@lawtedwu/climax-vault 0.1.0

package/README.md

@@ -0,0 +1,67 @@
+# @lawtedwu/climax-vault
+
+Climax Racing Team 2026 GTWCA 赛季文件库 CLI（zero-token 客户端）。
+
+数据通过私有 Cloudflare Worker 提供，需要团队 token 才能访问。
+
+## 使用方式
+
+把下面这段 prompt 粘进 Claude / Coze / Cursor（**替换 `<TOKEN>` 为你的团队 token**）：
+
+```
+我们的 Climax vault token 是 <TOKEN>。
+先跑 `CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest dump` 拉取
+全部赛季文档，然后回答我的问题。
+```
+
+或者直接命令行：
+
+```bash
+CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest dump          # 全量文档
+CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest event sepang  # Sepang 站
+CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest regulations   # 赛事规章
+CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest tires         # 轮胎数据
+CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest team          # 车队成员
+CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest search "pit"  # 全文搜索
+```
+
+## 获取 Token
+
+向车队经理（Arna Fong 方琨）申请。Token 用于鉴权所有 API 请求。
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `help` | 显示帮助 |
+| `dump` | 输出全部文档（给 agent 完整 context） |
+| `list` | 列出 vault 中所有文件 |
+| `regulations` | 赛事规章（规则/罚则/积分/进站） |
+| `event <name>` | 分站信息（sepang/mandalika/shanghai/fuji/okayama/beijing） |
+| `tires` | Pirelli 手册 + 规格索引 |
+| `team` | 车队成员 + 联系方式 |
+| `search <term>` | 全文搜索 |
+| `file <path>` | 读取指定文件 |
+
+## Architecture
+
+```
+Coze / Claude / Cursor
+       │
+       │ paste prompt with token
+       ▼
+   npx @lawtedwu/climax-vault
+       │
+       │ HTTPS + Bearer token
+       ▼
+climax-vault.lawtedwu.workers.dev (Cloudflare Worker)
+       │
+       │ embedded vault data
+       ▼
+   Markdown content → stdout → agent reads it
+```
+
+- **零 token 消耗**：CLI 不调用任何 AI API
+- **数据私有**：托管在私有 Cloudflare Worker，token 鉴权
+- **零基础设施**：Worker 跑在 Cloudflare 免费 tier
+- **任何 agent 可用**：只要能跑 npx 命令就行

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+const WORKER_URL = process.env.CLIMAX_WORKER_URL ?? "https://climax-vault.lawtedwu.workers.dev";
+function getToken(args) {
+    const flagIdx = args.findIndex(a => a === "--token" || a.startsWith("--token="));
+    if (flagIdx !== -1) {
+        const arg = args[flagIdx];
+        if (arg.includes("="))
+            return arg.split("=").slice(1).join("=");
+        return args[flagIdx + 1] ?? "";
+    }
+    return process.env.CLIMAX_TOKEN ?? "";
+}
+function stripTokenArgs(args) {
+    const out = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--token") {
+            i++;
+            continue;
+        }
+        if (a.startsWith("--token="))
+            continue;
+        out.push(a);
+    }
+    return out;
+}
+async function fetchWorker(path, token) {
+    if (!token) {
+        console.error("❌ Missing team token. Set CLIMAX_TOKEN env var or pass --token=<token>.");
+        console.error("   Contact Climax Racing team manager for the token.");
+        process.exit(1);
+    }
+    const url = `${WORKER_URL}${path}`;
+    const res = await fetch(url, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (res.status === 401) {
+        console.error("❌ Unauthorized. Token rejected by Climax vault Worker.");
+        process.exit(1);
+    }
+    if (!res.ok) {
+        console.error(`❌ Worker returned ${res.status}: ${await res.text()}`);
+        process.exit(1);
+    }
+    return await res.text();
+}
+function printHelp() {
+    console.log(`
+climax-vault — Climax Racing Team 2026 GTWCA Document Vault (zero-token client)
+
+USAGE
+  npx @lawtedwu/climax-vault <command> [options]
+  CLIMAX_TOKEN=<token> npx @lawtedwu/climax-vault <command>
+
+AUTH
+  This CLI fetches data from a private Cloudflare Worker.
+  You need a team token. Get it from your team manager (Arna Fong 方琨).
+
+  Pass via env var:    CLIMAX_TOKEN=xxx npx @lawtedwu/climax-vault dump
+  Or via flag:         npx @lawtedwu/climax-vault dump --token=xxx
+
+COMMANDS
+  help                Show this help message
+  dump                Output ALL documents (for full agent context)
+  list                List all available files in the vault
+  regulations         Sporting regulations (rules, penalties, points)
+  event <name>        Event info (sepang, mandalika, shanghai, fuji, okayama, beijing)
+  tires               Tire data: Pirelli book + specs index
+  team                Team roster & contacts
+  search <term>       Search across all documents
+
+EXAMPLES
+  CLIMAX_TOKEN=xxx npx @lawtedwu/climax-vault dump
+  CLIMAX_TOKEN=xxx npx @lawtedwu/climax-vault event sepang
+  CLIMAX_TOKEN=xxx npx @lawtedwu/climax-vault search "pit stop"
+
+ZERO-TOKEN PROMPT (paste into Claude / Coze / Cursor):
+
+  我们的 Climax vault token 是 <TOKEN>。
+  先跑 \`CLIMAX_TOKEN=<TOKEN> npx @lawtedwu/climax-vault@latest dump\` 拉取
+  全部赛季文档，然后回答我的问题。
+`);
+}
+const EVENT_ALIASES = {
+    sepang: "r1-r2-sepang",
+    mandalika: "r3-r4-mandalika",
+    shanghai: "r5-r6-shanghai",
+    fuji: "r7-r8-fuji",
+    okayama: "r9-r10-okayama",
+    beijing: "r11-r12-beijing",
+    r1: "r1-r2-sepang", r2: "r1-r2-sepang",
+    r3: "r3-r4-mandalika", r4: "r3-r4-mandalika",
+    r5: "r5-r6-shanghai", r6: "r5-r6-shanghai",
+    r7: "r7-r8-fuji", r8: "r7-r8-fuji",
+    r9: "r9-r10-okayama", r10: "r9-r10-okayama",
+    r11: "r11-r12-beijing", r12: "r11-r12-beijing",
+};
+async function main() {
+    const rawArgs = process.argv.slice(2);
+    const token = getToken(rawArgs);
+    const args = stripTokenArgs(rawArgs);
+    const cmd = args[0] ?? "help";
+    switch (cmd) {
+        case "help":
+        case "--help":
+        case "-h":
+            printHelp();
+            return;
+        case "list":
+            console.log(await fetchWorker("/list", token));
+            return;
+        case "dump":
+            console.log(await fetchWorker("/dump", token));
+            return;
+        case "regulations":
+        case "regs":
+        case "rules":
+            console.log(await fetchWorker("/file/regulations/sporting-regulations.md", token));
+            return;
+        case "tires":
+        case "tyres":
+        case "tire": {
+            const book = await fetchWorker("/file/tires/pirelli-book.md", token);
+            const specs = await fetchWorker("/file/tires/specs-index.md", token);
+            console.log(book);
+            console.log("\n" + "=".repeat(60) + "\n");
+            console.log(specs);
+            return;
+        }
+        case "team":
+        case "staff": {
+            const staff = await fetchWorker("/file/team/staff.md", token);
+            const contacts = await fetchWorker("/file/team/contacts.md", token);
+            console.log(staff);
+            console.log("\n" + "=".repeat(60) + "\n");
+            console.log(contacts);
+            return;
+        }
+        case "event": {
+            const name = (args[1] ?? "sepang").toLowerCase().replace(/[^a-z0-9]/g, "");
+            const dir = EVENT_ALIASES[name] ?? name;
+            const files = ["overview.md", "timetable.md", "cars.md", "logistics.md"];
+            for (const f of files) {
+                try {
+                    const content = await fetchWorker(`/file/events/${dir}/${f}`, token);
+                    console.log(`\n${"=".repeat(60)}\n📄 events/${dir}/${f}\n${"=".repeat(60)}\n`);
+                    console.log(content);
+                }
+                catch {
+                    // skip missing files (e.g. future events)
+                }
+            }
+            return;
+        }
+        case "search":
+        case "find":
+        case "grep": {
+            const term = args.slice(1).join(" ");
+            if (!term) {
+                console.error("Usage: search <term>");
+                process.exit(1);
+            }
+            console.log(await fetchWorker(`/search/${encodeURIComponent(term)}`, token));
+            return;
+        }
+        case "file": {
+            const path = args[1];
+            if (!path) {
+                console.error("Usage: file <path>  (e.g. file regulations/sporting-regulations.md)");
+                process.exit(1);
+            }
+            console.log(await fetchWorker(`/file/${path}`, token));
+            return;
+        }
+        default:
+            console.error(`Unknown command: ${cmd}. Run "climax-vault help" for usage.`);
+            process.exit(1);
+    }
+}
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});
+export {};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@lawtedwu/climax-vault",
+  "version": "0.1.0",
+  "description": "Climax Racing Team 2026 GTWCA document vault CLI. Zero-token client — fetches private team data from Cloudflare Worker.",
+  "type": "module",
+  "bin": {
+    "climax-vault": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LAWTED/climax-vault.git",
+    "directory": "cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "climax",
+    "racing",
+    "gtwca",
+    "gt3",
+    "vault",
+    "zero-token"
+  ],
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0"
+  }
+}