@enfyra/mcp-server 0.0.26 → 0.0.28

package/README.md

@@ -17,7 +17,7 @@ From your **Enfyra project root**:
 npx @enfyra/mcp-server config
 ```
 
-- **Interactive (default in a terminal):** first asks **where** to write config — `[1]` Claude Code, `[2]` Cursor, `[3]` Codex, `[4]` all (default) — unless you already passed target flags. Then prompts for `ENFYRA_API_URL`, `ENFYRA_EMAIL`, and `ENFYRA_PASSWORD` when missing. Press **Enter** to accept bracketed defaults from env or existing `enfyra` config. Password **Enter** keeps the current saved password when updating.
+- **Interactive (default in a terminal):** first asks **where** to write config with an arrow-key selector — Claude Code, Cursor, Codex, or all — unless you already passed target flags. Then prompts for `ENFYRA_API_URL`, `ENFYRA_EMAIL`, and `ENFYRA_PASSWORD` when missing. Press **Enter** to accept bracketed defaults from env or existing `enfyra` config. Password **Enter** keeps the current saved password when updating.
 - **Re-run anytime** to update the same files; other entries under `mcpServers` are preserved.
 - **Non-interactive** (CI / scripts): `npx @enfyra/mcp-server config --yes` plus optional `-a` / `-e` / `-p` and/or env vars.
 - **One host only:** `--claude-code` / `--claude` / `--claude-only` → `./.mcp.json`. `--cursor` / `--cursor-only` → `./.cursor/mcp.json`. `--codex` / `--codex-only` → `~/.codex/config.toml`. Pass multiple target flags to write each selected host.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "MCP server for Enfyra - manage your Enfyra instance via Claude Code",
   "type": "module",
   "license": "MIT",

package/src/lib/config-local.mjs

@@ -1,5 +1,6 @@
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { createInterface } from 'node:readline/promises';
+import { emitKeypressEvents } from 'node:readline';
 import { stdin as input, stdout as output, cwd } from 'node:process';
 import { dirname, join } from 'node:path';
 import { homedir } from 'node:os';
@@ -23,14 +24,14 @@ Options:
   --password, -p <secret> ENFYRA_PASSWORD
   --reconfig              Always choose target again in interactive mode and replace the old enfyra config for that target
   --yes                   Non-interactive: no prompts (CI / scripts); use CLI, env, existing file, then defaults
-  Target — non-interactive default is all; with TTY and no target flags, you are prompted [1]/[2]/[3]/[4]:
+  Target — non-interactive default is all; with TTY and no target flags, choose with ↑/↓:
   --claude-code, --claude, --claude-only   Only ./.mcp.json (Claude Code project scope)
   --cursor, --cursor-only                  Only ./.cursor/mcp.json (Cursor)
   --codex, --codex-only                    Only ~/.codex/config.toml (Codex)
   Passing multiple target flags writes each selected target.
   -h, --help              Show this help
 
-Interactive mode: asks Claude Code vs Cursor vs both if you did not pass target flags; then asks for URL / email / password
+Interactive mode: lets you choose Claude Code / Cursor / Codex / all if you did not pass target flags; then asks for URL / email / password
   when missing. Existing ./.mcp.json, ./.cursor/mcp.json, and ~/.codex/config.toml are used as defaults. Re-run to update.
 
 Examples:
@@ -231,6 +232,28 @@ async function loadExistingEnfyraEnv(root, readClaude, readCursor, readCodex) {
 }
 
 async function promptTargetChoice() {
+  const choices = [
+    {
+      label: 'Claude Code — ./.mcp.json',
+      value: { claude: true, cursor: false, codex: false },
+    },
+    {
+      label: 'Cursor — ./.cursor/mcp.json',
+      value: { claude: false, cursor: true, codex: false },
+    },
+    {
+      label: 'Codex — ~/.codex/config.toml',
+      value: { claude: false, cursor: false, codex: true },
+    },
+    {
+      label: 'All',
+      value: { claude: true, cursor: true, codex: true },
+    },
+  ];
+  if (input.setRawMode && output.isTTY) {
+    return promptTargetSelect(choices, 3);
+  }
+
   const rl = createInterface({ input, output });
   const line = (await rl.question(
     'Where should Enfyra MCP config be written?\n'
@@ -256,6 +279,66 @@ async function promptTargetChoice() {
   return { claude: true, cursor: true, codex: true };
 }
 
+async function promptTargetSelect(choices, initialIndex = 0) {
+  let selected = Math.max(0, Math.min(initialIndex, choices.length - 1));
+  let renderedLines = 0;
+
+  const render = () => {
+    if (renderedLines > 0) {
+      output.write(`\x1B[${renderedLines}A\x1B[0J`);
+    }
+    const lines = [
+      'Where should Enfyra MCP config be written?',
+      ...choices.map((choice, index) => `${index === selected ? '›' : ' '} ${choice.label}`),
+      '',
+      'Use ↑/↓ to move, Enter to select.',
+    ];
+    renderedLines = lines.length;
+    output.write(`${lines.join('\n')}\n`);
+  };
+
+  return new Promise((resolve, reject) => {
+    const wasRaw = input.isRaw;
+    const cleanup = () => {
+      input.off('keypress', onKeypress);
+      if (!wasRaw) input.setRawMode(false);
+      output.write('\x1B[?25h');
+    };
+    const finish = () => {
+      cleanup();
+      resolve(choices[selected].value);
+    };
+    const onKeypress = (_str, key = {}) => {
+      if (key.ctrl && key.name === 'c') {
+        cleanup();
+        output.write('\n');
+        reject(new Error('Cancelled'));
+        return;
+      }
+      if (key.name === 'up') {
+        selected = selected <= 0 ? choices.length - 1 : selected - 1;
+        render();
+        return;
+      }
+      if (key.name === 'down') {
+        selected = selected >= choices.length - 1 ? 0 : selected + 1;
+        render();
+        return;
+      }
+      if (key.name === 'return' || key.name === 'enter') {
+        finish();
+      }
+    };
+
+    emitKeypressEvents(input);
+    input.setRawMode(true);
+    input.resume();
+    output.write('\x1B[?25l');
+    input.on('keypress', onKeypress);
+    render();
+  });
+}
+
 async function promptConfig(opts, existing) {
   let apiUrl = opts.apiUrl;
   let email = opts.email;

package/src/lib/mcp-instructions.js

@@ -39,7 +39,7 @@ export function buildMcpServerInstructions(apiBaseUrl) {
     '### Capability map (current Enfyra system)',
     '- **Schema/metadata:** `table_definition`, `relation_definition`, and schema tools manage tables, columns, relations, validation, and migrations. `column_definition` is internal/no-route; columns are created/updated through table schema operations.',
     '- **Dynamic REST API:** `route_definition`, `route_handler_definition`, `pre_hook_definition`, `post_hook_definition`, `route_permission_definition`, and `method_definition` define paths, methods, handlers, hooks, and permissions.',
-    '- **Auth/OAuth/session:** `user_definition`, `role_definition`, `oauth_config_definition`, `oauth_account_definition`; `session_definition` is internal/no-route. OAuth is browser redirect only; MCP login is email/password.',
+    '- **Auth/OAuth/session:** `user_definition`, `role_definition`, `oauth_config_definition`, `oauth_account_definition`; `session_definition` is internal/no-route. OAuth is browser redirect only; MCP login is email/password. `user_definition` is the single source of truth for app users.',
     '- **Guards/permissions/validation:** `guard_definition`, `guard_rule_definition`, `field_permission_definition`, and `column_rule_definition` control route guards, field access, and request body validation.',
     '- **GraphQL:** `gql_definition` enables tables in GraphQL. GraphQL endpoint and schema share `ENFYRA_API_URL`; GraphQL requires Bearer auth.',
     '- **Files/storage/assets:** `file_definition`, `file_permission_definition`, `folder_definition`, `storage_config_definition` plus upload/assets routes and file helpers.',
@@ -76,6 +76,8 @@ export function buildMcpServerInstructions(apiBaseUrl) {
     '- MCP **`create_table` supports `isSingleRecord` directly**. Set `isSingleRecord: true` in the create call for settings/config tables that should keep only one record; do not create first and then patch only for this flag.',
     '- MCP **`create_table` does not accept `alias`**. Do not invent or send alias during table creation; default route/schema behavior is based on `name`. Use `update_table` later only when alias truly needs to change.',
     '- In `create_table.relations`, each relation uses `targetTable` (table id or `{id}`), `type`, `propertyName`, optional `inversePropertyName` or `mappedBy`, `isNullable`, `onDelete`, and `description`. The target table must already exist.',
+    '- **Use `user_definition` as the only user table.** Do not create app-specific user/profile mapping tables such as `chat_profile`, `app_user`, `customer_user`, or tables that only mirror/link Enfyra users. If an app needs extra user fields or user relations, add columns/relations directly on `user_definition`.',
+    '- When modeling features that involve users, relate domain tables directly to `user_definition` through real Enfyra relations. Examples: `chat_conversation_member.member` → `user_definition`, `chat_message.sender` → `user_definition`, `order.customer` → `user_definition`. Do not create duplicate scalar columns like `userId` or separate profile records just to point back to a user.',
     '- **Prefer real relations over relation-shaped columns.** If a field represents another record or list of records, model it as `relations`, not as columns such as `userId`, `author_id`, `categoryIds`, `teamIds`, `itemsJson`, or object/array JSON containing related records. Ask only when the user explicitly wants denormalized snapshot data.',
     '- Common mapping: one owner record → `many-to-one`; one record has many children → define the child `many-to-one` and use inverse/read deep relation; peer/tag lists → `many-to-many`; one profile/settings row per parent → `one-to-one` when supported by the model.',
     '- If the user asks to add a foreign key field, interpret it as a relation request unless they explicitly say they need a plain scalar column. Do not create both a relation and a duplicate scalar FK column for the same concept.',