@decaf-ts/mcp-server 0.4.2 → 0.4.6

package/lib/tools/ast/ts-ast-tool.d.ts

@@ -0,0 +1,2 @@
+import { ToolBuilder } from "../../builders/tool-builder";
+export declare const TsAstTool: ToolBuilder;

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

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ast-tool.js","sourceRoot":"","sources":["../../../src/tools/ast/ts-ast-tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uCAAsC;AAMtC,oEAA0D;AAE1D,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAElC,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD,MAAM,WAAW,GAAG,OAAC;KAClB,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC;KACD,QAAQ,CAAC,4BAA4B,QAAQ,OAAO,CAAC,CAAC;AAEzD,MAAM,YAAY,GAAG,OAAC;KACnB,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,6BAA6B,QAAQ,OAAO,CAAC,CAAC;AAE7C,QAAA,SAAS,GAAgB,0BAAW,CAAC,OAAO;KACtD,OAAO,CAAC,QAAQ,CAAC;KACjB,QAAQ,CAAC,SAAS,CAAC;KACnB,cAAc,CACb,gIAAgI,CACjI;KACA,cAAc,CAAC,WAAW,CAAC;IAC5B,0EAA0E;IAC1E,mEAAmE;IACnE,6CAA6C;KAC5C,cAAc,CAAC;IACd,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC;KACD,KAAK,CACJ,KAAK,EACH,IAAS;AACT,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,4DAA4D;IAC5D,MAAM,GAAG,GAAQ,MAAM,OAAO,CAAC,IAAI,CAAC;QAClC,IAAA,mBAAW,EAAC,QAAQ,CAAC;QACrB,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;KACxD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QAC5B,sEAAsE;QACtE,gEAAgE;QAChE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC;YACzE,iBAAiB,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;SAC/B,CAAC;IACX,CAAC;IACD,mDAAmD;IACnD,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;QAC9C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAG,CAAC,CAAC,IAAY,IAAI,SAAS;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU;QAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;KACnC,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,cAAc,EAAE,CAAC;QACxE,iBAAiB,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE;KACpC,CAAC;AACX,CAAC,CACF,CAAC"}

package/lib/tools/ast/types.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zAstObject = exports.zSourceLocation = exports.zAstObjectKind = void 0;
+const zod_1 = require("zod");
+exports.zAstObjectKind = zod_1.z.enum([
+    "class",
+    "function",
+    "interface",
+    "type",
+    "enum",
+    "constant",
+    "module",
+    "namespace",
+    "decorator",
+    "cli-module",
+]);
+exports.zSourceLocation = zod_1.z.object({
+    filePath: zod_1.z.string(),
+    startLine: zod_1.z.number().int().nonnegative(),
+    startColumn: zod_1.z.number().int().nonnegative(),
+    endLine: zod_1.z.number().int().nonnegative(),
+    endColumn: zod_1.z.number().int().nonnegative(),
+});
+exports.zAstObject = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    kind: exports.zAstObjectKind,
+    location: exports.zSourceLocation,
+    isExported: zod_1.z.boolean(),
+    signature: zod_1.z.string().optional(),
+    parentId: zod_1.z.string().optional(),
+    children: zod_1.z.array(zod_1.z.string()).optional(),
+    decorators: zod_1.z.array(zod_1.z.string()).optional(),
+    contextHints: zod_1.z.array(zod_1.z.string()).optional(),
+});
+//# sourceMappingURL=types.js.map

package/lib/tools/ast/types.d.ts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+export type AstObjectKind = "class" | "function" | "interface" | "type" | "enum" | "constant" | "module" | "namespace" | "decorator" | "cli-module";
+export declare const zAstObjectKind: z.ZodEnum<["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 declare const zSourceLocation: z.ZodObject<{
+    filePath: z.ZodString;
+    startLine: z.ZodNumber;
+    startColumn: z.ZodNumber;
+    endLine: z.ZodNumber;
+    endColumn: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}, {
+    filePath: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}>;
+export interface AstObject {
+    id: string;
+    name: string;
+    kind: AstObjectKind;
+    location: SourceLocation;
+    isExported: boolean;
+    signature?: string;
+    parentId?: string;
+    children?: string[];
+    decorators?: string[];
+    contextHints?: string[];
+}
+export declare const zAstObject: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodEnum<["class", "function", "interface", "type", "enum", "constant", "module", "namespace", "decorator", "cli-module"]>;
+    location: z.ZodObject<{
+        filePath: z.ZodString;
+        startLine: z.ZodNumber;
+        startColumn: z.ZodNumber;
+        endLine: z.ZodNumber;
+        endColumn: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    }, {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    }>;
+    isExported: z.ZodBoolean;
+    signature: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    decorators: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    contextHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    kind: "function" | "type" | "class" | "interface" | "enum" | "constant" | "module" | "namespace" | "decorator" | "cli-module";
+    id: string;
+    location: {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    };
+    isExported: boolean;
+    signature?: string | undefined;
+    parentId?: string | undefined;
+    children?: string[] | undefined;
+    decorators?: string[] | undefined;
+    contextHints?: string[] | undefined;
+}, {
+    name: string;
+    kind: "function" | "type" | "class" | "interface" | "enum" | "constant" | "module" | "namespace" | "decorator" | "cli-module";
+    id: string;
+    location: {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    };
+    isExported: boolean;
+    signature?: string | undefined;
+    parentId?: string | undefined;
+    children?: string[] | undefined;
+    decorators?: string[] | undefined;
+    contextHints?: string[] | undefined;
+}>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/ast/types.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAcX,QAAA,cAAc,GAAG,OAAC,CAAC,IAAI,CAAC;IACnC,OAAO;IACP,UAAU;IACV,WAAW;IACX,MAAM;IACN,MAAM;IACN,UAAU;IACV,QAAQ;IACR,WAAW;IACX,WAAW;IACX,YAAY;CACb,CAAC,CAAC;AAUU,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACvC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC1C,CAAC,CAAC;AAeU,QAAA,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,sBAAc;IACpB,QAAQ,EAAE,uBAAe;IACzB,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE;IACvB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC"}

package/lib/tools/ast/utils.cjs

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProject = getProject;
+exports.analyzeFile = analyzeFile;
+const ts_morph_1 = require("ts-morph");
+const path_1 = __importDefault(require("path"));
+let _project = null;
+function getProject(rootDir) {
+    if (_project)
+        return _project;
+    _project = new ts_morph_1.Project({
+        tsConfigFilePath: rootDir ? path_1.default.join(rootDir, "tsconfig.json") : undefined,
+        skipAddingFilesFromTsConfig: true,
+    });
+    return _project;
+}
+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 };
+}
+//# sourceMappingURL=utils.js.map

package/lib/tools/ast/utils.d.ts

@@ -0,0 +1,5 @@
+import { Project } from "ts-morph";
+export declare function getProject(rootDir?: string): Project;
+export declare function analyzeFile(filePath: string): Promise<{
+    astObjects: any[];
+}>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/tools/ast/utils.ts"],"names":[],"mappings":";;;;;AAKA,gCAOC;AAED,kCAqDC;AAnED,uCAA+C;AAC/C,gDAAwB;AAExB,IAAI,QAAQ,GAAmB,IAAI,CAAC;AAEpC,SAAgB,UAAU,CAAC,OAAgB;IACzC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,GAAG,IAAI,kBAAO,CAAC;QACrB,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,2BAA2B,EAAE,IAAI;KAClC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAEM,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"}

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

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backupFile = backupFile;
+exports.applySuggestionsToFile = applySuggestionsToFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const formatter_1 = require("./formatter.cjs");
+function backupFile(filePath) {
+    const abs = path_1.default.resolve(filePath);
+    const dir = path_1.default.dirname(abs);
+    const base = path_1.default.basename(abs);
+    const ts = Date.now();
+    const outName = path_1.default.join(dir, `.backup.${base}.${ts}`);
+    fs_1.default.copyFileSync(abs, outName);
+    return outName;
+}
+function applySuggestionsToFile(filePath, suggestions) {
+    const abs = path_1.default.resolve(filePath);
+    if (!fs_1.default.existsSync(abs))
+        throw new Error(`file not found: ${abs}`);
+    const original = fs_1.default.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 = (0, formatter_1.applyJSDocToContent)(content, s, symbol);
+    }
+    const backup = backupFile(abs);
+    fs_1.default.writeFileSync(abs, content, 'utf8');
+    return { backup, written: true };
+}
+//# sourceMappingURL=apply.js.map

package/lib/tools/ast-jsdoc-tools/apply.d.ts

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/apply.ts"],"names":[],"mappings":";;;;;AAKA,gCAQC;AAED,wDAeC;AA9BD,4CAAoB;AACpB,gDAAwB;AAExB,+CAAkD;AAElD,SAAgB,UAAU,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,cAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,YAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,sBAAsB,CAAC,QAAgB,EAAE,WAA8B;IACrF,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,YAAE,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,IAAA,+BAAmB,EAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,YAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const repoRunner_1 = require("./repoRunner.cjs");
+const fileRunner_1 = require("./fileRunner.cjs");
+const path_1 = __importDefault(require("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 (0, repoRunner_1.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 (0, fileRunner_1.runFile)(path_1.default.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);
+    });
+}
+//# sourceMappingURL=cli.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/cli.ts"],"names":[],"mappings":";;;;;;AACA,iDAA6C;AAC7C,iDAAuC;AACvC,gDAAwB;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,IAAA,0BAAa,EAAC,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,IAAA,oBAAO,EAAC,cAAI,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"}

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

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSourceFiles = listSourceFiles;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+async function listSourceFiles(root, exts = ['.ts', '.tsx']) {
+    const results = [];
+    const absRoot = path_1.default.resolve(root || '.');
+    function walk(dir) {
+        const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+        for (const e of entries) {
+            const full = path_1.default.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_1.default.extname(e.name).toLowerCase();
+                if (exts.includes(ext))
+                    results.push(full);
+            }
+        }
+    }
+    walk(absRoot);
+    return results;
+}
+//# sourceMappingURL=enumerator.js.map

package/lib/tools/ast-jsdoc-tools/enumerator.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"enumerator.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/enumerator.ts"],"names":[],"mappings":";;;;;AAGA,0CAoBC;AAvBD,4CAAoB;AACpB,gDAAwB;AAEjB,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;IACxE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,cAAI,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAE1C,SAAS,IAAI,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,YAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,cAAI,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,cAAI,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"}

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

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFile = runFile;
+const parser_1 = require("./parser.cjs");
+const generator_1 = require("./generator.cjs");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+async function runFile(filePath) {
+    const abs = path_1.default.resolve(filePath);
+    const objects = await (0, parser_1.extractAstObjects)(abs);
+    const suggestions = objects.map((o) => (0, generator_1.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_1.default.resolve('specs/001-ast-jsdoc-tools/reports');
+        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)}.report.json`);
+        fs_1.default.writeFileSync(filename, JSON.stringify(report, null, 2), 'utf8');
+    }
+    catch (e) {
+        // swallow
+    }
+    return report;
+}
+//# sourceMappingURL=fileRunner.js.map

package/lib/tools/ast-jsdoc-tools/fileRunner.d.ts

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileRunner.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/fileRunner.ts"],"names":[],"mappings":";;;;;AAaA,0BAuBC;AApCD,yCAA6C;AAC7C,+CAA4C;AAC5C,gDAAwB;AACxB,4CAAoB;AAUb,KAAK,UAAU,OAAO,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAiB,EAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,yBAAa,EAAC,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,cAAI,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;QACjE,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,YAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC7E,YAAE,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"}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyJSDocToContent = applyJSDocToContent;
+/**
+ * Insert a JSDoc block before the first occurrence of the symbol name in the file content.
+ * This is a simplistic inserter for MVP purposes.
+ */
+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');
+}
+//# sourceMappingURL=formatter.js.map

package/lib/tools/ast-jsdoc-tools/formatter.d.ts

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/formatter.ts"],"names":[],"mappings":";;AAMA,kDAaC;AAjBD;;;GAGG;AACH,SAAgB,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"}

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

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateJSDoc = generateJSDoc;
+const loader_1 = require("./prompts/loader.cjs");
+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] ?? "");
+    });
+}
+function generateJSDoc(obj) {
+    // Try to load prompt templates from the specs folder and use a matching template
+    const templates = (0, loader_1.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 };
+}
+//# sourceMappingURL=generator.js.map

package/lib/tools/ast-jsdoc-tools/generator.d.ts

@@ -0,0 +1,12 @@
+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;

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

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

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

@@ -0,0 +1,33 @@
+"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);
+//# sourceMappingURL=index.js.map

package/lib/tools/ast-jsdoc-tools/index.d.ts

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

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

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

@@ -0,0 +1,10 @@
+"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;
+}
+//# sourceMappingURL=interactive.js.map

package/lib/tools/ast-jsdoc-tools/interactive.d.ts

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

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

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