specweave 1.0.126 → 1.0.129

package/CLAUDE.md

@@ -1,10 +1,10 @@
-<!-- SW:META template="claude" version="1.0.125" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,lazyloading,principles,linking,mcp,autoexecute,auto,docs" -->
+<!-- SW:META template="claude" version="1.0.126" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,lazyloading,principles,linking,mcp,autoexecute,auto,docs" -->
 
-<!-- SW:SECTION:header version="1.0.125" -->
+<!-- SW:SECTION:header version="1.0.126" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
-<!-- SW:SECTION:start version="1.0.125" -->
+<!-- SW:SECTION:start version="1.0.126" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -14,7 +14,7 @@
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.125" -->
+<!-- SW:SECTION:autodetect version="1.0.126" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -24,7 +24,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.125" -->
+<!-- SW:SECTION:metarule version="1.0.126" -->
 ## Meta-Rule: Think-Before-Act
 
 **Satisfy dependencies BEFORE dependent operations.**
@@ -35,7 +35,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.125" -->
+<!-- SW:SECTION:rules version="1.0.126" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (spec.md, plan.md, tasks.md at root; reports/, scripts/, logs/ subfolders)
@@ -48,7 +48,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 8. **⛔ Marketplace refresh**: ALWAYS use `specweave refresh-marketplace` CLI command. NEVER suggest `scripts/refresh-marketplace.sh` - end users don't have the scripts folder (npm global install).
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.125" -->
+<!-- SW:SECTION:workflow version="1.0.126" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -68,7 +68,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Natural language**: "Let's build X" → `/sw:increment` | "What's status?" → `/sw:progress` | "We're done" → `/sw:done` | "Ship while sleeping" → `/sw:auto`
 <!-- SW:END:workflow -->
 
-<!-- SW:SECTION:reflect version="1.0.125" -->
+<!-- SW:SECTION:reflect version="1.0.126" -->
 ## Self-Improving Skills (Reflect)
 
 **Learn once, never repeat.** Claude learns from corrections and patterns across sessions.
@@ -112,7 +112,7 @@ ls ~/.specweave/memory/*.md 2>/dev/null
 **Enable auto-learning**: `/sw:reflect-on` → Stop hook analyzes sessions automatically
 <!-- SW:END:reflect -->
 
-<!-- SW:SECTION:context version="1.0.125" -->
+<!-- SW:SECTION:context version="1.0.126" -->
 ## Living Docs Context
 
 **Before implementing features**: Check existing docs for patterns and decisions.
@@ -132,7 +132,7 @@ grep -ril "keyword" .specweave/docs/internal/
 **Use `/sw:context <topic>`** to load relevant living docs into conversation.
 <!-- SW:END:context -->
 
-<!-- SW:SECTION:lsp version="1.0.125" -->
+<!-- SW:SECTION:lsp version="1.0.126" -->
 ## LSP-Enhanced Exploration
 
 **USE LSP ACTIVELY** for semantic code understanding (100x faster than grep).
@@ -149,7 +149,7 @@ go install golang.org/x/tools/gopls@latest  # Go
 **Best Practices**: ALWAYS use `findReferences` before refactoring | Use `goToDefinition` instead of grep | Combine with Explore agent
 <!-- SW:END:lsp -->
 
-<!-- SW:SECTION:structure version="1.0.125" -->
+<!-- SW:SECTION:structure version="1.0.126" -->
 ## Structure
 
 ```
@@ -219,7 +219,7 @@ my-project/
 ```
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.125" -->
+<!-- SW:SECTION:taskformat version="1.0.126" -->
 ## Task Format
 
 ```markdown
@@ -229,7 +229,7 @@ my-project/
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.125" -->
+<!-- SW:SECTION:secrets version="1.0.126" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -243,7 +243,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.125" -->
+<!-- SW:SECTION:syncing version="1.0.126" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **After increment creation**: Run `/sw-github:sync {id}` to create issues!
@@ -271,7 +271,7 @@ Living docs sync ≠ External sync. They are separate:
 **Verify tokens**: `grep -q GITHUB_TOKEN .env && echo "Token configured"` | `gh auth status`
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:mapping version="1.0.125" -->
+<!-- SW:SECTION:mapping version="1.0.126" -->
 ## GitHub Mapping
 
 | SpecWeave | GitHub |
@@ -281,7 +281,7 @@ Living docs sync ≠ External sync. They are separate:
 | Task T-XXX | Checkbox |
 <!-- SW:END:mapping -->
 
-<!-- SW:SECTION:testing version="1.0.125" -->
+<!-- SW:SECTION:testing version="1.0.126" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -293,7 +293,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:api version="1.0.125" -->
+<!-- SW:SECTION:api version="1.0.126" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** OpenAPI = source of truth → Postman derived from it.
@@ -312,13 +312,13 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 **Import**: Postman → Import collection + env → Fill secrets → Select env
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.125" -->
+<!-- SW:SECTION:limits version="1.0.126" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.125" -->
+<!-- SW:SECTION:troubleshooting version="1.0.126" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -340,7 +340,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 | Need all plugins loaded | `specweave load-plugins all` (~60K tokens) |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:lazyloading version="1.0.125" -->
+<!-- SW:SECTION:lazyloading version="1.0.126" -->
 ## Lazy Plugin Loading
 
 **By default, SpecWeave installs 2 essential plugins** (~3K tokens total):
@@ -386,7 +386,7 @@ specweave init --full .          # Install all plugins immediately
 ```
 <!-- SW:END:lazyloading -->
 
-<!-- SW:SECTION:principles version="1.0.125" -->
+<!-- SW:SECTION:principles version="1.0.126" -->
 ## Principles
 
 1. **Spec-first**: `/sw:increment` before coding
@@ -396,7 +396,7 @@ specweave init --full .          # Install all plugins immediately
 5. **Clean**: All files in increment folders
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.125" -->
+<!-- SW:SECTION:linking version="1.0.126" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -404,7 +404,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.125" -->
+<!-- SW:SECTION:mcp version="1.0.126" -->
 ## External Service Connection
 
 **Priority**: MCP Server → REST API → CLI → Direct Connection
@@ -429,7 +429,7 @@ wrangler whoami 2>/dev/null
 ```
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:autoexecute version="1.0.125" -->
+<!-- SW:SECTION:autoexecute version="1.0.126" -->
 ## Auto-Execute Rule
 
 **NEVER** output "Manual Step Required" when credentials exist. **EXECUTE DIRECTLY.**
@@ -444,7 +444,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 ```
 <!-- SW:END:autoexecute -->
 
-<!-- SW:SECTION:auto version="1.0.125" -->
+<!-- SW:SECTION:auto version="1.0.126" -->
 ## Auto Mode (Autonomous Execution)
 
 **Continuous execution until all tasks complete.**
@@ -521,7 +521,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 **Circuit Breaker**: External API fails 3x? Queue & continue
 <!-- SW:END:auto -->
 
-<!-- SW:SECTION:docs version="1.0.125" -->
+<!-- SW:SECTION:docs version="1.0.126" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com) | `.specweave/docs/internal/`

package/bin/specweave.js

@@ -850,6 +850,7 @@ const loadPluginsCmd = program
   .option('-f, --force', 'Force reinstall even if already loaded')
   .option('-b, --background', 'Run installation in background')
   .option('-v, --verbose', 'Show detailed output')
+  .option('-s, --silent', 'Silent mode - no stdout output (for hooks)')
   .option('--list-groups', 'Show available plugin groups')
   .action(async (group, options) => {
     if (options.listGroups) {
@@ -891,6 +892,34 @@ Examples:
   $ specweave load-plugins ml --background # Load ML plugins in background
 `);
 
+// Detect intent command - Hook helper for automatic plugin loading
+program
+  .command('detect-intent <prompt>')
+  .description('Detect SpecWeave intent from a prompt and optionally install plugins')
+  .option('--install', 'Also install detected plugins after detection')
+  .option('--silent', 'Silent mode - no stdout output (for hooks)')
+  .action(async (prompt, options) => {
+    const { detectIntentCommand } = await import('../dist/src/cli/commands/detect-intent.js');
+    const result = await detectIntentCommand(prompt, options);
+    // Exit code: 0 if plugins detected, 1 if none
+    process.exit(result.detected ? 0 : 1);
+  });
+
+// Detect project command - Analyze project files and suggest plugins
+program
+  .command('detect-project [path]')
+  .description('Detect project type from files and suggest plugins to install')
+  .option('--name <name>', 'Increment name for legacy name-based detection')
+  .option('--description <text>', 'Description for legacy name-based detection')
+  .option('--install', 'Also install detected plugins after detection')
+  .option('--silent', 'Silent mode - no stdout output (for hooks)')
+  .action(async (path, options) => {
+    const { detectProjectCommand } = await import('../dist/src/cli/commands/detect-project.js');
+    const result = await detectProjectCommand(path, options);
+    // Exit code: 0 if types detected, 1 if none
+    process.exit(result.types.length > 0 ? 0 : 1);
+  });
+
 // Unload plugins command - Lazy loading: remove plugin groups from active
 const unloadPluginsCmd = program
   .command('unload-plugins [group]')

package/dist/src/cli/commands/detect-intent.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Detect Intent CLI Command
+ *
+ * Detects SpecWeave intent from a user prompt and optionally installs matching plugins.
+ * Used by hooks for automatic plugin loading on user-prompt-submit.
+ *
+ * Usage:
+ *   specweave detect-intent "prompt text"                    # Returns JSON with detected plugins
+ *   specweave detect-intent "prompt text" --install          # Also installs detected plugins
+ *   specweave detect-intent "prompt text" --install --silent # Silent mode for hooks
+ *
+ * @module cli/commands/detect-intent
+ */
+import { Command } from 'commander';
+export interface DetectIntentOptions {
+    /** Also install detected plugins after detection */
+    install?: boolean;
+    /** Silent mode - no stdout output (for hooks) */
+    silent?: boolean;
+    /** Output format - json or text */
+    json?: boolean;
+    /** Confidence threshold for auto-install (0-1, default 0.6) */
+    threshold?: number;
+}
+export interface DetectIntentResult {
+    /** Whether any plugins were detected */
+    detected: boolean;
+    /** List of detected plugin names to install */
+    plugins: string[];
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Keywords that matched */
+    matchedKeywords: string[];
+    /** Detection latency in milliseconds */
+    latencyMs?: number;
+    /** Whether plugins were installed (when --install used) */
+    installed?: boolean;
+    /** Installation result message (when --install used) */
+    installMessage?: string;
+}
+/**
+ * Detect intent from a user prompt
+ *
+ * @param prompt - User's input prompt to analyze
+ * @param options - Command options
+ * @returns Detection result with plugins to install
+ */
+export declare function detectIntentCommand(prompt: string, options?: DetectIntentOptions): Promise<DetectIntentResult>;
+/**
+ * Create the detect-intent command for Commander
+ */
+export declare function createDetectIntentCommand(): Command;
+/**
+ * Export for direct CLI invocation
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=detect-intent.d.ts.map

package/dist/src/cli/commands/detect-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-intent.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/detect-intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAwF7B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CA6BnD;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgC1C"}

package/dist/src/cli/commands/detect-intent.js

@@ -0,0 +1,169 @@
+/**
+ * Detect Intent CLI Command
+ *
+ * Detects SpecWeave intent from a user prompt and optionally installs matching plugins.
+ * Used by hooks for automatic plugin loading on user-prompt-submit.
+ *
+ * Usage:
+ *   specweave detect-intent "prompt text"                    # Returns JSON with detected plugins
+ *   specweave detect-intent "prompt text" --install          # Also installs detected plugins
+ *   specweave detect-intent "prompt text" --install --silent # Silent mode for hooks
+ *
+ * @module cli/commands/detect-intent
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { detectSpecWeaveIntent } from '../../core/lazy-loading/keyword-detector.js';
+import { PluginCacheManager } from '../../core/lazy-loading/cache-manager.js';
+import { logInfo, logError, logWarn } from '../../core/lazy-loading/failure-logger.js';
+/** Default confidence threshold for auto-install (T-017) */
+const DEFAULT_INSTALL_THRESHOLD = 0.6;
+/**
+ * Detect intent from a user prompt
+ *
+ * @param prompt - User's input prompt to analyze
+ * @param options - Command options
+ * @returns Detection result with plugins to install
+ */
+export async function detectIntentCommand(prompt, options = {}) {
+    const startTime = performance.now();
+    // Run detection
+    const detection = detectSpecWeaveIntent(prompt);
+    // Map matched keywords to plugins
+    const plugins = detection.suggestedPlugins;
+    const result = {
+        detected: detection.detected,
+        plugins,
+        confidence: detection.confidence,
+        matchedKeywords: detection.matchedKeywords,
+        latencyMs: detection.latencyMs,
+    };
+    // Handle installation if requested (T-017: confidence threshold check)
+    const installThreshold = options.threshold ?? DEFAULT_INSTALL_THRESHOLD;
+    if (options.install && plugins.length > 0) {
+        // T-017: Only auto-install if confidence meets threshold
+        if (detection.confidence < installThreshold) {
+            result.installed = false;
+            result.installMessage = `Confidence ${detection.confidence.toFixed(2)} below threshold ${installThreshold} - plugins suggested but not installed`;
+            logWarn('detect-intent', 'Low confidence - skipping install', {
+                confidence: detection.confidence,
+                threshold: installThreshold,
+                plugins,
+                matchedKeywords: detection.matchedKeywords,
+            });
+        }
+        else {
+            try {
+                const cacheManager = new PluginCacheManager();
+                // Filter to only plugins not already loaded
+                const unloadedPlugins = plugins.filter((p) => !cacheManager.isPluginLoaded(p));
+                if (unloadedPlugins.length > 0) {
+                    const installResult = await cacheManager.installPlugins({
+                        plugins: unloadedPlugins,
+                        force: false, // Don't force reinstall
+                    });
+                    result.installed = installResult.success;
+                    result.installMessage = installResult.success
+                        ? `Installed ${installResult.pluginsAffected} plugin(s) in ${Math.round(installResult.durationMs)}ms`
+                        : installResult.error;
+                    logInfo('detect-intent', 'Plugins installed', {
+                        plugins: unloadedPlugins,
+                        success: installResult.success,
+                        durationMs: installResult.durationMs,
+                        confidence: detection.confidence,
+                    });
+                }
+                else {
+                    result.installed = true;
+                    result.installMessage = 'All plugins already loaded';
+                }
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                result.installed = false;
+                result.installMessage = err.message;
+                logError('detect-intent', 'Installation failed', err, {
+                    plugins,
+                    prompt: prompt.substring(0, 100),
+                });
+            }
+        }
+    }
+    // Output result (unless silent mode)
+    if (!options.silent) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    // Log for analytics
+    logInfo('detect-intent', 'Detection complete', {
+        detected: result.detected,
+        plugins: result.plugins,
+        confidence: result.confidence,
+        latencyMs: result.latencyMs,
+        installed: result.installed,
+    });
+    return result;
+}
+/**
+ * Create the detect-intent command for Commander
+ */
+export function createDetectIntentCommand() {
+    const cmd = new Command('detect-intent');
+    cmd
+        .description('Detect SpecWeave intent from a prompt and optionally install plugins')
+        .argument('<prompt>', 'User prompt text to analyze')
+        .option('--install', 'Also install detected plugins after detection')
+        .option('--silent', 'Silent mode - no stdout output (for hooks)')
+        .option('--json', 'Output as JSON (default when not silent)')
+        .option('--threshold <number>', 'Confidence threshold for auto-install (0-1, default 0.6)', parseFloat)
+        .action(async (prompt, options) => {
+        try {
+            const result = await detectIntentCommand(prompt, options);
+            // Exit code: 0 if plugins detected, 1 if none
+            process.exit(result.detected ? 0 : 1);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            if (!options.silent) {
+                console.error(chalk.red(`Error: ${err.message}`));
+            }
+            logError('detect-intent', 'Command failed', err);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+/**
+ * Export for direct CLI invocation
+ */
+export async function main() {
+    const args = process.argv.slice(2);
+    // Parse arguments manually for standalone execution
+    let prompt = '';
+    let install = false;
+    let silent = false;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--install') {
+            install = true;
+        }
+        else if (args[i] === '--silent') {
+            silent = true;
+        }
+        else if (!args[i].startsWith('--')) {
+            prompt = args[i];
+        }
+    }
+    if (!prompt) {
+        if (!silent) {
+            console.error('Usage: specweave detect-intent <prompt> [--install] [--silent]');
+            console.error('');
+            console.error('Examples:');
+            console.error('  specweave detect-intent "release npm version"');
+            console.error('  specweave detect-intent "deploy to kubernetes" --install');
+            console.error('  specweave detect-intent "create react component" --install --silent');
+        }
+        process.exit(1);
+    }
+    const result = await detectIntentCommand(prompt, { install, silent });
+    process.exit(result.detected ? 0 : 1);
+}
+//# sourceMappingURL=detect-intent.js.map

package/dist/src/cli/commands/detect-intent.js.map

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

package/dist/src/cli/commands/detect-project.d.ts

@@ -1,9 +1,54 @@
-#!/usr/bin/env node
 /**
  * Detect Project CLI
  *
- * Detects which project (backend, frontend, mobile, etc.) a feature belongs to
- * based on keywords in the increment name or description.
+ * Two modes of operation:
+ * 1. FILE-BASED (default): Analyzes project files to detect type (React, Express, K8s, etc.)
+ *    and suggests plugins to install.
+ *    Usage: specweave detect-project [path]
+ *
+ * 2. NAME-BASED (legacy): Detects which project config an increment name belongs to.
+ *    Usage: specweave detect-project --name "increment name"
+ *
+ * @module cli/commands/detect-project
+ */
+import { Command } from 'commander';
+export interface DetectProjectOptions {
+    /** Increment name for legacy name-based detection */
+    name?: string;
+    /** Description for legacy name-based detection */
+    description?: string;
+    /** Also install detected plugins after detection */
+    install?: boolean;
+    /** Silent mode - no stdout output (for hooks) */
+    silent?: boolean;
+}
+export interface DetectProjectResult {
+    /** Detection mode used */
+    mode: 'file-based' | 'name-based';
+    /** Detected project types (react, express, etc.) */
+    types: string[];
+    /** Recommended plugins to install */
+    plugins: string[];
+    /** Detection latency in milliseconds */
+    latencyMs?: number;
+    /** Whether plugins were installed (when --install used) */
+    installed?: boolean;
+    /** Installation result message (when --install used) */
+    installMessage?: string;
+    /** Legacy: detected project name from config (name-based mode only) */
+    project?: string;
+    /** Legacy: project display name (name-based mode only) */
+    projectName?: string;
+    /** Legacy: confidence score (name-based mode only) */
+    confidence?: number;
+}
+/**
+ * Main detect-project command handler
+ */
+export declare function detectProjectCommand(pathOrNothing: string | undefined, options?: DetectProjectOptions): Promise<DetectProjectResult>;
+/**
+ * Create the detect-project command for Commander
  */
-export {};
+export declare function createDetectProjectCommand(): Command;
+export { detectProjectCommand as main };
 //# sourceMappingURL=detect-project.d.ts.map

package/dist/src/cli/commands/detect-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect-project.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/detect-project.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}
+{"version":3,"file":"detect-project.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/detect-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;IAClC,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmHD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA2B9B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CA6BpD;AAID,OAAO,EAAE,oBAAoB,IAAI,IAAI,EAAE,CAAC"}