@petepetrash/circuit 0.1.0

package/dist/cli/generate.js

@@ -0,0 +1,346 @@
+// `circuit generate` — the PROPOSE half of the north star, as a product command.
+//
+// create vs generate. Both turn a task into a custom flow and publish it through
+// the SAME tail (custom-flow-package.ts). They differ in the PRODUCER:
+//   - create   INSTANTIATES a proven family template, offline and deterministic.
+//   - generate genuinely COMPOSES a flow block by block: it asks a model to
+//     PROPOSE a flow shape, runs the offline floor (compose -> validity ->
+//     runnability), and on a wall feeds the verifier's exact errors back for a
+//     bounded number of repair rounds. Output is a runnable composed flow OR an
+//     honest parse/relay/wall failure.
+//
+// This is the first product surface over proposeFlow. It is selection-agnostic at
+// the core (proposeFlow takes a ResolvedSelection); the command pins the proposer
+// to the model the live runs validated (claude-haiku-4-5 / low). Wiring the
+// session power dial here is a recorded follow-up — see the comment on
+// PROPOSER_SELECTION.
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { Command } from 'commander';
+import { relayClaudeCode } from '../connectors/claude-code.js';
+import { assembleFlowSchematic } from '../flows/assemble-flow-schematic.js';
+import { compileSchematicToCompiledFlow } from '../flows/compile-schematic-to-flow.js';
+import { planCompiledFlowFiles } from '../flows/compiled-flow-file-plan.js';
+import { proposeFlow } from '../flows/composition/index.js';
+import { CompiledFlow } from '../schemas/compiled-flow.js';
+import { progressPresentation } from '../shared/progress-output.js';
+import { parseCommanderOrThrow } from './commander-support.js';
+import { assertValidSlug, commandRoot, customFlowInvocation, customHome, draftRoot, flowRoot, manifestPath, publishDraft, publishedRoot, resultPath, slugify, summaryPath, validateCustomFlow, writeDraft, writeJson, writeText, } from './custom-flow-package.js';
+import { CUSTOM_FLOW_ROOT_RUNTIME_POLICY } from './runtime-routing-policy.js';
+import { utilityProgress } from './utility-progress.js';
+// The proposer is pinned to the model the live proposeFlow runs validated
+// (claude-haiku-4-5 / low): 4/4 of the validation tasks composed runnable on it.
+// proposeFlow is selection-agnostic, so honoring the session power dial here is a
+// one-line swap (materializePowerSelection, role 'researcher') once the dial is
+// loaded at this boundary. v1 pins the proven model and reports it transparently
+// in the result so the choice is visible.
+const PROPOSER_SELECTION = {
+    model: { provider: 'anthropic', model: 'claude-haiku-4-5' },
+    effort: 'low',
+    skills: [],
+    invocation_options: {},
+};
+const PROPOSER_MODEL_LABEL = 'claude-haiku-4-5';
+// The real model channel: wrap the connector relay as a RelayFn. Used when the
+// caller injects no relay (the bin/circuit path). Tests inject a stub instead.
+const productionRelay = {
+    connectorName: 'claude-code',
+    relay: (input) => relayClaudeCode(input),
+};
+function parseArgs(argv) {
+    const program = new Command('circuit generate')
+        .option('--description <task>')
+        .option('--name <slug>')
+        .option('--home <path>')
+        .option('--created-at <iso>')
+        .option('--publish')
+        .option('--yes')
+        .option('--max-repair <n>')
+        .option('--timeout-ms <ms>')
+        .option('--progress <format>');
+    parseCommanderOrThrow(program, argv);
+    if (program.args.length > 0)
+        throw new Error(`unexpected argument: ${program.args[0]}`);
+    const opts = program.opts();
+    if (opts.progress !== undefined && opts.progress !== 'jsonl') {
+        throw new Error("--progress only supports 'jsonl'");
+    }
+    const maxRepair = opts.maxRepair === undefined ? 4 : Number(opts.maxRepair);
+    if (!Number.isInteger(maxRepair) || maxRepair < 0) {
+        throw new Error('--max-repair must be a non-negative integer');
+    }
+    const timeoutMs = opts.timeoutMs === undefined ? 90_000 : Number(opts.timeoutMs);
+    if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {
+        throw new Error('--timeout-ms must be a positive integer');
+    }
+    // Flag misuse is a usage error and exits 2 through the parse-error path,
+    // like every other command; the operational try/catch below keeps exit 1
+    // for real failures (B4).
+    if (opts.description === undefined || opts.description.length === 0) {
+        throw new Error('--description is required');
+    }
+    if (opts.publish === true && opts.yes !== true) {
+        throw new Error('--publish requires --yes so publish confirmation is explicit');
+    }
+    return {
+        publish: opts.publish === true,
+        yes: opts.yes === true,
+        progress: opts.progress === 'jsonl',
+        maxRepair,
+        timeoutMs,
+        description: opts.description,
+        ...(opts.name === undefined ? {} : { name: opts.name }),
+        ...(opts.home === undefined ? {} : { home: opts.home }),
+        ...(opts.createdAt === undefined ? {} : { createdAt: opts.createdAt }),
+    };
+}
+// Name the topology the model proposed, for the operator summary + result.
+function shapeOf(roleSet) {
+    const roles = roleSet.roles ?? [];
+    if (roles.some((r) => r.executionKind === 'fanout'))
+        return 'fanout';
+    if (roles.some((r) => r.executionKind === 'sub-run'))
+        return 'sub-run';
+    if (roles.some((r) => r.loopBackTo !== undefined))
+        return 'loop';
+    const hasAct = roles.some((r) => r.stage === 'act');
+    if (roles.some((r) => r.block === 'review-intake') && !hasAct)
+        return 'review-only';
+    if (!hasAct)
+        return 'no-act';
+    return 'linear';
+}
+// The generate producer: PROPOSE a flow shape, run the floor, then compile the
+// runnable spec into the same CompiledFlowFile[] the publish tail consumes.
+async function composeCustomFlow(input) {
+    const outcome = await proposeFlow({
+        task: input.description,
+        relay: input.relay,
+        resolvedSelection: PROPOSER_SELECTION,
+        maxRepair: input.maxRepair,
+        timeoutMs: input.timeoutMs,
+    });
+    if (!outcome.ok) {
+        return {
+            ok: false,
+            reason: outcome.reason,
+            errors: outcome.errors,
+            repairRounds: Math.max(0, outcome.rounds.length - 1),
+        };
+    }
+    // The slug: --name wins; otherwise the model's proposed id. slugify normalizes,
+    // assertValidSlug rejects a reserved or malformed slug. Forcing spec.id = slug
+    // makes the compiled flow's id equal the slug (validateCustomFlow's invariant).
+    const slug = slugify(input.name ?? outcome.roleSet.id);
+    assertValidSlug(slug);
+    const schematic = assembleFlowSchematic({ ...outcome.spec, id: slug });
+    const compiled = compileSchematicToCompiledFlow(schematic);
+    const files = planCompiledFlowFiles(compiled).map((file) => ({
+        filename: file.filename,
+        flow: CompiledFlow.parse(file.flow),
+    }));
+    for (const { filename, flow } of files) {
+        validateCustomFlow(slug, flow, `composed flow (${filename})`);
+    }
+    const shape = shapeOf(outcome.roleSet);
+    return {
+        ok: true,
+        slug,
+        files,
+        archetype: { family: 'composed', composition: `block-level (${shape})`, signals_used: [] },
+        shape,
+        convergedRound: outcome.convergedRound,
+        repairRounds: Math.max(0, outcome.rounds.length - 1),
+    };
+}
+function summaryMarkdown(input) {
+    const invocation = customFlowInvocation(input.slug, input.home);
+    const convergence = input.convergedRound === 0
+        ? 'The first proposal was runnable as composed.'
+        : `It converged after ${input.convergedRound} verifier-guided repair round(s).`;
+    return [
+        '# Circuit Generate',
+        '',
+        `Status: ${input.status}`,
+        `Custom flow: ${input.slug}`,
+        '',
+        '## Purpose',
+        input.description,
+        '',
+        '## Shape',
+        `This flow was composed block by block to fit the task (a ${input.shape} shape).`,
+        convergence,
+        `Proposer model: ${PROPOSER_MODEL_LABEL}.`,
+        '',
+        '## Validation',
+        "The composed flow passed the offline floor: it composes, is catalog-valid, and every writer's required upstream reads have a producer (runnable).",
+        '',
+        '## Runtime Policy',
+        CUSTOM_FLOW_ROOT_RUNTIME_POLICY,
+        '',
+        '## Usage',
+        `\`${invocation}\``,
+        '',
+        '## Next Action',
+        input.status === 'published'
+            ? 'Run the usage command above, or reload the host command surface if your host caches slash commands.'
+            : 'Review the draft, then rerun generate with `--publish --yes` when ready.',
+    ].join('\n');
+}
+export async function runGenerateCommand(argv, options = {}) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`error: ${err.message}\n`);
+        return 2;
+    }
+    const now = options.now ?? (() => new Date());
+    const progress = utilityProgress({ enabled: args.progress, flowId: 'generate', now });
+    if (progress !== undefined) {
+        progress.emit({
+            type: 'route.selected',
+            recorded_at: now().toISOString(),
+            label: 'Selected Generate',
+            display: { text: 'Circuit selected generate.', importance: 'major', tone: 'info' },
+            presentation: progressPresentation({
+                blockId: progress.runId,
+                statusText: 'Chose generate.',
+            }),
+            selected_flow: 'generate',
+            routed_by: 'explicit',
+            router_reason: 'explicit generate utility command',
+        });
+    }
+    try {
+        const home = customHome(args.home);
+        const relay = options.relayer ?? productionRelay;
+        // Pre-flight on an explicit --name: when the operator names the slug it is
+        // fully known before any work, so reject a reserved/malformed/already-published
+        // slug here rather than after a full propose+repair spend (create validates up
+        // front the same way). The model-chosen-id path is validated post-compose, where
+        // the slug genuinely cannot be known earlier.
+        if (args.name !== undefined) {
+            const namedSlug = slugify(args.name);
+            assertValidSlug(namedSlug);
+            if (args.publish && existsSync(join(flowRoot(home), namedSlug, 'circuit.json'))) {
+                throw new Error(`custom flow already published: ${namedSlug}`);
+            }
+        }
+        const composed = await composeCustomFlow({
+            description: args.description,
+            name: args.name,
+            relay,
+            maxRepair: args.maxRepair,
+            timeoutMs: args.timeoutMs,
+        });
+        if (!composed.ok) {
+            // Honest fail-closed: the model never produced a runnable flow. Report the
+            // reason + the verifier's last errors so the operator can retry or fall back.
+            const failure = {
+                schema_version: 1,
+                action: 'generate',
+                status: 'failed',
+                reason: composed.reason,
+                proposer_model: PROPOSER_MODEL_LABEL,
+                repair_rounds: composed.repairRounds,
+                errors: composed.errors.slice(0, 5),
+            };
+            if (progress !== undefined) {
+                progress.emit({
+                    type: 'run.completed',
+                    recorded_at: now().toISOString(),
+                    label: 'Generate failed',
+                    display: {
+                        text: `Circuit generate could not compose a runnable flow (${composed.reason}).`,
+                        importance: 'error',
+                        tone: 'error',
+                    },
+                    presentation: progressPresentation({
+                        blockId: progress.runId,
+                        statusText: `Generate failed (${composed.reason}).`,
+                    }),
+                    outcome: 'error',
+                });
+            }
+            process.stdout.write(`${JSON.stringify(failure, null, 2)}\n`);
+            return 1;
+        }
+        const slug = composed.slug;
+        if (args.publish && existsSync(join(flowRoot(home), slug, 'circuit.json'))) {
+            throw new Error(`custom flow already published: ${slug}`);
+        }
+        const createdAt = args.createdAt ?? now().toISOString();
+        writeDraft({
+            home,
+            slug,
+            description: args.description,
+            files: composed.files,
+            archetype: composed.archetype,
+            source: 'composed',
+        });
+        const status = args.publish ? 'published' : 'draft_created';
+        if (args.publish) {
+            publishDraft({ home, slug, description: args.description, createdAt });
+        }
+        const summary = summaryMarkdown({
+            slug,
+            description: args.description,
+            status,
+            home,
+            shape: composed.shape,
+            convergedRound: composed.convergedRound,
+        });
+        writeText(summaryPath(home, slug), summary);
+        const result = {
+            schema_version: 1,
+            action: 'generate',
+            status,
+            slug,
+            shape: composed.shape,
+            proposer_model: PROPOSER_MODEL_LABEL,
+            converged_round: composed.convergedRound,
+            repair_rounds: composed.repairRounds,
+            draft_path: draftRoot(home, slug),
+            validation_path: join(draftRoot(home, slug), 'validation-result.json'),
+            ...(args.publish
+                ? {
+                    published_path: publishedRoot(home, slug),
+                    flow_path: join(flowRoot(home), slug, 'circuit.json'),
+                    command_path: join(commandRoot(home), `${slug}.md`),
+                    manifest_path: manifestPath(home),
+                }
+                : {}),
+            operator_summary_markdown_path: summaryPath(home, slug),
+        };
+        const outPath = resultPath(home, slug, 'generate');
+        writeJson(outPath, result);
+        const finalResult = { ...result, result_path: outPath };
+        if (progress !== undefined) {
+            progress.emit({
+                type: 'run.completed',
+                recorded_at: now().toISOString(),
+                label: 'Generate completed',
+                display: {
+                    text: `Circuit generate ${status === 'published' ? 'published' : 'drafted'} ${slug}.`,
+                    importance: 'major',
+                    tone: 'success',
+                },
+                presentation: progressPresentation({
+                    blockId: progress.runId,
+                    statusText: `Generate ${status === 'published' ? 'published' : 'drafted'} ${slug}.`,
+                }),
+                outcome: 'complete',
+                result_path: outPath,
+            });
+        }
+        process.stdout.write(`${JSON.stringify(finalResult, null, 2)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/generate.js.map

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

package/dist/cli/handoff-codex-hooks.d.ts

@@ -0,0 +1,25 @@
+export type HandoffHookHost = 'codex';
+export type HandoffHooksAction = 'install' | 'uninstall' | 'doctor';
+/** The slice of the handoff CLI arguments the Codex hooks domain reads. */
+export interface CodexHooksArgs {
+    readonly hooksAction?: HandoffHooksAction;
+    readonly host?: string;
+    readonly hooksFile?: string;
+    readonly launcher?: string;
+}
+export declare function resolveDefaultLauncher(pluginRoot: string | undefined, moduleDir: string): string;
+export declare function missingDefaultLauncherMessage(launcher: string): string;
+export declare function runHandoffHooksCommand(args: CodexHooksArgs): unknown;
+export interface CodexInstallAssuranceInput {
+    readonly projectRoot: string;
+    readonly hooksFile?: string;
+    readonly controlPlane?: string;
+    readonly now?: () => Date;
+}
+export interface CodexInstallAssuranceResult {
+    readonly status: 'ok' | 'nudge' | 'already_nudged' | 'reinstall_nudge' | 'already_reinstall_nudged';
+    readonly notice?: string;
+    readonly marker_path: string;
+}
+export declare function codexInstallAssurance(input: CodexInstallAssuranceInput): CodexInstallAssuranceResult;
+//# sourceMappingURL=handoff-codex-hooks.d.ts.map

package/dist/cli/handoff-codex-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-codex-hooks.d.ts","sourceRoot":"","sources":["../../src/cli/handoff-codex-hooks.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC;AACtC,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAoBD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKhG;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAwaD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAKpE;AA0GD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EACX,IAAI,GACJ,OAAO,GACP,gBAAgB,GAChB,iBAAiB,GACjB,0BAA0B,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,2BAA2B,CAiC7B"}