specweave 1.0.226 → 1.0.227

package/CLAUDE.md

@@ -1,4 +1,4 @@
-<!-- SW:META template="claude" version="1.0.225" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
+<!-- SW:META template="claude" version="1.0.226" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
 
 <!-- SW:SECTION:hook-priority version="1.0.171" -->
 ## ⛔ Hook Instructions Override Everything
@@ -13,7 +13,7 @@
 **SKILL FIRST ≠ only one skill.** Chain: hook skill → `sw-frontend:*` / `sw-backend:*` / etc → implement.
 <!-- SW:END:hook-priority -->
 
-<!-- SW:SECTION:header version="1.0.225" -->
+<!-- SW:SECTION:header version="1.0.226" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
@@ -123,7 +123,7 @@ claude plugin install sw@specweave --scope project  # Team-shared
 
 SpecWeave auto-installs: LSP → project scope, sw-* → user scope.
 
-<!-- SW:SECTION:start version="1.0.225" -->
+<!-- SW:SECTION:start version="1.0.226" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -133,7 +133,7 @@ SpecWeave auto-installs: LSP → project scope, sw-* → user scope.
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.225" -->
+<!-- SW:SECTION:autodetect version="1.0.226" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -143,7 +143,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
 <!-- SW:END:autodetect -->
 
-<!-- SW:SECTION:metarule version="1.0.225" -->
+<!-- SW:SECTION:metarule version="1.0.226" -->
 ## Workflow Orchestration
 
 ### 1. Plan Mode Default
@@ -170,7 +170,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.225" -->
+<!-- SW:SECTION:rules version="1.0.226" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (see Structure section for details)
@@ -189,7 +189,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
    Use next available number. **NEVER create duplicate prefixes.**
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.225" -->
+<!-- SW:SECTION:workflow version="1.0.226" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -235,7 +235,7 @@ project/
 **NEVER assume single-repo mode without scanning first!**
 <!-- SW:END:save-nested-repos -->
 
-<!-- SW:SECTION:reflect version="1.0.225" -->
+<!-- SW:SECTION:reflect version="1.0.226" -->
 ## Skill Memories
 
 SpecWeave learns from corrections. Learnings saved here automatically. Edit or delete as needed.
@@ -258,7 +258,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 - **2026-02-04**: Prefer leaderboard-style reporting when analyzing usage patterns or identifying deletion candidates
 - **2026-02-04**: Auto command must have explicit stop conditions (passing tests, increment completion, quality gates) and log/display output visibly to user in terminal
 
-<!-- SW:SECTION:context version="1.0.225" -->
+<!-- SW:SECTION:context version="1.0.226" -->
 ## Context
 
 **Before implementing**: Check ADRs at `.specweave/docs/internal/architecture/adr/`
@@ -266,7 +266,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 **Load context**: `/sw:context <topic>` loads relevant living docs into conversation
 <!-- SW:END:context -->
 
-<!-- SW:SECTION:structure version="1.0.225" -->
+<!-- SW:SECTION:structure version="1.0.226" -->
 ## Structure
 
 ```
@@ -281,7 +281,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 **Everything else → subfolders**: `reports/` | `logs/` | `scripts/` | `backups/`
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.225" -->
+<!-- SW:SECTION:taskformat version="1.0.226" -->
 ## Task Format
 
 ```markdown
@@ -291,7 +291,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.225" -->
+<!-- SW:SECTION:secrets version="1.0.226" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -305,7 +305,7 @@ gh auth status
 **SECURITY**: NEVER use `grep TOKEN .env` without `-q` flag - it exposes credentials in terminal!
 <!-- SW:END:secrets -->
 
-<!-- SW:SECTION:syncing version="1.0.225" -->
+<!-- SW:SECTION:syncing version="1.0.226" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **Commands**: `/sw-github:sync {id}` (issues) | `/sw:sync-specs` (living docs only)
@@ -315,7 +315,7 @@ gh auth status
 **Config**: Set `sync.github.enabled: true` + `canUpdateExternalItems: true` in config.json
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:testing version="1.0.225" -->
+<!-- SW:SECTION:testing version="1.0.226" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -327,7 +327,7 @@ vi.mock('./module', () => ({ func: mockFn }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:tdd version="1.0.225" -->
+<!-- SW:SECTION:tdd version="1.0.226" -->
 ## TDD Mode (Test-Driven Development)
 
 **When `testing.defaultTestMode: "TDD"` is configured**, follow RED-GREEN-REFACTOR discipline:
@@ -388,7 +388,7 @@ When TDD is enabled, tasks include phase markers:
 **Rule**: Complete dependencies BEFORE dependent tasks (RED before GREEN).
 <!-- SW:END:tdd -->
 
-<!-- SW:SECTION:api version="1.0.225" -->
+<!-- SW:SECTION:api version="1.0.226" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** Commands: `/sw:api-docs --all` | `--openapi` | `--postman` | `--validate`
@@ -396,13 +396,13 @@ When TDD is enabled, tasks include phase markers:
 Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.225" -->
+<!-- SW:SECTION:limits version="1.0.226" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.225" -->
+<!-- SW:SECTION:troubleshooting version="1.0.226" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -415,7 +415,7 @@ Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
 | Session stuck | Kill + `rm -f .specweave/state/*.lock` + restart |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:lazyloading version="1.0.225" -->
+<!-- SW:SECTION:lazyloading version="1.0.226" -->
 ## Plugin Auto-Loading
 
 Plugins load automatically based on project type and keywords. Manual install if needed:
@@ -429,7 +429,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1         # Disable auto-load
 **Token savings**: Core ~3-5K tokens vs all plugins ~60K+
 <!-- SW:END:lazyloading -->
 
-<!-- SW:SECTION:principles version="1.0.225" -->
+<!-- SW:SECTION:principles version="1.0.226" -->
 ## Principles
 
 ### SpecWeave Principles
@@ -445,7 +445,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1         # Disable auto-load
 - **Demand Elegance**: For non-trivial changes, pause and ask "is there a more elegant way?" - but skip this for simple, obvious fixes (don't over-engineer).
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.225" -->
+<!-- SW:SECTION:linking version="1.0.226" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -453,7 +453,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
 Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
 <!-- SW:END:linking -->
 
-<!-- SW:SECTION:mcp version="1.0.225" -->
+<!-- SW:SECTION:mcp version="1.0.226" -->
 ## External Services
 
 **Priority**: CLI tools first (simpler) → MCP for complex integrations
@@ -475,7 +475,7 @@ claude mcp add --transport stdio postgres -- npx -y @modelcontextprotocol/server
 MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:auto version="1.0.225" -->
+<!-- SW:SECTION:auto version="1.0.226" -->
 ## Auto Mode
 
 **Commands**: `/sw:auto` (start) | `/sw:auto-status` (check) | `/sw:cancel-auto` (emergency only)
@@ -492,7 +492,7 @@ MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
 **STOP & ASK** if: Spec conflicts | Task unnecessary | Requirement ambiguous
 <!-- SW:END:auto -->
 
-<!-- SW:SECTION:docs version="1.0.225" -->
+<!-- SW:SECTION:docs version="1.0.226" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com)

package/bin/specweave.js

@@ -701,6 +701,26 @@ program
     await cacheCommand(options);
   });
 
+// Analytics command - Usage analytics dashboard
+program
+  .command('analytics')
+  .description('Show usage analytics dashboard (commands, skills, agents)')
+  .option('--export <format>', 'Export data (json, csv)')
+  .option('--since <time>', 'Filter by time range (24h, 7d, 30d)')
+  .option('--type <type>', 'Filter by event type (command, skill, agent)')
+  .option('--json', 'Output raw JSON for scripting')
+  .option('--limit <n>', 'Number of top items to show', '10')
+  .action(async (options) => {
+    const { analyticsCommand } = await import('../dist/src/cli/commands/analytics.js');
+    await analyticsCommand({
+      export: options.export,
+      since: options.since,
+      type: options.type,
+      json: options.json,
+      limit: options.limit ? parseInt(options.limit, 10) : undefined,
+    });
+  });
+
 // LSP command - Code intelligence operations
 const lspCmd = program
   .command('lsp')

package/dist/src/cli/commands/analytics.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Analytics CLI Command
+ *
+ * Shows usage analytics dashboard - command invocations, skill activations, agent spawns.
+ * Supports filtering by time range, type, and export to JSON/CSV.
+ */
+import { AnalyticsSummary, AnalyticsEventType } from '../../core/analytics/index.js';
+export interface AnalyticsCommandOptions {
+    projectRoot?: string;
+    export?: 'json' | 'csv';
+    since?: string;
+    type?: AnalyticsEventType;
+    json?: boolean;
+    limit?: number;
+}
+export interface AnalyticsCommandResult {
+    totalEvents: number;
+    topCommands: Array<{
+        name: string;
+        count: number;
+    }>;
+    topSkills: Array<{
+        name: string;
+        count: number;
+    }>;
+    topAgents: Array<{
+        name: string;
+        count: number;
+    }>;
+    successRate: number;
+    exported?: boolean;
+    format?: string;
+    filename?: string;
+    jsonOutput?: boolean;
+    data?: AnalyticsSummary;
+}
+/**
+ * Analytics CLI command handler
+ */
+export declare function analyticsCommand(options?: AnalyticsCommandOptions): Promise<AnalyticsCommandResult>;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/src/cli/commands/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AA6ED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAqEjC"}

package/dist/src/cli/commands/analytics.js

@@ -0,0 +1,131 @@
+/**
+ * Analytics CLI Command
+ *
+ * Shows usage analytics dashboard - command invocations, skill activations, agent spawns.
+ * Supports filtering by time range, type, and export to JSON/CSV.
+ */
+import { AnalyticsCollector, AnalyticsAggregator, } from '../../core/analytics/index.js';
+/**
+ * Parse time filter string (e.g., "24h", "7d", "30d") to ISO date
+ */
+function parseSinceFilter(since) {
+    const now = new Date();
+    const match = since.match(/^(\d+)([hdwm])$/);
+    if (!match) {
+        throw new Error(`Invalid time format: ${since}. Use formats like 24h, 7d, 30d`);
+    }
+    const [, amount, unit] = match;
+    const value = parseInt(amount, 10);
+    switch (unit) {
+        case 'h':
+            now.setHours(now.getHours() - value);
+            break;
+        case 'd':
+            now.setDate(now.getDate() - value);
+            break;
+        case 'w':
+            now.setDate(now.getDate() - value * 7);
+            break;
+        case 'm':
+            now.setMonth(now.getMonth() - value);
+            break;
+    }
+    return now.toISOString();
+}
+/**
+ * Format summary for console display
+ */
+function displaySummary(summary) {
+    console.log('\n📊 SpecWeave Analytics Dashboard\n');
+    console.log(`Period: ${summary.since.split('T')[0]} → ${summary.until.split('T')[0]}`);
+    console.log(`Total Events: ${summary.totalEvents}`);
+    console.log(`Success Rate: ${summary.successRate}%\n`);
+    if (summary.topCommands.length > 0) {
+        console.log('🔧 Top Commands:');
+        for (const cmd of summary.topCommands.slice(0, 5)) {
+            console.log(`   ${cmd.count.toString().padStart(4)} │ ${cmd.name}`);
+        }
+        console.log('');
+    }
+    if (summary.topSkills.length > 0) {
+        console.log('⚡ Top Skills:');
+        for (const skill of summary.topSkills.slice(0, 5)) {
+            console.log(`   ${skill.count.toString().padStart(4)} │ ${skill.name}`);
+        }
+        console.log('');
+    }
+    if (summary.topAgents.length > 0) {
+        console.log('🤖 Top Agents:');
+        for (const agent of summary.topAgents.slice(0, 5)) {
+            console.log(`   ${agent.count.toString().padStart(4)} │ ${agent.name}`);
+        }
+        console.log('');
+    }
+    if (summary.dailySummaries.length > 0) {
+        console.log('📅 Daily Activity (last 7 days):');
+        for (const day of summary.dailySummaries.slice(-7)) {
+            const bar = '█'.repeat(Math.min(day.totalEvents, 20));
+            console.log(`   ${day.date} │ ${bar} (${day.totalEvents})`);
+        }
+        console.log('');
+    }
+}
+/**
+ * Analytics CLI command handler
+ */
+export async function analyticsCommand(options = {}) {
+    const projectRoot = options.projectRoot || process.cwd();
+    const limit = options.limit ?? 10;
+    // Initialize collector and aggregator
+    AnalyticsCollector.getInstance(projectRoot);
+    const aggregator = new AnalyticsAggregator(projectRoot);
+    // Build query options
+    const queryOptions = { limit };
+    if (options.since) {
+        queryOptions.since = parseSinceFilter(options.since);
+    }
+    if (options.type) {
+        queryOptions.type = options.type;
+    }
+    // Get summary
+    const summary = aggregator.getSummary(queryOptions);
+    // Handle export
+    if (options.export) {
+        const exported = aggregator.export(options.export, queryOptions);
+        console.log(`Exported to: ${exported.filename}`);
+        console.log(exported.content);
+        return {
+            totalEvents: summary.totalEvents,
+            topCommands: summary.topCommands,
+            topSkills: summary.topSkills,
+            topAgents: summary.topAgents,
+            successRate: summary.successRate,
+            exported: true,
+            format: options.export,
+            filename: exported.filename,
+        };
+    }
+    // Handle JSON output
+    if (options.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return {
+            totalEvents: summary.totalEvents,
+            topCommands: summary.topCommands,
+            topSkills: summary.topSkills,
+            topAgents: summary.topAgents,
+            successRate: summary.successRate,
+            jsonOutput: true,
+            data: summary,
+        };
+    }
+    // Display formatted summary
+    displaySummary(summary);
+    return {
+        totalEvents: summary.totalEvents,
+        topCommands: summary.topCommands,
+        topSkills: summary.topSkills,
+        topAgents: summary.topAgents,
+        successRate: summary.successRate,
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/src/cli/commands/analytics.js.map

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

package/dist/src/core/lsp/cache/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * LSP Cache Module
+ *
+ * Exports symbol caching functionality with mtime-based invalidation.
+ */
+export { SymbolCache, type SymbolLocation, type FileSystemAdapter, } from './symbol-cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/lsp/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/lsp/cache/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/src/core/lsp/cache/index.js

@@ -0,0 +1,7 @@
+/**
+ * LSP Cache Module
+ *
+ * Exports symbol caching functionality with mtime-based invalidation.
+ */
+export { SymbolCache, } from './symbol-cache.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/lsp/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/lsp/cache/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,GAGZ,MAAM,mBAAmB,CAAC"}

package/dist/src/core/lsp/config/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * LSP Configuration Module
+ *
+ * Exports all configuration-related classes and interfaces.
+ */
+export { parseLspConfig, DEFAULT_TIMEOUT, DEFAULT_WARMUP_TIMEOUT, type LspConfig, } from './lsp-config.js';
+export { TimeoutResolver } from './timeout-resolver.js';
+export { LanguageAnalyzer, type LanguageScore } from './language-analyzer.js';
+export { ProjectDetector, type ProjectInfo, type UnknownProjectResult, } from './project-detector.js';
+export { ServerRegistry, type ServerConfig, type RegistryConfig, } from './server-registry.js';
+export { ServerValidator, type TrustStore, type BinaryChecker, type ValidationResult, type WarnCallback, } from './server-validator.js';
+export { LspPrompt, MAX_SERVERS, type LspSuggestion, type PromptResult, type PromptAdapter, } from './lsp-prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/lsp/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/lsp/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,SAAS,EACT,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/src/core/lsp/config/index.js

@@ -0,0 +1,20 @@
+/**
+ * LSP Configuration Module
+ *
+ * Exports all configuration-related classes and interfaces.
+ */
+// Config parsing
+export { parseLspConfig, DEFAULT_TIMEOUT, DEFAULT_WARMUP_TIMEOUT, } from './lsp-config.js';
+// Timeout resolution
+export { TimeoutResolver } from './timeout-resolver.js';
+// Language analysis
+export { LanguageAnalyzer } from './language-analyzer.js';
+// Project detection
+export { ProjectDetector, } from './project-detector.js';
+// Server registry
+export { ServerRegistry, } from './server-registry.js';
+// Server validation
+export { ServerValidator, } from './server-validator.js';
+// Interactive prompt
+export { LspPrompt, MAX_SERVERS, } from './lsp-prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/lsp/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/lsp/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AACjB,OAAO,EACL,cAAc,EACd,eAAe,EACf,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,wBAAwB,CAAC;AAE9E,oBAAoB;AACpB,OAAO,EACL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAE/B,kBAAkB;AAClB,OAAO,EACL,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,OAAO,EACL,eAAe,GAKhB,MAAM,uBAAuB,CAAC;AAE/B,qBAAqB;AACrB,OAAO,EACL,SAAS,EACT,WAAW,GAIZ,MAAM,iBAAiB,CAAC"}

package/dist/src/core/lsp/config/lsp-prompt.d.ts

@@ -0,0 +1,66 @@
+/**
+ * LspPrompt - Interactive LSP server suggestion prompt
+ *
+ * @see spec.md US-003: Language-Aware Warm-up Strategies
+ * @satisfies AC-US3-03, AC-US3-04, AC-US3-05
+ */
+/**
+ * Maximum number of LSP servers to enable
+ */
+export declare const MAX_SERVERS = 3;
+/**
+ * LSP server suggestion from analyzer
+ */
+export interface LspSuggestion {
+    /** Language identifier */
+    language: string;
+    /** Server name */
+    server: string;
+    /** Score from analyzer (0-100) */
+    score: number;
+    /** Whether server is installed */
+    installed?: boolean;
+    /** Command to install the server */
+    installCommand?: string;
+}
+/**
+ * Result of prompt interaction
+ */
+export interface PromptResult {
+    /** Selected/enabled languages */
+    enabled: string[];
+    /** Install commands for missing servers (keyed by language) */
+    installCommands?: Record<string, string>;
+}
+/**
+ * Prompt adapter interface for testing
+ */
+export interface PromptAdapter {
+    prompt(config: {
+        message: string;
+        choices: Array<{
+            name: string;
+            value: string;
+        }>;
+        maxSelections?: number;
+    }): Promise<string[]>;
+}
+/**
+ * Interactive prompt for LSP server suggestions
+ */
+export declare class LspPrompt {
+    private readonly promptAdapter;
+    constructor(promptAdapter: PromptAdapter);
+    /**
+     * Show suggestions and prompt user for selection
+     *
+     * @param suggestions - LSP suggestions from analyzer
+     * @returns Promise resolving to prompt result
+     */
+    show(suggestions: LspSuggestion[]): Promise<PromptResult>;
+    /**
+     * Format a choice for display
+     */
+    private formatChoice;
+}
+//# sourceMappingURL=lsp-prompt.d.ts.map

package/dist/src/core/lsp/config/lsp-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/lsp/config/lsp-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,MAAM,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChD,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,aAAa,EAAE,aAAa;IAIxC;;;;;OAKG;IACG,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IA8B/D;;OAEG;IACH,OAAO,CAAC,YAAY;CAIrB"}

package/dist/src/core/lsp/config/lsp-prompt.js

@@ -0,0 +1,57 @@
+/**
+ * LspPrompt - Interactive LSP server suggestion prompt
+ *
+ * @see spec.md US-003: Language-Aware Warm-up Strategies
+ * @satisfies AC-US3-03, AC-US3-04, AC-US3-05
+ */
+/**
+ * Maximum number of LSP servers to enable
+ */
+export const MAX_SERVERS = 3;
+/**
+ * Interactive prompt for LSP server suggestions
+ */
+export class LspPrompt {
+    constructor(promptAdapter) {
+        this.promptAdapter = promptAdapter;
+    }
+    /**
+     * Show suggestions and prompt user for selection
+     *
+     * @param suggestions - LSP suggestions from analyzer
+     * @returns Promise resolving to prompt result
+     */
+    async show(suggestions) {
+        const choices = suggestions.map((s) => ({
+            name: this.formatChoice(s),
+            value: s.language,
+        }));
+        const selected = await this.promptAdapter.prompt({
+            message: 'Select LSP servers to enable (max 3):',
+            choices,
+            maxSelections: MAX_SERVERS,
+        });
+        // Limit to max servers
+        const enabled = selected.slice(0, MAX_SERVERS);
+        // Collect install commands for selected missing servers
+        const installCommands = {};
+        for (const lang of enabled) {
+            const suggestion = suggestions.find((s) => s.language === lang);
+            if (suggestion && !suggestion.installed && suggestion.installCommand) {
+                installCommands[lang] = suggestion.installCommand;
+            }
+        }
+        return {
+            enabled,
+            installCommands: Object.keys(installCommands).length > 0 ? installCommands : undefined,
+        };
+    }
+    /**
+     * Format a choice for display
+     */
+    formatChoice(suggestion) {
+        const installedIndicator = suggestion.installed ? '✓' : '○';
+        return `${installedIndicator} ${suggestion.language} (${suggestion.server}) - score: ${suggestion.score}`;
+    }
+}
+//# sourceMappingURL=lsp-prompt.js.map

package/dist/src/core/lsp/config/lsp-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-prompt.js","sourceRoot":"","sources":["../../../../../src/core/lsp/config/lsp-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAuC7B;;GAEG;AACH,MAAM,OAAO,SAAS;IAGpB,YAAY,aAA4B;QACtC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,WAA4B;QACrC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YAC1B,KAAK,EAAE,CAAC,CAAC,QAAQ;SAClB,CAAC,CAAC,CAAC;QAEJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAC/C,OAAO,EAAE,uCAAuC;YAChD,OAAO;YACP,aAAa,EAAE,WAAW;SAC3B,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAE/C,wDAAwD;QACxD,MAAM,eAAe,GAA2B,EAAE,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;YAChE,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;gBACrE,eAAe,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,cAAc,CAAC;YACpD,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO;YACP,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;SACvF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,UAAyB;QAC5C,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5D,OAAO,GAAG,kBAAkB,IAAI,UAAU,CAAC,QAAQ,KAAK,UAAU,CAAC,MAAM,cAAc,UAAU,CAAC,KAAK,EAAE,CAAC;IAC5G,CAAC;CACF"}

package/dist/src/core/lsp/diagnostics/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * LSP Diagnostics Module
+ *
+ * Exports diagnostic tools like progress tracking and the doctor command.
+ */
+export { LspProgress, type ProgressCallback } from './progress.js';
+export { LspDoctor, type DoctorResult, type ServerChecker, } from './doctor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/lsp/diagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/lsp/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}

package/dist/src/core/lsp/diagnostics/index.js

@@ -0,0 +1,8 @@
+/**
+ * LSP Diagnostics Module
+ *
+ * Exports diagnostic tools like progress tracking and the doctor command.
+ */
+export { LspProgress } from './progress.js';
+export { LspDoctor, } from './doctor.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/lsp/diagnostics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/lsp/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,SAAS,GAGV,MAAM,aAAa,CAAC"}