@petepetrash/circuit 0.1.0

package/dist/cli/custom-flow-package.d.ts

@@ -0,0 +1,62 @@
+import type { CompiledFlowFile } from '../flows/compiled-flow-file-plan.js';
+import { CompiledFlow } from '../schemas/compiled-flow.js';
+export declare const RESERVED_FLOW_IDS: Set<string>;
+export declare function slugify(value: string): string;
+export declare function assertValidSlug(slug: string): void;
+export declare function customHome(home: string | undefined): string;
+export declare function draftRoot(home: string, slug: string): string;
+export declare function publishedRoot(home: string, slug: string): string;
+export declare function flowRoot(home: string): string;
+export declare function customFlowInvocation(slug: string, home: string): string;
+export declare function commandRoot(home: string): string;
+export declare function reportsRoot(home: string): string;
+export declare function manifestPath(home: string): string;
+export declare function resultPath(home: string, slug: string, action: 'create' | 'generate'): string;
+export declare function summaryPath(home: string, slug: string): string;
+export declare function writeText(path: string, text: string): void;
+export declare function writeJson(path: string, value: unknown): void;
+export declare function validateCustomFlow(slug: string, flow: CompiledFlow, source: string): void;
+export declare function mainFlowOf(files: readonly CompiledFlowFile[]): CompiledFlow;
+export interface CustomFlowArchetype {
+    readonly family: string;
+    readonly composition: string;
+    readonly signals_used: readonly string[];
+}
+export declare function publishManifest(input: {
+    readonly home: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly createdAt: string;
+    readonly filenames: readonly string[];
+}): void;
+export declare function writeValidationResult(input: {
+    readonly home: string;
+    readonly slug: string;
+    readonly flow: CompiledFlow;
+    readonly source: 'template' | 'composed' | 'draft';
+    readonly files: readonly CompiledFlowFile[];
+    readonly archetype: CustomFlowArchetype;
+}): void;
+export declare function readDraftMetadata(home: string, slug: string): {
+    filenames: readonly string[];
+    archetype: CustomFlowArchetype;
+};
+export declare function writeDraft(input: {
+    readonly home: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly files: readonly CompiledFlowFile[];
+    readonly archetype: CustomFlowArchetype;
+    readonly source?: 'template' | 'composed';
+}): void;
+export declare function loadDraftFlow(home: string, slug: string): {
+    files: CompiledFlowFile[];
+    mainFlow: CompiledFlow;
+};
+export declare function publishDraft(input: {
+    readonly home: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly createdAt: string;
+}): void;
+//# sourceMappingURL=custom-flow-package.d.ts.map

package/dist/cli/custom-flow-package.d.ts.map

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

package/dist/cli/custom-flow-package.js

@@ -0,0 +1,294 @@
+// Shared custom-flow package machinery: the publish tail.
+//
+// A custom flow reaches disk in two steps: a PRODUCER turns a task into the
+// compiled-flow files, then this module's PUBLISH TAIL writes those files into a
+// draft, optionally publishes the draft to the host-visible locations, and keeps
+// the manifest the runtime trust gate path-matches.
+//
+// Two producers share this one tail:
+//   - `circuit create` INSTANTIATES a family template (assembleCustomFlow).
+//   - `circuit generate` genuinely COMPOSES a flow block by block from a role set
+//     (proposeFlow -> composeFlow -> compile).
+//
+// Everything here is producer-agnostic: it takes a list of compiled-flow files
+// plus an archetype descriptor (legibility metadata) and lays them out. The
+// per-command pieces that DIFFER — the producer itself and the operator summary
+// (create describes an archetype family; generate describes a composed shape) —
+// stay in create.ts and generate.ts.
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { validateCompiledFlowKindPolicy } from '../flows/canonical-stage-policy.js';
+import { catalogFlowIds } from '../flows/catalog.js';
+import { CompiledFlow } from '../schemas/compiled-flow.js';
+import { CustomFlowPackageDescriptor } from '../schemas/custom-flow-descriptor.js';
+import { CLI_COMMAND_NAMES } from './command-vocabulary.js';
+// Custom flow slugs may not collide with any id the engine already owns.
+// The reserved set is the union of every catalog flow id and every
+// top-level CLI command word, derived at module load so a new flow or
+// command is reserved automatically.
+export const RESERVED_FLOW_IDS = new Set([...catalogFlowIds, ...CLI_COMMAND_NAMES]);
+export function slugify(value) {
+    const slug = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 48)
+        .replace(/-+$/g, '');
+    return slug.length > 0 ? slug : `custom-${randomUUID().slice(0, 8)}`;
+}
+export function assertValidSlug(slug) {
+    if (!/^[a-z][a-z0-9-]*$/.test(slug)) {
+        throw new Error(`custom flow name must be lowercase kebab-case: ${slug}`);
+    }
+    if (RESERVED_FLOW_IDS.has(slug)) {
+        throw new Error(`custom flow name '${slug}' is reserved by Circuit`);
+    }
+}
+export function customHome(home) {
+    return resolve(home ?? join(homedir(), '.config', 'circuit', 'custom'));
+}
+export function draftRoot(home, slug) {
+    return join(home, 'drafts', slug);
+}
+export function publishedRoot(home, slug) {
+    return join(home, 'skills', slug);
+}
+export function flowRoot(home) {
+    return join(home, 'flows');
+}
+export function customFlowInvocation(slug, home) {
+    return `circuit run ${slug} --flow-root '${flowRoot(home)}' --goal '<task>' --progress jsonl`;
+}
+export function commandRoot(home) {
+    return join(home, 'commands');
+}
+export function reportsRoot(home) {
+    return join(home, 'reports');
+}
+export function manifestPath(home) {
+    return join(home, 'manifest.json');
+}
+export function resultPath(home, slug, action) {
+    return join(reportsRoot(home), `${slug}-${action}-result.json`);
+}
+export function summaryPath(home, slug) {
+    return join(reportsRoot(home), `${slug}-operator-summary.md`);
+}
+export function writeText(path, text) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, text.endsWith('\n') ? text : `${text}\n`);
+}
+export function writeJson(path, value) {
+    writeText(path, JSON.stringify(value, null, 2));
+}
+export function validateCustomFlow(slug, flow, source) {
+    if (flow.id !== slug) {
+        throw new Error(`custom flow draft id '${flow.id}' does not match expected name '${slug}'`);
+    }
+    const policy = validateCompiledFlowKindPolicy(flow);
+    if (!policy.ok) {
+        throw new Error(`${source} validation failed: ${policy.reason}`);
+    }
+}
+export function mainFlowOf(files) {
+    const main = files.find((file) => file.filename === 'circuit.json');
+    if (main === undefined)
+        throw new Error('custom flow package has no circuit.json');
+    return main.flow;
+}
+function skillMarkdown(slug, description, home) {
+    return [
+        '---',
+        `name: ${slug}`,
+        `description: ${description.replace(/\n/g, ' ')}`,
+        '---',
+        '',
+        `# ${slug}`,
+        '',
+        description,
+        '',
+        '## Run',
+        '',
+        'This custom flow is already routed when invoked directly. Do not bounce it through `/circuit:run`.',
+        '',
+        '```bash',
+        customFlowInvocation(slug, home),
+        '```',
+    ].join('\n');
+}
+function circuitYaml(slug, description) {
+    return [
+        'schema_version: 1',
+        `id: ${slug}`,
+        'format: compiled-flow-package',
+        'compiled_flow: circuit.json',
+        'purpose: |',
+        `  ${description.replace(/\n/g, '\n  ')}`,
+    ].join('\n');
+}
+function validateCircuitYamlDescriptor(text, sourcePath, expectedSlug) {
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (err) {
+        throw new Error(`custom flow descriptor YAML parse failed at ${sourcePath}: ${err.message}`);
+    }
+    let descriptor;
+    try {
+        descriptor = CustomFlowPackageDescriptor.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`custom flow descriptor validation failed at ${sourcePath}: ${err.message}`);
+    }
+    if (descriptor.id !== expectedSlug) {
+        throw new Error(`custom flow descriptor validation failed at ${sourcePath}: descriptor id '${descriptor.id}' does not match custom flow '${expectedSlug}'`);
+    }
+}
+function commandMarkdown(slug, description, home) {
+    return [
+        '---',
+        `description: Runs the ${slug} custom flow.`,
+        'argument-hint: <task>',
+        '---',
+        '',
+        `# /circuit:${slug}`,
+        '',
+        description,
+        '',
+        "Treat the task text as user-controlled input. Wrap it in single quotes; if it contains an apostrophe, replace each apostrophe with `'\\''` before running the command.",
+        '',
+        '```bash',
+        customFlowInvocation(slug, home),
+        '```',
+    ].join('\n');
+}
+export function publishManifest(input) {
+    let existing = {
+        schema_version: 1,
+        custom_flows: [],
+    };
+    if (existsSync(manifestPath(input.home))) {
+        existing = JSON.parse(readFileSync(manifestPath(input.home), 'utf8'));
+    }
+    const withoutSlug = existing.custom_flows.filter((flow) => !(typeof flow === 'object' && flow !== null && 'id' in flow && flow.id === input.slug));
+    // The manifest entry records IDENTITY, not "what shape this is". The chosen
+    // archetype family is legibility metadata, so it lives in the draft's
+    // validation-result.json + the operator summary — never on the descriptor the
+    // runtime trusts. The runtime resolves by slug -> flow_path (the default mode)
+    // and loads per-mode siblings by disk presence. flow_paths names exactly which
+    // compiled-flow files this flow published (circuit.json + any <mode>.json
+    // siblings) so the trust gate can bless the per-mode siblings the loader serves.
+    writeJson(manifestPath(input.home), {
+        schema_version: 1,
+        custom_flows: [
+            ...withoutSlug,
+            {
+                id: input.slug,
+                description: input.description,
+                flow_path: join(flowRoot(input.home), input.slug, 'circuit.json'),
+                flow_paths: input.filenames.map((filename) => join(flowRoot(input.home), input.slug, filename)),
+                skill_path: join(publishedRoot(input.home, input.slug), 'SKILL.md'),
+                command_path: join(commandRoot(input.home), `${input.slug}.md`),
+                published_at: input.createdAt,
+            },
+        ],
+    });
+}
+export function writeValidationResult(input) {
+    writeJson(join(draftRoot(input.home, input.slug), 'validation-result.json'), {
+        schema_version: 1,
+        status: 'valid',
+        validated_flow_id: input.flow.id,
+        source: input.source,
+        // The compiled-flow files this package owns ([circuit.json, <mode>.json...]).
+        // publish-from-draft copies and re-validates exactly this set.
+        flow_files: input.files.map((file) => file.filename),
+        archetype: input.archetype.family,
+        composition: input.archetype.composition,
+        signals_used: input.archetype.signals_used,
+    });
+}
+// Recover the file list + archetype facts a draft recorded. Falls back to a
+// single circuit.json for drafts written before this field existed.
+export function readDraftMetadata(home, slug) {
+    const raw = JSON.parse(readFileSync(join(draftRoot(home, slug), 'validation-result.json'), 'utf8'));
+    const filenames = Array.isArray(raw.flow_files) && raw.flow_files.every((f) => typeof f === 'string')
+        ? raw.flow_files
+        : ['circuit.json'];
+    return {
+        filenames,
+        archetype: {
+            family: typeof raw.archetype === 'string' ? raw.archetype : 'build',
+            composition: typeof raw.composition === 'string' ? raw.composition : 'instantiated',
+            signals_used: Array.isArray(raw.signals_used)
+                ? raw.signals_used.filter((s) => typeof s === 'string')
+                : [],
+        },
+    };
+}
+export function writeDraft(input) {
+    const source = input.source ?? 'template';
+    const root = draftRoot(input.home, input.slug);
+    rmSync(root, { recursive: true, force: true });
+    mkdirSync(root, { recursive: true });
+    const descriptor = circuitYaml(input.slug, input.description);
+    validateCircuitYamlDescriptor(descriptor, join(root, 'circuit.yaml'), input.slug);
+    writeText(join(root, 'SKILL.md'), skillMarkdown(input.slug, input.description, input.home));
+    writeText(join(root, 'circuit.yaml'), descriptor);
+    for (const { filename, flow } of input.files) {
+        writeJson(join(root, filename), flow);
+    }
+    writeText(join(root, 'command.md'), commandMarkdown(input.slug, input.description, input.home));
+    writeValidationResult({
+        home: input.home,
+        slug: input.slug,
+        flow: mainFlowOf(input.files),
+        source,
+        files: input.files,
+        archetype: input.archetype,
+    });
+}
+// Load + re-validate every compiled-flow file a draft owns. Returns the file
+// list (so publish can copy exactly them) and the main (circuit.json) flow.
+export function loadDraftFlow(home, slug) {
+    const { filenames } = readDraftMetadata(home, slug);
+    const files = filenames.map((filename) => {
+        const path = join(draftRoot(home, slug), filename);
+        const flow = CompiledFlow.parse(JSON.parse(readFileSync(path, 'utf8')));
+        validateCustomFlow(slug, flow, `custom flow draft (${filename})`);
+        return { filename, flow };
+    });
+    return { files, mainFlow: mainFlowOf(files) };
+}
+export function publishDraft(input) {
+    const draft = draftRoot(input.home, input.slug);
+    if (!existsSync(join(draft, 'SKILL.md'))) {
+        throw new Error(`draft missing for ${input.slug}: ${draft}`);
+    }
+    const descriptor = readFileSync(join(draft, 'circuit.yaml'), 'utf8');
+    validateCircuitYamlDescriptor(descriptor, join(draft, 'circuit.yaml'), input.slug);
+    const { filenames } = readDraftMetadata(input.home, input.slug);
+    const skillRoot = publishedRoot(input.home, input.slug);
+    const customFlowRoot = join(flowRoot(input.home), input.slug);
+    // Clear the target first so a stale <mode>.json sibling from an earlier publish
+    // (or a crash mid-publish) cannot survive and be served by the loader. The
+    // publish then writes exactly the files this draft owns. (writeDraft does the
+    // same for the draft directory.)
+    rmSync(customFlowRoot, { recursive: true, force: true });
+    mkdirSync(skillRoot, { recursive: true });
+    mkdirSync(customFlowRoot, { recursive: true });
+    writeText(join(skillRoot, 'SKILL.md'), readFileSync(join(draft, 'SKILL.md'), 'utf8'));
+    writeText(join(skillRoot, 'circuit.yaml'), descriptor);
+    // Copy every compiled-flow file the draft owns: circuit.json (default mode)
+    // plus any <mode>.json siblings produced by a per-mode family.
+    for (const filename of filenames) {
+        writeText(join(customFlowRoot, filename), readFileSync(join(draft, filename), 'utf8'));
+    }
+    writeText(join(commandRoot(input.home), `${input.slug}.md`), readFileSync(join(draft, 'command.md'), 'utf8'));
+    publishManifest({ ...input, filenames });
+}
+//# sourceMappingURL=custom-flow-package.js.map

package/dist/cli/custom-flow-package.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,9 @@
+import { type ConnectorHealthCheck } from '../connectors/health.js';
+import { type TerminalPalette } from './terminal-style.js';
+export interface DoctorConnectorEntry extends ConnectorHealthCheck {
+    readonly chosen: boolean;
+    readonly chosen_by: readonly string[];
+}
+export declare function renderDoctorReport(palette: TerminalPalette, entries: readonly DoctorConnectorEntry[]): string;
+export declare function runDoctorCommand(argv: readonly string[]): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EAAE,KAAK,eAAe,EAAiC,MAAM,qBAAqB,CAAC;AAuB1F,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAIhE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAIzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAiDD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,SAAS,oBAAoB,EAAE,GACvC,MAAM,CA8BR;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsD/E"}

package/dist/cli/doctor.js

@@ -0,0 +1,147 @@
+// `circuit doctor` — a readiness report for the connectors your runs would
+// actually use.
+//
+// A run that relays through a broken or signed-out connector CLI dies
+// mid-flight, after real spend on the branches that were healthy. Doctor
+// probes the same binaries a run would spawn (a version call for presence, a
+// status call for sign-in where the CLI has one) and answers in plain English
+// with a fix per connector. It grades readiness against the CHOSEN connector
+// set — the connectors at least one public flow's relay step would actually
+// dispatch through, under the operator's config and host kind — so a fresh
+// machine that only has claude-code installed reads Ready, not a false alarm
+// about codex and cursor-agent no flow would choose. Unchosen connectors
+// still get probed and reported, but only informationally: their state never
+// affects the exit code.
+import { Command } from 'commander';
+import { probeBuiltinConnectors, probeCustomConnectorPresence, } from '../connectors/health.js';
+import { discoverRuntimeConfigLayers } from '../shared/config-loader.js';
+import { resolveChosenConnectors } from './chosen-connectors.js';
+import { commanderErrorMessage, configureCommanderProgram } from './commander-support.js';
+import { hostKindFromEnv } from './preview.js';
+import { cell, columnHeader, diamondHeaderLine, renderStyledTable } from './styled-table.js';
+import { colorEnabled, terminalPalette } from './terminal-style.js';
+function parseDoctorArgs(argv) {
+    let options;
+    const program = configureCommanderProgram(new Command('circuit doctor'))
+        .option('--json')
+        .allowExcessArguments(false)
+        .action(() => {
+        options = program.opts();
+    });
+    try {
+        program.parse(argv, { from: 'user' });
+    }
+    catch (err) {
+        return commanderErrorMessage(err);
+    }
+    if (options === undefined)
+        return 'doctor could not parse its arguments';
+    return { json: options.json === true };
+}
+const STATE_LABELS = {
+    ok: 'ok',
+    needs_attention: 'needs attention',
+    unknown: 'could not check',
+};
+function statePaint(palette, state) {
+    if (state === 'ok')
+        return palette.accent;
+    if (state === 'needs_attention')
+        return palette.warn;
+    return palette.dim;
+}
+function connectorRows(palette, entries) {
+    const rows = [];
+    for (const entry of entries) {
+        rows.push([
+            cell(entry.connector, entry.chosen ? palette.bold : undefined),
+            entry.chosen ? cell(entry.chosen_by.join(', '), palette.accent) : cell('-', palette.dim),
+            cell(STATE_LABELS[entry.state], statePaint(palette, entry.state)),
+            cell(entry.detail, entry.chosen ? undefined : palette.dim),
+        ]);
+        if (entry.remediation !== undefined) {
+            rows.push([cell(''), cell(''), cell(''), cell(entry.remediation, palette.dim)]);
+        }
+    }
+    return rows;
+}
+function brokenChosenNames(entries) {
+    return entries
+        .filter((entry) => entry.chosen && entry.state === 'needs_attention')
+        .map((entry) => entry.connector);
+}
+function verdictLine(palette, entries) {
+    const broken = brokenChosenNames(entries);
+    if (broken.length === 0)
+        return palette.bold(palette.accent('Ready.'));
+    const noun = broken.length === 1 ? 'connector needs' : 'connectors need';
+    return palette.bold(palette.warn(`Not ready: ${broken.join(', ')} ${noun} attention.`));
+}
+export function renderDoctorReport(palette, entries) {
+    // One table, chosen connectors first (Array.prototype.sort is stable, so
+    // the probe order survives within each group). The CHOSEN BY column is
+    // both the chosen/unchosen split and the teaching surface: it names the
+    // exact resolution source behind every decision, and `-` marks a connector
+    // no flow would dispatch through.
+    const ordered = [...entries].sort((a, b) => Number(b.chosen) - Number(a.chosen));
+    return [
+        diamondHeaderLine(palette, 'circuit doctor'),
+        '',
+        verdictLine(palette, entries),
+        '',
+        renderStyledTable(palette, [
+            columnHeader(palette, ['CONNECTOR', 'CHOSEN BY', 'STATE', 'DETAIL']),
+            'rule',
+            ...connectorRows(palette, ordered),
+        ]),
+        '',
+        palette.dim('connectors marked - are optional (no flow step chooses them) and never fail this check. to change:'),
+        // Remedies must work when pasted: relay.roles.* and relay.flows.* take
+        // connector reference objects, so the role/flow lever shows the
+        // inline-YAML object form a bare name would fail.
+        palette.dim('  circuit config set relay.default codex'),
+        palette.dim("  circuit config set relay.roles.reviewer '{kind: builtin, name: codex}'   (also: relay.flows.<flow>; check with: circuit preview)"),
+    ].join('\n');
+}
+export async function runDoctorCommand(argv) {
+    const parsed = parseDoctorArgs(argv);
+    if (typeof parsed === 'string') {
+        process.stderr.write(`error: ${parsed}\n`);
+        return 2;
+    }
+    const configLayers = discoverRuntimeConfigLayers({}).selectionConfigLayers;
+    const hostKind = hostKindFromEnv();
+    const chosen = resolveChosenConnectors({
+        configLayers,
+        ...(hostKind === undefined ? {} : { hostKind }),
+    });
+    const builtinChecks = await probeBuiltinConnectors();
+    const customChecks = await Promise.all([...chosen.custom.values()].map((descriptor) => probeCustomConnectorPresence(descriptor.name, descriptor.command[0])));
+    const entries = [
+        ...builtinChecks.map((check) => ({
+            ...check,
+            chosen: chosen.names.has(check.connector),
+            chosen_by: chosen.sources.get(check.connector) ?? [],
+        })),
+        ...customChecks.map((check) => ({
+            ...check,
+            chosen: true,
+            chosen_by: chosen.sources.get(check.connector) ?? [],
+        })),
+    ];
+    const ready = brokenChosenNames(entries).length === 0;
+    if (parsed.json) {
+        process.stdout.write(`${JSON.stringify({
+            schema_version: 2,
+            ready,
+            chosen_connectors: [...chosen.names].sort(),
+            connectors: entries,
+        }, null, 2)}\n`);
+    }
+    else {
+        const palette = terminalPalette(colorEnabled());
+        process.stdout.write(`${renderDoctorReport(palette, entries)}\n`);
+    }
+    return ready ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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