@decaf-ts/mcp-server 0.4.10 → 0.4.17

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

@@ -1,33 +1,44 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AstJsdocTool = void 0;
-exports.analyzeFile = analyzeFile;
-const tool_builder_1 = require("./../../builders/tool-builder.cjs");
-const zod_1 = require("zod");
-const constants_1 = require("./../../constants.cjs");
-/**
- * Minimal analyzeFile helper used by other tools (placeholder for real implementation).
- * Returns an object compatible with the feature's data-model (FileReport-like).
- */
-async function analyzeFile(_filePath) {
-    return { astObjects: [] };
-}
-exports.AstJsdocTool = tool_builder_1.ToolBuilder.builder
-    .setName("ast.jsdoc")
-    .setTitle("AST → JSDoc Tool")
-    .setDescription("Generate suggested JSDoc comments for TypeScript AST objects (MVP stub).")
-    .setInputSchema(zod_1.z.object({ filePath: zod_1.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(constants_1.ReasoningLevel.BASIC)
-    .setEffort(constants_1.EffortLevel.LOW)
-    .setCost(constants_1.Cost.FREE);
+// 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.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/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,kCAEC;AAfD,oEAA0D;AAC1D,6BAAwB;AACxB,qDAAoE;AAOpE;;;GAGG;AACI,KAAK,UAAU,WAAW,CAAC,SAAiB;IACjD,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAC5B,CAAC;AAEY,QAAA,YAAY,GAAG,0BAAW,CAAC,OAAO;KAC5C,OAAO,CAAC,WAAW,CAAC;KACpB,QAAQ,CAAC,kBAAkB,CAAC;KAC5B,cAAc,CAAC,0EAA0E,CAAC;KAC1F,cAAc,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAC,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,0BAAc,CAAC,KAAK,CAAC;KAClC,SAAS,CAAC,uBAAW,CAAC,GAAG,CAAC;KAC1B,OAAO,CAAC,gBAAI,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/tools/ast-jsdoc-tools/interactive.cjs

@@ -1,10 +1,9 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.interactiveAnalyze = interactiveAnalyze;
-const fileRunner_1 = require("./fileRunner.cjs");
-async function interactiveAnalyze(filePath) {
-    // For MVP: return the file report so callers can present suggestions.
-    const report = await (0, fileRunner_1.runFile)(filePath);
-    return report;
-}
+// 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.d.ts

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

package/lib/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":";;AAEA,gDAIC;AAND,iDAAuC;AAEhC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,sEAAsE;IACtE,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAO,EAAC,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/tools/ast-jsdoc-tools/parser.cjs

@@ -1,77 +1,89 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractAstObjects = extractAstObjects;
-const ts_morph_1 = require("ts-morph");
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-async function extractAstObjects(filePath) {
-    // debug removed in final implementation
-    const project = new ts_morph_1.Project({ tsConfigFilePath: path_1.default.resolve("tsconfig.json") });
-    let sourceFile = project.addSourceFileAtPathIfExists(filePath);
-    if (!sourceFile) {
-        // fallback: read file contents and create source file in-memory
-        try {
-            const contents = fs_1.default.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;
-}
+// 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.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/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":";;;;;AAaA,8CAuEC;AApFD,uCAAmC;AACnC,gDAAwB;AACxB,4CAAoB;AAWb,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,wCAAwC;IACxC,MAAM,OAAO,GAAG,IAAI,kBAAO,CAAC,EAAE,gBAAgB,EAAE,cAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,UAAU,GAAG,OAAO,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,gEAAgE;QAChE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACnD,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,4DAA4D,QAAQ,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1F,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,oBAAoB;IAEpB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,YAAY;IACZ,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,CAAC;QAC3C,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,GAAG,QAAQ,KAAK,IAAI,EAAE;YAC1B,IAAI;YACJ,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE;YAC1D,UAAU;YACV,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAED,UAAU;IACV,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,aAAa,CAAC;QAC5C,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,GAAG,QAAQ,KAAK,IAAI,EAAE;YAC1B,IAAI;YACJ,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE;YAC1D,UAAU;YACV,SAAS,EAAE,GAAG,CAAC,OAAO,EAAE;SACzB,CAAC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,qBAAqB,EAAE,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,eAAe,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,GAAG,QAAQ,KAAK,IAAI,EAAE;gBAC1B,IAAI;gBACJ,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE;gBAC1D,UAAU;gBACV,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE;aAC1B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"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,29 +1,26 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writePatchForFile = writePatchForFile;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const formatter_1 = require("./formatter.cjs");
-function writePatchForFile(filePath, suggestions) {
-    const abs = path_1.default.resolve(filePath);
-    const original = fs_1.default.existsSync(abs) ? fs_1.default.readFileSync(abs, 'utf8') : '';
-    let patched = original;
-    for (const s of suggestions) {
-        const symbol = (s.id && s.id.split('::')[1]) || '';
-        patched = (0, formatter_1.applyJSDocToContent)(patched, s, symbol);
-    }
-    // simple unified-ish patch: header + original/new
-    const header = `--- a/${path_1.default.basename(filePath)}\n+++ b/${path_1.default.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_1.default.resolve('specs/001-ast-jsdoc-tools/reports/patches');
-    if (!fs_1.default.existsSync(outDir))
-        fs_1.default.mkdirSync(outDir, { recursive: true });
-    const fileName = path_1.default.join(outDir, `${path_1.default.basename(filePath)}.patch`);
-    fs_1.default.writeFileSync(fileName, out, 'utf8');
-    return fileName;
-}
+// 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.d.ts

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

package/lib/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":";;;;;AAKA,8CAkBC;AAvBD,4CAAoB;AACpB,gDAAwB;AAExB,+CAAkD;AAElD,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,WAA8B;IAChF,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAE,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,IAAA,+BAAmB,EAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,kDAAkD;IAClD,MAAM,MAAM,GAAG,SAAS,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,cAAI,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,cAAI,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;IACzE,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,YAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvE,YAAE,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/tools/ast-jsdoc-tools/promptRunner.cjs

@@ -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/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/tools/ast-jsdoc-tools/prompts/loader.cjs

@@ -1,32 +1,34 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadPromptTemplates = loadPromptTemplates;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * Load all prompt templates from the feature specs prompts folder.
- * Returns an array of PromptTemplate objects.
- */
-function loadPromptTemplates(baseDir) {
-    const repoRoot = process.cwd();
-    const dir = path_1.default.resolve(baseDir || path_1.default.join(repoRoot, 'specs/001-ast-jsdoc-tools/prompts'));
-    if (!fs_1.default.existsSync(dir))
-        return [];
-    const files = fs_1.default.readdirSync(dir).filter(f => f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.template'));
-    const templates = [];
-    for (const f of files) {
-        try {
-            const filePath = path_1.default.join(dir, f);
-            const content = fs_1.default.readFileSync(filePath, 'utf8');
-            templates.push({ id: f.replace(/\.[^.]+$/, ''), fileName: f, content });
-        }
-        catch (e) {
-            // skip
-        }
-    }
-    return templates;
-}
+// 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.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[];

package/lib/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,kDAkBC;AA/BD,4CAAoB;AACpB,gDAAwB;AAQxB;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,IAAI,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mCAAmC,CAAC,CAAC,CAAC;IAC9F,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,YAAE,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,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,YAAE,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"}