@petepetrash/circuit 0.1.0

package/dist/flows/cross-tool-build/writers/close.js

@@ -0,0 +1,49 @@
+// Cross-Tool Build close-with-evidence builder.
+//
+// Reads the implementation, the automated verification, and both adversarial
+// review verdicts, then emits cross-tool-build.result@v1. The outcome is
+// 'complete' only when the verification passed; the two review verdicts are
+// carried into the result for transparency, not as blockers (a 'revise' is
+// expected — the doer revised against it in the next step). The evidence links
+// point at every report the run produced so the operator can open them.
+import { reportPathForSchemaInRuntimeFlow } from '../../registries/runtime-index.js';
+import { CrossToolBuildImplementation, CrossToolBuildProposalReview, CrossToolBuildResult, CrossToolBuildSpecReview, CrossToolBuildVerification, } from '../reports.js';
+// Every report the run links from the result, in run order. Each is produced by
+// a step, so its path resolves through the runtime report index.
+const EVIDENCE_POINTERS = [
+    { label: 'Proposal', schema: 'cross-tool-build.proposal@v1' },
+    { label: 'Proposal review', schema: 'cross-tool-build.proposal-review@v1' },
+    { label: 'Implementation spec', schema: 'cross-tool-build.spec@v1' },
+    { label: 'Spec review', schema: 'cross-tool-build.spec-review@v1' },
+    { label: 'Implementation', schema: 'cross-tool-build.implementation@v1' },
+    { label: 'Verification', schema: 'cross-tool-build.verification@v1' },
+];
+export const crossToolBuildCloseBuilder = {
+    resultSchemaName: 'cross-tool-build.result@v1',
+    reads: [
+        { name: 'implementation', schema: 'cross-tool-build.implementation@v1', required: true },
+        { name: 'verification', schema: 'cross-tool-build.verification@v1', required: true },
+        { name: 'proposal_review', schema: 'cross-tool-build.proposal-review@v1', required: true },
+        { name: 'spec_review', schema: 'cross-tool-build.spec-review@v1', required: true },
+    ],
+    build(context) {
+        const implementation = CrossToolBuildImplementation.parse(context.inputs.implementation);
+        const verification = CrossToolBuildVerification.parse(context.inputs.verification);
+        const proposalReview = CrossToolBuildProposalReview.parse(context.inputs.proposal_review);
+        const specReview = CrossToolBuildSpecReview.parse(context.inputs.spec_review);
+        const verificationStatus = verification.overall_status === 'passed' ? 'passed' : 'failed';
+        const outcome = verificationStatus === 'passed' ? 'complete' : 'needs_attention';
+        return CrossToolBuildResult.parse({
+            summary: implementation.summary,
+            outcome,
+            verification_status: verificationStatus,
+            proposal_review_verdict: proposalReview.verdict,
+            spec_review_verdict: specReview.verdict,
+            evidence_links: EVIDENCE_POINTERS.map((pointer) => ({
+                label: pointer.label,
+                path: reportPathForSchemaInRuntimeFlow(context.flow, pointer.schema),
+            })),
+        });
+    },
+};
+//# sourceMappingURL=close.js.map

package/dist/flows/cross-tool-build/writers/close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../../src/flows/cross-tool-build/writers/close.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,+EAA+E;AAC/E,wEAAwE;AAGxE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,gFAAgF;AAChF,iEAAiE;AACjE,MAAM,iBAAiB,GAAG;IACxB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,8BAA8B,EAAE;IAC7D,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,qCAAqC,EAAE;IAC3E,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,0BAA0B,EAAE;IACpE,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,iCAAiC,EAAE;IACnE,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,oCAAoC,EAAE;IACzE,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,kCAAkC,EAAE;CAC7D,CAAC;AAEX,MAAM,CAAC,MAAM,0BAA0B,GAAiB;IACtD,gBAAgB,EAAE,4BAA4B;IAC9C,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,oCAAoC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxF,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,kCAAkC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpF,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,qCAAqC,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1F,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,iCAAiC,EAAE,QAAQ,EAAE,IAAI,EAAE;KACnF;IACD,KAAK,CAAC,OAA0B;QAC9B,MAAM,cAAc,GAAG,4BAA4B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACzF,MAAM,YAAY,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACnF,MAAM,cAAc,GAAG,4BAA4B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1F,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE9E,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1F,MAAM,OAAO,GAAG,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAEjF,OAAO,oBAAoB,CAAC,KAAK,CAAC;YAChC,OAAO,EAAE,cAAc,CAAC,OAAO;YAC/B,OAAO;YACP,mBAAmB,EAAE,kBAAkB;YACvC,uBAAuB,EAAE,cAAc,CAAC,OAAO;YAC/C,mBAAmB,EAAE,UAAU,CAAC,OAAO;YACvC,cAAc,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAClD,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,gCAAgC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC;aACrE,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/flows/cross-tool-build/writers/plan.d.ts

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

package/dist/flows/cross-tool-build/writers/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/flows/cross-tool-build/writers/plan.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AAGnD,eAAO,MAAM,gCAAgC,EAAE,cAc9C,CAAC"}

package/dist/flows/cross-tool-build/writers/plan.js

@@ -0,0 +1,27 @@
+// Cross-Tool Build plan compose writer.
+//
+// The preamble step. It resolves the verification command(s) the implementation
+// will be checked against and lifts them into a deliberate, check-able plan. The
+// commands come from the operator's goal via the shared verification resolver —
+// the same machine Build's brief uses (it reads the project's package.json
+// scripts). The verification step reads this plan and runs exactly these
+// commands, so the plan is the single source of truth for what "green" means
+// this run. Mirrors fix-until-green's plan writer.
+import { requireResolvedVerificationCommands } from '../../../shared/verification-resolver.js';
+import { CrossToolBuildPlan } from '../reports.js';
+export const crossToolBuildPlanComposeBuilder = {
+    resultSchemaName: 'cross-tool-build.plan@v1',
+    build(context) {
+        const commands = requireResolvedVerificationCommands({
+            ...(context.projectRoot === undefined ? {} : { projectRoot: context.projectRoot }),
+            goal: context.goal,
+            commandIdPrefix: 'cross-tool-build',
+        });
+        return CrossToolBuildPlan.parse({
+            objective: context.goal,
+            approach: `Propose, adversarially review, spec, adversarially review, then implement and verify: ${context.goal}`,
+            verification: { commands },
+        });
+    },
+};
+//# sourceMappingURL=plan.js.map

package/dist/flows/cross-tool-build/writers/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../src/flows/cross-tool-build/writers/plan.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,mDAAmD;AAEnD,OAAO,EAAE,mCAAmC,EAAE,MAAM,0CAA0C,CAAC;AAK/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,gCAAgC,GAAmB;IAC9D,gBAAgB,EAAE,0BAA0B;IAC5C,KAAK,CAAC,OAA4B;QAChC,MAAM,QAAQ,GAAG,mCAAmC,CAAC;YACnD,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;YAClF,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,eAAe,EAAE,kBAAkB;SACpC,CAAC,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,IAAI;YACvB,QAAQ,EAAE,yFAAyF,OAAO,CAAC,IAAI,EAAE;YACjH,YAAY,EAAE,EAAE,QAAQ,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/flows/cross-tool-build/writers/verification.d.ts

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

package/dist/flows/cross-tool-build/writers/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../../src/flows/cross-tool-build/writers/verification.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,gDAAgD,CAAC;AAGxD,eAAO,MAAM,gCAAgC,EAAE,mBAoC9C,CAAC"}

package/dist/flows/cross-tool-build/writers/verification.js

@@ -0,0 +1,46 @@
+// Cross-Tool Build verification writer.
+//
+// Sources its command list from cross-tool-build.plan@v1 (the preamble lifts the
+// goal's verification commands into a deliberate list) and emits the canonical
+// VerificationResult report. Its overall_status is the automated proof the close
+// gate reads: a failed command makes the result 'failed', which keeps the verify
+// step from routing 'continue', so the run cannot close 'complete' while the
+// checks are still red. Mirrors fix-until-green's verification writer.
+import { readFileSync } from 'node:fs';
+import { resolveRunRelative } from '../../../shared/run-relative-path.js';
+import { reportPathForSchemaInRuntimeFlow } from '../../registries/runtime-index.js';
+import { CrossToolBuildPlan, CrossToolBuildVerification } from '../reports.js';
+export const crossToolBuildVerificationWriter = {
+    resultSchemaName: 'cross-tool-build.verification@v1',
+    // Commands come from the plan's verification command list. Declared so a
+    // composer wires the read and the offline floor resolves it; loadCommands
+    // below is the enforcing source of truth.
+    reads: [{ name: 'plan', schema: 'cross-tool-build.plan@v1', required: true }],
+    loadCommands(context) {
+        const planPath = reportPathForSchemaInRuntimeFlow(context.flow, 'cross-tool-build.plan@v1');
+        if (!context.step.reads.includes(planPath)) {
+            throw new Error(`cross-tool-build.verification@v1 requires step '${context.step.id}' to read ${planPath}`);
+        }
+        const plan = CrossToolBuildPlan.parse(JSON.parse(readFileSync(resolveRunRelative(context.runFolder, planPath), 'utf8')));
+        return plan.verification.commands;
+    },
+    buildResult(observations) {
+        const overallStatus = observations.some((observation) => observation.status === 'failed')
+            ? 'failed'
+            : 'passed';
+        return CrossToolBuildVerification.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/cross-tool-build/writers/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../../../src/flows/cross-tool-build/writers/verification.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,iFAAiF;AACjF,6EAA6E;AAC7E,uEAAuE;AAEvE,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,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE/E,MAAM,CAAC,MAAM,gCAAgC,GAAwB;IACnE,gBAAgB,EAAE,kCAAkC;IACpD,yEAAyE;IACzE,0EAA0E;IAC1E,0CAA0C;IAC1C,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7E,YAAY,CAAC,OAAiC;QAC5C,MAAM,QAAQ,GAAG,gCAAgC,CAAC,OAAO,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;QAC5F,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAiB,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,mDAAmD,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,QAAQ,EAAE,CAC1F,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CACnC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAClF,CAAC;QACF,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;IACpC,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,0BAA0B,CAAC,KAAK,CAAC;YACtC,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/equipment-reshape.d.ts

@@ -0,0 +1,18 @@
+import { CompiledFlow } from '../schemas/compiled-flow.js';
+import type { EquipmentDiscovery } from '../schemas/equipment-discovery.js';
+export type EquipmentReshapeCandidate = {
+    readonly ok: true;
+    readonly compiledFlow: CompiledFlow;
+    readonly equippedSteps: readonly string[];
+    readonly rationale: string;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+export declare function reResolveEquipmentOnCompiledFlow(input: {
+    readonly sourceFlow: CompiledFlow;
+    readonly fromStepId: string;
+    readonly remainingRelayStepIds: ReadonlySet<string>;
+    readonly discovery: EquipmentDiscovery;
+}): EquipmentReshapeCandidate;
+//# sourceMappingURL=equipment-reshape.d.ts.map

package/dist/flows/equipment-reshape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equipment-reshape.d.ts","sourceRoot":"","sources":["../../src/flows/equipment-reshape.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAQ5E,MAAM,MAAM,yBAAyB,GACjC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AA4BN,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;CACxC,GAAG,yBAAyB,CA+E5B"}

package/dist/flows/equipment-reshape.js

@@ -0,0 +1,119 @@
+// Step 2 — the live equipment reshape, compile-layer half.
+//
+// When a relay surfaces a CONFIRMED runtime discovery ("this turned out to be a
+// React app"), this re-resolves equipment for the REMAINING relay steps and
+// re-validates the candidate flow through the compiled-flow schema gate — the
+// same gate every loaded flow passes (CompiledFlow.parse, including the
+// no-duplicate-skill-slot rule). It lives in the flows layer, not the engine,
+// because re-resolving equipment and re-compiling is a compile-time flow
+// operation: the resolver (resolveEquipment) and the compiled-flow schema both
+// belong here, and the engine reaches this only through the sanctioned
+// compile-schematic-to-flow seam. The runtime owns the second half of the gate
+// (fromCompiledFlow / assertExecutableFlow) and materializing the executable
+// tail; see src/runtime/run/equipment-reshape.ts.
+//
+// Scope is the safest reshape case ONLY: equipment injection is ADDITIVE — it
+// equips a step already in the remaining sequence — so the step SEQUENCE never
+// changes and there is no splice seam (that is Step 3, structural reshape,
+// deliberately out of scope). Pure: no run state, no I/O.
+import { CompiledFlow } from '../schemas/compiled-flow.js';
+import { resolveEquipment } from './resolvers/equipment.js';
+// Merge injected slots into a step's existing slots, deduping by id (existing
+// first, so an author's slot is never displaced). Returns the merged list and
+// the ids that were newly added.
+function mergeSlots(existing, injected) {
+    const byId = new Map();
+    for (const s of existing)
+        byId.set(s.id, s);
+    const added = [];
+    for (const s of injected) {
+        const id = s.id;
+        if (byId.has(id))
+            continue;
+        byId.set(id, s);
+        added.push(id);
+    }
+    return { merged: [...byId.values()], added };
+}
+// Re-resolve equipment on the remaining relay steps from a confirmed discovery,
+// merge it additively into their skill slots, and re-validate the whole flow
+// through the compiled-flow schema gate. An unconfirmed discovery, no usable
+// tags, a no-op (the equipment is already present), or a gate rejection all
+// return `ok:false` with the reason; the caller leaves the running flow
+// unchanged. No budget or cycle logic here — the runtime closure owns the bound
+// (a reshape happens within one run loop and never spawns a child run).
+export function reResolveEquipmentOnCompiledFlow(input) {
+    const { sourceFlow, fromStepId, remainingRelayStepIds, discovery } = input;
+    // Confirmed-only. An unconfirmed discovery is a hunch; the conservative
+    // default never reshapes on it.
+    if (!discovery.confirmed) {
+        return {
+            ok: false,
+            reason: `equipment discovery from step '${fromStepId}' is unconfirmed; recorded as a finding, flow unchanged`,
+        };
+    }
+    const tags = discovery.domain_tags.filter((tag) => tag.trim().length > 0);
+    if (tags.length === 0) {
+        return {
+            ok: false,
+            reason: `equipment discovery from step '${fromStepId}' carried no usable domain tags; nothing to equip`,
+        };
+    }
+    // Build the candidate: re-resolve equipment for each remaining relay step and
+    // merge it additively into that step's slots. The source flow and its step
+    // objects are never mutated (map returns new objects for changed steps).
+    const equippedSteps = [];
+    let addedAny = false;
+    const steps = sourceFlow.steps.map((step) => {
+        if (step.kind !== 'relay' || !remainingRelayStepIds.has(step.id))
+            return step;
+        const resolution = resolveEquipment({
+            step_id: step.id,
+            role: step.role,
+            domain_tags: tags,
+        });
+        const { merged, added } = mergeSlots((step.skill_slots ?? []), resolution.choice);
+        if (added.length === 0)
+            return step;
+        addedAny = true;
+        equippedSteps.push(step.id);
+        return { ...step, skill_slots: merged };
+    });
+    if (!addedAny) {
+        return {
+            ok: false,
+            reason: `the remaining relay steps already carry the discovered equipment; nothing to inject (from step '${fromStepId}')`,
+        };
+    }
+    // Safety floor (schema half): re-run the compiled-flow schema gate every
+    // loaded flow passes, including the no-duplicate-skill-slot rule. The runtime
+    // closure runs the graph half (fromCompiledFlow / assertExecutableFlow). If
+    // either rejects, the caller falls back to the original, still-valid flow.
+    //
+    // SCOPE NOTE: the full compile path (compileSchematicToCompiledFlow) also runs
+    // the block-catalog gate and the self-reference check. Those are intentionally
+    // NOT re-run here, and that is sound ONLY because this reshape touches solely
+    // `skill_slots` — it changes no contract, route, block id, or sub-run target,
+    // which is all the catalog gate governs, and the sequence is unchanged so
+    // self-reference cannot regress. Step 3 (structural / splice reshape) changes
+    // routes and the step set, so it MUST re-add the catalog gate before relying on
+    // this function — do not extend this to a structural reshape without it.
+    let compiledFlow;
+    try {
+        compiledFlow = CompiledFlow.parse({ ...sourceFlow, steps });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            ok: false,
+            reason: `equipment reshape rejected by the compiled-flow schema gate: ${message}`,
+        };
+    }
+    return {
+        ok: true,
+        compiledFlow,
+        equippedSteps,
+        rationale: `confirmed ${tags.join(', ')}; equipped ${equippedSteps.join(', ')} and re-validated the flow`,
+    };
+}
+//# sourceMappingURL=equipment-reshape.js.map

package/dist/flows/equipment-reshape.js.map

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