@decaf-ts/mcp-server 0.4.9 → 0.4.16

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

@@ -1,58 +1,70 @@
-import { Project } from "ts-morph";
-import path from "path";
-let _project = null;
-export function getProject(rootDir) {
-    if (_project)
-        return _project;
-    _project = new Project({
-        tsConfigFilePath: rootDir ? path.join(rootDir, "tsconfig.json") : undefined,
-        skipAddingFilesFromTsConfig: true,
-    });
-    return _project;
-}
-export async function analyzeFile(filePath) {
-    const project = getProject();
-    const source = 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.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.getStartLinePos === "function"
-            ? d.getStartLinePos()
-            : 0;
-        return {
-            id: `${filePath}::${name}`,
-            name,
-            kind,
-            location: {
-                filePath,
-                startLine: start,
-                startColumn,
-                endLine: end,
-                endColumn: 0,
-            },
-            isExported: true,
-        };
-    }));
-    return { astObjects };
-}
+"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 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/tools/ast/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,UAAU,CAAC;AAC/C,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,IAAI,QAAQ,GAAmB,IAAI,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,GAAG,IAAI,OAAO,CAAC;QACrB,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,2BAA2B,EAAE,IAAI;KAClC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GACV,OAAO,CAAC,2BAA2B,CAAC,QAAQ,CAAC;QAC7C,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAEtE,6EAA6E;IAC7E,uEAAuE;IACvE,uEAAuE;IACvE,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,OAAO,CAAC,6BAA6B,EAAE;YACvC,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2EAA2E;IAC7E,CAAC;IAED,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAClD,KAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,sBAAsB;QACtB,MAAM,KAAK,GACT,OAAO,CAAC,CAAC,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,GAAG,GACP,OAAO,CAAC,CAAC,gBAAgB,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,IAAI,GACR,OAAO,CAAC,CAAC,WAAW,KAAK,UAAU;YACjC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE;YACvC,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,WAAW,GACf,OAAQ,CAAS,CAAC,eAAe,KAAK,UAAU;YAC9C,CAAC,CAAE,CAAS,CAAC,eAAe,EAAE;YAC9B,CAAC,CAAC,CAAC,CAAC;QACR,OAAO;YACL,EAAE,EAAE,GAAG,QAAQ,KAAK,IAAI,EAAE;YAC1B,IAAI;YACJ,IAAI;YACJ,QAAQ,EAAE;gBACR,QAAQ;gBACR,SAAS,EAAE,KAAK;gBAChB,WAAW;gBACX,OAAO,EAAE,GAAG;gBACZ,SAAS,EAAE,CAAC;aACb;YACD,UAAU,EAAE,IAAI;SACV,CAAC;IACX,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}
+{"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.d.ts

@@ -1,6 +0,0 @@
-import { JSDocSuggestion } from './generator';
-export declare function backupFile(filePath: string): string;
-export declare function applySuggestionsToFile(filePath: string, suggestions: JSDocSuggestion[]): {
-    backup?: string;
-    written: boolean;
-};

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

@@ -1,29 +1,33 @@
-import fs from 'fs';
-import path from 'path';
-import { applyJSDocToContent } from "./formatter.js";
-export function backupFile(filePath) {
-    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, suggestions) {
-    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 };
-}
+"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 +1 @@
-{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,uBAAoB;AAElD,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,WAA8B;IACrF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,+DAA+D;QAC/D,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}
+{"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.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

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

@@ -1,33 +1,18 @@
-#!/usr/bin/env node
-import { runRepository } from "./repoRunner.js";
-import { runFile } from "./fileRunner.js";
-import path from 'path';
-async function main(argv) {
-    const cmd = argv[2];
-    if (cmd === 'run:repo') {
-        const root = argv[3] || '.';
-        const dryRun = argv.includes('--apply') ? false : true;
-        const report = await runRepository(root, { dryRun });
-        console.log('Repository run complete:', report);
-        process.exit(0);
-    }
-    if (cmd === 'analyze:file') {
-        const file = argv[3];
-        if (!file) {
-            console.error('Usage: analyze:file <path-to-file>');
-            process.exit(2);
-        }
-        const report = await runFile(path.resolve(file));
-        console.log('File report:', report);
-        process.exit(0);
-    }
-    console.log('Usage: cli run:repo [root] | analyze:file <file>');
-    process.exit(2);
-}
-if (require.main === module) {
-    main(process.argv).catch((e) => {
-        console.error(e);
-        process.exit(1);
-    });
-}
+"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 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,wBAAqB;AAC7C,OAAO,EAAE,OAAO,EAAE,wBAAqB;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"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

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -1 +0,0 @@
-export declare function listSourceFiles(root: string, exts?: string[]): Promise<string[]>;

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

@@ -1,25 +1,26 @@
-import fs from 'fs';
-import path from 'path';
-export async function listSourceFiles(root, exts = ['.ts', '.tsx']) {
-    const results = [];
-    const absRoot = path.resolve(root || '.');
-    function walk(dir) {
-        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;
-}
+"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 +1 @@
-{"version":3,"file":"enumerator.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/enumerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;IACxE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAE1C,SAAS,IAAI,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACzE,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,CAAC;IACd,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"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.d.ts

@@ -1,11 +0,0 @@
-export type FileReport = {
-    filePath: string;
-    astObjects: any[];
-    suggestions: any[];
-    summary: {
-        objectsFound: number;
-        suggestionsGenerated: number;
-    };
-    timestamp: string;
-};
-export declare function runFile(filePath: string): Promise<FileReport>;

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

@@ -1,29 +1,39 @@
-import { extractAstObjects } from "./parser.js";
-import { generateJSDoc } from "./generator.js";
-import path from 'path';
-import fs from 'fs';
-export async function runFile(filePath) {
-    const abs = path.resolve(filePath);
-    const objects = await extractAstObjects(abs);
-    const suggestions = objects.map((o) => generateJSDoc(o));
-    const report = {
-        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 (e) {
-        // swallow
-    }
-    return report;
-}
+"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 +1 @@
-{"version":3,"file":"fileRunner.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/fileRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAiB;AAC7C,OAAO,EAAE,aAAa,EAAE,uBAAoB;AAC5C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAUpB,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAe;QACzB,QAAQ,EAAE,GAAG;QACb,UAAU,EAAE,OAAO;QACnB,WAAW;QACX,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE;QACnF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,6DAA6D;IAC7D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;QACjE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC7E,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,UAAU;IACZ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"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.d.ts

@@ -1,6 +0,0 @@
-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 declare function applyJSDocToContent(content: string, suggestion: JSDocSuggestion, symbolName: string): string;

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

@@ -1,18 +1,22 @@
-/**
- * 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, suggestion, symbolName) {
-    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');
-}
+"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 +1 @@
-{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/formatter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,UAA2B,EAAE,UAAkB;IAClG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,2IAA2I;IAC3I,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mBAAmB,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC,CAAC;IACvM,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,gBAAgB;QAChB,OAAO,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}
+{"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.d.ts

@@ -1,12 +0,0 @@
-import { ASTObject } from "./parser";
-export type JSDocSuggestion = {
-    id: string;
-    text: string;
-    tags: Array<{
-        tag: string;
-        name?: string;
-        description?: string;
-    }>;
-    confidence?: number;
-};
-export declare function generateJSDoc(obj: ASTObject): JSDocSuggestion;