codebyplan 1.13.65 → 1.13.67

package/dist/lib/state-sync.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Sync engine for `.codebyplan/state/`.
+ *
+ * `runSync` fetches delta or full data from the backend `/sync` endpoint and
+ * writes the result to the local state mirror. It is safe to call from hooks
+ * (always returns, never throws).
+ */
+/**
+ * Shape returned by `GET /sync?repo_id&worktree_id&since`.
+ *
+ * Hand-maintained copy of `DeltaSyncResult` from `@codebyplan/data-access`.
+ * codebyplan-package is a standalone published bundle with no workspace deps —
+ * this interface cannot import from `packages/data-access`. Keep aligned with
+ * the 6 sync_seq tables: checkpoints, tasks, rounds, session_logs, todos,
+ * port_allocations.
+ *
+ * NOTE: worktrees was removed from the feed in CHK-225 — the entity is retired.
+ * The backend controller still accepts `worktree_id` as a query param for
+ * back-compat but returns no worktrees rows in the payload.
+ *
+ * NOTE: session_state is NOT a sync_seq table and is absent from /sync — do not
+ * add it here. session/state.json is populated solely by `codebyplan session
+ * update-state` (write-through). See state-store.ts module docblock.
+ */
+export interface DeltaSyncResult {
+    checkpoints: unknown[];
+    tasks: unknown[];
+    rounds: unknown[];
+    session_logs: unknown[];
+    todos: unknown[];
+    port_allocations: unknown[];
+    /**
+     * Tombstone rows for server-side entity deletions since the cursor.
+     * CHK-222 TASK-4: populated from sync_tombstones table. Always an array
+     * (empty when no deletions). sync_seq values are included in max_seq.
+     */
+    deleted: Array<{
+        entity_table: string;
+        entity_id: string;
+        sync_seq: number;
+        parent_ids?: {
+            checkpoint_id?: string;
+            task_id?: string;
+        } | null;
+    }>;
+    /** The highest sequence number in this response. Advance cursor to this. */
+    max_seq: number;
+}
+export interface SyncOptions {
+    /** If true, ignore cursor and do a full hydrate (since=0). */
+    full?: boolean;
+    /** If true, resolve entity paths but skip all writes. */
+    dryRun?: boolean;
+}
+export interface SyncResult {
+    ok: boolean;
+    error?: string;
+    /** Number of entity files written (0 on dry run or error). */
+    written?: number;
+    /** Number of entity files pruned during full hydrate. */
+    pruned?: number;
+    /**
+     * Number of tombstones whose local path resolved and a delete was attempted
+     * (runs on every sync). ENOENT-tolerant: a tombstone for an already-absent
+     * file (e.g. one a prior full-hydrate prune removed) still counts, so this is
+     * "tombstones processed", not strictly "files removed from disk".
+     */
+    tombstoned?: number;
+    /** Whether this was a full hydrate (since=0) or a delta (since>0). */
+    mode?: "full" | "delta";
+    /** The max_seq returned by the backend, if the fetch succeeded. */
+    max_seq?: number;
+    /**
+     * Pending `complete` markers that the outbox CANNOT auto-replay (the complete
+     * endpoint needs a different request shape than a generic PATCH). The local
+     * state for these entities is updated, but the backend was never told — the
+     * user must re-run the complete command. Empty on dry-run (replay is skipped).
+     */
+    pendingCompletions?: Array<{
+        entity: string;
+        id: string;
+    }>;
+}
+/**
+ * Sync local state mirror with the backend.
+ *
+ * - Cold / `--full`: fetches `since=0`, writes all entity files, prunes stale ones,
+ *   advances cursor to `max_seq`.
+ * - Warm (default): reads cursor `sync_seq`, fetches `since=<seq>`, upserts (no prune),
+ *   advances cursor.
+ *
+ * ALL filesystem and network errors are caught and returned as `{ ok: false, error }`.
+ * This function NEVER throws, making it safe to call from hook scripts.
+ *
+ * @param repoRoot   Absolute path to the project root (where `.codebyplan/` lives).
+ * @param repoId     Repository UUID (`repo_id` from `.codebyplan/repo.json`).
+ * @param worktreeId Optional worktree UUID forwarded as a query parameter.
+ * @param opts       Sync options (full, dryRun).
+ */
+export declare function runSync(repoRoot: string, repoId: string, worktreeId?: string, opts?: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=state-sync.d.ts.map

package/dist/lib/state-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-sync.d.ts","sourceRoot":"","sources":["../../src/lib/state-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B;;;;OAIG;IACH,OAAO,EAAE,KAAK,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE;YAAE,aAAa,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KAClE,CAAC,CAAC;IACH,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAqND;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CA6MrB"}

package/dist/lib/statusline-config.d.ts

@@ -0,0 +1,55 @@
+import type { StatuslineConfig, StatuslineLocalConfig } from "./types.js";
+export declare const STATUSLINE_DEFAULTS: StatuslineConfig;
+export declare const DEFAULT_RENDERER: "bash" | "node" | "python";
+/**
+ * Read `.codebyplan/statusline.json`. Returns full STATUSLINE_DEFAULTS when
+ * the file is absent or contains invalid/partial JSON. Missing keys are filled
+ * in from defaults so callers always get a complete object.
+ *
+ * Never throws.
+ */
+export declare function readStatuslineConfig(projectPath: string): Promise<StatuslineConfig>;
+/**
+ * Read `.codebyplan/statusline.local.json`. Returns `null` on any failure
+ * (file absent, bad JSON, unknown renderer string). Mirrors the shape of
+ * `readLocalConfig` in `src/lib/local-config.ts`.
+ *
+ * Never throws.
+ */
+export declare function readStatuslineLocalConfig(projectPath: string): Promise<StatuslineLocalConfig | null>;
+/**
+ * Write `.codebyplan/statusline.json`. Creates the `.codebyplan/` directory
+ * recursively if absent. Output is pretty-printed with a trailing newline to
+ * match other config writers in this package.
+ */
+export declare function writeStatuslineConfig(projectPath: string, config: StatuslineConfig): Promise<void>;
+/**
+ * Write `.codebyplan/statusline.local.json`. Creates the `.codebyplan/`
+ * directory recursively if absent. Validates the renderer value before
+ * writing; throws `TypeError` for unknown renderer strings.
+ */
+export declare function writeStatuslineLocalConfig(projectPath: string, localConfig: StatuslineLocalConfig): Promise<void>;
+/**
+ * Resolve the active renderer for a project. Reads the gitignored local config
+ * and returns its renderer, or `"bash"` when absent or on any error.
+ *
+ * Never throws.
+ */
+export declare function resolveRenderer(projectPath: string): Promise<"bash" | "node" | "python">;
+/**
+ * Probe which script runtimes are available on the current machine.
+ *
+ * - `bash` is always `true` (the statusline bash renderer ships as a self-
+ *   contained shell script; bash is present on every supported platform).
+ * - `node` and `python` are detected by spawning `node --version` /
+ *   `python3 --version` with a short timeout (1 s). The call is synchronous
+ *   and side-effect-free.
+ *
+ * Returns a plain object; never throws.
+ */
+export declare function detectAvailableRenderers(): {
+    bash: boolean;
+    node: boolean;
+    python: boolean;
+};
+//# sourceMappingURL=statusline-config.d.ts.map

package/dist/lib/statusline-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-config.d.ts","sourceRoot":"","sources":["../../src/lib/statusline-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAM1E,eAAO,MAAM,mBAAmB,EAAE,gBAYjC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,QAAiB,CAAC;AAkEnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAmBvC;AAMD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,IAAI,CAAC,CAaf;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAGrC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,IAAI;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB,CAmBA"}

package/dist/lib/structure-generator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Pure, side-effect-free library for generating .claude/generated/structure.md.
+ *
+ * The generated file is wrapped in sentinels:
+ *   <!-- @codebyplan-generated: structure start -->
+ *   ...content...
+ *   <!-- @codebyplan-generated: structure end -->
+ *
+ * To import the generated file into .claude/CLAUDE.md, add this line where you
+ * want the content to appear:
+ *   @.claude/generated/structure.md
+ *
+ * DETERMINISTIC: stable sorted ordering everywhere — no Date.now / new Date /
+ * random. Two calls with identical config produce byte-identical output.
+ */
+export interface PortAllocation {
+    port: number;
+    label: string;
+    server_type: string;
+}
+export interface MonorepoPackage {
+    /** Relative path from project root (e.g. "apps/web") */
+    path: string;
+    /** Scoped package name from package.json (e.g. "@codebyplan/web") */
+    name: string;
+    /** Human-readable purpose / description */
+    purpose?: string;
+}
+export interface ShipmentSurface {
+    /** Surface key (e.g. "supabase", "vercel_mcp") */
+    key: string;
+    /** Platform or type hint (e.g. "supabase", "vercel", "railway", "npm") */
+    platform?: string;
+    /** Primary URL or path for the surface */
+    urlOrPath?: string;
+}
+export interface BranchModel {
+    production: string;
+    protected?: string[];
+}
+/** Input configuration for generateStructureMd. */
+export interface StructureGenConfig {
+    /** Detected tech stack categories — map of category label to comma-joined names. */
+    techStack?: Record<string, string>;
+    /** Package manager string from root package.json (e.g. "pnpm@10.12.4"). */
+    packageManager?: string;
+    /** Workspace packages from monorepo discovery. */
+    packages?: MonorepoPackage[];
+    /** Port allocations from .codebyplan/server.json. */
+    ports?: PortAllocation[];
+    /** Branch model from .codebyplan/git.json. */
+    branchModel?: BranchModel;
+    /** Shipment surfaces from .codebyplan/shipment.json. */
+    shipmentSurfaces?: ShipmentSurface[];
+}
+export declare const SENTINEL_START = "<!-- @codebyplan-generated: structure start -->";
+/**
+ * Generate the structure.md content from the given config.
+ * DETERMINISTIC — no I/O, no side effects, no timestamps or random values.
+ * Re-running with identical config produces byte-identical output.
+ */
+export declare function generateStructureMd(config: StructureGenConfig): string;
+//# sourceMappingURL=structure-generator.d.ts.map

package/dist/lib/structure-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-generator.d.ts","sourceRoot":"","sources":["../../src/lib/structure-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,qDAAqD;IACrD,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC;AAED,eAAO,MAAM,cAAc,oDAAoD,CAAC;AA6FhF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAmCtE"}

package/dist/lib/supabase.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Pure lib for Supabase CLI helpers.
+ *
+ * All public functions accept injectable deps so tests never hit the real
+ * filesystem, git, or gh CLI. No top-level side effects.
+ */
+export interface PreviewBranch {
+    branch: string;
+    project_ref: string;
+    created_at?: string;
+}
+export interface ShipmentConfig {
+    parentRef: string | null;
+    previewBranches: PreviewBranch[];
+}
+export interface GitConfig {
+    production: string;
+    protected: string[];
+    integration: string | null;
+}
+/** Synchronous command runner — cmd + args → stdout string (throws on error). */
+export type RunFn = (cmd: string, args: string[]) => string;
+export interface DetectDbChangedOpts {
+    cwd?: string;
+    base?: string;
+    dbPaths?: string[];
+    run?: RunFn;
+}
+export interface GenerateMonotonicTimestampOpts {
+    cwd?: string;
+    now?: Date;
+    listDir?: (dir: string) => string[];
+}
+export interface PollGhPreviewCheckOpts {
+    prNumber?: string;
+    mode?: "pre_merge" | "pre_pr_create";
+    cwd?: string;
+    run?: RunFn;
+    sleep?: (ms: number) => Promise<void>;
+    maxPolls?: number;
+    intervalMs?: number;
+}
+export interface PollGhPreviewCheckResult {
+    status: "passed" | "skipped" | "pending_pr" | "blocked";
+    reason: string;
+    /** MCP-only: populated by the skill after gh logs fetch — undefined here. */
+    failed_step?: string;
+    /** MCP-only: populated by the skill after gh logs fetch — undefined here. */
+    log_excerpt?: string;
+}
+/**
+ * Read `.codebyplan/shipment.json` and extract the Supabase surface.
+ * Degrades gracefully: returns `{parentRef: null, previewBranches: []}` on any error.
+ */
+export declare function readShipmentConfig(cwd?: string): ShipmentConfig;
+/**
+ * Read `.codebyplan/git.json` `branch_config`.
+ * Degrades gracefully: returns production="main", protected=["main"], integration=null.
+ */
+export declare function readGitConfig(cwd?: string): GitConfig;
+/**
+ * Read `db_paths` from the Supabase surface in `.codebyplan/shipment.json`.
+ * Falls back to DEFAULT_DB_PATHS when missing or empty.
+ */
+export declare function readDbPaths(cwd?: string): string[];
+/**
+ * Returns true iff any file changed between `origin/<base>...HEAD` matches a
+ * db path glob. Uses a three-dot diff (common ancestor to HEAD).
+ */
+export declare function detectDbChanged(opts?: DetectDbChangedOpts): boolean;
+/**
+ * Generate a 14-char UTC timestamp token (YYYYMMDDHHmmss) that is STRICTLY
+ * GREATER (string compare) than all existing migration file prefixes.
+ *
+ * When the computed timestamp collides with (or is ≤) an existing prefix,
+ * appends `_01`, `_02`, … to produce a unique monotonic token.
+ */
+export declare function generateMonotonicTimestamp(opts?: GenerateMonotonicTimestampOpts): string;
+/**
+ * Poll `gh pr checks` until the "Supabase Preview" check resolves or times out.
+ *
+ * The `failed_step` and `log_excerpt` fields are intentionally left undefined:
+ * log fetching requires MCP (`mcp__supabase__get_logs`), which is unavailable
+ * in the CLI. The consuming skill enriches a blocked verdict via MCP.
+ */
+export declare function pollGhPreviewCheck(opts?: PollGhPreviewCheckOpts): Promise<PollGhPreviewCheckResult>;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/lib/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/lib/supabase.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,iFAAiF;AACjF,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,8BAA8B;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IACrC,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,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8ID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAkC/D;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CA+BrD;AAYD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBlD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAuBvE;AAcD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,GAAE,8BAAmC,GACxC,MAAM,CA8CR;AAMD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAiJnC"}

package/dist/lib/sync-approvals.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Core sync-approvals merge logic.
+ *
+ * Pure functions — no I/O. Takes prefetched round, task, and git status as
+ * parameters; returns the merged files_changed array plus counters.
+ *
+ * Three layers of merge semantics (applied in order):
+ *
+ * 1. Git-diff drift merge:
+ *    - In git AND in DB → keep; clear removed_from_diff if set (reactivation)
+ *    - In git, NOT in DB → append new entry (user_approved=false, claude_approved=false)
+ *    - In DB, NOT in git → set removed_from_diff=true; keep (do NOT delete)
+ *    - In DB with removed_from_diff=true, back in git → clear flag (reactivation)
+ *
+ * 2. Staging-status → user_approved flip:
+ *    - Cleanly staged (first-col letter, no second-col letter) → user_approved=true
+ *    - MM (staged then modified) → keep existing value
+ *    - Hook-auto-staged override: if lint-format-on-edit.sh exists AND outstanding
+ *      findings present → override cleanly-staged → user_approved=false
+ *
+ * 3. Web-UI flag merge:
+ *    - If task.app_file_approval_by_user=true → entries with user_approved=true
+ *      in task.files_changed are preserved (already merged into the drift result)
+ */
+export interface FilesChangedEntry {
+    path: string;
+    action: string;
+    status?: string;
+    app_approved?: boolean;
+    user_approved?: boolean;
+    claude_approved?: boolean;
+    removed_from_diff?: boolean;
+}
+/**
+ * Parsed staging status for a single file path.
+ * firstCol = staging area letter (A, M, D, R, etc.) or " " if none.
+ * secondCol = working tree letter or " " if none.
+ */
+export interface GitStagingStatus {
+    path: string;
+    firstCol: string;
+    secondCol: string;
+}
+export interface SyncApprovalsInput {
+    currentRound: {
+        id: string;
+        files_changed?: FilesChangedEntry[];
+        context?: {
+            improve_round_findings?: unknown[];
+            outstanding_findings?: unknown[];
+            testing_qa_output?: {
+                totals?: {
+                    hard_fail?: boolean;
+                };
+            };
+        };
+    };
+    currentTask: {
+        id: string;
+        files_changed?: FilesChangedEntry[];
+        app_file_approval_by_user?: boolean;
+    };
+    /** Raw output of `git status --short --porcelain -z` */
+    gitStatusOutput: string;
+    /** Whether lint-format-on-edit.sh exists in the repo */
+    lintFormatHookExists: boolean;
+}
+export interface SyncApprovalsResult {
+    /** Paths added as new entries (in git, not in DB) */
+    added: string[];
+    /** Paths marked as removed_from_diff (in DB, not in git) */
+    stale_marked: string[];
+    /** Paths reactivated (had removed_from_diff=true, back in git) */
+    reactivated: string[];
+    /** Total number of entries in merged set */
+    total_files: number;
+    /** The final merged files_changed array (round shape) */
+    merged_files_changed: FilesChangedEntry[];
+}
+/**
+ * Parse `git status --short --porcelain -z` output into per-file staging status.
+ *
+ * Porcelain -z format: null-delimited tokens, each record is "XY path\0".
+ * For renames/copies (X=R or X=C), the record token is followed by an
+ * additional null-delimited token containing the old path — it must be
+ * consumed and discarded so the index stays in sync.
+ *
+ * X=staging area letter (A, M, D, R, C, ?, etc.) or " " if none.
+ * Y=working tree letter or " " if none.
+ */
+/**
+ * True when a path lives under the gitignored local-first state mirror
+ * (`.codebyplan/state/`), at the repo root or in any nested worktree.
+ * Such paths are excluded from sync-approvals so they never enter
+ * files_changed / round routing.
+ */
+export declare function isStateMirrorPath(filePath: string): boolean;
+export declare function parseGitStatus(output: string): GitStagingStatus[];
+/**
+ * Determine if outstanding-findings condition holds for a given round context.
+ * Used for the hook-auto-staged override.
+ */
+export declare function hasOutstandingFindings(roundContext: SyncApprovalsInput["currentRound"]["context"]): boolean;
+/**
+ * Run all three merge layers and return the final files_changed array.
+ */
+export declare function runSyncApprovals(input: SyncApprovalsInput): SyncApprovalsResult;
+//# sourceMappingURL=sync-approvals.d.ts.map

package/dist/lib/sync-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-approvals.d.ts","sourceRoot":"","sources":["../../src/lib/sync-approvals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACpC,OAAO,CAAC,EAAE;YACR,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC;YACnC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC;YACjC,iBAAiB,CAAC,EAAE;gBAClB,MAAM,CAAC,EAAE;oBACP,SAAS,CAAC,EAAE,OAAO,CAAC;iBACrB,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IACF,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACpC,yBAAyB,CAAC,EAAE,OAAO,CAAC;KACrC,CAAC;IACF,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kEAAkE;IAClE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA0CjE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,GAC1D,OAAO,CAkBT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,GACxB,mBAAmB,CA2IrB"}

package/dist/lib/tech-detect.d.ts

@@ -0,0 +1,77 @@
+import type { TechStackEntry, TechStackResult, TechStackSyncPayload } from "./types.js";
+export interface DiscoveredApp {
+    name: string;
+    path: string;
+    absPath: string;
+}
+/**
+ * Discover monorepo apps from workspace configuration.
+ * Checks pnpm-workspace.yaml first, then package.json workspaces.
+ */
+export declare function discoverMonorepoApps(projectPath: string): Promise<DiscoveredApp[]>;
+/**
+ * Internal carrier name emitted by `detectFromDirectory` when capabilities are
+ * discovered but no known bearer framework is present (e.g. package has
+ * `src/main.ts` but no framework dep in PACKAGE_MAP). The synthetic entry is an
+ * internal transport mechanism to carry capabilities through per-directory
+ * aggregation — it must NEVER leak into public output from `detectTechStack`
+ * or `mergeTechStack`. Filter before persisting via API or rendering in UI.
+ */
+export declare const SYNTHETIC_CARRIER_NAME = "__capabilities__";
+interface PkgJson {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    main?: string;
+    bin?: string | Record<string, string>;
+}
+/**
+ * Detect behavioural capabilities of a package:
+ * - `jsx`: walks src/app/pages for .tsx/.jsx (skipping tests)
+ * - `node-server`: deps include a server framework OR src/main.ts exists OR pkg.main points at server entry
+ * - `cli-bin`: pkg.bin is set (string or object form)
+ *
+ * Exported for tests and CLI integration. Callers typically prefer reading
+ * `TechStackEntry.capabilities` from `detectTechStack` results.
+ */
+export declare function detectCapabilities(dirPath: string, pkgJson: PkgJson | null): Promise<Set<string>>;
+/**
+ * Collect the union of capabilities declared across a set of TechStackEntry items.
+ * Returns a deduplicated, lowercased, sorted array — suitable for URL query params.
+ */
+export declare function collectCapabilities(entries: TechStackEntry[]): string[];
+/**
+ * Detect tech stack from local project files.
+ * Returns per-app breakdown for monorepos and a flat deduplicated union.
+ */
+export declare function detectTechStack(projectPath: string): Promise<TechStackResult>;
+/**
+ * Merge detected entries with existing remote entries.
+ * Remote entries are preserved — detected entries only add new ones.
+ * Returns merged result and list of newly added entries.
+ * Handles both old format (flat array) and new format (TechStackResult).
+ */
+export declare function mergeTechStack(remote: TechStackEntry[] | TechStackResult, detected: TechStackResult): {
+    merged: TechStackResult;
+    added: TechStackEntry[];
+};
+/**
+ * Parse raw JSON tech_stack field into flat typed array.
+ * Handles both old format (flat array) and new format (structured object).
+ */
+export declare function parseTechStack(raw: unknown): TechStackEntry[];
+/**
+ * Parse raw JSON tech_stack field into full structured result.
+ */
+export declare function parseTechStackResult(raw: unknown): TechStackResult;
+/**
+ * Recursively find all package.json files in a project, excluding build artifacts.
+ */
+export declare function findPackageJsonFiles(dir: string, projectPath: string, depth?: number): Promise<string[]>;
+/**
+ * Scan all dependencies from all package.json files in a project.
+ * Returns every dependency as an individual entry with version, source path,
+ * dev/prod status, and auto-categorization.
+ */
+export declare function scanAllDependencies(projectPath: string): Promise<TechStackSyncPayload>;
+export {};
+//# sourceMappingURL=tech-detect.d.ts.map

package/dist/lib/tech-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-detect.d.ts","sourceRoot":"","sources":["../../src/lib/tech-detect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EACf,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAwMpB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgE1B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AA2BzD,UAAU,OAAO;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAsDD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GAAG,IAAI,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAkDtB;AAwGD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAWvE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAmD1B;AAyBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EAAE,GAAG,eAAe,EAC1C,QAAQ,EAAE,eAAe,GACxB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,CAwDtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,EAAE,CAiB7D;AAoBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAkBlE;AA+BD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CA8C/B"}

package/dist/lib/template-walker.d.ts

@@ -0,0 +1,26 @@
+export interface TemplateFile {
+    /** Path relative to templatesDir, in POSIX form (forward slashes). */
+    src: string;
+    /** Destination path under `.claude/`, equal to `src` (POSIX). */
+    dest: string;
+    /** sha256 of the file contents, prefixed `sha256:` */
+    hash: string;
+}
+/**
+ * Recursively walk `templatesDir` and return every file inside as a
+ * `TemplateFile`. Excludes meta files (see EXCLUDED_RELATIVE_PATHS).
+ *
+ * Additionally, `.gitkeep` files are skipped globally — they exist solely to
+ * track empty directories in git and must never be installed into consuming
+ * projects.
+ *
+ * Includes a `visited: Set<string>` cycle guard keyed by realpath-resolved
+ * directory paths — symlink loops in the template tree cannot cause
+ * unbounded recursion (required by rules/recursive-walk-cycle-guard.md).
+ *
+ * Returned paths are POSIX-normalised (forward slashes) so that downstream
+ * consumers (manifest write, settings.json command rewrite) get consistent
+ * shape on Windows and macOS / Linux.
+ */
+export declare function walkTemplates(templatesDir: string): TemplateFile[];
+//# sourceMappingURL=template-walker.d.ts.map

package/dist/lib/template-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-walker.d.ts","sourceRoot":"","sources":["../../src/lib/template-walker.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAyED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,EAAE,CAmDlE"}

package/dist/lib/templates-dir.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared helper for locating the package's bundled `templates/` directory.
+ *
+ * Extracted from cli/claude/install.ts (canonical), cli/claude/update.ts, and
+ * cli/claude/status.ts (private duplicates) so that all callers share a single
+ * probe implementation.
+ *
+ * Use this module instead of duplicating the resolution logic in new callers.
+ */
+/**
+ * Resolve the directory containing the package's `templates/` tree.
+ *
+ * Resolution order:
+ *   1. `__dirname/../templates`    — post-bundle: `dist/cli.js` sits next to
+ *      `templates/` (because `package.json#files` includes both).
+ *   2. `__dirname/../../templates` — package root candidate: `dist/lib/` or
+ *      `src/lib/` is two levels above the package root where `templates/` lives.
+ *   3. `__dirname/../../../templates` — extra defensive depth.
+ *
+ * Throws a clear error if none resolve. The error mentions all probed
+ * paths so a future contributor can debug a build / publish layout change
+ * without spelunking through the bundle.
+ */
+export declare function resolveTemplatesDir(): string;
+//# sourceMappingURL=templates-dir.d.ts.map

package/dist/lib/templates-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates-dir.d.ts","sourceRoot":"","sources":["../../src/lib/templates-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAiB5C"}