@zentodo/cli 0.1.0

package/dist/commands/sync.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Resolve runtime context from config + env + CLI flags for every command.
+ */
+import { type RunContext } from '@zentodo/core';
+export interface GlobalFlags {
+    profile?: string;
+    server?: string;
+    token?: string;
+    logLevel?: string;
+    logFile?: string;
+    noRetry?: boolean;
+    noColor?: boolean;
+    dryRun?: boolean;
+    yes?: boolean;
+    local?: boolean;
+    remote?: boolean;
+    json?: boolean;
+    ndjson?: boolean;
+    yaml?: boolean;
+    quiet?: boolean;
+}
+export interface CliContext extends RunContext {
+    profileName: string;
+    flags: GlobalFlags;
+}
+export declare function buildContext(flags: GlobalFlags): Promise<CliContext>;
+export declare function requireAuth(ctx: CliContext): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAUL,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA2C1E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAMjD"}

package/dist/context.js

@@ -0,0 +1,54 @@
+/**
+ * Resolve runtime context from config + env + CLI flags for every command.
+ */
+import { HttpClient, applyEnvOverrides, createSecretStore, ensureHome, getProfile, loadConfig, verifyToken, ZenError, ErrCode, } from '@zentodo/core';
+export async function buildContext(flags) {
+    ensureHome();
+    const cfg = loadConfig();
+    const { name, profile } = getProfile(cfg, flags.profile);
+    const effective = applyEnvOverrides(profile);
+    if (flags.server)
+        effective.server = flags.server;
+    const secrets = await createSecretStore();
+    const tokenRaw = flags.token ?? process.env['ZENTODO_TOKEN'] ?? (await secrets.get(name)) ?? '';
+    let usrKey = effective.user_key;
+    let grantedScopes = [];
+    if (tokenRaw) {
+        const secretMaterial = await secrets.get(`${name}:hmac-secret`);
+        if (secretMaterial) {
+            try {
+                const payload = verifyToken(tokenRaw, secretMaterial);
+                usrKey = payload.usrKey;
+                grantedScopes = payload.scopes;
+            }
+            catch {
+                // Fall back to the embedded config usrKey with no scopes.
+            }
+        }
+    }
+    const http = new HttpClient({
+        baseUrl: effective.server,
+        qps: effective.rate_limit_qps,
+        retry: effective.retry
+            ? { attempts: effective.retry.attempts, baseMs: effective.retry.base_ms }
+            : undefined,
+        noRetry: flags.noRetry,
+        userAgent: 'zentodo-cli/0.1.0',
+    });
+    return {
+        profileName: name,
+        flags,
+        http,
+        usrKey,
+        grantedScopes,
+        dryRun: flags.dryRun,
+    };
+}
+export function requireAuth(ctx) {
+    if (ctx.usrKey === undefined || ctx.usrKey === null || ctx.usrKey === '') {
+        throw new ZenError(ErrCode.EnoAuth, 'no credentials for this profile', {
+            hint: 'Run `zentodo auth login-password --email ... --password ...` first.',
+        });
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,OAAO,GAGR,MAAM,eAAe,CAAC;AAyBvB,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAkB;IACnD,UAAU,EAAE,CAAC;IACb,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM;QAAE,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAElD,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC1C,MAAM,QAAQ,GACZ,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACjF,IAAI,MAAM,GAAgC,SAAS,CAAC,QAAQ,CAAC;IAC7D,IAAI,aAAa,GAAqB,EAAE,CAAC;IACzC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC;QAChE,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;gBACtD,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBACxB,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;QAC1B,OAAO,EAAE,SAAS,CAAC,MAAM;QACzB,GAAG,EAAE,SAAS,CAAC,cAAc;QAC7B,KAAK,EAAE,SAAS,CAAC,KAAK;YACpB,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE;YACzE,CAAC,CAAC,SAAS;QACb,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,mBAAmB;KAC/B,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,KAAK;QACL,IAAI;QACJ,MAAM;QACN,aAAa;QACb,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAe;IACzC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,iCAAiC,EAAE;YACrE,IAAI,EAAE,qEAAqE;SAC5E,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/generate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 根据清单自动注册 CLI 子命令。
+ */
+import { Command } from 'commander';
+export declare function registerGenerated(root: Command): void;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAW5C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CA6DrD"}

package/dist/generate.js

@@ -0,0 +1,163 @@
+/**
+ * 根据清单自动注册 CLI 子命令。
+ */
+import { Option } from 'commander';
+import { CAPABILITIES, exitCodeOf, runCapability, } from '@zentodo/core';
+import { buildContext } from './context.js';
+import { resolveFormat, writeResult } from './output/format.js';
+export function registerGenerated(root) {
+    const groups = new Map();
+    for (const existing of root.commands) {
+        groups.set(existing.name(), existing);
+    }
+    for (const cap of CAPABILITIES) {
+        if (!cap.cli)
+            continue;
+        const groupName = cap.cli.group;
+        let group = groups.get(groupName);
+        if (!group) {
+            group = root
+                .command(groupName)
+                .description(describeGroup(groupName));
+            groups.set(groupName, group);
+        }
+        if (group.commands.some((c) => c.name() === cap.cli.command))
+            continue;
+        const cmd = group
+            .command(cap.cli.command)
+            .description(cap.summary);
+        for (const alias of cap.cli.aliases ?? [])
+            cmd.alias(alias);
+        for (const p of cap.params)
+            attachOption(cmd, p);
+        if (cap.destructive) {
+            cmd.option('--yes', '跳过破坏性操作的确认');
+        }
+        cmd.action(async (_args, thisCmd) => {
+            const flags = thisCmd.optsWithGlobals();
+            const globalFlags = pickGlobalFlags(flags);
+            const format = resolveFormat(globalFlags);
+            try {
+                const ctx = await buildContext(globalFlags);
+                const input = optsToInput(cap, flags);
+                const result = await runCapability(cap, input, ctx);
+                writeResult(result, { format, color: !globalFlags.noColor });
+                if (!result.ok)
+                    process.exit(exitCodeOf(result.error));
+            }
+            catch (err) {
+                const msg = err.message || String(err);
+                if (format === 'json' || format === 'ndjson') {
+                    process.stdout.write(JSON.stringify({
+                        ok: false,
+                        data: null,
+                        error: { code: err.code ?? 'ErrUnknown', message: msg },
+                        meta: { requestId: '-', durationMs: 0, scopeChecked: cap.scopes },
+                    }) + '\n');
+                }
+                else {
+                    process.stderr.write(`错误: ${msg}\n`);
+                }
+                process.exit(exitCodeOf({ code: err.code ?? 'ErrUnknown', message: msg }));
+            }
+        });
+    }
+}
+function attachOption(cmd, p) {
+    const flag = `--${toKebab(p.name)} <value>`;
+    const option = new Option(flag, p.description);
+    if (p.default !== undefined)
+        option.default(p.default);
+    if (p.type === 'enum' && p.enumValues)
+        option.choices([...p.enumValues]);
+    if (p.required)
+        option.makeOptionMandatory(true);
+    cmd.addOption(option);
+}
+function optsToInput(cap, opts) {
+    const input = {};
+    for (const p of cap.params) {
+        const key = toCamel(p.name);
+        const v = opts[key];
+        if (v === undefined)
+            continue;
+        input[p.name] = coerce(p, v);
+    }
+    return input;
+}
+function coerce(p, v) {
+    if (typeof v !== 'string')
+        return v;
+    switch (p.type) {
+        case 'integer':
+            return Number.parseInt(v, 10);
+        case 'number':
+            return Number.parseFloat(v);
+        case 'boolean':
+            return v === 'true' || v === '1' || v === 'yes';
+        case 'array':
+            return v.split(',').map((s) => s.trim()).filter(Boolean);
+        default:
+            return v;
+    }
+}
+function toKebab(name) {
+    return name.replace(/_/g, '-');
+}
+function toCamel(name) {
+    return name.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase())
+        .replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+function pickGlobalFlags(flags) {
+    return {
+        profile: flags['profile'],
+        server: flags['server'],
+        token: flags['token'],
+        logLevel: flags['logLevel'],
+        logFile: flags['logFile'],
+        noRetry: !!flags['noRetry'],
+        noColor: !!flags['noColor'],
+        dryRun: !!flags['dryRun'],
+        yes: !!flags['yes'],
+        local: !!flags['local'],
+        remote: !!flags['remote'],
+        json: !!flags['json'],
+        ndjson: !!flags['ndjson'],
+        yaml: !!flags['yaml'],
+        quiet: !!flags['quiet'],
+    };
+}
+/**
+ * 给自动生成的命令组一段中文描述。
+ */
+function describeGroup(name) {
+    const map = {
+        auth: '登录与 Token 管理',
+        user: '用户资料与奖励币 / VIP',
+        task: '任务增删改查 / 完成 / MIT / 四象限 / 日历',
+        subtask: '子任务管理',
+        project: '项目管理',
+        subproject: '子项目管理',
+        scene: '场景管理',
+        target: '长期目标管理',
+        label: '标签管理(含背景图上传)',
+        toplabel: '顶级标签管理',
+        quadrant: '四象限配置',
+        timeline: '时间轴条目',
+        attach: '附件上传与同步',
+        pomo: '番茄钟启动 / 停止 / 历史 / 配置',
+        timer: '自由计时(非番茄钟)',
+        workstate: '工作状态(开始 / 结束 / 当前)',
+        diary: '晨间日记(标题 + 内容)',
+        mindmap: '思维导图元数据',
+        reward: '奖励商店与兑换记录',
+        fasttime: '快速时间记录',
+        wheel: '滚轮视图配置',
+        invite: '邀请列表',
+        app: 'App 版本与服务器时间',
+        pay: '价格 / 订单信息 / 优惠券(只读)',
+        sync: '同步编排(状态 / 增量 / 全量)',
+    };
+    return map[name] ?? `${name} 命令`;
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { buildProgram } from './program.js';
+export { buildContext } from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { buildProgram } from './program.js';
+export { buildContext } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/output/format.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CLI 输出格式化。
+ *
+ * 不变式:`--json` 的结构与 MCP 工具的 outputSchema 严格一致(单一真相)。
+ */
+import { type ApiResult } from '@zentodo/core';
+export type OutputFormat = 'text' | 'json' | 'ndjson' | 'yaml';
+export interface FormatOptions {
+    format: OutputFormat;
+    color?: boolean;
+}
+export declare function writeResult<T>(result: ApiResult<T>, opts: FormatOptions): void;
+export declare function resolveFormat(flags: {
+    json?: boolean;
+    ndjson?: boolean;
+    yaml?: boolean;
+    quiet?: boolean;
+}): OutputFormat;
+//# sourceMappingURL=format.d.ts.map

package/dist/output/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAmB9E;AA4DD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,YAAY,CAUf"}

package/dist/output/format.js

@@ -0,0 +1,99 @@
+/**
+ * CLI 输出格式化。
+ *
+ * 不变式:`--json` 的结构与 MCP 工具的 outputSchema 严格一致(单一真相)。
+ */
+export function writeResult(result, opts) {
+    if (opts.format === 'json') {
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        return;
+    }
+    if (opts.format === 'ndjson') {
+        process.stdout.write(JSON.stringify(result) + '\n');
+        return;
+    }
+    if (opts.format === 'yaml') {
+        process.stdout.write(toYaml(result) + '\n');
+        return;
+    }
+    // text
+    if (!result.ok) {
+        process.stderr.write(formatError(result, opts) + '\n');
+        return;
+    }
+    process.stdout.write(formatSuccess(result, opts) + '\n');
+}
+function formatSuccess(result, _opts) {
+    const data = result.data;
+    if (data === null || data === undefined)
+        return '完成';
+    if (typeof data === 'string' || typeof data === 'number' || typeof data === 'boolean') {
+        return String(data);
+    }
+    if (Array.isArray(data)) {
+        return data.length === 0 ? '(空列表)' : data.map((row) => stringifyRow(row)).join('\n');
+    }
+    return stringifyRow(data);
+}
+function formatError(result, _opts) {
+    const err = result.error;
+    const lines = [`错误: ${err.code}: ${err.message}`];
+    if (err.hint)
+        lines.push(`提示: ${err.hint}`);
+    if (err.detail)
+        lines.push(`详情: ${safeStringify(err.detail)}`);
+    return lines.join('\n');
+}
+function stringifyRow(v) {
+    if (v === null || v === undefined)
+        return '-';
+    if (typeof v !== 'object')
+        return String(v);
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+function safeStringify(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+function toYaml(v, indent = 0) {
+    const pad = '  '.repeat(indent);
+    if (v === null || v === undefined)
+        return `${pad}null`;
+    if (typeof v !== 'object')
+        return `${pad}${String(v)}`;
+    if (Array.isArray(v)) {
+        if (v.length === 0)
+            return `${pad}[]`;
+        return v.map((item) => `${pad}- ${toYaml(item, indent + 1).trim()}`).join('\n');
+    }
+    const entries = Object.entries(v);
+    if (entries.length === 0)
+        return `${pad}{}`;
+    return entries
+        .map(([k, val]) => {
+        if (val !== null && typeof val === 'object') {
+            return `${pad}${k}:\n${toYaml(val, indent + 1)}`;
+        }
+        return `${pad}${k}: ${stringifyRow(val)}`;
+    })
+        .join('\n');
+}
+export function resolveFormat(flags) {
+    const picks = [flags.json && 'json', flags.ndjson && 'ndjson', flags.yaml && 'yaml'].filter(Boolean);
+    if (picks.length > 1) {
+        throw Object.assign(new Error('只能同时使用 --json / --ndjson / --yaml 中的一个'), {
+            code: 'ErrInvalidFlags',
+        });
+    }
+    return (picks[0] ?? 'text');
+}
+//# sourceMappingURL=format.js.map

package/dist/output/format.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildProgram(): Command;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,YAAY,IAAI,OAAO,CA8CtC"}

package/dist/program.js

@@ -0,0 +1,59 @@
+import { Command } from 'commander';
+import { registerAudit } from './commands/audit.js';
+import { registerAuth } from './commands/auth.js';
+import { registerConfig } from './commands/config.js';
+import { registerData } from './commands/data.js';
+import { registerDoctor } from './commands/doctor.js';
+import { registerMcp } from './commands/mcp.js';
+import { registerRaw } from './commands/raw.js';
+import { registerSearch } from './commands/search.js';
+import { registerSettings } from './commands/settings.js';
+import { registerSkill } from './commands/skill.js';
+import { registerStats } from './commands/stats.js';
+import { registerSync } from './commands/sync.js';
+import { registerGenerated } from './generate.js';
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name('zentodo')
+        .description('ZenTodo 命令行工具 — 基于清单驱动,连接 ZenTodo 后端。所有请求使用 FormData。')
+        .version('0.1.0', '-V, --version', '打印 CLI 版本')
+        .helpOption('-h, --help', '显示帮助信息')
+        .addHelpCommand('help [command]', '查看命令帮助')
+        .option('--profile <name>', '使用指定 Profile(默认使用 current_profile)')
+        .option('--server <url>', '覆盖后端地址')
+        .option('--token <token>', '覆盖本地 Token')
+        .option('--log-level <level>', '日志级别:trace|debug|info|warn|error', 'info')
+        .option('--log-file <path>', '追加日志到指定文件')
+        .option('--no-retry', '禁用自动重试')
+        .option('--no-color', '关闭彩色输出')
+        .option('--dry-run', '只打印将发送的请求,不真正调用后端')
+        .option('--yes', '跳过破坏性操作的确认提示')
+        .option('--local', '优先使用本地 SQLite(若可用)')
+        .option('--remote', '强制使用远程 HTTP 模式')
+        .option('--json', 'JSON 输出')
+        .option('--ndjson', '按行输出 JSON(适合流式处理)')
+        .option('--yaml', 'YAML 输出')
+        .option('--quiet', '隐藏非必要输出');
+    program
+        .command('version-full')
+        .description('打印版本号与协议兼容版本')
+        .action(() => {
+        process.stdout.write(JSON.stringify({ version: '0.1.0', apiCompat: 'v1' }) + '\n');
+    });
+    registerAuth(program);
+    registerConfig(program);
+    registerDoctor(program);
+    registerRaw(program);
+    registerSync(program);
+    registerStats(program);
+    registerSearch(program);
+    registerData(program);
+    registerSettings(program);
+    registerAudit(program);
+    registerMcp(program);
+    registerSkill(program);
+    registerGenerated(program);
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@zentodo/cli",
+  "version": "0.1.0",
+  "description": "ZenTodo 命令行工具 — 为 AI Agent 和开发者设计，覆盖任务、项目、番茄钟、日记、同步等全部能力。安装后自动配置 Claude Agent Skill。",
+  "type": "module",
+  "bin": {
+    "zentodo": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "skills/",
+    "scripts/postinstall.mjs",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rimraf dist *.tsbuildinfo skills/",
+    "start": "node dist/bin.js",
+    "postinstall": "node scripts/postinstall.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "zentodo",
+    "todo",
+    "task",
+    "pomodoro",
+    "cli",
+    "ai-agent",
+    "skill",
+    "claude"
+  ],
+  "dependencies": {
+    "@zentodo/core": "*",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.0",
+    "rimraf": "^5.0.10",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_GITHUB_USERNAME/ZenTodoProject.git"
+  },
+  "homepage": "https://github.com/YOUR_GITHUB_USERNAME/ZenTodoProject#readme"
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * npm install -g @zentodo/cli 之后自动运行。
+ *
+ * 把打包在 npm 包里的 skills/zentodo/ 目录复制到
+ * ~/.claude/skills/zentodo/，让 Claude Code / Claude Desktop
+ * 下次启动时自动加载 ZenTodo Skill。
+ *
+ * 如果复制失败（权限问题、目录不存在等），只打印警告，不中断安装。
+ */
+
+import { cpSync, existsSync, mkdirSync, rmSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PKG_DIR = dirname(fileURLToPath(import.meta.url));
+// scripts/postinstall.mjs -> scripts -> cli package root
+const CLI_ROOT = join(PKG_DIR, '..');
+const SKILL_SRC = join(CLI_ROOT, 'skills', 'zentodo');
+const SKILL_DEST = join(homedir(), '.claude', 'skills', 'zentodo');
+
+function run() {
+  if (!existsSync(SKILL_SRC)) {
+    // 开发环境直接跑源码时 skills/ 可能还没生成，静默跳过
+    return;
+  }
+
+  try {
+    if (existsSync(SKILL_DEST)) {
+      rmSync(SKILL_DEST, { recursive: true, force: true });
+    }
+    mkdirSync(SKILL_DEST, { recursive: true });
+    cpSync(SKILL_SRC, SKILL_DEST, { recursive: true });
+
+    console.log('');
+    console.log('✅ ZenTodo Skill 已安装到:', SKILL_DEST);
+    console.log('');
+    console.log('下一步:');
+    console.log('  1. 登录 ZenTodo:');
+    console.log('     zentodo auth login-password --email 你的邮箱 --password 你的密码');
+    console.log('');
+    console.log('  2. 重启 Claude Code / Claude Desktop');
+    console.log('');
+    console.log('  3. 在 Claude 里说: "帮我看看 ZenTodo 今天的 MIT 任务"');
+    console.log('');
+  } catch (err) {
+    // 不中断安装，只警告
+    console.warn('');
+    console.warn('⚠️  ZenTodo Skill 自动安装失败:', err.message);
+    console.warn('   手动安装: zentodo skill install claude-code');
+    console.warn('');
+  }
+}
+
+run();