@petepetrash/circuit 0.1.0

package/dist/flows/fix/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/flows/fix/data.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkMJ,CAAC"}

package/dist/flows/fix/data.js

@@ -0,0 +1,207 @@
+import { assembleFlowSchematic } from '../assemble-flow-schematic.js';
+import { fixAssemblySpec } from './assembly-spec.js';
+import { fixChangeShapeHint, fixContextShapeHint, fixDiagnosisShapeHint, fixReviewShapeHint, } from './relay-hints.js';
+import { FixBaselineSnapshot, FixBrief, FixChange, FixChangeSet, FixContext, FixDiagnosis, FixNoReproDecision, FixRegressionProof, FixRegressionRerun, FixResult, FixReview, FixVerification, } from './reports.js';
+import { fixBaselineSnapshotWriter } from './writers/baseline-snapshot.js';
+import { fixBriefComposeBuilder } from './writers/brief.js';
+import { fixChangeSetWriter } from './writers/change-set.js';
+import { fixCloseBuilder } from './writers/close.js';
+import { fixRegressionBaselineWriter } from './writers/regression-baseline.js';
+import { fixRegressionRerunWriter } from './writers/regression-rerun.js';
+import { fixVerificationWriter } from './writers/verification.js';
+export const fixFlowData = {
+    id: 'fix',
+    visibility: 'public',
+    paths: {
+        schematic: 'src/flows/fix/schematic.json',
+        contract: 'src/flows/fix/contract.md',
+    },
+    // First-class composition (A5): fix is one of the assembler's production
+    // customers. Its block sequence, scaffolding, and report_file_surfaces live in
+    // ./assembly-spec.ts; `assembleFlowSchematic` derives starts_at / stages /
+    // stage_path_policy and returns the validated FlowSchematic that used to be a
+    // hand-authored literal here. The prove-by-equivalence test proves the
+    // assembled schematic is byte-identical to the former literal (schematic +
+    // compiled).
+    schematic: assembleFlowSchematic(fixAssemblySpec),
+    canonicalStagePolicy: {
+        kind: 'enforce',
+        canonicals: ['frame', 'analyze', 'act', 'verify', 'review', 'close'],
+        omits: ['plan'],
+        optional_canonicals: ['review'],
+        variants: [],
+        title: 'Frame → Diagnose → Fix → Verify → Review → Close',
+        authority: 'docs/flows/authoring-model.md §Fix As The Proving Shape',
+    },
+    reports: [
+        {
+            schemaName: 'fix.context@v1',
+            channel: 'relay',
+            schema: FixContext,
+            relayHint: fixContextShapeHint.instruction,
+        },
+        {
+            schemaName: 'fix.diagnosis@v1',
+            channel: 'relay',
+            schema: FixDiagnosis,
+            relayHint: fixDiagnosisShapeHint.instruction,
+        },
+        {
+            schemaName: 'fix.change@v1',
+            channel: 'relay',
+            schema: FixChange,
+            relayHint: fixChangeShapeHint.instruction,
+        },
+        {
+            schemaName: 'fix.review@v1',
+            channel: 'relay',
+            schema: FixReview,
+            relayHint: fixReviewShapeHint.instruction,
+        },
+        {
+            schemaName: 'fix.brief@v1',
+            channel: 'report',
+            schema: FixBrief,
+            writers: { compose: [fixBriefComposeBuilder] },
+        },
+        {
+            schemaName: 'fix.no-repro-decision@v1',
+            channel: 'report',
+            schema: FixNoReproDecision,
+        },
+        {
+            schemaName: 'fix.regression-proof@v1',
+            channel: 'report',
+            schema: FixRegressionProof,
+            writers: { verification: [fixRegressionBaselineWriter] },
+        },
+        {
+            schemaName: 'fix.baseline-snapshot@v1',
+            channel: 'report',
+            schema: FixBaselineSnapshot,
+            writers: { verification: [fixBaselineSnapshotWriter] },
+        },
+        {
+            schemaName: 'fix.verification@v1',
+            channel: 'report',
+            schema: FixVerification,
+            writers: { verification: [fixVerificationWriter] },
+        },
+        {
+            schemaName: 'fix.regression-rerun@v1',
+            channel: 'report',
+            schema: FixRegressionRerun,
+            writers: { verification: [fixRegressionRerunWriter] },
+        },
+        {
+            schemaName: 'fix.change-set@v1',
+            channel: 'report',
+            schema: FixChangeSet,
+            fileSurface: {
+                timing: 'after',
+                extractor: { kind: 'string-array-field', field: 'observed' },
+            },
+            writers: { verification: [fixChangeSetWriter] },
+        },
+        {
+            schemaName: 'fix.result@v1',
+            channel: 'report',
+            schema: FixResult,
+            writers: { close: [fixCloseBuilder] },
+        },
+    ],
+    runtimeSurface: {
+        primaryResult: {
+            schemaName: 'fix.result@v1',
+            path: 'reports/fix-result.json',
+            label: 'Fix result',
+        },
+        progress: {
+            steps: [
+                {
+                    stepId: 'fix-frame',
+                    taskTitle: 'Frame the work',
+                    activeText: 'Framing the work',
+                },
+                {
+                    stepId: 'fix-gather-context',
+                    taskTitle: 'Check the context',
+                    activeText: 'Checking the context',
+                    relayRole: 'researcher',
+                    relayStartedText: 'Asking the specialist to gather context...',
+                    relayCompletedText: 'Finished gathering context.',
+                },
+                {
+                    stepId: 'fix-diagnose',
+                    taskTitle: 'Check the context',
+                    activeText: 'Checking the context',
+                    relayRole: 'researcher',
+                    relayStartedText: 'Asking the specialist to diagnose the cause...',
+                    relayCompletedText: 'Finished the diagnosis.',
+                },
+                {
+                    stepId: 'fix-no-repro-decision',
+                    taskTitle: 'Check the context',
+                    activeText: 'Checking the context',
+                },
+                {
+                    stepId: 'fix-regression-baseline',
+                    taskTitle: 'Check the work',
+                    activeText: 'Checking the work',
+                },
+                {
+                    stepId: 'fix-baseline-snapshot',
+                    taskTitle: 'Check the work',
+                    activeText: 'Checking the work',
+                },
+                {
+                    stepId: 'fix-act',
+                    taskTitle: 'Make the change',
+                    activeText: 'Making the change',
+                    relayRole: 'implementer',
+                    relayStartedText: 'Asking the specialist to make the change...',
+                    relayCompletedText: 'Finished the specialist pass.',
+                },
+                {
+                    stepId: 'fix-verify',
+                    taskTitle: 'Check the work',
+                    activeText: 'Checking the work',
+                },
+                {
+                    stepId: 'fix-change-set',
+                    taskTitle: 'Check the work',
+                    activeText: 'Checking the work',
+                },
+                {
+                    stepId: 'fix-regression-rerun',
+                    taskTitle: 'Check the work',
+                    activeText: 'Checking the work',
+                },
+                {
+                    stepId: 'fix-review',
+                    taskTitle: 'Check the result',
+                    activeText: 'Checking the result',
+                    relayRole: 'reviewer',
+                    relayStartedText: 'Asking the reviewer to check the result...',
+                    relayCompletedText: 'Finished checking the result.',
+                },
+                {
+                    stepId: 'fix-close-low',
+                    taskTitle: 'Wrap up',
+                    activeText: 'Wrapping up',
+                },
+                {
+                    stepId: 'fix-close',
+                    taskTitle: 'Wrap up',
+                    activeText: 'Wrapping up',
+                },
+                {
+                    stepId: 'fix-handoff',
+                    taskTitle: 'Wrap up',
+                    activeText: 'Wrapping up',
+                },
+            ],
+        },
+    },
+};
+//# sourceMappingURL=data.js.map

package/dist/flows/fix/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../../src/flows/fix/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,KAAK;IACT,UAAU,EAAE,QAAQ;IACpB,KAAK,EAAE;QACL,SAAS,EAAE,8BAA8B;QACzC,QAAQ,EAAE,2BAA2B;KACtC;IACD,yEAAyE;IACzE,+EAA+E;IAC/E,2EAA2E;IAC3E,8EAA8E;IAC9E,uEAAuE;IACvE,2EAA2E;IAC3E,aAAa;IACb,SAAS,EAAE,qBAAqB,CAAC,eAAe,CAAC;IACjD,oBAAoB,EAAE;QACpB,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;QACpE,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,mBAAmB,EAAE,CAAC,QAAQ,CAAC;QAC/B,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,kDAAkD;QACzD,SAAS,EAAE,yDAAyD;KACrE;IACD,OAAO,EAAE;QACP;YACE,UAAU,EAAE,gBAAgB;YAC5B,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,mBAAmB,CAAC,WAAW;SAC3C;QACD;YACE,UAAU,EAAE,kBAAkB;YAC9B,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,qBAAqB,CAAC,WAAW;SAC7C;QACD;YACE,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,kBAAkB,CAAC,WAAW;SAC1C;QACD;YACE,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,kBAAkB,CAAC,WAAW;SAC1C;QACD;YACE,UAAU,EAAE,cAAc;YAC1B,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE;SAC/C;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,kBAAkB;SAC3B;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,kBAAkB;YAC1B,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,2BAA2B,CAAC,EAAE;SACzD;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,mBAAmB;YAC3B,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,yBAAyB,CAAC,EAAE;SACvD;QACD;YACE,UAAU,EAAE,qBAAqB;YACjC,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,eAAe;YACvB,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,qBAAqB,CAAC,EAAE;SACnD;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,kBAAkB;YAC1B,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,wBAAwB,CAAC,EAAE;SACtD;QACD;YACE,UAAU,EAAE,mBAAmB;YAC/B,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,YAAY;YACpB,WAAW,EAAE;gBACX,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,EAAE;aAC7D;YACD,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,kBAAkB,CAAC,EAAE;SAChD;QACD;YACE,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,eAAe,CAAC,EAAE;SACtC;KACF;IACD,cAAc,EAAE;QACd,aAAa,EAAE;YACb,UAAU,EAAE,eAAe;YAC3B,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,YAAY;SACpB;QACD,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL;oBACE,MAAM,EAAE,WAAW;oBACnB,SAAS,EAAE,gBAAgB;oBAC3B,UAAU,EAAE,kBAAkB;iBAC/B;gBACD;oBACE,MAAM,EAAE,oBAAoB;oBAC5B,SAAS,EAAE,mBAAmB;oBAC9B,UAAU,EAAE,sBAAsB;oBAClC,SAAS,EAAE,YAAY;oBACvB,gBAAgB,EAAE,4CAA4C;oBAC9D,kBAAkB,EAAE,6BAA6B;iBAClD;gBACD;oBACE,MAAM,EAAE,cAAc;oBACtB,SAAS,EAAE,mBAAmB;oBAC9B,UAAU,EAAE,sBAAsB;oBAClC,SAAS,EAAE,YAAY;oBACvB,gBAAgB,EAAE,gDAAgD;oBAClE,kBAAkB,EAAE,yBAAyB;iBAC9C;gBACD;oBACE,MAAM,EAAE,uBAAuB;oBAC/B,SAAS,EAAE,mBAAmB;oBAC9B,UAAU,EAAE,sBAAsB;iBACnC;gBACD;oBACE,MAAM,EAAE,yBAAyB;oBACjC,SAAS,EAAE,gBAAgB;oBAC3B,UAAU,EAAE,mBAAmB;iBAChC;gBACD;oBACE,MAAM,EAAE,uBAAuB;oBAC/B,SAAS,EAAE,gBAAgB;oBAC3B,UAAU,EAAE,mBAAmB;iBAChC;gBACD;oBACE,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,iBAAiB;oBAC5B,UAAU,EAAE,mBAAmB;oBAC/B,SAAS,EAAE,aAAa;oBACxB,gBAAgB,EAAE,6CAA6C;oBAC/D,kBAAkB,EAAE,+BAA+B;iBACpD;gBACD;oBACE,MAAM,EAAE,YAAY;oBACpB,SAAS,EAAE,gBAAgB;oBAC3B,UAAU,EAAE,mBAAmB;iBAChC;gBACD;oBACE,MAAM,EAAE,gBAAgB;oBACxB,SAAS,EAAE,gBAAgB;oBAC3B,UAAU,EAAE,mBAAmB;iBAChC;gBACD;oBACE,MAAM,EAAE,sBAAsB;oBAC9B,SAAS,EAAE,gBAAgB;oBAC3B,UAAU,EAAE,mBAAmB;iBAChC;gBACD;oBACE,MAAM,EAAE,YAAY;oBACpB,SAAS,EAAE,kBAAkB;oBAC7B,UAAU,EAAE,qBAAqB;oBACjC,SAAS,EAAE,UAAU;oBACrB,gBAAgB,EAAE,4CAA4C;oBAC9D,kBAAkB,EAAE,+BAA+B;iBACpD;gBACD;oBACE,MAAM,EAAE,eAAe;oBACvB,SAAS,EAAE,SAAS;oBACpB,UAAU,EAAE,aAAa;iBAC1B;gBACD;oBACE,MAAM,EAAE,WAAW;oBACnB,SAAS,EAAE,SAAS;oBACpB,UAAU,EAAE,aAAa;iBAC1B;gBACD;oBACE,MAAM,EAAE,aAAa;oBACrB,SAAS,EAAE,SAAS;oBACpB,UAAU,EAAE,aAAa;iBAC1B;aACF;SACF;KACF;CACiB,CAAC"}

package/dist/flows/fix/flow.d.ts

@@ -0,0 +1,2 @@
+export declare const fixFlowDefinition: import("../flow-definition.js").FlowDefinition;
+//# sourceMappingURL=flow.d.ts.map

package/dist/flows/fix/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../src/flows/fix/flow.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,gDAA8B,CAAC"}

package/dist/flows/fix/flow.js

@@ -0,0 +1,4 @@
+import { defineFlowData } from '../flow-definition.js';
+import { fixFlowData } from './data.js';
+export const fixFlowDefinition = defineFlowData(fixFlowData);
+//# sourceMappingURL=flow.js.map

package/dist/flows/fix/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../../src/flows/fix/flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC"}

package/dist/flows/fix/index.d.ts

@@ -0,0 +1,3 @@
+declare const compiledFlowPackage: import("../types.js").CompiledFlowPackage;
+export { compiledFlowPackage as fixCompiledFlowPackage };
+//# sourceMappingURL=index.d.ts.map

package/dist/flows/fix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/flows/fix/index.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,mBAAmB,2CAA2C,CAAC;AAErE,OAAO,EAAE,mBAAmB,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/flows/fix/index.js

@@ -0,0 +1,5 @@
+import { compileFlowDefinition } from '../flow-definition.js';
+import { fixFlowDefinition } from './flow.js';
+const compiledFlowPackage = compileFlowDefinition(fixFlowDefinition);
+export { compiledFlowPackage as fixCompiledFlowPackage };
+//# sourceMappingURL=index.js.map

package/dist/flows/fix/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/flows/fix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;AAErE,OAAO,EAAE,mBAAmB,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/flows/fix/relay-hints.d.ts

@@ -0,0 +1,6 @@
+import type { SchemaShapeHint } from '../registries/shape-hints/types.js';
+export declare const fixContextShapeHint: SchemaShapeHint;
+export declare const fixDiagnosisShapeHint: SchemaShapeHint;
+export declare const fixChangeShapeHint: SchemaShapeHint;
+export declare const fixReviewShapeHint: SchemaShapeHint;
+//# sourceMappingURL=relay-hints.d.ts.map

package/dist/flows/fix/relay-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-hints.d.ts","sourceRoot":"","sources":["../../../src/flows/fix/relay-hints.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAG1E,eAAO,MAAM,mBAAmB,EAAE,eAQjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eASnC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAShC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAShC,CAAC"}

package/dist/flows/fix/relay-hints.js

@@ -0,0 +1,52 @@
+// Fix flow relay shape hints.
+//
+// The literal JSON shape for each instruction is rendered from the
+// step's Zod report schema via `renderShapeSkeleton`. Field-level
+// placeholders come from `.describe()` calls on the schema fields in
+// `reports.ts` — that keeps the shape and its worker-facing
+// description in one place. The renderer's output is then surrounded
+// by the task-specific guidance and a small mechanical tail that
+// reminds the worker of the parse/validate contract.
+import { renderShapeSkeleton } from '../registries/shape-hints/from-zod.js';
+import { mechanicalTail, shapeInstruction } from '../registries/shape-hints/instruction-helpers.js';
+import { FixChange, FixContext, FixDiagnosis, FixReview } from './reports.js';
+export const fixContextShapeHint = {
+    kind: 'schema',
+    schema: 'fix.context@v1',
+    instruction: [
+        shapeInstruction(renderShapeSkeleton(FixContext)),
+        'Read the relevant source and tests before reporting context. This step is read-only by intent: do not edit files, write files, or run commands that modify the checkout. Include the files, commands, or notes that define the bug boundary and the proof commands the operator expects. sources must contain at least one entry; observations must contain at least one entry. Use an empty open_questions array only when nothing remains unresolved. Every observation must be grounded in the cited sources — do not invent details that the sources do not support.',
+        mechanicalTail('fix.context@v1', 'reports/fix/context.json'),
+    ].join(' '),
+};
+export const fixDiagnosisShapeHint = {
+    kind: 'schema',
+    schema: 'fix.diagnosis@v1',
+    instruction: [
+        shapeInstruction(renderShapeSkeleton(FixDiagnosis)),
+        'Compare the failing behavior against the intended behavior before naming the cause. This step is read-only by intent: do not edit files, write files, or run commands that modify the checkout. Check whether the bug could have sibling edge cases, not only the first failing assertion. evidence must contain at least one entry (file:line, command result, or report reference that supports the cause), expressed as a JSON array of short distinct strings (one supporting fact per element). residual_uncertainty must be non-empty whenever reproduction_status is anything other than "reproduced" — if you could not cleanly reproduce the bug, name the unknowns honestly. Calibrate confidence to the evidence: do not claim "high" without direct reproduction or equivalent proof.',
+        'Include recommended_power ONLY when the relay context states the power dial is auto; omit the key entirely otherwise. When you do include it, judge from the code you read how strong a model the downstream fix and review need: "low" for a small localized change with good test coverage, "high" for a wide, subtle, or weakly-tested change, "medium" between. One short rationale sentence.',
+        mechanicalTail('fix.diagnosis@v1', 'reports/fix/diagnosis.json'),
+    ].join(' '),
+};
+export const fixChangeShapeHint = {
+    kind: 'schema',
+    schema: 'fix.change@v1',
+    instruction: [
+        shapeInstruction(renderShapeSkeleton(FixChange)),
+        'Make the smallest change that resolves the diagnosed cause and address every objective check named in the brief. Do not stop at the first green assertion if the brief names multiple formats, modes, or edge commands. Do not refactor adjacent code, broaden behavior, or address unrelated issues in the same edit. changed_files must contain at least one entry; evidence must contain at least one entry (test output, command result, or before/after observation that confirms the change works).',
+        '`evidence` is a JSON array of short distinct strings — one observation per element. It is a schema field name, not a request for prose. Even on retry attempts where you are summarizing prior verification output, keep each observation as its own array element.',
+        mechanicalTail('fix.change@v1', 'reports/fix/change.json'),
+    ].join(' '),
+};
+export const fixReviewShapeHint = {
+    kind: 'schema',
+    schema: 'fix.review@v1',
+    instruction: [
+        shapeInstruction(renderShapeSkeleton(FixReview)),
+        "Review the change against the diagnosed cause and the brief's success criteria, not just against passing verification. Look for missed edge cases, partially handled input variants, and changes that broaden semantics beyond the bug being fixed even when the regression test passes.",
+        'Use an empty findings array only with verdict "accept". Verdicts "accept-with-fixes" and "reject" must include at least one finding. Use an empty file_refs array when a finding has no file-specific reference.',
+        mechanicalTail('fix.review@v1', 'reports/fix/review.json'),
+    ].join(' '),
+};
+//# sourceMappingURL=relay-hints.js.map

package/dist/flows/fix/relay-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-hints.js","sourceRoot":"","sources":["../../../src/flows/fix/relay-hints.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,mEAAmE;AACnE,kEAAkE;AAClE,qEAAqE;AACrE,4DAA4D;AAC5D,qEAAqE;AACrE,iEAAiE;AACjE,qDAAqD;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEpG,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,gBAAgB;IACxB,WAAW,EAAE;QACX,gBAAgB,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACjD,0iBAA0iB;QAC1iB,cAAc,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;KAC7D,CAAC,IAAI,CAAC,GAAG,CAAC;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAoB;IACpD,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,kBAAkB;IAC1B,WAAW,EAAE;QACX,gBAAgB,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QACnD,mwBAAmwB;QACnwB,mYAAmY;QACnY,cAAc,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;KACjE,CAAC,IAAI,CAAC,GAAG,CAAC;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,eAAe;IACvB,WAAW,EAAE;QACX,gBAAgB,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAChD,2eAA2e;QAC3e,qQAAqQ;QACrQ,cAAc,CAAC,eAAe,EAAE,yBAAyB,CAAC;KAC3D,CAAC,IAAI,CAAC,GAAG,CAAC;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,eAAe;IACvB,WAAW,EAAE;QACX,gBAAgB,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAChD,0RAA0R;QAC1R,kNAAkN;QAClN,cAAc,CAAC,eAAe,EAAE,yBAAyB,CAAC;KAC3D,CAAC,IAAI,CAAC,GAAG,CAAC;CACZ,CAAC"}