javi-forge 0.1.0

package/src/ui/MemorySelector.tsx

@@ -0,0 +1,73 @@
+import React, { useState, useEffect } from 'react'
+import { Box, Text, useInput } from 'ink'
+import type { MemoryOption } from '../types/index.js'
+import { theme } from './theme.js'
+import { useCIMode } from './CIContext.js'
+
+const MEMORY_OPTIONS: { id: MemoryOption; label: string; description: string }[] = [
+  { id: 'engram',         label: 'Engram',         description: 'SQLite-backed persistent memory with MCP' },
+  { id: 'obsidian-brain', label: 'Obsidian Brain',  description: 'Obsidian vault with Kanban + Dataview' },
+  { id: 'memory-simple',  label: 'Simple Memory',   description: 'File-based .project/ memory' },
+  { id: 'none',           label: 'None',             description: 'Skip memory module' },
+]
+
+interface Props {
+  onConfirm: (memory: MemoryOption) => void
+}
+
+export default function MemorySelector({ onConfirm }: Props) {
+  const isCI = useCIMode()
+  const [cursor, setCursor] = useState(0)
+
+  // Auto-confirm in CI mode
+  useEffect(() => {
+    if (isCI) {
+      onConfirm(MEMORY_OPTIONS[cursor].id)
+    }
+  }, [isCI]) // eslint-disable-line react-hooks/exhaustive-deps
+
+  useInput((_, key) => {
+    if (key.upArrow)   setCursor(c => Math.max(0, c - 1))
+    if (key.downArrow) setCursor(c => Math.min(MEMORY_OPTIONS.length - 1, c + 1))
+    if (key.return) {
+      onConfirm(MEMORY_OPTIONS[cursor].id)
+    }
+  }, { isActive: !isCI })
+
+  return (
+    <Box flexDirection="column">
+      <Text bold>Select memory module:</Text>
+
+      <Box
+        marginTop={1}
+        flexDirection="column"
+        borderStyle="single"
+        borderLeft
+        borderRight={false}
+        borderTop={false}
+        borderBottom={false}
+        borderColor={theme.muted}
+        paddingLeft={1}
+      >
+        {MEMORY_OPTIONS.map((m, i) => (
+          <Box key={m.id}>
+            <Text color={i === cursor ? theme.primary : 'white'}>
+              {i === cursor ? '\u25b6 ' : '  '}
+              {i === cursor ? '\u25c9' : '\u25cb'} {m.label}
+            </Text>
+            <Text color={theme.muted} dimColor>  {m.description}</Text>
+          </Box>
+        ))}
+      </Box>
+
+      <Box marginTop={1} gap={2}>
+        <Text color={theme.primary}>
+          {MEMORY_OPTIONS[cursor].label}
+        </Text>
+        <Text color={theme.muted} dimColor>
+          {'\u2191\u2193'} navigate  Enter confirm
+        </Text>
+      </Box>
+    </Box>
+  )
+}

package/src/ui/NameInput.tsx

@@ -0,0 +1,82 @@
+import React, { useState, useEffect } from 'react'
+import { Box, Text, useInput } from 'ink'
+import path from 'path'
+import { theme } from './theme.js'
+import { useCIMode } from './CIContext.js'
+
+interface Props {
+  defaultName: string
+  onConfirm: (name: string, dir: string) => void
+}
+
+const VALID_NAME = /^[a-z0-9][a-z0-9._-]*$/
+
+function validateName(name: string): string | null {
+  if (name.length === 0)           return 'Name cannot be empty'
+  if (name !== name.toLowerCase()) return 'Use lowercase only'
+  if (name.includes(' '))          return 'No spaces allowed (use - or _)'
+  if (!VALID_NAME.test(name))      return 'Use lowercase letters, numbers, hyphens, dots'
+  if (name.length > 60)            return 'Name too long (max 60 chars)'
+  return null
+}
+
+export default function NameInput({ defaultName, onConfirm }: Props) {
+  const isCI = useCIMode()
+  const [value, setValue] = useState(defaultName)
+  const trimmed = value.trim()
+  const error = validateName(trimmed)
+  const isValid = error === null && trimmed.length > 0
+  const targetDir = path.resolve(process.cwd(), trimmed || '.')
+
+  // Auto-confirm in CI mode
+  useEffect(() => {
+    if (isCI && isValid) {
+      onConfirm(trimmed, targetDir)
+    }
+  }, [isCI]) // eslint-disable-line react-hooks/exhaustive-deps
+
+  useInput((input, key) => {
+    if (key.return && isValid) {
+      onConfirm(trimmed, targetDir)
+    } else if (key.backspace || key.delete) {
+      setValue(v => v.slice(0, -1))
+    } else if (input && !key.ctrl && !key.meta) {
+      setValue(v => v + input)
+    }
+  }, { isActive: !isCI })
+
+  return (
+    <Box flexDirection="column">
+      <Text bold>Project name:</Text>
+      <Box marginTop={1}>
+        <Text color={isValid ? theme.primary : theme.error}>{'\u25b6'} </Text>
+        <Text>{value}</Text>
+        <Text color={theme.muted}>{'\u2588'}</Text>
+      </Box>
+
+      {/* Validation feedback */}
+      {trimmed.length > 0 && error && (
+        <Box marginTop={1}>
+          <Text color={theme.error}>  {'\u2717'} {error}</Text>
+        </Box>
+      )}
+      {isValid && (
+        <Box marginTop={1}>
+          <Text color={theme.success}>  {'\u2713'} Valid name</Text>
+        </Box>
+      )}
+
+      {/* Target directory */}
+      <Box marginTop={1}>
+        <Text color={theme.muted}>  Will create: </Text>
+        <Text color={isValid ? theme.primary : theme.muted} dimColor={!isValid}>
+          {targetDir}
+        </Text>
+      </Box>
+
+      <Box marginTop={1}>
+        <Text color={theme.muted} dimColor>Enter to confirm</Text>
+      </Box>
+    </Box>
+  )
+}

package/src/ui/OptionSelector.tsx

@@ -0,0 +1,100 @@
+import React, { useState, useEffect } from 'react'
+import { Box, Text, useInput } from 'ink'
+import { theme } from './theme.js'
+import { useCIMode } from './CIContext.js'
+
+interface OptionItem {
+  id: string
+  label: string
+  description: string
+  default: boolean
+}
+
+const OPTIONS: OptionItem[] = [
+  { id: 'aiSync', label: 'AI Config Sync',  description: 'Copy agents, skills, and configs to .ai-config/', default: true },
+  { id: 'sdd',    label: 'SDD (openspec/)', description: 'Spec-Driven Development workflow',               default: true },
+  { id: 'ghagga', label: 'GHAGGA Review',   description: 'Multi-agent AI code review system',              default: false },
+]
+
+interface Props {
+  onConfirm: (selected: { aiSync: boolean; sdd: boolean; ghagga: boolean }) => void
+  presetGhagga?: boolean
+}
+
+export default function OptionSelector({ onConfirm, presetGhagga = false }: Props) {
+  const isCI = useCIMode()
+  const [cursor, setCursor] = useState(0)
+  const [selected, setSelected] = useState<Set<string>>(() => {
+    const defaults = new Set(OPTIONS.filter(o => o.default).map(o => o.id))
+    if (presetGhagga) defaults.add('ghagga')
+    return defaults
+  })
+
+  // Auto-confirm in CI mode with defaults
+  useEffect(() => {
+    if (isCI) {
+      onConfirm({
+        aiSync: selected.has('aiSync'),
+        sdd:    selected.has('sdd'),
+        ghagga: selected.has('ghagga'),
+      })
+    }
+  }, [isCI]) // eslint-disable-line react-hooks/exhaustive-deps
+
+  useInput((input, key) => {
+    if (key.upArrow)   setCursor(c => Math.max(0, c - 1))
+    if (key.downArrow) setCursor(c => Math.min(OPTIONS.length - 1, c + 1))
+    if (input === ' ') {
+      const opt = OPTIONS[cursor].id
+      setSelected(prev => {
+        const next = new Set(prev)
+        next.has(opt) ? next.delete(opt) : next.add(opt)
+        return next
+      })
+    }
+    if (key.return) {
+      onConfirm({
+        aiSync: selected.has('aiSync'),
+        sdd:    selected.has('sdd'),
+        ghagga: selected.has('ghagga'),
+      })
+    }
+  }, { isActive: !isCI })
+
+  return (
+    <Box flexDirection="column">
+      <Text bold>Select additional options:</Text>
+
+      <Box
+        marginTop={1}
+        flexDirection="column"
+        borderStyle="single"
+        borderLeft
+        borderRight={false}
+        borderTop={false}
+        borderBottom={false}
+        borderColor={theme.muted}
+        paddingLeft={1}
+      >
+        {OPTIONS.map((opt, i) => (
+          <Box key={opt.id}>
+            <Text color={i === cursor ? theme.primary : 'white'}>
+              {i === cursor ? '\u25b6 ' : '  '}
+              {selected.has(opt.id) ? '\u25c9' : '\u25cb'} {opt.label}
+            </Text>
+            <Text color={theme.muted} dimColor>  {opt.description}</Text>
+          </Box>
+        ))}
+      </Box>
+
+      <Box marginTop={1} gap={2}>
+        <Text color={selected.size > 0 ? theme.accent : theme.muted}>
+          {selected.size} selected
+        </Text>
+        <Text color={theme.muted} dimColor>
+          {'\u2191\u2193'} navigate  Space toggle  Enter confirm
+        </Text>
+      </Box>
+    </Box>
+  )
+}

package/src/ui/Progress.tsx

@@ -0,0 +1,88 @@
+import React, { useEffect, useRef } from 'react'
+import { Box, Text } from 'ink'
+import Spinner from 'ink-spinner'
+import type { InitStep } from '../types/index.js'
+import { theme } from './theme.js'
+
+interface Props {
+  steps: InitStep[]
+  projectName?: string
+  contextLine?: string
+  onDone?: () => void
+}
+
+const STATUS_ICON: Record<string, string> = {
+  pending: '\u25cb',
+  done:    '\u2713',
+  error:   '\u2717',
+  skipped: '\u2013',
+}
+
+const STATUS_COLOR: Record<string, string> = {
+  pending: theme.muted,
+  running: theme.warning,
+  done:    theme.success,
+  error:   theme.error,
+  skipped: theme.muted,
+}
+
+export default function Progress({ steps, projectName, contextLine, onDone }: Props) {
+  const doneRef = useRef(false)
+
+  const total     = steps.length
+  const completed = steps.filter(s => s.status === 'done' || s.status === 'skipped').length
+  const hasError  = steps.some(s => s.status === 'error')
+  const allFinished = total > 0 && steps.every(
+    s => s.status === 'done' || s.status === 'error' || s.status === 'skipped'
+  )
+
+  useEffect(() => {
+    if (allFinished && !hasError && !doneRef.current && onDone) {
+      doneRef.current = true
+      const t = setTimeout(onDone, 600)
+      return () => clearTimeout(t)
+    }
+    return undefined
+  }, [allFinished, hasError, onDone])
+
+  return (
+    <Box flexDirection="column">
+      {/* Context header */}
+      <Box marginBottom={1} flexDirection="column">
+        {contextLine && (
+          <Text color={theme.muted}>
+            {'Initializing: '}
+            <Text color={theme.primary}>{contextLine}</Text>
+          </Text>
+        )}
+        {total > 0 && (
+          <Text color={theme.muted}>
+            {'Progress: '}
+            <Text color={completed === total ? theme.success : theme.warning}>
+              {completed}/{total} steps
+            </Text>
+          </Text>
+        )}
+      </Box>
+
+      <Box flexDirection="column">
+        {steps.map(step => (
+          <Box key={step.id} marginLeft={2}>
+            {step.status === 'running' ? (
+              <Text color={theme.warning}>
+                <Spinner type="dots" />
+                {' '}{step.label}
+                {step.detail ? <Text color={theme.muted} dimColor>  {step.detail}</Text> : null}
+              </Text>
+            ) : (
+              <Text color={STATUS_COLOR[step.status] as any}>
+                {STATUS_ICON[step.status]} {step.label}
+                {step.detail ? <Text color={theme.muted} dimColor>  {step.detail}</Text> : null}
+              </Text>
+            )}
+          </Box>
+        ))}
+      </Box>
+    </Box>
+  )
+}

package/src/ui/StackSelector.tsx

@@ -0,0 +1,101 @@
+import React, { useState, useEffect, useRef } from 'react'
+import { Box, Text, useInput } from 'ink'
+import { detectStack, STACK_LABELS } from '../lib/common.js'
+import type { Stack } from '../types/index.js'
+import { theme } from './theme.js'
+import { useCIMode } from './CIContext.js'
+
+const ALL_STACKS: Stack[] = ['node', 'python', 'go', 'rust', 'java-gradle', 'java-maven', 'elixir']
+
+interface Props {
+  projectDir: string
+  onConfirm: (stack: Stack) => void
+}
+
+export default function StackSelector({ projectDir, onConfirm }: Props) {
+  const isCI = useCIMode()
+  const autoConfirmed = useRef(false)
+  const [cursor, setCursor] = useState(0)
+  const [detectedStack, setDetectedStack] = useState<Stack | null>(null)
+  const [detecting, setDetecting] = useState(true)
+
+  useEffect(() => {
+    detectStack(projectDir).then(result => {
+      if (result) {
+        setDetectedStack(result.stackType)
+        const idx = ALL_STACKS.indexOf(result.stackType)
+        if (idx >= 0) setCursor(idx)
+      }
+      setDetecting(false)
+    })
+  }, [projectDir])
+
+  // Auto-confirm in CI mode once detection is done
+  useEffect(() => {
+    if (isCI && !detecting && !autoConfirmed.current) {
+      autoConfirmed.current = true
+      onConfirm(ALL_STACKS[cursor])
+    }
+  }, [isCI, detecting]) // eslint-disable-line react-hooks/exhaustive-deps
+
+  useInput((input, key) => {
+    if (detecting) return
+    if (key.upArrow)   setCursor(c => Math.max(0, c - 1))
+    if (key.downArrow) setCursor(c => Math.min(ALL_STACKS.length - 1, c + 1))
+    if (key.return) {
+      onConfirm(ALL_STACKS[cursor])
+    }
+  }, { isActive: !isCI })
+
+  if (detecting) {
+    return (
+      <Box>
+        <Text color={theme.muted}>Detecting project stack...</Text>
+      </Box>
+    )
+  }
+
+  return (
+    <Box flexDirection="column">
+      <Text bold>Select project stack:</Text>
+      {detectedStack && (
+        <Text color={theme.success}>
+          {'  '}Auto-detected: {STACK_LABELS[detectedStack]}
+        </Text>
+      )}
+
+      <Box
+        marginTop={1}
+        flexDirection="column"
+        borderStyle="single"
+        borderLeft
+        borderRight={false}
+        borderTop={false}
+        borderBottom={false}
+        borderColor={theme.muted}
+        paddingLeft={1}
+      >
+        {ALL_STACKS.map((stack, i) => (
+          <Box key={stack}>
+            <Text color={i === cursor ? theme.primary : 'white'}>
+              {i === cursor ? '\u25b6 ' : '  '}
+              {stack === detectedStack ? '\u25c9' : '\u25cb'} {STACK_LABELS[stack]}
+              {stack === detectedStack && (
+                <Text color={theme.success} dimColor>  (detected)</Text>
+              )}
+            </Text>
+          </Box>
+        ))}
+      </Box>
+
+      <Box marginTop={1} gap={2}>
+        <Text color={theme.primary}>
+          {STACK_LABELS[ALL_STACKS[cursor]]}
+        </Text>
+        <Text color={theme.muted} dimColor>
+          {'\u2191\u2193'} navigate  Enter confirm
+        </Text>
+      </Box>
+    </Box>
+  )
+}

package/src/ui/Summary.tsx

@@ -0,0 +1,134 @@
+import React, { useEffect } from 'react'
+import { Box, Text, useApp, useInput } from 'ink'
+import type { InitStep } from '../types/index.js'
+import { theme } from './theme.js'
+import { useCIMode } from './CIContext.js'
+
+interface Props {
+  steps: InitStep[]
+  dryRun: boolean
+  projectName: string
+  stack?: string
+  elapsedMs?: number
+}
+
+/** Map stack to the install command hint */
+function getInstallHint(stack?: string): string | null {
+  switch (stack) {
+    case 'node':        return 'pnpm install'
+    case 'python':      return 'pip install -r requirements.txt'
+    case 'go':          return 'go mod tidy'
+    case 'rust':        return 'cargo build'
+    case 'java-gradle': return './gradlew build'
+    case 'java-maven':  return 'mvn install'
+    case 'elixir':      return 'mix deps.get'
+    default:            return null
+  }
+}
+
+export default function Summary({ steps, dryRun, projectName, stack, elapsedMs }: Props) {
+  const { exit } = useApp()
+  const isCI = useCIMode()
+
+  const done    = steps.filter(s => s.status === 'done').length
+  const skipped = steps.filter(s => s.status === 'skipped').length
+  const errors  = steps.filter(s => s.status === 'error')
+  const elapsed = elapsedMs != null
+    ? `${(elapsedMs / 1000).toFixed(1)}s`
+    : null
+
+  // Auto-exit in CI mode
+  useEffect(() => {
+    if (isCI) {
+      const t = setTimeout(() => exit(), 100)
+      return () => clearTimeout(t)
+    }
+    return undefined
+  }, [isCI, exit])
+
+  useInput((_, key) => {
+    if (key.return || key.escape) exit()
+  }, { isActive: !isCI })
+
+  const installHint = getInstallHint(stack)
+
+  return (
+    <Box flexDirection="column">
+      {/* Title */}
+      <Text bold color={errors.length > 0 ? theme.warning : theme.success}>
+        {dryRun ? '\u25cb Dry run complete' : '\u2713 Project scaffolded'}
+        {elapsed && <Text color={theme.muted}>  Completed in {elapsed}</Text>}
+      </Text>
+
+      {/* Project info */}
+      <Box marginTop={1}>
+        <Text color={theme.muted}>  Project: </Text>
+        <Text color={theme.primary} bold>{projectName}</Text>
+        {stack && <Text color={theme.muted}>  ({stack})</Text>}
+      </Box>
+
+      {/* Dry run note */}
+      {dryRun && (
+        <Box marginTop={1}>
+          <Text color={theme.warning} bold>  No changes were made (dry run)</Text>
+        </Box>
+      )}
+
+      {/* Step details */}
+      <Box marginTop={1} flexDirection="column">
+        {steps.map(step => (
+          <Box key={step.id} marginLeft={2}>
+            {step.status === 'done' ? (
+              <Text color={theme.success}>
+                {'\u2713'} {step.label}
+                {step.detail ? <Text color={theme.muted} dimColor>  {step.detail}</Text> : null}
+              </Text>
+            ) : step.status === 'skipped' ? (
+              <Text color={theme.muted}>
+                {'\u2013'} {step.label}
+                {step.detail ? <Text dimColor>  {step.detail}</Text> : null}
+              </Text>
+            ) : step.status === 'error' ? (
+              <Text color={theme.error}>
+                {'\u2717'} {step.label}
+                {step.detail ? <Text color={theme.muted} dimColor>  {step.detail}</Text> : null}
+              </Text>
+            ) : null}
+          </Box>
+        ))}
+      </Box>
+
+      {/* Totals */}
+      <Box marginTop={1} flexDirection="column">
+        <Text color={theme.success}>  {'\u2713'} {done} steps completed</Text>
+        {skipped > 0 && (
+          <Text color={theme.muted}>  {'\u2013'} {skipped} steps skipped</Text>
+        )}
+        {errors.length > 0 && (
+          <Box flexDirection="column">
+            <Text color={theme.error}>  {'\u2717'} {errors.length} errors:</Text>
+            {errors.map(e => (
+              <Text key={`err-${e.id}`} color={theme.error}>    {'\u2022'} {e.label}: {e.detail}</Text>
+            ))}
+          </Box>
+        )}
+      </Box>
+
+      {/* Next steps */}
+      {!dryRun && errors.length === 0 && (
+        <Box marginTop={1} flexDirection="column">
+          <Text color={theme.muted} bold>  Next steps:</Text>
+          <Text color={theme.primary}>    cd {projectName}</Text>
+          {installHint && <Text color={theme.primary}>    {installHint}</Text>}
+          <Text color={theme.primary}>    npx javi-ai sync</Text>
+          <Text color={theme.primary}>    javi-forge doctor</Text>
+        </Box>
+      )}
+
+      {/* Exit hint */}
+      <Box marginTop={1}>
+        <Text color={theme.muted} dimColor>Press Enter to exit</Text>
+      </Box>
+    </Box>
+  )
+}

package/src/ui/Welcome.tsx

@@ -0,0 +1,54 @@
+import React, { useEffect } from 'react'
+import { Box, Text } from 'ink'
+import Spinner from 'ink-spinner'
+import Header from './Header.js'
+import { theme } from './theme.js'
+import { useCIMode } from './CIContext.js'
+
+interface Props {
+  onDone: () => void
+}
+
+export default function Welcome({ onDone }: Props) {
+  const isCI = useCIMode()
+
+  useEffect(() => {
+    // Skip welcome delay in CI mode
+    const timer = setTimeout(onDone, isCI ? 0 : 1500)
+    return () => clearTimeout(timer)
+  }, [onDone, isCI])
+
+  return (
+    <Box flexDirection="column" padding={1}>
+      <Header />
+
+      <Box flexDirection="column" marginTop={1} marginLeft={2}>
+        <Text>Bootstrap AI-ready projects with:</Text>
+        <Box marginTop={1} flexDirection="column">
+          <Text>
+            <Text color={theme.primary}>{'\u25c6'} Templates  </Text>
+            <Text color={theme.muted}> Go, Java, Node, Python, Rust CI</Text>
+          </Text>
+          <Text>
+            <Text color={theme.success}>{'\u25c6'} Memory     </Text>
+            <Text color={theme.muted}> Engram, Obsidian Brain</Text>
+          </Text>
+          <Text>
+            <Text color={theme.accent}>{'\u25c6'} SDD        </Text>
+            <Text color={theme.muted}> Spec-Driven Development</Text>
+          </Text>
+          <Text>
+            <Text color={theme.warning}>{'\u25c6'} Review     </Text>
+            <Text color={theme.muted}> GHAGGA code review</Text>
+          </Text>
+        </Box>
+        <Box marginTop={1}>
+          <Text color={theme.muted}>
+            <Spinner type="dots" />
+            {' '}Detecting your environment...
+          </Text>
+        </Box>
+      </Box>
+    </Box>
+  )
+}

package/src/ui/theme.ts

@@ -0,0 +1,10 @@
+export const theme = {
+  primary:  '#f97316',  // orange
+  success:  'green',
+  warning:  'yellow',
+  error:    'red',
+  muted:    'gray',
+  accent:   'magenta',
+} as const
+
+export type ThemeColor = typeof theme[keyof typeof theme]

package/stryker.config.json

@@ -0,0 +1,19 @@
+{
+  "testRunner": "vitest",
+  "mutate": [
+    "src/lib/frontmatter.ts",
+    "src/lib/common.ts",
+    "src/lib/template.ts",
+    "src/commands/init.ts",
+    "src/commands/doctor.ts",
+    "src/commands/analyze.ts",
+    "src/constants.ts"
+  ],
+  "plugins": [
+    "@stryker-mutator/vitest-runner",
+    "@stryker-mutator/typescript-checker"
+  ],
+  "checkers": ["typescript"],
+  "tsconfigFile": "tsconfig.json",
+  "thresholds": { "high": 80, "low": 60, "break": 50 }
+}

package/tasks/_TEMPLATE/files-edited.md

@@ -0,0 +1,3 @@
+## Files Changed
+
+_Auto-populated_

package/tasks/_TEMPLATE/plan.md

@@ -0,0 +1,3 @@
+## Plan
+
+_Add steps here_

package/tasks/_TEMPLATE/research.md

@@ -0,0 +1,3 @@
+## Research
+
+_Add findings here_

package/tasks/_TEMPLATE/verification.md

@@ -0,0 +1,5 @@
+## Verification Checklist
+
+- [ ] Tests pass
+- [ ] No regressions
+- [ ] Docs updated