javi-forge 1.3.0 → 1.4.0

package/package.json

@@ -1,11 +1,34 @@
 {
   "name": "javi-forge",
-  "version": "1.3.0",
+  "version": "1.4.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"
+  },
+  "files": [
+    "dist/",
+    "ci-local/",
+    "modules/",
+    "templates/",
+    "workflows/",
+    "lib/",
+    "!dist/**/*.test.*",
+    "!dist/**/__snapshots__",
+    "package.json",
+    "README.md",
+    ".gitignore.template"
+  ],
   "author": "JNZader",
   "license": "MIT",
   "repository": {
@@ -45,15 +68,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
-  },
-  "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"
   }
-}
+}

package/templates/github/ci-go.yml

@@ -34,7 +34,7 @@ concurrency:
 
 jobs:
   build:
-    uses: JNZader/project-starter-framework/.github/workflows/reusable-build-go.yml@main
+    uses: JNZader/javi-forge/.github/workflows/reusable-build-go.yml@main
     with:
       go-version: '1.23'  # Change to: 1.22, 1.23
       run-lint: true

package/templates/github/ci-java.yml

@@ -3,7 +3,7 @@
 # ===========================================
 # Copy to: .github/workflows/ci.yml
 #
-# This uses reusable workflows from project-starter-framework.
+# This uses reusable workflows from javi-forge.
 # Runs on pushes to main, PRs, and manual triggers.
 # ===========================================
 
@@ -37,7 +37,7 @@ concurrency:
 
 jobs:
   build:
-    uses: JNZader/project-starter-framework/.github/workflows/reusable-build-java.yml@main
+    uses: JNZader/javi-forge/.github/workflows/reusable-build-java.yml@main
     with:
       java-version: '21'  # Change to your version: 17, 21, 25
       run-spotless: true

package/templates/github/ci-node.yml

@@ -34,7 +34,7 @@ concurrency:
 
 jobs:
   build:
-    uses: JNZader/project-starter-framework/.github/workflows/reusable-build-node.yml@main
+    uses: JNZader/javi-forge/.github/workflows/reusable-build-node.yml@main
     with:
       node-version: '20'  # Change to: 18, 20, 22
       package-manager: 'npm'  # Change to: npm, yarn, pnpm

package/templates/github/ci-python.yml

@@ -34,7 +34,7 @@ concurrency:
 
 jobs:
   build:
-    uses: JNZader/project-starter-framework/.github/workflows/reusable-build-python.yml@main
+    uses: JNZader/javi-forge/.github/workflows/reusable-build-python.yml@main
     with:
       python-version: '3.12'  # Change to: 3.10, 3.11, 3.12
       package-manager: 'pip'  # Change to: pip, poetry, uv

package/templates/github/ci-rust.yml

@@ -34,7 +34,7 @@ concurrency:
 
 jobs:
   build:
-    uses: JNZader/project-starter-framework/.github/workflows/reusable-build-rust.yml@main
+    uses: JNZader/javi-forge/.github/workflows/reusable-build-rust.yml@main
     with:
       toolchain: 'stable'  # Change to: stable, beta, nightly
       run-clippy: true

package/templates/github/ghagga-review.yml

@@ -0,0 +1,28 @@
+# ===========================================
+# GHAGGA AI Code Review
+# ===========================================
+# Triggers AI code review on pull requests.
+# Requires: GHAGGA GitHub Action (JNZader/ghagga@v1)
+#
+# Modes: simple (default), workflow, consensus
+# ===========================================
+
+name: Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  pull-requests: write
+  contents: read
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: JNZader/ghagga@v1
+        with:
+          mode: simple
+          provider: github

package/workflows/reusable-build-go.yml

@@ -6,7 +6,7 @@
 # Usage:
 #   jobs:
 #     build:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-go.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-build-go.yml@main
 #       with:
 #         go-version: '1.23'
 # ===========================================

package/workflows/reusable-build-java.yml

@@ -6,7 +6,7 @@
 # Usage in your project:
 #   jobs:
 #     build:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-java.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-build-java.yml@main
 #       with:
 #         java-version: '21'
 # ===========================================

package/workflows/reusable-build-node.yml

@@ -6,7 +6,7 @@
 # Usage:
 #   jobs:
 #     build:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-node.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-build-node.yml@main
 #       with:
 #         node-version: '20'
 # ===========================================

package/workflows/reusable-build-python.yml

@@ -6,7 +6,7 @@
 # Usage:
 #   jobs:
 #     build:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-python.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-build-python.yml@main
 #       with:
 #         python-version: '3.12'
 # ===========================================

package/workflows/reusable-build-rust.yml

@@ -6,7 +6,7 @@
 # Usage:
 #   jobs:
 #     build:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-rust.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-build-rust.yml@main
 # ===========================================
 
 name: Rust Build (Reusable)

package/workflows/reusable-docker.yml

@@ -6,7 +6,7 @@
 # Usage:
 #   jobs:
 #     docker:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-docker.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-docker.yml@main
 #       with:
 #         dockerfile: './Dockerfile'
 # ===========================================

package/workflows/reusable-ghagga-review.yml

@@ -6,7 +6,7 @@
 # Usage:
 #   jobs:
 #     review:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-ghagga-review.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-ghagga-review.yml@main
 #       with:
 #         ghagga-url: ${{ vars.GHAGGA_URL }}
 #       secrets:

package/workflows/reusable-release.yml

@@ -6,7 +6,7 @@
 # Usage:
 #   jobs:
 #     release:
-#       uses: JNZader/project-starter-framework/.github/workflows/reusable-release.yml@main
+#       uses: JNZader/javi-forge/.github/workflows/reusable-release.yml@main
 #       secrets:
 #         token: ${{ secrets.GITHUB_TOKEN }}
 # ===========================================

package/.releaserc

@@ -1,45 +0,0 @@
-{
-  "branches": ["main"],
-  "tagFormat": "v${version}",
-  "plugins": [
-    ["@semantic-release/commit-analyzer", {
-      "preset": "conventionalcommits",
-      "releaseRules": [
-        {"type": "feat", "release": "minor"},
-        {"type": "fix", "release": "patch"},
-        {"type": "perf", "release": "patch"},
-        {"type": "refactor", "release": "patch"},
-        {"type": "docs", "release": false},
-        {"type": "style", "release": false},
-        {"type": "chore", "release": false},
-        {"type": "test", "release": false},
-        {"breaking": true, "release": "major"}
-      ]
-    }],
-    ["@semantic-release/release-notes-generator", {
-      "preset": "conventionalcommits",
-      "presetConfig": {
-        "types": [
-          {"type": "feat", "section": "Features"},
-          {"type": "fix", "section": "Bug Fixes"},
-          {"type": "perf", "section": "Performance"},
-          {"type": "refactor", "section": "Refactoring"},
-          {"type": "docs", "section": "Documentation", "hidden": true},
-          {"type": "chore", "section": "Maintenance", "hidden": true}
-        ]
-      }
-    }],
-    ["@semantic-release/changelog", {
-      "changelogFile": "CHANGELOG.md"
-    }],
-    ["@semantic-release/exec", {
-      "prepareCmd": "echo ${nextRelease.version} > .framework-version"
-    }],
-    "@semantic-release/npm",
-    ["@semantic-release/git", {
-      "assets": ["CHANGELOG.md", "package.json", ".framework-version"],
-      "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-    }],
-    "@semantic-release/github"
-  ]
-}

package/dist/commands/analyze.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=analyze.test.d.ts.map

package/dist/commands/doctor.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=doctor.test.d.ts.map

package/dist/commands/init.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=init.test.d.ts.map

package/dist/commands/llmstxt.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=llmstxt.test.d.ts.map

package/dist/commands/plugin.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=plugin.test.d.ts.map

package/dist/commands/sync.d.ts

@@ -1,8 +0,0 @@
-import type { SyncOptions, InitStep } from '../types/index.js';
-type StepCallback = (step: InitStep) => void;
-/**
- * Sync AI config to a project directory, generating CLI-specific config files.
- */
-export declare function syncAIConfig(options: SyncOptions, onStep: StepCallback): Promise<void>;
-export {};
-//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.js

@@ -1,201 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-import { ensureDirExists } from '../lib/common.js';
-import { parseFrontmatter } from '../lib/frontmatter.js';
-import { AI_CONFIG_DIR, AI_CLI_CONFIG_FILES, MARKER_START, MARKER_END, } from '../constants.js';
-const ALL_TARGETS = ['claude', 'opencode', 'gemini', 'qwen', 'codex', 'copilot'];
-function report(onStep, id, label, status, detail) {
-    onStep({ id, label, status, detail });
-}
-/** Read .skillignore and parse exclusion rules */
-async function loadSkillIgnore(configDir) {
-    const globalExcludes = new Set();
-    const targetExcludes = new Map();
-    const ignorePath = path.join(configDir, '.skillignore');
-    if (!await fs.pathExists(ignorePath)) {
-        return { globalExcludes, targetExcludes };
-    }
-    const content = await fs.readFile(ignorePath, 'utf-8');
-    for (const rawLine of content.split('\n')) {
-        const line = rawLine.trim();
-        if (!line || line.startsWith('#'))
-            continue;
-        if (line.includes(':')) {
-            const [target, skill] = line.split(':', 2);
-            if (target && skill) {
-                if (!targetExcludes.has(target))
-                    targetExcludes.set(target, new Set());
-                targetExcludes.get(target).add(skill);
-            }
-        }
-        else {
-            globalExcludes.add(line);
-        }
-    }
-    return { globalExcludes, targetExcludes };
-}
-/** Recursively collect agent/skill markdown files from a directory */
-async function collectMarkdownEntries(baseDir, prefix = '') {
-    const entries = [];
-    if (!await fs.pathExists(baseDir))
-        return entries;
-    const items = await fs.readdir(baseDir, { withFileTypes: true });
-    for (const item of items) {
-        if (item.name.startsWith('_') || item.name.startsWith('.'))
-            continue;
-        const itemPath = path.join(baseDir, item.name);
-        const relPath = prefix ? `${prefix}/${item.name}` : item.name;
-        if (item.isDirectory()) {
-            // Look for SKILL.md or agent markdown inside
-            const skillMd = path.join(itemPath, 'SKILL.md');
-            if (await fs.pathExists(skillMd)) {
-                const content = await fs.readFile(skillMd, 'utf-8');
-                entries.push({ relativePath: relPath, name: item.name, content });
-            }
-            else {
-                // Recurse into subcategory directories
-                const subEntries = await collectMarkdownEntries(itemPath, relPath);
-                entries.push(...subEntries);
-            }
-        }
-        else if (item.name.endsWith('.md') && item.name !== 'README.md') {
-            const content = await fs.readFile(itemPath, 'utf-8');
-            const name = item.name.replace('.md', '');
-            entries.push({ relativePath: relPath, name, content });
-        }
-    }
-    return entries;
-}
-/** Build a CLAUDE.md / GEMINI.md / etc from agents + skills */
-function buildConfigContent(target, agents, skills) {
-    const lines = [];
-    lines.push(`# AI Configuration for ${target}`);
-    lines.push('');
-    lines.push(`Auto-generated by javi-forge sync. Do not edit between markers.`);
-    lines.push('');
-    if (agents.length > 0) {
-        lines.push('## Agents');
-        lines.push('');
-        for (const agent of agents) {
-            const fm = parseFrontmatter(agent.content);
-            if (fm?.data) {
-                const desc = fm.data['description'] ?? '';
-                lines.push(`- **${agent.name}**: ${desc}`);
-            }
-            else {
-                lines.push(`- **${agent.name}**`);
-            }
-        }
-        lines.push('');
-    }
-    if (skills.length > 0) {
-        lines.push('## Available Skills');
-        lines.push('');
-        for (const skill of skills) {
-            const fm = parseFrontmatter(skill.content);
-            if (fm?.data) {
-                const desc = fm.data['description'] ?? '';
-                lines.push(`- **${skill.name}**: ${desc}`);
-            }
-            else {
-                lines.push(`- **${skill.name}**`);
-            }
-        }
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-/** Merge generated content into an existing file using markers */
-function mergeWithMarkers(existingContent, generatedContent) {
-    const startIdx = existingContent.indexOf(MARKER_START);
-    const endIdx = existingContent.indexOf(MARKER_END);
-    const markerBlock = `${MARKER_START}\n${generatedContent}\n${MARKER_END}`;
-    if (startIdx !== -1 && endIdx !== -1) {
-        // Replace existing marker block
-        return existingContent.slice(0, startIdx) + markerBlock + existingContent.slice(endIdx + MARKER_END.length);
-    }
-    // Append marker block
-    return existingContent.trimEnd() + '\n\n' + markerBlock + '\n';
-}
-/**
- * Sync AI config to a project directory, generating CLI-specific config files.
- */
-export async function syncAIConfig(options, onStep) {
-    const { target, mode, projectDir, dryRun } = options;
-    const targets = target === 'all' ? ALL_TARGETS : [target];
-    const configDir = AI_CONFIG_DIR;
-    // Load exclusions
-    const { globalExcludes, targetExcludes } = await loadSkillIgnore(configDir);
-    // Collect agents and skills
-    const agentsDir = path.join(configDir, 'agents');
-    const skillsDir = path.join(configDir, 'skills');
-    const allAgents = await collectMarkdownEntries(agentsDir);
-    const allSkills = await collectMarkdownEntries(skillsDir);
-    for (const cli of targets) {
-        const stepId = `sync-${cli}`;
-        report(onStep, stepId, `Sync config for ${cli}`, 'running');
-        try {
-            // Filter out excluded skills
-            const cliExcludes = targetExcludes.get(cli) ?? new Set();
-            const filteredSkills = allSkills.filter(s => {
-                const nameWithoutExt = s.name;
-                const relWithoutExt = s.relativePath.replace(/\.md$/, '').replace(/\/SKILL\.md$/, '');
-                return !globalExcludes.has(nameWithoutExt)
-                    && !globalExcludes.has(relWithoutExt)
-                    && !cliExcludes.has(nameWithoutExt)
-                    && !cliExcludes.has(relWithoutExt);
-            });
-            const filteredAgents = allAgents.filter(a => {
-                return !globalExcludes.has(a.name) && !cliExcludes.has(a.name);
-            });
-            // Build the config content
-            const generatedContent = buildConfigContent(cli, filteredAgents, filteredSkills);
-            // Determine destination
-            const configFileName = AI_CLI_CONFIG_FILES[cli];
-            if (!configFileName) {
-                report(onStep, stepId, `Sync config for ${cli}`, 'skipped', 'no config file mapping');
-                continue;
-            }
-            const destPath = path.join(projectDir, configFileName);
-            if (!dryRun) {
-                await ensureDirExists(path.dirname(destPath));
-                if (mode === 'merge' && await fs.pathExists(destPath)) {
-                    const existing = await fs.readFile(destPath, 'utf-8');
-                    const merged = mergeWithMarkers(existing, generatedContent);
-                    await fs.writeFile(destPath, merged, 'utf-8');
-                }
-                else {
-                    await fs.writeFile(destPath, generatedContent, 'utf-8');
-                }
-            }
-            report(onStep, stepId, `Sync config for ${cli}`, 'done', `${filteredAgents.length} agents, ${filteredSkills.length} skills → ${configFileName}`);
-            // Sync Claude commands if target is claude
-            if (cli === 'claude') {
-                const cmdStepId = `sync-${cli}-commands`;
-                report(onStep, cmdStepId, 'Sync Claude commands', 'running');
-                try {
-                    const commandsSrc = path.join(configDir, 'commands');
-                    if (await fs.pathExists(commandsSrc)) {
-                        const commandsDest = path.join(projectDir, '.claude', 'commands');
-                        if (!dryRun) {
-                            await ensureDirExists(commandsDest);
-                            await fs.copy(commandsSrc, commandsDest, { overwrite: true });
-                        }
-                        const cmdFiles = await fs.readdir(commandsSrc);
-                        report(onStep, cmdStepId, 'Sync Claude commands', 'done', `${cmdFiles.length} commands`);
-                    }
-                    else {
-                        report(onStep, cmdStepId, 'Sync Claude commands', 'skipped', 'no commands dir');
-                    }
-                }
-                catch (e) {
-                    report(onStep, cmdStepId, 'Sync Claude commands', 'error', String(e));
-                }
-            }
-        }
-        catch (e) {
-            report(onStep, stepId, `Sync config for ${cli}`, 'error', String(e));
-        }
-    }
-}
-//# sourceMappingURL=sync.js.map

package/dist/e2e/aggressive.e2e.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=aggressive.e2e.test.d.ts.map

package/dist/e2e/commands.e2e.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=commands.e2e.test.d.ts.map

package/dist/lib/common.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=common.test.d.ts.map

package/dist/lib/frontmatter.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=frontmatter.test.d.ts.map

package/dist/lib/plugin.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=plugin.test.d.ts.map

package/dist/lib/template.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=template.test.d.ts.map

package/dist/ui/SyncUI.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-import type { AI_CLI } from '../types/index.js';
-interface Props {
-    target: AI_CLI | 'all';
-    mode: 'overwrite' | 'merge';
-    dryRun: boolean;
-}
-export default function SyncUI({ target, mode, dryRun }: Props): React.JSX.Element;
-export {};
-//# sourceMappingURL=SyncUI.d.ts.map

package/dist/ui/SyncUI.js

@@ -1,64 +0,0 @@
-import React, { useEffect, useState } from 'react';
-import { Box, Text, useApp, useInput } from 'ink';
-import Spinner from 'ink-spinner';
-import { syncAIConfig } from '../commands/sync.js';
-import Header from './Header.js';
-import { theme } from './theme.js';
-export default function SyncUI({ target, mode, dryRun }) {
-    const { exit } = useApp();
-    const [steps, setSteps] = useState([]);
-    const [finished, setFinished] = useState(false);
-    useEffect(() => {
-        syncAIConfig({ target, mode, projectDir: process.cwd(), dryRun }, (step) => setSteps(prev => {
-            const idx = prev.findIndex(s => s.id === step.id);
-            if (idx >= 0) {
-                const next = [...prev];
-                next[idx] = step;
-                return next;
-            }
-            return [...prev, step];
-        })).then(() => setFinished(true));
-    }, [target, mode, dryRun]);
-    useInput((_, key) => {
-        if (finished && (key.return || key.escape))
-            exit();
-    });
-    const done = steps.filter(s => s.status === 'done').length;
-    const errors = steps.filter(s => s.status === 'error').length;
-    return (React.createElement(Box, { flexDirection: "column", padding: 1 },
-        React.createElement(Header, { subtitle: "sync", dryRun: dryRun }),
-        React.createElement(Box, { flexDirection: "column" }, steps.map(step => (React.createElement(Box, { key: step.id, marginLeft: 2 }, step.status === 'running' ? (React.createElement(Text, { color: theme.warning },
-            React.createElement(Spinner, { type: "dots" }),
-            ' ',
-            step.label)) : step.status === 'done' ? (React.createElement(Text, { color: theme.success },
-            '\u2713',
-            " ",
-            step.label,
-            step.detail && React.createElement(Text, { color: theme.muted, dimColor: true },
-                "  ",
-                step.detail))) : step.status === 'error' ? (React.createElement(Text, { color: theme.error },
-            '\u2717',
-            " ",
-            step.label,
-            step.detail && React.createElement(Text, { color: theme.muted, dimColor: true },
-                "  ",
-                step.detail))) : (React.createElement(Text, { color: theme.muted },
-            '\u2013',
-            " ",
-            step.label,
-            step.detail && React.createElement(Text, { dimColor: true },
-                "  ",
-                step.detail))))))),
-        finished && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
-            React.createElement(Text, { bold: true, color: errors > 0 ? theme.warning : theme.success },
-                dryRun ? '\u25cb Dry run complete' : '\u2713 Sync complete',
-                ' ',
-                "(",
-                done,
-                " done",
-                errors > 0 ? `, ${errors} errors` : '',
-                ")"),
-            React.createElement(Box, { marginTop: 1 },
-                React.createElement(Text, { color: theme.muted, dimColor: true }, "Press Enter to exit"))))));
-}
-//# sourceMappingURL=SyncUI.js.map

package/tasks/_TEMPLATE/files-edited.md

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

package/tasks/_TEMPLATE/plan.md

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

package/tasks/_TEMPLATE/research.md

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

package/tasks/_TEMPLATE/verification.md

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