@decaf-ts/mcp-server 0.4.9 → 0.4.16

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

@@ -1,55 +1,69 @@
-import { loadPromptTemplates } from "./prompts/loader.js";
-function renderTemplate(tpl, ctx) {
-    // 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) {
-    // 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 = [];
-    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 };
-}
+"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/esm/tools/ast-jsdoc-tools/generator.js.map

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

@@ -1,7 +0,0 @@
-import { ToolBuilder } from "../../builders/tool-builder";
-/**
- * Minimal analyzeFile helper used by other tools (placeholder for real implementation).
- * Returns an object compatible with the feature's data-model (FileReport-like).
- */
-export declare function analyzeFile(_filePath: string): Promise<any>;
-export declare const AstJsdocTool: ToolBuilder;

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

@@ -1,29 +1,44 @@
-import { ToolBuilder } from "./../../builders/tool-builder.js";
-import { z } from "zod";
-import { ReasoningLevel, EffortLevel, Cost } from "./../../constants.js";
-/**
- * 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) {
-    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, _extra) => {
-    // 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 },
-    };
-})
-    .setReasoning(ReasoningLevel.BASIC)
-    .setEffort(EffortLevel.LOW)
-    .setCost(Cost.FREE);
+"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/esm/tools/ast-jsdoc-tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,yCAAoC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,6BAAwB;AAOpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAiB;IACjD,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO;KAC5C,OAAO,CAAC,WAAW,CAAC;KACpB,QAAQ,CAAC,kBAAkB,CAAC;KAC5B,cAAc,CAAC,0EAA0E,CAAC;KAC1F,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;KAClD,KAAK,CAAC,KAAK,EAAE,KAAU,EAAE,MAA8D,EAAE,EAAE;IAC1F,gGAAgG;IAChG,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC;IACnE,OAAO;QACL,yBAAyB;QACzB,OAAO;QACP,0EAA0E;QAC1E,iBAAiB,EAAE,EAAE,OAAO,EAAE;KACxB,CAAC;AACX,CAAC,CAAC;KACD,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC;KAClC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC;KAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
+{"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/esm/tools/ast-jsdoc-tools/interactive.d.ts

@@ -1 +0,0 @@
-export declare function interactiveAnalyze(filePath: string): Promise<import("./fileRunner").FileReport>;

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

@@ -1,7 +1,9 @@
-import { runFile } from "./fileRunner.js";
-export async function interactiveAnalyze(filePath) {
-    // For MVP: return the file report so callers can present suggestions.
-    const report = await runFile(filePath);
-    return report;
-}
+"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/esm/tools/ast-jsdoc-tools/interactive.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,wBAAqB;AAEvC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,sEAAsE;IACtE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"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/esm/tools/ast-jsdoc-tools/parser.d.ts

@@ -1,13 +0,0 @@
-export type ASTObject = {
-    id: string;
-    name: string;
-    kind: string;
-    location: {
-        filePath: string;
-        startLine: number;
-        startColumn: number;
-    };
-    isExported: boolean;
-    signature?: string;
-};
-export declare function extractAstObjects(filePath: string): Promise<ASTObject[]>;

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

@@ -1,71 +1,89 @@
-import { Project } from "ts-morph";
-import path from "path";
-import fs from "fs";
-export async function extractAstObjects(filePath) {
-    // 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) {
-            // eslint-disable-next-line no-console
-            console.log(`extractAstObjects: failed to read/create source file for ${filePath}: ${e}`);
-            return [];
-        }
-    }
-    // parsing completed
-    const objects = [];
-    // 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;
-}
+"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/esm/tools/ast-jsdoc-tools/parser.js.map

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

@@ -1,2 +0,0 @@
-import { JSDocSuggestion } from './generator';
-export declare function writePatchForFile(filePath: string, suggestions: JSDocSuggestion[]): string;

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

@@ -1,23 +1,26 @@
-import fs from 'fs';
-import path from 'path';
-import { applyJSDocToContent } from "./formatter.js";
-export function writePatchForFile(filePath, suggestions) {
-    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;
-}
+"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/esm/tools/ast-jsdoc-tools/patch.js.map

@@ -1 +1 @@
-{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,uBAAoB;AAElD,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,WAA8B;IAChF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,kDAAkD;IAClD,MAAM,MAAM,GAAG,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtF,MAAM,IAAI,GAAG,oBAAoB,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC5I,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;IACzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"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/esm/tools/ast-jsdoc-tools/promptRunner.js

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

@@ -0,0 +1 @@
+{"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/esm/tools/ast-jsdoc-tools/prompts/loader.d.ts

@@ -1,10 +0,0 @@
-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 declare function loadPromptTemplates(baseDir?: string): PromptTemplate[];