wezard 0.3.3

package/dist/shared/cli-backends.js

@@ -0,0 +1,304 @@
+// CLI backend descriptors. Claude Code / claude-internal forks / CodeBuddy
+// all share the headless stream-json + hook protocol shape, but differ in:
+//   - binary name + config home (~/.claude vs ~/.claude-internal vs ~/.codebuddy)
+//   - on-disk project-dir encoding (Claude: leading `-`; CodeBuddy: none)
+//   - jsonl transcript schema (CodeBuddy splits tool_use / tool_result into
+//     independent top-level records; Claude Code nests them in message.content)
+//   - slash-command injection tag dialect: verified identical (<command-name> /
+//     <system-reminder>), so no tag-regex dispatch needed.
+//
+// normalizeTranscriptLine maps a backend's raw jsonl line into the Claude Code
+// TranscriptLine shape that mirror-bridge's renderLine consumes. Claude backends
+// are identity; codebuddy does the schema adapter work.
+import { join } from "node:path";
+import { expandHome } from "./paths.js";
+// Claude + claude-internal: `/` and `.` → `-`, yields a leading `-`
+// (e.g. /Users/zyy/foo → -Users-zyy-foo). Verified against ~/.claude/projects.
+const encodeClaude = (absCwd) => absCwd.replace(/[/.]/g, "-");
+// CodeBuddy: same char mapping but trims the leading separator first, so no
+// leading `-` (e.g. /Users/zyy/foo → Users-zyy-foo).
+const encodeCodebuddy = (absCwd) => absCwd.replace(/^[/]+/, "").replace(/[/.]/g, "-");
+// Module-level encoder, bound at daemon boot via bindCliBackends(). Defaults to
+// Claude's dialect so the daemon works out-of-the-box. This is the PRIMARY
+// backend's encoder — correct for *write* paths (where a new session's jsonl
+// will land). Read paths must go through projectDirsFor/backendForPath instead,
+// which consider every active backend.
+let _encodeProjectDir = encodeClaude;
+export const encodeProjectDir = (absCwd) => _encodeProjectDir(absCwd);
+const makeClaude = (name, bin) => {
+    const homeDir = name === "claude-internal" ? "~/.claude-internal" : "~/.claude";
+    return {
+        name,
+        bin,
+        homeDir,
+        projectsDir: `${homeDir}/projects`,
+        settingsPath: `${homeDir}/settings.json`,
+        projectDirEnv: "CLAUDE_PROJECT_DIR",
+        pluginRootEnv: "CLAUDE_PLUGIN_ROOT",
+        headlessStreamingArgs: ["--verbose"],
+        encodeProjectDir: encodeClaude,
+        // Claude Code jsonl is already in the TranscriptLine shape — identity pass.
+        normalizeTranscriptLine: (raw) => raw,
+    };
+};
+// CodeBuddy jsonl adapter. Verified schema (2026-07-24, GLM-5.2 session):
+//   message              → { type:"message", role:"user"|"assistant",
+//                            content:[{type:"input_text"|"output_text", text}],
+//                            id, parentId, status?, providerData:{agent,model,usage,...} }
+//   function_call        → { type:"function_call", callId, name, arguments(JSON string),
+//                            id(==host assistant msg id), parentId }
+//   function_call_result → { type:"function_call_result", callId, name, status,
+//                            output:{type:"text", text}, id, parentId }
+//   reasoning | file-history-snapshot | ai-title | summary → drop
+//
+// Key structural differences from Claude Code:
+//   1. content block types are input_text/output_text, not "text".
+//   2. tool_use / tool_result are independent top-level records, not nested in
+//      a message.content array. Adapter synthesizes assistant/user messages
+//      around them so renderLine sees the Claude shape.
+//   3. id/parentId → uuid/parentUuid.
+//   4. Subagents live in <sid>/subagents/agent-<id>.jsonl — NOT inlined into
+//      the main transcript — so no isSidechain filtering needed here.
+//   5. Slash-command tags (<command-name> / <system-reminder>) are identical
+//      to Claude Code — no tag-regex dialect dispatch needed.
+//   6. /goal marker shape on disk: UNVERIFIED (blocker). The non-isMeta
+//      fallback path in renderLine (goalStartOf on string content) should
+//      catch it if codebuddy uses the same marker text, but this needs
+//      confirmation from a real /goal session.
+const normalizeCodebuddy = (raw) => {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const r = raw;
+    const type = r.type;
+    const id = r.id;
+    const parentId = r.parentId;
+    const providerData = (r.providerData ?? {});
+    const uuids = { uuid: id, parentUuid: parentId ?? undefined };
+    if (type === "message") {
+        const role = r.role;
+        const content = r.content;
+        if (role === "user") {
+            // Join input_text blocks into a single string. renderLine's string path
+            // handles slash-command stripping, /goal marker detection, task-notification
+            // rendering, and the isOwnInject dedup — all driven by string content.
+            const text = (content ?? []).map((b) => b.text ?? "").join("");
+            return { type: "user", ...uuids, message: { role: "user", content: text } };
+        }
+        if (role === "assistant") {
+            const blocks = (content ?? []).map((b) => ({
+                type: "text",
+                text: b.text ?? "",
+            }));
+            const msg = {
+                role: "assistant",
+                content: blocks,
+                id: providerData.messageId,
+                model: providerData.model,
+                usage: providerData.usage,
+            };
+            // status:"completed" 只说明这条记录写完了 —— codebuddy 把中途叙述和最终答复
+            // 写成同形的独立 message, 映射成 stop_reason:"end_turn" 会让"中间说一句"就把
+            // 整个 turn 收掉 (后半轮全部退化成散装气泡)。改为软收口, 交给 mirror-bridge
+            // 用静默期确认。
+            const status = r.status;
+            return { type: "assistant", ...uuids, message: msg, softTurnEnd: status === "completed" };
+        }
+        return null;
+    }
+    if (type === "function_call") {
+        const callId = r.callId;
+        const name = r.name;
+        const argsRaw = r.arguments;
+        let input;
+        try {
+            input = argsRaw ? JSON.parse(argsRaw) : {};
+        }
+        catch {
+            input = {};
+        }
+        return {
+            type: "assistant",
+            ...uuids,
+            message: { role: "assistant", content: [{ type: "tool_use", id: callId, name, input }] },
+        };
+    }
+    if (type === "function_call_result") {
+        const callId = r.callId;
+        const output = r.output;
+        const text = output?.text ?? "";
+        return {
+            type: "user",
+            ...uuids,
+            message: { role: "user", content: [{ type: "tool_result", tool_use_id: callId, content: text }] },
+        };
+    }
+    // reasoning / file-history-snapshot / ai-title / summary → drop.
+    return null;
+};
+const makeCodebuddy = (bin) => ({
+    name: "codebuddy",
+    bin,
+    homeDir: "~/.codebuddy",
+    projectsDir: "~/.codebuddy/projects",
+    settingsPath: "~/.codebuddy/settings.json",
+    projectDirEnv: "CODEBUDDY_PROJECT_DIR",
+    pluginRootEnv: "CODEBUDDY_PLUGIN_ROOT",
+    // CodeBuddy: --verbose is a no-op for streaming; --include-partial-messages
+    // is what emits stream_event content_block_delta lines. Keep --verbose too
+    // for log parity — it's harmless and may surface diagnostics in debug mode.
+    headlessStreamingArgs: ["--verbose", "--include-partial-messages"],
+    encodeProjectDir: encodeCodebuddy,
+    normalizeTranscriptLine: normalizeCodebuddy,
+});
+// Built-in defaults. `bin` is the default executable name; users override via
+// `wrc.cliBackends.<name>.bin` in config.jsonc (or the legacy `wrc.claudeBin`
+// for the claude / claude-internal backends — see resolveCliBackend).
+export const CLI_BACKEND_DEFAULTS = {
+    claude: makeClaude("claude", "claude"),
+    "claude-internal": makeClaude("claude-internal", "claude-internal"),
+    codebuddy: makeCodebuddy("codebuddy"),
+};
+// Infer the default backend name from a legacy `claudeBin` basename. Only
+// recognizes the two known forks; unknown bins fall back to "claude" (with
+// the custom bin still preserved via the override path below).
+const inferDefaultFromClaudeBin = (bin) => {
+    const base = bin.split("/").pop() ?? bin;
+    if (base === "claude-internal")
+        return "claude-internal";
+    if (base === "codebuddy")
+        return "codebuddy";
+    return "claude";
+};
+/**
+ * Resolve the active backend, applying user overrides + legacy back-compat.
+ *
+ * Back-compat ladder (in priority order):
+ *   1. Explicit `cliBackends.<name>.bin` override wins.
+ *   2. `defaultCli` missing → infer from `claudeBin` basename (claude / claude-
+ *      internal / codebuddy), else "claude".
+ *   3. Legacy `claudeBin` set to a non-default value AND defaultCli points at
+ *      the matching backend → carry `claudeBin` as the bin override. Preserves
+ *      both `claudeBin: "/absolute/claude"` and `claudeBin: "claude-internal"`.
+ */
+export const resolveCliBackend = (cfg) => {
+    const name = cfg.defaultCli ?? inferDefaultFromClaudeBin(cfg.claudeBin ?? "claude");
+    const base = CLI_BACKEND_DEFAULTS[name];
+    if (!base)
+        throw new Error(`unknown CLI backend: ${name}`);
+    const explicit = cfg.cliBackends?.[name]?.bin;
+    if (explicit)
+        return { ...base, bin: explicit };
+    // Legacy `claudeBin` carries a non-default value → treat as bin override for
+    // the backend it points at (matched by name, not by basename equality —
+    // `/usr/local/bin/claude-internal` should still map to claude-internal).
+    if (cfg.claudeBin && cfg.claudeBin !== "claude") {
+        const inferred = inferDefaultFromClaudeBin(cfg.claudeBin);
+        if (inferred === name)
+            return { ...base, bin: cfg.claudeBin };
+    }
+    return base;
+};
+/**
+ * Bind the active backend's dialect (encodeProjectDir) into module-level state.
+ * Call once at daemon boot after loadConfig — flips mirror-bridge + spawn-tmux
+ * to the resolved backend's project-dir encoding. Idempotent; re-binding on
+ * daemon reload picks up a changed defaultCli without restart.
+ */
+export const bindCliBackend = (cfg) => {
+    const backend = resolveCliBackend(cfg);
+    _encodeProjectDir = backend.encodeProjectDir;
+    return backend;
+};
+// ── Multi-backend registry ──────────────────────────────────────────────
+//
+// The daemon mirrors sessions from EVERY installed CLI at once, not just the
+// primary one: a user can have `claude` in one tmux pane and `codebuddy` in
+// another, each bound to a different WeCom chat. Since a session's identity on
+// disk *is* its transcript path, the path is the discriminant — `backendForPath`
+// recovers which CLI wrote a jsonl, and every downstream decision (which binary
+// to `--resume` with, which jsonl schema to normalize, which project-dir
+// encoding to compare panes against) derives from that instead of a global.
+//
+// `primaryBackend()` remains the tie-breaker for *write* paths — spawning a new
+// session has no path to derive from, so it uses `defaultCli`.
+const backendWithBin = (name, cfg) => {
+    const base = CLI_BACKEND_DEFAULTS[name];
+    const explicit = cfg.cliBackends?.[name]?.bin;
+    return explicit ? { ...base, bin: explicit } : base;
+};
+let _backends = [CLI_BACKEND_DEFAULTS.claude];
+let _primary = CLI_BACKEND_DEFAULTS.claude;
+/** Active backends, primary first. Read-only snapshot of the last bind. */
+export const activeBackends = () => _backends;
+/** Backend used when there is no path to derive one from (new-session spawns). */
+export const primaryBackend = () => _primary;
+/**
+ * Resolve the primary backend and register every other known backend alongside
+ * it. Zero-config: install codebuddy and its sessions become mirrorable without
+ * touching config.jsonc.
+ *
+ * Deliberately does NOT probe for each root's existence. That probe ran once at
+ * boot, so a CLI first used *after* the daemon started stayed invisible until a
+ * reload — and it bought nothing: a nonexistent root never prefix-matches in
+ * backendForPath, and every read path (rankedJsonlsForCwd, findJsonlBySid,
+ * session-scan's roots) already tolerates a missing directory.
+ */
+export const bindCliBackends = (cfg) => {
+    const resolved = resolveCliBackend(cfg);
+    // An explicit `mirror.projectsDir` retargets the PRIMARY backend only — it is
+    // the pre-multi-CLI escape hatch for a nonstandard transcript root, and has no
+    // meaning for the other backends.
+    const override = (cfg.projectsDirOverride ?? "").trim();
+    const primary = override && override !== resolved.projectsDir ? { ...resolved, projectsDir: override } : resolved;
+    const secondaries = Object.keys(CLI_BACKEND_DEFAULTS)
+        .filter((n) => n !== primary.name)
+        .map((n) => backendWithBin(n, cfg));
+    _primary = primary;
+    _backends = [primary, ...secondaries];
+    _encodeProjectDir = primary.encodeProjectDir;
+    return { primary, backends: _backends };
+};
+/**
+ * Register a backend as active at runtime, returning the already-known
+ * descriptor if there is one. `bindCliBackends` only admits secondaries whose
+ * transcript root already exists — a CLI that is installed but has never run
+ * has none, so the FIRST session spawned with it would be invisible to
+ * `backendForPath` (mirrored with the primary's jsonl dialect, resumed with the
+ * primary's binary). Spawning with an explicit `cli` calls this so the registry
+ * learns the backend before its transcript appears on disk.
+ */
+export const activateBackend = (backend) => {
+    const known = _backends.find((b) => b.name === backend.name);
+    if (known)
+        return known;
+    _backends = [..._backends, backend];
+    return backend;
+};
+/**
+ * Recover the backend that owns an absolute transcript path, by longest
+ * projectsDir prefix match. Falls back to primary for paths outside every known
+ * root (custom `mirror.projectsDir`, or a jsonl handed in by `/wrc` from a
+ * location we don't manage) — treating an unknown transcript as the primary
+ * dialect is what the single-backend code already did.
+ */
+export const backendForPath = (absPath) => _backends
+    .map((b) => ({ b, root: expandHome(b.projectsDir) }))
+    .filter(({ root }) => absPath === root || absPath.startsWith(`${root}/`))
+    .sort((x, y) => y.root.length - x.root.length)[0]?.b ?? _primary;
+/**
+ * Every candidate `<projectsDir>/<encoded(cwd)>` across active backends, primary
+ * first. Callers filter by existence and rank by mtime — a cwd can legitimately
+ * have transcripts under two backends at once (same project, both CLIs used).
+ */
+export const projectDirsFor = (absCwd) => _backends.map((b) => ({ backend: b, dir: join(expandHome(b.projectsDir), b.encodeProjectDir(absCwd)) }));
+/**
+ * The project dir `cwd` would encode to *under the same backend that owns
+ * `refPath`*. Used for "is this pane still in the project dir its transcript
+ * lives in?" checks — comparing against the primary encoding would report a
+ * spurious drift for every non-primary session.
+ */
+export const projectDirFor = (refPath, absCwd) => {
+    const b = backendForPath(refPath);
+    return join(expandHome(b.projectsDir), b.encodeProjectDir(absCwd));
+};
+//# sourceMappingURL=cli-backends.js.map

package/dist/shared/cli-backends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-backends.js","sourceRoot":"","sources":["../../shared/cli-backends.ts"],"names":[],"mappings":"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"}

package/dist/shared/config-writer.js

@@ -0,0 +1,39 @@
+// Surgical edits to ~/.weclaude/config.jsonc and secrets.json — preserves
+// comments + formatting via jsonc-parser's `modify` patches.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { applyEdits, modify, parse as parseJsonc } from "jsonc-parser";
+import { expandHome } from "./paths.js";
+const FORMAT = { tabSize: 2, insertSpaces: true, eol: "\n" };
+const readText = (abs) => existsSync(abs) ? readFileSync(abs, "utf8") : "{}\n";
+const writeText = (abs, txt) => {
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, txt.endsWith("\n") ? txt : `${txt}\n`, "utf8");
+};
+/** Apply a sequence of (path, value) patches to a JSONC file. value=undefined deletes. */
+export const patchJsonc = (filePath, patches) => {
+    const abs = expandHome(filePath);
+    let txt = readText(abs);
+    for (const { path, value } of patches) {
+        const edits = modify(txt, path, value, { formattingOptions: FORMAT });
+        txt = applyEdits(txt, edits);
+    }
+    writeText(abs, txt);
+};
+/** Append `value` into a string array at `path`, deduped. No-op if already present. */
+export const appendUnique = (filePath, path, value) => {
+    const abs = expandHome(filePath);
+    const txt = readText(abs);
+    const tree = (parseJsonc(txt) ?? {});
+    const cur = path.reduce((acc, key) => {
+        if (acc && typeof acc === "object")
+            return acc[String(key)];
+        return undefined;
+    }, tree);
+    const arr = Array.isArray(cur) ? cur.slice() : [];
+    if (arr.includes(value))
+        return;
+    arr.push(value);
+    patchJsonc(filePath, [{ path, value: arr }]);
+};
+//# sourceMappingURL=config-writer.js.map

package/dist/shared/config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../shared/config-writer.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6DAA6D;AAC7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,UAAU,EAAiB,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAE7D,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CACvC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAEvD,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,GAAW,EAAQ,EAAE;IACnD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,OAAkD,EAC5C,EAAE;IACR,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACtB,CAAC,CAAC;AAEF,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,IAAc,EAAE,KAAa,EAAQ,EAAE;IACpF,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAU,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5C,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAQ,GAA+B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzF,OAAO,SAAS,CAAC;IACnB,CAAC,EAAE,IAAI,CAAC,CAAC;IACT,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO;IAChC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC"}

package/dist/shared/config.js

@@ -0,0 +1,278 @@
+// Declarative config: schema (zod) + loader. Pure transforms, file IO at boundary.
+import { readFileSync, existsSync } from "node:fs";
+import { parse as parseJsonc } from "jsonc-parser";
+import { z } from "zod";
+import { expandHome } from "./paths.js";
+import { resolveCliBackend } from "./cli-backends.js";
+// ── Schema ──────────────────────────────────────────────────────────
+const Bot = z.object({
+    botId: z.string().min(1),
+    secret: z.string().min(1),
+    websocketUrl: z.string().url().default("wss://openws.work.weixin.qq.com"),
+});
+const Daemon = z.object({
+    host: z.string().default("127.0.0.1"),
+    port: z.number().int().min(1).max(65535).default(17890),
+    stateDir: z.string().default("~/.weclaude/state"),
+    logFile: z.string().default("~/.weclaude/daemon.log"),
+    logLevel: z.enum(["trace", "debug", "info", "warn", "error"]).default("info"),
+    // 工具调用 / 授权详情页 URL。空则用 http://<host>:<port> (回环)。
+    // 想让手机 WeCom 也能点开, 需要在反向代理后填外网地址。桌面端用回环即可。
+    detailPublicBase: z.string().default(""),
+    // 远端 detail svr (weclaude svr 起的独立服务, chat + cli 共同可达的网络里)。
+    // 空则不转发, 详情走本机 :port/detail。非空时:
+    //   • 每次 record*() 后 fire-and-forget POST 到 <base>/d, 存到远端 store。
+    //   • buildDetailUrl 用 <base> 作为链接根 (chat 端浏览器打开 <base>/detail?id=...)。
+    // 用这条路径解决 daemon (公司内网) 和 chat 用户 (移动网络) 不同网段的场景。
+    detailRemoteBase: z.string().default(""),
+    detailRemoteToken: z.string().default(""),
+    // 镜像消息里给每个 tool_use 行包成 markdown 链接, 点开本地 HTML 详情页。
+    detailLinksInMirror: z.boolean().default(true),
+});
+const Mirror = z.object({
+    // Transcript root for the DEFAULT backend only — an escape hatch for a
+    // nonstandard location. Empty → auto-derived from `defaultCli` (`claude` →
+    // `~/.claude/projects`, `claude-internal` → `~/.claude-internal/projects`,
+    // `codebuddy` → `~/.codebuddy/projects`). Other installed backends always use
+    // their own built-in roots; the mirror probes all of them, so setting this
+    // does not narrow which CLIs can be mirrored.
+    projectsDir: z.string().default(""),
+    // Pin a specific Claude session to mirror. Empty → auto-pick latest .jsonl
+    // under `<projectsDir>/<encoded(wrc.cwd)>/` by mtime.
+    sessionId: z.string().default(""),
+    // Where to push live assistant output. Empty → fall back to defaultChat.
+    pushChat: z.string().default(""),
+    // Cap a single push payload (WeCom markdown ~2048 limit). Long replies are split.
+    chunkChars: z.number().int().positive().default(1800),
+    // Mirror the user's CLI prompts (type:"user" with string content). Off by
+    // default: WeCom-sourced inbounds get dedup'd anyway, and local CLI typing
+    // is rare in the bot-driven flow — keeping it on mostly produced echo noise.
+    includeUser: z.boolean().default(false),
+    // Mirror assistant tool_use blocks (Bash/Edit/Read/...).
+    includeTools: z.boolean().default(true),
+    // Mirror tool_result blocks. Off by default — usually noisy.
+    includeToolResults: z.boolean().default(false),
+    // Truncate each tool_result body to this many chars.
+    toolResultMaxChars: z.number().int().positive().default(400),
+    // 工具调用气泡里 `compact` 一行的最大字符数 (`🔧 Name <compact>` / `[• compact](url)`).
+    // 旧值 40 太窄, 长 bash / 长 file_path 直接被截掉; 抬到 120 兼顾可读与单行。
+    toolUseInlineMaxChars: z.number().int().positive().default(120),
+    // Where inbound images/files from WeCom get saved before being pasted into
+    // the live TTY. Files persist — claude reads them by absolute path.
+    inboxDir: z.string().default("~/.weclaude/inbox"),
+    // Persisted mirror attachments (principal → sessionId/jsonl/tmux). Restored
+    // on daemon boot + lazily on first inbound after reload — so reloading the
+    // daemon doesn't re-spawn a fresh claude for an already-bound chat.
+    attachmentsFile: z.string().default("~/.weclaude/mirror-attachments.json"),
+    // Standalone fallback 路径(liveStream 已 closed/dead/capped) 上的防抖聚合窗口
+    // (ms)。窗口内同一 attachment 的多个 item 合并为一条 markdown, 抑制连续工具
+    // 调用刷屏。liveStream 仍活时不受影响——直接走 typewriter。0 = 关闭。
+    standaloneDebounceMs: z.number().int().nonnegative().default(3000),
+    // dispatch 后延迟开 stream 的窗口 (ms)。窗口内 item 累积:
+    //   • 出现 needs-approval tool_use → 立刻把 buffer 聚合成单条 standalone 推出 (赶在
+    //     授权卡之前), 切到 AWAITING_APPR 等点击; 点击后再开 stream 续 tool_result+回复。
+    //   • 窗口内 turn_end (纯文本快回复) → buffer 整体作为一条 standalone, 不开 stream。
+    //   • 窗口超时 → 正常开 stream, 重放 buffer。
+    // 0 = 关闭, 退回到 dispatch 立即 ack "…" 的旧行为。
+    outboundDeferMs: z.number().int().nonnegative().default(3000),
+    // 发卡前等待目标 tool_use 在 jsonl 落盘的最长 poll 时间 (ms)。Claude Code 的
+    // assistant 行写盘相对 PreToolUse hook fire 有 tens-to-hundreds ms 异步抖动,
+    // 没等到的话 drain 抓空, 卡先到、思考过程后到。轮询步进 50ms。0 = 关闭等待,
+    // 仅做一次同步 drain (旧行为)。
+    flushBeforeCardWaitMs: z.number().int().nonnegative().default(800),
+    // 发卡前从活着的 tmux pane 抠出「为什么发这张卡」的 assistant 前言并先推一条。
+    // 必要性: Claude Code 把以 tool_use 收尾的整个 turn 攒着, 等工具 resolve 才 flush
+    // 到 jsonl —— 而工具正卡在这张授权卡上, 于是前言在发卡时点既不在 jsonl 也不在
+    // hook 的 transcript_tail 里, 唯一存在处是 pane。抠不到时静默退回「只发卡」(无回归)。
+    panePreamble: z.boolean().default(true),
+    // Brief 模式: 只对 mirror 模式生效。一个 turn 里群里只发两条 —
+    //   1. turn 起始时:「🧵 [本轮详情](url)」链接 (指向聚合详情页,含所有 tool 输入/输出+中间文本+折叠展示)
+    //   2. turn 结束时: Claude 的 finish text (最终 assistant 回复)
+    // 中间 tool_use / tool_result / thinking / 非 final text 全部只写进详情页,不发气泡。
+    // 授权卡照常发群 (交互无法替代)。false = 现状 (逐条气泡)。
+    brief: z.boolean().default(true),
+});
+const Wrc = z.object({
+    allowFrom: z.array(z.string()).default([]),
+    mode: z.enum(["headless", "mirror"]).default("headless"),
+    // Legacy pre-v0.3: single binary path. Still honored as a back-compat alias
+    // — resolveCliBackend picks it up when cliBackends.<name>.bin is unset. Kept
+    // on the schema so existing configs keep parsing without migration.
+    claudeBin: z.string().default("claude"),
+    // DEFAULT CLI backend — the one used when there is no transcript to derive a
+    // backend from (new-session spawns, headless mode). It is NOT exclusive: the
+    // daemon mirrors sessions from every installed CLI concurrently, resolving
+    // each attachment's binary + jsonl dialect from its own transcript path
+    // (shared/cli-backends.ts bindCliBackends / backendForPath). Optional —
+    // when unset, resolveCliBackend infers from claudeBin basename (so legacy
+    // `claudeBin: "claude-internal"` configs still resolve correctly without
+    // needing to also set defaultCli). The Wrc transform below pins the inferred
+    // name back into v.defaultCli so downstream readers see a concrete value.
+    defaultCli: z.enum(["claude", "claude-internal", "codebuddy"]).optional(),
+    // Per-backend bin overrides. Missing entry → built-in default (`claude`,
+    // `claude-internal`, `codebuddy`). Example:
+    //   cliBackends: { codebuddy: { bin: "/usr/local/bin/codebuddy" } }
+    cliBackends: z
+        .object({
+        claude: z.object({ bin: z.string().optional() }).optional(),
+        "claude-internal": z.object({ bin: z.string().optional() }).optional(),
+        codebuddy: z.object({ bin: z.string().optional() }).optional(),
+    })
+        .default({}),
+    cwd: z.string().default("~/.weclaude/workspace"),
+    sessionMapFile: z.string().default("~/.weclaude/sessions.json"),
+    extraArgs: z.array(z.string()).default([]),
+    mirror: Mirror.default({}),
+    // Mirror-only: tmux session name prefix for auto-spawn. Final name is
+    // `${prefix}-<short>`. Auto-spawn fires when an authorized inbound finds no
+    // mirror attached for that chat — allowFrom IS the authorization.
+    tmuxPrefix: z.string().default("weclaude"),
+}).transform((v) => {
+    // Resolve the active backend once — honors defaultCli if set, otherwise
+    // infers from claudeBin basename (legacy back-compat). Pin the inferred
+    // name back into v.defaultCli so downstream readers see a concrete value
+    // and so logs / sync labels can report the effective backend.
+    const backend = resolveCliBackend(v);
+    if (!v.defaultCli)
+        v.defaultCli = backend.name;
+    // Sync claudeBin to the resolved backend's bin so every daemon file that
+    // reads cfg.wrc.claudeBin (cc-bridge, mirror-bridge, spawn-tmux, quota)
+    // spawns the correct binary — even when the user set only `defaultCli`
+    // without an explicit `claudeBin`. Without this, defaultCli:"codebuddy"
+    // + inherited claudeBin:"claude" would spawn the wrong CLI.
+    v.claudeBin = backend.bin;
+    // Auto-derive projectsDir from the resolved backend when not explicitly
+    // set. Replaces the old claudeBin-basename derivation — same result for the
+    // standard cases (claude → ~/.claude/projects, claude-internal →
+    // ~/.claude-internal/projects), plus now supports codebuddy →
+    // ~/.codebuddy/projects. Explicit projectsDir still wins.
+    if (!v.mirror.projectsDir) {
+        v.mirror.projectsDir = backend.projectsDir;
+    }
+    return v;
+});
+const Approval = z.object({
+    enabled: z.boolean().default(true),
+    matcher: z.string().default(".*"),
+    approvers: z.array(z.string()).default([]),
+    hookTimeoutSec: z.number().int().positive().default(43210),
+    longPollSec: z.number().int().positive().default(43200),
+    sessionCacheMinutes: z.number().int().nonnegative().default(30),
+    windowMinutes: z.number().int().nonnegative().default(600),
+    sensitiveArgRedact: z.boolean().default(true),
+    fallbackOnError: z.enum(["ask", "allow", "deny"]).default("ask"),
+    // 同 session 同 tool 的并发 PreToolUse 合流窗口: 第一次到达后等待这么久,
+    // 期间到的同类请求合成一张批量卡 (减少 N 张并发卡的轰炸)。0 = 关闭聚合,
+    // 每次立刻发卡 (旧行为)。单次到达走单卡路径, 仅多了一次性的延迟。
+    batchCoalesceMs: z.number().int().nonnegative().default(250),
+    // 拦截 model 主动调用的 EnterPlanMode (deny + reason),让 Claude 不要自动进
+    // plan mode、直接干活。用户仍可在本地 Shift+Tab 手动进 plan mode(那条路径
+    // 不过 hook)。默认 true。设 false 恢复原行为(允许模型自动进 plan mode)。
+    blockAutoPlanMode: z.boolean().default(true),
+});
+// sync.targets[].kind 的合法值。claude-internal / custom 等旧值自动 collapse
+// 为 "claude" (preprocess) — settingsPath 已经表达了具体 fork, kind 只表达家族。
+const SYNC_KIND_LEGACY_TO_CLAUDE = new Set(["claude-internal", "custom"]);
+const normalizeSyncKind = (v) => typeof v === "string" && SYNC_KIND_LEGACY_TO_CLAUDE.has(v) ? "claude" : v;
+const SyncTarget = z.object({
+    // CLI 家族标签: "claude" (含 claude-internal 等 fork) 或 "codebuddy"。
+    // 仅用于 sync 日志; 真正决定写入位置的是 settingsPath。
+    kind: z.preprocess(normalizeSyncKind, z.enum(["claude", "codebuddy"])).default("claude"),
+    settingsPath: z.string(),
+    scope: z.enum(["user", "project", "local"]).default("user"),
+});
+const Sync = z.object({
+    targets: z.array(SyncTarget).default([]),
+});
+// 独立 detail 中转服务 (weclaude svr) 的默认参数。CLI 参数 (--host/--port/…) 仍可覆盖,
+// 空则退回硬编码默认 (0.0.0.0:17891)。放在 top-level 而不是塞进 daemon: svr 是独立进程,
+// 与 daemon 生命周期解耦。
+const Svr = z.object({
+    host: z.string().default("0.0.0.0"),
+    port: z.number().int().min(1).max(65535).default(17891),
+    stateDir: z.string().default("~/.weclaude/svr"),
+    tokenFile: z.string().default("~/.weclaude/svr-token"),
+    token: z.string().default(""),
+    logLevel: z.enum(["trace", "debug", "info", "warn", "error"]).default("info"),
+});
+// 事件订阅 / 广播。subs 是 topic → 目标id数组 (`user:xxx` / `chat:xxx`),
+// 一个 topic 可以有多个订阅者; schedules 是「每天 HH:MM 触发某 topic」的定时任务。
+// 订阅关系与定时通过 IM 命令 (订阅 / 每天HH:MM广播 …) 增删,写回 config.jsonc。
+const Schedule = z.object({
+    topic: z.string(),
+    hour: z.number().int().min(0).max(23),
+    minute: z.number().int().min(0).max(59),
+    content: z.string(),
+    createdBy: z.string().default(""),
+    createdAt: z.number().default(0),
+});
+const Topics = z.object({
+    subs: z.record(z.string(), z.array(z.string())).default({}),
+    schedules: z.array(Schedule).default([]),
+});
+export const ConfigSchema = z.object({
+    bot: Bot,
+    defaultChat: z.string().default(""),
+    daemon: Daemon.default({}),
+    wrc: Wrc.default({}),
+    approval: Approval.default({}),
+    sync: Sync.default({ targets: [] }),
+    svr: Svr.default({}),
+    topics: Topics.default({ subs: {}, schedules: [] }),
+});
+// ── Loader ──────────────────────────────────────────────────────────
+const DEFAULT_CONFIG_PATHS = [
+    "~/.weclaude/config.jsonc",
+    "~/.weclaude/config.json",
+];
+const SECRETS_PATH = "~/.weclaude/secrets.json";
+const readJsoncIfExists = (p) => {
+    const abs = expandHome(p);
+    if (!existsSync(abs))
+        return undefined;
+    const text = readFileSync(abs, "utf8");
+    return parseJsonc(text);
+};
+const deepMerge = (a, b) => {
+    const out = { ...a };
+    for (const [k, v] of Object.entries(b ?? {})) {
+        const av = out[k];
+        if (v && typeof v === "object" && !Array.isArray(v) && av && typeof av === "object" && !Array.isArray(av)) {
+            out[k] = deepMerge(av, v);
+        }
+        else if (v !== undefined && v !== "") {
+            out[k] = v;
+        }
+    }
+    return out;
+};
+/** Resolve config path: explicit > $WECLAUDE_CONFIG > defaults. */
+const resolveConfigPath = (explicit) => {
+    if (explicit)
+        return explicit;
+    if (process.env.WECLAUDE_CONFIG)
+        return process.env.WECLAUDE_CONFIG;
+    for (const p of DEFAULT_CONFIG_PATHS) {
+        if (existsSync(expandHome(p)))
+            return p;
+    }
+    return undefined;
+};
+export const loadConfig = (explicitPath) => {
+    const sourcePath = resolveConfigPath(explicitPath);
+    if (!sourcePath) {
+        throw new Error(`weclaude config not found. Create ~/.weclaude/config.jsonc (see config.example.jsonc) or set $WECLAUDE_CONFIG.`);
+    }
+    const base = (readJsoncIfExists(sourcePath) ?? {});
+    const secrets = (readJsoncIfExists(SECRETS_PATH) ?? {});
+    const merged = deepMerge(base, secrets);
+    const parsed = ConfigSchema.safeParse(merged);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((i) => `  - ${i.path.join(".") || "<root>"}: ${i.message}`)
+            .join("\n");
+        throw new Error(`weclaude config invalid (${sourcePath}):\n${issues}`);
+    }
+    return { config: parsed.data, sourcePath: expandHome(sourcePath) };
+};
+//# sourceMappingURL=config.js.map