specweave 0.17.0 → 0.17.1

package/dist/src/adapters/doc-generator.js

@@ -0,0 +1,247 @@
+/**
+ * Documentation Generator for Adapters
+ *
+ * Generates markdown documentation from actual skills/agents/commands
+ * for use in adapter instruction files (.cursorrules, instructions.md, etc.)
+ */
+import fs from 'fs-extra';
+import * as path from 'path';
+import * as YAML from 'yaml';
+import { getDirname } from '../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+/**
+ * Documentation Generator
+ */
+export class DocGenerator {
+    constructor(skillsDir = path.join(__dirname, '../skills'), agentsDir = path.join(__dirname, '../agents'), commandsDir = path.join(__dirname, '../commands')) {
+        this.skillsDir = skillsDir;
+        this.agentsDir = agentsDir;
+        this.commandsDir = commandsDir;
+    }
+    /**
+     * Extract skills metadata from SKILL.md files
+     */
+    async extractSkills() {
+        const skills = [];
+        if (!await fs.pathExists(this.skillsDir)) {
+            return skills;
+        }
+        const skillFolders = await fs.readdir(this.skillsDir);
+        for (const folder of skillFolders) {
+            const skillPath = path.join(this.skillsDir, folder);
+            const skillFile = path.join(skillPath, 'SKILL.md');
+            if (await fs.pathExists(skillFile)) {
+                const content = await fs.readFile(skillFile, 'utf-8');
+                const metadata = this.extractYAMLFrontmatter(content);
+                if (metadata && metadata.name && metadata.description) {
+                    skills.push({
+                        name: metadata.name,
+                        description: metadata.description,
+                        location: `.claude/skills/${folder}/SKILL.md`
+                    });
+                }
+            }
+        }
+        return skills.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Extract agents metadata from AGENT.md files
+     */
+    async extractAgents() {
+        const agents = [];
+        if (!await fs.pathExists(this.agentsDir)) {
+            return agents;
+        }
+        const agentFolders = await fs.readdir(this.agentsDir);
+        for (const folder of agentFolders) {
+            const agentPath = path.join(this.agentsDir, folder);
+            const agentFile = path.join(agentPath, 'AGENT.md');
+            if (await fs.pathExists(agentFile)) {
+                const content = await fs.readFile(agentFile, 'utf-8');
+                // Extract role from content (look for "# [Role]" heading)
+                const roleMatch = content.match(/^#\s+(.+?)$/m);
+                const role = roleMatch ? roleMatch[1].trim() : folder;
+                // Extract description (first paragraph after frontmatter)
+                const descriptionMatch = content.match(/---\n[\s\S]*?---\n\n(.+?)(?:\n\n|$)/);
+                const description = descriptionMatch ? descriptionMatch[1].trim() : `${role} agent`;
+                agents.push({
+                    name: folder,
+                    role: role,
+                    description: description,
+                    location: `.claude/agents/${folder}/AGENT.md`
+                });
+            }
+        }
+        return agents.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Extract commands metadata from .md files
+     */
+    async extractCommands() {
+        const commands = [];
+        if (!await fs.pathExists(this.commandsDir)) {
+            return commands;
+        }
+        const commandFiles = await fs.readdir(this.commandsDir);
+        for (const file of commandFiles) {
+            if (file.endsWith('.md') && file !== 'README.md') {
+                const commandPath = path.join(this.commandsDir, file);
+                const content = await fs.readFile(commandPath, 'utf-8');
+                // Extract description from first paragraph
+                const descriptionMatch = content.match(/^(.+?)(?:\n\n|$)/);
+                const description = descriptionMatch ? descriptionMatch[1].trim() : '';
+                const commandName = file.replace('.md', '');
+                commands.push({
+                    name: commandName,
+                    description: description,
+                    location: `.claude/commands/${file}`
+                });
+            }
+        }
+        return commands.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Generate skills documentation for Cursor .cursorrules
+     */
+    async generateSkillsDocForCursor() {
+        const skills = await this.extractSkills();
+        let doc = '## Available Skills (Read SKILL.md when task matches)\n\n';
+        doc += 'SpecWeave skills are specialized capabilities. In Claude Code, they auto-activate.\n';
+        doc += 'In Cursor, you simulate by reading the skill file and following its workflow.\n\n';
+        for (const skill of skills) {
+            doc += `### ${skill.name}\n`;
+            doc += `**File**: \`${skill.location}\`\n`;
+            doc += `**Description**: ${skill.description}\n`;
+            doc += `**How to use**: Read the SKILL.md file and follow the workflow described\n\n`;
+        }
+        return doc;
+    }
+    /**
+     * Generate agents documentation for Cursor .cursorrules
+     */
+    async generateAgentsDocForCursor() {
+        const agents = await this.extractAgents();
+        let doc = '## Agent Roles (Adopt role when specialized expertise needed)\n\n';
+        doc += 'SpecWeave agents are specialized roles. In Claude Code, they have separate contexts.\n';
+        doc += 'In Cursor, you adopt the role\'s perspective and responsibilities.\n\n';
+        for (const agent of agents) {
+            doc += `### ${agent.role}\n`;
+            doc += `**File**: \`${agent.location}\`\n`;
+            doc += `**Description**: ${agent.description}\n`;
+            doc += `**When to adopt**: Say "Adopting ${agent.role} role..." and follow AGENT.md guidance\n\n`;
+        }
+        return doc;
+    }
+    /**
+     * Generate skills documentation for Copilot instructions.md
+     */
+    async generateSkillsDocForCopilot() {
+        const skills = await this.extractSkills();
+        let doc = '## Available Capabilities (SpecWeave Skills)\n\n';
+        doc += 'The project uses these specialized capabilities:\n\n';
+        for (const skill of skills) {
+            doc += `- **${skill.name}**: ${skill.description}\n`;
+        }
+        doc += '\n_Note: These are defined in `.claude/skills/` but work as documentation for code suggestions._\n\n';
+        return doc;
+    }
+    /**
+     * Generate agents documentation for Copilot instructions.md
+     */
+    async generateAgentsDocForCopilot() {
+        const agents = await this.extractAgents();
+        let doc = '## Project Roles (SpecWeave Agents)\n\n';
+        doc += 'Code in this project follows these role-based patterns:\n\n';
+        for (const agent of agents) {
+            doc += `- **${agent.role}**: ${agent.description}\n`;
+        }
+        doc += '\n_Note: These are defined in `.claude/agents/` but inform code patterns and suggestions._\n\n';
+        return doc;
+    }
+    /**
+     * Generate complete manual workflow for generic adapter
+     */
+    async generateManualWorkflow() {
+        const skills = await this.extractSkills();
+        const agents = await this.extractAgents();
+        const commands = await this.extractCommands();
+        let doc = '# SpecWeave Manual Workflow Guide\n\n';
+        doc += '_For use with ANY AI tool (ChatGPT, Claude web, Gemini, etc.)_\n\n';
+        doc += '---\n\n';
+        doc += '## What is SpecWeave?\n\n';
+        doc += 'SpecWeave is a spec-driven development framework where specifications are the source of truth.\n';
+        doc += 'This manual shows you how to use SpecWeave WITHOUT specialized tools (works with ANY AI).\n\n';
+        doc += '## Available Capabilities\n\n';
+        doc += 'While you can\'t auto-activate these like Claude Code, you can reference them:\n\n';
+        doc += '### Skills\n\n';
+        for (const skill of skills.slice(0, 10)) { // Top 10 skills
+            doc += `- **${skill.name}**: ${skill.description}\n`;
+        }
+        doc += `\n_...and ${skills.length - 10} more in \`.claude/skills/\`_\n\n`;
+        doc += '### Roles\n\n';
+        for (const agent of agents) {
+            doc += `- **${agent.role}**: ${agent.description}\n`;
+        }
+        doc += '\n';
+        doc += '## Step-by-Step: Creating a Feature\n\n';
+        doc += '### Step 1: Create Increment Folder\n\n';
+        doc += '```bash\n';
+        doc += 'mkdir -p .specweave/increments/0001-feature-name\n';
+        doc += '```\n\n';
+        doc += '### Step 2: Create spec.md (Act as Product Manager)\n\n';
+        doc += '_Copy this template to your AI and ask it to fill it out:_\n\n';
+        doc += '```markdown\n';
+        doc += '---\n';
+        doc += 'increment: 0001-feature-name\n';
+        doc += 'title: "Feature Title"\n';
+        doc += 'priority: P1\n';
+        doc += 'status: planned\n';
+        doc += '---\n\n';
+        doc += '# Increment 0001: Feature Name\n\n';
+        doc += '## Overview\n';
+        doc += '[Problem and solution]\n\n';
+        doc += '## User Stories\n';
+        doc += '[User stories with acceptance criteria]\n';
+        doc += '```\n\n';
+        doc += '### Step 3: Create plan.md (Act as Architect)\n\n';
+        doc += '_Copy this template to your AI:_\n\n';
+        doc += '```markdown\n';
+        doc += '# Technical Plan: Feature Name\n\n';
+        doc += '## Architecture\n';
+        doc += '[Component design]\n\n';
+        doc += '## Data Model\n';
+        doc += '[Database schema]\n';
+        doc += '```\n\n';
+        doc += '### Step 4: Create tasks.md\n\n';
+        doc += '```markdown\n';
+        doc += '# Implementation Tasks\n\n';
+        doc += '- [ ] T001: Task 1\n';
+        doc += '- [ ] T002: Task 2\n';
+        doc += '```\n\n';
+        doc += '### Step 5: Create context-manifest.yaml\n\n';
+        doc += '```yaml\n';
+        doc += 'spec_sections:\n';
+        doc += '  - .specweave/docs/internal/strategy/relevant-spec.md\n';
+        doc += 'documentation:\n';
+        doc += '  - .specweave/docs/internal/architecture/relevant-design.md\n';
+        doc += '```\n\n';
+        doc += '## Complete Workflow Reference\n\n';
+        doc += 'For detailed guidance, see SPECWEAVE.md in the project root.\n\n';
+        return doc;
+    }
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    extractYAMLFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match)
+            return null;
+        try {
+            return YAML.parse(match[1]);
+        }
+        catch (error) {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=doc-generator.js.map

package/dist/src/adapters/doc-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-generator.js","sourceRoot":"","sources":["../../../src/adapters/doc-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/adapters/gemini/adapter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Gemini CLI Adapter
+ *
+ * Semi-automation adapter for Google Gemini CLI.
+ * Uses universal AGENTS.md file for instructions.
+ *
+ * Gemini CLI features:
+ * - Open-source AI agent (Apache 2.0)
+ * - 1M token context window
+ * - ReAct loop with built-in tools
+ * - MCP (Model Context Protocol) support
+ * - Agent mode for multi-file tasks
+ */
+import { AdapterBase } from '../adapter-base.js';
+import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+export declare class GeminiAdapter extends AdapterBase {
+    name: string;
+    description: string;
+    automationLevel: "semi";
+    /**
+     * Detect if Gemini CLI is available
+     *
+     * Checks for:
+     * - gemini command in PATH
+     * - .gemini/ directory exists
+     * - AGENTS.md file exists (previously configured)
+     */
+    detect(): Promise<boolean>;
+    /**
+     * Get files to install for Gemini adapter
+     */
+    getFiles(): AdapterFile[];
+    /**
+     * Install Gemini adapter
+     */
+    install(options: AdapterOptions): Promise<void>;
+    /**
+     * Generate AGENTS.md file
+     */
+    private generateAgentsMd;
+    /**
+     * Post-installation instructions
+     */
+    postInstall(options: AdapterOptions): Promise<void>;
+    /**
+     * Get usage instructions for Gemini adapter
+     */
+    getInstructions(): string;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/src/adapters/gemini/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/gemini/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtE,qBAAa,aAAc,SAAQ,WAAW;IAC5C,IAAI,SAAY;IAChB,WAAW,SAAwE;IACnF,eAAe,EAAG,MAAM,CAAU;IAElC;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAQhC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAezB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAoL1B"}

package/dist/src/adapters/gemini/adapter.js

@@ -0,0 +1,281 @@
+/**
+ * Gemini CLI Adapter
+ *
+ * Semi-automation adapter for Google Gemini CLI.
+ * Uses universal AGENTS.md file for instructions.
+ *
+ * Gemini CLI features:
+ * - Open-source AI agent (Apache 2.0)
+ * - 1M token context window
+ * - ReAct loop with built-in tools
+ * - MCP (Model Context Protocol) support
+ * - Agent mode for multi-file tasks
+ */
+import * as path from 'path';
+import fs from 'fs-extra';
+import { AdapterBase } from '../adapter-base.js';
+import { AgentsMdGenerator } from '../agents-md-generator.js';
+import { getDirname } from '../../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+export class GeminiAdapter extends AdapterBase {
+    constructor() {
+        super(...arguments);
+        this.name = 'gemini';
+        this.description = 'Gemini CLI adapter - Semi-automation with AGENTS.md and agent mode';
+        this.automationLevel = 'semi';
+    }
+    /**
+     * Detect if Gemini CLI is available
+     *
+     * Checks for:
+     * - gemini command in PATH
+     * - .gemini/ directory exists
+     * - AGENTS.md file exists (previously configured)
+     */
+    async detect() {
+        const hasGeminiCLI = await this.commandExists('gemini');
+        const hasGeminiDir = await this.fileExists('.gemini');
+        const hasAgentsMd = await this.fileExists('AGENTS.md');
+        return hasGeminiCLI || hasGeminiDir || hasAgentsMd;
+    }
+    /**
+     * Get files to install for Gemini adapter
+     */
+    getFiles() {
+        return [
+            {
+                sourcePath: 'AGENTS.md',
+                targetPath: 'AGENTS.md',
+                description: 'Universal SpecWeave instructions (works with all AI tools)'
+            },
+            {
+                sourcePath: 'README.md',
+                targetPath: '.gemini/README.md',
+                description: 'Gemini adapter documentation'
+            }
+        ];
+    }
+    /**
+     * Install Gemini adapter
+     */
+    async install(options) {
+        console.log('\n📦 Installing Gemini CLI Adapter (Semi-Automation)\n');
+        // Ensure .gemini directory exists
+        const geminiDir = path.join(options.projectPath, '.gemini');
+        await fs.ensureDir(geminiDir);
+        // Generate AGENTS.md
+        const agentsMdPath = path.join(options.projectPath, 'AGENTS.md');
+        await this.generateAgentsMd(agentsMdPath, options);
+        // Copy README
+        const readmePath = path.join(__dirname, 'README.md');
+        if (await fs.pathExists(readmePath)) {
+            await fs.copy(readmePath, path.join(geminiDir, 'README.md'));
+        }
+        console.log('\n✨ Gemini adapter installed!');
+        console.log('\n📋 Files created:');
+        console.log('   - AGENTS.md (universal instructions)');
+        console.log('   - .gemini/README.md (adapter documentation)');
+    }
+    /**
+     * Generate AGENTS.md file
+     */
+    async generateAgentsMd(targetPath, options) {
+        const generator = new AgentsMdGenerator(path.join(__dirname, '../../skills'), path.join(__dirname, '../../agents'), path.join(__dirname, '../../commands'));
+        const content = await generator.generate({
+            projectName: options.projectName,
+            projectPath: options.projectPath
+        });
+        await fs.writeFile(targetPath, content);
+        console.log('  ✅ AGENTS.md - Universal SpecWeave instructions');
+    }
+    /**
+     * Post-installation instructions
+     */
+    async postInstall(options) {
+        console.log(this.getInstructions());
+    }
+    /**
+     * Get usage instructions for Gemini adapter
+     */
+    getInstructions() {
+        return `
+================================================================
+      Gemini CLI Adapter - Semi-Automation
+================================================================
+
+Your project is now configured for Gemini CLI with SEMI-automation!
+
+WHAT THIS PROVIDES:
+
+- AGENTS.md (Universal Instructions)
+  - Works with Gemini CLI AND other tools
+  - Auto-generated from actual skills/agents
+  - SpecWeave structure and workflows
+  - 1M token context window support
+
+- Agent Mode Integration
+  - Multi-file task handling
+  - ReAct loop with built-in tools
+  - MCP support for extensibility
+
+QUICK START:
+
+1. Install Gemini CLI (if not already installed):
+
+   npm install -g @google-cloud/gemini-cli
+
+2. Authenticate:
+
+   gemini auth
+
+3. Create your first feature:
+
+   gemini "Read AGENTS.md and create increment for user authentication"
+
+   Gemini will:
+   - Read AGENTS.md for SpecWeave context
+   - Adopt PM role: Create spec.md (WHAT/WHY)
+   - Adopt Architect role: Create plan.md (HOW)
+   - Create tasks.md
+   - Use agent mode for multi-file operations
+
+4. Continue development:
+
+   gemini "Implement task T001 from increment 0001"
+   gemini "Run tests for increment 0001"
+   gemini "Review and fix any issues"
+
+HOW TO USE:
+
+Gemini CLI reads AGENTS.md automatically when you reference it:
+
+\`\`\`bash
+# Explicit reference (recommended):
+gemini "Read AGENTS.md and [your request]"
+
+# Natural language:
+gemini "Create a new feature following SpecWeave structure"
+
+# With context:
+gemini "Following the PM role in AGENTS.md, create requirements for payments"
+\`\`\`
+
+CONTEXT LOADING (70%+ Token Savings):
+
+CRITICAL: Tell Gemini to read context-manifest.yaml first!
+
+\`\`\`bash
+gemini "Read context-manifest.yaml from increment 0001, load only those files, then implement task T001"
+\`\`\`
+
+**Why this matters**:
+- Gemini has 1M token context window
+- But loading everything wastes tokens
+- Context manifests = precise, efficient loading
+
+FEATURES:
+
+✅ 1M Token Context Window
+   - Can handle large specifications
+   - Read entire codebase if needed
+
+✅ Agent Mode
+   - Multi-file task completion
+   - Automatic planning and execution
+   - Interactive approval before changes
+
+✅ Built-in Tools
+   - File operations
+   - Shell commands
+   - Google Search grounding
+   - Web fetching
+
+✅ MCP Support
+   - Extend with custom integrations
+   - Local or remote MCP servers
+
+✅ Free Tier
+   - Gemini 2.5 Pro included
+   - 60 requests/minute
+   - 1,000 requests/day
+
+EXAMPLE WORKFLOWS:
+
+1. **Create Feature**:
+   \`\`\`bash
+   gemini "Read AGENTS.md. Create increment 0002 for payment processing with Stripe. Follow SpecWeave structure: spec.md (PM role), plan.md (Architect role), tasks.md"
+   \`\`\`
+
+2. **Implement Task**:
+   \`\`\`bash
+   gemini "Read increment 0002, implement task T001 (Setup Stripe SDK)"
+   \`\`\`
+
+3. **Fix Bug**:
+   \`\`\`bash
+   gemini "Read AGENTS.md and increment 0001. Fix authentication bug in login endpoint. Update tests."
+   \`\`\`
+
+4. **Review Code**:
+   \`\`\`bash
+   gemini "Adopt Tech Lead role from AGENTS.md. Review code in src/auth/ and provide feedback"
+   \`\`\`
+
+TIPS & TRICKS:
+
+1. **Always Reference AGENTS.md**
+   - Ensures Gemini understands SpecWeave structure
+   - Provides role definitions (PM, Architect, etc.)
+
+2. **Use Agent Mode**
+   - For complex, multi-file tasks
+   - Gemini proposes plan before execution
+   - You approve changes
+
+3. **Leverage 1M Context Window**
+   - Can load large specs
+   - But still use context manifests for efficiency
+
+4. **MCP Integration**
+   - Connect to your tools (JIRA, GitHub, etc.)
+   - See: https://modelcontextprotocol.io/
+
+5. **Check Gemini Documentation**
+   - \`gemini --help\`
+   - https://developers.google.com/gemini-code-assist/docs/gemini-cli
+
+COMPARISON:
+
+| Feature | Claude Code | Gemini CLI |
+|---------|-------------|------------|
+| **Automation** | Full | Semi |
+| **Skills** | Native | Via AGENTS.md |
+| **Agents** | Native | Via AGENTS.md |
+| **Context Window** | 200k | 1M (5x larger!) |
+| **Cost** | Paid | Free tier available |
+| **Open Source** | No | Yes (Apache 2.0) |
+
+LIMITATIONS:
+
+- No native skills/agents (manual role adoption via AGENTS.md)
+- No hooks (can't auto-update docs on events)
+- Requires explicit instruction referencing
+- CLI-only (no IDE integration yet)
+
+But still VERY powerful with 1M context and agent mode!
+
+DOCUMENTATION:
+
+- AGENTS.md: Universal SpecWeave instructions (READ THIS!)
+- SPECWEAVE.md: Complete framework documentation
+- .gemini/README.md: Gemini adapter guide
+- https://developers.google.com/gemini-code-assist/docs/gemini-cli
+
+You're ready to build with SpecWeave on Gemini CLI!
+
+Pro tip: Leverage the 1M token context window for large specifications,
+but always use context manifests for efficiency!
+    `;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/adapters/gemini/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/adapters/gemini/adapter.ts"],"names":[],"mappings":"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"}