@warpgogol/forge 2.16.0 → 2.17.0

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

@@ -0,0 +1,84 @@
+/*
+<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",
+    runtime: "autonomous",
+    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 a markdown note 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 a markdown note 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 a markdown note 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,OAAO,EAAE,YAAY;IACrB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,4CAA4C,CAAC,CAAC;QAC3F,MAAM,EAAE,0BAA0B,EAAE,GAClC,MAAM,MAAM,CAAC,mDAAmD,CAAC,CAAC;QACpE,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,yHAAyH;YAC3H,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,gHAAgH;YAClH,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,6HAA6H;YAC/H,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":"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"}

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"}

package/dist/os/plan/handlers/archive.js

@@ -0,0 +1,206 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Plan archive handler — moves plan files whose parent RFC has terminal status
+into status-specific subdirectories under docs/plans/archive/ and moves
+non-terminal files found in subdirectories back to the root.
+</purpose>
+<non-goals>
+  <item>Does not validate plan content.</item>
+  <item>Does not change plan frontmatter — only moves files on disk.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: implement plan.archive command.</item>
+  <item>RFC-0733: add pinned-files pre-check — skip pinned files with warning instead of moving them.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import { listPlanFiles, extractRfcIdFromPlanFile } from "../frontmatter-io.js";
+import { loadRfcStatusMap } from "../../rfc/frontmatter-io.js";
+import { PLAN_DIR } from "../types.js";
+import { loadPinnedManifest, isPinned, isIntraDirMove } from "../../core/handlers/pinned-check.js";
+const TERMINAL_STATUSES = ["implemented", "rejected", "superseded"];
+export async function runPlanArchive(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const planDirPath = path.join(workspaceRoot, PLAN_DIR);
+    const rfcDirPath = path.join(workspaceRoot, "docs", "rfcs");
+    const dryRun = context.dryRun || input.flags["dry-run"] === true;
+    const statusFilter = input.flags["status"];
+    if (statusFilter && !TERMINAL_STATUSES.includes(statusFilter)) {
+        throw new Error(`Invalid --status "${statusFilter}". Must be one of: ${TERMINAL_STATUSES.join(", ")}`);
+    }
+    const files = await listPlanFiles(planDirPath);
+    const rfcStatusMap = await loadRfcStatusMap(rfcDirPath);
+    const moved = [];
+    const skipped = [];
+    // RFC-0733: Load pinned manifest once per invocation
+    let pinnedManifest = null;
+    try {
+        pinnedManifest = await loadPinnedManifest(workspaceRoot);
+    }
+    catch {
+        // Malformed manifest — skip pre-check
+    }
+    for (const fileName of files) {
+        const rfcId = extractRfcIdFromPlanFile(fileName);
+        const relFile = path.join(PLAN_DIR, fileName);
+        const basename = path.basename(fileName);
+        if (!rfcId) {
+            skipped.push({ id: "UNKNOWN", file: relFile, reason: "no RFC id in filename" });
+            continue;
+        }
+        const rfcStatus = rfcStatusMap.get(rfcId);
+        if (!rfcStatus) {
+            skipped.push({ id: rfcId, file: relFile, reason: "parent RFC not found" });
+            continue;
+        }
+        const isTerminal = rfcStatus === "implemented" || rfcStatus === "rejected" || rfcStatus === "superseded";
+        const isInArchive = fileName.includes("/");
+        if (statusFilter && rfcStatus !== statusFilter) {
+            skipped.push({
+                id: rfcId,
+                file: relFile,
+                reason: `parent RFC status ${rfcStatus} does not match --status ${statusFilter}`,
+            });
+            continue;
+        }
+        if (isTerminal && !isInArchive) {
+            const targetDir = path.join(planDirPath, "archive", rfcStatus);
+            const targetPath = path.join(targetDir, basename);
+            const targetRel = path.join(PLAN_DIR, "archive", rfcStatus, basename);
+            // RFC-0733: Check if file is pinned before moving
+            // Gap fix: exempt intra-directory moves (file stays within the same pinned dir)
+            if (pinnedManifest &&
+                isPinned(pinnedManifest, relFile) &&
+                !isIntraDirMove(pinnedManifest, relFile, targetRel)) {
+                skipped.push({
+                    id: rfcId,
+                    file: relFile,
+                    reason: "pinned (protected by .forge/pinned.yaml)",
+                });
+                if (outputFormat === "pretty") {
+                    logger.warn(`  pinned: skipping ${relFile} (protected)`);
+                }
+                continue;
+            }
+            try {
+                await fs.access(targetPath);
+                skipped.push({ id: rfcId, file: relFile, reason: "destination exists" });
+                continue;
+            }
+            catch {
+                // destination doesn't exist — proceed
+            }
+            if (!dryRun) {
+                await fs.mkdir(targetDir, { recursive: true });
+                try {
+                    await fs.rename(path.join(planDirPath, fileName), targetPath);
+                }
+                catch (err) {
+                    if (err.code === "ENOENT") {
+                        skipped.push({ id: rfcId, file: relFile, reason: "already moved by another process" });
+                        continue;
+                    }
+                    throw err;
+                }
+            }
+            moved.push({
+                id: rfcId,
+                file: targetRel,
+                status: rfcStatus,
+                from: relFile,
+                to: targetRel,
+                direction: "into-archive",
+            });
+        }
+        else if (!isTerminal && isInArchive) {
+            const targetPath = path.join(planDirPath, basename);
+            const targetRel = path.join(PLAN_DIR, basename);
+            // RFC-0733: Check if file is pinned before moving
+            // Gap fix: exempt intra-directory moves (file stays within the same pinned dir)
+            if (pinnedManifest &&
+                isPinned(pinnedManifest, relFile) &&
+                !isIntraDirMove(pinnedManifest, relFile, targetRel)) {
+                skipped.push({
+                    id: rfcId,
+                    file: relFile,
+                    reason: "pinned (protected by .forge/pinned.yaml)",
+                });
+                if (outputFormat === "pretty") {
+                    logger.warn(`  pinned: skipping ${relFile} (protected)`);
+                }
+                continue;
+            }
+            try {
+                await fs.access(targetPath);
+                skipped.push({ id: rfcId, file: relFile, reason: "destination exists" });
+                continue;
+            }
+            catch {
+                // destination doesn't exist — proceed
+            }
+            if (!dryRun) {
+                try {
+                    await fs.rename(path.join(planDirPath, fileName), targetPath);
+                }
+                catch (err) {
+                    if (err.code === "ENOENT") {
+                        skipped.push({ id: rfcId, file: relFile, reason: "already moved by another process" });
+                        continue;
+                    }
+                    throw err;
+                }
+            }
+            moved.push({
+                id: rfcId,
+                file: targetRel,
+                status: rfcStatus,
+                from: relFile,
+                to: targetRel,
+                direction: "out-of-archive",
+            });
+        }
+        else if (isTerminal && isInArchive) {
+            skipped.push({ id: rfcId, file: relFile, reason: `already archived (${rfcStatus})` });
+        }
+        else {
+            skipped.push({
+                id: rfcId,
+                file: relFile,
+                reason: `parent RFC status ${rfcStatus} is non-terminal`,
+            });
+        }
+    }
+    if (outputFormat === "pretty") {
+        if (dryRun) {
+            logger.info(`[dry-run] plan.archive: would move ${moved.length} file(s), skip ${skipped.length}`);
+        }
+        else {
+            logger.success(`plan.archive: moved ${moved.length} file(s), skipped ${skipped.length}`);
+        }
+        for (const m of moved) {
+            logger.info(`  ${m.direction}: ${m.id} (${m.status}) ${m.from} → ${m.to}`);
+        }
+    }
+    return {
+        data: {
+            command: "plan.archive",
+            status: "ok",
+            moved,
+            skipped,
+            dryRun,
+        },
+        summary: dryRun
+            ? `[dry-run] Would move ${moved.length} file(s), skip ${skipped.length}`
+            : `Moved ${moved.length} file(s), skipped ${skipped.length}`,
+        nextSteps: [
+            {
+                action: "Run: pnpm exec werkstatt run plan.list --json to verify archive status",
+                kind: "optional",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=archive.js.map

package/dist/os/plan/handlers/archive.js.map

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

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

@@ -0,0 +1,6 @@
+export { forgePlanModule } from "./plan.module.ts";
+export { runPlanArchive } from "./handlers/archive.ts";
+export { listPlanFiles, parsePlanFile, readAndParsePlan, extractRfcIdFromPlanFile, type ParsedPlan, } from "./frontmatter-io.ts";
+export type { PlanArchiveResult, PlanArchiveMove, PlanArchiveSkip } from "./types.ts";
+export { PLAN_DIR, PLAN_FILE_PATTERN } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/plan/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/plan/index.js

@@ -0,0 +1,16 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the plan domain — types, module, and handlers.</purpose>
+<non-goals>
+  <item>Do not implement plan logic here; delegate to handlers/ and plan.module.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: initial plan module barrel.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgePlanModule } from "./plan.module.js";
+export { runPlanArchive } from "./handlers/archive.js";
+export { listPlanFiles, parsePlanFile, readAndParsePlan, extractRfcIdFromPlanFile, } from "./frontmatter-io.js";
+export { PLAN_DIR, PLAN_FILE_PATTERN } from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/plan/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,wBAAwB,GAEzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

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

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

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

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

package/dist/os/plan/plan.module.js

@@ -0,0 +1,45 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the plan 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-0521: initial forgePlanModule registering plan.archive command.</item>
+</CHANGE_SUMMARY>
+*/
+export const forgePlanModule = {
+    name: "forge-plan",
+    version: "0.1.0",
+    runtime: "autonomous",
+    async register(registry) {
+        const { runPlanArchive } = await import("./handlers/archive.js");
+        registry.registerCommand({
+            name: "plan.archive",
+            description: "Move plan files whose parent RFC has terminal status " +
+                "(implemented, rejected, superseded) into docs/plans/archive/<status>/ " +
+                "subdirectories. Bidirectional: moves non-terminal files found in " +
+                "subdirectories back to root. Use --dry-run to preview. " +
+                "Use --status to filter to a single terminal status. " +
+                "Prefer the docs.archive umbrella command unless you need to archive only plans.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/plans/*.md", "docs/plans/archive/**"],
+            reads: ["docs/plans/**/*.md", "docs/rfcs/**/*.md"],
+            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 (implemented, rejected, superseded).",
+                },
+            },
+            execute: runPlanArchive,
+        });
+    },
+};
+//# sourceMappingURL=plan.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.module.js","sourceRoot":"","sources":["../../../os/plan/plan.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,YAAY;IACrB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAEjE,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,uDAAuD;gBACvD,wEAAwE;gBACxE,mEAAmE;gBACnE,yDAAyD;gBACzD,sDAAsD;gBACtD,iFAAiF;YACnF,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;YACpD,KAAK,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;YAClD,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,yEAAyE;iBACvF;aACF;YACD,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { ArchiveMove, ArchiveSkip } from "../rfc/handlers/archive.ts";
+export declare const PLAN_DIR = "docs/plans";
+export declare const PLAN_FILE_PATTERN: RegExp;
+export interface PlanArchiveResult {
+    command: "plan.archive";
+    status: "ok";
+    moved: ArchiveMove[];
+    skipped: ArchiveSkip[];
+    dryRun: boolean;
+}
+export type { ArchiveMove as PlanArchiveMove, ArchiveSkip as PlanArchiveSkip };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../os/plan/types.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE3E,eAAO,MAAM,QAAQ,eAAe,CAAC;AACrC,eAAO,MAAM,iBAAiB,QAAqB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,YAAY,EAAE,WAAW,IAAI,eAAe,EAAE,WAAW,IAAI,eAAe,EAAE,CAAC"}

package/dist/os/plan/types.js

@@ -0,0 +1,17 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Type definitions for the plan archive domain — plan file discovery, parsing,
+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-0521: initial plan archive types.</item>
+</CHANGE_SUMMARY>
+*/
+export const PLAN_DIR = "docs/plans";
+export const PLAN_FILE_PATTERN = /^plan-rfc-\d{4}-/;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/plan/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAIF,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export interface PluginValidateResult {
+    command: "forge.plugin.validate";
+    status: "pass" | "fail";
+    packs: Array<{
+        prefix: string;
+        dir: string;
+        manifestPath: string;
+        valid: boolean;
+        errors: string[];
+    }>;
+}
+export interface PluginDiscoverResult {
+    command: "forge.plugin.discover";
+    packs: Array<{
+        prefix: string;
+        dir: string;
+        manifestPath: string;
+        id: string;
+        version: string;
+    }>;
+    count: number;
+}
+export declare const forgePluginModule: ForgeModule;
+//# sourceMappingURL=plugin.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.module.d.ts","sourceRoot":"","sources":["../../../os/plugin/plugin.module.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAS7D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,uBAAuB,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAwLD,eAAO,MAAM,iBAAiB,EAAE,WA6B/B,CAAC"}