@petepetrash/circuit 0.1.0

package/dist/flows/explainer/reports.js

@@ -0,0 +1,296 @@
+// Explainer (paper-to-site) flow report contracts.
+//
+// One `.strict()` Zod body per `explainer.<name>@v1` contract. The
+// describe-light shapes here mirror the explore/goal house style: compose
+// reports are produced by deterministic writers (writers/), relay reports are
+// produced by a connector-bound worker and guided by relay-hints.ts, and the
+// tournament aggregate is written by the engine's fanout join (so its shape is
+// copied verbatim from explore's proven aggregate, only swapping option_id for
+// concept_id).
+//
+// The flow encodes the operator's real research-paper -> interactive-site
+// pipeline: a lossless ("unsummarizable") digest, persona-lensed ideation, a
+// six-criteria tournament, an adversarial fidelity hardening pass, an operator
+// pick, a house-style spec, a child build run, verification, an operator
+// sign-off, and a close. See docs/ideas/paper-to-site-flow-brief.md.
+import { z } from 'zod';
+import { RubricJudgment, RubricResult } from '../../schemas/rubric.js';
+// The operator's six selection criteria. These ARE the rubric dims the
+// tournament fanout ranks branches on (ordered_dims in data.ts). Rubric dim
+// ids are free-form in the engine (RubricResult.dims is a string-keyed
+// record), so the operator's real vocabulary travels straight through.
+export const EXPLAINER_RUBRIC_DIMS = [
+    'fidelity',
+    'memetic_potential',
+    'entertainment',
+    'cross_audience_reach',
+    'build_feasibility',
+    'novelty',
+];
+const CONCEPT_ID = z
+    .string()
+    .regex(/^concept-[0-9]+$/, { message: 'concept id must be concept-<n>' });
+// 1. intake (compose) — frame the run: subject, source paper, house-style
+// references, and the success condition. Deterministic projection of the goal.
+export const ExplainerIntake = z
+    .object({
+    subject: z.string().min(1).describe('the paper or topic being explained'),
+    paper_reference: z
+        .string()
+        .min(1)
+        .describe('how to locate the source paper/outline for this run'),
+    house_style_references: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe('operator house-style spec files the build must honor'),
+    success_condition: z
+        .string()
+        .min(1)
+        .describe('what a faithful, shippable explainer site must satisfy'),
+})
+    .strict();
+// 2. digest (compose) — the "unsummarizable" lossless outline. A scaffold in
+// v1 (deterministic): the principle plus the row/section shape the operator
+// fills from the real paper. Promoting this to a model-authored relay is the
+// primary enrichment.
+export const ExplainerNotationRow = z
+    .object({
+    symbol: z.string().min(1),
+    name: z.string().min(1),
+    definition: z.string().min(1),
+    role: z.string().min(1),
+})
+    .strict();
+export const ExplainerOutlineSection = z
+    .object({
+    section_id: z.string().min(1).describe('addressable line id, e.g. O:40'),
+    title: z.string().min(1),
+    load_bearing_points: z.array(z.string().min(1)).min(1),
+})
+    .strict();
+export const ExplainerDigest = z
+    .object({
+    subject: z.string().min(1),
+    lossless_principle: z
+        .string()
+        .min(1)
+        .describe('the rule the digest obeys: dense, addressable, teaches the real driver'),
+    notation_rows: z
+        .array(ExplainerNotationRow)
+        .min(1)
+        .describe('one row per symbol, lookup-not-narrative'),
+    outline_sections: z
+        .array(ExplainerOutlineSection)
+        .min(1)
+        .describe('dense bullet stacks, every line load-bearing'),
+})
+    .strict();
+// 3. ideas (compose) — N scoped concepts to fan the tournament out over, one
+// per persona lens. Sized from axes.tournament_n.
+export const ExplainerConcept = z
+    .object({
+    id: CONCEPT_ID,
+    label: z.string().min(1),
+    summary: z.string().min(1),
+    lens: z.string().min(1).describe('the persona lens this concept is conceived through'),
+    scoped_prompt: z
+        .string()
+        .min(1)
+        .describe('best-case advocacy instruction handed to this branch relay'),
+    fidelity_anchor: z
+        .string()
+        .min(1)
+        .describe('outline citation (O:N) this concept must stay faithful to'),
+})
+    .strict();
+export const ExplainerIdeas = z
+    .object({
+    brief_question: z.string().min(1),
+    concepts: z.array(ExplainerConcept).min(1),
+})
+    .strict()
+    .superRefine((report, ctx) => {
+    const seen = new Set();
+    for (const [index, concept] of report.concepts.entries()) {
+        if (seen.has(concept.id)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['concepts', index, 'id'],
+                message: `duplicate concept id '${concept.id}'`,
+            });
+        }
+        seen.add(concept.id);
+    }
+});
+// The six-criteria self-judgment every tournament branch reports. Runtime
+// signals (declared in the fanout rubric) may veto a dim regardless of the
+// model's self-score.
+export const ExplainerRubricModelJudgments = z
+    .object({
+    fidelity: RubricJudgment,
+    memetic_potential: RubricJudgment,
+    entertainment: RubricJudgment,
+    cross_audience_reach: RubricJudgment,
+    build_feasibility: RubricJudgment,
+    novelty: RubricJudgment,
+})
+    .strict();
+// 4a. tournament-proposal (relay) — the per-branch advocate report. One relay
+// per concept argues the strongest evidence-backed case for THAT concept.
+export const ExplainerTournamentProposal = z
+    .object({
+    verdict: z.literal('accept'),
+    concept_id: CONCEPT_ID.describe('the branch concept id named in the step title'),
+    concept_label: z.string().min(1),
+    case_summary: z.string().min(1).describe('strongest evidence-backed case for THIS concept'),
+    fidelity_evidence: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe('O:N / outline citations proving it teaches the right driver'),
+    risks: z.array(z.string().min(1)),
+    next_action: z.string().min(1),
+    rubric_model_judgments: ExplainerRubricModelJudgments,
+})
+    .strict();
+// 4b. tournament-aggregate (report, engine-written by the fanout join). Shape
+// copied from explore's proven ExploreTournamentAggregate so the engine's
+// aggregate validates; result_body is the explainer proposal.
+export const ExplainerTournamentAggregateBranch = z
+    .object({
+    branch_id: z.string().min(1),
+    child_run_id: z.string().min(1),
+    child_outcome: z.enum(['complete', 'aborted', 'handoff', 'stopped', 'escalated']),
+    verdict: z.string().min(1),
+    admitted: z.boolean(),
+    result_path: z.string().min(1),
+    duration_ms: z.number().nonnegative(),
+    result_body: ExplainerTournamentProposal.optional(),
+    rubric_result: RubricResult.optional(),
+})
+    .strict();
+export const ExplainerTournamentAggregate = z
+    .object({
+    schema_version: z.literal(1),
+    join_policy: z.literal('aggregate-survivors'),
+    branch_count: z.number().int().positive(),
+    branches: z.array(ExplainerTournamentAggregateBranch).min(1),
+})
+    .strict()
+    .superRefine((aggregate, ctx) => {
+    if (aggregate.branch_count !== aggregate.branches.length) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['branch_count'],
+            message: 'branch_count must match branches.length',
+        });
+    }
+    for (const [index, branch] of aggregate.branches.entries()) {
+        if (branch.child_outcome === 'complete' && branch.result_body === undefined) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['branches', index, 'result_body'],
+                message: 'complete tournament branches must include result_body provenance',
+            });
+        }
+        if (branch.child_outcome === 'complete' && branch.rubric_result === undefined) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['branches', index, 'rubric_result'],
+                message: 'complete tournament branches must include rubric_result provenance',
+            });
+        }
+        if (branch.child_outcome === 'complete' &&
+            branch.result_body !== undefined &&
+            branch.result_body.concept_id !== branch.branch_id) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['branches', index, 'result_body', 'concept_id'],
+                message: `branch_id '${branch.branch_id}' must match result_body.concept_id '${branch.result_body.concept_id}'`,
+            });
+        }
+    }
+});
+// 5. hardening (relay) — adversarial fidelity pass over the survivors. The
+// danger protagonist is always the seductive wrong driver; the reviewer blocks
+// if any concept teaches it.
+export const ExplainerBannedPhraseFinding = z
+    .object({
+    phrase: z.string().min(1),
+    present: z.boolean(),
+    note: z.string().min(1).describe('why this phrase is a fidelity risk, with an O:N anchor'),
+})
+    .strict();
+export const ExplainerHardening = z
+    .object({
+    verdict: z.enum(['recommend', 'no-clear-winner', 'needs-operator']),
+    recommended_concept_id: z.string().min(1).nullable(),
+    teaches_right_driver: z
+        .boolean()
+        .describe('does the recommended concept foreground the actual driver, not the seductive one'),
+    banned_phrase_findings: z.array(ExplainerBannedPhraseFinding),
+    objections: z.array(z.string().min(1)),
+    confidence: z.enum(['low', 'medium', 'high']),
+})
+    .strict();
+// 7. spec (compose) — build-ready design law assembled from the winning
+// concept plus the operator house-style files.
+export const ExplainerSpec = z
+    .object({
+    concept_id: z.string().min(1),
+    concept_label: z.string().min(1),
+    visual_system: z.string().min(1).describe('design-token direction from VISUAL_SYSTEM.md'),
+    motion_architecture: z.string().min(1).describe('motion direction from MOTION_ARCHITECTURE.md'),
+    copy_deck: z.string().min(1).describe('voice and copy direction from COPY_DECK.md'),
+    fidelity_citations: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe('VERIFIED vs O:N tagged claims the build must not violate'),
+    build_brief: z.string().min(1).describe('the goal string handed to the build sub-run'),
+})
+    .strict();
+// 9. verification (verification) — mechanical proof of the built site.
+export const ExplainerVerificationCommand = z
+    .object({
+    id: z.string().min(1),
+    status: z.enum(['passed', 'failed']),
+    exit_code: z.number().int(),
+    stdout_summary: z.string(),
+    stderr_summary: z.string(),
+})
+    .strict();
+export const ExplainerVerification = z
+    .object({
+    overall_status: z.enum(['passed', 'failed']),
+    commands: z.array(ExplainerVerificationCommand).min(1),
+})
+    .strict();
+// 11. result (close) — the primary result. Honest outcome bound to the close.
+export const ExplainerResult = z
+    .object({
+    outcome: z.enum(['complete', 'blocked', 'stopped']).describe('honest run outcome'),
+    summary: z.string().min(1),
+    shipped_concept_id: z.string().min(1).nullable(),
+    evidence_pointers: z.array(z.string().min(1)).min(1),
+    residual_risks: z.array(z.string().min(1)),
+})
+    .strict();
+// Checkpoint response body (engine-written). Both operator checkpoints — the
+// concept PICK and the publish SIGN-OFF — resolve the human-decision block, whose
+// output_contract decision.answer@v1 this flow aliases to two actuals
+// (explainer.selection@v1, explainer.signoff@v1). The checkpoint executor writes
+// this exact shape to each step's response file (src/runtime/executors/checkpoint.ts).
+// Registering it as the body behind BOTH actuals lets the multi-actual
+// body-divergence probe prove the two checkpoints share one shape (uniform)
+// instead of leaving them unresolved. auto_resolution is left engine-typed
+// (present only on an auto-resolved checkpoint) rather than re-authored here.
+export const ExplainerCheckpointResponse = z
+    .object({
+    schema_version: z.literal(1),
+    step_id: z.string().min(1),
+    selection: z.string().min(1),
+    route_id: z.string().min(1),
+    resolution_source: z.string().min(1),
+    auto_resolution: z.unknown().optional(),
+})
+    .strict();
+//# sourceMappingURL=reports.js.map

package/dist/flows/explainer/reports.js.map

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

package/dist/flows/explainer/writers/close.d.ts

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

package/dist/flows/explainer/writers/close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/close.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAuC/F,eAAO,MAAM,qBAAqB,EAAE,YAoCnC,CAAC"}

package/dist/flows/explainer/writers/close.js

@@ -0,0 +1,67 @@
+// Explainer close-with-evidence writer.
+//
+// Binds the run's honest outcome to the operator SIGN-OFF and the mechanical
+// verification. The site is published only when the operator authorized it
+// (sign-off route 'continue') AND the build verified. Otherwise the run closes
+// blocked with the reason, and shipped_concept_id stays null — the flow never
+// launders an unauthorized or unverified site as shipped.
+import { readFileSync } from 'node:fs';
+import { resolveRunRelative } from '../../../shared/run-relative-path.js';
+import { reportPathForSchemaInRuntimeFlow } from '../../registries/runtime-index.js';
+import { ExplainerIntake, ExplainerResult, ExplainerSpec, ExplainerVerification, } from '../reports.js';
+const SIGNOFF_CHECKPOINT_STEP_ID = 'signoff-checkpoint-step';
+const POINTER_SCHEMAS = [
+    'explainer.intake@v1',
+    'explainer.digest@v1',
+    'explainer.ideas@v1',
+    'explainer.tournament-aggregate@v1',
+    'explainer.hardening@v1',
+    'explainer.spec@v1',
+    'explainer.build-result@v1',
+    'explainer.verification@v1',
+];
+function readJson(runFolder, path) {
+    return JSON.parse(readFileSync(resolveRunRelative(runFolder, path), 'utf8'));
+}
+function signoffSelection(context) {
+    const checkpoint = context.flow.steps.find((step) => step.kind === 'checkpoint' && step.id === SIGNOFF_CHECKPOINT_STEP_ID);
+    if (checkpoint?.kind !== 'checkpoint')
+        return undefined;
+    const response = readJson(context.runFolder, checkpoint.writes.response);
+    const selection = response !== null && typeof response === 'object' && !Array.isArray(response)
+        ? response.selection
+        : undefined;
+    return typeof selection === 'string' ? selection : undefined;
+}
+export const explainerCloseBuilder = {
+    resultSchemaName: 'explainer.result@v1',
+    reads: [
+        { name: 'intake', schema: 'explainer.intake@v1', required: true },
+        { name: 'spec', schema: 'explainer.spec@v1', required: true },
+        { name: 'verification', schema: 'explainer.verification@v1', required: true },
+    ],
+    build(context) {
+        const intake = ExplainerIntake.parse(context.inputs.intake);
+        const spec = ExplainerSpec.parse(context.inputs.spec);
+        const verification = ExplainerVerification.parse(context.inputs.verification);
+        const authorized = signoffSelection(context) === 'continue';
+        const verified = verification.overall_status === 'passed';
+        const shipped = authorized && verified;
+        const residualRisks = [];
+        if (!verified)
+            residualRisks.push('Site verification did not pass; the build does not yet compile cleanly.');
+        if (!authorized)
+            residualRisks.push('Operator did not authorize publishing at the fidelity sign-off.');
+        const summary = shipped
+            ? `Published the "${spec.concept_label}" explainer for ${intake.subject} after operator fidelity sign-off and a passing build.`
+            : `Held the "${spec.concept_label}" explainer for ${intake.subject}: ${residualRisks.join(' ')}`;
+        return ExplainerResult.parse({
+            outcome: shipped ? 'complete' : 'blocked',
+            summary,
+            shipped_concept_id: shipped ? spec.concept_id : null,
+            evidence_pointers: POINTER_SCHEMAS.map((schema) => reportPathForSchemaInRuntimeFlow(context.flow, schema)),
+            residual_risks: residualRisks,
+        });
+    },
+};
+//# sourceMappingURL=close.js.map

package/dist/flows/explainer/writers/close.js.map

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

package/dist/flows/explainer/writers/digest.d.ts

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

package/dist/flows/explainer/writers/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/digest.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AAQnD,eAAO,MAAM,6BAA6B,EAAE,cA8B3C,CAAC"}

package/dist/flows/explainer/writers/digest.js

@@ -0,0 +1,47 @@
+// Explainer digest compose writer.
+//
+// v1 emits the lossless-outline SCAFFOLD deterministically: the principle the
+// digest must obey plus one notation row and one outline section that name the
+// shape a real digest fills from the paper. A deterministic writer cannot read
+// the source paper, so it cannot author the dense, addressable outline itself —
+// promoting this step to a model-authored relay (researcher reads the paper,
+// emits explainer.digest@v1) is the flow's primary enrichment. Until then the
+// scaffold keeps the spine runnable and schema-valid, and the downstream
+// ideation/tournament steps are where the real model work happens.
+import { ExplainerDigest, ExplainerIntake } from '../reports.js';
+const LOSSLESS_PRINCIPLE = [
+    'The outline is unsummarizable: every line is load-bearing and addressable (O:N).',
+    'It is dense lookup, not narrative, and it teaches the paper’s actual driver — never the seductive wrong one.',
+].join(' ');
+export const explainerDigestComposeBuilder = {
+    resultSchemaName: 'explainer.digest@v1',
+    reads: [{ name: 'intake', schema: 'explainer.intake@v1', required: true }],
+    build(context) {
+        const intake = ExplainerIntake.parse(context.inputs.intake);
+        return ExplainerDigest.parse({
+            subject: intake.subject,
+            lossless_principle: LOSSLESS_PRINCIPLE,
+            // Scaffold rows/sections: schema-valid placeholders that name what a real
+            // digest fills. The ideation step reads these as the fidelity spine.
+            notation_rows: [
+                {
+                    symbol: '<symbol>',
+                    name: '<name from the paper>',
+                    definition: '<one-line definition, lookup not narrative>',
+                    role: 'the actual driver this symbol carries, stated plainly',
+                },
+            ],
+            outline_sections: [
+                {
+                    section_id: 'O:1',
+                    title: `Setup — what ${intake.subject} actually claims`,
+                    load_bearing_points: [
+                        'State the real mechanism the paper teaches.',
+                        'Name the seductive wrong driver the explainer must NOT teach.',
+                    ],
+                },
+            ],
+        });
+    },
+};
+//# sourceMappingURL=digest.js.map

package/dist/flows/explainer/writers/digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/digest.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,yEAAyE;AACzE,mEAAmE;AAMnE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,kBAAkB,GAAG;IACzB,kFAAkF;IAClF,8GAA8G;CAC/G,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,6BAA6B,GAAmB;IAC3D,gBAAgB,EAAE,qBAAqB;IACvC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1E,KAAK,CAAC,OAA4B;QAChC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,eAAe,CAAC,KAAK,CAAC;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,kBAAkB,EAAE,kBAAkB;YACtC,0EAA0E;YAC1E,qEAAqE;YACrE,aAAa,EAAE;gBACb;oBACE,MAAM,EAAE,UAAU;oBAClB,IAAI,EAAE,uBAAuB;oBAC7B,UAAU,EAAE,6CAA6C;oBACzD,IAAI,EAAE,uDAAuD;iBAC9D;aACF;YACD,gBAAgB,EAAE;gBAChB;oBACE,UAAU,EAAE,KAAK;oBACjB,KAAK,EAAE,gBAAgB,MAAM,CAAC,OAAO,kBAAkB;oBACvD,mBAAmB,EAAE;wBACnB,6CAA6C;wBAC7C,+DAA+D;qBAChE;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/flows/explainer/writers/ideas.d.ts

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

package/dist/flows/explainer/writers/ideas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideas.d.ts","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/ideas.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AA2BnD,eAAO,MAAM,4BAA4B,EAAE,cAkC1C,CAAC"}

package/dist/flows/explainer/writers/ideas.js

@@ -0,0 +1,65 @@
+// Explainer ideation compose writer.
+//
+// Drafts N scoped concepts for the tournament to fan out over, one per persona
+// lens, sized from axes.tournament_n (mirrors explore's decision-options
+// writer). Each concept carries a `scoped_prompt` — the best-case advocacy
+// instruction the matching tournament branch relay runs under — and a
+// `fidelity_anchor` tying it to the lossless outline so a branch cannot drift
+// off the paper's real driver. Deterministic in v1; the concepts' bodies are
+// thin, but the per-branch relay is where each concept gets argued for real.
+import { ExplainerDigest, ExplainerIdeas, ExplainerIntake } from '../reports.js';
+// The operator's three real evaluation personas (proposals/README.md). Concepts
+// cycle through them so the tournament ranks genuinely different framings, not
+// three flavors of one.
+const PERSONAS = [
+    {
+        label: 'Skeptical economist',
+        lens: 'incentives, second-order effects, and whether the claimed driver survives scrutiny',
+    },
+    {
+        label: 'Memetics strategist',
+        lens: 'what makes the idea spread without distorting it — the shareable, sticky frame',
+    },
+    {
+        label: 'Product designer / engineer',
+        lens: 'what is buildable as an interactive site and reads clearly across audiences',
+    },
+];
+const DEFAULT_CONCEPT_COUNT = 3;
+function fidelityAnchor(digest) {
+    return digest.outline_sections[0]?.section_id ?? 'O:1';
+}
+export const explainerIdeasComposeBuilder = {
+    resultSchemaName: 'explainer.ideas@v1',
+    reads: [
+        { name: 'intake', schema: 'explainer.intake@v1', required: true },
+        { name: 'digest', schema: 'explainer.digest@v1', required: true },
+    ],
+    build(context) {
+        const intake = ExplainerIntake.parse(context.inputs.intake);
+        const digest = ExplainerDigest.parse(context.inputs.digest);
+        const count = context.axes?.tournament_n ?? DEFAULT_CONCEPT_COUNT;
+        const anchor = fidelityAnchor(digest);
+        const concepts = Array.from({ length: count }, (_unused, index) => {
+            const persona = PERSONAS[index % PERSONAS.length];
+            const conceptNumber = index + 1;
+            return {
+                id: `concept-${conceptNumber}`,
+                label: `${persona?.label} framing of ${intake.subject}`,
+                summary: `An interactive explainer of ${intake.subject} conceived through the ${persona?.label.toLowerCase()} lens.`,
+                lens: persona?.lens ?? 'a distinct framing of the subject',
+                scoped_prompt: [
+                    `Make the strongest evidence-backed case for an interactive web explainer of ${intake.subject},`,
+                    `conceived through the ${persona?.label.toLowerCase()} lens (${persona?.lens}).`,
+                    `Cite the lossless outline (${anchor}) to prove it teaches the paper's actual driver, never the seductive wrong one.`,
+                ].join(' '),
+                fidelity_anchor: anchor,
+            };
+        });
+        return ExplainerIdeas.parse({
+            brief_question: `Which framing of ${intake.subject} should we build into an interactive explainer?`,
+            concepts,
+        });
+    },
+};
+//# sourceMappingURL=ideas.js.map

package/dist/flows/explainer/writers/ideas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideas.js","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/ideas.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,2EAA2E;AAC3E,sEAAsE;AACtE,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAM7E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEjF,gFAAgF;AAChF,+EAA+E;AAC/E,wBAAwB;AACxB,MAAM,QAAQ,GAAG;IACf;QACE,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,oFAAoF;KAC3F;IACD;QACE,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,gFAAgF;KACvF;IACD;QACE,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,6EAA6E;KACpF;CACO,CAAC;AAEX,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC,SAAS,cAAc,CAAC,MAAuB;IAC7C,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAmB;IAC1D,gBAAgB,EAAE,oBAAoB;IACtC,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACjE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE;KAClE;IACD,KAAK,CAAC,OAA4B;QAChC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,IAAI,qBAAqB,CAAC;QAClE,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,aAAa,GAAG,KAAK,GAAG,CAAC,CAAC;YAChC,OAAO;gBACL,EAAE,EAAE,WAAW,aAAa,EAAE;gBAC9B,KAAK,EAAE,GAAG,OAAO,EAAE,KAAK,eAAe,MAAM,CAAC,OAAO,EAAE;gBACvD,OAAO,EAAE,+BAA+B,MAAM,CAAC,OAAO,0BAA0B,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ;gBACpH,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,mCAAmC;gBAC1D,aAAa,EAAE;oBACb,+EAA+E,MAAM,CAAC,OAAO,GAAG;oBAChG,yBAAyB,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU,OAAO,EAAE,IAAI,IAAI;oBAChF,8BAA8B,MAAM,iFAAiF;iBACtH,CAAC,IAAI,CAAC,GAAG,CAAC;gBACX,eAAe,EAAE,MAAM;aACxB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC,KAAK,CAAC;YAC1B,cAAc,EAAE,oBAAoB,MAAM,CAAC,OAAO,iDAAiD;YACnG,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/flows/explainer/writers/intake.d.ts

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

package/dist/flows/explainer/writers/intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/intake.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AAmBnD,eAAO,MAAM,6BAA6B,EAAE,cAU3C,CAAC"}

package/dist/flows/explainer/writers/intake.js

@@ -0,0 +1,33 @@
+// Explainer intake compose writer.
+//
+// Deterministic projection of the run goal into the framing report: subject,
+// how to find the source paper, the operator house-style files the build must
+// honor, and the success condition. A real run supplies the paper path in the
+// goal; this writer keeps schematic execution honest with no operator input.
+import { ExplainerIntake } from '../reports.js';
+// The operator's house-style spec files (the-gap/spec/*). Referenced by name so
+// the flow runs anywhere; the build sub-run resolves them in the paper repo.
+const HOUSE_STYLE_REFERENCES = [
+    'VISUAL_SYSTEM.md',
+    'MOTION_ARCHITECTURE.md',
+    'COPY_DECK.md',
+    'FIDELITY_CITATIONS.md',
+];
+function successCondition(goal) {
+    return [
+        `Ship an interactive web explainer for: ${goal}.`,
+        'It must teach the paper’s actual driver (never the seductive wrong one), obey the house-style specs, and survive an operator fidelity sign-off before publishing.',
+    ].join(' ');
+}
+export const explainerIntakeComposeBuilder = {
+    resultSchemaName: 'explainer.intake@v1',
+    build(context) {
+        return ExplainerIntake.parse({
+            subject: context.goal,
+            paper_reference: context.goal,
+            house_style_references: [...HOUSE_STYLE_REFERENCES],
+            success_condition: successCondition(context.goal),
+        });
+    },
+};
+//# sourceMappingURL=intake.js.map

package/dist/flows/explainer/writers/intake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.js","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/intake.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAM7E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,gFAAgF;AAChF,6EAA6E;AAC7E,MAAM,sBAAsB,GAAG;IAC7B,kBAAkB;IAClB,wBAAwB;IACxB,cAAc;IACd,uBAAuB;CACf,CAAC;AAEX,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO;QACL,0CAA0C,IAAI,GAAG;QACjD,mKAAmK;KACpK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAmB;IAC3D,gBAAgB,EAAE,qBAAqB;IACvC,KAAK,CAAC,OAA4B;QAChC,OAAO,eAAe,CAAC,KAAK,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,eAAe,EAAE,OAAO,CAAC,IAAI;YAC7B,sBAAsB,EAAE,CAAC,GAAG,sBAAsB,CAAC;YACnD,iBAAiB,EAAE,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC;SAClD,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/flows/explainer/writers/spec.d.ts

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

package/dist/flows/explainer/writers/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/flows/explainer/writers/spec.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AAqCnD,eAAO,MAAM,2BAA2B,EAAE,cAkDzC,CAAC"}