@warpgogol/forge 2.1.0 → 2.2.0

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

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

@@ -0,0 +1,135 @@
+/*
+<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)`,
+    };
+}
+//# 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,CAgDpD"}

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

@@ -0,0 +1,56 @@
+/*
+<MODULE_CONTRACT>
+<purpose>exploration.list handler — list all exploration notes with metadata.</purpose>
+<non-goals>
+  <item>Do not validate frontmatter shape — listing is metadata-only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0710: initial exploration.list handler.</item>
+</CHANGE_SUMMARY>
+*/
+import path from "node:path";
+import { listExplorationFiles, readAndParseExplorationNote, getExplorationsDir, } from "../frontmatter-io.js";
+export async function runExplorationList(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const explorationsDirPath = getExplorationsDir(workspaceRoot);
+    const filterStatus = input.flags["status"];
+    const files = await listExplorationFiles(explorationsDirPath);
+    const entries = [];
+    for (const fileName of files) {
+        const result = await readAndParseExplorationNote(explorationsDirPath, fileName);
+        if (!result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const status = String(fm["status"] ?? "");
+        if (filterStatus && status !== filterStatus)
+            continue;
+        entries.push({
+            id: String(fm["id"] ?? path.basename(fileName, ".md")),
+            title: String(fm["title"] ?? ""),
+            status,
+            createdAt: String(fm["createdAt"] ?? ""),
+        });
+    }
+    if (outputFormat === "pretty") {
+        if (entries.length === 0) {
+            logger.info("No exploration notes found.");
+        }
+        else {
+            logger.section(`Exploration notes (${entries.length})`);
+            for (const entry of entries) {
+                logger.info(`${entry.id}  ${entry.status.padEnd(10)} ${entry.createdAt.padEnd(12)} ${entry.title}`);
+            }
+        }
+    }
+    return {
+        data: {
+            command: "exploration.list",
+            status: "ok",
+            count: entries.length,
+            explorations: entries,
+        },
+        summary: `${entries.length} exploration note(s) found`,
+    };
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../os/exploration/handlers/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,OAA4B;IAE5B,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAE9D,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAuB,CAAC;IAEjE,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAC9D,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;QAChF,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QAE/D,IAAI,YAAY,IAAI,MAAM,KAAK,YAAY;YAAE,SAAS;QAEtD,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACtD,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM;YACN,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,sBAAsB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CACT,GAAG,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CACvF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,kBAAkB;YAC3B,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,YAAY,EAAE,OAAO;SACtB;QACD,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,4BAA4B;KACvD,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,91 @@
+/*
+<MODULE_CONTRACT>
+<purpose>exploration.show handler — return the full content of a single exploration note.</purpose>
+<non-goals>
+  <item>Do not validate frontmatter shape — show returns raw parsed content.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0710: initial exploration.show handler.</item>
+</CHANGE_SUMMARY>
+*/
+import { readAndParseExplorationNote, getExplorationsDir } from "../frontmatter-io.js";
+function parseRelatedArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((v) => typeof v === "string");
+    }
+    return [];
+}
+export async function runExplorationShow(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const explorationsDirPath = getExplorationsDir(workspaceRoot);
+    const slug = input.flags["id"];
+    if (!slug) {
+        return {
+            data: {
+                command: "exploration.show",
+                status: "error",
+                note: {
+                    id: "",
+                    title: "",
+                    createdAt: "",
+                    status: "open",
+                    related: [],
+                    body: "",
+                },
+            },
+            exitCode: 1,
+            summary: "exploration.show requires --id <slug>",
+        };
+    }
+    const fileName = `${slug}.md`;
+    const result = await readAndParseExplorationNote(explorationsDirPath, fileName);
+    if (!result) {
+        if (outputFormat === "pretty") {
+            logger.info(`Exploration note not found: ${slug}`);
+        }
+        return {
+            data: {
+                command: "exploration.show",
+                status: "error",
+                note: {
+                    id: slug,
+                    title: "",
+                    createdAt: "",
+                    status: "open",
+                    related: [],
+                    body: "",
+                },
+            },
+            exitCode: 1,
+            summary: `Exploration note not found: ${slug}`,
+        };
+    }
+    const fm = result.parsed.frontmatter;
+    const note = {
+        id: String(fm["id"] ?? slug),
+        title: String(fm["title"] ?? ""),
+        createdAt: String(fm["createdAt"] ?? ""),
+        status: String(fm["status"] ?? "open"),
+        related: parseRelatedArray(fm["related"]),
+        body: result.parsed.body,
+    };
+    if (outputFormat === "pretty") {
+        logger.section(`Exploration: ${note.title}`);
+        logger.info(`ID: ${note.id}  Status: ${note.status}  Created: ${note.createdAt}`);
+        if (note.related.length > 0) {
+            logger.info(`Related: ${note.related.join(", ")}`);
+        }
+        logger.info("");
+        logger.info(note.body.trim());
+    }
+    return {
+        data: {
+            command: "exploration.show",
+            status: "ok",
+            note,
+        },
+        summary: `Exploration note: ${note.id}`,
+    };
+}
+//# sourceMappingURL=show.js.map

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

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

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

@@ -0,0 +1,7 @@
+export { forgeExplorationModule } from "./exploration.module.ts";
+export { runExplorationList } from "./handlers/list.ts";
+export { runExplorationShow } from "./handlers/show.ts";
+export { runExplorationArchive } from "./handlers/archive.ts";
+export type { ExplorationStatus, ExplorationNote, ExplorationListEntry, ExplorationListResult, ExplorationShowResult, ExplorationArchiveResult, } from "./types.ts";
+export { EXPLORATION_STATUSES, EXPLORATION_DIR, EXPLORATION_SLUG_PATTERN } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/exploration/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/exploration/index.js

@@ -0,0 +1,17 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the exploration domain — types, constants, module, and handlers.</purpose>
+<non-goals>
+  <item>Do not implement exploration logic here; delegate to handlers/ and exploration.module.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0710: expose forgeExplorationModule and exploration types from the exploration domain.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeExplorationModule } from "./exploration.module.js";
+export { runExplorationList } from "./handlers/list.js";
+export { runExplorationShow } from "./handlers/show.js";
+export { runExplorationArchive } from "./handlers/archive.js";
+export { EXPLORATION_STATUSES, EXPLORATION_DIR, EXPLORATION_SLUG_PATTERN } from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/exploration/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAS9D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,38 @@
+export type ExplorationStatus = "open" | "explored" | "archived";
+export declare const EXPLORATION_STATUSES: readonly ExplorationStatus[];
+export interface ExplorationNote {
+    id: string;
+    title: string;
+    createdAt: string;
+    status: ExplorationStatus;
+    related: string[];
+    body: string;
+}
+export interface ExplorationListEntry {
+    id: string;
+    title: string;
+    status: ExplorationStatus;
+    createdAt: string;
+}
+export interface ExplorationListResult {
+    command: "exploration.list";
+    status: "ok";
+    count: number;
+    explorations: ExplorationListEntry[];
+}
+export interface ExplorationShowResult {
+    command: "exploration.show";
+    status: "ok" | "error";
+    note: ExplorationNote;
+}
+export interface ExplorationArchiveResult {
+    command: "exploration.archive";
+    status: "ok" | "error";
+    id: string;
+    previousStatus: string;
+    newStatus: "archived";
+    related: string[];
+}
+export declare const EXPLORATION_DIR = "docs/explorations";
+export declare const EXPLORATION_SLUG_PATTERN: RegExp;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../os/exploration/types.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAEjE,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAInD,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,eAAO,MAAM,wBAAwB,QAA+B,CAAC"}

package/dist/os/exploration/types.js

@@ -0,0 +1,23 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Defines types and constants for managing exploration notes: statuses,
+frontmatter shape, list/show/archive result types.
+</purpose>
+<non-goals>
+  <item>Do not implement exploration processing logic here.</item>
+  <item>Do not handle user input or command execution.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0710: initial exploration types and constants.</item>
+</CHANGE_SUMMARY>
+*/
+export const EXPLORATION_STATUSES = [
+    "open",
+    "explored",
+    "archived",
+];
+export const EXPLORATION_DIR = "docs/explorations";
+export const EXPLORATION_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/exploration/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAIF,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,MAAM;IACN,UAAU;IACV,UAAU;CACF,CAAC;AAwCX,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,4BAA4B,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../os/mission/handlers/archive.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AA8GrB,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,CA0SnD"}