@warpgogol/forge 2.1.0 → 2.3.0

package/dist/src/onboarding/create.js

@@ -0,0 +1,318 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.create — single entry point for project scaffolding. Composes forge.scaffold + forge.init + package-manager post-processing into one command.</purpose>
+<non-goals>
+  <item>Do not change forge.init or forge.scaffold contracts — forge.create delegates to them.</item>
+  <item>Do not add interactive prompts — all configuration is via flags and positional args.</item>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0544: initial forge.create handler composing scaffold + init.</item>
+  <item>RFC-0544 fix: replace double cast on runInit return with proper InitResult typing.</item>
+  <item>RFC-0548: auto-run forge.agents.generate after init, update nextSteps to remove manual AGENTS.md step.</item>
+  <item>RFC-0550: write NEXT_STEPS.md into project root with creator-facing guidance (greenfield vs transplant via LLM).</item>
+  <item>RFC-0640: load profile domain fields and pass them to runInit for domain-aware bootstrapping.</item>
+  <item>RFC-0643: pass profileId to runInit so forge.yaml gets a `profile` field.</item>
+  <item>RFC-0664: scaffold memory layer (.agents/memory/) after init.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { runScaffoldProject } from "./scaffold-project.js";
+import { runInit } from "./init.js";
+import { runAgentsGenerate } from "./agents-generate.js";
+import { scaffoldMemoryLayer } from "./memory-scaffold.js";
+import { loadForgeConfig, resolveForgeRoot, resolvePackageManager, applyCliBindingDefaults, } from "../config/forge-config.js";
+import { listStackProfiles } from "../profiles/stack-profile.js";
+/**
+ * RFC-0640: Load domain fields from the selected profile.
+ * Returns register, domain, terminology, and semanticBindings derived from profile.artifacts[].
+ * When the profile has no domain fields, returns empty object (fallback to current behavior).
+ */
+function loadProfileDomainFields(profileId, forgeRoot) {
+    try {
+        const profiles = listStackProfiles(forgeRoot);
+        const profile = profiles.find((p) => p.id === profileId);
+        if (!profile)
+            return {};
+        const fields = {};
+        fields.profileId = profileId;
+        if (profile.register) {
+            fields.register = profile.register;
+        }
+        if (profile.domain) {
+            fields.domain = profile.domain;
+        }
+        if (profile.terminology) {
+            fields.terminology = profile.terminology;
+        }
+        // Derive semantic binding defaults from profile.artifacts[]
+        if (profile.artifacts && profile.artifacts.length > 0) {
+            const semanticBindings = {};
+            for (const artifact of profile.artifacts) {
+                if (artifact.produce?.command) {
+                    semanticBindings.produce = artifact.produce.command;
+                }
+                if (artifact.validate?.command) {
+                    semanticBindings.validate = artifact.validate.command;
+                }
+            }
+            if (Object.keys(semanticBindings).length > 0) {
+                fields.semanticBindings = semanticBindings;
+            }
+        }
+        return fields;
+    }
+    catch {
+        return {};
+    }
+}
+export async function runCreate(input, context) {
+    const { logger, outputFormat } = context;
+    const name = input.flags["name"];
+    const profile = input.flags["profile"] ?? "forge-shell";
+    const packageManager = input.flags["package-manager"] ?? "pnpm";
+    const template = input.flags["template"];
+    const errors = [];
+    const passNextSteps = [
+        { action: "Open the project in Windsurf", kind: "required" },
+        { action: "Run /forge-bootstrap to configure the project interactively", kind: "optional" },
+    ];
+    const failNextSteps = [
+        { action: "Fix the errors above and re-run forge.create", kind: "required" },
+    ];
+    // 1. Validate name
+    if (!name) {
+        errors.push("Missing required flag: --name <name>");
+        if (outputFormat === "pretty") {
+            logger.error("Missing required flag: --name <name>");
+        }
+        return {
+            data: { command: "forge.create", status: "fail", projectDir: "", profile, filesCreated: [], errors },
+            nextSteps: failNextSteps,
+            exitCode: 1,
+            summary: "forge.create: failed — missing --name flag",
+        };
+    }
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(name)) {
+        const msg = `Project name "${name}" is not kebab-case (expected ^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$)`;
+        errors.push(msg);
+        if (outputFormat === "pretty") {
+            logger.error(msg);
+        }
+        return {
+            data: { command: "forge.create", status: "fail", projectDir: "", profile, filesCreated: [], errors },
+            nextSteps: failNextSteps,
+            exitCode: 1,
+            summary: `forge.create: failed — ${msg}`,
+        };
+    }
+    // 2. Resolve target directory
+    const targetDir = path.resolve(context.workspaceRoot, name);
+    // 3. Refuse if target exists and is non-empty
+    if (fs.existsSync(targetDir)) {
+        const entries = fs.readdirSync(targetDir);
+        if (entries.length > 0) {
+            const msg = `Directory "${name}" already exists and is not empty (contains: ${entries.slice(0, 5).join(", ")}${entries.length > 5 ? "…" : ""})`;
+            errors.push(msg);
+            if (outputFormat === "pretty") {
+                logger.error(msg);
+            }
+            return {
+                data: { command: "forge.create", status: "fail", projectDir: targetDir, profile, filesCreated: [], errors },
+                nextSteps: failNextSteps,
+                exitCode: 1,
+                summary: `forge.create: failed — ${msg}`,
+            };
+        }
+    }
+    // 4. Create target directory
+    fs.mkdirSync(targetDir, { recursive: true });
+    // 4b. Resolve forge root from parent context (the new dir won't have forge installed)
+    let forgeRoot;
+    if (context.forgeRoot) {
+        forgeRoot = context.forgeRoot;
+    }
+    else {
+        try {
+            forgeRoot = resolveForgeRoot(context.workspaceRoot);
+        }
+        catch {
+            forgeRoot = context.workspaceRoot;
+        }
+    }
+    if (outputFormat === "pretty") {
+        logger.info(`Using forge root: ${forgeRoot}`);
+    }
+    // 5. Build child context with workspaceRoot = targetDir and forgeRoot override
+    const childContext = {
+        ...context,
+        workspaceRoot: targetDir,
+        forgeRoot,
+    };
+    // 6. Run forge.scaffold inside target dir
+    const scaffoldInput = {
+        argv: [],
+        flags: { profile, name, ...(template ? { template } : {}) },
+    };
+    const scaffoldResult = await runScaffoldProject(scaffoldInput, childContext);
+    if (scaffoldResult.exitCode !== 0) {
+        const scaffoldErrors = scaffoldResult.data?.errors ?? ["scaffold failed"];
+        return {
+            data: {
+                command: "forge.create",
+                status: "fail",
+                projectDir: targetDir,
+                profile,
+                filesCreated: scaffoldResult.data?.created ?? [],
+                errors: scaffoldErrors,
+            },
+            nextSteps: failNextSteps,
+            exitCode: 1,
+            summary: `forge.create: failed — scaffold step failed`,
+        };
+    }
+    // 7. Run forge.init inside target dir
+    // RFC-0640: load profile domain fields and pass them to runInit
+    const initDomainFields = loadProfileDomainFields(profile, forgeRoot);
+    const initInput = {
+        argv: [],
+        flags: {},
+    };
+    const initResult = runInit(initInput, childContext, initDomainFields);
+    if (outputFormat === "pretty") {
+        logger.info(`Init: ${initResult.status} — ${initResult.created.length} created, ${initResult.skipped.length} skipped, ${initResult.errors.length} errors`);
+        if (initResult.errors.length > 0) {
+            for (const err of initResult.errors.slice(0, 3)) {
+                logger.warn(`  init error: ${err}`);
+            }
+        }
+    }
+    // 7.5. Scaffold memory layer (RFC-0664) — runs regardless of init success
+    const memoryScaffoldResult = scaffoldMemoryLayer(targetDir);
+    if (initResult.status !== "pass") {
+        if (outputFormat === "pretty") {
+            logger.error(`Init failed with ${initResult.errors.length} error(s):`);
+            for (const err of initResult.errors.slice(0, 5)) {
+                logger.error(`  ${err}`);
+            }
+        }
+        return {
+            data: {
+                command: "forge.create",
+                status: "fail",
+                projectDir: targetDir,
+                profile,
+                filesCreated: [...(scaffoldResult.data?.created ?? []), ...(initResult.created ?? []), ...memoryScaffoldResult.created],
+                errors: initResult.errors ?? ["init failed"],
+            },
+            nextSteps: failNextSteps,
+            exitCode: 1,
+            summary: `forge.create: failed — init step failed`,
+        };
+    }
+    // 8. Post-process forge.yaml if --package-manager differs from default
+    if (packageManager !== "pnpm") {
+        const forgeYamlPath = path.join(targetDir, "forge.yaml");
+        if (fs.existsSync(forgeYamlPath)) {
+            try {
+                const config = loadForgeConfig(targetDir);
+                const pm = resolvePackageManager(packageManager);
+                config.project.packageManager = pm;
+                if (config.bindings) {
+                    config.bindings.commands = applyCliBindingDefaults(pm);
+                }
+                // RFC-0643: strip loaded profile object before serializing — forge.yaml stores profile id (string), not the full profile
+                const configToSerialize = { ...config };
+                if (typeof configToSerialize["profile"] === "object") {
+                    const profileObj = configToSerialize["profile"];
+                    configToSerialize["profile"] = profileObj.id ?? configToSerialize["profile"];
+                }
+                fs.writeFileSync(forgeYamlPath, stringifyYaml(configToSerialize), "utf8");
+            }
+            catch {
+                // Post-processing is best-effort — init already wrote a valid config
+            }
+        }
+    }
+    // 9. Auto-run forge.agents.generate (RFC-0548)
+    try {
+        const agentsInput = {
+            argv: [],
+            flags: {},
+        };
+        if (outputFormat === "pretty") {
+            logger.info("Generating AGENTS.md...");
+        }
+        const agentsResult = await runAgentsGenerate(agentsInput, childContext);
+        if (outputFormat === "pretty") {
+            logger.info(`Agents.generate: ${agentsResult.exitCode === 0 ? "ok" : "failed"} — ${(agentsResult.data?.generated ?? []).length} generated, ${(agentsResult.data?.errors ?? []).length} errors`);
+        }
+        if (agentsResult.exitCode !== 0 && outputFormat === "pretty") {
+            logger.warn("forge.agents.generate failed — AGENTS.md not generated. Run 'forge agents generate' manually after fixing the issue.");
+            for (const err of (agentsResult.data?.errors ?? []).slice(0, 3)) {
+                logger.warn(`  ${err}`);
+            }
+        }
+    }
+    catch (err) {
+        if (outputFormat === "pretty") {
+            logger.warn("forge.agents.generate failed — AGENTS.md not generated. Run 'forge agents generate' manually after fixing the issue.");
+            logger.warn(`  ${err.message}`);
+        }
+    }
+    // 10. Write NEXT_STEPS.md (RFC-0550)
+    const nextStepsPath = path.join(targetDir, "NEXT_STEPS.md");
+    const nextStepsContent = `# Next Steps
+
+Your Forge project is ready. You have two options — just tell the AI agent what you want, and it will handle the rest.
+
+## Option A: Start creating
+
+Tell the AI agent what you want to build. Describe your idea in your own words — a website, a game, a blog, a tool — and the system will set everything up and start creating with you.
+
+The agent will run \`/forge-bootstrap\` to configure your project interactively (language, stack bindings, git init).
+
+## Option B: Bring your existing project
+
+If you already have a project elsewhere and want to move it into Forge, tell the AI agent:
+
+> I want to bring my existing project into Forge.
+
+The system will guide you through the process — it detects your project type, migrates the code (including \`.env\` and git-ignored files), optionally transfers git history, and verifies the build.
+
+---
+
+Whichever path you choose, you don't need to run any commands. Just describe what you want in natural language, and the AI agent takes care of it.
+`;
+    fs.writeFileSync(nextStepsPath, nextStepsContent, "utf8");
+    // 11. Collect filesCreated
+    const filesCreated = [
+        ...(scaffoldResult.data?.created ?? []),
+        ...(initResult.created ?? []),
+        ...memoryScaffoldResult.created,
+        "NEXT_STEPS.md",
+    ];
+    if (outputFormat === "pretty") {
+        logger.success(`Created project "${name}" in ${targetDir}`);
+        for (const f of filesCreated) {
+            logger.info(`  created: ${f}`);
+        }
+    }
+    return {
+        data: {
+            command: "forge.create",
+            status: "pass",
+            projectDir: targetDir,
+            profile,
+            filesCreated,
+            errors: [],
+        },
+        nextSteps: passNextSteps,
+        exitCode: 0,
+        summary: `forge.create: OK — created ${name} with ${filesCreated.length} files`,
+    };
+}
+//# sourceMappingURL=create.js.map

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

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

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

@@ -0,0 +1,45 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../types.ts";
+import type { InvariantViolation } from "./invariant-engine.ts";
+interface DoctorCheck {
+    name: string;
+    status: "pass" | "fail" | "warn";
+    message: string;
+    invariantViolations?: InvariantViolation[];
+}
+interface ForbiddenImport {
+    file: string;
+    specifier: string;
+}
+interface BindingValidation {
+    resolved: string[];
+    absent: string[];
+    invalid: string[];
+    notices: BindingNotice[];
+}
+interface BindingNotice {
+    key: string;
+    rule: string;
+    suggestion: string;
+}
+interface DomainReport {
+    domain: string;
+    register: "business" | "creative" | null;
+    terminology: Record<string, string>;
+    invariants: Array<{
+        id: string;
+        rule: string;
+        severity: string;
+    }>;
+    source: "forge.yaml" | "profile" | "default";
+    profileId?: string;
+}
+export declare function runDoctor(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: string;
+    checks: DoctorCheck[];
+    allPass: boolean;
+    forbiddenImports: ForbiddenImport[];
+    bindings: BindingValidation;
+    domain?: DomainReport;
+}>>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/onboarding/doctor.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAkBrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5C;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAkvBD,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgMD,wBAAsB,SAAS,CAC7B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAoQpL"}