@warpgogol/forge 4.1.6 → 4.2.1

package/dist/os/session/handlers/list.js

@@ -0,0 +1,147 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+session.list handler — lists session files with optional filters by date
+range, RFC-id, and session type. Parses frontmatter on the fly.
+</purpose>
+<non-goals>
+  <item>Does not validate session content — that is session.validate.</item>
+  <item>Does not modify files in any way.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: implement session.list command handler.</item>
+</CHANGE_SUMMARY>
+*/
+import path from "node:path";
+import { listSessionFiles, listArchivedSessionFiles, readAndParseSession, } from "../frontmatter-io.js";
+import { SESSION_DIR, SESSION_ARCHIVE_SUBDIR, } from "../types.js";
+const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function parseDate(dateStr) {
+    if (!DATE_PATTERN.test(dateStr))
+        return null;
+    const date = new Date(dateStr + "T00:00:00Z");
+    return isNaN(date.getTime()) ? null : date;
+}
+export async function runSessionList(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const sessionDirPath = path.join(workspaceRoot, SESSION_DIR);
+    const filterDateFrom = input.flags["date-from"];
+    const filterDateTo = input.flags["date-to"];
+    const filterRfc = input.flags["rfc"];
+    const filterType = input.flags["type"];
+    let dateFrom = null;
+    let dateTo = null;
+    if (filterDateFrom) {
+        dateFrom = parseDate(filterDateFrom);
+        if (!dateFrom) {
+            throw new Error(`Invalid --date-from format, use YYYY-MM-DD. Got: "${filterDateFrom}"`);
+        }
+    }
+    if (filterDateTo) {
+        dateTo = parseDate(filterDateTo);
+        if (!dateTo) {
+            throw new Error(`Invalid --date-to format, use YYYY-MM-DD. Got: "${filterDateTo}"`);
+        }
+    }
+    const entries = [];
+    // Process active files
+    const activeFiles = await listSessionFiles(sessionDirPath);
+    for (const fileName of activeFiles) {
+        const result = await readAndParseSession(sessionDirPath, fileName);
+        if (!result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const id = String(fm["id"] ?? "");
+        const date = String(fm["date"] ?? "");
+        const types = Array.isArray(fm["types"]) ? fm["types"] : [];
+        const summary = String(fm["summary"] ?? "");
+        const relatedRfcs = Array.isArray(fm["relatedRfcs"]) ? fm["relatedRfcs"] : [];
+        // Apply filters
+        if (filterRfc && !relatedRfcs.includes(filterRfc))
+            continue;
+        if (filterType && !types.includes(filterType))
+            continue;
+        if (dateFrom || dateTo) {
+            const sessionDate = new Date(date);
+            if (isNaN(sessionDate.getTime()))
+                continue;
+            const sessionDay = new Date(sessionDate.toISOString().slice(0, 10) + "T00:00:00Z");
+            if (dateFrom && sessionDay < dateFrom)
+                continue;
+            if (dateTo && sessionDay > dateTo)
+                continue;
+        }
+        entries.push({
+            id,
+            date,
+            types,
+            summary,
+            relatedRfcs,
+            file: path.join(SESSION_DIR, fileName),
+            archived: false,
+        });
+    }
+    // Process archived files
+    const archivedFiles = await listArchivedSessionFiles(sessionDirPath);
+    for (const fileName of archivedFiles) {
+        const result = await readAndParseSession(path.join(sessionDirPath, SESSION_ARCHIVE_SUBDIR), fileName);
+        if (!result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const id = String(fm["id"] ?? "");
+        const date = String(fm["date"] ?? "");
+        const types = Array.isArray(fm["types"]) ? fm["types"] : [];
+        const summary = String(fm["summary"] ?? "");
+        const relatedRfcs = Array.isArray(fm["relatedRfcs"]) ? fm["relatedRfcs"] : [];
+        // Apply filters
+        if (filterRfc && !relatedRfcs.includes(filterRfc))
+            continue;
+        if (filterType && !types.includes(filterType))
+            continue;
+        if (dateFrom || dateTo) {
+            const sessionDate = new Date(date);
+            if (isNaN(sessionDate.getTime()))
+                continue;
+            const sessionDay = new Date(sessionDate.toISOString().slice(0, 10) + "T00:00:00Z");
+            if (dateFrom && sessionDay < dateFrom)
+                continue;
+            if (dateTo && sessionDay > dateTo)
+                continue;
+        }
+        entries.push({
+            id,
+            date,
+            types,
+            summary,
+            relatedRfcs,
+            file: path.join(SESSION_DIR, SESSION_ARCHIVE_SUBDIR, fileName),
+            archived: true,
+        });
+    }
+    // Sort by date descending (most recent first)
+    entries.sort((a, b) => b.date.localeCompare(a.date));
+    if (outputFormat === "pretty") {
+        if (entries.length === 0) {
+            logger.info("No sessions found matching the given filters.");
+        }
+        else {
+            logger.section(`Sessions (${entries.length})`);
+            for (const entry of entries) {
+                const archTag = entry.archived ? " [archived]" : "";
+                const typesStr = entry.types.join(", ");
+                logger.info(`${entry.id}  ${typesStr.padEnd(20)} ${entry.date}  ${entry.summary}${archTag}`);
+            }
+        }
+    }
+    return {
+        data: {
+            command: "session.list",
+            status: "ok",
+            sessions: entries,
+            count: entries.length,
+        },
+        summary: `${entries.length} session(s) found`,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/os/session/handlers/list.js.map

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

package/dist/os/session/handlers/metrics-aggregate.d.ts

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

package/dist/os/session/handlers/metrics-aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-aggregate.d.ts","sourceRoot":"","sources":["../../../../os/session/handlers/metrics-aggregate.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAe,KAAK,sBAAsB,EAA6D,MAAM,aAAa,CAAC;AAClI,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAWxG,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,CA0KrD"}

package/dist/os/session/handlers/metrics-aggregate.js

@@ -0,0 +1,183 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-1053: metrics.aggregate command handler — scans docs/metrics/ files and
+produces per-skill statistics (invocations, avgFindings, avgFixIterations,
+avgDurationMs). Supports --skill, --since, --until filters. Returns empty
+result when no metrics files exist.
+</purpose>
+<non-goals>
+  <item>Does not write files — read-only aggregation.</item>
+  <item>Does not index metrics files — scans on each invocation.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1053: initial metrics.aggregate command handler.</item>
+</CHANGE_SUMMARY>
+*/
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as yamlParse } from "yaml";
+import { METRICS_DIR } from "../types.js";
+async function readYamlFile(filePath) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        return yamlParse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function runMetricsAggregate(input, context) {
+    const { workspaceRoot, outputFormat } = context;
+    const skillFilter = input.flags["skill"];
+    const since = input.flags["since"];
+    const until = input.flags["until"];
+    const rfcMetricsDir = join(workspaceRoot, METRICS_DIR, "rfcs");
+    const sessionMetricsDir = join(workspaceRoot, METRICS_DIR, "sessions");
+    let rfcFiles = [];
+    let sessionFiles = [];
+    try {
+        rfcFiles = await readdir(rfcMetricsDir);
+    }
+    catch {
+        // No RFC metrics directory yet
+    }
+    try {
+        sessionFiles = await readdir(sessionMetricsDir);
+    }
+    catch {
+        // No session metrics directory yet
+    }
+    const rfcMetricsList = [];
+    for (const file of rfcFiles) {
+        if (!file.endsWith(".metrics.yaml"))
+            continue;
+        const metrics = await readYamlFile(join(rfcMetricsDir, file));
+        if (metrics)
+            rfcMetricsList.push(metrics);
+    }
+    const sessionMetricsList = [];
+    for (const file of sessionFiles) {
+        if (!file.endsWith(".metrics.yaml"))
+            continue;
+        const metrics = await readYamlFile(join(sessionMetricsDir, file));
+        if (metrics)
+            sessionMetricsList.push(metrics);
+    }
+    // Apply date filters
+    const sinceDate = since ? new Date(since) : null;
+    const untilDate = until ? new Date(until) : null;
+    const filteredRfcs = rfcMetricsList.filter((m) => {
+        if (!m.generatedAt)
+            return true;
+        const d = new Date(m.generatedAt);
+        if (isNaN(d.getTime()))
+            return true;
+        if (sinceDate && d < sinceDate)
+            return false;
+        if (untilDate && d > untilDate)
+            return false;
+        return true;
+    });
+    const filteredSessions = sessionMetricsList.filter((m) => {
+        if (!m.generatedAt)
+            return true;
+        const d = new Date(m.generatedAt);
+        if (isNaN(d.getTime()))
+            return true;
+        if (sinceDate && d < sinceDate)
+            return false;
+        if (untilDate && d > untilDate)
+            return false;
+        return true;
+    });
+    // Aggregate per-skill
+    const skillData = new Map();
+    function recordSkill(skill, data) {
+        let entry = skillData.get(skill);
+        if (!entry) {
+            entry = {
+                invocations: 0,
+                findingsSum: 0,
+                findingsCount: 0,
+                fixIterationsSum: 0,
+                fixIterationsCount: 0,
+                durationSum: 0,
+                durationCount: 0,
+            };
+            skillData.set(skill, entry);
+        }
+        entry.invocations++;
+        if (data.findings !== undefined) {
+            entry.findingsSum += data.findings;
+            entry.findingsCount++;
+        }
+        if (data.fixIterations !== undefined) {
+            entry.fixIterationsSum += data.fixIterations;
+            entry.fixIterationsCount++;
+        }
+        if (data.durationMs !== undefined) {
+            entry.durationSum += data.durationMs;
+            entry.durationCount++;
+        }
+    }
+    // From RFC metrics: pipeline steps (skill invocations), review findings, fix iterations
+    for (const rfc of filteredRfcs) {
+        for (const step of rfc.pipeline) {
+            if (step.skill) {
+                recordSkill(step.skill, {});
+            }
+        }
+        if (rfc.review && rfc.review.findingsCount !== undefined) {
+            recordSkill("fo-review", { findings: rfc.review.findingsCount });
+        }
+        if (rfc.fix) {
+            recordSkill("fo-fix", { fixIterations: rfc.fix.iterations });
+        }
+    }
+    // From session metrics: skill invocations with durations
+    for (const session of filteredSessions) {
+        for (const inv of session.skills) {
+            recordSkill(inv.skill, {
+                durationMs: inv.approximateDurationMs ?? undefined,
+            });
+        }
+    }
+    let perSkill = [];
+    for (const [skill, data] of skillData) {
+        if (skillFilter && skill !== skillFilter)
+            continue;
+        perSkill.push({
+            skill,
+            invocations: data.invocations,
+            avgFindings: data.findingsCount > 0 ? data.findingsSum / data.findingsCount : null,
+            avgFixIterations: data.fixIterationsCount > 0 ? data.fixIterationsSum / data.fixIterationsCount : null,
+            avgDurationMs: data.durationCount > 0 ? data.durationSum / data.durationCount : null,
+        });
+    }
+    // Sort by invocations descending
+    perSkill.sort((a, b) => b.invocations - a.invocations);
+    if (skillFilter && perSkill.length === 0) {
+        perSkill = [];
+    }
+    const result = {
+        command: "metrics.aggregate",
+        status: "ok",
+        skill: skillFilter ?? "all",
+        since: since ?? null,
+        until: until ?? null,
+        perSkill,
+        totalRfcs: filteredRfcs.length,
+        totalSessions: filteredSessions.length,
+    };
+    if (outputFormat === "pretty") {
+        context.logger.info(`[metrics.aggregate] ${perSkill.length} skill(s), ${filteredRfcs.length} RFC(s), ${filteredSessions.length} session(s)`);
+    }
+    return {
+        data: result,
+        exitCode: 0,
+        summary: `[metrics.aggregate] ${perSkill.length} skill(s) across ${filteredRfcs.length} RFC(s) and ${filteredSessions.length} session(s)`,
+    };
+}
+//# sourceMappingURL=metrics-aggregate.js.map

package/dist/os/session/handlers/metrics-aggregate.js.map

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

package/dist/os/session/handlers/metrics-rfc.d.ts

@@ -0,0 +1,4 @@
+export declare function generateRfcMetrics(workspaceRoot: string, rfcId: string, logger: {
+    warn: (msg: string) => void;
+}): Promise<string>;
+//# sourceMappingURL=metrics-rfc.d.ts.map

package/dist/os/session/handlers/metrics-rfc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-rfc.d.ts","sourceRoot":"","sources":["../../../../os/session/handlers/metrics-rfc.ts"],"names":[],"mappings":"AAqRA,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACtC,OAAO,CAAC,MAAM,CAAC,CAyDjB"}

package/dist/os/session/handlers/metrics-rfc.js

@@ -0,0 +1,272 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-1053: Generate per-RFC skill effectiveness metrics as structured YAML.
+Reconstructs the RFC pipeline (audit, enhance, plan, implement, review, fix)
+from git commit history, review reports, and verification evidence.
+Writes to docs/metrics/rfcs/<rfc-id>.metrics.yaml via writeFileAtomic.
+</purpose>
+<non-goals>
+  <item>Does not execute kernel commands — reads existing artifacts only.</item>
+  <item>Does not extract quantitative results from acceptance criteria.</item>
+  <item>Does not block the stamp on metrics failure — caller wraps in try/catch.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1053: initial generateRfcMetrics pure function.</item>
+</CHANGE_SUMMARY>
+*/
+import { execFile } from "node:child_process";
+import { readFile, readdir, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { writeFileAtomic } from "../../../src/utils/fs-atomic.js";
+import { parse as yamlParse, stringify as yamlStringify } from "yaml";
+import { METRICS_DIR, } from "../types.js";
+// ─── Git helper ──────────────────────────────────────────────────────────────
+function execGit(workspaceRoot, args) {
+    return new Promise((resolve) => {
+        execFile("git", args, { cwd: workspaceRoot, timeout: 10000 }, (err, stdout) => {
+            if (err) {
+                resolve("");
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+// ─── Pipeline step classification ────────────────────────────────────────────
+const STEP_PREFIXES = {
+    "audit:": { step: "audit", skill: "fo-idea-audit" },
+    "enhance:": { step: "enhance", skill: "fo-idea-enhance" },
+    "plan:": { step: "plan", skill: "fo-idea-plan" },
+    "implement:": { step: "implement", skill: "fo-idea-implement" },
+    "review:": { step: "review", skill: "fo-review" },
+    "fix:": { step: "fix", skill: "fo-fix" },
+    "evidence:": { step: "evidence", skill: null },
+    "test:": { step: "test", skill: null },
+    "docs:": { step: "docs", skill: null },
+    "trace:": { step: "trace", skill: null },
+};
+async function getRfcCommits(workspaceRoot, rfcId) {
+    const format = "%H%x1f%s%x1f%cI";
+    const raw = await execGit(workspaceRoot, [
+        "log",
+        "--no-merges",
+        `--grep=${rfcId}`,
+        `--format=${format}`,
+    ]);
+    if (!raw)
+        return [];
+    const entries = [];
+    const lines = raw.split("\n");
+    for (const line of lines) {
+        const parts = line.split("\x1f");
+        if (parts.length >= 3) {
+            entries.push({
+                sha: parts[0].trim(),
+                message: parts[1].trim(),
+                timestamp: parts[2].trim(),
+            });
+        }
+    }
+    return entries;
+}
+function classifyCommit(message) {
+    const firstLine = message.split("\n")[0] ?? "";
+    for (const [prefix, mapping] of Object.entries(STEP_PREFIXES)) {
+        if (firstLine.startsWith(prefix)) {
+            return mapping;
+        }
+    }
+    return null;
+}
+// ─── Review report parsing ───────────────────────────────────────────────────
+async function findReviewReport(workspaceRoot, rfcId) {
+    const reviewDir = join(workspaceRoot, "docs", "reviews", "code");
+    let files;
+    try {
+        files = await readdir(reviewDir, { recursive: true });
+    }
+    catch {
+        return null;
+    }
+    const rfcLower = rfcId.toLowerCase();
+    for (const file of files) {
+        if (!file.endsWith(".md"))
+            continue;
+        if (file.toLowerCase().includes(rfcLower)) {
+            try {
+                const content = await readFile(join(reviewDir, file), "utf-8");
+                return content;
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+function parseReviewReport(content) {
+    const findingsByAxis = {};
+    let findingsCount = 0;
+    let verdict = null;
+    const verdictMatch = content.match(/##\s*Verdict[:\s]+(.+)/i);
+    if (verdictMatch) {
+        verdict = verdictMatch[1].trim().toLowerCase();
+    }
+    const axisRegex = /##\s*Axis\s+[A-Z]\s*—\s*(.+)/gi;
+    let match;
+    while ((match = axisRegex.exec(content)) !== null) {
+        const axisName = match[1].trim();
+        const sectionStart = match.index + match[0].length;
+        const nextAxisMatch = content.slice(sectionStart).match(/##\s*Axis\s+[A-Z]\s*—/i);
+        const sectionEnd = nextAxisMatch ? sectionStart + nextAxisMatch.index : content.length;
+        const section = content.slice(sectionStart, sectionEnd);
+        const failMatches = section.match(/\*\*FAIL\*\*/g);
+        const failCount = failMatches ? failMatches.length : 0;
+        if (failCount > 0) {
+            findingsByAxis[axisName] = failCount;
+            findingsCount += failCount;
+        }
+    }
+    return { findingsCount, findingsByAxis, verdict };
+}
+// ─── Verification evidence parsing ───────────────────────────────────────────
+async function parseVerificationEvidence(workspaceRoot, rfcId) {
+    const rfcNum = rfcId.replace(/^RFC-/, "").toLowerCase();
+    const evidencePath = join(workspaceRoot, "docs", "rfcs", "verification", `rfc-${rfcNum}.generated.yaml`);
+    let content;
+    try {
+        content = await readFile(evidencePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const data = yamlParse(content);
+        const probes = Array.isArray(data["probes"])
+            ? data["probes"]
+            : [];
+        const probesTotal = probes.length;
+        const probesPassed = probes.filter((p) => p["ok"] === true).length;
+        return {
+            probesTotal,
+            probesPassed,
+            evidencePath: `docs/rfcs/verification/rfc-${rfcNum}.generated.yaml`,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Acceptance criteria parsing ─────────────────────────────────────────────
+async function parseAcceptanceCriteria(workspaceRoot, rfcId) {
+    const rfcDir = join(workspaceRoot, "docs", "rfcs");
+    let files;
+    try {
+        files = await readdir(rfcDir);
+    }
+    catch {
+        return { acceptanceCriteriaTotal: 0, acceptanceCriteriaMet: 0 };
+    }
+    const rfcLower = rfcId.toLowerCase();
+    const rfcFile = files.find((f) => f.toLowerCase().startsWith(rfcLower + "-") || f.toLowerCase().startsWith(rfcLower + "_"));
+    if (!rfcFile) {
+        return { acceptanceCriteriaTotal: 0, acceptanceCriteriaMet: 0 };
+    }
+    let content;
+    try {
+        content = await readFile(join(rfcDir, rfcFile), "utf-8");
+    }
+    catch {
+        return { acceptanceCriteriaTotal: 0, acceptanceCriteriaMet: 0 };
+    }
+    const acSectionMatch = content.match(/##\s*Acceptance\s+criteria[\s\S]*?(?=\n##\s|$)/i);
+    if (!acSectionMatch) {
+        return { acceptanceCriteriaTotal: 0, acceptanceCriteriaMet: 0 };
+    }
+    const acSection = acSectionMatch[0];
+    const totalMatches = acSection.match(/-\s*\[x\]/gi);
+    const uncheckedMatches = acSection.match(/-\s*\[\s\]/g);
+    const acceptanceCriteriaMet = totalMatches ? totalMatches.length : 0;
+    const acceptanceCriteriaUnmet = uncheckedMatches ? uncheckedMatches.length : 0;
+    return {
+        acceptanceCriteriaTotal: acceptanceCriteriaMet + acceptanceCriteriaUnmet,
+        acceptanceCriteriaMet,
+    };
+}
+// ─── Fix metrics parsing ─────────────────────────────────────────────────────
+function extractFixMetrics(commits) {
+    const fixCommits = commits.filter((c) => c.message.split("\n")[0].startsWith("fix:"));
+    if (fixCommits.length === 0)
+        return null;
+    return {
+        fixesApplied: fixCommits.length,
+        commitSha: fixCommits[fixCommits.length - 1].sha,
+        iterations: fixCommits.length,
+    };
+}
+// ─── Timings ─────────────────────────────────────────────────────────────────
+function computeTimings(commits) {
+    if (commits.length === 0) {
+        return { firstCommitAt: null, lastCommitAt: null, totalDurationMs: null };
+    }
+    const sorted = [...commits].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    const durationMs = new Date(last.timestamp).getTime() - new Date(first.timestamp).getTime();
+    return {
+        firstCommitAt: first.timestamp,
+        lastCommitAt: last.timestamp,
+        totalDurationMs: isNaN(durationMs) ? null : durationMs,
+    };
+}
+// ─── Main function ───────────────────────────────────────────────────────────
+export async function generateRfcMetrics(workspaceRoot, rfcId, logger) {
+    const commits = await getRfcCommits(workspaceRoot, rfcId);
+    const pipeline = [];
+    for (const commit of commits) {
+        const classified = classifyCommit(commit.message);
+        if (classified) {
+            pipeline.push({
+                step: classified.step,
+                skill: classified.skill,
+                commitSha: commit.sha,
+                timestamp: commit.timestamp,
+            });
+        }
+    }
+    let review = null;
+    try {
+        const reviewContent = await findReviewReport(workspaceRoot, rfcId);
+        if (reviewContent) {
+            review = parseReviewReport(reviewContent);
+        }
+    }
+    catch {
+        logger.warn(`[metrics] Could not parse review report for ${rfcId}`);
+    }
+    if (!review) {
+        review = { findingsCount: 0, findingsByAxis: {}, verdict: null };
+    }
+    const fix = extractFixMetrics(commits);
+    const verification = await parseVerificationEvidence(workspaceRoot, rfcId);
+    const result = await parseAcceptanceCriteria(workspaceRoot, rfcId);
+    const timings = computeTimings(commits);
+    const metrics = {
+        rfcId,
+        generatedAt: new Date().toISOString(),
+        pipeline,
+        review,
+        fix,
+        verification,
+        result,
+        timings,
+    };
+    const yamlContent = yamlStringify(metrics, { lineWidth: 120 });
+    const metricsFilePath = join(workspaceRoot, METRICS_DIR, "rfcs", `${rfcId.toLowerCase()}.metrics.yaml`);
+    await mkdir(dirname(metricsFilePath), { recursive: true });
+    await writeFileAtomic(metricsFilePath, yamlContent);
+    return `${METRICS_DIR}/rfcs/${rfcId.toLowerCase()}.metrics.yaml`;
+}
+//# sourceMappingURL=metrics-rfc.js.map

package/dist/os/session/handlers/metrics-rfc.js.map

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