@warpgogol/forge 0.3.1

package/dist/os/mission/mission.module.js

@@ -0,0 +1,44 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the mission archive command with the forge kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement handler logic here — delegate to handlers/archive.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0573: initial forgeMissionModule registering mission.archive command.</item>
+</CHANGE_SUMMARY>
+*/
+export const forgeMissionModule = {
+    name: "forge-mission",
+    version: "0.1.0",
+    async register(registry) {
+        const { runMissionArchive } = await import("./handlers/archive.js");
+        registry.registerCommand({
+            name: "mission.archive",
+            description: "Move terminal-state mission directories (state: closed or aborted in " +
+                "mission.yaml) into missions/archive/<state>/<missionId>/ subdirectories. " +
+                "Bidirectional: moves open missions found in archive subdirectories back " +
+                "to missions/. Use --dry-run to preview. Use --status to filter to a " +
+                "single terminal status (closed, aborted). " +
+                "Prefer the docs.archive umbrella command unless you need to archive only missions.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["missions/*", "missions/archive/**"],
+            reads: ["missions/**"],
+            cacheable: false,
+            flags: {
+                "dry-run": {
+                    kind: "boolean",
+                    description: "Preview what would be moved without touching the filesystem.",
+                },
+                status: {
+                    kind: "string",
+                    description: "Filter to a single terminal status (closed, aborted).",
+                },
+            },
+            execute: runMissionArchive,
+        });
+    },
+};
+//# sourceMappingURL=mission.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mission.module.js","sourceRoot":"","sources":["../../../os/mission/mission.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAEpE,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,uEAAuE;gBACvE,2EAA2E;gBAC3E,0EAA0E;gBAC1E,sEAAsE;gBACtE,4CAA4C;gBAC5C,oFAAoF;YACtF,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,YAAY,EAAE,qBAAqB,CAAC;YAC7C,KAAK,EAAE,CAAC,aAAa,CAAC;YACtB,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,SAAS,EAAE;oBACT,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACrE;aACF;YACD,OAAO,EAAE,iBAAiB;SAC3B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,23 @@
+export declare const MISSIONS_DIR = "missions";
+export declare const ARCHIVE_DIR_NAME = "archive";
+export declare const MISSION_TERMINAL_STATUSES: readonly ["closed", "aborted"];
+export interface MissionArchiveMove {
+    missionId: string;
+    state: string;
+    from: string;
+    to: string;
+    direction: "into-archive" | "out-of-archive";
+}
+export interface MissionArchiveSkip {
+    missionId: string;
+    dir: string;
+    reason: string;
+}
+export interface MissionArchiveResult {
+    command: "mission.archive";
+    status: "ok";
+    moved: MissionArchiveMove[];
+    skipped: MissionArchiveSkip[];
+    dryRun: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../os/mission/types.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,eAAO,MAAM,yBAAyB,gCAAiC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,cAAc,GAAG,gBAAgB,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/os/mission/types.js

@@ -0,0 +1,18 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Type definitions for the mission archive domain — mission directory discovery,
+manifest state extraction, and archive result shapes.
+</purpose>
+<non-goals>
+  <item>Do not define archive handler logic here — that lives in handlers/archive.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0573: initial mission archive types.</item>
+</CHANGE_SUMMARY>
+*/
+export const MISSIONS_DIR = "missions";
+export const ARCHIVE_DIR_NAME = "archive";
+export const MISSION_TERMINAL_STATUSES = ["closed", "aborted"];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/mission/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC"}

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

@@ -0,0 +1,3 @@
+export { forgeNamingModule } from "./naming.module.ts";
+export { runNamingConventionLint } from "./naming-convention.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/naming/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/os/naming/index.js

@@ -0,0 +1,14 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Expose forge naming lint command handlers through a stable package subpath.</purpose>
+<non-goals>
+  <item>Do not register project-specific naming commands.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial naming module barrel.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeNamingModule } from "./naming.module.js";
+export { runNamingConventionLint } from "./naming-convention.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/naming/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/os/naming/naming-convention.d.ts

@@ -0,0 +1,25 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+/**
+ * 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 declare function runNamingConventionLint(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    violations: number;
+    checkedFiles: number;
+    scannedRoots?: string[];
+    ephemeralRootsSkipped?: string[];
+    unknownTopLevelDirs?: string[];
+}>>;
+//# sourceMappingURL=naming-convention.d.ts.map

package/dist/os/naming/naming-convention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-convention.d.ts","sourceRoot":"","sources":["../../../os/naming/naming-convention.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAkN5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC,CACH,CAsHA"}

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/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,CA6B1E;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,71 @@
+/*
+<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;oBACjC,CAAC,CAAC,GAAG,cAAc,IAAI,KAAK,CAAC,IAAI,EAAE;oBACnC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBACf,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