@warpgogol/forge 4.1.6 → 4.2.1

package/dist/os/rfc/types.js

@@ -0,0 +1,118 @@
+/***************************************************************
+ * <MODULE_CONTRACT>
+ * <purpose>
+ * Defines types and constants for managing RFC lifecycle,
+ * including statuses, kinds, and scopes, facilitating
+ * structured proposal submissions.
+ * </purpose>
+ *  *  * <non-goals>
+ * <item>Do not implement RFC processing or validation logic here.</item>
+ * <item>Do not handle user input or command execution related to RFCs.</item>
+ * <item>Do not manage the storage or retrieval of RFC documents.</item>
+ * </non-goals>
+ * </MODULE_CONTRACT>
+ *  * <CHANGE_SUMMARY>
+  <item>Tidied by compass.changesummary.tidy; see git history for prior entries.</item>
+  <item>RFC-0465: added specRef field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for PBP spec traceability.</item>
+  <item>RFC-0478: added versionBump field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for platform versioning enforcement.</item>
+  <item>RFC-0480: added breaksC field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for Layer C protection.</item>
+  <item>RFC-0795: added dependsOn, batch fields to RfcFrontmatter and RFC_KNOWN_KEYS; added RFC-IMP-07 to RfcImplementStampRule; added batch/dependsOn to RfcListEntry.</item>
+  <item>RFC-0998: added TestProbe and JsonSchemaProbe to AcceptanceProbe union for test and json-schema acceptance probe kinds.</item>
+  <item>RFC-0999: added lastRefreshedAt to VerificationEvidence; added RfcVerificationRefreshResult interface.</item>
+</CHANGE_SUMMARY>
+ ***************************************************************/
+export const RFC_STATUSES = [
+    "draft",
+    "reviewing",
+    "accepted",
+    "implemented",
+    "rejected",
+    "superseded",
+];
+export const RFC_KINDS = [
+    "architecture",
+    "contract",
+    "command",
+    "policy",
+    "deprecation",
+];
+export const RFC_SCOPES = ["app", "workspace"]; // ─── Frontmatter ─────────────────────────────────────────────────────────────
+export const RFC_DIR = "docs/rfcs";
+export const RFC_TEMPLATE_FILE = "docs/rfcs/rfc-0000-template.md";
+export const RFC_TEMPLATE_FALLBACK_FILE = "os/rfc/rfc-0000-template.md";
+export const RFC_ID_PATTERN = /^RFC-\d{4}$/;
+/** Required H2 sections for every RFC. */
+export const RFC_FULL_REQUIRED_SECTIONS = [
+    "Context",
+    "Problem",
+    "Decision",
+    "Architectural fit",
+    "Design",
+    "Rollout",
+    "Alternatives considered",
+    "Risks",
+    "Acceptance criteria",
+    "Implementation notes for agents",
+];
+/** Every frontmatter key the RFC schema sanctions. V-20 warns on anything else. */
+export const RFC_KNOWN_KEYS = [
+    "id",
+    "title",
+    "status",
+    "kind",
+    "scope",
+    "owners",
+    "reviewers",
+    "createdAt",
+    "updatedAt",
+    "enhancedAt",
+    "implementedAt",
+    "closedAt",
+    "supersedes",
+    "supersededBy",
+    "amends",
+    "amendedBy",
+    "related",
+    "commands",
+    "appsImpacted",
+    "packagesImpacted",
+    "successSignals",
+    "nonGoals",
+    "acceptance",
+    "satisfies",
+    "specRef",
+    "versionBump",
+    "breaksC",
+    "liveSpec",
+    "dependsOn",
+    "batch",
+];
+/**
+ * RFC-0330 / RFC-0331 / RFC-0335: shared cutoff date for new metadata rules.
+ * RFCs created on or after this date are subject to V-23 (evidence), V-24 (DNA-trace),
+ * and V-25 (reviewer identity). RFCs created before are exempt.
+ */
+export const RFC_METADATA_CUTOFF = "2026-07-07";
+/**
+ * RFC-0478: cutoff date for versionBump enforcement (V-29).
+ * RFCs created on or after this date with status "implemented" must declare
+ * a versionBump field. RFCs created before are exempt.
+ */
+export const RFC_VERSION_BUMP_CUTOFF = "2026-07-21";
+/**
+ * RFC-0997: cutoff date for probe-criterion binding rules.
+ * RFCs created on or after this date are subject to V-35 (probe→criterion
+ * referential integrity), V-36 (criterion identifier discipline), V-37
+ * (evidence mechanism validity), and RFC-IMP-08 (minimum-one-probe stamp gate).
+ * RFCs created before are exempt.
+ */
+export const RFC_PROBE_BINDING_CUTOFF = "2026-09-01";
+/**
+ * RFC-1006: cutoff date for criteria content rules (phase separation, reject
+ * checklist, criterion versioning). RFCs created on or after this date are
+ * subject to V-38 (document readiness completeness), V-39 (non-atomic
+ * criterion), V-40 (unbounded quantity), V-41 (weasel verb), and V-42
+ * (criterion versioning annotation format). RFCs created before are exempt.
+ */
+export const RFC_CRITERIA_CONTENT_CUTOFF = "2026-09-03";
+//# sourceMappingURL=types.js.map

package/dist/os/rfc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/rfc/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;iEAsBiE;AA4BjE,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,OAAO;IACP,WAAW;IACX,UAAU;IACV,aAAa;IACb,UAAU;IACV,YAAY;CACJ,CAAC;AAaX,MAAM,CAAC,MAAM,SAAS,GAAuB;IAC3C,cAAc;IACd,UAAU;IACV,SAAS;IACT,QAAQ;IACR,aAAa;CACL,CAAC;AAUX,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,KAAK,EAAE,WAAW,CAAU,CAAC,CAAC,gFAAgF;AAie9J,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,gCAAgC,CAAC;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS;IACT,SAAS;IACT,UAAU;IACV,mBAAmB;IACnB,QAAQ;IACR,SAAS;IACT,yBAAyB;IACzB,OAAO;IACP,qBAAqB;IACrB,iCAAiC;CACzB,CAAC;AAEX,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,WAAW;IACX,WAAW;IACX,YAAY;IACZ,eAAe;IACf,UAAU;IACV,YAAY;IACZ,cAAc;IACd,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,gBAAgB;IAChB,UAAU;IACV,YAAY;IACZ,WAAW;IACX,SAAS;IACT,aAAa;IACb,SAAS;IACT,UAAU;IACV,WAAW;IACX,OAAO;CACC,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CAAC"}

package/dist/os/rfc/verification-evidence.d.ts

@@ -0,0 +1,15 @@
+import type { AcceptanceProbe, RfcStatus, VerificationEvidence, VerificationEvidenceProbeRecord, RfcVerificationEmitResult } from "./types.ts";
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+export declare const VERIFICATION_DIR: string;
+export declare function captureGitContext(workspaceRoot: string): Promise<{
+    commit: string;
+    workingTreeDirty: boolean;
+}>;
+export declare function getKernelVersion(workspaceRoot: string): Promise<string>;
+export declare function byteHashHex(content: string): string;
+export declare function buildEvidenceEnvelope(rfcId: string, title: string, rfcStatus: RfcStatus, rfcMarkdown: string, probes: AcceptanceProbe[], probeRecords: VerificationEvidenceProbeRecord[], gitContext: {
+    commit: string;
+    workingTreeDirty: boolean;
+}, kernelVersion: string, emittedAt: string): VerificationEvidence;
+export declare function runRfcVerificationEmit(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcVerificationEmitResult>>;
+//# sourceMappingURL=verification-evidence.d.ts.map

package/dist/os/rfc/verification-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-evidence.d.ts","sourceRoot":"","sources":["../../../os/rfc/verification-evidence.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAe9D,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,CAAC,CASxD;AAED,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ7E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAMD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EAAE,EACzB,YAAY,EAAE,+BAA+B,EAAE,EAC/C,UAAU,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,EACzD,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,oBAAoB,CAetB;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,CAAC,CA2HxD"}

package/dist/os/rfc/verification-evidence.js

@@ -0,0 +1,185 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-0330: emit per-RFC verification evidence artifacts. Executes acceptance
+probes via the existing runProbe, captures git/kernel context, and writes
+a JSON evidence envelope to docs/rfcs/verification/<slug>.generated.yaml.
+</purpose>
+<non-goals>
+  <item>Do not duplicate probe execution — reuse runProbe from acceptance.ts.</item>
+  <item>Do not run automatically inside build pipelines — on-demand only.</item>
+  <item>Do not backfill evidence for pre-cutoff RFCs.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0330: initial implementation.</item>
+  <item>RFC-0999: exported captureGitContext, getKernelVersion, byteHashHex, VERIFICATION_DIR for reuse by verification-refresh.ts.</item>
+</CHANGE_SUMMARY>
+*/
+import { execFile } from "node:child_process";
+import { readFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { performance } from "node:perf_hooks";
+import { byteHash } from "../../src/utils/hash.js";
+import { runProbe } from "./acceptance.js";
+import { listRfcFiles, readAndParseRfc } from "./frontmatter-io.js";
+import { writeFileAtomic } from "../../src/utils/fs-atomic.js";
+import { buildGeneratedHeader } from "../../src/utils/generated-marker.js";
+import { stringify as yamlStringify } from "yaml";
+import { RFC_DIR } from "./types.js";
+export const VERIFICATION_DIR = join(RFC_DIR, "verification");
+const HASH_PREFIX = "sha" + "256:";
+function execGit(workspaceRoot, args) {
+    return new Promise((resolve) => {
+        execFile("git", args, { cwd: workspaceRoot, timeout: 5000 }, (err, stdout) => {
+            if (err) {
+                resolve("");
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+export async function captureGitContext(workspaceRoot) {
+    const [commitOutput, statusOutput] = await Promise.all([
+        execGit(workspaceRoot, ["rev-parse", "HEAD"]),
+        execGit(workspaceRoot, ["status", "--porcelain"]),
+    ]);
+    return {
+        commit: commitOutput || "unknown",
+        workingTreeDirty: statusOutput.length > 0,
+    };
+}
+export async function getKernelVersion(workspaceRoot) {
+    try {
+        const pkgPath = join(workspaceRoot, "packages", "os", "site-kernel", "package.json");
+        const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+        return String(pkg.version ?? "unknown");
+    }
+    catch {
+        return "unknown";
+    }
+}
+export function byteHashHex(content) {
+    return byteHash(content).slice(HASH_PREFIX.length);
+}
+function normalizeProbes(probes) {
+    return JSON.stringify(probes, Object.keys(probes[0] ?? {}).sort());
+}
+export function buildEvidenceEnvelope(rfcId, title, rfcStatus, rfcMarkdown, probes, probeRecords, gitContext, kernelVersion, emittedAt) {
+    const overall = probeRecords.every((r) => r.ok) ? "pass" : "fail";
+    return {
+        rfcId,
+        title,
+        rfcStatus,
+        emittedAt,
+        commit: gitContext.commit,
+        workingTreeDirty: gitContext.workingTreeDirty,
+        kernelVersion,
+        rfcFileHash: byteHashHex(rfcMarkdown),
+        acceptanceHash: byteHashHex(normalizeProbes(probes)),
+        probes: probeRecords,
+        overall,
+    };
+}
+export async function runRfcVerificationEmit(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcDirPath = join(workspaceRoot, RFC_DIR);
+    const targetId = input.flags["id"];
+    const targetStatus = input.flags["status"];
+    if (!targetId && !targetStatus) {
+        return {
+            data: {
+                command: "rfc.verification.emit",
+                status: "pass",
+                emitted: [],
+                skipped: [],
+                diagnostics: [],
+            },
+            exitCode: 0,
+            summary: "rfc.verification.emit: pass --id <rfc-id> or --status <status> to select target RFC(s)",
+        };
+    }
+    const allFiles = await listRfcFiles(rfcDirPath);
+    const emitted = [];
+    const skipped = [];
+    const diagnostics = [];
+    const gitContext = await captureGitContext(workspaceRoot);
+    if (gitContext.commit === "unknown") {
+        diagnostics.push({
+            ruleId: "RFC-EVID-01",
+            severity: "warning",
+            message: "Git context unavailable — commit recorded as 'unknown'.",
+        });
+    }
+    const kernelVersion = await getKernelVersion(workspaceRoot);
+    const verificationDirAbs = join(workspaceRoot, VERIFICATION_DIR);
+    await mkdir(verificationDirAbs, { recursive: true });
+    for (const fileName of allFiles) {
+        const parsedFile = await readAndParseRfc(rfcDirPath, fileName);
+        if (!parsedFile)
+            continue;
+        if ("error" in parsedFile)
+            continue;
+        const fm = parsedFile.parsed.frontmatter;
+        const rfcId = String(fm["id"] ?? "");
+        if (targetId && rfcId.toLowerCase() !== targetId.toLowerCase())
+            continue;
+        if (targetStatus && String(fm["status"] ?? "") !== targetStatus)
+            continue;
+        const acceptance = fm["acceptance"];
+        if (!Array.isArray(acceptance) || acceptance.length === 0) {
+            skipped.push({ rfcId, reason: "no-probes" });
+            continue;
+        }
+        const probes = acceptance;
+        const probeRecords = [];
+        const rfcFilePath = join(rfcDirPath, fileName);
+        const rfcMarkdown = await readFile(rfcFilePath, "utf-8");
+        const emittedAt = new Date().toISOString();
+        for (const probe of probes) {
+            const start = performance.now();
+            const result = await runProbe(probe, workspaceRoot, context.commandRegistry);
+            const durationMs = Math.round(performance.now() - start);
+            probeRecords.push({
+                probe,
+                ok: result.ok,
+                detail: result.detail,
+                durationMs,
+            });
+        }
+        const envelope = buildEvidenceEnvelope(rfcId, String(fm["title"] ?? ""), String(fm["status"] ?? ""), rfcMarkdown, probes, probeRecords, gitContext, kernelVersion, emittedAt);
+        const slug = rfcId.toLowerCase();
+        const evidenceFileName = `${slug}.generated.yaml`;
+        const evidenceRelPath = join(VERIFICATION_DIR, evidenceFileName);
+        const evidenceAbsPath = join(workspaceRoot, evidenceRelPath);
+        const jsonContent = `${buildGeneratedHeader({ filePath: evidenceRelPath, ownerCommand: "rfc.verification.emit" })}${yamlStringify(envelope)}\n`;
+        await writeFileAtomic(evidenceAbsPath, jsonContent);
+        emitted.push({ rfcId, file: evidenceRelPath, overall: envelope.overall });
+        if (envelope.overall === "fail") {
+            diagnostics.push({
+                ruleId: "RFC-EVID-02",
+                severity: "error",
+                file: evidenceRelPath,
+                message: `${rfcId}: evidence overall is "fail" — ${probeRecords.filter((r) => !r.ok).length} probe(s) failed.`,
+            });
+        }
+        if (outputFormat === "pretty") {
+            logger.info(`[evidence] ${rfcId} → ${evidenceRelPath} (${envelope.overall}, ${probeRecords.length} probes)`);
+        }
+    }
+    const hasFailures = emitted.some((e) => e.overall === "fail");
+    const status = hasFailures ? "fail" : "pass";
+    return {
+        data: {
+            command: "rfc.verification.emit",
+            status,
+            emitted,
+            skipped,
+            diagnostics,
+        },
+        exitCode: hasFailures ? 1 : 0,
+        summary: `rfc.verification.emit: ${emitted.length} emitted, ${skipped.length} skipped`,
+    };
+}
+//# sourceMappingURL=verification-evidence.js.map

package/dist/os/rfc/verification-evidence.js.map

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

package/dist/os/rfc/verification-refresh.d.ts

@@ -0,0 +1,4 @@
+import type { RfcVerificationRefreshResult } from "./types.ts";
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+export declare function runRfcVerificationRefresh(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcVerificationRefreshResult>>;
+//# sourceMappingURL=verification-refresh.d.ts.map

package/dist/os/rfc/verification-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-refresh.d.ts","sourceRoot":"","sources":["../../../os/rfc/verification-refresh.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAKV,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,4BAA4B,CAAC,CAAC,CA4J3D"}

package/dist/os/rfc/verification-refresh.js

@@ -0,0 +1,160 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-0999: re-run acceptance probes for implemented RFCs and update their
+verification evidence envelopes in-place. Preserves emittedAt, adds
+lastRefreshedAt, replaces probes[] with fresh results. Supports --id,
+--all, and --dry-run flags.
+</purpose>
+<non-goals>
+  <item>Do not duplicate probe execution — reuse runProbe from acceptance.ts.</item>
+  <item>Do not create new envelopes — refresh only updates existing ones.</item>
+  <item>Do not run for non-implemented RFCs — only implemented status has evidence.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0999: initial implementation.</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { performance } from "node:perf_hooks";
+import { parse as yamlParse } from "yaml";
+import { runProbe } from "./acceptance.js";
+import { listRfcFiles, readAndParseRfc } from "./frontmatter-io.js";
+import { writeFileAtomic } from "../../src/utils/fs-atomic.js";
+import { buildGeneratedHeader } from "../../src/utils/generated-marker.js";
+import { stringify as yamlStringify } from "yaml";
+import { captureGitContext, getKernelVersion, VERIFICATION_DIR, buildEvidenceEnvelope, } from "./verification-evidence.js";
+import { RFC_DIR } from "./types.js";
+export async function runRfcVerificationRefresh(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const rfcDirPath = join(workspaceRoot, RFC_DIR);
+    const targetId = input.flags["id"];
+    const allMode = input.flags["all"] === true;
+    const dryRun = input.flags["dry-run"] === true;
+    if (!targetId && !allMode) {
+        return {
+            data: {
+                command: "rfc.verification.refresh",
+                status: "pass",
+                refreshed: [],
+                skipped: [],
+                diagnostics: [],
+                summary: { total: 0, passed: 0, failed: 0, skipped: 0 },
+            },
+            exitCode: 0,
+            summary: "rfc.verification.refresh: pass --id <rfc-id> or --all to select target RFC(s)",
+        };
+    }
+    const allFiles = await listRfcFiles(rfcDirPath);
+    const refreshed = [];
+    const skipped = [];
+    const diagnostics = [];
+    const gitContext = await captureGitContext(workspaceRoot);
+    const kernelVersion = await getKernelVersion(workspaceRoot);
+    for (const fileName of allFiles) {
+        const parsedFile = await readAndParseRfc(rfcDirPath, fileName);
+        if (!parsedFile)
+            continue;
+        if ("error" in parsedFile)
+            continue;
+        const fm = parsedFile.parsed.frontmatter;
+        const rfcId = String(fm["id"] ?? "");
+        const status = String(fm["status"] ?? "");
+        if (targetId && rfcId.toLowerCase() !== targetId.toLowerCase())
+            continue;
+        if (status !== "implemented") {
+            skipped.push({ rfcId, reason: "not implemented" });
+            continue;
+        }
+        const slug = rfcId.toLowerCase();
+        const evidenceFileName = `${slug}.generated.yaml`;
+        const evidenceRelPath = join(VERIFICATION_DIR, evidenceFileName);
+        const evidenceAbsPath = join(workspaceRoot, evidenceRelPath);
+        let existingEnvelope = null;
+        try {
+            const raw = await readFile(evidenceAbsPath, "utf-8");
+            const parsed = yamlParse(raw);
+            if (parsed && typeof parsed === "object" && parsed.rfcId) {
+                existingEnvelope = parsed;
+            }
+        }
+        catch {
+            // file doesn't exist or can't be parsed
+        }
+        if (!existingEnvelope) {
+            skipped.push({ rfcId, reason: "no evidence envelope" });
+            continue;
+        }
+        const acceptance = fm["acceptance"];
+        if (!Array.isArray(acceptance) || acceptance.length === 0) {
+            skipped.push({ rfcId, reason: "no evidence envelope" });
+            continue;
+        }
+        const probes = acceptance;
+        const probeRecords = [];
+        const rfcFilePath = join(rfcDirPath, fileName);
+        const rfcMarkdown = await readFile(rfcFilePath, "utf-8");
+        const now = new Date().toISOString();
+        for (const probe of probes) {
+            const start = performance.now();
+            const result = await runProbe(probe, workspaceRoot, context.commandRegistry);
+            const durationMs = Math.round(performance.now() - start);
+            probeRecords.push({
+                probe,
+                ok: result.ok,
+                detail: result.detail,
+                durationMs,
+            });
+        }
+        const envelope = buildEvidenceEnvelope(rfcId, String(fm["title"] ?? ""), String(fm["status"] ?? ""), rfcMarkdown, probes, probeRecords, gitContext, kernelVersion, existingEnvelope.emittedAt);
+        envelope.lastRefreshedAt = now;
+        if (!dryRun) {
+            const yamlContent = `${buildGeneratedHeader({ filePath: evidenceRelPath, ownerCommand: "rfc.verification.refresh" })}${yamlStringify(envelope)}\n`;
+            await writeFileAtomic(evidenceAbsPath, yamlContent);
+        }
+        const probesFailed = probeRecords.filter((r) => !r.ok).length;
+        refreshed.push({
+            rfcId,
+            file: evidenceRelPath,
+            overall: envelope.overall,
+            probesTotal: probeRecords.length,
+            probesFailed,
+        });
+        if (envelope.overall === "fail") {
+            diagnostics.push({
+                ruleId: "RFC-REFRESH-01",
+                severity: "error",
+                file: evidenceRelPath,
+                message: `${rfcId}: refresh overall is "fail" — ${probesFailed}/${probeRecords.length} probe(s) failed.`,
+            });
+        }
+        if (outputFormat === "pretty") {
+            logger.info(`[refresh] ${rfcId} → ${evidenceRelPath} (${envelope.overall}, ${probeRecords.length} probes${dryRun ? ", dry-run" : ""})`);
+        }
+    }
+    const passed = refreshed.filter((r) => r.overall === "pass").length;
+    const failed = refreshed.filter((r) => r.overall === "fail").length;
+    const hasFailures = failed > 0;
+    const hasSkippedNoEnvelope = skipped.some((s) => s.reason === "no evidence envelope");
+    const status = hasFailures ? "fail" : "pass";
+    return {
+        data: {
+            command: "rfc.verification.refresh",
+            status,
+            refreshed,
+            skipped,
+            diagnostics,
+            summary: {
+                total: refreshed.length,
+                passed,
+                failed,
+                skipped: skipped.length,
+            },
+        },
+        exitCode: hasFailures || hasSkippedNoEnvelope ? 1 : 0,
+        summary: `rfc.verification.refresh: ${refreshed.length} refreshed, ${skipped.length} skipped`,
+    };
+}
+//# sourceMappingURL=verification-refresh.js.map

package/dist/os/rfc/verification-refresh.js.map

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

package/dist/os/session/atif-parser.d.ts

@@ -0,0 +1,29 @@
+export interface AtifMessage {
+    role: "user" | "assistant" | "system" | "unknown";
+    timestamp: string | null;
+    content: string;
+}
+export interface AtifParseResult {
+    messages: AtifMessage[];
+    rawContent: string;
+    /** True if the content was parsed as structured ATIF, false if raw passthrough */
+    parsed: boolean;
+}
+/**
+ * Parse raw ATIF content from Devin CLI --export.
+ *
+ * The initial implementation uses raw text passthrough — the entire content
+ * is treated as a single message with role "unknown". This ensures session.save
+ * works immediately without needing a real ATIF sample to reverse-engineer
+ * the format. As real Devin exports are tested, format-specific parsing
+ * logic is added here.
+ *
+ * Fallback: if any parsing attempt fails, the raw content is preserved
+ * as a single message.
+ */
+export declare function parseAtif(rawContent: string): AtifParseResult;
+/**
+ * Convert parsed ATIF messages to a markdown transcript section.
+ */
+export declare function messagesToTranscriptMarkdown(messages: AtifMessage[]): string;
+//# sourceMappingURL=atif-parser.d.ts.map

package/dist/os/session/atif-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atif-parser.d.ts","sourceRoot":"","sources":["../../../os/session/atif-parser.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CA6B7D;AA2ED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAe5E"}