@warpgogol/forge 2.1.0 → 2.2.0

package/dist/os/naming/naming-convention.js

@@ -0,0 +1,324 @@
+/*
+<MODULE_CONTRACT>
+<purpose>naming.convention.lint — validates that every filename in registered repo roots
+uses kebab-case (lowercase letters, digits, hyphens only), with documented exemptions.</purpose>
+<non-goals>
+  <item>Do not introduce app-specific runtime composition or deployment behavior into this reusable package source file.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0303: split out of structure.ts (Phase 3 file-size split).</item>
+  <item>RFC-0360: extend scan roots from apps/ and packages/ to the whole repo.</item>
+</CHANGE_SUMMARY>
+*/
+import { basename, join, relative } from "node:path";
+import { readFile } from "node:fs/promises";
+import { readdirSync } from "node:fs";
+import { collectFiles } from "../../src/utils/fs.js";
+// @ai-invariant The exception rules below are the canonical source for naming.convention.lint.
+// Update naming-conventions.md (packages/site-kernel/docs/) when these rules change.
+// RFC-0360: Registered recursive roots — scanned recursively for filename violations.
+const NAMING_CONVENTION_RECURSIVE_ROOTS = [
+    "apps",
+    "packages",
+    "services",
+    "docs",
+    "integrations",
+    "onboarding",
+    "fleet",
+    "hooks",
+    "tools",
+    "scripts",
+    "systems",
+    "tsconfig",
+];
+// RFC-0360: Registered ephemeral roots — root name validated, contents skipped unless --include-ignored.
+const NAMING_CONVENTION_EPHEMERAL_ROOTS = ["missions", "releases", "agents", ".werkstatt"];
+// RFC-0360: Tool/cache directories that are never scanned at any level.
+const NAMING_CONVENTION_IGNORED_TOP_LEVEL = new Set([
+    "node_modules",
+    ".git",
+    ".turbo",
+    ".astro",
+    ".wrangler",
+    ".vscode",
+    ".idea",
+    "coverage",
+    ".changelog-system",
+    ".codex-runlogs",
+    ".agents",
+    ".claude",
+    ".github",
+    ".opencode",
+    ".windsurf",
+    ".cache",
+    "tmp",
+]);
+// Tool-mandated filenames exempt from kebab-case (Docker, Caddy use these exact names).
+const NAMING_CONVENTION_TOOL_MANDATED = new Set(["Dockerfile", "Caddyfile"]);
+const NAMING_CONVENTION_IGNORED_DIRS = new Set([
+    "node_modules",
+    "dist",
+    ".git",
+    ".turbo",
+    ".astro",
+    ".wrangler",
+    ".vscode",
+    ".idea",
+    "coverage",
+    "spec",
+    "todo",
+    // Generated, gitignored media-artifact dirs under public/ — their filenames are owned by the
+    // generators, not authored: RFC-0204 responsive image variants (_img) and RFC-0210 video
+    // variants / HLS segments (_video, e.g. "1080p_000.ts", where ".ts" is MPEG-TS, not TypeScript).
+    "_img",
+    "_video",
+    // DB migration dirs follow the ordered tool convention "NNN_name.sql" (Supabase/Postgres,
+    // RFC-0186) — the numeric-underscore prefix is required for ordering and is not authored prose.
+    "migrations",
+]);
+const NAMING_CONVENTION_EXEMPT_KEYWORDS = ["config", "module"];
+// Set of directory paths that are exempt from naming convention (generated files)
+const NAMING_CONVENTION_EXEMPT_DIRS = new Set([
+    "components/icons/gen", // Generated icon components — naming controlled by generator
+]);
+/**
+ * Returns true when a filename is exempt from kebab-case enforcement.
+ *
+ * Exemptions (see naming-conventions.md for the canonical description):
+ *   1. File name starts with a dot (.env, .gitignore, ...).
+ *   2. File name starts with an underscore (_shared.ts, _headers, etc.).
+ *   3. File name is ALLCAPS (AGENTS.md, README.md, LICENSE, etc.).
+ *   4. File name (full, including extension) contains "config" or "module".
+ *   5. File is in an exempt directory (components/icons/gen — generated files).
+ *   6. Base icon component (LordIconBase.astro) — used by generated icon components.
+ */
+function isNamingExempt(fileName, filePath) {
+    if (fileName.startsWith("."))
+        return true;
+    if (fileName.startsWith("_"))
+        return true;
+    if (NAMING_CONVENTION_TOOL_MANDATED.has(fileName))
+        return true;
+    // SHOUTY_SNAKE_CASE files are exempt (AGENTS.md, README.md, LICENSE,
+    // ICONS_GENERATE.md, etc.). RFC-0132 extension: the check uses the FIRST
+    // stem segment so multi-segment names like AGENTS.template.md and
+    // SCHEMA.draft.md inherit the exemption from their canonical first segment
+    // — this is intentional for template files whose generated artifact carries
+    // the canonical name (AGENTS.template.md → AGENTS.md after agents.generate).
+    const firstDotIndex = fileName.indexOf(".");
+    const firstStem = firstDotIndex > 0 ? fileName.slice(0, firstDotIndex) : fileName;
+    if (firstStem.length > 0 && /^[A-Z]+(_[A-Z]+)*$/.test(firstStem))
+        return true;
+    for (const keyword of NAMING_CONVENTION_EXEMPT_KEYWORDS) {
+        if (fileName.includes(keyword))
+            return true;
+    }
+    // Check if file is in an exempt directory
+    if (filePath) {
+        for (const exemptDir of NAMING_CONVENTION_EXEMPT_DIRS) {
+            if (filePath.includes(exemptDir))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns true when a filename violates the kebab-case convention.
+ * Violations: underscores OR mixed-case (PascalCase, camelCase).
+ * Note: ALLCAPS files are exempt, not violations.
+ * Only called when the file is not already exempt.
+ */
+function hasNamingViolation(fileName) {
+    const dotIndex = fileName.lastIndexOf(".");
+    const stem = dotIndex > 0 ? fileName.slice(0, dotIndex) : fileName;
+    // kebab-case allows only lowercase letters, digits, and hyphens
+    // Violations: underscores OR mixed-case (contains both upper and lower)
+    if (stem.includes("_"))
+        return true;
+    // Mixed case: has at least one uppercase AND at least one lowercase
+    const hasUpper = /[A-Z]/.test(stem);
+    const hasLower = /[a-z]/.test(stem);
+    return hasUpper && hasLower;
+}
+/**
+ * Reads a gitignore-style file and returns a set of simple (no-wildcard) patterns.
+ * Patterns containing `*` or `?` are skipped — too complex without a full gitignore engine.
+ */
+async function readSimpleIgnorePatterns(filePath) {
+    const patterns = new Set();
+    try {
+        const content = await readFile(filePath, "utf8");
+        for (const rawLine of content.split("\n")) {
+            const line = rawLine.trim();
+            if (!line || line.startsWith("#"))
+                continue;
+            if (line.includes("*") || line.includes("?"))
+                continue;
+            patterns.add(line.replace(/^\//, "").replace(/\/$/, ""));
+        }
+    }
+    catch {
+        // File absent — silently skip
+    }
+    return patterns;
+}
+function isSegmentIgnored(relPath, ignorePatterns) {
+    for (const segment of relPath.split("/")) {
+        if (ignorePatterns.has(segment))
+            return true;
+    }
+    return false;
+}
+async function collectAllFilesForNaming(dirPath, ignorePatterns) {
+    return collectFiles(dirPath, {
+        ignore: (name) => name.startsWith(".") ||
+            NAMING_CONVENTION_IGNORED_DIRS.has(name) ||
+            ignorePatterns.has(name) ||
+            ignorePatterns.has(`${name}/`),
+    });
+}
+function isRegisteredOrIgnoredTopLevel(name) {
+    return (NAMING_CONVENTION_RECURSIVE_ROOTS.includes(name) ||
+        NAMING_CONVENTION_EPHEMERAL_ROOTS.includes(name) ||
+        NAMING_CONVENTION_IGNORED_TOP_LEVEL.has(name));
+}
+function resolveScanPlan(repoRoot) {
+    let entries;
+    try {
+        entries = readdirSync(repoRoot, { withFileTypes: true });
+    }
+    catch {
+        return {
+            recursiveRoots: [...NAMING_CONVENTION_RECURSIVE_ROOTS],
+            ephemeralRoots: [...NAMING_CONVENTION_EPHEMERAL_ROOTS],
+            unknown: [],
+        };
+    }
+    const topLevelDirs = entries
+        .filter((e) => e.isDirectory() && !e.isSymbolicLink())
+        .map((e) => e.name);
+    const unknown = topLevelDirs.filter((name) => !isRegisteredOrIgnoredTopLevel(name));
+    const recursiveRoots = NAMING_CONVENTION_RECURSIVE_ROOTS.filter((name) => topLevelDirs.includes(name));
+    const ephemeralRoots = NAMING_CONVENTION_EPHEMERAL_ROOTS.filter((name) => topLevelDirs.includes(name));
+    return { recursiveRoots, ephemeralRoots, unknown };
+}
+/**
+ * Validates that all filenames in registered repo roots use kebab-case.
+ *
+ * Rule: filenames must use only lowercase letters, digits, and hyphens.
+ * Violations: underscores, uppercase letters (PascalCase, camelCase, ALLCAPS).
+ *
+ * Exceptions (not flagged):
+ *   - Files starting with a dot (.env, .gitignore)
+ *   - Files starting with an underscore (_shared.ts, _headers, _redirects, _routes.json)
+ *   - Tool-mandated filenames (Dockerfile, Caddyfile)
+ *   - Files containing "config" or "module" in their name (astro.config.mjs, check.module.ts)
+ *   - Files in directories starting with a dot (.git, .astro, .vscode)
+ *   - Files excluded by .gitignore or .windsurfignore (simple non-wildcard patterns only)
+ *
+ * See packages/site-kernel/docs/naming-conventions.md — "Global Rule" section.
+ */
+export async function runNamingConventionLint(input, context) {
+    const workspaceRoot = context.workspaceRoot;
+    const includeIgnored = input.flags["include-ignored"] === true;
+    const gitignorePatterns = await readSimpleIgnorePatterns(join(workspaceRoot, ".gitignore"));
+    const windsurfignorePatterns = await readSimpleIgnorePatterns(join(workspaceRoot, ".windsurfignore"));
+    const ignorePatterns = new Set([...gitignorePatterns, ...windsurfignorePatterns]);
+    let violations = 0;
+    let checkedFiles = 0;
+    // App-scoped mode: scan only the app directory
+    if (context.site) {
+        const files = await collectAllFilesForNaming(context.site.directory, ignorePatterns);
+        for (const filePath of files) {
+            const fileName = basename(filePath);
+            const relPath = relative(workspaceRoot, filePath).replace(/\\/g, "/");
+            if (isNamingExempt(fileName, relPath))
+                continue;
+            if (isSegmentIgnored(relPath, ignorePatterns))
+                continue;
+            checkedFiles += 1;
+            if (hasNamingViolation(fileName)) {
+                context.logger.error(`${relPath}: "${fileName}" violates kebab-case — use only lowercase letters, digits, and hyphens`);
+                violations += 1;
+            }
+        }
+        return {
+            data: { violations, checkedFiles },
+            exitCode: violations > 0 ? 1 : 0,
+            summary: violations > 0
+                ? undefined
+                : `[naming.convention] OK (${checkedFiles} non-exempt files checked)`,
+        };
+    }
+    // Workspace-scoped mode: resolve scan plan from filesystem
+    const scanPlan = resolveScanPlan(workspaceRoot);
+    // Report unknown top-level directories
+    for (const unknownDir of scanPlan.unknown) {
+        context.logger.error(`[naming.convention.lint] unknown top-level directory '${unknownDir}'; register it or remove it`);
+        violations += 1;
+    }
+    // Validate ephemeral root names (kebab-case check on the root name itself)
+    for (const ephemeral of scanPlan.ephemeralRoots) {
+        const name = ephemeral.startsWith(".") ? ephemeral.slice(1) : ephemeral;
+        if (name && !name.includes("_") && !(/[A-Z]/.test(name) && /[a-z]/.test(name))) {
+            // ok
+        }
+        else if (name && (name.includes("_") || (/[A-Z]/.test(name) && /[a-z]/.test(name)))) {
+            context.logger.error(`[naming.convention.lint] top-level directory '${ephemeral}' violates naming convention`);
+            violations += 1;
+        }
+    }
+    // Scan recursive roots
+    for (const rootName of scanPlan.recursiveRoots) {
+        const scanDir = join(workspaceRoot, rootName);
+        const files = await collectAllFilesForNaming(scanDir, ignorePatterns);
+        for (const filePath of files) {
+            const fileName = basename(filePath);
+            const relPath = relative(workspaceRoot, filePath).replace(/\\/g, "/");
+            if (isNamingExempt(fileName, relPath))
+                continue;
+            if (isSegmentIgnored(relPath, ignorePatterns))
+                continue;
+            checkedFiles += 1;
+            if (hasNamingViolation(fileName)) {
+                context.logger.error(`${relPath}: "${fileName}" violates kebab-case — use only lowercase letters, digits, and hyphens`);
+                violations += 1;
+            }
+        }
+    }
+    // Scan ephemeral root contents only when --include-ignored is passed
+    if (includeIgnored) {
+        for (const rootName of scanPlan.ephemeralRoots) {
+            const scanDir = join(workspaceRoot, rootName);
+            const files = await collectAllFilesForNaming(scanDir, ignorePatterns);
+            for (const filePath of files) {
+                const fileName = basename(filePath);
+                const relPath = relative(workspaceRoot, filePath).replace(/\\/g, "/");
+                if (isNamingExempt(fileName, relPath))
+                    continue;
+                if (isSegmentIgnored(relPath, ignorePatterns))
+                    continue;
+                checkedFiles += 1;
+                if (hasNamingViolation(fileName)) {
+                    context.logger.error(`${relPath}: "${fileName}" violates kebab-case — use only lowercase letters, digits, and hyphens`);
+                    violations += 1;
+                }
+            }
+        }
+    }
+    return {
+        data: {
+            violations,
+            checkedFiles,
+            scannedRoots: scanPlan.recursiveRoots,
+            ephemeralRootsSkipped: includeIgnored ? [] : scanPlan.ephemeralRoots,
+            unknownTopLevelDirs: scanPlan.unknown,
+        },
+        exitCode: violations > 0 ? 1 : 0,
+        summary: violations > 0
+            ? undefined
+            : `[naming.convention] OK (${checkedFiles} non-exempt files checked)`,
+    };
+}
+//# sourceMappingURL=naming-convention.js.map

package/dist/os/naming/naming-convention.js.map

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

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

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare const forgeNamingModule: ForgeModule;
+//# sourceMappingURL=naming.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naming.module.d.ts","sourceRoot":"","sources":["../../../os/naming/naming.module.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,iBAAiB,EAAE,WAqB/B,CAAC"}

package/dist/os/naming/naming.module.js

@@ -0,0 +1,33 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the forge naming convention lint command with the Site OS kernel registry.</purpose>
+<non-goals>
+  <item>Do not register project-specific naming commands (naming.pages.lint, etc.) — those stay in site-kernel-checks.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial forgeNamingModule registering naming.convention.lint.</item>
+</CHANGE_SUMMARY>
+*/
+export const forgeNamingModule = {
+    name: "forge-naming",
+    version: "0.1.0",
+    async register(registry) {
+        const { runNamingConventionLint } = await import("./naming-convention.js");
+        registry.registerCommand({
+            name: "naming.convention.lint",
+            description: "Validate all filenames use kebab-case (no underscores) across registered workspace roots.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: {
+                "include-ignored": {
+                    kind: "boolean",
+                    description: "Also scan files ignored by .gitignore or .windsurfignore.",
+                },
+            },
+            reads: ["packages/**/*.{ts,tsx}", "apps/**/*.{ts,tsx}", "services/**/*.{ts,tsx}"],
+            execute: runNamingConventionLint,
+        });
+    },
+};
+//# sourceMappingURL=naming.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naming.module.js","sourceRoot":"","sources":["../../../os/naming/naming.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC5C,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC3E,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EACT,2FAA2F;YAC7F,KAAK,EAAE,WAAW;YAClB,gBAAgB,EAAE,IAAI;YACtB,KAAK,EAAE;gBACL,iBAAiB,EAAE;oBACjB,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2DAA2D;iBACzE;aACF;YACD,KAAK,EAAE,CAAC,wBAAwB,EAAE,oBAAoB,EAAE,wBAAwB,CAAC;YACjF,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,2 @@
+export { forgeNotesModule } from "./notes.module.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/notes/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/os/notes/index.js

@@ -0,0 +1,10 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Re-export forgeNotesModule and note validator handlers.</purpose>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0808: initial notes module index.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeNotesModule } from "./notes.module.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/notes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;EAOE;AAEF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare const forgeNotesModule: ForgeModule;
+//# sourceMappingURL=notes.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes.module.d.ts","sourceRoot":"","sources":["../../../os/notes/notes.module.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAO7D,eAAO,MAAM,gBAAgB,EAAE,WA0F9B,CAAC"}

package/dist/os/notes/notes.module.js

@@ -0,0 +1,83 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register note validation commands (note.link.validate, note.frontmatter.validate, note.orphan.detect) with the forge kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement handler logic here — delegate to src/validators/.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0808: initial forgeNotesModule registering 3 note validation commands.</item>
+</CHANGE_SUMMARY>
+*/
+export const forgeNotesModule = {
+    name: "forge-notes",
+    version: "0.1.0",
+    async register(registry) {
+        const { runNoteLinkValidate } = await import("../../src/validators/note-link-validate.js");
+        const { runNoteFrontmatterValidate } = await import("../../src/validators/note-frontmatter-validate.js");
+        const { runNoteOrphanDetect } = await import("../../src/validators/note-orphan-detect.js");
+        const noteLinkValidateWrapper = async (input, context) => {
+            return runNoteLinkValidate(input, context);
+        };
+        const noteFrontmatterValidateWrapper = async (input, context) => {
+            return runNoteFrontmatterValidate(input, context);
+        };
+        const noteOrphanDetectWrapper = async (input, context) => {
+            return runNoteOrphanDetect(input, context);
+        };
+        registry.registerCommand({
+            name: "note.link.validate",
+            description: "Validate wikilink integrity across an Obsidian vault. Scans [[wikilinks]] and resolves each against the note graph.",
+            scope: "workspace",
+            supportsAllSites: false,
+            flags: {
+                "vault-dir": {
+                    kind: "string",
+                    description: "Vault directory relative to workspace root (default: vault).",
+                },
+                path: {
+                    kind: "string",
+                    description: "Subdirectory within the vault to scope the scan to.",
+                },
+            },
+            reads: ["vault/**/*.md"],
+            cacheable: false,
+            execute: noteLinkValidateWrapper,
+        });
+        registry.registerCommand({
+            name: "note.frontmatter.validate",
+            description: "Validate frontmatter consistency across an Obsidian vault. Checks for required fields in YAML frontmatter.",
+            scope: "workspace",
+            supportsAllSites: false,
+            flags: {
+                "vault-dir": {
+                    kind: "string",
+                    description: "Vault directory relative to workspace root (default: vault).",
+                },
+                fields: {
+                    kind: "string",
+                    description: "Comma-separated list of required fields (default: title).",
+                },
+            },
+            reads: ["vault/**/*.md"],
+            cacheable: false,
+            execute: noteFrontmatterValidateWrapper,
+        });
+        registry.registerCommand({
+            name: "note.orphan.detect",
+            description: "Detect orphan notes in an Obsidian vault — notes with zero inbound wikilinks. Always exits zero (warnings, not errors).",
+            scope: "workspace",
+            supportsAllSites: false,
+            flags: {
+                "vault-dir": {
+                    kind: "string",
+                    description: "Vault directory relative to workspace root (default: vault).",
+                },
+            },
+            reads: ["vault/**/*.md"],
+            cacheable: false,
+            execute: noteOrphanDetectWrapper,
+        });
+    },
+};
+//# sourceMappingURL=notes.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes.module.js","sourceRoot":"","sources":["../../../os/notes/notes.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AASF,MAAM,CAAC,MAAM,gBAAgB,GAAgB;IAC3C,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,4CAA4C,CAAC,CAAC;QAC3F,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CACjD,mDAAmD,CACpD,CAAC;QACF,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,4CAA4C,CAAC,CAAC;QAE3F,MAAM,uBAAuB,GAAG,KAAK,EACnC,KAAwB,EACxB,OAA4B,EACC,EAAE;YAC/B,OAAO,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,MAAM,8BAA8B,GAAG,KAAK,EAC1C,KAAwB,EACxB,OAA4B,EACC,EAAE;YAC/B,OAAO,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC,CAAC;QAEF,MAAM,uBAAuB,GAAG,KAAK,EACnC,KAAwB,EACxB,OAA4B,EACC,EAAE;YAC/B,OAAO,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,qHAAqH;YACvH,KAAK,EAAE,WAAW;YAClB,gBAAgB,EAAE,KAAK;YACvB,KAAK,EAAE;gBACL,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;aACF;YACD,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAC;QAEH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,2BAA2B;YACjC,WAAW,EACT,4GAA4G;YAC9G,KAAK,EAAE,WAAW;YAClB,gBAAgB,EAAE,KAAK;YACvB,KAAK,EAAE;gBACL,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;aACF;YACD,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;QAEH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,yHAAyH;YAC3H,KAAK,EAAE,WAAW;YAClB,gBAAgB,EAAE,KAAK;YACvB,KAAK,EAAE;gBACL,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;aACF;YACD,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/os/plan/frontmatter-io.d.ts

@@ -0,0 +1,12 @@
+export interface ParsedPlan {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export declare function parsePlanFile(source: string): ParsedPlan;
+export declare function listPlanFiles(planDirPath: string): Promise<string[]>;
+export declare function readAndParsePlan(planDirPath: string, fileName: string): Promise<{
+    fileName: string;
+    parsed: ParsedPlan;
+} | undefined>;
+export declare function extractRfcIdFromPlanFile(fileName: string): string | undefined;
+//# sourceMappingURL=frontmatter-io.d.ts.map

package/dist/os/plan/frontmatter-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-io.d.ts","sourceRoot":"","sources":["../../../os/plan/frontmatter-io.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CASxD;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2B1E;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG,SAAS,CAAC,CAQ/D;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E"}

package/dist/os/plan/frontmatter-io.js

@@ -0,0 +1,69 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Plan frontmatter file I/O — recursive file discovery and YAML frontmatter
+parsing for plan files under docs/plans/.
+</purpose>
+<non-goals>
+  <item>Do not validate plan content — that is a future concern.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: initial plan frontmatter I/O.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { PLAN_FILE_PATTERN } from "./types.js";
+export function parsePlanFile(source) {
+    const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, body: source };
+    }
+    return {
+        frontmatter: (YAML.parse(match[1]) ?? {}),
+        body: match[2] ?? "",
+    };
+}
+export async function listPlanFiles(planDirPath) {
+    const results = [];
+    async function scanDir(dirPath, relativePrefix) {
+        try {
+            const entries = await fs.readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const relativePath = relativePrefix ? `${relativePrefix}/${entry.name}` : entry.name;
+                if (entry.isDirectory()) {
+                    await scanDir(path.join(dirPath, entry.name), relativePath);
+                }
+                else if (entry.isFile() &&
+                    entry.name.endsWith(".md") &&
+                    !entry.name.startsWith("plan-0000") &&
+                    entry.name !== "README.md" &&
+                    PLAN_FILE_PATTERN.test(entry.name)) {
+                    results.push(relativePath);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or is unreadable — return empty
+        }
+    }
+    await scanDir(planDirPath, "");
+    return results.sort();
+}
+export async function readAndParsePlan(planDirPath, fileName) {
+    try {
+        const filePath = path.join(planDirPath, fileName);
+        const content = await fs.readFile(filePath, "utf-8");
+        return { fileName, parsed: parsePlanFile(content) };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function extractRfcIdFromPlanFile(fileName) {
+    const match = path.basename(fileName).match(/^plan-(rfc-\d{4})-/i);
+    return match ? match[1].toUpperCase() : undefined;
+}
+//# sourceMappingURL=frontmatter-io.js.map

package/dist/os/plan/frontmatter-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-io.js","sourceRoot":"","sources":["../../../os/plan/frontmatter-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAEF,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAO/C,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO;QACL,WAAW,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAA4B;QACrE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,cAAsB;QAC5D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrF,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;gBAC9D,CAAC;qBAAM,IACL,KAAK,CAAC,MAAM,EAAE;oBACd,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC1B,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;oBACnC,KAAK,CAAC,IAAI,KAAK,WAAW;oBAC1B,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAClC,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}

package/dist/os/plan/handlers/archive.d.ts

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

package/dist/os/plan/handlers/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../os/plan/handlers/archive.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKrD,wBAAsB,cAAc,CAClC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAwMhD"}