matimo 0.1.0-alpha.9 → 0.1.1

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "matimo",
-  "version": "0.1.0-alpha.9",
-  "description": "Universal tool provider SDK: Framework-agnostic YAML-driven tool ecosystem for AI agents. Execute a library of pre-built tools (Slack, Gmail, GitHub, AWS, etc.) or define your own in YAML.",
+  "version": "0.1.1",
+  "description": "A framework-agnostic SDK with pre-built providers, a skills knowledge layer, MCP out of the box, and agents that autonomously build new capabilities — governed by a policy engine you control.",
   "main": "packages/core/dist/index.js",
   "types": "packages/core/dist/index.d.ts",
+  "bin": {
+    "matimo": "packages/cli/dist/bin.js"
+  },
   "type": "module",
   "packageManager": "pnpm@8.15.0",
   "private": false,
@@ -47,7 +50,6 @@
   "files": [
     "packages/core/dist",
     "packages/cli/dist",
-    "packages/cli/bin",
     "README.md",
     "LICENSE"
   ],
@@ -55,8 +57,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@matimo/cli": "0.1.0-alpha.9",
-    "@matimo/core": "0.1.0-alpha.9"
+    "@matimo/cli": "0.1.0",
+    "@matimo/core": "0.1.0"
   },
   "devDependencies": {
     "@commitlint/cli": "^20.3.1",
@@ -65,14 +67,14 @@
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.1.0",
-    "@typescript-eslint/eslint-plugin": "^8.54.0",
-    "@typescript-eslint/parser": "^8.54.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
     "eslint": "^9.39.2",
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "langchain": "^1.2.18",
     "prettier": "^3.8.1",
-    "ts-jest": "^29.4.6",
+    "ts-jest": "^29.4.9",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"

package/packages/cli/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/packages/cli/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/packages/cli/dist/bin.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * Matimo CLI entry point
+ *
+ * This is the npm bin target — compiled to dist/bin.js.
+ * All command routing (install, list, search, mcp, etc.) is handled by cli.ts.
+ *
+ * Uses tsx to register ESM hooks so extensionless imports in @matimo/core work
+ * correctly. This is required because @matimo/core compiles TypeScript with
+ * "moduleResolution": "bundler" which omits .js extensions in the output.
+ *
+ * Tool discovery works automatically via ToolLoader.getNodeModulesPath():
+ *   1. Walks up from process.cwd() to find node_modules/@matimo/*
+ *   2. Falls back to __dirname-based discovery (for Claude Desktop where cwd='/')
+ *
+ * Users run:
+ *   npx matimo mcp                         # stdio mode
+ *   npx matimo mcp --transport http        # http mode
+ *   npx matimo install slack gmail         # install providers
+ *   npx matimo list                        # list installed tools
+ */
+import { spawn } from 'child_process';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Resolve tsx from this package's dependencies
+const require = createRequire(import.meta.url);
+let tsxBin;
+try {
+    const tsxPkgPath = require.resolve('tsx/package.json');
+    tsxBin = join(dirname(tsxPkgPath), 'dist', 'cli.mjs');
+}
+catch {
+    tsxBin = 'tsx';
+}
+const cliScript = join(__dirname, 'cli.js');
+const child = spawn(process.execPath, [tsxBin, cliScript, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: process.env,
+});
+child.on('error', (error) => {
+    console.error('❌ Failed to start Matimo CLI. Make sure tsx is installed.');
+    console.error('   Run: npm install tsx');
+    console.error('   Error:', error.message);
+    process.exit(1);
+});
+child.on('exit', (code) => process.exit(code || 0));
+//# sourceMappingURL=bin.js.map

package/packages/cli/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+CAA+C;AAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,IAAI,MAAc,CAAC;AACnB,IAAI,CAAC;IACH,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;IACnF,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;IACjC,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/packages/cli/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAgBA,wBAAgB,QAAQ,IAAI,IAAI,CAmC/B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC5D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAmBA,wBAAgB,QAAQ,IAAI,IAAI,CAmE/B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD5D"}

package/packages/cli/dist/cli.js

@@ -1,8 +1,11 @@
 import { readFileSync } from 'fs';
-import { join } from 'path';
+import { join, basename } from 'path';
 import { installCommand } from './commands/install.js';
 import { listCommand } from './commands/list.js';
 import { searchCommand } from './commands/search.js';
+import { mcpCommand } from './commands/mcp.js';
+import { doctorCommand } from './commands/doctor.js';
+import { reviewCommand } from './commands/review.js';
 function getPackageVersion() {
     try {
         const pkgPath = join(process.cwd(), 'package.json');
@@ -29,10 +32,34 @@ Commands:
   search <query>        Search for available tools
                        Example: matimo search slack
   
+  mcp                   Start MCP server (Model Context Protocol)
+                       Example: matimo mcp
+                       Example: matimo mcp --transport http --port 3000
+  
+  mcp setup             Generate config for Claude Desktop / Cursor
+                       Example: matimo mcp setup
+  
+  doctor               Diagnose your Matimo setup (env vars, YAML validity, Node version)
+                       Example: matimo doctor
+  
+  review               Review agent-created tools awaiting human approval
+                       Example: matimo review list
+                       Example: matimo review approve my_tool
+                       Example: matimo review reject my_tool
+  
   help                  Show this help message
   
   version               Show version information
 
+MCP Options:
+  --transport <type>    Transport mode: stdio (default) or http
+  --port <number>       HTTP port (default: 3000)
+  --tools <list>        Comma-separated tool allowlist
+  --exclude <list>      Comma-separated tool denylist
+  --secrets <list>      Secret resolvers: env,dotenv,vault,aws
+  --token <string>      Bearer token for HTTP mode
+  --env-file <path>     Path to .env file
+
 Examples:
   # Install new tools
   $ matimo install slack
@@ -43,7 +70,15 @@ Examples:
   
   # Search for tools
   $ matimo search email
-  $ matimo search database
+  
+  # Start MCP server for Claude Desktop
+  $ matimo mcp
+  
+  # Start MCP HTTP server with auth
+  $ MATIMO_MCP_TOKEN=secret matimo mcp --transport http
+  
+  # Generate Claude Desktop config
+  $ matimo mcp setup
 
 Documentation: https://github.com/tallclub/matimo#readme
 Issues: https://github.com/tallclub/matimo/issues
@@ -71,6 +106,15 @@ export async function main(cliArgs) {
             case 'search':
                 await searchCommand(params[0] || '');
                 break;
+            case 'mcp':
+                await mcpCommand(params);
+                break;
+            case 'doctor':
+                await doctorCommand();
+                break;
+            case 'review':
+                await reviewCommand(params);
+                break;
             case 'help':
             case '-h':
             case '--help':
@@ -92,4 +136,22 @@ export async function main(cliArgs) {
         process.exit(1);
     }
 }
+// Auto-execute when run directly (e.g., via tsx src/cli.ts or through bin.ts).
+// bin.ts spawns: node <tsx-cli.mjs> <cli.js> ...args
+// - When tsx shifts its own entry out of argv: process.argv[1] == cli.js
+// - When tsx does NOT shift argv:              process.argv[2] == cli.js
+// Checking both slots handles either tsx version. When imported as a module
+// (tests, bin.ts import) neither slot contains 'cli.js'.
+// Use basename() to normalise path separators (POSIX / and Windows \).
+/* istanbul ignore next */
+const toCliJs = (s) => basename(s).replace(/\.ts$/, '.js');
+/* istanbul ignore next */
+const isRunDirectly = toCliJs(process.argv[1] ?? '') === 'cli.js' || toCliJs(process.argv[2] ?? '') === 'cli.js';
+/* istanbul ignore next */
+if (isRunDirectly) {
+    main().catch((error) => {
+        console.error('❌ Fatal error:', error);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=cli.js.map

package/packages/cli/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCd,CAAC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAkB;IAC3C,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9B,KAAK,SAAS;gBACZ,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,WAAW,EAAE,CAAC;gBACpB,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,MAAM,CAAC;YACZ,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,QAAQ,EAAE,CAAC;gBACX,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,OAAO,CAAC,IAAI,CAAC,eAAe,iBAAiB,EAAE,EAAE,CAAC,CAAC;gBACnD,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/packages/cli/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctorCommand(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/packages/cli/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAmDA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA8JnD"}

package/packages/cli/dist/commands/doctor.js

@@ -0,0 +1,174 @@
+import * as fs from 'fs';
+import * as path from 'path';
+const issues = [];
+function check(label, pass, message, severity = 'error') {
+    const icon = pass ? '✅' : severity === 'error' ? '❌' : '⚠️ ';
+    console.info(`  ${icon} ${label}`);
+    if (!pass) {
+        issues.push({ severity, message });
+        console.info(`     ${message}`);
+    }
+}
+function findNodeModules() {
+    let dir = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.join(dir, 'node_modules');
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+async function loadMatimoCoreExport(exportName) {
+    try {
+        // Dynamic import works in both ESM (built CLI) and CJS (ts-jest test transform)
+        const core = (await import('@matimo/core'));
+        return core[exportName] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function doctorCommand() {
+    // Ensure issues do not accumulate across multiple invocations
+    issues.length = 0;
+    console.info('\n🩺 Matimo Doctor — Checking your setup...\n');
+    // ─── 1. Node.js version ────────────────────────────────────────────────
+    console.info('Node.js:');
+    const nodeVersion = process.versions.node;
+    const [major] = nodeVersion.split('.').map(Number);
+    check(`Node.js v${nodeVersion}`, major >= 18, `Node.js 18+ required. You are running ${nodeVersion}. Upgrade: https://nodejs.org`);
+    console.info('');
+    // ─── 2. @matimo/* packages ─────────────────────────────────────────────
+    const nodeModulesPath = findNodeModules();
+    console.info('@matimo/* packages:');
+    if (!nodeModulesPath) {
+        check('node_modules', false, 'node_modules not found. Run "pnpm install" or "npm install".');
+        console.info('');
+    }
+    else {
+        const matimoScope = path.join(nodeModulesPath, '@matimo');
+        const hasScope = fs.existsSync(matimoScope);
+        if (!hasScope) {
+            check('@matimo scope', false, 'No @matimo/* packages installed. Run "matimo install slack" to get started.', 'warn');
+        }
+        else {
+            const packages = fs.readdirSync(matimoScope).filter((d) => !d.startsWith('.'));
+            if (packages.length === 0) {
+                check('@matimo scope', false, 'No @matimo/* packages installed. Run "matimo install slack" to get started.', 'warn');
+            }
+            else {
+                for (const pkg of packages) {
+                    const pkgDir = path.join(matimoScope, pkg);
+                    const pkgJsonPath = path.join(pkgDir, 'package.json');
+                    if (!fs.existsSync(pkgJsonPath))
+                        continue;
+                    console.info(`  📦 @matimo/${pkg}`);
+                    // Check env vars for auth placeholders
+                    const toolsDir = path.join(pkgDir, 'tools');
+                    if (fs.existsSync(toolsDir)) {
+                        const toolDirs = fs.readdirSync(toolsDir).filter((d) => {
+                            return fs.existsSync(path.join(toolsDir, d, 'definition.yaml'));
+                        });
+                        const missingEnv = [];
+                        const seenVars = new Set();
+                        for (const toolName of toolDirs) {
+                            const yamlPath = path.join(toolsDir, toolName, 'definition.yaml');
+                            const content = fs.readFileSync(yamlPath, 'utf-8');
+                            // Scan for {ENV_VAR_NAME} placeholders in headers/URLs
+                            const placeholderRegex = /\{(\w+)\}/g;
+                            let match;
+                            while ((match = placeholderRegex.exec(content)) !== null) {
+                                const name = match[1];
+                                if (isAuthVar(name) && !seenVars.has(name)) {
+                                    seenVars.add(name);
+                                    if (!process.env[name]) {
+                                        missingEnv.push(name);
+                                    }
+                                }
+                            }
+                        }
+                        if (missingEnv.length > 0) {
+                            issues.push({
+                                severity: 'error',
+                                message: `@matimo/${pkg}: missing env vars: ${missingEnv.join(', ')}`,
+                            });
+                            for (const v of missingEnv) {
+                                console.info(`     ❌ Missing env var: ${v}`);
+                            }
+                        }
+                        else {
+                            console.info(`     ✅ All required env vars are set`);
+                        }
+                        // Validate YAML schemas
+                        let yamlErrors = 0;
+                        const validateToolDefinition = await loadMatimoCoreExport('validateToolDefinition');
+                        if (validateToolDefinition) {
+                            const yaml = await import('js-yaml');
+                            for (const toolName of toolDirs) {
+                                const yamlPath = path.join(toolsDir, toolName, 'definition.yaml');
+                                try {
+                                    const parsed = yaml.load(fs.readFileSync(yamlPath, 'utf-8'));
+                                    validateToolDefinition(parsed);
+                                }
+                                catch (err) {
+                                    yamlErrors++;
+                                    issues.push({
+                                        severity: 'error',
+                                        message: `@matimo/${pkg}/${toolName}: YAML invalid — ${err.message}`,
+                                    });
+                                    console.info(`     ❌ ${toolName}: invalid YAML`);
+                                    console.info(`        ${err.message.split('\n')[0]}`);
+                                }
+                            }
+                            if (yamlErrors === 0 && toolDirs.length > 0) {
+                                console.info(`     ✅ ${toolDirs.length} tool YAML(s) valid`);
+                            }
+                        }
+                    }
+                    console.info('');
+                }
+            }
+        }
+    }
+    // ─── 3. MATIMO_APPROVAL_SECRET ─────────────────────────────────────────
+    console.info('Policy / Approval:');
+    const hasApprovalSecret = !!process.env.MATIMO_APPROVAL_SECRET;
+    check('MATIMO_APPROVAL_SECRET', hasApprovalSecret, 'MATIMO_APPROVAL_SECRET is not set. Agent-created tool approvals will use a random secret (not persistent across restarts). Set it in your .env file.', 'warn');
+    console.info('');
+    // ─── 4. Summary ────────────────────────────────────────────────────────
+    const errors = issues.filter((i) => i.severity === 'error');
+    const warnings = issues.filter((i) => i.severity === 'warn');
+    console.info('─'.repeat(60));
+    if (errors.length === 0 && warnings.length === 0) {
+        console.info('\n✅ Matimo is ready! No issues found.\n');
+    }
+    else {
+        if (errors.length > 0) {
+            console.info(`\n❌ ${errors.length} error(s) found — fix before using Matimo:\n`);
+            errors.forEach((e, i) => console.info(`  ${i + 1}. ${e.message}`));
+            console.info('');
+        }
+        if (warnings.length > 0) {
+            console.info(`⚠️  ${warnings.length} warning(s):\n`);
+            warnings.forEach((w, i) => console.info(`  ${i + 1}. ${w.message}`));
+            console.info('');
+        }
+    }
+    if (errors.length > 0)
+        process.exit(1);
+}
+/** Heuristic: is this placeholder likely an auth/secret env var? */
+function isAuthVar(name) {
+    const upper = name.toUpperCase();
+    return (upper.includes('TOKEN') ||
+        upper.includes('SECRET') ||
+        upper.includes('KEY') ||
+        upper.includes('PASSWORD') ||
+        upper.includes('CREDENTIAL') ||
+        upper.includes('AUTH'));
+}
+//# sourceMappingURL=doctor.js.map

package/packages/cli/dist/commands/doctor.js.map

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

package/packages/cli/dist/commands/mcp-setup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI command: matimo mcp setup
+ *
+ * Interactive config generator for MCP server.
+ * Detects installed tools, scans for required auth env vars,
+ * and outputs a ready-to-paste Claude Desktop / Cursor config.
+ */
+export declare function mcpSetupCommand(): Promise<void>;
+//# sourceMappingURL=mcp-setup.d.ts.map

package/packages/cli/dist/commands/mcp-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-setup.d.ts","sourceRoot":"","sources":["../../src/commands/mcp-setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiHrD"}

package/packages/cli/dist/commands/mcp-setup.js

@@ -0,0 +1,106 @@
+/**
+ * CLI command: matimo mcp setup
+ *
+ * Interactive config generator for MCP server.
+ * Detects installed tools, scans for required auth env vars,
+ * and outputs a ready-to-paste Claude Desktop / Cursor config.
+ */
+export async function mcpSetupCommand() {
+    console.info('\n🔨 Matimo MCP Setup\n');
+    console.info('Scanning for installed tool packages...\n');
+    try {
+        // @ts-ignore - dynamic import of package resolved at runtime
+        const { ToolLoader, extractAuthPlaceholders } = await import('@matimo/core');
+        const loader = new ToolLoader();
+        // Auto-discover installed packages
+        const toolPaths = loader.autoDiscoverPackages();
+        if (toolPaths.length === 0) {
+            console.info('No @matimo/* tool packages found.');
+            console.info('Install tools first: matimo install slack github\n');
+            return;
+        }
+        // Load all tools
+        const tools = loader.loadToolsFromMultiplePaths(toolPaths);
+        console.info(`Found ${tools.size} tools across ${toolPaths.length} package(s):\n`);
+        // Group tools by provider (extract from tool name prefix)
+        const providers = new Map();
+        const authVars = new Set();
+        for (const [name, tool] of tools) {
+            // Extract provider from tool name (e.g., "slack_send" → "slack")
+            const provider = name.includes('_')
+                ? name.split('_')[0]
+                : name.includes('-')
+                    ? name.split('-')[0]
+                    : 'core';
+            if (!providers.has(provider)) {
+                providers.set(provider, []);
+            }
+            providers.get(provider).push(name);
+            // Extract auth placeholders
+            const placeholders = extractAuthPlaceholders(tool);
+            for (const p of placeholders) {
+                authVars.add(p);
+            }
+        }
+        // Display providers and tools
+        for (const [provider, toolNames] of providers) {
+            console.info(`  📦 ${provider} (${toolNames.length} tools)`);
+            for (const name of toolNames.slice(0, 5)) {
+                console.info(`     • ${name}`);
+            }
+            if (toolNames.length > 5) {
+                console.info(`     ... and ${toolNames.length - 5} more`);
+            }
+        }
+        console.info('');
+        // Display required env vars
+        if (authVars.size > 0) {
+            console.info('🔐 Required environment variables:\n');
+            for (const v of authVars) {
+                const value = process.env[v] || process.env[`MATIMO_${v}`];
+                const status = value ? '✅' : '❌';
+                console.info(`  ${status} ${v}`);
+            }
+            console.info('');
+        }
+        // Generate Claude Desktop config
+        const envBlock = {};
+        for (const v of authVars) {
+            envBlock[v] = process.env[v] || process.env[`MATIMO_${v}`] || '<your-token>';
+        }
+        const claudeConfig = {
+            mcpServers: {
+                matimo: {
+                    command: 'npx',
+                    args: ['matimo', 'mcp'],
+                    env: envBlock,
+                },
+            },
+        };
+        console.info('📋 Claude Desktop config (paste into Settings → Developer → MCP Servers):\n');
+        console.info(JSON.stringify(claudeConfig, null, 2));
+        // Generate Cursor config
+        console.info('\n📋 Cursor config (paste into .cursor/mcp.json):\n');
+        const cursorConfig = {
+            mcpServers: {
+                matimo: {
+                    command: 'npx',
+                    args: ['matimo', 'mcp'],
+                    env: envBlock,
+                },
+            },
+        };
+        console.info(JSON.stringify(cursorConfig, null, 2));
+        // HTTP mode example
+        console.info('\n📋 HTTP mode (for remote hosting / Docker):\n');
+        const envExport = [...authVars].map((v) => `  ${v}=<your-token>`).join(' \\\n');
+        console.info(`  ${envExport} \\`);
+        console.info(`  MATIMO_MCP_TOKEN=<your-server-secret> \\`);
+        console.info(`  npx matimo mcp --transport http --port 3000\n`);
+    }
+    catch (error) {
+        console.error('❌ Setup failed:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mcp-setup.js.map

package/packages/cli/dist/commands/mcp-setup.js.map

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

package/packages/cli/dist/commands/mcp.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI command: matimo mcp
+ *
+ * Starts the Matimo MCP server with configurable transport and options.
+ *
+ * Usage:
+ *   matimo mcp                                    # stdio mode (default)
+ *   matimo mcp --transport http --port 3000       # HTTP mode
+ *   matimo mcp --tools slack,github               # only these tools
+ *   matimo mcp --exclude postgres                 # exclude these tools
+ *   matimo mcp --secrets env,vault                # secret resolver chain
+ *   matimo mcp --token my-secret                  # HTTP bearer token
+ *   matimo mcp --tool-paths /path/to/tools         # custom tool paths
+ *   matimo mcp --skill-paths /path/to/skills       # custom skill paths
+ */
+export declare function mcpCommand(params: string[]): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/packages/cli/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA8KH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8FhE"}