Compare commits

..

No commits in common. "627a4d7995c8b71c7305572735547b0856deab78" and "6a72faf83b3aeb35ee44da51898fe8cbce6f5002" have entirely different histories.

7 changed files with 8 additions and 21 deletions

View file

@ -1 +0,0 @@
6a72faf83b3aeb35ee44da51898fe8cbce6f5002

View file

@ -24,22 +24,12 @@ Before making changes, read in this order:
- `server/`: Express REST API and orchestration services
- `ui/`: React + Vite board UI
- `cli/`: CLI package (`paperclipai` command)
- `packages/db/`: Drizzle schema, migrations, DB clients
- `packages/shared/`: shared types, constants, validators, API path constants
- `packages/adapters/`: agent adapter implementations (Claude, Codex, Cursor, etc.)
- `packages/adapter-utils/`: shared adapter utilities
- `packages/plugins/`: plugin system packages
- `skills/`: agent skills (Paperclip skill, company skills)
- `doc/`: operational and product docs
- `docs/`: Mintlify documentation site
- `tests/`: end-to-end and release smoke tests
- `scripts/`: build, dev, and release scripts
- `evals/`: promptfoo evaluation suites
- `releases/`: release notes
- `patches/`: pnpm dependency patches
- `docker/`: Docker configuration
- `report/`: generated analysis and audit reports
## 4. Dev Setup (Auto DB)
@ -65,7 +55,7 @@ curl http://localhost:3100/api/companies
Reset local dev DB:
```sh
rm -rf ~/.paperclip/instances/default/db
rm -rf data/pglite
pnpm dev
```

View file

@ -11,8 +11,8 @@ We really appreciate both small fixes and thoughtful larger changes.
- Pick **one** clear thing to fix/improve
- Touch the **smallest possible number of files**
- Make sure the change is very targeted and easy to review
- All automated checks pass (CI typecheck, tests, build)
- No new test failures
- All automated checks pass (including Greptile comments)
- No new lint/test failures
These almost always get merged quickly when they're clean.
@ -27,7 +27,7 @@ These almost always get merged quickly when they're clean.
- Clear description of what & why
- Proof it works (manual testing notes)
- All tests passing
- All PR review comments addressed
- All Greptile + other PR comments addressed
PRs that follow this path are **much** more likely to be accepted, even when they're large.

View file

@ -244,7 +244,7 @@ See [doc/DEVELOPING.md](doc/DEVELOPING.md) for the full development guide.
- ⚪ Artifacts & Deployments
- ⚪ CEO Chat
- ⚪ MAXIMIZER MODE
- Multiple Human Users
- Multiple Human Users
- ⚪ Cloud / Sandbox agents (e.g. Cursor / e2b agents)
- ⚪ Cloud deployments
- ⚪ Desktop App

View file

@ -54,7 +54,7 @@ I am researching the Facebook ads Granola uses (current task)
Tasks have parentage. Every task exists in service of a parent task, all the way up to the company goal. This is what keeps autonomous agents aligned — they can always answer "why am I doing this?"
Tasks carry statuses (backlog, todo, in_progress, in_review, done, blocked, cancelled), priorities, project and goal associations, billing codes for cross-team cost attribution, and execution workspace context. See [SPEC.md](./SPEC.md) for the full task model.
More detailed task structure TBD.
## Principles

View file

@ -196,7 +196,6 @@ Agent configuration includes an **adapter** that defines how Paperclip invokes t
| `codex_local` | Local Codex process | Codex CLI heartbeat worker |
| `opencode_local` | Local OpenCode process | OpenCode heartbeat worker |
| `pi_local` | Local Pi process | Pi CLI heartbeat worker |
| `gemini_local` | Local Gemini process | Gemini CLI heartbeat worker |
| `cursor` | Cursor API/CLI bridge | Cursor-integrated heartbeat worker |
| `openclaw_gateway` | OpenClaw gateway API | Managed OpenClaw agent via gateway |
| `hermes_local` | Local Hermes process | Hermes agent heartbeat worker |
@ -435,7 +434,7 @@ The core Paperclip system must be extensible. Features like knowledge bases, ext
- Well-defined API boundaries that plugins can hook into
- Event system or hooks for reacting to task/Agent lifecycle events
- **Agent Adapter plugins** — new Adapter types can be registered via the plugin system
- Plugin-registrable UI components (toolbar buttons, pages, slots)
- Plugin-registrable UI components (future)
The plugin framework has shipped. Plugins can register new adapter types, hook into lifecycle events, and contribute UI components (e.g. global toolbar buttons). A plugin SDK and CLI commands (`paperclipai plugin`) are available for authoring and installing plugins.

View file

@ -37,7 +37,6 @@ Built-in adapters:
- `claude_local`: runs your local `claude` CLI
- `codex_local`: runs your local `codex` CLI
- `opencode_local`: runs your local `opencode` CLI
- `gemini_local`: runs your local Gemini CLI
- `hermes_local`: runs your local `hermes` CLI
- `cursor`: runs Cursor in background mode
- `pi_local`: runs an embedded Pi agent locally
@ -45,7 +44,7 @@ Built-in adapters:
- `process`: generic shell command adapter
- `http`: calls an external HTTP endpoint
For local CLI adapters (`claude_local`, `codex_local`, `opencode_local`, `gemini_local`, `hermes_local`), Paperclip assumes the CLI is already installed and authenticated on the host machine.
For local CLI adapters (`claude_local`, `codex_local`, `opencode_local`, `hermes_local`), Paperclip assumes the CLI is already installed and authenticated on the host machine.
## 3.2 Runtime behavior