@warpgogol/forge 2.1.0 → 2.3.0

package/dist/os/core/handlers/release-publish.js

@@ -0,0 +1,173 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.release.publish — publish a prepared release to the declared target (local, R2, S3). Supports --dry-run, --json, --profile.</purpose>
+<non-goals>
+  <item>Do not implement release preparation — that lives in release-prepare.ts.</item>
+  <item>Do not import from @warpgogol/* in autonomous modules — os/core/ may import from @warpgogol/*.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0680: initial forge.release.publish handler with local/r2/s3 targets, --dry-run, env var validation.</item>
+  <item>RFC-0680 review fix: remove unused readdir import (A-1).</item>
+  <item>RFC-0680 review fix: add S3_ENDPOINT to required env vars (G-1).</item>
+  <item>RFC-0680 review fix: add 30s request timeout on S3Client (G-2).</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile, copyFile, mkdir } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.js";
+function getRequiredEnvVars(target) {
+    if (target === "r2") {
+        return ["R2_AXIOM_ACCOUNT_ID", "R2_AXIOM_ACCESS_KEY_ID", "R2_AXIOM_SECRET_ACCESS_KEY"];
+    }
+    if (target === "s3") {
+        return ["S3_BUCKET", "S3_ACCESS_KEY_ID", "S3_SECRET_ACCESS_KEY", "S3_ENDPOINT"];
+    }
+    return [];
+}
+export async function runReleasePublish(input, context) {
+    const { workspaceRoot, logger } = context;
+    const { dryRun, profileIdOverride } = resolveLifecycleFlags(input, context);
+    const resolved = resolveActiveProfile(workspaceRoot, context.forgeRoot, profileIdOverride);
+    if (!resolved) {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: "",
+                target: "",
+                publishedFiles: [],
+                manifestPath: "",
+            },
+            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.release) {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target: "",
+                publishedFiles: [],
+                manifestPath: "",
+            },
+            exitCode: 1,
+            summary: `Profile ${profile.id} does not declare a release configuration.`,
+        };
+    }
+    const releaseConfig = profile.release;
+    const releaseDir = join(workspaceRoot, releaseConfig.outputDir);
+    const manifestPath = join(releaseDir, releaseConfig.manifestName);
+    let manifest;
+    try {
+        const raw = await readFile(manifestPath, "utf8");
+        manifest = JSON.parse(raw);
+    }
+    catch {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target: releaseConfig.target,
+                publishedFiles: [],
+                manifestPath,
+            },
+            exitCode: 1,
+            summary: `No release manifest found at ${manifestPath}. Run \`forge release prepare\` first.`,
+        };
+    }
+    const target = releaseConfig.target;
+    const requiredVars = getRequiredEnvVars(target);
+    const missingVars = requiredVars.filter((v) => !process.env[v]);
+    if (missingVars.length > 0) {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target,
+                publishedFiles: [],
+                manifestPath,
+            },
+            exitCode: 1,
+            summary: `Missing required environment variables: ${missingVars.join(", ")}`,
+        };
+    }
+    const filesToPublish = [];
+    for (const a of manifest.artifacts) {
+        filesToPublish.push(join(releaseDir, basename(a.path)));
+    }
+    filesToPublish.push(manifestPath);
+    if (dryRun) {
+        logger.info(`[dry-run] forge.release.publish — profile: ${profile.id}`);
+        logger.info(`  target: ${target}`);
+        for (const f of filesToPublish) {
+            logger.info(`  file: ${f}`);
+        }
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target,
+                publishedFiles: filesToPublish.map((f) => ({
+                    path: f,
+                    targetPath: target === "local"
+                        ? join(releaseDir, "published", basename(f))
+                        : `${target}://${basename(f)}`,
+                })),
+                manifestPath,
+            },
+            summary: `[dry-run] Would publish ${filesToPublish.length} file(s) to ${target}`,
+        };
+    }
+    const publishedFiles = [];
+    if (target === "local") {
+        const publishedDir = join(releaseDir, "published");
+        await mkdir(publishedDir, { recursive: true });
+        for (const f of filesToPublish) {
+            const dst = join(publishedDir, basename(f));
+            await copyFile(f, dst);
+            publishedFiles.push({ path: f, targetPath: dst });
+        }
+    }
+    else if (target === "r2" || target === "s3") {
+        const { S3Client, PutObjectCommand } = await import("@aws-sdk/client-s3");
+        const { readFile: fsReadFile } = await import("node:fs/promises");
+        const endpoint = target === "r2"
+            ? `https://${process.env.R2_AXIOM_ACCOUNT_ID}.r2.cloudflarestorage.com`
+            : process.env.S3_ENDPOINT;
+        const bucket = target === "r2" ? releaseConfig.r2?.bucket : process.env.S3_BUCKET;
+        const accessKeyId = target === "r2" ? process.env.R2_AXIOM_ACCESS_KEY_ID : process.env.S3_ACCESS_KEY_ID;
+        const secretAccessKey = target === "r2" ? process.env.R2_AXIOM_SECRET_ACCESS_KEY : process.env.S3_SECRET_ACCESS_KEY;
+        const prefix = target === "r2" ? (releaseConfig.r2?.prefix ?? "") : "";
+        const client = new S3Client({
+            endpoint,
+            region: "auto",
+            credentials: { accessKeyId: accessKeyId, secretAccessKey: secretAccessKey },
+            requestHandler: { requestTimeout: 30_000 },
+        });
+        for (const f of filesToPublish) {
+            const key = prefix ? `${prefix}/${basename(f)}` : basename(f);
+            const body = await fsReadFile(f);
+            await client.send(new PutObjectCommand({
+                Bucket: bucket,
+                Key: key,
+                Body: body,
+            }));
+            publishedFiles.push({ path: f, targetPath: `${target}://${bucket}/${key}` });
+        }
+    }
+    logger.success(`  Published ${publishedFiles.length} file(s) to ${target}`);
+    return {
+        data: {
+            command: "forge.release.publish",
+            profileId: profile.id,
+            target,
+            publishedFiles,
+            manifestPath,
+        },
+        summary: `Published ${publishedFiles.length} file(s) to ${target}`,
+    };
+}
+//# sourceMappingURL=release-publish.js.map

package/dist/os/core/handlers/release-publish.js.map

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

package/dist/os/core/handlers/validate.d.ts

@@ -0,0 +1,26 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export interface ValidateViolation {
+    file: string;
+    line?: number;
+    column?: number;
+    severity: "error" | "warning";
+    message: string;
+}
+export interface ForgeValidateArtifactResult {
+    id: string;
+    command: string;
+    exitCode: number;
+    passed: boolean;
+    violations: ValidateViolation[];
+    stdout: string;
+    stderr: string;
+}
+export interface ForgeValidateResult {
+    command: "forge.validate";
+    profileId: string;
+    artifacts: ForgeValidateArtifactResult[];
+    allPassed: boolean;
+}
+export declare function parseViolations(output: string, outputFormat: "plain" | "json" | undefined, violationPattern: string | undefined): ValidateViolation[];
+export declare function runValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<ForgeValidateResult>>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/os/core/handlers/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/validate.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EAC1C,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,iBAAiB,EAAE,CAgDrB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CA0JlD"}

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

@@ -0,0 +1,208 @@
+/*
+<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/* — this module is portable.</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>
+</CHANGE_SUMMARY>
+*/
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.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,
+            },
+            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 allPassed = results.every((r) => r.passed);
+    return {
+        data: {
+            command: "forge.validate",
+            profileId: profile.id,
+            artifacts: results,
+            allPassed,
+        },
+        exitCode: allPassed ? 0 : 1,
+        summary: allPassed
+            ? `forge.validate: all ${results.length} artifact(s) passed`
+            : `forge.validate: ${results.filter((r) => !r.passed).length} artifact(s) failed`,
+    };
+}
+//# 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/handlers/workspace-deps.d.ts

@@ -0,0 +1,12 @@
+export type CollectFilesFn = (root: string, options?: {
+    extensions?: string[];
+    ignore?: (name: string) => boolean;
+}) => Promise<string[]>;
+export type ByteHashFileFn = (filePath: string) => Promise<string>;
+interface WorkspaceDeps {
+    collectFiles: CollectFilesFn;
+    byteHashFile: ByteHashFileFn;
+}
+export declare function loadWorkspaceDeps(): Promise<WorkspaceDeps>;
+export {};
+//# sourceMappingURL=workspace-deps.d.ts.map

package/dist/os/core/handlers/workspace-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-deps.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/workspace-deps.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC,KACE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEvB,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEnE,UAAU,aAAa;IACrB,YAAY,EAAE,cAAc,CAAC;IAC7B,YAAY,EAAE,cAAc,CAAC;CAC9B;AAKD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAqBhE"}

package/dist/os/core/handlers/workspace-deps.js

@@ -0,0 +1,39 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Lazy dynamic-import bridge for @warpgogol/werkstatt/fingerprint and @warpgogol/werkstatt-shared/share/fs. These workspace packages are not published to npm — when forge is installed standalone from npm, they are unavailable and handlers that depend on them must degrade gracefully.</purpose>
+<non-goals>
+  <item>Do not re-export types from @warpgogol/* — only runtime functions.</item>
+  <item>Do not use static imports — that would break npm installs without workspace deps.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0682: extract dynamic-import helper so forge publishes without workspace:* deps.</item>
+</CHANGE_SUMMARY>
+*/
+let cached = null;
+let loadError = null;
+export async function loadWorkspaceDeps() {
+    if (cached)
+        return cached;
+    if (loadError)
+        throw new Error(loadError);
+    try {
+        // @ts-ignore — workspace dep, may not be installed when forge is used standalone from npm
+        const shareMod = await import("@warpgogol/werkstatt-shared/share/fs");
+        // @ts-ignore — workspace dep, may not be installed when forge is used standalone from npm
+        const fpMod = await import("@warpgogol/werkstatt/fingerprint");
+        cached = {
+            collectFiles: shareMod.collectFiles,
+            byteHashFile: fpMod.byteHashFile,
+        };
+        return cached;
+    }
+    catch (err) {
+        loadError =
+            `@warpgogol/werkstatt/fingerprint and @warpgogol/werkstatt-shared/share are required for this command but not installed. ` +
+                `When using forge standalone from npm, install them separately or use forge within the warpgogol workspace. ` +
+                `Error: ${err.message}`;
+        throw new Error(loadError);
+    }
+}
+//# sourceMappingURL=workspace-deps.js.map

package/dist/os/core/handlers/workspace-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-deps.js","sourceRoot":"","sources":["../../../../os/core/handlers/workspace-deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAiBF,IAAI,MAAM,GAAyB,IAAI,CAAC;AACxC,IAAI,SAAS,GAAkB,IAAI,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,0FAA0F;QAC1F,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,sCAAsC,CAAC,CAAC;QACtE,0FAA0F;QAC1F,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;QAC/D,MAAM,GAAG;YACP,YAAY,EAAE,QAAQ,CAAC,YAA8B;YACrD,YAAY,EAAE,KAAK,CAAC,YAA8B;SACnD,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,SAAS;YACP,0HAA0H;gBAC1H,6GAA6G;gBAC7G,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,2 @@
+export { forgeCoreModule } 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,eAAe,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 { forgeCoreModule } 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,eAAe,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 const forgeExplorationModule: 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,eAAO,MAAM,sBAAsB,EAAE,WA2EpC,CAAC"}

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

@@ -0,0 +1,82 @@
+/*
+<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 const forgeExplorationModule = {
+    name: "forge-exploration",
+    version: "0.1.0",
+    async register(registry) {
+        const { runExplorationList } = await import("./handlers/list.js");
+        const { runExplorationShow } = await import("./handlers/show.js");
+        const { runExplorationArchive } = await import("./handlers/archive.js");
+        registry.registerCommand({
+            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,
+        });
+        registry.registerCommand({
+            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,
+        });
+        registry.registerCommand({
+            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,
+        });
+    },
+};
+//# 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,MAAM,sBAAsB,GAAgB;IACjD,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAClE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAClE,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAExE,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,4GAA4G;gBAC5G,wEAAwE;gBACxE,8EAA8E;YAChF,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,KAAK;YACnB,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,CAAC,wBAAwB,CAAC;YACjC,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;aACF;YACD,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;QAEH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,+FAA+F;gBAC/F,gFAAgF;gBAChF,+CAA+C;YACjD,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,KAAK;YACnB,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,CAAC,wBAAwB,CAAC;YACjC,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;aACF;YACD,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;QAEH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EACT,wGAAwG;gBACxG,uEAAuE;gBACvE,qFAAqF;gBACrF,uFAAuF;YACzF,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,wBAAwB,CAAC;YAClC,KAAK,EAAE,CAAC,wBAAwB,CAAC;YACjC,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,+DAA+D;iBAC7E;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gEAAgE;iBAC9E;aACF;YACD,OAAO,EAAE,qBAAqB;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,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"}