javi-forge 1.2.0 → 1.4.0

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/schemas/agent.schema.json

@@ -1,34 +0,0 @@
-{
-  "$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

@@ -1,28 +0,0 @@
-{
-  "$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/plugin.schema.json

@@ -1,62 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Plugin manifest",
-  "description": "Schema for javi-forge plugin.json manifest",
-  "type": "object",
-  "required": ["name", "version", "description"],
-  "additionalProperties": false,
-  "properties": {
-    "name": {
-      "type": "string",
-      "description": "Unique plugin identifier in kebab-case",
-      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
-      "minLength": 2,
-      "maxLength": 60
-    },
-    "version": {
-      "type": "string",
-      "description": "Semver version string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$"
-    },
-    "description": {
-      "type": "string",
-      "description": "Short description of what the plugin provides",
-      "minLength": 10,
-      "maxLength": 200
-    },
-    "author": {
-      "type": "string",
-      "description": "Plugin author or organization"
-    },
-    "repository": {
-      "type": "string",
-      "description": "GitHub repository URL (e.g. https://github.com/org/repo)"
-    },
-    "skills": {
-      "type": "array",
-      "description": "Skill directories included in this plugin",
-      "items": { "type": "string" }
-    },
-    "commands": {
-      "type": "array",
-      "description": "Command definitions included in this plugin",
-      "items": { "type": "string" }
-    },
-    "hooks": {
-      "type": "array",
-      "description": "Hook definitions included in this plugin",
-      "items": { "type": "string" }
-    },
-    "agents": {
-      "type": "array",
-      "description": "Agent definitions included in this plugin",
-      "items": { "type": "string" }
-    },
-    "tags": {
-      "type": "array",
-      "description": "Searchable tags for plugin discovery",
-      "items": { "type": "string" },
-      "maxItems": 10
-    }
-  }
-}

package/schemas/skill.schema.json

@@ -1,44 +0,0 @@
-{
-  "$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/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