specweave 0.10.0 → 0.11.0

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.6.1",
+  "version": "0.11.0",
   "description": "SpecWeave - Spec-Driven Development Framework. PM-led planning, intelligent model selection, living documentation, multi-tool support.",
   "owner": {
     "name": "Anton Abyzov",
@@ -12,7 +12,7 @@
       "description": "SpecWeave framework - increment lifecycle, living docs, PM-led planning",
       "source": "./plugins/specweave",
       "category": "development",
-      "version": "0.6.1",
+      "version": "0.11.0",
       "author": {
         "name": "Anton Abyzov",
         "email": "anton@spec-weave.com"

package/CLAUDE.md

@@ -681,10 +681,10 @@ my-project/
 - ✅ Strategy docs are project-level, not module-level
 - ✅ Living docs sync works best with one central location
 
-**Plugin Detection**:
-- ✅ Four-phase detection assumes one `.specweave/` folder
-- ✅ Auto-detection scans from root only
-- ✅ No ambiguity about where plugins are enabled
+**Plugin Installation**:
+- ✅ ALL plugins installed automatically during `specweave init`
+- ✅ No selective loading or detection needed
+- ✅ Full capabilities available immediately
 
 **Prevents Chaos**:
 - ❌ Nested folders cause: Which is the source of truth?
@@ -842,7 +842,7 @@ if (parentSpecweave) {
 - Domain expertise (ML, payments) = separate plugins
 - Core plugin = only increment lifecycle + living docs automation
 
-### Available Plugins (Opt-In)
+### Available Plugins (All Auto-Installed)
 
 **Implemented Plugins**:
 
@@ -891,20 +891,22 @@ if (parentSpecweave) {
 | **jira-sync** | 1 | 1 | 2 | JIRA project tracking |
 | **ado-sync** | 1 | 1 | 2 | Azure DevOps tracking |
 
-### Context Efficiency Examples
+### Context Efficiency
 
-**Before** - Monolithic approach:
-- Simple React app: Loads ALL 44 skills + 20 agents ≈ **50K tokens**
-- Backend API: Loads ALL 44 skills + 20 agents ≈ **50K tokens**
-- ML pipeline: Loads ALL 44 skills + 20 agents ≈ **50K tokens**
+**All plugins are installed, but only relevant skills activate based on context**. Claude Code's native skill system ensures:
+- Skills only activate when their description keywords match the conversation
+- Agents only load when explicitly invoked
+- Commands only appear when relevant
 
-**After** - Modular plugin architecture:
-- Simple React app: Core + frontend-stack + github ≈ **16K tokens** (68% reduction!)
-- Backend API: Core + nodejs-backend + github ≈ **15K tokens** (70% reduction!)
-- ML pipeline: Core + ml-ops + github ≈ **18K tokens** (64% reduction!)
-- SpecWeave itself: Core + github + diagrams ≈ **15K tokens** (70% reduction!)
+**Example**: Working on a React frontend:
+- ✅ `specweave-frontend` skills activate (React, Next.js, design systems)
+- ✅ `specweave-github` skills activate (if mentioning GitHub)
+- ❌ `specweave-ml` skills stay dormant (ML keywords not detected)
+- ❌ `specweave-payments` skills stay dormant (Stripe not mentioned)
 
-### How Plugins Are Loaded (Intelligent Auto-Loading)
+**Result**: Even with 19+ plugins installed, you only "pay" (in tokens) for what you're actively using in the conversation.
+
+### How Plugins Are Loaded (All Plugins Installed Upfront)
 
 **SpecWeave's plugin system is designed to be intelligent and non-intrusive:**
 
@@ -932,81 +934,43 @@ When you run `specweave init`:
    - Claude Code automatically discovers plugins from GitHub
    - No manual `/plugin marketplace add` needed!
 
-2. ✅ **Core Plugin Auto-Installation**
-   - Automatically runs: `claude plugin marketplace add` and `claude plugin install specweave`
+2. ✅ **ALL Plugins Auto-Installation** (Breaking Change: No Selective Loading!)
+   - Automatically installs ALL 19+ plugins from marketplace.json
    - Works via CLI during init (uses user's shell to access `claude` command)
-   - Slash commands available IMMEDIATELY - no manual install!
-   - Success message: "✔ SpecWeave core plugin installed automatically!"
+   - Installation process:
+     1. Removes existing marketplace (if present)
+     2. Re-adds marketplace from GitHub (always fresh)
+     3. Reads marketplace.json to get list of all plugins
+     4. Installs each plugin via `claude plugin install {name}`
+     5. Reports success/failure for each plugin
+   - All slash commands available IMMEDIATELY - no manual install needed!
+   - Success message: "✔ Installed: 19/19 plugins"
    - Graceful fallback: If CLI unavailable, shows manual install instructions
-
-3. ✅ **Issue Tracker Plugin Auto-Installation** (NEW! v0.8.18+)
-   - Detects GitHub/Jira/Azure DevOps from project structure
-   - Prompts for credentials (API tokens, PATs)
-   - **Automatically installs** corresponding plugin (specweave-github, specweave-jira, specweave-ado)
-   - Happens AFTER marketplace registration (ensures plugin installation succeeds)
-   - Shows detailed error messages if auto-install fails
-   - Example: Jira detected → credentials saved → `specweave-jira` plugin installed automatically
-
-4. ℹ️  **Optional Plugins Available**
-   - Suggested based on project type (frontend, backend, infrastructure)
-   - User can install later via `/plugin install specweave-{name}`
+   - **No selective loading**: Everything installed upfront for full capabilities
 
 **Key Architectural Change**:
 - ❌ Old: Copied `.claude-plugin/` + `plugins/` to every project (~2MB bloat)
 - ✅ New: Reference GitHub marketplace (~2KB settings.json, always up-to-date)
 
-#### Phase 2: Increment Planning (Intelligent Plugin Detection)
-
-When you create increments (e.g., `/specweave:increment "Add Stripe billing"`):
-
-1. **Spec Analysis** (v0.6.0+, Enhanced v0.8.18+)
-   - increment-planner skill scans spec.md content
-   - Detects keywords: "Stripe", "GitHub", "Kubernetes", "React", etc.
-   - Maps keywords → required plugins (see Step 6 in increment-planner/SKILL.md)
-
-2. **🚨 AUTOMATIC Plugin Recommendation** (Enhanced v0.8.18+)
-   ```
-   🔌 Detected plugin requirements from spec content:
-
-   REQUIRED (will significantly improve implementation):
-   • specweave-payments - Stripe integration
-     Detected: "billing", "Stripe", "subscriptions"
-     Provides: Stripe expert agent, payment flow validation, webhook handling
-     → Without this: Manual Stripe integration, no validation
+#### Phase 2: Implementation (All Plugins Ready)
 
-   📦 Install recommended plugins:
-     /plugin install specweave-payments
-
-   💡 Benefits:
-     • Plugins provide specialized AI agents (Stripe expert, etc.)
-     • Skills auto-activate based on context (zero manual invocation)
-     • 70%+ context reduction (only load what you need)
-     • Best practices built-in (from real-world experience)
-
-   Would you like me to wait while you install these plugins? (Recommended)
-   Or shall I continue without them? (Limited capabilities)
-   ```
-
-3. **User Decision**
-   - Install now → Plugin activates immediately (skills available during implementation)
-   - Install later → Skills won't be available until plugin installed (can add mid-work)
-   - Skip → Increment creation continues (not blocked, but capabilities limited)
-
-#### Phase 3: Implementation (Auto-Activation)
-
-When plugins are installed:
+After `specweave init`, ALL plugins are already installed. No additional steps needed!
 
 1. **Skills Auto-Activate**
    - Based on description keywords (Claude Code native behavior)
    - No manual invocation needed
    - Example: Mention "GitHub" → github-sync skill activates
 
-2. **Context Efficiency**
-   - Only loaded plugins consume tokens
-   - 70%+ reduction vs. monolithic approach
-   - Real-time: Simple React app = 16K tokens (was 50K in v0.3.7)
+2. **All Capabilities Available**
+   - GitHub integration: `/specweave-github:sync`
+   - JIRA integration: `/specweave-jira:sync`
+   - Documentation preview: `/specweave:docs preview`
+   - Frontend tools: React, Next.js, design systems
+   - Backend tools: Node.js, Python, .NET
+   - Infrastructure: Kubernetes, Helm, monitoring
+   - ...and 19+ more plugins ready to use!
 
-#### Phase 4: First Increment Completion (Documentation Preview)
+#### Phase 3: First Increment Completion (Documentation Preview)
 
 After completing your first increment:
 
@@ -1043,29 +1007,27 @@ After completing your first increment:
    - Mermaid diagrams rendered automatically
    - Share docs with stakeholders (export static site)
 
-### Manual Plugin Management
+### Plugin Management
 
-All plugin management happens through Claude Code's native commands:
+**All 19+ plugins are automatically installed during `specweave init`**. You rarely need to manage plugins manually, but Claude Code's native commands are available if needed:
 
 ```bash
-# List installed plugins
+# List installed plugins (should show all 19+ SpecWeave plugins)
 /plugin list --installed
 
-# Install a specific plugin
-/plugin install specweave-kubernetes
-
-# Uninstall a plugin
+# Uninstall a plugin (not recommended - breaks functionality)
 /plugin uninstall specweave-kubernetes
 
-# List all available plugins from marketplace
-/plugin list specweave
+# Reinstall all plugins (if you uninstalled something by mistake)
+specweave init .  # Re-runs full installation
 ```
 
 **Key Insight**: SpecWeave uses **ONLY** Claude Code's native plugin system:
+- ALL plugins installed automatically during init (no manual selection)
 - Plugins install globally via `/plugin install specweave-{name}`
 - Work across ALL projects (like VS Code extensions)
 - Auto-activate based on skills' description keywords
-- Managed by Claude Code (updates, uninstall, etc.)
+- Managed by Claude Code (updates handled via `specweave init` re-run)
 
 ### Development vs Production Setup
 
@@ -2076,10 +2038,10 @@ ls -1 .specweave/increments/ | grep -E '^[0-9]{4}' | wc -l
 
 ```
 SpecWeave = Collection of Claude Code Plugins
-├── specweave (auto-loaded) ← The "framework" IS a plugin
-├── specweave-github (opt-in)
-├── specweave-figma (opt-in)
-└── ...all other plugins (opt-in)
+├── specweave (auto-installed) ← The "framework" IS a plugin
+├── specweave-github (auto-installed)
+├── specweave-figma (auto-installed)
+└── ...all 19+ plugins (auto-installed)
 ```
 
 **What this means**:
@@ -2106,7 +2068,7 @@ SpecWeave = Collection of Claude Code Plugins
 **Discovery**:
 - Browse all plugins: `ls plugins/` or check [.claude-plugin/marketplace.json](/.claude-plugin/marketplace.json)
 - Live catalog: See `.claude-plugin/README.md` for current marketplace contents
-- Auto-detection during `specweave init` suggests relevant plugins
+- **All plugins automatically installed** during `specweave init` (no manual selection needed)
 
 **Plugin Structure** (all follow same pattern):
 ```
@@ -2118,8 +2080,8 @@ plugins/specweave-{name}/
 └── lib/                        # TypeScript utilities (optional)
 ```
 
-**Key Plugins** (for reference):
-- `specweave` - Framework essentials (always loaded)
+**Key Plugins** (for reference - all auto-installed):
+- `specweave` - Framework essentials
 - `specweave-github` - GitHub Issues integration
 - `specweave-{frontend|backend|infrastructure}` - Tech stack plugins
 

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6qBf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA+tBf"}

package/dist/cli/commands/init.js

@@ -441,7 +441,35 @@ export async function initCommand(projectName, options = {}) {
                 enableDocsPreview = response.enableDocsPreview;
                 if (enableDocsPreview) {
                     console.log(chalk.green('   ✔ Documentation preview enabled'));
-                    console.log(chalk.gray('   → Preview with: /specweave:docs preview'));
+                    // 🚨 CRITICAL FIX: Actually install the docs-preview plugin!
+                    // User said Yes → Install plugin immediately (like issue tracker setup)
+                    if (detectClaudeCli()) {
+                        console.log(chalk.gray('   → Installing specweave-docs-preview plugin...'));
+                        try {
+                            const result = execFileNoThrowSync('claude', [
+                                'plugin',
+                                'install',
+                                'specweave-docs-preview' // NO @marketplace suffix
+                            ]);
+                            if (result.success) {
+                                console.log(chalk.green('   ✔ specweave-docs-preview plugin installed'));
+                                console.log(chalk.gray('   → Preview with: /specweave:docs preview'));
+                            }
+                            else {
+                                console.log(chalk.yellow('   ⚠️  Plugin install failed (can install later)'));
+                                console.log(chalk.gray('   → Try manually: /plugin install specweave-docs-preview'));
+                            }
+                        }
+                        catch (error) {
+                            console.log(chalk.yellow('   ⚠️  Plugin install failed (can install later)'));
+                            console.log(chalk.gray('   → Try manually: /plugin install specweave-docs-preview'));
+                        }
+                    }
+                    else {
+                        console.log(chalk.gray('   → Preview with: /specweave:docs preview'));
+                        console.log(chalk.yellow('   ⚠️  Claude CLI not detected - install plugin manually:'));
+                        console.log(chalk.gray('   → /plugin install specweave-docs-preview'));
+                    }
                 }
                 else {
                     console.log(chalk.gray('   → Skipped (can enable later in .specweave/config.json)'));
@@ -468,7 +496,7 @@ export async function initCommand(projectName, options = {}) {
                 // Non-critical - show manual instructions in next steps
                 console.warn(chalk.yellow(`\n${locale.t('cli', 'init.warnings.pluginAutoSetupFailed')}`));
             }
-            // 15. AUTO-INSTALL CORE PLUGIN via Claude CLI (Secure + Cross-Platform)
+            // 15. AUTO-INSTALL ALL PLUGINS via Claude CLI (Breaking Change: No selective loading)
             // Pre-flight check: Is Claude CLI available? (ROBUST CHECK)
             const claudeStatus = detectClaudeCli();
             if (!claudeStatus.available) {
@@ -528,12 +556,10 @@ export async function initCommand(projectName, options = {}) {
                 autoInstallSucceeded = false;
             }
             else {
-                // Claude CLI available → attempt secure auto-install
+                // Claude CLI available → install ALL plugins from marketplace
                 try {
-                    spinner.start('Installing SpecWeave core plugin...');
-                    // Step 1: PROACTIVE marketplace management - check if exists, remove if needed, then re-add
-                    // ✅ This runs REGARDLESS of whether project has local .claude-plugin/
-                    // ✅ Uses SpecWeave package's .claude-plugin folder as marketplace source
+                    // Step 1: FORCE marketplace refresh - remove and re-add from GitHub
+                    spinner.start('Refreshing SpecWeave marketplace...');
                     const listResult = execFileNoThrowSync('claude', [
                         'plugin',
                         'marketplace',
@@ -542,60 +568,89 @@ export async function initCommand(projectName, options = {}) {
                     const marketplaceExists = listResult.success &&
                         (listResult.stdout || '').toLowerCase().includes('specweave');
                     if (marketplaceExists) {
-                        // Marketplace exists - remove it first (prevents "already installed" error)
-                        spinner.stop();
-                        console.log(chalk.blue('   🔄 Updating existing SpecWeave marketplace...'));
+                        // Always remove existing marketplace to ensure fresh install
                         execFileNoThrowSync('claude', [
                             'plugin',
                             'marketplace',
                             'remove',
                             'specweave'
                         ]);
-                        console.log(chalk.green('   ✔ Old marketplace removed'));
+                        console.log(chalk.blue('   🔄 Removed existing marketplace'));
                     }
-                    // Step 1.5: Add marketplace from GitHub
-                    // ✅ Uses GitHub repo format (owner/repo) - works for all npm installs
+                    // Add marketplace from GitHub (always fresh)
                     const addResult = execFileNoThrowSync('claude', [
                         'plugin',
                         'marketplace',
                         'add',
                         'anton-abyzov/specweave'
                     ]);
-                    if (addResult.success) {
-                        if (marketplaceExists) {
-                            console.log(chalk.green('   ✔ Marketplace updated successfully'));
-                        }
+                    if (!addResult.success) {
+                        throw new Error('Failed to add marketplace from GitHub');
                     }
-                    else {
-                        console.log(chalk.yellow('   ⚠️  Marketplace add via CLI failed, will use settings.json fallback'));
+                    console.log(chalk.green('   ✔ Marketplace registered from GitHub'));
+                    spinner.succeed('SpecWeave marketplace refreshed');
+                    // Step 2: Load marketplace.json to get ALL available plugins
+                    spinner.start('Loading available plugins...');
+                    const marketplaceJsonPath = findSourceDir('.claude-plugin/marketplace.json');
+                    if (!fs.existsSync(marketplaceJsonPath)) {
+                        throw new Error('marketplace.json not found - cannot determine plugins to install');
                     }
-                    spinner.start('Installing SpecWeave core plugin...');
-                    // Step 2: Install core plugin
-                    // ✅ SECURE: No string interpolation, no shell, cross-platform
-                    const installResult = execFileNoThrowSync('claude', [
-                        'plugin',
-                        'install',
-                        'specweave'
-                    ]);
-                    if (installResult.success) {
-                        autoInstallSucceeded = true;
-                        spinner.succeed('SpecWeave plugin installed successfully!');
-                        console.log(chalk.green('   ✔ Marketplace: ./claude-plugin → specweave'));
-                        console.log(chalk.green('   ✔ Plugin: specweave'));
-                        console.log(chalk.green('   ✔ Slash commands ready: /specweave:increment'));
+                    const marketplace = JSON.parse(fs.readFileSync(marketplaceJsonPath, 'utf-8'));
+                    const allPlugins = marketplace.plugins || [];
+                    if (allPlugins.length === 0) {
+                        throw new Error('No plugins found in marketplace.json');
                     }
-                    else {
-                        throw new Error(installResult.stderr || installResult.stdout || 'Installation failed');
+                    console.log(chalk.blue(`   📦 Found ${allPlugins.length} plugins to install`));
+                    spinner.succeed(`Found ${allPlugins.length} plugins`);
+                    // Step 3: Install ALL plugins (no selective loading!)
+                    let successCount = 0;
+                    let failCount = 0;
+                    const failedPlugins = [];
+                    for (const plugin of allPlugins) {
+                        const pluginName = plugin.name;
+                        spinner.start(`Installing ${pluginName}...`);
+                        const installResult = execFileNoThrowSync('claude', [
+                            'plugin',
+                            'install',
+                            pluginName
+                        ]);
+                        if (installResult.success) {
+                            successCount++;
+                            spinner.succeed(`${pluginName} installed`);
+                        }
+                        else {
+                            failCount++;
+                            failedPlugins.push(pluginName);
+                            spinner.warn(`${pluginName} failed (will continue)`);
+                        }
+                    }
+                    // Step 4: Report results
+                    console.log('');
+                    console.log(chalk.green.bold(`✅ Plugin Installation Complete`));
+                    console.log(chalk.white(`   Installed: ${successCount}/${allPlugins.length} plugins`));
+                    if (failCount > 0) {
+                        console.log(chalk.yellow(`   Failed: ${failCount} plugins`));
+                        console.log(chalk.gray(`   Failed plugins: ${failedPlugins.join(', ')}`));
+                        console.log(chalk.gray(`   → You can install these manually later`));
                     }
+                    console.log('');
+                    console.log(chalk.cyan('📋 Available capabilities:'));
+                    console.log(chalk.gray('   • /specweave:increment - Plan new features'));
+                    console.log(chalk.gray('   • /specweave:do - Execute tasks'));
+                    console.log(chalk.gray('   • /specweave-github:sync - GitHub integration'));
+                    console.log(chalk.gray('   • /specweave-jira:sync - JIRA integration'));
+                    console.log(chalk.gray('   • /specweave:docs preview - Documentation preview'));
+                    console.log(chalk.gray('   • ...and more!'));
+                    autoInstallSucceeded = successCount > 0;
                 }
                 catch (error) {
                     // Installation failed - provide helpful diagnostics
-                    spinner.warn('Could not auto-install core plugin');
+                    spinner.warn('Could not auto-install plugins');
                     console.log('');
                     // Diagnose error and provide actionable hints
                     if (error.message.includes('not found') || error.message.includes('ENOENT')) {
                         console.log(chalk.yellow('   Reason: Claude CLI found but command failed'));
-                        console.log(chalk.gray('   → Try manually: claude plugin install specweave'));
+                        console.log(chalk.gray('   → Try manually: /plugin install specweave'));
                     }
                     else if (error.message.includes('EACCES') || error.message.includes('permission')) {
                         console.log(chalk.yellow('   Reason: Permission denied'));
@@ -611,28 +666,12 @@ export async function initCommand(projectName, options = {}) {
                     console.log('');
                     console.log(chalk.cyan('📦 Manual installation:'));
                     console.log(chalk.white('   /plugin install specweave'));
+                    console.log(chalk.white('   /plugin install specweave-github'));
+                    console.log(chalk.white('   ...etc.'));
                     console.log('');
                     autoInstallSucceeded = false;
                 }
             }
-            // 10.5 Issue Tracker Integration (NEW!)
-            // CRITICAL: Must happen AFTER marketplace registration and core plugin install
-            // Otherwise plugin installation will fail (marketplace not found)
-            try {
-                const { setupIssueTracker } = await import('../helpers/issue-tracker/index.js');
-                await setupIssueTracker({
-                    projectPath: targetDir,
-                    language: language,
-                    maxRetries: 3
-                });
-            }
-            catch (error) {
-                // Non-critical error - log but continue
-                if (process.env.DEBUG) {
-                    console.error(chalk.red(`\n❌ Issue tracker setup error: ${error.message}`));
-                }
-                console.log(chalk.yellow('\n⚠️  Issue tracker setup skipped (can configure later)'));
-            }
         }
         showNextSteps(finalProjectName, toolName, language, usedDotNotation, toolName === 'claude' ? autoInstallSucceeded : undefined);
     }
@@ -1180,10 +1219,10 @@ function showNextSteps(projectName, adapterName, language, usedDotNotation = fal
             console.log('');
             stepNumber++;
         }
-        console.log(`   ${stepNumber}. ${chalk.white(locale.t('cli', 'init.nextSteps.claude.step3'))}`);
-        console.log(`      ${chalk.gray(locale.t('cli', 'init.nextSteps.claude.installGitHub'))}`);
-        console.log(`      ${chalk.gray(locale.t('cli', 'init.nextSteps.claude.installFrontend'))}`);
-        console.log(`      ${chalk.gray('...or let SpecWeave suggest plugins automatically')}`);
+        console.log(`   ${stepNumber}. ${chalk.white('All plugins are already installed!')}`);
+        console.log(`      ${chalk.gray('✔ All 19+ SpecWeave plugins installed automatically')}`);
+        console.log(`      ${chalk.gray('✔ No need to install additional plugins manually')}`);
+        console.log(`      ${chalk.gray('✔ Full capabilities available immediately')}`);
         console.log('');
         stepNumber++;
         console.log(`   ${stepNumber}. ${chalk.white(locale.t('cli', 'init.nextSteps.claude.step4'))}`);