@decaf-ts/mcp-server 0.4.9 → 0.4.16

package/lib/tools/ast-jsdoc-tools/tool3/fileProcessor.cjs

@@ -0,0 +1,35 @@
+"use strict";
+// import type { ASTObject } from '../tool1/extractor';
+// import type { JSDocSuggestion } from '../tool2/suggester';
+// import { suggestJSDoc } from '../tool2/suggester';
+// import { extractAstObjects } from '../tool1/extractor';
+//
+// export type FileReport = {
+//   filePath: string;
+//   astObjects: ASTObject[];
+//   suggestions: JSDocSuggestion[];
+//   summary: { objectsFound: number; suggestionsGenerated: number };
+// };
+//
+// export async function processFile(filePath: string, opts: { dryRun?: boolean } = {}): Promise<FileReport> {
+//   const astObjects = await extractAstObjects(filePath);
+//   const suggestions: JSDocSuggestion[] = [];
+//   for (const obj of astObjects) {
+//     try {
+//       const sug = await suggestJSDoc(obj);
+//       suggestions.push(sug);
+//     } catch (_e) {
+//       // on error, push a failed suggestion entry
+//       suggestions.push({ id: obj.id, text: '', confidence: 0 });
+//     }
+//   }
+//   return {
+//     filePath,
+//     astObjects,
+//     suggestions,
+//     summary: { objectsFound: astObjects.length, suggestionsGenerated: suggestions.length },
+//   };
+// }
+//
+//
+//# sourceMappingURL=fileProcessor.js.map

package/lib/tools/ast-jsdoc-tools/tool3/fileProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileProcessor.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/tool3/fileProcessor.ts"],"names":[],"mappings":";AAAA,uDAAuD;AACvD,6DAA6D;AAC7D,qDAAqD;AACrD,0DAA0D;AAC1D,EAAE;AACF,6BAA6B;AAC7B,sBAAsB;AACtB,6BAA6B;AAC7B,oCAAoC;AACpC,qEAAqE;AACrE,KAAK;AACL,EAAE;AACF,8GAA8G;AAC9G,0DAA0D;AAC1D,+CAA+C;AAC/C,oCAAoC;AACpC,YAAY;AACZ,6CAA6C;AAC7C,+BAA+B;AAC/B,qBAAqB;AACrB,oDAAoD;AACpD,mEAAmE;AACnE,QAAQ;AACR,MAAM;AACN,aAAa;AACb,gBAAgB;AAChB,kBAAkB;AAClB,mBAAmB;AACnB,8FAA8F;AAC9F,OAAO;AACP,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/ast-jsdoc-tools/tool4/repoRunner.cjs

@@ -0,0 +1,116 @@
+"use strict";
+// import * as fs from 'fs';
+// import * as path from 'path';
+// import { emit } from '../utils/logging';
+// import { createBackup } from '../utils/backups';
+// import type { FileReport } from '../tool3/fileProcessor';
+// import { processFile } from '../tool3/fileProcessor';
+//
+// export type RepositoryRunReport = {
+//   runId: string;
+//   rootPath: string;
+//   filesProcessed: number;
+//   suggestionsTotal: number;
+//   fileReports: FileReport[];
+//   startedAt: string;
+//   finishedAt?: string;
+// };
+//
+// async function listTsFiles(dir: string, ignoreDirs = new Set(['node_modules', 'dist', 'build'])): Promise<string[]> {
+//   const results: string[] = [];
+//   async function walk(d: string) {
+//     let entries: string[] = [];
+//     try {
+//       entries = await fs.promises.readdir(d, { withFileTypes: true }).then((es) => es.map((e) => e.name));
+//     } catch (e) {
+//       return;
+//     }
+//     for (const name of entries) {
+//       const full = path.join(d, name);
+//       try {
+//         const stat = await fs.promises.stat(full);
+//         if (stat.isDirectory()) {
+//           if (ignoreDirs.has(name)) continue;
+//           await walk(full);
+//         } else if (stat.isFile() && name.endsWith('.ts')) {
+//           results.push(full);
+//         }
+//       } catch (e) {
+//         // ignore
+//       }
+//     }
+//   }
+//   await walk(dir);
+//   return results;
+// }
+//
+// function makeRunId() {
+//   return `run-${Date.now()}`;
+// }
+//
+// async function writeJsonReport(outPath: string, obj: unknown) {
+//   await fs.promises.mkdir(path.dirname(outPath), { recursive: true });
+//   await fs.promises.writeFile(outPath, JSON.stringify(obj, null, 2), 'utf8');
+// }
+//
+// export async function runRepository(root: string, opts: { dryRun?: boolean; concurrency?: number } = {}): Promise<RepositoryRunReport> {
+//   const runId = makeRunId();
+//   const startedAt = new Date().toISOString();
+//   emit('run:start', { runId, root });
+//
+//   const concurrency = opts.concurrency || 4;
+//   const files = await listTsFiles(root);
+//   const fileReports: FileReport[] = [];
+//
+//   // Simple concurrency limiter
+//   let index = 0;
+//   const errors: string[] = [];
+//
+//   async function worker() {
+//     while (true) {
+//       const i = index++;
+//       if (i >= files.length) break;
+//       const filePath = files[i];
+//       emit('file:start', { runId, file: filePath });
+//       try {
+//         const report = await processFile(filePath, { dryRun: !!opts.dryRun });
+//         fileReports.push(report);
+//         emit('file:complete', { runId, file: filePath, objects: report.astObjects.length });
+//       } catch (e: any) {
+//         errors.push(`${filePath}: ${String(e?.message || e)}`);
+//         emit('file:error', { runId, file: filePath, error: String(e?.message || e) });
+//       }
+//     }
+//   }
+//
+//   const workers = [] as Promise<void>[];
+//   for (let i = 0; i < concurrency; i++) workers.push(worker());
+//   await Promise.all(workers);
+//
+//   const suggestionsTotal = fileReports.reduce((s, r) => s + r.suggestions.length, 0);
+//
+//   const report: RepositoryRunReport = {
+//     runId,
+//     rootPath: root,
+//     filesProcessed: files.length,
+//     suggestionsTotal,
+//     fileReports,
+//     startedAt,
+//     finishedAt: new Date().toISOString(),
+//   };
+//
+//   // Write final report and checkpoint
+//   const reportsDir = path.join('specs', '001-ast-jsdoc-tools', 'reports');
+//   const outPath = path.join(reportsDir, `${runId}-repo-report.json`);
+//   await writeJsonReport(outPath, report);
+//   // also write simple checkpoint
+//   const checkpointPath = path.join(reportsDir, 'checkpoints', `${runId}.json`);
+//   await writeJsonReport(checkpointPath, { runId, filesProcessed: files.length, finishedAt: report.finishedAt, errors });
+//
+//   emit('run:complete', { runId, root, filesProcessed: files.length, suggestionsTotal, errors: errors.length });
+//
+//   return report;
+// }
+//
+//
+//# sourceMappingURL=repoRunner.js.map

package/lib/tools/ast-jsdoc-tools/tool4/repoRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoRunner.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/tool4/repoRunner.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,gCAAgC;AAChC,2CAA2C;AAC3C,mDAAmD;AACnD,4DAA4D;AAC5D,wDAAwD;AACxD,EAAE;AACF,sCAAsC;AACtC,mBAAmB;AACnB,sBAAsB;AACtB,4BAA4B;AAC5B,8BAA8B;AAC9B,+BAA+B;AAC/B,uBAAuB;AACvB,yBAAyB;AACzB,KAAK;AACL,EAAE;AACF,wHAAwH;AACxH,kCAAkC;AAClC,qCAAqC;AACrC,kCAAkC;AAClC,YAAY;AACZ,6GAA6G;AAC7G,oBAAoB;AACpB,gBAAgB;AAChB,QAAQ;AACR,oCAAoC;AACpC,yCAAyC;AACzC,cAAc;AACd,qDAAqD;AACrD,oCAAoC;AACpC,gDAAgD;AAChD,8BAA8B;AAC9B,8DAA8D;AAC9D,gCAAgC;AAChC,YAAY;AACZ,sBAAsB;AACtB,oBAAoB;AACpB,UAAU;AACV,QAAQ;AACR,MAAM;AACN,qBAAqB;AACrB,oBAAoB;AACpB,IAAI;AACJ,EAAE;AACF,yBAAyB;AACzB,gCAAgC;AAChC,IAAI;AACJ,EAAE;AACF,kEAAkE;AAClE,yEAAyE;AACzE,gFAAgF;AAChF,IAAI;AACJ,EAAE;AACF,2IAA2I;AAC3I,+BAA+B;AAC/B,gDAAgD;AAChD,wCAAwC;AACxC,EAAE;AACF,+CAA+C;AAC/C,2CAA2C;AAC3C,0CAA0C;AAC1C,EAAE;AACF,kCAAkC;AAClC,mBAAmB;AACnB,iCAAiC;AACjC,EAAE;AACF,8BAA8B;AAC9B,qBAAqB;AACrB,2BAA2B;AAC3B,sCAAsC;AACtC,mCAAmC;AACnC,uDAAuD;AACvD,cAAc;AACd,iFAAiF;AACjF,oCAAoC;AACpC,+FAA+F;AAC/F,2BAA2B;AAC3B,kEAAkE;AAClE,yFAAyF;AACzF,UAAU;AACV,QAAQ;AACR,MAAM;AACN,EAAE;AACF,2CAA2C;AAC3C,kEAAkE;AAClE,gCAAgC;AAChC,EAAE;AACF,wFAAwF;AACxF,EAAE;AACF,0CAA0C;AAC1C,aAAa;AACb,sBAAsB;AACtB,oCAAoC;AACpC,wBAAwB;AACxB,mBAAmB;AACnB,iBAAiB;AACjB,4CAA4C;AAC5C,OAAO;AACP,EAAE;AACF,yCAAyC;AACzC,6EAA6E;AAC7E,wEAAwE;AACxE,4CAA4C;AAC5C,oCAAoC;AACpC,kFAAkF;AAClF,2HAA2H;AAC3H,EAAE;AACF,kHAAkH;AAClH,EAAE;AACF,mBAAmB;AACnB,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/ast-jsdoc-tools/tools/jsdoc-generator.cjs

@@ -1,81 +1,80 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateForObject = generateForObject;
-function paramListFromSignature(sig) {
-    const m = sig.match(/\(([^)]*)\)/);
-    if (!m)
-        return [];
-    const inside = m[1].trim();
-    if (!inside)
-        return [];
-    return inside.split(',').map((s) => s.split(':')[0].trim().replace(/[\s=].*$/, ''));
-}
-function generateForObject(obj) {
-    const kind = (obj.kind || '').toLowerCase();
-    const sig = obj.signature || obj.signature === '' ? obj.signature : '';
-    let needsReview = false;
-    let lines = [];
-    if (kind === 'function' || kind === 'functiondeclaration' || kind === 'functionexpression') {
-        if (!sig)
-            needsReview = true;
-        const params = paramListFromSignature(sig);
-        lines.push('/**');
-        lines.push(` * Function: ${obj.name || 'function'}`);
-        for (const p of params)
-            lines.push(` * @param ${p} `);
-        const ret = sig.match(/:\s*([^\)\s]+)\s*$/);
-        if (ret)
-            lines.push(` * @returns ${ret[1]}`);
-        if (needsReview)
-            lines.push(` * TODO: Describe ${obj.name || 'function'}`);
-        lines.push(' */');
-        return { suggestedDoc: lines.join('\n'), needsReview };
-    }
-    if (kind === 'class') {
-        // try to parse constructor params
-        const params = paramListFromSignature(sig);
-        lines.push('/**');
-        lines.push(` * Class: ${obj.name}`);
-        for (const p of params)
-            lines.push(` * @param ${p} `);
-        lines.push(' */');
-        return { suggestedDoc: lines.join('\n') };
-    }
-    if (kind === 'type' || kind === 'interface') {
-        // crude property listing
-        const props = (sig.match(/\{([^}]*)\}/) || [])[1] || '';
-        const parts = props.split(';').map((s) => s.trim()).filter(Boolean);
-        lines.push('/**');
-        lines.push(` * Type: ${obj.name}`);
-        for (const part of parts) {
-            const name = (part.split(':')[0] || '').trim();
-            if (name)
-                lines.push(` * @property ${name}`);
-        }
-        lines.push(' */');
-        return { suggestedDoc: lines.join('\n') };
-    }
-    if (kind === 'enum') {
-        const members = (sig.match(/\{([^}]*)\}/) || [])[1] || '';
-        const parts = members.split(',').map((s) => s.trim()).filter(Boolean);
-        lines.push('/**');
-        lines.push(` * Enum: ${obj.name}`);
-        for (const p of parts) {
-            const m = p.split('=')[0].trim();
-            if (m)
-                lines.push(` * @enum ${m}`);
-        }
-        lines.push(' */');
-        return { suggestedDoc: lines.join('\n') };
-    }
-    if (kind === 'constant' || kind === 'variable') {
-        lines.push('/**');
-        lines.push(` * constant: ${obj.name}`);
-        lines.push(' */');
-        return { suggestedDoc: lines.join('\n') };
-    }
-    // default fallback
-    return { suggestedDoc: `/**\n * TODO: Describe ${obj.name || 'item'}\n */`, needsReview: true };
-}
-exports.default = generateForObject;
+// import { JSDocSuggestion } from '../generator';
+//
+// function paramListFromSignature(sig: string) {
+//   const m = sig.match(/\(([^)]*)\)/);
+//   if (!m) return [] as string[];
+//   const inside = m[1].trim();
+//   if (!inside) return [];
+//   return inside.split(',').map((s: string) => s.split(':')[0].trim().replace(/[\s=].*$/, ''));
+// }
+//
+// export function generateForObject(obj: any): { suggestedDoc: string; needsReview?: boolean } {
+//   const kind = (obj.kind || '').toLowerCase();
+//   const sig = obj.signature || obj.signature === '' ? obj.signature : '';
+//   let needsReview = false;
+//   const lines: string[] = [];
+//
+//   if (kind === 'function' || kind === 'functiondeclaration' || kind === 'functionexpression') {
+//     if (!sig) needsReview = true;
+//     const params = paramListFromSignature(sig);
+//     lines.push('/**');
+//     lines.push(` * Function: ${obj.name || 'function'}`);
+//     for (const p of params) lines.push(` * @param ${p} `);
+//     const ret = sig.match(/:\s*([^\)\s]+)\s*$/);
+//     if (ret) lines.push(` * @returns ${ret[1]}`);
+//     if (needsReview) lines.push(` * TODO: Describe ${obj.name || 'function'}`);
+//     lines.push(' */');
+//     return { suggestedDoc: lines.join('\n'), needsReview };
+//   }
+//
+//   if (kind === 'class') {
+//     // try to parse constructor params
+//     const params = paramListFromSignature(sig);
+//     lines.push('/**');
+//     lines.push(` * Class: ${obj.name}`);
+//     for (const p of params) lines.push(` * @param ${p} `);
+//     lines.push(' */');
+//     return { suggestedDoc: lines.join('\n') };
+//   }
+//
+//   if (kind === 'type' || kind === 'interface') {
+//     // crude property listing
+//     const props = (sig.match(/\{([^}]*)\}/) || [])[1] || '';
+//     const parts = props.split(';').map((s: string) => s.trim()).filter(Boolean);
+//     lines.push('/**');
+//     lines.push(` * Type: ${obj.name}`);
+//     for (const part of parts) {
+//       const name = (part.split(':')[0] || '').trim();
+//       if (name) lines.push(` * @property ${name}`);
+//     }
+//     lines.push(' */');
+//     return { suggestedDoc: lines.join('\n') };
+//   }
+//
+//   if (kind === 'enum') {
+//     const members = (sig.match(/\{([^}]*)\}/) || [])[1] || '';
+//     const parts = members.split(',').map((s: string) => s.trim()).filter(Boolean);
+//     lines.push('/**');
+//     lines.push(` * Enum: ${obj.name}`);
+//     for (const p of parts) {
+//       const m = p.split('=')[0].trim();
+//       if (m) lines.push(` * @enum ${m}`);
+//     }
+//     lines.push(' */');
+//     return { suggestedDoc: lines.join('\n') };
+//   }
+//
+//   if (kind === 'constant' || kind === 'variable') {
+//     lines.push('/**');
+//     lines.push(` * constant: ${obj.name}`);
+//     lines.push(' */');
+//     return { suggestedDoc: lines.join('\n') };
+//   }
+//
+//   // default fallback
+//   return { suggestedDoc: `/**\n * TODO: Describe ${obj.name || 'item'}\n */`, needsReview: true };
+// }
+//
+//
 //# sourceMappingURL=jsdoc-generator.js.map

package/lib/tools/ast-jsdoc-tools/tools/jsdoc-generator.d.ts

@@ -1,5 +0,0 @@
-export declare function generateForObject(obj: any): {
-    suggestedDoc: string;
-    needsReview?: boolean;
-};
-export default generateForObject;

package/lib/tools/ast-jsdoc-tools/tools/jsdoc-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsdoc-generator.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/tools/jsdoc-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jsdoc-generator.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/tools/jsdoc-generator.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,EAAE;AACF,iDAAiD;AACjD,wCAAwC;AACxC,mCAAmC;AACnC,gCAAgC;AAChC,4BAA4B;AAC5B,iGAAiG;AACjG,IAAI;AACJ,EAAE;AACF,iGAAiG;AACjG,iDAAiD;AACjD,4EAA4E;AAC5E,6BAA6B;AAC7B,gCAAgC;AAChC,EAAE;AACF,kGAAkG;AAClG,oCAAoC;AACpC,kDAAkD;AAClD,yBAAyB;AACzB,4DAA4D;AAC5D,6DAA6D;AAC7D,mDAAmD;AACnD,oDAAoD;AACpD,kFAAkF;AAClF,yBAAyB;AACzB,8DAA8D;AAC9D,MAAM;AACN,EAAE;AACF,4BAA4B;AAC5B,yCAAyC;AACzC,kDAAkD;AAClD,yBAAyB;AACzB,2CAA2C;AAC3C,6DAA6D;AAC7D,yBAAyB;AACzB,iDAAiD;AACjD,MAAM;AACN,EAAE;AACF,mDAAmD;AACnD,gCAAgC;AAChC,+DAA+D;AAC/D,mFAAmF;AACnF,yBAAyB;AACzB,0CAA0C;AAC1C,kCAAkC;AAClC,wDAAwD;AACxD,sDAAsD;AACtD,QAAQ;AACR,yBAAyB;AACzB,iDAAiD;AACjD,MAAM;AACN,EAAE;AACF,2BAA2B;AAC3B,iEAAiE;AACjE,qFAAqF;AACrF,yBAAyB;AACzB,0CAA0C;AAC1C,+BAA+B;AAC/B,0CAA0C;AAC1C,4CAA4C;AAC5C,QAAQ;AACR,yBAAyB;AACzB,iDAAiD;AACjD,MAAM;AACN,EAAE;AACF,sDAAsD;AACtD,yBAAyB;AACzB,8CAA8C;AAC9C,yBAAyB;AACzB,iDAAiD;AACjD,MAAM;AACN,EAAE;AACF,wBAAwB;AACxB,qGAAqG;AACrG,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/ast-jsdoc-tools/utils/backups.cjs

@@ -0,0 +1,14 @@
+"use strict";
+// import * as fs from 'fs';
+// import * as path from 'path';
+//
+// export async function createBackup(runId: string, relativePath: string, content: string) {
+//   const base = path.join('specs', '001-ast-jsdoc-tools', 'reports', 'backups', runId);
+//   await fs.promises.mkdir(path.dirname(path.join(base, relativePath)), { recursive: true });
+//   const out = path.join(base, relativePath + '.orig');
+//   await fs.promises.writeFile(out, content, 'utf8');
+//   return out;
+// }
+//
+//
+//# sourceMappingURL=backups.js.map

package/lib/tools/ast-jsdoc-tools/utils/backups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backups.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/backups.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,gCAAgC;AAChC,EAAE;AACF,6FAA6F;AAC7F,yFAAyF;AACzF,+FAA+F;AAC/F,yDAAyD;AACzD,uDAAuD;AACvD,gBAAgB;AAChB,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/ast-jsdoc-tools/utils/conflict-detector.cjs

@@ -1,33 +1,30 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasExistingJsDoc = hasExistingJsDoc;
-function hasExistingJsDoc(fileContent, nodeStartLine) {
-    const lines = fileContent.split(/\r?\n/);
-    // look up to 10 lines above the node start for a JSDoc block
-    const startIdx = Math.max(0, nodeStartLine - 10); // nodeStartLine is 1-based
-    // check from the provided line (nodeStartLine - 1) upwards
-    for (let i = nodeStartLine - 1; i >= startIdx; i--) {
-        const line = (lines[i] || '').trim();
-        if (line.endsWith('*/') || line === '*/') {
-            // gather the block
-            let j = i;
-            const blockLines = [];
-            while (j >= 0) {
-                blockLines.unshift(lines[j]);
-                if (lines[j].trim().startsWith('/**'))
-                    break;
-                j--;
-            }
-            const block = blockLines.join('\n');
-            if (block.includes('/**')) {
-                return { has: true, block };
-            }
-        }
-        // stop if hit a blank line or code line without comment marker
-        if (line && !line.startsWith('*') && !line.startsWith('//') && !line.startsWith('/**'))
-            break;
-    }
-    return { has: false, block: '' };
-}
-exports.default = hasExistingJsDoc;
+// export function hasExistingJsDoc(fileContent: string, nodeStartLine: number) {
+//   const lines = fileContent.split(/\r?\n/);
+//   // look up to 10 lines above the node start for a JSDoc block
+//   const startIdx = Math.max(0, nodeStartLine - 10); // nodeStartLine is 1-based
+//   // check from the provided line (nodeStartLine - 1) upwards
+//   for (let i = nodeStartLine - 1; i >= startIdx; i--) {
+//     const line = (lines[i] || '').trim();
+//     if (line.endsWith('*/') || line === '*/') {
+//       // gather the block
+//       let j = i;
+//       const blockLines = [] as string[];
+//       while (j >= 0) {
+//         blockLines.unshift(lines[j]);
+//         if (lines[j].trim().startsWith('/**')) break;
+//         j--;
+//       }
+//       const block = blockLines.join('\n');
+//       if (block.includes('/**')) {
+//         return { has: true, block };
+//       }
+//     }
+//     // stop if hit a blank line or code line without comment marker
+//     if (line && !line.startsWith('*') && !line.startsWith('//') && !line.startsWith('/**')) break;
+//   }
+//   return { has: false, block: '' };
+// }
+//
+//
 //# sourceMappingURL=conflict-detector.js.map

package/lib/tools/ast-jsdoc-tools/utils/conflict-detector.d.ts

@@ -1,5 +0,0 @@
-export declare function hasExistingJsDoc(fileContent: string, nodeStartLine: number): {
-    has: boolean;
-    block: string;
-};
-export default hasExistingJsDoc;

package/lib/tools/ast-jsdoc-tools/utils/conflict-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"conflict-detector.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/conflict-detector.ts"],"names":[],"mappings":";;AAAA,4CAyBC;AAzBD,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,aAAqB;IACzE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC,2BAA2B;IAC7E,2DAA2D;IAC3D,KAAK,IAAI,CAAC,GAAG,aAAa,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACzC,mBAAmB;YACnB,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,MAAM,UAAU,GAAG,EAAc,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACd,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;oBAAE,MAAM;gBAC7C,CAAC,EAAE,CAAC;YACN,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,+DAA+D;QAC/D,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM;IAChG,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,kBAAe,gBAAgB,CAAC"}
+{"version":3,"file":"conflict-detector.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/conflict-detector.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,8CAA8C;AAC9C,kEAAkE;AAClE,kFAAkF;AAClF,gEAAgE;AAChE,0DAA0D;AAC1D,4CAA4C;AAC5C,kDAAkD;AAClD,4BAA4B;AAC5B,mBAAmB;AACnB,2CAA2C;AAC3C,yBAAyB;AACzB,wCAAwC;AACxC,wDAAwD;AACxD,eAAe;AACf,UAAU;AACV,6CAA6C;AAC7C,qCAAqC;AACrC,uCAAuC;AACvC,UAAU;AACV,QAAQ;AACR,sEAAsE;AACtE,qGAAqG;AACrG,MAAM;AACN,sCAAsC;AACtC,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/ast-jsdoc-tools/utils/context-schema.cjs

@@ -1,32 +1,30 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateMappingFile = validateMappingFile;
-/** Very small validator for the mapping file used by the tool.
- * Returns { valid, errors } where errors is a list of strings describing issues.
- */
-function validateMappingFile(obj) {
-    const errors = [];
-    if (!obj || typeof obj !== 'object') {
-        return { valid: false, errors: ['mapping is not an object'] };
-    }
-    if (!obj.mappingVersion || typeof obj.mappingVersion !== 'string') {
-        errors.push('mappingVersion must be a string');
-    }
-    if (obj.overrides) {
-        if (typeof obj.overrides !== 'object')
-            errors.push('overrides must be an object');
-        else if (obj.overrides.files) {
-            if (!Array.isArray(obj.overrides.files))
-                errors.push('overrides.files must be an array');
-            else {
-                for (const [i, e] of obj.overrides.files.entries()) {
-                    if (!e.pattern || typeof e.pattern !== 'string')
-                        errors.push(`overrides.files[${i}].pattern must be a string`);
-                }
-            }
-        }
-    }
-    // heuristics optional
-    return { valid: errors.length === 0, errors };
-}
+// type MappingEntry = { pattern: string; role?: string; preferredTemplate?: string };
+// type MappingFile = { mappingVersion: string; overrides?: { files?: MappingEntry[] }; heuristics?: Record<string, any> };
+//
+// /** Very small validator for the mapping file used by the tool.
+//  * Returns { valid, errors } where errors is a list of strings describing issues.
+//  */
+// export function validateMappingFile(obj: any): { valid: boolean; errors: string[] } {
+//   const errors: string[] = [];
+//   if (!obj || typeof obj !== 'object') {
+//     return { valid: false, errors: ['mapping is not an object'] };
+//   }
+//   if (!obj.mappingVersion || typeof obj.mappingVersion !== 'string') {
+//     errors.push('mappingVersion must be a string');
+//   }
+//   if (obj.overrides) {
+//     if (typeof obj.overrides !== 'object') errors.push('overrides must be an object');
+//     else if (obj.overrides.files) {
+//       if (!Array.isArray(obj.overrides.files)) errors.push('overrides.files must be an array');
+//       else {
+//         for (const [i, e] of obj.overrides.files.entries()) {
+//           if (!e.pattern || typeof e.pattern !== 'string') errors.push(`overrides.files[${i}].pattern must be a string`);
+//         }
+//       }
+//     }
+//   }
+//   // heuristics optional
+//   return { valid: errors.length === 0, errors };
+// }
 //# sourceMappingURL=context-schema.js.map

package/lib/tools/ast-jsdoc-tools/utils/context-schema.d.ts

@@ -1,7 +0,0 @@
-/** Very small validator for the mapping file used by the tool.
- * Returns { valid, errors } where errors is a list of strings describing issues.
- */
-export declare function validateMappingFile(obj: any): {
-    valid: boolean;
-    errors: string[];
-};

package/lib/tools/ast-jsdoc-tools/utils/context-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-schema.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/context-schema.ts"],"names":[],"mappings":";;AAMA,kDAqBC;AAxBD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,GAAQ;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QAClE,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;aAC7E,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;iBACpF,CAAC;gBACJ,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;oBACnD,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;wBAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,4BAA4B,CAAC,CAAC;gBACjH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,sBAAsB;IACtB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"context-schema.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/context-schema.ts"],"names":[],"mappings":";AAAA,sFAAsF;AACtF,2HAA2H;AAC3H,EAAE;AACF,kEAAkE;AAClE,oFAAoF;AACpF,MAAM;AACN,wFAAwF;AACxF,iCAAiC;AACjC,2CAA2C;AAC3C,qEAAqE;AACrE,MAAM;AACN,yEAAyE;AACzE,sDAAsD;AACtD,MAAM;AACN,yBAAyB;AACzB,yFAAyF;AACzF,sCAAsC;AACtC,kGAAkG;AAClG,eAAe;AACf,gEAAgE;AAChE,4HAA4H;AAC5H,YAAY;AACZ,UAAU;AACV,QAAQ;AACR,MAAM;AACN,2BAA2B;AAC3B,mDAAmD;AACnD,IAAI"}

package/lib/tools/ast-jsdoc-tools/utils/heuristics.cjs

@@ -1,34 +1,28 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.inferContextHints = inferContextHints;
-function inferContextHints(filePath, repoRoot = '.') {
-    const hints = [];
-    const p = filePath.replace(/\\/g, '/');
-    const parts = p.split('/');
-    // directory-based hints
-    if (p.includes('/cli/') || p.endsWith('.cli.ts') || p.includes('/bin/'))
-        hints.push('cli');
-    if (p.includes('/api/'))
-        hints.push('api');
-    if (/\.controller\./.test(p) || p.includes('.controller'))
-        hints.push('controller');
-    if (p.includes('/tests/') || p.includes('/test-fixtures/'))
-        hints.push('test');
-    if (p.startsWith('lib/') || p.startsWith('dist/') || p.startsWith('build/'))
-        hints.push('library');
-    // filename-based hints
-    const file = parts[parts.length - 1] || '';
-    if (/index\./i.test(file))
-        hints.push('index');
-    if (/service\.|\.service\./i.test(file))
-        hints.push('service');
-    if (/router\.|\.router\./i.test(file))
-        hints.push('router');
-    // export surface heuristics
-    if (p.includes('/src/'))
-        hints.push('source');
-    // normalize unique
-    return Array.from(new Set(hints));
-}
-exports.default = inferContextHints;
+// export function inferContextHints(filePath: string, repoRoot = '.') {
+//   const hints: string[] = [];
+//   const p = filePath.replace(/\\/g, '/');
+//   const parts = p.split('/');
+//
+//   // directory-based hints
+//   if (p.includes('/cli/') || p.endsWith('.cli.ts') || p.includes('/bin/')) hints.push('cli');
+//   if (p.includes('/api/')) hints.push('api');
+//   if (/\.controller\./.test(p) || p.includes('.controller')) hints.push('controller');
+//   if (p.includes('/tests/') || p.includes('/test-fixtures/')) hints.push('test');
+//   if (p.startsWith('lib/') || p.startsWith('dist/') || p.startsWith('build/')) hints.push('library');
+//
+//   // filename-based hints
+//   const file = parts[parts.length - 1] || '';
+//   if (/index\./i.test(file)) hints.push('index');
+//   if (/service\.|\.service\./i.test(file)) hints.push('service');
+//   if (/router\.|\.router\./i.test(file)) hints.push('router');
+//
+//   // export surface heuristics
+//   if (p.includes('/src/')) hints.push('source');
+//
+//   // normalize unique
+//   return Array.from(new Set(hints));
+// }
+//
+//
 //# sourceMappingURL=heuristics.js.map

package/lib/tools/ast-jsdoc-tools/utils/heuristics.d.ts

@@ -1,2 +0,0 @@
-export declare function inferContextHints(filePath: string, repoRoot?: string): string[];
-export default inferContextHints;