specweave 0.33.2 → 0.33.3

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

@@ -0,0 +1,156 @@
+/**
+ * Project Resolver
+ *
+ * Smart utility that auto-resolves project/board for user stories
+ * based on context analysis:
+ * - Single project → auto-select
+ * - Keyword matching → suggest with confidence
+ * - Cross-cutting detection → split across projects
+ * - Learned patterns from existing specs
+ *
+ * Part of increment 0137: Per-US Project/Board Enforcement
+ *
+ * @module utils/project-resolver
+ * @since v0.34.0
+ */
+import { type ProjectInfo, type BoardInfo } from './structure-level-detector.js';
+import { Logger } from './logger.js';
+import { CrossCuttingDetector, type CrossCuttingResult, type DetectedPattern } from './cross-cutting-detector.js';
+/**
+ * Resolution result for a single user story
+ */
+export interface ProjectResolution {
+    /** Whether project was successfully resolved */
+    resolved: boolean;
+    /** Resolved project ID (if resolved) */
+    projectId?: string;
+    /** Resolved board ID (for 2-level structures) */
+    boardId?: string;
+    /** Confidence level */
+    confidence: 'high' | 'medium' | 'low';
+    /** Reason for resolution decision */
+    reason: string;
+    /** Keywords that matched (if any) */
+    matchedKeywords?: string[];
+}
+/**
+ * Resolution result for an entire increment
+ */
+export interface IncrementResolution {
+    /** Whether this is a cross-project increment */
+    isCrossProject: boolean;
+    /** Default project for USs without explicit assignment */
+    defaultProject: string;
+    /** Default board for 2-level (optional) */
+    defaultBoard?: string;
+    /** Suggested project for each US type */
+    suggestions: Map<string, ProjectResolution>;
+    /** Structure level detected */
+    structureLevel: 1 | 2;
+    /** Cross-cutting detection result (when detected) */
+    crossCuttingResult?: CrossCuttingResult;
+    /** Detected patterns for display/logging */
+    detectedPatterns?: DetectedPattern[];
+}
+/**
+ * Project Resolver
+ *
+ * Resolves project/board context for user stories based on:
+ * 1. Single project auto-selection
+ * 2. Learned patterns from existing specs
+ * 3. Keyword-based matching
+ * 4. Cross-cutting detection
+ */
+export declare class ProjectResolver {
+    private projectRoot;
+    private logger;
+    private structureConfig;
+    private learnedPatterns;
+    private keywordPatterns;
+    private crossCuttingDetector;
+    constructor(projectRoot: string, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Get structure level (1 or 2)
+     */
+    getStructureLevel(): 1 | 2;
+    /**
+     * Get available projects
+     */
+    getProjects(): ProjectInfo[];
+    /**
+     * Get boards for a project (2-level only)
+     */
+    getBoards(projectId: string): BoardInfo[];
+    /**
+     * Learn keyword patterns from existing spec.md files
+     */
+    learnFromExistingSpecs(): Promise<void>;
+    /**
+     * Extract keyword → project patterns from a spec file
+     */
+    private extractPatternsFromSpec;
+    /**
+     * Check if word is in default patterns
+     */
+    private isDefaultPattern;
+    /**
+     * Resolve project for a single user story
+     */
+    resolveForUserStory(usContent: string): ProjectResolution;
+    /**
+     * Map suggested project type (frontend, backend, etc.) to actual project ID
+     */
+    private mapSuggestedTypeToProject;
+    /**
+     * Resolve board for a user story (2-level structures only)
+     */
+    resolveBoard(usContent: string, projectId: string): ProjectResolution;
+    /**
+     * Match content against project keywords
+     */
+    private matchProjectsByKeywords;
+    /**
+     * Resolve project context for an entire increment description
+     */
+    resolveForIncrement(incrementDescription: string): IncrementResolution;
+    /**
+     * Detect if description indicates cross-project work
+     */
+    private detectCrossProject;
+    /**
+     * Check if content matches any keywords
+     */
+    private matchesKeywords;
+    /**
+     * Detect cross-cutting concerns using the integrated detector
+     * Returns full detection result for advanced use cases
+     */
+    detectCrossCuttingConcerns(description: string): CrossCuttingResult;
+    /**
+     * Get the cross-cutting detector instance for direct access
+     */
+    getCrossCuttingDetector(): CrossCuttingDetector;
+    /**
+     * Format available projects for display
+     */
+    formatProjectsForDisplay(): string;
+}
+/**
+ * Create a project resolver instance (sync - no pattern learning)
+ */
+export declare function createProjectResolver(projectRoot: string, options?: {
+    logger?: Logger;
+}): ProjectResolver;
+/**
+ * Create a project resolver instance with pattern learning (async)
+ *
+ * This awaits learnFromExistingSpecs() to ensure patterns are available
+ * before the resolver is used.
+ */
+export declare function createProjectResolverWithPatterns(projectRoot: string, options?: {
+    logger?: Logger;
+}): Promise<ProjectResolver>;
+export type { CrossCuttingResult, DetectedPattern };
+//# sourceMappingURL=project-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.d.ts","sourceRoot":"","sources":["../../../src/utils/project-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAmD,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAClI,OAAO,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAElH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAElB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAEtC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IAExB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE5C,+BAA+B;IAC/B,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC;IAEtB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC;AA0DD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAwBlE;;OAEG;IACH,iBAAiB,IAAI,CAAC,GAAG,CAAC;IAI1B;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAI5B;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE;IAIzC;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC7C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IA6GzD;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqCjC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAwErE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgD/B;;OAEG;IACH,mBAAmB,CAAC,oBAAoB,EAAE,MAAM,GAAG,mBAAmB;IAgFtE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;OAGG;IACH,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB;IAInE;;OAEG;IACH,uBAAuB,IAAI,oBAAoB;IAI/C;;OAEG;IACH,wBAAwB,IAAI,MAAM;CAoBnC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,eAAe,CAEjB;AAED;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,eAAe,CAAC,CAU1B;AAGD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC"}