codebyplan 1.13.65 → 1.13.66

package/dist/cli/e2e/verify-round.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-round.d.ts","sourceRoot":"","sources":["../../../src/cli/e2e/verify-round.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAO1D,UAAU,YAAY;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAMD,MAAM,WAAW,eAAe;IAC9B,6FAA6F;IAC7F,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrD,6EAA6E;IAC7E,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC1D,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAoBD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAMD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAwFf"}

package/dist/cli/e2e.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI handler for `codebyplan e2e <subcommand>`.
+ *
+ * Two-level subcommand dispatcher — no Commander dependency.
+ * Mirrors the runWorktreeCommand shape from cli/worktree.ts.
+ *
+ * Subcommands:
+ *   verify-round   Verify the three E2E hard-fails for a completed round
+ */
+export declare function runE2eCommand(args: string[]): Promise<number>;
+//# sourceMappingURL=e2e.d.ts.map

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

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

package/dist/cli/eslint.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CLI eslint command — init ESLint configs.
+ *
+ * `codebyplan eslint init`  — Detect tech stack, resolve presets, generate config, install deps
+ */
+/**
+ * Auto-detect package-specific ESLint ignore patterns based on files present
+ * in the target directory. Returns a list of glob patterns to add to the
+ * generated config's `ignores:` array.
+ *
+ * Signals:
+ *   - `esbuild.js` or `esbuild.<variant>.{mjs,cjs,js}` → add each filename
+ *   - `vitest.config.{ts,mts,js,mjs}` → add matching filename
+ *   - `vite.config.{ts,mts,js,mjs}` → add matching filename
+ *   - `tauri.conf.json` → add `src-tauri` glob AND `.d.ts` glob
+ */
+export declare function autoDetectIgnorePatterns(absPath: string): Promise<string[]>;
+export declare function eslintInit(repoId: string, projectPath: string): Promise<void>;
+export declare function runEslint(): Promise<void>;
+//# sourceMappingURL=eslint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.d.ts","sourceRoot":"","sources":["../../src/cli/eslint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAwDnB;AA+ED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAuPf;AAMD,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAmB/C"}

package/dist/cli/export-writer.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Shared export helper for checkpoint and standalone-task workflow data.
+ *
+ * This module is intentionally PURE — no process.exit, no process.argv reads,
+ * no side-effectful imports beyond node:fs. Every function takes explicit args
+ * and returns a value so it is straightforwardly unit-testable.
+ *
+ * Data sources:
+ *   - Checkpoint: REST apiGet (GET /checkpoints/:id, GET /tasks?checkpoint_id=)
+ *   - Rounds per task: MCP mcpCall('get_rounds', { task_id })
+ *   - Standalone task: MCP mcpCall('get_standalone_tasks', { repo_id })
+ *   - Standalone rounds: MCP mcpCall('get_standalone_rounds', { standalone_task_id })
+ *
+ * Export artifact layout (written by writeExportArtifacts):
+ *   .codebyplan/exports/{N}/export.json   — machine-readable
+ *   .codebyplan/exports/{N}/summary.md    — human-readable
+ *
+ * export.json schema (schema_version: 1):
+ *   { schema_version, exported_at, checkpoint_id|standalone_task_id,
+ *     number, title, status, completed_at, context, files_changed, qa,
+ *     tasks: [{ id, number, title, status, completed_at, files_changed, qa,
+ *               rounds: [{ id, number, status, files_changed, context }] }] }
+ */
+export declare const EXPORT_SCHEMA_VERSION = 1;
+export interface ExportRound {
+    id: string;
+    number: number;
+    status: string;
+    files_changed: unknown[];
+    context: unknown;
+}
+export interface ExportTask {
+    id: string;
+    number: number;
+    title: string | null;
+    status: string;
+    completed_at: string | null;
+    files_changed: unknown[];
+    qa: unknown;
+    rounds: ExportRound[];
+}
+export interface CheckpointExportData {
+    schema_version: typeof EXPORT_SCHEMA_VERSION;
+    exported_at: string;
+    checkpoint_id: string;
+    number: number;
+    /** Checkpoint sync_seq at export time — used as the stamp's OCC token. */
+    sync_seq?: number;
+    title: string | null;
+    status: string;
+    completed_at: string | null;
+    context: unknown;
+    files_changed: unknown[];
+    qa: unknown;
+    tasks: ExportTask[];
+}
+export interface StandaloneExportData {
+    schema_version: typeof EXPORT_SCHEMA_VERSION;
+    exported_at: string;
+    standalone_task_id: string;
+    number: number;
+    title: string;
+    status: string;
+    completed_at: string | null;
+    context: unknown;
+    files_changed: unknown[];
+    qa: unknown;
+    tasks: ExportTask[];
+}
+export type ExportData = CheckpointExportData | StandaloneExportData;
+/**
+ * Fetch checkpoint + tasks + rounds from the API/MCP and assemble the export
+ * object. Does NOT write to disk.
+ *
+ * Transport:
+ *   - Checkpoint:    REST GET /checkpoints/:id
+ *   - Tasks:         REST GET /tasks?checkpoint_id=  (the route exists and
+ *                    accepts this filter — verified against apps/web routes)
+ *   - Rounds:        MCP get_rounds({ task_id })
+ */
+export declare function buildCheckpointExport(checkpointId: string): Promise<CheckpointExportData>;
+/**
+ * Fetch standalone task + rounds from MCP and assemble the export object.
+ * Does NOT write to disk.
+ */
+export declare function buildStandaloneExport(taskId: string, repoRoot: string, repoIdHint?: string): Promise<StandaloneExportData>;
+/**
+ * Pure markdown renderer. No I/O.
+ */
+export declare function renderSummaryMd(data: ExportData): string;
+/**
+ * Write export.json and summary.md into outDir (created recursively).
+ * Returns the paths written.
+ */
+export declare function writeExportArtifacts(outDir: string, exportData: ExportData, summaryMd: string): {
+    exportJsonPath: string;
+    summaryMdPath: string;
+};
+//# sourceMappingURL=export-writer.d.ts.map

package/dist/cli/export-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-writer.d.ts","sourceRoot":"","sources":["../../src/cli/export-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAWH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAMvC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,OAAO,qBAAqB,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,OAAO,qBAAqB,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAiDrE;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CA2D/B;AAMD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAgE/B;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAsExD;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,GAChB;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAcnD"}

package/dist/cli/handoff.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI handler for `codebyplan handoff <subcommand>`.
+ *
+ * Two-level subcommand dispatcher — no Commander dependency.
+ * Subcommands:
+ *   read    --level <l> [--number N] [--task T]             Print current content
+ *   write   --level <l> [--number N] [--task T] --content   Replace content
+ *   append  --level <l> [--number N] [--task T] --content   Append to existing
+ *   clear   --level <l> [--number N] [--task T]             Empty + delete file
+ *   status  [--json]                                        List non-empty handoffs
+ */
+export declare function runHandoffCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=handoff.d.ts.map

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

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

package/dist/cli/login.d.ts

@@ -0,0 +1,10 @@
+export declare function fetchEmail(accessToken: string): Promise<string | null>;
+export interface LoginResult {
+    user_id: string;
+    email: string | null;
+}
+export interface LoginOptions {
+    admin?: boolean;
+}
+export declare function runLogin(options?: LoginOptions): Promise<LoginResult>;
+//# sourceMappingURL=login.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/cli/login.ts"],"names":[],"mappings":"AAQA,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe5E;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,QAAQ,CAC5B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA0DtB"}

package/dist/cli/logout.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/cli/logout.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAI/C"}

package/dist/cli/lsp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI lsp command — detect tech stack, enable LSP plugins, install language servers.
+ *
+ * `codebyplan lsp`          — Full mode: detect stack, update settings.local.json, install servers
+ * `codebyplan lsp --check`  — Check mode: re-check binaries, prune resolved nudge files
+ *
+ * Unlike eslint/tech-stack, this command:
+ *   - requires NO auth (no validateAuth, resolveConfig, apiGet, apiPost)
+ *   - operates entirely locally: reads .codebyplan/lsp.json, .claude/settings.local.json
+ *   - safe to run inside `codebyplan claude install` in OAuth-less environments
+ */
+export declare function runLspFull(projectPath: string, opts?: {
+    dryRun?: boolean;
+}): Promise<void>;
+export declare function runLsp(): Promise<void>;
+//# sourceMappingURL=lsp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/cli/lsp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwEH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Jf;AAqDD,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB5C"}

package/dist/cli/migration-collisions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI entry point for `codebyplan migration-collisions`.
+ *
+ * Usage: codebyplan migration-collisions [--base <branch>] [--json]
+ *
+ * Output JSON: { base, collisions: [{ prefix, ours: string[], theirs: string[] }] }
+ * Exit: 0 always.
+ */
+export declare function runMigrationCollisionsCommand(args: string[]): number;
+//# sourceMappingURL=migration-collisions.d.ts.map

package/dist/cli/migration-collisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-collisions.d.ts","sourceRoot":"","sources":["../../src/cli/migration-collisions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAyBpE"}

package/dist/cli/ports.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `codebyplan ports` — verify and optionally fix port allocations.
+ *
+ * Two additional local-config modes layer on top of the verify flow:
+ *   --write-local    Write this worktree's port allocations to the gitignored
+ *                    `.codebyplan/server.local.json` overlay (never the committed
+ *                    `server.json`). Reads from the DB via the shared resolver.
+ *   --provision-e2e  Copy the canonical E2E credentials from `apps/web/.env.local`
+ *                    into the gitignored `.codebyplan/e2e.env`. Purely local — no
+ *                    network, no API key required.
+ *
+ * Both are non-destructive: they touch ONLY the two gitignored overlay files and
+ * never write `server.json`, `git.json`, `repo.json`, `shipment.json`, or the
+ * legacy `.codebyplan.json` (avoiding the `codebyplan config` clobber footgun).
+ */
+export declare function runPorts(): Promise<void>;
+/**
+ * Parse a `.env`-style file into a key→value map.
+ * - Skips blank lines and `#` comment lines.
+ * - Splits on the FIRST `=` (so base64/`==`-padded values survive intact).
+ * - Quoted values: strips a single pair of matching surrounding quotes; any `#`
+ *   inside the quotes is literal.
+ * - Unquoted values: a ` #` begins an inline comment (dotenv semantics) and is
+ *   stripped, so `KEY=https://x  # note` yields `https://x`.
+ *
+ * Exported for direct unit testing of the parsing edge cases.
+ */
+export declare function parseEnvFile(raw: string): Record<string, string>;
+//# sourceMappingURL=ports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/cli/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiDH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAqJ9C;AA8ID;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBhE"}

package/dist/cli/process-exit-signal.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared hook-safe sentinel used by hook-callable subcommands
+ * (version-status) to distinguish test-injected `process.exit` stubs from
+ * real unexpected errors.
+ *
+ * In production, `process.exit` terminates the process immediately. In test
+ * environments, the stubs throw a `ProcessExitSignal` instead. Each handler's
+ * outer `catch` re-throws `ProcessExitSignal` so the test sees the expected
+ * rejection rather than the catch-all masking an in-process exit.
+ *
+ * Single definition here preserves `instanceof` integrity across all consumers:
+ * the throw site (test stub) and the catch site (handler) must reference the
+ * exact same class constructor. A second copy in any file would break the check.
+ */
+/**
+ * Sentinel thrown by test stubs for process.exit — distinguishes
+ * test-injected exits from real unexpected errors.
+ * @internal
+ */
+export declare class ProcessExitSignal extends Error {
+    readonly code: number;
+    constructor(code: number);
+}
+//# sourceMappingURL=process-exit-signal.d.ts.map

package/dist/cli/process-exit-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-exit-signal.d.ts","sourceRoot":"","sources":["../../src/cli/process-exit-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM;CAKzB"}

package/dist/cli/round.d.ts

@@ -0,0 +1,79 @@
+/**
+ * CLI handler for `codebyplan round <subcommand>`.
+ *
+ * Two-level subcommand dispatcher — no Commander dependency.
+ * Subcommands:
+ *   sync-approvals   Sync git diff and approvals with round/task state
+ *   add              Create a new round (local-first + backend write-through)
+ *   update           Update a round (local-first + backend write-through)
+ *   complete         Complete a round (local-first + backend write-through)
+ */
+import { type FilesChangedEntry } from "../lib/sync-approvals.js";
+import { type Round } from "../lib/types.js";
+type McpRound = Pick<Round, "id"> & {
+    files_changed?: FilesChangedEntry[];
+    context?: {
+        improve_round_findings?: unknown[];
+        outstanding_findings?: unknown[];
+        testing_qa_output?: {
+            totals?: {
+                hard_fail?: boolean;
+            };
+        };
+    };
+};
+/**
+ * Delay in milliseconds between retries. Exposed as a module-level constant
+ * so tests can override it to 0 for fast execution.
+ */
+export declare let RETRY_DELAY_MS: number;
+/**
+ * Maximum number of OCC conflict retries for update/complete write verbs.
+ * On a 409 the verb re-reads the fresh row, merges intent, and retries up to
+ * this many additional times before surfacing a conflict error to the user.
+ */
+export declare const MAX_OCC_RETRIES = 3;
+/**
+ * Override the retry delay (used in tests to avoid real sleeps).
+ */
+export declare function setRetryDelayMs(ms: number): void;
+/**
+ * Returns true for errors that are transient and safe to retry:
+ *   - McpError with status 500-599 (gateway / server error)
+ *   - McpError with no status whose message includes "network error"
+ *     (AbortController timeout, fetch failure)
+ *
+ * Returns false for:
+ *   - 4xx (incl. 401 auth failures) — non-transient, must not retry
+ *   - Missing API key — config error, must not degrade
+ *   - Non-McpError errors (git failures, JSON parse, etc.)
+ */
+export declare function isTransientMcpError(err: unknown): boolean;
+/**
+ * Fetches rounds for a task with up to 2 retry attempts on transient errors.
+ * On a transient error after all retries, re-throws the last error.
+ * On a non-transient error, re-throws immediately.
+ */
+export declare function fetchRoundsWithRetry(taskId: string, options?: {
+    retries?: number;
+    delayMs?: number;
+}): Promise<McpRound[]>;
+export declare function runRoundCommand(args: string[]): Promise<void>;
+export declare function runRoundAdd(args: string[]): Promise<void>;
+export declare function runRoundUpdate(args: string[]): Promise<void>;
+export declare function runRoundComplete(args: string[]): Promise<void>;
+/**
+ * Canonical git-status invocation for sync-approvals.
+ *
+ * `--untracked-files=all` is REQUIRED: without it git collapses a brand-new
+ * untracked directory into a single `?? dir/` token. parseGitStatus correctly
+ * skips dir-slash tokens (they are not files), so every file nested inside a
+ * new untracked directory would be invisible to the diff merge and its
+ * existing DB row would be wrongly stale-marked (observed live, CHK-191
+ * TASK-5 R1). With `-uall`, untracked files always arrive as per-file
+ * `?? dir/file.ts` tokens. `-z` (NUL delimiting) must remain last.
+ */
+export declare const GIT_STATUS_CMD = "git status --short --porcelain --untracked-files=all -z";
+export declare function runRoundSyncApprovals(args: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=round.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"round.d.ts","sourceRoot":"","sources":["../../src/cli/round.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAuB,KAAK,KAAK,EAAa,MAAM,iBAAiB,CAAC;AAmC7E,KAAK,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG;IAClC,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE;QACR,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC;QACnC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC;QACjC,iBAAiB,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE;gBAAE,SAAS,CAAC,EAAE,OAAO,CAAA;aAAE,CAAA;SAAE,CAAC;KAC1D,CAAC;CACH,CAAC;AAMF;;;GAGG;AACH,eAAO,IAAI,cAAc,QAAQ,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEhD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOzD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoBrB;AAMD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCnE;AAsCD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoE/D;AAMD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgLlE;AAMD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyIpE;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,4DACgC,CAAC;AAE5D,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2LzE"}

package/dist/cli/scaffold-publish-workflow.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI handler for `codebyplan scaffold-publish-workflow`.
+ *
+ * Reads `templates/github-workflows/publish.yml` from this package and writes
+ * it to `{projectDir}/.github/workflows/publish.yml`. Idempotent — running
+ * twice on an identical target returns a "skipped" result.
+ *
+ * Flags:
+ *   --dry-run           Compute the operation but do NOT write any files
+ *   --force             Overwrite an existing file that differs from the template
+ *   --project-dir <p>   Override the project root (default: cwd)
+ *   --json              Write structured JSON output to stdout
+ *   --help              Print this help and exit
+ */
+export declare function runScaffoldPublishWorkflowCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=scaffold-publish-workflow.d.ts.map

package/dist/cli/scaffold-publish-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-publish-workflow.d.ts","sourceRoot":"","sources":["../../src/cli/scaffold-publish-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgDH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/cli/session/freshness-gate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI entry point for `codebyplan session freshness-gate`.
+ *
+ * Usage: codebyplan session freshness-gate [--halt-on-update]
+ *
+ * Replicates cbp-session-start Step 1.6 version freshness check.
+ *
+ * Flags:
+ *   --halt-on-update   Set halt:true in output (session-start passes this;
+ *                      session-end does not).
+ *
+ * Output JSON:
+ *   { result: 'skipped'|'guarded'|'up_to_date'|'updated'|'error', ... }
+ * Exit: 0 always — the result field carries the verdict; callers branch on it.
+ */
+import { type FreshnessGateOpts } from "../../lib/session.js";
+export interface FreshnessGateCliDeps extends FreshnessGateOpts {
+    cwd?: string;
+}
+export declare function freshnessGateCli(args: string[], deps?: FreshnessGateCliDeps): Promise<number>;
+//# sourceMappingURL=freshness-gate.d.ts.map

package/dist/cli/session/freshness-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness-gate.d.ts","sourceRoot":"","sources":["../../../src/cli/session/freshness-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/cli/session/home-ff.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI entry point for `codebyplan session home-ff`.
+ *
+ * Usage: codebyplan session home-ff
+ *
+ * Replicates cbp-session-start Step 1.4 / cbp-session-end fast-forward logic.
+ *
+ * Output JSON: { result: 'skipped'|'warn'|'fast_forwarded', reason?, warn? }
+ * Exit: 0 always — warn/skipped results are not errors; the skill branches on result.
+ */
+import { type HomeFfOpts } from "../../lib/session.js";
+export interface HomeFfCliDeps extends HomeFfOpts {
+    cwd?: string;
+}
+export declare function homeFfCli(_args: string[], deps?: HomeFfCliDeps): number;
+//# sourceMappingURL=home-ff.d.ts.map

package/dist/cli/session/home-ff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-ff.d.ts","sourceRoot":"","sources":["../../../src/cli/session/home-ff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAI3E"}

package/dist/cli/session/infra-files.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI entry point for `codebyplan session infra-files`.
+ *
+ * Usage: codebyplan session infra-files [--task-files <csv>] [--json]
+ *
+ * Replicates cbp-session-start Step 5.7 infra-file set math.
+ *
+ * Flags:
+ *   --task-files <csv>   Comma-separated list of the active task's round files
+ *                        (primary deterministic mechanism; default empty).
+ *   --json               Accepted for forward compatibility; output is always JSON.
+ *
+ * Output JSON: { infra_files: string[], task_files: string[], note?: string }
+ * Exit: 0 always.
+ */
+import { type InfraFilesOpts } from "../../lib/session.js";
+export interface InfraFilesCliDeps extends InfraFilesOpts {
+    cwd?: string;
+}
+export declare function infraFilesCli(args: string[], deps?: InfraFilesCliDeps): Promise<number>;
+//# sourceMappingURL=infra-files.d.ts.map

package/dist/cli/session/infra-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infra-files.d.ts","sourceRoot":"","sources":["../../../src/cli/session/infra-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/cli/session/start.d.ts

@@ -0,0 +1,70 @@
+/**
+ * CLI entry point for `codebyplan session start`.
+ *
+ * Orchestrates the deterministic steps of /cbp-session-start in ONE process
+ * and emits a single JSON envelope on stdout. Collapses ~13 Claude tool
+ * round-trips into 1.
+ *
+ * Steps (mirror SKILL ordering):
+ *  1. Resolve repo root + repo_id
+ *  2. resolveUserJson (codebyplan whoami --json → user_id)
+ *  3. freshnessGate — update_halt short-circuit (no activate, no create-log)
+ *  4. infraDriftNudge + archMapDriftNudge + lspNudge
+ *  5. Read previous session log (local-first; sync on miss)
+ *  6. probeHandoff (uses previous row BEFORE create-log overwrites it)
+ *  7. update-state activate (write-through)
+ *  8. create-log → session_log_id
+ *  9. infra-files set math (todos.json → task files → git delta)
+ * 10. get_checkpoints + partitionOwnership
+ * 11. computeNextAction + renderBlock → emit JSON envelope
+ *
+ * Exit: 0 always — failures are embedded in the envelope as null/empty fields.
+ * Output: exactly one JSON line on stdout.
+ */
+import { freshnessGate, type ResolveUserJsonOpts, type InfraDriftNudgeOpts, type ArchMapDriftNudgeOpts, type LspNudgeOpts, type ProbeHandoffOpts, type InfraFilesOpts, type SessionLogRow } from "../../lib/session.js";
+export interface SessionStartDeps {
+    /** cwd override — defaults to process.cwd() */
+    cwd?: string;
+    resolveRepo?: (cwd: string) => Promise<{
+        repoRoot: string;
+        repoId: string;
+    } | null>;
+    freshnessGate?: typeof freshnessGate;
+    resolveUserRunner?: ResolveUserJsonOpts["run"];
+    infraDriftRunner?: InfraDriftNudgeOpts["run"];
+    infraDriftExistsSync?: InfraDriftNudgeOpts["existsSync"];
+    archMapDriftRunner?: ArchMapDriftNudgeOpts["run"];
+    archMapDriftExistsSync?: ArchMapDriftNudgeOpts["existsSync"];
+    lspRunner?: LspNudgeOpts["run"];
+    readEntity?: ProbeHandoffOpts["readEntity"];
+    infraFilesRunner?: InfraFilesOpts["run"];
+    updateStateActivate?: (repoId: string, repoRoot: string) => Promise<void>;
+    createLog?: (repoId: string, repoRoot: string) => Promise<string | null>;
+    getCheckpoints?: (repoId: string) => Promise<Array<Record<string, unknown>>>;
+    readPreviousSession?: (repoRoot: string) => Promise<SessionLogRow | null>;
+    resolveTaskFiles?: (repoRoot: string) => Promise<string[]>;
+    runSync?: (cwd: string) => void;
+}
+/**
+ * Build the POST /session-logs body. The backend requires `session_date`
+ * (YYYY-MM-DD) and `day_number` (positive integer) in addition to `repo_id`;
+ * omitting them fails the create with "session_date is required". The session
+ * log is user-level (CHK-225 retired worktree_id from the create body — the
+ * controller keys ownership on the JWT user), so no worktree/user id is threaded
+ * here. Exported for unit testing of the field contract.
+ *
+ * claude_session_id is read from .codebyplan/state/session/session-id.json
+ * (written by the cbp-session-id-stamp.sh SessionStart hook). Non-fatal: the
+ * field is omitted when the file is absent or unparseable.
+ */
+export declare function buildCreateLogBody(repoId: string, now?: Date, claudeSessionId?: string | null): Record<string, unknown>;
+/**
+ * Fetch the repo's active checkpoints via the REST list endpoint. Uses the same
+ * auth-aware `apiGet` path as the rest of the CLI's reads — replaces an earlier
+ * `callMcpTool("get_checkpoints")` whose MCP-envelope parse silently fell back
+ * to `[]`, which made ownership always report 0/0. Exported for unit testing of
+ * the response-shape parse. Fail-safe: any error yields `[]`.
+ */
+export declare function defaultGetCheckpoints(repoId: string): Promise<Array<Record<string, unknown>>>;
+export declare function runSessionStartCli(_args: string[], deps?: SessionStartDeps): Promise<number>;
+//# sourceMappingURL=start.d.ts.map

package/dist/cli/session/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/session/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EACL,aAAa,EAUb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAEnB,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAC;AA8B9B,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IAIb,WAAW,CAAC,EAAE,CACZ,GAAG,EAAE,MAAM,KACR,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAG1D,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IAGrC,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAG/C,gBAAgB,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,oBAAoB,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAGzD,kBAAkB,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAClD,sBAAsB,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAG7D,SAAS,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAGhC,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAG5C,gBAAgB,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAGzC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAGzE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAI7E,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAG1E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAG3D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAwED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,IAAiB,EACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAsDD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAsBzC;AAyFD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwPjB"}

package/dist/cli/session.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI handler for `codebyplan session <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-log | update-log | update-state
+ *
+ * Uses parseFlagsFromArgs pattern (no Commander dependency).
+ */
+export declare function runSessionCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=session.d.ts.map

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

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

package/dist/cli/setup.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AA0JA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAgN9C"}

package/dist/cli/ship.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI handler for `codebyplan ship`.
+ *
+ * Ships the current feat branch to the production base branch via PR.
+ * Mirrors the two-level dispatcher pattern from branch.ts.
+ *
+ * Flags:
+ *   --dry-run          Short-circuit before any mutating operations
+ *   --json             Write JSON result to stdout
+ *   --keep-feat        Do not delete the feat branch after merge
+ *   --body-file <path> Path to a markdown file used as the PR body
+ *   --timeout <secs>   Max seconds to poll required checks (default: 600)
+ *   --no-bump          Skip automatic patch-version bump before push
+ */
+export declare function runShipCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=ship.d.ts.map

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

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

package/dist/cli/slug.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI entry point for `codebyplan slug`.
+ *
+ * Usage: codebyplan slug <title words...>
+ *
+ * Output: plain text — single slug line (no JSON; consumed via $(...) in shell).
+ * Exit: 0 on success, 1 on missing title.
+ */
+export declare function runSlugCommand(args: string[]): number;
+//# sourceMappingURL=slug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/cli/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAyBrD"}