@decaf-ts/mcp-server 0.4.9 → 0.4.16

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

@@ -1 +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"}
+{"version":3,"file":"heuristics.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/heuristics.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,gCAAgC;AAChC,4CAA4C;AAC5C,gCAAgC;AAChC,EAAE;AACF,6BAA6B;AAC7B,gGAAgG;AAChG,gDAAgD;AAChD,yFAAyF;AACzF,oFAAoF;AACpF,wGAAwG;AACxG,EAAE;AACF,4BAA4B;AAC5B,gDAAgD;AAChD,oDAAoD;AACpD,oEAAoE;AACpE,iEAAiE;AACjE,EAAE;AACF,iCAAiC;AACjC,mDAAmD;AACnD,EAAE;AACF,wBAAwB;AACxB,uCAAuC;AACvC,IAAI;AACJ,EAAE;AACF,EAAE"}

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

@@ -0,0 +1,18 @@
+"use strict";
+// import { Logging } from '@decaf-ts/logging';
+//
+// const log = Logging.for('ast-jsdoc-tools');
+//
+// export function emit(event: string, payload: Record<string, unknown> = {}) {
+//   // Minimal structured logger for tests and local dev.
+//   // In production this would wire into a metrics/telemetry system.
+//   // Keep output minimal to avoid noisy logs in tests.
+//   try {
+//     log.debug(`[ast-jsdoc-tools] ${event} ` + JSON.stringify(payload));
+//   } catch (_) {
+//     log.debug(`[ast-jsdoc-tools] ${event}`);
+//   }
+// }
+//
+//
+//# sourceMappingURL=logging.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/logging.ts"],"names":[],"mappings":";AAAA,+CAA+C;AAC/C,EAAE;AACF,8CAA8C;AAC9C,EAAE;AACF,+EAA+E;AAC/E,0DAA0D;AAC1D,sEAAsE;AACtE,yDAAyD;AACzD,UAAU;AACV,0EAA0E;AAC1E,kBAAkB;AAClB,+CAA+C;AAC/C,MAAM;AACN,IAAI;AACJ,EAAE;AACF,EAAE"}

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

@@ -1,57 +1,23 @@
 "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;
+// import { Project } from 'ts-morph';
+// import * as fs from 'fs';
+//
+// export async function analyzeFile(filePath: string) {
+//   try {
+//     const p = new 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) };
+//   }
+// }
+//
+//
 //# sourceMappingURL=ts-project.js.map

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

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

@@ -1 +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"}
+{"version":3,"file":"ts-project.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/utils/ts-project.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC,4BAA4B;AAC5B,EAAE;AACF,wDAAwD;AACxD,UAAU;AACV,oEAAoE;AACpE,qCAAqC;AACrC,+HAA+H;AAC/H,iBAAiB;AACjB,oBAAoB;AACpB,8DAA8D;AAC9D,0DAA0D;AAC1D,WAAW;AACX,QAAQ;AACR,uDAAuD;AACvD,kBAAkB;AAClB,yEAAyE;AACzE,MAAM;AACN,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/decoration/builder.cjs

@@ -0,0 +1,81 @@
+"use strict";
+// // Lightweight in-repo Decoration builder used by unit tests.
+// // This provides a minimal, deterministic API the tests rely on. The
+// // full implementation is out-of-scope for these unit tests and is provided
+// // via the schematics resource in production usage.
+//
+// export const DefaultFlavour = 'default';
+//
+// type DecoratorFn = (target: any) => void;
+//
+// class DecorationBuilder {
+//   private static registry: Map<string, Map<string, DecoratorFn>> = new Map();
+//   private static flavourResolver: (target: any) => string = () => DefaultFlavour;
+//
+//   private key!: string;
+//   private flavour: string = DefaultFlavour;
+//   private fn?: DecoratorFn;
+//
+//   static for(key: string) {
+//     const inst = new DecorationBuilder();
+//     inst.key = key;
+//     inst.flavour = DefaultFlavour;
+//     return inst;
+//   }
+//
+//   static flavouredAs(flavour: string) {
+//     return {
+//       for: (key: string) => {
+//         const inst = new DecorationBuilder();
+//         inst.key = key;
+//         inst.flavour = flavour;
+//         return inst;
+//       },
+//     };
+//   }
+//
+//   static setFlavourResolver(fn: (target: any) => string) {
+//     DecorationBuilder.flavourResolver = fn;
+//   }
+//
+//   define(fn: DecoratorFn) {
+//     this.fn = fn;
+//     // register immediately under the configured flavour
+//     let map = DecorationBuilder.registry.get(this.key);
+//     if (!map) {
+//       map = new Map();
+//       DecorationBuilder.registry.set(this.key, map);
+//     }
+//     map.set(this.flavour, fn as DecoratorFn);
+//     return this;
+//   }
+//
+//   // apply returns the decorator function that chooses the flavour at call time
+//   apply() {
+//     const key = this.key;
+//     return (target: any) => {
+//       const flavour = DecorationBuilder.flavourResolver
+//         ? DecorationBuilder.flavourResolver(target)
+//         : DefaultFlavour;
+//       const map = DecorationBuilder.registry.get(key);
+//       const chosen = map?.get(flavour) ?? map?.get(DefaultFlavour);
+//       if (chosen) chosen(target);
+//     };
+//   }
+//
+//   // convenience accessor for tests that call Decoration.for(...).apply() statically
+//   static forApply(key: string) {
+//     return DecorationBuilder.for(key).apply();
+//   }
+// }
+//
+// export const Decoration = {
+//   for: DecorationBuilder.for.bind(DecorationBuilder),
+//   flavouredAs: DecorationBuilder.flavouredAs.bind(DecorationBuilder),
+//   setFlavourResolver: DecorationBuilder.setFlavourResolver.bind(DecorationBuilder),
+//   // for test convenience expose apply helper
+//   applyFor: DecorationBuilder.forApply.bind(DecorationBuilder),
+// };
+//
+//
+//# sourceMappingURL=builder.js.map

package/lib/tools/decoration/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/tools/decoration/builder.ts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,uEAAuE;AACvE,8EAA8E;AAC9E,sDAAsD;AACtD,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4CAA4C;AAC5C,EAAE;AACF,4BAA4B;AAC5B,gFAAgF;AAChF,oFAAoF;AACpF,EAAE;AACF,0BAA0B;AAC1B,8CAA8C;AAC9C,8BAA8B;AAC9B,EAAE;AACF,8BAA8B;AAC9B,4CAA4C;AAC5C,sBAAsB;AACtB,qCAAqC;AACrC,mBAAmB;AACnB,MAAM;AACN,EAAE;AACF,0CAA0C;AAC1C,eAAe;AACf,gCAAgC;AAChC,gDAAgD;AAChD,0BAA0B;AAC1B,kCAAkC;AAClC,uBAAuB;AACvB,WAAW;AACX,SAAS;AACT,MAAM;AACN,EAAE;AACF,6DAA6D;AAC7D,8CAA8C;AAC9C,MAAM;AACN,EAAE;AACF,8BAA8B;AAC9B,oBAAoB;AACpB,2DAA2D;AAC3D,0DAA0D;AAC1D,kBAAkB;AAClB,yBAAyB;AACzB,uDAAuD;AACvD,QAAQ;AACR,gDAAgD;AAChD,mBAAmB;AACnB,MAAM;AACN,EAAE;AACF,kFAAkF;AAClF,cAAc;AACd,4BAA4B;AAC5B,gCAAgC;AAChC,0DAA0D;AAC1D,sDAAsD;AACtD,4BAA4B;AAC5B,yDAAyD;AACzD,sEAAsE;AACtE,oCAAoC;AACpC,SAAS;AACT,MAAM;AACN,EAAE;AACF,uFAAuF;AACvF,mCAAmC;AACnC,iDAAiD;AACjD,MAAM;AACN,IAAI;AACJ,EAAE;AACF,8BAA8B;AAC9B,wDAAwD;AACxD,wEAAwE;AACxE,sFAAsF;AACtF,gDAAgD;AAChD,kEAAkE;AAClE,KAAK;AACL,EAAE;AACF,EAAE"}

package/lib/tools/decoration/decorators.cjs

@@ -0,0 +1,37 @@
+"use strict";
+// import { Metadata } from '../../..//specs/002-decoration/golden/metadata/Metadata';
+//
+// export function metadata(key: string, value: any) {
+//   return function (target: any) {
+//     Metadata.set(target, key, value);
+//   };
+// }
+//
+// export function apply(...decorators: Array<Function>) {
+//   return function (target: any) {
+//     decorators.forEach(d => d(target));
+//   };
+// }
+//
+// export function methodMetadata(key: string, value: any) {
+//   // method decorator signature: (target, propertyKey, descriptor)
+//   return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+//     const ctor = target.constructor || target;
+//     Metadata.set(ctor, key, value);
+//   } as any;
+// }
+//
+// export function description(text: string) {
+//   return function (target: any, propertyKey?: string) {
+//     if (typeof propertyKey === 'string') {
+//       const ctor = (target && target.constructor) || target;
+//       Metadata.set(ctor, Metadata.key('description', propertyKey), text);
+//     } else {
+//       // used as class decorator
+//       Metadata.set(target, Metadata.key('description', 'class'), text);
+//     }
+//   } as any;
+// }
+//
+//
+//# sourceMappingURL=decorators.js.map

package/lib/tools/decoration/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../src/tools/decoration/decorators.ts"],"names":[],"mappings":";AAAA,sFAAsF;AACtF,EAAE;AACF,sDAAsD;AACtD,oCAAoC;AACpC,wCAAwC;AACxC,OAAO;AACP,IAAI;AACJ,EAAE;AACF,0DAA0D;AAC1D,oCAAoC;AACpC,0CAA0C;AAC1C,OAAO;AACP,IAAI;AACJ,EAAE;AACF,4DAA4D;AAC5D,qEAAqE;AACrE,yFAAyF;AACzF,iDAAiD;AACjD,sCAAsC;AACtC,cAAc;AACd,IAAI;AACJ,EAAE;AACF,8CAA8C;AAC9C,0DAA0D;AAC1D,6CAA6C;AAC7C,+DAA+D;AAC/D,4EAA4E;AAC5E,eAAe;AACf,mCAAmC;AACnC,0EAA0E;AAC1E,QAAQ;AACR,cAAc;AACd,IAAI;AACJ,EAAE;AACF,EAAE"}

package/lib/tools/decoration/index.cjs

@@ -0,0 +1,49 @@
+"use strict";
+// /**
+//  * Minimal MCP tool skeletons for the decoration module.
+//  * These exports provide a deterministic interface the MCP LLM can call
+//  * when implementing the confirmed functionality tasks. They are intentionally
+//  * small and dependency-free; the MCP LLM will be guided by prompts and
+//  * golden artifacts under `specs/002-decoration/golden/`.
+//  */
+//
+// import * as path from "path";
+//
+// export const TOOL_NAME = "decoration-tools";
+//
+// export function describeConfirmedTasks() {
+//   return {
+//     name: TOOL_NAME,
+//     confirmed: [
+//       "Decoration builder",
+//       "Flavour resolution",
+//       "Metadata store + mirroring + overriding",
+//       "Decorator utilities",
+//       "Predictable decorator order",
+//       "Reflect-metadata integration",
+//       "Introspection utilities",
+//     ],
+//     goldenPath: path.join(process.cwd(), "specs", "002-decoration", "golden"),
+//   };
+// }
+//
+// export function sampleRunner() {
+//   // This runner is a lightweight helper the MCP can call to locate golden artifacts
+//   // and run local static checks. Heavy execution (compiling ./temp) is left to the
+//   // MCP environment where TypeScript tooling is available.
+//   const desc = describeConfirmedTasks();
+//   return {
+//     ok: true,
+//     message: `Tool skeleton for ${desc.name} available`,
+//     goldenPath: desc.goldenPath,
+//   };
+// }
+//
+//
+//
+// // Export decorator helpers so MCP LLMs can import a stable API surface
+// // pointing at the authoritative implementation in `./temp`.
+// // The builder surface is provided as a schematics resource. Export that resource
+// // so MCP tooling can access the canonical schematics package.
+// export * as resource from "../../resources/decoration-schematics";
+//# sourceMappingURL=index.js.map

package/lib/tools/decoration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/decoration/index.ts"],"names":[],"mappings":";AAAA,MAAM;AACN,2DAA2D;AAC3D,0EAA0E;AAC1E,iFAAiF;AACjF,0EAA0E;AAC1E,4DAA4D;AAC5D,MAAM;AACN,EAAE;AACF,gCAAgC;AAChC,EAAE;AACF,+CAA+C;AAC/C,EAAE;AACF,6CAA6C;AAC7C,aAAa;AACb,uBAAuB;AACvB,mBAAmB;AACnB,8BAA8B;AAC9B,8BAA8B;AAC9B,mDAAmD;AACnD,+BAA+B;AAC/B,uCAAuC;AACvC,wCAAwC;AACxC,mCAAmC;AACnC,SAAS;AACT,iFAAiF;AACjF,OAAO;AACP,IAAI;AACJ,EAAE;AACF,mCAAmC;AACnC,uFAAuF;AACvF,sFAAsF;AACtF,8DAA8D;AAC9D,2CAA2C;AAC3C,aAAa;AACb,gBAAgB;AAChB,2DAA2D;AAC3D,mCAAmC;AACnC,OAAO;AACP,IAAI;AACJ,EAAE;AACF,EAAE;AACF,EAAE;AACF,0EAA0E;AAC1E,+DAA+D;AAC/D,oFAAoF;AACpF,iEAAiE;AACjE,qEAAqE"}

package/lib/tools/file-summarizer/index.cjs

@@ -1,32 +1,42 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileSummarizer = void 0;
-const tool_builder_1 = require("./../../builders/tool-builder.cjs");
-const zod_1 = require("zod");
-const constants_1 = require("./../../constants.cjs");
-const index_1 = require("./../ast-jsdoc-tools/index.cjs");
-exports.FileSummarizer = tool_builder_1.ToolBuilder.builder
-    .setName("file.summarizer")
-    .setTitle("File Summarizer")
-    .setDescription("Produce a short structured summary for a TypeScript file.")
-    .setInputSchema(zod_1.z.object({ filePath: zod_1.z.string() }))
-    .setCb(async (args, _extra) => {
-    const filePath = args?.filePath ?? args?.path;
-    if (!filePath)
-        return { content: [{ type: "text", text: "" }] };
-    const res = await (0, index_1.analyzeFile)(filePath).catch(() => null);
-    const objects = (res && res.astObjects) || [];
-    const names = objects.map((o) => o.name || o.id || o.kind).slice(0, 20);
-    const summary = `Found ${objects.length} AST objects. Top names: ${names.join(", ")}`;
-    return {
-        // Text content for readability
-        content: [{ type: "text", text: summary }],
-        // Structured content matching the declared outputSchema: { summary: string }
-        structuredContent: { summary },
-        _meta: { count: objects.length },
-    };
-})
-    .setReasoning(constants_1.ReasoningLevel.NONE)
-    .setEffort(constants_1.EffortLevel.NONE)
-    .setCost(constants_1.Cost.FREE);
+// import { ToolBuilder } from "../../builders/tool-builder";
+// import { z } from "zod";
+// import { ReasoningLevel, EffortLevel, Cost } from "../../constants";
+// import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol";
+// import type {
+//   ServerNotification,
+//   ServerRequest,
+// } from "@modelcontextprotocol/sdk/types";
+// import { analyzeFile } from "../ast-jsdoc-tools/index";
+//
+// export const FileSummarizer = ToolBuilder.builder
+//   .setName("file.summarizer")
+//   .setTitle("File Summarizer")
+//   .setDescription("Produce a short structured summary for a TypeScript file.")
+//   .setInputSchema(z.object({ filePath: z.string() }))
+//   .setCb(
+//     async (
+//       args: any,
+//       _extra: RequestHandlerExtra<ServerRequest, ServerNotification>
+//     ) => {
+//       const filePath = args?.filePath ?? args?.path;
+//       if (!filePath) return { content: [{ type: "text", text: "" }] } as any;
+//       const res: any = await analyzeFile(filePath).catch(() => null);
+//       const objects = (res && res.astObjects) || [];
+//       const names = objects.map((o: any) => o.name || o.id || o.kind).slice(0, 20);
+//       const summary = `Found ${objects.length} AST objects. Top names: ${names.join(", ")}`;
+//       return {
+//         // Text content for readability
+//         content: [{ type: "text", text: summary }],
+//         // Structured content matching the declared outputSchema: { summary: string }
+//         structuredContent: { summary },
+//         _meta: { count: objects.length },
+//       } as any;
+//     }
+//   )
+//   .setReasoning(ReasoningLevel.NONE)
+//   .setEffort(EffortLevel.NONE)
+//   .setCost(Cost.FREE);
+//
+//
 //# sourceMappingURL=index.js.map

package/lib/tools/file-summarizer/index.d.ts

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

package/lib/tools/file-summarizer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/file-summarizer/index.ts"],"names":[],"mappings":";;;AAAA,oEAA0D;AAC1D,6BAAwB;AACxB,qDAAoE;AAMpE,0DAAuD;AAE1C,QAAA,cAAc,GAAG,0BAAW,CAAC,OAAO;KAC9C,OAAO,CAAC,iBAAiB,CAAC;KAC1B,QAAQ,CAAC,iBAAiB,CAAC;KAC3B,cAAc,CAAC,2DAA2D,CAAC;KAC3E,cAAc,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;KAClD,KAAK,CACJ,KAAK,EACH,IAAS,EACT,MAA8D,EAC9D,EAAE;IACF,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,IAAI,CAAC;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAS,CAAC;IACvE,MAAM,GAAG,GAAQ,MAAM,IAAA,mBAAW,EAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,SAAS,OAAO,CAAC,MAAM,4BAA4B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtF,OAAO;QACL,+BAA+B;QAC/B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,6EAA6E;QAC7E,iBAAiB,EAAE,EAAE,OAAO,EAAE;QAC9B,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;KAC1B,CAAC;AACX,CAAC,CACF;KACA,YAAY,CAAC,0BAAc,CAAC,IAAI,CAAC;KACjC,SAAS,CAAC,uBAAW,CAAC,IAAI,CAAC;KAC3B,OAAO,CAAC,gBAAI,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/file-summarizer/index.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,2BAA2B;AAC3B,uEAAuE;AACvE,wFAAwF;AACxF,gBAAgB;AAChB,wBAAwB;AACxB,mBAAmB;AACnB,4CAA4C;AAC5C,0DAA0D;AAC1D,EAAE;AACF,oDAAoD;AACpD,gCAAgC;AAChC,iCAAiC;AACjC,iFAAiF;AACjF,wDAAwD;AACxD,YAAY;AACZ,cAAc;AACd,mBAAmB;AACnB,uEAAuE;AACvE,aAAa;AACb,uDAAuD;AACvD,gFAAgF;AAChF,wEAAwE;AACxE,uDAAuD;AACvD,sFAAsF;AACtF,+FAA+F;AAC/F,iBAAiB;AACjB,0CAA0C;AAC1C,sDAAsD;AACtD,wFAAwF;AACxF,0CAA0C;AAC1C,4CAA4C;AAC5C,kBAAkB;AAClB,QAAQ;AACR,MAAM;AACN,uCAAuC;AACvC,iCAAiC;AACjC,yBAAyB;AACzB,EAAE;AACF,EAAE"}

package/lib/tools/index.cjs

@@ -1,9 +1,31 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Tools = void 0;
-const ts_ast_tool_1 = require("./ast/ts-ast-tool.cjs");
-const example_tool_1 = require("./example-tool/index.cjs");
-const file_summarizer_1 = require("./file-summarizer/index.cjs");
-const ast_jsdoc_tools_1 = require("./ast-jsdoc-tools/index.cjs");
-exports.Tools = [ts_ast_tool_1.TsAstTool, example_tool_1.ExampleTool, file_summarizer_1.FileSummarizer, ast_jsdoc_tools_1.AstJsdocTool];
+// import { TsAstTool } from "./ast/ts-ast-tool";
+// import { ToolBuilder } from "../builders/tool-builder";
+// import { ExampleTool } from "./example-tool";
+// import { FileSummarizer } from "./file-summarizer";
+// import { AstJsdocTool, AstJsdocGeneratorTool } from "./ast-jsdoc-tools";
+// import { TsDocumentElementTool as JsdocElementTool } from "./jsdoc/ts-jsdoc-element-tool";
+// import { TsDocumentElementTool as JestListTestsTool } from "./testing/ts-jest-list-tests";
+// import { JiraIssueCreateTool, JiraProjectListTool, JiraSearchJqlTool, JiraAgileBoardListTool, JiraIssueTransitionTool } from "../modules/jira";
+//
+// // NOTE: This file MUST export every ToolBuilder defined anywhere under `src/tools`.
+// // The MCP server `load` method imports this list and performs centralized
+// // registration. Keep this list updated when adding new tools.
+// export const Tools: ToolBuilder[] = [
+// 	TsAstTool,
+// 	ExampleTool,
+// 	FileSummarizer,
+// 	AstJsdocTool,
+// 	AstJsdocGeneratorTool,
+// 	// JS/TS documentation helpers
+// 	JsdocElementTool,
+// 	// Testing helpers
+// 	JestListTestsTool,
+// 	// Jira integrations (module-provided builders)
+// 	JiraIssueCreateTool,
+// 	JiraProjectListTool,
+// 	JiraSearchJqlTool,
+// 	JiraAgileBoardListTool,
+// 	JiraIssueTransitionTool,
+// ];
 //# sourceMappingURL=index.js.map

package/lib/tools/index.d.ts

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

package/lib/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,uDAA8C;AAE9C,2DAA6C;AAC7C,iEAAmD;AACnD,iEAAiD;AAEpC,QAAA,KAAK,GAAkB,CAAC,uBAAS,EAAE,0BAAW,EAAE,gCAAc,EAAE,8BAAY,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,0DAA0D;AAC1D,gDAAgD;AAChD,sDAAsD;AACtD,2EAA2E;AAC3E,6FAA6F;AAC7F,6FAA6F;AAC7F,kJAAkJ;AAClJ,EAAE;AACF,uFAAuF;AACvF,6EAA6E;AAC7E,iEAAiE;AACjE,wCAAwC;AACxC,cAAc;AACd,gBAAgB;AAChB,mBAAmB;AACnB,iBAAiB;AACjB,0BAA0B;AAC1B,kCAAkC;AAClC,qBAAqB;AACrB,sBAAsB;AACtB,sBAAsB;AACtB,mDAAmD;AACnD,wBAAwB;AACxB,wBAAwB;AACxB,sBAAsB;AACtB,2BAA2B;AAC3B,4BAA4B;AAC5B,KAAK"}

package/lib/tools/issue/create-tool.cjs

@@ -0,0 +1,132 @@
+"use strict";
+// /**
+//  * Jira Issue Create Tool (Version3-only)
+//  *
+//  * Create an issue in Jira Cloud.
+//  * Endpoint: POST /rest/api/3/issue
+//  */
+//
+// import { validateWithSchema } from "../../jira/tool-utils";
+// import { normalizeJiraError } from "../../jira/errors";
+// import { z } from "zod";
+// import { Logging } from "@decaf-ts/logging";
+//
+// const log = Logging.for("jira.issue-create");
+//
+// export const name = "jira.issue-create";
+//
+// export const inputSchema = z.union([
+//   z.object({ fields: z.record(z.any()) }),
+//   z.object({
+//     summary: z.string(),
+//     projectKey: z.string(),
+//     issueType: z.string(),
+//     description: z.string().optional(),
+//   }),
+// ]);
+//
+// export const outputSchema = z.object({
+//   id: z.string(),
+//   key: z.string(),
+//   self: z.string().optional(),
+// });
+//
+// export async function runTool(client: any, input: any) {
+//   log.debug("[jira.create.run] input: " + JSON.stringify(input));
+//   const hasFields = !!(
+//     input &&
+//     typeof input === "object" &&
+//     "fields" in input &&
+//     input.fields
+//   );
+//   const hasLegacyShape = !!(
+//     input &&
+//     typeof input === "object" &&
+//     typeof input.summary === "string" &&
+//     typeof input.projectKey === "string" &&
+//     typeof input.issueType === "string"
+//   );
+//   if (!hasFields && !hasLegacyShape) {
+//     const e = new Error(
+//       "Invalid input: fields or legacy fields (summary/projectKey/issueType) are required"
+//     );
+//     (e as any).code = "validation_error";
+//     throw e;
+//   }
+//   const v = validateWithSchema(input, inputSchema as any);
+//   if (!v.valid) {
+//     const e = new Error(
+//       "Invalid input: " +
+//         (v.errors ? v.errors.join("; ") : "schema validation failed")
+//     );
+//     (e as any).code = "validation_error";
+//     throw e;
+//   }
+//
+//   try {
+//     let payload: any;
+//     if (
+//       input &&
+//       typeof input === "object" &&
+//       "fields" in input &&
+//       input.fields
+//     ) {
+//       payload = input;
+//     } else if (
+//       input &&
+//       typeof input === "object" &&
+//       (input.summary || input.projectKey || input.issueType)
+//     ) {
+//       payload = {
+//         fields: {
+//           summary: input.summary,
+//           project: { key: input.projectKey },
+//           issuetype: { name: input.issueType },
+//           ...(input.description ? { description: input.description } : {}),
+//         },
+//       };
+//     } else {
+//       payload = input;
+//     }
+//
+//     if (!payload || !payload.fields) {
+//       const e = new Error("Invalid input: fields is required");
+//       (e as any).code = "validation_error";
+//       throw e;
+//     }
+//
+//     // Directly call Version3Client helper. Support both `create` and legacy
+//     // `createIssue` method names to be tolerant of different client shapes
+//     // used by tests and earlier versions of the Jira SDK.
+//     const createFn = client?.issues?.create ?? client?.issues?.createIssue;
+//     if (typeof createFn !== "function") {
+//       const e = new Error(
+//         "Jira client does not expose a create function on client.issues"
+//       );
+//       (e as any).code = "client_error";
+//       throw e;
+//     }
+//     const res = await createFn.call(client.issues, { fields: payload.fields });
+//
+//     try {
+//       log.debug(
+//         "[jira.create.run] jira client response: " + JSON.stringify(res)
+//       );
+//     } catch (_) {
+//       log.debug("[jira.create.run] jira client response (non-serializable)");
+//     }
+//
+//     const resObj = (res && (res as any).data) || res;
+//     const out = { id: resObj?.id, key: resObj?.key, self: resObj?.self };
+//     const vo = validateWithSchema(out, outputSchema as any);
+//     if (!vo.valid) {
+//       return { ...out, _raw: res };
+//     }
+//     return out;
+//   } catch (err: any) {
+//     throw normalizeJiraError(err);
+//   }
+// }
+//
+// export default { name, inputSchema, runTool };
+//# sourceMappingURL=create-tool.js.map

package/lib/tools/issue/create-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-tool.js","sourceRoot":"","sources":["../../../src/tools/issue/create-tool.ts"],"names":[],"mappings":";AAAA,MAAM;AACN,4CAA4C;AAC5C,KAAK;AACL,oCAAoC;AACpC,sCAAsC;AACtC,MAAM;AACN,EAAE;AACF,8DAA8D;AAC9D,0DAA0D;AAC1D,2BAA2B;AAC3B,+CAA+C;AAC/C,EAAE;AACF,gDAAgD;AAChD,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,uCAAuC;AACvC,6CAA6C;AAC7C,eAAe;AACf,2BAA2B;AAC3B,8BAA8B;AAC9B,6BAA6B;AAC7B,0CAA0C;AAC1C,QAAQ;AACR,MAAM;AACN,EAAE;AACF,yCAAyC;AACzC,oBAAoB;AACpB,qBAAqB;AACrB,iCAAiC;AACjC,MAAM;AACN,EAAE;AACF,2DAA2D;AAC3D,oEAAoE;AACpE,0BAA0B;AAC1B,eAAe;AACf,mCAAmC;AACnC,2BAA2B;AAC3B,mBAAmB;AACnB,OAAO;AACP,+BAA+B;AAC/B,eAAe;AACf,mCAAmC;AACnC,2CAA2C;AAC3C,8CAA8C;AAC9C,0CAA0C;AAC1C,OAAO;AACP,yCAAyC;AACzC,2BAA2B;AAC3B,6FAA6F;AAC7F,SAAS;AACT,4CAA4C;AAC5C,eAAe;AACf,MAAM;AACN,6DAA6D;AAC7D,oBAAoB;AACpB,2BAA2B;AAC3B,4BAA4B;AAC5B,wEAAwE;AACxE,SAAS;AACT,4CAA4C;AAC5C,eAAe;AACf,MAAM;AACN,EAAE;AACF,UAAU;AACV,wBAAwB;AACxB,WAAW;AACX,iBAAiB;AACjB,qCAAqC;AACrC,6BAA6B;AAC7B,qBAAqB;AACrB,UAAU;AACV,yBAAyB;AACzB,kBAAkB;AAClB,iBAAiB;AACjB,qCAAqC;AACrC,+DAA+D;AAC/D,UAAU;AACV,oBAAoB;AACpB,oBAAoB;AACpB,oCAAoC;AACpC,gDAAgD;AAChD,kDAAkD;AAClD,8EAA8E;AAC9E,aAAa;AACb,WAAW;AACX,eAAe;AACf,yBAAyB;AACzB,QAAQ;AACR,EAAE;AACF,yCAAyC;AACzC,kEAAkE;AAClE,8CAA8C;AAC9C,iBAAiB;AACjB,QAAQ;AACR,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAC9E,4CAA4C;AAC5C,6BAA6B;AAC7B,2EAA2E;AAC3E,WAAW;AACX,0CAA0C;AAC1C,iBAAiB;AACjB,QAAQ;AACR,kFAAkF;AAClF,EAAE;AACF,YAAY;AACZ,mBAAmB;AACnB,2EAA2E;AAC3E,WAAW;AACX,oBAAoB;AACpB,gFAAgF;AAChF,QAAQ;AACR,EAAE;AACF,wDAAwD;AACxD,4EAA4E;AAC5E,+DAA+D;AAC/D,uBAAuB;AACvB,sCAAsC;AACtC,QAAQ;AACR,kBAAkB;AAClB,yBAAyB;AACzB,qCAAqC;AACrC,MAAM;AACN,IAAI;AACJ,EAAE;AACF,iDAAiD"}