@petepetrash/circuit 0.1.0

package/dist/flows/pursue/writers/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,0CAA0C,CAAC;AAK/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,CAAC,MAAM,6BAA6B,GAAmB;IAC3D,gBAAgB,EAAE,qBAAqB;IACvC,KAAK,CAAC,OAA4B;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,oBAAoB,GAAG,mCAAmC,CAAC;YAC/D,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;YAClF,IAAI;YACJ,cAAc,EAAE,CAAC,SAAS,CAAC;YAC3B,eAAe,EAAE,SAAS;YAC1B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;QAEH,OAAO,sBAAsB,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAChE,CAAC;CACF,CAAC"}

package/dist/flows/pursue/writers/graph.d.ts

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

package/dist/flows/pursue/writers/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AAiBnD,eAAO,MAAM,0BAA0B,EAAE,cAiExC,CAAC"}

package/dist/flows/pursue/writers/graph.js

@@ -0,0 +1,76 @@
+import { PursuitContract, PursuitGraph } from '../reports.js';
+function setsOverlap(left, right) {
+    const rightSet = new Set(right);
+    return left.some((item) => rightSet.has(item));
+}
+function touchSetsOverlap(left, right) {
+    return (setsOverlap(left.paths, right.paths) ||
+        setsOverlap(left.symbols, right.symbols) ||
+        setsOverlap(left.commands, right.commands) ||
+        setsOverlap(left.generated_outputs, right.generated_outputs));
+}
+export const pursuitGraphComposeBuilder = {
+    resultSchemaName: 'pursuit.graph@v1',
+    reads: [{ name: 'contract', schema: 'pursuit.contract@v1', required: true }],
+    build(context) {
+        const contract = PursuitContract.parse(context.inputs.contract);
+        const nodes = contract.pursuits.map((pursuit) => ({
+            id: pursuit.id,
+            goal: pursuit.goal,
+            estimated_touch_set: pursuit.estimated_touch_set,
+            risk: pursuit.risk,
+            status: 'ready',
+            reason: pursuit.risk === 'high'
+                ? 'High-risk pursuit is ready, but code-changing work remains serialized.'
+                : 'Ready for coordinated execution.',
+        }));
+        const edges = [];
+        for (let i = 0; i < contract.pursuits.length; i += 1) {
+            const left = contract.pursuits[i];
+            if (left === undefined)
+                continue;
+            for (let j = i + 1; j < contract.pursuits.length; j += 1) {
+                const right = contract.pursuits[j];
+                if (right === undefined)
+                    continue;
+                if (touchSetsOverlap(left.estimated_touch_set, right.estimated_touch_set)) {
+                    edges.push({
+                        from: left.id,
+                        to: right.id,
+                        kind: 'conflict',
+                        reason: 'Estimated touch sets overlap, so V1 serializes these pursuits.',
+                    });
+                }
+                else {
+                    edges.push({
+                        from: left.id,
+                        to: right.id,
+                        kind: 'composes-with',
+                        reason: 'No estimated touch-set overlap was found; discovery may run in parallel, but code writes still serialize in V1.',
+                    });
+                }
+            }
+        }
+        return PursuitGraph.parse({
+            verdict: 'accept',
+            nodes,
+            edges,
+            serial_groups: [
+                {
+                    id: 'serial-code-writes',
+                    pursuit_ids: contract.pursuits.map((pursuit) => pursuit.id),
+                    reason: 'Pursuits V1 serializes all code-changing work until safe worktree apply exists.',
+                },
+            ],
+            parallel_read_only_groups: [
+                {
+                    id: 'parallel-discovery',
+                    pursuit_ids: contract.pursuits.map((pursuit) => pursuit.id),
+                    reason: 'Read-only discovery can happen in parallel because it does not mutate the worktree.',
+                },
+            ],
+            blocked: [],
+        });
+    },
+};
+//# sourceMappingURL=graph.js.map

package/dist/flows/pursue/writers/graph.js.map

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

package/dist/flows/pursue/writers/result-projection.d.ts

@@ -0,0 +1,11 @@
+import { PursuitResult } from '../reports.js';
+import type { PursuitBatch, PursuitContract, PursuitReview, PursuitVerification } from '../reports.js';
+export type PursuitResultProjectorInputs = {
+    readonly contract: PursuitContract;
+    readonly batch: PursuitBatch;
+    readonly verification: PursuitVerification;
+    readonly review: PursuitReview;
+    readonly evidenceLinks: PursuitResult['evidence_links'];
+};
+export declare function projectPursuitResult(inputs: PursuitResultProjectorInputs): PursuitResult;
+//# sourceMappingURL=result-projection.d.ts.map

package/dist/flows/pursue/writers/result-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-projection.d.ts","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/result-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACzD,CAAC;AAoDF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,4BAA4B,GAAG,aAAa,CAoCxF"}

package/dist/flows/pursue/writers/result-projection.js

@@ -0,0 +1,85 @@
+import { PursuitResult } from '../reports.js';
+function assertBatchCoversContract(contract, batch) {
+    const expected = new Set(contract.pursuits.map((pursuit) => pursuit.id));
+    const seen = new Set();
+    const issues = [];
+    for (const item of [...batch.completed, ...batch.skipped, ...batch.blocked, ...batch.failed]) {
+        if (!expected.has(item.pursuit_id)) {
+            issues.push(`unknown pursuit id '${item.pursuit_id}'`);
+            continue;
+        }
+        if (seen.has(item.pursuit_id)) {
+            issues.push(`duplicate pursuit id '${item.pursuit_id}'`);
+            continue;
+        }
+        seen.add(item.pursuit_id);
+    }
+    for (const id of expected) {
+        if (!seen.has(id))
+            issues.push(`missing pursuit id '${id}'`);
+    }
+    if (issues.length > 0) {
+        throw new Error(`pursuit.batch@v1 does not cover pursuit.contract@v1: ${issues.join('; ')}`);
+    }
+}
+// The review must attest every contracted pursuit exactly once. This is the
+// cross-report half of the F12 fix: the schema forces a non-empty, per-pursuit
+// attestation list, and this check ties those attestations to the real pursuit
+// set so a review cannot close by naming a subset (or none) of the work.
+function assertReviewCoversContract(contract, review) {
+    const expected = new Set(contract.pursuits.map((pursuit) => pursuit.id));
+    const seen = new Set();
+    const issues = [];
+    for (const attestation of review.reviewed_pursuits) {
+        if (!expected.has(attestation.pursuit_id)) {
+            issues.push(`unknown pursuit id '${attestation.pursuit_id}'`);
+            continue;
+        }
+        if (seen.has(attestation.pursuit_id)) {
+            issues.push(`duplicate pursuit id '${attestation.pursuit_id}'`);
+            continue;
+        }
+        seen.add(attestation.pursuit_id);
+    }
+    for (const id of expected) {
+        if (!seen.has(id))
+            issues.push(`missing pursuit id '${id}'`);
+    }
+    if (issues.length > 0) {
+        throw new Error(`pursuit.review@v1 does not attest pursuit.contract@v1: ${issues.join('; ')}`);
+    }
+}
+export function projectPursuitResult(inputs) {
+    assertBatchCoversContract(inputs.contract, inputs.batch);
+    assertReviewCoversContract(inputs.contract, inputs.review);
+    const completedCount = inputs.batch.completed.length;
+    const skippedCount = inputs.batch.skipped.length;
+    const blockedCount = inputs.batch.blocked.length;
+    const failedCount = inputs.batch.failed.length;
+    const verificationOk = inputs.verification.overall_status === 'passed';
+    const outcome = failedCount > 0 || !verificationOk
+        ? 'failed'
+        : blockedCount > 0 ||
+            inputs.batch.verdict === 'blocked' ||
+            inputs.review.verdict === 'blocked'
+            ? 'blocked'
+            : skippedCount > 0 ||
+                inputs.review.verdict === 'needs-followup' ||
+                inputs.batch.verdict === 'partial'
+                ? 'needs_attention'
+                : 'complete';
+    return PursuitResult.parse({
+        summary: `Pursuits result for ${inputs.contract.objective}: ${inputs.batch.summary}`,
+        outcome,
+        verification_status: inputs.verification.overall_status,
+        review_verdict: inputs.review.verdict,
+        total_pursuits: inputs.contract.pursuits.length,
+        completed_count: completedCount,
+        skipped_count: skippedCount,
+        blocked_count: blockedCount,
+        failed_count: failedCount,
+        serial_code_writes: true,
+        evidence_links: inputs.evidenceLinks,
+    });
+}
+//# sourceMappingURL=result-projection.js.map

package/dist/flows/pursue/writers/result-projection.js.map

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

package/dist/flows/pursue/writers/verification-projection.d.ts

@@ -0,0 +1,4 @@
+import type { VerificationCommandObservation } from '../../registries/verification-writers/types.js';
+import { PursuitVerification } from '../reports.js';
+export declare function projectPursuitVerification(observations: readonly VerificationCommandObservation[]): PursuitVerification;
+//# sourceMappingURL=verification-projection.d.ts.map

package/dist/flows/pursue/writers/verification-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-projection.d.ts","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/verification-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AACrG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,SAAS,8BAA8B,EAAE,GACtD,mBAAmB,CAkBrB"}

package/dist/flows/pursue/writers/verification-projection.js

@@ -0,0 +1,20 @@
+import { PursuitVerification } from '../reports.js';
+export function projectPursuitVerification(observations) {
+    const overallStatus = observations.some((observation) => observation.status === 'failed')
+        ? 'failed'
+        : 'passed';
+    return PursuitVerification.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-projection.js.map

package/dist/flows/pursue/writers/verification-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-projection.js","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/verification-projection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,UAAU,0BAA0B,CACxC,YAAuD;IAEvD,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC;QACvF,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC;IAEb,OAAO,mBAAmB,CAAC,KAAK,CAAC;QAC/B,cAAc,EAAE,aAAa;QAC7B,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC3C,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE;YAClC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI;YAC9B,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG;YAC5B,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,cAAc,EAAE,WAAW,CAAC,cAAc;SAC3C,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/verification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,gDAAgD,CAAC;AAIxD,eAAO,MAAM,yBAAyB,EAAE,mBAqBvC,CAAC"}

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

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import { resolveRunRelative } from '../../../shared/run-relative-path.js';
+import { reportPathForSchemaInRuntimeFlow } from '../../registries/runtime-index.js';
+import { PursuitContract } from '../reports.js';
+import { projectPursuitVerification } from './verification-projection.js';
+export const pursuitVerificationWriter = {
+    resultSchemaName: 'pursuit.verification@v1',
+    // Sources verification command candidates from the pursuit contract. Declared so
+    // a composer wires the read and the offline floor resolves it; loadCommands below
+    // is the enforcing source of truth.
+    reads: [{ name: 'contract', schema: 'pursuit.contract@v1', required: true }],
+    loadCommands(context) {
+        const contractPath = reportPathForSchemaInRuntimeFlow(context.flow, 'pursuit.contract@v1');
+        if (!context.step.reads.includes(contractPath)) {
+            throw new Error(`pursuit.verification@v1 requires step '${context.step.id}' to read ${contractPath}`);
+        }
+        const contract = PursuitContract.parse(JSON.parse(readFileSync(resolveRunRelative(context.runFolder, contractPath), 'utf8')));
+        return contract.verification_command_candidates;
+    },
+    buildResult(observations) {
+        return projectPursuitVerification(observations);
+    },
+};
+//# sourceMappingURL=verification.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/verification.ts"],"names":[],"mappings":"AAAA,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,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,MAAM,CAAC,MAAM,yBAAyB,GAAwB;IAC5D,gBAAgB,EAAE,yBAAyB;IAC3C,iFAAiF;IACjF,kFAAkF;IAClF,oCAAoC;IACpC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5E,YAAY,CAAC,OAAiC;QAC5C,MAAM,YAAY,GAAG,gCAAgC,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;QAC3F,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAqB,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,0CAA0C,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,YAAY,EAAE,CACrF,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CACpC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC,CACtF,CAAC;QACF,OAAO,QAAQ,CAAC,+BAA+B,CAAC;IAClD,CAAC;IACD,WAAW,CAAC,YAAuD;QACjE,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;CACF,CAAC"}

package/dist/flows/pursue/writers/wave-plan.d.ts

@@ -0,0 +1,3 @@
+import type { ComposeBuilder } from '../../registries/compose-writers/types.js';
+export declare const pursuitWavePlanComposeBuilder: ComposeBuilder;
+//# sourceMappingURL=wave-plan.d.ts.map

package/dist/flows/pursue/writers/wave-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wave-plan.d.ts","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/wave-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AAGnD,eAAO,MAAM,6BAA6B,EAAE,cAmC3C,CAAC"}

package/dist/flows/pursue/writers/wave-plan.js

@@ -0,0 +1,36 @@
+import { PursuitContract, PursuitGraph, PursuitWavePlan } from '../reports.js';
+export const pursuitWavePlanComposeBuilder = {
+    resultSchemaName: 'pursuit.wave-plan@v1',
+    reads: [
+        { name: 'contract', schema: 'pursuit.contract@v1', required: true },
+        { name: 'graph', schema: 'pursuit.graph@v1', required: true },
+    ],
+    build(context) {
+        const contract = PursuitContract.parse(context.inputs.contract);
+        const graph = PursuitGraph.parse(context.inputs.graph);
+        const allPursuitIds = contract.pursuits.map((pursuit) => pursuit.id);
+        return PursuitWavePlan.parse({
+            verdict: 'accept',
+            waves: [
+                {
+                    id: 'read-only-discovery',
+                    kind: 'read-only',
+                    pursuit_ids: graph.parallel_read_only_groups[0]?.pursuit_ids ?? allPursuitIds,
+                    execution: 'parallel',
+                    reason: 'Gather context for each pursuit before code-changing work begins.',
+                    re_ground_after: false,
+                },
+                ...graph.serial_groups.map((group, index) => ({
+                    id: index === 0 ? 'serial-code-writes' : `serial-code-writes-${index + 1}`,
+                    kind: 'code-change',
+                    pursuit_ids: group.pursuit_ids,
+                    execution: 'serial',
+                    reason: group.reason,
+                    re_ground_after: true,
+                })),
+            ],
+            no_parallel_writes_reason: 'Pursuits V1 does not apply parallel worktree edits. Code-changing work runs serially until safe apply and shared post-apply verification exist.',
+        });
+    },
+};
+//# sourceMappingURL=wave-plan.js.map

package/dist/flows/pursue/writers/wave-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wave-plan.js","sourceRoot":"","sources":["../../../../src/flows/pursue/writers/wave-plan.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/E,MAAM,CAAC,MAAM,6BAA6B,GAAmB;IAC3D,gBAAgB,EAAE,sBAAsB;IACxC,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC9D;IACD,KAAK,CAAC,OAA4B;QAChC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAErE,OAAO,eAAe,CAAC,KAAK,CAAC;YAC3B,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,qBAAqB;oBACzB,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,aAAa;oBAC7E,SAAS,EAAE,UAAU;oBACrB,MAAM,EAAE,mEAAmE;oBAC3E,eAAe,EAAE,KAAK;iBACvB;gBACD,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC5C,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB,KAAK,GAAG,CAAC,EAAE;oBAC1E,IAAI,EAAE,aAAsB;oBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,SAAS,EAAE,QAAiB;oBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,eAAe,EAAE,IAAI;iBACtB,CAAC,CAAC;aACJ;YACD,yBAAyB,EACvB,iJAAiJ;SACpJ,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/flows/registries/checkpoint-writers/registry.d.ts

@@ -0,0 +1,3 @@
+import type { CheckpointBriefBuilder } from './types.js';
+export declare function findCheckpointBriefBuilder(resultSchemaName: string): CheckpointBriefBuilder | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/flows/registries/checkpoint-writers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/checkpoint-writers/registry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,GACvB,sBAAsB,GAAG,SAAS,CAEpC"}

package/dist/flows/registries/checkpoint-writers/registry.js

@@ -0,0 +1,12 @@
+// Registry of checkpoint brief builders, keyed by output schema name.
+//
+// Builders come from src/flows/catalog.ts via buildCheckpointRegistry.
+// Most checkpoints don't write reports and skip this registry entirely;
+// the runner only invokes a builder when step.writes.report is defined.
+import { buildCheckpointRegistry } from '../../catalog-derivations.js';
+import { flowPackages } from '../../catalog.js';
+const REGISTRY = buildCheckpointRegistry(flowPackages);
+export function findCheckpointBriefBuilder(resultSchemaName) {
+    return REGISTRY.get(resultSchemaName);
+}
+//# sourceMappingURL=registry.js.map

package/dist/flows/registries/checkpoint-writers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/flows/registries/checkpoint-writers/registry.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AAExE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;AAEvD,MAAM,UAAU,0BAA0B,CACxC,gBAAwB;IAExB,OAAO,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC"}

package/dist/flows/registries/checkpoint-writers/types.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeIndexedCheckpointStep } from '../runtime-index.js';
+export type CheckpointStep = RuntimeIndexedCheckpointStep;
+export interface CheckpointBuildContext {
+    readonly runFolder: string;
+    readonly step: CheckpointStep;
+    readonly goal: string;
+    readonly projectRoot?: string;
+    readonly responsePath: string;
+}
+export interface CheckpointResumeContext {
+    readonly runFolder: string;
+    readonly step: CheckpointStep;
+    readonly reportPath: string;
+    readonly reportSha256?: string;
+}
+export interface CheckpointBriefBuilder {
+    readonly resultSchemaName: string;
+    build(context: CheckpointBuildContext): unknown;
+    validateResumeContext?(context: CheckpointResumeContext): unknown;
+}
+export declare function checkpointChoiceIds(step: CheckpointStep): string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/flows/registries/checkpoint-writers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/checkpoint-writers/types.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,4BAA4B,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAK9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAQD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IAGrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAIlC,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAWhD,qBAAqB,CAAC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC;CACnE;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAElE"}

package/dist/flows/registries/checkpoint-writers/types.js

@@ -0,0 +1,24 @@
+// Checkpoint writer registry types.
+//
+// A checkpoint step optionally writes a typed report alongside its
+// request/response files. Build's frame step is the canonical example:
+// the policy carries a generic `report_template` object, the Build writer
+// validates it and assembles a BuildBrief before operator selection.
+// Future flows would add their own policy templates + builders.
+//
+// To add a new flow's checkpoint-with-report:
+//   1. Add `policy.report_template` to the checkpoint step.
+//   2. Define a CheckpointBriefBuilder in the flow package
+//      (src/flows/<id>/writers/checkpoint-*.ts).
+//   3. Register it on the CompiledFlowPackage's `writers.checkpoint`.
+//
+// Most checkpoints don't write reports at all — those skip this
+// path entirely (the runner only invokes a builder when
+// step.writes.report is defined).
+// Helper used by checkpoint builders to read the choice ids the
+// runner accepts for this step. Lives here (not in registry.ts) so
+// builders can import it without a registry round-trip.
+export function checkpointChoiceIds(step) {
+    return step.policy.choices?.map((choice) => choice.id) ?? [];
+}
+//# sourceMappingURL=types.js.map

package/dist/flows/registries/checkpoint-writers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/flows/registries/checkpoint-writers/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,mEAAmE;AACnE,uEAAuE;AACvE,0EAA0E;AAC1E,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,8CAA8C;AAC9C,4DAA4D;AAC5D,2DAA2D;AAC3D,iDAAiD;AACjD,sEAAsE;AACtE,EAAE;AACF,gEAAgE;AAChE,wDAAwD;AACxD,kCAAkC;AAoDlC,gEAAgE;AAChE,mEAAmE;AACnE,wDAAwD;AACxD,MAAM,UAAU,mBAAmB,CAAC,IAAoB;IACtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC"}

package/dist/flows/registries/close-writers/generic-close-builder.d.ts

@@ -0,0 +1,3 @@
+import type { CloseBuilder } from './types.js';
+export declare const GENERIC_CLOSE_BUILDER: CloseBuilder;
+//# sourceMappingURL=generic-close-builder.d.ts.map

package/dist/flows/registries/close-writers/generic-close-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-close-builder.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/close-writers/generic-close-builder.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,qBAAqB,EAAE,YA0BnC,CAAC"}

package/dist/flows/registries/close-writers/generic-close-builder.js

@@ -0,0 +1,45 @@
+// Engine-built-in generic close builder, keyed by the generic flow.result@v1
+// contract.
+//
+// Default-OFF for the eight shipped flows: each of them aliases flow.result@v1 to
+// its own family result (fix.result@v1, build.result@v1, …) in its
+// contract_aliases, so a shipped flow's close resolves to its FAMILY builder and
+// never reaches this one. This builder is only ever hit by a COMPOSED flow whose
+// terminal close the composer left at the generic flow.result@v1 — which it does
+// exactly when the family close builder's REQUIRED reads are not all producible by
+// the composed topology (a triage that closes after diagnose can never satisfy
+// fix.result@v1's change/verification/regression reads). Binding the family result
+// there would abort the run at close time (resolveCloseReadPaths throws on the
+// first unproduced required read); falling back to this generic lets the flow run
+// to @complete and report the evidence it DID produce.
+//
+// It is reads-agnostic: it declares no required reads, so the compose executor
+// passes it an empty inputs map and the required-read resolver enforces nothing.
+// It folds whatever the terminal close already reads — the composer's
+// evidence-soak set — into evidence_links straight off the runtime-indexed step.
+import { FLOW_RESULT_CONTRACT } from '../../../schemas/builtin-report-schemas.js';
+export const GENERIC_CLOSE_BUILDER = {
+    resultSchemaName: FLOW_RESULT_CONTRACT,
+    reads: [],
+    build(context) {
+        const evidenceLinks = [...context.closeStep.reads];
+        const linkCount = evidenceLinks.length;
+        return {
+            schema_version: 1,
+            summary: linkCount === 0
+                ? `Composed flow '${context.flow.id}' closed with no upstream evidence.`
+                : `Composed flow '${context.flow.id}' closed with ${linkCount} evidence link${linkCount === 1 ? '' : 's'}.`,
+            // INFORMATIONAL ONLY. The run's honest outcome is derived from the terminal
+            // ROUTE (@complete/@stop/@handoff), not from this body — a composed flow
+            // never sets engineFlags.bindsTerminalOutcomeToPrimaryResult, so run-close
+            // never reads this field to decide the run outcome. This builder only sits on
+            // the @complete close compose step, so 'complete' is faithful here. Do NOT
+            // make this the outcome bind source (set that flag on a composed flow)
+            // without re-deriving the value from real upstream state — hardcoded
+            // 'complete' would then mask a degraded run.
+            outcome: 'complete',
+            evidence_links: evidenceLinks,
+        };
+    },
+};
+//# sourceMappingURL=generic-close-builder.js.map

package/dist/flows/registries/close-writers/generic-close-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-close-builder.js","sourceRoot":"","sources":["../../../../src/flows/registries/close-writers/generic-close-builder.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,YAAY;AACZ,EAAE;AACF,kFAAkF;AAClF,mEAAmE;AACnE,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,mFAAmF;AACnF,+EAA+E;AAC/E,mFAAmF;AACnF,+EAA+E;AAC/E,kFAAkF;AAClF,uDAAuD;AACvD,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,sEAAsE;AACtE,iFAAiF;AAEjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAGlF,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,gBAAgB,EAAE,oBAAoB;IACtC,KAAK,EAAE,EAAE;IACT,KAAK,CAAC,OAAO;QACX,MAAM,aAAa,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC;QACvC,OAAO;YACL,cAAc,EAAE,CAAC;YACjB,OAAO,EACL,SAAS,KAAK,CAAC;gBACb,CAAC,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,EAAE,qCAAqC;gBACxE,CAAC,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,EAAE,iBAAiB,SAAS,iBACzD,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACzB,GAAG;YACT,4EAA4E;YAC5E,yEAAyE;YACzE,2EAA2E;YAC3E,8EAA8E;YAC9E,2EAA2E;YAC3E,uEAAuE;YACvE,qEAAqE;YACrE,6CAA6C;YAC7C,OAAO,EAAE,UAAU;YACnB,cAAc,EAAE,aAAa;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/flows/registries/close-writers/registry.d.ts

@@ -0,0 +1,5 @@
+import { type RuntimeIndexedFlow } from '../runtime-index.js';
+import type { CloseBuildContext, CloseBuilder } from './types.js';
+export declare function findCloseBuilder(resultSchemaName: string): CloseBuilder | undefined;
+export declare function resolveCloseReadPaths(builder: CloseBuilder, flow: RuntimeIndexedFlow, closeStep: CloseBuildContext['closeStep']): Record<string, string | undefined>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/flows/registries/close-writers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/close-writers/registry.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAclE,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEnF;AASD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAqBpC"}

package/dist/flows/registries/close-writers/registry.js

@@ -0,0 +1,48 @@
+// Registry of close-with-evidence builders, keyed by result schema name.
+//
+// Builders come from src/flows/catalog.ts via buildCloseRegistry.
+import { buildCloseRegistry } from '../../catalog-derivations.js';
+import { flowPackages } from '../../catalog.js';
+import { flowHasReportSchemaInRuntimeFlow, reportPathForSchemaInRuntimeFlow, } from '../runtime-index.js';
+import { GENERIC_CLOSE_BUILDER } from './generic-close-builder.js';
+// The flow-derived close builders, plus the engine-built-in generic close
+// builder keyed by the generic flow.result@v1 contract. No flow registers a
+// builder under that key (each aliases the generic to its family result), so the
+// merge cannot collide — assert it rather than trust it.
+const REGISTRY = new Map(buildCloseRegistry(flowPackages));
+if (REGISTRY.has(GENERIC_CLOSE_BUILDER.resultSchemaName)) {
+    throw new Error(`generic close builder collides with a flow-registered close builder for schema '${GENERIC_CLOSE_BUILDER.resultSchemaName}'`);
+}
+REGISTRY.set(GENERIC_CLOSE_BUILDER.resultSchemaName, GENERIC_CLOSE_BUILDER);
+export function findCloseBuilder(resultSchemaName) {
+    return REGISTRY.get(resultSchemaName);
+}
+// Resolve the read paths for a builder against a specific runtime flow index +
+// close step. Required reads must be in the close step's reads list;
+// optional reads are returned only when both the flow declares a
+// step that writes the schema AND the close step lists the path.
+// Required-but-missing throws with a clear "<schema> requires close
+// step '<id>' to read <path>" message that matches the runner's
+// existing requiredCloseReadForSchema phrasing.
+export function resolveCloseReadPaths(builder, flow, closeStep) {
+    const paths = {};
+    for (const descriptor of builder.reads) {
+        if (descriptor.required) {
+            const path = reportPathForSchemaInRuntimeFlow(flow, descriptor.schema);
+            if (!closeStep.reads.includes(path)) {
+                throw new Error(`${closeStep.writes.report.schema} requires close step '${closeStep.id}' to read ${path}`);
+            }
+            paths[descriptor.name] = path;
+        }
+        else {
+            if (!flowHasReportSchemaInRuntimeFlow(flow, descriptor.schema)) {
+                paths[descriptor.name] = undefined;
+                continue;
+            }
+            const path = reportPathForSchemaInRuntimeFlow(flow, descriptor.schema);
+            paths[descriptor.name] = closeStep.reads.includes(path) ? path : undefined;
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=registry.js.map

package/dist/flows/registries/close-writers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/flows/registries/close-writers/registry.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,kEAAkE;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAEL,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,0EAA0E;AAC1E,4EAA4E;AAC5E,iFAAiF;AACjF,yDAAyD;AACzD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;AAC3D,IAAI,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,CAAC;IACzD,MAAM,IAAI,KAAK,CACb,mFAAmF,qBAAqB,CAAC,gBAAgB,GAAG,CAC7H,CAAC;AACJ,CAAC;AACD,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;AAE5E,MAAM,UAAU,gBAAgB,CAAC,gBAAwB;IACvD,OAAO,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,qEAAqE;AACrE,iEAAiE;AACjE,iEAAiE;AACjE,oEAAoE;AACpE,gEAAgE;AAChE,gDAAgD;AAChD,MAAM,UAAU,qBAAqB,CACnC,OAAqB,EACrB,IAAwB,EACxB,SAAyC;IAEzC,MAAM,KAAK,GAAuC,EAAE,CAAC;IACrD,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,gCAAgC,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YACvE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAa,CAAC,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,yBAAyB,SAAS,CAAC,EAAE,aAAa,IAAI,EAAE,CAC1F,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gCAAgC,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/D,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;gBACnC,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,gCAAgC,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YACvE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/flows/registries/close-writers/types.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeIndexedComposeStep, RuntimeIndexedFlow } from '../runtime-index.js';
+export interface CloseReadDescriptor {
+    readonly name: string;
+    readonly schema: string;
+    readonly required: boolean;
+}
+export interface CloseBuildContext {
+    readonly runFolder: string;
+    readonly flow: RuntimeIndexedFlow;
+    readonly closeStep: RuntimeIndexedComposeStep;
+    readonly goal: string;
+    readonly inputs: Record<string, unknown | undefined>;
+}
+export interface CloseBuilder {
+    readonly resultSchemaName: string;
+    readonly reads: readonly CloseReadDescriptor[];
+    build(context: CloseBuildContext): unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flows/registries/close-writers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/close-writers/types.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAOzF,MAAM,WAAW,mBAAmB;IAIlC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAKxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;CACtD;AAMD,MAAM,WAAW,YAAY;IAG3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAI/C,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC5C"}

package/dist/flows/registries/close-writers/types.js

@@ -0,0 +1,19 @@
+// Close-writer registry types.
+//
+// A close writer turns a schematic's close-with-evidence step into a
+// schema-validated final report. The pattern is the same across
+// every flow: read upstream reports, assemble pointers, derive
+// summary + outcome, validate against the flow's result schema,
+// write to disk. Per-flow logic (summary template, outcome
+// rules, optional-pointer detection) lives in a `CloseBuilder` next
+// to that flow's schemas, not in the runner.
+//
+// To add a new flow's close, an author:
+//   1. Defines the result schema (Zod) in src/flows/<wf>/reports.ts
+//   2. Implements a CloseBuilder in src/flows/<wf>/writers/close.ts
+//   3. Registers it on the package's `writers.close`
+//
+// The runner.ts close path stays flow-agnostic — it relays by
+// schema name to the registered builder.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/flows/registries/close-writers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/flows/registries/close-writers/types.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,qEAAqE;AACrE,gEAAgE;AAChE,+DAA+D;AAC/D,gEAAgE;AAChE,2DAA2D;AAC3D,oEAAoE;AACpE,6CAA6C;AAC7C,EAAE;AACF,wCAAwC;AACxC,oEAAoE;AACpE,oEAAoE;AACpE,qDAAqD;AACrD,EAAE;AACF,8DAA8D;AAC9D,yCAAyC"}

package/dist/flows/registries/compose-writers/registry.d.ts

@@ -0,0 +1,6 @@
+import { type RuntimeIndexedFlow } from '../runtime-index.js';
+import type { ComposeBuilder, ComposeStep } from './types.js';
+export declare function findComposeBuilder(resultSchemaName: string): ComposeBuilder | undefined;
+export declare function listComposeWriters(): readonly (readonly [string, ComposeBuilder])[];
+export declare function resolveComposeReadPaths(builder: ComposeBuilder, flow: RuntimeIndexedFlow, step: ComposeStep): Record<string, string | undefined>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/flows/registries/compose-writers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/compose-writers/registry.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9D,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvF;AAKD,wBAAgB,kBAAkB,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAEnF;AAcD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,WAAW,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAepC"}