refactor: rename packages to @paperclipai and CLI binary to paperclipai

Rename all workspace packages from @paperclip/* to @paperclipai/* and the CLI binary from `paperclip` to `paperclipai` in preparation for npm publishing. Bump CLI version to 0.1.0 and add package metadata (description, keywords, license, repository, files). Update all imports, documentation, user-facing messages, and tests accordingly. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 08:45:26 -06:00
parent 5a5549fc54
commit f60c1001ec
196 changed files with 501 additions and 490 deletions
--- a/docs/cli/control-plane-commands.md
+++ b/docs/cli/control-plane-commands.md
@@ -9,38 +9,38 @@ Client-side commands for managing issues, agents, approvals, and more.

 ```sh
 # List issues
-pnpm paperclip issue list [--status todo,in_progress] [--assignee-agent-id <id>] [--match text]
+pnpm paperclipai issue list [--status todo,in_progress] [--assignee-agent-id <id>] [--match text]

 # Get issue details
-pnpm paperclip issue get <issue-id-or-identifier>
+pnpm paperclipai issue get <issue-id-or-identifier>

 # Create issue
-pnpm paperclip issue create --title "..." [--description "..."] [--status todo] [--priority high]
+pnpm paperclipai issue create --title "..." [--description "..."] [--status todo] [--priority high]

 # Update issue
-pnpm paperclip issue update <issue-id> [--status in_progress] [--comment "..."]
+pnpm paperclipai issue update <issue-id> [--status in_progress] [--comment "..."]

 # Add comment
-pnpm paperclip issue comment <issue-id> --body "..." [--reopen]
+pnpm paperclipai issue comment <issue-id> --body "..." [--reopen]

 # Checkout task
-pnpm paperclip issue checkout <issue-id> --agent-id <agent-id>
+pnpm paperclipai issue checkout <issue-id> --agent-id <agent-id>

 # Release task
-pnpm paperclip issue release <issue-id>
+pnpm paperclipai issue release <issue-id>
 ```

 ## Company Commands

 ```sh
-pnpm paperclip company list
-pnpm paperclip company get <company-id>
+pnpm paperclipai company list
+pnpm paperclipai company get <company-id>

 # Export to portable folder package (writes manifest + markdown files)
-pnpm paperclip company export <company-id> --out ./exports/acme --include company,agents
+pnpm paperclipai company export <company-id> --out ./exports/acme --include company,agents

 # Preview import (no writes)
-pnpm paperclip company import \
+pnpm paperclipai company import \
  --from https://github.com/<owner>/<repo>/tree/main/<path> \
  --target existing \
  --company-id <company-id> \
@@ -48,7 +48,7 @@ pnpm paperclip company import \
  --dry-run

 # Apply import
-pnpm paperclip company import \
+pnpm paperclipai company import \
  --from ./exports/acme \
  --target new \
  --new-company-name "Acme Imported" \
@@ -58,52 +58,52 @@ pnpm paperclip company import \
 ## Agent Commands

 ```sh
-pnpm paperclip agent list
-pnpm paperclip agent get <agent-id>
+pnpm paperclipai agent list
+pnpm paperclipai agent get <agent-id>
 ```

 ## Approval Commands

 ```sh
 # List approvals
-pnpm paperclip approval list [--status pending]
+pnpm paperclipai approval list [--status pending]

 # Get approval
-pnpm paperclip approval get <approval-id>
+pnpm paperclipai approval get <approval-id>

 # Create approval
-pnpm paperclip approval create --type hire_agent --payload '{"name":"..."}' [--issue-ids <id1,id2>]
+pnpm paperclipai approval create --type hire_agent --payload '{"name":"..."}' [--issue-ids <id1,id2>]

 # Approve
-pnpm paperclip approval approve <approval-id> [--decision-note "..."]
+pnpm paperclipai approval approve <approval-id> [--decision-note "..."]

 # Reject
-pnpm paperclip approval reject <approval-id> [--decision-note "..."]
+pnpm paperclipai approval reject <approval-id> [--decision-note "..."]

 # Request revision
-pnpm paperclip approval request-revision <approval-id> [--decision-note "..."]
+pnpm paperclipai approval request-revision <approval-id> [--decision-note "..."]

 # Resubmit
-pnpm paperclip approval resubmit <approval-id> [--payload '{"..."}']
+pnpm paperclipai approval resubmit <approval-id> [--payload '{"..."}']

 # Comment
-pnpm paperclip approval comment <approval-id> --body "..."
+pnpm paperclipai approval comment <approval-id> --body "..."
 ```

 ## Activity Commands

 ```sh
-pnpm paperclip activity list [--agent-id <id>] [--entity-type issue] [--entity-id <id>]
+pnpm paperclipai activity list [--agent-id <id>] [--entity-type issue] [--entity-id <id>]
 ```

 ## Dashboard

 ```sh
-pnpm paperclip dashboard get
+pnpm paperclipai dashboard get
 ```

 ## Heartbeat

 ```sh
-pnpm paperclip heartbeat run --agent-id <agent-id> [--api-base http://localhost:3100]
+pnpm paperclipai heartbeat run --agent-id <agent-id> [--api-base http://localhost:3100]
 ```
--- a/docs/cli/overview.md
+++ b/docs/cli/overview.md
@@ -8,7 +8,7 @@ The Paperclip CLI handles instance setup, diagnostics, and control-plane operati
 ## Usage

 ```sh
-pnpm paperclip --help
+pnpm paperclipai --help
 ```

 ## Global Options
@@ -29,7 +29,7 @@ Company-scoped commands also accept `--company-id <id>`.
 For clean local instances, pass `--data-dir` on the command you run:

 ```sh
-pnpm paperclip run --data-dir ./tmp/paperclip-dev
+pnpm paperclipai run --data-dir ./tmp/paperclip-dev
 ```

 ## Context Profiles
@@ -38,22 +38,22 @@ Store defaults to avoid repeating flags:

 ```sh
 # Set defaults
-pnpm paperclip context set --api-base http://localhost:3100 --company-id <id>
+pnpm paperclipai context set --api-base http://localhost:3100 --company-id <id>

 # View current context
-pnpm paperclip context show
+pnpm paperclipai context show

 # List profiles
-pnpm paperclip context list
+pnpm paperclipai context list

 # Switch profile
-pnpm paperclip context use default
+pnpm paperclipai context use default
 ```

 To avoid storing secrets in context, use an env var:

 ```sh
-pnpm paperclip context set --api-key-env-var-name PAPERCLIP_API_KEY
+pnpm paperclipai context set --api-key-env-var-name PAPERCLIP_API_KEY
 export PAPERCLIP_API_KEY=...
 ```

--- a/docs/cli/setup-commands.md
+++ b/docs/cli/setup-commands.md
@@ -5,32 +5,32 @@ summary: Onboard, run, doctor, and configure

 Instance setup and diagnostics commands.

-## `paperclip run`
+## `paperclipai run`

 One-command bootstrap and start:

 ```sh
-pnpm paperclip run
+pnpm paperclipai run
 ```

 Does:

 1. Auto-onboards if config is missing
-2. Runs `paperclip doctor` with repair enabled
+2. Runs `paperclipai doctor` with repair enabled
 3. Starts the server when checks pass

 Choose a specific instance:

 ```sh
-pnpm paperclip run --instance dev
+pnpm paperclipai run --instance dev
 ```

-## `paperclip onboard`
+## `paperclipai onboard`

 Interactive first-time setup:

 ```sh
-pnpm paperclip onboard
+pnpm paperclipai onboard
 ```

 Prompts for:
@@ -40,13 +40,13 @@ Prompts for:
 3. Public URL (if authenticated + public)
 4. Database and secrets configuration

-## `paperclip doctor`
+## `paperclipai doctor`

 Health checks with optional auto-repair:

 ```sh
-pnpm paperclip doctor
-pnpm paperclip doctor --repair
+pnpm paperclipai doctor
+pnpm paperclipai doctor --repair
 ```

 Validates:
@@ -57,30 +57,30 @@ Validates:
 - Storage configuration
 - Missing key files

-## `paperclip configure`
+## `paperclipai configure`

 Update configuration sections:

 ```sh
-pnpm paperclip configure --section server
-pnpm paperclip configure --section secrets
-pnpm paperclip configure --section storage
+pnpm paperclipai configure --section server
+pnpm paperclipai configure --section secrets
+pnpm paperclipai configure --section storage
 ```

-## `paperclip env`
+## `paperclipai env`

 Show resolved environment configuration:

 ```sh
-pnpm paperclip env
+pnpm paperclipai env
 ```

-## `paperclip allowed-hostname`
+## `paperclipai allowed-hostname`

 Allow a private hostname for authenticated/private mode:

 ```sh
-pnpm paperclip allowed-hostname my-tailscale-host
+pnpm paperclipai allowed-hostname my-tailscale-host
 ```

 ## Local Storage Paths
@@ -96,12 +96,12 @@ pnpm paperclip allowed-hostname my-tailscale-host
 Override with:

 ```sh
-PAPERCLIP_HOME=/custom/home PAPERCLIP_INSTANCE_ID=dev pnpm paperclip run
+PAPERCLIP_HOME=/custom/home PAPERCLIP_INSTANCE_ID=dev pnpm paperclipai run
 ```

 Or pass `--data-dir` directly on any command:

 ```sh
-pnpm paperclip run --data-dir ./tmp/paperclip-dev
-pnpm paperclip doctor --data-dir ./tmp/paperclip-dev
+pnpm paperclipai run --data-dir ./tmp/paperclip-dev
+pnpm paperclipai doctor --data-dir ./tmp/paperclip-dev
 ```