@warpgogol/forge 4.1.6 → 4.2.1

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

@@ -0,0 +1,224 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+session.validate handler — checks session frontmatter schema (SES-01),
+id-filename match (SES-02), RFC-id existence (SES-03), raw file hygiene
+(SES-04), non-markdown file detection (SES-05), and missing checkpoint
+fields in implementation/mission sessions (SES-06, RFC-0884).
+</purpose>
+<non-goals>
+  <item>Does not move or modify files — that is session.archive.</item>
+  <item>Does not check transcript content quality — that is the fo-session-save skill.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: implement session.validate command handler.</item>
+  <item>RFC-0884: add SES-06 warning for missing checkpoint fields in implementation/mission sessions.</item>
+</CHANGE_SUMMARY>
+*/
+import path from "node:path";
+import { listSessionFiles, listNonMarkdownSessionFiles, listRawFiles, readAndParseSession, } from "../frontmatter-io.js";
+import { listRfcFiles, readAndParseRfc } from "../../rfc/frontmatter-io.js";
+import { SESSION_DIR, SESSION_KNOWN_KEYS, SESSION_REQUIRED_KEYS, SESSION_TYPES, SES_RULES, } from "../types.js";
+const RFC_DIR = "docs/rfcs";
+async function loadRfcIds(workspaceRoot) {
+    const rfcIds = new Set();
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const files = await listRfcFiles(rfcDirPath);
+    for (const fileName of files) {
+        const result = await readAndParseRfc(rfcDirPath, fileName);
+        const id = result && "parsed" in result ? String(result.parsed.frontmatter["id"] ?? "") : "";
+        if (id)
+            rfcIds.add(id);
+    }
+    return rfcIds;
+}
+export async function runSessionValidate(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const sessionDirPath = path.join(workspaceRoot, SESSION_DIR);
+    const targetId = input.flags["id"];
+    const allFiles = await listSessionFiles(sessionDirPath);
+    const filesToValidate = targetId
+        ? allFiles.filter((f) => path.basename(f).toLowerCase().startsWith(targetId.toLowerCase()))
+        : allFiles;
+    if (filesToValidate.length === 0) {
+        if (outputFormat === "pretty") {
+            logger.info("No session files found to validate.");
+        }
+        return {
+            data: {
+                command: "session.validate",
+                status: "pass",
+                violations: [],
+                checked: 0,
+            },
+            summary: "No session files found to validate",
+        };
+    }
+    const knownRfcIds = await loadRfcIds(workspaceRoot);
+    const knownKeys = new Set(SESSION_KNOWN_KEYS);
+    const violations = [];
+    for (const fileName of filesToValidate) {
+        const result = await readAndParseSession(sessionDirPath, fileName);
+        if (!result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const id = String(fm["id"] ?? "");
+        const relFile = path.join(SESSION_DIR, fileName);
+        const basename = path.basename(fileName, ".md");
+        // SES-01: Required frontmatter fields
+        for (const key of SESSION_REQUIRED_KEYS) {
+            if (!(key in fm) || fm[key] === undefined || fm[key] === null) {
+                violations.push({
+                    rule: SES_RULES.SES_01,
+                    file: relFile,
+                    message: `Required field "${key}" is missing`,
+                    severity: "error",
+                });
+            }
+        }
+        // SES-01: Check types is a valid array
+        // typesArray is also used by SES-06 below — hoisted here to make the coupling explicit.
+        const typesValue = fm["types"];
+        const typesArray = Array.isArray(typesValue) ? typesValue : [];
+        if (Array.isArray(typesValue)) {
+            for (const t of typesValue) {
+                if (!SESSION_TYPES.includes(t)) {
+                    violations.push({
+                        rule: SES_RULES.SES_01,
+                        file: relFile,
+                        message: `Invalid session type "${t}". Must be one of: ${SESSION_TYPES.join(", ")}`,
+                        severity: "error",
+                    });
+                }
+            }
+        }
+        else if (typesValue !== undefined) {
+            violations.push({
+                rule: SES_RULES.SES_01,
+                file: relFile,
+                message: `Field "types" must be an array`,
+                severity: "error",
+            });
+        }
+        // SES-01: Warn on unknown keys
+        for (const key of Object.keys(fm)) {
+            if (!knownKeys.has(key)) {
+                violations.push({
+                    rule: SES_RULES.SES_01,
+                    file: relFile,
+                    message: `Unknown frontmatter key "${key}"`,
+                    severity: "warning",
+                });
+            }
+        }
+        // SES-02: id matches filename
+        if (id && id !== basename) {
+            violations.push({
+                rule: SES_RULES.SES_02,
+                file: relFile,
+                message: `id "${id}" does not match filename "${basename}"`,
+                severity: "error",
+            });
+        }
+        // SES-03: relatedRfcs reference existing RFCs
+        const relatedRfcs = Array.isArray(fm["relatedRfcs"]) ? fm["relatedRfcs"] : [];
+        for (const rfcId of relatedRfcs) {
+            if (!knownRfcIds.has(rfcId)) {
+                violations.push({
+                    rule: SES_RULES.SES_03,
+                    file: relFile,
+                    message: `relatedRfcs references non-existent RFC "${rfcId}"`,
+                    severity: "error",
+                });
+            }
+        }
+        // SES-06: Missing checkpoint fields in implementation/mission sessions
+        // typesArray is extracted by SES-01 above.
+        const isImplOrMission = typesArray.includes("implementation") || typesArray.includes("mission");
+        if (isImplOrMission) {
+            const hasCheckpointFields = "systemDelta" in fm ||
+                "diagrams" in fm ||
+                "evidence" in fm ||
+                "remainingIssues" in fm ||
+                "checkpoint" in fm;
+            if (!hasCheckpointFields) {
+                violations.push({
+                    rule: SES_RULES.SES_06,
+                    file: relFile,
+                    message: "Implementation/mission session missing checkpoint frontmatter fields (systemDelta, diagrams, evidence, remainingIssues, checkpoint). Agent should populate these during fo-session-save.",
+                    severity: "warning",
+                });
+            }
+        }
+    }
+    // SES-04: Raw files in .raw/ that haven't been processed (warning)
+    const rawFiles = await listRawFiles(sessionDirPath);
+    for (const rawFile of rawFiles) {
+        violations.push({
+            rule: SES_RULES.SES_04,
+            file: path.join(SESSION_DIR, ".raw", rawFile),
+            message: `Unprocessed raw file in .raw/ — run session.save to convert`,
+            severity: "warning",
+        });
+    }
+    // SES-05: Non-markdown files in docs/sessions/ (excluding .raw/ and archive/)
+    const nonMdFiles = await listNonMarkdownSessionFiles(sessionDirPath);
+    for (const nonMdFile of nonMdFiles) {
+        violations.push({
+            rule: SES_RULES.SES_05,
+            file: path.join(SESSION_DIR, nonMdFile),
+            message: `Non-markdown file in docs/sessions/ — only .md files are allowed (excluding .raw/ and archive/)`,
+            severity: "error",
+        });
+    }
+    const hasErrors = violations.some((v) => v.severity === "error");
+    const resultStatus = hasErrors ? "fail" : "pass";
+    if (outputFormat === "pretty") {
+        if (violations.length === 0) {
+            logger.success(`All ${filesToValidate.length} session file(s) passed validation.`);
+        }
+        else {
+            logger.section(`Session Validation (${filesToValidate.length} file(s))`);
+            for (const v of violations) {
+                const prefix = v.severity === "error" ? "ERROR" : "WARN";
+                logger[v.severity === "error" ? "error" : "warn"](`[${prefix}] ${v.rule}: ${v.file}: ${v.message}`);
+            }
+            const errorCount = violations.filter((v) => v.severity === "error").length;
+            const warnCount = violations.filter((v) => v.severity === "warning").length;
+            const parts = [];
+            if (errorCount > 0)
+                parts.push(`${errorCount} error${errorCount === 1 ? "" : "s"}`);
+            if (warnCount > 0)
+                parts.push(`${warnCount} warning${warnCount === 1 ? "" : "s"}`);
+            const counts = parts.join(", ");
+            if (errorCount > 0) {
+                logger.error(counts);
+            }
+            else {
+                logger.warn(`${counts} — passed`);
+            }
+        }
+    }
+    return {
+        data: {
+            command: "session.validate",
+            status: resultStatus,
+            violations,
+            checked: filesToValidate.length,
+        },
+        exitCode: hasErrors ? 1 : 0,
+        summary: hasErrors
+            ? `${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} found`
+            : `All ${filesToValidate.length} session file(s) passed validation`,
+        nextSteps: hasErrors
+            ? [
+                {
+                    action: `Fix the ${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run session.validate`,
+                    kind: "required",
+                },
+            ]
+            : undefined,
+    };
+}
+//# sourceMappingURL=validate.js.map

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

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

package/dist/os/session/index.d.ts

@@ -0,0 +1,9 @@
+export { createForgeSessionModule } from "./session.module.ts";
+export { runSessionSave } from "./handlers/save.ts";
+export { runSessionArchive } from "./handlers/archive.ts";
+export { runSessionValidate } from "./handlers/validate.ts";
+export { runSessionList } from "./handlers/list.ts";
+export { parseSessionFile, listSessionFiles, listArchivedSessionFiles, readAndParseSession, listNonMarkdownSessionFiles, listRawFiles, type ParsedSession, } from "./frontmatter-io.ts";
+export { parseAtif, messagesToTranscriptMarkdown, type AtifMessage, type AtifParseResult, } from "./atif-parser.ts";
+export { SESSION_DIR, SESSION_RAW_SUBDIR, SESSION_ARCHIVE_SUBDIR, METRICS_DIR, SESSION_TYPES, SES_RULES, type SessionType, type SessionFrontmatter, type SessionSaveResult, type SessionArchiveResult, type SessionArchiveMove, type SessionArchiveSkip, type SessionValidationResult, type SessionValidationViolation, type SessionListResult, type SessionListEntry, type SesRule, type RfcMetrics, type RfcPipelineStep, type ReviewMetrics, type FixMetrics, type VerificationMetrics, type ResultMetrics, type RfcTimings, type SessionMetrics, type SessionDocumentRef, type SessionSkillInvocation, type InsightSummary, type SkillAggregate, type MetricsAggregateResult, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/os/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/session/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,4BAA4B,EAC5B,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC"}

package/dist/os/session/index.js

@@ -0,0 +1,21 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the session domain — types, module, and handlers.</purpose>
+<non-goals>
+  <item>Do not implement session logic here; delegate to handlers/ and session.module.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: initial session module barrel.</item>
+  <item>RFC-1053: export metrics types and METRICS_DIR constant.</item>
+</CHANGE_SUMMARY>
+*/
+export { createForgeSessionModule } from "./session.module.js";
+export { runSessionSave } from "./handlers/save.js";
+export { runSessionArchive } from "./handlers/archive.js";
+export { runSessionValidate } from "./handlers/validate.js";
+export { runSessionList } from "./handlers/list.js";
+export { parseSessionFile, listSessionFiles, listArchivedSessionFiles, readAndParseSession, listNonMarkdownSessionFiles, listRawFiles, } from "./frontmatter-io.js";
+export { parseAtif, messagesToTranscriptMarkdown, } from "./atif-parser.js";
+export { SESSION_DIR, SESSION_RAW_SUBDIR, SESSION_ARCHIVE_SUBDIR, METRICS_DIR, SESSION_TYPES, SES_RULES, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/os/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,YAAY,GAEb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,4BAA4B,GAG7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,SAAS,GAyBV,MAAM,YAAY,CAAC"}

package/dist/os/session/session.module.d.ts

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare function createForgeSessionModule(): Promise<ForgeModule>;
+//# sourceMappingURL=session.module.d.ts.map

package/dist/os/session/session.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.module.d.ts","sourceRoot":"","sources":["../../../os/session/session.module.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,WAAW,CAAC,CA2IrE"}

package/dist/os/session/session.module.js

@@ -0,0 +1,147 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the session documentation domain commands with the forge kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement handler logic here — delegate to handlers/*.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: initial forgeSessionModule registering session.save, session.archive, session.validate, session.list commands.</item>
+  <item>RFC-1053: register metrics.aggregate command for skill effectiveness metrics aggregation.</item>
+</CHANGE_SUMMARY>
+*/
+export async function createForgeSessionModule() {
+    const { runSessionSave } = await import("./handlers/save.js");
+    const { runSessionArchive } = await import("./handlers/archive.js");
+    const { runSessionValidate } = await import("./handlers/validate.js");
+    const { runSessionList } = await import("./handlers/list.js");
+    const { runMetricsAggregate } = await import("./handlers/metrics-aggregate.js");
+    return {
+        name: "forge-session",
+        version: "0.1.0",
+        runtime: "autonomous",
+        declarations: [],
+        commands: [
+            {
+                name: "session.save",
+                description: "Convert raw ATIF files from docs/sessions/.raw/ to structured markdown " +
+                    "in docs/sessions/ with auto-extracted metadata. Idempotent — same raw " +
+                    "file always produces the same output filename. Deletes raw file after " +
+                    "conversion unless --keep-raw. Use --raw-file to process a specific file.",
+                scope: "workspace",
+                mutatesState: true,
+                writes: ["docs/sessions/*.md"],
+                reads: ["docs/sessions/.raw/*"],
+                cacheable: false,
+                flags: {
+                    "raw-file": {
+                        kind: "string",
+                        description: "Process a specific raw file instead of scanning .raw/.",
+                    },
+                    "keep-raw": {
+                        kind: "boolean",
+                        description: "Do not delete raw file after conversion.",
+                    },
+                    "dry-run": {
+                        kind: "boolean",
+                        description: "Preview without writing files.",
+                    },
+                },
+                execute: runSessionSave,
+            },
+            {
+                name: "session.archive",
+                description: "Move session files older than --max-age-days (default 7) from " +
+                    "docs/sessions/ to docs/sessions/archive/. Bidirectional: files in " +
+                    "archive/ younger than threshold are moved back to docs/sessions/. " +
+                    "Use --dry-run to preview. Age is computed from frontmatter date, " +
+                    "not filesystem mtime. Prefer the docs.archive umbrella command " +
+                    "unless you need to archive only sessions.",
+                scope: "workspace",
+                mutatesState: true,
+                writes: ["docs/sessions/*.md", "docs/sessions/archive/**"],
+                reads: ["docs/sessions/**/*.md"],
+                cacheable: false,
+                flags: {
+                    "max-age-days": {
+                        kind: "string",
+                        description: "Age threshold in days (default 7).",
+                    },
+                    "dry-run": {
+                        kind: "boolean",
+                        description: "Preview what would be moved without touching the filesystem.",
+                    },
+                },
+                execute: runSessionArchive,
+            },
+            {
+                name: "session.validate",
+                contract: "session",
+                rules: [],
+                description: "Validate session frontmatter schema (SES-01), id-filename match (SES-02), " +
+                    "RFC-id existence (SES-03), raw file hygiene (SES-04), and non-markdown " +
+                    "file detection (SES-05). Pass --id to validate a single file, " +
+                    "or run without arguments for all. On-demand only — not integrated into " +
+                    "build.check.",
+                scope: "workspace",
+                flags: {
+                    id: { kind: "string", description: "Target a single session by id." },
+                },
+                reads: ["docs/sessions/**/*.md", "docs/rfcs/**/*.md"],
+                execute: runSessionValidate,
+            },
+            {
+                name: "session.list",
+                description: "List all sessions. Filter with --date-from, --date-to, --rfc, --type flags. " +
+                    "Use --json for machine-readable output. Parses frontmatter on the fly. " +
+                    "Includes archived sessions (marked with archived: true).",
+                scope: "workspace",
+                flags: {
+                    "date-from": {
+                        kind: "string",
+                        description: "Filter sessions from this date (YYYY-MM-DD, inclusive).",
+                    },
+                    "date-to": {
+                        kind: "string",
+                        description: "Filter sessions up to this date (YYYY-MM-DD, inclusive).",
+                    },
+                    rfc: {
+                        kind: "string",
+                        description: "Filter by related RFC id (e.g. RFC-0537).",
+                    },
+                    type: {
+                        kind: "string",
+                        description: "Filter by session type (mission, grilling, implementation, review, fix, freeform).",
+                    },
+                },
+                reads: ["docs/sessions/**/*.md"],
+                execute: runSessionList,
+            },
+            {
+                name: "metrics.aggregate",
+                description: "Query and aggregate skill effectiveness metrics from docs/metrics/ files. " +
+                    "Returns per-skill statistics (invocations, avgFindings, avgFixIterations, avgDurationMs). " +
+                    "Use --skill to filter by skill name, --since/--until for date range.",
+                scope: "workspace",
+                flags: {
+                    skill: {
+                        kind: "string",
+                        description: "Filter by skill name (e.g. fo-review).",
+                    },
+                    since: {
+                        kind: "string",
+                        description: "Only include metrics generated since this date (YYYY-MM-DD).",
+                    },
+                    until: {
+                        kind: "string",
+                        description: "Only include metrics generated until this date (YYYY-MM-DD).",
+                    },
+                },
+                reads: ["docs/metrics/**/*.yaml"],
+                execute: runMetricsAggregate,
+            },
+        ],
+        pipelines: [],
+    };
+}
+//# sourceMappingURL=session.module.js.map

package/dist/os/session/session.module.js.map

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

package/dist/os/session/types.d.ts

@@ -0,0 +1,214 @@
+export declare const SESSION_DIR = "docs/sessions";
+export declare const SESSION_RAW_SUBDIR = ".raw";
+export declare const SESSION_ARCHIVE_SUBDIR = "archive";
+export declare const METRICS_DIR = "docs/metrics";
+export declare const SESSION_ID_PATTERN: RegExp;
+export declare const SESSION_FILE_PATTERN: RegExp;
+export declare const SESSION_TYPES: readonly ["mission", "grilling", "implementation", "review", "fix", "freeform"];
+export type SessionType = (typeof SESSION_TYPES)[number];
+export declare const SESSION_KNOWN_KEYS: readonly ["id", "date", "duration", "types", "summary", "relatedRfcs", "relatedArtifacts", "decisions", "commits", "files", "commands", "systemDelta", "diagrams", "evidence", "remainingIssues", "checkpoint"];
+export declare const SESSION_REQUIRED_KEYS: readonly ["id", "date", "types"];
+export declare const SESSION_REQUIRED_SECTIONS: readonly ["## Transcript"];
+export declare const SES_RULES: {
+    readonly SES_01: "SES-01";
+    readonly SES_02: "SES-02";
+    readonly SES_03: "SES-03";
+    readonly SES_04: "SES-04";
+    readonly SES_05: "SES-05";
+    readonly SES_06: "SES-06";
+};
+export type SesRule = (typeof SES_RULES)[keyof typeof SES_RULES];
+export interface SessionCheckpoint {
+    before: string;
+    change: string;
+    after: string;
+}
+export interface SessionDiagram {
+    type: "flowchart" | "sequenceDiagram" | "stateDiagram-v2" | "erDiagram" | "none";
+    scope: "current-system" | "session-delta";
+    caption: string;
+    mermaid: string;
+}
+export interface SessionEvidenceEntry {
+    claim: string;
+    source?: string;
+    test?: string;
+    command?: string;
+}
+export interface SessionSystemDelta {
+    changedContracts: string[];
+    changedSchemas: string[];
+    changedStateMachines: string[];
+    changedInvariants: string[];
+    changedPersistence: string[];
+}
+export interface SessionFrontmatter {
+    id: string;
+    date: string;
+    duration: string | null;
+    types: SessionType[];
+    summary: string;
+    relatedRfcs: string[];
+    relatedArtifacts: string[];
+    decisions: string[];
+    commits: string[];
+    files: string[];
+    commands: string[];
+    systemDelta?: SessionSystemDelta;
+    diagrams?: SessionDiagram[];
+    evidence?: SessionEvidenceEntry[];
+    remainingIssues?: string[];
+    checkpoint?: SessionCheckpoint;
+}
+export interface SessionSaveResult {
+    command: "session.save";
+    status: "ok";
+    file: string;
+    rawFile: string;
+    rawDeleted: boolean;
+    id: string;
+    types: SessionType[];
+    extractedMetadata: {
+        relatedRfcs: string[];
+        relatedArtifacts: string[];
+        commits: string[];
+        files: string[];
+        commands: string[];
+    };
+    metricsPath?: string;
+    dryRun: boolean;
+}
+export interface SessionSaveSkip {
+    rawFile: string;
+    reason: string;
+}
+export interface SessionArchiveMove {
+    id: string;
+    file: string;
+    from: string;
+    to: string;
+    ageDays: number;
+    direction: "into-archive" | "out-of-archive";
+}
+export interface SessionArchiveSkip {
+    id: string;
+    file: string;
+    reason: string;
+}
+export interface SessionArchiveResult {
+    command: "session.archive";
+    status: "ok";
+    moved: SessionArchiveMove[];
+    skipped: SessionArchiveSkip[];
+    maxAgeDays: number;
+    dryRun: boolean;
+}
+export interface SessionValidationViolation {
+    rule: SesRule;
+    file: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface SessionValidationResult {
+    command: "session.validate";
+    status: "pass" | "fail";
+    violations: SessionValidationViolation[];
+    checked: number;
+}
+export interface SessionListEntry {
+    id: string;
+    date: string;
+    types: SessionType[];
+    summary: string;
+    relatedRfcs: string[];
+    file: string;
+    archived: boolean;
+}
+export interface SessionListResult {
+    command: "session.list";
+    status: "ok";
+    sessions: SessionListEntry[];
+    count: number;
+}
+export interface RfcPipelineStep {
+    step: string;
+    skill: string | null;
+    commitSha: string | null;
+    timestamp: string | null;
+}
+export interface ReviewMetrics {
+    findingsCount: number;
+    findingsByAxis: Record<string, number>;
+    verdict: string | null;
+}
+export interface FixMetrics {
+    fixesApplied: number;
+    commitSha: string | null;
+    iterations: number;
+}
+export interface VerificationMetrics {
+    probesTotal: number;
+    probesPassed: number;
+    evidencePath: string | null;
+}
+export interface ResultMetrics {
+    acceptanceCriteriaTotal: number;
+    acceptanceCriteriaMet: number;
+}
+export interface RfcTimings {
+    firstCommitAt: string | null;
+    lastCommitAt: string | null;
+    totalDurationMs: number | null;
+}
+export interface RfcMetrics {
+    rfcId: string;
+    generatedAt: string;
+    pipeline: RfcPipelineStep[];
+    review: ReviewMetrics | null;
+    fix: FixMetrics | null;
+    verification: VerificationMetrics | null;
+    result: ResultMetrics;
+    timings: RfcTimings;
+}
+export interface SessionDocumentRef {
+    rfcId: string;
+    status: string;
+    metricsFile: string | null;
+}
+export interface SessionSkillInvocation {
+    skill: string;
+    approximateDurationMs: number | null;
+}
+export interface InsightSummary {
+    total: number;
+    byCategory: Record<string, number>;
+}
+export interface SessionMetrics {
+    sessionId: string;
+    generatedAt: string;
+    date: string;
+    durationMs: number;
+    approximateDurations: true;
+    documents: SessionDocumentRef[];
+    skills: SessionSkillInvocation[];
+    insights: InsightSummary | null;
+    commits: string[];
+}
+export interface SkillAggregate {
+    skill: string;
+    invocations: number;
+    avgFindings: number | null;
+    avgFixIterations: number | null;
+    avgDurationMs: number | null;
+}
+export interface MetricsAggregateResult {
+    command: "metrics.aggregate";
+    status: "ok";
+    skill: string | "all";
+    since: string | null;
+    until: string | null;
+    perSkill: SkillAggregate[];
+    totalRfcs: number;
+    totalSessions: number;
+}
+//# sourceMappingURL=types.d.ts.map