codebyplan 1.13.64 → 1.13.66

package/README.md

@@ -1,95 +1,137 @@
 # codebyplan
 
-CLI for [CodeByPlan](https://codebyplan.com) — AI-powered development planning and tracking.
+CLI for [CodeByPlan](https://codebyplan.com) — AI-powered development planning and tracking. It
+authenticates you, wires Claude Code to the CodeByPlan MCP server, scaffolds the `.claude/` skill /
+agent / hook system into your repo, and runs the planning workflow (checkpoints → tasks → rounds),
+CI/CD setup, and shipping.
 
-## Installation
+## Requirements
 
-```bash
-npx codebyplan setup
-```
-
-This will:
-
-1. Sign you in via OAuth (a browser window opens automatically; no API key needed)
-2. Configure Claude Code to connect via remote MCP
-3. Optionally link a repository
-
-## Commands
+- **Node.js >= 22.** Realtime sync uses the runtime's native `WebSocket`, which is only available on
+  Node 22+.
 
-### `codebyplan setup`
-
-Interactive setup wizard. Authenticates via OAuth and configures the MCP server connection.
-
-### `codebyplan config`
-
-Sync repo configuration from the CodeByPlan database to `.codebyplan.json`. Updates `server_port`, `server_type`, `branch_config`, and `port_allocations`. Also runs the worktree self-heal to cache the active worktree ID in memory.
-
-**Options:**
-
-| Flag               | Description                                      |
-| ------------------ | ------------------------------------------------ |
-| `--path <dir>`     | Project root directory (default: cwd)            |
-| `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
-| `--dry-run`        | Preview changes without writing                  |
-
-**Example:**
+## Quick start
 
 ```bash
-codebyplan config
-codebyplan config --dry-run
-```
-
-### `codebyplan ports`
-
-Verify port allocations match local `package.json` dev scripts. Reports mismatches and unallocated apps. With `--fix`, auto-creates missing port allocations in the database.
-
-**Options:**
-
-| Flag               | Description                                      |
-| ------------------ | ------------------------------------------------ |
-| `--path <dir>`     | Project root directory (default: cwd)            |
-| `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
-| `--dry-run`        | Preview changes without writing                  |
-| `--fix`            | Auto-create missing port allocations             |
-
-**Example:**
-
-```bash
-codebyplan ports
-codebyplan ports --fix
-codebyplan ports --fix --dry-run
+npx codebyplan setup
 ```
 
-### `codebyplan tech-stack`
-
-Detect and sync tech stack dependencies from all `package.json` files in the project. Also runs the local config migration to move any legacy `worktree_id` from `.codebyplan.json` to the gitignored `.codebyplan.local.json`.
-
-**Options:**
+`setup` walks you through:
 
-| Flag               | Description                                      |
-| ------------------ | ------------------------------------------------ |
-| `--path <dir>`     | Project root directory (default: cwd)            |
-| `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
-| `--dry-run`        | Preview changes without writing                  |
+1. **Authentication** — the OAuth device-code flow is recommended: a browser window opens to sign you
+   in and no API key is stored. A legacy API-key path remains as a short-lived shim (deprecated
+   2026-06-30).
+2. **MCP configuration** — writes the `codebyplan` remote-MCP entry (URL only, no secret) into your
+   global `~/.claude.json` or the project-local `.mcp.json`.
+3. **Project init** (optional) — link an existing repository (or create one inline), then scaffold the
+   committed `.codebyplan/` config directory and install the `.claude/` assets. Run from a repo root.
 
-**Example:**
+## Configuration: the `.codebyplan/` directory
 
-```bash
-codebyplan tech-stack
-codebyplan tech-stack --dry-run
-```
+Repo configuration lives in a per-concern `.codebyplan/` directory (not a single `.codebyplan.json`).
+The committed files are shared across the team; a few per-device / per-worktree files are gitignored.
 
-### `codebyplan help`
+| File | Scope | Contents |
+| ---- | ----- | -------- |
+| `repo.json` | committed | `repo_id`, `organization_id`, `project_id` |
+| `server.json` | committed | server port + type, `port_allocations[]` |
+| `git.json` | committed | branch config |
+| `shipment.json` | committed | configured deploy surfaces (Vercel, EAS, Supabase, npm, …) |
+| `ci.json` / `cd.json` | committed | CI / CD source-of-truth read by the workflow generators |
+| `vendor.json`, `statusline.json` | committed | vendor-docs path, statusline display prefs |
+| `device.local.json`, `server.local.json` | gitignored | per-device id, per-worktree ports |
+| `state/` | gitignored | per-worktree hot-path cache of workflow state (synced from the DB) |
 
-Show help message.
+Run `codebyplan config` to (re)sync the committed config from the CodeByPlan database.
 
-### `codebyplan --version`
+## Commands
 
-Print the CLI version.
+Run `codebyplan help` for the full usage block, or `codebyplan <command> --help` for a command's
+flags. The command surface:
+
+### Auth & identity
+
+| Command | Description |
+| ------- | ----------- |
+| `setup` | Interactive setup — OAuth + MCP config + optional project init |
+| `login [--admin]` | Authenticate via the OAuth device-code flow |
+| `logout` | Clear cached OAuth tokens |
+| `whoami [--json]` | Show the authenticated identity |
+| `upgrade-auth` | Migrate a legacy `x-api-key` MCP config to OAuth |
+
+### Project & config
+
+| Command | Description |
+| ------- | ----------- |
+| `config` | Sync repo config from the DB into `.codebyplan/` (`config migrate` upgrades a legacy `.codebyplan.json`) |
+| `ports` | Verify / fix port allocations against local dev scripts |
+| `tech-stack` | Detect and sync tech-stack dependencies |
+| `docs` | Manage the local dependency-docs mirror |
+| `create-org` / `create-project` / `create-repo` | Create an organization / project / repository |
+
+### Planning workflow
+
+| Command | Description |
+| ------- | ----------- |
+| `checkpoint` | Checkpoint writes via MCP (create / update / complete / export) |
+| `task` | Checkpoint-bound task writes via MCP |
+| `standalone-task` | Standalone (non-checkpoint) task writes via MCP |
+| `round` | Round helpers (`round sync-approvals`, …) |
+| `session` | Session helpers (home-ff / freshness-gate / infra-files) |
+| `sync` / `watch` | Hydrate `.codebyplan/state/`; run the Realtime down-sync daemon |
+
+### CI / CD & shipping
+
+| Command | Description |
+| ------- | ----------- |
+| `ci` / `cd` | CI / CD config management + GitHub Actions workflow scaffolding |
+| `eslint` | Detect the stack, resolve presets, generate `eslint.config.mjs` |
+| `ship` | Ship the current feat branch to production via PR |
+| `bump [--prerelease <id>]` | Detect changed packages and patch-bump versions |
+| `branch` | Branch model migration / checkout |
+| `scaffold-publish-workflow` | Write the publish-on-main GitHub workflow |
+| `upload-e2e-images` | Upload new/changed committed E2E PNGs for a checkpoint |
+
+### Claude assets
+
+| Command | Description |
+| ------- | ----------- |
+| `claude install` / `update` / `uninstall` | Manage `.claude/` skills, agents, and hooks |
+| `claude status` | Report package-sync state (drift, version skip, settings drift) |
+| `claude generate` | Write `.claude/generated/structure.md` from local config |
+| `claude readme` | Generate / refresh READMEs for outward-facing units |
+| `claude migrate-memory` | Inventory auto-memory files and emit a migration plan |
+| `claude audit-mode` | Audit the model/effort convention across templates |
+
+### Supabase
+
+| Command | Description |
+| ------- | ----------- |
+| `supabase resolve-preview` / `teardown-preview` | Resolve / guard-check a preview branch |
+| `supabase new-migration <name>` | Create a monotonic timestamped migration file |
+| `supabase preview-check` | Poll the GitHub "Supabase Preview" status check |
+
+### Utilities
+
+| Command | Description |
+| ------- | ----------- |
+| `check` | Run the unified check matrix (lint, tsc, tests, audit) |
+| `doctor` | Diagnostics: auth, version, settings (always exits 0) |
+| `lsp` | Detect the stack and enable LSP plugins in Claude Code |
+| `arch-map` | Architecture-map status / drift / stamp |
+| `worktree` | Worktree management (add / create / remove) |
+| `e2e` | E2E deterministic gates (verify-round) |
+| `slug <title>` | Convert a title to a git-safe branch slug |
+| `commit --scope-task` | Compute staged files scoped to the active task (JSON) |
+| `migration-collisions` | Detect Supabase migration timestamp collisions pre-merge |
+| `validate-waves` | Validate a plan's `waves[]` against parallel-wave invariants |
+| `cleanup-plan-folders` | Remove stale plan folders |
+| `statusline` | Show or set the statusline renderer (bash / node / python) |
+| `version-status` | Report installed vs latest version + update guard (JSON) |
 
 ## MCP Server
 
-Claude Code connects to CodeByPlan via a remote MCP server. The `setup` command configures this automatically:
+Claude Code connects to CodeByPlan via a remote MCP server. `setup` configures this automatically:
 
 ```json
 {
@@ -102,8 +144,9 @@ Claude Code connects to CodeByPlan via a remote MCP server. The `setup` command
 }
 ```
 
-Authentication is handled via OAuth Bearer — no API key is stored in this file.
+The entry is URL-only — authentication is handled by Claude Code's own OAuth handshake against the
+MCP host, so no API key is stored in this file.
 
-## Learn More
+## Learn more
 
 - [codebyplan.com](https://codebyplan.com)

package/dist/__tests__/helpers.d.ts

@@ -0,0 +1,22 @@
+import { vi } from "vitest";
+/**
+ * Create a mock fetch response.
+ */
+export declare function mockResponse(body: unknown, init?: {
+    status?: number;
+    headers?: Record<string, string>;
+}): Response;
+/**
+ * Install a mock fetch that returns the given responses in order.
+ * Returns the mock function for assertions.
+ */
+export declare function mockFetch(...responses: Response[]): ReturnType<typeof vi.fn>;
+/**
+ * Install a mock fetch that always rejects with the given error.
+ */
+export declare function mockFetchError(error: Error): ReturnType<typeof vi.fn>;
+/**
+ * Set environment variables for tests. Returns a cleanup function.
+ */
+export declare function setEnv(vars: Record<string, string>): () => void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/__tests__/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/__tests__/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3D,QAAQ,CASV;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAY5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAKrE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAe/D"}

package/dist/ci-public.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Public generator surface for the `codebyplan/ci` subpath export.
+ *
+ * Re-exports ONLY the reader interface, the local-fs reader, and the CI
+ * generator functions + types. Does NOT import from src/index.ts or any CLI
+ * entry so the emitted dist/ci.js bundle stays clean (no process.argv parsing,
+ * no keyring, no Supabase client).
+ *
+ * Import in consuming repos:
+ *   import { detectPlatforms, buildDefaultCiConfig, LocalFsReader } from 'codebyplan/ci';
+ */
+export type { RepoReader } from "./lib/repo-reader.js";
+export { LocalFsReader } from "./lib/repo-reader.js";
+export { detectPlatforms, buildDefaultCiConfig, PLATFORM_COMMAND_MAP, } from "./lib/ci-init.js";
+export type { CiInitOptions, CiInitResult } from "./lib/ci-init.js";
+export { runCiInit } from "./lib/ci-init.js";
+export { runScaffoldCiWorkflow, renderCiWorkflowContent, } from "./lib/scaffold-ci-workflow.js";
+export type { ScaffoldCiWorkflowOptions } from "./lib/scaffold-ci-workflow.js";
+export type { ScaffoldResult } from "./lib/scaffold-publish-workflow.js";
+//# sourceMappingURL=ci-public.d.ts.map

package/dist/ci-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-public.d.ts","sourceRoot":"","sources":["../src/ci-public.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/ci.js

@@ -45,10 +45,19 @@ import * as path2 from "node:path";
 
 // src/lib/atomic-write.ts
 import * as fs from "node:fs";
-function writeJsonAtomic(filePath, value) {
+function writeJsonAtomic(filePath, value, opts = {}) {
   const tmpPath = filePath + ".tmp";
   try {
-    fs.writeFileSync(tmpPath, JSON.stringify(value, null, 2) + "\n", "utf-8");
+    fs.writeFileSync(tmpPath, JSON.stringify(value, null, 2) + "\n", {
+      encoding: "utf-8",
+      ...opts.mode !== void 0 ? { mode: opts.mode } : {}
+    });
+    if (opts.mode !== void 0 && process.platform !== "win32") {
+      try {
+        fs.chmodSync(tmpPath, opts.mode);
+      } catch {
+      }
+    }
     fs.renameSync(tmpPath, filePath);
   } catch (err) {
     try {

package/dist/cli/arch-map.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `codebyplan arch-map` — architecture map pipeline for .codebyplan/architecture.json.
+ *
+ * Subcommands:
+ *   status   — enumerate modules; cross-reference architecture.json
+ *   drift    — report modules whose stamped SHA has since changed
+ *   stamp    — update architecture.json with the current SHA for a module
+ */
+/**
+ * Derive the map-file slug for a module path: replace path separators with `-`,
+ * then normalize a leading dot to `dot-` so a dot-prefixed module (e.g. `.github`)
+ * maps to a NON-hidden, collision-safe map file (`dot-github.md`). Only the map-file
+ * slug is normalized — the manifest `path` keeps the leading dot so `git log -- .github`
+ * drift tracking still works.
+ */
+export declare function mapFileSlug(modulePath: string): string;
+/**
+ * Update YAML frontmatter fields in a map file's content string.
+ *
+ * Finds the leading `---` ... `---` frontmatter block and replaces
+ * `generated_from_sha`, `generated_at`, and optionally `depth` values in-place.
+ * All other lines (frontmatter or body) pass through byte-for-byte.
+ *
+ * Returns null when no valid frontmatter block is found (first non-empty line
+ * is not "---", or the closing "---" is missing).
+ */
+export declare function updateFrontmatterFields(content: string, fields: {
+    generated_from_sha: string;
+    generated_at: string;
+    depth?: string;
+}): string | null;
+export declare function runArchMapCommand(rest: string[]): Promise<void>;
+//# sourceMappingURL=arch-map.d.ts.map

package/dist/cli/arch-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-map.d.ts","sourceRoot":"","sources":["../../src/cli/arch-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtD;AAoTD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E,MAAM,GAAG,IAAI,CA0Cf;AAyID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8FrE"}

package/dist/cli/branch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI handler for `codebyplan branch <subcommand>`.
+ *
+ * Two-level subcommand dispatcher — no Commander dependency.
+ * Subcommands:
+ *   migrate   Rewrite branch_config from 3-branch to 2-tier model
+ *   checkout  Switch/create a branch (replicates cbp-task-start Step 3.3)
+ */
+export declare function runBranchCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=branch.d.ts.map

package/dist/cli/branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/cli/branch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BpE"}

package/dist/cli/bump.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI handler for `codebyplan bump`.
+ *
+ * Detects changed workspace packages since the base branch, patch-bumps their
+ * versions, and prepends CHANGELOG entries. Does NOT commit or push.
+ *
+ * Flags:
+ *   --dry-run   Compute and print planned bumps without writing any files
+ *   --json      Write structured JSON output to stdout
+ */
+export declare function runBumpCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=bump.d.ts.map

package/dist/cli/bump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump.d.ts","sourceRoot":"","sources":["../../src/cli/bump.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0EH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuClE"}

package/dist/cli/cd.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CLI handler for `codebyplan cd`.
+ *
+ * Subcommands:
+ *   init               Detect CD surfaces from shipment.json and write/update .codebyplan/cd.json
+ *   scaffold-workflow  Write .github/workflows/publish.yml and release-desktop.yml from bundled templates
+ *
+ * Flags (all subcommands):
+ *   --dry-run            Preview the operation without writing any files
+ *   --force              Overwrite existing content that differs
+ *   --project-dir <p>    Override the project root (default: cwd)
+ *   --json               Emit structured JSON to stdout
+ *   --help               Print help and exit
+ *
+ * Flags (scaffold-workflow only):
+ *   --workflow <name>    Which workflow to scaffold: publish | release-desktop (may be repeated)
+ *                        Defaults to both when omitted.
+ */
+export declare function runCdCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=cd.d.ts.map

package/dist/cli/cd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cd.d.ts","sourceRoot":"","sources":["../../src/cli/cd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAkHH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFhE"}

package/dist/cli/check.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CLI handler for `codebyplan check`.
+ *
+ * Runs the unified whole-repo + baseline check matrix (gate6, lint, typecheck,
+ * tests, audit) and emits a human-readable pipe-table or JSON output.
+ *
+ * Flags:
+ *   --scope <round|task|merged>   Check scope (default: round)
+ *   --files <comma-separated>     DEPRECATED / NO-OP in whole-repo mode.
+ *                                 Emits a notice to stderr and is otherwise ignored.
+ *   --update-baseline             Run checks and write current failing state to
+ *                                 .check-baseline.json (seeds/refreshes baseline).
+ *   --no-baseline                 STRICT / absolute-green: ignore the baseline so
+ *                                 EVERY failing package + GHSA id counts as a
+ *                                 failure (any red fails). gate6 unchanged.
+ *                                 Mutually exclusive with --update-baseline
+ *                                 (the latter is ignored, with a warning).
+ *   --concurrency <n>             Cap turbo task parallelism (turbo --concurrency).
+ *                                 The strict whole-repo CI gate passes 1 to
+ *                                 serialize package suites and avoid contention
+ *                                 flakes; omit it for the dev-loop default.
+ *   --json                        Emit structured JSON to stdout instead of the
+ *                                 human pipe-table
+ *
+ * Exit behaviour:
+ *   process.exitCode = 1 when any hard-fail check fails.
+ *   Never calls process.exit() directly — caller (index.ts) handles that.
+ */
+export declare function runCheckCommand(args: string[]): void;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAoOH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA2BpD"}

package/dist/cli/checkpoint.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI handler for `codebyplan checkpoint <subcommand>`.
+ *
+ * Implements local-first write semantics:
+ *   1. Snapshot current local file
+ *   2. Optimistic local write
+ *   3. Backend call via state-client
+ *   4a. Success: overwrite local from server response + update entity_hashes
+ *   4b. 4xx BackendError: restore snapshot + exit 1 with stderr message
+ *   4c. 5xx BackendError / network error: keep local + write _pending/<id>.json + exit 1
+ *
+ * Subcommands: create | update | complete
+ *
+ * Uses parseFlagsFromArgs pattern (no Commander dependency).
+ */
+export declare function runCheckpointCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/cli/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/cli/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAohBH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCxE"}

package/dist/cli/ci.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLI handler for `codebyplan ci`.
+ *
+ * Subcommands:
+ *   init               Detect platforms and write/update .codebyplan/ci.json
+ *   scaffold-workflow  Write .github/workflows/ci.yml from the bundled template
+ *   enforce-check      Enforce the required CI status check on a GitHub branch
+ *   resolve <category> Resolve the shell command for a CI check category
+ *
+ * Flags (all subcommands):
+ *   --dry-run            Preview the operation without writing any files
+ *   --force              Overwrite existing content that differs
+ *   --project-dir <p>    Override the project root (default: cwd)
+ *   --json               Emit structured JSON to stdout
+ *   --help               Print help and exit
+ *
+ * Flags (scaffold-workflow only):
+ *   --pnpm-version <v>   pnpm version for {{PNPM_VERSION}} token (default: auto-detected from package.json packageManager, falls back to "10")
+ *   --node-version <v>   Node.js version for {{NODE_VERSION}} token (default: "22")
+ *   --strict-enforced    Emit ci-strict as an enforced gate (default: read .codebyplan/ci.json workflow.strict_check_enforced)
+ *
+ * Flags (enforce-check only):
+ *   --branch <b>         Branch to enforce (default: "main")
+ *   --check-name <n>     Status check name (default: "Lint + typecheck + test + build")
+ *
+ * Flags (resolve only):
+ *   --platform <slug>    Platform slug to resolve against (e.g. next_js, nestjs)
+ *   --json               Emit the full CiResolveResult as JSON
+ */
+export declare function runCiCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=ci.d.ts.map

package/dist/cli/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../src/cli/ci.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAyIH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsLhE"}

package/dist/cli/claude/__test-helpers__/expect-manifest.d.ts

@@ -0,0 +1,7 @@
+import { type Manifest } from "../../../lib/manifest.js";
+/**
+ * Reads the manifest from projectDir, asserts non-null, then calls checker.
+ * Produces a descriptive error on null rather than a TypeError.
+ */
+export declare function expectManifest(projectDir: string, checker: (manifest: Manifest) => void): void;
+//# sourceMappingURL=expect-manifest.d.ts.map

package/dist/cli/claude/__test-helpers__/expect-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-manifest.d.ts","sourceRoot":"","sources":["../../../../src/cli/claude/__test-helpers__/expect-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GACpC,IAAI,CAKN"}

package/dist/cli/claude/__test-helpers__/tmp-fixture.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shape returned by createTmpProject(). A test typically:
+ *   1. Seeds `templatesDir` with a tiny replica of packages/codebyplan-package/templates/
+ *   2. process.chdir(projectDir) so install/update/uninstall write into projectDir
+ *   3. afterEach: restores cwd and calls cleanup()
+ */
+export interface TmpProject {
+    /** Absolute path to the project root (acts as user's repo). */
+    projectDir: string;
+    /** Absolute path to the simulated templates dir for the package. */
+    templatesDir: string;
+    /** Removes BOTH dirs recursively. Idempotent — safe to call multiple times. */
+    cleanup: () => void;
+}
+export interface SeedOpts {
+    /** Adds a small but representative tree under templatesDir. Default: true. */
+    seedDefaultTemplates?: boolean;
+    /**
+     * When true, also seeds `settings.user.base.json` into templatesDir alongside
+     * the project base. The 22 user-scope keys are written using the same shape as
+     * the real `templates/settings.user.base.json`.
+     */
+    userScope?: boolean;
+}
+/**
+ * Create two sibling tmp dirs (one for the project, one for the package's
+ * templates) using mkdtempSync — fully isolated per-test, no cross-test
+ * leakage even when run in parallel.
+ *
+ * The default seed mirrors the real templates/ layout enough that
+ * install/update/uninstall exercise every code path: a couple of skill
+ * files, an agent file, a hook .sh, a hooks.json (which the walker skips),
+ * and a hooks/README.md (also skipped).
+ */
+export declare function createTmpProject(opts?: SeedOpts): TmpProject;
+/** Seed a minimal templates tree representative of the real package layout. */
+export declare function seedMinimalTemplates(templatesDir: string): void;
+/**
+ * Seed `settings.user.base.json` into `templatesDir`. Contains only the
+ * 22 user-scope owned keys — 21 common keys (matching settings.project.base.json
+ * values byte-for-byte) plus `permissions.skipDangerousModePermissionPrompt`.
+ *
+ * Note: `autoMemoryEnabled` is a common project key (added to
+ * settings.project.base.json to ship auto-memory disabled per repo) but is
+ * intentionally ABSENT from this user template — auto-memory is per-repository,
+ * so the project template alone disables it for every consuming repo's team;
+ * user scope would overreach to non-CBP projects.
+ *
+ * No skills/agents/hooks/rules are seeded — user-scope install never copies
+ * template files.
+ */
+export declare function seedUserTemplates(templatesDir: string): void;
+/**
+ * Create a temporary directory that mimics `~/.claude/` for test isolation.
+ * Tests should pass the returned `userDir` path via `deps.userDir` to avoid
+ * touching the real home directory.
+ *
+ * Returns the absolute path and a `cleanup` function that removes it.
+ */
+export declare function createTmpUserDir(): {
+    userDir: string;
+    cleanup: () => void;
+};
+//# sourceMappingURL=tmp-fixture.d.ts.map

package/dist/cli/claude/__test-helpers__/tmp-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmp-fixture.d.ts","sourceRoot":"","sources":["../../../../src/cli/claude/__test-helpers__/tmp-fixture.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,QAAa,GAAG,UAAU,CAqBhE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAoG/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAgC5D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAQ3E"}

package/dist/cli/claude/audit-mode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI handler for `codebyplan claude audit-mode`.
+ *
+ * Scans `templates/agents/*.md` and `templates/skills/* /SKILL.md`, applies
+ * the model/effort convention from cbp-build-cc-mode, and emits a
+ * pipe-delimited report.
+ *
+ * Exit codes:
+ *   0 — all files comply (zero gaps)
+ *   1 — one or more gaps detected
+ *
+ * Flags:
+ *   --json   Emit entries array as JSON instead of the human table
+ */
+export declare function runAuditMode(args: string[]): Promise<void>;
+//# sourceMappingURL=audit-mode.d.ts.map

package/dist/cli/claude/audit-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-mode.d.ts","sourceRoot":"","sources":["../../../src/cli/claude/audit-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgEH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhE"}

package/dist/cli/claude/generate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * I/O orchestrator for `codebyplan claude generate`.
+ *
+ * Reads LOCAL config + repo layout (offline — no DB/MCP calls) and writes a
+ * DETERMINISTIC `.claude/generated/structure.md`.
+ *
+ * Usage:
+ *   codebyplan claude generate [--project-dir <path>] [--dry-run]
+ *
+ * Integration contract (TASK-4 will wire the import line):
+ *   Add this to .claude/CLAUDE.md where you want the content injected:
+ *     @.claude/generated/structure.md
+ */
+export interface GenerateOpts {
+    /** Override the project root (default: cwd). */
+    projectDir?: string;
+    /** Print the would-be content to stdout, write nothing. */
+    dryRun?: boolean;
+    /** Exit non-zero when AGENTS.md is missing or drifted. Read-only — writes nothing. */
+    check?: boolean;
+}
+export declare function runGenerate(opts: GenerateOpts | Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/claude/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/claude/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyDD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA4Of"}