@warpgogol/forge 4.1.5 → 4.2.1

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

@@ -0,0 +1,228 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.release.prepare — bundle built artifacts into a release package with a manifest. Supports --dry-run, --json, --profile.</purpose>
+<non-goals>
+  <item>Do not implement publish logic — that lives in release-publish.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.prepare handler with manifest generation, artifact hashing, --dry-run.</item>
+  <item>RFC-0680 review fix: remove unused artifactId param from findBuiltArtifacts (A-2).</item>
+  <item>RFC-0680 review fix: use writeFileIfChanged for manifest write (B-1, DNA-34).</item>
+  <item>RFC-0680 review fix: document validationPassed semantics (G-3).</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile, copyFile, mkdir, stat } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { createHash } from "node:crypto";
+import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.js";
+import { loadWorkspaceDeps } from "../../werkstatt/handlers/workspace-deps.js";
+import { writeFileIfChanged } from "../../../src/utils/fs-idempotent.js";
+function generateReleaseId(profileId, shortHash) {
+    const ts = new Date().toISOString().replace(/[:.]/g, "-").slice(0, -5);
+    return `${profileId}-${ts}-${shortHash}`;
+}
+async function readVersionFromPackageJson(workspaceRoot) {
+    try {
+        const raw = await readFile(join(workspaceRoot, "package.json"), "utf8");
+        const pkg = JSON.parse(raw);
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+async function findBuiltArtifacts(workspaceRoot, extensions, produceOutput) {
+    if (produceOutput) {
+        const { collectFiles } = await loadWorkspaceDeps();
+        const outputPattern = produceOutput.replace("{composition}", "*");
+        const basePattern = basename(outputPattern);
+        const isGlob = basePattern.includes("*");
+        if (!isGlob) {
+            const fullPath = join(workspaceRoot, produceOutput);
+            try {
+                const _s = await stat(fullPath);
+                return [fullPath];
+            }
+            catch {
+                return [];
+            }
+        }
+        // Extract extension from the output pattern (e.g. "*.mp4" → ".mp4")
+        const extMatch = basePattern.match(/(\.[^.]+)$/);
+        const outputExts = extMatch ? [extMatch[1]] : extensions;
+        const distDir = join(workspaceRoot, "dist");
+        const files = await collectFiles(distDir, {
+            extensions: outputExts,
+            ignore: (name) => name.startsWith("-") || name.startsWith("old-") || name === ".DS_Store",
+        });
+        const regex = new RegExp("^" + basePattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$");
+        return files.filter((f) => regex.test(basename(f)));
+    }
+    const { collectFiles } = await loadWorkspaceDeps();
+    const distDir = join(workspaceRoot, "dist");
+    return collectFiles(distDir, {
+        extensions,
+        ignore: (name) => name.startsWith("-") || name.startsWith("old-") || name === ".DS_Store",
+    });
+}
+export async function runReleasePrepare(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.prepare",
+                profileId: "",
+                releaseDir: "",
+                manifest: {
+                    schemaVersion: "1",
+                    releaseId: "",
+                    profileId: "",
+                    version: "",
+                    createdAt: "",
+                    artifacts: [],
+                    determinismChecked: false,
+                    validationPassed: 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.release) {
+        return {
+            data: {
+                command: "forge.release.prepare",
+                profileId: profile.id,
+                releaseDir: "",
+                manifest: {
+                    schemaVersion: "1",
+                    releaseId: "",
+                    profileId: profile.id,
+                    version: "",
+                    createdAt: "",
+                    artifacts: [],
+                    determinismChecked: false,
+                    validationPassed: false,
+                },
+            },
+            exitCode: 1,
+            summary: `Profile ${profile.id} does not declare a release configuration.`,
+        };
+    }
+    const releaseConfig = profile.release;
+    const releaseDir = join(workspaceRoot, releaseConfig.outputDir);
+    const artifacts = profile.artifacts ?? [];
+    const includeArtifacts = releaseConfig.includeArtifacts;
+    const filteredArtifacts = includeArtifacts
+        ? artifacts.filter((a) => includeArtifacts.includes(a.id))
+        : artifacts.filter((a) => a.produce?.output);
+    const version = await readVersionFromPackageJson(workspaceRoot);
+    const manifestArtifacts = [];
+    let allHashes = "";
+    for (const artifact of filteredArtifacts) {
+        const builtFiles = await findBuiltArtifacts(workspaceRoot, artifact.extensions, artifact.produce?.output);
+        if (builtFiles.length === 0) {
+            return {
+                data: {
+                    command: "forge.release.prepare",
+                    profileId: profile.id,
+                    releaseDir: "",
+                    manifest: {
+                        schemaVersion: "1",
+                        releaseId: "",
+                        profileId: profile.id,
+                        version,
+                        createdAt: "",
+                        artifacts: [],
+                        determinismChecked: false,
+                        validationPassed: false,
+                    },
+                },
+                exitCode: 1,
+                summary: `Artifact ${artifact.id} has no built output — run \`forge build\` first.`,
+            };
+        }
+        for (const builtFile of builtFiles) {
+            const relPath = builtFile.replace(workspaceRoot + "/", "");
+            let hash = "";
+            let size = 0;
+            if (!dryRun) {
+                const { byteHashFile } = await loadWorkspaceDeps();
+                hash = await byteHashFile(builtFile);
+                const stats = await stat(builtFile);
+                size = stats.size;
+                allHashes += hash;
+            }
+            manifestArtifacts.push({
+                artifactId: artifact.id,
+                path: relPath,
+                hash,
+                size,
+                deterministic: artifact.determinism?.hashable ?? false,
+            });
+        }
+    }
+    const shortHash = allHashes
+        ? createHash("sha256").update(allHashes).digest("hex").slice(0, 8)
+        : "dryrun00";
+    const releaseId = generateReleaseId(profile.id, shortHash);
+    const createdAt = new Date().toISOString();
+    const manifest = {
+        schemaVersion: "1",
+        releaseId,
+        profileId: profile.id,
+        version,
+        createdAt,
+        artifacts: manifestArtifacts,
+        determinismChecked: false,
+        validationPassed: true,
+    };
+    // G-3 note: validationPassed is set to true because forge.release.prepare
+    // does not run validation itself — the operator is expected to run
+    // `forge.validate` before `forge.release.prepare`. This mirrors the
+    // prepare-then-publish separation: prepare assumes prior validation.
+    if (dryRun) {
+        logger.info(`[dry-run] forge.release.prepare — profile: ${profile.id}`);
+        logger.info(`  releaseId: ${releaseId}`);
+        logger.info(`  version: ${version}`);
+        logger.info(`  outputDir: ${releaseConfig.outputDir}`);
+        for (const a of manifestArtifacts) {
+            logger.info(`  artifact: ${a.artifactId} — ${a.path}`);
+        }
+        return {
+            data: {
+                command: "forge.release.prepare",
+                profileId: profile.id,
+                releaseDir: releaseConfig.outputDir,
+                manifest,
+            },
+            summary: `[dry-run] Release prepared: ${manifestArtifacts.length} artifact(s), releaseId: ${releaseId}`,
+        };
+    }
+    await mkdir(releaseDir, { recursive: true });
+    for (const a of manifestArtifacts) {
+        const srcPath = join(workspaceRoot, a.path);
+        const dstPath = join(releaseDir, basename(a.path));
+        await copyFile(srcPath, dstPath);
+    }
+    const manifestPath = join(releaseDir, releaseConfig.manifestName);
+    await writeFileIfChanged(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+    logger.success(`  Release prepared: ${manifestArtifacts.length} artifact(s)`);
+    logger.info(`  Manifest: ${manifestPath}`);
+    return {
+        data: {
+            command: "forge.release.prepare",
+            profileId: profile.id,
+            releaseDir: releaseConfig.outputDir,
+            manifest,
+        },
+        summary: `Release prepared: ${manifestArtifacts.length} artifact(s), releaseId: ${releaseId}`,
+    };
+}
+//# sourceMappingURL=release-prepare.js.map

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

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

package/dist/os/core/handlers/release-publish.d.ts

@@ -0,0 +1,13 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export interface ForgeReleasePublishResult {
+    command: "forge.release.publish";
+    profileId: string;
+    target: string;
+    publishedFiles: Array<{
+        path: string;
+        targetPath: string;
+    }>;
+    manifestPath: string;
+}
+export declare function runReleasePublish(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<ForgeReleasePublishResult>>;
+//# sourceMappingURL=release-publish.d.ts.map

package/dist/os/core/handlers/release-publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-publish.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/release-publish.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,CAAC,CAmKxD"}

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,39 @@
+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 ForgeValidateCompassResult {
+    passed: boolean;
+    checkedFiles: number;
+    failures: number;
+    diagnostics: Array<{
+        ruleId: string;
+        severity: string;
+        file: string;
+        message: string;
+        fix: string;
+    }>;
+}
+export interface ForgeValidateResult {
+    command: "forge.validate";
+    profileId: string;
+    artifacts: ForgeValidateArtifactResult[];
+    allPassed: boolean;
+    compass?: ForgeValidateCompassResult;
+}
+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":"AAiBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAM/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,0BAA0B;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACJ;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;IACnB,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;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,CA6LlD"}