@telora/daemon 0.18.40 → 0.18.55

package/dist/crash-recovery-scan.js

@@ -1,145 +0,0 @@
-/**
- * Worktree scanning for crash recovery.
- *
- * Parses `git worktree list` output and reconciles against DB sessions
- * and active focuses to classify worktrees as active or orphaned.
- */
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { runGitSync } from './git.js';
-import { defaultDeps } from './crash-recovery-types.js';
-// ── Helpers ──────────────────────────────────────────────────────
-/**
- * Extract the focus ID prefix (last 8 hex chars) from a worktree directory name.
- * Focus worktree directories follow: agent-{role}-{name}-{8-char-id}
- */
-function extractFocusIdPrefix(dirName) {
-    const match = dirName.match(/-([0-9a-f]{8})$/);
-    return match ? match[1] : null;
-}
-// ── Worktree scanning ────────────────────────────────────────────
-/**
- * Parse `git worktree list --porcelain` to build a map of
- * worktree path -> branch name for all registered worktrees.
- */
-export function parseWorktreeList(repoPath) {
-    const result = runGitSync(['worktree', 'list', '--porcelain'], repoPath);
-    const map = new Map();
-    if (!result.success)
-        return map;
-    let currentPath = null;
-    for (const line of result.output.split('\n')) {
-        if (line.startsWith('worktree ')) {
-            currentPath = line.slice('worktree '.length);
-        }
-        else if (line.startsWith('branch refs/heads/') && currentPath) {
-            map.set(currentPath, line.slice('branch refs/heads/'.length));
-            currentPath = null;
-        }
-        else if (line === '') {
-            currentPath = null;
-        }
-    }
-    return map;
-}
-/**
- * Scan the worktree directory and reconcile against active DB sessions
- * to classify each worktree as active or orphaned.
- */
-export async function detectOrphanedWorktrees(config, deps = defaultDeps) {
-    const { worktreeDir, repoPath } = config;
-    // 1. Read all subdirectories in worktreeDir
-    if (!existsSync(worktreeDir))
-        return [];
-    const entries = readdirSync(worktreeDir);
-    const subdirs = entries.filter((entry) => {
-        const fullPath = join(worktreeDir, entry);
-        try {
-            return statSync(fullPath).isDirectory();
-        }
-        catch (e) {
-            console.debug(`[crash-recovery] Failed to stat ${fullPath} (may have been deleted):`, e.message);
-            return false;
-        }
-    });
-    if (subdirs.length === 0)
-        return [];
-    // 2. Parse git worktree list to map paths -> branch names
-    const worktreeMap = parseWorktreeList(repoPath);
-    // Build a reverse lookup: resolve worktree paths so we can match
-    const pathToBranch = new Map();
-    for (const [wtPath, branch] of worktreeMap) {
-        pathToBranch.set(resolve(wtPath), branch);
-    }
-    // 3. Query active sessions from DB
-    let activeSessions = [];
-    try {
-        activeSessions = await deps.getActiveSessions();
-    }
-    catch (err) {
-        console.warn(`[crash-recovery] Failed to query active sessions from DB: ${err instanceof Error ? err.message : String(err)}. ` +
-            `Treating all worktrees as orphaned.`);
-    }
-    // Build set of branch names with active sessions
-    const activeBranches = new Set(activeSessions.map((s) => s.branch_name));
-    // Build map of branch -> session for linking
-    const branchToSession = new Map();
-    for (const session of activeSessions) {
-        branchToSession.set(session.branch_name, session);
-    }
-    // 3b. Query active focuses to preserve persistent worktrees
-    const activeFocusIdPrefixes = new Set();
-    try {
-        const activeFocuses = await deps.getActiveFocuses(config.organizationId, config.productId);
-        for (const s of activeFocuses) {
-            activeFocusIdPrefixes.add(s.focus_id.slice(0, 8));
-        }
-    }
-    catch (err) {
-        console.warn(`[crash-recovery] Failed to query active focuses: ${err instanceof Error ? err.message : String(err)}. ` +
-            `Persistent focus worktrees may be incorrectly classified as orphaned.`);
-    }
-    // 4. Classify each worktree subdirectory
-    const orphans = [];
-    for (const subdir of subdirs) {
-        const fullPath = resolve(join(worktreeDir, subdir));
-        const branchName = pathToBranch.get(fullPath);
-        if (!branchName) {
-            // Directory exists but no git worktree entry -- likely a stale directory.
-            // Check if it belongs to an active focus before classifying as orphan.
-            const idPrefix = extractFocusIdPrefix(subdir);
-            if (idPrefix && activeFocusIdPrefixes.has(idPrefix)) {
-                console.log(`[crash-recovery] Worktree belongs to active focus (persistent, no git entry): ${fullPath}`);
-                continue;
-            }
-            // Try to infer branch from directory name (agent-role-delivery pattern).
-            console.log(`[crash-recovery] Worktree directory has no git entry: ${fullPath}`);
-            orphans.push({
-                worktreePath: fullPath,
-                branchName: subdir.replace(/-/g, '/').replace(/^agent\//, 'agent/'),
-                session: null,
-            });
-            continue;
-        }
-        if (activeBranches.has(branchName)) {
-            // Active session exists -- leave alone
-            console.log(`[crash-recovery] Worktree is active (has DB session): ${fullPath} [${branchName}]`);
-            continue;
-        }
-        // Check if this worktree belongs to an active focus (persistent worktree)
-        const idPrefix = extractFocusIdPrefix(subdir);
-        if (idPrefix && activeFocusIdPrefixes.has(idPrefix)) {
-            console.log(`[crash-recovery] Worktree belongs to active focus (persistent): ${fullPath} [${branchName}]`);
-            continue;
-        }
-        // No active session and no active focus -- orphaned
-        const session = branchToSession.get(branchName) ?? null;
-        orphans.push({
-            worktreePath: fullPath,
-            branchName,
-            session,
-        });
-    }
-    return orphans;
-}
-//# sourceMappingURL=crash-recovery-scan.js.map

package/dist/crash-recovery-scan.js.map

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

package/dist/crash-recovery-types.d.ts

@@ -1,49 +0,0 @@
-/**
- * Types and dependency injection for crash recovery.
- */
-import type { AgentSession } from './types.js';
-import { type CreateEscalationParams } from './queries/issues.js';
-export interface OrphanedWorktree {
-    /** Absolute path to the worktree directory. */
-    worktreePath: string;
-    /** Git branch name (e.g. agent/developer/my-delivery). */
-    branchName: string;
-    /** DB session that was still marked active, if any. */
-    session: AgentSession | null;
-}
-export interface CleanupAction {
-    worktreePath: string;
-    branchName: string;
-    action: 'removed' | 'preserved' | 'safety-committed' | 'safety-committed-and-removed';
-    /** Set when a safety commit was created. */
-    commitHash?: string;
-    /** Set when the orphan was preserved due to unmerged commits. */
-    unmergedCommitCount?: number;
-}
-export interface RecoveryResult {
-    orphansDetected: number;
-    orphansCleaned: number;
-    orphansPreserved: number;
-    branchesPruned: number;
-    branchesPreserved: number;
-    actions: CleanupAction[];
-    errors: string[];
-}
-/**
- * Injectable dependencies for testing.
- * Production code uses the defaults (real DB queries).
- */
-export interface RecoveryDeps {
-    getActiveSessions: () => Promise<AgentSession[]>;
-    getActiveFocuses: (organizationId: string, productId?: string) => Promise<Array<{
-        focus_id: string;
-        focus_name: string;
-        assigned_agent_role_id: string | null;
-    }>>;
-    updateSession: (sessionId: string, updates: Record<string, unknown>) => Promise<unknown>;
-    createEscalation: (params: CreateEscalationParams) => Promise<{
-        escalationId: string | null;
-    } | void>;
-}
-export declare const defaultDeps: RecoveryDeps;
-//# sourceMappingURL=crash-recovery-types.d.ts.map

package/dist/crash-recovery-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"crash-recovery-types.d.ts","sourceRoot":"","sources":["../src/crash-recovery-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKpF,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,kBAAkB,GAAG,8BAA8B,CAAC;IACtF,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACjD,gBAAgB,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IAClK,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzF,gBAAgB,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACvG;AAED,eAAO,MAAM,WAAW,EAAE,YAKzB,CAAC"}

package/dist/crash-recovery-types.js

@@ -1,13 +0,0 @@
-/**
- * Types and dependency injection for crash recovery.
- */
-import { getActiveSessions, updateSession } from './queries/sessions.js';
-import { createEscalation } from './queries/issues.js';
-import { getActiveFocuses } from './queries/deliveries.js';
-export const defaultDeps = {
-    getActiveSessions,
-    getActiveFocuses,
-    updateSession: (id, updates) => updateSession(id, updates),
-    createEscalation,
-};
-//# sourceMappingURL=crash-recovery-types.js.map

package/dist/crash-recovery-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"crash-recovery-types.js","sourceRoot":"","sources":["../src/crash-recovery-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAA+B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA4C3D,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,iBAAiB;IACjB,gBAAgB;IAChB,aAAa,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,OAA8C,CAAC;IACjG,gBAAgB;CACjB,CAAC"}

package/dist/prd-clearance-engine.d.ts

@@ -1,121 +0,0 @@
-/**
- * PRD obstacle clearance predicate engine -- Staged Assembly: PRD Layer.
- *
- * This module lifts the per-delivery verification engine one altitude up to the
- * PRD Prerequisite Tree (PRT) obstacle. Where `verification-engine.ts` answers
- * "is this delivery's injection cleared?", this answers "is this milestone's
- * obstacle cleared?" -- and, in aggregate, "is the whole milestone complete?".
- *
- * The clearance predicate is BOTH the completion signal AND the divergence
- * detector: a PRD (milestone) is done exactly when every obstacle's verifiable
- * clearance predicate passes. (UDE #4 -> desired effect: milestone completion
- * is computable.)
- *
- * Design constraints (delivery C):
- *   - PURE. No DB access, no reality-tree writes, no module-level mutable state.
- *     The caller fetches obstacles (from `prd_prt_nodes.clearance_predicate`) and
- *     passes them in; this module only computes verdicts.
- *   - Command execution is INJECTED via `ClearanceContext.runCommand` so tests
- *     never shell out. A `defaultRunCommand` is provided for real callers and
- *     mirrors `verification-engine.runDeterministicStrategy` (spawn `sh -c`, tail
- *     output at 4000 chars, exit 0 = pass) -- but returns the raw triple rather
- *     than a StrategyResult, keeping this module side-effect-light.
- *   - NO daemon-loop wiring here. Wiring into the focus/verification loop is a
- *     later delivery (D).
- *
- * Predicate kinds mirror the verification engine's strategy taxonomy:
- *   deterministic  -- run shell checks; all exit 0 => cleared.
- *   behavioral     -- runtime telemetry observation (deferred; no signal source).
- *   ai_inspection  -- AI reads code/state and decides (deferred; no driver).
- *   human          -- a human attests clearance (deferred; out of band).
- *
- * @module prd-clearance-engine
- */
-/** The kinds of clearance predicate, mirroring verification strategy methods. */
-export type ClearanceKind = 'deterministic' | 'behavioral' | 'ai_inspection' | 'human';
-/** A single deterministic shell check within a predicate. */
-export interface ClearanceCheck {
-    cmd: string;
-    label?: string;
-}
-/** An obstacle's verifiable clearance predicate (shape of `clearance_predicate`). */
-export interface ClearancePredicate {
-    kind: ClearanceKind;
-    checks?: ClearanceCheck[];
-}
-/** Outcome of running one deterministic check. */
-export interface ClearanceCheckResult {
-    cmd: string;
-    exitCode: number | null;
-    passed: boolean;
-}
-/** The verdict for a single obstacle's predicate. */
-export interface ClearanceVerdict {
-    kind: ClearanceKind;
-    /** True only when the predicate is computable AND every check passed. */
-    cleared: boolean;
-    /** True when the predicate kind has no automatic signal source (deferred). */
-    deferred: boolean;
-    /** Human-readable summary of how the verdict was reached. */
-    evidence: string;
-    /** Populated for deterministic predicates; one entry per check run. */
-    checkResults?: ClearanceCheckResult[];
-}
-/**
- * Injected command runner. Mirrors the spawn semantics of
- * `verification-engine.runDeterministicStrategy` but returns the raw triple so
- * this module stays free of StrategyResult/outcome coupling.
- */
-export type RunCommand = (cmd: string, cwd: string) => Promise<{
-    exitCode: number | null;
-    stdoutTail: string;
-    stderrTail: string;
-}>;
-/** Evaluation context: where to run, and (optionally) how to run. */
-export interface ClearanceContext {
-    worktreeDir: string;
-    /** Defaults to `defaultRunCommand` when omitted. Tests inject a fake. */
-    runCommand?: RunCommand;
-}
-/**
- * Real shell runner: spawn `sh -c <cmd>` in `cwd`, capture stdout/stderr tailed
- * to 4000 chars, resolve `{ exitCode, stdoutTail, stderrTail }`. A spawn error
- * resolves with `exitCode: null` (treated as a non-pass by callers). Mirrors
- * `verification-engine.runDeterministicStrategy` but returns the raw triple.
- */
-export declare const defaultRunCommand: RunCommand;
-/**
- * Evaluate a single obstacle's clearance predicate. PURE.
- *
- * - deterministic: run each check via `ctx.runCommand ?? defaultRunCommand`.
- *   exit 0 = passed. All pass => cleared. No checks (undefined/empty) =>
- *   not cleared, not deferred (a deterministic predicate with nothing to check
- *   cannot assert clearance).
- * - behavioral | ai_inspection | human: deferred (cleared:false, deferred:true);
- *   evidence names the deferral reason.
- */
-export declare function evaluateClearance(predicate: ClearancePredicate, ctx: ClearanceContext): Promise<ClearanceVerdict>;
-/**
- * Aggregate clearance across all obstacles of a PRT -- the "milestone
- * completion is computable" primitive. PURE; the caller fetches the obstacles
- * (each carrying its `clearance_predicate`).
- *
- * - `allCleared` is true only when there is at least one obstacle AND every
- *   obstacle's verdict is cleared. (An empty obstacle set cannot assert a
- *   complete milestone.)
- * - `deferredCount` counts obstacles whose predicate could not be evaluated
- *   automatically -- these block `allCleared` and flag where human/AI signal
- *   is still required.
- */
-export declare function evaluatePrtClearance(obstacles: {
-    nodeId: string;
-    predicate: ClearancePredicate;
-}[], ctx: ClearanceContext): Promise<{
-    nodeVerdicts: {
-        nodeId: string;
-        verdict: ClearanceVerdict;
-    }[];
-    allCleared: boolean;
-    deferredCount: number;
-}>;
-//# sourceMappingURL=prd-clearance-engine.d.ts.map

package/dist/prd-clearance-engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prd-clearance-engine.d.ts","sourceRoot":"","sources":["../src/prd-clearance-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAWH,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAAC;AAEvF,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,KACR,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElF,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAsC/B,CAAC;AAYF;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,kBAAkB,EAC7B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA4C3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,EAAE,EAC9D,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC;IACT,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,EAAE,CAAC;IAC9D,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAWD"}

package/dist/prd-clearance-engine.js

@@ -1,164 +0,0 @@
-/**
- * PRD obstacle clearance predicate engine -- Staged Assembly: PRD Layer.
- *
- * This module lifts the per-delivery verification engine one altitude up to the
- * PRD Prerequisite Tree (PRT) obstacle. Where `verification-engine.ts` answers
- * "is this delivery's injection cleared?", this answers "is this milestone's
- * obstacle cleared?" -- and, in aggregate, "is the whole milestone complete?".
- *
- * The clearance predicate is BOTH the completion signal AND the divergence
- * detector: a PRD (milestone) is done exactly when every obstacle's verifiable
- * clearance predicate passes. (UDE #4 -> desired effect: milestone completion
- * is computable.)
- *
- * Design constraints (delivery C):
- *   - PURE. No DB access, no reality-tree writes, no module-level mutable state.
- *     The caller fetches obstacles (from `prd_prt_nodes.clearance_predicate`) and
- *     passes them in; this module only computes verdicts.
- *   - Command execution is INJECTED via `ClearanceContext.runCommand` so tests
- *     never shell out. A `defaultRunCommand` is provided for real callers and
- *     mirrors `verification-engine.runDeterministicStrategy` (spawn `sh -c`, tail
- *     output at 4000 chars, exit 0 = pass) -- but returns the raw triple rather
- *     than a StrategyResult, keeping this module side-effect-light.
- *   - NO daemon-loop wiring here. Wiring into the focus/verification loop is a
- *     later delivery (D).
- *
- * Predicate kinds mirror the verification engine's strategy taxonomy:
- *   deterministic  -- run shell checks; all exit 0 => cleared.
- *   behavioral     -- runtime telemetry observation (deferred; no signal source).
- *   ai_inspection  -- AI reads code/state and decides (deferred; no driver).
- *   human          -- a human attests clearance (deferred; out of band).
- *
- * @module prd-clearance-engine
- */
-import { spawn } from 'node:child_process';
-const DEFAULT_CLEARANCE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
-const OUTPUT_TAIL_MAX = 4000;
-// ---------------------------------------------------------------------------
-// Default command runner (mirrors runDeterministicStrategy)
-// ---------------------------------------------------------------------------
-/**
- * Real shell runner: spawn `sh -c <cmd>` in `cwd`, capture stdout/stderr tailed
- * to 4000 chars, resolve `{ exitCode, stdoutTail, stderrTail }`. A spawn error
- * resolves with `exitCode: null` (treated as a non-pass by callers). Mirrors
- * `verification-engine.runDeterministicStrategy` but returns the raw triple.
- */
-export const defaultRunCommand = (cmd, cwd) => {
-    return new Promise((resolve) => {
-        const child = spawn('sh', ['-c', cmd], {
-            cwd,
-            stdio: ['ignore', 'pipe', 'pipe'],
-        });
-        let stdout = '';
-        let stderr = '';
-        const tail = (buf, max = OUTPUT_TAIL_MAX) => buf.length <= max ? buf : buf.slice(buf.length - max);
-        child.stdout?.on('data', (chunk) => {
-            stdout += chunk.toString('utf8');
-            stdout = tail(stdout);
-        });
-        child.stderr?.on('data', (chunk) => {
-            stderr += chunk.toString('utf8');
-            stderr = tail(stderr);
-        });
-        const timer = setTimeout(() => {
-            try {
-                child.kill('SIGKILL');
-            }
-            catch { /* ignore */ }
-        }, DEFAULT_CLEARANCE_TIMEOUT_MS);
-        child.on('error', (err) => {
-            clearTimeout(timer);
-            resolve({
-                exitCode: null,
-                stdoutTail: stdout,
-                stderrTail: tail(`${stderr}\n${err.message}`),
-            });
-        });
-        child.on('close', (code) => {
-            clearTimeout(timer);
-            resolve({ exitCode: code, stdoutTail: stdout, stderrTail: stderr });
-        });
-    });
-};
-// ---------------------------------------------------------------------------
-// Evaluation
-// ---------------------------------------------------------------------------
-const DEFERRAL_REASON = {
-    behavioral: 'behavioral clearance deferred -- no runtime telemetry source wired',
-    ai_inspection: 'ai_inspection clearance deferred -- no AI inspection driver wired',
-    human: 'human clearance deferred -- requires out-of-band human attestation',
-};
-/**
- * Evaluate a single obstacle's clearance predicate. PURE.
- *
- * - deterministic: run each check via `ctx.runCommand ?? defaultRunCommand`.
- *   exit 0 = passed. All pass => cleared. No checks (undefined/empty) =>
- *   not cleared, not deferred (a deterministic predicate with nothing to check
- *   cannot assert clearance).
- * - behavioral | ai_inspection | human: deferred (cleared:false, deferred:true);
- *   evidence names the deferral reason.
- */
-export async function evaluateClearance(predicate, ctx) {
-    if (predicate.kind !== 'deterministic') {
-        return {
-            kind: predicate.kind,
-            cleared: false,
-            deferred: true,
-            evidence: DEFERRAL_REASON[predicate.kind],
-        };
-    }
-    const checks = predicate.checks ?? [];
-    if (checks.length === 0) {
-        return {
-            kind: 'deterministic',
-            cleared: false,
-            deferred: false,
-            evidence: 'no checks defined -- deterministic predicate cannot assert clearance',
-            checkResults: [],
-        };
-    }
-    const run = ctx.runCommand ?? defaultRunCommand;
-    const checkResults = [];
-    for (const check of checks) {
-        const { exitCode } = await run(check.cmd, ctx.worktreeDir);
-        checkResults.push({
-            cmd: check.cmd,
-            exitCode,
-            passed: exitCode === 0,
-        });
-    }
-    const passedCount = checkResults.filter(r => r.passed).length;
-    const cleared = passedCount === checkResults.length;
-    return {
-        kind: 'deterministic',
-        cleared,
-        deferred: false,
-        evidence: cleared
-            ? `deterministic clearance passed (${passedCount}/${checkResults.length} checks exit 0)`
-            : `deterministic clearance failed (${passedCount}/${checkResults.length} checks exit 0)`,
-        checkResults,
-    };
-}
-/**
- * Aggregate clearance across all obstacles of a PRT -- the "milestone
- * completion is computable" primitive. PURE; the caller fetches the obstacles
- * (each carrying its `clearance_predicate`).
- *
- * - `allCleared` is true only when there is at least one obstacle AND every
- *   obstacle's verdict is cleared. (An empty obstacle set cannot assert a
- *   complete milestone.)
- * - `deferredCount` counts obstacles whose predicate could not be evaluated
- *   automatically -- these block `allCleared` and flag where human/AI signal
- *   is still required.
- */
-export async function evaluatePrtClearance(obstacles, ctx) {
-    const nodeVerdicts = [];
-    for (const obstacle of obstacles) {
-        const verdict = await evaluateClearance(obstacle.predicate, ctx);
-        nodeVerdicts.push({ nodeId: obstacle.nodeId, verdict });
-    }
-    const allCleared = obstacles.length > 0 && nodeVerdicts.every(nv => nv.verdict.cleared);
-    const deferredCount = nodeVerdicts.filter(nv => nv.verdict.deferred).length;
-    return { nodeVerdicts, allCleared, deferredCount };
-}
-//# sourceMappingURL=prd-clearance-engine.js.map

package/dist/prd-clearance-engine.js.map

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