@forgeax/game 0.1.3 → 0.2.1

package/README.md

@@ -22,17 +22,22 @@ externalizes it from the Game bundle.
 
 ## Install
 
-Configure one client (this can run from any empty directory):
+### New client setup
+
+Run this once per machine to add the ForgeaX MCP server to the selected agent client.
+For ZCode:
 
 ```bash
-npx -y -p @forgeax/game forgeax-game install --ide codex
-npx -y -p @forgeax/game forgeax-game init --game snake
+npx -y -p @forgeax/game forgeax-game install --ide zcode
 ```
 
-Configure several clients:
+This writes ZCode's native user configuration to
+`~/.zcode/cli/config.json`. It can run from any directory.
+
+Configure several clients in one pass:
 
 ```bash
-npx -y -p @forgeax/game forgeax-game install --ide codex,claude,cursor
+npx -y -p @forgeax/game forgeax-game install --ide codex,claude,cursor,zcode
 ```
 
 Omitting `--ide` configures every supported client. User-scoped clients can be
@@ -49,6 +54,44 @@ store and completes a real `initialize` → `tools/list` → `resources/list` ha
 Existing config files are merged, and a changed file is backed up beside the original
 with the `.bak.latest` suffix.
 
+### Create a project
+
+Choose an empty directory and initialize a game there:
+
+```bash
+cd /path/to/empty-directory
+npx -y -p @forgeax/game forgeax-game init --game snake --ide zcode
+```
+
+`init` creates the ForgeaX project, installs the matching Engine SDK, and mounts the
+bundled Skills under `.zcode/skills` for ZCode. If `--ide` is omitted, it refreshes
+every client that already has a ForgeaX MCP entry.
+
+> [!IMPORTANT]
+> `init` does not install the user-level MCP entry. A new machine must run
+> `install --ide zcode` once before `init`. A user who already has the `forgeax`
+> entry configured in ZCode can run `init` directly for each new project.
+
+### Refresh an existing project
+
+For a project that was initialized previously, use `update` instead of running the
+same `init` again:
+
+```bash
+cd /path/to/existing-forgeax-project
+npx -y -p @forgeax/game forgeax-game update --ide zcode
+```
+
+If the project has no game-development Skills yet, use:
+
+```bash
+npx -y -p @forgeax/game forgeax-game devkit install
+```
+
+After installing or refreshing ZCode Skills, open the project as a ZCode workspace,
+refresh Settings → Skills, and start a new session. Check Settings → MCP Servers or
+run `/mcp status` to confirm `forgeax` is connected.
+
 For local package development or offline use, pin the currently running executable:
 
 ```bash
@@ -60,12 +103,12 @@ bun src/main.ts install --ide codex --local
 | Command | Purpose |
 |:--|:--|
 | `install [--ide a,b] [--local]` | Verify the MCP launch command, then merge client configuration |
-| `init [--game <slug>]` | Create a project/game, install routing rules, and materialize the bundled Engine SDK |
+| `init [--game <slug>] [--ide ...]` | Create a project/game, install routing rules, and materialize the bundled Engine SDK |
 | `use <slug>` | Activate an existing game through the server |
 | `doctor` | Check Node, project binding, service tiers, and client configuration |
 | `devkit install` | Install the game-development Skill and host rules; use `forgeax-install` only when available |
 | `agents update` | Insert or refresh only the managed ForgeaX block in `AGENTS.md` |
-| `upgrade` | Verify the published launch command, refresh installed client entries, and update project routing rules |
+| `update [--ide ...]` | Verify the published launch command, refresh installed client entries, and update project routing rules |
 
 `init` can create the minimal `.forgeax/` instance and game in an ordinary empty
 directory. It also installs `.forgeax/engine-sdk/`, containing declarations, API
@@ -122,6 +165,7 @@ is absent, inspect `source/<package>/src/` instead of guessing.
 | `codebuddy` / `workbuddy` | `~/.codebuddy/.mcp.json` | User |
 | `windsurf` | `~/.codeium/windsurf/mcp_config.json` | User |
 | `vscode` | `<project>/.vscode/mcp.json` | Project |
+| `zcode` | `~/.zcode/cli/config.json` | User |
 | `opencode` | `~/.config/opencode/opencode.json` | User |
 
 > [!NOTE]
@@ -133,6 +177,10 @@ is absent, inspect `source/<package>/src/` instead of guessing.
 > OpenCode 1.17.9: `opencode mcp list` starts this package and reports
 > `forgeax connected`. If a future client release changes the schema, `doctor`
 > will still report whether the configured entry matches what this package writes.
+>
+> ZCode uses its native `mcp.servers.<name>` user configuration rather than the
+> `.agents/mcp.json` fallback. Project Skills are installed under `.zcode/skills`;
+> start a new ZCode session and run `/mcp status` after installation.
 
 ## Game development Skill
 

package/dist/main.js

@@ -678,27 +678,17 @@ running, and running it.`;
 var PLUGIN_SKILL_ID = "forgeax-game";
 var ENGINE_SKILL_PREFIX = "forgeax-engine-";
 var DEVKIT_VERSION = 2;
-var HOST_SKILL_MOUNTS = {
-  codex: ".agents/skills",
-  claude: ".claude/skills",
-  cursor: ".cursor/skills",
-  trae: ".trae/skills",
-  codebuddy: ".codebuddy/skills",
-  workbuddy: ".codebuddy/skills",
-  windsurf: ".codeium/windsurf/skills",
-  vscode: ".vscode/skills",
-  opencode: ".config/opencode/skills"
-};
-var HOST_RULE_MOUNTS = {
-  codex: ".agents/rules",
-  claude: ".claude/rules",
-  cursor: ".cursor/rules",
-  trae: ".trae/rules",
-  codebuddy: ".codebuddy/rules",
-  workbuddy: ".codebuddy/rules",
-  windsurf: ".codeium/windsurf/rules",
-  vscode: ".vscode/rules",
-  opencode: ".config/opencode/rules"
+var HOST_MOUNTS = {
+  codex: { skills: ".agents/skills", rules: ".agents/rules" },
+  claude: { skills: ".claude/skills", rules: ".claude/rules" },
+  cursor: { skills: ".cursor/skills", rules: ".cursor/rules" },
+  trae: { skills: ".trae/skills", rules: ".trae/rules" },
+  codebuddy: { skills: ".codebuddy/skills", rules: ".codebuddy/rules" },
+  workbuddy: { skills: ".codebuddy/skills", rules: ".codebuddy/rules" },
+  windsurf: { skills: ".codeium/windsurf/skills", rules: ".codeium/windsurf/rules" },
+  vscode: { skills: ".vscode/skills", rules: ".vscode/rules" },
+  zcode: { skills: ".zcode/skills" },
+  opencode: { skills: ".config/opencode/skills", rules: ".config/opencode/rules" }
 };
 function skillRoots() {
   const here = dirname3(fileURLToPath(import.meta.url));
@@ -782,24 +772,27 @@ function writeTextIfChanged(path, content) {
   return true;
 }
 function selectedHostIds(clients) {
-  return [...new Set(clients.map((id) => id === "workbuddy" ? "codebuddy" : id))].filter((id) => HOST_SKILL_MOUNTS[id]);
+  return [...new Set(clients.map((id) => id === "workbuddy" ? "codebuddy" : id))].filter((id) => HOST_MOUNTS[id]);
 }
 function hostSkillDirs(projectRoot) {
-  return [...new Set(Object.values(HOST_SKILL_MOUNTS))].map((mount) => join3(projectRoot, mount));
+  return [...new Set(Object.values(HOST_MOUNTS).map((mount) => mount.skills))].map((mount) => join3(projectRoot, mount));
 }
 function installHostDevKit(projectRoot, clients, skills = bundledSkills()) {
   const skillPaths = [];
   const rulePaths = [];
   let changed = false;
   for (const id of selectedHostIds(clients)) {
-    const skillsDir = join3(projectRoot, HOST_SKILL_MOUNTS[id]);
+    const mount = HOST_MOUNTS[id];
+    const skillsDir = join3(projectRoot, mount.skills);
     for (const skill of skills) {
       changed = copySkill(skill.path, join3(skillsDir, skill.id)) || changed;
     }
-    const rulePath = join3(projectRoot, HOST_RULE_MOUNTS[id], `${PLUGIN_SKILL_ID}.md`);
-    changed = writeTextIfChanged(rulePath, ROUTING_TEXT) || changed;
     skillPaths.push(skillsDir);
-    rulePaths.push(rulePath);
+    if (mount.rules) {
+      const rulePath = join3(projectRoot, mount.rules, `${PLUGIN_SKILL_ID}.md`);
+      changed = writeTextIfChanged(rulePath, ROUTING_TEXT) || changed;
+      rulePaths.push(rulePath);
+    }
   }
   const skillIds = skills.map((skill) => skill.id);
   const noun = skillPaths.length === 1 ? "host" : "hosts";
@@ -888,7 +881,7 @@ function removeDevKit(projectRoot) {
   const owned = new Set(bundledSkills().map((skill) => skill.id));
   const removed = [];
   let skillCount = 0;
-  for (const mount of new Set(Object.values(HOST_SKILL_MOUNTS))) {
+  for (const mount of new Set(Object.values(HOST_MOUNTS).map((entry) => entry.skills))) {
     const dir = join3(projectRoot, mount);
     let entries;
     try {
@@ -906,7 +899,8 @@ function removeDevKit(projectRoot) {
     }
     removed.push(dir);
   }
-  for (const mount of new Set(Object.values(HOST_RULE_MOUNTS))) {
+  const ruleMounts = Object.values(HOST_MOUNTS).flatMap((entry) => entry.rules ? [entry.rules] : []);
+  for (const mount of new Set(ruleMounts)) {
     for (const suffix of [".md", ".md.bak.latest"]) {
       rmSync(join3(projectRoot, mount, `${PLUGIN_SKILL_ID}${suffix}`), { force: true });
     }
@@ -1788,6 +1782,16 @@ var CLIENTS = [
     commandShape: "split",
     postInstallNote: 'Open .vscode/mcp.json and click Start, or run "MCP: List Servers".'
   },
+  {
+    id: "zcode",
+    label: "ZCode",
+    format: "json",
+    scope: "user",
+    path: () => join7(HOME, ".zcode", "cli", "config.json"),
+    serverMapKey: ["mcp", "servers"],
+    commandShape: "split",
+    postInstallNote: "Start a new ZCode session, then run /mcp status to confirm the server is connected."
+  },
   {
     id: "opencode",
     label: "OpenCode",
@@ -2273,7 +2277,7 @@ import {
 var HELP = `ForgeaX game development plugin
 
 Usage:
-  forgeax-game install [--ide codex,claude,cursor,trae,opencode,workbuddy] [--local]
+  forgeax-game install [--ide ${CLIENT_CHOICES.join(",")}] [--local]
   forgeax-game uninstall [--ide ...] [--purge]
   forgeax-game init [--game <slug>] [--ide ...]
   forgeax-game use <slug>

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@forgeax/game",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "private": false,
   "type": "module",
-  "description": "@forgeax/game \u2014 ForgeaX game development as a plugin for MCP-capable agent CLIs (Codex, Claude Code, Cursor, Trae, OpenCode, WorkBuddy). Single binary, dual mode: no args = stdio MCP server, subcommand = CLI.",
+  "description": "@forgeax/game \u2014 ForgeaX game development as a plugin for MCP-capable agent CLIs (Codex, Claude Code, Cursor, Trae, ZCode, OpenCode, WorkBuddy). Single binary, dual mode: no args = stdio MCP server, subcommand = CLI.",
   "main": "./dist/main.js",
   "bin": {
     "forgeax-game": "dist/main.js"