javi-forge 0.1.0

package/src/commands/init.ts

@@ -0,0 +1,285 @@
+import fs from 'fs-extra'
+import path from 'path'
+import { execFile } from 'child_process'
+import { promisify } from 'util'
+import type { InitOptions, InitStep, ForgeManifest } from '../types/index.js'
+import { backupIfExists, ensureDirExists } from '../lib/common.js'
+import { generateDependabotYml, generateCIWorkflow, getCIDestination } from '../lib/template.js'
+import {
+  FORGE_ROOT,
+  TEMPLATES_DIR,
+  MODULES_DIR,
+  CI_LOCAL_DIR,
+} from '../constants.js'
+
+const execFileAsync = promisify(execFile)
+
+type StepCallback = (step: InitStep) => void
+
+function report(onStep: StepCallback, id: string, label: string, status: InitStep['status'], detail?: string) {
+  onStep({ id, label, status, detail })
+}
+
+/**
+ * Main init orchestrator: bootstraps a project with CI, git hooks,
+ * memory module, AI config sync, SDD, and ghagga.
+ */
+export async function initProject(
+  options: InitOptions,
+  onStep: StepCallback
+): Promise<void> {
+  const { projectDir, projectName, stack, ciProvider, memory, aiSync, sdd, ghagga, dryRun } = options
+
+  // Ensure project directory exists before any steps
+  if (!dryRun && projectDir) {
+    await ensureDirExists(projectDir)
+  }
+
+  // ── Step 1: Initialize git ────────────────────────────────────────────────
+  const stepGit = 'git-init'
+  report(onStep, stepGit, 'Initialize git repository', 'running')
+  try {
+    const gitDir = path.join(projectDir, '.git')
+    if (!await fs.pathExists(gitDir)) {
+      if (!dryRun) {
+        await execFileAsync('git', ['init'], { cwd: projectDir })
+      }
+      report(onStep, stepGit, 'Initialize git repository', 'done', 'initialized')
+    } else {
+      report(onStep, stepGit, 'Initialize git repository', 'done', 'already exists')
+    }
+  } catch (e) {
+    report(onStep, stepGit, 'Initialize git repository', 'error', String(e))
+  }
+
+  // ── Step 2: Configure git hooks path ──────────────────────────────────────
+  const stepHooks = 'git-hooks'
+  report(onStep, stepHooks, 'Configure git hooks path', 'running')
+  try {
+    const ciLocalSrc = CI_LOCAL_DIR
+    const ciLocalDest = path.join(projectDir, 'ci-local')
+    if (await fs.pathExists(ciLocalSrc)) {
+      if (!dryRun) {
+        await fs.copy(ciLocalSrc, ciLocalDest, { overwrite: false, errorOnExist: false })
+        // Set core.hooksPath to ci-local/hooks
+        const hooksDir = path.join(ciLocalDest, 'hooks')
+        if (await fs.pathExists(hooksDir)) {
+          await execFileAsync('git', ['config', 'core.hooksPath', 'ci-local/hooks'], { cwd: projectDir })
+        }
+      }
+      report(onStep, stepHooks, 'Configure git hooks path', 'done', 'ci-local/hooks')
+    } else {
+      report(onStep, stepHooks, 'Configure git hooks path', 'skipped', 'no ci-local dir')
+    }
+  } catch (e) {
+    report(onStep, stepHooks, 'Configure git hooks path', 'error', String(e))
+  }
+
+  // ── Step 3: Copy CI template ──────────────────────────────────────────────
+  const stepCI = 'ci-template'
+  report(onStep, stepCI, `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, stepCI, `Copy ${ciProvider} CI workflow`, 'done', getCIDestination(ciProvider))
+    } else {
+      report(onStep, stepCI, `Copy ${ciProvider} CI workflow`, 'skipped', `no template for ${stack}`)
+    }
+  } catch (e) {
+    report(onStep, stepCI, `Copy ${ciProvider} CI workflow`, 'error', String(e))
+  }
+
+  // ── Step 4: Generate .gitignore ───────────────────────────────────────────
+  const stepGitignore = 'gitignore'
+  report(onStep, stepGitignore, 'Generate .gitignore', 'running')
+  try {
+    const templatePath = path.join(FORGE_ROOT, '.gitignore.template')
+    const dest = path.join(projectDir, '.gitignore')
+    if (await fs.pathExists(templatePath) && !await fs.pathExists(dest)) {
+      if (!dryRun) {
+        await fs.copy(templatePath, dest)
+      }
+      report(onStep, stepGitignore, 'Generate .gitignore', 'done', 'from template')
+    } else if (await fs.pathExists(dest)) {
+      report(onStep, stepGitignore, 'Generate .gitignore', 'done', 'already exists')
+    } else {
+      report(onStep, stepGitignore, 'Generate .gitignore', 'skipped', 'no template')
+    }
+  } catch (e) {
+    report(onStep, stepGitignore, 'Generate .gitignore', 'error', String(e))
+  }
+
+  // ── Step 5: Generate dependabot.yml ───────────────────────────────────────
+  const stepDeps = 'dependabot'
+  report(onStep, stepDeps, '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, stepDeps, 'Generate dependabot.yml', 'done')
+    } else {
+      report(onStep, stepDeps, 'Generate dependabot.yml', 'skipped', `not needed for ${ciProvider}`)
+    }
+  } catch (e) {
+    report(onStep, stepDeps, 'Generate dependabot.yml', 'error', String(e))
+  }
+
+  // ── Step 6: Install memory module ─────────────────────────────────────────
+  const stepMem = 'memory'
+  report(onStep, stepMem, `Install memory module: ${memory}`, 'running')
+  try {
+    if (memory !== 'none') {
+      const moduleSrc = path.join(MODULES_DIR, memory)
+      if (await fs.pathExists(moduleSrc)) {
+        if (!dryRun) {
+          // Copy module files to project
+          const moduleDest = path.join(projectDir, '.javi-forge', 'modules', memory)
+          await ensureDirExists(moduleDest)
+          await fs.copy(moduleSrc, moduleDest, { overwrite: false, errorOnExist: false })
+
+          // If engram, copy .mcp-config-snippet.json to project
+          if (memory === 'engram') {
+            const snippetSrc = path.join(moduleSrc, '.mcp-config-snippet.json')
+            if (await fs.pathExists(snippetSrc)) {
+              const snippetDest = path.join(projectDir, '.mcp-config-snippet.json')
+              await fs.copy(snippetSrc, snippetDest, { overwrite: false })
+            }
+          }
+        }
+        report(onStep, stepMem, `Install memory module: ${memory}`, 'done')
+      } else {
+        report(onStep, stepMem, `Install memory module: ${memory}`, 'error', 'module not found')
+      }
+    } else {
+      report(onStep, stepMem, `Install memory module: ${memory}`, 'skipped', 'none selected')
+    }
+  } catch (e) {
+    report(onStep, stepMem, `Install memory module: ${memory}`, 'error', String(e))
+  }
+
+  // ── Step 7: AI config sync (delegated to javi-ai) ──────────────────────────
+  const stepAI = 'ai-sync'
+  report(onStep, stepAI, 'Sync AI config via javi-ai', 'running')
+  try {
+    if (aiSync) {
+      if (!dryRun) {
+        try {
+          await execFileAsync('npx', ['javi-ai', 'sync', '--project-dir', projectDir, '--target', 'all'], {
+            cwd: projectDir,
+            timeout: 120_000,
+          })
+          report(onStep, stepAI, 'Sync AI config via javi-ai', 'done', 'javi-ai sync --target all')
+        } catch (syncErr: unknown) {
+          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, stepAI, '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, stepAI, 'Sync AI config via javi-ai', 'error', msg)
+          }
+        }
+      } else {
+        report(onStep, stepAI, 'Sync AI config via javi-ai', 'done', 'dry-run: would run javi-ai sync --target all')
+      }
+    } else {
+      report(onStep, stepAI, 'Sync AI config via javi-ai', 'skipped', 'not selected')
+    }
+  } catch (e) {
+    report(onStep, stepAI, 'Sync AI config via javi-ai', 'error', String(e))
+  }
+
+  // ── Step 8: SDD (Spec-Driven Development) ─────────────────────────────────
+  const stepSDD = 'sdd'
+  report(onStep, stepSDD, 'Set up SDD (openspec/)', 'running')
+  try {
+    if (sdd) {
+      if (!dryRun) {
+        const openspecDir = path.join(projectDir, 'openspec')
+        await ensureDirExists(openspecDir)
+        // Create a README if none exists
+        const readmePath = path.join(openspecDir, 'README.md')
+        if (!await fs.pathExists(readmePath)) {
+          await fs.writeFile(readmePath, `# openspec/\n\nSpec-Driven Development artifacts for ${projectName}.\n\nSee: /sdd:new <name> to start a new change.\n`, 'utf-8')
+        }
+      }
+      report(onStep, stepSDD, 'Set up SDD (openspec/)', 'done')
+    } else {
+      report(onStep, stepSDD, 'Set up SDD (openspec/)', 'skipped', 'not selected')
+    }
+  } catch (e) {
+    report(onStep, stepSDD, 'Set up SDD (openspec/)', 'error', String(e))
+  }
+
+  // ── Step 9: GHAGGA ────────────────────────────────────────────────────────
+  const stepGhagga = 'ghagga'
+  report(onStep, stepGhagga, '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 workflow to CI provider location
+          if (ciProvider === 'github') {
+            const workflowSrc = path.join(FORGE_ROOT, 'workflows', 'reusable-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, stepGhagga, 'Install GHAGGA review system', 'done')
+      } else {
+        report(onStep, stepGhagga, 'Install GHAGGA review system', 'error', 'module not found')
+      }
+    } else {
+      report(onStep, stepGhagga, 'Install GHAGGA review system', 'skipped', 'not selected')
+    }
+  } catch (e) {
+    report(onStep, stepGhagga, 'Install GHAGGA review system', 'error', String(e))
+  }
+
+  // ── Step 10: Write manifest ───────────────────────────────────────────────
+  const stepManifest = 'manifest'
+  report(onStep, stepManifest, 'Write forge manifest', 'running')
+  try {
+    if (!dryRun) {
+      const manifestDir = path.join(projectDir, '.javi-forge')
+      await ensureDirExists(manifestDir)
+      const manifest: ForgeManifest = {
+        version: '0.1.0',
+        projectName,
+        stack,
+        ciProvider,
+        memory,
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        modules: [
+          ...(memory !== 'none' ? [memory] : []),
+          ...(ghagga ? ['ghagga'] : []),
+          ...(sdd ? ['sdd'] : []),
+          ...(aiSync ? ['ai-config'] : []),
+        ],
+      }
+      await fs.writeJson(path.join(manifestDir, 'manifest.json'), manifest, { spaces: 2 })
+    }
+    report(onStep, stepManifest, 'Write forge manifest', 'done', '.javi-forge/manifest.json')
+  } catch (e) {
+    report(onStep, stepManifest, 'Write forge manifest', 'error', String(e))
+  }
+}

package/src/constants.ts

@@ -0,0 +1,69 @@
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+/** Root of the javi-forge package (one level up from dist/) */
+export const FORGE_ROOT = path.resolve(__dirname, '..')
+
+/** Templates directory */
+export const TEMPLATES_DIR = path.join(FORGE_ROOT, 'templates')
+
+/** Modules directory */
+export const MODULES_DIR = path.join(FORGE_ROOT, 'modules')
+
+/** Workflows directory */
+export const WORKFLOWS_DIR = path.join(FORGE_ROOT, 'workflows')
+
+/** AI config directory */
+export const AI_CONFIG_DIR = path.join(FORGE_ROOT, 'ai-config')
+
+/** Schemas directory */
+export const SCHEMAS_DIR = path.join(FORGE_ROOT, 'schemas')
+
+/** CI-local directory */
+export const CI_LOCAL_DIR = path.join(FORGE_ROOT, 'ci-local')
+
+/** Dependabot fragment directory */
+export const DEPENDABOT_FRAGMENTS_DIR = path.join(TEMPLATES_DIR, 'common', 'dependabot')
+
+/** Stack-to-dependabot fragment mapping */
+export const STACK_DEPENDABOT_MAP: Record<string, string[]> = {
+  'node':        ['npm'],
+  'python':      ['pip'],
+  'go':          ['gomod'],
+  'rust':        ['cargo'],
+  'java-gradle': ['gradle'],
+  'java-maven':  ['maven'],
+  'elixir':      [],
+}
+
+/** Stack-to-CI template filename mapping */
+export const STACK_CI_MAP: Record<string, Record<string, string>> = {
+  github: {
+    'node':        'ci-node.yml',
+    'python':      'ci-python.yml',
+    'go':          'ci-go.yml',
+    'rust':        'ci-rust.yml',
+    'java-gradle': 'ci-java.yml',
+    'java-maven':  'ci-java.yml',
+  },
+  gitlab: {
+    'node':        'gitlab-ci-node.yml',
+    'python':      'gitlab-ci-python.yml',
+    'go':          'gitlab-ci-go.yml',
+    'rust':        'gitlab-ci-rust.yml',
+    'java-gradle': 'gitlab-ci-java.yml',
+    'java-maven':  'gitlab-ci-java.yml',
+  },
+  woodpecker: {
+    'node':        'woodpecker-node.yml',
+    'python':      'woodpecker-python.yml',
+    'go':          'woodpecker-go.yml',
+    'rust':        'woodpecker-rust.yml',
+    'java-gradle': 'woodpecker-java.yml',
+    'java-maven':  'woodpecker-java.yml',
+  },
+}
+
+