ai-nexus 1.4.2 → 1.4.3

package/README.ko.md

@@ -105,16 +105,16 @@ npx ai-nexus install --rules github.com/your-org/team-rules
 └── rules-inactive/           # 비활성 룰 (로드 안 됨)
 ```
 
-**AI 라우팅 사용** (권장):
+**AI 라우팅 사용** (선택):
 ```bash
 export OPENAI_API_KEY=sk-xxx        # 또는 ANTHROPIC_API_KEY
 export SEMANTIC_ROUTER_ENABLED=true
 ```
 
-GPT-4o-mini 또는 Claude Haiku가 프롬프트를 분석해 적절한 룰을 선택합니다. 비용: 월 ~$0.50.
+GPT-4o-mini 또는 Claude Haiku가 프롬프트를 분석해 적절한 룰을 선택합니다. 비용: 월 ~$0.50. 명시적으로 활성화해야 동작합니다.
 
-**AI 없이** (폴백):
-프롬프트의 키워드를 매칭해서 룰을 활성화합니다.
+**AI 없이** (기본값):
+프롬프트의 키워드를 매칭해서 룰을 활성화합니다. 비용 없음, API 키 불필요.
 
 ### Cursor: 룰 변환기
 
@@ -286,6 +286,27 @@ npx ai-nexus update
 
 ---
 
+## 네트워크 & 개인정보
+
+ai-nexus는 로컬에서 실행됩니다. 아래는 이 도구가 수행할 수 있는 모든 네트워크 요청 목록입니다:
+
+| 시점 | 대상 | 목적 | 필수 여부 |
+|------|------|------|-----------|
+| 시맨틱 라우팅 (프롬프트마다) | `api.openai.com` | GPT-4o-mini를 통한 AI 룰 선택 | **옵트인 전용** — `SEMANTIC_ROUTER_ENABLED=true` + `OPENAI_API_KEY` 필요 |
+| 시맨틱 라우팅 (프롬프트마다) | `api.anthropic.com` | Claude Haiku를 통한 AI 룰 선택 | **옵트인 전용** — `SEMANTIC_ROUTER_ENABLED=true` + `ANTHROPIC_API_KEY` 필요 |
+| `search`, `get`, `browse` | `api.github.com` | 커뮤니티 룰 레지스트리 조회 | 해당 명령어 실행 시에만 |
+| `get` | `raw.githubusercontent.com` | 룰 파일 콘텐츠 다운로드 | `get` 실행 시에만 |
+| `browse` | `localhost:3847` | 마켓플레이스 UI용 로컬 전용 HTTP 서버 | `127.0.0.1`에 바인딩 — 외부 접근 불가 |
+| `install --rules <url>` | Git 원격 호스트 | 팀 룰 저장소 클론 | `--rules` URL 제공 시에만 |
+
+**텔레메트리 없음. 분석 수집 없음. 외부 데이터 전송 없음.**
+
+- API 키는 환경 변수에서만 읽으며, 디스크에 저장하거나 로깅하지 않습니다.
+- 프롬프트가 OpenAI/Anthropic으로 전송되는 것은 시맨틱 라우팅을 **명시적으로 활성화**한 경우에만 해당됩니다. 비활성화 시 키워드 기반 폴백이 완전히 오프라인으로 동작합니다.
+- `browse` 서버는 `127.0.0.1`에 바인딩되어 네트워크에서 접근할 수 없습니다.
+
+---
+
 ## 룰 마켓플레이스
 
 ![browse](https://raw.githubusercontent.com/JSK9999/ai-nexus/main/docs/nexus-marketplace.png)

package/README.md

@@ -105,16 +105,16 @@ A hook runs on every prompt, analyzing what rules you actually need:
 └── rules-inactive/           # Parked rules (not loaded)
 ```
 
-**With AI routing** (recommended):
+**With AI routing** (optional):
 ```bash
 export OPENAI_API_KEY=sk-xxx        # or ANTHROPIC_API_KEY
 export SEMANTIC_ROUTER_ENABLED=true
 ```
 
-GPT-4o-mini or Claude Haiku analyzes your prompt and picks the right rules. Cost: ~$0.50/month.
+GPT-4o-mini or Claude Haiku analyzes your prompt and picks the right rules. Cost: ~$0.50/month. Requires explicit opt-in.
 
-**Without AI** (fallback):
-Keyword matching activates rules based on words in your prompt.
+**Without AI** (default):
+Keyword matching activates rules based on words in your prompt. Zero cost, no API key needed.
 
 ### Cursor: Rule Converter
 
@@ -286,6 +286,27 @@ npx ai-nexus update
 
 ---
 
+## Network & Privacy
+
+ai-nexus runs locally. Here is a complete list of network requests the tool may make:
+
+| When | Destination | Purpose | Required? |
+|------|-------------|---------|-----------|
+| Semantic routing (per prompt) | `api.openai.com` | AI-powered rule selection via GPT-4o-mini | **Opt-in only** — requires `SEMANTIC_ROUTER_ENABLED=true` + `OPENAI_API_KEY` |
+| Semantic routing (per prompt) | `api.anthropic.com` | AI-powered rule selection via Claude Haiku | **Opt-in only** — requires `SEMANTIC_ROUTER_ENABLED=true` + `ANTHROPIC_API_KEY` |
+| `search`, `get`, `browse` | `api.github.com` | Fetch community rule registry | Only when you run these commands |
+| `get` | `raw.githubusercontent.com` | Download rule file content | Only when you run `get` |
+| `browse` | `localhost:3847` | Local-only HTTP server for marketplace UI | Bound to `127.0.0.1` — not accessible from other machines |
+| `install --rules <url>` | Git remote host | Clone a team rules repository | Only when you provide a `--rules` URL |
+
+**No telemetry. No analytics. No external data collection.**
+
+- API keys are read from environment variables only — never stored on disk or logged.
+- Your prompts are sent to OpenAI/Anthropic **only** when semantic routing is explicitly enabled. Without it, keyword-based fallback runs entirely offline.
+- The `browse` server binds to `127.0.0.1` and is not accessible from the network.
+
+---
+
 ## Rule Marketplace
 
 ![browse](https://raw.githubusercontent.com/JSK9999/ai-nexus/main/docs/nexus-marketplace.png)

package/config/hooks/semantic-router.cjs

@@ -9,7 +9,7 @@ const RULES_DIR = fs.existsSync(_projectRules)
   ? _projectRules
   : path.join(os.homedir(), '.claude/rules');
 const INACTIVE_DIR = RULES_DIR.replace(/rules$/, 'rules-inactive');
-const SEMANTIC_ROUTER_ENABLED = process.env.SEMANTIC_ROUTER_ENABLED !== 'false';
+const SEMANTIC_ROUTER_ENABLED = process.env.SEMANTIC_ROUTER_ENABLED === 'true';
 
 // Static keyword map (fallback for files without frontmatter)
 const STATIC_KEYWORD_MAP = {

package/dist/commands/browse.js

@@ -207,7 +207,7 @@ export async function browse(port = 3847) {
             process.exit(1);
         }
     });
-    server.listen(port, () => {
+    server.listen(port, '127.0.0.1', () => {
         console.log(`\n  ai-nexus browse: http://localhost:${port}`);
         console.log(`  Ctrl+C to quit\n`);
         openBrowser(`http://localhost:${port}`);

package/dist/utils/git.js

@@ -1,4 +1,4 @@
-import { execSync } from 'child_process';
+import { execSync, spawnSync } from 'child_process';
 import fs from 'fs';
 export function parseGitUrl(url) {
     // Handle various formats:
@@ -34,10 +34,13 @@ export function cloneRepo(url, targetDir) {
         });
     }
     else {
-        // Clone new repo
-        execSync(`git clone --depth 1 ${normalizedUrl} "${targetDir}"`, {
+        // Clone new repo (use spawnSync to avoid command injection)
+        const result = spawnSync('git', ['clone', '--depth', '1', normalizedUrl, targetDir], {
             stdio: 'pipe',
         });
+        if (result.status !== 0) {
+            throw new Error(`git clone failed: ${result.stderr?.toString() || 'unknown error'}`);
+        }
     }
 }
 export function updateRepo(repoPath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-nexus",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Unified rule manager for Claude Code, Cursor, and Codex - write once, use everywhere, save tokens",
   "main": "dist/index.js",
   "bin": {