trove-cli 0.0.0-stage → 0.3.2

package/dist/daemon.js

@@ -0,0 +1,272 @@
+import { spawn } from 'node:child_process';
+import { open, readFile, rename, stat, unlink, writeFile, mkdir, appendFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { isProcessAlive } from './core/lock.js';
+import { execFileSync } from 'node:child_process';
+export const isAlive = isProcessAlive;
+async function readPidFile(paths) {
+    try {
+        const raw = await readFile(paths.daemonPid, 'utf8');
+        const v = JSON.parse(raw);
+        if (typeof v.pid !== 'number')
+            return null;
+        return { pid: v.pid, startedAt: v.startedAt ?? 0 };
+    }
+    catch {
+        return null;
+    }
+}
+/** 单实例锁:pid 文件不存在才创建;陈旧 pid(进程已死)自动接管。 */
+export async function acquireDaemonPid(paths) {
+    await mkdir(dirname(paths.daemonPid), { recursive: true });
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const fh = await open(paths.daemonPid, 'wx');
+            await fh.writeFile(JSON.stringify({ pid: process.pid, startedAt: Date.now() }));
+            await fh.close();
+            return;
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+            const existing = await readPidFile(paths);
+            if (existing && isAlive(existing.pid)) {
+                throw new Error(`daemon 已在运行 (pid ${existing.pid})`);
+            }
+            await unlink(paths.daemonPid).catch(() => { });
+        }
+    }
+    throw new Error('无法获取 daemon 单实例锁');
+}
+export async function releaseDaemonPid(paths) {
+    const existing = await readPidFile(paths);
+    if (!existing || existing.pid === process.pid) {
+        await unlink(paths.daemonPid).catch(() => { });
+    }
+}
+export async function readDaemonStatus(paths) {
+    try {
+        return JSON.parse(await readFile(paths.daemonStatus, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function writeDaemonStatus(paths, status) {
+    await mkdir(dirname(paths.daemonStatus), { recursive: true });
+    const tmp = `${paths.daemonStatus}.tmp`;
+    await writeFile(tmp, JSON.stringify(status, null, 2));
+    await rename(tmp, paths.daemonStatus);
+}
+/** 日志超过 10MB 轮转一份,避免 daemon 无限写。 */
+export async function daemonLog(paths, text) {
+    await mkdir(dirname(paths.daemonLog), { recursive: true });
+    try {
+        const st = await stat(paths.daemonLog);
+        if (st.size > 10 * 1024 * 1024) {
+            await rename(paths.daemonLog, `${paths.daemonLog}.1`).catch(() => { });
+        }
+    }
+    catch {
+        // 日志还不存在
+    }
+    await appendFile(paths.daemonLog, `${new Date().toISOString()} ${text}\n`);
+}
+function logProgress(paths) {
+    let last = 0;
+    return {
+        phase(name, detail) {
+            void daemonLog(paths, `[${name}]${detail ? ` ${detail}` : ''}`);
+        },
+        item(label, current, total) {
+            const now = Date.now();
+            if (now - last < 10_000 && current < total)
+                return;
+            last = now;
+            void daemonLog(paths, `[progress] ${current}/${total} ${label}`);
+        },
+    };
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve();
+        const t = setTimeout(resolve, ms);
+        signal.addEventListener('abort', () => {
+            clearTimeout(t);
+            resolve();
+        }, { once: true });
+    });
+}
+/**
+ * daemon 主循环:sync 与 learn 两个循环并发跑,共享 abort 信号;SIGTERM/abort 后清理 pid 退出。
+ * sync 循环每轮状态写 daemon.status.json,供 `trove daemon status` 读取;learn 循环只写日志。
+ */
+export async function runDaemon(runtime, signal) {
+    const { paths, intervalSeconds, since } = runtime;
+    await acquireDaemonPid(paths);
+    const status = {
+        running: true,
+        pid: process.pid,
+        startedAt: Date.now(),
+        intervalSeconds,
+        since,
+    };
+    await writeDaemonStatus(paths, status);
+    await daemonLog(paths, `daemon 启动 pid=${process.pid} interval=${intervalSeconds}s since=${since}`);
+    try {
+        const loops = [syncLoop(runtime, status, signal)];
+        if (runtime.learnTick)
+            loops.push(learnLoop(runtime, signal));
+        await Promise.all(loops);
+    }
+    finally {
+        status.running = false;
+        status.nextRunAt = undefined;
+        await writeDaemonStatus(paths, status);
+        await releaseDaemonPid(paths);
+        await daemonLog(paths, 'daemon 退出');
+    }
+}
+async function syncLoop(runtime, status, signal) {
+    const { paths, intervalSeconds, runOnce } = runtime;
+    while (!signal.aborted) {
+        const started = Date.now();
+        status.lastRunAt = started;
+        await writeDaemonStatus(paths, status); // 让 status 命令能看到"正在跑"
+        try {
+            const report = await runOnce(logProgress(paths), signal);
+            status.lastResult = {
+                collected: report.collected,
+                pulled: report.pulled,
+                pushed: report.pushed,
+            };
+            status.lastError = undefined;
+            await daemonLog(paths, `同步完成:收集 ${report.collected.archived}/${report.collected.appended} · ` +
+                `拉取 ${report.pulled.downloadedItems} · 推送 ${report.pushed.uploadedItems} · ` +
+                `库拉取 ${report.library?.pulled.downloaded ?? 0} · 库推送 ${report.library?.pushed.uploaded ?? 0} · ` +
+                `${report.durationMs}ms`);
+            if (runtime.afterSync) {
+                try {
+                    const note = await runtime.afterSync(report);
+                    if (note)
+                        await daemonLog(paths, note);
+                }
+                catch (e) {
+                    await daemonLog(paths, `同步后处理失败: ${e.message}`);
+                }
+            }
+        }
+        catch (err) {
+            if (signal.aborted)
+                break; // 主动停止,不算同步失败
+            status.lastError = err.message;
+            await daemonLog(paths, `同步失败: ${status.lastError}`);
+        }
+        status.lastDurationMs = Date.now() - started;
+        status.nextRunAt = Date.now() + intervalSeconds * 1000;
+        await writeDaemonStatus(paths, status);
+        await sleep(intervalSeconds * 1000, signal);
+    }
+}
+/** learn 循环:串行 tick(上一 tick 跑完 LLM 再睡),天然 single-flight,不会与自身重叠。 */
+async function learnLoop(runtime, signal) {
+    const { paths, learnTick, intervalSeconds } = runtime;
+    const interval = runtime.learnIntervalSeconds ?? intervalSeconds;
+    while (!signal.aborted) {
+        try {
+            const note = await learnTick();
+            if (note)
+                await daemonLog(paths, note);
+        }
+        catch (e) {
+            await daemonLog(paths, `经验提取失败: ${e.message}`);
+        }
+        await sleep(interval * 1000, signal);
+    }
+}
+/** 后台启动:spawn 一个独立进程,等待 pid 文件落盘后返回。 */
+export async function startDaemon(opts) {
+    const existing = await readPidFile(opts.paths);
+    if (existing && isAlive(existing.pid)) {
+        throw new Error(`daemon 已在运行 (pid ${existing.pid})`);
+    }
+    await mkdir(dirname(opts.paths.daemonLog), { recursive: true });
+    const fd = await open(opts.paths.daemonLog, 'a');
+    const entry = opts.entry ?? process.argv[1];
+    const child = spawn(process.execPath, [
+        entry,
+        'daemon',
+        'run',
+        '--interval',
+        String(opts.intervalSeconds),
+        '--since',
+        opts.since,
+        ...(opts.raw === true ? ['--raw'] : opts.raw === false ? ['--no-raw'] : []),
+    ], { detached: true, stdio: ['ignore', fd.fd, fd.fd], env: { ...process.env, ...opts.env } });
+    child.unref();
+    await fd.close();
+    for (let i = 0; i < 60; i++) {
+        const pid = await readPidFile(opts.paths);
+        if (pid && isAlive(pid.pid))
+            return pid.pid;
+        if (child.exitCode !== null)
+            break;
+        await new Promise((r) => setTimeout(r, 50));
+    }
+    throw new Error(`daemon 启动超时,请查看 ${opts.paths.daemonLog}`);
+}
+function processStartedAt(pid) {
+    try {
+        const out = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+            encoding: 'utf8',
+        }).trim();
+        const t = Date.parse(out);
+        return Number.isFinite(t) ? t : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 优雅停止:发 SIGTERM,最多等 5 秒;不做 SIGKILL,避免中断写入。 */
+export async function stopDaemon(paths) {
+    const existing = await readPidFile(paths);
+    if (!existing || !isAlive(existing.pid)) {
+        await releaseDaemonPid(paths);
+        return false;
+    }
+    // pid 可能被系统复用:启动时间对不上就只清理陈旧锁,绝不误杀
+    const actualStart = processStartedAt(existing.pid);
+    if (existing.startedAt && actualStart && Math.abs(actualStart - existing.startedAt) > 5000) {
+        await releaseDaemonPid(paths);
+        return false;
+    }
+    process.kill(existing.pid, 'SIGTERM');
+    for (let i = 0; i < 50; i++) {
+        if (!isAlive(existing.pid)) {
+            await releaseDaemonPid(paths);
+            return true;
+        }
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    return false;
+}
+/**
+ * 重启:先优雅停止(没在跑就直接跳过),再按同样的参数后台拉起。
+ * 停止失败(进程没退)时 startDaemon 会因 pid 锁仍在而报错,不会起两个实例。
+ */
+export async function restartDaemon(opts) {
+    const stop = opts.stop ?? stopDaemon;
+    const wasRunning = await stop(opts.paths);
+    const pid = await startDaemon(opts);
+    return { pid, wasRunning };
+}
+export async function daemonState(paths) {
+    const pid = await readPidFile(paths);
+    return {
+        running: Boolean(pid && isAlive(pid.pid)),
+        ...(pid ? { pid: pid.pid } : {}),
+        status: await readDaemonStatus(paths),
+    };
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,4 @@
+/** 字节数 → 人类可读字符串(如 "45 KB"、"1.2 MB"、"106 MB")。 */
+export declare function humanSize(bytes: number): string;
+/** 时间跨度 → "42 秒 / 5 分钟 / 2 小时 / 3 天";调用方自行加「前 / 后」。 */
+export declare function humanSpan(ms: number): string;

package/dist/format.js

@@ -0,0 +1,28 @@
+/** 字节数 → 人类可读字符串(如 "45 KB"、"1.2 MB"、"106 MB")。 */
+export function humanSize(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return '0 B';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ['KB', 'MB', 'GB', 'TB', 'PB'];
+    let value = bytes;
+    let u = -1;
+    while (value >= 1024 && u < units.length - 1) {
+        value /= 1024;
+        u++;
+    }
+    const text = value >= 100 ? String(Math.round(value)) : value.toFixed(1).replace(/\.0$/, '');
+    return `${text} ${units[u]}`;
+}
+/** 时间跨度 → "42 秒 / 5 分钟 / 2 小时 / 3 天";调用方自行加「前 / 后」。 */
+export function humanSpan(ms) {
+    const s = Math.max(0, Math.round(ms / 1000));
+    if (s < 60)
+        return `${s} 秒`;
+    if (s < 3600)
+        return `${Math.round(s / 60)} 分钟`;
+    if (s < 86400)
+        return `${Math.round(s / 3600)} 小时`;
+    return `${Math.round(s / 86400)} 天`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACX,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,KAAK,IAAI,IAAI,CAAC;QACd,CAAC,EAAE,CAAC;IACN,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7F,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;IAChD,IAAI,CAAC,GAAG,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IACnD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;AACtC,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { run } from './cli.js';
+run(process.argv.slice(2))
+    .then((code) => process.exit(code))
+    .catch((e) => {
+    console.error(`错误: ${e.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACX,OAAO,CAAC,KAAK,CAAC,OAAQ,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,19 @@
+/** trove 本地目录布局。 */
+export interface TrovePaths {
+    base: string;
+    config: string;
+    vault: string;
+    /** 游标 + 推送/拉取水位(单文件,原子写) */
+    state: string;
+    /** 自身 LLM 调用的 token 用量台账(JSONL,只追加) */
+    usageLog: string;
+    logs: string;
+    tmp: string;
+    daemonPid: string;
+    daemonStatus: string;
+    daemonLog: string;
+    /** learn 待办队列(不在 vault 内,不参与同步) */
+    learnQueue: string;
+}
+/** 从 base 目录推导全部路径。默认 ~/.trove,可用 TROVE_HOME 覆盖;测试可注入临时 base。 */
+export declare function trovePaths(base?: string): TrovePaths;

package/dist/paths.js

@@ -0,0 +1,19 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** 从 base 目录推导全部路径。默认 ~/.trove,可用 TROVE_HOME 覆盖;测试可注入临时 base。 */
+export function trovePaths(base = process.env.TROVE_HOME || join(homedir(), '.trove')) {
+    return {
+        base,
+        config: join(base, 'config.json'),
+        vault: join(base, 'vault'),
+        state: join(base, 'state.json'),
+        usageLog: join(base, 'usage.jsonl'),
+        logs: join(base, 'logs'),
+        tmp: join(base, 'tmp'),
+        daemonPid: join(base, 'daemon.pid'),
+        daemonStatus: join(base, 'daemon.status.json'),
+        daemonLog: join(base, 'logs', 'daemon.log'),
+        learnQueue: join(base, 'learn-queue.json'),
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAoBjC,iEAAiE;AACjE,MAAM,UAAU,UAAU,CACxB,OAAe,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC;IAElE,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QACjC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAC1B,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QAC/B,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QACtB,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QACnC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC;QAC9C,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC;QAC3C,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/progress-console.d.ts

@@ -0,0 +1,12 @@
+import type { Progress } from './progress.js';
+export interface ConsoleProgressOptions {
+    write: (s: string) => void;
+    tty?: boolean;
+    now?: () => number;
+    intervalMs?: number;
+}
+/**
+ * 终端进度:TTY 用 \r 原地刷新,管道/日志按固定间隔输出,
+ * 避免一次 sync 刷出上万行。最后一项总是输出。
+ */
+export declare function createConsoleProgress(opts: ConsoleProgressOptions): Progress;

package/dist/progress-console.js

@@ -0,0 +1,42 @@
+import { humanSize } from './format.js';
+/**
+ * 终端进度:TTY 用 \r 原地刷新,管道/日志按固定间隔输出,
+ * 避免一次 sync 刷出上万行。最后一项总是输出。
+ */
+export function createConsoleProgress(opts) {
+    const write = opts.write;
+    const tty = opts.tty ?? false;
+    const now = opts.now ?? Date.now;
+    const interval = opts.intervalMs ?? 1000;
+    let phase = '';
+    let lastPrint = 0;
+    let lastLen = 0;
+    const line = (text, final) => {
+        if (tty) {
+            const padded = text + ' '.repeat(Math.max(0, lastLen - text.length));
+            write(`\r${padded}${final ? '\n' : ''}`);
+            lastLen = final ? 0 : text.length;
+        }
+        else {
+            write(`${text}\n`);
+        }
+    };
+    return {
+        phase(name, detail) {
+            phase = name;
+            lastPrint = 0;
+            line(detail ? `[${name}] ${detail}` : `[${name}]`, true);
+        },
+        item(label, current, total, bytes = 0) {
+            const t = now();
+            const final = total > 0 && current >= total;
+            if (!tty && !final && t - lastPrint < interval)
+                return;
+            lastPrint = t;
+            const short = label.length > 64 ? `…${label.slice(-63)}` : label;
+            const size = bytes > 0 ? ` · ${humanSize(bytes)}` : '';
+            line(`[${phase}] ${current}/${total}${size} ${short}`, final);
+        },
+    };
+}
+//# sourceMappingURL=progress-console.js.map

package/dist/progress-console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-console.js","sourceRoot":"","sources":["../src/progress-console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IACzC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;QAC5C,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACrE,KAAK,CAAC,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,IAAI,EAAE,MAAM;YAChB,KAAK,GAAG,IAAI,CAAC;YACb,SAAS,GAAG,CAAC,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC;YACnC,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC;YAC5C,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,QAAQ;gBAAE,OAAO;YACvD,SAAS,GAAG,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;YACjE,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/progress.d.ts

@@ -0,0 +1,7 @@
+/** 进度上报:阶段 + 单项进度;CLI/TUI 各自实现,编排层只依赖此接口。 */
+export interface Progress {
+    phase(name: string, detail?: string): void;
+    item(label: string, current: number, total: number, bytes?: number): void;
+}
+/** 测试/daemon 静默模式。 */
+export declare const silentProgress: Progress;

package/dist/progress.js

@@ -0,0 +1,6 @@
+/** 测试/daemon 静默模式。 */
+export const silentProgress = {
+    phase() { },
+    item() { },
+};
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAMA,sBAAsB;AACtB,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;CACV,CAAC"}

package/dist/remote/create-remote.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteConfig } from '../config.js';
+import type { RemoteStore } from './store.js';
+/**
+ * 按配置构造远端实现。这是 WebDAV 与 S3 唯一的分叉点:
+ * 上层(push/pull/library sync)只认 RemoteStore 接口。
+ */
+export declare function createRemoteFromConfig(config: RemoteConfig): RemoteStore;
+/** 配置是否完整到可以连远端。 */
+export declare function isRemoteConfigured(config: RemoteConfig): boolean;
+/** 远端的可读描述,用于 status 输出。 */
+export declare function describeRemote(config: RemoteConfig): string;
+/**
+ * 远端身份指纹:用来判断"还是同一个远端吗"。
+ *
+ * 换后端(WebDAV → S3)后指纹会变,本地记录的推送/拉取水位自动作废,
+ * 从而把历史数据整份重推到新后端,而不是以为推过了。
+ *
+ * 不含凭证 —— 轮换密钥不该触发一次全量重推。
+ */
+export declare function remoteIdentity(config: RemoteConfig): string;

package/dist/remote/create-remote.js

@@ -0,0 +1,86 @@
+import { resolveEndpoint } from './s3-vendors.js';
+import { S3Store } from './s3-store.js';
+import { WebDavStore } from './webdav-store.js';
+/**
+ * 按配置构造远端实现。这是 WebDAV 与 S3 唯一的分叉点:
+ * 上层(push/pull/library sync)只认 RemoteStore 接口。
+ */
+export function createRemoteFromConfig(config) {
+    if (config.type === 's3') {
+        const endpoint = resolveEndpoint({
+            provider: config.provider,
+            region: config.region,
+            endpoint: config.endpoint,
+        });
+        return new S3Store({
+            endpoint,
+            region: config.region,
+            bucket: config.bucket,
+            accessKeyId: config.accessKeyId,
+            secretAccessKey: config.secretAccessKey,
+            forcePathStyle: config.forcePathStyle ?? false,
+        });
+    }
+    return new WebDavStore({
+        url: config.url,
+        username: config.username,
+        password: config.password,
+    });
+}
+/** 配置是否完整到可以连远端。 */
+export function isRemoteConfigured(config) {
+    if (config.type === 's3') {
+        return Boolean(config.bucket &&
+            config.region &&
+            config.accessKeyId &&
+            config.secretAccessKey &&
+            (config.provider || config.endpoint));
+    }
+    return Boolean(config.url && config.password);
+}
+/** 远端的可读描述,用于 status 输出。 */
+export function describeRemote(config) {
+    if (config.type === 's3') {
+        const endpoint = (() => {
+            try {
+                return resolveEndpoint({
+                    provider: config.provider,
+                    region: config.region,
+                    endpoint: config.endpoint,
+                });
+            }
+            catch {
+                return config.endpoint ?? '(未配置)';
+            }
+        })();
+        return `${endpoint} · ${config.bucket || '(未配置 bucket)'}`;
+    }
+    return config.url;
+}
+/**
+ * 远端身份指纹:用来判断"还是同一个远端吗"。
+ *
+ * 换后端(WebDAV → S3)后指纹会变,本地记录的推送/拉取水位自动作废,
+ * 从而把历史数据整份重推到新后端,而不是以为推过了。
+ *
+ * 不含凭证 —— 轮换密钥不该触发一次全量重推。
+ */
+export function remoteIdentity(config) {
+    if (config.type === 's3') {
+        const endpoint = (() => {
+            try {
+                return resolveEndpoint({
+                    provider: config.provider,
+                    region: config.region,
+                    endpoint: config.endpoint,
+                });
+            }
+            catch {
+                return config.endpoint ?? '';
+            }
+        })();
+        return `s3:${endpoint}/${config.bucket}`;
+    }
+    return `webdav:${config.url}`;
+}
+//# sourceMappingURL=create-remote.js.map

package/dist/remote/create-remote.js.map

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

package/dist/remote/prompt.d.ts

@@ -0,0 +1,17 @@
+import type { RemoteConfig } from '../config.js';
+/**
+ * 远端后端的交互式配置引导。
+ *
+ * 顺序:先选后端类型,再按类型问对应字段 —— 用户不需要先知道要填 URL 还是 Bucket。
+ */
+export type RemoteType = 'webdav' | 's3';
+export declare function isCancel(v: unknown): v is symbol;
+/**
+ * 交互式引导远端配置。
+ *
+ * @param existing 当前配置,用作默认值
+ * @param interactive 是否交互
+ * @param forcedType 强制指定类型(init 的 --type flag)
+ * @returns 远端配置;非交互模式返回 undefined
+ */
+export declare function promptRemoteConfig(existing: RemoteConfig | undefined, interactive: boolean, forcedType?: RemoteType): Promise<RemoteConfig | undefined>;