@warpgogol/forge 4.1.5 → 4.2.1

package/dist/src/onboarding/scaffold-project.js

@@ -0,0 +1,264 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.scaffold — creates a working pnpm + Turborepo monorepo from a stack profile in the current directory.</purpose>
+<non-goals>
+  <item>Do not add a --force flag — ever.</item>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0392: initial forge.scaffold handler.</item>
+  <item>RFC-0542: populate nextSteps in forge.scaffold result.</item>
+  <item>Add __PROJECT_NAME__ placeholder replacement for workspace files; profiles now include root package.json with scripts (clean, format, test, upgrade-packages) and scripts/clean.mjs.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { listStackProfiles } from "../profiles/stack-profile.js";
+import { resolveForgeRoot } from "../config/forge-config.js";
+export async function runScaffoldProject(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const profileId = input.flags["profile"];
+    const projectName = input.flags["name"];
+    const templateId = input.flags["template"];
+    const created = [];
+    const installLog = [];
+    const errors = [];
+    // Validate required flags
+    if (!profileId) {
+        return fail("forge.scaffold", "", "Missing required flag: --profile", errors, outputFormat, logger);
+    }
+    // Derive project name from folder name if not provided (consistent with forge.create)
+    const effectiveProjectName = projectName ?? path.basename(workspaceRoot);
+    // Validate kebab-case project name
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(effectiveProjectName)) {
+        return fail("forge.scaffold", profileId, `Project name "${effectiveProjectName}" is not kebab-case`, errors, outputFormat, logger);
+    }
+    // RFC-0877: The target directory must be empty (only .git/ tolerated).
+    // The empty-directory check is handled by forge.create.
+    // forge.scaffold is called from forge.create which already verified the directory is empty.
+    // Load profiles and find the requested one
+    let forgeRoot;
+    if (context.forgeRoot) {
+        forgeRoot = context.forgeRoot;
+    }
+    else {
+        try {
+            forgeRoot = resolveForgeRoot(workspaceRoot);
+        }
+        catch {
+            // In autonomous mode, forgeRoot may be the cwd itself
+            forgeRoot = workspaceRoot;
+        }
+    }
+    let profiles;
+    try {
+        profiles = listStackProfiles(forgeRoot);
+    }
+    catch (err) {
+        return fail("forge.scaffold", profileId, `Failed to load profiles: ${err.message}`, errors, outputFormat, logger);
+    }
+    const profile = profiles.find((p) => p.id === profileId);
+    if (!profile) {
+        const available = profiles.map((p) => p.id).join(", ");
+        return fail("forge.scaffold", profileId, `Unknown profile "${profileId}". Available: ${available}`, errors, outputFormat, logger);
+    }
+    // Create workspace directories
+    for (const dir of profile.workspace.dirs) {
+        const dirPath = path.join(workspaceRoot, dir);
+        fs.mkdirSync(dirPath, { recursive: true });
+        created.push(`${dir}/`);
+    }
+    // Create workspace files (with __PROJECT_NAME__ placeholder replacement)
+    for (const file of profile.workspace.files) {
+        const filePath = path.join(workspaceRoot, file.path);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        const content = file.content.replace(/__PROJECT_NAME__/g, effectiveProjectName);
+        fs.writeFileSync(filePath, content, "utf8");
+        created.push(file.path);
+    }
+    // Ensure .npmrc has ignore-workspace-root-check=true before running install commands to avoid:
+    // - ERR_PNPM_ADDING_TO_ROOT (pnpm v10/v11 blocks `pnpm add` in workspace root without -w)
+    // - ERR_PNPM_IGNORED_BUILDS (pnpm exits non-zero for ignored build scripts)
+    // Profiles may already include .npmrc in workspace.files — append the setting if missing.
+    const npmrcPath = path.join(workspaceRoot, ".npmrc");
+    if (profile.install.length > 0) {
+        if (fs.existsSync(npmrcPath)) {
+            const existing = fs.readFileSync(npmrcPath, "utf8");
+            if (!existing.includes("ignore-workspace-root-check=true")) {
+                fs.appendFileSync(npmrcPath, "ignore-workspace-root-check=true\n", "utf8");
+            }
+        }
+        else {
+            fs.writeFileSync(npmrcPath, "ignore-workspace-root-check=true\n", "utf8");
+            created.push(".npmrc");
+        }
+    }
+    // Create first workspace if defined (use template override if --template is provided)
+    let templateError = null;
+    const effectiveFirstWorkspace = (() => {
+        if (templateId && profile.templates) {
+            const template = profile.templates.find((t) => t.id === templateId);
+            if (template)
+                return template.firstWorkspace;
+            templateError = `Unknown template "${templateId}". Available: ${profile.templates.map((t) => t.id).join(", ")}`;
+            return undefined;
+        }
+        // Use default template if no --template specified and templates exist
+        if (profile.templates && profile.templates.length > 0) {
+            const defaultTemplate = profile.templates.find((t) => t.default) ?? profile.templates[0];
+            return defaultTemplate.firstWorkspace;
+        }
+        return profile.firstWorkspace;
+    })();
+    if (templateError) {
+        return fail("forge.scaffold", profileId, templateError, errors, outputFormat, logger);
+    }
+    if (effectiveFirstWorkspace) {
+        const wsPath = effectiveFirstWorkspace.path.replace("my-site", effectiveProjectName).replace("my-game", effectiveProjectName);
+        const wsDir = path.join(workspaceRoot, wsPath);
+        fs.mkdirSync(wsDir, { recursive: true });
+        created.push(`${wsPath}/`);
+        for (const file of effectiveFirstWorkspace.files) {
+            const filePath = path.join(wsDir, file.path);
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            // Replace placeholder names (quoted and bare)
+            const content = file.content
+                .replace(/my-site/g, effectiveProjectName)
+                .replace(/my-game/g, effectiveProjectName);
+            fs.writeFileSync(filePath, content, "utf8");
+            created.push(`${wsPath}/${file.path}`);
+        }
+    }
+    // Run ALL install commands AFTER all files are created (atomicity: no partial state if install fails)
+    // Root workspace install commands
+    if (outputFormat === "pretty" && profile.install.length > 0) {
+        logger.info(`Installing ${profile.install.length} root workspace package(s)...`);
+    }
+    for (const cmd of profile.install) {
+        if (outputFormat === "pretty") {
+            logger.info(`Running: ${cmd}`);
+        }
+        try {
+            execSync(cmd, { cwd: workspaceRoot, stdio: "pipe", timeout: 60000 });
+            installLog.push(`${cmd} — ok`);
+            if (outputFormat === "pretty") {
+                logger.success(`Finished: ${cmd}`);
+            }
+        }
+        catch (err) {
+            const stderr = String(err.stderr ?? "").trim();
+            const stdout = String(err.stdout ?? "").trim();
+            const details = [stderr, stdout].filter(Boolean).join("\n");
+            // pnpm v10 exits non-zero for ERR_PNPM_IGNORED_BUILDS even when install succeeded
+            if (details.includes("ERR_PNPM_IGNORED_BUILDS")) {
+                installLog.push(`${cmd} — ok (build scripts ignored)`);
+                if (outputFormat === "pretty") {
+                    logger.success(`Finished: ${cmd} (build scripts ignored — run 'pnpm approve-builds' later)`);
+                }
+            }
+            else {
+                installLog.push(`${cmd} — FAILED: ${details || err.message}`);
+                if (outputFormat === "pretty") {
+                    logger.warn(`Install failed (non-fatal): ${cmd}`);
+                    if (details)
+                        logger.warn(details);
+                    logger.warn("Run this command manually after fixing the issue (e.g. configuring .npmrc).");
+                }
+            }
+        }
+    }
+    // First workspace install commands
+    if (effectiveFirstWorkspace) {
+        const wsPath = effectiveFirstWorkspace.path.replace("my-site", effectiveProjectName).replace("my-game", effectiveProjectName);
+        const wsDir = path.join(workspaceRoot, wsPath);
+        if (outputFormat === "pretty" && effectiveFirstWorkspace.install.length > 0) {
+            logger.info(`Installing first workspace packages in ${effectiveFirstWorkspace.path}...`);
+        }
+        for (const cmd of effectiveFirstWorkspace.install) {
+            if (outputFormat === "pretty") {
+                logger.info(`Running: ${cmd}`);
+            }
+            try {
+                execSync(cmd, { cwd: wsDir, stdio: "pipe", timeout: 60000 });
+                installLog.push(`${cmd} — ok`);
+                if (outputFormat === "pretty") {
+                    logger.success(`Finished: ${cmd}`);
+                }
+            }
+            catch (err) {
+                const stderr = String(err.stderr ?? "").trim();
+                const stdout = String(err.stdout ?? "").trim();
+                const details = [stderr, stdout].filter(Boolean).join("\n");
+                // pnpm v10 exits non-zero for ERR_PNPM_IGNORED_BUILDS even when install succeeded
+                if (details.includes("ERR_PNPM_IGNORED_BUILDS")) {
+                    installLog.push(`${cmd} — ok (build scripts ignored)`);
+                    if (outputFormat === "pretty") {
+                        logger.success(`Finished: ${cmd} (build scripts ignored — run 'pnpm approve-builds' later)`);
+                    }
+                }
+                else {
+                    errors.push(`Install step failed: ${cmd}\n${details || err.message}`);
+                    if (outputFormat === "pretty") {
+                        logger.error(`Install failed: ${cmd}`);
+                        if (details)
+                            logger.error(details);
+                    }
+                    return {
+                        data: { command: "forge.scaffold", status: "fail", profile: profileId, created, installLog, errors },
+                        nextSteps: [{ action: "Fix the errors above and re-run forge.scaffold", kind: "required" }],
+                        exitCode: 1,
+                        summary: `forge.scaffold: failed — install step "${cmd}" failed`,
+                    };
+                }
+            }
+        }
+    }
+    // Format generated files with prettier if it's available
+    try {
+        if (outputFormat === "pretty") {
+            logger.info("Formatting generated files with prettier...");
+        }
+        execSync("npx prettier --write .", { cwd: workspaceRoot, stdio: "pipe", timeout: 30000 });
+        installLog.push("prettier --write . — ok");
+        if (outputFormat === "pretty") {
+            logger.success("Formatting complete.");
+        }
+    }
+    catch {
+        // Prettier is optional — don't fail the scaffold if it's not available
+        if (outputFormat === "pretty") {
+            logger.info("Skipping prettier formatting (not available yet).");
+        }
+    }
+    if (outputFormat === "pretty") {
+        logger.success(`Scaffolded ${profile.displayName} in ${workspaceRoot}`);
+        for (const f of created) {
+            logger.info(`  created: ${f}`);
+        }
+    }
+    const nextSteps = [
+        { action: "Open the project in Windsurf", kind: "required" },
+        { action: "Run forge.create to deploy skills and docs dirs", kind: "required" },
+    ];
+    return {
+        data: { command: "forge.scaffold", status: "pass", profile: profileId, created, installLog, errors },
+        nextSteps,
+        exitCode: 0,
+        summary: `forge.scaffold: OK — scaffolded ${profileId} with ${created.length} files`,
+    };
+}
+function fail(command, profile, message, errors, outputFormat, logger) {
+    errors.push(message);
+    if (outputFormat === "pretty") {
+        logger.error(message);
+    }
+    return {
+        data: { command, status: "fail", profile, created: [], installLog: [], errors },
+        nextSteps: [{ action: "Fix the errors above and re-run forge.scaffold", kind: "required" }],
+        exitCode: 1,
+        summary: `${command}: failed — ${message}`,
+    };
+}
+//# sourceMappingURL=scaffold-project.js.map

package/dist/src/onboarding/scaffold-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-project.js","sourceRoot":"","sources":["../../../src/onboarding/scaffold-project.ts"],"names":[],"mappings":"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"}

package/dist/src/onboarding/scaffold.d.ts

@@ -0,0 +1,15 @@
+interface ScaffoldResult {
+    command: string;
+    status: "pass" | "fail";
+    created: string[];
+    errors: string[];
+}
+export declare function runScaffold(input: {
+    flags: {
+        name?: string;
+        type?: string;
+        category?: string;
+    };
+}, context: unknown): ScaffoldResult;
+export {};
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/src/onboarding/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/onboarding/scaffold.ts"],"names":[],"mappings":"AAiBA,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE;IAAE,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACrE,OAAO,EAAE,OAAO,GACf,cAAc,CAkHhB"}

package/dist/src/onboarding/scaffold.js

@@ -0,0 +1,123 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.port.scaffold — generates a skeleton for a new skill or command in forge.</purpose>
+<non-goals>
+  <item>Do not validate the scaffolded content — that is forge.port.validate's job.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial forge.port.scaffold handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { FORGE_SKILLS } from "../registry.js";
+import { resolveForgeRoot } from "../config/forge-config.js";
+export function runScaffold(input, context) {
+    const ctx = context;
+    const workspaceRoot = ctx?.workspaceRoot ?? process.cwd();
+    let forgeRoot;
+    try {
+        forgeRoot = resolveForgeRoot(workspaceRoot);
+    }
+    catch {
+        forgeRoot = path.join(workspaceRoot, "packages", "forge");
+    }
+    const name = input.flags?.name;
+    const type = input.flags?.type ?? "skill";
+    const category = input.flags?.category ?? "shared";
+    const errors = [];
+    const created = [];
+    if (!name) {
+        errors.push("--name flag is required");
+        return { command: "forge.port.scaffold", status: "fail", created, errors };
+    }
+    // Check for existing skill with same name
+    if (FORGE_SKILLS.some((s) => s.name === name)) {
+        errors.push(`Skill "${name}" already exists in the forge registry`);
+        return { command: "forge.port.scaffold", status: "fail", created, errors };
+    }
+    if (type === "skill") {
+        const skillDir = path.join(forgeRoot, "skills", category, name);
+        const skillPath = path.join(skillDir, "SKILL.md");
+        if (fs.existsSync(skillPath)) {
+            errors.push(`SKILL.md already exists at ${path.relative(workspaceRoot, skillPath)}`);
+            return { command: "forge.port.scaffold", status: "fail", created, errors };
+        }
+        fs.mkdirSync(skillDir, { recursive: true });
+        const content = `---
+name: ${name}
+description: TODO — one-line description (max 200 chars)
+invocation: user
+category: ${category}
+concerns: document-only
+dependsOn: []
+languagePolicy: ref(PREFERENCES.md)
+---
+
+# ${name}
+
+Before starting, read \`PREFERENCES.md\` at the repository root. If the file is missing or \`aiLanguage\` is unset, ask the operator once and create the file using the \`my-preferences\` skill semantics.
+
+TODO: Write the skill's behavioral instructions here.
+`;
+        fs.writeFileSync(skillPath, content, "utf8");
+        created.push(path.relative(workspaceRoot, skillPath));
+    }
+    else if (type === "command") {
+        const cmdDir = path.join(forgeRoot, "os", name);
+        const cmdPath = path.join(cmdDir, `${name}.module.ts`);
+        if (fs.existsSync(cmdPath)) {
+            errors.push(`Command module already exists at ${path.relative(workspaceRoot, cmdPath)}`);
+            return { command: "forge.port.scaffold", status: "fail", created, errors };
+        }
+        fs.mkdirSync(cmdDir, { recursive: true });
+        const content = `/*
+<MODULE_CONTRACT>
+<purpose>TODO — purpose of the ${name} command module.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/site-kernel.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial ${name} command module.</item>
+</CHANGE_SUMMARY>
+*/
+
+import type { ForgeModule, ForgeCommandDefinition } from "../../src/forge-module.ts";
+
+export const forge${capitalize(name)}Module: ForgeModule = {
+  name: "forge-${name}",
+  version: "0.1.0",
+  runtime: "autonomous",
+  declarations: [],
+  commands: [
+    {
+      name: "${name}",
+      description: "TODO — one-line description",
+      scope: "workspace",
+      execute() {
+        // TODO: implement
+      },
+    } satisfies ForgeCommandDefinition,
+  ],
+  pipelines: [],
+};
+`;
+        fs.writeFileSync(cmdPath, content, "utf8");
+        created.push(path.relative(workspaceRoot, cmdPath));
+    }
+    else {
+        errors.push(`--type must be "skill" or "command", got "${type}"`);
+    }
+    return {
+        command: "forge.port.scaffold",
+        status: errors.length === 0 ? "pass" : "fail",
+        created,
+        errors,
+    };
+}
+function capitalize(s) {
+    return s.split("-").map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/src/onboarding/scaffold.js.map

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

package/dist/src/onboarding/upgrade.d.ts

@@ -0,0 +1,27 @@
+import type { SkippedSkill } from "./init.ts";
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../types.ts";
+export interface UpgradeResult {
+    command: "forge.upgrade";
+    status: "pass" | "noop" | "fail";
+    fromVersion: string;
+    toVersion: string;
+    skillsUpdated: string[];
+    bindingsAdded: {
+        key: string;
+        value: string;
+    }[];
+    skippedSkills: SkippedSkill[];
+    nestedAgentsGenerated: string[];
+    memoryScaffold: {
+        created: string[];
+        gitignoreUpdated: boolean;
+        skipped: string[];
+    };
+    npmUpdated: boolean;
+    npmUpdateSkipped: string | null;
+    latestNpmVersion: string | null;
+    npmVersionWarning: string | null;
+    doctorReport: unknown;
+}
+export declare function runUpgrade(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<UpgradeResult>>;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/src/onboarding/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/onboarding/upgrade.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAiB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE7G,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,cAAc,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpF,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;CACvB;AAiQD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAsP5C"}