mellos-mapping 0.12.0

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "mellos-mapping",
+  "version": "0.12.0",
+  "description": "A live layered dependency map for bottom-up development — MCP server + terminal pane. Ghost the design first, then light nodes up from the bottom as they are built and verified.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Mellos",
+  "homepage": "https://github.com/GuangminJu/mellos-mapping#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GuangminJu/mellos-mapping.git"
+  },
+  "bugs": "https://github.com/GuangminJu/mellos-mapping/issues",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "claude-code",
+    "codex",
+    "visualization",
+    "dependency-graph",
+    "bottom-up",
+    "terminal",
+    "tui"
+  ],
+  "bin": {
+    "mellos-mapping": "dist/server.mjs",
+    "mellos-mapping-watch": "dist/watch.mjs"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "README.zh-CN.md",
+    "scripts/codex-register.mjs"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "build": "node build.mjs",
+    "verify": "npm run typecheck && npm run test && npm run build"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0",
+    "zod": "^3.24.0"
+  }
+}

package/scripts/codex-register.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/**
+ * Register the bundled MCP server with Codex CLI — run once after installing
+ * or updating the plugin: `node <plugin root>/scripts/codex-register.mjs`.
+ *
+ * Why this script exists instead of a plugin-shipped .mcp.json: Codex spawns
+ * plugin-bundled MCP servers inside the plugin cache and gives them no way to
+ * learn the user's workspace (no ${PLUGIN_ROOT}-style expansion in args, cwd
+ * locked to the plugin root when set — verified empirically against
+ * codex-cli 0.147.0). The state file would land in the cache instead of the
+ * project. A user-level `codex mcp add` entry inherits the session's working
+ * directory, which is exactly the contract dist/server.mjs already expects.
+ * The registered path is absolute and version-specific, so re-run after
+ * every plugin update.
+ */
+import { spawnSync } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const pluginRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const serverPath = join(pluginRoot, 'dist', 'server.mjs');
+
+function codex(args) {
+  if (process.platform !== 'win32') {
+    return spawnSync('codex', args, { stdio: 'pipe', encoding: 'utf8' });
+  }
+  // Windows: codex may be an .exe or an npm .cmd shim; only a shell resolves
+  // both. The shell needs explicit quoting for paths with spaces.
+  const line = ['codex', ...args].map((a) => (/[\s"]/.test(a) ? `"${a}"` : a)).join(' ');
+  return spawnSync(line, { shell: true, stdio: 'pipe', encoding: 'utf8' });
+}
+
+// Idempotent: drop any previous (possibly stale, version-specific) entry.
+codex(['mcp', 'remove', 'mellos-mapping']);
+
+const added = codex(['mcp', 'add', 'mellos-mapping', '--', 'node', serverPath]);
+if (added.error !== undefined || added.status !== 0) {
+  process.stderr.write(added.stderr ?? '');
+  console.error(
+    added.error !== undefined
+      ? 'codex CLI not found on PATH — install Codex first, then re-run this script.'
+      : `codex mcp add failed (exit ${added.status}).`,
+  );
+  process.exit(1);
+}
+process.stdout.write(added.stdout ?? '');
+console.log(`mellos-mapping MCP registered with Codex: node ${serverPath}`);
+console.log('State files resolve to each session’s working directory (.claude/mellos-mapping.json).');