specweave 0.16.7 → 0.16.11

package/dist/src/core/plugin-loader.js

@@ -0,0 +1,421 @@
+/**
+ * Plugin Loader - Claude Code Native
+ *
+ * Reads plugin directories using Claude's official plugin.json format.
+ * Discovers components by scanning directory structure (not from manifest).
+ *
+ * @module core/plugin-loader
+ * @version 0.6.1
+ * @see https://docs.claude.com/en/docs/claude-code/plugins
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+import { ManifestValidationError, PluginNotFoundError } from './types/plugin.js';
+/**
+ * PluginLoader - Loads Claude Code plugins from filesystem
+ */
+export class PluginLoader {
+    constructor() {
+        // No schema validation - Claude's plugin.json is minimal and straightforward
+    }
+    /**
+     * Load a plugin from directory (Claude Code native)
+     *
+     * @param pluginPath - Absolute path to plugin directory
+     * @returns Loaded plugin with all components
+     * @throws PluginNotFoundError if directory doesn't exist
+     * @throws ManifestValidationError if plugin.json is invalid
+     */
+    async loadFromDirectory(pluginPath) {
+        // Verify directory exists
+        if (!(await fs.pathExists(pluginPath))) {
+            throw new PluginNotFoundError(path.basename(pluginPath));
+        }
+        // Load Claude's plugin.json
+        const manifest = await this.loadManifest(pluginPath);
+        // Discover components by scanning directories (NOT from manifest)
+        const [skills, agents, commands] = await Promise.all([
+            this.discoverSkills(pluginPath),
+            this.discoverAgents(pluginPath),
+            this.discoverCommands(pluginPath)
+        ]);
+        return {
+            manifest,
+            path: pluginPath,
+            skills,
+            agents,
+            commands
+        };
+    }
+    /**
+     * Load plugin manifest from .claude-plugin/plugin.json (Claude's official format)
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Plugin manifest
+     * @throws ManifestValidationError if plugin.json is invalid
+     */
+    async loadManifest(pluginPath) {
+        const pluginJsonPath = path.join(pluginPath, '.claude-plugin', 'plugin.json');
+        // Check if plugin.json exists
+        if (!(await fs.pathExists(pluginJsonPath))) {
+            throw new ManifestValidationError(`plugin.json not found at ${pluginJsonPath}`, path.basename(pluginPath));
+        }
+        // Read and parse plugin.json
+        let content;
+        try {
+            content = await fs.readJSON(pluginJsonPath);
+        }
+        catch (error) {
+            throw new ManifestValidationError(`Invalid JSON in plugin.json: ${error.message}`, path.basename(pluginPath));
+        }
+        // Basic validation (required fields)
+        const validation = this.validateManifest(content);
+        if (!validation.valid) {
+            throw new ManifestValidationError(`plugin.json validation failed:\n${validation.errors.join('\n')}`, path.basename(pluginPath));
+        }
+        return content;
+    }
+    /**
+     * Validate plugin.json (simple validation, no JSON Schema)
+     *
+     * @param manifest - Manifest object to validate
+     * @returns Validation result with errors/warnings
+     */
+    validateManifest(manifest) {
+        const errors = [];
+        const warnings = [];
+        // Required fields (Claude's official schema)
+        if (!manifest.name)
+            errors.push('Missing required field: name');
+        if (!manifest.description)
+            errors.push('Missing required field: description');
+        if (!manifest.version)
+            errors.push('Missing required field: version');
+        if (!manifest.author)
+            errors.push('Missing required field: author');
+        if (manifest.author && !manifest.author.name) {
+            errors.push('Missing required field: author.name');
+        }
+        // Warn about old SpecWeave fields
+        if (manifest.specweave_core_version) {
+            warnings.push('Deprecated field: specweave_core_version (no longer used)');
+        }
+        if (manifest.provides) {
+            warnings.push('Deprecated field: provides (components discovered by scanning)');
+        }
+        if (manifest.auto_detect) {
+            warnings.push('Deprecated field: auto_detect (no longer used)');
+        }
+        if (manifest.triggers) {
+            warnings.push('Deprecated field: triggers (use keywords instead)');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    /**
+     * Discover skills by scanning skills/ directory
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Array of discovered skills
+     */
+    async discoverSkills(pluginPath) {
+        const skillsDir = path.join(pluginPath, 'skills');
+        if (!(await fs.pathExists(skillsDir))) {
+            return [];
+        }
+        const skills = [];
+        const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const skillPath = path.join(skillsDir, entry.name);
+                const skillMdPath = path.join(skillPath, 'SKILL.md');
+                if (await fs.pathExists(skillMdPath)) {
+                    const content = await fs.readFile(skillMdPath, 'utf-8');
+                    const description = this.extractDescription(content);
+                    const testCases = await this.loadTestCases(skillPath);
+                    skills.push({
+                        name: entry.name,
+                        path: skillPath,
+                        description,
+                        testCases
+                    });
+                }
+            }
+        }
+        return skills;
+    }
+    /**
+     * Discover agents by scanning agents/ directory
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Array of discovered agents
+     */
+    async discoverAgents(pluginPath) {
+        const agentsDir = path.join(pluginPath, 'agents');
+        if (!(await fs.pathExists(agentsDir))) {
+            return [];
+        }
+        const agents = [];
+        const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const agentPath = path.join(agentsDir, entry.name);
+                const agentMdPath = path.join(agentPath, 'AGENT.md');
+                if (await fs.pathExists(agentMdPath)) {
+                    const content = await fs.readFile(agentMdPath, 'utf-8');
+                    const capabilities = this.extractCapabilities(content);
+                    agents.push({
+                        name: entry.name,
+                        path: agentPath,
+                        systemPrompt: content,
+                        capabilities
+                    });
+                }
+            }
+        }
+        return agents;
+    }
+    /**
+     * Discover commands by scanning commands/ directory
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Array of discovered commands
+     */
+    async discoverCommands(pluginPath) {
+        const commandsDir = path.join(pluginPath, 'commands');
+        if (!(await fs.pathExists(commandsDir))) {
+            return [];
+        }
+        const commands = [];
+        const files = await fs.readdir(commandsDir);
+        for (const file of files) {
+            if (file.endsWith('.md')) {
+                const commandPath = path.join(commandsDir, file);
+                const content = await fs.readFile(commandPath, 'utf-8');
+                const name = path.basename(file, '.md');
+                const description = this.extractDescription(content);
+                commands.push({
+                    name,
+                    path: commandPath,
+                    description,
+                    prompt: content
+                });
+            }
+        }
+        return commands;
+    }
+    /**
+     * Load skills from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param skillNames - Skill names from manifest
+     * @returns Array of loaded skills
+     */
+    async loadSkills(pluginPath, skillNames) {
+        const skills = [];
+        const skillsDir = path.join(pluginPath, 'skills');
+        for (const skillName of skillNames) {
+            const skillPath = path.join(skillsDir, skillName);
+            const skillMdPath = path.join(skillPath, 'SKILL.md');
+            if (await fs.pathExists(skillMdPath)) {
+                const content = await fs.readFile(skillMdPath, 'utf-8');
+                const description = this.extractDescription(content);
+                // Load test cases if they exist
+                const testCases = await this.loadTestCases(skillPath);
+                skills.push({
+                    name: skillName,
+                    path: skillPath,
+                    description,
+                    testCases
+                });
+            }
+            else {
+                console.warn(`Skill ${skillName} not found at ${skillMdPath}`);
+            }
+        }
+        return skills;
+    }
+    /**
+     * Load agents from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param agentNames - Agent names from manifest
+     * @returns Array of loaded agents
+     */
+    async loadAgents(pluginPath, agentNames) {
+        const agents = [];
+        const agentsDir = path.join(pluginPath, 'agents');
+        for (const agentName of agentNames) {
+            const agentPath = path.join(agentsDir, agentName);
+            const agentMdPath = path.join(agentPath, 'AGENT.md');
+            if (await fs.pathExists(agentMdPath)) {
+                const content = await fs.readFile(agentMdPath, 'utf-8');
+                const systemPrompt = content; // Full content is the system prompt
+                const capabilities = this.extractCapabilities(content);
+                agents.push({
+                    name: agentName,
+                    path: agentPath,
+                    systemPrompt,
+                    capabilities
+                });
+            }
+            else {
+                console.warn(`Agent ${agentName} not found at ${agentMdPath}`);
+            }
+        }
+        return agents;
+    }
+    /**
+     * Load commands from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param commandNames - Command names from manifest
+     * @returns Array of loaded commands
+     */
+    async loadCommands(pluginPath, commandNames) {
+        const commands = [];
+        const commandsDir = path.join(pluginPath, 'commands');
+        for (const commandName of commandNames) {
+            // Convert specweave.github.sync → github-sync.md
+            const fileName = commandName.replace('specweave.', '').replace(/\./g, '-') + '.md';
+            const commandPath = path.join(commandsDir, fileName);
+            if (await fs.pathExists(commandPath)) {
+                const content = await fs.readFile(commandPath, 'utf-8');
+                const description = this.extractDescription(content);
+                commands.push({
+                    name: commandName,
+                    path: commandPath,
+                    description,
+                    prompt: content
+                });
+            }
+            else {
+                console.warn(`Command ${commandName} not found at ${commandPath}`);
+            }
+        }
+        return commands;
+    }
+    /**
+     * Load test cases from skill directory
+     *
+     * @param skillPath - Path to skill directory
+     * @returns Array of test cases
+     */
+    async loadTestCases(skillPath) {
+        const testCases = [];
+        const testCasesDir = path.join(skillPath, 'test-cases');
+        if (!(await fs.pathExists(testCasesDir))) {
+            return testCases;
+        }
+        const files = await fs.readdir(testCasesDir);
+        for (const file of files) {
+            if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+                const testCasePath = path.join(testCasesDir, file);
+                // TODO: Parse YAML test case
+                // For now, just record the path
+                testCases.push({
+                    id: file.replace(/\.(yaml|yml)$/, ''),
+                    description: `Test case from ${file}`,
+                    input: '',
+                    expected: '',
+                    path: testCasePath
+                });
+            }
+        }
+        return testCases;
+    }
+    /**
+     * Extract description from SKILL.md or AGENT.md frontmatter
+     *
+     * @param content - File content
+     * @returns Extracted description
+     */
+    extractDescription(content) {
+        // Extract from YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]+?)\n---/);
+        if (frontmatterMatch) {
+            const descMatch = frontmatterMatch[1].match(/description:\s*(.+)/);
+            if (descMatch) {
+                return descMatch[1].trim();
+            }
+        }
+        // Fallback: first non-empty line after frontmatter
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('-')) {
+                return trimmed.substring(0, 200); // Max 200 chars
+            }
+        }
+        return 'No description available';
+    }
+    /**
+     * Extract capabilities from agent content
+     *
+     * @param content - Agent file content
+     * @returns Array of capability strings
+     */
+    extractCapabilities(content) {
+        const capabilities = [];
+        // Look for "Capabilities" or "Can do" section
+        const capabilitiesMatch = content.match(/##\s*Capabilities\s*\n([\s\S]+?)(?=\n##|$)/i);
+        if (capabilitiesMatch) {
+            const lines = capabilitiesMatch[1].split('\n');
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (trimmed.startsWith('-') || trimmed.startsWith('*')) {
+                    capabilities.push(trimmed.substring(1).trim());
+                }
+            }
+        }
+        return capabilities;
+    }
+    /**
+     * Verify plugin integrity
+     *
+     * Checks that all declared skills/agents/commands exist
+     *
+     * @param plugin - Plugin to verify
+     * @returns True if plugin is intact
+     */
+    async verifyPlugin(plugin) {
+        const { manifest, skills, agents, commands } = plugin;
+        // Check skills
+        if (skills.length !== manifest.provides.skills.length) {
+            console.warn(`Plugin ${manifest.name}: Expected ${manifest.provides.skills.length} skills, found ${skills.length}`);
+            return false;
+        }
+        // Check agents
+        if (agents.length !== manifest.provides.agents.length) {
+            console.warn(`Plugin ${manifest.name}: Expected ${manifest.provides.agents.length} agents, found ${agents.length}`);
+            return false;
+        }
+        // Check commands
+        if (commands.length !== manifest.provides.commands.length) {
+            console.warn(`Plugin ${manifest.name}: Expected ${manifest.provides.commands.length} commands, found ${commands.length}`);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get plugin metadata (lightweight, without loading full plugin)
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Plugin metadata
+     */
+    async getMetadata(pluginPath) {
+        const manifest = await this.loadManifest(pluginPath);
+        return {
+            name: manifest.name,
+            version: manifest.version,
+            description: manifest.description,
+            skillCount: manifest.provides.skills.length,
+            agentCount: manifest.provides.agents.length,
+            commandCount: manifest.provides.commands.length
+        };
+    }
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/src/core/plugin-loader.js.map

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

package/dist/src/core/project-manager.d.ts

@@ -0,0 +1,122 @@
+/**
+ * ProjectManager - Multi-project support for SpecWeave
+ *
+ * Handles project context, path resolution, and project switching.
+ * Key principle: Single project = multi-project with 1 project (no special cases)
+ */
+export interface ProjectContext {
+    id: string;
+    name: string;
+    description: string;
+    techStack: string[];
+    team: string;
+    contacts?: {
+        lead?: string;
+        pm?: string;
+    };
+    syncProfiles?: string[];
+}
+export interface MultiProjectConfig {
+    enabled: boolean;
+    activeProject: string;
+    projects: ProjectContext[];
+}
+export declare class ProjectManager {
+    private configManager;
+    private projectRoot;
+    private cachedProject;
+    constructor(projectRoot: string);
+    /**
+     * Get current active project
+     * Auto-detects project ID from git remote or sync config
+     *
+     * @returns ProjectContext
+     */
+    getActiveProject(): ProjectContext;
+    /**
+     * Get all projects
+     *
+     * @returns ProjectContext[]
+     */
+    getAllProjects(): ProjectContext[];
+    /**
+     * Get project by ID
+     *
+     * @param projectId - Project identifier
+     * @returns ProjectContext or null
+     */
+    getProjectById(projectId: string): ProjectContext | null;
+    /**
+     * Get specs path for active project
+     * Example: .specweave/docs/internal/specs/backend/
+     *
+     * @returns string
+     */
+    getSpecsPath(projectId?: string): string;
+    /**
+     * Get modules path for active project
+     * Example: .specweave/docs/internal/modules/backend/
+     *
+     * @returns string
+     */
+    getModulesPath(projectId?: string): string;
+    /**
+     * Get team docs path for active project
+     * Example: .specweave/docs/internal/team/backend/
+     *
+     * @returns string
+     */
+    getTeamPath(projectId?: string): string;
+    /**
+     * Get project-specific architecture path
+     * Renamed from getArchitecturePath() to avoid conflict with top-level architecture/
+     * Example: .specweave/docs/internal/project-arch/backend/
+     *
+     * @returns string
+     */
+    getProjectArchitecturePath(projectId?: string): string;
+    /**
+     * Get legacy docs path for active project
+     * Example: .specweave/docs/internal/legacy/backend/
+     * Or with source: .specweave/docs/internal/legacy/backend/notion/
+     *
+     * @param source - Optional source type (notion, confluence, wiki, custom)
+     * @returns string
+     */
+    getLegacyPath(source?: string, projectId?: string): string;
+    /**
+     * Switch active project
+     *
+     * @param projectId - Project identifier
+     */
+    switchProject(projectId: string): Promise<void>;
+    /**
+     * Create project structure with all folders
+     * Uses flattened structure: specs/{project}/, modules/{project}/, etc.
+     *
+     * @param projectId - Project identifier
+     */
+    createProjectStructure(projectId: string): Promise<void>;
+    /**
+     * Add new project to config
+     *
+     * @param project - Project context
+     */
+    addProject(project: ProjectContext): Promise<void>;
+    /**
+     * Remove project from config
+     *
+     * @param projectId - Project identifier
+     */
+    removeProject(projectId: string): Promise<void>;
+    /**
+     * Clear cached project (force reload)
+     */
+    clearCache(): void;
+    private createProjectREADME;
+    private createModulesREADME;
+    private createTeamREADME;
+    private createArchitectureREADME;
+    private createLegacyREADME;
+}
+//# sourceMappingURL=project-manager.d.ts.map

package/dist/src/core/project-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manager.d.ts","sourceRoot":"","sources":["../../../src/core/project-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAA+B;gBAExC,WAAW,EAAE,MAAM;IAK/B;;;;;OAKG;IACH,gBAAgB,IAAI,cAAc;IAyClC;;;;OAIG;IACH,cAAc,IAAI,cAAc,EAAE;IAmBlC;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAKxD;;;;;OAKG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAaxC;;;;;OAKG;IACH,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAa1C;;;;;OAKG;IACH,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAavC;;;;;;OAMG;IACH,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAatD;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAc1D;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD;;;;;OAKG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9D;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCxD;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrD;;OAEG;IACH,UAAU,IAAI,IAAI;YAMJ,mBAAmB;YAyDnB,mBAAmB;YAgEnB,gBAAgB;YAmEhB,wBAAwB;YAwDxB,kBAAkB;CAuCjC"}