driftdetect-mcp 0.5.0 → 0.6.0

package/dist/tools/detail/file-patterns.d.ts

@@ -3,8 +3,9 @@
  *
  * Detail tool that returns all patterns found in a specific file.
  * Shows pattern details, locations within the file, and outliers.
+ *
+ * Uses IndexStore (by-file.json) for file-to-pattern mapping.
  */
-import type { ManifestStore } from 'driftdetect-core';
 export interface FilePatternLocation {
     line: number;
     column?: number;
@@ -27,7 +28,7 @@ export interface FilePatternData {
     outlierCount: number;
     categories: string[];
 }
-export declare function handleFilePatterns(store: ManifestStore, args: {
+export declare function handleFilePatterns(projectRoot: string, args: {
     file: string;
     category?: string;
 }): Promise<{

package/dist/tools/detail/file-patterns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-patterns.d.ts","sourceRoot":"","sources":["../../../src/tools/detail/file-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA+G7D"}
+{"version":3,"file":"file-patterns.d.ts","sourceRoot":"","sources":["../../../src/tools/detail/file-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAsH7D"}

package/dist/tools/detail/file-patterns.js

@@ -3,28 +3,36 @@
  *
  * Detail tool that returns all patterns found in a specific file.
  * Shows pattern details, locations within the file, and outliers.
+ *
+ * Uses IndexStore (by-file.json) for file-to-pattern mapping.
  */
+import { IndexStore, PatternStore } from 'driftdetect-core';
 import { createResponseBuilder, Errors } from '../../infrastructure/index.js';
-export async function handleFilePatterns(store, args) {
+export async function handleFilePatterns(projectRoot, args) {
     const builder = createResponseBuilder();
     if (!args.file) {
         throw Errors.missingParameter('file');
     }
-    await store.load();
-    const manifest = await store.get();
+    // Use IndexStore for file-to-pattern mapping
+    const indexStore = new IndexStore({ rootDir: projectRoot });
+    await indexStore.initialize();
+    const fileIndex = await indexStore.getFileIndex();
     // Normalize file path
     const filePath = args.file.replace(/^\.\//, '');
-    // Check if file exists in manifest
-    const fileEntry = manifest.files[filePath];
-    if (!fileEntry) {
+    // Check if file exists in index
+    const patternIds = fileIndex?.patterns[filePath];
+    if (!patternIds || patternIds.length === 0) {
         throw Errors.notFound('file', filePath);
     }
+    // Load pattern store to get full pattern details
+    const patternStore = new PatternStore({ rootDir: projectRoot });
+    await patternStore.initialize();
     // Get patterns for this file
     const patterns = [];
     const categories = new Set();
     let outlierCount = 0;
-    for (const patternId of fileEntry.patterns) {
-        const pattern = manifest.patterns[patternId];
+    for (const patternId of patternIds) {
+        const pattern = patternStore.get(patternId);
         if (!pattern)
             continue;
         // Filter by category if specified
@@ -37,10 +45,10 @@ export async function handleFilePatterns(store, args) {
             .filter(loc => loc.file === filePath)
             .map(loc => {
             const result = {
-                line: loc.range.start,
+                line: loc.line,
             };
-            if (loc.snippet) {
-                result.snippet = loc.snippet;
+            if (loc.column) {
+                result.column = loc.column;
             }
             return result;
         });
@@ -54,7 +62,7 @@ export async function handleFilePatterns(store, args) {
             name: pattern.name,
             category: pattern.category,
             subcategory: pattern.subcategory ?? '',
-            confidence: Math.round(pattern.confidence * 100) / 100,
+            confidence: Math.round(pattern.confidence.score * 100) / 100,
             locations: fileLocations,
             isOutlier: !!outlier,
         };

package/dist/tools/detail/file-patterns.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-patterns.js","sourceRoot":"","sources":["../../../src/tools/detail/file-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AA2B9E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAoB,EACpB,IAGC;IAED,MAAM,OAAO,GAAG,qBAAqB,EAAmB,CAAC;IAEzD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;IAEnC,sBAAsB;IACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEhD,mCAAmC;IACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,6BAA6B;IAC7B,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,kCAAkC;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QAED,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEjC,6BAA6B;QAC7B,MAAM,aAAa,GAA0B,OAAO,CAAC,SAAS;aAC3D,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;aACpC,GAAG,CAAC,GAAG,CAAC,EAAE;YACT,MAAM,MAAM,GAAwB;gBAClC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK;aACtB,CAAC;YACF,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC/B,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEL,oDAAoD;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,EAAE,CAAC;QACjB,CAAC;QAED,MAAM,YAAY,GAAgB;YAChC,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG;YACtD,SAAS,EAAE,aAAa;YACxB,SAAS,EAAE,CAAC,CAAC,OAAO;SACrB,CAAC;QAEF,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,aAAa,GAAG,uBAAuB,CAAC;QACvD,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC;IAED,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3E,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAoB;QAC5B,IAAI,EAAE,QAAQ;QACd,QAAQ;QACR,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,YAAY;QACZ,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE;KAC1C,CAAC;IAEF,gBAAgB;IAChB,IAAI,OAAO,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,MAAM,WAAW,CAAC;IACzD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,KAAK,YAAY,YAAY,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,iBAAiB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC;IAE3E,MAAM,KAAK,GAA2E;QACpF,WAAW,EAAE;YACX,gDAAgD;YAChD,gDAAgD;SACjD;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,CAAC;KAC/E,CAAC;IAEF,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,QAAQ,GAAG;YACf,GAAG,YAAY,4DAA4D;SAC5E,CAAC;IACJ,CAAC;IAED,OAAO,OAAO;SACX,WAAW,CAAC,OAAO,CAAC;SACpB,QAAQ,CAAC,IAAI,CAAC;SACd,SAAS,CAAC,KAAK,CAAC;SAChB,YAAY,EAAE,CAAC;AACpB,CAAC"}
+{"version":3,"file":"file-patterns.js","sourceRoot":"","sources":["../../../src/tools/detail/file-patterns.ts"],"names":[],"mappings":"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"}

package/dist/tools/detail/files-list.d.ts

@@ -3,20 +3,20 @@
  *
  * Detail tool that lists files matching a glob pattern with their pattern counts.
  * Supports pagination for large codebases.
+ *
+ * Uses IndexStore (by-file.json) for file-to-pattern mapping.
  */
-import type { ManifestStore } from 'driftdetect-core';
 export interface FileEntry {
     file: string;
     patternCount: number;
     categories: string[];
-    lastScanned?: string;
 }
 export interface FilesListData {
     files: FileEntry[];
     totalFiles: number;
     totalPatterns: number;
 }
-export declare function handleFilesList(store: ManifestStore, args: {
+export declare function handleFilesList(projectRoot: string, args: {
     path?: string;
     category?: string;
     limit?: number;

package/dist/tools/detail/files-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files-list.d.ts","sourceRoot":"","sources":["../../../src/tools/detail/files-list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA2F7D"}
+{"version":3,"file":"files-list.d.ts","sourceRoot":"","sources":["../../../src/tools/detail/files-list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA2G7D"}

package/dist/tools/detail/files-list.js

@@ -3,26 +3,43 @@
  *
  * Detail tool that lists files matching a glob pattern with their pattern counts.
  * Supports pagination for large codebases.
+ *
+ * Uses IndexStore (by-file.json) for file-to-pattern mapping.
  */
+import { IndexStore, PatternStore } from 'driftdetect-core';
 import { createResponseBuilder, createCursor, parseCursor } from '../../infrastructure/index.js';
 const DEFAULT_LIMIT = 20;
-export async function handleFilesList(store, args) {
+export async function handleFilesList(projectRoot, args) {
     const builder = createResponseBuilder();
-    await store.load();
-    const manifest = await store.get();
+    // Use IndexStore for file-to-pattern mapping
+    const indexStore = new IndexStore({ rootDir: projectRoot });
+    await indexStore.initialize();
+    const fileIndex = await indexStore.getFileIndex();
+    if (!fileIndex || Object.keys(fileIndex.patterns).length === 0) {
+        return builder
+            .withSummary('0 files with 0 pattern instances.')
+            .withData({ files: [], totalFiles: 0, totalPatterns: 0 })
+            .withHints({
+            nextActions: ['Run drift scan to discover patterns'],
+            relatedTools: ['drift_file_patterns', 'drift_patterns_list'],
+        })
+            .buildContent();
+    }
     const limit = args.limit ?? DEFAULT_LIMIT;
     const offset = args.cursor ? parseCursor(args.cursor).offset : 0;
     const pathPattern = args.path ?? '**/*';
-    // Get all files from manifest
-    const allFiles = Object.entries(manifest.files);
+    // Get all files from index
+    const allFiles = Object.entries(fileIndex.patterns);
     // Filter by path pattern (simple glob matching)
     let filteredFiles = allFiles.filter(([filePath]) => matchGlob(filePath, pathPattern));
+    // Load pattern store to get categories
+    const patternStore = new PatternStore({ rootDir: projectRoot });
+    await patternStore.initialize();
     // Build file entries with pattern info
-    let fileEntries = filteredFiles.map(([filePath, fileData]) => {
-        const patternIds = fileData.patterns;
+    let fileEntries = filteredFiles.map(([filePath, patternIds]) => {
         const categories = new Set();
         for (const patternId of patternIds) {
-            const pattern = manifest.patterns[patternId];
+            const pattern = patternStore.get(patternId);
             if (pattern) {
                 categories.add(pattern.category);
             }
@@ -31,7 +48,6 @@ export async function handleFilesList(store, args) {
             file: filePath,
             patternCount: patternIds.length,
             categories: Array.from(categories).sort(),
-            lastScanned: fileData.lastScanned,
         };
     });
     // Filter by category if specified
@@ -87,12 +103,13 @@ export async function handleFilesList(store, args) {
 function matchGlob(filePath, pattern) {
     if (pattern === '**/*' || pattern === '*')
         return true;
+    // Escape special regex chars first, then handle glob patterns
     const regexPattern = pattern
+        .replace(/\./g, '\\.')
         .replace(/\*\*/g, '{{GLOBSTAR}}')
         .replace(/\*/g, '[^/]*')
         .replace(/{{GLOBSTAR}}/g, '.*')
-        .replace(/\?/g, '.')
-        .replace(/\./g, '\\.');
+        .replace(/\?/g, '.');
     const regex = new RegExp(`^${regexPattern}$`);
     return regex.test(filePath);
 }

package/dist/tools/detail/files-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"files-list.js","sourceRoot":"","sources":["../../../src/tools/detail/files-list.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files-list.js","sourceRoot":"","sources":["../../../src/tools/detail/files-list.ts"],"names":[],"mappings":"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"}

package/dist/tools/orchestration/context.d.ts

@@ -11,7 +11,7 @@
  *
  * Enhanced with Language Intelligence for cross-language semantic analysis.
  */
-import { PatternStore, ManifestStore, BoundaryStore, CallGraphStore, DNAStore } from 'driftdetect-core';
+import { PatternStore, ManifestStore, BoundaryStore, CallGraphStore, DNAStore, type ConstraintCategory } from 'driftdetect-core';
 export type TaskIntent = 'add_feature' | 'fix_bug' | 'refactor' | 'security_audit' | 'understand_code' | 'add_test';
 export interface RelevantPattern {
     id: string;
@@ -79,6 +79,18 @@ export interface SemanticInsights {
         serviceCount: number;
     };
 }
+/** Relevant constraint for the task */
+export interface RelevantConstraint {
+    id: string;
+    name: string;
+    category: ConstraintCategory;
+    type: string;
+    condition: string;
+    enforcement: 'error' | 'warning' | 'info';
+    confidence: number;
+    guidance: string;
+    why: string;
+}
 export interface ContextPackage {
     summary: string;
     relevantPatterns: RelevantPattern[];
@@ -89,6 +101,8 @@ export interface ContextPackage {
     deeperDive: DeeperDive[];
     /** Semantic insights from Language Intelligence */
     semanticInsights?: SemanticInsights;
+    /** Architectural constraints that apply to this task */
+    constraints?: RelevantConstraint[];
     /** Project context when targeting a specific project */
     projectContext?: Record<string, unknown>;
 }

package/dist/tools/orchestration/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/tools/orchestration/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/tools/orchestration/context.ts"],"names":[],"mappings":"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"}

package/dist/tools/orchestration/context.js

@@ -11,7 +11,7 @@
  *
  * Enhanced with Language Intelligence for cross-language semantic analysis.
  */
-import { PatternStore, ManifestStore, BoundaryStore, CallGraphStore, DNAStore, createLanguageIntelligence, } from 'driftdetect-core';
+import { PatternStore, ManifestStore, BoundaryStore, CallGraphStore, DNAStore, createLanguageIntelligence, createConstraintStore, } from 'driftdetect-core';
 import { createResponseBuilder, resolveProject, formatProjectContext } from '../../infrastructure/index.js';
 import * as fs from 'fs/promises';
 import * as path from 'path';
@@ -258,8 +258,10 @@ export async function handleContext(stores, projectRoot, args) {
     const deeperDive = generateDeeperDive(intent, focus, relevantPatterns, suggestedFiles);
     // Generate semantic insights from Language Intelligence
     const semanticInsights = await generateSemanticInsights(effectiveRoot, suggestedFiles, focus);
+    // Get relevant constraints for this task
+    const constraints = await getRelevantConstraints(effectiveRoot, intent, focus, suggestedFiles);
     // Build summary
-    let summary = buildSummary(intent, focus, relevantPatterns, suggestedFiles, warnings, semanticInsights);
+    let summary = buildSummary(intent, focus, relevantPatterns, suggestedFiles, warnings, semanticInsights, constraints);
     // Add project context to summary if using a different project
     if (resolution.fromRegistry && resolution.project) {
         summary = `[Project: ${resolution.project.name}] ${summary}`;
@@ -273,7 +275,16 @@ export async function handleContext(stores, projectRoot, args) {
         confidence,
         deeperDive,
         ...(semanticInsights && { semanticInsights }),
+        ...(constraints.length > 0 && { constraints }),
     };
+    // Add constraint-related guidance
+    if (constraints.length > 0) {
+        const errorConstraints = constraints.filter(c => c.enforcement === 'error');
+        if (errorConstraints.length > 0) {
+            guidance.keyInsights.unshift(`⚠️ ${errorConstraints.length} mandatory constraint(s) apply - violations will cause errors`);
+        }
+        guidance.decisionPoints.push('Review constraints below before implementing - they define what code MUST do');
+    }
     // Add project context to response
     const projectContext = formatProjectContext(resolution);
     return builder
@@ -496,7 +507,7 @@ function generateDeeperDive(intent, _focus, patterns, files) {
     }
     return suggestions;
 }
-function buildSummary(intent, focus, patterns, files, warnings, semanticInsights) {
+function buildSummary(intent, focus, patterns, files, warnings, semanticInsights, constraints) {
     const intentLabels = {
         add_feature: 'Adding feature',
         fix_bug: 'Fixing bug',
@@ -537,7 +548,21 @@ function buildSummary(intent, focus, patterns, files, warnings, semanticInsights
             semanticParts.push(`${stats.serviceCount} service(s)`);
         }
         if (semanticParts.length > 0) {
-            summary += `Semantic analysis: ${semanticParts.join(', ')}.`;
+            summary += `Semantic analysis: ${semanticParts.join(', ')}. `;
+        }
+    }
+    // Add constraint info to summary
+    if (constraints && constraints.length > 0) {
+        const errorCount = constraints.filter(c => c.enforcement === 'error').length;
+        const warningCount = constraints.filter(c => c.enforcement === 'warning').length;
+        if (errorCount > 0) {
+            summary += `🔒 ${errorCount} mandatory constraint(s). `;
+        }
+        else if (warningCount > 0) {
+            summary += `${constraints.length} constraint(s) apply. `;
+        }
+        else {
+            summary += `${constraints.length} constraint(s) for reference. `;
         }
     }
     return summary;
@@ -652,6 +677,225 @@ async function generateSemanticInsights(projectRoot, suggestedFiles, focus) {
         return undefined;
     }
 }
+// =============================================================================
+// Constraint Integration
+// =============================================================================
+/**
+ * Get constraints relevant to the current task
+ *
+ * Maps task intent to constraint categories and filters constraints
+ * that apply to the suggested files.
+ */
+async function getRelevantConstraints(projectRoot, intent, focus, suggestedFiles) {
+    try {
+        // Initialize constraint store
+        const constraintStore = createConstraintStore({ rootDir: projectRoot });
+        await constraintStore.initialize();
+        // Map intent to relevant constraint categories
+        const intentToCategories = {
+            add_feature: ['api', 'auth', 'data', 'error', 'validation', 'logging', 'structural'],
+            fix_bug: ['error', 'data', 'validation', 'logging'],
+            refactor: ['structural', 'api', 'data', 'performance'],
+            security_audit: ['security', 'auth', 'data', 'validation'],
+            understand_code: ['api', 'data', 'structural', 'auth'],
+            add_test: ['test', 'error', 'data', 'api'],
+        };
+        const relevantCategories = intentToCategories[intent] ?? [];
+        // Get active constraints (approved + high-confidence discovered)
+        const activeConstraints = constraintStore.getActive(0.85);
+        // Filter to relevant categories
+        let filtered = activeConstraints.filter(c => relevantCategories.includes(c.category));
+        // Further filter to constraints that apply to suggested files
+        if (suggestedFiles.length > 0) {
+            filtered = filtered.filter(c => {
+                // If constraint has no file scope, it applies globally
+                if (!c.scope.files || c.scope.files.length === 0) {
+                    return true;
+                }
+                // Check if any suggested file matches the constraint scope
+                return suggestedFiles.some(sf => constraintAppliesToFile(c, sf.file));
+            });
+        }
+        // Also include constraints that match the focus term
+        const focusLower = focus.toLowerCase();
+        const focusMatches = activeConstraints.filter(c => !filtered.includes(c) && (c.name.toLowerCase().includes(focusLower) ||
+            c.description.toLowerCase().includes(focusLower)));
+        filtered = [...filtered, ...focusMatches];
+        // Sort by enforcement level (errors first) then confidence
+        filtered.sort((a, b) => {
+            const levelOrder = { error: 0, warning: 1, info: 2 };
+            const levelDiff = levelOrder[a.enforcement.level] - levelOrder[b.enforcement.level];
+            if (levelDiff !== 0)
+                return levelDiff;
+            return b.confidence.score - a.confidence.score;
+        });
+        // Limit to top 10 most relevant
+        const top = filtered.slice(0, 10);
+        // Convert to RelevantConstraint format
+        return top.map(c => ({
+            id: c.id,
+            name: c.name,
+            category: c.category,
+            type: c.invariant.type,
+            condition: c.invariant.condition,
+            enforcement: c.enforcement.level,
+            confidence: Math.round(c.confidence.score * 100) / 100,
+            guidance: c.enforcement.guidance,
+            why: generateConstraintWhy(c, intent, focus),
+        }));
+    }
+    catch {
+        // Constraint store not available or error - return empty
+        return [];
+    }
+}
+/**
+ * Check if a constraint applies to a specific file
+ */
+function constraintAppliesToFile(constraint, filePath) {
+    const scope = constraint.scope;
+    // Check exclusions first
+    if (scope.exclude?.files?.length) {
+        for (const pattern of scope.exclude.files) {
+            if (matchGlob(filePath, pattern)) {
+                return false;
+            }
+        }
+    }
+    if (scope.exclude?.directories?.length) {
+        for (const dir of scope.exclude.directories) {
+            if (filePath.includes(dir)) {
+                return false;
+            }
+        }
+    }
+    // Check inclusions
+    if (scope.files?.length) {
+        return scope.files.some(pattern => matchGlob(filePath, pattern));
+    }
+    // Check language match
+    if (constraint.language !== 'all') {
+        const ext = path.extname(filePath).toLowerCase();
+        const langExtensions = {
+            typescript: ['.ts', '.tsx'],
+            javascript: ['.js', '.jsx', '.mjs', '.cjs'],
+            python: ['.py'],
+            java: ['.java'],
+            csharp: ['.cs'],
+            php: ['.php'],
+        };
+        const exts = langExtensions[constraint.language];
+        if (exts && !exts.includes(ext)) {
+            return false;
+        }
+    }
+    // If no specific file scope, constraint applies to all matching language files
+    return true;
+}
+/**
+ * Simple glob matching (supports * and **)
+ */
+function matchGlob(filePath, pattern) {
+    const regexPattern = pattern
+        .replace(/\*\*/g, '{{GLOBSTAR}}')
+        .replace(/\*/g, '[^/]*')
+        .replace(/{{GLOBSTAR}}/g, '.*')
+        .replace(/\//g, '\\/');
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(filePath);
+}
+/**
+ * Generate explanation for why a constraint is relevant
+ */
+function generateConstraintWhy(constraint, intent, focus) {
+    const focusLower = focus.toLowerCase();
+    // Check if constraint name/description matches focus
+    if (constraint.name.toLowerCase().includes(focusLower) ||
+        constraint.description.toLowerCase().includes(focusLower)) {
+        return `Directly related to "${focus}" - this constraint must be satisfied`;
+    }
+    // Intent-specific explanations
+    const intentExplanations = {
+        add_feature: {
+            api: 'API constraints ensure new endpoints follow established patterns',
+            auth: 'Authentication constraints protect new features',
+            data: 'Data access constraints ensure proper data handling',
+            error: 'Error handling constraints ensure robust error management',
+            validation: 'Validation constraints ensure input safety',
+            logging: 'Logging constraints ensure observability',
+            structural: 'Structural constraints maintain code organization',
+            security: 'Security constraints protect against vulnerabilities',
+            test: 'Test constraints ensure adequate coverage',
+            performance: 'Performance constraints prevent regressions',
+        },
+        fix_bug: {
+            error: 'Error handling constraints may reveal the bug pattern',
+            data: 'Data constraints ensure fix doesn\'t break data integrity',
+            validation: 'Validation constraints may be the root cause',
+            logging: 'Logging constraints help debug the issue',
+            api: 'API constraints ensure fix maintains compatibility',
+            auth: 'Auth constraints ensure fix doesn\'t create security holes',
+            security: 'Security constraints must be maintained during fix',
+            structural: 'Structural constraints guide where fix should go',
+            test: 'Test constraints ensure fix is properly tested',
+            performance: 'Performance constraints ensure fix doesn\'t regress',
+        },
+        refactor: {
+            structural: 'Structural constraints guide refactoring direction',
+            api: 'API constraints ensure refactor maintains compatibility',
+            data: 'Data constraints ensure refactor preserves data handling',
+            performance: 'Performance constraints ensure refactor improves efficiency',
+            error: 'Error handling must be preserved during refactor',
+            auth: 'Auth patterns must be maintained',
+            security: 'Security patterns must be preserved',
+            validation: 'Validation must be maintained',
+            logging: 'Logging must be preserved',
+            test: 'Tests must continue to pass',
+        },
+        security_audit: {
+            security: 'Security constraints define required protections',
+            auth: 'Auth constraints ensure proper authentication',
+            data: 'Data constraints protect sensitive information',
+            validation: 'Validation constraints prevent injection attacks',
+            api: 'API constraints ensure secure endpoints',
+            error: 'Error handling must not leak sensitive info',
+            logging: 'Logging must not expose sensitive data',
+            structural: 'Structure affects security boundaries',
+            test: 'Security tests must exist',
+            performance: 'Performance affects DoS resistance',
+        },
+        understand_code: {
+            api: 'API constraints explain endpoint requirements',
+            data: 'Data constraints explain data flow rules',
+            structural: 'Structural constraints explain code organization',
+            auth: 'Auth constraints explain security model',
+            error: 'Error constraints explain error handling approach',
+            security: 'Security constraints explain protection model',
+            validation: 'Validation constraints explain input requirements',
+            logging: 'Logging constraints explain observability approach',
+            test: 'Test constraints explain testing strategy',
+            performance: 'Performance constraints explain optimization rules',
+        },
+        add_test: {
+            test: 'Test constraints define testing requirements',
+            error: 'Error constraints show what error cases to test',
+            data: 'Data constraints show what data scenarios to test',
+            api: 'API constraints show what endpoints need testing',
+            auth: 'Auth constraints show security scenarios to test',
+            security: 'Security constraints show attack vectors to test',
+            validation: 'Validation constraints show input cases to test',
+            logging: 'Logging constraints show what to verify in logs',
+            structural: 'Structure affects test organization',
+            performance: 'Performance constraints show what to benchmark',
+        },
+    };
+    const explanation = intentExplanations[intent]?.[constraint.category];
+    if (explanation) {
+        return explanation;
+    }
+    // Default explanation
+    return `${constraint.category} constraint with ${Math.round(constraint.confidence.score * 100)}% confidence`;
+}
 /**
  * Find source files matching the focus term
  */