@neurcode-ai/cli 0.10.1 → 0.14.0

package/dist/utils/path-boundary-classifier.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Deterministic, replay-safe path-boundary classification.
+ *
+ * Maps a repo-relative file path to one of a small, well-defined set of
+ * governance boundary categories (generated-code, infra, ci,
+ * dependency-manifest, sensitive). Uses ONLY pattern matching — no file I/O,
+ * no AI inference, no probabilistic scoring. Same path string → same
+ * classification across machines, runs, and CLI versions. Boundary patterns
+ * are intentionally conservative: when in doubt the classifier returns
+ * `null`, leaving the path uncategorised rather than asserting an incorrect
+ * boundary.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyPathBoundary = classifyPathBoundary;
+exports.classifyAndBucket = classifyAndBucket;
+function exact(needle) {
+    return (path) => path === needle;
+}
+function basename(needle) {
+    return (path) => path === needle || path.endsWith(`/${needle}`);
+}
+function basenameAny(needles) {
+    const set = new Set(needles);
+    return (path) => {
+        const slash = path.lastIndexOf('/');
+        const name = slash === -1 ? path : path.slice(slash + 1);
+        return set.has(name);
+    };
+}
+function suffix(needle) {
+    return (path) => path.endsWith(needle);
+}
+function suffixAny(needles) {
+    return (path) => needles.some((n) => path.endsWith(n));
+}
+function segment(needle) {
+    const fragment = `/${needle}/`;
+    return (path) => path === needle || path.startsWith(`${needle}/`) || path.includes(fragment);
+}
+function regex(pattern) {
+    return (path) => pattern.test(path);
+}
+const RULES = Object.freeze([
+    // ── Generated code ────────────────────────────────────────────────────────
+    // Detection prioritised over infra because many generated artefacts live
+    // inside infra-adjacent paths (e.g. helm template output), and the
+    // "this is generated, do not hand-edit" semantic is the stronger signal.
+    { category: 'generated-code', reasonId: 'gen.protobuf-py', reason: 'Generated protobuf (Python).', test: suffixAny(['_pb2.py', '_pb2_grpc.py']) },
+    { category: 'generated-code', reasonId: 'gen.protobuf-go', reason: 'Generated protobuf (Go).', test: suffixAny(['.pb.go', '_pb.go']) },
+    { category: 'generated-code', reasonId: 'gen.protobuf-ts', reason: 'Generated protobuf (TS/JS).', test: suffixAny(['.pb.ts', '.pb.js']) },
+    { category: 'generated-code', reasonId: 'gen.dts', reason: 'TypeScript declaration file (typically generated).', test: suffix('.d.ts') },
+    { category: 'generated-code', reasonId: 'gen.openapi-segment', reason: 'OpenAPI / Swagger generated client surface.', test: regex(/(^|\/)(openapi-generated|swagger-generated|generated-clients?)\//) },
+    { category: 'generated-code', reasonId: 'gen.generated-segment', reason: 'Conventional generated-code directory.', test: regex(/(^|\/)(__generated__|generated|gen)\//) },
+    { category: 'generated-code', reasonId: 'gen.suffix-generated', reason: 'File explicitly suffixed `.generated.*`.', test: regex(/\.generated\.[A-Za-z0-9]+$/) },
+    { category: 'generated-code', reasonId: 'gen.dist-build', reason: 'Build output directory; never hand-edit.', test: regex(/(^|\/)(dist|build|out|\.next|\.nuxt|\.svelte-kit|\.turbo|target)\//) },
+    { category: 'generated-code', reasonId: 'gen.vendor', reason: 'Vendored / installed dependency tree.', test: regex(/(^|\/)(vendor|node_modules|Pods)\//) },
+    { category: 'generated-code', reasonId: 'gen.snapshots', reason: 'Generated test snapshot.', test: regex(/(^|\/)__snapshots__\//) },
+    { category: 'generated-code', reasonId: 'gen.lockfile', reason: 'Lock file — regenerated by tooling, not hand-authored.', test: basenameAny(['package-lock.json', 'pnpm-lock.yaml', 'yarn.lock', 'Cargo.lock', 'Pipfile.lock', 'poetry.lock', 'composer.lock', 'go.sum']) },
+    // ── CI ────────────────────────────────────────────────────────────────────
+    { category: 'ci', reasonId: 'ci.github-workflows', reason: 'GitHub Actions workflow.', test: regex(/^\.github\/workflows\//) },
+    { category: 'ci', reasonId: 'ci.github-action-config', reason: 'GitHub action / repo automation config.', test: regex(/^\.github\/(actions|dependabot\.yml|CODEOWNERS)/) },
+    { category: 'ci', reasonId: 'ci.gitlab', reason: 'GitLab CI config.', test: exact('.gitlab-ci.yml') },
+    { category: 'ci', reasonId: 'ci.circleci', reason: 'CircleCI config.', test: regex(/^\.circleci\//) },
+    { category: 'ci', reasonId: 'ci.jenkins', reason: 'Jenkins pipeline.', test: basenameAny(['Jenkinsfile']) },
+    { category: 'ci', reasonId: 'ci.travis', reason: 'Travis CI config.', test: exact('.travis.yml') },
+    { category: 'ci', reasonId: 'ci.azure-pipelines', reason: 'Azure Pipelines config.', test: basenameAny(['azure-pipelines.yml']) },
+    { category: 'ci', reasonId: 'ci.drone', reason: 'Drone CI config.', test: exact('.drone.yml') },
+    { category: 'ci', reasonId: 'ci.buildkite', reason: 'Buildkite pipeline.', test: regex(/^\.buildkite\//) },
+    // ── Infra / deployment ────────────────────────────────────────────────────
+    { category: 'infra', reasonId: 'infra.dockerfile', reason: 'Docker build artefact.', test: basenameAny(['Dockerfile']) },
+    { category: 'infra', reasonId: 'infra.dockerfile-variant', reason: 'Docker build artefact (variant).', test: regex(/(^|\/)Dockerfile(\.[A-Za-z0-9._-]+)?$/) },
+    { category: 'infra', reasonId: 'infra.docker-compose', reason: 'docker-compose deployment file.', test: regex(/(^|\/)docker-compose(\.[A-Za-z0-9._-]+)?\.ya?ml$/) },
+    { category: 'infra', reasonId: 'infra.terraform', reason: 'Terraform infrastructure source.', test: regex(/(^|\/)(terraform|infra\/terraform)\//) },
+    { category: 'infra', reasonId: 'infra.terraform-suffix', reason: 'Terraform source (suffix).', test: suffix('.tf') },
+    { category: 'infra', reasonId: 'infra.helm', reason: 'Helm chart source.', test: regex(/(^|\/)(helm|helm-chart|charts)\//) },
+    { category: 'infra', reasonId: 'infra.kubernetes', reason: 'Kubernetes manifest directory.', test: regex(/(^|\/)(k8s|kubernetes|manifests)\//) },
+    { category: 'infra', reasonId: 'infra.ansible', reason: 'Ansible playbook directory.', test: regex(/(^|\/)(ansible|playbooks)\//) },
+    { category: 'infra', reasonId: 'infra.cloudformation', reason: 'CloudFormation template directory.', test: regex(/(^|\/)cloudformation\//) },
+    { category: 'infra', reasonId: 'infra.serverless', reason: 'Serverless framework config.', test: basenameAny(['serverless.yml', 'serverless.yaml', 'serverless.ts']) },
+    { category: 'infra', reasonId: 'infra.nginx', reason: 'Nginx / reverse-proxy config.', test: regex(/(^|\/)nginx(.*)?\.conf$/) },
+    { category: 'infra', reasonId: 'infra.migration', reason: 'Database migration file.', test: regex(/(^|\/)(migrations|db\/migrations|services\/.+\/migrations)\//) },
+    // ── Sensitive ─────────────────────────────────────────────────────────────
+    { category: 'sensitive', reasonId: 'sensitive.env', reason: 'Environment variable file.', test: regex(/(^|\/)\.env(\.[A-Za-z0-9._-]+)?$/) },
+    { category: 'sensitive', reasonId: 'sensitive.keys', reason: 'Key/credential material.', test: regex(/\.(pem|key|crt|p12|pfx|jks|keystore)$/) },
+    { category: 'sensitive', reasonId: 'sensitive.auth-path', reason: 'Auth / IAM / permissions surface.', test: regex(/(^|\/)(auth|iam|permissions|secrets?)\//) },
+    // ── Dependency manifest ───────────────────────────────────────────────────
+    { category: 'dependency-manifest', reasonId: 'dep.npm', reason: 'Node package manifest.', test: basename('package.json') },
+    { category: 'dependency-manifest', reasonId: 'dep.python-requirements', reason: 'Python requirements file.', test: regex(/(^|\/)requirements(\/[^/]+)?\.(txt|in)$|^requirements(\/[^/]+)?\.(txt|in)$/) },
+    { category: 'dependency-manifest', reasonId: 'dep.python-requirements-dir', reason: 'Python requirements directory.', test: regex(/(^|\/)requirements\//) },
+    { category: 'dependency-manifest', reasonId: 'dep.pyproject', reason: 'Python project / build manifest.', test: basename('pyproject.toml') },
+    { category: 'dependency-manifest', reasonId: 'dep.pipfile', reason: 'Pipenv manifest.', test: basename('Pipfile') },
+    { category: 'dependency-manifest', reasonId: 'dep.setup-py', reason: 'Legacy setuptools manifest.', test: basename('setup.py') },
+    { category: 'dependency-manifest', reasonId: 'dep.setup-cfg', reason: 'Legacy setuptools config.', test: basename('setup.cfg') },
+    { category: 'dependency-manifest', reasonId: 'dep.cargo', reason: 'Rust crate manifest.', test: basename('Cargo.toml') },
+    { category: 'dependency-manifest', reasonId: 'dep.go-mod', reason: 'Go module manifest.', test: basename('go.mod') },
+    { category: 'dependency-manifest', reasonId: 'dep.maven', reason: 'Maven project manifest.', test: basename('pom.xml') },
+    { category: 'dependency-manifest', reasonId: 'dep.gradle', reason: 'Gradle build script.', test: suffixAny(['/build.gradle', '/build.gradle.kts', '/settings.gradle', '/settings.gradle.kts']) },
+    { category: 'dependency-manifest', reasonId: 'dep.composer', reason: 'PHP composer manifest.', test: basename('composer.json') },
+    { category: 'dependency-manifest', reasonId: 'dep.gemfile', reason: 'Ruby Gemfile.', test: basename('Gemfile') },
+]);
+/**
+ * Classify a single repo-relative path. Returns the FIRST matching boundary
+ * (rules are ordered by specificity / severity), or `null` when the path
+ * does not match any well-known boundary pattern.
+ *
+ * The classifier is intentionally first-match-wins so the ordering above
+ * encodes the priority: generated-code > CI > infra > sensitive > dep-manifest.
+ */
+function classifyPathBoundary(path) {
+    if (!path)
+        return null;
+    const normalised = path.replace(/\\/g, '/').replace(/^\.\//, '');
+    for (const rule of RULES) {
+        if (rule.test(normalised)) {
+            return { category: rule.category, reasonId: rule.reasonId, reason: rule.reason };
+        }
+    }
+    return null;
+}
+/**
+ * Bulk classify and bucket. Returns a deterministic { category → paths } map.
+ * Empty buckets are omitted from the result for compactness; consumers should
+ * defensively check `result.<category]?.length`.
+ */
+function classifyAndBucket(paths) {
+    const buckets = {};
+    // Sort + dedupe inputs so the output is replay-stable regardless of caller
+    // ordering. This is load-bearing for the canonical replay checksum.
+    const seen = new Set();
+    const inputs = [...paths]
+        .filter((p) => typeof p === 'string' && p.length > 0)
+        .filter((p) => (seen.has(p) ? false : (seen.add(p), true)))
+        .sort();
+    for (const path of inputs) {
+        const classification = classifyPathBoundary(path);
+        if (!classification)
+            continue;
+        (buckets[classification.category] ??= []).push(path);
+    }
+    return buckets;
+}
+//# sourceMappingURL=path-boundary-classifier.js.map

package/dist/utils/path-boundary-classifier.js.map

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

package/dist/utils/replay-html-report.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Self-contained HTML replay report generator.
+ *
+ * Renders deterministic replay state into a single audit-grade HTML file.
+ * No JavaScript, no external assets, no remote requests — every byte of the
+ * output is derived from canonical replay artifacts.
+ *
+ * The output is intended to be opened directly in a browser, attached to
+ * audit reports, or stored alongside `.neurcode/evidence/` artifacts.
+ */
+import type { replayGovernanceState } from './replay-runtime';
+type ReplayState = ReturnType<typeof replayGovernanceState>;
+export interface HtmlReportInput {
+    state: ReplayState;
+    /**
+     * Optional latest verify payload (the structural+governance envelope
+     * emitted by `verify --json`). When provided, scope issues, runtime
+     * capabilities, and the canonical replay checksum are surfaced.
+     */
+    verify?: Record<string, unknown> | null;
+    generatedAt?: string;
+}
+/**
+ * Render a self-contained HTML report. The returned string is ready to be
+ * written to disk and opened in any browser. No external assets fetched.
+ */
+export declare function renderReplayHtmlReport(input: HtmlReportInput): string;
+export {};
+//# sourceMappingURL=replay-html-report.d.ts.map

package/dist/utils/replay-html-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-html-report.d.ts","sourceRoot":"","sources":["../../src/utils/replay-html-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoQD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAsCrE"}

package/dist/utils/replay-html-report.js

@@ -0,0 +1,309 @@
+"use strict";
+/**
+ * Self-contained HTML replay report generator.
+ *
+ * Renders deterministic replay state into a single audit-grade HTML file.
+ * No JavaScript, no external assets, no remote requests — every byte of the
+ * output is derived from canonical replay artifacts.
+ *
+ * The output is intended to be opened directly in a browser, attached to
+ * audit reports, or stored alongside `.neurcode/evidence/` artifacts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderReplayHtmlReport = renderReplayHtmlReport;
+const STYLES = `
+:root {
+  --bg: #0f172a;
+  --bg-soft: #111827;
+  --panel: #1e293b;
+  --border: #334155;
+  --text: #e2e8f0;
+  --muted: #94a3b8;
+  --accent: #38bdf8;
+  --good: #4ade80;
+  --warn: #facc15;
+  --bad: #f87171;
+}
+* { box-sizing: border-box; }
+body {
+  margin: 0; padding: 32px;
+  background: var(--bg); color: var(--text);
+  font: 14px/1.55 -apple-system, BlinkMacSystemFont, "Segoe UI", "SF Mono", monospace;
+}
+main { max-width: 1100px; margin: 0 auto; }
+h1 { font-size: 22px; margin: 0 0 4px; letter-spacing: 0.2px; }
+h2 { font-size: 16px; margin: 24px 0 8px; color: var(--accent); text-transform: uppercase; letter-spacing: 0.9px; }
+.subtitle { color: var(--muted); margin: 0 0 24px; font-size: 13px; }
+.panel { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 16px 20px; margin-bottom: 16px; }
+.kv { display: grid; grid-template-columns: 220px 1fr; row-gap: 6px; column-gap: 16px; }
+.kv dt { color: var(--muted); }
+.kv dd { margin: 0; word-break: break-all; }
+.badge { display: inline-block; padding: 1px 8px; border-radius: 4px; font-size: 11px; margin-right: 4px; font-weight: 600; letter-spacing: 0.4px; }
+.badge.good { background: rgba(74, 222, 128, 0.18); color: var(--good); }
+.badge.warn { background: rgba(250, 204, 21, 0.18); color: var(--warn); }
+.badge.bad  { background: rgba(248, 113, 113, 0.18); color: var(--bad); }
+.badge.muted { background: rgba(148, 163, 184, 0.18); color: var(--muted); }
+.checksum { font-family: "SF Mono", "Menlo", monospace; font-size: 12px; word-break: break-all; }
+table { width: 100%; border-collapse: collapse; }
+th, td { text-align: left; padding: 6px 8px; border-bottom: 1px solid var(--border); vertical-align: top; font-size: 13px; }
+th { color: var(--muted); font-weight: 500; text-transform: uppercase; letter-spacing: 0.6px; font-size: 11px; }
+tr:last-child td { border-bottom: 0; }
+.muted { color: var(--muted); }
+.code { font-family: "SF Mono", "Menlo", monospace; }
+.row { display: flex; gap: 12px; flex-wrap: wrap; }
+.row .panel { flex: 1; min-width: 280px; }
+footer { color: var(--muted); font-size: 12px; margin-top: 32px; border-top: 1px solid var(--border); padding-top: 12px; }
+`;
+function escapeHtml(text) {
+    if (text === null || text === undefined)
+        return '—';
+    const s = typeof text === 'string' ? text : String(text);
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function badge(value, kind) {
+    return `<span class="badge ${kind}">${escapeHtml(value)}</span>`;
+}
+function statusBadge(value, positive, warning = []) {
+    if (!value)
+        return badge('unknown', 'muted');
+    if (positive.includes(value))
+        return badge(value, 'good');
+    if (warning.includes(value))
+        return badge(value, 'warn');
+    return badge(value, 'bad');
+}
+function row(label, value) {
+    return `<dt>${escapeHtml(label)}</dt><dd>${value}</dd>`;
+}
+function renderRuntimeCapabilities(verify) {
+    const rc = (verify?.runtimeCapabilities ?? null);
+    if (!rc) {
+        return `<section class="panel">
+  <h2>Runtime Capabilities</h2>
+  <p class="muted">No <code>runtimeCapabilities</code> envelope was attached to the input. This typically means the run pre-dates the 0.11.0 intent-runtime activation, or no <code>verify</code> output was supplied with <code>--verify</code>.</p>
+</section>`;
+    }
+    const tag = (v) => statusBadge(typeof v === 'string' ? v : null, ['active', 'enforced', 'pattern-deterministic', 'active-authored', 'active-synthesized', 'offline', 'full-bundle', 'intent-pack-only'], ['inactive', 'unenforced']);
+    return `<section class="panel">
+  <h2>Runtime Capabilities</h2>
+  <p class="muted">What actually executed in this run. Schema: <code>${escapeHtml(rc.schemaVersion ?? 'neurcode.runtime-capabilities.v1')}</code></p>
+  <dl class="kv">
+    ${row('intent-runtime', tag(rc.intentRuntime))}
+    ${row('intent-contract-source', tag(rc.intentContractSource))}
+    ${row('intent-runtime-required', rc.intentRuntimeRequired === true ? badge('required', 'good') : badge('not required', 'muted'))}
+    ${row('requirement-satisfied', rc.intentRuntimeRequirementSatisfied === false ? badge('NOT SATISFIED', 'bad') : badge('satisfied', 'good'))}
+    ${row('scope-guard', tag(rc.scopeGuard))}
+    ${row('forbidden-boundary-enforcement', tag(rc.forbiddenBoundaryEnforcement))}
+    ${row('import-edge-governance', tag(rc.importEdgeGovernance))}
+    ${row('generated-code-governance', tag(rc.generatedCodeGovernance))}
+    ${row('drift-intelligence', tag(rc.driftIntelligence))}
+    ${row('structural-rules', tag(rc.structuralRules))}
+    ${row('replay-determinism', tag(rc.replayDeterminism))}
+    ${row('api-contract-status', tag(rc.apiContractStatus))}
+    ${row('execution-path', escapeHtml(rc.executionPath ?? '—'))}
+  </dl>
+  ${rc.importEdgesAnalyzed !== undefined ? `
+  <h3 style="font-size:13px;color:var(--muted);text-transform:uppercase;letter-spacing:0.6px;margin-top:14px;">Import-edge observability</h3>
+  <dl class="kv">
+    ${row('edges-analyzed', escapeHtml(rc.importEdgesAnalyzed))}
+    ${row('blocking-findings', escapeHtml(rc.importEdgeBlockingFindings ?? 0))}
+    ${row('advisory-findings', escapeHtml(rc.importEdgeAdvisoryFindings ?? 0))}
+    ${row('observed-boundary-types', escapeHtml(Array.isArray(rc.observedImportEdgeBoundaryTypes) ? rc.observedImportEdgeBoundaryTypes.join(', ') : '—'))}
+  </dl>` : ''}
+</section>`;
+}
+function renderPosture(verify) {
+    const ig = (verify?.intentGovernance ?? null);
+    if (!ig || (!ig.governanceGate && !ig.rolloutTrust)) {
+        return '';
+    }
+    return `<section class="panel">
+  <h2>Governance Posture</h2>
+  <p class="muted">Categorical rollup synthesised by the drift-intelligence engine from the canonical finding set.</p>
+  <dl class="kv">
+    ${row('governance-gate', escapeHtml(ig.governanceGate ?? '—'))}
+    ${row('rollout-trust', escapeHtml(ig.rolloutTrust ?? '—'))}
+    ${row('rollout-risk', escapeHtml(ig.rolloutRisk ?? '—'))}
+    ${row('canonical-finding-count', escapeHtml(ig.canonicalFindingCount ?? 0))}
+    ${row('blocking-finding-count', escapeHtml(ig.blockingFindingCount ?? 0))}
+    ${row('advisory-finding-count', escapeHtml(ig.advisoryFindingCount ?? 0))}
+    ${ig.unexpectedFiles && Array.isArray(ig.unexpectedFiles) && ig.unexpectedFiles.length > 0
+        ? row('unexpected-files', `<code>${ig.unexpectedFiles.map(escapeHtml).join('</code><br><code>')}</code>`)
+        : ''}
+  </dl>
+</section>`;
+}
+function renderScopeIssues(verify) {
+    const issues = (verify?.scopeIssues ?? []);
+    if (!Array.isArray(issues) || issues.length === 0) {
+        return `<section class="panel">
+  <h2>Scope Issues</h2>
+  <p class="muted">No scope issues recorded for this replay state.</p>
+</section>`;
+    }
+    const pathTouch = issues.filter((i) => !i.importEdge);
+    const importEdges = issues.filter((i) => !!i.importEdge);
+    const rows = (subset, type) => subset.map((issue) => {
+        const edge = (issue.importEdge ?? null);
+        const policyBadge = issue.policy === 'forbidden' ? badge('forbidden', 'bad')
+            : issue.policy === 'review-required' ? badge('review-required', 'warn')
+                : issue.policy === 'generated-code' ? badge('generated-code', 'warn')
+                    : badge(issue.policy ?? 'out-of-scope', 'muted');
+        const boundaryBadge = issue.boundaryType ? badge(issue.boundaryType, 'muted') : '';
+        if (type === 'edge' && edge) {
+            return `<tr>
+  <td class="code">${escapeHtml(edge.sourceFile)}:${escapeHtml(edge.sourceLine)}</td>
+  <td>${policyBadge}${boundaryBadge}<span class="badge muted">${escapeHtml(edge.edgeKind)}</span></td>
+  <td><span class="code">${escapeHtml(edge.importTarget)}</span><br><span class="muted">→ ${escapeHtml(edge.resolvedTargetPath)}</span><br><span class="muted">boundary: ${escapeHtml(edge.resolvedBoundary)}</span></td>
+</tr>`;
+        }
+        return `<tr>
+  <td class="code">${escapeHtml(issue.file)}</td>
+  <td>${policyBadge}${boundaryBadge}</td>
+  <td>${escapeHtml(issue.message)}</td>
+</tr>`;
+    }).join('');
+    const sections = [];
+    if (importEdges.length > 0) {
+        sections.push(`<section class="panel">
+  <h2>Import-Edge Drift (${importEdges.length})</h2>
+  <p class="muted">Cross-boundary <code>import</code> statements inside otherwise in-scope files. Deterministic, replay-stable.</p>
+  <table>
+    <thead><tr><th>Source · line</th><th>Classification</th><th>Edge</th></tr></thead>
+    <tbody>${rows(importEdges, 'edge')}</tbody>
+  </table>
+</section>`);
+    }
+    if (pathTouch.length > 0) {
+        sections.push(`<section class="panel">
+  <h2>Path-touch Scope Drift (${pathTouch.length})</h2>
+  <p class="muted">Files modified outside the declared scope or inside an explicit forbidden boundary.</p>
+  <table>
+    <thead><tr><th>File</th><th>Classification</th><th>Message</th></tr></thead>
+    <tbody>${rows(pathTouch, 'path')}</tbody>
+  </table>
+</section>`);
+    }
+    return sections.join('\n');
+}
+function renderReplayState(state, verify) {
+    const reconstruction = state.reconstruction;
+    const statusBadgeForRecon = reconstruction.reconstructionStatus === 'exact'
+        ? badge('exact', 'good')
+        : badge(reconstruction.reconstructionStatus, 'warn');
+    const verifyChecksum = (verify?.replayChecksum ?? null);
+    const verdict = (verify?.verdict ?? null);
+    return `<section class="panel">
+  <h2>Replay State</h2>
+  <dl class="kv">
+    ${row('as-of', escapeHtml(state.asOf))}
+    ${row('artifact-hash', `<span class="checksum">${escapeHtml(state.determinism.artifactHash)}</span>`)}
+    ${verifyChecksum ? row('canonical-replay-checksum', `<span class="checksum">${escapeHtml(verifyChecksum)}</span>`) : ''}
+    ${verdict ? row('latest-verdict', verdict === 'PASS' ? badge('PASS', 'good') : badge(verdict, 'bad')) : ''}
+    ${row('reconstruction-status', statusBadgeForRecon)}
+    ${row('reconstruction-confidence', `${reconstruction.confidence.overall}/100`)}
+    ${row('snapshot · control-plane', state.controlPlane.snapshotId ? escapeHtml(state.controlPlane.snapshotId) : badge('none', 'muted'))}
+    ${row('snapshot · workspace', state.workspace.snapshotId ? escapeHtml(state.workspace.snapshotId) : badge('none', 'muted'))}
+  </dl>
+  <div class="row" style="margin-top:14px;">
+    <div class="panel" style="margin-bottom:0;">
+      <h3 style="font-size:13px;color:var(--muted);text-transform:uppercase;letter-spacing:0.6px;margin:0 0 8px;">Posture</h3>
+      <dl class="kv">
+        ${row('runs', escapeHtml(state.posture.runCount))}
+        ${row('pass-rate', `${escapeHtml(state.posture.passRate)}%`)}
+        ${row('block-rate', `${escapeHtml(state.posture.blockRate)}%`)}
+        ${row('regression-rate', `${escapeHtml(state.posture.regressionRate)}%`)}
+      </dl>
+    </div>
+    <div class="panel" style="margin-bottom:0;">
+      <h3 style="font-size:13px;color:var(--muted);text-transform:uppercase;letter-spacing:0.6px;margin:0 0 8px;">Reconstruction confidence (deterministic subscores)</h3>
+      <dl class="kv">
+        ${row('provenance', `${reconstruction.confidence.provenance.score}/100`)}
+        ${row('graph', `${reconstruction.confidence.graph.score}/100`)}
+        ${row('semantic', `${reconstruction.confidence.semantic.score}/100`)}
+        ${row('federation', `${reconstruction.confidence.federation.score}/100`)}
+        ${row('artifacts', `${reconstruction.confidence.artifacts.score}/100`)}
+      </dl>
+    </div>
+  </div>
+</section>`;
+}
+function renderBlockedExecutions(state) {
+    if (state.blockedExecutions.length === 0)
+        return '';
+    const rows = state.blockedExecutions.slice(0, 30).map((exec) => `<tr>
+  <td class="code">${escapeHtml(exec.executionId.slice(0, 12))}</td>
+  <td>${escapeHtml(exec.type)}</td>
+  <td>${escapeHtml(exec.source)}</td>
+  <td>${escapeHtml(exec.createdAt)}</td>
+  <td>${escapeHtml(exec.blocking)}</td>
+  <td>${escapeHtml(exec.advisory)}</td>
+</tr>`).join('');
+    return `<section class="panel">
+  <h2>Blocked Executions (${state.blockedExecutions.length})</h2>
+  <table>
+    <thead><tr><th>Execution</th><th>Type</th><th>Source</th><th>Created</th><th>Blocking</th><th>Advisory</th></tr></thead>
+    <tbody>${rows}</tbody>
+  </table>
+</section>`;
+}
+function renderRecoveryGuidance(state) {
+    const guidance = state.reconstruction.recoveryGuidance ?? [];
+    if (guidance.length === 0)
+        return '';
+    const items = guidance.slice(0, 20).map((g) => `<li>${escapeHtml(g)}</li>`).join('');
+    return `<section class="panel">
+  <h2>Operational Recovery Guidance</h2>
+  <p class="muted">Bounded, deterministic remediation hints derived from observed snapshot completeness.</p>
+  <ul>${items}</ul>
+</section>`;
+}
+/**
+ * Render a self-contained HTML report. The returned string is ready to be
+ * written to disk and opened in any browser. No external assets fetched.
+ */
+function renderReplayHtmlReport(input) {
+    const generatedAt = input.generatedAt ?? new Date().toISOString();
+    const projectRoot = input.state.determinism.projectRoot ?? 'unknown';
+    const verify = input.verify ?? null;
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="generator" content="neurcode replay --html" />
+  <title>Neurcode · Replay Report</title>
+  <style>${STYLES}</style>
+</head>
+<body>
+<main>
+  <h1>Neurcode · Replay Report</h1>
+  <p class="subtitle">Deterministic operational governance · audit-grade · same inputs → same report bytes.</p>
+  <section class="panel">
+    <dl class="kv">
+      ${row('generated-at', escapeHtml(generatedAt))}
+      ${row('project-root', `<code>${escapeHtml(projectRoot)}</code>`)}
+      ${row('replay schema', escapeHtml(input.state.schemaVersion))}
+    </dl>
+  </section>
+  ${renderReplayState(input.state, verify)}
+  ${renderRuntimeCapabilities(verify)}
+  ${renderPosture(verify)}
+  ${renderScopeIssues(verify)}
+  ${renderBlockedExecutions(input.state)}
+  ${renderRecoveryGuidance(input.state)}
+  <footer>
+    <p>Replay output is deterministic. Same diff + same intent contract + same rule set → byte-identical <code>replayChecksum</code>.</p>
+    <p>Schema: <code>${escapeHtml(input.state.schemaVersion)}</code> · Generator: <code>neurcode replay --html</code> · No JavaScript, no external assets.</p>
+  </footer>
+</main>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=replay-html-report.js.map

package/dist/utils/replay-html-report.js.map

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

package/dist/utils/runtime-state.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Runtime state guardrails.
+ *
+ * Detects the operational state of a project root and produces structured
+ * "what's next" guidance when a command would otherwise fail with a raw
+ * runtime / git / filesystem error.
+ *
+ * Pure, deterministic, no network. Read-only. No mutations to .neurcode/
+ * or any other on-disk state.
+ *
+ * Aesthetic discipline: subtle sophistication, no terminal theatrics.
+ * Aligned with the operational-experience refabrication phase
+ * (docs/ux/final-operational-experience-report.md).
+ */
+export type RuntimeStateIssue = 'not-a-git-repo' | 'no-head-commit' | 'no-neurcode-dir' | 'no-intent-pack';
+export interface RuntimeStateSnapshot {
+    projectRoot: string;
+    isGitRepo: boolean;
+    hasHeadCommit: boolean;
+    hasNeurcodeDir: boolean;
+    hasIntentPack: boolean;
+    hasLastVerifyOutput: boolean;
+}
+export declare function detectRuntimeState(projectRoot: string): RuntimeStateSnapshot;
+/**
+ * Render an operational-guidance panel when a command cannot run because
+ * a prerequisite is not met. Same aesthetic as the welcome banner + the
+ * `neurcode home` panels: subtle, structured, no theatrics.
+ *
+ * The panel writes to stderr (so JSON-mode callers piping stdout get clean
+ * JSON or no output) and returns the exit code the caller should propagate.
+ */
+export declare function renderRuntimeStateGuidance(issue: RuntimeStateIssue, state: RuntimeStateSnapshot, options?: {
+    commandLabel?: string;
+}): number;
+/**
+ * Convenience: detect state + render guidance + return the exit code for
+ * the FIRST unsatisfied prerequisite (in lifecycle order). Returns null if
+ * all required prerequisites are satisfied.
+ */
+export declare function guardRequired(projectRoot: string, required: ReadonlyArray<RuntimeStateIssue>, options?: {
+    commandLabel?: string;
+}): number | null;
+//# sourceMappingURL=runtime-state.d.ts.map

package/dist/utils/runtime-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAUD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAiB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,MAAM,CA2ER;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC1C,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,MAAM,GAAG,IAAI,CAcf"}