@decaf-ts/mcp-server 0.4.9 → 0.4.16

package/lib/esm/tools/ast-jsdoc-tools/prompts/loader.js

@@ -1,26 +1,34 @@
-import fs from 'fs';
-import path from 'path';
-/**
- * Load all prompt templates from the feature specs prompts folder.
- * Returns an array of PromptTemplate objects.
- */
-export function loadPromptTemplates(baseDir) {
-    const repoRoot = process.cwd();
-    const dir = path.resolve(baseDir || path.join(repoRoot, 'specs/001-ast-jsdoc-tools/prompts'));
-    if (!fs.existsSync(dir))
-        return [];
-    const files = fs.readdirSync(dir).filter(f => f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.template'));
-    const templates = [];
-    for (const f of files) {
-        try {
-            const filePath = path.join(dir, f);
-            const content = fs.readFileSync(filePath, 'utf8');
-            templates.push({ id: f.replace(/\.[^.]+$/, ''), fileName: f, content });
-        }
-        catch (e) {
-            // skip
-        }
-    }
-    return templates;
-}
+"use strict";
+// import * as fs from 'fs';
+// import * as path from 'path';
+//
+// export type PromptTemplate = {
+//   id: string;
+//   fileName: string;
+//   content: string;
+// };
+//
+// /**
+//  * Load all prompt templates from the feature specs prompts folder.
+//  * Returns an array of PromptTemplate objects.
+//  */
+// export function loadPromptTemplates(baseDir?: string): PromptTemplate[] {
+//   const repoRoot = process.cwd();
+//   const dir = path.resolve(baseDir || path.join(repoRoot, 'specs/001-ast-jsdoc-tools/prompts'));
+//   if (!fs.existsSync(dir)) return [];
+//
+//   const files = fs.readdirSync(dir).filter(f => f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.template'));
+//   const templates: PromptTemplate[] = [];
+//   for (const f of files) {
+//     try {
+//       const filePath = path.join(dir, f);
+//       const content = fs.readFileSync(filePath, 'utf8');
+//       templates.push({ id: f.replace(/\.[^.]+$/, ''), fileName: f, content });
+//     } catch (_e) {
+//       // skip
+//     }
+//   }
+//
+//   return templates;
+// }
 //# sourceMappingURL=loader.js.map

package/lib/esm/tools/ast-jsdoc-tools/prompts/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/prompts/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mCAAmC,CAAC,CAAC,CAAC;IAC9F,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAClH,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;QACT,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/prompts/loader.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,gCAAgC;AAChC,EAAE;AACF,iCAAiC;AACjC,gBAAgB;AAChB,sBAAsB;AACtB,qBAAqB;AACrB,KAAK;AACL,EAAE;AACF,MAAM;AACN,sEAAsE;AACtE,iDAAiD;AACjD,MAAM;AACN,4EAA4E;AAC5E,oCAAoC;AACpC,mGAAmG;AACnG,wCAAwC;AACxC,EAAE;AACF,uHAAuH;AACvH,4CAA4C;AAC5C,6BAA6B;AAC7B,YAAY;AACZ,4CAA4C;AAC5C,2DAA2D;AAC3D,iFAAiF;AACjF,qBAAqB;AACrB,gBAAgB;AAChB,QAAQ;AACR,MAAM;AACN,EAAE;AACF,sBAAsB;AACtB,IAAI"}

package/lib/esm/tools/ast-jsdoc-tools/repoRunner.d.ts

@@ -1,16 +0,0 @@
-export type RepositoryRunReport = {
-    runId: string;
-    rootPath: string;
-    filesProcessed: number;
-    suggestionsTotal: number;
-    changedFiles: string[];
-    errors: {
-        filePath: string;
-        error: string;
-    }[];
-    startedAt: string;
-    finishedAt?: string;
-};
-export declare function runRepository(rootPath?: string, options?: {
-    dryRun?: boolean;
-}): Promise<RepositoryRunReport>;

package/lib/esm/tools/ast-jsdoc-tools/repoRunner.js

@@ -1,61 +1,124 @@
-import { listSourceFiles } from "./enumerator.js";
-import { runFile } from "./fileRunner.js";
-import { applySuggestionsToFile } from "./apply.js";
-import { writePatchForFile } from "./patch.js";
-import fs from 'fs';
-import path from 'path';
-import { v4 as uuidv4 } from 'uuid';
-export async function runRepository(rootPath = '.', options = { dryRun: true }) {
-    const startedAt = new Date().toISOString();
-    const runId = uuidv4();
-    const files = await listSourceFiles(rootPath);
-    const report = {
-        runId,
-        rootPath: path.resolve(rootPath),
-        filesProcessed: 0,
-        suggestionsTotal: 0,
-        changedFiles: [],
-        errors: [],
-        startedAt,
-    };
-    for (const f of files) {
-        try {
-            const fr = await runFile(f);
-            report.filesProcessed += 1;
-            report.suggestionsTotal += (fr.suggestions || []).length;
-            if (!options.dryRun && fr.suggestions && fr.suggestions.length) {
-                try {
-                    // apply changes in-place and write patch report
-                    const res = applySuggestionsToFile(f, fr.suggestions);
-                    report.changedFiles.push(f);
-                    try {
-                        writePatchForFile(f, fr.suggestions);
-                    }
-                    catch (e) {
-                        // non-fatal
-                    }
-                }
-                catch (e) {
-                    report.errors.push({ filePath: f, error: `apply failed: ${String(e)}` });
-                }
-            }
-        }
-        catch (e) {
-            report.errors.push({ filePath: f, error: String(e) });
-        }
-    }
-    report.finishedAt = new Date().toISOString();
-    // persist run report
-    try {
-        const outDir = path.resolve('specs/001-ast-jsdoc-tools/reports');
-        if (!fs.existsSync(outDir))
-            fs.mkdirSync(outDir, { recursive: true });
-        const filename = path.join(outDir, `${runId}.repo.json`);
-        fs.writeFileSync(filename, JSON.stringify(report, null, 2), 'utf8');
-    }
-    catch (e) {
-        // ignore
-    }
-    return report;
-}
+"use strict";
+// import { listSourceFiles } from './enumerator';
+// import { runFile } from './fileRunner';
+// import { applySuggestionsToFile } from './apply';
+// import { writePatchForFile } from './patch';
+// import * as fs from 'fs';
+// import * as path from 'path';
+// import { v4 as uuidv4 } from 'uuid';
+//
+// export type RepositoryRunReport = {
+//   runId: string;
+//   rootPath: string;
+//   filesProcessed: number;
+//   suggestionsTotal: number;
+//   changedFiles: string[];
+//   errors: { filePath: string; error: string }[];
+//   startedAt: string;
+//   finishedAt?: string;
+// };
+//
+// export async function runRepository(
+//   rootPath = '.',
+//   options: { dryRun?: boolean; apply?: boolean; concurrency?: number; runId?: string } = { dryRun: true, concurrency: 4 }
+// ): Promise<RepositoryRunReport> {
+//   const startedAt = new Date().toISOString();
+//   const runId = options.runId ?? uuidv4();
+//   const files = await listSourceFiles(rootPath);
+//   const outDir = path.resolve('specs/001-ast-jsdoc-tools/reports');
+//   if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
+//
+//   const checkpointDir = path.join(outDir, 'checkpoints');
+//   if (!fs.existsSync(checkpointDir)) fs.mkdirSync(checkpointDir, { recursive: true });
+//   const checkpointFile = path.join(checkpointDir, `${runId}.json`);
+//
+//   // Load existing checkpoint if present (resume support)
+//   const completedFiles = new Set<string>();
+//   if (fs.existsSync(checkpointFile)) {
+//     try {
+//       const data = JSON.parse(fs.readFileSync(checkpointFile, 'utf8'));
+//       if (Array.isArray(data.completed)) for (const c of data.completed) completedFiles.add(c);
+//     } catch {
+//       // ignore malformed checkpoint
+//     }
+//   }
+//
+//   const report: RepositoryRunReport = {
+//     runId,
+//     rootPath: path.resolve(rootPath),
+//     filesProcessed: 0,
+//     suggestionsTotal: 0,
+//     changedFiles: [],
+//     errors: [],
+//     startedAt,
+//   };
+//
+//   const concurrency = options.concurrency && options.concurrency > 0 ? options.concurrency : 4;
+//
+//   // Worker pool
+//   let idx = 0;
+//   const mutex = () => {
+//     const i = idx;
+//     idx += 1;
+//     return i;
+//   };
+//
+//   async function worker() {
+//     while (true) {
+//       const i = mutex();
+//       if (i >= files.length) break;
+//       const f = files[i];
+//       if (completedFiles.has(f)) {
+//         // skip already completed
+//         continue;
+//       }
+//       try {
+//         const fr = await runFile(f);
+//         report.filesProcessed += 1;
+//         report.suggestionsTotal += (fr.suggestions || []).length;
+//
+//         if (!options.dryRun && fr.suggestions && fr.suggestions.length) {
+//           try {
+//             applySuggestionsToFile(f, fr.suggestions);
+//             report.changedFiles.push(f);
+//             try {
+//               writePatchForFile(f, fr.suggestions);
+//             } catch {
+//               // non-fatal
+//             }
+//           } catch (e: any) {
+//             report.errors.push({ filePath: f, error: `apply failed: ${String(e)}` });
+//           }
+//         }
+//
+//         // mark completed and persist checkpoint
+//         completedFiles.add(f);
+//         try {
+//           fs.writeFileSync(checkpointFile, JSON.stringify({ completed: Array.from(completedFiles) }, null, 2), 'utf8');
+//         } catch {
+//           // ignore checkpoint write errors
+//         }
+//       } catch (e: any) {
+//         report.errors.push({ filePath: f, error: String(e) });
+//       }
+//     }
+//   }
+//
+//   // start workers
+//   const workers = [] as Promise<void>[];
+//   for (let w = 0; w < concurrency; w++) workers.push(worker());
+//   await Promise.all(workers);
+//
+//   report.finishedAt = new Date().toISOString();
+//
+//   // persist run report
+//   try {
+//     const filename = path.join(outDir, `${runId}.repo.json`);
+//     fs.writeFileSync(filename, JSON.stringify(report, null, 2), 'utf8');
+//   } catch {
+//     // ignore
+//   }
+//
+//   return report;
+// }
 //# sourceMappingURL=repoRunner.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"repoRunner.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/repoRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repoRunner.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/repoRunner.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,0CAA0C;AAC1C,oDAAoD;AACpD,+CAA+C;AAC/C,4BAA4B;AAC5B,gCAAgC;AAChC,uCAAuC;AACvC,EAAE;AACF,sCAAsC;AACtC,mBAAmB;AACnB,sBAAsB;AACtB,4BAA4B;AAC5B,8BAA8B;AAC9B,4BAA4B;AAC5B,mDAAmD;AACnD,uBAAuB;AACvB,yBAAyB;AACzB,KAAK;AACL,EAAE;AACF,uCAAuC;AACvC,oBAAoB;AACpB,4HAA4H;AAC5H,oCAAoC;AACpC,gDAAgD;AAChD,6CAA6C;AAC7C,mDAAmD;AACnD,sEAAsE;AACtE,2EAA2E;AAC3E,EAAE;AACF,4DAA4D;AAC5D,yFAAyF;AACzF,sEAAsE;AACtE,EAAE;AACF,4DAA4D;AAC5D,8CAA8C;AAC9C,yCAAyC;AACzC,YAAY;AACZ,0EAA0E;AAC1E,kGAAkG;AAClG,gBAAgB;AAChB,uCAAuC;AACvC,QAAQ;AACR,MAAM;AACN,EAAE;AACF,0CAA0C;AAC1C,aAAa;AACb,wCAAwC;AACxC,yBAAyB;AACzB,2BAA2B;AAC3B,wBAAwB;AACxB,kBAAkB;AAClB,iBAAiB;AACjB,OAAO;AACP,EAAE;AACF,kGAAkG;AAClG,EAAE;AACF,mBAAmB;AACnB,iBAAiB;AACjB,0BAA0B;AAC1B,qBAAqB;AACrB,gBAAgB;AAChB,gBAAgB;AAChB,OAAO;AACP,EAAE;AACF,8BAA8B;AAC9B,qBAAqB;AACrB,2BAA2B;AAC3B,sCAAsC;AACtC,4BAA4B;AAC5B,qCAAqC;AACrC,oCAAoC;AACpC,oBAAoB;AACpB,UAAU;AACV,cAAc;AACd,uCAAuC;AACvC,sCAAsC;AACtC,oEAAoE;AACpE,EAAE;AACF,4EAA4E;AAC5E,kBAAkB;AAClB,yDAAyD;AACzD,2CAA2C;AAC3C,oBAAoB;AACpB,sDAAsD;AACtD,wBAAwB;AACxB,6BAA6B;AAC7B,gBAAgB;AAChB,+BAA+B;AAC/B,wFAAwF;AACxF,cAAc;AACd,YAAY;AACZ,EAAE;AACF,mDAAmD;AACnD,iCAAiC;AACjC,gBAAgB;AAChB,0HAA0H;AAC1H,oBAAoB;AACpB,8CAA8C;AAC9C,YAAY;AACZ,2BAA2B;AAC3B,iEAAiE;AACjE,UAAU;AACV,QAAQ;AACR,MAAM;AACN,EAAE;AACF,qBAAqB;AACrB,2CAA2C;AAC3C,kEAAkE;AAClE,gCAAgC;AAChC,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,0BAA0B;AAC1B,UAAU;AACV,gEAAgE;AAChE,2EAA2E;AAC3E,cAAc;AACd,gBAAgB;AAChB,MAAM;AACN,EAAE;AACF,mBAAmB;AACnB,IAAI"}

package/lib/esm/tools/ast-jsdoc-tools/tool0/generator-tool.js

@@ -0,0 +1,34 @@
+"use strict";
+// import { z } from 'zod';
+// import { ToolBuilder } from '../../../builders/tool-builder';
+// import { generateJSDoc } from '../generator';
+// import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol';
+// import type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types';
+//
+// const name = 'ast-jsdoc.generate';
+//
+// export const AstJsdocGeneratorTool = ToolBuilder.builder
+//   .setName(name)
+//   .setTitle('AST → JSDoc (programmatic)')
+//   .setDescription('Generate a JSDoc suggestion for a provided AST object or array of AST objects (test/programmatic helper).')
+//   .setInputSchema(z.object({ astObject: z.any().optional(), astObjects: z.array(z.any()).optional(), patchPreview: z.boolean().optional() }))
+//   .setCb(async (args: any, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
+//     const { astObject, astObjects, patchPreview } = args || {};
+//     const items = astObjects && Array.isArray(astObjects) ? astObjects : astObject ? [astObject] : [];
+//     if (!items.length) {
+//       return { content: [{ type: 'text', text: 'No astObject(s) provided' }], structuredContent: { suggestions: [] } } as any;
+//     }
+//     try {
+//       const suggestions = items.map((it: any) => generateJSDoc(it as any));
+//       const structured: any = { suggestions };
+//       if (patchPreview) {
+//         structured.patches = suggestions.map((s: any, i: number) => ({ file: items[i]?.location?.filePath || `in-memory-${i}`, patch: s.text }));
+//       }
+//       return { content: [{ type: 'text', text: 'Generated suggestion(s)' }], structuredContent: structured } as any;
+//     } catch (e: any) {
+//       return { content: [{ type: 'text', text: `Error: ${String(e?.message || e)}` }], structuredContent: { suggestions: [] } } as any;
+//     }
+//   });
+//
+//
+//# sourceMappingURL=generator-tool.js.map

package/lib/esm/tools/ast-jsdoc-tools/tool0/generator-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-tool.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/tool0/generator-tool.ts"],"names":[],"mappings":";AAAA,2BAA2B;AAC3B,gEAAgE;AAChE,gDAAgD;AAChD,wFAAwF;AACxF,4FAA4F;AAC5F,EAAE;AACF,qCAAqC;AACrC,EAAE;AACF,2DAA2D;AAC3D,mBAAmB;AACnB,4CAA4C;AAC5C,iIAAiI;AACjI,gJAAgJ;AAChJ,kGAAkG;AAClG,kEAAkE;AAClE,yGAAyG;AACzG,2BAA2B;AAC3B,iIAAiI;AACjI,QAAQ;AACR,YAAY;AACZ,8EAA8E;AAC9E,iDAAiD;AACjD,4BAA4B;AAC5B,oJAAoJ;AACpJ,UAAU;AACV,uHAAuH;AACvH,yBAAyB;AACzB,0IAA0I;AAC1I,QAAQ;AACR,QAAQ;AACR,EAAE;AACF,EAAE"}

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

@@ -0,0 +1,196 @@
+"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/esm/tools/ast-jsdoc-tools/tool1/extractor.js.map

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

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

@@ -0,0 +1,67 @@
+"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/esm/tools/ast-jsdoc-tools/tool2/suggester.js.map

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