specweave 0.4.1 → 0.6.3

package/dist/plugins/specweave-github/lib/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Type definitions for GitHub sync plugin
+ */
+export interface Task {
+    id: string;
+    title: string;
+    priority: 'P0' | 'P1' | 'P2' | 'P3';
+    estimate: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+    githubIssue?: number;
+    assignee?: string;
+    description: string;
+    subtasks?: Subtask[];
+    filesToCreate?: string[];
+    filesToModify?: string[];
+    implementation?: string;
+    acceptanceCriteria?: string[];
+    dependencies?: string[];
+    blocks?: string[];
+    phase?: string;
+}
+export interface Subtask {
+    id: string;
+    description: string;
+    estimate: string;
+    completed: boolean;
+}
+export interface IncrementMetadata {
+    id: string;
+    title: string;
+    version?: string;
+    priority: 'P0' | 'P1' | 'P2' | 'P3';
+    status: 'planning' | 'in-progress' | 'completed' | 'cancelled';
+    github?: {
+        milestone?: number;
+        epic_issue?: number;
+        task_issues?: Record<string, number>;
+        last_sync?: string;
+    };
+}
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    body: string;
+    state: 'open' | 'closed';
+    html_url: string;
+    labels: string[];
+    milestone?: {
+        number: number;
+        title: string;
+    };
+}
+export interface GitHubMilestone {
+    number: number;
+    title: string;
+    description: string;
+    state: 'open' | 'closed';
+}
+export interface SyncResult {
+    milestone?: GitHubMilestone;
+    epic: GitHubIssue;
+    tasks: Array<{
+        taskId: string;
+        issue: GitHubIssue;
+    }>;
+    errors: Array<{
+        taskId?: string;
+        error: string;
+    }>;
+}
+export interface GitHubSyncOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    batchDelay?: number;
+    batchSize?: number;
+    milestoneDays?: number;
+    projectName?: string;
+    fastMode?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/specweave-github/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/specweave-github/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for GitHub sync plugin
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/specweave-github/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/plugins/specweave-github/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/agents-md-compiler.d.ts

@@ -0,0 +1,68 @@
+/**
+ * AGENTS.md Compiler (Cross-Platform)
+ *
+ * Compiles SpecWeave plugins (skills, agents, commands) into unified AGENTS.md format
+ * for non-Claude tools (Cursor, Copilot, Generic)
+ *
+ * Reads from NPM package location (auto-detected):
+ * - Windows: %APPDATA%\npm\node_modules\specweave\
+ * - macOS: /usr/local/lib/node_modules/specweave/ or /opt/homebrew/lib/node_modules/specweave/
+ * - Linux: /usr/local/lib/node_modules/specweave/
+ * - Local development: ./skills/, ./agents/, ./commands/
+ *
+ * Supports: Windows 10+, macOS 10.15+, Linux (Ubuntu, Debian, RHEL, etc.)
+ */
+interface Skill {
+    name: string;
+    description: string;
+    content: string;
+    activationKeywords?: string[];
+}
+interface Agent {
+    name: string;
+    role: string;
+    description: string;
+    content: string;
+    activatesFor?: string[];
+    capabilities?: string[];
+}
+interface Command {
+    name: string;
+    description: string;
+    usage: string;
+    content: string;
+}
+interface CompilationResult {
+    agentsMd: string;
+    skills: Skill[];
+    agents: Agent[];
+    commands: Command[];
+}
+/**
+ * Find SpecWeave installation path (cross-platform)
+ *
+ * Supports Windows, macOS, and Linux with all common NPM installation locations.
+ * Priority: NPM global → NPM local → local development
+ *
+ * @returns Absolute path to SpecWeave installation
+ * @throws Error if SpecWeave installation not found
+ */
+export declare function getSpecweaveInstallPath(): string;
+/**
+ * Read all skills from skills/ directory
+ */
+export declare function readSkills(basePath: string): Promise<Skill[]>;
+/**
+ * Read all agents from agents/ directory
+ */
+export declare function readAgents(basePath: string): Promise<Agent[]>;
+/**
+ * Read all commands from commands/ directory
+ */
+export declare function readCommands(basePath: string): Promise<Command[]>;
+/**
+ * Compile plugins to AGENTS.md format
+ */
+export declare function compileToAgentsMd(basePath: string): Promise<CompilationResult>;
+export { CompilationResult };
+//# sourceMappingURL=agents-md-compiler.d.ts.map

package/dist/utils/agents-md-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md-compiler.d.ts","sourceRoot":"","sources":["../../src/utils/agents-md-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgBH,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAoFhD;AA2BD;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAmCnE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAmCnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA4BvE;AAcD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAapF;AA+MD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/utils/agents-md-compiler.js

@@ -0,0 +1,420 @@
+/**
+ * AGENTS.md Compiler (Cross-Platform)
+ *
+ * Compiles SpecWeave plugins (skills, agents, commands) into unified AGENTS.md format
+ * for non-Claude tools (Cursor, Copilot, Generic)
+ *
+ * Reads from NPM package location (auto-detected):
+ * - Windows: %APPDATA%\npm\node_modules\specweave\
+ * - macOS: /usr/local/lib/node_modules/specweave/ or /opt/homebrew/lib/node_modules/specweave/
+ * - Linux: /usr/local/lib/node_modules/specweave/
+ * - Local development: ./skills/, ./agents/, ./commands/
+ *
+ * Supports: Windows 10+, macOS 10.15+, Linux (Ubuntu, Debian, RHEL, etc.)
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import yaml from 'js-yaml';
+// ============================================================================
+// Path Resolution
+// ============================================================================
+/**
+ * Find SpecWeave installation path (cross-platform)
+ *
+ * Supports Windows, macOS, and Linux with all common NPM installation locations.
+ * Priority: NPM global → NPM local → local development
+ *
+ * @returns Absolute path to SpecWeave installation
+ * @throws Error if SpecWeave installation not found
+ */
+export function getSpecweaveInstallPath() {
+    const platform = process.platform;
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    // Build platform-specific paths
+    const paths = [];
+    // === Windows Paths ===
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
+        const programFiles = process.env['ProgramFiles'] || 'C:\\Program Files';
+        const programFilesX86 = process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)';
+        paths.push(
+        // NPM global (most common on Windows)
+        path.join(appData, 'npm', 'node_modules', 'specweave'), 
+        // NPM global (system install)
+        path.join(programFiles, 'nodejs', 'node_modules', 'specweave'), path.join(programFilesX86, 'nodejs', 'node_modules', 'specweave'), 
+        // nvm-windows
+        path.join(appData, 'nvm', 'node_modules', 'specweave'), 
+        // Custom prefix
+        path.join(homeDir, '.npm-global', 'node_modules', 'specweave'));
+    }
+    // === macOS Paths ===
+    if (platform === 'darwin') {
+        paths.push(
+        // NPM global (Intel Macs)
+        '/usr/local/lib/node_modules/specweave', 
+        // NPM global (Apple Silicon - Homebrew)
+        '/opt/homebrew/lib/node_modules/specweave', 
+        // NVM (Node Version Manager)
+        path.join(homeDir, '.nvm', 'versions', 'node', 'lib', 'node_modules', 'specweave'), 
+        // Custom prefix
+        path.join(homeDir, '.npm-global', 'lib', 'node_modules', 'specweave'));
+    }
+    // === Linux Paths ===
+    if (platform === 'linux') {
+        paths.push(
+        // NPM global (common)
+        '/usr/local/lib/node_modules/specweave', '/usr/lib/node_modules/specweave', 
+        // NVM
+        path.join(homeDir, '.nvm', 'versions', 'node', 'lib', 'node_modules', 'specweave'), 
+        // Custom prefix
+        path.join(homeDir, '.npm-global', 'lib', 'node_modules', 'specweave'));
+    }
+    // === Universal Paths (all platforms) ===
+    paths.push(
+    // NPM local (project-specific)
+    path.join(process.cwd(), 'node_modules', 'specweave'), 
+    // Local development (current directory)
+    process.cwd());
+    // Search for valid installation
+    for (const p of paths) {
+        try {
+            const skillsPath = path.join(p, 'skills');
+            if (fs.existsSync(skillsPath)) {
+                // Verify it's a valid SpecWeave installation
+                const testSkill = path.join(skillsPath, 'increment-planner', 'SKILL.md');
+                if (fs.existsSync(testSkill)) {
+                    return p;
+                }
+            }
+        }
+        catch (error) {
+            // Skip invalid paths
+            continue;
+        }
+    }
+    throw new Error('Could not find SpecWeave installation. Ensure SpecWeave is installed:\n' +
+        '  npm install -g specweave\n\n' +
+        'Searched paths:\n' +
+        paths.map(p => `  - ${p}`).join('\n'));
+}
+// ============================================================================
+// Parsers
+// ============================================================================
+/**
+ * Parse YAML frontmatter from markdown file
+ */
+function parseFrontmatter(content) {
+    const frontmatterRegex = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+    const match = content.match(frontmatterRegex);
+    if (!match) {
+        return { frontmatter: {}, body: content };
+    }
+    try {
+        const frontmatter = yaml.load(match[1]);
+        const body = match[2].trim();
+        return { frontmatter, body };
+    }
+    catch (error) {
+        console.warn('Failed to parse frontmatter:', error);
+        return { frontmatter: {}, body: content };
+    }
+}
+/**
+ * Read all skills from skills/ directory
+ */
+export async function readSkills(basePath) {
+    const skillsDir = path.join(basePath, 'skills');
+    if (!fs.existsSync(skillsDir)) {
+        return [];
+    }
+    const skillFolders = fs.readdirSync(skillsDir).filter((f) => {
+        const stat = fs.statSync(path.join(skillsDir, f));
+        return stat.isDirectory();
+    });
+    const skills = [];
+    for (const folder of skillFolders) {
+        const skillFile = path.join(skillsDir, folder, 'SKILL.md');
+        if (!fs.existsSync(skillFile)) {
+            continue;
+        }
+        const content = fs.readFileSync(skillFile, 'utf-8');
+        const { frontmatter, body } = parseFrontmatter(content);
+        const skill = {
+            name: frontmatter.name || folder,
+            description: frontmatter.description || 'No description',
+            content: body,
+            activationKeywords: frontmatter.description
+                ? extractKeywords(frontmatter.description)
+                : [],
+        };
+        skills.push(skill);
+    }
+    return skills;
+}
+/**
+ * Read all agents from agents/ directory
+ */
+export async function readAgents(basePath) {
+    const agentsDir = path.join(basePath, 'agents');
+    if (!fs.existsSync(agentsDir)) {
+        return [];
+    }
+    const agentFolders = fs.readdirSync(agentsDir).filter((f) => {
+        const stat = fs.statSync(path.join(agentsDir, f));
+        return stat.isDirectory();
+    });
+    const agents = [];
+    for (const folder of agentFolders) {
+        const agentFile = path.join(agentsDir, folder, 'AGENT.md');
+        if (!fs.existsSync(agentFile)) {
+            continue;
+        }
+        const content = fs.readFileSync(agentFile, 'utf-8');
+        const { frontmatter, body } = parseFrontmatter(content);
+        const agent = {
+            name: frontmatter.name || folder,
+            role: frontmatter.role || 'Agent',
+            description: frontmatter.description || 'No description',
+            content: body,
+            activatesFor: frontmatter['activates-for'] || [],
+            capabilities: frontmatter.capabilities || [],
+        };
+        agents.push(agent);
+    }
+    return agents;
+}
+/**
+ * Read all commands from commands/ directory
+ */
+export async function readCommands(basePath) {
+    const commandsDir = path.join(basePath, 'commands');
+    if (!fs.existsSync(commandsDir)) {
+        return [];
+    }
+    const commandFiles = fs.readdirSync(commandsDir).filter((f) => f.endsWith('.md'));
+    const commands = [];
+    for (const file of commandFiles) {
+        const commandFile = path.join(commandsDir, file);
+        const content = fs.readFileSync(commandFile, 'utf-8');
+        const { frontmatter, body } = parseFrontmatter(content);
+        const commandName = frontmatter.name || file.replace('.md', '');
+        const command = {
+            name: commandName,
+            description: frontmatter.description || 'No description',
+            usage: `/${commandName}`,
+            content: body,
+        };
+        commands.push(command);
+    }
+    return commands;
+}
+/**
+ * Extract keywords from description
+ */
+function extractKeywords(description) {
+    const words = description.toLowerCase().split(/[,\s]+/);
+    return words.filter((w) => w.length > 3);
+}
+// ============================================================================
+// AGENTS.MD Compiler
+// ============================================================================
+/**
+ * Compile plugins to AGENTS.md format
+ */
+export async function compileToAgentsMd(basePath) {
+    const skills = await readSkills(basePath);
+    const agents = await readAgents(basePath);
+    const commands = await readCommands(basePath);
+    const agentsMd = generateAgentsMd(skills, agents, commands);
+    return {
+        agentsMd,
+        skills,
+        agents,
+        commands,
+    };
+}
+/**
+ * Generate AGENTS.md content
+ */
+function generateAgentsMd(skills, agents, commands) {
+    const sections = [];
+    // Header
+    sections.push(`# SpecWeave Development Guide
+
+**Version**: 0.5.0
+**Plugin System**: Claude Code Native + Multi-Tool Support
+
+This project uses SpecWeave for spec-driven development. SpecWeave provides specialized agents, skills, and commands to guide the development workflow.
+
+---
+
+## Quick Start
+
+### For Claude Code Users
+
+\`\`\`bash
+# Add SpecWeave marketplace
+/plugin marketplace add anton-abyzov/specweave
+
+# Install core framework
+/plugin install specweave@specweave
+
+# Install GitHub plugin (optional)
+/plugin install specweave-github@specweave
+\`\`\`
+
+### For Other Tools (Cursor, Copilot, etc.)
+
+This AGENTS.md file contains all necessary context. Your AI assistant will automatically read it.
+
+---
+`);
+    // Agents section
+    sections.push(`## Available Agents\n`);
+    for (const agent of agents) {
+        const emoji = getAgentEmoji(agent.name);
+        sections.push(`### ${emoji} ${capitalize(agent.name)} (${agent.role})\n`);
+        sections.push(`**Description**: ${agent.description}\n`);
+        if (agent.activatesFor && agent.activatesFor.length > 0) {
+            sections.push(`**Activates for**: ${agent.activatesFor.join(', ')}\n`);
+        }
+        if (agent.capabilities && agent.capabilities.length > 0) {
+            sections.push(`**Capabilities**:\n`);
+            for (const cap of agent.capabilities) {
+                sections.push(`- ${cap}\n`);
+            }
+        }
+        sections.push(`\n---\n\n`);
+    }
+    // Skills section
+    sections.push(`## Available Skills\n`);
+    for (const skill of skills) {
+        sections.push(`### ${skill.name}\n`);
+        sections.push(`**Description**: ${skill.description}\n`);
+        if (skill.activationKeywords && skill.activationKeywords.length > 0) {
+            sections.push(`**Activates for**: ${skill.activationKeywords.slice(0, 5).join(', ')}\n`);
+        }
+        sections.push(`\n---\n\n`);
+    }
+    // Commands section
+    sections.push(`## Available Commands\n`);
+    for (const command of commands) {
+        sections.push(`### ${command.usage}\n`);
+        sections.push(`**Description**: ${command.description}\n`);
+        sections.push(`\n---\n\n`);
+    }
+    // Project structure
+    sections.push(`## Project Structure
+
+\`\`\`
+.specweave/
+├── increments/              # Feature development
+│   ├── 0001-feature-name/
+│   │   ├── spec.md          # Product specification
+│   │   ├── plan.md          # Technical implementation
+│   │   ├── tasks.md         # Actionable tasks
+│   │   ├── tests.md         # Test strategy
+│   │   ├── logs/            # Execution logs
+│   │   ├── reports/         # Analysis files
+│   │   └── scripts/         # Helper scripts
+│   └── _backlog/            # Planned future work
+│
+├── docs/
+│   ├── internal/            # Strategic docs (NEVER published)
+│   │   ├── strategy/        # Business strategy, market analysis
+│   │   ├── architecture/    # Technical architecture
+│   │   │   ├── adr/         # Architecture Decision Records
+│   │   │   ├── rfc/         # Request for Comments
+│   │   │   ├── diagrams/    # Mermaid + SVG diagrams
+│   │   │   └── hld-*.md     # High-Level Design
+│   │   └── delivery/        # Implementation notes, runbooks
+│   │
+│   └── public/              # User-facing docs (can publish)
+│       ├── guides/
+│       └── api/
+│
+└── logs/                    # Framework logs (gitignored)
+\`\`\`
+
+---
+
+## Typical Workflow
+
+### 1. Plan New Increment
+
+\`\`\`bash
+/specweave.inc "user authentication with OAuth"
+\`\`\`
+
+Creates:
+- \`.specweave/increments/0001-user-authentication/spec.md\`
+- \`.specweave/increments/0001-user-authentication/plan.md\`
+- \`.specweave/increments/0001-user-authentication/tasks.md\`
+- \`.specweave/increments/0001-user-authentication/tests.md\`
+
+### 2. Execute Tasks
+
+\`\`\`bash
+/specweave.do
+\`\`\`
+
+- Executes tasks sequentially
+- Hooks fire after EVERY task
+- Living docs update automatically
+
+### 3. Check Progress
+
+\`\`\`bash
+/specweave.progress
+\`\`\`
+
+Shows completion percentage and next action.
+
+### 4. Close Increment
+
+\`\`\`bash
+/specweave.done 0001
+\`\`\`
+
+PM validation, updates status.
+
+---
+
+## Best Practices
+
+### DO:
+- ✅ Always start with \`/specweave.inc\` for new features
+- ✅ Review specs before implementation
+- ✅ Execute tasks via \`/specweave.do\` (hooks fire automatically)
+- ✅ Validate before closing: \`/specweave.validate\`
+
+### DON'T:
+- ❌ Skip spec creation (no "cowboy coding")
+- ❌ Create files in project root (use increment folders)
+- ❌ Ignore PM gate validation
+
+---
+
+**Last Updated**: 2025-11-02 (v0.5.0)
+`);
+    return sections.join('');
+}
+/**
+ * Get emoji for agent type
+ */
+function getAgentEmoji(name) {
+    const emojiMap = {
+        pm: '🎯',
+        architect: '🏗️',
+        'tech-lead': '👨‍💻',
+        'github-manager': '🐙',
+    };
+    return emojiMap[name.toLowerCase()] || '🤖';
+}
+/**
+ * Capitalize first letter
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=agents-md-compiler.js.map

package/dist/utils/agents-md-compiler.js.map

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