@zentao-hub/cli 0.1.0

package/dist/commands/init.d.ts

@@ -0,0 +1,9 @@
+interface Options {
+    workspace?: string;
+    profile?: string;
+    credentials?: string;
+    force?: boolean;
+    migrateLegacy?: boolean;
+}
+export declare function init(opts: Options): Promise<void>;
+export {};

package/dist/commands/init.js

@@ -0,0 +1,94 @@
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { TEMPLATES_DIR, resolveWorkspace, resolveHubRoot } from "../paths.js";
+import { DEFAULT_PROFILE_NAME, resolveCredentialsPath, resolveProfileName, } from "@zentao-hub/sdk";
+import { CliError, copyFile, info, warn } from "../util.js";
+export async function init(opts) {
+    const credsPath = resolveCredentialsPath(opts.credentials);
+    const profile = await resolveProfileName(opts.profile, credsPath);
+    const workspace = resolveWorkspace(profile, opts.workspace);
+    const root = resolveHubRoot();
+    await maybeMigrateLegacy({
+        root,
+        workspace,
+        profile,
+        explicitWorkspace: opts.workspace,
+        migrate: opts.migrateLegacy ?? false,
+    });
+    info(`Initializing workspace at ${workspace} (profile '${profile}')`);
+    await fs.mkdir(path.join(workspace, "bugs"), { recursive: true });
+    info(`  ok    bugs/`);
+    const example = path.join(TEMPLATES_DIR, "repos.yaml.example");
+    const exampleOut = path.join(workspace, "repos.yaml.example");
+    await copyFile(example, exampleOut, { overwrite: true });
+    info(`  ok    repos.yaml.example`);
+    const registry = path.join(workspace, "repos.yaml");
+    if (!existsSync(registry) || opts.force) {
+        await fs.writeFile(registry, "products: {}\n", "utf8");
+        info(`  ok    repos.yaml`);
+    }
+    else {
+        info(`  skip  repos.yaml (exists; pass --force to overwrite)`);
+    }
+    info(``);
+    info(`Tip: export ZENTAO_HUB=${root}`);
+    info(`     (the CLI / slash commands append the active profile to that root.)`);
+}
+async function maybeMigrateLegacy(opts) {
+    // When the user passes --workspace explicitly they have chosen an exact
+    // directory; skip the legacy detection so we don't surprise them.
+    if (opts.explicitWorkspace)
+        return;
+    const legacyBugs = path.join(opts.root, "bugs");
+    const legacyRegistry = path.join(opts.root, "repos.yaml");
+    const legacyExample = path.join(opts.root, "repos.yaml.example");
+    const hasLegacy = existsSync(legacyBugs) || existsSync(legacyRegistry);
+    if (!hasLegacy)
+        return;
+    if (!opts.migrate) {
+        warn(`Detected legacy layout at ${opts.root} (bugs/ or repos.yaml at the root).`);
+        warn(`Workspaces are now per-profile: ${opts.workspace}`);
+        warn(`Re-run with --migrate-legacy to move the legacy files into the '${opts.profile}' profile, or pass --workspace ${opts.root} to keep using the flat layout for this profile.`);
+        return;
+    }
+    if (opts.profile !== DEFAULT_PROFILE_NAME) {
+        throw new CliError(`--migrate-legacy only makes sense for the default profile; got '${opts.profile}'. The legacy flat layout never had a notion of profiles.`);
+    }
+    await fs.mkdir(opts.workspace, { recursive: true });
+    for (const [src, name] of [
+        [legacyBugs, "bugs/"],
+        [legacyRegistry, "repos.yaml"],
+        [legacyExample, "repos.yaml.example"],
+    ]) {
+        if (!existsSync(src))
+            continue;
+        const dest = path.join(opts.workspace, name.replace(/\/$/, ""));
+        if (existsSync(dest)) {
+            // A prior no-flag init may have left an empty placeholder here;
+            // overwrite it so the migration still works on a second pass.
+            const overridable = await isEmptyPlaceholder(dest);
+            if (!overridable) {
+                warn(`  skip  ${name} (already exists at ${dest} with content)`);
+                continue;
+            }
+            await fs.rm(dest, { recursive: true, force: true });
+        }
+        await fs.rename(src, dest);
+        info(`  move  ${src} → ${dest}`);
+    }
+}
+async function isEmptyPlaceholder(p) {
+    const stat = await fs.stat(p);
+    if (stat.isDirectory()) {
+        const entries = await fs.readdir(p);
+        return entries.length === 0;
+    }
+    if (stat.isFile()) {
+        const text = (await fs.readFile(p, "utf8")).trim();
+        // Empty file, or the default registry skeleton written by init.
+        return text === "" || text === "products: {}";
+    }
+    return false;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/install-claude-md.d.ts

@@ -0,0 +1,12 @@
+interface Options {
+    agent?: string;
+    repo?: string;
+    force?: boolean;
+}
+/**
+ * Install the AI-collaboration instructions file for the chosen agent.
+ * The template is the same regardless of agent — only the destination
+ * filename differs (CLAUDE.md / AGENTS.md / .github/copilot-instructions.md).
+ */
+export declare function installClaudeMd(opts: Options): Promise<void>;
+export {};

package/dist/commands/install-claude-md.js

@@ -0,0 +1,25 @@
+import path from "node:path";
+import { describeAgent, resolveAgent, resolveAgentInstructionsFile, } from "../agents.js";
+import { TEMPLATES_DIR } from "../paths.js";
+import { copyFile, info } from "../util.js";
+/**
+ * Install the AI-collaboration instructions file for the chosen agent.
+ * The template is the same regardless of agent — only the destination
+ * filename differs (CLAUDE.md / AGENTS.md / .github/copilot-instructions.md).
+ */
+export async function installClaudeMd(opts) {
+    const agent = await resolveAgent(opts.agent);
+    const repo = path.resolve(opts.repo ?? process.cwd());
+    const { abs: dest, rel } = resolveAgentInstructionsFile(agent, repo);
+    const src = path.join(TEMPLATES_DIR, "CLAUDE.md");
+    info(`Installing ${describeAgent(agent)} instructions to ${dest}`);
+    const result = await copyFile(src, dest, { overwrite: opts.force });
+    if (result === "skipped") {
+        info(`  skip  ${rel} (exists; pass --force to overwrite)`);
+    }
+    else {
+        info(`  ok    ${rel}`);
+        info(`  Remember to fill in the "Test commands" and "Code style" sections.`);
+    }
+}
+//# sourceMappingURL=install-claude-md.js.map

package/dist/commands/install-claude-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-claude-md.js","sourceRoot":"","sources":["../../src/commands/install-claude-md.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQ5C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAa;IACjD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,4BAA4B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,cAAc,aAAa,CAAC,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,sCAAsC,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,sEAAsE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/dist/commands/install-commands.d.ts

@@ -0,0 +1,8 @@
+interface Options {
+    agent?: string;
+    dest?: string;
+    repo?: string;
+    force?: boolean;
+}
+export declare function installCommands(opts: Options): Promise<void>;
+export {};

package/dist/commands/install-commands.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+import { describeAgent, resolveAgent, resolveAgentPromptsDir, } from "../agents.js";
+import { TEMPLATES_DIR } from "../paths.js";
+import { copyFile, info } from "../util.js";
+const FILES = ["fix-bug.md", "bug-analyze.md"];
+export async function installCommands(opts) {
+    const agent = await resolveAgent(opts.agent);
+    const { dir: dest, suffix, scope } = resolveAgentPromptsDir(agent, {
+        explicit: opts.dest,
+        repo: opts.repo,
+    });
+    info(`Installing slash commands for ${describeAgent(agent)} (${scope}-scope) → ${dest}`);
+    for (const name of FILES) {
+        const src = path.join(TEMPLATES_DIR, ".claude", "commands", name);
+        const outName = suffix === ".md" ? name : name.replace(/\.md$/, suffix);
+        const out = path.join(dest, outName);
+        const result = await copyFile(src, out, { overwrite: opts.force });
+        if (result === "skipped") {
+            info(`  skip  ${outName} (exists; pass --force to overwrite)`);
+        }
+        else {
+            info(`  ok    ${outName}`);
+        }
+    }
+    info(`Done. Tip: export ZENTAO_HUB=<path> so the commands know where to drop bug context (default: ~/.zentao-hub).`);
+}
+//# sourceMappingURL=install-commands.js.map

package/dist/commands/install-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-commands.js","sourceRoot":"","sources":["../../src/commands/install-commands.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAS5C,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAU,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAa;IACjD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,sBAAsB,CAAC,KAAK,EAAE;QACjE,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;IACH,IAAI,CACF,iCAAiC,aAAa,CAAC,KAAK,CAAC,KAAK,KAAK,aAAa,IAAI,EAAE,CACnF,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,OAAO,sCAAsC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,IAAI,CAAC,8GAA8G,CAAC,CAAC;AACvH,CAAC"}

package/dist/commands/install-hooks.d.ts

@@ -0,0 +1,7 @@
+interface Options {
+    repo?: string;
+    force?: boolean;
+    setHooksPath?: boolean;
+}
+export declare function installHooks(opts: Options): Promise<void>;
+export {};

package/dist/commands/install-hooks.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+import { TEMPLATES_DIR } from "../paths.js";
+import { CliError, copyFile, ensureExecutable, git, info, isGitRepo } from "../util.js";
+export async function installHooks(opts) {
+    const repo = path.resolve(opts.repo ?? process.cwd());
+    if (!isGitRepo(repo)) {
+        throw new CliError(`${repo} is not a git repository`);
+    }
+    const srcHook = path.join(TEMPLATES_DIR, ".githooks", "commit-msg");
+    const destHook = path.join(repo, ".githooks", "commit-msg");
+    info(`Installing commit-msg hook to ${destHook}`);
+    const result = await copyFile(srcHook, destHook, { overwrite: opts.force });
+    if (result === "skipped") {
+        info(`  skip  commit-msg (exists; pass --force to overwrite)`);
+    }
+    else {
+        info(`  ok    commit-msg`);
+    }
+    await ensureExecutable(destHook);
+    if (opts.setHooksPath !== false) {
+        const r = git(repo, ["config", "core.hooksPath", ".githooks"]);
+        if (r.status === 0) {
+            info(`  ok    git config core.hooksPath .githooks`);
+        }
+        else {
+            throw new CliError(`failed to set core.hooksPath: ${r.stderr.trim() || r.stdout.trim()}`);
+        }
+    }
+    info(`Done. Verify: echo "fix: test 🤖 generated with claude" | .githooks/commit-msg /dev/stdin`);
+}
+//# sourceMappingURL=install-hooks.js.map

package/dist/commands/install-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hooks.js","sourceRoot":"","sources":["../../src/commands/install-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQxF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAa;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,0BAA0B,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC5D,IAAI,CAAC,iCAAiC,QAAQ,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEjC,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,6CAA6C,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,QAAQ,CAAC,iCAAiC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,IAAI,CAAC,2FAA2F,CAAC,CAAC;AACpG,CAAC"}

package/dist/commands/install-mcp.d.ts

@@ -0,0 +1,20 @@
+interface Options {
+    agent?: string;
+    /** "user" (default) or "workspace". */
+    scope?: string;
+    /** Repo root for workspace scope. */
+    repo?: string;
+    /** MCP server name to register under (default "zentao-hub"). */
+    name?: string;
+    /** Override the command used to spawn the server (default "zentao-hub-mcp"). */
+    command?: string;
+    /** Bind a specific credentials profile. Defaults to the active default. */
+    profile?: string;
+    /** Skip ZENTAO_PROFILE env binding (server will fall back to file default). */
+    noProfile?: boolean;
+    /** Force overwrite an existing entry with the same name. */
+    force?: boolean;
+    credentials?: string;
+}
+export declare function installMcp(opts: Options): Promise<void>;
+export {};

package/dist/commands/install-mcp.js

@@ -0,0 +1,203 @@
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { describeAgent, resolveAgent, resolveMcpTarget, } from "../agents.js";
+import { DEFAULT_PROFILE_NAME, readStore, resolveCredentialsPath, } from "@zentao-hub/sdk";
+import { CliError, info, warn } from "../util.js";
+const DEFAULT_SERVER_NAME = "zentao-hub";
+const DEFAULT_COMMAND = "zentao-hub-mcp";
+export async function installMcp(opts) {
+    const agent = await resolveAgent(opts.agent);
+    const scope = parseScope(opts.scope);
+    const target = resolveMcpTarget(agent, { scope, repo: opts.repo });
+    // Default ZENTAO_PROFILE to the active profile, but only when the store is
+    // available — otherwise the user clearly intends to wire env vars manually.
+    const profile = await resolveProfile(opts);
+    const serverName = (opts.name ?? DEFAULT_SERVER_NAME).trim();
+    if (!serverName)
+        throw new CliError("--name must not be empty");
+    const command = (opts.command ?? DEFAULT_COMMAND).trim();
+    if (!command)
+        throw new CliError("--command must not be empty");
+    const env = {};
+    if (profile && !opts.noProfile) {
+        env.ZENTAO_PROFILE = profile;
+    }
+    info(`Configuring MCP server '${serverName}' for ${describeAgent(agent)}`);
+    info(`  target  ${target.path}`);
+    info(`  format  ${target.format}${target.scope === "workspace" ? " (workspace)" : " (user)"}`);
+    await ensureParentDir(target.path);
+    if (target.format === "json") {
+        await writeJsonMcp(target, serverName, command, env, !!opts.force);
+    }
+    else {
+        await writeTomlMcp(target, serverName, command, env, !!opts.force);
+    }
+    info(`  ok    server '${serverName}' written`);
+    if (!profile && !opts.noProfile) {
+        warn(`no credentials file found — wrote MCP entry without ZENTAO_PROFILE. ` +
+            `Run 'zentao-hub login' first, or set ZENTAO_URL/USERNAME/PASSWORD manually.`);
+    }
+    printHints(agent, target, serverName);
+}
+function parseScope(raw) {
+    if (!raw)
+        return "user";
+    const v = raw.toLowerCase();
+    if (v === "user" || v === "workspace" || v === "project") {
+        return v === "project" ? "workspace" : v;
+    }
+    throw new CliError(`--scope must be 'user' or 'workspace', got '${raw}'`);
+}
+async function resolveProfile(opts) {
+    if (opts.profile)
+        return opts.profile;
+    if (opts.noProfile)
+        return undefined;
+    const credsPath = resolveCredentialsPath(opts.credentials);
+    const store = await readStore(credsPath).catch(() => undefined);
+    if (!store)
+        return undefined;
+    return store.default ?? DEFAULT_PROFILE_NAME;
+}
+async function ensureParentDir(filePath) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+}
+async function writeJsonMcp(target, name, command, env, force) {
+    const key = target.jsonKey ?? "mcpServers";
+    const existing = await readJsonObject(target.path);
+    const map = existing[key] ?? {};
+    if (map[name] && !force) {
+        throw new CliError(`Server '${name}' is already configured in ${target.path}. ` +
+            `Pass --force to overwrite, or --name <other> to add a second entry.`);
+    }
+    // Copilot uses { type: "stdio", command, args, env }. Claude omits "type"
+    // and only requires command/args/env. Both accept the Copilot shape, but
+    // including a stray "type" breaks Claude — so we branch.
+    const entry = key === "servers"
+        ? { type: "stdio", command, args: [], env }
+        : { command, args: [], env };
+    if (Object.keys(env).length === 0) {
+        delete entry.env;
+    }
+    map[name] = entry;
+    existing[key] = map;
+    await fs.writeFile(target.path, JSON.stringify(existing, null, 2) + "\n", "utf8");
+}
+async function readJsonObject(filePath) {
+    if (!existsSync(filePath))
+        return {};
+    const text = await fs.readFile(filePath, "utf8");
+    const trimmed = text.trim();
+    if (!trimmed)
+        return {};
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch (err) {
+        throw new CliError(`Failed to parse ${filePath} as JSON: ${err.message}. ` +
+            `Fix the file by hand or remove it and re-run.`);
+    }
+    throw new CliError(`${filePath} does not contain a JSON object at the top level`);
+}
+async function writeTomlMcp(target, name, command, env, force) {
+    const prefix = target.tomlSectionPrefix ?? "mcp_servers";
+    const header = `[${prefix}.${name}]`;
+    const existing = existsSync(target.path) ? await fs.readFile(target.path, "utf8") : "";
+    if (sectionExists(existing, header) && !force) {
+        throw new CliError(`Section '${header}' already exists in ${target.path}. ` +
+            `Pass --force to overwrite, or --name <other> to add a second entry.`);
+    }
+    const block = renderTomlSection(header, command, env);
+    const next = upsertTomlSection(existing, header, block);
+    await fs.writeFile(target.path, next, "utf8");
+}
+function sectionExists(text, header) {
+    return text.split("\n").some((line) => line.trim() === header);
+}
+function renderTomlSection(header, command, env) {
+    const lines = [header];
+    lines.push(`command = ${tomlString(command)}`);
+    lines.push(`args = []`);
+    const envKeys = Object.keys(env);
+    if (envKeys.length > 0) {
+        const pairs = envKeys.map((k) => `${k} = ${tomlString(env[k])}`).join(", ");
+        lines.push(`env = { ${pairs} }`);
+    }
+    return lines.join("\n") + "\n";
+}
+function tomlString(value) {
+    // Basic-string escaping per TOML spec.
+    const escaped = value
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+    return `"${escaped}"`;
+}
+/**
+ * Replace an existing `[section]` block with `block`, or append it. The block
+ * runs until the next top-level `[...]` header. This is intentionally a
+ * text-level edit so we don't depend on a TOML library — Codex's config is
+ * small and the section header we touch is well-defined.
+ */
+function upsertTomlSection(text, header, block) {
+    const lines = text.length === 0 ? [] : text.split("\n");
+    let startIdx = -1;
+    let endIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim() === header) {
+            startIdx = i;
+            for (let j = i + 1; j < lines.length; j++) {
+                if (/^\s*\[/.test(lines[j])) {
+                    endIdx = j;
+                    break;
+                }
+            }
+            if (endIdx === -1)
+                endIdx = lines.length;
+            break;
+        }
+    }
+    if (startIdx === -1) {
+        const needsSep = text.length > 0 && !text.endsWith("\n\n");
+        const sep = text.length === 0 ? "" : text.endsWith("\n") ? "\n" : "\n\n";
+        const prefix = needsSep ? sep : "";
+        const suffix = block.endsWith("\n") ? "" : "\n";
+        return text + prefix + block + suffix;
+    }
+    const before = lines.slice(0, startIdx).join("\n");
+    const after = lines.slice(endIdx).join("\n");
+    const beforePart = before.length > 0 && !before.endsWith("\n") ? before + "\n" : before;
+    const blockPart = block.endsWith("\n") ? block : block + "\n";
+    return beforePart + blockPart + after;
+}
+function printHints(agent, target, serverName) {
+    info(``);
+    switch (agent) {
+        case "claude":
+            info(`Tip: restart Claude Code (or run '/mcp') and you should see '${serverName}'.`);
+            break;
+        case "copilot":
+            info(`Tip: reload the VS Code window. Open the Chat view and pick '${serverName}' as a tool.`);
+            if (target.scope === "workspace") {
+                info(`     Commit .vscode/mcp.json if you want teammates to share this config.`);
+            }
+            break;
+        case "copilot-cli":
+            info(`Tip: restart 'copilot' and run '/mcp list' to confirm '${serverName}' is registered.`);
+            if (target.scope === "workspace") {
+                info(`     Commit .mcp.json if you want teammates to share this config — both`);
+                info(`     Copilot CLI and Claude Code read it.`);
+            }
+            break;
+        case "codex":
+            info(`Tip: restart 'codex' and run '/mcp' to confirm '${serverName}' is registered.`);
+            break;
+    }
+}
+//# sourceMappingURL=install-mcp.js.map

package/dist/commands/install-mcp.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,17 @@
+interface Options {
+    url?: string;
+    username?: string;
+    password?: string;
+    profile?: string;
+    setDefault?: boolean;
+    credentials?: string;
+    /** Tri-state for password caching:
+     *   undefined → auto (save if keychain available, skip otherwise)
+     *   true       → fail loudly if keychain unavailable
+     *   false      → never save, even if keychain available
+     */
+    savePassword?: boolean;
+    timeoutMs?: number;
+}
+export declare function login(opts: Options): Promise<void>;
+export {};

package/dist/commands/login.js

@@ -0,0 +1,110 @@
+import { DEFAULT_PROFILE_NAME, ZentaoClient, accountKey, detectBackend, readStore, resolveCredentialsPath, writeStore, } from "@zentao-hub/sdk";
+import { promptLine, promptSecret } from "../prompt.js";
+import { CliError, info, warn } from "../util.js";
+const PROFILE_NAME_PATTERN = /^[a-zA-Z0-9._-]+$/;
+export async function login(opts) {
+    // Read existing store first: it's needed both for the prompt suggestion
+    // and (later) for merging the new profile in.
+    const credsPath = resolveCredentialsPath(opts.credentials);
+    const existing = (await readStore(credsPath).catch(() => undefined));
+    // Interactive mode = at least one of url/username/password was not supplied
+    // via flags. In script mode (everything via flags) we skip the profile
+    // prompt too, so the call doesn't block waiting on stdin.
+    const interactive = !opts.url || !opts.username || !opts.password;
+    const profile = (opts.profile ?? (await resolveProfileName(existing, interactive))).trim();
+    if (!PROFILE_NAME_PATTERN.test(profile)) {
+        throw new CliError(`Invalid profile name '${profile}'. Allowed: letters, digits, '.', '_', '-'`);
+    }
+    if (existing?.profiles[profile]) {
+        info(`Note: profile '${profile}' already exists and will be overwritten.`);
+    }
+    const baseUrl = (opts.url ?? (await promptLine("ZenTao URL: "))).trim();
+    if (!baseUrl)
+        throw new CliError("ZenTao URL is required");
+    if (!/^https?:\/\//i.test(baseUrl)) {
+        throw new CliError(`ZenTao URL must start with http(s)://, got '${baseUrl}'`);
+    }
+    const username = (opts.username ?? (await promptLine("Username: "))).trim();
+    if (!username)
+        throw new CliError("username is required");
+    const password = opts.password ?? (await promptSecret("Password: "));
+    if (!password)
+        throw new CliError("password is required");
+    info(`Authenticating against ${baseUrl} as ${username} (profile '${profile}')...`);
+    const token = await ZentaoClient.fetchToken(baseUrl, username, password, opts.timeoutMs);
+    const cleanUrl = baseUrl.replace(/\/+$/, "");
+    const newProfile = {
+        baseUrl: cleanUrl,
+        username,
+        token,
+        createdAt: new Date().toISOString(),
+    };
+    const store = existing
+        ? { ...existing, profiles: { ...existing.profiles, [profile]: newProfile } }
+        : {
+            schemaVersion: 2,
+            default: profile,
+            profiles: { [profile]: newProfile },
+        };
+    // First profile in a fresh file is always the default; explicit
+    // --set-default flips it regardless.
+    if (!existing) {
+        store.default = profile;
+    }
+    else if (opts.setDefault) {
+        store.default = profile;
+    }
+    await writeStore(credsPath, store);
+    const isDefault = store.default === profile;
+    info(`Logged in. Profile '${profile}'${isDefault ? " (default)" : ""} saved to ${credsPath}`);
+    await savePasswordIfApplicable(cleanUrl, username, password, opts.savePassword);
+}
+/**
+ * Resolve the profile name. In interactive mode prompt for it (defaulting
+ * to "default"); in script mode (all flags supplied) silently use "default"
+ * so the call never blocks waiting on stdin. If a file already exists, list
+ * its profiles to help the user avoid accidental name collisions — the main
+ * flow still prints a clear "will overwrite" note if they pick an existing
+ * name, which is fine when re-logging the same profile to refresh its token.
+ */
+async function resolveProfileName(existing, interactive) {
+    if (!interactive)
+        return DEFAULT_PROFILE_NAME;
+    if (existing) {
+        info(`Existing profiles: ${Object.keys(existing.profiles).join(", ")} ` +
+            `(default: ${existing.default})`);
+    }
+    const entered = (await promptLine(`Profile name [${DEFAULT_PROFILE_NAME}]: `)).trim();
+    return entered || DEFAULT_PROFILE_NAME;
+}
+async function savePasswordIfApplicable(baseUrl, username, password, preference) {
+    if (preference === false) {
+        info(``);
+        info(`Password not cached (--no-save-password). MCP server will be unable`);
+        info(`to auto-refresh the token; rerun 'zentao-hub login' when it expires.`);
+        return;
+    }
+    const backend = detectBackend();
+    if (!backend.available) {
+        const msg = `No system keychain available: ${backend.unavailableReason ?? "unsupported platform"}`;
+        if (preference === true)
+            throw new CliError(msg);
+        warn(msg);
+        warn(`Password will not be cached. Token works until it expires; rerun 'zentao-hub login' afterwards.`);
+        return;
+    }
+    try {
+        await backend.set(accountKey(baseUrl, username), password);
+        info(``);
+        info(`Password saved to ${backend.name}. MCP server will auto-refresh the`);
+        info(`token when it expires.`);
+    }
+    catch (err) {
+        const msg = `Failed to save password to ${backend.name}: ${err.message}`;
+        if (preference === true)
+            throw new CliError(msg);
+        warn(msg);
+        warn(`Token was still stored, but auto-refresh is disabled.`);
+    }
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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

package/dist/commands/logout.d.ts

@@ -0,0 +1,7 @@
+interface Options {
+    profile?: string;
+    all?: boolean;
+    credentials?: string;
+}
+export declare function logout(opts: Options): Promise<void>;
+export {};