@memnexus-ai/cli 1.7.42 → 1.7.44

package/dist/lib/setup/rules-writer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Steering file writer — reads, merges, and writes agent instruction files
+ * using section markers for non-destructive updates.
+ */
+import type { AgentDefinition, Scope, SteeringWriteResult } from './types.js';
+/**
+ * Resolve the steering file path for a given agent, scope, and platform.
+ * Returns null if the agent has no steering config or the scope is unsupported.
+ */
+export declare function resolveSteeringPath(agent: AgentDefinition, scope: Scope, projectDir?: string): string | null;
+/**
+ * Write or update the steering file for an agent.
+ * Uses section markers for non-destructive merging with existing content.
+ */
+export declare function writeSteeringFile(options: {
+    agent: AgentDefinition;
+    scope: Scope;
+    projectDir?: string;
+    dryRun?: boolean;
+}): Promise<SteeringWriteResult | null>;
+/**
+ * Remove the MemNexus steering section from an agent's instruction file.
+ * Preserves all content outside the section markers.
+ * Returns true if the section was found and removed.
+ */
+export declare function removeSteeringSection(options: {
+    agent: AgentDefinition;
+    scope: Scope;
+    projectDir?: string;
+}): Promise<boolean>;
+/**
+ * Get the MemNexus rules version from an agent's steering file.
+ * Returns null if no steering file or no markers found.
+ */
+export declare function getSteeringVersion(options: {
+    agent: AgentDefinition;
+    scope: Scope;
+    projectDir?: string;
+}): Promise<string | null>;
+//# sourceMappingURL=rules-writer.d.ts.map

package/dist/lib/setup/rules-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-writer.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/rules-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAK9E;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,KAAK,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAgBf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAgDtC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBnB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQzB"}

package/dist/lib/setup/rules-writer.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Steering file writer — reads, merges, and writes agent instruction files
+ * using section markers for non-destructive updates.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSteeringPath = resolveSteeringPath;
+exports.writeSteeringFile = writeSteeringFile;
+exports.removeSteeringSection = removeSteeringSection;
+exports.getSteeringVersion = getSteeringVersion;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const detector_js_1 = require("./detector.js");
+const rules_templates_js_1 = require("./rules-templates.js");
+const package_json_1 = __importDefault(require("../../../package.json"));
+/**
+ * Resolve the steering file path for a given agent, scope, and platform.
+ * Returns null if the agent has no steering config or the scope is unsupported.
+ */
+function resolveSteeringPath(agent, scope, projectDir) {
+    if (!agent.steering)
+        return null;
+    const platform = process.platform;
+    if (scope === 'project') {
+        if (!projectDir)
+            return null;
+        if (!agent.steering.projectFilePath)
+            return null;
+        return node_path_1.default.join(projectDir, agent.steering.projectFilePath);
+    }
+    // Global scope
+    if (!agent.steering.globalFilePath)
+        return null;
+    const globalPath = agent.steering.globalFilePath[platform];
+    if (!globalPath)
+        return null;
+    return (0, detector_js_1.resolvePath)(globalPath);
+}
+/**
+ * Write or update the steering file for an agent.
+ * Uses section markers for non-destructive merging with existing content.
+ */
+async function writeSteeringFile(options) {
+    const { agent, scope, projectDir, dryRun } = options;
+    const filePath = resolveSteeringPath(agent, scope, projectDir);
+    if (!filePath)
+        return null;
+    const contentFocus = agent.steering?.contentFocus ?? 'full';
+    const rulesContent = (0, rules_templates_js_1.composeRules)(agent.id, package_json_1.default.version, contentFocus);
+    let backupPath;
+    let action = 'created';
+    let finalContent;
+    if ((0, node_fs_1.existsSync)(filePath)) {
+        action = 'updated';
+        const existing = await (0, promises_1.readFile)(filePath, 'utf-8');
+        // Check if markers already exist — replace section in-place
+        const beginIdx = existing.indexOf(rules_templates_js_1.BEGIN_MARKER);
+        const endIdx = existing.indexOf(rules_templates_js_1.END_MARKER);
+        if (beginIdx !== -1 && endIdx !== -1 && endIdx > beginIdx) {
+            // Replace existing section
+            const before = existing.slice(0, beginIdx);
+            const after = existing.slice(endIdx + rules_templates_js_1.END_MARKER.length);
+            finalContent = before + rulesContent + after;
+        }
+        else {
+            // Append section at end
+            const separator = existing.endsWith('\n') ? '\n' : '\n\n';
+            finalContent = existing + separator + rulesContent;
+        }
+        // Backup before modifying
+        if (!dryRun) {
+            backupPath = filePath + '.bak';
+            await (0, promises_1.copyFile)(filePath, backupPath);
+        }
+    }
+    else {
+        // New file — just the rules content
+        finalContent = rulesContent;
+    }
+    if (!dryRun) {
+        await (0, promises_1.mkdir)(node_path_1.default.dirname(filePath), { recursive: true });
+        await (0, promises_1.writeFile)(filePath, finalContent, 'utf-8');
+    }
+    return { filePath, backupPath, content: finalContent, action };
+}
+/**
+ * Remove the MemNexus steering section from an agent's instruction file.
+ * Preserves all content outside the section markers.
+ * Returns true if the section was found and removed.
+ */
+async function removeSteeringSection(options) {
+    const { agent, scope, projectDir } = options;
+    const filePath = resolveSteeringPath(agent, scope, projectDir);
+    if (!filePath || !(0, node_fs_1.existsSync)(filePath))
+        return false;
+    const existing = await (0, promises_1.readFile)(filePath, 'utf-8');
+    const beginIdx = existing.indexOf(rules_templates_js_1.BEGIN_MARKER);
+    const endIdx = existing.indexOf(rules_templates_js_1.END_MARKER);
+    if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx)
+        return false;
+    const before = existing.slice(0, beginIdx);
+    const after = existing.slice(endIdx + rules_templates_js_1.END_MARKER.length);
+    // Clean up: remove trailing newlines at the splice point
+    const cleaned = (before.trimEnd() + after).trimEnd() + '\n';
+    // If only whitespace remains, delete the file content but keep the file
+    const finalContent = cleaned.trim() ? cleaned : '';
+    await (0, promises_1.writeFile)(filePath, finalContent, 'utf-8');
+    return true;
+}
+/**
+ * Get the MemNexus rules version from an agent's steering file.
+ * Returns null if no steering file or no markers found.
+ */
+async function getSteeringVersion(options) {
+    const { agent, scope, projectDir } = options;
+    const filePath = resolveSteeringPath(agent, scope, projectDir);
+    if (!filePath || !(0, node_fs_1.existsSync)(filePath))
+        return null;
+    const content = await (0, promises_1.readFile)(filePath, 'utf-8');
+    return (0, rules_templates_js_1.parseSteeringVersion)(content);
+}
+//# sourceMappingURL=rules-writer.js.map

package/dist/lib/setup/rules-writer.js.map

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

package/dist/lib/setup/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Types for the mx setup command — MCP agent configuration.
+ */
+/** Supported operating systems. */
+export type Platform = 'darwin' | 'linux' | 'win32';
+/** Supported CPU architectures. */
+export type Arch = 'x64' | 'arm64';
+/** Transport strategy for an agent's MCP config. */
+export type Transport = 'mcp-proxy-stdio' | 'toml-env-var';
+/** Scope of the configuration (global user-level or project-level). */
+export type Scope = 'global' | 'project';
+/** JSON key used for MCP servers in the agent's config file. */
+export type ServersKey = 'mcpServers' | 'servers';
+/** Config file format. */
+export type ConfigFormat = 'json' | 'toml';
+/** Per-platform paths for global config files. */
+export interface PlatformPaths {
+    darwin?: string;
+    linux?: string;
+    win32?: string;
+}
+/** Detection rules for finding an agent. */
+export interface AgentDetection {
+    /** Directories to check in project root (e.g., ".claude/", ".vscode/"). */
+    projectDirs: string[];
+    /** Binaries to check in PATH. */
+    binaries: string[];
+    /** Global config directories per platform. */
+    globalDirs: PlatformPaths;
+}
+/** What kind of steering content to generate. */
+export type SteeringContentFocus = 'full' | 'mcp-only';
+/** Steering file configuration for an agent. */
+export interface AgentSteeringConfig {
+    /** Steering file path relative to project root (for project scope). */
+    projectFilePath: string;
+    /** Global steering file path per platform (null if project-only). */
+    globalFilePath: PlatformPaths | null;
+    /** Whether to generate full CLI + MCP rules or MCP-only rules. */
+    contentFocus: SteeringContentFocus;
+}
+/** Result of writing a steering file. */
+export interface SteeringWriteResult {
+    /** Path to the steering file that was written. */
+    filePath: string;
+    /** Backup path if existing file was modified. */
+    backupPath?: string;
+    /** The content that was written (or would be written in dry-run). */
+    content: string;
+    /** Whether the file was created new or an existing file was updated. */
+    action: 'created' | 'updated' | 'skipped';
+}
+/** MCP configuration details for an agent. */
+export interface AgentMcpConfig {
+    /** Config file path relative to project root (for project scope). */
+    projectConfigPath: string;
+    /** Global config file path per platform (with ~ for home dir). */
+    globalConfigPath: PlatformPaths;
+    /** JSON key for the servers object. */
+    serversKey: ServersKey;
+    /** Config file format. */
+    configFormat: ConfigFormat;
+    /** Transport strategy. */
+    transport: Transport;
+}
+/** Complete definition of a supported agent. */
+export interface AgentDefinition {
+    /** CLI identifier (e.g., "claude-code"). */
+    id: string;
+    /** Display name (e.g., "Claude Code"). */
+    name: string;
+    /** Short description. */
+    description: string;
+    /** Detection rules. */
+    detection: AgentDetection;
+    /** MCP configuration details. */
+    mcp: AgentMcpConfig;
+    /** Steering file configuration (null if no file-based steering, e.g., Claude Desktop). */
+    steering: AgentSteeringConfig | null;
+    /** Sort order in interactive menu. */
+    sortOrder: number;
+}
+/** Result of detecting agents on the system. */
+export interface DetectedAgent {
+    agent: AgentDefinition;
+    /** Where the agent was found. */
+    detectedAt: 'project' | 'global' | 'both';
+    /** Existing MCP config file path (if config file already exists). */
+    existingConfigPath?: string;
+    /** Whether memnexus is already configured in the existing config. */
+    alreadyConfigured?: boolean;
+}
+/** Result of running setup for one agent. */
+export interface SetupResult {
+    agentId: string;
+    agentName: string;
+    success: boolean;
+    configPath: string;
+    scope: Scope;
+    /** What was done. */
+    action: 'created' | 'updated' | 'skipped' | 'failed';
+    /** Error message if failed. */
+    error?: string;
+    /** Backup path if existing config was modified. */
+    backupPath?: string;
+}
+/** Verification check result. */
+export interface VerifyCheck {
+    name: string;
+    passed: boolean;
+    message: string;
+}
+/** Full verification result for one agent. */
+export interface VerifyResult {
+    agentId: string;
+    agentName: string;
+    checks: VerifyCheck[];
+    allPassed: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/setup/types.d.ts.map

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

package/dist/lib/setup/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for the mx setup command — MCP agent configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/setup/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/setup/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/lib/setup/verifier.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Setup verification — health checks for configured agents.
+ */
+import type { AgentDefinition, VerifyResult } from './types.js';
+/**
+ * Verify a single agent's setup.
+ */
+export declare function verifyAgent(agent: AgentDefinition): Promise<VerifyResult>;
+/**
+ * Verify all configured agents.
+ */
+export declare function verifyAll(): Promise<VerifyResult[]>;
+//# sourceMappingURL=verifier.d.ts.map

package/dist/lib/setup/verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/verifier.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAyB,YAAY,EAAE,MAAM,YAAY,CAAC;AAUvF;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CA8H/E;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAczD"}

package/dist/lib/setup/verifier.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Setup verification — health checks for configured agents.
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyAgent = verifyAgent;
+exports.verifyAll = verifyAll;
+const node_fs_1 = require("node:fs");
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = __importDefault(require("node:os"));
+const registry_js_1 = require("./registry.js");
+const detector_js_1 = require("./detector.js");
+const proxy_js_1 = require("./proxy.js");
+const rules_writer_js_1 = require("./rules-writer.js");
+const rules_templates_js_1 = require("./rules-templates.js");
+const promises_1 = require("node:fs/promises");
+const config_js_1 = require("../config.js");
+const package_json_1 = __importDefault(require("../../../package.json"));
+/**
+ * Verify a single agent's setup.
+ */
+async function verifyAgent(agent) {
+    const checks = [];
+    const platform = node_os_1.default.platform();
+    // 1. Check config file exists
+    const globalPath = agent.mcp.globalConfigPath[platform];
+    const configExists = globalPath !== undefined && (0, node_fs_1.existsSync)((0, detector_js_1.resolvePath)(globalPath));
+    checks.push({
+        name: 'Config file exists',
+        passed: configExists,
+        message: configExists
+            ? `Found: ${globalPath}`
+            : `Not found: ${globalPath || '(no path for this platform)'}`,
+    });
+    // 2. Check proxy binary (for mcp-proxy-stdio agents)
+    if (agent.mcp.transport === 'mcp-proxy-stdio') {
+        const proxyInstalled = await (0, proxy_js_1.isProxyInstalled)();
+        checks.push({
+            name: 'mcp-proxy binary installed',
+            passed: proxyInstalled,
+            message: proxyInstalled ? `Found: ${(0, proxy_js_1.getProxyPath)()}` : `Not found. Run: mx setup ${agent.id}`,
+        });
+        // 3. Check proxy binary is executable
+        if (proxyInstalled) {
+            try {
+                const proxyPath = (0, proxy_js_1.getProxyPath)();
+                (0, node_child_process_1.execFileSync)(proxyPath, ['--version'], {
+                    timeout: 5000,
+                    stdio: 'pipe',
+                    windowsHide: true,
+                });
+                checks.push({
+                    name: 'mcp-proxy binary runs',
+                    passed: true,
+                    message: 'Binary is executable',
+                });
+            }
+            catch (e) {
+                checks.push({
+                    name: 'mcp-proxy binary runs',
+                    passed: false,
+                    message: `Binary failed to execute: ${e.message}`,
+                });
+            }
+        }
+    }
+    // 4. Check steering file (if agent supports it)
+    if (agent.steering) {
+        const steeringPath = (0, rules_writer_js_1.resolveSteeringPath)(agent, 'global');
+        if (steeringPath) {
+            const steeringExists = (0, node_fs_1.existsSync)(steeringPath);
+            if (steeringExists) {
+                try {
+                    const steeringContent = await (0, promises_1.readFile)(steeringPath, 'utf-8');
+                    const version = (0, rules_templates_js_1.parseSteeringVersion)(steeringContent);
+                    if (version) {
+                        const isCurrent = version === package_json_1.default.version;
+                        checks.push({
+                            name: 'Steering rules',
+                            passed: true,
+                            message: isCurrent
+                                ? `Found (v${version}, current)`
+                                : `Found (v${version}, CLI is v${package_json_1.default.version} — run \`mx setup rules --agent ${agent.id}\` to update)`,
+                        });
+                    }
+                    else {
+                        checks.push({
+                            name: 'Steering rules',
+                            passed: false,
+                            message: `File exists but no MemNexus section found: ${steeringPath}`,
+                        });
+                    }
+                }
+                catch {
+                    checks.push({
+                        name: 'Steering rules',
+                        passed: false,
+                        message: `Failed to read: ${steeringPath}`,
+                    });
+                }
+            }
+            else {
+                checks.push({
+                    name: 'Steering rules',
+                    passed: false,
+                    message: `Not found: ${steeringPath}. Run: mx setup rules --agent ${agent.id}`,
+                });
+            }
+        }
+    }
+    // 5. Check API key is configured
+    const apiKey = config_js_1.config.getApiKey();
+    checks.push({
+        name: 'API key configured',
+        passed: !!apiKey,
+        message: apiKey
+            ? `Configured (source: ${config_js_1.config.getApiKey() ? 'config/env' : 'none'})`
+            : 'Not configured. Run: mx auth login',
+    });
+    // 6. Check API is reachable (if key is configured)
+    if (apiKey) {
+        try {
+            const { getSdk } = await Promise.resolve().then(() => __importStar(require('../api-client.js')));
+            const sdk = getSdk();
+            await sdk.users.getCurrentUser();
+            checks.push({
+                name: 'API reachable',
+                passed: true,
+                message: 'Successfully connected to MemNexus API',
+            });
+        }
+        catch (e) {
+            checks.push({
+                name: 'API reachable',
+                passed: false,
+                message: `Connection failed: ${e.message}`,
+            });
+        }
+    }
+    return {
+        agentId: agent.id,
+        agentName: agent.name,
+        checks,
+        allPassed: checks.every((c) => c.passed),
+    };
+}
+/**
+ * Verify all configured agents.
+ */
+async function verifyAll() {
+    const agents = (0, registry_js_1.getSortedAgents)();
+    const platform = node_os_1.default.platform();
+    const results = [];
+    for (const agent of agents) {
+        // Only verify agents that have a config file present
+        const globalPath = agent.mcp.globalConfigPath[platform];
+        if (globalPath && (0, node_fs_1.existsSync)((0, detector_js_1.resolvePath)(globalPath))) {
+            results.push(await verifyAgent(agent));
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=verifier.js.map

package/dist/lib/setup/verifier.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memnexus-ai/cli",
-  "version": "1.7.42",
+  "version": "1.7.44",
   "description": "Command-line interface for MemNexus Core API",
   "main": "dist/index.js",
   "bin": {
@@ -33,7 +33,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@memnexus-ai/typescript-sdk": "^1.41.4",
+    "@memnexus-ai/typescript-sdk": "^1.42.10",
     "axios": "^1.13.5",
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.3",