audit-tools 0.28.0

package/dist/audit/io/artifacts.d.ts

@@ -0,0 +1,152 @@
+import { cp, rm } from "node:fs/promises";
+import type { AuditResult, AuditTask, CoverageMatrix, RepoManifest, UnitManifest } from "../types.js";
+import type { AuditState } from "../types/auditState.js";
+import type { ArtifactMetadataManifest } from "../types/artifactMetadata.js";
+import type { AuditFindingsReport, FileDisposition, CriticalFlowManifest, GraphBundle, RiskRegister, SurfaceManifest, IntentCheckpoint } from "audit-tools/shared";
+import type { ProviderConfirmationResult } from "audit-tools/shared";
+import type { SynthesisNarrativeRecord } from "../types/synthesisNarrative.js";
+import type { ExternalAnalyzerResults } from "../types/externalAnalyzer.js";
+import type { FlowCoverageManifest } from "../types/flowCoverage.js";
+import type { AuditPlanMetrics } from "../types/reviewPlanning.js";
+import type { TaskAffinityGraph } from "../orchestrator/taskAffinityGraph.js";
+import type { RuntimeValidationReport, RuntimeValidationTaskManifest } from "../types/runtimeValidation.js";
+import type { DesignAssessment } from "../types/designAssessment.js";
+import type { AnalyzerCapabilityRecord } from "../types/analyzerCapability.js";
+import type { AuditScopeManifest } from "../types/auditScope.js";
+import type { ToolingManifest } from "../types/toolingManifest.js";
+import type { ActiveDispatchState } from "../types/activeDispatch.js";
+import { type DesignReviewSnapshotBundle } from "../orchestrator/designReviewSnapshot.js";
+import { type AgentReflection } from "audit-tools/shared";
+/**
+ * Thrown when a versioned artifact is loaded from disk with a schema_version
+ * field that does not match the expected version constant.  The message names
+ * the artifact and both the expected and actual versions so the operator has
+ * an actionable diagnosis.
+ */
+export declare class ArtifactSchemaVersionError extends Error {
+    readonly artifactName: string;
+    readonly expected: string;
+    readonly actual: string;
+    constructor(artifactName: string, expected: string, actual: string);
+}
+type ArtifactPayloadMap = {
+    provider_confirmation: ProviderConfirmationResult;
+    repo_manifest: RepoManifest;
+    file_disposition: FileDisposition;
+    auto_fixes_applied: unknown;
+    intent_checkpoint: IntentCheckpoint;
+    unit_manifest: UnitManifest;
+    graph_bundle: GraphBundle;
+    surface_manifest: SurfaceManifest;
+    critical_flows: CriticalFlowManifest;
+    flow_coverage: FlowCoverageManifest;
+    risk_register: RiskRegister;
+    design_assessment: DesignAssessment;
+    analyzer_capability: AnalyzerCapabilityRecord;
+    scope: AuditScopeManifest;
+    coverage_matrix: CoverageMatrix;
+    runtime_validation_tasks: RuntimeValidationTaskManifest;
+    runtime_validation_report: RuntimeValidationReport;
+    external_analyzer_results: ExternalAnalyzerResults;
+    syntax_resolution_status: unknown;
+    audit_results: AuditResult[];
+    audit_tasks: AuditTask[];
+    audit_plan_metrics: AuditPlanMetrics;
+    task_affinity_graph: TaskAffinityGraph;
+    requeue_tasks: AuditTask[];
+    audit_report: string;
+    audit_findings: AuditFindingsReport;
+    synthesis_narrative: SynthesisNarrativeRecord;
+    audit_state: AuditState;
+    artifact_metadata: ArtifactMetadataManifest;
+    tooling_manifest: ToolingManifest;
+};
+/**
+ * Audit artifacts accumulate phase-by-phase as the orchestrator advances.
+ * Missing keys mean the corresponding artifact has not been produced yet.
+ *
+ * `active_dispatch` is loaded specially (like `tooling_manifest`): it lives at
+ * the artifacts root rather than as a standard pruned artifact, and carries the
+ * in-flight dispatch phase plus any budget-deferred task ids the completion
+ * obligation must exclude.
+ *
+ * `agent_reflections` is the parsed view of the worker-APPENDED
+ * `agent-feedback.jsonl` (opt-in meta-audit feedback). Workers own that file;
+ * the orchestrator only ever reads it, so it is deliberately NOT an
+ * ARTIFACT_DEFINITIONS entry — writeCoreArtifacts must never rewrite it (a
+ * round-trip would drop lines a worker appended after load, and prune would
+ * delete a file the orchestrator does not own).
+ */
+export type ArtifactBundle = Partial<ArtifactPayloadMap> & {
+    active_dispatch?: ActiveDispatchState;
+    agent_reflections?: AgentReflection[];
+    /**
+     * The design-review pass snapshots (B2 parity port), keyed by pass. Loaded
+     * specially like `active_dispatch` — they live under
+     * `design-review-snapshots/` rather than as standard pruned artifacts — so the
+     * synchronous `deriveAuditState` can key each pass's staleness on the semantic
+     * projection of the structural inputs it reviewed. Absent until first review.
+     */
+    design_review_snapshots?: DesignReviewSnapshotBundle;
+};
+export type ArtifactBundleKey = keyof ArtifactPayloadMap;
+type ArtifactPhase = "intake" | "analysis" | "execution" | "reporting" | "supervisor";
+interface ArtifactDefinition<K extends ArtifactBundleKey = ArtifactBundleKey> {
+    fileName: string;
+    phase: ArtifactPhase;
+    read: (path: string) => Promise<ArtifactPayloadMap[K] | undefined>;
+    write: (path: string, value: ArtifactPayloadMap[K]) => Promise<void>;
+}
+export declare const AUDIT_REPORT_FILENAME = "audit-report.md";
+export declare const ARTIFACT_DEFINITIONS: {
+    readonly provider_confirmation: ArtifactDefinition<"provider_confirmation">;
+    readonly repo_manifest: ArtifactDefinition<"repo_manifest">;
+    readonly file_disposition: ArtifactDefinition<"file_disposition">;
+    readonly auto_fixes_applied: ArtifactDefinition<"auto_fixes_applied">;
+    readonly intent_checkpoint: ArtifactDefinition<"intent_checkpoint">;
+    readonly unit_manifest: ArtifactDefinition<"unit_manifest">;
+    readonly graph_bundle: ArtifactDefinition<"graph_bundle">;
+    readonly surface_manifest: ArtifactDefinition<"surface_manifest">;
+    readonly critical_flows: ArtifactDefinition<"critical_flows">;
+    readonly flow_coverage: ArtifactDefinition<"flow_coverage">;
+    readonly risk_register: ArtifactDefinition<"risk_register">;
+    readonly design_assessment: ArtifactDefinition<"design_assessment">;
+    readonly analyzer_capability: ArtifactDefinition<"analyzer_capability">;
+    readonly scope: ArtifactDefinition<"scope">;
+    readonly coverage_matrix: ArtifactDefinition<"coverage_matrix">;
+    readonly runtime_validation_tasks: ArtifactDefinition<"runtime_validation_tasks">;
+    readonly runtime_validation_report: ArtifactDefinition<"runtime_validation_report">;
+    readonly external_analyzer_results: ArtifactDefinition<"external_analyzer_results">;
+    readonly syntax_resolution_status: ArtifactDefinition<"syntax_resolution_status">;
+    readonly audit_results: ArtifactDefinition<"audit_results">;
+    readonly audit_tasks: ArtifactDefinition<"audit_tasks">;
+    readonly audit_plan_metrics: ArtifactDefinition<"audit_plan_metrics">;
+    readonly task_affinity_graph: ArtifactDefinition<"task_affinity_graph">;
+    readonly requeue_tasks: ArtifactDefinition<"requeue_tasks">;
+    readonly audit_report: ArtifactDefinition<"audit_report">;
+    readonly audit_findings: ArtifactDefinition<"audit_findings">;
+    readonly synthesis_narrative: ArtifactDefinition<"synthesis_narrative">;
+    readonly audit_state: ArtifactDefinition<"audit_state">;
+    readonly artifact_metadata: ArtifactDefinition<"artifact_metadata">;
+    readonly tooling_manifest: ArtifactDefinition<"tooling_manifest">;
+};
+export declare const ARTIFACT_FILE_TO_BUNDLE_KEY: Record<string, ArtifactBundleKey>;
+export declare function getArtifactValue(bundle: ArtifactBundle, artifactName: string): unknown;
+export declare function loadArtifactBundle(root: string): Promise<ArtifactBundle>;
+export declare function writeCoreArtifacts(root: string, bundle: ArtifactBundle, options?: {
+    prune?: boolean;
+}): Promise<void>;
+export declare function cleanupIntermediateArtifacts(root: string): Promise<string[]>;
+export declare function promoteFinalAuditReport(params: {
+    artifactsDir: string;
+}, options?: {
+    copy?: typeof cp;
+    remove?: typeof rm;
+    warn?: (message: string) => void;
+}): Promise<{
+    promoted: boolean;
+    cleaned: boolean;
+    warning?: string;
+}>;
+export {};
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/audit/io/artifacts.d.ts.map

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

package/dist/audit/io/artifacts.js

@@ -0,0 +1,239 @@
+import { cp, rm, unlink } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { PROVIDER_CONFIRMATION_RESULT_VERSION } from "audit-tools/shared";
+import { loadDesignReviewSnapshots, } from "../orchestrator/designReviewSnapshot.js";
+import { AGENT_FEEDBACK_FILENAME, isFileMissingError, parseReflectionsNdjson, readOptionalJsonFile, readOptionalNdjsonFile, readOptionalTextFile, writeJsonFile, writeNdjsonFile, writeTextFile, } from "audit-tools/shared";
+import { buildToolingManifest } from "./toolingManifest.js";
+// ---------------------------------------------------------------------------
+// Schema-version guard (ARC-dd468422)
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when a versioned artifact is loaded from disk with a schema_version
+ * field that does not match the expected version constant.  The message names
+ * the artifact and both the expected and actual versions so the operator has
+ * an actionable diagnosis.
+ */
+export class ArtifactSchemaVersionError extends Error {
+    artifactName;
+    expected;
+    actual;
+    constructor(artifactName, expected, actual) {
+        super(`Artifact "${artifactName}" has schema_version "${actual}" but expected "${expected}". ` +
+            `This likely means the artifact was produced by an incompatible version of audit-code. ` +
+            `Delete ${artifactName} from the artifacts directory to regenerate it.`);
+        this.artifactName = artifactName;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = "ArtifactSchemaVersionError";
+    }
+}
+/**
+ * Verify the schema_version field of a loaded artifact against the expected
+ * value.  Throws {@link ArtifactSchemaVersionError} on mismatch; silently
+ * returns on `undefined` (artifact not yet produced).
+ */
+function assertArtifactSchemaVersion(artifact, artifactName, expected) {
+    if (artifact === undefined)
+        return;
+    const actual = artifact.schema_version;
+    if (typeof actual !== "string") {
+        throw new ArtifactSchemaVersionError(artifactName, expected, String(actual));
+    }
+    if (actual !== expected) {
+        throw new ArtifactSchemaVersionError(artifactName, expected, actual);
+    }
+}
+// Canonical filename for the rendered findings report. Single source of truth
+// for path construction. The dependency table below still lists it as plain
+// data alongside its sibling artifact-name literals.
+export const AUDIT_REPORT_FILENAME = "audit-report.md";
+function jsonArtifact(fileName, phase) {
+    return {
+        fileName,
+        phase,
+        read: (path) => readOptionalJsonFile(path),
+        write: (path, value) => writeJsonFile(path, value),
+    };
+}
+function ndjsonArtifact(fileName, phase) {
+    return {
+        fileName,
+        phase,
+        read: (path) => readOptionalNdjsonFile(path),
+        write: (path, value) => writeNdjsonFile(path, value),
+    };
+}
+function textArtifact(fileName, phase) {
+    return {
+        fileName,
+        phase,
+        read: (path) => readOptionalTextFile(path),
+        write: (path, value) => writeTextFile(path, value),
+    };
+}
+export const ARTIFACT_DEFINITIONS = {
+    provider_confirmation: jsonArtifact("provider_confirmation.json", "intake"),
+    repo_manifest: jsonArtifact("repo_manifest.json", "intake"),
+    file_disposition: jsonArtifact("file_disposition.json", "intake"),
+    auto_fixes_applied: jsonArtifact("auto_fixes_applied.json", "intake"),
+    intent_checkpoint: jsonArtifact("intent_checkpoint.json", "intake"),
+    unit_manifest: jsonArtifact("unit_manifest.json", "analysis"),
+    graph_bundle: jsonArtifact("graph_bundle.json", "analysis"),
+    surface_manifest: jsonArtifact("surface_manifest.json", "analysis"),
+    critical_flows: jsonArtifact("critical_flows.json", "analysis"),
+    flow_coverage: jsonArtifact("flow_coverage.json", "analysis"),
+    risk_register: jsonArtifact("risk_register.json", "analysis"),
+    design_assessment: jsonArtifact("design_assessment.json", "analysis"),
+    analyzer_capability: jsonArtifact("analyzer_capability.json", "analysis"),
+    scope: jsonArtifact("scope.json", "execution"),
+    coverage_matrix: jsonArtifact("coverage_matrix.json", "execution"),
+    runtime_validation_tasks: jsonArtifact("runtime_validation_tasks.json", "execution"),
+    runtime_validation_report: jsonArtifact("runtime_validation_report.json", "execution"),
+    external_analyzer_results: jsonArtifact("external_analyzer_results.json", "execution"),
+    syntax_resolution_status: jsonArtifact("syntax_resolution_status.json", "execution"),
+    audit_results: ndjsonArtifact("audit_results.jsonl", "execution"),
+    audit_tasks: jsonArtifact("audit_tasks.json", "execution"),
+    audit_plan_metrics: jsonArtifact("audit_plan_metrics.json", "execution"),
+    task_affinity_graph: jsonArtifact("task_affinity_graph.json", "execution"),
+    requeue_tasks: jsonArtifact("requeue_tasks.json", "execution"),
+    audit_report: textArtifact(AUDIT_REPORT_FILENAME, "reporting"),
+    audit_findings: jsonArtifact("audit-findings.json", "reporting"),
+    synthesis_narrative: jsonArtifact("synthesis-narrative.json", "reporting"),
+    audit_state: jsonArtifact("audit_state.json", "supervisor"),
+    artifact_metadata: jsonArtifact("artifact_metadata.json", "supervisor"),
+    tooling_manifest: jsonArtifact("tooling_manifest.json", "supervisor"),
+};
+const ARTIFACT_ENTRIES = Object.entries(ARTIFACT_DEFINITIONS);
+export const ARTIFACT_FILE_TO_BUNDLE_KEY = Object.fromEntries(ARTIFACT_ENTRIES.map(([key, definition]) => [definition.fileName, key]));
+export function getArtifactValue(bundle, artifactName) {
+    // Worker-appended feedback participates in the staleness DAG (its content
+    // hash re-stales audit-report.md) without being a writable registry entry.
+    if (artifactName === AGENT_FEEDBACK_FILENAME) {
+        return bundle.agent_reflections;
+    }
+    const key = ARTIFACT_FILE_TO_BUNDLE_KEY[artifactName];
+    return key ? bundle[key] : undefined;
+}
+export async function loadArtifactBundle(root) {
+    const bundle = {};
+    const bundleRecord = bundle;
+    for (const entry of ARTIFACT_ENTRIES) {
+        const [key, definition] = entry;
+        const value = await definition.read(join(root, definition.fileName));
+        if (value !== undefined) {
+            bundleRecord[key] = value;
+        }
+    }
+    bundle.tooling_manifest = await buildToolingManifest();
+    // active-dispatch.json is written by prepare-dispatch at the artifacts root
+    // (not a standard ARTIFACT_DEFINITIONS entry). Load it so the completion
+    // obligation can exclude budget-deferred tasks. Absent on a fresh run.
+    const activeDispatch = await readOptionalJsonFile(join(root, "active-dispatch.json"));
+    if (activeDispatch !== undefined) {
+        bundle.active_dispatch = activeDispatch;
+    }
+    // Design-review snapshots (B2 parity port): loaded specially like
+    // active-dispatch so deriveAuditState can key each pass's staleness on the
+    // semantic projection of the structural inputs it reviewed. Absent on a fresh
+    // run / before the first design review completes.
+    const designReviewSnapshots = await loadDesignReviewSnapshots(root);
+    if (Object.keys(designReviewSnapshots).length > 0) {
+        bundle.design_review_snapshots = designReviewSnapshots;
+    }
+    // Schema-version guards (ARC-dd468422): versioned artifacts must carry the
+    // exact expected schema_version or the load fails with a diagnosable error.
+    // Checked after the loop so the error message can name both values.
+    assertArtifactSchemaVersion(bundle.intent_checkpoint, "intent_checkpoint.json", "intent-checkpoint/v1");
+    assertArtifactSchemaVersion(bundle.provider_confirmation, "provider_confirmation.json", PROVIDER_CONFIRMATION_RESULT_VERSION);
+    // agent-feedback.jsonl is appended by workers (opt-in reflections), never
+    // written by the orchestrator. Parse leniently: malformed lines are skipped,
+    // a present-but-unusable file is just an empty list. Synthesis surfaces the
+    // parsed reflections as the report's "Process Feedback" section.
+    const feedbackText = await readOptionalTextFile(join(root, AGENT_FEEDBACK_FILENAME));
+    if (feedbackText !== undefined) {
+        bundle.agent_reflections = parseReflectionsNdjson(feedbackText);
+    }
+    return bundle;
+}
+export async function writeCoreArtifacts(root, bundle, options = {}) {
+    const bundleRecord = bundle;
+    for (const entry of ARTIFACT_ENTRIES) {
+        const [key, definition] = entry;
+        const value = bundleRecord[key];
+        const path = join(root, definition.fileName);
+        if (value !== undefined) {
+            await definition.write(path, value);
+        }
+        else if (options.prune) {
+            // The bundle is authoritative. An executor that clears an artifact to
+            // `undefined` (to force a downstream rebuild — e.g. planning/ingestion
+            // reset audit_report) intends the file gone; if it lingers it reloads as a
+            // stale "present" artifact with no metadata entry, which deriveAuditState
+            // reads as satisfied — masking the invalidation and stranding a stale
+            // report. Only callers passing the full accumulated bundle may prune.
+            try {
+                await unlink(path);
+            }
+            catch (error) {
+                if (!isFileMissingError(error))
+                    throw error;
+            }
+        }
+    }
+}
+export async function cleanupIntermediateArtifacts(root) {
+    const deleted = [];
+    for (const [, definition] of ARTIFACT_ENTRIES) {
+        const path = join(root, definition.fileName);
+        try {
+            await unlink(path);
+            deleted.push(definition.fileName);
+        }
+        catch (error) {
+            if (isFileMissingError(error)) {
+                continue;
+            }
+            throw error;
+        }
+    }
+    return deleted;
+}
+export async function promoteFinalAuditReport(params, options = {}) {
+    const outputDir = dirname(params.artifactsDir);
+    const source = join(params.artifactsDir, AUDIT_REPORT_FILENAME);
+    const destination = join(outputDir, AUDIT_REPORT_FILENAME);
+    const copy = options.copy ?? cp;
+    const remove = options.remove ?? rm;
+    const warn = options.warn ?? ((message) => process.stderr.write(`${message}\n`));
+    try {
+        await copy(source, destination, { force: true });
+    }
+    catch (error) {
+        const warning = `audit-code: completed audit but could not promote final report to ${destination}: ` +
+            (error instanceof Error ? error.message : String(error));
+        warn(warning);
+        return { promoted: false, cleaned: false, warning };
+    }
+    // Promote the canonical machine contract alongside the human report. Missing
+    // (e.g. legacy bundle) or unreadable: best-effort, never blocks completion.
+    try {
+        await copy(join(params.artifactsDir, "audit-findings.json"), join(outputDir, "audit-findings.json"), { force: true });
+    }
+    catch (error) {
+        // audit-findings.json is optional output; absence must not fail promotion.
+        // Log so operators can distinguish a partial promotion from a clean one.
+        warn(`audit-code: could not promote audit-findings.json to ${join(outputDir, "audit-findings.json")}: ` +
+            (error instanceof Error ? error.message : String(error)));
+    }
+    try {
+        await remove(params.artifactsDir, { recursive: true, force: true });
+        return { promoted: true, cleaned: true };
+    }
+    catch (error) {
+        const warning = `audit-code: promoted final report to ${destination}, but could not remove ${params.artifactsDir}: ` +
+            (error instanceof Error ? error.message : String(error));
+        warn(warning);
+        return { promoted: true, cleaned: false, warning };
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/audit/io/artifacts.js.map

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

package/dist/audit/io/runArtifactTypes.d.ts

@@ -0,0 +1,19 @@
+export interface RunPaths {
+    runDir: string;
+    taskPath: string;
+    promptPath: string;
+    resultPath: string;
+    stdoutPath: string;
+    stderrPath: string;
+    statusPath: string;
+}
+export interface DispatchBatchRun {
+    run_id: string;
+    task_path: string;
+    prompt_path: string;
+    result_path: string;
+    status_path: string;
+    audit_results_path?: string;
+    pending_audit_tasks_path?: string;
+}
+//# sourceMappingURL=runArtifactTypes.d.ts.map

package/dist/audit/io/runArtifactTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runArtifactTypes.d.ts","sourceRoot":"","sources":["../../../src/audit/io/runArtifactTypes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/dist/audit/io/runArtifactTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runArtifactTypes.js.map

package/dist/audit/io/runArtifactTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runArtifactTypes.js","sourceRoot":"","sources":["../../../src/audit/io/runArtifactTypes.ts"],"names":[],"mappings":""}

package/dist/audit/io/runArtifacts.d.ts

@@ -0,0 +1,33 @@
+import type { AuditTask } from "../types.js";
+import type { WorkerTask } from "../types/workerSession.js";
+import type { RunPaths, DispatchBatchRun } from "./runArtifactTypes.js";
+export type { RunPaths, DispatchBatchRun } from "./runArtifactTypes.js";
+/**
+ * Schema files copied into a dispatch run's `task-results/` directory so packet
+ * workers can optionally self-validate before submit. `audit_result.schema.json`
+ * `$ref`s the other two by relative filename, so all three must sit side-by-side
+ * for a validator to resolve them. Exported so merge-and-ingest can recognize
+ * them as legitimate (not stray) files in `task-results/`.
+ */
+export declare const PACKET_SCHEMA_FILENAMES: readonly ["audit_result.schema.json", "finding.schema.json", "audit_task.schema.json"];
+/**
+ * Copy {@link PACKET_SCHEMA_FILENAMES} into `targetDir` under their canonical
+ * filenames, making the AuditResult schema reachable from a dispatch run's
+ * `task-results/` directory.
+ */
+export declare function writePacketSchemaFiles(targetDir: string, pkgRoot: string): Promise<void>;
+export declare function buildRunId(obligationId: string | null, index: number, now?: Date): string;
+export declare function getRunPaths(artifactsDir: string, runId: string): RunPaths;
+export declare function ensureSupervisorDirs(artifactsDir: string): Promise<void>;
+export declare function writeWorkerTaskFiles(task: WorkerTask, prompt: string, paths: RunPaths, artifactsDir: string, currentTasks?: AuditTask[], options?: {
+    updateDispatch?: boolean;
+}, log?: {
+    event: (name: string, data: Record<string, unknown>) => void;
+}): Promise<void>;
+export declare function writeDispatchBatchFiles(artifactsDir: string, runs: DispatchBatchRun[], currentTasks: AuditTask[], log?: {
+    event: (name: string, data: Record<string, unknown>) => void;
+}): Promise<void>;
+export declare function clearDispatchFiles(artifactsDir: string, log?: {
+    event: (name: string, data: Record<string, unknown>) => void;
+}): Promise<void>;
+//# sourceMappingURL=runArtifacts.d.ts.map

package/dist/audit/io/runArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runArtifacts.d.ts","sourceRoot":"","sources":["../../../src/audit/io/runArtifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOxE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAUxE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,wFAI1B,CAAC;AAYX;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf;AAwCD,wBAAgB,UAAU,CACxB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,IAAiB,GACrB,MAAM,CAIR;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAWzE;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf;AAyED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,SAAS,EAAE,EAC1B,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,EAC1C,GAAG,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,gBAAgB,EAAE,EACxB,YAAY,EAAE,SAAS,EAAE,EACzB,GAAG,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CAuBf"}