javi-forge 1.6.1 → 1.7.0

package/dist/commands/init/steps/agent-skills.js

@@ -0,0 +1,45 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { AGENT_SKILLS_MANIFEST_FILE } from "../../../constants.js";
+import { report } from "../report.js";
+/**
+ * Step 17: Generate Agent Skills manifest (skills.json).
+ *
+ * - In dry-run mode, reports what would be created without touching disk.
+ * - Otherwise writes <projectDir>/<AGENT_SKILLS_MANIFEST_FILE> with an empty
+ *   skills array unless the file already exists (idempotent).
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 6 of 6).
+ */
+export const stepAgentSkills = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { projectName } = options;
+    const stepId = "agent-skills";
+    report(onStep, stepId, "Generate Agent Skills manifest (skills.json)", "running");
+    try {
+        if (!dryRun) {
+            const skillsManifest = {
+                name: projectName,
+                version: "0.1.0",
+                description: `Agent Skills manifest for ${projectName}`,
+                skills: [],
+            };
+            const skillsJsonPath = path.join(projectDir, AGENT_SKILLS_MANIFEST_FILE);
+            if (!(await fs.pathExists(skillsJsonPath))) {
+                await fs.writeJson(skillsJsonPath, skillsManifest, { spaces: 2 });
+                report(onStep, stepId, "Generate Agent Skills manifest (skills.json)", "done", AGENT_SKILLS_MANIFEST_FILE);
+            }
+            else {
+                report(onStep, stepId, "Generate Agent Skills manifest (skills.json)", "done", "already exists");
+            }
+        }
+        else {
+            report(onStep, stepId, "Generate Agent Skills manifest (skills.json)", "done", `dry-run: would generate ${AGENT_SKILLS_MANIFEST_FILE}`);
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Generate Agent Skills manifest (skills.json)", "error", String(e));
+    }
+};
+//# sourceMappingURL=agent-skills.js.map

package/dist/commands/init/steps/ai-sync.d.ts

@@ -0,0 +1,15 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 7: AI config sync (delegated to javi-ai).
+ *
+ * - When aiSync is false, reports "skipped".
+ * - When dryRun, reports a done message without invoking javi-ai.
+ * - Otherwise shells out to `npx javi-ai sync --project-dir <projectDir> --target all`.
+ * - Detects soft failures via stderr (e.g. "Raw mode is not supported", "ERROR").
+ * - Hard failures (ENOENT, not found, ERR_MODULE_NOT_FOUND) report a helpful install hint.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 3 of 6).
+ */
+export declare const stepAISync: StepFn;
+//# sourceMappingURL=ai-sync.d.ts.map

package/dist/commands/init/steps/ai-sync.js

@@ -0,0 +1,62 @@
+import { execFileAsync } from "../../../lib/exec.js";
+import { report } from "../report.js";
+/**
+ * Step 7: AI config sync (delegated to javi-ai).
+ *
+ * - When aiSync is false, reports "skipped".
+ * - When dryRun, reports a done message without invoking javi-ai.
+ * - Otherwise shells out to `npx javi-ai sync --project-dir <projectDir> --target all`.
+ * - Detects soft failures via stderr (e.g. "Raw mode is not supported", "ERROR").
+ * - Hard failures (ENOENT, not found, ERR_MODULE_NOT_FOUND) report a helpful install hint.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 3 of 6).
+ */
+export const stepAISync = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { aiSync } = options;
+    const stepId = "ai-sync";
+    report(onStep, stepId, "Sync AI config via javi-ai", "running");
+    try {
+        if (aiSync) {
+            if (!dryRun) {
+                try {
+                    const { stderr } = await execFileAsync("npx", ["javi-ai", "sync", "--project-dir", projectDir, "--target", "all"], {
+                        cwd: projectDir,
+                        timeout: 120_000,
+                    });
+                    // javi-ai may exit 0 but crash (e.g. Ink raw mode error) — detect via stderr
+                    if (stderr &&
+                        (stderr.includes("Raw mode is not supported") ||
+                            stderr.includes("ERROR"))) {
+                        report(onStep, stepId, "Sync AI config via javi-ai", "error", "javi-ai crashed. Run manually: npx javi-ai sync --project-dir . --target all");
+                    }
+                    else {
+                        report(onStep, stepId, "Sync AI config via javi-ai", "done", "javi-ai sync --target all");
+                    }
+                }
+                catch (syncErr) {
+                    const msg = syncErr instanceof Error ? syncErr.message : String(syncErr);
+                    if (msg.includes("ENOENT") ||
+                        msg.includes("not found") ||
+                        msg.includes("ERR_MODULE_NOT_FOUND")) {
+                        report(onStep, stepId, "Sync AI config via javi-ai", "error", "javi-ai not found. Install with: npm install -g javi-ai (or run npx javi-ai sync manually)");
+                    }
+                    else {
+                        report(onStep, stepId, "Sync AI config via javi-ai", "error", msg);
+                    }
+                }
+            }
+            else {
+                report(onStep, stepId, "Sync AI config via javi-ai", "done", "dry-run: would run javi-ai sync --target all");
+            }
+        }
+        else {
+            report(onStep, stepId, "Sync AI config via javi-ai", "skipped", "not selected");
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Sync AI config via javi-ai", "error", String(e));
+    }
+};
+//# sourceMappingURL=ai-sync.js.map

package/dist/commands/init/steps/ci.d.ts

@@ -0,0 +1,24 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 3: Copy CI template.
+ *
+ * - Generates the CI workflow for the detected stack + provider.
+ * - Writes to getCIDestination(ciProvider), backing up any existing file.
+ * - Skips with "no template for <stack>" when generateCIWorkflow returns empty.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 2 of 6).
+ */
+export declare const stepCITemplate: StepFn;
+/**
+ * Step 5: Generate dependabot.yml.
+ *
+ * - Only runs when ciProvider === "github".
+ * - Writes .github/dependabot.yml with backup of any existing file.
+ * - Otherwise reports skipped with "not needed for <ciProvider>".
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 2 of 6).
+ */
+export declare const stepDependabot: StepFn;
+//# sourceMappingURL=ci.d.ts.map

package/dist/commands/init/steps/ci.js

@@ -0,0 +1,74 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { backupIfExists, ensureDirExists } from "../../../lib/common.js";
+import { generateCIWorkflow, generateDependabotYml, getCIDestination, } from "../../../lib/template.js";
+import { report } from "../report.js";
+/**
+ * Step 3: Copy CI template.
+ *
+ * - Generates the CI workflow for the detected stack + provider.
+ * - Writes to getCIDestination(ciProvider), backing up any existing file.
+ * - Skips with "no template for <stack>" when generateCIWorkflow returns empty.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 2 of 6).
+ */
+export const stepCITemplate = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { stack, ciProvider } = options;
+    const stepId = "ci-template";
+    report(onStep, stepId, `Copy ${ciProvider} CI workflow`, "running");
+    try {
+        const ciContent = await generateCIWorkflow(stack, ciProvider);
+        if (ciContent) {
+            const dest = path.join(projectDir, getCIDestination(ciProvider));
+            if (!dryRun) {
+                await backupIfExists(dest);
+                await ensureDirExists(path.dirname(dest));
+                await fs.writeFile(dest, ciContent, "utf-8");
+            }
+            report(onStep, stepId, `Copy ${ciProvider} CI workflow`, "done", getCIDestination(ciProvider));
+        }
+        else {
+            report(onStep, stepId, `Copy ${ciProvider} CI workflow`, "skipped", `no template for ${stack}`);
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, `Copy ${ciProvider} CI workflow`, "error", String(e));
+    }
+};
+/**
+ * Step 5: Generate dependabot.yml.
+ *
+ * - Only runs when ciProvider === "github".
+ * - Writes .github/dependabot.yml with backup of any existing file.
+ * - Otherwise reports skipped with "not needed for <ciProvider>".
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 2 of 6).
+ */
+export const stepDependabot = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { stack, ciProvider } = options;
+    const stepId = "dependabot";
+    report(onStep, stepId, "Generate dependabot.yml", "running");
+    try {
+        if (ciProvider === "github") {
+            const content = await generateDependabotYml([stack], true);
+            const dest = path.join(projectDir, ".github", "dependabot.yml");
+            if (!dryRun) {
+                await backupIfExists(dest);
+                await ensureDirExists(path.dirname(dest));
+                await fs.writeFile(dest, content, "utf-8");
+            }
+            report(onStep, stepId, "Generate dependabot.yml", "done");
+        }
+        else {
+            report(onStep, stepId, "Generate dependabot.yml", "skipped", `not needed for ${ciProvider}`);
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Generate dependabot.yml", "error", String(e));
+    }
+};
+//# sourceMappingURL=ci.js.map

package/dist/commands/init/steps/claude-md.d.ts

@@ -0,0 +1,14 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 12: Generate CLAUDE.md (smart: project-aware).
+ *
+ * - When claudeMd is false, reports "skipped".
+ * - If CLAUDE.md already exists at the project root, reports "done" with "already exists".
+ * - Otherwise detects the project stack and writes a smart CLAUDE.md;
+ *   the detail mentions the number of recommended skills detected.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 4 of 6).
+ */
+export declare const stepClaudeMd: StepFn;
+//# sourceMappingURL=claude-md.d.ts.map

package/dist/commands/init/steps/claude-md.js

@@ -0,0 +1,54 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { generateSmartClaudeMd } from "../../../lib/claudemd.js";
+import { detectProjectStack } from "../../../lib/stack-detector.js";
+import { report } from "../report.js";
+/**
+ * Step 12: Generate CLAUDE.md (smart: project-aware).
+ *
+ * - When claudeMd is false, reports "skipped".
+ * - If CLAUDE.md already exists at the project root, reports "done" with "already exists".
+ * - Otherwise detects the project stack and writes a smart CLAUDE.md;
+ *   the detail mentions the number of recommended skills detected.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 4 of 6).
+ */
+export const stepClaudeMd = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { claudeMd } = options;
+    const stepId = "claude-md";
+    report(onStep, stepId, "Generate CLAUDE.md", "running");
+    try {
+        if (claudeMd) {
+            const claudeMdPath = path.join(projectDir, "CLAUDE.md");
+            if (await fs.pathExists(claudeMdPath)) {
+                report(onStep, stepId, "Generate CLAUDE.md", "done", "already exists");
+            }
+            else {
+                if (!dryRun) {
+                    // Detect project stack for smart CLAUDE.md generation
+                    const detection = await detectProjectStack(projectDir).catch(() => null);
+                    const content = generateSmartClaudeMd(options, detection);
+                    await fs.writeFile(claudeMdPath, content, "utf-8");
+                    // detection itself can be null from .catch(() => null) above;
+                    // recommendedSkills is always an array if detection succeeds.
+                    const skillCount = detection?.recommendedSkills.length ?? 0;
+                    report(onStep, stepId, "Generate CLAUDE.md", "done", skillCount > 0
+                        ? `CLAUDE.md (${skillCount} skills detected)`
+                        : "CLAUDE.md");
+                }
+                else {
+                    report(onStep, stepId, "Generate CLAUDE.md", "done", "dry-run: would generate CLAUDE.md");
+                }
+            }
+        }
+        else {
+            report(onStep, stepId, "Generate CLAUDE.md", "skipped", "not selected");
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Generate CLAUDE.md", "error", String(e));
+    }
+};
+//# sourceMappingURL=claude-md.js.map

package/dist/commands/init/steps/code-graph.d.ts

@@ -0,0 +1,16 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 15: Scaffold RepoForge code graph.
+ *
+ * - When options.codeGraph is false, reports "skipped".
+ * - Otherwise:
+ *   1. Copies .repoforge.yaml config (skip if exists).
+ *   2. Ensures .repoforge/ output dir exists.
+ *   3. Copies the graph generation CI workflow when ciProvider === "github".
+ *   4. Copies the MCP config snippet with __PROJECT_NAME__ interpolation.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 5 of 6).
+ */
+export declare const stepCodeGraph: StepFn;
+//# sourceMappingURL=code-graph.d.ts.map

package/dist/commands/init/steps/code-graph.js

@@ -0,0 +1,68 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { TEMPLATES_DIR } from "../../../constants.js";
+import { backupIfExists, ensureDirExists } from "../../../lib/common.js";
+import { report } from "../report.js";
+/**
+ * Step 15: Scaffold RepoForge code graph.
+ *
+ * - When options.codeGraph is false, reports "skipped".
+ * - Otherwise:
+ *   1. Copies .repoforge.yaml config (skip if exists).
+ *   2. Ensures .repoforge/ output dir exists.
+ *   3. Copies the graph generation CI workflow when ciProvider === "github".
+ *   4. Copies the MCP config snippet with __PROJECT_NAME__ interpolation.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 5 of 6).
+ */
+export const stepCodeGraph = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { projectName, ciProvider } = options;
+    const stepId = "code-graph";
+    report(onStep, stepId, "Scaffold RepoForge code graph", "running");
+    try {
+        if (options.codeGraph) {
+            if (!dryRun) {
+                // 1. Copy .repoforge.yaml config
+                const repoforgeConfigSrc = path.join(TEMPLATES_DIR, "common", "repoforge", "repoforge.yaml");
+                const repoforgeConfigDest = path.join(projectDir, ".repoforge.yaml");
+                if (!(await fs.pathExists(repoforgeConfigDest))) {
+                    await fs.copy(repoforgeConfigSrc, repoforgeConfigDest);
+                }
+                // 2. Ensure .repoforge/ output dir exists
+                await ensureDirExists(path.join(projectDir, ".repoforge"));
+                // 3. Copy CI workflow for graph generation (GitHub only)
+                if (ciProvider === "github") {
+                    const graphWorkflowSrc = path.join(TEMPLATES_DIR, "github", "repoforge-graph.yml");
+                    if (await fs.pathExists(graphWorkflowSrc)) {
+                        const graphWorkflowDest = path.join(projectDir, ".github", "workflows", "repoforge-graph.yml");
+                        await ensureDirExists(path.dirname(graphWorkflowDest));
+                        await backupIfExists(graphWorkflowDest);
+                        await fs.copy(graphWorkflowSrc, graphWorkflowDest, {
+                            overwrite: false,
+                        });
+                    }
+                }
+                // 4. Copy MCP config snippet for repoforge code intelligence
+                const mcpSnippetSrc = path.join(TEMPLATES_DIR, "common", "repoforge", "mcp-repoforge-snippet.json");
+                if (await fs.pathExists(mcpSnippetSrc)) {
+                    const mcpSnippetDest = path.join(projectDir, ".repoforge", "mcp-config-snippet.json");
+                    let content = await fs.readFile(mcpSnippetSrc, "utf-8");
+                    content = content.replace(/__PROJECT_NAME__/g, projectName);
+                    await fs.writeFile(mcpSnippetDest, content, "utf-8");
+                }
+            }
+            report(onStep, stepId, "Scaffold RepoForge code graph", "done", dryRun
+                ? "dry-run: would scaffold .repoforge.yaml + CI + MCP"
+                : ".repoforge.yaml + CI + MCP snippet");
+        }
+        else {
+            report(onStep, stepId, "Scaffold RepoForge code graph", "skipped", "not selected");
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Scaffold RepoForge code graph", "error", String(e));
+    }
+};
+//# sourceMappingURL=code-graph.js.map

package/dist/commands/init/steps/context-dir.d.ts

@@ -0,0 +1,13 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 11: Generate .context/ directory.
+ *
+ * - When contextDir is false, reports "skipped".
+ * - If .context/ already exists, reports "done" with "already exists".
+ * - Otherwise generates INDEX.md + summary.md via generateContextDir().
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 4 of 6).
+ */
+export declare const stepContextDir: StepFn;
+//# sourceMappingURL=context-dir.d.ts.map

package/dist/commands/init/steps/context-dir.js

@@ -0,0 +1,47 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { ensureDirExists } from "../../../lib/common.js";
+import { generateContextDir } from "../../../lib/context.js";
+import { report } from "../report.js";
+/**
+ * Step 11: Generate .context/ directory.
+ *
+ * - When contextDir is false, reports "skipped".
+ * - If .context/ already exists, reports "done" with "already exists".
+ * - Otherwise generates INDEX.md + summary.md via generateContextDir().
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 4 of 6).
+ */
+export const stepContextDir = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { contextDir } = options;
+    const stepId = "context-dir";
+    report(onStep, stepId, "Generate .context/ directory", "running");
+    try {
+        if (contextDir) {
+            const contextDirPath = path.join(projectDir, ".context");
+            if (await fs.pathExists(contextDirPath)) {
+                report(onStep, stepId, "Generate .context/ directory", "done", "already exists");
+            }
+            else {
+                if (!dryRun) {
+                    const { index, summary } = await generateContextDir(options);
+                    await ensureDirExists(contextDirPath);
+                    await fs.writeFile(path.join(contextDirPath, "INDEX.md"), index, "utf-8");
+                    await fs.writeFile(path.join(contextDirPath, "summary.md"), summary, "utf-8");
+                }
+                report(onStep, stepId, "Generate .context/ directory", "done", dryRun
+                    ? "dry-run: would generate .context/"
+                    : ".context/INDEX.md + summary.md");
+            }
+        }
+        else {
+            report(onStep, stepId, "Generate .context/ directory", "skipped", "not selected");
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Generate .context/ directory", "error", String(e));
+    }
+};
+//# sourceMappingURL=context-dir.js.map

package/dist/commands/init/steps/docker-deploy.d.ts

@@ -0,0 +1,16 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 13: Scaffold Docker zero-downtime deploy.
+ *
+ * - When options.dockerDeploy is false, reports "skipped".
+ * - Resolves the deploy destination for the configured CI provider; reports
+ *   "error" when no destination/template exists for that provider.
+ * - If the destination file already exists, reports "done" with "already exists".
+ * - Otherwise renders the deploy workflow with options.dockerServiceName ?? "app"
+ *   and writes it (backing up any existing file).
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 4 of 6).
+ */
+export declare const stepDockerDeploy: StepFn;
+//# sourceMappingURL=docker-deploy.d.ts.map

package/dist/commands/init/steps/docker-deploy.js

@@ -0,0 +1,60 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { backupIfExists, ensureDirExists } from "../../../lib/common.js";
+import { generateDeployWorkflow, getDeployDestination, } from "../../../lib/template.js";
+import { report } from "../report.js";
+/**
+ * Step 13: Scaffold Docker zero-downtime deploy.
+ *
+ * - When options.dockerDeploy is false, reports "skipped".
+ * - Resolves the deploy destination for the configured CI provider; reports
+ *   "error" when no destination/template exists for that provider.
+ * - If the destination file already exists, reports "done" with "already exists".
+ * - Otherwise renders the deploy workflow with options.dockerServiceName ?? "app"
+ *   and writes it (backing up any existing file).
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 4 of 6).
+ */
+export const stepDockerDeploy = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { ciProvider } = options;
+    const stepId = "docker-deploy";
+    report(onStep, stepId, "Scaffold Docker zero-downtime deploy", "running");
+    try {
+        if (options.dockerDeploy) {
+            const deployDest = getDeployDestination(ciProvider);
+            if (deployDest) {
+                const fullDest = path.join(projectDir, deployDest);
+                if (await fs.pathExists(fullDest)) {
+                    report(onStep, stepId, "Scaffold Docker zero-downtime deploy", "done", "already exists");
+                }
+                else {
+                    const serviceName = options.dockerServiceName || "app";
+                    const content = await generateDeployWorkflow(ciProvider, serviceName);
+                    if (content) {
+                        if (!dryRun) {
+                            await backupIfExists(fullDest);
+                            await ensureDirExists(path.dirname(fullDest));
+                            await fs.writeFile(fullDest, content, "utf-8");
+                        }
+                        report(onStep, stepId, "Scaffold Docker zero-downtime deploy", "done", dryRun ? `dry-run: would create ${deployDest}` : deployDest);
+                    }
+                    else {
+                        report(onStep, stepId, "Scaffold Docker zero-downtime deploy", "error", `no deploy template for ${ciProvider}`);
+                    }
+                }
+            }
+            else {
+                report(onStep, stepId, "Scaffold Docker zero-downtime deploy", "error", `no deploy destination for ${ciProvider}`);
+            }
+        }
+        else {
+            report(onStep, stepId, "Scaffold Docker zero-downtime deploy", "skipped", "not selected");
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Scaffold Docker zero-downtime deploy", "error", String(e));
+    }
+};
+//# sourceMappingURL=docker-deploy.js.map

package/dist/commands/init/steps/ghagga.d.ts

@@ -0,0 +1,15 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 9: Install GHAGGA review system.
+ *
+ * - When ghagga is false, reports "skipped".
+ * - Copies <MODULES_DIR>/ghagga → <project>/.javi-forge/modules/ghagga (no overwrite).
+ * - For GitHub provider, also copies the ghagga-review.yml caller workflow into
+ *   <project>/.github/workflows/.
+ * - If module source dir is missing, reports "error" with "module not found".
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 3 of 6).
+ */
+export declare const stepGhagga: StepFn;
+//# sourceMappingURL=ghagga.d.ts.map

package/dist/commands/init/steps/ghagga.js

@@ -0,0 +1,58 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { FORGE_ROOT, MODULES_DIR } from "../../../constants.js";
+import { ensureDirExists } from "../../../lib/common.js";
+import { report } from "../report.js";
+/**
+ * Step 9: Install GHAGGA review system.
+ *
+ * - When ghagga is false, reports "skipped".
+ * - Copies <MODULES_DIR>/ghagga → <project>/.javi-forge/modules/ghagga (no overwrite).
+ * - For GitHub provider, also copies the ghagga-review.yml caller workflow into
+ *   <project>/.github/workflows/.
+ * - If module source dir is missing, reports "error" with "module not found".
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 3 of 6).
+ */
+export const stepGhagga = async (ctx) => {
+    const { projectDir, dryRun, onStep, options } = ctx;
+    const { ghagga, ciProvider } = options;
+    const stepId = "ghagga";
+    report(onStep, stepId, "Install GHAGGA review system", "running");
+    try {
+        if (ghagga) {
+            const ghaggaSrc = path.join(MODULES_DIR, "ghagga");
+            if (await fs.pathExists(ghaggaSrc)) {
+                if (!dryRun) {
+                    const ghaggaDest = path.join(projectDir, ".javi-forge", "modules", "ghagga");
+                    await ensureDirExists(ghaggaDest);
+                    await fs.copy(ghaggaSrc, ghaggaDest, {
+                        overwrite: false,
+                        errorOnExist: false,
+                    });
+                    // Copy ghagga caller workflow to CI provider location
+                    if (ciProvider === "github") {
+                        const workflowSrc = path.join(FORGE_ROOT, "templates", "github", "ghagga-review.yml");
+                        if (await fs.pathExists(workflowSrc)) {
+                            const workflowDest = path.join(projectDir, ".github", "workflows", "ghagga-review.yml");
+                            await ensureDirExists(path.dirname(workflowDest));
+                            await fs.copy(workflowSrc, workflowDest, { overwrite: false });
+                        }
+                    }
+                }
+                report(onStep, stepId, "Install GHAGGA review system", "done");
+            }
+            else {
+                report(onStep, stepId, "Install GHAGGA review system", "error", "module not found");
+            }
+        }
+        else {
+            report(onStep, stepId, "Install GHAGGA review system", "skipped", "not selected");
+        }
+    }
+    catch (e) {
+        report(onStep, stepId, "Install GHAGGA review system", "error", String(e));
+    }
+};
+//# sourceMappingURL=ghagga.js.map

package/dist/commands/init/steps/git.d.ts

@@ -0,0 +1,25 @@
+import type { StepFn } from "../types.js";
+/**
+ * Step 1: Initialize git repository.
+ *
+ * - If .git is missing, runs `git init` in the project dir.
+ * - If .git already exists, reports "done" with detail "already exists".
+ * - In dry-run, skips the actual `git init` call but still reports.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 1 of 6).
+ */
+export declare const stepGitInit: StepFn;
+/**
+ * Step 2: Configure git hooks path.
+ *
+ * - Copies templates/ci-local/ → <project>/ci-local/ (no overwrite).
+ * - chmod 0755 on hook files.
+ * - Sets git config core.hooksPath to ci-local/hooks.
+ * - Skips entirely when CI_LOCAL_DIR template is missing.
+ * - Errors are swallowed and reported as status:"error" — never thrown.
+ *
+ * Extracted VERBATIM from src/commands/init.ts (PR 1 of 6).
+ */
+export declare const stepGitHooks: StepFn;
+//# sourceMappingURL=git.d.ts.map