audit-tools 0.28.0

package/dist/audit/reporting/workBlocks.js.map

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

package/dist/audit/supervisor/operatorHandoff.d.ts

@@ -0,0 +1,65 @@
+import { type ArtifactBundle } from "../io/artifacts.js";
+import type { AuditState, AuditTopLevelStatus } from "../types/auditState.js";
+export interface AuditCodeHandoffInput {
+    flag: "--results" | "--batch-results" | "--updates" | "--external-analyzer-results";
+    suggested_path: string;
+    description: string;
+}
+export interface AuditCodeHandoffArtifactPaths {
+    incoming_dir: string;
+    operator_handoff_json: string;
+    operator_handoff_markdown: string;
+    session_config: string;
+    run_ledger: string;
+    current_task: string | null;
+    current_prompt: string | null;
+    current_tasks: string | null;
+    audit_tasks: string | null;
+    runtime_validation_tasks: string | null;
+}
+export interface ActiveReviewRun {
+    run_id: string;
+    task_path: string;
+    prompt_path: string;
+    pending_audit_tasks_path?: string;
+    audit_results_path: string;
+    worker_command: string[];
+}
+export declare const CONFIG_ERROR_BLOCKER_PREFIX = "config-error:";
+export interface AuditCodeHandoff {
+    status: AuditTopLevelStatus;
+    repo_root: string;
+    artifacts_dir: string;
+    provider: string | null;
+    summary: string;
+    pending_obligations: string[];
+    suggested_inputs: AuditCodeHandoffInput[];
+    suggested_commands: string[];
+    interactive_provider_hint: string | null;
+    artifact_paths: AuditCodeHandoffArtifactPaths;
+    active_review_run?: ActiveReviewRun;
+    quick_start?: string;
+    file_map?: Record<string, string>;
+}
+export declare const INCOMING_DIRNAME = "incoming";
+export declare const OPERATOR_HANDOFF_JSON_FILENAME = "operator-handoff.json";
+export declare const OPERATOR_HANDOFF_MARKDOWN_FILENAME = "operator-handoff.md";
+export declare const SESSION_CONFIG_FILENAME = "session-config.json";
+export declare const RUN_LEDGER_FILENAME = "run-ledger.json";
+export declare const CURRENT_TASK_FILENAME = "current-task.json";
+export declare const CURRENT_PROMPT_FILENAME = "current-prompt.md";
+export declare const CURRENT_TASKS_FILENAME = "current-tasks.json";
+export declare const AUDIT_TASKS_FILENAME = "audit_tasks.json";
+export declare const RUNTIME_VALIDATION_TASKS_FILENAME = "runtime_validation_tasks.json";
+export declare function buildAuditCodeHandoff(params: {
+    root: string;
+    artifactsDir: string;
+    state: AuditState;
+    bundle: ArtifactBundle;
+    providerName?: string | null;
+    progressSummary: string;
+    isConfigError?: boolean;
+    activeReviewRun?: ActiveReviewRun;
+}): AuditCodeHandoff;
+export declare function writeAuditCodeHandoffArtifacts(handoff: AuditCodeHandoff): Promise<void>;
+//# sourceMappingURL=operatorHandoff.d.ts.map

package/dist/audit/supervisor/operatorHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatorHandoff.d.ts","sourceRoot":"","sources":["../../../src/audit/supervisor/operatorHandoff.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAyB,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EAEpB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EACA,WAAW,GACX,iBAAiB,GACjB,WAAW,GACX,6BAA6B,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,cAAc,EAAE,6BAA6B,CAAC;IAC9C,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AACtE,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AACxE,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,iCAAiC,kCAAkC,CAAC;AAuPjF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,GAAG,gBAAgB,CA2FnB;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/audit/supervisor/operatorHandoff.js

@@ -0,0 +1,277 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { writeJsonFile } from "audit-tools/shared";
+import { AUDIT_REPORT_FILENAME } from "../io/artifacts.js";
+import { LOCAL_SUBPROCESS_PROVIDER_NAME } from "../providers/constants.js";
+export const CONFIG_ERROR_BLOCKER_PREFIX = "config-error:";
+export const INCOMING_DIRNAME = "incoming";
+export const OPERATOR_HANDOFF_JSON_FILENAME = "operator-handoff.json";
+export const OPERATOR_HANDOFF_MARKDOWN_FILENAME = "operator-handoff.md";
+export const SESSION_CONFIG_FILENAME = "session-config.json";
+export const RUN_LEDGER_FILENAME = "run-ledger.json";
+export const CURRENT_TASK_FILENAME = "current-task.json";
+export const CURRENT_PROMPT_FILENAME = "current-prompt.md";
+export const CURRENT_TASKS_FILENAME = "current-tasks.json";
+export const AUDIT_TASKS_FILENAME = "audit_tasks.json";
+export const RUNTIME_VALIDATION_TASKS_FILENAME = "runtime_validation_tasks.json";
+const BLOCKED_STATUS = "blocked";
+const COMPLETE_STATUS = "complete";
+const NOT_STARTED_STATUS = "not_started";
+const NON_PENDING_OBLIGATION_STATES = new Set([
+    "present",
+    "satisfied",
+]);
+const INTERACTIVE_PROVIDER_OPTIONS = [
+    "auto",
+    "claude-code",
+    "codex",
+    "opencode",
+    "subprocess-template",
+    "vscode-task",
+    "antigravity",
+];
+function quoteShellPath(filePath) {
+    // The handoff renders a single shell argument, so the snippet only needs
+    // double-quote wrapping plus escaping embedded double quotes.
+    return `"${filePath.replace(/"/g, '\\"')}"`;
+}
+function renderShellCommand(argv) {
+    return argv.map((item) => quoteShellPath(item)).join(" ");
+}
+function buildPendingObligations(state) {
+    return state.obligations
+        .filter((item) => !NON_PENDING_OBLIGATION_STATES.has(item.state))
+        .map((item) => item.id);
+}
+function formatQuotedList(values) {
+    if (values.length === 1) {
+        return `"${values[0]}"`;
+    }
+    const head = values.slice(0, -1).map((value) => `"${value}"`).join(", ");
+    return `${head}, or "${values[values.length - 1]}"`;
+}
+function buildSummary(status, providerName, fallbackSummary) {
+    if (status === COMPLETE_STATUS) {
+        return "No operator handoff is required. All known obligations are currently satisfied.";
+    }
+    if (status === BLOCKED_STATUS) {
+        return fallbackSummary;
+    }
+    if (status === NOT_STARTED_STATUS) {
+        return "The artifact bundle is not initialized yet. Run the wrapper from the repository root to create the initial audit artifacts.";
+    }
+    return providerName
+        ? `Automatic work can continue under ${providerName}. Re-run the same wrapper or inspect the listed artifacts if you need operator context.`
+        : "Automatic work can continue. Re-run the same wrapper or inspect the listed artifacts if you need operator context.";
+}
+function buildSuggestedInputs(artifactsDir, status, isConfigError, activeReviewRun) {
+    if (status !== BLOCKED_STATUS || isConfigError) {
+        return [];
+    }
+    if (activeReviewRun) {
+        return [];
+    }
+    const incomingDir = join(artifactsDir, INCOMING_DIRNAME);
+    return [
+        {
+            flag: "--results",
+            suggested_path: join(incomingDir, "audit-results.json"),
+            description: "Import structured audit-review results after manual or provider-assisted review finishes.",
+        },
+        {
+            flag: "--batch-results",
+            suggested_path: join(incomingDir, "audit-results-batch"),
+            description: "Import a directory of per-batch audit result files when the conversation agent reviews multiple tasks before ingestion.",
+        },
+        {
+            flag: "--updates",
+            suggested_path: join(incomingDir, "runtime-validation-updates.json"),
+            description: "Merge runtime validation evidence updates gathered outside the wrapper.",
+        },
+        {
+            flag: "--external-analyzer-results",
+            suggested_path: join(incomingDir, "external-analyzer-results.json"),
+            description: "Import normalized external analyzer results such as Semgrep findings.",
+        },
+    ];
+}
+function buildSuggestedCommands(artifactsDir, suggestedInputs, status, activeReviewRun) {
+    if (status !== BLOCKED_STATUS) {
+        return [];
+    }
+    if (activeReviewRun) {
+        return [
+            renderShellCommand([
+                "audit-code",
+                "next-step",
+                "--artifacts-dir",
+                artifactsDir,
+            ]),
+        ];
+    }
+    return suggestedInputs.map((item) => `audit-code advance-audit ${item.flag} ${quoteShellPath(item.suggested_path)}`);
+}
+function buildInteractiveProviderHint(status, providerName, sessionConfigPath, isConfigError) {
+    if (status !== BLOCKED_STATUS) {
+        return null;
+    }
+    if (isConfigError) {
+        return `Configuration error: Verify --root points to the intended repository root and that the tree contains auditable files.`;
+    }
+    const providerLabel = providerName ?? LOCAL_SUBPROCESS_PROVIDER_NAME;
+    return `Provider: ${providerLabel}. This is a deterministic semantic-review handoff, not a failed audit. Use host subagents when the active toolset provides them; otherwise use the single-task fallback and stop after the worker command. For automatic LLM review, configure an interactive provider in ${sessionConfigPath}; that is only needed for backend-launched review.`;
+}
+// Single source for which artifact paths render in the markdown handoff and how
+// absent ones read. renderMarkdown and file_map both source paths from the
+// artifact path model (AuditCodeHandoffArtifactPaths), so adding or renaming a
+// handoff artifact is one edit here instead of coordinated edits across sites.
+const ARTIFACT_PATH_RENDER_FIELDS = [
+    { label: "operator handoff json", key: "operator_handoff_json" },
+    { label: "operator handoff markdown", key: "operator_handoff_markdown" },
+    { label: "incoming dir", key: "incoming_dir" },
+    { label: "session config", key: "session_config" },
+    { label: "run ledger", key: "run_ledger" },
+    { label: "current task", key: "current_task", fallback: "not available" },
+    { label: "current prompt", key: "current_prompt", fallback: "not available" },
+    { label: "current tasks", key: "current_tasks", fallback: "not available" },
+    { label: "audit tasks", key: "audit_tasks", fallback: "not available yet" },
+    {
+        label: "runtime validation tasks",
+        key: "runtime_validation_tasks",
+        fallback: "not available yet",
+    },
+];
+function renderMarkdown(handoff) {
+    const lines = [
+        "# audit-code operator handoff",
+        "",
+        `Status: ${handoff.status}`,
+        `Provider: ${handoff.provider ?? "n/a"}`,
+        `Repo root: ${handoff.repo_root}`,
+        `Artifacts dir: ${handoff.artifacts_dir}`,
+        "",
+        `Summary: ${handoff.summary}`,
+        "",
+        "Pending obligations:",
+    ];
+    if (handoff.pending_obligations.length === 0) {
+        lines.push("- none");
+    }
+    else {
+        for (const obligation of handoff.pending_obligations) {
+            lines.push(`- ${obligation}`);
+        }
+    }
+    lines.push("", "Useful artifact paths:");
+    for (const field of ARTIFACT_PATH_RENDER_FIELDS) {
+        const value = handoff.artifact_paths[field.key];
+        lines.push(`- ${field.label}: ${value ?? field.fallback ?? "not available"}`);
+    }
+    if (handoff.suggested_inputs.length > 0) {
+        lines.push("", "Suggested evidence inputs:");
+        for (const item of handoff.suggested_inputs) {
+            lines.push(`- ${item.flag} -> ${item.suggested_path}`);
+            lines.push(`  ${item.description}`);
+        }
+    }
+    if (handoff.suggested_commands.length > 0) {
+        lines.push("", "Suggested commands:");
+        for (const command of handoff.suggested_commands) {
+            lines.push(`- ${command}`);
+        }
+        if (handoff.active_review_run) {
+            lines.push("- Use next-step so the backend renders either packet dispatch or single-task fallback from CLI flags, session config, environment, or the default single-task path.");
+        }
+    }
+    if (handoff.active_review_run) {
+        lines.push("", "Active review run:");
+        lines.push(`- run id: ${handoff.active_review_run.run_id}`);
+        lines.push(`- task file: ${handoff.active_review_run.task_path}`);
+        lines.push(`- prompt file: ${handoff.active_review_run.prompt_path}`);
+        if (handoff.active_review_run.pending_audit_tasks_path) {
+            lines.push(`- pending tasks: ${handoff.active_review_run.pending_audit_tasks_path}`);
+        }
+        lines.push(`- audit results: ${handoff.active_review_run.audit_results_path}`);
+    }
+    if (handoff.interactive_provider_hint) {
+        lines.push("", "Interactive provider hint:");
+        lines.push(`- ${handoff.interactive_provider_hint}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+export function buildAuditCodeHandoff(params) {
+    const isConfigError = params.isConfigError ?? false;
+    const incomingDir = join(params.artifactsDir, INCOMING_DIRNAME);
+    const artifactPaths = {
+        incoming_dir: incomingDir,
+        operator_handoff_json: join(params.artifactsDir, OPERATOR_HANDOFF_JSON_FILENAME),
+        operator_handoff_markdown: join(params.artifactsDir, OPERATOR_HANDOFF_MARKDOWN_FILENAME),
+        session_config: join(params.artifactsDir, SESSION_CONFIG_FILENAME),
+        run_ledger: join(params.artifactsDir, RUN_LEDGER_FILENAME),
+        current_task: params.state.status === BLOCKED_STATUS
+            ? join(params.artifactsDir, "dispatch", CURRENT_TASK_FILENAME)
+            : null,
+        current_prompt: params.state.status === BLOCKED_STATUS
+            ? join(params.artifactsDir, "dispatch", CURRENT_PROMPT_FILENAME)
+            : null,
+        current_tasks: params.state.status === BLOCKED_STATUS
+            ? join(params.artifactsDir, "dispatch", CURRENT_TASKS_FILENAME)
+            : null,
+        audit_tasks: params.bundle.audit_tasks
+            ? join(params.artifactsDir, AUDIT_TASKS_FILENAME)
+            : null,
+        runtime_validation_tasks: params.bundle.runtime_validation_tasks
+            ? join(params.artifactsDir, RUNTIME_VALIDATION_TASKS_FILENAME)
+            : null,
+    };
+    const suggestedInputs = buildSuggestedInputs(params.artifactsDir, params.state.status, isConfigError, params.activeReviewRun);
+    const handoff = {
+        status: params.state.status,
+        repo_root: params.root,
+        artifacts_dir: params.artifactsDir,
+        provider: params.providerName ?? null,
+        summary: buildSummary(params.state.status, params.providerName ?? null, params.progressSummary),
+        pending_obligations: buildPendingObligations(params.state),
+        suggested_inputs: suggestedInputs,
+        suggested_commands: buildSuggestedCommands(params.artifactsDir, suggestedInputs, params.state.status, params.activeReviewRun),
+        interactive_provider_hint: buildInteractiveProviderHint(params.state.status, params.providerName ?? null, artifactPaths.session_config, isConfigError),
+        artifact_paths: artifactPaths,
+        active_review_run: params.activeReviewRun,
+    };
+    // Add quick_start command and file map when blocked for review
+    if (params.state.status === BLOCKED_STATUS && params.activeReviewRun) {
+        handoff.quick_start = renderShellCommand([
+            "audit-code",
+            "next-step",
+            "--artifacts-dir",
+            params.artifactsDir,
+        ]);
+        handoff.file_map = {
+            current_task: artifactPaths.current_task,
+            current_prompt: artifactPaths.current_prompt,
+            audit_results: params.activeReviewRun.audit_results_path,
+            // Synthesis writes the report into the artifacts dir; it is only promoted
+            // to <repo-root>/audit-report.md at completion (which then removes the
+            // artifacts dir). A blocked-for-review handoff happens before that, so the
+            // advertised deliverable must point at its real mid-run location, not the
+            // repo-root path that does not exist yet.
+            final_report: join(params.artifactsDir, AUDIT_REPORT_FILENAME),
+        };
+    }
+    return handoff;
+}
+export async function writeAuditCodeHandoffArtifacts(handoff) {
+    try {
+        await mkdir(handoff.artifact_paths.incoming_dir, { recursive: true });
+        await mkdir(join(handoff.artifact_paths.incoming_dir, "audit-results-batch"), {
+            recursive: true,
+        });
+        await writeJsonFile(handoff.artifact_paths.operator_handoff_json, handoff);
+        await writeFile(handoff.artifact_paths.operator_handoff_markdown, renderMarkdown(handoff), "utf8");
+    }
+    catch (error) {
+        throw new Error(`Failed to write operator handoff artifacts: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+}
+//# sourceMappingURL=operatorHandoff.js.map

package/dist/audit/supervisor/operatorHandoff.js.map

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

package/dist/audit/supervisor/runLedger.d.ts

@@ -0,0 +1,4 @@
+import { type RunLedger, type RunLedgerEntry } from "audit-tools/shared";
+export declare function loadRunLedger(artifactsDir: string): Promise<RunLedger>;
+export declare function appendRunLedgerEntry(artifactsDir: string, entry: RunLedgerEntry): Promise<void>;
+//# sourceMappingURL=runLedger.d.ts.map

package/dist/audit/supervisor/runLedger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runLedger.d.ts","sourceRoot":"","sources":["../../../src/audit/supervisor/runLedger.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AA8G5B,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAW5E;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/audit/supervisor/runLedger.js

@@ -0,0 +1,118 @@
+import { mkdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { RUN_LEDGER_STATUSES, } from "audit-tools/shared";
+import { isFileMissingError, readJsonFile, writeJsonFile, withFileLock } from "audit-tools/shared";
+const RUN_LEDGER_FILENAME = "run-ledger.json";
+const RUN_LEDGER_LOCK_FILENAME = "run-ledger.lock";
+const VALID_RUN_LEDGER_STATUSES = new Set(RUN_LEDGER_STATUSES);
+function ledgerPath(artifactsDir) {
+    return join(artifactsDir, RUN_LEDGER_FILENAME);
+}
+/**
+ * Wrap withFileLock for the run ledger, emitting a stderr message when the
+ * lock file already exists so operators can observe prolonged lock waits
+ * before the full timeout expires.
+ */
+async function withLedgerLock(lockPath, fn) {
+    // Check for contention via stat (read-only probe — no acquire/release cycle).
+    try {
+        await stat(lockPath);
+        // Lock file exists — contention likely; log before entering the retry loop.
+        process.stderr.write(`[audit-code] runLedger: lock contention detected on ${lockPath}, waiting...\n`);
+    }
+    catch {
+        // Lock file absent — no contention; proceed silently.
+    }
+    return withFileLock(lockPath, fn);
+}
+function ledgerLockPath(artifactsDir) {
+    return join(artifactsDir, RUN_LEDGER_LOCK_FILENAME);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function assertRunLedgerEntry(value, fieldPath) {
+    if (!isRecord(value)) {
+        throw new Error(`Invalid run ledger in ${fieldPath}: expected an object.`);
+    }
+    const requireString = (field) => {
+        const entry = value[field];
+        if (typeof entry !== "string" || entry.trim().length === 0) {
+            throw new Error(`Invalid run ledger in ${fieldPath}.${field}: expected a non-empty string.`);
+        }
+        return entry;
+    };
+    const requireNullableString = (field) => {
+        const entry = value[field];
+        if (entry === null) {
+            return null;
+        }
+        if (typeof entry !== "string" || entry.trim().length === 0) {
+            throw new Error(`Invalid run ledger in ${fieldPath}.${field}: expected a non-empty string or null.`);
+        }
+        return entry;
+    };
+    const status = value.status;
+    if (typeof status !== "string" ||
+        !VALID_RUN_LEDGER_STATUSES.has(status)) {
+        throw new Error(`Invalid run ledger in ${fieldPath}.status: expected one of ${Array.from(VALID_RUN_LEDGER_STATUSES).join(", ")}.`);
+    }
+    return {
+        run_id: requireString("run_id"),
+        provider: requireString("provider"),
+        obligation_id: requireNullableString("obligation_id"),
+        selected_executor: requireNullableString("selected_executor"),
+        status: status,
+        started_at: requireString("started_at"),
+        ended_at: requireString("ended_at"),
+        result_path: requireString("result_path"),
+    };
+}
+function parseRunLedger(value, path) {
+    if (!isRecord(value)) {
+        throw new Error(`Invalid run ledger in ${path}: expected an object.`);
+    }
+    if (!Array.isArray(value.runs)) {
+        throw new Error(`Invalid run ledger in ${path}: expected runs to be an array.`);
+    }
+    return {
+        runs: value.runs.map((entry, index) => assertRunLedgerEntry(entry, `${path}.runs[${index}]`)),
+    };
+}
+export async function loadRunLedger(artifactsDir) {
+    const path = ledgerPath(artifactsDir);
+    try {
+        return parseRunLedger(await readJsonFile(path), path);
+    }
+    catch (error) {
+        if (isFileMissingError(error)) {
+            // A missing run ledger just means no worker runs have been recorded yet.
+            return { runs: [] };
+        }
+        throw error;
+    }
+}
+export async function appendRunLedgerEntry(artifactsDir, entry) {
+    const path = ledgerPath(artifactsDir);
+    const lockPath = ledgerLockPath(artifactsDir);
+    await mkdir(artifactsDir, { recursive: true });
+    // Emit a structured event so run outcomes are observable without reading the ledger file.
+    process.stderr.write(JSON.stringify({
+        event: "run_ledger_entry",
+        run_id: entry.run_id,
+        provider: entry.provider,
+        obligation_id: entry.obligation_id,
+        selected_executor: entry.selected_executor,
+        status: entry.status,
+        started_at: entry.started_at,
+        ended_at: entry.ended_at,
+    }) + "\n");
+    await withLedgerLock(lockPath, async () => {
+        const ledger = await loadRunLedger(artifactsDir);
+        ledger.runs.push(entry);
+        // Single atomic write through the shared writer (temp + atomic rename); the
+        // prior local temp-then-rename on top of it was a redundant double rename.
+        await writeJsonFile(path, ledger);
+    });
+}
+//# sourceMappingURL=runLedger.js.map

package/dist/audit/supervisor/runLedger.js.map

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

package/dist/audit/supervisor/sessionConfig.d.ts

@@ -0,0 +1,12 @@
+import { type AnalyzerSetting, type SessionConfig } from "audit-tools/shared";
+export declare function getSessionConfigPath(artifactsDir: string): string;
+export declare function readSessionConfigFile(artifactsDir: string): Promise<unknown | undefined>;
+export declare function loadSessionConfig(artifactsDir: string): Promise<SessionConfig>;
+/**
+ * Merge per-analyzer resolution decisions into `session-config.json`,
+ * preserving any unknown fields, validating, and persisting the result. Used by
+ * the conversation-first `analyzer_install` step to durably record the host's
+ * `{ephemeral|permanent|skip}` choices under `analyzers.<id>`.
+ */
+export declare function persistAnalyzerSettings(artifactsDir: string, settings: Record<string, AnalyzerSetting>): Promise<SessionConfig>;
+//# sourceMappingURL=sessionConfig.d.ts.map

package/dist/audit/supervisor/sessionConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionConfig.d.ts","sourceRoot":"","sources":["../../../src/audit/supervisor/sessionConfig.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAMnB,MAAM,oBAAoB,CAAC;AAM5B,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAE9B;AASD,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CAcxB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GACxC,OAAO,CAAC,aAAa,CAAC,CAexB"}

package/dist/audit/supervisor/sessionConfig.js

@@ -0,0 +1,49 @@
+import { join } from "node:path";
+import { isRecord, readOptionalJsonFile, writeJsonFile, formatValidationIssues, } from "audit-tools/shared";
+import { validateSessionConfig } from "../validation/sessionConfig.js";
+const SESSION_CONFIG_FILENAME = "session-config.json";
+const DEFAULT_SESSION_CONFIG = { provider: "local-subprocess" };
+export function getSessionConfigPath(artifactsDir) {
+    return join(artifactsDir, SESSION_CONFIG_FILENAME);
+}
+export async function readSessionConfigFile(artifactsDir) {
+    return await readOptionalJsonFile(getSessionConfigPath(artifactsDir));
+}
+function formatConfigValidationIssues(configPath, issues) {
+    return `Invalid ${configPath}:\n${formatValidationIssues(issues).replace(/^  /gm, "- ")}`;
+}
+export async function loadSessionConfig(artifactsDir) {
+    const configPath = getSessionConfigPath(artifactsDir);
+    const rawConfig = await readOptionalJsonFile(configPath);
+    if (rawConfig === undefined) {
+        await writeJsonFile(configPath, DEFAULT_SESSION_CONFIG);
+        return { ...DEFAULT_SESSION_CONFIG };
+    }
+    const issues = validateSessionConfig(rawConfig);
+    if (issues.length > 0) {
+        throw new Error(formatConfigValidationIssues(configPath, issues));
+    }
+    return rawConfig;
+}
+/**
+ * Merge per-analyzer resolution decisions into `session-config.json`,
+ * preserving any unknown fields, validating, and persisting the result. Used by
+ * the conversation-first `analyzer_install` step to durably record the host's
+ * `{ephemeral|permanent|skip}` choices under `analyzers.<id>`.
+ */
+export async function persistAnalyzerSettings(artifactsDir, settings) {
+    const configPath = getSessionConfigPath(artifactsDir);
+    const raw = (await readOptionalJsonFile(configPath)) ?? {
+        ...DEFAULT_SESSION_CONFIG,
+    };
+    const base = isRecord(raw) ? raw : { ...DEFAULT_SESSION_CONFIG };
+    const current = isRecord(base.analyzers) ? base.analyzers : {};
+    const merged = { ...base, analyzers: { ...current, ...settings } };
+    const issues = validateSessionConfig(merged);
+    if (issues.length > 0) {
+        throw new Error(formatConfigValidationIssues(configPath, issues));
+    }
+    await writeJsonFile(configPath, merged);
+    return merged;
+}
+//# sourceMappingURL=sessionConfig.js.map

package/dist/audit/supervisor/sessionConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionConfig.js","sourceRoot":"","sources":["../../../src/audit/supervisor/sessionConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAGL,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,sBAAsB,GAEvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AACtD,MAAM,sBAAsB,GAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;AAE/E,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,OAAO,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAoB;IAEpB,OAAO,MAAM,oBAAoB,CAAU,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,4BAA4B,CACnC,UAAkB,EAClB,MAAyB;IAEzB,OAAO,WAAW,UAAU,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAAoB;IAEpB,MAAM,UAAU,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAU,UAAU,CAAC,CAAC;IAClE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,aAAa,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;QACxD,OAAO,EAAE,GAAG,sBAAsB,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,SAA0B,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB,EACpB,QAAyC;IAEzC,MAAM,UAAU,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,CAAC,MAAM,oBAAoB,CAAU,UAAU,CAAC,CAAC,IAAI;QAC/D,GAAG,sBAAsB;KAC1B,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,sBAAsB,EAAE,CAAC;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,EAAE,EAAE,CAAC;IAEnE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,MAAuB,CAAC;AACjC,CAAC"}

package/dist/audit/types/activeDispatch.d.ts

@@ -0,0 +1,36 @@
+import type { PartialCompletionTerminal } from "audit-tools/shared";
+export declare const DISPATCH_RESULT_MAP_FILENAME = "dispatch-result-map.json";
+export declare const ACTIVE_DISPATCH_FILENAME = "active-dispatch.json";
+export interface ActiveDispatchState {
+    run_id: string;
+    created_at: string;
+    /** Emitted packets only (after budget filtering). */
+    packet_count: number;
+    /** Tasks remaining this round (not-yet-done), not just emitted-packet tasks. */
+    task_count: number;
+    status: "active" | "merged";
+    /** Total packets that would have been emitted before a budget cap (present only when capped). */
+    budget_packet_count?: number;
+    /** packet_ids NOT emitted due to the budget cap. */
+    deferred_packet_ids?: string[];
+    /** task_ids NOT emitted due to the budget cap. */
+    deferred_task_ids?: string[];
+    /**
+     * Set when the dispatch engine fires a partial-completion terminal (empty pool
+     * or livelock guard). Presence of this field allows `deriveAuditState` to treat
+     * `audit_tasks_completed` as satisfied so the pipeline can proceed to synthesis
+     * on partial coverage, without blocking on tasks that can never be dispatched.
+     */
+    partial_completion_terminal?: PartialCompletionTerminal;
+}
+export interface DispatchResultMapEntry {
+    packet_id: string;
+    task_id: string;
+    result_path: string;
+}
+export interface DispatchResultMap {
+    contract_version: "audit-code-dispatch-results/v1alpha1";
+    run_id: string;
+    entries: DispatchResultMapEntry[];
+}
+//# sourceMappingURL=activeDispatch.d.ts.map

package/dist/audit/types/activeDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeDispatch.d.ts","sourceRoot":"","sources":["../../../src/audit/types/activeDispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,yBAAyB,CAAC;CACzD;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,sCAAsC,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC"}

package/dist/audit/types/activeDispatch.js

@@ -0,0 +1,3 @@
+export const DISPATCH_RESULT_MAP_FILENAME = "dispatch-result-map.json";
+export const ACTIVE_DISPATCH_FILENAME = "active-dispatch.json";
+//# sourceMappingURL=activeDispatch.js.map

package/dist/audit/types/activeDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeDispatch.js","sourceRoot":"","sources":["../../../src/audit/types/activeDispatch.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC"}