@ffschrattenecker/tm1-mcp-server 6.0.0 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ffschrattenecker/tm1-mcp-server",
-  "version": "6.0.0",
+  "version": "7.0.0",
   "description": "MCP server for IBM Planning Analytics / TM1 — full model lifecycle via REST API",
   "repository": {
     "type": "git",
@@ -19,7 +19,8 @@
     "dist",
     "!dist/**/*.map",
     "NOTICE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "npm-shrinkwrap.json"
   ],
   "prettier": {
     "semi": true,
@@ -59,10 +60,12 @@
     "lint:mutation-envelope": "node scripts/check-mutation-envelope.mjs",
     "lint:format": "prettier --check .",
     "format": "prettier --write .",
-    "verify": "npm run typecheck && npm run typecheck:tests && npm run lint:no-flat-api && npm run lint:output-schema-budget && npm run lint:tool-registration && npm run lint:input-naming && npm run lint:mutation-envelope && npm run lint:format && npm run lint:eslint && npm run coverage:check",
+    "verify": "npm run typecheck && npm run typecheck:tests && npm run lint:no-flat-api && npm run lint:output-schema-budget && npm run lint:tool-surface-budget && npm run lint:tool-registration && npm run lint:input-naming && npm run lint:mutation-envelope && npm run lint:format && npm run lint:eslint && npm run coverage:check",
     "tools:list": "node scripts/gen-tool-list.mjs",
     "tools:update-readme": "node scripts/gen-tool-list.mjs --write-readme",
-    "lint:eslint": "eslint ."
+    "lint:eslint": "eslint .",
+    "measure:tools": "node scripts/measure-tool-surface.mjs",
+    "lint:tool-surface-budget": "node scripts/measure-tool-surface.mjs --top 0 --budget 133000"
   },
   "keywords": [
     "mcp",
@@ -72,7 +75,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.19.0"
   },
   "overrides": {
     "fast-uri": "^3.1.5",
@@ -101,7 +104,6 @@
     "vitest": "^4.1.10"
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   }
 }

package/dist/tools/ti-development/get-process-code.d.ts

@@ -1,2 +0,0 @@
-export declare const registerGetProcessCode: import("../define-tool.js").ToolRegistrar;
-//# sourceMappingURL=get-process-code.d.ts.map

package/dist/tools/ti-development/get-process-code.js

@@ -1,100 +0,0 @@
-import { z } from "zod";
-import { commentStats, stripCommentBlocks } from "../../lib/strip-comments.js";
-import { maskCode, resolveMaskSecrets } from "../../lib/mask-secrets.js";
-import { ProcessCodeSchema } from "../schemas/items.js";
-import { READ_ONLY } from "../annotations.js";
-import { defineTool } from "../define-tool.js";
-// A tab counts as comment-heavy (worth flagging for stripComments) only when it
-// is both long enough to matter and mostly comments.
-const HEAVY_MIN_LINES = 20;
-const HEAVY_RATIO = 0.4;
-const TABS = ["prolog", "metadata", "data", "epilog"];
-export const registerGetProcessCode = defineTool({
-    name: "tm1_get_process_code",
-    description: "Get the source code of all four tabs (Prolog, Metadata, Data, Epilog) of a TI process. " +
-        "Grown TM1 models often carry large blocks of commented-out dead code; set stripComments=true " +
-        "to collapse runs of 4+ comment lines into a `# [... N lines ...]` marker and save context.",
-    annotations: READ_ONLY,
-    output: ProcessCodeSchema,
-    input: {
-        processName: z.string().describe("Name of the TI process"),
-        stripComments: z
-            .boolean()
-            .optional()
-            .default(false)
-            .describe("If true, collapse blocks of 4+ consecutive comment lines into a single marker (dead-code reduction). " +
-            "Inline and short comments are kept. Default false (full verbatim source)."),
-        maskSecrets: z
-            .boolean()
-            .optional()
-            .default(true)
-            .describe("Redact credential literals in the returned code. Masks the password arg of ODBCOpen() and quoted values " +
-            "assigned to credential-named identifiers (pPwd, sToken, …). Default: true. Set false only when explicitly auditing credentials."),
-        includeSecurityAccess: z
-            .boolean()
-            .optional()
-            .default(false)
-            .describe("Also fetch process's HasSecurityAccess elevation flag (one extra GET). " +
-            "Default false — pure code reads stay single request."),
-    },
-    handler: async ({ processName, stripComments, maskSecrets, includeSecurityAccess }, tm1Client) => {
-        const code = await tm1Client.processes.getCode(processName);
-        let hint;
-        if (stripComments) {
-            let removedLines = 0;
-            let collapsedBlocks = 0;
-            for (const tab of TABS) {
-                const r = stripCommentBlocks(code[tab]);
-                code[tab] = r.code;
-                removedLines += r.removedLines;
-                collapsedBlocks += r.collapsedBlocks;
-            }
-            if (collapsedBlocks > 0) {
-                hint =
-                    `stripComments collapsed ${collapsedBlocks} comment block(s) (${removedLines} lines) into markers. ` +
-                        `Re-run without stripComments for the full source.`;
-            }
-        }
-        else {
-            let worst;
-            for (const tab of TABS) {
-                const s = commentStats(code[tab]);
-                if (s.totalLines < HEAVY_MIN_LINES)
-                    continue;
-                const ratio = s.commentLines / s.totalLines;
-                if (ratio >= HEAVY_RATIO && (!worst || ratio > worst.ratio)) {
-                    worst = {
-                        tab,
-                        total: s.totalLines,
-                        comment: s.commentLines,
-                        ratio,
-                    };
-                }
-            }
-            if (worst) {
-                const pct = Math.round(worst.ratio * 100);
-                hint =
-                    `${worst.tab} tab is ${pct}% comments (${worst.comment}/${worst.total} lines). ` +
-                        `Set stripComments=true to collapse dead-code blocks and save context.`;
-            }
-        }
-        if (resolveMaskSecrets(maskSecrets)) {
-            for (const tab of TABS)
-                code[tab] = maskCode(code[tab]);
-        }
-        let hasSecurityAccess;
-        if (includeSecurityAccess) {
-            hasSecurityAccess = (await tm1Client.processes.getDeployMeta(processName))
-                .hasSecurityAccess;
-        }
-        const payload = {
-            ...code,
-            ...(hasSecurityAccess !== undefined ? { hasSecurityAccess } : {}),
-            ...(hint ? { hint } : {}),
-        };
-        return {
-            content: [{ type: "text", text: JSON.stringify(payload) }],
-        };
-    },
-});
-//# sourceMappingURL=get-process-code.js.map

package/dist/tools/ti-development/get-process-datasource.d.ts

@@ -1,2 +0,0 @@
-export declare const registerGetProcessDatasource: import("../define-tool.js").ToolRegistrar;
-//# sourceMappingURL=get-process-datasource.d.ts.map

package/dist/tools/ti-development/get-process-datasource.js

@@ -1,20 +0,0 @@
-import { z } from "zod";
-import { FORMAT_SCHEMA, payloadResponse, renderKV } from "../format.js";
-import { DataSourceSchema } from "../schemas/items.js";
-import { READ_ONLY } from "../annotations.js";
-import { defineTool } from "../define-tool.js";
-export const registerGetProcessDatasource = defineTool({
-    name: "tm1_get_process_datasource",
-    description: "Get the data source configuration of a TurboIntegrator process. The password field is always redacted.",
-    annotations: READ_ONLY,
-    output: DataSourceSchema,
-    input: {
-        processName: z.string().describe("Name of the TI process"),
-        ...FORMAT_SCHEMA,
-    },
-    handler: async ({ processName, format }, tm1Client) => {
-        const ds = await tm1Client.processes.getDataSource(processName);
-        return payloadResponse(ds, format, (d) => renderKV(d, `Datasource of ${processName}`));
-    },
-});
-//# sourceMappingURL=get-process-datasource.js.map

package/dist/tools/ti-development/get-process-parameters.d.ts

@@ -1,2 +0,0 @@
-export declare const registerGetProcessParameters: import("../define-tool.js").ToolRegistrar;
-//# sourceMappingURL=get-process-parameters.d.ts.map

package/dist/tools/ti-development/get-process-parameters.js

@@ -1,25 +0,0 @@
-import { z } from "zod";
-import { FORMAT_SCHEMA, payloadResponse, renderTable, columnsOf, } from "../format.js";
-import { ProcessParameterSchema } from "../schemas/items.js";
-import { READ_ONLY } from "../annotations.js";
-import { defineTool } from "../define-tool.js";
-export const registerGetProcessParameters = defineTool({
-    name: "tm1_get_process_parameters",
-    description: "Get the parameters of a TurboIntegrator process including names, types and defaults",
-    annotations: READ_ONLY,
-    output: {
-        processName: z.string(),
-        parameters: z.array(ProcessParameterSchema),
-    },
-    input: {
-        processName: z.string().describe("Name of the TI process"),
-        ...FORMAT_SCHEMA,
-    },
-    handler: async ({ processName, format }, tm1Client) => {
-        const params = await tm1Client.processes.getParameters(processName);
-        const payload = { processName, parameters: params };
-        const columns = columnsOf(["name", "type", "defaultValue", "prompt"]);
-        return payloadResponse(payload, format, (p) => `## Parameters of ${p.processName}\n\n${renderTable(p.parameters, columns)}`);
-    },
-});
-//# sourceMappingURL=get-process-parameters.js.map

package/dist/tools/ti-development/get-process-variables.d.ts

@@ -1,2 +0,0 @@
-export declare const registerGetProcessVariables: import("../define-tool.js").ToolRegistrar;
-//# sourceMappingURL=get-process-variables.d.ts.map

package/dist/tools/ti-development/get-process-variables.js

@@ -1,38 +0,0 @@
-import { z } from "zod";
-import { FORMAT_SCHEMA, payloadResponse, renderTable, columnsOf, } from "../format.js";
-import { IgnoredColumnSchema, ProcessVariableSchema, } from "../schemas/items.js";
-import { READ_ONLY } from "../annotations.js";
-import { defineTool } from "../define-tool.js";
-export const registerGetProcessVariables = defineTool({
-    name: "tm1_get_process_variables",
-    description: "Get the variables (column-name mapping for ASCII/ODBC sources) of a TurboIntegrator process. " +
-        "Columns set to 'Ignore' carry no variable and are reported separately in ignoredColumns — " +
-        "they are the reason variable positions can have gaps.",
-    annotations: READ_ONLY,
-    output: {
-        processName: z.string(),
-        variables: z.array(ProcessVariableSchema),
-        ignoredColumns: z.array(IgnoredColumnSchema),
-    },
-    input: {
-        processName: z.string().describe("Name of the TI process"),
-        ...FORMAT_SCHEMA,
-    },
-    handler: async ({ processName, format }, tm1Client) => {
-        const { variables, ignoredColumns } = await tm1Client.processes.getVariableLayout(processName);
-        const payload = { processName, variables, ignoredColumns };
-        const columns = columnsOf([
-            "name",
-            "type",
-            "position",
-            "startByte",
-            "endByte",
-        ]);
-        const ignoredCols = columnsOf(["position", "name"]);
-        return payloadResponse(payload, format, (p) => `## Variables of ${p.processName}\n\n${renderTable(p.variables, columns)}` +
-            (p.ignoredColumns.length > 0
-                ? `\n\n### Ignored columns\n\n${renderTable(p.ignoredColumns, ignoredCols)}`
-                : ""));
-    },
-});
-//# sourceMappingURL=get-process-variables.js.map