@zlnap/astrolabe 0.16.0 → 0.17.0

package/README.md

@@ -6,14 +6,22 @@ Astrolabe AI：面向 AI 编码助手的本地代码检索与导航 MCP server
 npx -y @zlnap/astrolabe /path/to/repo
 ```
 
-MCP 客户端：
+MCP 客户端（推荐一键配置）：
+
+```bash
+npx -y @zlnap/astrolabe setup
+```
+
+Detects Claude Code, Cursor, Codex, Windsurf, Cline, Roo, Continue, OpenCode, DeepSeek Harness, Codebuddy, Grok Build, Kimi Code, and ZCode. Merges MCP config (OpenCode V1/V2/jsonc; Grok `[mcp_servers.*]` TOML; ZCode `mcp.servers`; DSH installs the native guard plugin + `cordis.patch.yml` merge). Optional `--with-hooks` installs OpenCode's guard plugin and hook recipes for Codebuddy / Grok / Kimi / ZCode (ZCode: no `SessionEnd`, do not hang cleanup on `Stop`). Flags: `--yes`, `--clients=…`, `--dry-run`, `--with-hooks`, `--list`.
+
+探测本机 Claude Code / Cursor / Codex 等，交互勾选后合并写入 MCP 配置（`--yes`、`--dry-run`、`--list` 可用）。手动配置示例：
 
 ```json
 {
   "mcpServers": {
     "astrolabe": {
       "command": "npx",
-      "args": ["-y", "@zlnap/astrolabe", "."]
+      "args": ["-y", "@zlnap/astrolabe", ".", "--context=cursor"]
     }
   }
 }

package/bin/astrolabe.js

@@ -1,14 +1,28 @@
 #!/usr/bin/env node
 'use strict';
 
-const { resolveBinary } = require('../lib/resolve');
-const { runBinary } = require('../lib/run');
+const argv = process.argv.slice(2);
 
-resolveBinary()
-  .then((binPath) => {
-    runBinary(binPath, process.argv.slice(2));
-  })
-  .catch((error) => {
-    console.error(`[astrolabe] ${error.message || error}`);
-    process.exit(1);
-  });
+// `astrolabe setup` is implemented in Node (detect agents + merge MCP configs).
+// Intercept before resolving / spawning the native binary.
+if (argv[0] === 'setup') {
+  const { run } = require('../lib/setup');
+  try {
+    process.exitCode = run(argv.slice(1));
+  } catch (error) {
+    console.error(`[astrolabe setup] ${error.message || error}`);
+    process.exitCode = 1;
+  }
+} else {
+  const { resolveBinary } = require('../lib/resolve');
+  const { runBinary } = require('../lib/run');
+
+  resolveBinary()
+    .then((binPath) => {
+      runBinary(binPath, argv);
+    })
+    .catch((error) => {
+      console.error(`[astrolabe] ${error.message || error}`);
+      process.exit(1);
+    });
+}

package/lib/setup/args.js

@@ -0,0 +1,85 @@
+'use strict';
+
+const USAGE = `Configure Astrolabe as an MCP server for local AI coding agents.
+
+Usage:
+  astrolabe setup [options]
+
+Options:
+  --yes, -y              Configure all detected clients without prompts
+  --clients=a,b,c        Configure only these client ids (comma-separated)
+  --list                 Print detection results and exit
+  --dry-run              Preview writes; do not modify files
+  --native               Use command "astrolabe" on PATH instead of npx
+  --command=<bin>        Override MCP command (default: npx, or astrolabe with --native)
+  --with-hooks           Also install drift-guard hooks/plugins where supported
+                         (OpenCode guard plugin; Codebuddy/Grok/Kimi/ZCode hook recipes;
+                          DSH always installs its native guard)
+  --no-cursor-permissions
+                         Skip merging Cursor mcpAllowlist
+  --cursor-permissions   Force Cursor allowlist merge when Cursor is selected (default on)
+  --home <dir>           Override HOME (tests)
+  -h, --help             Show this help
+
+Client ids:
+  claude-code, cursor, codex, windsurf, cline, roo, continue, opencode,
+  deepseek-harness (alias: dsh), codebuddy, grok (aliases: grokbuild, grok-build),
+  kimicode (aliases: kimi-code, kimi_code, kimi), zcode (aliases: z-code, zai)
+`;
+
+function parseArgs(argv) {
+  const opts = {
+    yes: false,
+    list: false,
+    dryRun: false,
+    native: false,
+    help: false,
+    home: null,
+    clients: null,
+    command: null,
+    cursorPermissions: true,
+    withHooks: false,
+  };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--yes' || arg === '-y') opts.yes = true;
+    else if (arg === '--list') opts.list = true;
+    else if (arg === '--dry-run') opts.dryRun = true;
+    else if (arg === '--native') opts.native = true;
+    else if (arg === '--help' || arg === '-h') opts.help = true;
+    else if (arg === '--with-hooks') opts.withHooks = true;
+    else if (arg === '--no-cursor-permissions') opts.cursorPermissions = false;
+    else if (arg === '--cursor-permissions') opts.cursorPermissions = true;
+    else if (arg === '--home') {
+      const value = argv[i + 1];
+      if (!value || value.startsWith('-')) throw new Error('--home needs a directory');
+      opts.home = value;
+      i += 1;
+    } else if (arg.startsWith('--home=')) {
+      opts.home = arg.slice('--home='.length);
+      if (!opts.home) throw new Error('--home needs a directory');
+    } else if (arg.startsWith('--clients=')) {
+      const raw = arg.slice('--clients='.length).trim();
+      if (!raw) throw new Error('--clients needs a comma-separated list');
+      opts.clients = raw.split(',').map((s) => s.trim()).filter(Boolean);
+    } else if (arg === '--clients') {
+      const value = argv[i + 1];
+      if (!value || value.startsWith('-')) throw new Error('--clients needs a comma-separated list');
+      opts.clients = value.split(',').map((s) => s.trim()).filter(Boolean);
+      i += 1;
+    } else if (arg.startsWith('--command=')) {
+      opts.command = arg.slice('--command='.length);
+      if (!opts.command) throw new Error('--command needs a value');
+    } else if (arg === '--command') {
+      const value = argv[i + 1];
+      if (!value || value.startsWith('-')) throw new Error('--command needs a value');
+      opts.command = value;
+      i += 1;
+    } else {
+      throw new Error(`unknown argument: ${arg}`);
+    }
+  }
+  return opts;
+}
+
+module.exports = { parseArgs, USAGE };