@decaf-ts/mcp-server 0.4.19 → 1.0.0

package/lib/esm/resources/repo-metadata/index.js

@@ -1,34 +0,0 @@
-"use strict";
-// import { ResourceBuilder } from "../../builders/resource-builder";
-// import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol";
-// import type {
-//   ReadResourceResult,
-//   ServerNotification,
-//   ServerRequest,
-// } from "@modelcontextprotocol/sdk/types";
-// import { ReasoningLevel, EffortLevel, Cost } from "../../constants";
-// import { readFile } from "fs/promises";
-// import { resolve } from "path";
-//
-// export const RepoMetadataResource = ResourceBuilder.builder
-//   .setName("repo.metadata")
-//   .setTitle("Repository Metadata Resource")
-//   .setDescription("Expose basic repository metadata such as package.json and lint rules.")
-//   .setUriOtTemplate("repo://metadata/{file}")
-//   .setConfig({ description: "Repository metadata resource", _meta: { usage: { reasoning: ReasoningLevel.NONE, effort: EffortLevel.NONE, cost: Cost.FREE } } })
-//   .setCb(async (uri: URL, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
-//     const file = uri.pathname.replace(/^\//, "") || "package.json";
-//     try {
-//       const p = resolve(process.cwd(), file);
-//       const raw = await readFile(p, { encoding: "utf8" });
-//       const parsed = JSON.parse(raw);
-//       const payload: ReadResourceResult = { content: { type: "json", data: JSON.stringify(parsed) }, _meta: {} } as any;
-//       return payload;
-//     } catch {
-//       const payload: ReadResourceResult = { content: { type: "text", text: "" }, _meta: {} } as any;
-//       return payload;
-//     }
-//   });
-//
-//
-//# sourceMappingURL=index.js.map

package/lib/esm/resources/repo-metadata/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/resources/repo-metadata/index.ts"],"names":[],"mappings":";AAAA,qEAAqE;AACrE,wFAAwF;AACxF,gBAAgB;AAChB,wBAAwB;AACxB,wBAAwB;AACxB,mBAAmB;AACnB,4CAA4C;AAC5C,uEAAuE;AACvE,0CAA0C;AAC1C,kCAAkC;AAClC,EAAE;AACF,8DAA8D;AAC9D,8BAA8B;AAC9B,8CAA8C;AAC9C,6FAA6F;AAC7F,gDAAgD;AAChD,iKAAiK;AACjK,iGAAiG;AACjG,sEAAsE;AACtE,YAAY;AACZ,gDAAgD;AAChD,6DAA6D;AAC7D,wCAAwC;AACxC,2HAA2H;AAC3H,wBAAwB;AACxB,gBAAgB;AAChB,uGAAuG;AACvG,wBAAwB;AACxB,QAAQ;AACR,QAAQ;AACR,EAAE;AACF,EAAE"}

package/lib/esm/tools/agile/board-list-tool.js

@@ -1,49 +0,0 @@
-"use strict";
-// /**
-//  * Agile: Board List Tool (Version3-only)
-//  *
-//  * Returns boards for a user or filtered by project. Endpoint: GET /rest/agile/1.0/board
-//  * Docs: https://developer.atlassian.com/cloud/jira/software/rest/api-group-board/
-//  */
-//
-// import { validateWithSchema, buildPagination } from "../../jira/tool-utils";
-// import { normalizeJiraError } from "../../jira/errors";
-// import { z } from "zod";
-//
-// export const name = "jira.agile-board-list";
-//
-// export const inputSchema = z.object({
-//   projectKeyOrId: z.string().optional(),
-//   startAt: z.number().optional(),
-//   maxResults: z.number().optional(),
-//   type: z.string().optional(),
-// });
-//
-// export async function runTool(client: any, input: any) {
-//   const v = validateWithSchema(input, inputSchema as any);
-//   if (!v.valid)
-//     throw {
-//       code: "validation_error",
-//       message: "Invalid input",
-//       details: v.errors,
-//     };
-//   try {
-//     const { projectKeyOrId, startAt, maxResults, type } = input || {};
-//     const page = buildPagination(startAt, maxResults);
-//     const res: any = await client.board.getBoards({
-//       projectKeyOrId,
-//       startAt: page.startAt,
-//       maxResults: page.maxResults,
-//       type,
-//     });
-//     return {
-//       startAt: res.startAt ?? page.startAt,
-//       maxResults: res.maxResults ?? page.maxResults,
-//       total: res.total,
-//       values: res.values ?? res.boards ?? [],
-//     };
-//   } catch (err: any) {
-//     throw normalizeJiraError(err);
-//   }
-// }
-//# sourceMappingURL=board-list-tool.js.map

package/lib/esm/tools/agile/board-list-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"board-list-tool.js","sourceRoot":"","sources":["../../../../src/tools/agile/board-list-tool.ts"],"names":[],"mappings":";AAAA,MAAM;AACN,4CAA4C;AAC5C,KAAK;AACL,2FAA2F;AAC3F,qFAAqF;AACrF,MAAM;AACN,EAAE;AACF,+EAA+E;AAC/E,0DAA0D;AAC1D,2BAA2B;AAC3B,EAAE;AACF,+CAA+C;AAC/C,EAAE;AACF,wCAAwC;AACxC,2CAA2C;AAC3C,oCAAoC;AACpC,uCAAuC;AACvC,iCAAiC;AACjC,MAAM;AACN,EAAE;AACF,2DAA2D;AAC3D,6DAA6D;AAC7D,kBAAkB;AAClB,cAAc;AACd,kCAAkC;AAClC,kCAAkC;AAClC,2BAA2B;AAC3B,SAAS;AACT,UAAU;AACV,yEAAyE;AACzE,yDAAyD;AACzD,sDAAsD;AACtD,wBAAwB;AACxB,+BAA+B;AAC/B,qCAAqC;AACrC,cAAc;AACd,UAAU;AACV,eAAe;AACf,8CAA8C;AAC9C,uDAAuD;AACvD,0BAA0B;AAC1B,gDAAgD;AAChD,SAAS;AACT,yBAAyB;AACzB,qCAAqC;AACrC,MAAM;AACN,IAAI"}

package/lib/esm/tools/ast/ts-ast-tool.js

@@ -1,80 +0,0 @@
-"use strict";
-// import { z } from "zod";
-// import { analyzeFile } from "./utils";
-// import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol";
-// import {
-//   ServerNotification,
-//   ServerRequest,
-// } from "@modelcontextprotocol/sdk/types";
-// import { ToolBuilder } from "../../builders/tool-builder";
-//
-// const toolName = "ts.ast.extract";
-//
-// const toolTitle = "AST Extraction Tool for TypeScript";
-//
-// const inputSchema = z
-//   .object({
-//     filePath: z.string().describe("The path to the TypeScript file to analyze."),
-//   })
-//   .describe(`the input schema for the ${toolName} tool`);
-//
-// const outputSchema = z.object({}).describe(`the output schema for the ${toolName} tool`);
-//
-// export const TsAstTool: ToolBuilder = ToolBuilder.builder
-//   .setName(toolName)
-//   .setTitle(toolTitle)
-//   .setDescription(
-//     "Extracts and analyzes the Abstract Syntax Tree (AST) of TypeScript code to provide insights into its structure and components."
-//   )
-//   .setInputSchema(inputSchema)
-//   // This tool returns a list of content blocks (in `content`) rather than a
-//   // structured object; do not set an outputSchema to avoid requiring
-//   // `structuredContent` in the CallToolResult.
-//   .setAnnotations({
-//     title: toolTitle,
-//     readOnlyHint: true,
-//     destructiveHint: false,
-//     idempotentHint: true,
-//     openWorldHint: false,
-//   })
-//   .setCb(
-//     async (
-//       args: any,
-//       // eslint-disable-next-line @typescript-eslint/no-unused-vars
-//       extra: RequestHandlerExtra<ServerRequest, ServerNotification>
-//     ) => {
-//       const { filePath } = args;
-//       // Guard analyzeFile with a short overall timeout so a slow ts-morph
-//       // resolution won't block the integration test indefinitely.
-//       const res: any = await Promise.race([
-//         analyzeFile(filePath),
-//         new Promise((res) => setTimeout(() => res(null), 1500)),
-//       ]);
-//       if (!res || !res.astObjects) {
-//         // return an empty content array (CallToolResult expects an object; we
-//         // provide readable content and a lightweight structuredContent)
-//         return {
-//           content: [{ type: "text", text: "No AST objects or analysis timed out" }],
-//           structuredContent: { astObjects: [] },
-//         } as any;
-//       }
-//       // Normalize shape to AstObject as much as possible
-//       const objects = res.astObjects.map((o: any) => ({
-//         id: o.id,
-//         name: o.name,
-//         kind: (o.kind as any) || "unknown",
-//         location: o.location,
-//         isExported: !!o.isExported,
-//         signature: o.signature,
-//         parentId: o.parentId,
-//         children: o.children,
-//         decorators: o.decorators,
-//         contextHints: o.contextHints || [],
-//       }));
-//       return {
-//         content: [{ type: "text", text: `Found ${objects.length} AST objects` }],
-//         structuredContent: { astObjects: objects },
-//       } as any;
-//     }
-//   );
-//# sourceMappingURL=ts-ast-tool.js.map

package/lib/esm/tools/ast/ts-ast-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ts-ast-tool.js","sourceRoot":"","sources":["../../../../src/tools/ast/ts-ast-tool.ts"],"names":[],"mappings":";AAAA,2BAA2B;AAC3B,yCAAyC;AACzC,mFAAmF;AACnF,WAAW;AACX,wBAAwB;AACxB,mBAAmB;AACnB,4CAA4C;AAC5C,6DAA6D;AAC7D,EAAE;AACF,qCAAqC;AACrC,EAAE;AACF,0DAA0D;AAC1D,EAAE;AACF,wBAAwB;AACxB,cAAc;AACd,oFAAoF;AACpF,OAAO;AACP,4DAA4D;AAC5D,EAAE;AACF,4FAA4F;AAC5F,EAAE;AACF,4DAA4D;AAC5D,uBAAuB;AACvB,yBAAyB;AACzB,qBAAqB;AACrB,uIAAuI;AACvI,MAAM;AACN,iCAAiC;AACjC,+EAA+E;AAC/E,wEAAwE;AACxE,kDAAkD;AAClD,sBAAsB;AACtB,wBAAwB;AACxB,0BAA0B;AAC1B,8BAA8B;AAC9B,4BAA4B;AAC5B,4BAA4B;AAC5B,OAAO;AACP,YAAY;AACZ,cAAc;AACd,mBAAmB;AACnB,sEAAsE;AACtE,sEAAsE;AACtE,aAAa;AACb,mCAAmC;AACnC,6EAA6E;AAC7E,qEAAqE;AACrE,8CAA8C;AAC9C,iCAAiC;AACjC,mEAAmE;AACnE,YAAY;AACZ,uCAAuC;AACvC,iFAAiF;AACjF,2EAA2E;AAC3E,mBAAmB;AACnB,uFAAuF;AACvF,mDAAmD;AACnD,oBAAoB;AACpB,UAAU;AACV,4DAA4D;AAC5D,0DAA0D;AAC1D,oBAAoB;AACpB,wBAAwB;AACxB,8CAA8C;AAC9C,gCAAgC;AAChC,sCAAsC;AACtC,kCAAkC;AAClC,gCAAgC;AAChC,gCAAgC;AAChC,oCAAoC;AACpC,8CAA8C;AAC9C,aAAa;AACb,iBAAiB;AACjB,oFAAoF;AACpF,sDAAsD;AACtD,kBAAkB;AAClB,QAAQ;AACR,OAAO"}

package/lib/esm/tools/ast/types.js

@@ -1,70 +0,0 @@
-"use strict";
-// import { z } from "zod";
-//
-// export type AstObjectKind =
-//   | "class"
-//   | "function"
-//   | "interface"
-//   | "type"
-//   | "enum"
-//   | "constant"
-//   | "module"
-//   | "namespace"
-//   | "decorator"
-//   | "cli-module";
-//
-// export const zAstObjectKind = z.enum([
-//   "class",
-//   "function",
-//   "interface",
-//   "type",
-//   "enum",
-//   "constant",
-//   "module",
-//   "namespace",
-//   "decorator",
-//   "cli-module",
-// ]);
-//
-// export interface SourceLocation {
-//   filePath: string;
-//   startLine: number;
-//   startColumn: number;
-//   endLine: number;
-//   endColumn: number;
-// }
-//
-// export const zSourceLocation = z.object({
-//   filePath: z.string(),
-//   startLine: z.number().int().nonnegative(),
-//   startColumn: z.number().int().nonnegative(),
-//   endLine: z.number().int().nonnegative(),
-//   endColumn: z.number().int().nonnegative(),
-// });
-//
-// export interface AstObject {
-//   id: string;
-//   name: string;
-//   kind: AstObjectKind;
-//   location: SourceLocation;
-//   isExported: boolean;
-//   signature?: string;
-//   parentId?: string;
-//   children?: string[];
-//   decorators?: string[];
-//   contextHints?: string[];
-// }
-//
-// export const zAstObject = z.object({
-//   id: z.string(),
-//   name: z.string(),
-//   kind: zAstObjectKind,
-//   location: zSourceLocation,
-//   isExported: z.boolean(),
-//   signature: z.string().optional(),
-//   parentId: z.string().optional(),
-//   children: z.array(z.string()).optional(),
-//   decorators: z.array(z.string()).optional(),
-//   contextHints: z.array(z.string()).optional(),
-// });
-//# sourceMappingURL=types.js.map

package/lib/esm/tools/ast/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/ast/types.ts"],"names":[],"mappings":";AAAA,2BAA2B;AAC3B,EAAE;AACF,8BAA8B;AAC9B,cAAc;AACd,iBAAiB;AACjB,kBAAkB;AAClB,aAAa;AACb,aAAa;AACb,iBAAiB;AACjB,eAAe;AACf,kBAAkB;AAClB,kBAAkB;AAClB,oBAAoB;AACpB,EAAE;AACF,yCAAyC;AACzC,aAAa;AACb,gBAAgB;AAChB,iBAAiB;AACjB,YAAY;AACZ,YAAY;AACZ,gBAAgB;AAChB,cAAc;AACd,iBAAiB;AACjB,iBAAiB;AACjB,kBAAkB;AAClB,MAAM;AACN,EAAE;AACF,oCAAoC;AACpC,sBAAsB;AACtB,uBAAuB;AACvB,yBAAyB;AACzB,qBAAqB;AACrB,uBAAuB;AACvB,IAAI;AACJ,EAAE;AACF,4CAA4C;AAC5C,0BAA0B;AAC1B,+CAA+C;AAC/C,iDAAiD;AACjD,6CAA6C;AAC7C,+CAA+C;AAC/C,MAAM;AACN,EAAE;AACF,+BAA+B;AAC/B,gBAAgB;AAChB,kBAAkB;AAClB,yBAAyB;AACzB,8BAA8B;AAC9B,yBAAyB;AACzB,wBAAwB;AACxB,uBAAuB;AACvB,yBAAyB;AACzB,2BAA2B;AAC3B,6BAA6B;AAC7B,IAAI;AACJ,EAAE;AACF,uCAAuC;AACvC,oBAAoB;AACpB,sBAAsB;AACtB,0BAA0B;AAC1B,+BAA+B;AAC/B,6BAA6B;AAC7B,sCAAsC;AACtC,qCAAqC;AACrC,8CAA8C;AAC9C,gDAAgD;AAChD,kDAAkD;AAClD,MAAM"}

package/lib/esm/tools/ast/utils.js

@@ -1,70 +0,0 @@
-"use strict";
-// import { Project, SourceFile } from "ts-morph";
-// import * as path from "path";
-//
-// let _project: Project | null = null;
-//
-// export function getProject(rootDir?: string) {
-//   if (_project) return _project;
-//   _project = new Project({
-//     tsConfigFilePath: rootDir ? path.join(rootDir, "tsconfig.json") : undefined,
-//     skipAddingFilesFromTsConfig: true,
-//   });
-//   return _project;
-// }
-//
-// export async function analyzeFile(filePath: string) {
-//   const project = getProject();
-//   const source: SourceFile =
-//     project.addSourceFileAtPathIfExists(filePath) ||
-//     project.createSourceFile(filePath, undefined, { overwrite: false });
-//
-//   // Resolve dependencies but don't allow this to block the server for too long
-//   // (some environments may have large tsconfigs or slow IO). Use a short
-//   // timeout so analyzeFile remains responsive in tests and integrations.
-//   try {
-//     await Promise.race([
-//       project.resolveSourceFileDependencies(),
-//       new Promise((res) => setTimeout(res, 2000)),
-//     ]);
-//   } catch (err) {
-//     // ignore resolution errors — we can still extract basic info from the file
-//   }
-//
-//   // Very small example extractor: list exported declarations
-//   const exported = source.getExportedDeclarations();
-//   const entries = Array.from(exported.entries());
-//   const astObjects = entries.flatMap(([name, decls]) =>
-//     (decls as any[]).map((d) => {
-//       // defensive accessors
-//       const start =
-//         typeof d.getStartLineNumber === "function" ? d.getStartLineNumber() : 0;
-//       const end =
-//         typeof d.getEndLineNumber === "function" ? d.getEndLineNumber() : 0;
-//       const kind =
-//         typeof d.getKindName === "function"
-//           ? String(d.getKindName()).toLowerCase()
-//           : "unknown";
-//       const startColumn =
-//         typeof (d as any).getStartLinePos === "function"
-//           ? (d as any).getStartLinePos()
-//           : 0;
-//       return {
-//         id: `${filePath}::${name}`,
-//         name,
-//         kind,
-//         location: {
-//           filePath,
-//           startLine: start,
-//           startColumn,
-//           endLine: end,
-//           endColumn: 0,
-//         },
-//         isExported: true,
-//       } as any;
-//     })
-//   );
-//
-//   return { astObjects };
-// }
-//# sourceMappingURL=utils.js.map

package/lib/esm/tools/ast/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/tools/ast/utils.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,gCAAgC;AAChC,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,iDAAiD;AACjD,mCAAmC;AACnC,6BAA6B;AAC7B,mFAAmF;AACnF,yCAAyC;AACzC,QAAQ;AACR,qBAAqB;AACrB,IAAI;AACJ,EAAE;AACF,wDAAwD;AACxD,kCAAkC;AAClC,+BAA+B;AAC/B,uDAAuD;AACvD,2EAA2E;AAC3E,EAAE;AACF,kFAAkF;AAClF,4EAA4E;AAC5E,4EAA4E;AAC5E,UAAU;AACV,2BAA2B;AAC3B,iDAAiD;AACjD,qDAAqD;AACrD,UAAU;AACV,oBAAoB;AACpB,kFAAkF;AAClF,MAAM;AACN,EAAE;AACF,gEAAgE;AAChE,uDAAuD;AACvD,oDAAoD;AACpD,0DAA0D;AAC1D,oCAAoC;AACpC,+BAA+B;AAC/B,sBAAsB;AACtB,mFAAmF;AACnF,oBAAoB;AACpB,+EAA+E;AAC/E,qBAAqB;AACrB,8CAA8C;AAC9C,oDAAoD;AACpD,yBAAyB;AACzB,4BAA4B;AAC5B,2DAA2D;AAC3D,2CAA2C;AAC3C,iBAAiB;AACjB,iBAAiB;AACjB,sCAAsC;AACtC,gBAAgB;AAChB,gBAAgB;AAChB,sBAAsB;AACtB,sBAAsB;AACtB,8BAA8B;AAC9B,yBAAyB;AACzB,0BAA0B;AAC1B,0BAA0B;AAC1B,aAAa;AACb,4BAA4B;AAC5B,kBAAkB;AAClB,SAAS;AACT,OAAO;AACP,EAAE;AACF,2BAA2B;AAC3B,IAAI"}

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

@@ -1,33 +0,0 @@
-"use strict";
-// import * as fs from 'fs';
-// import * as path from 'path';
-// import { JSDocSuggestion } from './generator';
-// import { applyJSDocToContent } from './formatter';
-//
-// export function backupFile(filePath: string): string {
-//   const abs = path.resolve(filePath);
-//   const dir = path.dirname(abs);
-//   const base = path.basename(abs);
-//   const ts = Date.now();
-//   const outName = path.join(dir, `.backup.${base}.${ts}`);
-//   fs.copyFileSync(abs, outName);
-//   return outName;
-// }
-//
-// export function applySuggestionsToFile(filePath: string, suggestions: JSDocSuggestion[]): { backup?: string; written: boolean } {
-//   const abs = path.resolve(filePath);
-//   if (!fs.existsSync(abs)) throw new Error(`file not found: ${abs}`);
-//   const original = fs.readFileSync(abs, 'utf8');
-//   let content = original;
-//   for (const s of suggestions) {
-//     // Attempt to guess symbol name from suggestion id (file::name)
-//     const parts = s.id.split('::');
-//     const symbol = parts[1] || '';
-//     content = applyJSDocToContent(content, s, symbol);
-//   }
-//
-//   const backup = backupFile(abs);
-//   fs.writeFileSync(abs, content, 'utf8');
-//   return { backup, written: true };
-// }
-//# sourceMappingURL=apply.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/apply.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,gCAAgC;AAChC,iDAAiD;AACjD,qDAAqD;AACrD,EAAE;AACF,yDAAyD;AACzD,wCAAwC;AACxC,mCAAmC;AACnC,qCAAqC;AACrC,2BAA2B;AAC3B,6DAA6D;AAC7D,mCAAmC;AACnC,oBAAoB;AACpB,IAAI;AACJ,EAAE;AACF,oIAAoI;AACpI,wCAAwC;AACxC,wEAAwE;AACxE,mDAAmD;AACnD,4BAA4B;AAC5B,mCAAmC;AACnC,sEAAsE;AACtE,sCAAsC;AACtC,qCAAqC;AACrC,yDAAyD;AACzD,MAAM;AACN,EAAE;AACF,oCAAoC;AACpC,4CAA4C;AAC5C,sCAAsC;AACtC,IAAI"}

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

@@ -1,18 +0,0 @@
-"use strict";
-// // Minimal CLI wiring for ast-jsdoc-tools. Real CLI will use `yargs` in future.
-// import { runFile } from './fileRunner';
-// import { runRepository } from './repoRunner';
-//
-// export async function runFileAnalyze(args: { filePath: string; dryRun?: boolean }) {
-//   const report = await runFile(args.filePath);
-//   // In dry-run, just return the suggestions report
-//   return report;
-// }
-//
-// export async function runRepo(args: { root: string; dryRun?: boolean; apply?: boolean; concurrency?: number }) {
-//   const report = await runRepository(args.root || '.', { dryRun: !!args.dryRun, apply: !!args.apply, concurrency: args.concurrency });
-//   return report;
-// }
-//
-//
-//# sourceMappingURL=cli.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/cli.ts"],"names":[],"mappings":";AAAA,kFAAkF;AAClF,0CAA0C;AAC1C,gDAAgD;AAChD,EAAE;AACF,uFAAuF;AACvF,iDAAiD;AACjD,sDAAsD;AACtD,mBAAmB;AACnB,IAAI;AACJ,EAAE;AACF,mHAAmH;AACnH,yIAAyI;AACzI,mBAAmB;AACnB,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/esm/tools/ast-jsdoc-tools/contracts/validator.js

@@ -1,8 +0,0 @@
-"use strict";
-// export function validateReport(_report: unknown): { valid: boolean; errors?: string[] } {
-//   // Minimal stub: assume valid. Real impl should use ajv with provided schemas.
-//   return { valid: true };
-// }
-//
-//
-//# sourceMappingURL=validator.js.map

package/lib/esm/tools/ast-jsdoc-tools/contracts/validator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/contracts/validator.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,mFAAmF;AACnF,4BAA4B;AAC5B,IAAI;AACJ,EAAE;AACF,EAAE"}

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

@@ -1,26 +0,0 @@
-"use strict";
-// import * as fs from 'fs';
-// import * as path from 'path';
-//
-// export async function listSourceFiles(root: string, exts = ['.ts', '.tsx']): Promise<string[]> {
-//   const results: string[] = [];
-//   const absRoot = path.resolve(root || '.');
-//
-//   function walk(dir: string) {
-//     const entries = fs.readdirSync(dir, { withFileTypes: true });
-//     for (const e of entries) {
-//       const full = path.join(dir, e.name);
-//       if (e.isDirectory()) {
-//         if (['node_modules', 'dist', 'build', '.git'].includes(e.name)) continue;
-//         walk(full);
-//       } else if (e.isFile()) {
-//         const ext = path.extname(e.name).toLowerCase();
-//         if (exts.includes(ext)) results.push(full);
-//       }
-//     }
-//   }
-//
-//   walk(absRoot);
-//   return results;
-// }
-//# sourceMappingURL=enumerator.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"enumerator.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/enumerator.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,gCAAgC;AAChC,EAAE;AACF,mGAAmG;AACnG,kCAAkC;AAClC,+CAA+C;AAC/C,EAAE;AACF,iCAAiC;AACjC,oEAAoE;AACpE,iCAAiC;AACjC,6CAA6C;AAC7C,+BAA+B;AAC/B,oFAAoF;AACpF,sBAAsB;AACtB,iCAAiC;AACjC,0DAA0D;AAC1D,sDAAsD;AACtD,UAAU;AACV,QAAQ;AACR,MAAM;AACN,EAAE;AACF,mBAAmB;AACnB,oBAAoB;AACpB,IAAI"}

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

@@ -1,39 +0,0 @@
-"use strict";
-// import { extractAstObjects } from './parser';
-// import { generateJSDoc } from './generator';
-// import * as path from 'path';
-// import * as fs from 'fs';
-//
-// export type FileReport = {
-//   filePath: string;
-//   astObjects: any[];
-//   suggestions: any[];
-//   summary: { objectsFound: number; suggestionsGenerated: number };
-//   timestamp: string;
-// };
-//
-// export async function runFile(filePath: string): Promise<FileReport> {
-//   const abs = path.resolve(filePath);
-//   const objects = await extractAstObjects(abs);
-//   const suggestions = objects.map((o) => generateJSDoc(o));
-//   const report: FileReport = {
-//     filePath: abs,
-//     astObjects: objects,
-//     suggestions,
-//     summary: { objectsFound: objects.length, suggestionsGenerated: suggestions.length },
-//     timestamp: new Date().toISOString(),
-//   };
-//
-//   // write a file report under specs folder for reproducibility
-//   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, `${path.basename(filePath)}.report.json`);
-//     fs.writeFileSync(filename, JSON.stringify(report, null, 2), 'utf8');
-//   } catch {
-//     // swallow
-//   }
-//
-//   return report;
-// }
-//# sourceMappingURL=fileRunner.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileRunner.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/fileRunner.ts"],"names":[],"mappings":";AAAA,gDAAgD;AAChD,+CAA+C;AAC/C,gCAAgC;AAChC,4BAA4B;AAC5B,EAAE;AACF,6BAA6B;AAC7B,sBAAsB;AACtB,uBAAuB;AACvB,wBAAwB;AACxB,qEAAqE;AACrE,uBAAuB;AACvB,KAAK;AACL,EAAE;AACF,yEAAyE;AACzE,wCAAwC;AACxC,kDAAkD;AAClD,8DAA8D;AAC9D,iCAAiC;AACjC,qBAAqB;AACrB,2BAA2B;AAC3B,mBAAmB;AACnB,2FAA2F;AAC3F,2CAA2C;AAC3C,OAAO;AACP,EAAE;AACF,kEAAkE;AAClE,UAAU;AACV,wEAAwE;AACxE,6EAA6E;AAC7E,oFAAoF;AACpF,2EAA2E;AAC3E,cAAc;AACd,iBAAiB;AACjB,MAAM;AACN,EAAE;AACF,mBAAmB;AACnB,IAAI"}

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

@@ -1,22 +0,0 @@
-"use strict";
-// import { JSDocSuggestion } from './generator';
-//
-// /**
-//  * Insert a JSDoc block before the first occurrence of the symbol name in the file content.
-//  * This is a simplistic inserter for MVP purposes.
-//  */
-// export function applyJSDocToContent(content: string, suggestion: JSDocSuggestion, symbolName: string): string {
-//   const lines = content.split(/\r?\n/);
-//   // Find line index where symbol is declared (very naive: first line that contains `function ${symbolName}` or `export const ${symbolName}`)
-//   const idx = lines.findIndex(l => l.includes(`function ${symbolName}`) || l.includes(`export function ${symbolName}`) || l.includes(`const ${symbolName}`) || l.includes(`export const ${symbolName}`));
-//   const jsLines = suggestion.text.split(/\r?\n/);
-//   if (idx === -1) {
-//     // Append at top
-//     return [...jsLines, '', ...lines].join('\n');
-//   }
-//
-//   const before = lines.slice(0, idx);
-//   const after = lines.slice(idx);
-//   return [...before, ...jsLines, ...after].join('\n');
-// }
-//# sourceMappingURL=formatter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/formatter.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,EAAE;AACF,MAAM;AACN,8FAA8F;AAC9F,qDAAqD;AACrD,MAAM;AACN,kHAAkH;AAClH,0CAA0C;AAC1C,gJAAgJ;AAChJ,4MAA4M;AAC5M,oDAAoD;AACpD,sBAAsB;AACtB,uBAAuB;AACvB,oDAAoD;AACpD,MAAM;AACN,EAAE;AACF,wCAAwC;AACxC,oCAAoC;AACpC,yDAAyD;AACzD,IAAI"}

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

@@ -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/esm/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"}