specweave 1.0.461 → 1.0.462

package/plugins/specweave/lib/vendor/utils/execFileNoThrow.js

@@ -0,0 +1,149 @@
+import { execFile, execFileSync } from 'child_process';
+import { promisify } from 'util';
+import { getCleanEnv } from './clean-env.js';
+const execFileAsync = promisify(execFile);
+/**
+ * Safely execute a command without throwing errors
+ *
+ * This utility uses child_process.execFile instead of exec/execSync:
+ * - ✅ Prevents command injection vulnerabilities (no shell interpolation)
+ * - ✅ Cross-platform compatible (Windows, Mac, Linux)
+ * - ✅ Proper error handling (returns result instead of throwing)
+ * - ✅ Structured output (stdout, stderr, exitCode)
+ *
+ * @param command - Command to execute (must be in PATH or absolute path)
+ * @param args - Array of arguments (safely escaped automatically)
+ * @param options - Additional execution options
+ * @returns Promise resolving to execution result
+ *
+ * @example
+ * ```typescript
+ * // ✅ Safe: Arguments automatically escaped
+ * const result = await execFileNoThrow('git', ['add', userProvidedFilename]);
+ * if (result.success) {
+ *   console.log('Git add succeeded:', result.stdout);
+ * } else {
+ *   console.error('Git add failed:', result.stderr);
+ * }
+ *
+ * // ✅ Check if command exists
+ * const which = process.platform === 'win32' ? 'where' : 'which';
+ * const checkResult = await execFileNoThrow(which, ['claude']);
+ * if (checkResult.success) {
+ *   console.log('Claude CLI found at:', checkResult.stdout.trim());
+ * }
+ * ```
+ */
+export async function execFileNoThrow(command, args = [], options = {}) {
+    try {
+        // CRITICAL: On Windows, shell is needed for .cmd/.bat files
+        // Without shell, execFileAsync can't find 'claude.cmd' even if it's in PATH
+        const needsShell = process.platform === 'win32' && options.shell !== false;
+        // CRITICAL: Use clean environment to prevent debugger/instrumentation from breaking child processes
+        // If caller provides custom env, merge with clean env (caller's values take precedence)
+        const cleanEnv = getCleanEnv();
+        const mergedEnv = options.env ? { ...cleanEnv, ...options.env } : cleanEnv;
+        const { stdout, stderr } = await execFileAsync(command, args, {
+            ...options,
+            env: mergedEnv,
+            encoding: 'utf-8',
+            windowsHide: true, // Don't show console window on Windows
+            shell: needsShell,
+        });
+        return {
+            stdout: stdout || '',
+            stderr: stderr || '',
+            exitCode: 0,
+            success: true,
+        };
+    }
+    catch (error) {
+        const execError = error;
+        return {
+            stdout: execError.stdout || '',
+            stderr: execError.stderr || '',
+            exitCode: typeof execError.code === 'number' ? execError.code : 1,
+            success: false,
+            error: execError,
+        };
+    }
+}
+/**
+ * Synchronous version of execFileNoThrow
+ *
+ * Use sparingly - prefer async version when possible.
+ * Useful for initialization code that needs to be synchronous.
+ *
+ * @example
+ * ```typescript
+ * const result = execFileNoThrowSync('claude', ['--version']);
+ * if (result.success) {
+ *   console.log('Claude version:', result.stdout.trim());
+ * }
+ * ```
+ */
+export function execFileNoThrowSync(command, args = [], options = {}) {
+    try {
+        // CRITICAL: On Windows, shell is needed for .cmd/.bat files
+        // Without shell, execFileSync can't find 'claude.cmd' even if it's in PATH
+        const needsShell = process.platform === 'win32' && options.shell !== false;
+        // CRITICAL: Use clean environment to prevent debugger/instrumentation from breaking child processes
+        // If caller provides custom env, merge with clean env (caller's values take precedence)
+        const cleanEnv = getCleanEnv();
+        const mergedEnv = options.env ? { ...cleanEnv, ...options.env } : cleanEnv;
+        const stdout = execFileSync(command, args, {
+            ...options,
+            env: mergedEnv,
+            encoding: 'utf-8',
+            windowsHide: true,
+            shell: needsShell,
+            stdio: ['pipe', 'pipe', 'pipe'], // Capture all streams, don't leak to terminal
+        });
+        return {
+            stdout: stdout || '',
+            stderr: '',
+            exitCode: 0,
+            success: true,
+        };
+    }
+    catch (error) {
+        return {
+            stdout: error.stdout || '',
+            stderr: error.stderr || '',
+            exitCode: typeof error.status === 'number' ? error.status : 1,
+            success: false,
+            error: error,
+        };
+    }
+}
+/**
+ * Check if a command is available in PATH
+ *
+ * Cross-platform helper that uses 'which' (Unix) or 'where' (Windows)
+ *
+ * @param command - Command name to check (e.g., 'claude', 'git', 'node')
+ * @returns Promise resolving to true if command exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isCommandAvailable('claude')) {
+ *   console.log('Claude CLI is installed');
+ * } else {
+ *   console.log('Claude CLI not found - install from https://claude.com/code');
+ * }
+ * ```
+ */
+export async function isCommandAvailable(command) {
+    const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+    const result = await execFileNoThrow(whichCommand, [command]);
+    return result.success;
+}
+/**
+ * Synchronous version of isCommandAvailable
+ */
+export function isCommandAvailableSync(command) {
+    const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+    const result = execFileNoThrowSync(whichCommand, [command]);
+    return result.success;
+}
+//# sourceMappingURL=execFileNoThrow.js.map

package/plugins/specweave/lib/vendor/utils/execFileNoThrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execFileNoThrow.js","sourceRoot":"","sources":["../../../src/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAqB,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAkB1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,OAAiB,EAAE,EACnB,UAMI,EAAE;IAEN,IAAI,CAAC;QACH,4DAA4D;QAC5D,4EAA4E;QAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;QAE3E,oGAAoG;QACpG,wFAAwF;QACxF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE3E,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE;YAC5D,GAAG,OAAO;YACV,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,IAAI,EAAE,uCAAuC;YAC1D,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,KAA0B,CAAC;QAE7C,OAAO;YACL,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,EAAE;YAC9B,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,EAAE;YAC9B,QAAQ,EAAE,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,OAAiB,EAAE,EACnB,UAMI,EAAE;IAEN,IAAI,CAAC;QACH,4DAA4D;QAC5D,2EAA2E;QAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;QAE3E,oGAAoG;QACpG,wFAAwF;QACxF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE3E,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE;YACzC,GAAG,OAAO;YACV,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,8CAA8C;SAChF,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;YAC1B,QAAQ,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7D,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAe;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACtE,MAAM,MAAM,GAAG,mBAAmB,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/plugins/specweave-ado/lib/ado-ac-checkbox-sync.js

@@ -3,7 +3,6 @@ import path from "path";
 import yaml from "yaml";
 import axios from "axios";
 import { consoleLogger } from "../../specweave/lib/vendor/utils/logger.js";
-import { autoDetectProjectIdSync } from "../../specweave/lib/vendor/utils/project-detection.js";
 import { deriveFeatureId } from "../../specweave/lib/vendor/utils/feature-id-derivation.js";
 import { GitHubACCheckboxSync } from "../../specweave-github/lib/github-ac-checkbox-sync.js";
 class AdoACCheckboxSync {
@@ -11,7 +10,6 @@ class AdoACCheckboxSync {
     this.projectRoot = options.projectRoot;
     this.incrementId = options.incrementId;
     this.logger = options.logger ?? consoleLogger;
-    this.projectId = autoDetectProjectIdSync(this.projectRoot) || "default";
   }
   async syncACCheckboxesToAdo(config) {
     const result = { success: true, updated: 0, issues: [] };
@@ -202,12 +200,9 @@ ${acLines}
     const specsRoot = path.join(this.projectRoot, ".specweave/docs/internal/specs");
     const usFiles = [];
     const projectDirs = [];
-    const primary = path.join(specsRoot, this.projectId, featureId);
-    if (existsSync(primary)) projectDirs.push(primary);
     if (existsSync(specsRoot)) {
       try {
         for (const proj of await fs.readdir(specsRoot)) {
-          if (proj === this.projectId) continue;
           const p = path.join(specsRoot, proj, featureId);
           if (existsSync(p)) projectDirs.push(p);
         }

package/plugins/specweave-ado/lib/ado-ac-checkbox-sync.ts

@@ -13,7 +13,6 @@ import path from 'path';
 import yaml from 'yaml';
 import axios, { AxiosInstance } from 'axios';
 import { Logger, consoleLogger } from '../../specweave/lib/vendor/utils/logger.js';
-import { autoDetectProjectIdSync } from '../../specweave/lib/vendor/utils/project-detection.js';
 import { deriveFeatureId } from '../../specweave/lib/vendor/utils/feature-id-derivation.js';
 import { GitHubACCheckboxSync } from '../../specweave-github/lib/github-ac-checkbox-sync.js';
 import type { SpecWeaveConfig } from '../../../src/core/config/types.js';
@@ -28,7 +27,6 @@ export interface AdoACCheckboxSyncResult {
 export class AdoACCheckboxSync {
   private projectRoot: string;
   private incrementId: string;
-  private projectId: string;
   private logger: Logger;
 
   constructor(options: {
@@ -39,7 +37,6 @@ export class AdoACCheckboxSync {
     this.projectRoot = options.projectRoot;
     this.incrementId = options.incrementId;
     this.logger = options.logger ?? consoleLogger;
-    this.projectId = autoDetectProjectIdSync(this.projectRoot) || 'default';
   }
 
   async syncACCheckboxesToAdo(config: SpecWeaveConfig): Promise<AdoACCheckboxSyncResult> {
@@ -271,13 +268,10 @@ ${acLines}
     const usFiles: LivingDocsUSFile[] = [];
     const projectDirs: string[] = [];
 
-    const primary = path.join(specsRoot, this.projectId, featureId);
-    if (existsSync(primary)) projectDirs.push(primary);
-
+    // Search all project directories for the feature
     if (existsSync(specsRoot)) {
       try {
         for (const proj of await fs.readdir(specsRoot)) {
-          if (proj === this.projectId) continue;
           const p = path.join(specsRoot, proj, featureId);
           if (existsSync(p)) projectDirs.push(p);
         }

package/plugins/specweave-github/lib/github-ac-checkbox-sync.js

@@ -3,7 +3,7 @@ import path from "path";
 import yaml from "yaml";
 import { GitHubClientV2 } from "./github-client-v2.js";
 import { consoleLogger } from "../../specweave/lib/vendor/utils/logger.js";
-import { autoDetectProjectIdSync } from "../../specweave/lib/vendor/utils/project-detection.js";
+import { autoDetectProjectIdSync } from "../../../src/utils/project-detection.js";
 import { deriveFeatureId } from "../../specweave/lib/vendor/utils/feature-id-derivation.js";
 import {
   ProviderRouter

package/plugins/specweave-github/lib/github-ac-checkbox-sync.ts

@@ -13,7 +13,7 @@ import path from 'path';
 import yaml from 'yaml';
 import { GitHubClientV2 } from './github-client-v2.js';
 import { Logger, consoleLogger } from '../../specweave/lib/vendor/utils/logger.js';
-import { autoDetectProjectIdSync } from '../../specweave/lib/vendor/utils/project-detection.js';
+import { autoDetectProjectIdSync } from '../../../src/utils/project-detection.js';
 import { deriveFeatureId } from '../../specweave/lib/vendor/utils/feature-id-derivation.js';
 import {
   ProviderRouter,

package/plugins/specweave-github/lib/github-client-v2.js

@@ -1,4 +1,4 @@
-import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
+import { execFileNoThrow } from "../../specweave/lib/vendor/utils/execFileNoThrow.js";
 class GitHubClientV2 {
   /**
    * Create GitHub client from sync profile

package/plugins/specweave-github/lib/github-client-v2.ts

@@ -8,7 +8,7 @@
  * - Secure command execution (no shell injection)
  */
 
-import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+import { execFileNoThrow } from '../../specweave/lib/vendor/utils/execFileNoThrow.js';
 import { GitHubIssue, GitHubMilestone, GitHubExternalChange } from './types';
 import { SyncProfile, GitHubConfig, TimeRangePreset } from '../../../src/core/types/sync-profile';
 

package/plugins/specweave-jira/lib/jira-ac-checkbox-sync.js

@@ -3,7 +3,6 @@ import path from "path";
 import yaml from "yaml";
 import axios from "axios";
 import { consoleLogger } from "../../specweave/lib/vendor/utils/logger.js";
-import { autoDetectProjectIdSync } from "../../specweave/lib/vendor/utils/project-detection.js";
 import { deriveFeatureId } from "../../specweave/lib/vendor/utils/feature-id-derivation.js";
 import { getApiBaseUrl } from "./jira-deployment-detector.js";
 import { GitHubACCheckboxSync } from "../../specweave-github/lib/github-ac-checkbox-sync.js";
@@ -12,7 +11,6 @@ class JiraACCheckboxSync {
     this.projectRoot = options.projectRoot;
     this.incrementId = options.incrementId;
     this.logger = options.logger ?? consoleLogger;
-    this.projectId = autoDetectProjectIdSync(this.projectRoot) || "default";
   }
   async syncACCheckboxesToJira(config) {
     const result = { success: true, updated: 0, issues: [] };
@@ -224,13 +222,9 @@ class JiraACCheckboxSync {
     const specsRoot = path.join(this.projectRoot, ".specweave/docs/internal/specs");
     const usFiles = [];
     const projectDirs = [];
-    const primaryPath = path.join(specsRoot, this.projectId, featureId);
-    if (existsSync(primaryPath)) projectDirs.push(primaryPath);
     if (existsSync(specsRoot)) {
       try {
-        const allProjects = await fs.readdir(specsRoot);
-        for (const proj of allProjects) {
-          if (proj === this.projectId) continue;
+        for (const proj of await fs.readdir(specsRoot)) {
           const p = path.join(specsRoot, proj, featureId);
           if (existsSync(p)) projectDirs.push(p);
         }

package/plugins/specweave-jira/lib/jira-ac-checkbox-sync.ts

@@ -16,7 +16,6 @@ import path from 'path';
 import yaml from 'yaml';
 import axios, { AxiosInstance } from 'axios';
 import { Logger, consoleLogger } from '../../specweave/lib/vendor/utils/logger.js';
-import { autoDetectProjectIdSync } from '../../specweave/lib/vendor/utils/project-detection.js';
 import { deriveFeatureId } from '../../specweave/lib/vendor/utils/feature-id-derivation.js';
 import { detectDeploymentType, getApiBaseUrl } from './jira-deployment-detector.js';
 import type { SpecWeaveConfig } from '../../../src/core/config/types.js';
@@ -32,7 +31,6 @@ export interface JiraACCheckboxSyncResult {
 export class JiraACCheckboxSync {
   private projectRoot: string;
   private incrementId: string;
-  private projectId: string;
   private logger: Logger;
 
   constructor(options: {
@@ -43,7 +41,6 @@ export class JiraACCheckboxSync {
     this.projectRoot = options.projectRoot;
     this.incrementId = options.incrementId;
     this.logger = options.logger ?? consoleLogger;
-    this.projectId = autoDetectProjectIdSync(this.projectRoot) || 'default';
   }
 
   async syncACCheckboxesToJira(config: SpecWeaveConfig): Promise<JiraACCheckboxSyncResult> {
@@ -299,15 +296,11 @@ export class JiraACCheckboxSync {
     const specsRoot = path.join(this.projectRoot, '.specweave/docs/internal/specs');
     const usFiles: LivingDocsUSFile[] = [];
 
+    // Search all project directories for the feature
     const projectDirs: string[] = [];
-    const primaryPath = path.join(specsRoot, this.projectId, featureId);
-    if (existsSync(primaryPath)) projectDirs.push(primaryPath);
-
     if (existsSync(specsRoot)) {
       try {
-        const allProjects = await fs.readdir(specsRoot);
-        for (const proj of allProjects) {
-          if (proj === this.projectId) continue;
+        for (const proj of await fs.readdir(specsRoot)) {
           const p = path.join(specsRoot, proj, featureId);
           if (existsSync(p)) projectDirs.push(p);
         }

package/plugins/specweave/lib/vendor/utils/project-detection.d.ts

@@ -1,250 +0,0 @@
-/**
- * Project ID Auto-Detection Utilities
- *
- * Detects project ID from (priority order):
- * 1. sync.defaultProfile (for multi-profile monorepos)
- * 2. Git remote (GitHub repo name)
- * 3. Sync configuration (JIRA project key, ADO project name)
- * 4. User prompt (fallback)
- *
- * NOTE: multiProject.activeProject has been REMOVED!
- * Per-US project targeting replaces global activeProject.
- * See: 0125-cross-project-user-story-targeting
- *
- * Also provides repo name parsing for domain context understanding.
- */
-/**
- * Parsed repo name structure for domain understanding
- *
- * @example
- * parseRepoName('sw-qr-menu-be')
- * // Returns: { prefix: 'sw', product: 'qr-menu', component: 'be', full: 'sw-qr-menu-be' }
- */
-export interface ParsedRepoName {
-    /** Short prefix (e.g., 'sw' for company/project abbreviation) */
-    prefix: string | null;
-    /** Product/domain name (e.g., 'qr-menu') */
-    product: string;
-    /** Component suffix (e.g., 'be', 'fe', 'shared', 'api', 'web', 'mobile') */
-    component: string | null;
-    /** Full original repo name */
-    full: string;
-    /** Detected domain context based on product name */
-    domain: string | null;
-}
-/**
- * Parse repo name to extract product, component, and domain context
- *
- * Understands naming conventions like:
- * - `sw-qr-menu-be` → prefix: sw, product: qr-menu, component: be
- * - `my-app-frontend` → prefix: null, product: my-app, component: frontend
- * - `ecommerce-api` → prefix: null, product: ecommerce, component: api
- *
- * @param repoName - Repository name (e.g., "sw-qr-menu-be")
- * @returns Parsed repo name structure
- */
-export declare function parseRepoName(repoName: string): ParsedRepoName;
-/**
- * Detect default project ID from configuration
- *
- * NOTE: multiProject.activeProject has been REMOVED!
- * This function now only uses sync.defaultProfile for legacy umbrella repos.
- *
- * Priority:
- * 1. sync.defaultProfile - for umbrella repos where profile maps to folder
- *
- * @param projectRoot - Project root directory
- * @returns Default project ID or null if not configured
- */
-export declare function detectDefaultProfileId(projectRoot: string): string | null;
-/**
- * Auto-detect project ID from git remote URL
- *
- * Extracts repository name from git remote URL
- *
- * @param projectRoot - Project root directory
- * @returns Project ID (repo name) or null if not detected
- *
- * @example
- * // Git remote: https://github.com/anton-abyzov/specweave.git
- * detectProjectIdFromGit('/path/to/project')
- * // Returns: "specweave"
- *
- * @example
- * // Git remote: git@github.com:my-org/web-app.git
- * detectProjectIdFromGit('/path/to/project')
- * // Returns: "web-app"
- */
-export declare function detectProjectIdFromGit(projectRoot: string): string | null;
-/**
- * Auto-detect project ID from sync configuration
- *
- * Checks existing sync profiles for JIRA project key or ADO project name
- *
- * @param projectRoot - Project root directory
- * @returns Project ID from sync config or null if not detected
- *
- * @example
- * // Config has JIRA: { projectKey: "WEBAPP" }
- * detectProjectIdFromSync('/path/to/project')
- * // Returns: "webapp"
- */
-export declare function detectProjectIdFromSync(projectRoot: string): string | null;
-/**
- * Prompt user for project ID
- *
- * Interactive prompt with validation and helpful examples
- *
- * @param suggestedId - Optional suggested project ID (from detection)
- * @returns Project ID entered by user
- *
- * @example
- * await promptForProjectId()
- * // User sees:
- * // Project ID (matches GitHub repo, JIRA project, or ADO project): █
- * // User enters: "web-app"
- * // Returns: "web-app"
- */
-export declare function promptForProjectId(suggestedId?: string): Promise<string>;
-/**
- * Auto-detect project ID synchronously (no prompts)
- *
- * Priority:
- * 1. Active sync profile ID (for multi-profile monorepos like sw-qr-menu)
- * 2. Git remote (GitHub repo name) - for single-repo projects
- * 3. Sync configuration (JIRA/ADO project) - legacy fallback
- * 4. "default" (fallback)
- *
- * @param projectRoot - Project root directory
- * @param options - Detection options
- * @returns Detected project ID or "default"
- *
- * @example
- * // Multi-project setup with activeProject: "be"
- * autoDetectProjectIdSync('/path/to/sw-qr-menu')
- * // Returns: "be" (profile ID, NOT "sw-qr-menu-be")
- *
- * @example
- * // Single repo: https://github.com/anton-abyzov/specweave.git
- * autoDetectProjectIdSync('/path/to/project')
- * // Returns: "specweave"
- *
- * @example
- * // No git, no sync
- * autoDetectProjectIdSync('/path/to/project')
- * // Returns: "default"
- */
-export declare function autoDetectProjectIdSync(projectRoot: string, options?: {
-    silent?: boolean;
-}): string;
-/**
- * Auto-detect project ID with fallback chain (async version with prompts)
- *
- * Priority:
- * 1. Default sync profile ID (for multi-profile monorepos)
- * 2. Git remote (GitHub repo name)
- * 3. Sync configuration (JIRA/ADO project)
- * 4. User prompt (with detected suggestion)
- * 5. "default" (if user accepts default in prompt)
- *
- * @param projectRoot - Project root directory
- * @param options - Detection options
- * @returns Detected or prompted project ID
- *
- * @example
- * // Multi-project setup with defaultProfile: "be"
- * await autoDetectProjectId('/path/to/sw-qr-menu')
- * // Output: "✅ Detected default profile: be"
- * // Returns: "be"
- *
- * @example
- * // In git repo: https://github.com/anton-abyzov/specweave.git
- * await autoDetectProjectId('/path/to/project')
- * // Output: "✅ Detected git repository: specweave"
- * // Returns: "specweave"
- *
- * @example
- * // No git, no sync, user prompted
- * await autoDetectProjectId('/path/to/project')
- * // Output: "📝 No git repository or sync configuration detected."
- * // Prompts user for project ID
- * // Returns: user input (e.g., "my-project")
- */
-export declare function autoDetectProjectId(projectRoot: string, options?: {
-    silent?: boolean;
-    promptIfNotDetected?: boolean;
-}): Promise<string>;
-/**
- * Format project ID to display name
- *
- * Converts kebab-case/snake_case to Title Case
- *
- * @param projectId - Project ID (e.g., "web-app", "mobile_app")
- * @returns Formatted name (e.g., "Web App", "Mobile App")
- *
- * @example
- * formatProjectName('web-app')
- * // Returns: "Web App"
- *
- * @example
- * formatProjectName('mobile_app')
- * // Returns: "Mobile App"
- *
- * @example
- * formatProjectName('specweave')
- * // Returns: "SpecWeave"
- */
-export declare function formatProjectName(projectId: string): string;
-/**
- * Validate project ID format
- *
- * @param projectId - Project ID to validate
- * @returns True if valid, error message if invalid
- */
-export declare function validateProjectId(projectId: string): true | string;
-/**
- * Full project context for intelligent user story routing and domain awareness
- */
-export interface ProjectContext {
-    /** Default project/profile ID (folder name under specs/) */
-    projectId: string;
-    /** How projectId was detected */
-    detectedFrom: 'defaultProfile' | 'gitRemote' | 'syncConfig' | 'fallback';
-    /** Parsed repo name with domain context (if git remote detected) */
-    repoInfo: ParsedRepoName | null;
-    /** All available profiles (for multi-profile monorepos) */
-    availableProfiles: string[];
-    /** Default profile config (if multi-profile) */
-    defaultProfile: {
-        id: string;
-        displayName: string;
-        provider: string;
-        repo?: string;
-    } | null;
-}
-/**
- * Get full project context for intelligent routing and domain awareness
- *
- * Use this to understand:
- * - Which project folder to use for specs (projectId)
- * - What domain/product this project is about (repoInfo.domain)
- * - What component type this is (repoInfo.component: be/fe/shared)
- * - What other profiles are available (for cross-project user stories)
- *
- * @param projectRoot - Project root directory
- * @returns Full project context
- *
- * @example
- * // sw-qr-menu monorepo with defaultProfile: "be"
- * getProjectContext('/path/to/sw-qr-menu')
- * // Returns:
- * // {
- * //   projectId: 'be',
- * //   detectedFrom: 'defaultProfile',
- * //   repoInfo: { prefix: 'sw', product: 'qr-menu', component: 'be', domain: 'hospitality/restaurant' },
- * //   availableProfiles: ['be', 'fe', 'shared'],
- * //   defaultProfile: { id: 'be', displayName: 'sw-qr-menu-be service', provider: 'github', repo: 'sw-qr-menu-be' }
- * // }
- */
-export declare function getProjectContext(projectRoot: string): ProjectContext;
-//# sourceMappingURL=project-detection.d.ts.map