codebyplan 1.13.65 → 1.13.67

package/dist/cli/standalone-task.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLI handler for `codebyplan standalone-task <subcommand>`.
+ *
+ * Wraps the standalone MCP write tools (create_standalone_task /
+ * update_standalone_task / complete_standalone_task). Unlike `codebyplan task`
+ * (REST via state-client against the checkpoint-bound `tasks` table), the
+ * standalone surface has NO NestJS controller — the ONLY writers for the
+ * standalone_tasks table are the MCP tools in
+ * packages/mcp-tools/src/tools/standalone-write.ts. So the transport here is
+ * MCP JSON-RPC via mcpCall, NOT apiBackendPost/apiBackendPatch.
+ *
+ * Local-first write semantics (mirrors task.ts / round.ts):
+ *   1. Snapshot current local file (update/complete)
+ *   2. Optimistic local write
+ *   3. MCP call via mcpCall
+ *   4a. Success: overwrite local from server row + update entity_hashes
+ *   4b. 401 auth error: revert optimistic write + exit 1 (suggest `codebyplan login`)
+ *   4c. transient (>=500 / network error): KEEP optimistic + write pending marker + exit 1
+ *   4d. tool-level error (zod validation / CHK-104 lock / unapproved files):
+ *       revert optimistic write + exit 1 (NO pending marker)
+ *
+ * Local-cache paths are FLAT — `.codebyplan/state/standalone_tasks/<id>.json` —
+ * with no checkpoint partitioning, so there is NO --checkpoint-id flag (that is
+ * exactly why `task` needs it and `standalone-task` does not).
+ *
+ * Subcommands: create | update | complete | help
+ *
+ * Uses parseFlagsFromArgs pattern (no Commander dependency).
+ */
+export declare function runStandaloneTaskCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=standalone-task.d.ts.map

package/dist/cli/standalone-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-task.d.ts","sourceRoot":"","sources":["../../src/cli/standalone-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA4cH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC5E"}

package/dist/cli/statusline.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `codebyplan statusline` — show or set the statusline renderer.
+ *
+ * Usage:
+ *   codebyplan statusline                   Show current state (renderer, availability, toggles)
+ *   codebyplan statusline bash|node|python  Set the renderer
+ *   codebyplan statusline --bash|--node|--python  Set the renderer (flag form)
+ */
+export declare function runStatusline(args: string[]): Promise<void>;
+//# sourceMappingURL=statusline.d.ts.map

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

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

package/dist/cli/supabase/new-migration.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CLI entry point for `codebyplan supabase new-migration`.
+ *
+ * Usage: codebyplan supabase new-migration <name>
+ *
+ * Creates an empty migration file at supabase/migrations/<stamp>_<slug>.sql.
+ *
+ * Output JSON: { path }
+ *
+ * Exit codes:
+ *   0 — file created
+ *   1 — missing <name> argument
+ */
+import { type GenerateMonotonicTimestampOpts } from "../../lib/supabase.js";
+export interface NewMigrationDeps {
+    cwd?: string;
+    generateTimestamp?: (opts: GenerateMonotonicTimestampOpts) => string;
+    mkdirSyncFn?: (dir: string, opts: {
+        recursive: boolean;
+    }) => void;
+    writeFileSyncFn?: (filePath: string, content: string) => void;
+}
+export declare function newMigration(args: string[], deps?: NewMigrationDeps): number;
+//# sourceMappingURL=new-migration.d.ts.map

package/dist/cli/supabase/new-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-migration.d.ts","sourceRoot":"","sources":["../../../src/cli/supabase/new-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,8BAA8B,KAAK,MAAM,CAAC;IACrE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAClE,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAeD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,gBAAqB,GAC1B,MAAM,CAiCR"}

package/dist/cli/supabase/preview-check.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CLI entry point for `codebyplan supabase preview-check`.
+ *
+ * Usage: codebyplan supabase preview-check [--mode pre_merge|pre_pr_create]
+ *
+ * Resolves the current PR number and polls gh pr checks until the
+ * "Supabase Preview" check resolves (or times out).
+ *
+ * Output JSON: { status, reason, failed_step?, log_excerpt? }
+ * Exit: 0 always — the status field carries the verdict; callers branch on it.
+ */
+import { type RunFn, type PollGhPreviewCheckResult } from "../../lib/supabase.js";
+export interface PreviewCheckDeps {
+    cwd?: string;
+    run?: RunFn;
+    sleep?: (ms: number) => Promise<void>;
+    /** Override PR number resolution. Returns null when no open PR exists. */
+    getPrNumber?: (cwd: string, run: RunFn) => string | null;
+    /** Override the actual poll (for unit testing without real gh). */
+    pollCheck?: (opts: {
+        prNumber?: string;
+        mode?: "pre_merge" | "pre_pr_create";
+        run?: RunFn;
+        sleep?: (ms: number) => Promise<void>;
+        maxPolls?: number;
+        intervalMs?: number;
+    }) => Promise<PollGhPreviewCheckResult>;
+}
+export declare function previewCheck(args: string[], deps?: PreviewCheckDeps): Promise<number>;
+//# sourceMappingURL=preview-check.d.ts.map

package/dist/cli/supabase/preview-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-check.d.ts","sourceRoot":"","sources":["../../../src/cli/supabase/preview-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,mEAAmE;IACnE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;QACrC,GAAG,CAAC,EAAE,KAAK,CAAC;QACZ,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACzC;AA4BD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/cli/supabase/resolve-preview.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CLI entry point for `codebyplan supabase resolve-preview`.
+ *
+ * Usage: codebyplan supabase resolve-preview [--branch <name>]
+ *
+ * Output JSON: { branch, parent_ref, project_ref, db_changed, base }
+ * Exit: 0 always.
+ */
+import { type ShipmentConfig, type GitConfig, type DetectDbChangedOpts } from "../../lib/supabase.js";
+export interface ResolvePreviewDeps {
+    cwd?: string;
+    readShipment?: (cwd: string) => ShipmentConfig;
+    readGit?: (cwd: string) => GitConfig;
+    detectDb?: (opts: DetectDbChangedOpts) => boolean;
+    /** Override current-branch detection. */
+    getCurrentBranch?: (cwd: string) => string;
+}
+export declare function resolvePreview(args: string[], deps?: ResolvePreviewDeps): number;
+//# sourceMappingURL=resolve-preview.d.ts.map

package/dist/cli/supabase/resolve-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-preview.d.ts","sourceRoot":"","sources":["../../../src/cli/supabase/resolve-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC;IAClD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAYD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,kBAAuB,GAC5B,MAAM,CAqCR"}

package/dist/cli/supabase/teardown-preview.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI entry point for `codebyplan supabase teardown-preview`.
+ *
+ * Usage: codebyplan supabase teardown-preview <branch>
+ *
+ * Guard/resolver only — does NOT delete anything. The MCP delete stays in the skill.
+ *
+ * Output JSON:
+ *   { status: 'allowed'|'not_found'|'rejected', branch, parent_ref, project_ref, reason? }
+ *
+ * Exit codes:
+ *   0 — allowed or not_found (idempotent)
+ *   1 — rejected (guard failed) or missing required arg
+ */
+import { type ShipmentConfig, type GitConfig } from "../../lib/supabase.js";
+export interface TeardownPreviewDeps {
+    cwd?: string;
+    readShipment?: (cwd: string) => ShipmentConfig;
+    readGit?: (cwd: string) => GitConfig;
+}
+export declare function teardownPreview(args: string[], deps?: TeardownPreviewDeps): number;
+//# sourceMappingURL=teardown-preview.d.ts.map

package/dist/cli/supabase/teardown-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teardown-preview.d.ts","sourceRoot":"","sources":["../../../src/cli/supabase/teardown-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;CACtC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,mBAAwB,GAC7B,MAAM,CAuGR"}

package/dist/cli/sync.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI handler for `codebyplan sync`.
+ *
+ * Hydrates or delta-syncs `.codebyplan/state/` from the backend `/sync`
+ * endpoint. Always exits 0 (hook-safe) regardless of outcome.
+ *
+ * Flags:
+ *   --full       Force a full hydrate (since=0); discards cursor and prunes stale files.
+ *   --dry-run    Resolve paths but skip all writes (prints what would happen).
+ *   --json       Emit structured JSON to stdout instead of human-readable lines.
+ */
+export declare function runSyncCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

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

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

package/dist/cli/task.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI handler for `codebyplan task <subcommand>`.
+ *
+ * Implements local-first write semantics (same pattern as checkpoint.ts):
+ *   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 / network error: keep local + write _pending/<id>.json + exit 1
+ *
+ * Subcommands: create | update | complete
+ *
+ * Uses parseFlagsFromArgs pattern (no Commander dependency).
+ */
+export declare function runTaskCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/cli/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA+bH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgClE"}

package/dist/cli/tech-stack.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `codebyplan tech-stack` — detect and sync tech stack, and run local config migration.
+ */
+export declare function runTechStack(): Promise<void>;
+/**
+ * `codebyplan tech-stack --full-tech-stack` — simplified to current-repo-only
+ * mode (CHK-225 TASK-3: worktree identity stack retired; no device filter, no
+ * cross-worktree scan).  Behaves identically to the default `runTechStack` call.
+ */
+export declare function runFullTechStack(dryRun: boolean): Promise<void>;
+//# sourceMappingURL=tech-stack.d.ts.map

package/dist/cli/tech-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-stack.d.ts","sourceRoot":"","sources":["../../src/cli/tech-stack.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAqHlD;AA8DD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAerE"}

package/dist/cli/upgrade-auth.d.ts

@@ -0,0 +1,2 @@
+export declare function runUpgradeAuth(): Promise<void>;
+//# sourceMappingURL=upgrade-auth.d.ts.map

package/dist/cli/upgrade-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-auth.d.ts","sourceRoot":"","sources":["../../src/cli/upgrade-auth.ts"],"names":[],"mappings":"AA+DA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBpD"}

package/dist/cli/upload-e2e-images.d.ts

@@ -0,0 +1,18 @@
+/**
+ * CLI handler for `codebyplan upload-e2e-images`.
+ *
+ * Collects new/changed committed e2e PNGs on this branch vs a base branch
+ * (feat-vs-base git diff) and POSTs them to the checkpoint-images endpoint.
+ *
+ * Usage:
+ *   codebyplan upload-e2e-images <checkpointId> [--repo-id <uuid>]
+ *     [--base-branch <name>] [--json] [--dry-run]
+ *
+ * Flags:
+ *   --repo-id <uuid>       Repository ID (default: read from .codebyplan/repo.json)
+ *   --base-branch <name>   Base branch for git diff (default: main)
+ *   --json                 Write JSON result to stdout
+ *   --dry-run              Print collected manifest without uploading
+ */
+export declare function runUploadE2eImagesCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=upload-e2e-images.d.ts.map

package/dist/cli/upload-e2e-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-e2e-images.d.ts","sourceRoot":"","sources":["../../src/cli/upload-e2e-images.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAwOH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8J7E"}

package/dist/cli/validate-waves.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI handler for `codebyplan validate-waves`.
+ *
+ * Usage:
+ *   codebyplan validate-waves [plan.json] [--json]
+ *   echo '{"waves":[...]}' | codebyplan validate-waves [--json]
+ *
+ * Input: a JSON file path (first positional arg) or JSON on stdin.
+ * Accepts either:
+ *   { waves: [...] }   full plan object
+ *   [...]              bare waves array
+ *
+ * Output:
+ *   ok:true   → human success line to stdout; exit 0.
+ *   ok:false  → violations to stderr (or JSON to stdout with --json); exit 1.
+ *
+ * Exit codes:
+ *   0 — all invariants pass
+ *   1 — one or more violations, or input error
+ */
+export declare function runValidateWavesCommand(args: string[]): Promise<number>;
+//# sourceMappingURL=validate-waves.d.ts.map

package/dist/cli/validate-waves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-waves.d.ts","sourceRoot":"","sources":["../../src/cli/validate-waves.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAwBH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwG7E"}

package/dist/cli/version-status.d.ts

@@ -0,0 +1,42 @@
+/**
+ * CLI handler for `codebyplan version-status`.
+ *
+ * Performs pure DETECTION: reports the installed vs latest codebyplan version
+ * and whether an auto-update should be guarded. Never mutates anything.
+ *
+ * Exit behaviour (always exits 0 — safe for scripted consumption):
+ *   - Emits a single JSON object to stdout then exits 0
+ *   - On ANY unhandled error → emits fail-safe JSON and exits 0
+ *
+ * JSON output keys:
+ *   installed      — running version (from npm_package_version)
+ *   latest         — latest version from npm registry, or null on network failure
+ *   newer          — true iff latest > installed (semver)
+ *   packageManager — "pnpm" | "yarn" | "npm" (detected from lockfiles)
+ *   installCommand — local install command for the detected PM
+ *   guarded        — true when auto-update must be skipped
+ *   guardReason    — "protected_branch" | "canonical_source" | "unknown" | null
+ *                    ("unknown" = detection failed; guard conservatively)
+ */
+type GuardReason = "protected_branch" | "canonical_source" | "unknown" | null;
+/**
+ * Fetch latest version of the codebyplan package from the npm registry.
+ * Returns null on ANY failure (network timeout, registry unavailable, etc.).
+ */
+export declare function fetchLatestVersion(): string | null;
+/**
+ * Determine the guard reason. Canonical source wins if both apply.
+ *
+ * canonical_source: gitRoot/packages/codebyplan-package/package.json exists and
+ *   its `name` field === "codebyplan".
+ *
+ * protected_branch: current branch is in .codebyplan/git.json branch_config.protected[]
+ *   OR equals "main".
+ */
+export declare function resolveGuard(gitRoot: string | null, currentBranch: string): Promise<{
+    guarded: boolean;
+    guardReason: GuardReason;
+}>;
+export declare function runVersionStatus(): Promise<void>;
+export {};
+//# sourceMappingURL=version-status.d.ts.map

package/dist/cli/version-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-status.d.ts","sourceRoot":"","sources":["../../src/cli/version-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,KAAK,WAAW,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAC;AAgC9E;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAalD;AAwDD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC,CA4EzD;AAMD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CA6CtD"}

package/dist/cli/watch.d.ts

@@ -0,0 +1,18 @@
+/**
+ * CLI handler for `codebyplan watch`.
+ *
+ * Subcommands:
+ *   start   — spawn the daemon in background (idempotent)
+ *   stop    — SIGTERM the daemon + remove pidfile
+ *   status  — print daemon status (--json for machine-readable)
+ *   run     — run the daemon in foreground (used internally by `start`)
+ *
+ * Pidfile layout:
+ *   <repoRoot>/.codebyplan/state/_watch/<branchSlug|'default'>.pid
+ *   <repoRoot>/.codebyplan/state/_watch/<branchSlug|'default'>.health.json
+ *
+ * All FS operations are advisory / non-throwing (mirror state-store.ts contract).
+ * Always exits 0 — hook-safe.
+ */
+export declare function runWatchCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiXH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CnE"}

package/dist/cli/whoami.d.ts

@@ -0,0 +1,5 @@
+export interface WhoamiOpts {
+    json?: boolean;
+}
+export declare function runWhoami(opts?: WhoamiOpts): Promise<void>;
+//# sourceMappingURL=whoami.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../src/cli/whoami.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiCD,wBAAsB,SAAS,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCpE"}

package/dist/cli/worktree/add.d.ts

@@ -0,0 +1,81 @@
+/**
+ * CLI entry point for `codebyplan worktree add <CHK-NNN>`.
+ *
+ * Usage: codebyplan worktree add <CHK-NNN | CHK-007 | bare-number>
+ *
+ * Looks up the checkpoint's branch_name via MCP, verifies it is available at
+ * origin, adds a git worktree at <parent>/<base>-CHK-NNN (T3-D1 naming), copies
+ * config stubs into it, and registers it in CodeByPlan via the REST API.
+ *
+ * Output JSON:
+ *   { status: 'added',        worktree_path, branch_name, worktree_id? }
+ *   { status: 'branch_pending', message }   — branch not yet created (exit 0, DISC4)
+ *   { status: 'branch_not_ready', message } — branch absent at origin after retries (exit 1)
+ *   { error: string }                        — on stderr for hard errors (exit 1)
+ *
+ * Exit: 0 on success or branch_pending; 1 on usage/hard errors or branch_not_ready.
+ */
+export type BranchLookupResult = {
+    found: true;
+    branch_name: string;
+} | {
+    found: false;
+    pending: boolean;
+    message: string;
+};
+export interface GitRunResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+}
+export interface AddWorktreeDeps {
+    cwd?: string;
+    /** Override repo_id resolution from .codebyplan/repo.json. */
+    getRepoId?: (cwd: string) => Promise<string | null>;
+    /**
+     * Look up the branch_name for a checkpoint number.
+     * Returns found=true + branch_name, or found=false + pending/message.
+     */
+    lookupBranch?: (repoId: string, checkpointNumber: number) => Promise<BranchLookupResult>;
+    /** Override git invocations (fetch, ls-remote, worktree add). */
+    gitRun?: (args: string[], cwd: string) => GitRunResult;
+    /** Override sleep for retry back-off (injectable for tests). */
+    sleep?: (ms: number) => Promise<void>;
+    /** Override config-stub copy (.mcp.json, .env.local, .codebyplan/repo.json). */
+    copyConfigStubs?: (srcCwd: string, destPath: string) => Promise<void>;
+}
+export interface AddWorktreeResult {
+    status: "added" | "branch_pending" | "branch_not_ready";
+    worktree_path?: string;
+    branch_name?: string;
+    message?: string;
+    warn?: string;
+}
+/**
+ * Copy `.claude/settings.json` and `.claude/settings.local.json` from srcCwd
+ * to destPath. Creates `.claude/` in the destination when needed.
+ *
+ * Non-fatal: skips a file silently when:
+ *   - it is absent in the source
+ *   - it already exists in the destination (never overwrite)
+ *
+ * Exported so `worktree/create.ts` can share the same logic.
+ */
+export declare function copyClaudeSettings(srcCwd: string, destPath: string, deps?: {
+    readFileFn?: (p: string) => Promise<string>;
+    writeFileFn?: (p: string, content: string) => Promise<void>;
+    existsFn?: (p: string) => Promise<boolean>;
+    mkdirFn?: (p: string, opts: {
+        recursive: boolean;
+    }) => Promise<void>;
+}): Promise<void>;
+/**
+ * Run `codebyplan worktree add <CHK-NNN>`.
+ *
+ * @param args  Remaining args after "add" was stripped — e.g. ["CHK-207"]
+ * @param deps  Injectable deps for testing.
+ * @returns     Exit code: 0 on success or branch_pending; 1 on errors.
+ */
+export declare function runWorktreeAdd(args: string[], deps?: AddWorktreeDeps): Promise<number>;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/worktree/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/worktree/add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpD;;;OAGG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,KACrB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;IACvD,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,gFAAgF;IAChF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IACJ,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE,GACL,OAAO,CAAC,IAAI,CAAC,CAgCf;AA8DD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqJjB"}

package/dist/cli/worktree/create.d.ts

@@ -0,0 +1,46 @@
+/**
+ * CLI entry point for `codebyplan worktree create <name>`.
+ *
+ * Usage: codebyplan worktree create <name> [--path <abs>]
+ *
+ * Writes .codebyplan/ config files into an already-git-worktree-added path
+ * and registers the worktree in CodeByPlan via the REST API.
+ *
+ * The git worktree add itself is intentionally left to the cbp-git-worktree-create
+ * skill — this CLI only writes files + registers (planner decision).
+ *
+ * Output JSON: { worktree_files_written: boolean, mcp_registered: boolean, worktree_id?, warn? }
+ * Exit: 0 on success or non-fatal failure; 1 on usage error.
+ */
+import { type FsDeps } from "../../lib/worktree.js";
+/** Repo identity read from the current repo's `.codebyplan/repo.json`. */
+export interface RepoIdentity {
+    repo_id: string;
+    organization_id?: string;
+    project_id?: string;
+}
+export interface CreateWorktreeDeps {
+    cwd?: string;
+    fsDeps?: FsDeps;
+    /** Override repo identity resolution. Returns null when not in a CBP project. */
+    getRepoIdentity?: (cwd: string) => Promise<RepoIdentity | null>;
+    /**
+     * Override the .claude/settings copy step.
+     * Called after createWorktreeFiles() succeeds; failure is non-fatal.
+     * Defaults to copyClaudeSettings(srcCwd, destPath).
+     */
+    copyClaudeSettingsFn?: (srcCwd: string, destPath: string) => Promise<void>;
+}
+export interface CreateWorktreeResult {
+    worktree_files_written: boolean;
+    warn?: string;
+}
+/**
+ * Run `codebyplan worktree create`.
+ *
+ * @param args  Remaining args after "create" was stripped — e.g. ["my-branch", "--path", "/abs/path"]
+ * @param deps  Injectable deps for testing.
+ * @returns     Exit code: 0 success / non-fatal, 1 usage error.
+ */
+export declare function runWorktreeCreate(args: string[], deps?: CreateWorktreeDeps): Promise<number>;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/worktree/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cli/worktree/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOzE,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChE;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAgCD,MAAM,WAAW,oBAAoB;IACnC,sBAAsB,EAAE,OAAO,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA0FjB"}

package/dist/cli/worktree/path.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared worktree-path utility.
+ *
+ * Single source of truth for the T3-D1 naming convention used by both
+ * `worktree add` and `worktree remove`:
+ *   <parent>/<base>-CHK-NNN
+ *
+ * Example: cwd=/Users/foo/codebyplan-web-2, number=207
+ *   → /Users/foo/codebyplan-web-2-CHK-207
+ */
+/**
+ * Compute the git worktree path for a given checkpoint number.
+ *
+ * @param cwd              Absolute path to the current (home) worktree.
+ * @param checkpointNumber Checkpoint number (e.g. 207).
+ * @returns                Absolute path to the per-checkpoint sibling worktree.
+ */
+export declare function computeWorktreePath(cwd: string, checkpointNumber: number): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/cli/worktree/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/cli/worktree/path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAKR"}

package/dist/cli/worktree/remove.d.ts

@@ -0,0 +1,92 @@
+/**
+ * CLI entry point for `codebyplan worktree remove <name|CHK-NNN|abs-path>`.
+ *
+ * Usage: codebyplan worktree remove <name>         (legacy name-based path)
+ *        codebyplan worktree remove <CHK-NNN>      (checkpoint path — git rm + Supabase teardown)
+ *        codebyplan worktree remove <bare-number>  (same as CHK-NNN)
+ *        codebyplan worktree remove <abs-path>     (direct path — same logic as CHK-NNN without number computation)
+ *
+ * Legacy path: deregistration retired in CHK-225 TASK-3; returns { mcp_deregistered: false } with no MCP call.
+ * CHK-NNN / abs-path: performs git worktree remove and Supabase preview-branch teardown; deregistration removed.
+ *
+ * Output JSON:
+ *   Legacy:  { mcp_deregistered: boolean, warn? }
+ *   CHK-NNN / abs-path: { mcp_deregistered: boolean, git_removed: boolean, supabase_torn_down: boolean,
+ *                          remote_branch_deleted?: boolean, local_branch_deleted?: boolean, warn? }
+ *
+ * Exit: 0 on success or non-fatal failure; 1 on usage error; 2 when cwd is inside the target worktree.
+ */
+export interface GitRunResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+}
+export interface SupabaseTeardownResult {
+    deleted: boolean;
+    warn?: string;
+}
+export interface RemoveWorktreeDeps {
+    cwd?: string;
+    /** Override git invocations (worktree remove, symbolic-ref). */
+    gitRun?: (args: string[], cwd: string) => GitRunResult;
+    /**
+     * Resolve the branch checked out in a worktree directory.
+     * Called before git worktree remove so the branch name is available for teardown.
+     * Returns null when the worktree path is missing or git fails.
+     */
+    getWorktreeBranchName?: (worktreePath: string) => string | null;
+    /**
+     * Delete the Supabase preview branch for a git branch.
+     * Non-fatal: returns { deleted: false, warn } on any failure.
+     * Idempotent: not-found is success ({ deleted: true }).
+     */
+    deleteSupabaseBranch?: (branchName: string, cwd: string) => Promise<SupabaseTeardownResult>;
+    /**
+     * Guard: returns true when cwd is the worktree being removed or a child of it.
+     * When true, removal is aborted with exit code 2.
+     * Default: cwd === worktreePath || cwd.startsWith(worktreePath + sep)
+     */
+    isInsideWorktreePath?: (worktreePath: string, cwd: string) => boolean;
+    /**
+     * Verify the remote branch exists (ls-remote --exit-code) and delete it when found.
+     * Non-fatal: failures emit warnings and never change the exit code.
+     * Returns { remote_branch_deleted: boolean, warn?: string }.
+     */
+    verifyAndDeleteRemoteBranch?: (branchName: string, cwd: string) => Promise<{
+        remote_branch_deleted: boolean;
+        warn?: string;
+    }>;
+    /**
+     * Delete the local tracking branch after the worktree has been removed.
+     * Attempts `git branch -d` first; escalates to `git branch -D` only when the
+     * remote is confirmed gone (remote_is_gone === true).
+     * Non-fatal: failures emit warnings and never change the exit code.
+     * Returns { local_branch_deleted: boolean, warn?: string }.
+     */
+    deleteFeatBranch?: (branchName: string, cwd: string, remote_is_gone: boolean) => Promise<{
+        local_branch_deleted: boolean;
+        warn?: string;
+    }>;
+}
+export interface RemoveWorktreeResult {
+    mcp_deregistered: boolean;
+    /** CHK-NNN / abs-path: whether git worktree remove succeeded. */
+    git_removed?: boolean;
+    /** CHK-NNN / abs-path: whether the Supabase preview branch was deleted. */
+    supabase_torn_down?: boolean;
+    /** CHK-NNN / abs-path: whether the remote git branch was deleted. */
+    remote_branch_deleted?: boolean;
+    /** CHK-NNN / abs-path: whether the local git branch was deleted. */
+    local_branch_deleted?: boolean;
+    warn?: string;
+}
+/**
+ * Run `codebyplan worktree remove`.
+ *
+ * @param args  Remaining args after "remove" was stripped — e.g. ["my-branch"], ["CHK-207"], or ["/abs/path"]
+ * @param deps  Injectable deps for testing.
+ * @returns     Exit code: 0 success / non-fatal, 1 usage error, 2 cwd-inside guard.
+ */
+export declare function runWorktreeRemove(args: string[], deps?: RemoveWorktreeDeps): Promise<number>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/cli/worktree/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/cli/worktree/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IAIb,gEAAgE;IAChE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;IACvD;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAChE;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CACrB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACtE;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,CAC5B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC;QAAE,qBAAqB,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,OAAO,KACpB,OAAO,CAAC;QAAE,oBAAoB,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAoOD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA4LD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAgCjB"}