@decaf-ts/mcp-server 0.4.19 → 1.0.0

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

@@ -1,69 +0,0 @@
-"use strict";
-// import { ASTObject } from "./parser";
-// import { loadPromptTemplates } from "./prompts/loader";
-//
-// export type JSDocSuggestion = {
-//   id: string;
-//   text: string;
-//   tags: Array<{ tag: string; name?: string; description?: string }>;
-//   confidence?: number;
-// };
-//
-// function renderTemplate(tpl: string, ctx: Record<string, string>): string {
-//   // very small and safe interpolation: replace {{key}} with ctx[key]
-//   return tpl.replace(/{{\s*([a-zA-Z0-9_]+)\s*}}/g, (_, k) => {
-//     return String(ctx[k] ?? "");
-//   });
-// }
-//
-// export function generateJSDoc(obj: ASTObject): JSDocSuggestion {
-//   // Try to load prompt templates from the specs folder and use a matching template
-//   const templates = loadPromptTemplates();
-//   const ctx = {
-//     name: obj.name || "",
-//     signature: obj.signature || "",
-//   };
-//
-//   // pick priority: function.template, default.template, first available
-//   const preferredIds = ["function", "default", "jsdoc", "summary"];
-//   let tpl = "";
-//   for (const id of preferredIds) {
-//     const t = templates.find((x) => x.id === id || x.fileName === `${id}.md` || x.fileName === `${id}.template`);
-//     if (t) {
-//       tpl = t.content;
-//       break;
-//     }
-//   }
-//   if (!tpl && templates.length) tpl = templates[0].content;
-//
-//   if (tpl) {
-//     // Only treat the found file as a template if it looks like a template or a JSDoc snippet.
-//     const looksLikeTemplate = /{{|\/\*\*|@param/.test(tpl);
-//     if (looksLikeTemplate) {
-//       const text = renderTemplate(tpl, ctx);
-//       return { id: obj.id, text, tags: [], confidence: 0.7 };
-//     }
-//     // otherwise ignore README-like files and fall through to heuristic
-//   }
-//
-//   // Fallback: simple heuristic generation
-//   const summary = obj.signature ? `Summary: ${obj.signature.split("\n")[0]}` : `Summary for ${obj.name}`;
-//   const tags: Array<{ tag: string; name?: string; description?: string }> = [];
-//   const paramMatch = obj.signature ? obj.signature.match(/\(([^)]*)\)/) : null;
-//   if (paramMatch && paramMatch[1].trim()) {
-//     const parts = paramMatch[1].split(",").map((p) => p.trim()).filter(Boolean);
-//     for (const p of parts) {
-//       const name = p.split(":")[0].replace(/[^a-zA-Z0-9_]/g, "");
-//       if (name) tags.push({ tag: "param", name, description: "" });
-//     }
-//   }
-//
-//   const textLines = ["/**", ` * ${summary}`];
-//   for (const t of tags) {
-//     textLines.push(` * @${t.tag} ${t.name} ${t.description}`.trim());
-//   }
-//   textLines.push(" */");
-//
-//   return { id: obj.id, text: textLines.join("\n"), tags, confidence: 0.5 };
-// }
-//# sourceMappingURL=generator.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/generator.ts"],"names":[],"mappings":";AAAA,wCAAwC;AACxC,0DAA0D;AAC1D,EAAE;AACF,kCAAkC;AAClC,gBAAgB;AAChB,kBAAkB;AAClB,uEAAuE;AACvE,yBAAyB;AACzB,KAAK;AACL,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,iEAAiE;AACjE,mCAAmC;AACnC,QAAQ;AACR,IAAI;AACJ,EAAE;AACF,mEAAmE;AACnE,sFAAsF;AACtF,6CAA6C;AAC7C,kBAAkB;AAClB,4BAA4B;AAC5B,sCAAsC;AACtC,OAAO;AACP,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,kBAAkB;AAClB,qCAAqC;AACrC,oHAAoH;AACpH,eAAe;AACf,yBAAyB;AACzB,eAAe;AACf,QAAQ;AACR,MAAM;AACN,8DAA8D;AAC9D,EAAE;AACF,eAAe;AACf,iGAAiG;AACjG,8DAA8D;AAC9D,+BAA+B;AAC/B,+CAA+C;AAC/C,gEAAgE;AAChE,QAAQ;AACR,0EAA0E;AAC1E,MAAM;AACN,EAAE;AACF,6CAA6C;AAC7C,4GAA4G;AAC5G,kFAAkF;AAClF,kFAAkF;AAClF,8CAA8C;AAC9C,mFAAmF;AACnF,+BAA+B;AAC/B,oEAAoE;AACpE,sEAAsE;AACtE,QAAQ;AACR,MAAM;AACN,EAAE;AACF,gDAAgD;AAChD,4BAA4B;AAC5B,wEAAwE;AACxE,MAAM;AACN,2BAA2B;AAC3B,EAAE;AACF,8EAA8E;AAC9E,IAAI"}

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

@@ -1,44 +0,0 @@
-"use strict";
-// export { extractAstObjects } from './tool1/extractor';
-// export * from './tool2/suggester';
-// export * from './tool3/fileProcessor';
-// export * from './tool4/repoRunner';
-// export * as logging from './utils/logging';
-// export * from './promptRunner';
-// import { ToolBuilder } from "../../builders/tool-builder";
-// export * from './tool0/generator-tool';
-// import { z } from "zod";
-// import { ReasoningLevel, EffortLevel, Cost } from "../../constants";
-// import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol";
-// import type {
-//   ServerNotification,
-//   ServerRequest,
-// } from "@modelcontextprotocol/sdk/types";
-//
-// /**
-//  * Minimal analyzeFile helper used by other tools (placeholder for real implementation).
-//  * Returns an object compatible with the feature's data-model (FileReport-like).
-//  */
-// export async function analyzeFile(_filePath: string): Promise<any> {
-//   return { astObjects: [] };
-// }
-//
-// export const AstJsdocTool = ToolBuilder.builder
-//   .setName("ast.jsdoc")
-//   .setTitle("AST → JSDoc Tool")
-//   .setDescription("Generate suggested JSDoc comments for TypeScript AST objects (MVP stub).")
-//   .setInputSchema(z.object({ filePath: z.string() }))
-//   .setCb(async (_args: any, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
-//     // Lightweight stub implementation — real implementation lives under src/tools/ast-jsdoc-tools/*
-//     const content = [{ type: "text", text: "Not implemented (stub)" }];
-//     return {
-//       // human-readable content
-//       content,
-//       // structuredContent matches the declared outputSchema: { content: array }
-//       structuredContent: { content },
-//     } as any;
-//   })
-//   .setReasoning(ReasoningLevel.BASIC)
-//   .setEffort(EffortLevel.LOW)
-//   .setCost(Cost.FREE);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/index.ts"],"names":[],"mappings":";AAAA,yDAAyD;AACzD,qCAAqC;AACrC,yCAAyC;AACzC,sCAAsC;AACtC,8CAA8C;AAC9C,kCAAkC;AAClC,6DAA6D;AAC7D,0CAA0C;AAC1C,2BAA2B;AAC3B,uEAAuE;AACvE,wFAAwF;AACxF,gBAAgB;AAChB,wBAAwB;AACxB,mBAAmB;AACnB,4CAA4C;AAC5C,EAAE;AACF,MAAM;AACN,2FAA2F;AAC3F,mFAAmF;AACnF,MAAM;AACN,uEAAuE;AACvE,+BAA+B;AAC/B,IAAI;AACJ,EAAE;AACF,kDAAkD;AAClD,0BAA0B;AAC1B,kCAAkC;AAClC,gGAAgG;AAChG,wDAAwD;AACxD,mGAAmG;AACnG,uGAAuG;AACvG,0EAA0E;AAC1E,eAAe;AACf,kCAAkC;AAClC,iBAAiB;AACjB,mFAAmF;AACnF,wCAAwC;AACxC,gBAAgB;AAChB,OAAO;AACP,wCAAwC;AACxC,gCAAgC;AAChC,yBAAyB"}

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

@@ -1,9 +0,0 @@
-"use strict";
-// import { runFile } from './fileRunner';
-//
-// export async function interactiveAnalyze(filePath: string) {
-//   // For MVP: return the file report so callers can present suggestions.
-//   const report = await runFile(filePath);
-//   return report;
-// }
-//# sourceMappingURL=interactive.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/interactive.ts"],"names":[],"mappings":";AAAA,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,2EAA2E;AAC3E,4CAA4C;AAC5C,mBAAmB;AACnB,IAAI"}

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

@@ -1,89 +0,0 @@
-"use strict";
-// import { Project } from "ts-morph";
-// import * as path from "path";
-// import * as fs from "fs";
-// import { Logging } from '@decaf-ts/logging';
-//
-// const log = Logging.for('ast-jsdoc-tools.parser');
-//
-// export type ASTObject = {
-//   id: string;
-//   name: string;
-//   kind: string;
-//   location: { filePath: string; startLine: number; startColumn: number };
-//   isExported: boolean;
-//   signature?: string;
-// };
-//
-// export async function extractAstObjects(filePath: string): Promise<ASTObject[]> {
-//   // debug removed in final implementation
-//   const project = new Project({ tsConfigFilePath: path.resolve("tsconfig.json") });
-//   let sourceFile = project.addSourceFileAtPathIfExists(filePath);
-//   if (!sourceFile) {
-//     // fallback: read file contents and create source file in-memory
-//     try {
-//       const contents = fs.readFileSync(filePath, "utf8");
-//       sourceFile = project.createSourceFile(filePath, contents, { overwrite: true });
-//     } catch (e) {
-//       log.warn(`extractAstObjects: failed to read/create source file for ${filePath}: ${e}`);
-//       return [];
-//     }
-//   }
-//
-//   // parsing completed
-//
-//   const objects: ASTObject[] = [];
-//
-//   // Functions
-//   for (const fn of sourceFile.getFunctions()) {
-//     const name = fn.getName() || "<anonymous>";
-//     const isExported = fn.isExported();
-//     const start = fn.getStartLineNumber();
-//     const col = fn.getStart() ? sourceFile.getLineAndColumnAtPos(fn.getStart()).column : 1;
-//     objects.push({
-//       id: `${filePath}::${name}`,
-//       name,
-//       kind: "function",
-//       location: { filePath, startLine: start, startColumn: col },
-//       isExported,
-//       signature: fn.getText(),
-//     });
-//   }
-//
-//   // Classes
-//   for (const cls of sourceFile.getClasses()) {
-//     const name = cls.getName() || "<anonymous>";
-//     const isExported = cls.isExported();
-//     const start = cls.getStartLineNumber();
-//     const col = cls.getStart() ? sourceFile.getLineAndColumnAtPos(cls.getStart()).column : 1;
-//     objects.push({
-//       id: `${filePath}::${name}`,
-//       name,
-//       kind: "class",
-//       location: { filePath, startLine: start, startColumn: col },
-//       isExported,
-//       signature: cls.getText(),
-//     });
-//   }
-//
-//   // Variable statements (consts/exports)
-//   for (const vs of sourceFile.getVariableStatements()) {
-//     const isExported = vs.isExported();
-//     for (const decl of vs.getDeclarations()) {
-//       const name = decl.getName();
-//       const start = decl.getStartLineNumber();
-//       const col = decl.getStart() ? sourceFile.getLineAndColumnAtPos(decl.getStart()).column : 1;
-//       objects.push({
-//         id: `${filePath}::${name}`,
-//         name,
-//         kind: "variable",
-//         location: { filePath, startLine: start, startColumn: col },
-//         isExported,
-//         signature: decl.getText(),
-//       });
-//     }
-//   }
-//
-//   return objects;
-// }
-//# sourceMappingURL=parser.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/parser.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC,gCAAgC;AAChC,4BAA4B;AAC5B,+CAA+C;AAC/C,EAAE;AACF,qDAAqD;AACrD,EAAE;AACF,4BAA4B;AAC5B,gBAAgB;AAChB,kBAAkB;AAClB,kBAAkB;AAClB,4EAA4E;AAC5E,yBAAyB;AACzB,wBAAwB;AACxB,KAAK;AACL,EAAE;AACF,oFAAoF;AACpF,6CAA6C;AAC7C,sFAAsF;AACtF,oEAAoE;AACpE,uBAAuB;AACvB,uEAAuE;AACvE,YAAY;AACZ,4DAA4D;AAC5D,wFAAwF;AACxF,oBAAoB;AACpB,gGAAgG;AAChG,mBAAmB;AACnB,QAAQ;AACR,MAAM;AACN,EAAE;AACF,yBAAyB;AACzB,EAAE;AACF,qCAAqC;AACrC,EAAE;AACF,iBAAiB;AACjB,kDAAkD;AAClD,kDAAkD;AAClD,0CAA0C;AAC1C,6CAA6C;AAC7C,8FAA8F;AAC9F,qBAAqB;AACrB,oCAAoC;AACpC,cAAc;AACd,0BAA0B;AAC1B,oEAAoE;AACpE,oBAAoB;AACpB,iCAAiC;AACjC,UAAU;AACV,MAAM;AACN,EAAE;AACF,eAAe;AACf,iDAAiD;AACjD,mDAAmD;AACnD,2CAA2C;AAC3C,8CAA8C;AAC9C,gGAAgG;AAChG,qBAAqB;AACrB,oCAAoC;AACpC,cAAc;AACd,uBAAuB;AACvB,oEAAoE;AACpE,oBAAoB;AACpB,kCAAkC;AAClC,UAAU;AACV,MAAM;AACN,EAAE;AACF,4CAA4C;AAC5C,2DAA2D;AAC3D,0CAA0C;AAC1C,iDAAiD;AACjD,qCAAqC;AACrC,iDAAiD;AACjD,oGAAoG;AACpG,uBAAuB;AACvB,sCAAsC;AACtC,gBAAgB;AAChB,4BAA4B;AAC5B,sEAAsE;AACtE,sBAAsB;AACtB,qCAAqC;AACrC,YAAY;AACZ,QAAQ;AACR,MAAM;AACN,EAAE;AACF,oBAAoB;AACpB,IAAI"}

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

@@ -1,26 +0,0 @@
-"use strict";
-// import * as fs from 'fs';
-// import * as path from 'path';
-// import { JSDocSuggestion } from './generator';
-// import { applyJSDocToContent } from './formatter';
-//
-// export function writePatchForFile(filePath: string, suggestions: JSDocSuggestion[]): string {
-//   const abs = path.resolve(filePath);
-//   const original = fs.existsSync(abs) ? fs.readFileSync(abs, 'utf8') : '';
-//   let patched = original;
-//   for (const s of suggestions) {
-//     const symbol = (s.id && s.id.split('::')[1]) || '';
-//     patched = applyJSDocToContent(patched, s, symbol);
-//   }
-//
-//   // simple unified-ish patch: header + original/new
-//   const header = `--- a/${path.basename(filePath)}\n+++ b/${path.basename(filePath)}\n`;
-//   const body = `@@\n- Original:\n${original.split('\n').slice(0,20).join('\n')}\n+ Patched:\n${patched.split('\n').slice(0,20).join('\n')}\n`;
-//   const out = header + body;
-//   const outDir = path.resolve('specs/001-ast-jsdoc-tools/reports/patches');
-//   if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
-//   const fileName = path.join(outDir, `${path.basename(filePath)}.patch`);
-//   fs.writeFileSync(fileName, out, 'utf8');
-//   return fileName;
-// }
-//# sourceMappingURL=patch.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/patch.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,gCAAgC;AAChC,iDAAiD;AACjD,qDAAqD;AACrD,EAAE;AACF,gGAAgG;AAChG,wCAAwC;AACxC,6EAA6E;AAC7E,4BAA4B;AAC5B,mCAAmC;AACnC,0DAA0D;AAC1D,yDAAyD;AACzD,MAAM;AACN,EAAE;AACF,uDAAuD;AACvD,2FAA2F;AAC3F,iJAAiJ;AACjJ,+BAA+B;AAC/B,8EAA8E;AAC9E,2EAA2E;AAC3E,4EAA4E;AAC5E,6CAA6C;AAC7C,qBAAqB;AACrB,IAAI"}

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

@@ -1,40 +0,0 @@
-"use strict";
-// import * as fs from 'fs';
-// import * as path from 'path';
-//
-// export type ASTObject = {
-//   id?: string;
-//   kind?: string;
-//   name: string;
-//   signature?: any;
-//   exported?: boolean;
-//   children?: any[];
-// };
-//
-// function kindDescription(kind?: string): string {
-//   if (!kind) return 'utility';
-//   const k = kind.toLowerCase();
-//   if (k === 'class') return 'utility class';
-//   if (k === 'function') return 'utility function';
-//   if (k === 'interface' || k === 'type') return 'type definition';
-//   if (k === 'enum' || k === 'constant') return 'constant';
-//   if (k === 'cli-module') return 'CLI module';
-//   return 'helper';
-// }
-//
-// export function generateJsDoc(ast: ASTObject, templatePath?: string): string {
-//   // If a template exists, we could render it; for now produce a small, deterministic JSDoc
-//   // that includes the name and a short kind-based description.
-//   const summary = `${ast.name} - ${kindDescription(ast.kind)}`;
-//   const lines = [`/**`, ` * ${summary}`, ` *`, ` * Generated JSDoc suggestion.`, ` */`];
-//   return lines.join('\n');
-// }
-//
-// export function loadTemplate(name: string): string | null {
-//   const p = path.resolve(process.cwd(), `specs/001-ast-jsdoc-tools/prompts/${name}`);
-//   if (fs.existsSync(p)) return fs.readFileSync(p, 'utf8');
-//   return null;
-// }
-//
-//
-//# sourceMappingURL=promptRunner.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"promptRunner.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/promptRunner.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,gCAAgC;AAChC,EAAE;AACF,4BAA4B;AAC5B,iBAAiB;AACjB,mBAAmB;AACnB,kBAAkB;AAClB,qBAAqB;AACrB,wBAAwB;AACxB,sBAAsB;AACtB,KAAK;AACL,EAAE;AACF,oDAAoD;AACpD,iCAAiC;AACjC,kCAAkC;AAClC,+CAA+C;AAC/C,qDAAqD;AACrD,qEAAqE;AACrE,6DAA6D;AAC7D,iDAAiD;AACjD,qBAAqB;AACrB,IAAI;AACJ,EAAE;AACF,iFAAiF;AACjF,8FAA8F;AAC9F,kEAAkE;AAClE,kEAAkE;AAClE,2FAA2F;AAC3F,6BAA6B;AAC7B,IAAI;AACJ,EAAE;AACF,8DAA8D;AAC9D,wFAAwF;AACxF,6DAA6D;AAC7D,iBAAiB;AACjB,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/ast-jsdoc-tools/prompts/loader.cjs

@@ -1,34 +0,0 @@
-"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/tools/ast-jsdoc-tools/prompts/loader.js.map

@@ -1 +0,0 @@
-{"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/tools/ast-jsdoc-tools/repoRunner.cjs

@@ -1,124 +0,0 @@
-"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/tools/ast-jsdoc-tools/repoRunner.js.map

@@ -1 +0,0 @@
-{"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/tools/ast-jsdoc-tools/tool0/generator-tool.cjs

@@ -1,34 +0,0 @@
-"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/tools/ast-jsdoc-tools/tool0/generator-tool.js.map

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