@memoarchitect/tools 0.6.2 → 0.6.4

package/packages/tools/lib/commands/mcp.js

@@ -0,0 +1,128 @@
+// ─── memo mcp CLI Command ────────────────────────────────────────────────────
+//
+//   memo mcp              — serve the model over MCP on stdio (read-only)
+//   memo mcp --write      — same, with the model-editing tools enabled
+//   memo mcp init         — wire the server into Cursor / Claude Code
+//
+// The serve path must keep stdout clean for JSON-RPC frames, so it prints
+// nothing there. `init` is an ordinary command and prints normally.
+// ─────────────────────────────────────────────────────────────────────────────
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import chalk from 'chalk';
+import { findConfigFile } from '../index.js';
+import { startMcpServer } from '../mcp/server.js';
+export async function mcpCommand(options) {
+    const projectRoot = resolve(options.project ?? process.cwd());
+    if (!findConfigFile(projectRoot)) {
+        // stderr, not stdout — an MCP client is reading stdout as protocol.
+        console.error(chalk.red(`No MEMO project found at ${projectRoot}.`));
+        console.error(chalk.dim('Run `memo init` there, or pass --project <path>.'));
+        process.exit(1);
+    }
+    await startMcpServer({
+        projectRoot,
+        allowWrites: options.write === true,
+        version: options.version,
+    });
+}
+/** The MCP client entry MEMO registers. */
+function serverEntry(projectRoot, write) {
+    const args = ['-y', '--package=@memoarchitect/tools', 'memo', 'mcp', '--project', projectRoot];
+    if (write)
+        args.push('--write');
+    // npx rather than a bare `memo` so this works without a global install.
+    return { command: 'npx', args };
+}
+/**
+ * Merge our server into an MCP config file, preserving any other servers the
+ * user has registered. Only the `memo` key is ever touched.
+ */
+function mergeMcpConfig(path, entry) {
+    let config = {};
+    let existed = false;
+    if (existsSync(path)) {
+        existed = true;
+        try {
+            config = JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch {
+            throw new Error(`${path} is not valid JSON. Fix or remove it, then re-run.`);
+        }
+    }
+    if (!config.mcpServers || typeof config.mcpServers !== 'object')
+        config.mcpServers = {};
+    config.mcpServers.memo = entry;
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
+    return existed ? 'updated' : 'created';
+}
+const CURSOR_RULES = `---
+description: MEMO SysML v2 modelling conventions for this medical device project
+globs:
+  - "**/*.sysml"
+alwaysApply: false
+---
+
+# MEMO model conventions
+
+This project is a MEMO medical device model. The \`.sysml\` files are the
+regulated source of truth — treat them as you would production code under
+change control.
+
+## Before you edit
+
+- Call the \`memo_ontology\` MCP tool to see the element kinds and relationship
+  types this project actually defines. Never invent a kind or relationship
+  name; if what you need is missing, say so rather than approximating.
+- Call \`memo_search_elements\` to find the exact id of anything you reference.
+  Ids are SysML usage names and must match exactly.
+
+## While you edit
+
+- Every element belongs to exactly one architecture layer, determined by its
+  kind. Do not move an element between layers as a side effect of another change.
+- Relationships are typed. Use the relationship types from \`memo_ontology\`,
+  with the direction the ontology specifies.
+- Terms that come from a standard (ISO 14971 risk vocabulary, IEC 62304
+  software safety classes) carry regulatory meaning. Use them exactly as the
+  ontology defines them — never paraphrase a regulated term.
+
+## After you edit
+
+- Call \`memo_validate\` and resolve any new errors you introduced. Warnings
+  that predate your change are not yours to fix unless asked.
+- Traceability matters more than volume: a new requirement with no verification
+  is a gap, not progress.
+`;
+export async function mcpInitCommand(options) {
+    const projectRoot = resolve(options.project ?? process.cwd());
+    if (!findConfigFile(projectRoot)) {
+        console.error(chalk.red(`No MEMO project found at ${projectRoot}.`));
+        console.error(chalk.dim('Run `memo init` first.'));
+        process.exit(1);
+    }
+    const write = options.write === true;
+    const entry = serverEntry(projectRoot, write);
+    const mcpPath = resolve(projectRoot, '.cursor', 'mcp.json');
+    const outcome = mergeMcpConfig(mcpPath, entry);
+    console.log(`${outcome === 'created' ? 'Created' : 'Updated'} ${chalk.cyan('.cursor/mcp.json')}`);
+    if (!options.noRules) {
+        const rulesPath = resolve(projectRoot, '.cursor', 'rules', 'memo.mdc');
+        mkdirSync(dirname(rulesPath), { recursive: true });
+        const rulesExisted = existsSync(rulesPath);
+        writeFileSync(rulesPath, CURSOR_RULES, 'utf8');
+        console.log(`${rulesExisted ? 'Updated' : 'Created'} ${chalk.cyan('.cursor/rules/memo.mdc')}`);
+    }
+    console.log('');
+    console.log(chalk.bold('MEMO is now available to Cursor.'));
+    console.log(chalk.dim('Restart Cursor, then check Settings → MCP for the "memo" server.'));
+    console.log('');
+    console.log(write
+        ? chalk.yellow('Editing tools are enabled — Cursor can write elements into your SysML source.')
+        : chalk.dim('The server is read-only. Re-run with --write to let Cursor create elements.'));
+    console.log('');
+    console.log(chalk.dim('For Claude Code, register the same server with:'));
+    console.log(chalk.dim(`  claude mcp add memo -- npx -y --package=@memoarchitect/tools memo mcp --project ${projectRoot}${write ? ' --write' : ''}`));
+}
+//# sourceMappingURL=mcp.js.map

package/packages/tools/lib/commands/mcp.js.map

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

package/packages/tools/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAKhD,OAAO,EACH,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,mBAAmB,IAAI,uBAAuB,EACnD,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAClB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAG1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAGhD,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAKhD,OAAO,EACH,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,mBAAmB,IAAI,uBAAuB,EACnD,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAClB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAG1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAGhD,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,mBAAmB,CAAC;AAQlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,uBAAuB,CAAC"}

package/packages/tools/lib/index.js

@@ -49,6 +49,10 @@ export * from './dhf/index.js';
 export * from './llm/index.js';
 // ─── Plugin System ──────────────────────────────────────────────────────────
 export * from './plugin/index.js';
+// The MCP server is intentionally NOT re-exported here. It depends on
+// server/persistor, which imports this module by package name — routing it
+// through the public index would close a runtime import cycle. `memo mcp`
+// imports src/mcp/server.js directly instead.
 // ─── Protocol (WebSocket messages) ──────────────────────────────────────────
 export * from './protocol/messages.js';
 // ─── OWL Export ─────────────────────────────────────────────────────────────

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAEpC,+EAA+E;AAC/E,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAoBhD,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAE5C,+EAA+E;AAC/E,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAE1C,gFAAgF;AAChF,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAElC,+EAA+E;AAC/E,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAEhD,gFAAgF;AAChF,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAExC,8EAA8E;AAC9E,cAAc,qBAAqB,CAAC;AAEpC,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC;AAE/B,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC;AAE/B,+EAA+E;AAC/E,cAAc,mBAAmB,CAAC;AAElC,+EAA+E;AAC/E,cAAc,wBAAwB,CAAC;AAEvC,+EAA+E;AAC/E,cAAc,4BAA4B,CAAC;AAE3C,8EAA8E;AAC9E,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAEpC,+EAA+E;AAC/E,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAoBhD,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAE5C,+EAA+E;AAC/E,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAE1C,gFAAgF;AAChF,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAElC,+EAA+E;AAC/E,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAEhD,gFAAgF;AAChF,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAExC,8EAA8E;AAC9E,cAAc,qBAAqB,CAAC;AAEpC,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC;AAE/B,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC;AAE/B,+EAA+E;AAC/E,cAAc,mBAAmB,CAAC;AAElC,sEAAsE;AACtE,2EAA2E;AAC3E,0EAA0E;AAC1E,8CAA8C;AAE9C,+EAA+E;AAC/E,cAAc,wBAAwB,CAAC;AAEvC,+EAA+E;AAC/E,cAAc,4BAA4B,CAAC;AAE3C,8EAA8E;AAC9E,cAAc,uBAAuB,CAAC"}

package/packages/tools/lib/llm/chat-engine.d.ts

@@ -0,0 +1,97 @@
+import type { QueryContext } from '../dhf/query-engine.js';
+import type { MEMOConfig } from '../model/config.js';
+import type { LLMProvider, ChatMessage, ToolDefinition } from './llm-provider.js';
+import { type ContextOptions } from './model-context.js';
+export interface ProposedElementCreate {
+    kind: 'create-element';
+    id: string;
+    elementId: string;
+    name: string;
+    elementKind: string;
+    layer?: string;
+    attributes?: Record<string, string>;
+    doc?: string;
+    summary: string;
+}
+export interface ProposedElementUpdate {
+    kind: 'update-element';
+    id: string;
+    elementId: string;
+    /** Only the fields the model asked to change. */
+    changes: {
+        name?: string;
+        attributes?: Record<string, string>;
+        doc?: string;
+    };
+    /** Current values for the same fields, so the UI can render a diff. */
+    before: {
+        name?: string;
+        attributes?: Record<string, string>;
+        doc?: string;
+    };
+    summary: string;
+}
+export interface ProposedRelationshipCreate {
+    kind: 'create-relationship';
+    id: string;
+    relationshipType: string;
+    sourceId: string;
+    targetId: string;
+    summary: string;
+}
+export interface ProposedRelationshipDelete {
+    kind: 'delete-relationship';
+    id: string;
+    relationshipId: string;
+    sourceId: string;
+    targetId: string;
+    relationshipType: string;
+    summary: string;
+}
+export type ProposedChange = ProposedElementCreate | ProposedElementUpdate | ProposedRelationshipCreate | ProposedRelationshipDelete;
+export interface ChatTurnResult {
+    /** The assistant's final prose for this turn. */
+    answer: string;
+    /** Changes awaiting approval. Empty when the turn was read-only. */
+    proposedChanges: ProposedChange[];
+    /**
+     * The full message history including this turn, ready to be sent back on
+     * the next call. Tool calls and results are included — the model needs
+     * them to stay coherent across turns.
+     */
+    messages: ChatMessage[];
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** True when the loop hit `maxIterations` before the model finished. */
+    truncated?: boolean;
+}
+export interface ChatTurnOptions {
+    /** The user's new message. */
+    question: string;
+    /** Prior conversation, excluding the system prompt. */
+    history?: ChatMessage[];
+    ctx: QueryContext;
+    provider: LLMProvider;
+    config?: MEMOConfig;
+    /** Allow the model to propose edits. Read-only when false. */
+    allowEdits?: boolean;
+    contextOptions?: ContextOptions;
+    /** Cap on tool round-trips per turn. */
+    maxIterations?: number;
+}
+declare const READ_TOOLS: ToolDefinition[];
+declare function writeTools(config?: MEMOConfig): ToolDefinition[];
+/**
+ * Run one conversational turn, looping until the model stops calling tools.
+ *
+ * The returned `messages` include every tool call and result, so passing them
+ * straight back as `history` on the next turn keeps the model coherent.
+ */
+export declare function runChatTurn(options: ChatTurnOptions): Promise<ChatTurnResult>;
+/** The tool names this engine exposes — used by tests and the MCP server. */
+export declare function chatToolNames(allowEdits?: boolean): string[];
+export { READ_TOOLS, writeTools };
+//# sourceMappingURL=chat-engine.d.ts.map

package/packages/tools/lib/llm/chat-engine.d.ts.map

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