@decaf-ts/mcp-server 0.4.2 → 0.4.7

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

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractAstObjects = extractAstObjects;
+const ts_morph_1 = require("ts-morph");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+async function extractAstObjects(filePath) {
+    // debug removed in final implementation
+    const project = new ts_morph_1.Project({ tsConfigFilePath: path_1.default.resolve("tsconfig.json") });
+    let sourceFile = project.addSourceFileAtPathIfExists(filePath);
+    if (!sourceFile) {
+        // fallback: read file contents and create source file in-memory
+        try {
+            const contents = fs_1.default.readFileSync(filePath, "utf8");
+            sourceFile = project.createSourceFile(filePath, contents, { overwrite: true });
+        }
+        catch (e) {
+            // eslint-disable-next-line no-console
+            console.log(`extractAstObjects: failed to read/create source file for ${filePath}: ${e}`);
+            return [];
+        }
+    }
+    // parsing completed
+    const objects = [];
+    // Functions
+    for (const fn of sourceFile.getFunctions()) {
+        const name = fn.getName() || "<anonymous>";
+        const isExported = fn.isExported();
+        const start = fn.getStartLineNumber();
+        const col = fn.getStart() ? sourceFile.getLineAndColumnAtPos(fn.getStart()).column : 1;
+        objects.push({
+            id: `${filePath}::${name}`,
+            name,
+            kind: "function",
+            location: { filePath, startLine: start, startColumn: col },
+            isExported,
+            signature: fn.getText(),
+        });
+    }
+    // Classes
+    for (const cls of sourceFile.getClasses()) {
+        const name = cls.getName() || "<anonymous>";
+        const isExported = cls.isExported();
+        const start = cls.getStartLineNumber();
+        const col = cls.getStart() ? sourceFile.getLineAndColumnAtPos(cls.getStart()).column : 1;
+        objects.push({
+            id: `${filePath}::${name}`,
+            name,
+            kind: "class",
+            location: { filePath, startLine: start, startColumn: col },
+            isExported,
+            signature: cls.getText(),
+        });
+    }
+    // Variable statements (consts/exports)
+    for (const vs of sourceFile.getVariableStatements()) {
+        const isExported = vs.isExported();
+        for (const decl of vs.getDeclarations()) {
+            const name = decl.getName();
+            const start = decl.getStartLineNumber();
+            const col = decl.getStart() ? sourceFile.getLineAndColumnAtPos(decl.getStart()).column : 1;
+            objects.push({
+                id: `${filePath}::${name}`,
+                name,
+                kind: "variable",
+                location: { filePath, startLine: start, startColumn: col },
+                isExported,
+                signature: decl.getText(),
+            });
+        }
+    }
+    return objects;
+}
+//# sourceMappingURL=parser.js.map

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

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

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

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

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

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writePatchForFile = writePatchForFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const formatter_1 = require("./formatter.cjs");
+function writePatchForFile(filePath, suggestions) {
+    const abs = path_1.default.resolve(filePath);
+    const original = fs_1.default.existsSync(abs) ? fs_1.default.readFileSync(abs, 'utf8') : '';
+    let patched = original;
+    for (const s of suggestions) {
+        const symbol = (s.id && s.id.split('::')[1]) || '';
+        patched = (0, formatter_1.applyJSDocToContent)(patched, s, symbol);
+    }
+    // simple unified-ish patch: header + original/new
+    const header = `--- a/${path_1.default.basename(filePath)}\n+++ b/${path_1.default.basename(filePath)}\n`;
+    const body = `@@\n- Original:\n${original.split('\n').slice(0, 20).join('\n')}\n+ Patched:\n${patched.split('\n').slice(0, 20).join('\n')}\n`;
+    const out = header + body;
+    const outDir = path_1.default.resolve('specs/001-ast-jsdoc-tools/reports/patches');
+    if (!fs_1.default.existsSync(outDir))
+        fs_1.default.mkdirSync(outDir, { recursive: true });
+    const fileName = path_1.default.join(outDir, `${path_1.default.basename(filePath)}.patch`);
+    fs_1.default.writeFileSync(fileName, out, 'utf8');
+    return fileName;
+}
+//# sourceMappingURL=patch.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/tools/ast-jsdoc-tools/patch.ts"],"names":[],"mappings":";;;;;AAKA,8CAkBC;AAvBD,4CAAoB;AACpB,gDAAwB;AAExB,+CAAkD;AAElD,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,WAA8B;IAChF,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,GAAG,IAAA,+BAAmB,EAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,kDAAkD;IAClD,MAAM,MAAM,GAAG,SAAS,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtF,MAAM,IAAI,GAAG,oBAAoB,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC5I,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;IACzE,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,YAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvE,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/tools/ast-jsdoc-tools/prompts/loader.cjs

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

package/lib/tools/ast-jsdoc-tools/prompts/loader.d.ts

@@ -0,0 +1,10 @@
+export type PromptTemplate = {
+    id: string;
+    fileName: string;
+    content: string;
+};
+/**
+ * Load all prompt templates from the feature specs prompts folder.
+ * Returns an array of PromptTemplate objects.
+ */
+export declare function loadPromptTemplates(baseDir?: string): PromptTemplate[];

package/lib/tools/ast-jsdoc-tools/prompts/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/prompts/loader.ts"],"names":[],"mappings":";;;;;AAaA,kDAkBC;AA/BD,4CAAoB;AACpB,gDAAwB;AAQxB;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,IAAI,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mCAAmC,CAAC,CAAC,CAAC;IAC9F,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAClH,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;QACT,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRepository = runRepository;
+const enumerator_1 = require("./enumerator.cjs");
+const fileRunner_1 = require("./fileRunner.cjs");
+const apply_1 = require("./apply.cjs");
+const patch_1 = require("./patch.cjs");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const uuid_1 = require("uuid");
+async function runRepository(rootPath = '.', options = { dryRun: true }) {
+    const startedAt = new Date().toISOString();
+    const runId = (0, uuid_1.v4)();
+    const files = await (0, enumerator_1.listSourceFiles)(rootPath);
+    const report = {
+        runId,
+        rootPath: path_1.default.resolve(rootPath),
+        filesProcessed: 0,
+        suggestionsTotal: 0,
+        changedFiles: [],
+        errors: [],
+        startedAt,
+    };
+    for (const f of files) {
+        try {
+            const fr = await (0, fileRunner_1.runFile)(f);
+            report.filesProcessed += 1;
+            report.suggestionsTotal += (fr.suggestions || []).length;
+            if (!options.dryRun && fr.suggestions && fr.suggestions.length) {
+                try {
+                    // apply changes in-place and write patch report
+                    const res = (0, apply_1.applySuggestionsToFile)(f, fr.suggestions);
+                    report.changedFiles.push(f);
+                    try {
+                        (0, patch_1.writePatchForFile)(f, fr.suggestions);
+                    }
+                    catch (e) {
+                        // non-fatal
+                    }
+                }
+                catch (e) {
+                    report.errors.push({ filePath: f, error: `apply failed: ${String(e)}` });
+                }
+            }
+        }
+        catch (e) {
+            report.errors.push({ filePath: f, error: String(e) });
+        }
+    }
+    report.finishedAt = new Date().toISOString();
+    // persist run report
+    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, `${runId}.repo.json`);
+        fs_1.default.writeFileSync(filename, JSON.stringify(report, null, 2), 'utf8');
+    }
+    catch (e) {
+        // ignore
+    }
+    return report;
+}
+//# sourceMappingURL=repoRunner.js.map

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

@@ -0,0 +1,16 @@
+export type RepositoryRunReport = {
+    runId: string;
+    rootPath: string;
+    filesProcessed: number;
+    suggestionsTotal: number;
+    changedFiles: string[];
+    errors: {
+        filePath: string;
+        error: string;
+    }[];
+    startedAt: string;
+    finishedAt?: string;
+};
+export declare function runRepository(rootPath?: string, options?: {
+    dryRun?: boolean;
+}): Promise<RepositoryRunReport>;

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

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

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

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateForObject = generateForObject;
+function paramListFromSignature(sig) {
+    const m = sig.match(/\(([^)]*)\)/);
+    if (!m)
+        return [];
+    const inside = m[1].trim();
+    if (!inside)
+        return [];
+    return inside.split(',').map((s) => s.split(':')[0].trim().replace(/[\s=].*$/, ''));
+}
+function generateForObject(obj) {
+    const kind = (obj.kind || '').toLowerCase();
+    const sig = obj.signature || obj.signature === '' ? obj.signature : '';
+    let needsReview = false;
+    let lines = [];
+    if (kind === 'function' || kind === 'functiondeclaration' || kind === 'functionexpression') {
+        if (!sig)
+            needsReview = true;
+        const params = paramListFromSignature(sig);
+        lines.push('/**');
+        lines.push(` * Function: ${obj.name || 'function'}`);
+        for (const p of params)
+            lines.push(` * @param ${p} `);
+        const ret = sig.match(/:\s*([^\)\s]+)\s*$/);
+        if (ret)
+            lines.push(` * @returns ${ret[1]}`);
+        if (needsReview)
+            lines.push(` * TODO: Describe ${obj.name || 'function'}`);
+        lines.push(' */');
+        return { suggestedDoc: lines.join('\n'), needsReview };
+    }
+    if (kind === 'class') {
+        // try to parse constructor params
+        const params = paramListFromSignature(sig);
+        lines.push('/**');
+        lines.push(` * Class: ${obj.name}`);
+        for (const p of params)
+            lines.push(` * @param ${p} `);
+        lines.push(' */');
+        return { suggestedDoc: lines.join('\n') };
+    }
+    if (kind === 'type' || kind === 'interface') {
+        // crude property listing
+        const props = (sig.match(/\{([^}]*)\}/) || [])[1] || '';
+        const parts = props.split(';').map((s) => s.trim()).filter(Boolean);
+        lines.push('/**');
+        lines.push(` * Type: ${obj.name}`);
+        for (const part of parts) {
+            const name = (part.split(':')[0] || '').trim();
+            if (name)
+                lines.push(` * @property ${name}`);
+        }
+        lines.push(' */');
+        return { suggestedDoc: lines.join('\n') };
+    }
+    if (kind === 'enum') {
+        const members = (sig.match(/\{([^}]*)\}/) || [])[1] || '';
+        const parts = members.split(',').map((s) => s.trim()).filter(Boolean);
+        lines.push('/**');
+        lines.push(` * Enum: ${obj.name}`);
+        for (const p of parts) {
+            const m = p.split('=')[0].trim();
+            if (m)
+                lines.push(` * @enum ${m}`);
+        }
+        lines.push(' */');
+        return { suggestedDoc: lines.join('\n') };
+    }
+    if (kind === 'constant' || kind === 'variable') {
+        lines.push('/**');
+        lines.push(` * constant: ${obj.name}`);
+        lines.push(' */');
+        return { suggestedDoc: lines.join('\n') };
+    }
+    // default fallback
+    return { suggestedDoc: `/**\n * TODO: Describe ${obj.name || 'item'}\n */`, needsReview: true };
+}
+exports.default = generateForObject;
+//# sourceMappingURL=jsdoc-generator.js.map

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

@@ -0,0 +1,5 @@
+export declare function generateForObject(obj: any): {
+    suggestedDoc: string;
+    needsReview?: boolean;
+};
+export default generateForObject;

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

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

package/lib/tools/ast-jsdoc-tools/utils/conflict-detector.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasExistingJsDoc = hasExistingJsDoc;
+function hasExistingJsDoc(fileContent, nodeStartLine) {
+    const lines = fileContent.split(/\r?\n/);
+    // look up to 10 lines above the node start for a JSDoc block
+    const startIdx = Math.max(0, nodeStartLine - 10); // nodeStartLine is 1-based
+    // check from the provided line (nodeStartLine - 1) upwards
+    for (let i = nodeStartLine - 1; i >= startIdx; i--) {
+        const line = (lines[i] || '').trim();
+        if (line.endsWith('*/') || line === '*/') {
+            // gather the block
+            let j = i;
+            const blockLines = [];
+            while (j >= 0) {
+                blockLines.unshift(lines[j]);
+                if (lines[j].trim().startsWith('/**'))
+                    break;
+                j--;
+            }
+            const block = blockLines.join('\n');
+            if (block.includes('/**')) {
+                return { has: true, block };
+            }
+        }
+        // stop if hit a blank line or code line without comment marker
+        if (line && !line.startsWith('*') && !line.startsWith('//') && !line.startsWith('/**'))
+            break;
+    }
+    return { has: false, block: '' };
+}
+exports.default = hasExistingJsDoc;
+//# sourceMappingURL=conflict-detector.js.map

package/lib/tools/ast-jsdoc-tools/utils/conflict-detector.d.ts

@@ -0,0 +1,5 @@
+export declare function hasExistingJsDoc(fileContent: string, nodeStartLine: number): {
+    has: boolean;
+    block: string;
+};
+export default hasExistingJsDoc;

package/lib/tools/ast-jsdoc-tools/utils/conflict-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/conflict-detector.ts"],"names":[],"mappings":";;AAAA,4CAyBC;AAzBD,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,aAAqB;IACzE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC,2BAA2B;IAC7E,2DAA2D;IAC3D,KAAK,IAAI,CAAC,GAAG,aAAa,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACzC,mBAAmB;YACnB,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,MAAM,UAAU,GAAG,EAAc,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACd,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;oBAAE,MAAM;gBAC7C,CAAC,EAAE,CAAC;YACN,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,+DAA+D;QAC/D,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM;IAChG,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,kBAAe,gBAAgB,CAAC"}

package/lib/tools/ast-jsdoc-tools/utils/context-schema.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMappingFile = validateMappingFile;
+/** Very small validator for the mapping file used by the tool.
+ * Returns { valid, errors } where errors is a list of strings describing issues.
+ */
+function validateMappingFile(obj) {
+    const errors = [];
+    if (!obj || typeof obj !== 'object') {
+        return { valid: false, errors: ['mapping is not an object'] };
+    }
+    if (!obj.mappingVersion || typeof obj.mappingVersion !== 'string') {
+        errors.push('mappingVersion must be a string');
+    }
+    if (obj.overrides) {
+        if (typeof obj.overrides !== 'object')
+            errors.push('overrides must be an object');
+        else if (obj.overrides.files) {
+            if (!Array.isArray(obj.overrides.files))
+                errors.push('overrides.files must be an array');
+            else {
+                for (const [i, e] of obj.overrides.files.entries()) {
+                    if (!e.pattern || typeof e.pattern !== 'string')
+                        errors.push(`overrides.files[${i}].pattern must be a string`);
+                }
+            }
+        }
+    }
+    // heuristics optional
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=context-schema.js.map

package/lib/tools/ast-jsdoc-tools/utils/context-schema.d.ts

@@ -0,0 +1,7 @@
+/** Very small validator for the mapping file used by the tool.
+ * Returns { valid, errors } where errors is a list of strings describing issues.
+ */
+export declare function validateMappingFile(obj: any): {
+    valid: boolean;
+    errors: string[];
+};

package/lib/tools/ast-jsdoc-tools/utils/context-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-schema.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/context-schema.ts"],"names":[],"mappings":";;AAMA,kDAqBC;AAxBD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,GAAQ;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QAClE,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;aAC7E,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;iBACpF,CAAC;gBACJ,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;oBACnD,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;wBAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,4BAA4B,CAAC,CAAC;gBACjH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,sBAAsB;IACtB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/lib/tools/ast-jsdoc-tools/utils/heuristics.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferContextHints = inferContextHints;
+function inferContextHints(filePath, repoRoot = '.') {
+    const hints = [];
+    const p = filePath.replace(/\\/g, '/');
+    const parts = p.split('/');
+    // directory-based hints
+    if (p.includes('/cli/') || p.endsWith('.cli.ts') || p.includes('/bin/'))
+        hints.push('cli');
+    if (p.includes('/api/'))
+        hints.push('api');
+    if (/\.controller\./.test(p) || p.includes('.controller'))
+        hints.push('controller');
+    if (p.includes('/tests/') || p.includes('/test-fixtures/'))
+        hints.push('test');
+    if (p.startsWith('lib/') || p.startsWith('dist/') || p.startsWith('build/'))
+        hints.push('library');
+    // filename-based hints
+    const file = parts[parts.length - 1] || '';
+    if (/index\./i.test(file))
+        hints.push('index');
+    if (/service\.|\.service\./i.test(file))
+        hints.push('service');
+    if (/router\.|\.router\./i.test(file))
+        hints.push('router');
+    // export surface heuristics
+    if (p.includes('/src/'))
+        hints.push('source');
+    // normalize unique
+    return Array.from(new Set(hints));
+}
+exports.default = inferContextHints;
+//# sourceMappingURL=heuristics.js.map

package/lib/tools/ast-jsdoc-tools/utils/heuristics.d.ts

@@ -0,0 +1,2 @@
+export declare function inferContextHints(filePath: string, repoRoot?: string): string[];
+export default inferContextHints;

package/lib/tools/ast-jsdoc-tools/utils/heuristics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heuristics.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/heuristics.ts"],"names":[],"mappings":";;AAAA,8CAuBC;AAvBD,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,QAAQ,GAAG,GAAG;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3B,wBAAwB;IACxB,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3F,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpF,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/E,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEnG,uBAAuB;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5D,4BAA4B;IAC5B,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE9C,mBAAmB;IACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,kBAAe,iBAAiB,CAAC"}

package/lib/tools/ast-jsdoc-tools/utils/ts-project.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeFile = analyzeFile;
+const ts_morph_1 = require("ts-morph");
+const fs = __importStar(require("fs"));
+async function analyzeFile(filePath) {
+    try {
+        const p = new ts_morph_1.Project({ tsConfigFilePath: 'tsconfig.json' });
+        if (fs.existsSync(filePath)) {
+            const sf = p.addSourceFileAtPathIfExists(filePath) || p.createSourceFile(filePath, fs.readFileSync(filePath, 'utf8'));
+            return {
+                filePath,
+                functions: sf.getFunctions().map(f => f.getName()),
+                classes: sf.getClasses().map(c => c.getName()),
+            };
+        }
+        return { filePath, functions: [], classes: [] };
+    }
+    catch (e) {
+        return { filePath, functions: [], classes: [], error: String(e) };
+    }
+}
+exports.default = analyzeFile;
+//# sourceMappingURL=ts-project.js.map

package/lib/tools/ast-jsdoc-tools/utils/ts-project.d.ts

@@ -0,0 +1,12 @@
+export declare function analyzeFile(filePath: string): Promise<{
+    filePath: string;
+    functions: (string | undefined)[];
+    classes: (string | undefined)[];
+    error?: undefined;
+} | {
+    filePath: string;
+    functions: never[];
+    classes: never[];
+    error: string;
+}>;
+export default analyzeFile;

package/lib/tools/ast-jsdoc-tools/utils/ts-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-project.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/ts-project.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,kCAeC;AAlBD,uCAAmC;AACnC,uCAAyB;AAElB,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,kBAAO,CAAC,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAAC;QAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,CAAC,2BAA2B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YACtH,OAAO;gBACL,QAAQ;gBACR,SAAS,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBAClD,OAAO,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC;AACH,CAAC;AAED,kBAAe,WAAW,CAAC"}

package/lib/tools/example-tool/index.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExampleTool = void 0;
+const tool_builder_1 = require("./../../builders/tool-builder.cjs");
+const zod_1 = require("zod");
+const constants_1 = require("./../../constants.cjs");
+// A tiny example tool that reverses an input string. Useful as a smoke/example tool.
+exports.ExampleTool = tool_builder_1.ToolBuilder.builder
+    .setName("example-tool")
+    .setTitle("Example: Reverse String Tool")
+    .setDescription("Reverses the provided `text` input and returns the result.")
+    .setInputSchema(zod_1.z.object({ text: zod_1.z.string() }))
+    .setCb(async (args, _extra) => {
+    const text = args?.text ?? "";
+    const reversed = String(text).split("").reverse().join("");
+    return {
+        // Human-readable content for models and UIs
+        content: [
+            {
+                type: "text",
+                text: reversed,
+            },
+        ],
+        // Structured content matching the declared outputSchema: { result: string }
+        structuredContent: { result: reversed },
+    };
+})
+    .setReasoning(constants_1.ReasoningLevel.NONE)
+    .setEffort(constants_1.EffortLevel.NONE)
+    .setCost(constants_1.Cost.FREE);
+// Named export already provided above; avoid default exports per repository policy.
+//# sourceMappingURL=index.js.map

package/lib/tools/example-tool/index.d.ts

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

package/lib/tools/example-tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/example-tool/index.ts"],"names":[],"mappings":";;;AAAA,oEAA0D;AAC1D,6BAAwB;AACxB,qDAAoE;AAOpE,qFAAqF;AACxE,QAAA,WAAW,GAAG,0BAAW,CAAC,OAAO;KAC3C,OAAO,CAAC,cAAc,CAAC;KACvB,QAAQ,CAAC,8BAA8B,CAAC;KACxC,cAAc,CAAC,4DAA4D,CAAC;KAC5E,cAAc,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;KAC9C,KAAK,CAAC,KAAK,EAAE,IAAS,EAAE,MAA8D,EAAE,EAAE;IACzF,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,OAAO;QACL,4CAA4C;QAC5C,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;aACf;SACF;QACD,4EAA4E;QAC5E,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KACjC,CAAC;AACX,CAAC,CAAC;KACD,YAAY,CAAC,0BAAc,CAAC,IAAI,CAAC;KACjC,SAAS,CAAC,uBAAW,CAAC,IAAI,CAAC;KAC3B,OAAO,CAAC,gBAAI,CAAC,IAAI,CAAC,CAAC;AAEtB,oFAAoF"}