javi-forge 0.1.0

package/modules/obsidian-brain/new-wave.sh

@@ -0,0 +1,182 @@
+#!/bin/bash
+# =============================================================================
+# NEW-WAVE: Crear oleada de tareas paralelas
+# =============================================================================
+# Uso:
+#   ./scripts/new-wave.sh "T-001 T-002 T-003"
+#   ./scripts/new-wave.sh --from-vibekanban
+#   ./scripts/new-wave.sh --list
+# =============================================================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+WAVES_FILE="$PROJECT_DIR/.project/Memory/WAVES.md"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+sed_inplace() {
+    if sed --version 2>/dev/null | grep -q GNU; then
+        sed -i "$@"
+    else
+        sed -i '' "$@"
+    fi
+}
+
+escape_sed() {
+    printf '%s\n' "$1" | sed 's/[&/\]/\\&/g'
+}
+
+# Asegurar que existe el archivo de oleadas
+if [[ ! -f "$WAVES_FILE" ]]; then
+    cat > "$WAVES_FILE" << 'EOF'
+# Oleadas de Trabajo
+
+> Registro de oleadas de tareas paralelas
+
+---
+
+## Oleada Actual
+
+**Numero:** 0
+**Estado:** Ninguna activa
+**Tareas:** -
+
+---
+
+## Historial
+
+| # | Tareas | Inicio | Fin | Estado |
+|---|--------|--------|-----|--------|
+EOF
+fi
+
+show_help() {
+    echo -e "${CYAN}NEW-WAVE: Gestion de oleadas de tareas paralelas${NC}"
+    echo ""
+    echo "Uso:"
+    echo "  ./scripts/new-wave.sh \"T-001 T-002 T-003\"   Crear oleada con tareas"
+    echo "  ./scripts/new-wave.sh --list                 Ver oleada actual"
+    echo "  ./scripts/new-wave.sh --complete             Marcar oleada como completada"
+    echo "  ./scripts/new-wave.sh --create-branches      Crear branches para tareas"
+    echo ""
+}
+
+list_wave() {
+    echo -e "${CYAN}=== Oleada Actual ===${NC}"
+    echo ""
+    grep -A 10 "## Oleada Actual" "$WAVES_FILE" | head -12
+}
+
+get_current_wave_number() {
+    grep "^\*\*Numero:\*\*" "$WAVES_FILE" | head -1 | grep -oE '[0-9]+' || echo "0"
+}
+
+create_wave() {
+    local tasks="$1"
+    local wave_num=$(($(get_current_wave_number) + 1))
+    local today=$(date +%Y-%m-%d)
+    local task_count=$(echo "$tasks" | wc -w)
+
+    local escaped_tasks
+    escaped_tasks=$(escape_sed "$tasks")
+
+    echo -e "${YELLOW}Creando Oleada $wave_num...${NC}"
+    echo -e "  Tareas: $tasks"
+    echo -e "  Total: $task_count tareas"
+
+    # Actualizar archivo de oleadas
+    sed_inplace "s/\*\*Numero:\*\* [0-9]*/\*\*Numero:\*\* $wave_num/" "$WAVES_FILE"
+    sed_inplace "s/\*\*Estado:\*\* .*/\*\*Estado:\*\* En progreso/" "$WAVES_FILE"
+    sed_inplace "s/\*\*Tareas:\*\* .*/\*\*Tareas:\*\* $escaped_tasks/" "$WAVES_FILE"
+
+    echo -e "${GREEN}Oleada $wave_num creada${NC}"
+    echo ""
+
+    # Preguntar si crear branches
+    read -p "Crear branches para cada tarea? (y/n) " -n 1 -r
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        create_branches "$tasks"
+    fi
+}
+
+create_branches() {
+    local tasks="$1"
+    local base_branch="develop"
+
+    echo -e "${YELLOW}Creando branches...${NC}"
+
+    # Asegurar que estamos en develop
+    git checkout "$base_branch" 2>/dev/null || git checkout -b "$base_branch"
+    git pull origin "$base_branch" 2>/dev/null || true
+
+    for task in $tasks; do
+        local branch_name="feature/$(echo "$task" | tr '[:upper:]' '[:lower:]')"
+        if git show-ref --verify --quiet "refs/heads/$branch_name"; then
+            echo -e "  ${YELLOW}Branch $branch_name ya existe${NC}"
+        else
+            git checkout -b "$branch_name" "$base_branch"
+            echo -e "  ${GREEN}Creado: $branch_name${NC}"
+        fi
+    done
+
+    # Volver a develop
+    git checkout "$base_branch"
+    echo -e "${GREEN}Branches creados${NC}"
+}
+
+complete_wave() {
+    local wave_num=$(get_current_wave_number)
+    local today=$(date +%Y-%m-%d)
+    local tasks=$(grep "^\*\*Tareas:\*\*" "$WAVES_FILE" | head -1 | sed 's/\*\*Tareas:\*\* //')
+
+    local escaped_tasks
+    escaped_tasks=$(escape_sed "$tasks")
+
+    echo -e "${YELLOW}Completando Oleada $wave_num...${NC}"
+
+    # Agregar al historial
+    sed_inplace "/^|---|/a | $wave_num | $escaped_tasks | - | $today | Completada |" "$WAVES_FILE"
+
+    # Resetear oleada actual
+    sed_inplace "s/\*\*Estado:\*\* .*/\*\*Estado:\*\* Ninguna activa/" "$WAVES_FILE"
+    sed_inplace "s/\*\*Tareas:\*\* .*/\*\*Tareas:\*\* -/" "$WAVES_FILE"
+
+    echo -e "${GREEN}Oleada $wave_num completada${NC}"
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+case "${1:-}" in
+    --help|-h)
+        show_help
+        ;;
+    --list|-l)
+        list_wave
+        ;;
+    --complete|-c)
+        complete_wave
+        ;;
+    --create-branches|-b)
+        tasks=$(grep "^\*\*Tareas:\*\*" "$WAVES_FILE" | head -1 | sed 's/\*\*Tareas:\*\* //')
+        if [[ "$tasks" != "-" && -n "$tasks" ]]; then
+            create_branches "$tasks"
+        else
+            echo -e "${RED}No hay tareas en la oleada actual${NC}"
+        fi
+        ;;
+    "")
+        show_help
+        ;;
+    *)
+        create_wave "$1"
+        ;;
+esac

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "javi-forge",
+  "version": "0.1.0",
+  "description": "Project scaffolding and AI-ready CI bootstrap",
+  "type": "module",
+  "bin": {
+    "javi-forge": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.tsx",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:mutation": "stryker run"
+  },
+  "author": "JNZader",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JNZader/javi-forge"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "fs-extra": "^11.3.4",
+    "glob": "^13.0.6",
+    "ink": "^6.8.0",
+    "ink-spinner": "^5.0.0",
+    "meow": "^14.1.0",
+    "react": "^19.2.4",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@stryker-mutator/core": "^9.6.0",
+    "@stryker-mutator/typescript-checker": "^9.6.0",
+    "@stryker-mutator/vitest-runner": "^9.6.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/glob": "^9.0.0",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^4.1.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}

package/schemas/agent.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Agent frontmatter",
+  "description": "Schema for AI agent frontmatter in project-starter-framework",
+  "type": "object",
+  "required": ["name", "description"],
+  "additionalProperties": true,
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Unique agent identifier in kebab-case",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "minLength": 2,
+      "maxLength": 60
+    },
+    "description": {
+      "type": "string",
+      "description": "What the agent does and when to use it",
+      "minLength": 10
+    },
+    "model": {
+      "type": "string",
+      "description": "Preferred model for this agent (optional)"
+    },
+    "tools": {
+      "description": "List of tools this agent uses",
+      "oneOf": [
+        { "type": "array", "items": { "type": "string" } },
+        { "type": "string" },
+        { "type": "null" }
+      ]
+    }
+  }
+}

package/schemas/ai-config.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "AI Config",
+  "description": "Schema for .ai-config/config.yaml",
+  "type": "object",
+  "properties": {
+    "targets": {
+      "type": "array",
+      "description": "Targets to sync when running sync-ai-config.sh without arguments",
+      "items": {
+        "type": "string",
+        "enum": ["claude", "opencode", "cursor", "aider", "gemini", "continue"]
+      },
+      "uniqueItems": true,
+      "minItems": 1
+    },
+    "sync": {
+      "type": "object",
+      "properties": {
+        "claude_mode": {
+          "type": "string",
+          "enum": ["overwrite", "merge"],
+          "default": "overwrite"
+        }
+      }
+    }
+  }
+}

package/schemas/skill.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "SKILL.md frontmatter",
+  "description": "Schema for AI skill frontmatter in project-starter-framework",
+  "type": "object",
+  "required": ["name", "description"],
+  "additionalProperties": true,
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Unique skill identifier in kebab-case",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "minLength": 2,
+      "maxLength": 60
+    },
+    "description": {
+      "type": "string",
+      "description": "Short description. Should include 'Trigger:' hint for auto-invoke.",
+      "minLength": 10
+    },
+    "metadata": {
+      "description": "Optional skill metadata",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "author": { "type": "string" },
+            "version": {
+              "type": "string",
+              "pattern": "^\\d+\\.\\d+(\\.\\d+)?$"
+            },
+            "tags": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "category": { "type": "string" }
+          }
+        },
+        { "type": "string" },
+        { "type": "null" }
+      ]
+    }
+  }
+}

package/src/commands/analyze.test.ts

@@ -0,0 +1,145 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import type { InitStep } from '../types/index.js'
+
+// ── Mock child_process ───────────────────────────────────────────────────────
+vi.mock('child_process', () => ({
+  execFile: vi.fn((_cmd: string, _args: string[], _opts: unknown, cb: unknown) => {
+    if (typeof cb === 'function') cb(null, { stdout: '', stderr: '' })
+    return undefined as any
+  }),
+}))
+
+import { execFile } from 'child_process'
+import { runAnalyze } from './analyze.js'
+
+const mockedExecFile = vi.mocked(execFile)
+
+beforeEach(() => {
+  vi.resetAllMocks()
+})
+
+function collectSteps(projectDir: string, dryRun: boolean): Promise<InitStep[]> {
+  const steps: InitStep[] = []
+  return runAnalyze(projectDir, dryRun, (step) => steps.push(step)).then(() => steps)
+}
+
+describe('runAnalyze', () => {
+  it('reports error when repoforge not found', async () => {
+    // which fails → repoforge not found
+    mockedExecFile.mockImplementation((_cmd: unknown, _args: unknown, _opts: unknown, cb: unknown) => {
+      const cmd = String(_cmd)
+      // The 'which' call is execFile('which', ['repoforge']) with 2 args (no opts)
+      // promisify(execFile) passes (cmd, args) → node adds callback
+      if (cmd === 'which') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(new Error('not found'))
+      }
+      return undefined as any
+    })
+
+    const steps = await collectSteps('/project', false)
+    const errorStep = steps.find(s => s.status === 'error')
+    expect(errorStep).toBeDefined()
+    expect(errorStep!.detail).toContain('repoforge not found')
+    expect(errorStep!.detail).toContain('pip install repoforge')
+  })
+
+  it('reports done when repoforge succeeds', async () => {
+    mockedExecFile.mockImplementation((_cmd: unknown, _args: unknown, _opts: unknown, cb: unknown) => {
+      const cmd = String(_cmd)
+      if (cmd === 'which') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: '/usr/bin/repoforge', stderr: '' })
+      } else if (cmd === 'repoforge') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: 'Analysis complete\nGenerated 5 skills', stderr: '' })
+      }
+      return undefined as any
+    })
+
+    const steps = await collectSteps('/project', false)
+    const doneStep = steps.find(s => s.id === 'analyze-repoforge' && s.status === 'done')
+    expect(doneStep).toBeDefined()
+    expect(doneStep!.detail).toContain('Generated 5 skills')
+  })
+
+  it('passes --dry-run when dryRun is true', async () => {
+    let capturedArgs: string[] = []
+    mockedExecFile.mockImplementation((_cmd: unknown, _args: unknown, _opts: unknown, cb: unknown) => {
+      const cmd = String(_cmd)
+      if (cmd === 'which') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: '/usr/bin/repoforge', stderr: '' })
+      } else if (cmd === 'repoforge') {
+        capturedArgs = (_args as string[]) ?? []
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: '', stderr: '' })
+      }
+      return undefined as any
+    })
+
+    await collectSteps('/project', true)
+    expect(capturedArgs).toContain('--dry-run')
+  })
+
+  it('reports error when repoforge execution fails', async () => {
+    mockedExecFile.mockImplementation((_cmd: unknown, _args: unknown, _opts: unknown, cb: unknown) => {
+      const cmd = String(_cmd)
+      if (cmd === 'which') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: '/usr/bin/repoforge', stderr: '' })
+      } else if (cmd === 'repoforge') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(new Error('Analysis crashed'))
+      }
+      return undefined as any
+    })
+
+    const steps = await collectSteps('/project', false)
+    const errorStep = steps.find(s => s.id === 'analyze-repoforge' && s.status === 'error')
+    expect(errorStep).toBeDefined()
+    expect(errorStep!.detail).toContain('Analysis crashed')
+  })
+
+  it('reports done with dry-run message when no stdout and dryRun', async () => {
+    mockedExecFile.mockImplementation((_cmd: unknown, _args: unknown, _opts: unknown, cb: unknown) => {
+      const cmd = String(_cmd)
+      if (cmd === 'which') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: '/usr/bin/repoforge', stderr: '' })
+      } else if (cmd === 'repoforge') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: '', stderr: '' })
+      }
+      return undefined as any
+    })
+
+    const steps = await collectSteps('/project', true)
+    const doneStep = steps.find(s => s.id === 'analyze-repoforge' && s.status === 'done')
+    expect(doneStep).toBeDefined()
+    expect(doneStep!.detail).toContain('dry-run')
+  })
+
+  it('reports warning when stderr has output', async () => {
+    mockedExecFile.mockImplementation((_cmd: unknown, _args: unknown, _opts: unknown, cb: unknown) => {
+      const cmd = String(_cmd)
+      if (cmd === 'which') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, { stdout: '/usr/bin/repoforge', stderr: '' })
+      } else if (cmd === 'repoforge') {
+        const callback = typeof _opts === 'function' ? _opts : cb
+        if (typeof callback === 'function') (callback as Function)(null, {
+          stdout: 'Analysis done',
+          stderr: 'Warning: deprecated API\nWarning: slow scan',
+        })
+      }
+      return undefined as any
+    })
+
+    const steps = await collectSteps('/project', false)
+    const warnStep = steps.find(s => s.id === 'analyze-warnings')
+    expect(warnStep).toBeDefined()
+    expect(warnStep!.status).toBe('skipped')
+    expect(warnStep!.detail).toContain('Warning: slow scan')
+  })
+})

package/src/commands/analyze.ts

@@ -0,0 +1,69 @@
+import { execFile } from 'child_process'
+import { promisify } from 'util'
+import type { InitStep } from '../types/index.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 })
+}
+
+/** Check if a binary is available in PATH */
+async function which(bin: string): Promise<boolean> {
+  try {
+    await execFileAsync('which', [bin])
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Run repoforge skills analysis on a project directory.
+ * This is a thin wrapper that delegates to the repoforge CLI.
+ */
+export async function runAnalyze(
+  projectDir: string,
+  dryRun: boolean,
+  onStep: StepCallback
+): Promise<void> {
+  const stepId = 'analyze-repoforge'
+  report(onStep, stepId, 'Run repoforge skills analysis', 'running')
+
+  try {
+    // Check if repoforge is installed
+    const hasRepoforge = await which('repoforge')
+
+    if (!hasRepoforge) {
+      report(onStep, stepId, 'Run repoforge skills analysis', 'error',
+        'repoforge not found. Install with: pip install repoforge')
+      return
+    }
+
+    const args = ['skills', '-w', projectDir]
+    if (dryRun) {
+      args.push('--dry-run')
+    }
+
+    const { stdout, stderr } = await execFileAsync('repoforge', args, {
+      cwd: projectDir,
+      timeout: 300_000, // 5 min — analysis can take a while on large repos
+    })
+
+    if (stdout) {
+      report(onStep, stepId, 'Run repoforge skills analysis', 'done', stdout.trim().split('\n').pop() ?? 'complete')
+    } else {
+      report(onStep, stepId, 'Run repoforge skills analysis', 'done', dryRun ? 'dry-run complete' : 'complete')
+    }
+
+    if (stderr) {
+      const warnId = 'analyze-warnings'
+      report(onStep, warnId, 'Analysis warnings', 'skipped', stderr.trim().split('\n').pop() ?? '')
+    }
+  } catch (e: unknown) {
+    const msg = e instanceof Error ? e.message : String(e)
+    report(onStep, stepId, 'Run repoforge skills analysis', 'error', msg)
+  }
+}