@petepetrash/circuit 0.1.0

package/dist/flows/sweep/writers/partition.js

@@ -0,0 +1,130 @@
+// Sweep partition compose writer.
+//
+// The loop head. Each wave it re-scans the tree, so it sees only the findings
+// the previous waves' workers have NOT yet cleared — the survivor set narrows
+// itself with no bookkeeping. It groups the survivors into file-disjoint units
+// (one worker per file), so the fanout can run them concurrently without two
+// workers racing the same file. When a carried lesson from an earlier judge is
+// present, it is folded into every unit's fix prompt — the compounding path,
+// since a compose head has no relay prompt for the engine to re-inline notes
+// into, so the writer reads the notes file itself.
+//
+// A re-scan that finds nothing is a contract violation, not a clean stop: the
+// loop must already have completed at the judge on a green rescan, so an empty
+// backlog here means the judge misjudged. The writer throws rather than emit a
+// zero-unit partition (which the fanout would reject anyway), turning a would-be
+// crash into a legible failure.
+import { existsSync, readFileSync } from 'node:fs';
+import { resolveRunRelative } from '../../../shared/run-relative-path.js';
+import { SWEEP_CARRIED_NOTES_PATH } from '../paths.js';
+import { SweepPartition } from '../reports.js';
+import { runScannerFindings } from './scan.js';
+// Turn a file path into a fanout-safe branch id fragment. Unit ids become
+// fanout branch ids, which the step schema validates as strict kebab-case slugs
+// (`/^[a-z0-9][a-z0-9-]*$/`) AND which appear in directory names — so this folds
+// EVERYTHING outside [a-z0-9] to a single dash, lowercases, and trims. A path
+// like `src/Alpha.ts` becomes `src-alpha-ts`; the dot or underscore a looser
+// sanitizer would keep is exactly what the branch-id regex rejects, which would
+// abort the fanout the first wave.
+function sanitizeForBranchId(value) {
+    const cleaned = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return cleaned.length === 0 ? 'unit' : cleaned;
+}
+// The most recent judge lesson, if the carried-notes file exists and holds one.
+// Absent on wave 0 (no notes yet) and whenever the lesson is "none" (the judge's
+// signal that there is nothing to carry). Never throws — notes are an aid.
+function latestLesson(runFolder) {
+    const notesPath = resolveRunRelative(runFolder, SWEEP_CARRIED_NOTES_PATH);
+    if (!existsSync(notesPath))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(notesPath, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (!Array.isArray(parsed))
+        return undefined;
+    for (let index = parsed.length - 1; index >= 0; index -= 1) {
+        const lesson = parsed[index]?.lesson?.trim();
+        if (lesson !== undefined && lesson.length > 0 && lesson.toLowerCase() !== 'none') {
+            return lesson;
+        }
+    }
+    return undefined;
+}
+function fixPrompt(file, findings, lesson) {
+    const rules = [...new Set(findings.map((finding) => finding.rule))].join(', ');
+    const lines = findings.map((finding) => `- ${finding.rule}: ${finding.message}`);
+    const base = [
+        `Fix every finding in ${file}. Change only this file.`,
+        `Rules to clear: ${rules}.`,
+        'Findings:',
+        ...lines,
+        'Fix the underlying cause. Do not add suppression directives and do not edit the project config to hide the finding — both are audited and will keep the run red.',
+    ];
+    if (lesson !== undefined) {
+        base.push(`Lesson carried from an earlier attempt: ${lesson}`);
+    }
+    return base.join('\n');
+}
+function partitionByFile(findings, lesson) {
+    const byFile = new Map();
+    for (const finding of findings) {
+        if (finding.file === null) {
+            throw new Error(`sweep partition: finding '${finding.finding_id}' has no file; project-level findings are not yet partitionable (every finding must be file-scoped)`);
+        }
+        const group = byFile.get(finding.file);
+        if (group === undefined)
+            byFile.set(finding.file, [finding]);
+        else
+            group.push(finding);
+    }
+    const usedIds = new Set();
+    const units = [];
+    // Named unitIndex, not after the Latin word for position-in-a-sequence: the
+    // design-system CSS build scans this tree (theme.css `@source
+    // '../../../flows'`), and Tailwind's text extractor reads any bare token that
+    // matches a utility class name as a used class. That word is the
+    // font-variant-numeric utility, so a variable named it would bloat the
+    // committed stylesheet with numeric-variant custom properties. Keep
+    // flow-writer identifiers (and this comment) off the Tailwind utility names.
+    let unitIndex = 0;
+    for (const [file, group] of byFile) {
+        unitIndex += 1;
+        let unitId = `unit-${unitIndex}-${sanitizeForBranchId(file)}`;
+        while (usedIds.has(unitId))
+            unitId = `${unitId}-x`;
+        usedIds.add(unitId);
+        units.push({
+            unit_id: unitId,
+            files: [file],
+            finding_ids: group.map((finding) => finding.finding_id),
+            // One file per unit, so a unit's fix never touches another unit's file:
+            // the isolation that makes the wave safe to fan out concurrently.
+            independence: 'isolated',
+            fix_prompt: fixPrompt(file, group, lesson),
+        });
+    }
+    return units;
+}
+export const sweepPartitionComposeBuilder = {
+    resultSchemaName: 'sweep.partition@v1',
+    build(context) {
+        const projectRoot = context.projectRoot;
+        if (projectRoot === undefined) {
+            throw new Error('sweep partition requires projectRoot to re-scan the tree; none was provided by the invocation');
+        }
+        const findings = runScannerFindings(projectRoot);
+        if (findings.length === 0) {
+            throw new Error('sweep partition: re-scan found no findings, so there is nothing to fan out. The loop should have completed at the judge on a green rescan; reaching partition with an empty backlog means the judge advanced when it should have stopped.');
+        }
+        const units = partitionByFile(findings, latestLesson(context.runFolder));
+        return SweepPartition.parse({ units, covers_all_findings: true });
+    },
+};
+//# sourceMappingURL=partition.js.map

package/dist/flows/sweep/writers/partition.js.map

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

package/dist/flows/sweep/writers/scan.d.ts

@@ -0,0 +1,5 @@
+import { SweepFinding } from '../reports.js';
+export declare function parseScannerFindings(stdout: string): SweepFinding[];
+export declare function runScannerFindings(projectRoot: string): SweepFinding[];
+export declare function runSuppressionBaseline(projectRoot: string): number;
+//# sourceMappingURL=scan.d.ts.map

package/dist/flows/sweep/writers/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../../src/flows/sweep/writers/scan.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAmC7C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAyBnE;AAID,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAEtE;AAOD,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOlE"}

package/dist/flows/sweep/writers/scan.js

@@ -0,0 +1,89 @@
+// Shared scanner probe for Sweep's compose writers.
+//
+// The census and the per-wave partition both need the CURRENT structured
+// finding list, so they spawn the project's `scan` script and parse its JSON
+// stdout. This is deliberately NOT the oracle: the honesty floor is the pinned
+// run-verification rescan (engine change 2), which reads the scanner's EXIT
+// CODE. The scanner is dual-channel — it prints `{ "findings": [...] }` to
+// stdout for the work-list here and exits non-zero while findings remain for the
+// floor there. A worker that tampers with the `scan` script body to hide
+// findings from THIS probe cannot launder a green close: the pinned rescan
+// re-runs the same script and its fingerprint drift or its still-red exit is
+// what the floor reads. The probe only affects which units a wave attempts, not
+// whether the run may complete.
+import { spawnSync } from 'node:child_process';
+import { SweepFinding } from '../reports.js';
+const MAX_SCAN_BUFFER_BYTES = 16 * 1024 * 1024;
+const SCAN_TIMEOUT_MS = 120_000;
+function outputToString(output) {
+    if (output === null || output === undefined)
+        return '';
+    return typeof output === 'string' ? output : Buffer.from(output).toString('utf8');
+}
+// Run `npm --silent run <script>` in the project and return its stdout. `npm
+// --silent` suppresses npm's own chatter so the script's stdout is the whole
+// payload. A non-zero exit is EXPECTED for the scanner (findings remain) and is
+// not an error here; only a spawn failure (npm missing, timeout) throws.
+function runSilentScript(projectRoot, script) {
+    const result = spawnSync('npm', ['--silent', 'run', script], {
+        cwd: projectRoot,
+        encoding: 'utf8',
+        maxBuffer: MAX_SCAN_BUFFER_BYTES,
+        timeout: SCAN_TIMEOUT_MS,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (result.error !== undefined) {
+        throw new Error(`sweep scan: 'npm run ${script}' could not be spawned: ${result.error.message}`);
+    }
+    return outputToString(result.stdout);
+}
+// Locate and parse the `{ "findings": [...] }` object in the scanner's stdout.
+// Tolerant of a leading/trailing blank line, but not of arbitrary prose: the
+// fixture script emits a single JSON object, and a malformed payload is a real
+// error worth surfacing rather than silently treating as zero findings (which
+// would let a broken scanner masquerade as a clean tree).
+export function parseScannerFindings(stdout) {
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0) {
+        throw new Error('sweep scan: scanner produced no output to parse for findings');
+    }
+    const firstBrace = trimmed.indexOf('{');
+    const lastBrace = trimmed.lastIndexOf('}');
+    if (firstBrace === -1 || lastBrace === -1 || lastBrace < firstBrace) {
+        throw new Error('sweep scan: scanner output did not contain a JSON findings object');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed.slice(firstBrace, lastBrace + 1));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`sweep scan: scanner findings JSON was unparseable: ${message}`);
+    }
+    const rawFindings = parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+        ? parsed.findings
+        : undefined;
+    if (!Array.isArray(rawFindings)) {
+        throw new Error("sweep scan: scanner output missing a 'findings' array");
+    }
+    return rawFindings.map((finding) => SweepFinding.parse(finding));
+}
+// The structured finding list from a fresh scanner run. Used by the census
+// (baseline) and by every wave's partition (survivors).
+export function runScannerFindings(projectRoot) {
+    return parseScannerFindings(runSilentScript(projectRoot, 'scan'));
+}
+// The suppression baseline: the count of suppression directives already in the
+// tree, printed by the `audit` script. The pinned rescan reads the audit's EXIT
+// code (non-zero once any suppression exists); the census reads this count so
+// the operator sees the starting point. On the fixture the tree is clean, so the
+// baseline is zero. A non-integer payload throws rather than defaulting.
+export function runSuppressionBaseline(projectRoot) {
+    const stdout = runSilentScript(projectRoot, 'audit').trim();
+    const match = stdout.match(/-?\d+/);
+    if (match === null) {
+        throw new Error('sweep census: audit script did not print a suppression count');
+    }
+    return Math.max(0, Number.parseInt(match[0], 10));
+}
+//# sourceMappingURL=scan.js.map

package/dist/flows/sweep/writers/scan.js.map

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

package/dist/flows/sweep/writers/verification.d.ts

@@ -0,0 +1,3 @@
+import type { VerificationBuilder } from '../../registries/verification-writers/types.js';
+export declare const sweepRescanVerificationWriter: VerificationBuilder;
+//# sourceMappingURL=verification.d.ts.map

package/dist/flows/sweep/writers/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../../src/flows/sweep/writers/verification.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,gDAAgD,CAAC;AAGxD,eAAO,MAAM,6BAA6B,EAAE,mBAoC3C,CAAC"}

package/dist/flows/sweep/writers/verification.js

@@ -0,0 +1,55 @@
+// Sweep rescan verification writer.
+//
+// The honesty floor. Each wave it re-runs the two oracle commands the census
+// pinned — the scanner and the suppression audit — and reports their combined
+// result. overall_status is `passed` only when BOTH exit clean: the scanner
+// finds zero findings AND the audit finds no added suppressions. That status is
+// what the until-loop evidence floor reads, so a judge cannot stop the loop
+// clean while findings remain or while a worker has silenced one.
+//
+// The command list comes from sweep.census@v1, which the engine's oracle-command
+// pin (engine change 2) snapshots the first time this step resolves. On every
+// later wave the pin serves that same snapshot and refuses to run if either
+// pinned package-script body drifted — so a worker cannot narrow the scanner in
+// a plan or swap `scripts.scan`'s package.json body to a no-op. Two vectors stay
+// open in the baseline (spec 6.6 / 9.1): rewriting the scanner PROGRAM the script
+// launches, and narrowing the scan SCOPE inside that program (set-identity, spec
+// 6.4, is designed but not enforced).
+import { readFileSync } from 'node:fs';
+import { resolveRunRelative } from '../../../shared/run-relative-path.js';
+import { reportPathForSchemaInRuntimeFlow } from '../../registries/runtime-index.js';
+import { SweepCensus, SweepVerification } from '../reports.js';
+export const sweepRescanVerificationWriter = {
+    resultSchemaName: 'sweep.verification@v1',
+    // The scanner and suppression audit both come from the census. Declared so a
+    // composer wires the read and the offline floor resolves it; loadCommands
+    // below is the enforcing source of truth.
+    reads: [{ name: 'census', schema: 'sweep.census@v1', required: true }],
+    loadCommands(context) {
+        const censusPath = reportPathForSchemaInRuntimeFlow(context.flow, 'sweep.census@v1');
+        if (!context.step.reads.includes(censusPath)) {
+            throw new Error(`sweep.verification@v1 requires step '${context.step.id}' to read ${censusPath}`);
+        }
+        const census = SweepCensus.parse(JSON.parse(readFileSync(resolveRunRelative(context.runFolder, censusPath), 'utf8')));
+        return [census.scanner, census.suppression_audit];
+    },
+    buildResult(observations) {
+        const overallStatus = observations.some((observation) => observation.status === 'failed')
+            ? 'failed'
+            : 'passed';
+        return SweepVerification.parse({
+            overall_status: overallStatus,
+            commands: observations.map((observation) => ({
+                command_id: observation.command.id,
+                argv: observation.command.argv,
+                cwd: observation.command.cwd,
+                exit_code: observation.exit_code,
+                status: observation.status,
+                duration_ms: observation.duration_ms,
+                stdout_summary: observation.stdout_summary,
+                stderr_summary: observation.stderr_summary,
+            })),
+        });
+    },
+};
+//# sourceMappingURL=verification.js.map

package/dist/flows/sweep/writers/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../../../src/flows/sweep/writers/verification.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,gFAAgF;AAChF,4EAA4E;AAC5E,kEAAkE;AAClE,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,iFAAiF;AACjF,sCAAsC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAOrF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,gBAAgB,EAAE,uBAAuB;IACzC,6EAA6E;IAC7E,0EAA0E;IAC1E,0CAA0C;IAC1C,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtE,YAAY,CAAC,OAAiC;QAC5C,MAAM,UAAU,GAAG,gCAAgC,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACrF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAmB,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CACb,wCAAwC,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,UAAU,EAAE,CACjF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAC9B,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CACpF,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACpD,CAAC;IACD,WAAW,CAAC,YAAuD;QACjE,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC;YACvF,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC;QACb,OAAO,iBAAiB,CAAC,KAAK,CAAC;YAC7B,cAAc,EAAE,aAAa;YAC7B,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC3C,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE;gBAClC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI;gBAC9B,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG;gBAC5B,SAAS,EAAE,WAAW,CAAC,SAAS;gBAChC,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,WAAW,EAAE,WAAW,CAAC,WAAW;gBACpC,cAAc,EAAE,WAAW,CAAC,cAAc;gBAC1C,cAAc,EAAE,WAAW,CAAC,cAAc;aAC3C,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/flows/types.d.ts

@@ -0,0 +1,111 @@
+import type { z } from 'zod';
+import type { ReportFileSurfaceDeclaration } from '../schemas/report-file-surface.js';
+import type { CheckpointBriefBuilder } from './registries/checkpoint-writers/types.js';
+import type { CloseBuilder } from './registries/close-writers/types.js';
+import type { ComposeBuilder } from './registries/compose-writers/types.js';
+import type { CrossReportValidator } from './registries/cross-report-validators.js';
+import type { StructuralShapeHint } from './registries/shape-hints/types.js';
+import type { VerificationBuilder } from './registries/verification-writers/types.js';
+export interface CompiledFlowRelayReport {
+    readonly schemaName: string;
+    readonly schema: z.ZodTypeAny;
+    readonly relayHint?: string;
+    readonly crossReportValidate?: CrossReportValidator;
+}
+export interface CompiledFlowReportSchema {
+    readonly schemaName: string;
+    readonly schema: z.ZodTypeAny;
+}
+export interface CompiledFlowPaths {
+    readonly schematic: string;
+    readonly command?: string;
+    readonly contract?: string;
+}
+export type CompiledFlowVisibility = 'public' | 'internal';
+export interface SliceLoopEngineFlag {
+    readonly headStep: string;
+    readonly tailStep: string;
+    readonly advanceRoute: string;
+    readonly slicesFrom: {
+        readonly report: string;
+        readonly itemsPath: string;
+    };
+    readonly maxSlices: number;
+    readonly activateWhenDepthAtLeast: 'high';
+}
+export interface UntilLoopEngineFlag {
+    readonly headStep: string;
+    readonly tailStep: string;
+    readonly bodySteps: readonly string[];
+    readonly reenterRoute: string;
+    readonly maxIterations: number;
+    readonly stopJudge?: {
+        readonly report: string;
+        readonly goalMetPath: string;
+        readonly lessonPath?: string;
+        readonly progressPath?: string;
+    };
+    readonly needsAttentionRoute?: string;
+    readonly carriedNotes?: {
+        readonly report: string;
+        readonly maxEntries?: number;
+    };
+    readonly cumulativeUsdCap?: number;
+    readonly cumulativeTokenCap?: number;
+    readonly noProgressCeiling?: number;
+    readonly iterationCommitContainment?: {
+        readonly branchPrefix: string;
+    };
+    readonly frozenPaths?: readonly string[];
+    readonly activateWhenDepthAtLeast: 'autonomous';
+}
+export interface CompiledFlowEngineFlags {
+    readonly bindsExecutionDepthToRelaySelection?: boolean;
+    readonly bindsTerminalOutcomeToPrimaryResult?: boolean;
+    readonly iteratesSliceLoop?: SliceLoopEngineFlag;
+    readonly iteratesUntilCondition?: UntilLoopEngineFlag;
+}
+export interface CompiledFlowAxisConfigRequirement {
+    readonly axis: 'tournament' | 'autonomous';
+    readonly path: string;
+    readonly message: string;
+}
+export interface CompiledFlowPrimaryResult {
+    readonly schemaName: string;
+    readonly path: string;
+    readonly label: string;
+}
+export interface CompiledFlowProgressStep {
+    readonly stepId: string;
+    readonly taskTitle: string;
+    readonly activeText: string;
+    readonly relayRole?: 'researcher' | 'implementer' | 'reviewer';
+    readonly relayStartedText?: string;
+    readonly relayCompletedText?: string;
+}
+export interface CompiledFlowProgressSurface {
+    readonly steps: readonly CompiledFlowProgressStep[];
+}
+export interface CompiledFlowRuntimeSurface {
+    readonly primaryResult?: CompiledFlowPrimaryResult;
+    readonly progress?: CompiledFlowProgressSurface;
+}
+export interface CompiledFlowPackage {
+    readonly id: string;
+    readonly visibility: CompiledFlowVisibility;
+    readonly paths: CompiledFlowPaths;
+    readonly relayReports: readonly CompiledFlowRelayReport[];
+    readonly reportSchemas?: readonly CompiledFlowReportSchema[];
+    readonly reportFileSurfaces?: Readonly<Record<string, ReportFileSurfaceDeclaration>>;
+    readonly writers: {
+        readonly compose: readonly ComposeBuilder[];
+        readonly close: readonly CloseBuilder[];
+        readonly verification: readonly VerificationBuilder[];
+        readonly checkpoint: readonly CheckpointBriefBuilder[];
+    };
+    readonly structuralHints?: readonly StructuralShapeHint[];
+    readonly runtimeSurface?: CompiledFlowRuntimeSurface;
+    readonly engineFlags?: CompiledFlowEngineFlags;
+    readonly requiredConfig?: readonly CompiledFlowAxisConfigRequirement[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flows/types.d.ts.map

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

package/dist/flows/types.js

@@ -0,0 +1,14 @@
+// CompiledFlow package — the per-flow unit the engine consumes.
+//
+// Each flow lives in src/flows/<id>/ and exports a FlowDefinition that
+// compiles into a CompiledFlowPackage describing source files, relay
+// reports, writers, and structural shape hints. The engine (registries,
+// report-schemas, emit script) derives everything from the flowPackages
+// aggregation in src/flows/catalog.ts — it never imports a flow module
+// directly. Routing is model-only: the host or operator names the flow,
+// so flows carry no routing/classification metadata.
+//
+// The flow-authoring playbook lives in docs/flows/authoring-model.md.
+// No engine edits are needed for normal flow additions.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/flows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/flows/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,uEAAuE;AACvE,qEAAqE;AACrE,wEAAwE;AACxE,wEAAwE;AACxE,uEAAuE;AACvE,wEAAwE;AACxE,qDAAqD;AACrD,EAAE;AACF,sEAAsE;AACtE,wDAAwD"}

package/dist/history/run-corpus.d.ts

@@ -0,0 +1,16 @@
+import type { HistoryErrorCodeV1 } from '../schemas/index.js';
+export declare const DEFAULT_RUNS_BASE = ".circuit/runs";
+export declare class HistoryCommandError extends Error {
+    readonly code: HistoryErrorCodeV1;
+    readonly paths: {
+        readonly runsBase?: string;
+        readonly indexDir?: string;
+    };
+    constructor(code: HistoryErrorCodeV1, message: string, paths?: {
+        readonly runsBase?: string;
+        readonly indexDir?: string;
+    });
+}
+export declare function listCandidateRunFolders(runsBase: string): readonly string[];
+export declare function computeRunFolderNamesHash(runFolders: readonly string[]): string;
+//# sourceMappingURL=run-corpus.d.ts.map

package/dist/history/run-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-corpus.d.ts","sourceRoot":"","sources":["../../src/history/run-corpus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9D,eAAO,MAAM,iBAAiB,kBAAyB,CAAC;AAExD,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,IAAI,EAAE,kBAAkB;IAEjC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;gBAFjE,IAAI,EAAE,kBAAkB,EACjC,OAAO,EAAE,MAAM,EACN,KAAK,GAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;CAIlF;AAUD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAsC3E;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAO/E"}

package/dist/history/run-corpus.js

@@ -0,0 +1,55 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { sha256Hex } from '../shared/connector-relay.js';
+import { CONTROL_PLANE_RUNS_DIR } from '../shared/control-plane-paths.js';
+export const DEFAULT_RUNS_BASE = CONTROL_PLANE_RUNS_DIR;
+export class HistoryCommandError extends Error {
+    code;
+    paths;
+    constructor(code, message, paths = {}) {
+        super(message);
+        this.code = code;
+        this.paths = paths;
+    }
+}
+function isCandidateRunFolder(runFolder) {
+    return (existsSync(join(runFolder, 'manifest.snapshot.json')) ||
+        existsSync(join(runFolder, 'trace.ndjson')) ||
+        existsSync(join(runFolder, 'reports/result.json')));
+}
+export function listCandidateRunFolders(runsBase) {
+    if (!existsSync(runsBase)) {
+        throw new HistoryCommandError('runs_base_not_found', `runs base not found: ${runsBase}`, {
+            runsBase,
+        });
+    }
+    let stat;
+    try {
+        stat = statSync(runsBase);
+    }
+    catch (error) {
+        throw new HistoryCommandError('runs_base_unreadable', `runs base unreadable: ${error instanceof Error ? error.message : String(error)}`, { runsBase });
+    }
+    if (!stat.isDirectory()) {
+        throw new HistoryCommandError('runs_base_unreadable', `runs base is not a directory: ${runsBase}`, {
+            runsBase,
+        });
+    }
+    try {
+        return readdirSync(runsBase, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => join(runsBase, entry.name))
+            .filter(isCandidateRunFolder)
+            .sort((left, right) => basename(left).localeCompare(basename(right)));
+    }
+    catch (error) {
+        throw new HistoryCommandError('runs_base_unreadable', `runs base unreadable: ${error instanceof Error ? error.message : String(error)}`, { runsBase });
+    }
+}
+export function computeRunFolderNamesHash(runFolders) {
+    return sha256Hex(runFolders
+        .map((folder) => basename(folder))
+        .sort()
+        .join('\n'));
+}
+//# sourceMappingURL=run-corpus.js.map

package/dist/history/run-corpus.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schemas/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './schemas/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/memory/project-distill.d.ts

@@ -0,0 +1,18 @@
+import { type MemoryInputV0, type RunMemoryUpdateEvent } from '../schemas/index.js';
+export declare const DEFAULT_MIN_DISTINCT_RUNS = 2;
+export interface DistillProjectFactsOptions {
+    readonly repoRoot: string;
+    readonly runsBase?: string;
+    readonly flowId?: string;
+    readonly projectId: string;
+    readonly minDistinctRuns?: number;
+    readonly now?: () => Date;
+}
+export interface DistillProjectFactsResult {
+    readonly proposals: readonly MemoryInputV0[];
+    readonly events: readonly RunMemoryUpdateEvent[];
+}
+export declare function normalizeReasonHead(reason: string): string;
+export declare function reasonTail(reason: string): string;
+export declare function distillProjectFacts(options: DistillProjectFactsOptions): DistillProjectFactsResult;
+//# sourceMappingURL=project-distill.d.ts.map

package/dist/memory/project-distill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-distill.d.ts","sourceRoot":"","sources":["../../src/memory/project-distill.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAIlB,KAAK,oBAAoB,EAG1B,MAAM,qBAAqB,CAAC;AAwB7B,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,0BAA0B;IAEzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAG3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD;AAoBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG1D;AAMD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjD;AAoGD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAsH3B"}