teamai-cli 0.24.0-beta.2 → 0.24.0-beta.3

package/README.md

@@ -91,6 +91,7 @@ Once initialized, every AI session automatically pulls the latest skills / rules
     <tr><td>Hermes</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
     <tr><td>DeepSeek Harness</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
     <tr><td>Qoder</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>ZCode</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
   </tbody>
 </table>
 

package/README.zh-CN.md

@@ -91,6 +91,7 @@ teamai init https://github.com/yourorg/yourrepo --scope user
     <tr><td>Hermes</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
     <tr><td>DeepSeek Harness</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
     <tr><td>Qoder</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>ZCode</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
   </tbody>
 </table>
 

package/dist/index.js

@@ -868,6 +868,17 @@ var init_types = __esm({
           mcp: ".qoder/settings.json",
           mcpProject: ".qoder/settings.json"
         },
+        // ZCode: user-level config lives at ~/.zcode/cli/config.json (a shared file
+        // that also carries plugin state — reconcile must merge, never replace).
+        // Hooks are Claude-shaped but nested under `hooks.events` and gated by
+        // `hooks.enabled` (config-file hooks are disabled by default; the writer
+        // must force it on). Subagents deploy to ~/.zcode/agents/ as Claude-style
+        // Markdown (the CLI also reads <project>/.zcode/agents/ per workspace).
+        // User-scope MCP mirrors Claude's shape (`mcpServers` key) in
+        // ~/.agents/mcp.json; project scope writes `mcp.servers` inside
+        // .zcode/config.json (a different key), which the Claude writer cannot
+        // emit — so no mcpProject. ZCode has no user-level rules dir convention.
+        zcode: { skills: ".zcode/skills", agents: ".zcode/agents", settings: ".zcode/cli/config.json", mcp: ".agents/mcp.json" },
         codebuddy: { skills: ".codebuddy/skills", rules: ".codebuddy/rules", settings: ".codebuddy/settings.json", claudemd: ".codebuddy/CODEBUDDY.md", agents: ".codebuddy/agents", mcp: ".codebuddy/mcp.json", mcpProject: ".codebuddy/mcp.json" },
         openclaw: { skills: ".openclaw/skills", rules: ".openclaw/rules", claudemd: ".openclaw/workspace/AGENTS.md" },
         hermes: { skills: ".hermes/skills", claudemd: "AGENTS.md" },
@@ -1240,13 +1251,17 @@ function getDispatchCommand(event, tool, matcher, binPath) {
   const matcherArg = matcher && matcher !== "*" ? ` --matcher ${matcher}` : "";
   return `bash -lc "${bin} hook-dispatch ${event} --tool ${tool}${matcherArg} 2>/dev/null" || true`;
 }
+function getRawDispatchCommand(event, tool, matcher) {
+  const matcherArg = matcher && matcher !== "*" ? ` --matcher ${matcher}` : "";
+  return `teamai hook-dispatch ${event} --tool ${tool}${matcherArg}`;
+}
 function getWrapperDispatchCommand(event, tool, matcher) {
   const matcherArg = matcher && matcher !== "*" ? ` --matcher ${matcher}` : "";
   return `PATH="$HOME/${TEAMAI_BIN_DIR}:$PATH" teamai hook-dispatch ${event} --tool ${tool}${matcherArg} 2>/dev/null || true`;
 }
 function builtinHookDefs(tool) {
-  const withTimeout3 = tool === "cursor" || tool === "workbuddy" || tool === "codebuddy";
-  const buildCommand = WRAPPER_TOOLS.has(tool) ? getWrapperDispatchCommand : getDispatchCommand;
+  const withTimeout3 = tool === "cursor" || tool === "workbuddy" || tool === "codebuddy" || tool === "zcode";
+  const buildCommand = tool === "zcode" ? getRawDispatchCommand : WRAPPER_TOOLS.has(tool) ? getWrapperDispatchCommand : getDispatchCommand;
   return BUILTIN_HOOK_SPECS.map((spec) => ({
     source: "builtin",
     key: spec.key,
@@ -2186,6 +2201,7 @@ import path12 from "path";
 import { realpathSync } from "fs";
 function detectFormat(tool) {
   if (CODEX_TOOLS.has(tool)) return "codex";
+  if (ZCODE_TOOLS.has(tool)) return "zcode";
   return CURSOR_TOOLS.has(tool) ? "cursor" : "claude";
 }
 function isCodexTrustGatedTool(tool) {
@@ -2273,6 +2289,27 @@ function toCodexEntry(def) {
   if (def.matcher && def.matcher !== "*") entry.matcher = def.matcher;
   return entry;
 }
+function toZcodeEntry(def) {
+  const entry = {
+    type: "process",
+    command: "bash",
+    // Stored verbatim: the shell payload must equal `def.command` exactly so
+    // managed-entry detection and the managed-hooks manifest share one command
+    // representation (the same invariant the Codex format keeps). teamai
+    // hook-dispatch is silent and failure-tolerant on its success paths, so no
+    // shell redirection is layered on top of the payload.
+    args: ["-lc", def.command],
+    ...def.timeout !== void 0 ? { timeoutMs: def.timeout * 1e3 } : {}
+  };
+  const group = { hooks: [entry] };
+  if (def.matcher && def.matcher !== "*") group.matcher = def.matcher;
+  return group;
+}
+function zcodeEntryCommand(entry) {
+  const hook = entry.hooks?.[0];
+  if (hook?.command === "bash" && hook.args?.[0] === "-lc") return hook.args[1] ?? "";
+  return hook?.command ?? "";
+}
 function desiredEventOrder(defs, mapEvent) {
   const seen = /* @__PURE__ */ new Set();
   const order = [];
@@ -2412,6 +2449,42 @@ async function reconcileCodexFormat(hooksPath, tool, teamDefs, opts, priorTeamCo
     log.debug(`teamai hooks already up-to-date in ${hooksPath}`);
   }
 }
+async function reconcileZcodeFormat(settingsPath, tool, teamDefs, opts, priorTeamCommands) {
+  const expanded = expandHome(settingsPath);
+  await ensureDir(path12.dirname(expanded));
+  const cfg = await readJson(expanded) ?? {};
+  if (!cfg.hooks) cfg.hooks = {};
+  let changed = false;
+  if (!opts.removeAll && cfg.hooks.enabled !== true) {
+    cfg.hooks.enabled = true;
+    changed = true;
+  }
+  if (!cfg.hooks.events) cfg.hooks.events = {};
+  const isManaged = (entry) => {
+    const cmd = zcodeEntryCommand(entry);
+    return TEAMAI_COMMAND_MARKERS.some((marker) => cmd.includes(marker)) || priorTeamCommands.has(cmd);
+  };
+  const defs = opts.removeAll ? [] : desiredDefs(tool, teamDefs, opts.builtinOverride);
+  const eventOrder = desiredEventOrder(defs, (e) => e);
+  const eventsMap = cfg.hooks.events;
+  const events = [...eventOrder, ...Object.keys(eventsMap).filter((e) => !eventOrder.includes(e))];
+  for (const event of events) {
+    const existing = eventsMap[event] ?? [];
+    const untouched = existing.filter((e) => !isManaged(e));
+    const desiredEntries = defs.filter((d) => d.event === event).map(toZcodeEntry);
+    const newArr = [...untouched, ...desiredEntries];
+    if (JSON.stringify(existing) !== JSON.stringify(newArr)) {
+      eventsMap[event] = newArr;
+      changed = true;
+    }
+  }
+  if (changed) {
+    await writeJson(expanded, cfg);
+    log.success(`${opts.removeAll ? "Removed" : "Updated"} teamai hooks in ${settingsPath}`);
+  } else {
+    log.debug(`teamai hooks already up-to-date in ${settingsPath}`);
+  }
+}
 function isAgentHookSupportedTool(tool) {
   return !CURSOR_TOOLS.has(tool);
 }
@@ -2529,6 +2602,8 @@ async function reconcileHooks(settingsPath, tool, teamDefs = [], opts = {}) {
     await reconcileCursorFormat(settingsPath, tool, scopedDefs, opts, priorTeamCommands);
   } else if (format === "codex") {
     await reconcileCodexFormat(settingsPath, tool, scopedDefs, opts, priorTeamCommands);
+  } else if (format === "zcode") {
+    await reconcileZcodeFormat(settingsPath, tool, scopedDefs, opts, priorTeamCommands);
   } else {
     await reconcileClaudeFormat(settingsPath, tool, scopedDefs, {
       ...opts,
@@ -2588,6 +2663,18 @@ async function getHookStatus(settingsPath, tool) {
     });
     return present2 ? "installed" : "missing";
   }
+  if (format === "zcode") {
+    const cfg = await readJson(expanded);
+    const eventsMap = cfg?.hooks?.events;
+    if (!eventsMap) return "missing";
+    const present2 = defs.every((def) => {
+      const want = toZcodeEntry(def);
+      const wantCmd = zcodeEntryCommand(want);
+      const entries = eventsMap[def.event] ?? [];
+      return entries.some((e) => e.matcher === want.matcher && zcodeEntryCommand(e) === wantCmd);
+    });
+    return present2 ? "installed" : "missing";
+  }
   const settings = await readJson(expanded);
   if (!settings?.hooks) return "missing";
   const present = defs.every((def) => {
@@ -2619,6 +2706,17 @@ async function hasTeamaiHooks(settingsPath, tool, manifestPath) {
       })
     );
   }
+  if (format === "zcode") {
+    const j = await readJson(expanded);
+    const eventsMap = j?.hooks?.events;
+    if (!eventsMap) return false;
+    return Object.values(eventsMap).some(
+      (entries) => (entries ?? []).some((e) => {
+        const cmd = zcodeEntryCommand(e);
+        return TEAMAI_COMMAND_MARKERS.some((m) => cmd.includes(m)) || priorTeamCommands.has(cmd);
+      })
+    );
+  }
   const s = await readJson(expanded);
   if (!s?.hooks) return false;
   return Object.values(s.hooks).some(
@@ -2792,7 +2890,7 @@ async function reconcileTeamHooksForConfig(teamConfig, localConfig, opts = {}) {
   await sweepLegacyProjectHooks(teamConfig.toolPaths, localConfig);
   return teamDefs;
 }
-var OPENCLAW_TOOLS, TEAMAI_HOOK_SUBCOMMANDS, TEAMAI_LEGACY_HOOK_SUBCOMMANDS, CLAUDE_TO_CURSOR_EVENTS, CURSOR_TOOLS, CODEX_TOOLS, CODEX_TRUST_GATE_TOOLS, TEAMAI_COMMAND_MARKERS, AGENT_HOOK_EVENTS;
+var OPENCLAW_TOOLS, TEAMAI_HOOK_SUBCOMMANDS, TEAMAI_LEGACY_HOOK_SUBCOMMANDS, CLAUDE_TO_CURSOR_EVENTS, CURSOR_TOOLS, CODEX_TOOLS, ZCODE_TOOLS, CODEX_TRUST_GATE_TOOLS, TEAMAI_COMMAND_MARKERS, AGENT_HOOK_EVENTS;
 var init_hooks2 = __esm({
   "src/hooks.ts"() {
     "use strict";
@@ -2814,6 +2912,7 @@ var init_hooks2 = __esm({
     };
     CURSOR_TOOLS = /* @__PURE__ */ new Set(["cursor"]);
     CODEX_TOOLS = /* @__PURE__ */ new Set(["codex", "codex-internal", "tcodex"]);
+    ZCODE_TOOLS = /* @__PURE__ */ new Set(["zcode"]);
     CODEX_TRUST_GATE_TOOLS = /* @__PURE__ */ new Set(["codex"]);
     TEAMAI_COMMAND_MARKERS = [
       "teamai pull",
@@ -7769,7 +7868,7 @@ var CLAUDE_TOOLS, CURSOR_TOOLS2, CODEX_TOOLS2, BUDDY_TOOLS, OPENCODE_TOOLS, MCP_
 var init_mcp_format = __esm({
   "src/resources/mcp-format.ts"() {
     "use strict";
-    CLAUDE_TOOLS = /* @__PURE__ */ new Set(["claude", "claude-internal", "tclaude", "qoder"]);
+    CLAUDE_TOOLS = /* @__PURE__ */ new Set(["claude", "claude-internal", "tclaude", "qoder", "zcode"]);
     CURSOR_TOOLS2 = /* @__PURE__ */ new Set(["cursor"]);
     CODEX_TOOLS2 = /* @__PURE__ */ new Set(["codex", "codex-internal", "tcodex"]);
     BUDDY_TOOLS = /* @__PURE__ */ new Set(["codebuddy", "workbuddy"]);
@@ -12720,6 +12819,8 @@ function renderForTool(spec, tool) {
       return renderForJoycode(spec);
     case "qoder":
       return renderForClaude(spec);
+    case "zcode":
+      return renderForClaude(spec);
     case "opencode":
       return renderForOpencode(spec);
   }
@@ -12739,6 +12840,7 @@ var init_agent_format = __esm({
       "cursor",
       "joycode",
       "qoder",
+      "zcode",
       "opencode"
     ];
     COMMON_CLAUDE_FIELDS = /* @__PURE__ */ new Set(["name", "description", "model", "tools"]);
@@ -12942,6 +13044,8 @@ function reverseByTool(tool, filePath, content) {
       return reverseFromJoycode(filePath, content);
     case "qoder":
       return reverseFromClaude(filePath, content);
+    case "zcode":
+      return reverseFromClaude(filePath, content);
     case "opencode":
       return reverseFromOpencode(filePath, content);
   }
@@ -14645,6 +14749,7 @@ var init_known_agents = __esm({
       { id: "trae", displayName: "Trae", category: "coding", skillsPath: ".trae/skills" },
       { id: "trae-cn", displayName: "Trae CN", category: "coding", skillsPath: ".trae-cn/skills" },
       { id: "windsurf", displayName: "Windsurf", category: "coding", skillsPath: ".windsurf/skills" },
+      { id: "zcode", displayName: "ZCode", category: "coding", skillsPath: ".zcode/skills" },
       // Lobster family
       { id: "openclaw", displayName: "OpenClaw", category: "lobster", skillsPath: ".openclaw/skills" },
       { id: "qclaw", displayName: "QClaw", category: "lobster", skillsPath: ".qclaw/skills" },
@@ -21162,6 +21267,7 @@ async function resolveTargets(teamConfig, localConfig) {
   for (const [tool, paths] of Object.entries(scopedToolPaths(teamConfig, localConfig))) {
     if (disabled.has(tool)) continue;
     if (whitelist && !whitelist.includes(tool)) continue;
+    if (tool === "zcode") continue;
     const family = familyOf(tool);
     const probe = paths.settings ?? paths.skills ?? paths.agents;
     if (!probe) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamai-cli",
-  "version": "0.24.0-beta.2",
+  "version": "0.24.0-beta.3",
   "description": "TeamAI — Make Every Team AI Native (skill sync + shared knowledge base, powered by Git)",
   "type": "module",
   "bin": {