@petepetrash/circuit 0.1.0

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

@@ -0,0 +1,186 @@
+// Review intake compose writer.
+//
+// Emits the requested review scope plus the local working-tree evidence the
+// reviewer needs to audit current changes. The CLI supplies projectRoot from
+// its cwd, so Codex/Claude/generic-shell hosts all collect the same evidence
+// before the reviewer relay is called.
+import { spawnSync } from 'node:child_process';
+import { closeSync, lstatSync, openSync, readSync } from 'node:fs';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { projectReviewIntake } from './intake-projection.js';
+const MAX_DIFF_CHARS = 120_000;
+const MAX_UNTRACKED_FILES = 20;
+const MAX_UNTRACKED_FILE_CHARS = 20_000;
+const MAX_GIT_BUFFER_BYTES = 10 * 1024 * 1024;
+const MAX_DIFF_BUFFER_BYTES = Math.max(MAX_DIFF_CHARS * 4, 1024 * 1024);
+const MAX_UNTRACKED_FILE_BYTES = MAX_UNTRACKED_FILE_CHARS + 1;
+function truncateText(text, maxChars) {
+    if (text.length <= maxChars)
+        return { text, truncated: false };
+    return {
+        text: `${text.slice(0, maxChars)}\n[truncated ${text.length - maxChars} characters]`,
+        truncated: true,
+    };
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function outputToString(output) {
+    if (output === null || output === undefined)
+        return '';
+    if (typeof output === 'string')
+        return output;
+    return Buffer.from(output).toString('utf8');
+}
+function runGit(projectRoot, args, options = {}) {
+    const result = spawnSync('git', [...args], {
+        cwd: projectRoot,
+        encoding: 'utf8',
+        maxBuffer: options.maxBufferBytes ?? MAX_GIT_BUFFER_BYTES,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    const stdout = outputToString(result.stdout);
+    const stderr = outputToString(result.stderr).trim();
+    if (result.error !== undefined) {
+        if (options.allowPartialStdout === true && stdout.length > 0) {
+            return { ok: true, stdout, truncated_by_buffer: true };
+        }
+        return { ok: false, reason: `git ${args.join(' ')} failed: ${result.error.message}` };
+    }
+    if (result.status !== 0) {
+        const reason = stderr.length > 0 ? stderr : `exited with status ${result.status ?? 'unknown'}`;
+        return { ok: false, reason: `git ${args.join(' ')} failed: ${reason}` };
+    }
+    return { ok: true, stdout, truncated_by_buffer: false };
+}
+function runGitDiff(projectRoot, args) {
+    const result = runGit(projectRoot, args, {
+        maxBufferBytes: MAX_DIFF_BUFFER_BYTES,
+        allowPartialStdout: true,
+    });
+    if (!result.ok)
+        return truncateText(result.reason, MAX_DIFF_CHARS);
+    if (!result.truncated_by_buffer)
+        return truncateText(result.stdout, MAX_DIFF_CHARS);
+    const truncated = truncateText(result.stdout, MAX_DIFF_CHARS);
+    return {
+        text: `${truncated.text}\n[truncated because git output exceeded ${MAX_DIFF_BUFFER_BYTES} bytes before completion]`,
+        truncated: true,
+    };
+}
+function insideProject(projectRoot, path) {
+    const rel = relative(projectRoot, path);
+    return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
+}
+function readUntrackedFile(projectRoot, path, contentPolicy) {
+    const abs = resolve(projectRoot, path);
+    if (!insideProject(projectRoot, abs)) {
+        return { path, byte_length: 0, skipped_reason: 'path resolves outside project root' };
+    }
+    let stat;
+    try {
+        stat = lstatSync(abs);
+    }
+    catch (err) {
+        return { path, byte_length: 0, skipped_reason: `failed to inspect file: ${errorMessage(err)}` };
+    }
+    if (stat.isSymbolicLink()) {
+        return { path, byte_length: stat.size, skipped_reason: 'symbolic link skipped' };
+    }
+    if (!stat.isFile()) {
+        return { path, byte_length: stat.size, skipped_reason: 'not a regular file' };
+    }
+    if (contentPolicy === 'metadata-only') {
+        return { path, byte_length: stat.size };
+    }
+    let fd;
+    try {
+        const byteLimit = Math.min(stat.size, MAX_UNTRACKED_FILE_BYTES);
+        fd = openSync(abs, 'r');
+        const bytes = Buffer.alloc(byteLimit);
+        const bytesRead = readSync(fd, bytes, 0, byteLimit, 0);
+        const sample = bytes.subarray(0, bytesRead);
+        if (sample.includes(0)) {
+            return { path, byte_length: stat.size, skipped_reason: 'binary file skipped' };
+        }
+        const content = truncateText(sample.toString('utf8'), MAX_UNTRACKED_FILE_CHARS);
+        return {
+            path,
+            byte_length: stat.size,
+            content: stat.size > bytesRead && !content.truncated ? { ...content, truncated: true } : content,
+        };
+    }
+    catch (err) {
+        return {
+            path,
+            byte_length: stat.size,
+            skipped_reason: `failed to read file: ${errorMessage(err)}`,
+        };
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+            }
+            catch {
+                // The evidence entry above is still useful even if closing a skipped
+                // file descriptor fails after the read attempt.
+            }
+        }
+    }
+}
+function collectUntrackedFiles(projectRoot, contentPolicy) {
+    const listed = runGit(projectRoot, ['ls-files', '--others', '--exclude-standard', '-z']);
+    if (!listed.ok)
+        return { count: 0, truncated: false, files: [] };
+    const paths = listed.stdout.split('\0').filter((path) => path.length > 0);
+    return {
+        count: paths.length,
+        truncated: paths.length > MAX_UNTRACKED_FILES,
+        files: paths
+            .slice(0, MAX_UNTRACKED_FILES)
+            .map((path) => readUntrackedFile(projectRoot, path, contentPolicy)),
+    };
+}
+function collectReviewEvidence(projectRoot, options = {}) {
+    if (projectRoot === undefined) {
+        return {
+            kind: 'unavailable',
+            reason: 'CompiledFlowInvocation.projectRoot was not provided',
+        };
+    }
+    const status = runGit(projectRoot, ['status', '--short']);
+    if (!status.ok)
+        return { kind: 'unavailable', reason: status.reason };
+    const staged = runGitDiff(projectRoot, ['diff', '--cached', '--no-ext-diff', '--']);
+    const unstaged = runGitDiff(projectRoot, ['diff', '--no-ext-diff', '--']);
+    const diffStat = runGit(projectRoot, ['diff', '--stat', '--cached', '--no-ext-diff']);
+    const untrackedContentPolicy = options.includeUntrackedFileContent === true ? 'include-content' : 'metadata-only';
+    const untracked = collectUntrackedFiles(projectRoot, untrackedContentPolicy);
+    return {
+        kind: 'git-working-tree',
+        project_root: projectRoot,
+        status_short: status.stdout,
+        staged_diff: staged,
+        unstaged_diff: unstaged,
+        diff_stat: diffStat.ok ? diffStat.stdout : diffStat.reason,
+        untracked_file_count: untracked.count,
+        untracked_files_truncated: untracked.truncated,
+        untracked_content_policy: untrackedContentPolicy,
+        untracked_files: untracked.files,
+    };
+}
+export const reviewIntakeComposeBuilder = {
+    resultSchemaName: 'review.intake@v1',
+    build(context) {
+        const evidence = collectReviewEvidence(context.projectRoot, context.evidencePolicy?.includeUntrackedFileContent === true
+            ? { includeUntrackedFileContent: true }
+            : {});
+        return projectReviewIntake({
+            scope: context.goal,
+            evidence,
+            maxUntrackedFiles: MAX_UNTRACKED_FILES,
+        });
+    },
+};
+//# sourceMappingURL=intake.js.map

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

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

package/dist/flows/review/writers/result-html.d.ts

@@ -0,0 +1,3 @@
+import type { HtmlProjector } from '../../../shared/html/projector.js';
+export declare const reviewResultProjector: HtmlProjector;
+//# sourceMappingURL=result-html.d.ts.map

package/dist/flows/review/writers/result-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-html.d.ts","sourceRoot":"","sources":["../../../../src/flows/review/writers/result-html.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAoFvE,eAAO,MAAM,qBAAqB,EAAE,aAgEnC,CAAC"}

package/dist/flows/review/writers/result-html.js

@@ -0,0 +1,78 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// Review result HTML projector.
+//
+// Rendered with the shared report components; all operator-controlled
+// strings pass through t().
+import { MAX_BULLET_LEN, MAX_PROMPT_LEN } from '../../../shared/html/page.js';
+import { t } from '../../../shared/html/react-page.js';
+import { BulletList, Chip, ReportCard, SectionLabel, Summary, VerdictBanner, renderReportPage, } from '../../../shared/html/report-components.js';
+import { ReviewResult } from '../reports.js';
+function severityIntent(severity) {
+    if (severity === 'critical' || severity === 'high')
+        return 'negative';
+    if (severity === 'medium')
+        return 'attention';
+    return 'info';
+}
+function FindingList({ findings }) {
+    if (findings.length === 0)
+        return _jsx(Summary, { text: "No actionable findings." });
+    return (_jsx("ul", { className: "m-0 list-disc space-y-1.5 pl-4 text-[13px] leading-normal marker:text-muted-foreground/60", children: findings.map((finding) => (_jsxs("li", { children: [_jsx("strong", { children: t(finding.severity.toUpperCase(), 40) }), ":", ' ', t(finding.text, MAX_BULLET_LEN), finding.file_refs.length === 0 ? null : (_jsxs(_Fragment, { children: [' ', _jsx(Chip, { text: finding.file_refs.join(', ') })] }))] }, `${finding.severity}:${finding.text}`))) }));
+}
+function StringList({ items }) {
+    if (items.length === 0)
+        return _jsx(Summary, { text: "None." });
+    return _jsx(BulletList, { items: items });
+}
+function WarningList({ warnings }) {
+    if (warnings.length === 0)
+        return _jsx(Summary, { text: "No evidence warnings." });
+    return (_jsx("ul", { className: "m-0 list-disc space-y-1.5 pl-4 text-[13px] leading-normal marker:text-muted-foreground/60", children: warnings.map((warning) => (_jsxs("li", { children: [_jsx("strong", { children: t(warning.kind, 120) }), warning.path === undefined ? null : _jsxs(_Fragment, { children: [" (", t(warning.path, MAX_BULLET_LEN), ")"] }), ":", ' ', t(warning.message, MAX_BULLET_LEN)] }, `${warning.kind}:${warning.message}`))) }));
+}
+function EvidenceSummary({ report }) {
+    const evidence = report.evidence_summary;
+    if (evidence === undefined)
+        return _jsx(Summary, { text: "No evidence summary was recorded." });
+    if (evidence.kind === 'unavailable')
+        return _jsx(Summary, { text: evidence.message });
+    const sampled = `${evidence.untracked_files_sampled}/${evidence.untracked_file_count}`;
+    const truncated = evidence.untracked_files_truncated ? 'yes' : 'no';
+    return (_jsx(BulletList, { items: [
+            `Untracked content policy: ${evidence.untracked_content_policy}`,
+            `Untracked files sampled: ${sampled}`,
+            `Untracked file list truncated: ${truncated}`,
+        ] }));
+}
+function shouldRenderHtml(report) {
+    return (report.findings.length > 0 ||
+        report.evidence_warnings.length > 0 ||
+        report.confidence_limitations.length > 0);
+}
+export const reviewResultProjector = (ctx) => {
+    const parsed = ReviewResult.safeParse(ctx.flowReport);
+    if (!parsed.success)
+        return undefined;
+    const report = parsed.data;
+    if (!shouldRenderHtml(report))
+        return undefined;
+    const worstIntent = report.findings.reduce((intent, finding) => {
+        const findingIntent = severityIntent(finding.severity);
+        if (findingIntent === 'negative')
+            return 'negative';
+        if (findingIntent === 'attention' && intent === 'positive')
+            return 'attention';
+        return intent;
+    }, report.verdict === 'CLEAN' ? 'positive' : 'attention');
+    return renderReportPage({
+        title: 'Review result',
+        metaLine: `Circuit · Review · ${ctx.runOutcome}`,
+        headline: 'Review result',
+        subtitle: report.assessment,
+        footerLeft: `Run ${ctx.runId}`,
+        footerRight: 'reports/review-result.json',
+        children: (_jsxs(_Fragment, { children: [_jsx(VerdictBanner, { intent: worstIntent, badgeText: report.verdict, main: _jsx("strong", { children: t(report.scope, MAX_PROMPT_LEN) }), aside: `${report.findings.length} finding${report.findings.length === 1 ? '' : 's'}` }), _jsxs("div", { className: "flex flex-col gap-4", children: [_jsx(ReportCard, { intent: worstIntent, eyebrow: "Findings", title: "Reviewer findings", children: _jsx(FindingList, { findings: report.findings }) }), _jsxs(ReportCard, { eyebrow: "Evidence", title: "What was checked", children: [_jsx(Summary, { text: report.assessment }), _jsxs("div", { children: [_jsx(SectionLabel, { children: "Verification" }), _jsx(StringList, { items: report.verification })] }), _jsxs("div", { children: [_jsx(SectionLabel, { children: "Confidence limits" }), _jsx(StringList, { items: report.confidence_limitations })] })] }), _jsxs(ReportCard, { eyebrow: "Caveats", title: "Evidence caveats", ...(report.evidence_warnings.length > 0
+                                ? { badge: { text: 'Scope limited', intent: 'attention' } }
+                                : {}), children: [_jsx(WarningList, { warnings: report.evidence_warnings }), _jsx(EvidenceSummary, { report: report })] })] })] })),
+    });
+};
+//# sourceMappingURL=result-html.js.map

package/dist/flows/review/writers/result-html.js.map

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

package/dist/flows/review/writers/result-projection.d.ts

@@ -0,0 +1,6 @@
+import { type ReviewIntake, type ReviewRelayResult, ReviewResult } from '../reports.js';
+export declare function projectReviewResult(input: {
+    readonly intake: ReviewIntake;
+    readonly relayResult: ReviewRelayResult;
+}): ReviewResult;
+//# sourceMappingURL=result-projection.d.ts.map

package/dist/flows/review/writers/result-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-projection.d.ts","sourceRoot":"","sources":["../../../../src/flows/review/writers/result-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,YAAY,EAEb,MAAM,eAAe,CAAC;AAevB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;CACzC,GAAG,YAAY,CAcf"}

package/dist/flows/review/writers/result-projection.js

@@ -0,0 +1,29 @@
+import { ReviewResult, computeReviewVerdict, } from '../reports.js';
+function evidenceSummary(evidence) {
+    if (evidence.kind === 'unavailable') {
+        return { kind: 'unavailable', message: evidence.reason };
+    }
+    return {
+        kind: 'git-working-tree',
+        untracked_content_policy: evidence.untracked_content_policy,
+        untracked_file_count: evidence.untracked_file_count,
+        untracked_files_sampled: evidence.untracked_files.length,
+        untracked_files_truncated: evidence.untracked_files_truncated,
+    };
+}
+export function projectReviewResult(input) {
+    const verdict = computeReviewVerdict(input.relayResult.findings);
+    const outcome = verdict === 'CLEAN' ? 'complete' : 'stopped';
+    return ReviewResult.parse({
+        scope: input.intake.scope,
+        findings: input.relayResult.findings,
+        verdict,
+        outcome,
+        assessment: input.relayResult.assessment,
+        verification: input.relayResult.verification,
+        confidence_limitations: input.relayResult.confidence_limitations,
+        evidence_summary: evidenceSummary(input.intake.evidence),
+        evidence_warnings: input.intake.evidence_warnings,
+    });
+}
+//# sourceMappingURL=result-projection.js.map

package/dist/flows/review/writers/result-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-projection.js","sourceRoot":"","sources":["../../../../src/flows/review/writers/result-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,SAAS,eAAe,CAAC,QAAwB;IAC/C,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB;QAC3D,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;QACnD,uBAAuB,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM;QACxD,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAGnC;IACC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,OAAO,YAAY,CAAC,KAAK,CAAC;QACxB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK;QACzB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ;QACpC,OAAO;QACP,OAAO;QACP,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,UAAU;QACxC,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,YAAY;QAC5C,sBAAsB,EAAE,KAAK,CAAC,WAAW,CAAC,sBAAsB;QAChE,gBAAgB,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QACxD,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB;KAClD,CAAC,CAAC;AACL,CAAC"}

package/dist/flows/review/writers/result.d.ts

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

package/dist/flows/review/writers/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../../src/flows/review/writers/result.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AAsDnD,eAAO,MAAM,0BAA0B,EAAE,cAoBxC,CAAC"}

package/dist/flows/review/writers/result.js

@@ -0,0 +1,50 @@
+// Review result compose writer.
+//
+// Reads the upstream reviewer relay's result body (NOT a typed
+// report at a known schema path — this is the relay's
+// writes.result file) and lifts findings + verdict into the canonical
+// ReviewResult report. This is the one compose writer that does
+// not consume a typed report via schema-name lookup; it consumes a
+// relay result, so the path resolver is custom.
+import { readFileSync } from 'node:fs';
+import { resolveRunRelative } from '../../../shared/run-relative-path.js';
+import { ReviewIntake, ReviewRelayResult } from '../reports.js';
+import { projectReviewResult } from './result-projection.js';
+function reviewerRelayResultPath(flow, closeStep) {
+    const closeStepId = closeStep.id;
+    const reviewerRelayes = flow.steps.filter((candidate) => candidate.kind === 'relay' &&
+        candidate.role === 'reviewer' &&
+        candidate.routes.pass === closeStepId);
+    if (reviewerRelayes.length !== 1) {
+        throw new Error(`review.result@v1 requires exactly one reviewer relay routing to '${closeStepId}', found ${reviewerRelayes.length}`);
+    }
+    const resultPath = reviewerRelayes[0]?.writes.result;
+    if (resultPath === undefined || !closeStep.reads.includes(resultPath)) {
+        throw new Error(`review.result@v1 requires close step '${closeStepId}' to read the reviewer relay result path '${resultPath ?? '<missing>'}'`);
+    }
+    return resultPath;
+}
+function reviewIntakePath(flow, closeStep) {
+    const closeStepId = closeStep.id;
+    const intakeStep = flow.steps.find((candidate) => candidate.kind === 'compose' &&
+        candidate.writes.report.schema === 'review.intake@v1' &&
+        closeStep.reads.includes(candidate.writes.report.path));
+    const path = intakeStep?.writes.report.path;
+    if (path === undefined) {
+        throw new Error(`review.result@v1 requires close step '${closeStepId}' to read the review intake report`);
+    }
+    return path;
+}
+export const reviewResultComposeBuilder = {
+    resultSchemaName: 'review.result@v1',
+    // No declarative reads — the read is a relay result body, not a
+    // typed report at a schema-mapped path. The build function does
+    // its own resolution.
+    build(context) {
+        const path = reviewerRelayResultPath(context.flow, context.step);
+        const intake = ReviewIntake.parse(JSON.parse(readFileSync(resolveRunRelative(context.runFolder, reviewIntakePath(context.flow, context.step)), 'utf8')));
+        const relayResult = ReviewRelayResult.parse(JSON.parse(readFileSync(resolveRunRelative(context.runFolder, path), 'utf8')));
+        return projectReviewResult({ intake, relayResult });
+    },
+};
+//# sourceMappingURL=result.js.map

package/dist/flows/review/writers/result.js.map

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

package/dist/flows/runtime-proof/assembly-spec.d.ts

@@ -0,0 +1,5 @@
+import type { FlowSchematicAssemblySpec } from '../assemble-flow-schematic.js';
+import type { BlockStepUse } from '../block-step-expansion.js';
+export declare const runtimeProofBlockItems: readonly BlockStepUse[];
+export declare const runtimeProofAssemblySpec: FlowSchematicAssemblySpec;
+//# sourceMappingURL=assembly-spec.d.ts.map

package/dist/flows/runtime-proof/assembly-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly-spec.d.ts","sourceRoot":"","sources":["../../../src/flows/runtime-proof/assembly-spec.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,yBAAyB,EAAiB,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAO/D,eAAO,MAAM,sBAAsB,EAAE,SAAS,YAAY,EA2BzD,CAAC;AAOF,eAAO,MAAM,wBAAwB,EAAE,yBAkBtC,CAAC"}

package/dist/flows/runtime-proof/assembly-spec.js

@@ -0,0 +1,54 @@
+const RUNTIME_PROOF_STAGE_PATH_RATIONALE = 'Runtime Proof is a narrow proof flow; only plan and act are needed to exercise compose and relay through the runtime boundary.';
+// Runtime Proof's full block sequence, in route order. It touches only the plan
+// and act canonical stages.
+export const runtimeProofBlockItems = [
+    {
+        id: 'compose-step',
+        title: 'Compose runtime proof report',
+        stage: 'plan',
+        block: 'plan',
+        input: { brief: 'flow.brief@v1' },
+        execution: { kind: 'compose' },
+        protocol: 'runtime-proof-compose@v1',
+        reportPath: 'reports/compose.json',
+        required: ['summary'],
+        routes: { continue: 'relay-step' },
+    },
+    {
+        id: 'relay-step',
+        title: 'Relay dry-run connector',
+        stage: 'act',
+        block: 'act',
+        input: { brief: 'flow.brief@v1', plan: 'plan.strategy@v1' },
+        execution: { kind: 'relay', role: 'implementer' },
+        protocol: 'runtime-proof-relay@v1',
+        requestPath: 'reports/relay.request.json',
+        receiptPath: 'reports/relay.receipt.json',
+        resultPath: 'reports/relay.result.json',
+        pass: ['ok'],
+        routes: { continue: '@complete' },
+    },
+];
+const runtimeProofStageLabels = {
+    plan: { id: 'plan-stage', title: 'Plan' },
+    act: { id: 'act-stage', title: 'Act' },
+};
+export const runtimeProofAssemblySpec = {
+    id: 'runtime-proof',
+    title: 'Runtime Proof Schematic',
+    purpose: 'Runtime Proof flow: exercise one compose step and one relay step end-to-end so the runtime boundary can be observed closing a real run.',
+    status: 'active',
+    version: '0.1.0',
+    initial_contracts: ['flow.brief@v1'],
+    contract_aliases: [],
+    axes: {
+        allowed_depths: ['medium'],
+        supports_tournament: false,
+        supports_autonomous: false,
+        default: { depth: 'medium', tournament: false, tournament_n: 3, autonomous: false },
+    },
+    items: runtimeProofBlockItems,
+    stageLabels: runtimeProofStageLabels,
+    stagePathRationale: RUNTIME_PROOF_STAGE_PATH_RATIONALE,
+};
+//# sourceMappingURL=assembly-spec.js.map

package/dist/flows/runtime-proof/assembly-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly-spec.js","sourceRoot":"","sources":["../../../src/flows/runtime-proof/assembly-spec.ts"],"names":[],"mappings":"AAgBA,MAAM,kCAAkC,GACtC,gIAAgI,CAAC;AAEnI,gFAAgF;AAChF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,sBAAsB,GAA4B;IAC7D;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,8BAA8B;QACrC,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACjC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC9B,QAAQ,EAAE,0BAA0B;QACpC,UAAU,EAAE,sBAAsB;QAClC,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;KACnC;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,yBAAyB;QAChC,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE;QAC3D,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE;QACjD,QAAQ,EAAE,wBAAwB;QAClC,WAAW,EAAE,4BAA4B;QACzC,WAAW,EAAE,4BAA4B;QACzC,UAAU,EAAE,2BAA2B;QACvC,IAAI,EAAE,CAAC,IAAI,CAAC;QACZ,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE;KAClC;CACF,CAAC;AAEF,MAAM,uBAAuB,GAAkB;IAC7C,IAAI,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE;IACzC,GAAG,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAA8B;IACjE,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,yBAAyB;IAChC,OAAO,EACL,yIAAyI;IAC3I,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,OAAO;IAChB,iBAAiB,EAAE,CAAC,eAAe,CAAC;IACpC,gBAAgB,EAAE,EAAE;IACpB,IAAI,EAAE;QACJ,cAAc,EAAE,CAAC,QAAQ,CAAC;QAC1B,mBAAmB,EAAE,KAAK;QAC1B,mBAAmB,EAAE,KAAK;QAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE;KACpF;IACD,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,kBAAkB,EAAE,kCAAkC;CACvD,CAAC"}