@warpgogol/forge 4.1.6 → 4.2.1

package/dist/src/onboarding/create.js

@@ -0,0 +1,408 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.create — in-place project scaffolding. Composes forge.scaffold + forge.init + package-manager post-processing into one command. Scaffolds directly into the current directory (no subdirectory).</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>
+  <item>Do not create subdirectories — --in-place is the only mode (RFC-0877).</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>
+  <item>RFC-0877: in-place mode only — --in-place flag required, no subdirectory creation, name derived from folder, strict empty-directory check (only .git/ tolerated).</item>
+  <item>Initialize git repo with --initial-branch=main if .git does not exist (hard guard for main branch default).</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+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;
+            }
+        }
+        if (profile.compass) {
+            fields.compass = profile.compass;
+        }
+        return fields;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Convert a string to kebab-case.
+ * Handles camelCase, PascalCase, snake_case, spaces, and mixed separators.
+ */
+function toKebabCase(s) {
+    return s
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
+        .replace(/[_\s]+/g, "-")
+        .replace(/[^a-zA-Z0-9-]/g, "")
+        .toLowerCase()
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Directories that are allowed in an otherwise empty target directory.
+ * Only these are tolerated when checking for emptiness.
+ */
+const ALLOWED_EXISTING_DIRS = new Set([".git"]);
+export async function runCreate(input, context) {
+    const { logger, outputFormat } = context;
+    const inPlace = input.flags["in-place"];
+    const nameOverride = input.flags["name"];
+    const profile = input.flags["profile"];
+    const packageManager = input.flags["package-manager"] ?? "pnpm";
+    const template = input.flags["template"];
+    const errors = [];
+    const passNextSteps = [
+        { action: "Run /forge-bootstrap immediately to configure language, register, and stack bindings", kind: "required" },
+    ];
+    const failNextSteps = [
+        { action: "Fix the errors above and re-run forge.create", kind: "required" },
+    ];
+    // 1. --in-place is required (RFC-0877)
+    if (!inPlace) {
+        const msg = "Missing required flag: --in-place";
+        errors.push(msg);
+        if (outputFormat === "pretty") {
+            logger.error(msg);
+        }
+        return {
+            data: { command: "forge.create", status: "fail", projectDir: "", profile: profile ?? "", filesCreated: [], errors },
+            nextSteps: failNextSteps,
+            exitCode: 1,
+            summary: "forge.create: failed — missing --in-place flag",
+        };
+    }
+    // 2. --profile is required (RFC-0877)
+    if (!profile) {
+        const msg = "Missing required flag: --profile <profile-id>";
+        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 — missing --profile flag",
+        };
+    }
+    // 3. Resolve target directory — in-place mode uses workspaceRoot directly
+    const targetDir = path.resolve(context.workspaceRoot);
+    // 4. Derive project name from folder name if not provided
+    let name;
+    if (nameOverride) {
+        name = nameOverride;
+    }
+    else {
+        const folderName = path.basename(targetDir);
+        name = toKebabCase(folderName);
+        if (!name) {
+            const msg = `Cannot derive project name from folder "${folderName}" — provide --name explicitly`;
+            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}`,
+            };
+        }
+    }
+    // 5. Validate kebab-case
+    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: targetDir, profile, filesCreated: [], errors },
+            nextSteps: failNextSteps,
+            exitCode: 1,
+            summary: `forge.create: failed — ${msg}`,
+        };
+    }
+    // 6. Strict empty-directory check (RFC-0877)
+    // The target directory must be empty (only .git/ is tolerated).
+    // If any other files or directories exist, refuse to scaffold.
+    let dirEntries;
+    try {
+        dirEntries = fs.readdirSync(targetDir);
+    }
+    catch {
+        dirEntries = [];
+    }
+    const unexpectedEntries = dirEntries.filter((e) => !ALLOWED_EXISTING_DIRS.has(e));
+    if (unexpectedEntries.length > 0) {
+        const msg = `Directory is not empty. Found: ${unexpectedEntries.slice(0, 10).join(", ")}${unexpectedEntries.length > 10 ? ` (and ${unexpectedEntries.length - 10} more)` : ""}. The target directory must be empty. Refusing to scaffold.`;
+        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}`,
+        };
+    }
+    // 6.5. Initialize git repo with main branch (if not already initialized)
+    // This is a hard guard — forge.create programmatically ensures main branch,
+    // so greenfield projects don't depend on the agent running git init correctly.
+    const gitDir = path.join(targetDir, ".git");
+    if (!fs.existsSync(gitDir)) {
+        try {
+            execFileSync("git", ["init", "--initial-branch=main"], { cwd: targetDir, stdio: "pipe" });
+            if (outputFormat === "pretty") {
+                logger.info("Initialized git repository with main branch");
+            }
+        }
+        catch {
+            if (outputFormat === "pretty") {
+                logger.warn("Failed to initialize git repository — run 'git init --initial-branch=main' manually");
+            }
+        }
+    }
+    // 7. Resolve forge root
+    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}`);
+    }
+    // 8. Build child context with workspaceRoot = targetDir and forgeRoot override
+    const childContext = {
+        ...context,
+        workspaceRoot: targetDir,
+        forgeRoot,
+    };
+    // 9. 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`,
+        };
+    }
+    // 10. 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}`);
+            }
+        }
+    }
+    // 10.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${initResult.errors.length === 1 ? "" : "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`,
+        };
+    }
+    // 11. 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
+            }
+        }
+    }
+    // 12. 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}`);
+        }
+    }
+    // 13. Write NEXT_STEPS.md (RFC-0550)
+    const nextStepsPath = path.join(targetDir, "NEXT_STEPS.md");
+    const nextStepsContent = `# Next Steps
+
+Your Forge project is ready. The next step is mandatory: run \`/forge-bootstrap\` to configure your project interactively.
+
+## Step 1: Configure your project (required)
+
+Run \`/forge-bootstrap\` now. It will ask you:
+
+- Which language the AI should communicate with you in
+- Which language project documentation should be written in (defaults to English)
+- Whether you prefer a business or creative working style
+- Your name and how you want to be addressed
+- Your stack configuration (or migrate an existing project)
+
+This step is required before any work begins — it sets up language preferences, communication style, and project bindings.
+
+## Step 2: Start creating
+
+After configuration, 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.
+
+## Alternative: 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.
+`;
+    fs.writeFileSync(nextStepsPath, nextStepsContent, "utf8");
+    // 14. 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":"AAkCA,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;AA8zBD,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;AAiOD,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,CA2QpL"}