specweave 0.17.0 → 0.17.1

package/dist/src/utils/pricing-constants.js

@@ -0,0 +1,71 @@
+/**
+ * Anthropic API Pricing Constants
+ *
+ * Pricing as of 2025-10-31 (verified against https://www.anthropic.com/pricing)
+ *
+ * Model Tier Mapping:
+ * - sonnet → claude-sonnet-4-5-20250929 (latest Sonnet 4.5)
+ * - haiku → claude-4-5-haiku-20250110 (latest Haiku 4.5)
+ * - opus → claude-opus-4-0-... (when released)
+ *
+ * Note: This file should be updated when Anthropic releases new models.
+ */
+/**
+ * Pricing per 1M tokens (input/output) in USD
+ */
+export const PRICING = {
+    sonnet: {
+        input: 0.000003, // $3 per 1M input tokens
+        output: 0.000015, // $15 per 1M output tokens
+    },
+    haiku: {
+        input: 0.000001, // $1 per 1M input tokens
+        output: 0.000005, // $5 per 1M output tokens
+    },
+    opus: {
+        input: 0.000015, // $15 per 1M input tokens
+        output: 0.000075, // $75 per 1M output tokens
+    },
+};
+/**
+ * Calculate cost for a given model and token usage
+ *
+ * @param model - Model tier (sonnet, haiku, opus)
+ * @param inputTokens - Number of input tokens
+ * @param outputTokens - Number of output tokens
+ * @returns Total cost in USD
+ *
+ * @example
+ * ```typescript
+ * const cost = calculateCost('haiku', 1000, 500);
+ * // Returns: 0.0035 ($0.0035 = $0.001 input + $0.0025 output)
+ * ```
+ */
+export function calculateCost(model, inputTokens, outputTokens) {
+    const pricing = PRICING[model];
+    return (inputTokens * pricing.input) + (outputTokens * pricing.output);
+}
+/**
+ * Get pricing constants for a specific model
+ *
+ * @param model - Model tier
+ * @returns Pricing object with input/output costs
+ */
+export function getModelPricing(model) {
+    return PRICING[model];
+}
+/**
+ * Calculate cost savings vs baseline (all-Sonnet)
+ *
+ * @param actualModel - Model actually used
+ * @param inputTokens - Input tokens
+ * @param outputTokens - Output tokens
+ * @returns Savings amount in dollars (positive = saved money)
+ */
+export function calculateSavings(actualModel, inputTokens, outputTokens) {
+    const actualCost = calculateCost(actualModel, inputTokens, outputTokens);
+    const baselineCost = calculateCost('sonnet', inputTokens, outputTokens);
+    const savedAmount = baselineCost - actualCost;
+    return savedAmount;
+}
+//# sourceMappingURL=pricing-constants.js.map

package/dist/src/utils/pricing-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-constants.js","sourceRoot":"","sources":["../../../src/utils/pricing-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;IACD,KAAK,EAAE;QACL,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,0BAA0B;KAC9C;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,QAAQ,EAAI,0BAA0B;QAC7C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;CACO,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkC,EAClC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkC;IAChE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAwC,EACxC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;IAE9C,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/src/utils/project-detection.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Project ID Auto-Detection Utilities
+ *
+ * Detects project ID from:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA project key, ADO project name)
+ * 3. User prompt (fallback)
+ */
+/**
+ * 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. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. "default" (fallback)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected project ID or "default"
+ *
+ * @example
+ * // In git 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. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. User prompt (with detected suggestion)
+ * 4. "default" (if user accepts default in prompt)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected or prompted project ID
+ *
+ * @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;
+//# sourceMappingURL=project-detection.d.ts.map

package/dist/src/utils/project-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detection.d.ts","sourceRoot":"","sources":["../../../src/utils/project-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsD1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B9E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,MAAM,CAuBR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,GACL,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB3D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAkBlE"}

package/dist/src/utils/project-detection.js

@@ -0,0 +1,321 @@
+/**
+ * Project ID Auto-Detection Utilities
+ *
+ * Detects project ID from:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA project key, ADO project name)
+ * 3. User prompt (fallback)
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import inquirer from 'inquirer';
+import { ConfigManager } from '../core/config-manager';
+/**
+ * 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 function detectProjectIdFromGit(projectRoot) {
+    try {
+        const gitConfigPath = path.join(projectRoot, '.git', 'config');
+        // Check if .git/config exists
+        if (!fs.existsSync(gitConfigPath)) {
+            return null;
+        }
+        // Read git config
+        const gitConfig = fs.readFileSync(gitConfigPath, 'utf8');
+        // Extract remote URL (match both HTTPS and SSH formats)
+        // HTTPS: https://github.com/owner/repo.git
+        // SSH: git@github.com:owner/repo.git
+        const httpsMatch = gitConfig.match(/url = https?:\/\/[^\/]+\/[^\/]+\/([^\/\s]+?)(?:\.git)?$/m);
+        const sshMatch = gitConfig.match(/url = git@[^:]+:[^\/]+\/([^\/\s]+?)(?:\.git)?$/m);
+        const match = httpsMatch || sshMatch;
+        if (match && match[1]) {
+            const repoName = match[1].trim();
+            // Validate repo name (lowercase, alphanumeric, hyphens, underscores)
+            if (/^[a-z0-9_-]+$/i.test(repoName)) {
+                return repoName.toLowerCase();
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        // Silently fail (not in git repo or permission error)
+        return 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 function detectProjectIdFromSync(projectRoot) {
+    try {
+        const configManager = new ConfigManager(projectRoot);
+        const config = configManager.load();
+        // Check sync profiles for project identifiers
+        if (config.sync?.profiles) {
+            const profiles = Object.values(config.sync.profiles);
+            for (const profile of profiles) {
+                // GitHub profile (extract repo name)
+                if (profile.provider === 'github') {
+                    const githubConfig = profile.config;
+                    if (githubConfig?.repo) {
+                        return githubConfig.repo.toLowerCase();
+                    }
+                }
+                // JIRA profile (use project key)
+                if (profile.provider === 'jira') {
+                    const jiraConfig = profile.config;
+                    if (jiraConfig?.projectKey) {
+                        return jiraConfig.projectKey.toLowerCase();
+                    }
+                }
+                // Azure DevOps profile (use project name)
+                if (profile.provider === 'ado') {
+                    const adoConfig = profile.config;
+                    if (adoConfig?.project) {
+                        return adoConfig.project.toLowerCase().replace(/\s+/g, '-');
+                    }
+                }
+            }
+        }
+        // Legacy: Check old sync config format (pre-profiles)
+        if (config.sync?.jira?.projectKey) {
+            return config.sync.jira.projectKey.toLowerCase();
+        }
+        if (config.sync?.ado?.project) {
+            return config.sync.ado.project.toLowerCase().replace(/\s+/g, '-');
+        }
+        if (config.sync?.github?.repo) {
+            return config.sync.github.repo.toLowerCase();
+        }
+        return null;
+    }
+    catch (error) {
+        // Config doesn't exist or is invalid
+        return 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 async function promptForProjectId(suggestedId) {
+    const { projectId } = await inquirer.prompt([{
+            type: 'input',
+            name: 'projectId',
+            message: 'Project ID (matches GitHub repo, JIRA project, or ADO project):',
+            default: suggestedId || 'default',
+            validate: (input) => {
+                if (!input) {
+                    return 'Project ID is required';
+                }
+                if (!/^[a-z0-9_-]+$/.test(input)) {
+                    return 'Project ID must be lowercase, alphanumeric, with hyphens or underscores';
+                }
+                if (input.length < 2) {
+                    return 'Project ID must be at least 2 characters';
+                }
+                if (input.length > 64) {
+                    return 'Project ID must be at most 64 characters';
+                }
+                return true;
+            }
+        }]);
+    return projectId;
+}
+/**
+ * Auto-detect project ID synchronously (no prompts)
+ *
+ * Priority:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. "default" (fallback)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected project ID or "default"
+ *
+ * @example
+ * // In git 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 function autoDetectProjectIdSync(projectRoot, options = {}) {
+    const { silent = false } = options;
+    // 1. Try git remote
+    const gitProjectId = detectProjectIdFromGit(projectRoot);
+    if (gitProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected git repository: ${gitProjectId}`);
+        }
+        return gitProjectId;
+    }
+    // 2. Try sync config
+    const syncProjectId = detectProjectIdFromSync(projectRoot);
+    if (syncProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected sync configuration: ${syncProjectId}`);
+        }
+        return syncProjectId;
+    }
+    // 3. Fallback to "default"
+    return 'default';
+}
+/**
+ * Auto-detect project ID with fallback chain (async version with prompts)
+ *
+ * Priority:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. User prompt (with detected suggestion)
+ * 4. "default" (if user accepts default in prompt)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected or prompted project ID
+ *
+ * @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 async function autoDetectProjectId(projectRoot, options = {}) {
+    const { silent = false, promptIfNotDetected = true } = options;
+    // 1. Try git remote
+    const gitProjectId = detectProjectIdFromGit(projectRoot);
+    if (gitProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected git repository: ${gitProjectId}`);
+        }
+        return gitProjectId;
+    }
+    // 2. Try sync config
+    const syncProjectId = detectProjectIdFromSync(projectRoot);
+    if (syncProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected sync configuration: ${syncProjectId}`);
+        }
+        return syncProjectId;
+    }
+    // 3. Prompt user (if enabled)
+    if (promptIfNotDetected) {
+        if (!silent) {
+            console.log('\n📝 No git repository or sync configuration detected.');
+            console.log('   Please enter your project identifier.\n');
+            console.log('   Examples:');
+            console.log('   • GitHub repo "web-app" → enter: web-app');
+            console.log('   • JIRA project "WEBAPP" → enter: webapp');
+            console.log('   • ADO project "Platform" → enter: platform');
+            console.log('   • Generic project → enter: default\n');
+        }
+        return await promptForProjectId();
+    }
+    // 4. Fallback to "default" (no prompt)
+    return 'default';
+}
+/**
+ * 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 function formatProjectName(projectId) {
+    // Special cases (known project names)
+    const specialCases = {
+        'specweave': 'SpecWeave',
+        'webapp': 'WebApp',
+        'default': 'Default Project'
+    };
+    if (specialCases[projectId.toLowerCase()]) {
+        return specialCases[projectId.toLowerCase()];
+    }
+    // Convert kebab-case or snake_case to Title Case
+    return projectId
+        .replace(/[-_]/g, ' ')
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+/**
+ * Validate project ID format
+ *
+ * @param projectId - Project ID to validate
+ * @returns True if valid, error message if invalid
+ */
+export function validateProjectId(projectId) {
+    if (!projectId) {
+        return 'Project ID is required';
+    }
+    if (!/^[a-z0-9_-]+$/.test(projectId)) {
+        return 'Project ID must be lowercase, alphanumeric, with hyphens or underscores';
+    }
+    if (projectId.length < 2) {
+        return 'Project ID must be at least 2 characters';
+    }
+    if (projectId.length > 64) {
+        return 'Project ID must be at most 64 characters';
+    }
+    return true;
+}
+//# sourceMappingURL=project-detection.js.map

package/dist/src/utils/project-detection.js.map

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

package/dist/src/utils/project-mapper.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Project Mapper - Intelligent User Story to Project Classification
+ *
+ * Analyzes user story content, tech stack mentions, and component architecture
+ * to intelligently map user stories to the correct projects (FE, BE, MOBILE, etc.)
+ *
+ * @module project-mapper
+ */
+export interface ProjectMapping {
+    projectId: string;
+    confidence: number;
+    reasoning: string[];
+}
+export interface UserStory {
+    id: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+    technicalContext?: string;
+}
+export interface ProjectRule {
+    id: string;
+    name: string;
+    keywords: string[];
+    techStack: string[];
+    componentTypes: string[];
+    excludeKeywords?: string[];
+}
+/**
+ * Project mapper configuration
+ */
+export interface ProjectMapperConfig {
+    /**
+     * Minimum confidence threshold (0.0-1.0) for primary project match
+     * Default: 0.3 (30%)
+     *
+     * Lower values (0.15-0.2) work better for business-focused specs
+     * Higher values (0.4-0.5) work better for tech-focused specs
+     */
+    confidenceThreshold?: number;
+    /**
+     * Custom project rules (overrides default rules)
+     */
+    customRules?: ProjectRule[];
+}
+/**
+ * Default project mapping rules
+ * These can be customized via .specweave/config.json
+ */
+export declare const DEFAULT_PROJECT_RULES: ProjectRule[];
+/**
+ * Analyze user story content and map to projects
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules (defaults to DEFAULT_PROJECT_RULES)
+ * @returns Array of project mappings sorted by confidence (highest first)
+ */
+export declare function mapUserStoryToProjects(userStory: UserStory, projectRules?: ProjectRule[]): ProjectMapping[];
+/**
+ * Determine primary project for a user story
+ * (highest confidence mapping)
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules
+ * @param config Optional configuration (confidence threshold, custom rules)
+ * @returns Primary project mapping or null if no confident match
+ */
+export declare function getPrimaryProject(userStory: UserStory, projectRules?: ProjectRule[], config?: ProjectMapperConfig): ProjectMapping | null;
+/**
+ * Split spec into project-specific specs based on user story mappings
+ *
+ * @param userStories Array of user stories
+ * @param projectRules Project mapping rules
+ * @returns Map of projectId → user stories
+ */
+export declare function splitSpecByProject(userStories: UserStory[], projectRules?: ProjectRule[]): Map<string, UserStory[]>;
+/**
+ * Suggest JIRA item type hierarchy based on user story scope
+ *
+ * @param userStory User story to analyze
+ * @returns Suggested JIRA item type (Epic, Story, Task, Subtask)
+ */
+export declare function suggestJiraItemType(userStory: UserStory): 'Epic' | 'Story' | 'Task' | 'Subtask';
+/**
+ * Format project mapping report (for display to user)
+ *
+ * @param userStory User story
+ * @param mappings Project mappings
+ * @returns Formatted markdown report
+ */
+export declare function formatProjectMappingReport(userStory: UserStory, mappings: ProjectMapping[]): string;
+//# sourceMappingURL=project-mapper.d.ts.map

package/dist/src/utils/project-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mapper.d.ts","sourceRoot":"","sources":["../../../src/utils/project-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,EAwF9C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,EACpB,YAAY,GAAE,WAAW,EAA0B,GAClD,cAAc,EAAE,CAiFlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,YAAY,GAAE,WAAW,EAA0B,EACnD,MAAM,CAAC,EAAE,mBAAmB,GAC3B,cAAc,GAAG,IAAI,CAUvB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,SAAS,EAAE,EACxB,YAAY,GAAE,WAAW,EAA0B,GAClD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAmB1B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAoB/F;AAeD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,cAAc,EAAE,GACzB,MAAM,CA4BR"}