@zentodo/cli 0.1.0

package/dist/commands/skill.js

@@ -0,0 +1,280 @@
+/**
+ * `zentodo skill ...` — 把 ZenTodo 打包成符合 Claude Agent Skill 规范的目录 / zip。
+ *
+ * 产物结构:
+ *
+ *   zentodo/
+ *     SKILL.md                     <- 带 YAML frontmatter 的主文件
+ *     references/
+ *       commands.md                <- 自动生成
+ *       tools.md                   <- 自动生成
+ *       error-codes.md             <- 自动生成
+ *       tools.json                 <- 机器可读工具清单
+ *     examples/
+ *       plan-my-day.md
+ *       sync.md
+ *     assets/                      <- 预留
+ *
+ * 通过 `--zip` 打包为 `zentodo.zip`,可直接上传到 Claude.ai 或其他支持
+ * Skill 上传的客户端。
+ */
+import { createHash } from 'node:crypto';
+import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, statSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+import { renderCommandsMarkdown, renderMappingMarkdown, renderToolsJson, renderToolsMarkdown } from '@zentodo/core';
+const CLI_DIR = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = resolve(CLI_DIR, '..', '..', '..', '..');
+const SKILL_SRC = resolve(REPO_ROOT, 'packages', 'claude-skill');
+const ERROR_CODES_SRC = resolve(REPO_ROOT, 'docs', 'integration', 'error-codes.md');
+export function registerSkill(root) {
+    const skill = root.command('skill').description('把 ZenTodo 打包成 Claude Agent Skill(SKILL.md + references)');
+    skill
+        .command('build')
+        .description('构建 Skill 目录,默认输出到 dist/skill/zentodo/')
+        .option('--out <dir>', '输出根目录', 'dist/skill')
+        .option('--name <name>', 'Skill 目录名', 'zentodo')
+        .option('--zip', '同时打包为 <name>.zip', false)
+        .option('--clean', '构建前清空目标目录', false)
+        .action(async (opts) => {
+        const outRoot = resolve(process.cwd(), opts.out);
+        const skillDir = join(outRoot, opts.name);
+        if (opts.clean && existsSync(skillDir))
+            rmSync(skillDir, { recursive: true, force: true });
+        mkdirSync(join(skillDir, 'references'), { recursive: true });
+        mkdirSync(join(skillDir, 'examples'), { recursive: true });
+        mkdirSync(join(skillDir, 'assets'), { recursive: true });
+        // 1. SKILL.md
+        const skillMd = readFileSync(join(SKILL_SRC, 'SKILL.md'), 'utf8');
+        writeFileSync(join(skillDir, 'SKILL.md'), skillMd, 'utf8');
+        // 2. references (generated)
+        writeFileSync(join(skillDir, 'references', 'commands.md'), renderCommandsMarkdown(), 'utf8');
+        writeFileSync(join(skillDir, 'references', 'tools.md'), renderToolsMarkdown(), 'utf8');
+        writeFileSync(join(skillDir, 'references', 'mapping.md'), renderMappingMarkdown(), 'utf8');
+        writeFileSync(join(skillDir, 'references', 'tools.json'), renderToolsJson(), 'utf8');
+        if (existsSync(ERROR_CODES_SRC)) {
+            writeFileSync(join(skillDir, 'references', 'error-codes.md'), readFileSync(ERROR_CODES_SRC, 'utf8'), 'utf8');
+        }
+        // 3. examples (copy)
+        const examplesSrc = join(SKILL_SRC, 'examples');
+        if (existsSync(examplesSrc)) {
+            for (const entry of readdirSync(examplesSrc)) {
+                const src = join(examplesSrc, entry);
+                if (statSync(src).isFile()) {
+                    writeFileSync(join(skillDir, 'examples', entry), readFileSync(src, 'utf8'), 'utf8');
+                }
+            }
+        }
+        const manifestPath = join(skillDir, 'skill.json');
+        const filesIncluded = collectFiles(skillDir);
+        writeFileSync(manifestPath, JSON.stringify({
+            name: opts.name,
+            version: '0.1.0',
+            entry: 'SKILL.md',
+            files: filesIncluded.map((f) => relative(skillDir, f).replaceAll('\\', '/')),
+        }, null, 2), 'utf8');
+        process.stdout.write([
+            `已生成 Skill 目录:${skillDir}`,
+            `  SKILL.md           ${formatBytes(statSync(join(skillDir, 'SKILL.md')).size)}`,
+            `  references/        ${filesIncluded.filter((f) => f.includes('references')).length} 个文件`,
+            `  examples/          ${filesIncluded.filter((f) => f.includes('examples')).length} 个文件`,
+        ].join('\n') + '\n');
+        if (opts.zip) {
+            const zipPath = join(outRoot, `${opts.name}.zip`);
+            await writeZip(skillDir, zipPath, opts.name);
+            process.stdout.write(`\n已打包:${zipPath} (${formatBytes(statSync(zipPath).size)})\n`);
+            process.stdout.write('\n提示:将 zentodo.zip 上传到:\n' +
+                '  - Claude.ai → Projects → Skills\n' +
+                '  - 或解压后放到 Claude Code 的 skills 目录\n' +
+                '  - 或作为 Claude API 的 Agent Skill 附件\n');
+        }
+    });
+    skill
+        .command('install <target>')
+        .description('把构建产物安装到本地客户端的 skills 目录。target: claude-code | claude-desktop')
+        .option('--source <dir>', '已构建的 skill 目录', 'dist/skill/zentodo')
+        .option('--name <name>', 'Skill 目录名', 'zentodo')
+        .action((target, opts) => {
+        const source = resolve(process.cwd(), opts.source);
+        if (!existsSync(source)) {
+            process.stderr.write(`未找到构建产物:${source}\n先运行 \`zentodo skill build\`\n`);
+            process.exit(2);
+        }
+        const dest = resolveSkillsTarget(target, opts.name);
+        if (existsSync(dest))
+            rmSync(dest, { recursive: true, force: true });
+        copyDir(source, dest);
+        process.stdout.write([
+            `已安装 Skill 到:${dest}`,
+            '',
+            '下一步:重启 ' + target + ',然后在对话里试试:',
+            '  > 看看我 ZenTodo 里今天的 MIT 任务',
+        ].join('\n') + '\n');
+    });
+    skill
+        .command('sync-to-repo')
+        .description('把构建产物同步到仓库根的 skills/zentodo/ 目录(commit 后可用 npx skills add 安装)')
+        .option('--source <dir>', '已构建的 skill 目录', 'dist/skill/zentodo')
+        .option('--name <name>', 'Skill 目录名', 'zentodo')
+        .action((opts) => {
+        const source = resolve(process.cwd(), opts.source);
+        if (!existsSync(source)) {
+            process.stderr.write(`未找到构建产物:${source}\n先运行 \`zentodo skill build\`\n`);
+            process.exit(2);
+        }
+        const dest = resolve(process.cwd(), 'skills', opts.name);
+        if (existsSync(dest))
+            rmSync(dest, { recursive: true, force: true });
+        copyDir(source, dest);
+        process.stdout.write([
+            `已同步到仓库:${dest}`,
+            '',
+            '下一步:',
+            '  git add skills/',
+            '  git commit -m "chore: update zentodo skill"',
+            '  git push',
+            '',
+            '用户安装命令:',
+            '  npx skills add <你的GitHub用户名>/ZenTodoProject -y -g',
+            '',
+            '或者直接安装到本地 Claude Code:',
+            '  zentodo skill install claude-code',
+        ].join('\n') + '\n');
+    });
+    function resolveSkillsTarget(target, name) {
+        const home = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '.';
+        const isWin = process.platform === 'win32';
+        const isMac = process.platform === 'darwin';
+        switch (target) {
+            case 'claude-code':
+                // Claude Code 约定:~/.claude/skills/<name>/SKILL.md
+                return join(home, '.claude', 'skills', name);
+            case 'claude-desktop':
+                return isWin
+                    ? join(process.env['APPDATA'] ?? join(home, 'AppData', 'Roaming'), 'Claude', 'skills', name)
+                    : isMac
+                        ? join(home, 'Library', 'Application Support', 'Claude', 'skills', name)
+                        : join(home, '.config', 'Claude', 'skills', name);
+            default:
+                throw new Error(`未知 target: ${target}。可选:claude-code | claude-desktop`);
+        }
+    }
+    function collectFiles(dir) {
+        const out = [];
+        for (const entry of readdirSync(dir)) {
+            const full = join(dir, entry);
+            const s = statSync(full);
+            if (s.isDirectory())
+                out.push(...collectFiles(full));
+            else
+                out.push(full);
+        }
+        return out;
+    }
+    function copyDir(src, dest) {
+        mkdirSync(dest, { recursive: true });
+        for (const entry of readdirSync(src)) {
+            const s = join(src, entry);
+            const d = join(dest, entry);
+            if (statSync(s).isDirectory())
+                copyDir(s, d);
+            else
+                writeFileSync(d, readFileSync(s));
+        }
+    }
+    function formatBytes(n) {
+        if (n < 1024)
+            return `${n} B`;
+        if (n < 1024 * 1024)
+            return `${(n / 1024).toFixed(1)} KB`;
+        return `${(n / (1024 * 1024)).toFixed(2)} MB`;
+    }
+    /* ---------- 轻量 ZIP 写入器(Store 模式,无需第三方依赖) ---------- */
+    async function writeZip(sourceDir, zipPath, skillName) {
+        const files = collectFiles(sourceDir).map((full) => ({
+            full,
+            archive: `${skillName}/${relative(sourceDir, full).replaceAll('\\', '/')}`,
+        }));
+        const centralDirEntries = [];
+        const localParts = [];
+        let offset = 0;
+        for (const f of files) {
+            const data = readFileSync(f.full);
+            const crc = crc32(data);
+            const nameBuf = Buffer.from(f.archive, 'utf8');
+            const localHeader = Buffer.alloc(30);
+            localHeader.writeUInt32LE(0x04034b50, 0); // signature
+            localHeader.writeUInt16LE(20, 4); // version needed
+            localHeader.writeUInt16LE(0, 6); // flags
+            localHeader.writeUInt16LE(0, 8); // method 0 (store)
+            localHeader.writeUInt16LE(dosTime(), 10);
+            localHeader.writeUInt16LE(dosDate(), 12);
+            localHeader.writeUInt32LE(crc, 14);
+            localHeader.writeUInt32LE(data.length, 18);
+            localHeader.writeUInt32LE(data.length, 22);
+            localHeader.writeUInt16LE(nameBuf.length, 26);
+            localHeader.writeUInt16LE(0, 28);
+            localParts.push(localHeader, nameBuf, data);
+            const central = Buffer.alloc(46);
+            central.writeUInt32LE(0x02014b50, 0);
+            central.writeUInt16LE(20, 4); // version made by
+            central.writeUInt16LE(20, 6); // version needed
+            central.writeUInt16LE(0, 8);
+            central.writeUInt16LE(0, 10);
+            central.writeUInt16LE(dosTime(), 12);
+            central.writeUInt16LE(dosDate(), 14);
+            central.writeUInt32LE(crc, 16);
+            central.writeUInt32LE(data.length, 20);
+            central.writeUInt32LE(data.length, 24);
+            central.writeUInt16LE(nameBuf.length, 28);
+            central.writeUInt16LE(0, 30);
+            central.writeUInt16LE(0, 32);
+            central.writeUInt16LE(0, 34);
+            central.writeUInt16LE(0, 36);
+            central.writeUInt32LE(0, 38); // external attr
+            central.writeUInt32LE(offset, 42);
+            centralDirEntries.push(central, nameBuf);
+            offset += localHeader.length + nameBuf.length + data.length;
+        }
+        const centralDir = Buffer.concat(centralDirEntries);
+        const end = Buffer.alloc(22);
+        end.writeUInt32LE(0x06054b50, 0);
+        end.writeUInt16LE(0, 4);
+        end.writeUInt16LE(0, 6);
+        end.writeUInt16LE(files.length, 8);
+        end.writeUInt16LE(files.length, 10);
+        end.writeUInt32LE(centralDir.length, 12);
+        end.writeUInt32LE(offset, 16);
+        end.writeUInt16LE(0, 20);
+        mkdirSync(dirname(zipPath), { recursive: true });
+        await pipeline(Readable.from(Buffer.concat([...localParts, centralDir, end])), createWriteStream(zipPath));
+        void createHash;
+    }
+    // Pre-computed CRC table for ZIP (ISO/IEC 21320)
+    const CRC_TABLE = (() => {
+        const t = new Uint32Array(256);
+        for (let n = 0; n < 256; n++) {
+            let c = n;
+            for (let k = 0; k < 8; k++)
+                c = (c & 1) ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+            t[n] = c >>> 0;
+        }
+        return t;
+    })();
+    function crc32(buf) {
+        let c = 0xffffffff;
+        for (let i = 0; i < buf.length; i++) {
+            c = (CRC_TABLE[(c ^ buf[i]) & 0xff] ^ (c >>> 8)) >>> 0;
+        }
+        return (c ^ 0xffffffff) >>> 0;
+    }
+    function dosTime(d = new Date()) {
+        return ((d.getHours() & 0x1f) << 11) | ((d.getMinutes() & 0x3f) << 5) | ((d.getSeconds() / 2) & 0x1f);
+    }
+    function dosDate(d = new Date()) {
+        return (((d.getFullYear() - 1980) & 0x7f) << 9) | (((d.getMonth() + 1) & 0x0f) << 5) | (d.getDate() & 0x1f);
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

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

package/dist/commands/stats.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `zentodo stats ...` — 任务与专注指标聚合(客户端完成)。
+ */
+import { Command } from 'commander';
+export declare function registerStats(root: Command): void;
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAmHjD"}

package/dist/commands/stats.js

@@ -0,0 +1,163 @@
+/**
+ * `zentodo stats ...` — 任务与专注指标聚合(客户端完成)。
+ */
+import { capabilityById, runCapability } from '@zentodo/core';
+import { buildContext, requireAuth } from '../context.js';
+import { resolveFormat, writeResult } from '../output/format.js';
+export function registerStats(root) {
+    const stats = root.command('stats').description('基于任务 / 番茄钟数据的客户端统计。');
+    stats
+        .command('tasks')
+        .description('任务完成情况统计')
+        .option('--range <start..end>', 'ISO 日期范围,例如 2025-09-01..2025-09-30')
+        .action(async (opts, thisCmd) => {
+        const globalFlags = thisCmd.optsWithGlobals();
+        const format = resolveFormat({
+            json: !!globalFlags['json'],
+            ndjson: !!globalFlags['ndjson'],
+            yaml: !!globalFlags['yaml'],
+        });
+        const ctx = await buildContext(globalFlags);
+        requireAuth(ctx);
+        const rows = await list(ctx, 'task.list-all');
+        const { from, to } = parseRange(opts.range);
+        const inRange = (t) => inWindow(t.taskCreateTime, from, to) || inWindow(t.taskCompletedTime, from, to);
+        const filtered = rows.filter((r) => r.syncFlag !== 'D' && inRange(r));
+        const created = filtered.length;
+        const completed = filtered.filter((r) => r.taskState === 0).length;
+        const byProject = groupCount(filtered, (r) => String(r.taskProjectKey ?? 'none'));
+        writeResult({
+            ok: true,
+            data: {
+                range: { from: from?.toISOString() ?? null, to: to?.toISOString() ?? null },
+                created,
+                completed,
+                completion_rate: created === 0 ? 0 : +(completed / created).toFixed(3),
+                by_project: byProject,
+            },
+            error: null,
+            meta: { requestId: 'stats.tasks', durationMs: 0, scopeChecked: ['read'] },
+        }, { format });
+    });
+    stats
+        .command('focus')
+        .description('番茄钟 / 工作状态专注时长统计')
+        .option('--range <start..end>', 'ISO 日期范围')
+        .action(async (opts, thisCmd) => {
+        const globalFlags = thisCmd.optsWithGlobals();
+        const format = resolveFormat({
+            json: !!globalFlags['json'],
+            ndjson: !!globalFlags['ndjson'],
+            yaml: !!globalFlags['yaml'],
+        });
+        const ctx = await buildContext(globalFlags);
+        requireAuth(ctx);
+        const rows = await list(ctx, 'pomo.history');
+        const { from, to } = parseRange(opts.range);
+        const filtered = rows.filter((r) => inWindow(r.startTime ?? r.endTime, from, to));
+        const totalSec = filtered.reduce((acc, r) => acc + (r.duration ?? r.focusDuration ?? 0), 0);
+        const byTask = aggregate(filtered, (r) => String(r.taskKey ?? 'none'), (r) => r.duration ?? r.focusDuration ?? 0);
+        writeResult({
+            ok: true,
+            data: {
+                range: { from: from?.toISOString() ?? null, to: to?.toISOString() ?? null },
+                sessions: filtered.length,
+                total_sec: totalSec,
+                total_hours: +(totalSec / 3600).toFixed(2),
+                by_task: byTask,
+            },
+            error: null,
+            meta: { requestId: 'stats.focus', durationMs: 0, scopeChecked: ['read'] },
+        }, { format });
+    });
+    stats
+        .command('overview')
+        .description('仪表盘式综合概览:任务打开/完成/今日完成 + 今日专注时长')
+        .action(async (_opts, thisCmd) => {
+        const globalFlags = thisCmd.optsWithGlobals();
+        const format = resolveFormat({
+            json: !!globalFlags['json'],
+            ndjson: !!globalFlags['ndjson'],
+            yaml: !!globalFlags['yaml'],
+        });
+        const ctx = await buildContext(globalFlags);
+        requireAuth(ctx);
+        const [tasks, pomos] = await Promise.all([
+            list(ctx, 'task.list-all'),
+            list(ctx, 'pomo.history'),
+        ]);
+        const now = new Date();
+        const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+        const tomorrow = new Date(todayStart.getTime() + 86_400_000);
+        const liveTasks = tasks.filter((t) => t.syncFlag !== 'D');
+        const open = liveTasks.filter((t) => t.taskState !== 0).length;
+        const done = liveTasks.filter((t) => t.taskState === 0).length;
+        const doneToday = liveTasks.filter((t) => inWindow(t.taskCompletedTime, todayStart, tomorrow)).length;
+        const focusToday = pomos
+            .filter((p) => inWindow(p.startTime ?? p.endTime, todayStart, tomorrow))
+            .reduce((acc, p) => acc + (p.duration ?? p.focusDuration ?? 0), 0);
+        writeResult({
+            ok: true,
+            data: {
+                date: todayStart.toISOString().slice(0, 10),
+                tasks: { open, done, done_today: doneToday },
+                focus: { sessions_today: pomos.filter((p) => inWindow(p.startTime ?? p.endTime, todayStart, tomorrow)).length, seconds_today: focusToday },
+            },
+            error: null,
+            meta: { requestId: 'stats.overview', durationMs: 0, scopeChecked: ['read'] },
+        }, { format });
+    });
+}
+async function list(ctx, capId) {
+    const spec = capabilityById(capId);
+    if (!spec)
+        return [];
+    const r = await runCapability(spec, {}, ctx);
+    if (!r.ok || !Array.isArray(r.data))
+        return [];
+    return r.data;
+}
+function parseRange(s) {
+    if (!s)
+        return {};
+    const [a, b] = s.split('..');
+    const from = a ? new Date(a) : undefined;
+    const to = b ? new Date(b) : undefined;
+    return { from, to };
+}
+function inWindow(value, from, to) {
+    if (!value)
+        return false;
+    const t = parseBackendTime(value);
+    if (!t)
+        return false;
+    if (from && t < from)
+        return false;
+    if (to && t > to)
+        return false;
+    return true;
+}
+function parseBackendTime(s) {
+    if (!s)
+        return null;
+    const iso = s.replace('/', '-').replace('/', '-').replace(' ', 'T');
+    const d = new Date(iso);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+function groupCount(rows, key) {
+    const out = {};
+    for (const r of rows) {
+        const k = key(r);
+        out[k] = (out[k] ?? 0) + 1;
+    }
+    return out;
+}
+function aggregate(rows, key, value) {
+    const out = {};
+    for (const r of rows) {
+        const k = key(r);
+        out[k] = (out[k] ?? 0) + value(r);
+    }
+    return out;
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `zentodo sync ...` — 同步编排命令。
+ */
+import { Command } from 'commander';
+export declare function registerSync(root: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAyHhD"}

package/dist/commands/sync.js

@@ -0,0 +1,142 @@
+/**
+ * `zentodo sync ...` — 同步编排命令。
+ */
+import { SYNC_TABLES, syncFull, syncIncremental, syncStatus, } from '@zentodo/core';
+import { buildContext, requireAuth } from '../context.js';
+import { resolveFormat, writeResult } from '../output/format.js';
+export function registerSync(root) {
+    const sync = root.command('sync').description('同步编排:对比本地与服务器版本,拉取增量,推送本地变更。');
+    sync
+        .command('tables')
+        .description('列出所有参与同步的表')
+        .action(async (_opts, thisCmd) => {
+        const globalFlags = thisCmd.optsWithGlobals();
+        const format = resolveFormat({
+            json: !!globalFlags['json'],
+            ndjson: !!globalFlags['ndjson'],
+            yaml: !!globalFlags['yaml'],
+        });
+        writeResult({
+            ok: true,
+            data: SYNC_TABLES.map((t) => ({
+                table: t.tableName,
+                label: t.label,
+                pull: t.pullCapability,
+                push: t.pushCapability ?? null,
+                list: t.listAllCapability ?? null,
+            })),
+            error: null,
+            meta: { requestId: 'sync.tables', durationMs: 0, scopeChecked: [] },
+        }, { format });
+    });
+    sync
+        .command('status')
+        .description('查看每张表的本地版本 / 服务器版本 / 同步方向')
+        .option('--tables <csv>', '只检查指定表,逗号分隔')
+        .action(async (opts, thisCmd) => {
+        const globalFlags = thisCmd.optsWithGlobals();
+        const format = resolveFormat({
+            json: !!globalFlags['json'],
+            ndjson: !!globalFlags['ndjson'],
+            yaml: !!globalFlags['yaml'],
+        });
+        const ctx = await buildContext(globalFlags);
+        requireAuth(ctx);
+        try {
+            const rows = await syncStatus(ctx, { tables: splitCsv(opts.tables) });
+            writeResult({
+                ok: true,
+                data: rows,
+                error: null,
+                meta: { requestId: 'sync.status', durationMs: 0, scopeChecked: ['sync', 'read'] },
+            }, { format });
+        }
+        catch (err) {
+            writeResult({
+                ok: false,
+                data: null,
+                error: { code: 'ErrUnknown', message: err.message },
+                meta: { requestId: 'sync.status', durationMs: 0, scopeChecked: [] },
+            }, { format });
+            process.exit(1);
+        }
+    });
+    sync
+        .command('incremental')
+        .description('运行增量同步(服务器新于本地的表自动拉取)')
+        .option('--tables <csv>', '只同步指定表,逗号分隔')
+        .action(async (opts, thisCmd) => {
+        const globalFlags = thisCmd.optsWithGlobals();
+        const format = resolveFormat({
+            json: !!globalFlags['json'],
+            ndjson: !!globalFlags['ndjson'],
+            yaml: !!globalFlags['yaml'],
+        });
+        const ctx = await buildContext(globalFlags);
+        requireAuth(ctx);
+        const onProgress = progressHandler(format);
+        const report = await syncIncremental(ctx, { tables: splitCsv(opts.tables), onProgress });
+        writeResult({
+            ok: report.errors.length === 0,
+            data: report,
+            error: report.errors.length === 0 ? null : { code: 'ErrServer', message: `${report.errors.length} 张表同步失败` },
+            meta: { requestId: 'sync.incremental', durationMs: 0, scopeChecked: ['sync', 'read'] },
+        }, { format });
+        if (report.errors.length > 0)
+            process.exit(1);
+    });
+    sync
+        .command('full')
+        .description('对所有表执行 list-all 全量拉取(不推送本地变更)')
+        .option('--tables <csv>', '只同步指定表,逗号分隔')
+        .action(async (opts, thisCmd) => {
+        const globalFlags = thisCmd.optsWithGlobals();
+        const format = resolveFormat({
+            json: !!globalFlags['json'],
+            ndjson: !!globalFlags['ndjson'],
+            yaml: !!globalFlags['yaml'],
+        });
+        const ctx = await buildContext(globalFlags);
+        requireAuth(ctx);
+        const onProgress = progressHandler(format);
+        const report = await syncFull(ctx, { tables: splitCsv(opts.tables), onProgress });
+        writeResult({
+            ok: report.errors.length === 0,
+            data: report,
+            error: report.errors.length === 0 ? null : { code: 'ErrServer', message: `${report.errors.length} 张表同步失败` },
+            meta: { requestId: 'sync.full', durationMs: 0, scopeChecked: ['sync', 'read'] },
+        }, { format });
+        if (report.errors.length > 0)
+            process.exit(1);
+    });
+}
+function splitCsv(v) {
+    if (!v)
+        return undefined;
+    return v.split(',').map((s) => s.trim()).filter(Boolean);
+}
+function progressHandler(format) {
+    if (format === 'ndjson') {
+        return (e) => process.stdout.write(JSON.stringify({ progress: e }) + '\n');
+    }
+    if (format === 'json') {
+        return () => { };
+    }
+    return (e) => {
+        if (e.phase === 'done')
+            return;
+        const pieces = [`[${e.phase}]`, e.table];
+        if (e.local_version !== undefined)
+            pieces.push(`本地=${e.local_version}`);
+        if (e.server_version !== undefined)
+            pieces.push(`服务器=${e.server_version}`);
+        if (e.direction)
+            pieces.push(`方向=${e.direction}`);
+        if (e.ok === false && e.error)
+            pieces.push(`错误=${e.error}`);
+        if (e.records !== undefined)
+            pieces.push(`记录=${e.records}`);
+        process.stderr.write(pieces.join(' ') + '\n');
+    };
+}
+//# sourceMappingURL=sync.js.map