mcp-server-gamenumerics 0.1.0 → 0.1.2

package/HOST-VERIFICATION.md

@@ -72,3 +72,14 @@
 | F7 | 宿主进程模型差异：Claude Code 每次 `-p` 独立 server 子进程（无状态），ZCode 长会话常驻 | 预期行为（宿主语义），两种形态 server 均健康（EOF 干净退出 3/3 已验） | 记档即可 |
 
 **验证金字塔收官判定**：两宿主（ZCode + Claude Code）真机全绿 + 用户裁决跳过 Cursor——**发布决策输入齐备，npm publish 解禁**。
+
+## 七、npm 发布记录（2026-09-12，两宿主全绿后用户拍板）
+
+| 步骤 | 结果 |
+|------|------|
+| 发布前置 | 包名核查可用 / files 白名单收敛（误含 41KB 测试文件、漏 dist——修正后 4 文件）/ bin shebang 修复（esbuild CLI banner 不解析转义 + Windows cmd 换行截断双坑，改走 JS API）/ README 反转「发布待定」为 npx 主推形态 |
+| **0.1.0 发布事故** | 首发成坏包：仓库根 `private:true` 拦 publish（npm 向上应用 monorepo 根标记）→ 改独立临时目录发布时把 `dist/index.js` 拷为根级 `index.js`，files 白名单命中 `dist` 目录——**包内无 bin 目标，npx 必崩**；unpublish 403（granular token 无 unpublish 权限） |
+| 0.1.1 修复版 | 版本号推进 + 正确 dist/ 结构发布成功；`npm deprecate` 标记 0.1.0 引导升级；`latest` tag 指向 0.1.1 |
+| **发布后真机冒烟** | ✓ registry 真实拉包：`npx -y mcp-server-gamenumerics` → initialize 响应 + **17 工具**——发布链完整闭环 |
+
+**教训**：发布验收不能止于 `npm pack --dry-run` 看清单——必须在**发布后从 registry 重新安装**并起 server 冒烟（本次 dry-run 两误：白名单误含测试文件、临时目录结构错误均在 dry-run 可见而未核）；granular token 默认无 unpublish 权限，首发事故只能版本推进兜底（unpublish 72h 窗口需账号级操作）。

package/README.md

@@ -1,5 +1,35 @@
 # mcp-server-gamenumerics
 
+> **MCP server for game numerical design & balance auditing.** 17 deterministic tools that let your AI coding agent (Claude Code, Cursor, ZCode, or any MCP host) import xlsx config tables, audit growth curves, run battle/gacha simulations, and reverse-engineer the formulas behind game spreadsheets — every numeric answer comes from deterministic pure-function engines, zero LLM guessing.
+
+**Who it's for**: game designers and solo/small teams doing roguelike / deckbuilder balance work, spreadsheet-driven numerical design, or live-ops tuning audits — no engine integration required, just an xlsx export of your config tables.
+
+**What you get — 17 tools**: `import_xlsx` (dual-row header merge + column-pattern detection) · `list_tables` / `read_table` (workspace read, filter & paginate) · `battle_simulate` / `simulate_gacha` (Monte Carlo) / `compute_power` (EHP×EDPS) / `power_curve` / `eval_formula` / `audit_column` (expected-vs-actual reconciliation) / `infer_column_rule` (Theil-Sen robust fitting) / `infer_table_relation` (base×coefficient structures) · `grade_workspace` / `profile_table` / `infer_foreign_keys` (structure analysis) · `list_workspaces` / `set_workspace` / `read_memory` (session meta). Read-only surface — write tools stay behind the web workbench's human-in-the-loop confirm flow.
+
+**Quick start** (Node.js 18+):
+
+```bash
+npx -y mcp-server-gamenumerics
+```
+
+```json
+{ "mcpServers": { "gamenumerics": { "command": "npx", "args": ["-y", "mcp-server-gamenumerics"] } } }
+```
+
+Also on **Smithery** — one-line install ([server page](https://smithery.ai/servers/26048608982lp/gamenumerics)):
+
+```bash
+npx -y @smithery/cli@latest install 26048608982lp/gamenumerics --client claude
+```
+
+**Performance**: ~150ms cold start (spawn → initialize → tools/list) · ~79MB idle memory · 17 tools · clean exit on stdin close.
+
+**Verified hosts**: ZCode ✓ · Claude Code ✓ — per-host config snippets below; host-verification log in [HOST-VERIFICATION.md](HOST-VERIFICATION.md).
+
+---
+
+以下为中文详细文档。
+
 游戏数值设计 Agent 工作站的 MCP（Model Context Protocol）形态——**read/算/审计面**的 stdio server。
 
 把本项目 agent harness 的 20+ 个零依赖纯函数数值引擎，以 **14 个只读数值工具 + 3 个会话 meta 工具**（共 17 个）带给任意 MCP 宿主（Claude Code / Cursor / ZCode 等）：在开发者自己的 AI 编辑器里直接说「检查这份 HeroGrowth.xlsx 的数值曲线」，宿主 LLM 即可完成导入 → 查表 → 曲线审计的完整链路。