cancanneed 0.1.1 → 0.2.0

package/README.md

@@ -5,43 +5,46 @@
 
 ## 一条命令安装
 
-**npx（推荐，无需 clone）:**
+**npx（推荐，无需 clone，首次自动下载）:**
 ```bash
 npx cancanneed /path/to/project
 ```
 
-**Hermes Agent:**
+**全局安装:**
 ```bash
-cp ~/cancanneed/hermes_adapter.py ~/hermes-agent/tools/ && hermes # /reset
+npm install -g cancanneed
+cancanneed /path/to/project
 ```
 
-**Claude Code / Codex CLI:**
-直接走 codebase-memory-mcp MCP server，然后用 `cancanneed.py` CLI：
+**Hermes Agent（将 cancanneed 注册为工具）:**
 ```bash
-# 先装 CBM (如果还没有)
-curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
+npm install -g cancanneed
+# 复制适配器到 Hermes 工具目录（路径对所有 Node.js 安装方式通用）
+ADAPTER="$(npm root -g)/cancanneed/hermes_adapter.py"
+mkdir -p ~/.hermes/tools && cp "$ADAPTER" ~/.hermes/tools/
+# 重启 hermes 后生效
+```
 
-# 索引 + 骨架
-git clone https://github.com/user/repo /tmp/repo
-codebase-memory-mcp cli index_repository '{"repo_path":"/tmp/repo","mode":"fast"}' --json
-python3 ~/cancanneed/cancanneed.py /tmp/repo
+**Claude Code / Codex CLI:**
+```bash
+npm install -g cancanneed
+cancanneed /path/to/project --json
 ```
 
-**CLI 直接使用（任何 agent，零依赖）:**
+**无 npm 直接下载:**
 ```bash
-python3 ~/cancanneed/cancanneed.py /path/to/project        # 自动索引 + 骨架
-python3 ~/cancanneed/cancanneed.py project-name             # 已有索引的项目
-python3 ~/cancanneed/cancanneed.py                          # 列出所有可用项目
-python3 ~/cancanneed/cancanneed.py --json /path/to/project  # JSON 输出
-python3 ~/cancanneed/cancanneed.py --skill                  # 输出 SKILL.md
+curl -O https://registry.npmjs.org/cancanneed/-/cancanneed-0.1.2.tgz
+tar xzf cancanneed-0.1.2.tgz
+python3 package/cancanneed.py /path/to/project
 ```
 
 ## 前置条件
 
-- Python 3.9+
-- [codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp) 二进制（用于首次索引）
-  - macOS: `brew install deusdata/codebase-memory-mcp/codebase-memory-mcp`
-  - 或: `curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash`
+- **Python 3.9+**（npm 安装时会自动提示）
+- **[codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)** 二进制（用于首次索引）
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
+  ```
 - 首次索引需要 10-60s，后续对同一目录秒级返回（增量索引）
 
 ## 输出示例
@@ -49,7 +52,6 @@ python3 ~/cancanneed/cancanneed.py --skill                  # 输出 SKILL.md
 ```
 project: Users-lyx-ai-runtime-trace
 root: /Users/lyx/ai-runtime-trace
-indexed: 2026-07-11T02:54:07Z
 nodes: 2255, edges: 4486
 
 languages: Python 62, Markdown 57, YAML 21, Bash 11
@@ -57,19 +59,16 @@ languages: Python 62, Markdown 57, YAML 21, Bash 11
 entry points:
   hermes_flow/cli/analyze.py:main
   experiments/agent-pool/cli.py:main
-  ...
 
 routes: ANY /api/admin/agents, ANY /api/admin/skills
 
 hotspots:
   connect (56 in) -- hermes_flow/storage.py
   span (22 in) -- hermes_flow/trace.py
-  ...
 
 layers:
   core: storage(55 in), schemas(23 in), trace(30 in)
   entry: agent-pool, cli, observer, tools
-  ...
 
 complexity:
   flow_init -- O(n^5) (hermes_flow/tools.py)
@@ -82,16 +81,6 @@ call chains:
 
 (~2500 chars / ~600 tokens)
 
-## 项目结构
-
-```
-~/cancanneed/
-  cancanneed.py        # 核心模块 (纯 Python, 零依赖)
-  hermes_adapter.py    # Hermes Agent 适配器 (复制到 ~/hermes-agent/tools/)
-  skills/SKILL.md      # Hermes skill
-  README.md            # 本文件
-```
-
 ## License
 
 MIT

package/cancanneed.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+// cancanneed npx wrapper — delegates to python3 cancanneed.py
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const dir = __dirname;
+const pyScript = fs.existsSync(path.join(dir, 'cancanneed.py'))
+    ? path.join(dir, 'cancanneed.py')
+    : path.join(dir, '..', 'cancanneed.py');
+
+const args = process.argv.slice(2);
+const py = process.env.PYTHON || 'python3';
+
+try {
+    const result = execSync(`"${py}" "${pyScript}" ${args.map(a => `"${a}"`).join(' ')}`, {
+        stdio: 'inherit',
+        timeout: 600000,
+    });
+    process.exit(0);
+} catch (e) {
+    process.exit(e.status || 1);
+}

package/cancanneed.py

@@ -13,13 +13,15 @@ from collections import Counter, defaultdict
 CACHE_DIR = os.path.expanduser("~/.cache/codebase-memory-mcp")
 
 def _find_cbm_binary():
-    for p in [
-        os.path.expanduser("~/.local/bin/codebase-memory-mcp"),
-        os.path.expanduser("~/.hermes/bin/codebase-memory-mcp"),
-        "/usr/local/bin/codebase-memory-mcp",
-    ]:
-        if os.path.isfile(p) and os.access(p, os.X_OK):
-            return p
+    """查找 cancanneed 自带的索引器二进制（不依赖系统 PATH）。"""
+    # 1. cancanneed 包内（npm 安装后 node_modules/cancanneed/ 下）
+    own = os.path.join(os.path.dirname(os.path.abspath(__file__)), "cancanneed-indexer")
+    if os.path.isfile(own) and os.access(own, os.X_OK):
+        return own
+    # 2. 开发环境 ~/cancanneed/ 下
+    dev = os.path.expanduser("~/cancanneed/cancanneed-indexer")
+    if os.path.isfile(dev) and os.access(dev, os.X_OK):
+        return dev
     return None
 
 def _cbm_project_name(repo_path):
@@ -30,7 +32,7 @@ def _cbm_project_name(repo_path):
 def _ensure_indexed(repo_path):
     cbm = _find_cbm_binary()
     if not cbm:
-        return None, "CBM binary not found. Install codebase-memory-mcp first."
+        return None, "CBM binary not found."
     repo_path = os.path.abspath(repo_path)
     if not os.path.isdir(repo_path):
         return None, "Not a directory: %s" % repo_path

package/package.json

@@ -1,16 +1,19 @@
 {
   "name": "cancanneed",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "代码仓库压缩骨架提取器 — ~2K tokens 看清项目全貌",
   "bin": {
-    "cancanneed": "./cancanneed.sh"
+    "cancanneed": "./cancanneed.js"
   },
   "files": [
     "cancanneed.py",
-    "cancanneed.sh",
+    "cancanneed.js",
+    "cancanneed-indexer",
     "skills/SKILL.md",
     "README.md"
   ],
+  "os": ["darwin", "linux"],
+  "cpu": ["arm64"],
   "keywords": ["codebase", "skeleton", "architecture", "agent", "cbm"],
   "license": "MIT"
 }

package/cancanneed.sh

@@ -1,13 +0,0 @@
-#!/bin/sh
-# cancanneed npx wrapper — finds cancanneed.py next to this script
-DIR=$(cd "$(dirname "$0")" && pwd)
-PY=${PYTHON:-python3}
-if [ -f "$DIR/cancanneed.py" ]; then
-    exec "$PY" "$DIR/cancanneed.py" "$@"
-elif [ -f "$DIR/../cancanneed.py" ]; then
-    # npx places bin scripts in node_modules/.bin/, files in node_modules/cancanneed/
-    exec "$PY" "$DIR/../cancanneed.py" "$@"
-else
-    echo "cancanneed: cannot find cancanneed.py" >&2
-    exit 1
-fi