opensquid 0.5.432 → 0.5.447

package/dist/runtime/agent_bridge/autospawn.js

@@ -1,251 +0,0 @@
-/**
- * agent-bridge headless responder autospawn (T-CHAT-AS-TERMINAL CAT.5.1).
- *
- * The chat-transport daemon (`src/channels/daemon/autospawn.ts`) already
- * autospawns from the MCP chat-bridge boot. The HEADLESS RESPONDER — the
- * agent-bridge daemon that ANSWERS chat when no terminal is live (CAT.5 the
- * project umbrella's headless responder, CAT.6 the project-less `general`
- * session) — did NOT. This module mirrors that chat-daemon autospawn so the
- * headless responder is ALWAYS-ON too: started opportunistically on MCP boot,
- * keyed PER-INSTANCE so `loop` + `general` run concurrently (CAT.5.1's
- * per-scope lock/pid in daemon.ts).
- *
- * SAFE to autospawn the project headless even while a terminal is live: CAT.5's
- * lease-ownership guard makes it STAND DOWN. The headless only answers when it
- * owns a fresh umbrella lease; while a human `chat watch` lease is present the
- * dispatcher's flush-time `isLeaseFreshAndOwnedBy` guard suppresses it — it
- * idles at zero token cost (fs-only heartbeat) until the human lease lapses.
- *
- * Behavior (mirrors `ensureChatDaemonRunning`):
- *   - No-op when no chat platform is configured.
- *   - No-op when the SCOPED daemon (its own pidfile) is already running.
- *   - Else acquire an atomic per-scope spawn-lock (`fs.open(lock, 'wx')`) so two
- *     MCP servers don't double-spawn; the loser waits briefly for the pidfile.
- *     Stale lock (> 15s) is reclaimed.
- *   - Always async + non-throwing. A resolution failure (no project uuid / no
- *     pack) → `{ status: 'no_config' }` (skip that scope, never throw).
- *
- * It spawns `dist/cli.js agent-bridge start [--general]` DETACHED:
- *   - general: `agent-bridge start --general` (env as-is — the worker resolves
- *     the built-in `general` pack itself).
- *   - project umbrella: `agent-bridge start` with `OPENSQUID_PROJECT_UUID` +
- *     `OPENSQUID_PACK_ROOT` injected into the child env (resolved exactly like
- *     cli.ts's non-general path: `resolveProjectUuid` + `resolvePackRootFromEnv`).
- *     If the project uuid can't be resolved → skip (no-op).
- *
- * Imports from: node:fs, node:os, node:path, node:child_process, node:url,
- *   ../../channels/config, ../../channels/routing, ../paths, ./daemon.
- * Imported by: src/mcp/chat-bridge-server.ts (boot) + tests.
- */
-import { spawn } from 'node:child_process';
-import { promises as fs } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { loadChatConfig } from '../../channels/config.js';
-import { GENERAL_UMBRELLA } from '../../channels/routing.js';
-import { resolveProjectUuid } from '../paths.js';
-import { agentBridgeLockPath, agentBridgePidPath, resolvePackRootFromEnv, } from './daemon.js';
-const STALE_LOCK_AGE_MS = 15_000;
-const PIDFILE_WAIT_MS = 8_000;
-const POLL_INTERVAL_MS = 100;
-/**
- * Resolve the CLI binary (`dist/cli.js`). From the MCP server at
- * `dist/mcp/chat-bridge-server.js` the CLI sits at `dist/cli.js`; from this
- * module's built location (`dist/runtime/agent_bridge/autospawn.js`) it's three
- * dirs up. We resolve relative to the MCP-server layout to match the chat
- * daemon's `resolveCliEntrypoint`, honoring `OPENSQUID_CLI_ENTRYPOINT`.
- */
-export function resolveCliEntrypoint() {
-    const override = process.env.OPENSQUID_CLI_ENTRYPOINT;
-    if (override !== undefined && override.length > 0)
-        return override;
-    const here = fileURLToPath(import.meta.url);
-    // dist/runtime/agent_bridge/autospawn.js → dist → dist/cli.js
-    return resolve(dirname(here), '..', '..', 'cli.js');
-}
-/** True iff at least one chat platform has a token configured. */
-async function anyChatConfigured() {
-    const config = await loadChatConfig();
-    return (config.telegram?.bot_token !== undefined ||
-        config.discord?.bot_token !== undefined ||
-        config.slack?.bot_token !== undefined);
-}
-/** `kill -0 <pid>` liveness — ESRCH (dead) → false, EPERM (foreign live) → true. */
-function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (err) {
-        return err.code === 'EPERM';
-    }
-}
-/** Default scoped-status probe: read `agent-bridge[-<scope>].pid` + `kill -0`. */
-async function defaultScopedStatus(scope) {
-    let raw;
-    try {
-        raw = await fs.readFile(agentBridgePidPath(scope), 'utf8');
-    }
-    catch {
-        return { running: false };
-    }
-    const pid = parseInt(raw.trim(), 10);
-    if (!Number.isFinite(pid) || pid <= 0)
-        return { running: false };
-    return isProcessAlive(pid) ? { running: true, pid } : { running: false };
-}
-/** Default spawn: detached `node <entrypoint> <args...>` with the merged env. */
-function defaultSpawn(entrypoint, inv) {
-    const child = spawn(process.execPath, [entrypoint, ...inv.args], {
-        detached: true,
-        stdio: 'ignore',
-        env: inv.env,
-    });
-    child.unref();
-    return child.pid !== undefined ? { pid: child.pid } : {};
-}
-/**
- * Build the detached spawn invocation for a target, or `null` to SKIP (a
- * project umbrella whose project uuid can't be resolved). Pure given its deps.
- */
-function buildInvocation(target, deps, projectUuid) {
-    if (target.kind === 'general') {
-        // General: env as-is; the worker resolves the built-in `general` pack.
-        return { args: ['agent-bridge', 'start', '--general'], env: { ...deps.env } };
-    }
-    // Project umbrella: inject the resolved project uuid + pack root so the
-    // detached `agent-bridge start` worker keys off THIS scope (matches cli.ts's
-    // non-general path). Skip when the project uuid can't be resolved.
-    if (projectUuid === null)
-        return null;
-    const packRoot = deps.resolvePackRootFn(deps.env);
-    return {
-        args: ['agent-bridge', 'start'],
-        env: {
-            ...deps.env,
-            OPENSQUID_PROJECT_UUID: projectUuid,
-            OPENSQUID_PACK_ROOT: packRoot,
-        },
-    };
-}
-/** Scope key for a target (umbrella id is the scope identity for both kinds). */
-function scopeForTarget(target) {
-    return target.kind === 'general'
-        ? { umbrellaId: GENERAL_UMBRELLA }
-        : { umbrellaId: target.umbrellaId };
-}
-/**
- * Best-effort: ensure the headless agent-bridge responder for `target` is
- * running. Returns on the no-op paths (no config, already running, peer
- * spawning, unresolvable scope). NEVER throws.
- */
-export async function ensureAgentBridgeRunning(target, opts = {}) {
-    const isConfigured = opts.isConfigured ?? anyChatConfigured;
-    const statusFn = opts.statusFn ?? defaultScopedStatus;
-    const spawnFn = opts.spawnFn ?? defaultSpawn;
-    const env = opts.env ?? process.env;
-    const resolveProjectUuidFn = opts.resolveProjectUuidFn ?? resolveProjectUuid;
-    const resolvePackRootFn = opts.resolvePackRootFn ?? resolvePackRootFromEnv;
-    try {
-        if (!(await isConfigured()))
-            return { status: 'no_config' };
-        const scope = scopeForTarget(target);
-        // Resolve the project uuid up-front for the umbrella path so we can SKIP
-        // (no_config) before touching any lock when it's unresolvable.
-        let projectUuid = null;
-        if (target.kind === 'umbrella') {
-            projectUuid = await resolveProjectUuidFn({ cwd: target.cwd, env });
-            if (projectUuid === null)
-                return { status: 'no_config' };
-        }
-        const cur = await statusFn(scope);
-        if (cur.running)
-            return { status: 'already_running', ...(cur.pid !== undefined ? { pid: cur.pid } : {}) };
-        const invocation = buildInvocation(target, { resolvePackRootFn, env }, projectUuid);
-        if (invocation === null)
-            return { status: 'no_config' };
-        const entrypoint = opts.entrypoint ?? resolveCliEntrypoint();
-        const lockPath = agentBridgeLockPath(scope);
-        const acquired = await tryAcquireLock(lockPath);
-        if (acquired) {
-            try {
-                const re = await statusFn(scope);
-                if (re.running) {
-                    return { status: 'already_running', ...(re.pid !== undefined ? { pid: re.pid } : {}) };
-                }
-                const res = spawnFn(entrypoint, invocation);
-                return res.pid !== undefined ? { status: 'spawned', pid: res.pid } : { status: 'spawned' };
-            }
-            finally {
-                await fs.unlink(lockPath).catch(() => {
-                    /* race-tolerant */
-                });
-            }
-        }
-        // Another process holds the lock — wait for its pidfile.
-        const pid = await waitForPeer(statusFn, scope);
-        if (pid !== null)
-            return { status: 'waited_for_peer', pid };
-        return { status: 'error', error: 'peer spawn timed out' };
-    }
-    catch (err) {
-        return { status: 'error', error: err instanceof Error ? err.message : String(err) };
-    }
-}
-async function tryAcquireLock(lockPath) {
-    await fs.mkdir(dirname(lockPath), { recursive: true });
-    try {
-        const fd = await fs.open(lockPath, 'wx');
-        await fd.write(`${process.pid}\n`);
-        await fd.close();
-        return true;
-    }
-    catch (err) {
-        if (err.code !== 'EEXIST')
-            throw err;
-        try {
-            const st = await fs.stat(lockPath);
-            if (Date.now() - st.mtimeMs > STALE_LOCK_AGE_MS) {
-                await fs.unlink(lockPath).catch(() => {
-                    /* race */
-                });
-                return tryAcquireLock(lockPath);
-            }
-        }
-        catch {
-            return tryAcquireLock(lockPath);
-        }
-        return false;
-    }
-}
-async function waitForPeer(statusFn, scope) {
-    const deadline = Date.now() + PIDFILE_WAIT_MS;
-    while (Date.now() < deadline) {
-        const s = await statusFn(scope);
-        if (s.running)
-            return s.pid ?? -1;
-        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
-    }
-    return null;
-}
-/**
- * MCP-boot convenience (CAT.5.1): ensure (a) the GENERAL headless responder
- * (always) and (b) the headless responder for the umbrella the cwd resolves to
- * (if any). Each is fire-and-forget at the call site; this helper awaits both
- * and returns their results for logging. Never throws.
- *
- * `cwd` defaults to `CLAUDE_PROJECT_DIR ?? process.cwd()` (matches the MCP
- * server's active-umbrella resolution). `umbrellaForCwd` lets the caller pass
- * the already-resolved umbrella (the MCP boot resolves it once for logging).
- */
-export async function ensureHeadlessRespondersForBoot(opts) {
-    const ensureFn = opts.ensureFn ?? ensureAgentBridgeRunning;
-    const cwd = opts.cwd ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
-    const general = await ensureFn({ kind: 'general' }, opts.deps);
-    let umbrella = null;
-    if (opts.umbrellaForCwd !== null && opts.umbrellaForCwd !== GENERAL_UMBRELLA) {
-        umbrella = await ensureFn({ kind: 'umbrella', umbrellaId: opts.umbrellaForCwd, cwd }, opts.deps);
-    }
-    return { general, umbrella };
-}
-//# sourceMappingURL=autospawn.js.map

package/dist/runtime/agent_bridge/autospawn.js.map

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

package/dist/runtime/chain_state.d.ts

@@ -1,124 +0,0 @@
-/**
- * Per-session auto-start chain state machine (T-ASC, ASC.1).
- *
- * Tracks the user-locked pipeline scope-decomposer → task-spec-author →
- * workflow / 7-layer across a single Claude Code session. The state is the
- * substrate ASC.2's `Skill.requires: chain_stage` precondition reads, and the
- * data source ASC.5's reframed scope-decomposer handoff rules consume to
- * shape their structured `directive` verdicts (ASC.3).
- *
- * 7 stages (declaration order = pipeline order):
- *   idle              — no scope work in flight (initial)
- *   scoping           — scope-authoring intent detected on the most recent
- *                       prompt (the SCOPE_INTENT_REGEX matched while idle)
- *   researched        — a pre-research artifact landed on disk
- *                       (docs/research/*-pre-research-*.md)
- *   spec_authored     — a track spec landed on disk
- *                       (docs/tasks/T-*.md)
- *   tasks_loaded      — harness TaskCreate fired with metadata.taskId
- *                       provenance (the spec became loaded tasks)
- *   phases_in_flight  — at least one phase logged for the active task
- *   phases_complete   — all 7 REQUIRED phases logged for the active task
- *
- * Writers (5 distributed transition points across the runtime):
- *   UserPromptSubmit  → 'scoping'         (prompt matches SCOPE_INTENT_REGEX
- *                                          AND current stage is 'idle')
- *   PreToolUse        → 'researched'      (Write to docs/research/*-pre-research-*.md)
- *   PreToolUse        → 'spec_authored'   (Write to docs/tasks/T-*.md)
- *   PreToolUse        → 'tasks_loaded'    (TaskCreate/TaskUpdate with metadata.taskId)
- *   log_phase MCP     → 'phases_in_flight' / 'phases_complete'
- *
- * Lifecycle: session-scoped per T-ASC L3. SessionEnd hook calls
- * `clearChainState`. Cross-session resume is OUT OF SCOPE for this track
- * (separate product question).
- *
- * Invariants:
- *   - Same-stage write is idempotent (no double-history-entry, no file rewrite).
- *     The `history` is append-only and entries are NEVER removed mid-session
- *     (per L4); history captures stage ENTRIES, not write attempts.
- *   - No-throw read posture: absent / malformed → null; the caller defaults
- *     to 'idle' via `readChainStage`'s nullish coalesce. Same eventual-
- *     consistency model as session_state.ts:108-135 (recordSessionCwd).
- *   - Enrichment fields (pre_research_path, spec_path, task_ids) ACCUMULATE
- *     across transitions: a transition without enrich preserves prior values.
- *     A same-stage idempotent call does NOT update enrichment (L4 contract —
- *     same stage = no write at all). If a future need surfaces ("update
- *     enrichment on current stage"), add a sibling enrichChainState helper;
- *     do NOT loosen transitionChainStage's idempotency.
- *   - Write failures throw (caller-owned recovery). Call sites in hooks /
- *     log_phase wrap in try/catch with stderr-warn or silent (their existing
- *     best-effort discipline).
- *
- * Imports from: node:fs/promises, node:path, ./paths.js.
- * Imported by:
- *   - src/runtime/hooks/{pre-tool-use,user-prompt-submit,session-end}.ts (writers)
- *   - src/mcp/tools/log_phase.ts (writer)
- *   - src/runtime/skill_requires.ts (ASC.2 — `chain_stage` precondition reader)
- *   - src/functions/chain_state.ts (ASC.5 — `read_chain_state` primitive)
- */
-/** The 7 stages, in pipeline order. `as const` so ChainStage narrows to the literal union. */
-export declare const CHAIN_STAGES: readonly ["idle", "scoping", "researched", "spec_authored", "tasks_loaded", "phases_in_flight", "phases_complete"];
-export type ChainStage = (typeof CHAIN_STAGES)[number];
-export interface ChainHistoryEntry {
-    stage: ChainStage;
-    /** ISO-8601 timestamp the chain ENTERED this stage. */
-    at: string;
-}
-export interface ChainState {
-    stage: ChainStage;
-    /** ISO timestamp the chain entered the CURRENT stage. */
-    started_at: string;
-    /** ISO timestamp of the most-recent transition write (same as started_at after a fresh transition). */
-    last_transition_at: string;
-    /** Absolute path to the pre-research artifact; set when transitioning to 'researched'. */
-    pre_research_path?: string;
-    /** Absolute path to the track spec; set when transitioning to 'spec_authored'. */
-    spec_path?: string;
-    /** Harness task ids that loaded from the spec; set when transitioning to 'tasks_loaded'. */
-    task_ids?: string[];
-    /** Append-only audit trail of every stage entered. */
-    history: ChainHistoryEntry[];
-}
-/** Optional enrichment supplied on transition; merges into ChainState (only when the stage actually transitions). */
-export interface ChainEnrich {
-    pre_research_path?: string;
-    spec_path?: string;
-    task_ids?: string[];
-}
-/**
- * Write a stage transition. Idempotent on same-stage re-write: when the
- * persisted stage already equals `next`, this is a no-op (history unchanged,
- * enrichment NOT applied — L4 contract: same stage = no write).
- *
- * Enrichment fields ACCUMULATE on actual transitions: a transition without
- * an explicit enrich value preserves whatever was in the prior state for that
- * field. Supplying enrich for a stage we're already in is silently dropped
- * (the function returns early). If a caller needs to update enrichment on
- * the current stage, that's a separate concern (out of scope for ASC.1).
- *
- * Fail-open is caller-side: write failures throw, hook bins wrap with
- * try/catch + stderr-warn, the log_phase MCP tool wraps silently (the tool's
- * return shape is the gate's contract and a chain-state-write failure must
- * NOT propagate into the tool response).
- */
-export declare function transitionChainStage(sessionId: string, next: ChainStage, enrich?: ChainEnrich): Promise<void>;
-/**
- * Read the persisted ChainState, or `null` if absent/unreadable/malformed.
- * Same no-throw posture as readSessionCwd / readActiveTask: a missing or
- * shape-invalid file reads as null inside a hook bin, never an exception.
- */
-export declare function readChainState(sessionId: string): Promise<ChainState | null>;
-/**
- * Read just the current stage; defaults to 'idle' when the chain has not yet
- * been initialized (absent file) or when the persisted state is malformed.
- * The convenience reader for callers that only care about the stage gate
- * (ASC.2's `Skill.requires: chain_stage` precondition, ASC.5's rule guards).
- */
-export declare function readChainStage(sessionId: string): Promise<ChainStage>;
-/**
- * Remove the chain-state file (SessionEnd cleanup). ENOENT is swallowed —
- * a session that never advanced past 'idle' has no file to clear. Any other
- * error throws (caller wraps with best-effort discipline).
- */
-export declare function clearChainState(sessionId: string): Promise<void>;
-//# sourceMappingURL=chain_state.d.ts.map

package/dist/runtime/chain_state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chain_state.d.ts","sourceRoot":"","sources":["../../src/runtime/chain_state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAMH,8FAA8F;AAC9F,eAAO,MAAM,YAAY,oHAQf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAKvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sDAAsD;IACtD,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,qHAAqH;AACrH,MAAM,WAAW,WAAW;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAkBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQlF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE"}

package/dist/runtime/chain_state.js

@@ -1,189 +0,0 @@
-/**
- * Per-session auto-start chain state machine (T-ASC, ASC.1).
- *
- * Tracks the user-locked pipeline scope-decomposer → task-spec-author →
- * workflow / 7-layer across a single Claude Code session. The state is the
- * substrate ASC.2's `Skill.requires: chain_stage` precondition reads, and the
- * data source ASC.5's reframed scope-decomposer handoff rules consume to
- * shape their structured `directive` verdicts (ASC.3).
- *
- * 7 stages (declaration order = pipeline order):
- *   idle              — no scope work in flight (initial)
- *   scoping           — scope-authoring intent detected on the most recent
- *                       prompt (the SCOPE_INTENT_REGEX matched while idle)
- *   researched        — a pre-research artifact landed on disk
- *                       (docs/research/*-pre-research-*.md)
- *   spec_authored     — a track spec landed on disk
- *                       (docs/tasks/T-*.md)
- *   tasks_loaded      — harness TaskCreate fired with metadata.taskId
- *                       provenance (the spec became loaded tasks)
- *   phases_in_flight  — at least one phase logged for the active task
- *   phases_complete   — all 7 REQUIRED phases logged for the active task
- *
- * Writers (5 distributed transition points across the runtime):
- *   UserPromptSubmit  → 'scoping'         (prompt matches SCOPE_INTENT_REGEX
- *                                          AND current stage is 'idle')
- *   PreToolUse        → 'researched'      (Write to docs/research/*-pre-research-*.md)
- *   PreToolUse        → 'spec_authored'   (Write to docs/tasks/T-*.md)
- *   PreToolUse        → 'tasks_loaded'    (TaskCreate/TaskUpdate with metadata.taskId)
- *   log_phase MCP     → 'phases_in_flight' / 'phases_complete'
- *
- * Lifecycle: session-scoped per T-ASC L3. SessionEnd hook calls
- * `clearChainState`. Cross-session resume is OUT OF SCOPE for this track
- * (separate product question).
- *
- * Invariants:
- *   - Same-stage write is idempotent (no double-history-entry, no file rewrite).
- *     The `history` is append-only and entries are NEVER removed mid-session
- *     (per L4); history captures stage ENTRIES, not write attempts.
- *   - No-throw read posture: absent / malformed → null; the caller defaults
- *     to 'idle' via `readChainStage`'s nullish coalesce. Same eventual-
- *     consistency model as session_state.ts:108-135 (recordSessionCwd).
- *   - Enrichment fields (pre_research_path, spec_path, task_ids) ACCUMULATE
- *     across transitions: a transition without enrich preserves prior values.
- *     A same-stage idempotent call does NOT update enrichment (L4 contract —
- *     same stage = no write at all). If a future need surfaces ("update
- *     enrichment on current stage"), add a sibling enrichChainState helper;
- *     do NOT loosen transitionChainStage's idempotency.
- *   - Write failures throw (caller-owned recovery). Call sites in hooks /
- *     log_phase wrap in try/catch with stderr-warn or silent (their existing
- *     best-effort discipline).
- *
- * Imports from: node:fs/promises, node:path, ./paths.js.
- * Imported by:
- *   - src/runtime/hooks/{pre-tool-use,user-prompt-submit,session-end}.ts (writers)
- *   - src/mcp/tools/log_phase.ts (writer)
- *   - src/runtime/skill_requires.ts (ASC.2 — `chain_stage` precondition reader)
- *   - src/functions/chain_state.ts (ASC.5 — `read_chain_state` primitive)
- */
-import { readFile, unlink } from 'node:fs/promises';
-import { atomicWriteFile } from './atomic_write.js';
-import { sessionStateFile } from './paths.js';
-/** The 7 stages, in pipeline order. `as const` so ChainStage narrows to the literal union. */
-export const CHAIN_STAGES = [
-    'idle',
-    'scoping',
-    'researched',
-    'spec_authored',
-    'tasks_loaded',
-    'phases_in_flight',
-    'phases_complete',
-];
-/** Well-known session-state key for the chain-state file. */
-const CHAIN_STATE_KEY = 'chain-state';
-/**
- * Runtime type guard for the persisted shape. Validates every required field
- * + stage-membership; the unknown-shape branches return false so the read
- * helpers default to null (no-throw posture).
- */
-function isChainState(o) {
-    if (o === null || typeof o !== 'object')
-        return false;
-    const obj = o;
-    if (typeof obj.stage !== 'string')
-        return false;
-    if (!CHAIN_STAGES.includes(obj.stage))
-        return false;
-    if (typeof obj.started_at !== 'string')
-        return false;
-    if (typeof obj.last_transition_at !== 'string')
-        return false;
-    if (!Array.isArray(obj.history))
-        return false;
-    return true;
-}
-/**
- * Write a stage transition. Idempotent on same-stage re-write: when the
- * persisted stage already equals `next`, this is a no-op (history unchanged,
- * enrichment NOT applied — L4 contract: same stage = no write).
- *
- * Enrichment fields ACCUMULATE on actual transitions: a transition without
- * an explicit enrich value preserves whatever was in the prior state for that
- * field. Supplying enrich for a stage we're already in is silently dropped
- * (the function returns early). If a caller needs to update enrichment on
- * the current stage, that's a separate concern (out of scope for ASC.1).
- *
- * Fail-open is caller-side: write failures throw, hook bins wrap with
- * try/catch + stderr-warn, the log_phase MCP tool wraps silently (the tool's
- * return shape is the gate's contract and a chain-state-write failure must
- * NOT propagate into the tool response).
- */
-export async function transitionChainStage(sessionId, next, enrich) {
-    const path = sessionStateFile(sessionId, CHAIN_STATE_KEY);
-    const now = new Date().toISOString();
-    const current = await readChainState(sessionId);
-    if (current?.stage === next)
-        return; // L4 idempotency: same stage = no-op
-    // T-PACK-FSM-STANDARDIZATION slice A4 — legality. The workflow pipeline is
-    // FORWARD-ONLY (CHAIN_STAGES order); forward JUMPS are allowed by design
-    // (e.g. a spec write lands `spec_authored` without an intervening prompt),
-    // but a BACKWARD transition was silently accepted before — the exact "accepts
-    // any target, no legality matrix" gap the generic FSM engine closes. Reject
-    // it: no-op + warn, so an illegal regress can't quietly rewind a gate. (The
-    // legitimate research loop-back lives in the `scope-fsm` pack's FSM, not this
-    // global one-shot chain.)
-    const curIdx = current ? CHAIN_STAGES.indexOf(current.stage) : -1;
-    const nextIdx = CHAIN_STAGES.indexOf(next);
-    if (nextIdx < curIdx) {
-        process.stderr.write(`opensquid: illegal backward chain transition ${current?.stage ?? 'idle'} -> ${next} ignored (forward-only)\n`);
-        return;
-    }
-    const merged = {
-        stage: next,
-        started_at: now,
-        last_transition_at: now,
-        ...(current?.pre_research_path !== undefined
-            ? { pre_research_path: current.pre_research_path }
-            : {}),
-        ...(current?.spec_path !== undefined ? { spec_path: current.spec_path } : {}),
-        ...(current?.task_ids !== undefined ? { task_ids: current.task_ids } : {}),
-        ...(enrich?.pre_research_path !== undefined
-            ? { pre_research_path: enrich.pre_research_path }
-            : {}),
-        ...(enrich?.spec_path !== undefined ? { spec_path: enrich.spec_path } : {}),
-        ...(enrich?.task_ids !== undefined ? { task_ids: enrich.task_ids } : {}),
-        history: [...(current?.history ?? []), { stage: next, at: now }],
-    };
-    // FC.1: atomic publish so concurrent transitions can't tear/lose the stage —
-    // the stage the gates read is always the last fully-committed one.
-    await atomicWriteFile(path, JSON.stringify(merged, null, 2));
-}
-/**
- * Read the persisted ChainState, or `null` if absent/unreadable/malformed.
- * Same no-throw posture as readSessionCwd / readActiveTask: a missing or
- * shape-invalid file reads as null inside a hook bin, never an exception.
- */
-export async function readChainState(sessionId) {
-    try {
-        const raw = await readFile(sessionStateFile(sessionId, CHAIN_STATE_KEY), 'utf8');
-        const parsed = JSON.parse(raw);
-        return isChainState(parsed) ? parsed : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Read just the current stage; defaults to 'idle' when the chain has not yet
- * been initialized (absent file) or when the persisted state is malformed.
- * The convenience reader for callers that only care about the stage gate
- * (ASC.2's `Skill.requires: chain_stage` precondition, ASC.5's rule guards).
- */
-export async function readChainStage(sessionId) {
-    return (await readChainState(sessionId))?.stage ?? 'idle';
-}
-/**
- * Remove the chain-state file (SessionEnd cleanup). ENOENT is swallowed —
- * a session that never advanced past 'idle' has no file to clear. Any other
- * error throws (caller wraps with best-effort discipline).
- */
-export async function clearChainState(sessionId) {
-    try {
-        await unlink(sessionStateFile(sessionId, CHAIN_STATE_KEY));
-    }
-    catch (e) {
-        if (e.code !== 'ENOENT')
-            throw e;
-    }
-}
-//# sourceMappingURL=chain_state.js.map

package/dist/runtime/chain_state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chain_state.js","sourceRoot":"","sources":["../../src/runtime/chain_state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,8FAA8F;AAC9F,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM;IACN,SAAS;IACT,YAAY;IACZ,eAAe;IACf,cAAc;IACd,kBAAkB;IAClB,iBAAiB;CACT,CAAC;AAIX,6DAA6D;AAC7D,MAAM,eAAe,GAAG,aAAa,CAAC;AA+BtC;;;;GAIG;AACH,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,CAA4B,CAAC;IACzC,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAE,YAAkC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,IAAgB,EAChB,MAAoB;IAEpB,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,OAAO,EAAE,KAAK,KAAK,IAAI;QAAE,OAAO,CAAC,qCAAqC;IAE1E,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,8EAA8E;IAC9E,0BAA0B;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gDAAgD,OAAO,EAAE,KAAK,IAAI,MAAM,OAAO,IAAI,2BAA2B,CAC/G,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAe;QACzB,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,GAAG;QACf,kBAAkB,EAAE,GAAG;QACvB,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;KACjE,CAAC;IACF,6EAA6E;IAC7E,mEAAmE;IACnE,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB;IACpD,OAAO,CAAC,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,IAAI,MAAM,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/runtime/hooks/permission_decision.d.ts

@@ -1,34 +0,0 @@
-/**
- * PreToolUse permission-decision envelope (T-RJ-FOLLOWUPS FU.11).
- *
- * A PreToolUse hook signals a block in one of two ways:
- *   - `exit 2` — the simple path, BUT `--dangerously-skip-permissions`
- *     (= `bypassPermissions` mode) silently IGNORES it (proven live: a
- *     `git commit` the gate should block ran anyway).
- *   - a `permissionDecision: "deny"` JSON envelope on stdout (exit 0) — HONORED
- *     even under `bypassPermissions` (proven live: the call was denied).
- *
- * So opensquid emits the JSON envelope on every block, making drift gates
- * enforce in BOTH normal and bypass permission modes. Pure builder so the shape
- * is unit-testable without spawning the hook bin.
- */
-export interface PreToolUseDeny {
-    hookSpecificOutput: {
-        hookEventName: 'PreToolUse';
-        permissionDecision: 'deny';
-        permissionDecisionReason: string;
-    };
-}
-/**
- * Every drift/block message opensquid emits to the user carries a leading 🦑 so
- * it's unmistakably opensquid speaking — NOT the agent's own prose, NOT a chat
- * message (chat replies via chat_send are deliberately unprefixed). Added HERE at
- * the hook EMIT boundary (not in the dispatcher/verdict layer) so skill YAML
- * `message:` fields stay clean and the dispatch internals stay emoji-free.
- * Idempotent; empty string passes through untouched (nothing to surface).
- */
-export declare const SQUID = "\uD83E\uDD91";
-export declare function squidPrefix(message: string): string;
-/** Build the deny envelope; falls back to a generic reason when none is given. */
-export declare function buildPreToolUseDeny(reason: string): PreToolUseDeny;
-//# sourceMappingURL=permission_decision.d.ts.map

package/dist/runtime/hooks/permission_decision.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"permission_decision.d.ts","sourceRoot":"","sources":["../../../src/runtime/hooks/permission_decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE;QAClB,aAAa,EAAE,YAAY,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;CACH;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,iBAAO,CAAC;AAC1B,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAUlE"}