@warpgogol/forge 2.1.0 → 2.3.0

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

@@ -0,0 +1,115 @@
+/*
+<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>
+</CHANGE_SUMMARY>
+*/
+export const forgeSessionModule = {
+    name: "forge-session",
+    version: "0.1.0",
+    async register(registry) {
+        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");
+        registry.registerCommand({
+            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,
+        });
+        registry.registerCommand({
+            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,
+        });
+        registry.registerCommand({
+            name: "session.validate",
+            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,
+        });
+        registry.registerCommand({
+            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,
+        });
+    },
+};
+//# 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,101 @@
+export declare const SESSION_DIR = "docs/sessions";
+export declare const SESSION_RAW_SUBDIR = ".raw";
+export declare const SESSION_ARCHIVE_SUBDIR = "archive";
+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"];
+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";
+};
+export type SesRule = (typeof SES_RULES)[keyof typeof SES_RULES];
+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[];
+}
+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[];
+    };
+    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;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/os/session/types.js

@@ -0,0 +1,52 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Type definitions and constants for the session documentation domain —
+session frontmatter, list/archive/validate/save result shapes, and SES
+validation rule identifiers.
+</purpose>
+<non-goals>
+  <item>Do not define handler logic here — that lives in handlers/*.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: initial session domain types, constants, and SES rule identifiers.</item>
+</CHANGE_SUMMARY>
+*/
+export const SESSION_DIR = "docs/sessions";
+export const SESSION_RAW_SUBDIR = ".raw";
+export const SESSION_ARCHIVE_SUBDIR = "archive";
+export const SESSION_ID_PATTERN = /^\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2}-[0-9a-f]{6}$/;
+export const SESSION_FILE_PATTERN = /^\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2}-[0-9a-f]{6}\.md$/;
+export const SESSION_TYPES = [
+    "mission",
+    "grilling",
+    "implementation",
+    "review",
+    "fix",
+    "freeform",
+];
+export const SESSION_KNOWN_KEYS = [
+    "id",
+    "date",
+    "duration",
+    "types",
+    "summary",
+    "relatedRfcs",
+    "relatedArtifacts",
+    "decisions",
+    "commits",
+    "files",
+    "commands",
+];
+export const SESSION_REQUIRED_KEYS = ["id", "date", "types"];
+export const SESSION_REQUIRED_SECTIONS = ["## Transcript"];
+// SES validation rules
+export const SES_RULES = {
+    SES_01: "SES-01",
+    SES_02: "SES-02",
+    SES_03: "SES-03",
+    SES_04: "SES-04",
+    SES_05: "SES-05",
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/session/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,mDAAmD,CAAC;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,uDAAuD,CAAC;AAE5F,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS;IACT,UAAU;IACV,gBAAgB;IAChB,QAAQ;IACR,KAAK;IACL,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI;IACJ,MAAM;IACN,UAAU;IACV,OAAO;IACP,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,WAAW;IACX,SAAS;IACT,OAAO;IACP,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,eAAe,CAAU,CAAC;AAEpE,uBAAuB;AACvB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/dist/os/spec/live-spec-list.d.ts

@@ -0,0 +1,4 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+import type { SpecLiveListResult } from "./live-spec-types.ts";
+export declare function runSpecLiveList(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<SpecLiveListResult>>;
+//# sourceMappingURL=live-spec-list.d.ts.map

package/dist/os/spec/live-spec-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-spec-list.d.ts","sourceRoot":"","sources":["../../../os/spec/live-spec-list.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,sBAAsB,CAAC;AAIlF,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAiDjD"}

package/dist/os/spec/live-spec-list.js

@@ -0,0 +1,64 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.live.list handler — lists all living specs in docs/specs/live/ (RFC-0711).</purpose>
+<non-goals>
+  <item>Do not merge or validate — use spec.live.merge / spec.live.validate.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0711: initial spec.live.list handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+const LIVE_SPECS_DIR = "docs/specs/live";
+export async function runSpecLiveList(_input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const liveSpecsDir = path.join(workspaceRoot, LIVE_SPECS_DIR);
+    const entries = [];
+    if (existsSync(liveSpecsDir)) {
+        const files = await fs.readdir(liveSpecsDir);
+        for (const file of files) {
+            if (!file.endsWith(".md") || file === "README.md")
+                continue;
+            const filePath = path.join(liveSpecsDir, file);
+            const content = await fs.readFile(filePath, "utf-8");
+            const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (!match)
+                continue;
+            const fm = (YAML.parse(match[1]) ?? {});
+            entries.push({
+                domain: String(fm["domain"] ?? ""),
+                title: String(fm["title"] ?? ""),
+                lastMergedRfc: String(fm["lastMergedRfc"] ?? ""),
+                updatedAt: String(fm["updatedAt"] ?? ""),
+                historyCount: Array.isArray(fm["history"]) ? fm["history"].length : 0,
+            });
+        }
+    }
+    entries.sort((a, b) => a.domain.localeCompare(b.domain));
+    const result = {
+        command: "spec.live.list",
+        status: "ok",
+        livingSpecs: entries,
+    };
+    if (outputFormat === "pretty") {
+        if (entries.length === 0) {
+            logger.info("spec.live.list: no living specs found");
+        }
+        else {
+            logger.section(`Living Specs (${entries.length})`);
+            for (const entry of entries) {
+                logger.info(`  ${entry.domain} — ${entry.title} (last: ${entry.lastMergedRfc})`);
+            }
+        }
+    }
+    return {
+        data: result,
+        exitCode: 0,
+        summary: `spec.live.list: ${entries.length} living spec(s)`,
+    };
+}
+//# sourceMappingURL=live-spec-list.js.map

package/dist/os/spec/live-spec-list.js.map

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

package/dist/os/spec/live-spec-merge.d.ts

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

package/dist/os/spec/live-spec-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-spec-merge.d.ts","sourceRoot":"","sources":["../../../os/spec/live-spec-merge.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAKV,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAgJ9B,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAwOlD"}