@warpgogol/forge 2.1.0 → 2.3.0

package/dist/src/onboarding/upgrade.js

@@ -0,0 +1,391 @@
+/*
+<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.
+With --update-npm, also updates @warpgogol/forge from npm before syncing (skipped in monorepo).</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>
+  <item>RFC-0611: added nested AGENTS.md generation after skill sync.</item>
+  <item>RFC-0663: added syncSharedKnowledge step to sync shared knowledge layer to .agents/skills/shared-knowledge/.</item>
+  <item>RFC-0664: added scaffoldMemoryLayer step to scaffold .agents/memory/ and .gitignore block.</item>
+  <item>Added --update-npm flag: updates @warpgogol/forge from npm before syncing (skipped in monorepo).</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { stringify as stringifyYaml, parse as parseYaml } from "yaml";
+import { FORGE_CLI_BINDING_DEFAULTS, resolveForgeRoot, loadForgeConfig, resolvePmRunner, resolvePmInstall, } from "../config/forge-config.js";
+import { FORGE_SKILLS, discoverPackSkills } from "../registry.js";
+import { generateNestedAgentsMd } from "./nested-agents-generate.js";
+import { scaffoldMemoryLayer } from "./memory-scaffold.js";
+function isMonorepoForge(workspaceRoot) {
+    return fs.existsSync(path.join(workspaceRoot, "packages", "forge", "package.json"));
+}
+function updateNpmPackage(workspaceRoot, config, isDryRun) {
+    if (isMonorepoForge(workspaceRoot)) {
+        return { updated: false, skipped: "monorepo (local package, not npm-installed)" };
+    }
+    const pm = config.project.packageManager;
+    const installCmd = resolvePmInstall(pm);
+    const fullCmd = `${installCmd} @warpgogol/forge@latest`;
+    if (isDryRun) {
+        return { updated: false, skipped: "dry-run" };
+    }
+    try {
+        execSync(fullCmd, {
+            cwd: workspaceRoot,
+            stdio: "pipe",
+            timeout: 120_000,
+        });
+        return { updated: true, skipped: null };
+    }
+    catch {
+        return { updated: false, skipped: "install failed (network error or registry unavailable)" };
+    }
+}
+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 syncSharedKnowledge(workspaceRoot, forgeRoot, skillsDir, dryRun) {
+    const updated = [];
+    const srcPath = path.join(forgeRoot, "skills", "shared", "knowledge", "learned-principles.md");
+    if (!fs.existsSync(srcPath))
+        return updated;
+    const destDir = path.join(workspaceRoot, skillsDir, "shared-knowledge");
+    const destPath = path.join(destDir, "learned-principles.md");
+    if (!dryRun) {
+        fs.mkdirSync(destDir, { recursive: true });
+        fs.writeFileSync(destPath, fs.readFileSync(srcPath, "utf8"), "utf8");
+    }
+    updated.push("shared-knowledge");
+    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;
+    const isUpdateNpm = input.flags["update-npm"] === 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: [],
+                nestedAgentsGenerated: [],
+                memoryScaffold: { created: [], gitignoreUpdated: false, skipped: [] },
+                npmUpdated: false,
+                npmUpdateSkipped: null,
+                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 0.5: Update npm package if --update-npm flag is set
+    let npmUpdated = false;
+    let npmUpdateSkipped = null;
+    if (isUpdateNpm) {
+        let configForNpm;
+        try {
+            configForNpm = loadForgeConfig(workspaceRoot);
+        }
+        catch {
+            configForNpm = { project: { packageManager: "npm" } };
+        }
+        const npmResult = updateNpmPackage(workspaceRoot, configForNpm, isDryRun);
+        npmUpdated = npmResult.updated;
+        npmUpdateSkipped = npmResult.skipped;
+    }
+    // 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: [],
+                nestedAgentsGenerated: [],
+                memoryScaffold: { created: [], gitignoreUpdated: false, skipped: [] },
+                npmUpdated: false,
+                npmUpdateSkipped: null,
+                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: [],
+                nestedAgentsGenerated: [],
+                memoryScaffold: { created: [], gitignoreUpdated: false, skipped: [] },
+                npmUpdated: false,
+                npmUpdateSkipped: null,
+                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: [],
+                nestedAgentsGenerated: [],
+                memoryScaffold: { created: [], gitignoreUpdated: false, skipped: [] },
+                npmUpdated: npmUpdated,
+                npmUpdateSkipped: npmUpdateSkipped,
+                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);
+    // Step 3c: Sync shared knowledge layer (RFC-0663)
+    const sharedKnowledgeUpdated = syncSharedKnowledge(workspaceRoot, forgeRoot, config.paths.skillsDir, isDryRun);
+    const skillsUpdated = [...forgeSkillsUpdated, ...packResult.updated, ...sharedKnowledgeUpdated];
+    // Step 3d: Scaffold memory layer (RFC-0664)
+    const memoryScaffold = isDryRun ? { created: [], gitignoreUpdated: false, skipped: [] } : scaffoldMemoryLayer(workspaceRoot);
+    // Step 4: Add missing binding defaults
+    const bindingsAdded = addMissingBindingDefaults(config, isDryRun);
+    // Step 5: Update forge.syncedVersion
+    if (!isDryRun) {
+        updateSyncedVersion(workspaceRoot, config, toVersion, false);
+    }
+    // Step 5b: Generate nested AGENTS.md (RFC-0611)
+    let nestedAgentsGenerated = [];
+    if (!isDryRun) {
+        try {
+            const nestedResult = await generateNestedAgentsMd(workspaceRoot, config, false);
+            nestedAgentsGenerated = nestedResult.generated;
+        }
+        catch {
+            // Nested generation failure is non-fatal
+        }
+    }
+    // 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,
+            nestedAgentsGenerated,
+            memoryScaffold,
+            npmUpdated,
+            npmUpdateSkipped,
+            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/onboarding/workspace-discovery.d.ts

@@ -0,0 +1,11 @@
+import type { ProfileWorkspaceType } from "../profiles/profile-schema.ts";
+export type WorkspaceType = "app" | "service" | "package" | string;
+export interface WorkspaceDir {
+    path: string;
+    type: WorkspaceType;
+    hasAgentsMd: boolean;
+    isGenerated: boolean;
+}
+export declare function detectWorkspaceType(dirPath: string, workspaceTypes?: ProfileWorkspaceType[]): WorkspaceType | null;
+export declare function discoverWorkspaces(workspaceRoot: string, workspaceTypes?: ProfileWorkspaceType[]): WorkspaceDir[];
+//# sourceMappingURL=workspace-discovery.d.ts.map

package/dist/src/onboarding/workspace-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-discovery.d.ts","sourceRoot":"","sources":["../../../src/onboarding/workspace-discovery.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAWD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,oBAAoB,EAAE,GACtC,aAAa,GAAG,IAAI,CAiCtB;AAiCD,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,oBAAoB,EAAE,GACtC,YAAY,EAAE,CAiDhB"}

package/dist/src/onboarding/workspace-discovery.js

@@ -0,0 +1,138 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Workspace discovery for nested AGENTS.md generation (RFC-0611).
+Scans the project root for directories containing package.json and auto-detects
+workspace type (app, service, package) by content markers.</purpose>
+<non-goals>
+  <item>Do not scan node_modules, .git, dist, .turbo, .cache, .agents directories.</item>
+  <item>Do not read package.json contents — only check existence for workspace detection.</item>
+  <item>Do not add new workspace-type detection rules without an amending RFC.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0611: initial workspace discovery and type auto-detection.</item>
+  <item>RFC-0640: accept optional workspaceTypes from profile for profile-driven detection, falling back to hardcoded detection when absent.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { hasGeneratedMarker } from "../utils/index.js";
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    ".turbo",
+    ".cache",
+    ".agents",
+]);
+export function detectWorkspaceType(dirPath, workspaceTypes) {
+    if (!fs.existsSync(path.join(dirPath, "package.json")))
+        return null;
+    // RFC-0640: try profile-driven detection first
+    if (workspaceTypes && workspaceTypes.length > 0) {
+        for (const wt of workspaceTypes) {
+            if (matchesWorkspaceType(dirPath, wt)) {
+                return wt.id;
+            }
+        }
+        // RFC-0640: when workspaceTypes is present, it fully replaces hardcoded detection
+        // Directories matching no profile-declared workspace type are not classified
+        return null;
+    }
+    // Fallback: hardcoded detection (software domain)
+    if (fs.existsSync(path.join(dirPath, "astro.config.mjs")) ||
+        fs.existsSync(path.join(dirPath, "astro.config.js")) ||
+        fs.existsSync(path.join(dirPath, "astro.config.ts"))) {
+        return "app";
+    }
+    if (fs.existsSync(path.join(dirPath, "Dockerfile")) ||
+        fs.existsSync(path.join(dirPath, "service.config.yaml")) ||
+        fs.existsSync(path.join(dirPath, "service.config.yml"))) {
+        return "service";
+    }
+    return "package";
+}
+function matchesWorkspaceType(dirPath, wt) {
+    const { glob: globPattern, contains, packageJsonDep } = wt.detect;
+    if (globPattern) {
+        try {
+            const entries = fs.readdirSync(dirPath);
+            const regex = globToRegex(globPattern);
+            if (entries.some((e) => regex.test(e)))
+                return true;
+        }
+        catch {
+            // dir not readable
+        }
+    }
+    if (contains) {
+        const filePath = path.join(dirPath, contains);
+        if (fs.existsSync(filePath))
+            return true;
+    }
+    if (packageJsonDep) {
+        try {
+            const pkgJson = JSON.parse(fs.readFileSync(path.join(dirPath, "package.json"), "utf8"));
+            const deps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };
+            if (packageJsonDep in deps)
+                return true;
+        }
+        catch {
+            // package.json not readable
+        }
+    }
+    return false;
+}
+export function discoverWorkspaces(workspaceRoot, workspaceTypes) {
+    const results = [];
+    function scanDir(dirPath, depth) {
+        if (depth > 5)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            const childPath = path.join(dirPath, entry.name);
+            const type = detectWorkspaceType(childPath, workspaceTypes);
+            if (type !== null) {
+                const agentsMdPath = path.join(childPath, "AGENTS.md");
+                const hasAgentsMd = fs.existsSync(agentsMdPath);
+                let isGenerated = false;
+                if (hasAgentsMd) {
+                    try {
+                        const content = fs.readFileSync(agentsMdPath, "utf8");
+                        isGenerated = hasGeneratedMarker(content);
+                    }
+                    catch {
+                        // unreadable — treat as not generated
+                    }
+                }
+                results.push({
+                    path: path.relative(workspaceRoot, childPath),
+                    type,
+                    hasAgentsMd,
+                    isGenerated,
+                });
+                scanDir(childPath, depth + 1);
+            }
+            else {
+                scanDir(childPath, depth + 1);
+            }
+        }
+    }
+    scanDir(workspaceRoot, 0);
+    return results;
+}
+function globToRegex(pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+    return new RegExp(`^${escaped}$`);
+}
+//# sourceMappingURL=workspace-discovery.js.map

package/dist/src/onboarding/workspace-discovery.js.map

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