codebyplan 1.13.65 → 1.13.66

package/dist/lib/scaffold-cd-workflow.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Library for `codebyplan cd scaffold-workflow`.
+ *
+ * Reads CD workflow templates from this package's `templates/github-workflows/`
+ * directory and writes them to `{projectDir}/.github/workflows/`. Two workflow
+ * files are scaffolded:
+ *   - publish.yml    (npm publish — from templates/github-workflows/publish.yml)
+ *   - release-desktop.yml (Tauri desktop release — from templates/github-workflows/release-desktop.yml)
+ *
+ * Idempotent:
+ *   - If the target file is byte-identical to the template → returns `skipped`.
+ *   - If the target exists but differs and `force` is false → throws an error.
+ *   - If `dryRun` is true → returns `dry_run` without writing.
+ *
+ * Reuses ScaffoldOptions + ScaffoldResult types from scaffold-publish-workflow.ts
+ * and resolveTemplatesDir from templates-dir.ts (same resolution logic as the
+ * CI scaffolder).
+ */
+import type { ScaffoldOptions, ScaffoldResult } from "./scaffold-publish-workflow.js";
+export interface ScaffoldCdWorkflowOptions extends ScaffoldOptions {
+    /**
+     * Which workflow(s) to scaffold. Defaults to ["publish", "release-desktop"]
+     * which scaffolds both. Callers may pass a subset for targeted operations.
+     */
+    workflows?: ("publish" | "release-desktop")[];
+}
+/**
+ * Aggregated result for a single `cd scaffold-workflow` invocation that may
+ * scaffold multiple workflow files.
+ */
+export interface ScaffoldCdWorkflowResult {
+    /** One result entry per template scaffolded. */
+    results: Array<ScaffoldResult & {
+        workflow: string;
+    }>;
+}
+/**
+ * Scaffold CD GitHub Actions workflow(s) into the target project.
+ *
+ * By default scaffolds both publish.yml and release-desktop.yml. Callers may
+ * limit the set via `opts.workflows`.
+ *
+ * @throws {Error} If any template file is missing.
+ * @throws {Error} If any target file exists, differs from its template, and
+ *                 `force` is false.
+ */
+export declare function runScaffoldCdWorkflow(opts?: ScaffoldCdWorkflowOptions): Promise<ScaffoldCdWorkflowResult>;
+//# sourceMappingURL=scaffold-cd-workflow.d.ts.map

package/dist/lib/scaffold-cd-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-cd-workflow.d.ts","sourceRoot":"","sources":["../../src/lib/scaffold-cd-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,gCAAgC,CAAC;AAMxC,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,OAAO,EAAE,KAAK,CAAC,cAAc,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAiGD;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CA4BnC"}

package/dist/lib/scaffold-ci-workflow.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Library for `codebyplan ci scaffold-workflow`.
+ *
+ * Reads `templates/github-workflows/ci.yml` from this package's templates
+ * directory, substitutes {{PNPM_VERSION}} and {{NODE_VERSION}} tokens, and
+ * writes the result to `{projectDir}/.github/workflows/ci.yml`.
+ *
+ * The emitted workflow has TWO jobs:
+ *   - `ci`        SOFT tier — the baseline-tolerant lint/typecheck/test/build
+ *                 inner loop; the authoritative required check.
+ *   - `ci-strict` HARDCORE tier (report-only) — whole-repo ABSOLUTE GREEN via
+ *                 `codebyplan check --scope merged --no-baseline`, run with
+ *                 `continue-on-error: true` so it is non-blocking until the
+ *                 repo baseline is burned down and it is promoted to required.
+ * The job bodies live in the template; this module only substitutes tokens.
+ *
+ * Idempotent:
+ *   - If the target file is byte-identical to the rendered template → returns `skipped`.
+ *   - If the target exists but differs and `force` is false → throws an error.
+ *   - If `dryRun` is true → returns `dry_run` without writing.
+ *
+ * Mirrors `scaffold-publish-workflow.ts` (same ScaffoldOptions/ScaffoldResult types +
+ * skip-if-identical / error-on-diff-without-force / --force / --dry-run / returns
+ * {status,path} logic). Token substitution uses simple String.replace with /g regex.
+ *
+ * Project-content reads (package.json, .codebyplan/ci.json) are reader-driven via
+ * RepoReader. Template-asset resolution stays import.meta.url-based via
+ * resolveTemplatesDir (not routed through the reader).
+ */
+import type { ScaffoldOptions, ScaffoldResult } from "./scaffold-publish-workflow.js";
+import { type RepoReader } from "./repo-reader.js";
+export interface ScaffoldCiWorkflowOptions extends ScaffoldOptions {
+    /**
+     * pnpm version to substitute for the {{PNPM_VERSION}} token.
+     * When omitted, the version is auto-detected from the target project's
+     * package.json `packageManager` field, falling back to "10".
+     */
+    pnpmVersion?: string;
+    /**
+     * Node.js version to substitute for the {{NODE_VERSION}} token.
+     * Defaults to "22".
+     */
+    nodeVersion?: string;
+    /**
+     * When true, the hardcore `ci-strict` job is emitted as an enforced gate
+     * (`continue-on-error: false`, job name without the " (report-only)" suffix)
+     * so it can be wired as a required branch-protection check. When omitted, the
+     * value is read from the target project's `.codebyplan/ci.json`
+     * `workflow.strict_check_enforced` field, defaulting to `false` (report-only).
+     */
+    strictEnforced?: boolean;
+    /**
+     * Optional reader for project-content reads. When omitted, a LocalFsReader
+     * constructed with `projectDir` is used. Inject an InMemoryRepoReader in
+     * tests to avoid disk I/O.
+     */
+    reader?: RepoReader;
+}
+/**
+ * Render the CI workflow YAML string by reading the package template and
+ * substituting tokens. Returns the rendered content WITHOUT writing to disk.
+ *
+ * This is the single rendering path — `runScaffoldCiWorkflow` calls this and
+ * then writes the returned string to disk. Non-fs callers (e.g. the GitHub-App
+ * auto-provisioner in apps/web) call this directly to obtain the YAML for a
+ * GitHub API blob upload.
+ *
+ * @throws {Error} If the template file is missing.
+ */
+export declare function renderCiWorkflowContent(opts?: ScaffoldCiWorkflowOptions): Promise<string>;
+/**
+ * Scaffold the CI GitHub Actions workflow into the target project.
+ *
+ * Delegates rendering to `renderCiWorkflowContent` (the single rendering path)
+ * and then handles the disk-write lifecycle (dry-run, skip-if-identical,
+ * error-on-diff-without-force, atomic tmp+rename write).
+ *
+ * @throws {Error} If the template file is missing.
+ * @throws {Error} If the target file exists, differs from the rendered template,
+ *                 and `force` is false.
+ */
+export declare function runScaffoldCiWorkflow(opts?: ScaffoldCiWorkflowOptions): Promise<ScaffoldResult>;
+//# sourceMappingURL=scaffold-ci-workflow.d.ts.map

package/dist/lib/scaffold-ci-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-ci-workflow.d.ts","sourceRoot":"","sources":["../../src/lib/scaffold-ci-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAMlE,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAkFD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAgDjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAsDzB"}

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

@@ -0,0 +1,48 @@
+/**
+ * Library for `codebyplan scaffold-publish-workflow`.
+ *
+ * Reads `templates/github-workflows/publish.yml` from this package's templates
+ * directory and writes it to `{projectDir}/.github/workflows/publish.yml`.
+ *
+ * Idempotent:
+ *   - If the target file is byte-identical to the template → returns `skipped`.
+ *   - If the target exists but differs and `force` is false → throws an error.
+ *   - If `dryRun` is true → returns `dry_run` without writing.
+ */
+export interface ScaffoldOptions {
+    /** If true, compute the operation but do NOT write any files. */
+    dryRun?: boolean;
+    /** If true, overwrite an existing file that differs from the template. */
+    force?: boolean;
+    /**
+     * Override the templates directory (used in tests to inject a fixture).
+     * When omitted, resolveTemplatesDir() is used.
+     */
+    templatesDir?: string;
+    /**
+     * Override the project root directory (used in tests, or when the CLI is
+     * run from a different directory than the target project).
+     * When omitted, process.cwd() is used.
+     */
+    projectDir?: string;
+}
+export type ScaffoldResult = {
+    status: "written";
+    path: string;
+} | {
+    status: "skipped";
+    path: string;
+    reason: string;
+} | {
+    status: "dry_run";
+    path: string;
+};
+/**
+ * Scaffold the publish-on-main GitHub Actions workflow into the target project.
+ *
+ * @throws {Error} If the template file is missing.
+ * @throws {Error} If the target file exists, differs from the template, and
+ *                 `force` is false.
+ */
+export declare function runScaffoldPublishWorkflow(opts?: ScaffoldOptions): Promise<ScaffoldResult>;
+//# sourceMappingURL=scaffold-publish-workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-publish-workflow.d.ts","sourceRoot":"","sources":["../../src/lib/scaffold-publish-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMxC;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,cAAc,CAAC,CAkEzB"}

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

@@ -0,0 +1,20 @@
+export interface DetectedServer {
+    label: string;
+    port: number | null;
+    command: string;
+    server_type: string;
+}
+export interface DetectionResult {
+    name: string;
+    isMonorepo: boolean;
+    packageManager: string;
+    servers: DetectedServer[];
+}
+export declare function detectFramework(pkg: Record<string, unknown>): string;
+export declare function detectPortFromScripts(pkg: Record<string, unknown>): number | null;
+/**
+ * Detect dev servers for a project by scanning package.json files.
+ * Mirrors the Rust `scan_repo` logic from the desktop app.
+ */
+export declare function detectServers(projectPath: string): Promise<DetectionResult>;
+//# sourceMappingURL=server-detect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-detect.d.ts","sourceRoot":"","sources":["../../src/lib/server-detect.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAmBD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAYpE;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,GAAG,IAAI,CAef;AASD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA4E1B"}

package/dist/lib/session.d.ts

@@ -0,0 +1,371 @@
+/**
+ * Pure lib for session lifecycle helpers.
+ *
+ * Replicates the deterministic parts of cbp-session-start / cbp-session-end
+ * into the CLI so the behaviour is testable, versionable, and available in
+ * every consumer repo via the codebyplan npm package.
+ *
+ * All public functions accept injectable deps so tests never hit the real
+ * filesystem, git, or npm registry. No top-level side effects.
+ */
+export type HomeFfResult = {
+    result: "skipped";
+    reason: string;
+} | {
+    result: "warn";
+    warn: string;
+} | {
+    result: "fast_forwarded";
+};
+export interface HomeFfOpts {
+    cwd?: string;
+    /** Override git runner. Signature: (cmd, args, cwd?) => stdout */
+    run?: (cmd: string, args: string[], cwd?: string) => string;
+}
+/**
+ * Fast-forward the home branch to origin/<production>.
+ *
+ * Replicates cbp-session-start Step 1.4 / cbp-session-end equivalent.
+ *
+ * - Reads production branch via readGitConfig (imported from ./supabase).
+ * - FOLDER = basename of git rev-parse --show-toplevel.
+ * - CURRENT = git rev-parse --abbrev-ref HEAD.
+ * - CURRENT !== FOLDER → skipped (no fetch attempted).
+ * - CURRENT === FOLDER → git fetch origin <production>, then git merge --ff-only.
+ *
+ * NEVER rebases, resets, or stashes.
+ */
+export declare function homeFf(opts?: HomeFfOpts): HomeFfResult;
+/**
+ * Shape returned by probing the version-status command.
+ * Mirrors the JSON output of `codebyplan version-status`.
+ */
+export interface VersionStatusProbe {
+    installed: string;
+    latest: string | null;
+    newer: boolean;
+    packageManager: string;
+    installCommand: string;
+    guarded: boolean;
+    guardReason: string | null;
+}
+export type FreshnessGateResult = {
+    result: "skipped";
+    reason: string;
+} | {
+    result: "guarded";
+} | {
+    result: "up_to_date";
+} | {
+    result: "updated";
+    latest: string;
+    changed_files: string[];
+    halt: boolean;
+} | {
+    result: "error";
+    reason: string;
+};
+export interface FreshnessGateOpts {
+    cwd?: string;
+    /**
+     * Probe the version status. Defaults to running the current CLI's
+     * version-status logic via the imported helpers. Injected in tests.
+     */
+    probeVersionStatus?: (cwd: string) => VersionStatusProbe | null;
+    /**
+     * Run the package-manager install command (e.g. "pnpm add codebyplan@latest").
+     * Injected in tests.
+     */
+    runInstall?: (installCommand: string, cwd: string) => void;
+    /**
+     * Run `npx codebyplan claude update --yes` equivalent.
+     * Injected in tests.
+     */
+    runClaudeUpdate?: (cwd: string) => void;
+    /**
+     * Run git status --porcelain to list changed files.
+     * Injected in tests.
+     */
+    runGitStatus?: (cwd: string) => string;
+    /**
+     * When true, the output includes `halt: true` so the calling skill knows
+     * to stop the session after an update (session-start behaviour).
+     * When false (default — session-end behaviour), `halt` is false.
+     */
+    haltOnUpdate?: boolean;
+}
+/**
+ * Spawn `npx codebyplan version-status` and parse its JSON output.
+ * Returns null when the command fails or emits non-JSON.
+ */
+export declare function spawnVersionStatus(cwd: string): VersionStatusProbe | null;
+/**
+ * Gate that checks if codebyplan has a newer version and auto-updates when safe.
+ *
+ * Replicates cbp-session-start Step 1.6.
+ */
+export declare function freshnessGate(opts?: FreshnessGateOpts): Promise<FreshnessGateResult>;
+export interface InfraFilesResult {
+    infra_files: string[];
+    task_files: string[];
+    note?: string;
+}
+export interface InfraFilesOpts {
+    cwd?: string;
+    /** Injectable git status runner — returns raw `git status --porcelain` output. */
+    run?: (cmd: string, args: string[], cwd?: string) => string;
+    /**
+     * Async resolver for the active-task round's files.
+     * Default returns [] (caller/skill passes --task-files instead).
+     */
+    getTaskFiles?: () => Promise<string[]>;
+}
+/**
+ * Compute infra_files = changed_files − task_files.
+ *
+ * Replicates cbp-session-start Step 5.7 set math.
+ *
+ * Algorithm:
+ * 1. git status --porcelain → changed_files; if empty → clean tree.
+ * 2. task_files = await getTaskFiles().
+ * 3. RE-RUN git status --porcelain (second run is authoritative —
+ *    MCP round-trip race workaround; the first run races with any
+ *    background MCP fetch; the second run is the stable read).
+ * 4. infra_files = fresh changed − task_files set.
+ */
+export declare function infraFiles(opts?: InfraFilesOpts): Promise<InfraFilesResult>;
+export interface ResolveUserJsonResult {
+    user_id: string | null;
+    error_kind: string | null;
+}
+export interface ResolveUserJsonOpts {
+    cwd?: string;
+    /**
+     * Injectable runner: (cmd, args, cwd?) => stdout.
+     * Injected in tests so no real subprocess is spawned.
+     */
+    run?: (cmd: string, args: string[], cwd?: string) => string;
+}
+/**
+ * Run `codebyplan whoami --json` and parse the structured output.
+ *
+ * CHK-225 retired worktree identity — concurrency is now USER-level via
+ * `assigned_user_id`. Caller identity comes from `codebyplan whoami --json`
+ * (`{ user_id, email }`); the removed `resolve-worktree` verb no longer exists.
+ *
+ * Returns `{ user_id: string|null, error_kind: string|null }`.
+ * Empty / `"null"` output (signed out) → `{ user_id: null, error_kind: 'tuple_miss' }`.
+ * On any internal error returns `{ user_id: null, error_kind: 'unhandled' }`
+ * and writes a one-line note to stderr.
+ *
+ * NEVER throws.
+ */
+export declare function resolveUserJson(opts?: ResolveUserJsonOpts): ResolveUserJsonResult;
+export interface InfraDriftNudgeOpts {
+    cwd?: string;
+    /**
+     * Injectable runner: (cmd, args, cwd?) => stdout.
+     * Injected in tests.
+     */
+    run?: (cmd: string, args: string[], cwd?: string) => string;
+    /**
+     * Injectable fs-existence check for the monorepo marker files.
+     * Injected in tests to avoid real stat calls.
+     */
+    existsSync?: (filePath: string) => boolean;
+}
+/**
+ * Monorepo-only infra-drift nudge (Step 1.5 of cbp-session-start).
+ *
+ * Runs only when BOTH `scripts/infra-drift.mjs` and `packages/codebyplan-package/templates/`
+ * exist in the repo root. Best-effort: fetches origin/<production> then runs the drift script.
+ *
+ * Returns a single-line nudge string when drift is found, or `null` when clean/unavailable.
+ * NEVER throws.
+ */
+export declare function infraDriftNudge(opts?: InfraDriftNudgeOpts): string | null;
+export interface ArchMapDriftNudgeOpts {
+    cwd?: string;
+    /**
+     * Injectable runner: (cmd, args, cwd?) => stdout.
+     * Injected in tests.
+     */
+    run?: (cmd: string, args: string[], cwd?: string) => string;
+    /**
+     * Injectable fs-existence check for architecture.json.
+     * Injected in tests.
+     */
+    existsSync?: (filePath: string) => boolean;
+}
+/**
+ * Architecture-map drift nudge (Step 1.55 of cbp-session-start).
+ *
+ * Returns a nudge string when N>0 drifted modules detected,
+ * or `null` when clean, absent manifest, or any error.
+ * NEVER throws.
+ */
+export declare function archMapDriftNudge(opts?: ArchMapDriftNudgeOpts): string | null;
+export interface LspNudgeOpts {
+    cwd?: string;
+    /**
+     * Injectable runner: (cmd, args, cwd?) => stdout.
+     * Injected in tests.
+     */
+    run?: (cmd: string, args: string[], cwd?: string) => string;
+}
+/**
+ * LSP binary nudge (Step 1.7 of cbp-session-start).
+ *
+ * Runs `codebyplan lsp --check` and returns an array of non-empty output lines
+ * (one install hint per missing binary), or `[]` when clean.
+ * NEVER throws.
+ */
+export declare function lspNudge(opts?: LspNudgeOpts): string[];
+export interface HandoffContext {
+    checkpoint_id?: string;
+    task_id?: string;
+    round_id?: string;
+    [key: string]: unknown;
+}
+export interface HandoffPayload {
+    command: string;
+    captured_at?: string;
+    context?: HandoffContext;
+    state?: unknown;
+}
+export interface SessionLogRow {
+    id?: string;
+    closed_at?: string | null;
+    content?: unknown;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+export interface CheckpointRow {
+    id?: string;
+    assigned_user_id?: string | null;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+export interface EntityRow {
+    updated_at?: string;
+    assigned_user_id?: string | null;
+    [key: string]: unknown;
+}
+export interface ProbeHandoffOpts {
+    repoRoot: string;
+    userId: string | null;
+    previousSessionRow: SessionLogRow | null;
+    freshnessWindowHours?: number;
+    /**
+     * Injectable entity-file reader — takes a file path and returns parsed JSON or null.
+     * Injected in tests to avoid real fs access.
+     */
+    readEntity?: (filePath: string) => Promise<EntityRow | null>;
+}
+export type ProbeHandoffResult = {
+    fresh: true;
+    command: string;
+    context: HandoffContext;
+    state: unknown;
+} | {
+    fresh: false;
+};
+/**
+ * Step 4.5 handoff freshness probe.
+ *
+ * Returns `{ fresh:true, command, context, state }` when the previous session's
+ * handoff payload is valid and fresh, or `{ fresh:false }` on any defensive gate
+ * or stale condition.
+ *
+ * NEVER throws — all failure paths return `{ fresh:false }`.
+ */
+export declare function probeHandoff(opts: ProbeHandoffOpts): Promise<ProbeHandoffResult>;
+export interface CheckpointSummary {
+    id: string;
+    title: string;
+}
+export interface OwnershipPartition {
+    owned: CheckpointSummary[];
+    cross: CheckpointSummary[];
+}
+/**
+ * PURE. Partition checkpoint rows into owned-by-you vs other-users.
+ *
+ * owned = chk.assigned_user_id is null (open) OR chk.assigned_user_id === userId.
+ * cross = chk.assigned_user_id is non-null AND !== userId.
+ *
+ * @param checkpoints  Array of checkpoint-like objects with id, title, assigned_user_id.
+ * @param userId       The caller's user ID (may be null when signed out).
+ */
+export declare function partitionOwnership(checkpoints: Array<{
+    id?: string;
+    title?: string;
+    number?: number;
+    assigned_user_id?: string | null;
+    [key: string]: unknown;
+}>, userId: string | null): OwnershipPartition;
+export type NextAction = "mcp_update_halt" | "resume_handoff" | "commit_then_todo" | "trigger_todo" | "stop";
+export interface ComputeNextActionInput {
+    status: string;
+    owned_count: number;
+    total_count: number;
+    handoff_fresh: boolean;
+    infra_files_count: number;
+}
+/**
+ * PURE. Compute the session's next action from the envelope status and ownership data.
+ *
+ * Priority order:
+ * 1. update_halt → mcp_update_halt
+ * 2. handoff_fresh → resume_handoff
+ * 3. infra_files_count > 0 && owned_count >= 1 → commit_then_todo
+ * 4. owned_count >= 1 → trigger_todo
+ * 5. total_count >= 1 && owned_count === 0 → stop
+ * 6. total_count === 0 → trigger_todo
+ */
+export declare function computeNextAction(input: ComputeNextActionInput): NextAction;
+export interface SessionStartEnvelope {
+    status: "ok" | "update_halt";
+    session_log_id: string | null;
+    user_id: string | null;
+    user_error_kind: string | null;
+    infra_drift_nudge: string | null;
+    arch_map_nudge: string | null;
+    lsp_nudges: string[];
+    handoff: {
+        fresh: boolean;
+        command?: string;
+        context?: HandoffContext;
+        state?: unknown;
+    };
+    infra_files_to_commit: string[];
+    owned_checkpoints: CheckpointSummary[];
+    cross_checkpoints: CheckpointSummary[];
+    owned_count: number;
+    total_count: number;
+    next_action: NextAction;
+    rendered_block: string;
+    previous_session: {
+        title?: string;
+        summary?: string;
+        pending?: string;
+    } | null;
+}
+/**
+ * PURE. Produce the Step 6 output text block from a SessionStartEnvelope.
+ *
+ * Mirrors the Step 6 template in the SKILL.md exactly:
+ *   Session active | User: [user_id or "not signed in"]
+ *   [whoami distress line — only when error_kind non-null && != tuple_miss]
+ *   [infra drift nudge]
+ *   [arch map nudge]
+ *   Previous session: [title or "none"]
+ *     Pending: [pending or "—"]
+ *   Ownership: N active CHK(s), M owned by you
+ *   [Owned: ... — only when owned_count > 0]
+ *   [Other users: ... — only when cross > 0]
+ *   [LSP: <hint> — one per line]
+ *   [⚠ Not signed in ... — only when user_id null and no distress shown]
+ */
+export declare function renderBlock(envelope: SessionStartEnvelope): string;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"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"}