@decaf-ts/mcp-server 0.4.19 → 1.0.0

package/lib/tools/ast-jsdoc-tools/tool1/extractor.cjs

@@ -1,196 +0,0 @@
-"use strict";
-// import { Project, SyntaxKind } from "ts-morph";
-// import * as path from "path";
-// import * as fs from "fs";
-// import { Logging } from "@decaf-ts/logging";
-//
-// export type ASTObject = {
-//   id: string;
-//   name: string;
-//   kind: string;
-//   location?: {
-//     filePath: string;
-//     startLine: number;
-//     startColumn?: number;
-//     endLine?: number;
-//     endColumn?: number;
-//   };
-//   signature?:
-//     | { params?: Array<{ name: string; type?: string }>; returnType?: string }
-//     | string;
-//   isExported?: boolean;
-// };
-//
-// function makeId(
-//   filePath: string,
-//   name?: string,
-//   startLine?: number,
-//   startCol?: number
-// ) {
-//   const rel = path.relative(process.cwd(), filePath) || filePath;
-//   if (name) return `${rel}::${name}`;
-//   return `${rel}::default@${startLine || 0}:${startCol || 0}`;
-// }
-//
-// function nodeLocation(node: any, filePath: string) {
-//   try {
-//     const startLine = node.getStartLineNumber();
-//     const startCol =
-//       typeof node.getStartColumn === "function"
-//         ? node.getStartColumn()
-//         : undefined;
-//     const endLine =
-//       typeof node.getEndLineNumber === "function"
-//         ? node.getEndLineNumber()
-//         : undefined;
-//     const endCol =
-//       typeof node.getEndColumn === "function" ? node.getEndColumn() : undefined;
-//     return {
-//       filePath,
-//       startLine,
-//       startColumn: startCol,
-//       endLine,
-//       endColumn: endCol,
-//     } as const;
-//   } catch (_e) {
-//     return undefined;
-//   }
-// }
-//
-// export async function extractAstObjects(
-//   filePath: string
-// ): Promise<ASTObject[]> {
-//   const log = Logging.for(extractAstObjects);
-//   if (!filePath) return [];
-//   try {
-//     const project = new Project({ tsConfigFilePath: undefined });
-//     const srcText = await (fs as any).promises.readFile(filePath, "utf8");
-//     const sourceFile = project.createSourceFile(filePath, srcText, {
-//       overwrite: true,
-//     });
-//     if (!sourceFile) return [];
-//     const results: ASTObject[] = [];
-//
-//     // Functions (including exported and default)
-//     const functions = sourceFile.getFunctions();
-//     functions.forEach((fn) => {
-//       const name = fn.getName() ?? undefined;
-//       const isExported = fn.isExported();
-//       const params = fn
-//         .getParameters()
-//         .map((p) => ({ name: p.getName(), type: p.getType().getText() }));
-//       const returnType = fn.getReturnType().getText();
-//       const loc = nodeLocation(
-//         fn.getNameNode ? fn.getNameNode() : fn,
-//         filePath
-//       );
-//       const id = makeId(filePath, name, loc?.startLine, loc?.startColumn);
-//       results.push({
-//         id,
-//         name: name ?? "default",
-//         kind: "function",
-//         location: loc,
-//         signature: { params, returnType },
-//         isExported,
-//       });
-//     });
-//
-//     // Classes
-//     const classes = sourceFile.getClasses();
-//     classes.forEach((cl) => {
-//       const name = cl.getName() ?? undefined;
-//       const isExported = cl.isExported();
-//       const loc = nodeLocation(
-//         cl.getNameNode ? cl.getNameNode() : cl,
-//         filePath
-//       );
-//       const id = makeId(filePath, name, loc?.startLine, loc?.startColumn);
-//       results.push({
-//         id,
-//         name: name ?? "default",
-//         kind: "class",
-//         location: loc,
-//         isExported,
-//       });
-//     });
-//
-//     // Interfaces
-//     const interfaces = sourceFile.getInterfaces();
-//     interfaces.forEach((it) => {
-//       const name = it.getName();
-//       const isExported =
-//         it.isExported && typeof it.isExported === "function"
-//           ? it.isExported()
-//           : false;
-//       const loc = nodeLocation(
-//         it.getNameNode ? it.getNameNode() : it,
-//         filePath
-//       );
-//       const id = makeId(filePath, name, loc?.startLine, loc?.startColumn);
-//       results.push({ id, name, kind: "interface", location: loc, isExported });
-//     });
-//
-//     // Type aliases
-//     const types = sourceFile.getTypeAliases();
-//     types.forEach((t) => {
-//       const name = t.getName();
-//       const isExported =
-//         t.isExported && typeof t.isExported === "function"
-//           ? t.isExported()
-//           : false;
-//       const loc = nodeLocation(t.getNameNode ? t.getNameNode() : t, filePath);
-//       const id = makeId(filePath, name, loc?.startLine, loc?.startColumn);
-//       results.push({ id, name, kind: "type", location: loc, isExported });
-//     });
-//
-//     // Enums
-//     const enums = sourceFile.getEnums();
-//     enums.forEach((e) => {
-//       const name = e.getName();
-//       const isExported =
-//         e.isExported && typeof e.isExported === "function"
-//           ? e.isExported()
-//           : false;
-//       const loc = nodeLocation(e.getNameNode ? e.getNameNode() : e, filePath);
-//       const id = makeId(filePath, name, loc?.startLine, loc?.startColumn);
-//       results.push({ id, name, kind: "enum", location: loc, isExported });
-//     });
-//
-//     // Exported consts / variables
-//     const varStmts = sourceFile.getVariableStatements();
-//     varStmts.forEach((vs) => {
-//       const exported = vs.isExported
-//         ? vs.isExported()
-//         : vs.hasExportKeyword && vs.hasExportKeyword();
-//       vs.getDeclarations().forEach((decl) => {
-//         const name = decl.getName();
-//         const loc = nodeLocation(
-//           decl.getNameNode ? decl.getNameNode() : decl,
-//           filePath
-//         );
-//         const id = makeId(filePath, name, loc?.startLine, loc?.startColumn);
-//         results.push({
-//           id,
-//           name,
-//           kind: "const",
-//           location: loc,
-//           isExported: !!exported,
-//         });
-//       });
-//     });
-//
-//     // Note: namespace/module declarations handled later if required. Skipping explicit namespace extraction for now.
-//
-//     return results;
-//   } catch (e) {
-//     // Log parsing/extraction errors so they are observable during CI/dev.
-//     // Returning an empty list is an acceptable fallback, but the error
-//     // must not be silently swallowed.
-//
-//     log.warn(`extractAstObjects error: ${e}`);
-//     return [];
-//   }
-// }
-//
-//
-//# sourceMappingURL=extractor.js.map

package/lib/tools/ast-jsdoc-tools/tool1/extractor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/tool1/extractor.ts"],"names":[],"mappings":"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"}

package/lib/tools/ast-jsdoc-tools/tool2/suggester.cjs

@@ -1,67 +0,0 @@
-"use strict";
-// import type { ASTObject } from '../tool1/extractor';
-//
-// export type JSDocSuggestion = {
-//   id: string;
-//   text: string;
-//   tags?: Array<{ tag: string; name?: string; description?: string }>;
-//   confidence?: number;
-//   notes?: string[];
-// };
-//
-// export async function suggestJSDoc(astObject: ASTObject, context: Record<string, unknown> = {}): Promise<JSDocSuggestion> {
-//   const id = astObject?.id ?? 'unknown';
-//   const name = astObject?.name ?? 'symbol';
-//   const summary = `${name} — autogenerated summary.`;
-//   // Build tags for params and return when signature present
-//   const tags: Array<{ tag: string; name?: string; description?: string }> = [];
-//   const notes: string[] = [];
-//   const sig = astObject?.signature && typeof astObject.signature === 'object' ? (astObject.signature as { params?: Array<{ name: string; type?: string }>; returnType?: string }) : undefined;
-//   if (sig?.params) {
-//     for (const p of sig.params) {
-//       tags.push({ tag: 'param', name: p.name, description: p.type ? `Type: ${p.type}` : '' });
-//     }
-//   }
-//   if (sig?.returnType) {
-//     tags.push({ tag: 'returns', description: `Type: ${sig.returnType}` });
-//   }
-//   // Compute a simple confidence heuristic:
-//   // - base 0.3
-//   // - +0.3 if signature exists
-//   // - +0.2 * (typedParams / paramCount) for params
-//   // - +0.15 if returnType exists
-//   let confidence = 0.3;
-//   const sigAny = sig as any;
-//   if (sigAny) {
-//     confidence += 0.3;
-//     const params = Array.isArray(sigAny.params) ? sigAny.params : [];
-//     const paramCount = params.length;
-//     const typedParams = params.filter((p: any) => p.type && p.type !== 'any').length;
-//     if (paramCount > 0) {
-//       confidence += 0.2 * (typedParams / paramCount);
-//       if (typedParams < paramCount) notes.push('[NEEDS REVIEW] some params missing explicit types');
-//     }
-//     if (sigAny.returnType) {
-//       confidence += 0.15;
-//       if (sigAny.returnType === 'any') notes.push('[NEEDS REVIEW] return type is any');
-//     }
-//   }
-//   // clamp
-//   confidence = Math.min(1, Math.max(0, Math.round(confidence * 100) / 100));
-//
-//   const lines = ['/**', ` * ${summary}`];
-//   for (const t of tags) {
-//     if (t.tag === 'param') lines.push(` * @param ${t.name} ${t.description}`);
-//     else if (t.tag === 'returns') lines.push(` * @returns ${t.description}`);
-//   }
-//   if (notes.length > 0) {
-//     lines.push(' *');
-//     for (const n of notes) lines.push(` * NOTE: ${n}`);
-//   }
-//   lines.push(' */');
-//   const text = lines.join('\n');
-//   return { id, text, tags, confidence, notes };
-// }
-//
-//
-//# sourceMappingURL=suggester.js.map

package/lib/tools/ast-jsdoc-tools/tool2/suggester.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"suggester.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/tool2/suggester.ts"],"names":[],"mappings":";AAAA,uDAAuD;AACvD,EAAE;AACF,kCAAkC;AAClC,gBAAgB;AAChB,kBAAkB;AAClB,wEAAwE;AACxE,yBAAyB;AACzB,sBAAsB;AACtB,KAAK;AACL,EAAE;AACF,8HAA8H;AAC9H,2CAA2C;AAC3C,8CAA8C;AAC9C,wDAAwD;AACxD,+DAA+D;AAC/D,kFAAkF;AAClF,gCAAgC;AAChC,iMAAiM;AACjM,uBAAuB;AACvB,oCAAoC;AACpC,iGAAiG;AACjG,QAAQ;AACR,MAAM;AACN,2BAA2B;AAC3B,6EAA6E;AAC7E,MAAM;AACN,8CAA8C;AAC9C,kBAAkB;AAClB,kCAAkC;AAClC,sDAAsD;AACtD,oCAAoC;AACpC,0BAA0B;AAC1B,+BAA+B;AAC/B,kBAAkB;AAClB,yBAAyB;AACzB,wEAAwE;AACxE,wCAAwC;AACxC,wFAAwF;AACxF,4BAA4B;AAC5B,wDAAwD;AACxD,uGAAuG;AACvG,QAAQ;AACR,+BAA+B;AAC/B,4BAA4B;AAC5B,0FAA0F;AAC1F,QAAQ;AACR,MAAM;AACN,aAAa;AACb,+EAA+E;AAC/E,EAAE;AACF,4CAA4C;AAC5C,4BAA4B;AAC5B,iFAAiF;AACjF,gFAAgF;AAChF,MAAM;AACN,4BAA4B;AAC5B,wBAAwB;AACxB,0DAA0D;AAC1D,MAAM;AACN,uBAAuB;AACvB,mCAAmC;AACnC,kDAAkD;AAClD,IAAI;AACJ,EAAE;AACF,EAAE"}

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

@@ -1,35 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,116 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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,80 +0,0 @@
-"use strict";
-// 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.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,14 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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,30 +0,0 @@
-"use strict";
-// 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.js.map

@@ -1 +0,0 @@
-{"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,30 +0,0 @@
-"use strict";
-// 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.js.map

@@ -1 +0,0 @@
-{"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"}