@warpgogol/forge 0.3.1

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,CA+GhB"}

package/dist/src/onboarding/scaffold.js

@@ -0,0 +1,120 @@
+/*
+<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",
+  register(registry) {
+    registry.registerCommand({
+      name: "${name}",
+      description: "TODO — one-line description",
+      scope: "workspace",
+      execute() {
+        // TODO: implement
+      },
+    } satisfies ForgeCommandDefinition);
+  },
+};
+`;
+        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":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAS7D,MAAM,UAAU,WAAW,CACzB,KAAqE,EACrE,OAAgB;IAEhB,MAAM,GAAG,GAAG,OAAqC,CAAC;IAClD,MAAM,aAAa,GAAG,GAAG,EAAE,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1D,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,OAAO,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAE,QAAQ,IAAI,QAAQ,CAAC;IAEnD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7E,CAAC;IAED,0CAA0C;IAC1C,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,wCAAwC,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7E,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAElD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,8BAA8B,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7E,CAAC;QAED,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG;QACZ,IAAI;;;YAGA,QAAQ;;;;;;IAMhB,IAAI;;;;;CAKP,CAAC;QAEE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,CAAC;QAEvD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YACzF,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7E,CAAC;QAED,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG;;iCAEa,IAAI;;;;;;4BAMT,IAAI;;;;;;oBAMZ,UAAU,CAAC,IAAI,CAAC;iBACnB,IAAI;;;;eAIN,IAAI;;;;;;;;;CASlB,CAAC;QAEE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,6CAA6C,IAAI,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,OAAO,EAAE,qBAAqB;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAC7C,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAClF,CAAC"}

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

@@ -0,0 +1,17 @@
+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[];
+    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":"AA4BA,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,YAAY,EAAE,OAAO,CAAC;CACvB;AAgKD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAuK5C"}

package/dist/src/onboarding/upgrade.js

@@ -0,0 +1,293 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.upgrade — additive sync for npm consumers. Refreshes .agents/skills/
+from the installed forge package, adds missing binding defaults (RFC-0540) without
+overwriting operator-set values, updates forge.syncedVersion, and runs forge.doctor.</purpose>
+<non-goals>
+  <item>Do not overwrite operator-set non-null bindings — additive only.</item>
+  <item>Do not create forge.yaml — that is forge.create's responsibility.</item>
+  <item>Do not modify PREFERENCES.md or AGENTS.md — upgrade is skill + binding sync only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0543: initial forge.upgrade handler — 7-step additive sync flow.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { stringify as stringifyYaml, parse as parseYaml } from "yaml";
+import { FORGE_CLI_BINDING_DEFAULTS, resolveForgeRoot, loadForgeConfig, resolvePmRunner, } from "../config/forge-config.js";
+import { FORGE_SKILLS, discoverPackSkills } from "../registry.js";
+function readForgePackageVersion(forgeRoot) {
+    const pkgPath = path.join(forgeRoot, "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return pkg.version ?? "0.0.0-unknown";
+}
+function syncForgeSkills(workspaceRoot, forgeRoot, skillsDir, dryRun) {
+    const updated = [];
+    const agentsSkillsDir = path.join(workspaceRoot, skillsDir);
+    for (const skill of FORGE_SKILLS) {
+        const srcPath = path.join(forgeRoot, skill.path);
+        if (!fs.existsSync(srcPath))
+            continue;
+        const skillName = skill.name;
+        const destDir = path.join(agentsSkillsDir, skillName);
+        const destPath = path.join(destDir, "SKILL.md");
+        if (!dryRun) {
+            fs.mkdirSync(destDir, { recursive: true });
+            const content = fs.readFileSync(srcPath, "utf8");
+            fs.writeFileSync(destPath, content, "utf8");
+            // Sync knowledge files
+            const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (fmMatch) {
+                try {
+                    const fm = parseYaml(fmMatch[1]);
+                    const knowledgeFiles = fm["knowledge"];
+                    if (Array.isArray(knowledgeFiles)) {
+                        const skillSrcDir = path.dirname(srcPath);
+                        for (const kf of knowledgeFiles) {
+                            if (typeof kf !== "string")
+                                continue;
+                            const kfSrcPath = path.join(skillSrcDir, kf);
+                            const kfDestPath = path.join(destDir, kf);
+                            if (fs.existsSync(kfSrcPath)) {
+                                fs.writeFileSync(kfDestPath, fs.readFileSync(kfSrcPath, "utf8"), "utf8");
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Frontmatter parse error — SKILL-01 will catch in validation
+                }
+            }
+        }
+        updated.push(skillName);
+    }
+    return updated;
+}
+function syncPackSkills(workspaceRoot, config, skillsDir, dryRun) {
+    const updated = [];
+    const skipped = [];
+    const agentsSkillsDir = path.join(workspaceRoot, skillsDir);
+    const packSkills = discoverPackSkills(workspaceRoot, config);
+    const forgeSkillNames = new Set(FORGE_SKILLS.map((s) => s.name));
+    for (const skill of packSkills) {
+        const srcPath = path.join(workspaceRoot, skill.dir, skill.path);
+        if (!fs.existsSync(srcPath))
+            continue;
+        const skillName = skill.name;
+        if (forgeSkillNames.has(skillName)) {
+            skipped.push({ name: skillName, reason: "conflict with Forge skill" });
+            continue;
+        }
+        const destDir = path.join(agentsSkillsDir, skillName);
+        const destPath = path.join(destDir, "SKILL.md");
+        if (!dryRun) {
+            fs.mkdirSync(destDir, { recursive: true });
+            const content = fs.readFileSync(srcPath, "utf8");
+            fs.writeFileSync(destPath, content, "utf8");
+            // Sync knowledge files
+            const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (fmMatch) {
+                try {
+                    const fm = parseYaml(fmMatch[1]);
+                    const knowledgeFiles = fm["knowledge"];
+                    if (Array.isArray(knowledgeFiles)) {
+                        const skillSrcDir = path.dirname(srcPath);
+                        for (const kf of knowledgeFiles) {
+                            if (typeof kf !== "string")
+                                continue;
+                            const kfSrcPath = path.join(skillSrcDir, kf);
+                            const kfDestPath = path.join(destDir, kf);
+                            if (fs.existsSync(kfSrcPath)) {
+                                fs.writeFileSync(kfDestPath, fs.readFileSync(kfSrcPath, "utf8"), "utf8");
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Frontmatter parse error
+                }
+            }
+        }
+        updated.push(skillName);
+    }
+    return { updated, skipped };
+}
+function addMissingBindingDefaults(config, dryRun) {
+    if (!config.bindings)
+        return [];
+    const pm = config.project.packageManager;
+    const runner = resolvePmRunner(pm);
+    const added = [];
+    for (const entry of FORGE_CLI_BINDING_DEFAULTS) {
+        const bareKey = entry.key.replace("commands.", "");
+        const currentValue = config.bindings.commands[bareKey];
+        if (currentValue === null || currentValue === undefined) {
+            const resolvedValue = `${runner} ${entry.template}`;
+            added.push({ key: entry.key, value: resolvedValue });
+            if (!dryRun) {
+                config.bindings.commands[bareKey] = resolvedValue;
+            }
+        }
+    }
+    return added;
+}
+function updateSyncedVersion(workspaceRoot, config, version, dryRun) {
+    if (dryRun)
+        return;
+    // Set the syncedVersion on the in-memory config (bindings already updated)
+    config.forge = { syncedVersion: version };
+    // Write the full config back to forge.yaml
+    const forgeYamlPath = path.join(workspaceRoot, "forge.yaml");
+    fs.writeFileSync(forgeYamlPath, stringifyYaml(config), "utf8");
+}
+export async function runUpgrade(input, context) {
+    const { workspaceRoot, dryRun } = context;
+    const isDryRun = dryRun || input.flags["dry-run"] === true;
+    // Step 0: Check forge.yaml exists
+    const forgeYamlPath = path.join(workspaceRoot, "forge.yaml");
+    if (!fs.existsSync(forgeYamlPath)) {
+        return {
+            data: {
+                command: "forge.upgrade",
+                status: "fail",
+                fromVersion: "",
+                toVersion: "",
+                skillsUpdated: [],
+                bindingsAdded: [],
+                skippedSkills: [],
+                doctorReport: null,
+            },
+            nextSteps: [{ action: "Run 'forge create' to create forge.yaml first", kind: "required" }],
+            exitCode: 1,
+            summary: "[forge.upgrade] FAIL — forge.yaml not found. Run 'forge create' first.",
+        };
+    }
+    // Step 1: Resolve forge root and read installed version
+    let forgeRoot;
+    let toVersion;
+    try {
+        forgeRoot = context.forgeRoot ?? resolveForgeRoot(workspaceRoot);
+        toVersion = readForgePackageVersion(forgeRoot);
+    }
+    catch (err) {
+        return {
+            data: {
+                command: "forge.upgrade",
+                status: "fail",
+                fromVersion: "",
+                toVersion: "",
+                skillsUpdated: [],
+                bindingsAdded: [],
+                skippedSkills: [],
+                doctorReport: null,
+            },
+            nextSteps: [
+                { action: "Install @warpgogol/forge first: npm install @warpgogol/forge", kind: "required" },
+            ],
+            exitCode: 1,
+            summary: `[forge.upgrade] FAIL — ${err.message}`,
+        };
+    }
+    // Step 2: Load config and check syncedVersion
+    let config;
+    try {
+        config = loadForgeConfig(workspaceRoot);
+    }
+    catch (err) {
+        return {
+            data: {
+                command: "forge.upgrade",
+                status: "fail",
+                fromVersion: "",
+                toVersion,
+                skillsUpdated: [],
+                bindingsAdded: [],
+                skippedSkills: [],
+                doctorReport: null,
+            },
+            nextSteps: [
+                { action: `Fix forge.yaml: ${err.message}`, kind: "required" },
+            ],
+            exitCode: 1,
+            summary: `[forge.upgrade] FAIL — forge.yaml invalid: ${err.message}`,
+        };
+    }
+    const fromVersion = config.forge?.syncedVersion ?? null;
+    if (fromVersion === toVersion) {
+        // Noop — versions match
+        const nextSteps = [];
+        return {
+            data: {
+                command: "forge.upgrade",
+                status: "noop",
+                fromVersion,
+                toVersion,
+                skillsUpdated: [],
+                bindingsAdded: [],
+                skippedSkills: [],
+                doctorReport: null,
+            },
+            nextSteps,
+            exitCode: 0,
+            summary: `[forge.upgrade] Already up to date (v${toVersion})`,
+        };
+    }
+    // Step 3: Sync forge skills
+    const forgeSkillsUpdated = syncForgeSkills(workspaceRoot, forgeRoot, config.paths.skillsDir, isDryRun);
+    // Step 3b: Sync pack skills
+    const packResult = syncPackSkills(workspaceRoot, config, config.paths.skillsDir, isDryRun);
+    const skillsUpdated = [...forgeSkillsUpdated, ...packResult.updated];
+    // Step 4: Add missing binding defaults
+    const bindingsAdded = addMissingBindingDefaults(config, isDryRun);
+    // Step 5: Update forge.syncedVersion
+    if (!isDryRun) {
+        updateSyncedVersion(workspaceRoot, config, toVersion, false);
+    }
+    // Step 6: Run doctor
+    let doctorReport = null;
+    if (!isDryRun) {
+        try {
+            const { runDoctor } = await import("./doctor.js");
+            const doctorResult = await runDoctor(input, context);
+            doctorReport = doctorResult.data;
+        }
+        catch {
+            // Doctor may fail in some contexts — non-fatal
+        }
+    }
+    // Step 7: Build nextSteps
+    const nextSteps = [];
+    if (isDryRun) {
+        nextSteps.push({ action: "Re-run without --dry-run to apply changes", kind: "required" });
+    }
+    else {
+        nextSteps.push({ action: "Review updated skills in .agents/skills/", kind: "optional" });
+        if (bindingsAdded.length > 0) {
+            nextSteps.push({
+                action: "Review newly added binding defaults in forge.yaml",
+                kind: "optional",
+            });
+        }
+    }
+    const status = "pass";
+    return {
+        data: {
+            command: "forge.upgrade",
+            status,
+            fromVersion: fromVersion ?? "never-synced",
+            toVersion,
+            skillsUpdated,
+            bindingsAdded,
+            skippedSkills: packResult.skipped,
+            doctorReport,
+        },
+        nextSteps,
+        exitCode: 0,
+        summary: isDryRun
+            ? `[dry-run] forge.upgrade: would sync ${skillsUpdated.length} skill(s), add ${bindingsAdded.length} binding(s), update syncedVersion to ${toVersion}`
+            : `[forge.upgrade] OK — ${skillsUpdated.length} skill(s) synced, ${bindingsAdded.length} binding(s) added, syncedVersion → ${toVersion}`,
+    };
+}
+//# sourceMappingURL=upgrade.js.map

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

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

package/dist/src/profiles/stack-profile.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export declare const stackProfileSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/stack-profile@1">;
+    id: z.ZodString;
+    displayName: z.ZodString;
+    detect: z.ZodObject<{
+        anyOf: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    workspace: z.ZodObject<{
+        dirs: z.ZodArray<z.ZodString>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    install: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    firstWorkspace: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>;
+        install: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export interface ProfileFile {
+    path: string;
+    content: string;
+}
+export interface StackProfile {
+    schema: "forge/stack-profile@1";
+    id: string;
+    displayName: string;
+    detect: {
+        anyOf: string[];
+    };
+    workspace: {
+        dirs: string[];
+        files: ProfileFile[];
+    };
+    install: string[];
+    firstWorkspace?: {
+        path: string;
+        files: ProfileFile[];
+        install: string[];
+    };
+}
+export declare function loadStackProfile(profilePath: string): StackProfile;
+export declare function listStackProfiles(forgeRoot: string): StackProfile[];
+export declare function detectStack(projectRoot: string, profiles: StackProfile[]): StackProfile | null;
+//# sourceMappingURL=stack-profile.d.ts.map

package/dist/src/profiles/stack-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-profile.d.ts","sourceRoot":"","sources":["../../../src/profiles/stack-profile.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;iBA6B7B,CAAC;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,uBAAuB,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5B,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,KAAK,EAAE,WAAW,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAMD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAkBlE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAiBnE;AAMD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,GAAG,IAAI,CAO9F"}

package/dist/src/profiles/stack-profile.js

@@ -0,0 +1,119 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Stack profile schema, loader, and detector. Defines what a supported stack looks like and how to detect it in an existing project.</purpose>
+<non-goals>
+  <item>Do not scaffold projects — that is scaffold-project.ts.</item>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0392: initial stack profile module with zod schema, listStackProfiles, detectStack.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { parse as parseYaml } from "yaml";
+// ---------------------------------------------------------------------------
+// Schema (forge/stack-profile@1)
+// ---------------------------------------------------------------------------
+export const stackProfileSchema = z.object({
+    schema: z.literal("forge/stack-profile@1"),
+    id: z.string().min(1),
+    displayName: z.string().min(1),
+    detect: z.object({
+        anyOf: z.array(z.string()).min(1),
+    }),
+    workspace: z.object({
+        dirs: z.array(z.string()).min(1),
+        files: z.array(z.object({
+            path: z.string().min(1),
+            content: z.string(),
+        })),
+    }),
+    install: z.array(z.string()).default([]),
+    firstWorkspace: z
+        .object({
+        path: z.string().min(1),
+        files: z.array(z.object({
+            path: z.string().min(1),
+            content: z.string(),
+        })),
+        install: z.array(z.string()).default([]),
+    })
+        .optional(),
+});
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+export function loadStackProfile(profilePath) {
+    const raw = fs.readFileSync(profilePath, "utf8");
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`Stack profile at ${profilePath} is not valid YAML: ${err.message}`);
+    }
+    const result = stackProfileSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Stack profile at ${profilePath} failed schema validation:\n${issues}`);
+    }
+    return result.data;
+}
+export function listStackProfiles(forgeRoot) {
+    const profilesDir = path.join(forgeRoot, "profiles");
+    if (!fs.existsSync(profilesDir)) {
+        return [];
+    }
+    const entries = fs.readdirSync(profilesDir);
+    const profiles = [];
+    for (const entry of entries) {
+        if (entry.endsWith(".yaml") && !entry.startsWith(".")) {
+            const profilePath = path.join(profilesDir, entry);
+            profiles.push(loadStackProfile(profilePath));
+        }
+    }
+    return profiles;
+}
+// ---------------------------------------------------------------------------
+// Detector
+// ---------------------------------------------------------------------------
+export function detectStack(projectRoot, profiles) {
+    for (const profile of profiles) {
+        if (matchesAnyOf(projectRoot, profile.detect.anyOf)) {
+            return profile;
+        }
+    }
+    return null;
+}
+function matchesAnyOf(projectRoot, patterns) {
+    for (const pattern of patterns) {
+        if (globExists(projectRoot, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+function globExists(dir, pattern) {
+    // Simple glob: support * and *.ext patterns at the root level
+    if (!pattern.includes("*")) {
+        return fs.existsSync(path.join(dir, pattern));
+    }
+    try {
+        const entries = fs.readdirSync(dir);
+        const regex = globToRegex(pattern);
+        return entries.some((e) => regex.test(e));
+    }
+    catch {
+        return false;
+    }
+}
+function globToRegex(pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+    return new RegExp(`^${escaped}$`);
+}
+//# sourceMappingURL=stack-profile.js.map

package/dist/src/profiles/stack-profile.js.map

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