@warpgogol/forge 4.1.6 → 4.2.1

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

@@ -0,0 +1,241 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.validate — execute validate commands for all artifacts declared in the active stack profile. Supports --dry-run, --json, --artifact filtering, and violation parsing.</purpose>
+<non-goals>
+  <item>Do not implement dev or build logic — those are separate handlers.</item>
+  <item>Do not import from @warpgogol/* — compass handler is intra-package within @warpgogol/forge.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0674: initial forge.validate handler with profile resolution, --dry-run, and per-artifact execution.</item>
+  <item>RFC-0677: extended with --artifact filtering, violation parsing (outputFormat: json/plain), passed/allPassed fields.</item>
+  <item>Integrated compass.validate as in-process step after artifact validations for automatic Compass enforcement.</item>
+</CHANGE_SUMMARY>
+*/
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.js";
+import { runCompassValidation } from "../../compass/handlers/compass-inventory-handler.js";
+const execAsync = promisify(exec);
+export function parseViolations(output, outputFormat, violationPattern) {
+    if (outputFormat === "json") {
+        try {
+            const parsed = JSON.parse(output);
+            if (Array.isArray(parsed)) {
+                return parsed
+                    .filter((v) => typeof v === "object" && v !== null)
+                    .map((v) => ({
+                    file: String(v["file"] ?? ""),
+                    line: typeof v["line"] === "number" ? v["line"] : undefined,
+                    column: typeof v["column"] === "number" ? v["column"] : undefined,
+                    severity: (v["severity"] === "warning" ? "warning" : "error"),
+                    message: String(v["message"] ?? ""),
+                }))
+                    .filter((v) => v.file || v.message);
+            }
+            return [];
+        }
+        catch {
+            return [];
+        }
+    }
+    if (outputFormat === "plain" && violationPattern) {
+        try {
+            const regex = new RegExp(violationPattern, "gm");
+            const violations = [];
+            let match;
+            const MAX_MATCHES = 1000;
+            let matchCount = 0;
+            while ((match = regex.exec(output)) !== null && matchCount < MAX_MATCHES) {
+                matchCount++;
+                const groups = match.groups ?? {};
+                violations.push({
+                    file: String(groups["file"] ?? ""),
+                    line: groups["line"] ? Number(groups["line"]) : undefined,
+                    column: groups["column"] ? Number(groups["column"]) : undefined,
+                    severity: (groups["severity"] === "warning" ? "warning" : "error"),
+                    message: String(groups["message"] ?? match[0]),
+                });
+                if (regex.lastIndex === match.index)
+                    regex.lastIndex++;
+            }
+            return violations;
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+export async function runValidate(input, context) {
+    const { workspaceRoot, logger } = context;
+    const { dryRun, profileIdOverride } = resolveLifecycleFlags(input, context);
+    const artifactFilter = typeof input.flags["artifact"] === "string" ? input.flags["artifact"] : undefined;
+    const resolved = resolveActiveProfile(workspaceRoot, context.forgeRoot, profileIdOverride);
+    if (!resolved) {
+        return {
+            data: {
+                command: "forge.validate",
+                profileId: "",
+                artifacts: [],
+                allPassed: false,
+            },
+            exitCode: 1,
+            summary: "No active profile found. Set `profile` in forge.yaml or use --profile <id>.",
+            nextSteps: [{ action: "Set profile in forge.yaml or use --profile <id>", kind: "required" }],
+        };
+    }
+    const { profile } = resolved;
+    if (!profile.artifacts || profile.artifacts.length === 0) {
+        return {
+            data: {
+                command: "forge.validate",
+                profileId: profile.id,
+                artifacts: [],
+                allPassed: false,
+            },
+            exitCode: 1,
+            summary: `Profile ${profile.id} does not declare any artifacts.`,
+            nextSteps: [{ action: `Add artifacts section to profile ${profile.id}`, kind: "required" }],
+        };
+    }
+    if (artifactFilter) {
+        const found = profile.artifacts.find((a) => a.id === artifactFilter);
+        if (!found) {
+            return {
+                data: {
+                    command: "forge.validate",
+                    profileId: profile.id,
+                    artifacts: [],
+                    allPassed: false,
+                },
+                exitCode: 1,
+                summary: `Artifact ${artifactFilter} not declared in profile ${profile.id}.`,
+                nextSteps: [{ action: `Check artifacts in profile ${profile.id}`, kind: "required" }],
+            };
+        }
+    }
+    const artifactsToValidate = artifactFilter
+        ? profile.artifacts.filter((a) => a.id === artifactFilter)
+        : profile.artifacts;
+    if (dryRun) {
+        const commands = artifactsToValidate
+            .filter((a) => a.validate)
+            .map((a) => ({ artifactId: a.id, command: a.validate.command }));
+        logger.info(`[dry-run] forge.validate — profile: ${profile.id}`);
+        for (const cmd of commands) {
+            logger.info(`  ${cmd.artifactId}: ${cmd.command}`);
+        }
+        return {
+            data: {
+                command: "forge.validate",
+                profileId: profile.id,
+                artifacts: commands.map((c) => ({
+                    id: c.artifactId,
+                    command: c.command,
+                    exitCode: 0,
+                    passed: true,
+                    violations: [],
+                    stdout: "",
+                    stderr: "",
+                })),
+                allPassed: true,
+                compass: {
+                    passed: true,
+                    checkedFiles: 0,
+                    failures: 0,
+                    diagnostics: [],
+                },
+            },
+            summary: `[dry-run] ${commands.length} validate command(s) resolved`,
+        };
+    }
+    const results = [];
+    for (const artifact of artifactsToValidate) {
+        if (!artifact.validate) {
+            logger.warn(`Skipping artifact ${artifact.id}: no validate command declared`);
+            results.push({
+                id: artifact.id,
+                command: "",
+                exitCode: 0,
+                passed: true,
+                violations: [],
+                stdout: "",
+                stderr: "skipped: no validate command",
+            });
+            continue;
+        }
+        const cmd = artifact.validate.command;
+        const outputFormat = artifact.validate.outputFormat;
+        const violationPattern = artifact.validate.violationPattern;
+        try {
+            const { stdout, stderr } = await execAsync(cmd, { cwd: workspaceRoot, timeout: 30_000 });
+            const violations = parseViolations(stdout + "\n" + stderr, outputFormat, violationPattern);
+            results.push({
+                id: artifact.id,
+                command: cmd,
+                exitCode: 0,
+                passed: true,
+                violations,
+                stdout,
+                stderr,
+            });
+            logger.success(`  ${artifact.id}: OK`);
+        }
+        catch (err) {
+            const e = err;
+            const rawStdout = e.stdout ?? "";
+            const rawStderr = e.stderr ?? e.message;
+            const violations = parseViolations(rawStdout + "\n" + rawStderr, outputFormat, violationPattern);
+            results.push({
+                id: artifact.id,
+                command: cmd,
+                exitCode: e.code ?? 1,
+                passed: false,
+                violations,
+                stdout: rawStdout,
+                stderr: rawStderr,
+            });
+            logger.error(`  ${artifact.id}: FAILED (exit ${e.code ?? 1})`);
+        }
+    }
+    const artifactsAllPassed = results.every((r) => r.passed);
+    let compassResult;
+    try {
+        const compassResponse = await runCompassValidation({ argv: [], flags: {} }, context);
+        if (compassResponse.data) {
+            compassResult = {
+                passed: (compassResponse.exitCode ?? 0) === 0,
+                checkedFiles: compassResponse.data.checkedFiles,
+                failures: compassResponse.data.failures,
+                diagnostics: compassResponse.data.diagnostics,
+            };
+        }
+    }
+    catch {
+        // compass.validate not available in this workspace — skip
+    }
+    const allPassed = artifactsAllPassed && (compassResult?.passed ?? true);
+    const summaryParts = [
+        allPassed
+            ? `forge.validate: all ${results.length} artifact(s) passed`
+            : `forge.validate: ${results.filter((r) => !r.passed).length} artifact(s) failed`,
+    ];
+    if (compassResult) {
+        summaryParts.push(compassResult.passed
+            ? `compass: OK (${compassResult.checkedFiles} files)`
+            : `compass: ${compassResult.failures} failure(s)`);
+    }
+    return {
+        data: {
+            command: "forge.validate",
+            profileId: profile.id,
+            artifacts: results,
+            allPassed,
+            compass: compassResult,
+        },
+        exitCode: allPassed ? 0 : 1,
+        summary: summaryParts.join("; "),
+    };
+}
+//# sourceMappingURL=validate.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/core/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/os/core/index.js

@@ -0,0 +1,13 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Expose the forge core kernel module through a stable package subpath.</purpose>
+<non-goals>
+  <item>Do not implement handler logic.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial core module barrel.</item>
+</CHANGE_SUMMARY>
+*/
+export { createForgeCoreModule } from "./core.module.js";
+//# sourceMappingURL=index.js.map

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

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

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

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

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

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

package/dist/os/exploration/exploration.module.js

@@ -0,0 +1,88 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register exploration note commands with the forge kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement handler logic here — delegate to handlers/.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0710: initial forgeExplorationModule registering exploration.list, exploration.show, exploration.archive commands.</item>
+</CHANGE_SUMMARY>
+*/
+export async function createForgeExplorationModule() {
+    const { runExplorationList } = await import("./handlers/list.js");
+    const { runExplorationShow } = await import("./handlers/show.js");
+    const { runExplorationArchive } = await import("./handlers/archive.js");
+    return {
+        name: "forge-exploration",
+        version: "0.1.0",
+        runtime: "autonomous",
+        declarations: [],
+        commands: [
+            {
+                name: "exploration.list",
+                description: "List all exploration notes in docs/explorations/. Returns id, title, status, and createdAt for each note. " +
+                    "Use --status <status> to filter by status (open, explored, archived). " +
+                    "Returns an empty list with exit code 0 if the directory is empty or missing.",
+                scope: "workspace",
+                mutatesState: false,
+                writes: [],
+                reads: ["docs/explorations/*.md"],
+                cacheable: false,
+                flags: {
+                    status: {
+                        kind: "string",
+                        description: "Filter by status (open, explored, archived).",
+                    },
+                },
+                execute: runExplorationList,
+            },
+            {
+                name: "exploration.show",
+                description: "Show the full content of a single exploration note. Use --id <slug> to specify the note slug " +
+                    "(kebab-case, lowercase, latin-only). Returns the note's frontmatter and body. " +
+                    "Returns exit code 1 if the note is not found.",
+                scope: "workspace",
+                mutatesState: false,
+                writes: [],
+                reads: ["docs/explorations/*.md"],
+                cacheable: false,
+                flags: {
+                    id: {
+                        kind: "string",
+                        required: true,
+                        description: "The slug of the exploration note to show (e.g. 'my-idea').",
+                    },
+                },
+                execute: runExplorationShow,
+            },
+            {
+                name: "exploration.archive",
+                description: "Archive an exploration note by setting its status to 'archived'. Use --id <slug> to specify the note. " +
+                    "Use --rfc <RFC-XXXX> to add an RFC id to the note's 'related' field. " +
+                    "Idempotent — if the note is already archived, returns exit code 0 with no changes. " +
+                    "Returns exit code 1 if the note is not found or the slug is invalid (non-kebab-case).",
+                scope: "workspace",
+                mutatesState: true,
+                writes: ["docs/explorations/*.md"],
+                reads: ["docs/explorations/*.md"],
+                cacheable: false,
+                flags: {
+                    id: {
+                        kind: "string",
+                        required: true,
+                        description: "The slug of the exploration note to archive (e.g. 'my-idea').",
+                    },
+                    rfc: {
+                        kind: "string",
+                        description: "RFC id to add to the note's 'related' field (e.g. 'RFC-0710').",
+                    },
+                },
+                execute: runExplorationArchive,
+            }
+        ],
+        pipelines: []
+    };
+}
+;
+//# sourceMappingURL=exploration.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exploration.module.js","sourceRoot":"","sources":["../../../os/exploration/exploration.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAClD,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC9D,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAClE,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAC1E,OAAO;QACP,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,YAAY;QACnB,YAAY,EAAE,EAAE;QAClB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,4GAA4G;oBAC5G,wEAAwE;oBACxE,8EAA8E;gBAChF,KAAK,EAAE,WAAW;gBAClB,YAAY,EAAE,KAAK;gBACnB,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,CAAC,wBAAwB,CAAC;gBACjC,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE;oBACL,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8CAA8C;qBAC5D;iBACF;gBACD,OAAO,EAAE,kBAAkB;aAC5B;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,+FAA+F;oBAC/F,gFAAgF;oBAChF,+CAA+C;gBACjD,KAAK,EAAE,WAAW;gBAClB,YAAY,EAAE,KAAK;gBACnB,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,CAAC,wBAAwB,CAAC;gBACjC,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE;oBACL,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,IAAI;wBACd,WAAW,EAAE,4DAA4D;qBAC1E;iBACF;gBACD,OAAO,EAAE,kBAAkB;aAC5B;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,wGAAwG;oBACxG,uEAAuE;oBACvE,qFAAqF;oBACrF,uFAAuF;gBACzF,KAAK,EAAE,WAAW;gBAClB,YAAY,EAAE,IAAI;gBAClB,MAAM,EAAE,CAAC,wBAAwB,CAAC;gBAClC,KAAK,EAAE,CAAC,wBAAwB,CAAC;gBACjC,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE;oBACL,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,IAAI;wBACd,WAAW,EAAE,+DAA+D;qBAC7E;oBACD,GAAG,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,gEAAgE;qBAC9E;iBACF;gBACD,OAAO,EAAE,qBAAqB;aAC/B;SACF;QACD,SAAS,EAAE,EAEV;KAAC,CAAC;AACL,CAAC;AACD,CAAC"}

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

@@ -0,0 +1,13 @@
+export interface ParsedExplorationNote {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export declare function parseExplorationFile(source: string): ParsedExplorationNote;
+export declare function listExplorationFiles(explorationsDirPath: string): Promise<string[]>;
+export declare function readAndParseExplorationNote(explorationsDirPath: string, fileName: string): Promise<{
+    fileName: string;
+    parsed: ParsedExplorationNote;
+} | undefined>;
+export declare function serializeExplorationNote(frontmatter: Record<string, unknown>, body: string): string;
+export declare function getExplorationsDir(workspaceRoot: string): string;
+//# sourceMappingURL=frontmatter-io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-io.d.ts","sourceRoot":"","sources":["../../../os/exploration/frontmatter-io.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAS1E;AAED,wBAAsB,oBAAoB,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAezF;AAED,wBAAsB,2BAA2B,CAC/C,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAAG,SAAS,CAAC,CAQ1E;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE"}

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

@@ -0,0 +1,61 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Shared exploration note frontmatter I/O — list exploration files and parse
+their YAML frontmatter without validating the shape.
+</purpose>
+<non-goals>
+  <item>Do not validate frontmatter shape — that is the skill's responsibility.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0710: initial exploration frontmatter I/O.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { EXPLORATION_DIR } from "./types.js";
+export function parseExplorationFile(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 listExplorationFiles(explorationsDirPath) {
+    const results = [];
+    try {
+        const entries = await fs.readdir(explorationsDirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith(".md") && entry.name !== "README.md") {
+                results.push(entry.name);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or is unreadable — return empty
+    }
+    return results.sort();
+}
+export async function readAndParseExplorationNote(explorationsDirPath, fileName) {
+    try {
+        const filePath = path.join(explorationsDirPath, fileName);
+        const content = await fs.readFile(filePath, "utf-8");
+        return { fileName, parsed: parseExplorationFile(content) };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function serializeExplorationNote(frontmatter, body) {
+    const fmYaml = YAML.stringify(frontmatter).trimEnd();
+    return `---\n${fmYaml}\n---\n${body}`;
+}
+export function getExplorationsDir(workspaceRoot) {
+    return path.join(workspaceRoot, EXPLORATION_DIR);
+}
+//# sourceMappingURL=frontmatter-io.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-io.js","sourceRoot":"","sources":["../../../os/exploration/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,eAAe,EAAE,MAAM,YAAY,CAAC;AAO7C,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,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,oBAAoB,CAAC,mBAA2B;IACpE,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/E,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,mBAA2B,EAC3B,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,WAAoC,EACpC,IAAY;IAEZ,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IACrD,OAAO,QAAQ,MAAM,UAAU,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../os/exploration/handlers/archive.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAA4B,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAStF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC,CAgIvD"}

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

@@ -0,0 +1,141 @@
+/*
+<MODULE_CONTRACT>
+<purpose>exploration.archive handler — transition an exploration note to archived status.</purpose>
+<non-goals>
+  <item>Do not delete exploration notes — archive is a status transition only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0710: initial exploration.archive handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import { readAndParseExplorationNote, serializeExplorationNote, getExplorationsDir, } from "../frontmatter-io.js";
+import { EXPLORATION_SLUG_PATTERN } from "../types.js";
+function parseRelatedArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((v) => typeof v === "string");
+    }
+    return [];
+}
+export async function runExplorationArchive(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const explorationsDirPath = getExplorationsDir(workspaceRoot);
+    const slug = input.flags["id"];
+    if (!slug) {
+        return {
+            data: {
+                command: "exploration.archive",
+                status: "error",
+                id: "",
+                previousStatus: "",
+                newStatus: "archived",
+                related: [],
+            },
+            exitCode: 1,
+            summary: "exploration.archive requires --id <slug>",
+        };
+    }
+    if (!EXPLORATION_SLUG_PATTERN.test(slug)) {
+        if (outputFormat === "pretty") {
+            logger.info(`Invalid slug: ${slug}. Must be kebab-case, lowercase, latin-only.`);
+        }
+        return {
+            data: {
+                command: "exploration.archive",
+                status: "error",
+                id: slug,
+                previousStatus: "",
+                newStatus: "archived",
+                related: [],
+            },
+            exitCode: 1,
+            summary: `Invalid slug: ${slug}`,
+        };
+    }
+    const fileName = `${slug}.md`;
+    const filePath = path.join(explorationsDirPath, fileName);
+    const result = await readAndParseExplorationNote(explorationsDirPath, fileName);
+    if (!result) {
+        if (outputFormat === "pretty") {
+            logger.info(`Exploration note not found: ${slug}`);
+        }
+        return {
+            data: {
+                command: "exploration.archive",
+                status: "error",
+                id: slug,
+                previousStatus: "",
+                newStatus: "archived",
+                related: [],
+            },
+            exitCode: 1,
+            summary: `Exploration note not found: ${slug}`,
+        };
+    }
+    const fm = result.parsed.frontmatter;
+    const previousStatus = String(fm["status"] ?? "open");
+    const related = parseRelatedArray(fm["related"]);
+    const rfcId = input.flags["rfc"];
+    if (rfcId && !related.includes(rfcId)) {
+        related.push(rfcId);
+    }
+    if (previousStatus === "archived") {
+        if (rfcId) {
+            const updatedFrontmatter = {
+                ...fm,
+                status: "archived",
+                related,
+            };
+            const updatedContent = serializeExplorationNote(updatedFrontmatter, result.parsed.body);
+            await fs.writeFile(filePath, updatedContent, "utf-8");
+        }
+        if (outputFormat === "pretty") {
+            logger.info(`Exploration note ${slug} is already archived (no-op).`);
+        }
+        return {
+            data: {
+                command: "exploration.archive",
+                status: "ok",
+                id: slug,
+                previousStatus: "archived",
+                newStatus: "archived",
+                related,
+            },
+            exitCode: 0,
+            summary: `Exploration note ${slug} is already archived (no-op)`,
+        };
+    }
+    const updatedFrontmatter = {
+        ...fm,
+        status: "archived",
+        related,
+    };
+    const updatedContent = serializeExplorationNote(updatedFrontmatter, result.parsed.body);
+    await fs.writeFile(filePath, updatedContent, "utf-8");
+    if (outputFormat === "pretty") {
+        logger.success(`Archived exploration note: ${slug} (${previousStatus} → archived)`);
+        if (rfcId) {
+            logger.info(`Related RFC: ${rfcId}`);
+        }
+    }
+    return {
+        data: {
+            command: "exploration.archive",
+            status: "ok",
+            id: slug,
+            previousStatus,
+            newStatus: "archived",
+            related,
+        },
+        summary: `Archived exploration note: ${slug} (${previousStatus} → archived)`,
+        nextSteps: [
+            {
+                action: `Commit the archive: pnpm exec forge run ecosystem.commit`,
+                kind: "optional",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=archive.js.map

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

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

package/dist/os/exploration/handlers/list.d.ts

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

package/dist/os/exploration/handlers/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../os/exploration/handlers/list.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAAwB,qBAAqB,EAAqB,MAAM,aAAa,CAAC;AAElG,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAyDpD"}