mcp-adr-analysis-server 2.6.20 → 2.7.19

package/dist/src/tools/perform-research-tool.js

@@ -8,6 +8,7 @@ import { McpAdrError } from '../types/index.js';
 import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
 import { ToolContextManager } from '../utils/context-document-manager.js';
 import * as path from 'path';
+import { existsSync } from 'fs';
 /**
  * Perform research using the orchestrated multi-source approach
  *
@@ -54,8 +55,56 @@ import * as path from 'path';
  * @category Tools
  * @mcp-tool
  */
+/**
+ * Which ADR files did this research actually read?
+ *
+ * Derived from the project_files source rather than re-globbing the directory:
+ * listing every ADR that exists would assert a link the research never made, and
+ * an over-broad citation is worse than none -- it makes the link unfalsifiable.
+ *
+ * Exported for test. The citation rule is the whole substance of #1528 -- if it
+ * silently stopped matching, every generated document would go back to citing
+ * nothing and the file would still be written, so the failure is invisible from
+ * the outside. Reaching it through performResearch() would mean standing up the
+ * orchestrator, so the rule is tested directly.
+ */
+export function collectConsultedAdrs(sources, projectPath, adrDirectory) {
+    const adrRoot = path.resolve(projectPath, adrDirectory);
+    const files = sources
+        .filter(s => s.type === 'project_files')
+        .flatMap(s => (Array.isArray(s.data?.files) ? s.data.files : []));
+    const seen = new Set();
+    for (const f of files) {
+        if (typeof f !== 'string')
+            continue;
+        if (!f.endsWith('.md'))
+            continue;
+        if (path.basename(f).toLowerCase() === 'readme.md')
+            continue;
+        // Two path conventions arrive in this one list, because the orchestrator
+        // builds it from two different roots:
+        //
+        //   PHASE 4  findFiles(projectPath, ['**/*<keyword>*'])  -> 'docs/adrs/adr-001.md'
+        //   PHASE 3  findFiles(adrPath,     ['**/*.md'])         -> 'adr-001.md'
+        //
+        // Resolving only against projectPath dropped every PHASE 3 entry -- the
+        // "Always include ADRs" pass, which is the source this citation was written
+        // to read. It looked correct against this repository only because PHASE 4's
+        // keyword search happens to match ADR filenames here.
+        //
+        // Existence is checked rather than inferred: the adrRoot-relative reading of
+        // an arbitrary 'docs/planning/x.md' also lands under adrRoot, so a path test
+        // alone would invent citations. A cited ADR is one that is on disk, which is
+        // also what the link check in #1527 will require.
+        const abs = [path.resolve(projectPath, f), path.resolve(adrRoot, f)].find(candidate => candidate.startsWith(adrRoot + path.sep) && existsSync(candidate));
+        if (!abs)
+            continue;
+        seen.add(path.relative(projectPath, abs));
+    }
+    return [...seen].sort();
+}
 export async function performResearch(args, context) {
-    const { question, projectPath = process.cwd(), adrDirectory = 'docs/adrs', confidenceThreshold = 0.6, performWebSearch = true, } = args;
+    const { question, projectPath = process.cwd(), adrDirectory = 'docs/adrs', researchDirectory = 'docs/research', confidenceThreshold = 0.6, performWebSearch = true, } = args;
     if (!question || question.trim().length === 0) {
         throw new McpAdrError('Research question is required', 'INVALID_INPUT');
     }
@@ -185,7 +234,11 @@ ${generateSearchQueries(question)
         // Save research context for future sessions
         try {
             const contextManager = new ToolContextManager(projectPath);
-            await contextManager.initialize();
+            // No initialize() call: it eagerly mkdir -p's every category under
+            // docs/context/, which left an empty docs/context/research/ in the user's
+            // tree even when the document was written to researchDirectory. saveContext
+            // creates its own target directory, so initialize() is redundant here and
+            // its only effect was the orphan. (#1528)
             const contextDoc = {
                 metadata: {
                     toolName: 'perform_research',
@@ -250,7 +303,17 @@ ${generateSearchQueries(question)
                     environmentSpecific: [],
                 },
                 relatedDocuments: {
-                    adrs: [],
+                    // The ADRs this research actually consulted, not an empty array.
+                    //
+                    // research-orchestrator.ts PHASE 3 ("Always include ADRs") globs every
+                    // file under adrDirectory into the project_files source, and this write
+                    // site used to hardcode `adrs: []` -- discarding it. That single line is
+                    // why 187 generated research documents cite zero ADRs between them,
+                    // while docs/research/README.md has required since 2025-12 that "all
+                    // research must link to relevant ADRs". The field existed, the renderer
+                    // existed (context-document-manager.ts:431 emits "**ADRs**:"), and the
+                    // data was gathered. Only the assignment was missing. (#1528)
+                    adrs: collectConsultedAdrs(research.sources, projectPath, adrDirectory),
                     configs: [],
                     otherContexts: [],
                 },
@@ -264,7 +327,7 @@ ${generateSearchQueries(question)
                     },
                 },
             };
-            await contextManager.saveContext('research', contextDoc);
+            await contextManager.saveContext('research', contextDoc, path.resolve(projectPath, researchDirectory));
             context?.info('💾 Research context saved for future reference');
         }
         catch (contextError) {

package/dist/src/tools/perform-research-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"perform-research-tool.js","sourceRoot":"","sources":["../../../src/tools/perform-research-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAA4B,MAAM,sCAAsC,CAAC;AACpG,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAMC,EACD,OAAqB;IAErB,MAAM,EACJ,QAAQ,EACR,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,EAC3B,YAAY,GAAG,WAAW,EAC1B,mBAAmB,GAAG,GAAG,EACzB,gBAAgB,GAAG,IAAI,GACxB,GAAG,IAAI,CAAC;IAET,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,WAAW,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;QACnD,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAEjC,+BAA+B;QAC/B,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACzE,YAAY,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;QAEzD,OAAO,EAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,OAAO,EAAE,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAElC,uFAAuF;QACvF,OAAO,EAAE,IAAI,CAAC,0DAA0D,CAAC,CAAC;QAC1E,OAAO,EAAE,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAElC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAErE,OAAO,EAAE,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,EAAE,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAElC,kBAAkB;QAClB,IAAI,QAAQ,GAAG,uBAAuB,QAAQ;;;EAGhD,QAAQ,CAAC,MAAM,IAAI,oDAAoD;;uBAElD,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;;;CAG5D,CAAC;QAEE,qBAAqB;QACrB,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,QAAQ,IAAI,iCAAiC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtC,QAAQ,IAAI,SAAS,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC;oBACtC,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;mBACrC,MAAM,CAAC,SAAS;CAClC,CAAC;gBAEM,8BAA8B;gBAC9B,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACtC,QAAQ,IAAI,sBAAsB,KAAK,CAAC,MAAM,IAAI,CAAC;oBAEnD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,QAAQ,IAAI,yBAAyB,CAAC;wBACtC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAY,EAAE,EAAE;4BAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;4BAChD,QAAQ,IAAI,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;wBACpG,CAAC,CAAC,CAAC;wBAEH,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;4BACtB,QAAQ,IAAI,cAAc,KAAK,CAAC,MAAM,GAAG,EAAE,gBAAgB,CAAC;wBAC9D,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;oBACtC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACtC,QAAQ,IAAI,uBAAuB,KAAK,CAAC,MAAM,IAAI,CAAC;gBACtD,CAAC;gBAED,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBAClC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;oBACpD,QAAQ,IAAI,iCAAiC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBAEzE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;wBACjC,QAAQ,IAAI,2BAA2B,CAAC;wBACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;4BACpC,QAAQ,IAAI,OAAO,GAAG,CAAC,UAAU,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC;wBACvF,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,QAAQ,CAAC,cAAc,IAAI,gBAAgB,EAAE,CAAC;YAChD,QAAQ,IAAI;;;;iCAIe,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;;;;EAIrE,qBAAqB,CAAC,QAAQ,CAAC;iBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;iBACpB,IAAI,CAAC,IAAI,CAAC;CACZ,CAAC;QACE,CAAC;QAED,WAAW;QACX,QAAQ,IAAI;;;kBAGE,QAAQ,CAAC,QAAQ,CAAC,QAAQ;yBACnB,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC5C,QAAQ,CAAC,QAAQ,CAAC,aAAa;4BAC3B,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;;;;CAIjE,CAAC;QAEE,IAAI,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC/B,QAAQ,IAAI;CACjB,CAAC;QACE,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACtC,QAAQ,IAAI;CACjB,CAAC;QACE,CAAC;aAAM,CAAC;YACN,QAAQ,IAAI;CACjB,CAAC;QACE,CAAC;QAED,mCAAmC;QACnC,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,EAAE,CAAC;YAC3D,QAAQ,IAAI;;;;;CAKjB,CAAC;QACE,CAAC;QAED,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,EAAE,CAAC;YACzD,QAAQ,IAAI;;;;;CAKjB,CAAC;QACE,CAAC;QAED,OAAO,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,OAAO,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEnC,4CAA4C;QAC5C,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAC3D,MAAM,cAAc,CAAC,UAAU,EAAE,CAAC;YAElC,MAAM,UAAU,GAAwB;gBACtC,QAAQ,EAAE;oBACR,QAAQ,EAAE,kBAAkB;oBAC5B,WAAW,EAAE,OAAO;oBACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,WAAW;oBACX,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;oBACvC,MAAM,EAAE,QAAQ,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;oBAC1E,UAAU,EAAE,QAAQ,CAAC,UAAU,GAAG,GAAG;iBACtC;gBACD,cAAc,EAAE,cAAc,QAAQ,OAAO,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC7K,gBAAgB,EAAE;oBAChB,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc;oBACvF,UAAU,EAAE,QAAQ,CAAC,UAAU,GAAG,GAAG;oBACrC,WAAW,EAAE;wBACX,aAAa,QAAQ,EAAE;wBACvB,eAAe,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;wBACxD,sBAAsB,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBACnE,mBAAmB,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE;wBACpD,aAAa,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI;qBAC5C;iBACF;gBACD,eAAe,EAAE;oBACf,QAAQ;oBACR,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;wBAClC,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,SAAS,EAAE,CAAC,CAAC,SAAS;wBACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;qBAC3D,CAAC,CAAC;oBACH,cAAc,EAAE,QAAQ,CAAC,cAAc;iBACxC;gBACD,YAAY,EAAE;oBACZ;wBACE,QAAQ,EAAE,sBAAsB,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;wBAC9E,SAAS,EAAE,0EAA0E;wBACrF,YAAY,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;qBAC1D;iBACF;gBACD,SAAS,EAAE;oBACT,SAAS,EACP,QAAQ,CAAC,UAAU,IAAI,GAAG;wBACxB,CAAC,CAAC,CAAC,2CAA2C,EAAE,oCAAoC,CAAC;wBACrF,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG;4BAC1B,CAAC,CAAC,CAAC,6BAA6B,EAAE,0BAA0B,CAAC;4BAC7D,CAAC,CAAC,EAAE;oBACV,QAAQ,EACN,QAAQ,CAAC,UAAU,GAAG,GAAG;wBACvB,CAAC,CAAC;4BACE,0CAA0C;4BAC1C,wCAAwC;yBACzC;wBACH,CAAC,CAAC,EAAE;oBACR,eAAe,EACb,QAAQ,CAAC,UAAU,IAAI,GAAG;wBACxB,CAAC,CAAC,CAAC,qCAAqC,EAAE,sCAAsC,CAAC;wBACjF,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG;4BAC1B,CAAC,CAAC;gCACE,2CAA2C;gCAC3C,+CAA+C;6BAChD;4BACH,CAAC,CAAC,CAAC,2CAA2C,EAAE,6BAA6B,CAAC;oBACpF,mBAAmB,EAAE,EAAE;iBACxB;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,EAAE;oBACR,OAAO,EAAE,EAAE;oBACX,aAAa,EAAE,EAAE;iBAClB;gBACD,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR,MAAM,EAAE,QAAQ,CAAC,MAAM;wBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;wBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;wBACzB,cAAc,EAAE,QAAQ,CAAC,cAAc;wBACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;qBAC5B;iBACF;aACF,CAAC;YAEF,MAAM,cAAc,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACzD,OAAO,EAAE,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,kDAAkD;YAClD,OAAO,EAAE,IAAI,CAAC,uCAAuC,YAAY,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ;iBACf;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACvF,gBAAgB,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,MAAM,KAAK,GAA2B;QACpC,aAAa,EAAE,kBAAkB;QACjC,eAAe,EAAE,oBAAoB;QACrC,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,eAAe;KAC5B,CAAC;IAEF,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,MAAM,OAAO,GAAa,CAAC,QAAQ,CAAC,CAAC;IAErC,iBAAiB;IACjB,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE7C,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,+BAA+B;IAC/B,IAAI,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,4BAA4B,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,oBAAoB,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,0BAA0B,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB;AAC/C,CAAC"}
+{"version":3,"file":"perform-research-tool.js","sourceRoot":"","sources":["../../../src/tools/perform-research-tool.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/tool-catalog.d.ts

@@ -5,7 +5,7 @@
  * for dynamic discovery, categorization, and token-efficient listing.
  *
  * @see ADR-014: CE-MCP Architecture (Phase 3)
- * @see docs/IMPLEMENTATION-PLAN.md
+ * @see docs/planning/IMPLEMENTATION-PLAN.md
  */
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 /**