specweave 0.23.18 → 0.24.0

package/.claude-plugin/marketplace.json

@@ -18,17 +18,6 @@
         "email": "anton.abyzov@gmail.com"
       }
     },
-    {
-      "name": "specweave-plugin-dev",
-      "description": "Plugin development guide - Create custom Claude Code plugins, skills, agents, hooks, and MCP servers. Essential for SpecWeave contributors and plugin developers.",
-      "source": "./plugins/specweave-plugin-dev",
-      "category": "development-tools",
-      "version": "1.0.0",
-      "author": {
-        "name": "Anton Abyzov",
-        "email": "anton.abyzov@gmail.com"
-      }
-    },
     {
       "name": "specweave-github",
       "description": "GitHub integration - bidirectional sync, issue tracking, task management",
@@ -63,9 +52,9 @@
       }
     },
     {
-      "name": "specweave-kubernetes",
-      "description": "Kubernetes deployment - K8s manifests, Helm charts, GitOps",
-      "source": "./plugins/specweave-kubernetes",
+      "name": "specweave-infrastructure",
+      "description": "Cloud infrastructure - Hetzner, Prometheus, Grafana, monitoring",
+      "source": "./plugins/specweave-infrastructure",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -74,9 +63,9 @@
       }
     },
     {
-      "name": "specweave-infrastructure",
-      "description": "Cloud infrastructure - Hetzner, Prometheus, Grafana, monitoring",
-      "source": "./plugins/specweave-infrastructure",
+      "name": "specweave-ml",
+      "description": "Machine learning - ML pipelines, training, deployment",
+      "source": "./plugins/specweave-ml",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -85,9 +74,20 @@
       }
     },
     {
-      "name": "specweave-backend",
-      "description": "Backend development - Node.js, Python, .NET, REST APIs",
-      "source": "./plugins/specweave-backend",
+      "name": "specweave-docs-preview",
+      "description": "Interactive documentation preview - Launch Docusaurus dev server with hot reload, auto-generated sidebar, Mermaid diagrams. Build static sites for deployment.",
+      "source": "./plugins/specweave-docs-preview",
+      "category": "productivity",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton.abyzov@gmail.com"
+      }
+    },
+    {
+      "name": "specweave-release",
+      "description": "Release management - version alignment, RC workflows, multi-repo coordination, semantic versioning",
+      "source": "./plugins/specweave-release",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -96,9 +96,9 @@
       }
     },
     {
-      "name": "specweave-payments",
-      "description": "Payment processing - Stripe, PayPal, billing, PCI compliance",
-      "source": "./plugins/specweave-payments",
+      "name": "specweave-kafka",
+      "description": "Apache Kafka event streaming integration with MCP servers, CLI tools (kcat), Terraform modules, and comprehensive observability stack",
+      "source": "./plugins/specweave-kafka",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -107,9 +107,9 @@
       }
     },
     {
-      "name": "specweave-ml",
-      "description": "Machine learning - ML pipelines, training, deployment",
-      "source": "./plugins/specweave-ml",
+      "name": "specweave-kafka-streams",
+      "description": "Kafka Streams library integration - Stream processing with Java/Kotlin, topology design, state stores, windowing, joins, exactly-once semantics",
+      "source": "./plugins/specweave-kafka-streams",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -118,9 +118,42 @@
       }
     },
     {
-      "name": "specweave-docs-preview",
-      "description": "Interactive documentation preview - Launch Docusaurus dev server with hot reload, auto-generated sidebar, Mermaid diagrams. Build static sites for deployment.",
-      "source": "./plugins/specweave-docs-preview",
+      "name": "specweave-n8n",
+      "description": "n8n workflow automation with Kafka integration - Event-driven workflows, Kafka triggers, producers, no-code/low-code event processing patterns",
+      "source": "./plugins/specweave-n8n",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton.abyzov@gmail.com"
+      }
+    },
+    {
+      "name": "specweave-frontend",
+      "description": "Frontend development - React, Next.js, component generation, design systems, UI scaffolding",
+      "source": "./plugins/specweave-frontend",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton.abyzov@gmail.com"
+      }
+    },
+    {
+      "name": "specweave-testing",
+      "description": "Testing framework - E2E with Playwright, unit testing, test coverage, test generation",
+      "source": "./plugins/specweave-testing",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton.abyzov@gmail.com"
+      }
+    },
+    {
+      "name": "specweave-figma",
+      "description": "Figma integration - Design import, component sync, design-to-code workflows",
+      "source": "./plugins/specweave-figma",
       "category": "productivity",
       "version": "1.0.0",
       "author": {
@@ -128,9 +161,20 @@
         "email": "anton.abyzov@gmail.com"
       }
     },
+    {
+      "name": "specweave-tooling",
+      "description": "Development tooling - Skill creation, plugin scaffolding, development utilities",
+      "source": "./plugins/specweave-tooling",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton.abyzov@gmail.com"
+      }
+    },
     {
       "name": "specweave-diagrams",
-      "description": "Architecture diagrams - Mermaid, C4 Model, sequence, ER diagrams",
+      "description": "Architecture diagram generation - Mermaid, C4 Model, sequence diagrams, ER diagrams, deployment diagrams",
       "source": "./plugins/specweave-diagrams",
       "category": "development",
       "version": "1.0.0",
@@ -140,9 +184,9 @@
       }
     },
     {
-      "name": "specweave-release",
-      "description": "Release management - version alignment, RC workflows, multi-repo coordination, semantic versioning",
-      "source": "./plugins/specweave-release",
+      "name": "specweave-ui",
+      "description": "Browser automation and UI tools - Element inspection, automated testing, Playwright integration",
+      "source": "./plugins/specweave-ui",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -151,10 +195,10 @@
       }
     },
     {
-      "name": "specweave-mobile",
-      "description": "React Native & Expo mobile development - environment setup, debugging, performance optimization, native modules, testing, Metro bundler configuration",
-      "source": "./plugins/specweave-mobile",
-      "category": "development",
+      "name": "specweave-docs",
+      "description": "Documentation generation and management - Docusaurus, spec-driven docs, API documentation, living documentation",
+      "source": "./plugins/specweave-docs",
+      "category": "productivity",
       "version": "1.0.0",
       "author": {
         "name": "Anton Abyzov",
@@ -162,9 +206,9 @@
       }
     },
     {
-      "name": "specweave-kafka",
-      "description": "Apache Kafka event streaming integration with MCP servers, CLI tools (kcat), Terraform modules, and comprehensive observability stack",
-      "source": "./plugins/specweave-kafka",
+      "name": "specweave-alternatives",
+      "description": "Technology stack alternatives analysis using BMAD method - Best, Most Appropriate, Design decisions for architecture choices",
+      "source": "./plugins/specweave-alternatives",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -173,9 +217,9 @@
       }
     },
     {
-      "name": "specweave-confluent",
-      "description": "Confluent Cloud integration - Schema Registry, ksqlDB, Kafka Connect, Flink, stream processing, and enterprise Kafka features",
-      "source": "./plugins/specweave-confluent",
+      "name": "specweave-cost-optimizer",
+      "description": "Cloud cost optimization - AWS, GCP, Azure cost analysis, right-sizing, reserved instances, savings plans",
+      "source": "./plugins/specweave-cost-optimizer",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -184,9 +228,9 @@
       }
     },
     {
-      "name": "specweave-kafka-streams",
-      "description": "Kafka Streams library integration - Stream processing with Java/Kotlin, topology design, state stores, windowing, joins, exactly-once semantics",
-      "source": "./plugins/specweave-kafka-streams",
+      "name": "specweave-core",
+      "description": "Core utility commands - Code analysis, refactoring, debugging, performance profiling, dependency management",
+      "source": "./plugins/specweave-core",
       "category": "development",
       "version": "1.0.0",
       "author": {
@@ -195,9 +239,9 @@
       }
     },
     {
-      "name": "specweave-n8n",
-      "description": "n8n workflow automation with Kafka integration - Event-driven workflows, Kafka triggers, producers, no-code/low-code event processing patterns",
-      "source": "./plugins/specweave-n8n",
+      "name": "specweave-plugin-dev",
+      "description": "Plugin development tools - Create, validate, and scaffold SpecWeave plugins, skills, commands, and agents",
+      "source": "./plugins/specweave-plugin-dev",
       "category": "development",
       "version": "1.0.0",
       "author": {

package/CLAUDE.md

@@ -51,7 +51,84 @@ git push origin develop
 **Testing Unpushed Changes:**
 - **Option 1**: Temp branch → push → test → delete
 - **Option 2**: Fork-based (`claude plugin marketplace add github:YOUR_USERNAME/specweave`)
-- **Option 3**: Symlink (Unix-only, see `.specweave/docs/internal/advanced/symlink-dev-mode.md`)
+
+---
+
+### 1a. Quick Marketplace Refresh (NEW! 🚀)
+
+**Problem**: After implementing new plugins locally, Claude Code needs to reload the marketplace.
+
+**Solution**: Use the automated refresh script!
+
+```bash
+# LOCAL DEVELOPMENT (default) - Uses your local changes
+bash scripts/refresh-marketplace.sh
+
+# FROM GITHUB - Pulls latest from GitHub
+bash scripts/refresh-marketplace.sh --github
+```
+
+**What it does**:
+1. ✅ Removes existing marketplace
+2. ✅ Clears all plugin caches
+3. ✅ Re-adds marketplace (local or GitHub)
+4. ✅ Installs ALL plugins automatically
+5. ✅ Shows success/failure summary
+
+**Output Example**:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  SpecWeave Marketplace Refresh (local mode)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📦 Step 1: Removing existing marketplace...
+✓ Marketplace removed
+
+🧹 Step 2: Clearing plugin caches...
+✓ Marketplace cache cleared
+✓ Installed plugins cache backed up
+
+📥 Step 3: Adding marketplace...
+Using local development version: /Users/antonabyzov/Projects/github/specweave
+✓ Local marketplace added
+
+📋 Step 4: Reading plugin list...
+✓ Found 19 plugins
+
+⚙️  Step 5: Installing all plugins...
+  Installing specweave...
+  ✓ specweave installed
+
+  [... all 19 plugins ...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Installation Summary
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Total plugins: 19
+  Successful: 19
+  Failed: 0
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ✓ ALL PLUGINS INSTALLED SUCCESSFULLY!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Next steps:
+  1. Restart Claude Code for changes to take effect
+  2. Run /plugin to verify all plugins loaded
+  3. Check ~/.claude/plugins/installed_plugins.json
+```
+
+**When to use**:
+- ✅ After adding new plugins
+- ✅ After modifying plugin commands/agents/skills
+- ✅ After pulling latest from GitHub
+- ✅ When plugins aren't loading correctly
+- ✅ To test local changes before pushing
+
+**Time**: ~30 seconds (vs 5-10 minutes manual)
+
+**Requirements**: `jq` installed (`brew install jq`)
 
 ---
 
@@ -149,6 +226,61 @@ grep -c "^- \[x\] \*\*AC-" spec.md                            # Must equal total
 
 ---
 
+### 7a. AC Presence in spec.md (MANDATORY - v0.24.0+) ⚠️
+
+**CRITICAL RULE**: spec.md MUST contain inline Acceptance Criteria, even when using `structure: user-stories` with external living docs.
+
+**Why**: The AC sync hook (`post-task-completion.sh`) requires ACs in spec.md to function. Without inline ACs, you get 0% AC completion and broken status line.
+
+**Architecture** (ADR-0064):
+```
+spec.md = SOURCE OF TRUTH for ACs
+living docs = DOCUMENTATION LAYER (optional, provides rich context)
+```
+
+**Validation Gates**:
+1. `/specweave:do` (pre-start hook) - **BLOCKS** if ACs missing
+2. `/specweave:validate` - **ERRORS** if ACs missing
+3. `/specweave:increment` - **AUTO-EMBEDS** ACs during creation
+
+**Required Format**:
+```markdown
+## Acceptance Criteria
+
+<!-- Auto-synced from living docs -->
+
+### US-001: User Story Title
+
+- [ ] **AC-US1-01**: Criterion description
+- [ ] **AC-US1-02**: Criterion description
+```
+
+**If ACs are missing**:
+```bash
+# Manual fix: Auto-embed ACs from living docs
+/specweave:embed-acs 0050
+
+# Or add ACs manually to spec.md
+Edit("spec.md", "...", "...\n\n## Acceptance Criteria\n\n...")
+```
+
+**Common mistake**: Generating "pointer-only" spec.md that just references living docs without embedding ACs.
+
+**Incident** (2025-11-22, Increment 0050):
+- spec.md had 0 inline ACs (only references to living docs)
+- tasks.md referenced 39 ACs (AC-US1-01, AC-US4-01, etc.)
+- AC sync hook failed: 38 warnings, 0% completion
+- Fix: `/specweave:embed-acs 0050` → auto-embedded 39 ACs → 100% completion
+
+**Prevention**:
+- Pre-start hook validates AC presence before allowing work to start
+- Spec generators auto-embed ACs when `structure: user-stories` is used
+- Validation command checks AC count matches metadata.json
+
+**See**: ADR-0064, `src/utils/ac-embedder.ts`, `src/core/validators/ac-presence-validator.ts`
+
+---
+
 ### 8. Logger Abstraction (NEVER `console.*`)
 
 **Rule**: ALL `src/` code uses logger injection, NEVER `console.log/error/warn`
@@ -611,10 +743,11 @@ npm run rebuild
 **Local setup**:
 ```bash
 git clone https://github.com/YOUR_USERNAME/specweave.git
-cd specweave && npm install
-mkdir -p ~/.claude/plugins/marketplaces
-ln -s "$(pwd)" ~/.claude/plugins/marketplaces/specweave
+cd specweave && npm install && npm run rebuild
 bash scripts/install-git-hooks.sh
+
+# Push changes to GitHub → Claude Code auto-updates marketplace (5-10s)
+# For fork-based testing: claude plugin marketplace add github:YOUR_USERNAME/specweave
 ```
 
 ---

package/dist/src/cli/helpers/ado-area-path-mapper.d.ts

@@ -0,0 +1,89 @@
+/**
+ * ADO Area Path Mapper
+ *
+ * Maps SpecWeave increments to Azure DevOps area paths for hierarchical organization.
+ * Supports granularity selection (Project-level, Team-level, Area-Path-level).
+ *
+ * @module cli/helpers/ado-area-path-mapper
+ */
+export type AreaPathGranularity = 'project' | 'team' | 'area-path';
+export interface AreaPathMapping {
+    incrementId: string;
+    project: string;
+    team?: string;
+    areaPath?: string;
+    granularity: AreaPathGranularity;
+}
+export interface AreaPathMapperOptions {
+    organization: string;
+    project: string;
+    availableTeams?: string[];
+    availableAreaPaths?: string[];
+}
+/**
+ * Prompt user to select area path granularity
+ *
+ * Granularity levels:
+ * - project: Map to project only (simplest)
+ * - team: Map to project + team
+ * - area-path: Map to project + team + specific area path (most granular)
+ *
+ * @param options - Mapper options
+ * @returns Selected granularity
+ */
+export declare function promptAreaPathGranularity(options: AreaPathMapperOptions): Promise<AreaPathGranularity>;
+/**
+ * Prompt user to select team (for team-level or area-path-level granularity)
+ *
+ * @param options - Mapper options
+ * @returns Selected team name
+ */
+export declare function promptTeamSelection(options: AreaPathMapperOptions): Promise<string | undefined>;
+/**
+ * Prompt user to select area path (for area-path-level granularity)
+ *
+ * @param options - Mapper options
+ * @param team - Selected team
+ * @returns Selected area path
+ */
+export declare function promptAreaPathSelection(options: AreaPathMapperOptions, team?: string): Promise<string | undefined>;
+/**
+ * Create area path mapping for an increment
+ *
+ * Interactive flow:
+ * 1. Select granularity level
+ * 2. Select team (if team-level or area-path-level)
+ * 3. Select area path (if area-path-level)
+ *
+ * @param incrementId - Increment ID
+ * @param options - Mapper options
+ * @returns Area path mapping
+ */
+export declare function createAreaPathMapping(incrementId: string, options: AreaPathMapperOptions): Promise<AreaPathMapping>;
+/**
+ * Format area path for ADO API
+ *
+ * Converts mapping to ADO-compatible area path format:
+ * - project: "ProjectName"
+ * - team: "ProjectName\\TeamName"
+ * - area-path: "ProjectName\\TeamName\\AreaPath"
+ *
+ * @param mapping - Area path mapping
+ * @returns Formatted area path string
+ */
+export declare function formatAreaPath(mapping: AreaPathMapping): string;
+/**
+ * Validate area path exists in ADO
+ *
+ * Makes API call to verify area path is valid before creating work item.
+ *
+ * @param areaPath - Formatted area path
+ * @param credentials - ADO credentials
+ * @returns true if valid, false otherwise
+ */
+export declare function validateAreaPath(areaPath: string, credentials: {
+    organization: string;
+    pat: string;
+    project: string;
+}): Promise<boolean>;
+//# sourceMappingURL=ado-area-path-mapper.d.ts.map

package/dist/src/cli/helpers/ado-area-path-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-area-path-mapper.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/ado-area-path-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA4B9B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,qBAAqB,EAC9B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA8B7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA6C1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAY/D;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClE,OAAO,CAAC,OAAO,CAAC,CAuBlB"}