trove-cli 0.0.0-stage → 0.3.2

package/dist/core/remote-layout.js.map

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

package/dist/core/sessions.d.ts

@@ -0,0 +1,29 @@
+export interface SessionSummary {
+    /** canonical 变体所属设备(并集时为 merged) */
+    device: string;
+    harness: string;
+    session: string;
+    title?: string;
+    firstText?: string;
+    cwd?: string;
+    model?: string;
+    startedAt?: string;
+    /** canonical 事件文件绝对路径 */
+    path: string;
+    bytes: number;
+    events: number;
+    /** 其他内容不同的设备版本数 */
+    variants: number;
+    devices: string[];
+}
+export interface ListSessionsOptions {
+    device?: string;
+    harness?: string;
+    /** 标题/摘要/目录/模型/正文的模糊匹配 */
+    grep?: string;
+}
+/**
+ * 列出 library 里的会话(canonical 视图)。
+ * 索引缺失时按分片重建;--grep 只读命中的 canonical 文件。
+ */
+export declare function listSessions(vaultRoot: string, opts?: ListSessionsOptions): Promise<SessionSummary[]>;

package/dist/core/sessions.js

@@ -0,0 +1,96 @@
+import { createReadStream } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { libraryDir } from './layout.js';
+import { loadLibraryIndex, rebuildUnifiedIndex } from './library/index-file.js';
+function headerMatches(s, needle) {
+    return [s.title, s.firstText, s.cwd, s.model, s.session, s.harness]
+        .filter((v) => Boolean(v))
+        .some((v) => v.toLowerCase().includes(needle));
+}
+function eventMatches(e, needle) {
+    const parts = [
+        e.text,
+        e.title,
+        e.cwd,
+        e.model?.id,
+        e.tool?.name,
+        e.tool?.input === undefined ? undefined : JSON.stringify(e.tool.input),
+        typeof e.result?.output === 'string' ? e.result.output : undefined,
+    ];
+    return parts.some((v) => typeof v === 'string' && v.toLowerCase().includes(needle));
+}
+/** 在 canonical 事件文件里找关键词;命中即停。 */
+async function bodyMatches(path, needle) {
+    const stream = createReadStream(path, { encoding: 'utf8' });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    try {
+        for await (const line of rl) {
+            if (!line.trim())
+                continue;
+            let e;
+            try {
+                e = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (eventMatches(e, needle))
+                return true;
+        }
+        return false;
+    }
+    finally {
+        rl.close();
+        stream.destroy();
+    }
+}
+/**
+ * 列出 library 里的会话(canonical 视图)。
+ * 索引缺失时按分片重建;--grep 只读命中的 canonical 文件。
+ */
+export async function listSessions(vaultRoot, opts = {}) {
+    const index = (await loadLibraryIndex(vaultRoot)) ?? (await rebuildUnifiedIndex(vaultRoot));
+    const needle = opts.grep?.toLowerCase();
+    const out = [];
+    for (const s of Object.values(index.sessions)) {
+        if (opts.harness && s.harness !== opts.harness)
+            continue;
+        if (opts.device && !s.sources.includes(opts.device))
+            continue;
+        if (needle && !headerMatches(s, needle)) {
+            const path = join(libraryDir(vaultRoot), ...s.canonical.path.split('/'));
+            if (!(await bodyMatches(path, needle)))
+                continue;
+        }
+        const path = join(libraryDir(vaultRoot), ...s.canonical.path.split('/'));
+        let bytes = 0;
+        try {
+            bytes = (await stat(path)).size;
+        }
+        catch {
+            // 索引指向的文件缺失:仍然列出,便于发现不一致
+        }
+        out.push({
+            device: s.canonical.device,
+            harness: s.harness,
+            session: s.session,
+            ...(s.title ? { title: s.title } : {}),
+            ...(s.firstText ? { firstText: s.firstText } : {}),
+            ...(s.cwd ? { cwd: s.cwd } : {}),
+            ...(s.model ? { model: s.model } : {}),
+            ...(s.startedAt ? { startedAt: s.startedAt } : {}),
+            path,
+            bytes,
+            events: s.canonical.events,
+            variants: s.variants.length,
+            devices: s.sources,
+        });
+    }
+    out.sort((a, b) => (b.startedAt ?? '').localeCompare(a.startedAt ?? '') ||
+        a.harness.localeCompare(b.harness) ||
+        a.session.localeCompare(b.session));
+    return out;
+}
+//# sourceMappingURL=sessions.js.map

package/dist/core/sessions.js.map

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

package/dist/core/state.d.ts

@@ -0,0 +1,94 @@
+import type { ChunkRef } from './chunker.js';
+import type { FileCursor } from './cursor.js';
+/** 源文件已归档状态(游标 + 会话归属)。 */
+export interface SourceEntry extends FileCursor {
+    /** 会话 id:同一次对话的多个文件共享(豆包目录/多文件会话) */
+    sessionKey: string;
+    /** 会话最近变更时间,用于 --since 过滤 */
+    sessionMtimeMs: number;
+    /** SQLite 类数据源的导出格式版本;变化时强制重新导出 */
+    formatVersion?: number;
+}
+/** 已推送到远端的快照;size 是提交点,chunks 只增不改。 */
+export interface PushedEntry {
+    generation: string;
+    size: number;
+    chunks: ChunkRef[];
+    /** chunks 数组的 sha256,与索引项比对,判断远端是否已是最新 */
+    chunksHash: string;
+}
+/** 已从某个远端设备拉取的快照。 */
+export interface PulledEntry {
+    generation: string;
+    size: number;
+    chunksHash: string;
+}
+export interface DaemonStatus {
+    pid: number;
+    startedAt: number;
+    intervalSeconds: number;
+    since: string;
+    lastRunAt?: number;
+    lastDurationMs?: number;
+    lastError?: string;
+    nextRunAt?: number;
+}
+/** 本设备已构建的会话(增量判断用)。 */
+export interface BuiltEntry {
+    sig: string;
+    hash: string;
+    events: number;
+    path: string;
+    /** 写入后的事件文件大小与 mtime,用于跳过未变化的文件 */
+    size?: number;
+    mtimeMs?: number;
+    /** 映射后得到的会话 id(可能不同于路径推导值) */
+    session?: string;
+    title?: string;
+    firstText?: string;
+    cwd?: string;
+    model?: string;
+    startedAt?: string;
+}
+export interface LibraryState {
+    built: Record<string, BuiltEntry>;
+    /** 已推送的 library 文件: path → {size, hash} */
+    pushed: Record<string, {
+        size: number;
+        mtimeMs?: number;
+        hash?: string;
+    }>;
+    /** 已拉取的 library 文件: device → path → hash */
+    pulled: Record<string, Record<string, string>>;
+    /**
+     * library.pushed 记录所属的远端身份。
+     * 换后端后旧记录对新远端无效,否则会整体跳过上传,只剩索引分片指向不存在的文件。
+     */
+    remoteId?: string;
+}
+export interface State {
+    v: 1;
+    /** harness → 本地文件(或 SQLite 会话) → 游标 */
+    sources: Record<string, Record<string, SourceEntry>>;
+    /** harness → 本地文件 key → 已推送快照 */
+    pushed: Record<string, Record<string, PushedEntry>>;
+    /** 远端设备 id → "harness:key" → 已拉取快照 */
+    pulled: Record<string, Record<string, PulledEntry>>;
+    library: LibraryState;
+    daemon?: DaemonStatus;
+    /**
+     * pushed/pulled 记录所属的远端身份指纹。
+     * 换后端(WebDAV → S3)后这些记录对新远端无效,必须整份重推。
+     */
+    remoteId?: string;
+}
+export declare function emptyLibraryState(): LibraryState;
+export declare function emptyState(): State;
+/** 读取状态;不存在返回空状态。损坏 JSON 抛出可定位的错误。 */
+export declare function loadState(path: string): Promise<State>;
+/** 原子写入:临时文件 + rename,避免进程中断留下半个 JSON。 */
+export declare function saveState(path: string, state: State): Promise<void>;
+/** 取(或创建)某个 harness 的源状态表。 */
+export declare function sourceBucket(state: State, harness: string): Record<string, SourceEntry>;
+export declare function pushedBucket(state: State, harness: string): Record<string, PushedEntry>;
+export declare function pulledBucket(state: State, deviceId: string): Record<string, PulledEntry>;

package/dist/core/state.js

@@ -0,0 +1,62 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+export function emptyLibraryState() {
+    return { built: {}, pushed: {}, pulled: {} };
+}
+export function emptyState() {
+    return { v: 1, sources: {}, pushed: {}, pulled: {}, library: emptyLibraryState() };
+}
+/** 读取状态;不存在返回空状态。损坏 JSON 抛出可定位的错误。 */
+export async function loadState(path) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return emptyState();
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`state 损坏,无法解析 JSON: ${path}`);
+    }
+    // 旧版对话层挂在 raw 下(_events/),已迁到 library:读入时清掉遗留条目
+    for (const bucket of Object.values(parsed.sources ?? {})) {
+        for (const key of Object.keys(bucket)) {
+            if (key.startsWith('_events/'))
+                delete bucket[key];
+        }
+    }
+    return {
+        v: 1,
+        sources: parsed.sources ?? {},
+        pushed: parsed.pushed ?? {},
+        pulled: parsed.pulled ?? {},
+        library: parsed.library ?? emptyLibraryState(),
+        ...(parsed.daemon ? { daemon: parsed.daemon } : {}),
+        ...(parsed.remoteId ? { remoteId: parsed.remoteId } : {}),
+    };
+}
+/** 原子写入:临时文件 + rename,避免进程中断留下半个 JSON。 */
+export async function saveState(path, state) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = join(dirname(path), `.state.tmp-${randomUUID()}`);
+    await writeFile(tmp, JSON.stringify(state), 'utf8');
+    await rename(tmp, path);
+}
+/** 取(或创建)某个 harness 的源状态表。 */
+export function sourceBucket(state, harness) {
+    return (state.sources[harness] ??= {});
+}
+export function pushedBucket(state, harness) {
+    return (state.pushed[harness] ??= {});
+}
+export function pulledBucket(state, deviceId) {
+    return (state.pulled[deviceId] ??= {});
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

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

package/dist/core/sync.d.ts

@@ -0,0 +1,48 @@
+import { type CollectResult } from './collect.js';
+import { type PullResult } from './pull.js';
+import { type PushResult } from './push.js';
+import { type PullLibraryResult, type PushLibraryResult } from './library/sync.js';
+import { type Progress } from '../progress.js';
+import type { Adapter } from '../adapters/index.js';
+import type { RemoteStore } from '../remote/store.js';
+export interface SyncOptions {
+    adapters: Adapter[];
+    deviceId: string;
+    deviceName: string;
+    vaultRoot: string;
+    statePath: string;
+    /** null = 本地模式(未配置远端),只归档到本地 vault,不做远端拉/推 */
+    remote: RemoteStore | null;
+    /** 远端身份指纹;换后端时本地推送水位作废,历史数据整份重推。 */
+    remoteId?: string;
+    /** 0 = 全量;否则只收集最近变更的会话 */
+    cutoff: number;
+    tmpDir?: string;
+    chunkSize?: number;
+    concurrency?: number;
+    progress?: Progress;
+    now?: () => number;
+    pullOnly?: boolean;
+    pushOnly?: boolean;
+    /** false 时只同步对话层(_events/),raw 只归档到本地 */
+    rawSync?: boolean;
+    signal?: AbortSignal;
+}
+export interface SyncReport {
+    collected: CollectResult;
+    pulled: PullResult;
+    pushed: PushResult;
+    library: {
+        pulled: PullLibraryResult;
+        pushed: PushLibraryResult;
+    };
+    /** 本轮开始时检测到远端身份变化(切换后端/换桶)。 */
+    remoteChanged: boolean;
+    durationMs: number;
+}
+/**
+ * 一次完整同步:collect(本机 → vault)→ pull(远端 → vault)→ push(vault → 远端)。
+ * 每个阶段结束都落状态,长同步被打断也不必从头再来。
+ */
+/** 同一份 vault/state 只允许一个进程写:daemon 与手动 sync 共用此锁。 */
+export declare function sync(opts: SyncOptions): Promise<SyncReport>;

package/dist/core/sync.js

@@ -0,0 +1,140 @@
+import { collect } from './collect.js';
+import { pullRemote } from './pull.js';
+import { pushLocal } from './push.js';
+import { pullLibrary, pushLibrary } from './library/sync.js';
+import { acquireLock } from './lock.js';
+import { loadState, saveState } from './state.js';
+import { metaPath } from './remote-layout.js';
+import { silentProgress } from '../progress.js';
+const emptyCollect = {
+    discovered: 0,
+    archived: 0,
+    appended: 0,
+    skipped: 0,
+    outOfWindow: 0,
+    bytesCopied: 0,
+    sessions: 0,
+    changedSessions: [],
+};
+const emptyPull = {
+    downloadedChunks: 0,
+    downloadedBytes: 0,
+    downloadedItems: 0,
+    skippedItems: 0,
+};
+const emptyPush = {
+    uploadedChunks: 0,
+    uploadedBytes: 0,
+    uploadedItems: 0,
+    skippedItems: 0,
+};
+/**
+ * 一次完整同步:collect(本机 → vault)→ pull(远端 → vault)→ push(vault → 远端)。
+ * 每个阶段结束都落状态,长同步被打断也不必从头再来。
+ */
+/** 同一份 vault/state 只允许一个进程写:daemon 与手动 sync 共用此锁。 */
+export async function sync(opts) {
+    const release = await acquireLock(`${opts.statePath}.lock`);
+    try {
+        return await syncUnlocked(opts);
+    }
+    finally {
+        await release();
+    }
+}
+async function syncUnlocked(opts) {
+    const now = opts.now ?? Date.now;
+    const started = now();
+    const progress = opts.progress ?? silentProgress;
+    const state = await loadState(opts.statePath);
+    // 本轮开始时判断是否换了远端;push 阶段会更新 state.remoteId,所以必须提前算
+    const remoteChanged = Boolean(opts.remoteId && state.remoteId && opts.remoteId !== state.remoteId);
+    let collected = emptyCollect;
+    if (!opts.pullOnly) {
+        collected = await collect({
+            adapters: opts.adapters,
+            deviceId: opts.deviceId,
+            vaultRoot: opts.vaultRoot,
+            state,
+            cutoff: opts.cutoff,
+            progress,
+            tmpDir: opts.tmpDir,
+            signal: opts.signal,
+        });
+        await saveState(opts.statePath, state);
+    }
+    const emptyLibrary = {
+        pulled: { downloaded: 0, bytes: 0, skipped: 0 },
+        pushed: { uploaded: 0, bytes: 0, skipped: 0 },
+    };
+    let pulled = emptyPull;
+    let libraryPulled = emptyLibrary.pulled;
+    if (!opts.pushOnly) {
+        if (opts.remote) {
+            if (opts.rawSync !== false)
+                pulled = await pullRemote({
+                    remote: opts.remote,
+                    deviceId: opts.deviceId,
+                    vaultRoot: opts.vaultRoot,
+                    state,
+                    progress,
+                    signal: opts.signal,
+                });
+            libraryPulled = await pullLibrary({
+                remote: opts.remote,
+                vaultRoot: opts.vaultRoot,
+                deviceId: opts.deviceId,
+                state,
+                progress,
+                signal: opts.signal,
+            });
+        }
+        await saveState(opts.statePath, state);
+    }
+    let pushed = emptyPush;
+    let libraryPushed = emptyLibrary.pushed;
+    if (!opts.pullOnly) {
+        if (opts.remote) {
+            if (opts.rawSync !== false)
+                pushed = await pushLocal({
+                    remote: opts.remote,
+                    deviceId: opts.deviceId,
+                    vaultRoot: opts.vaultRoot,
+                    state,
+                    remoteId: opts.remoteId,
+                    now,
+                    chunkSize: opts.chunkSize,
+                    concurrency: opts.concurrency,
+                    progress,
+                    signal: opts.signal,
+                });
+            libraryPushed = await pushLibrary({
+                remote: opts.remote,
+                vaultRoot: opts.vaultRoot,
+                deviceId: opts.deviceId,
+                state,
+                remoteId: opts.remoteId,
+                statePath: opts.statePath,
+                progress,
+                signal: opts.signal,
+            });
+            if (opts.rawSync !== false) {
+                await opts.remote.writeJson(metaPath(opts.deviceId), {
+                    id: opts.deviceId,
+                    name: opts.deviceName,
+                    lastSeen: now(),
+                });
+            }
+        }
+        await saveState(opts.statePath, state);
+    }
+    return {
+        collected,
+        pulled,
+        pushed,
+        library: { pulled: libraryPulled, pushed: libraryPushed },
+        remoteChanged,
+        durationMs: now() - started,
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/sync.js.map

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

package/dist/core/time-window.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 同步时间窗:只收集「最近变更」的会话,避免首次全量过大。
+ * 单位支持 m/h/d/w;all 表示不限制;也接受 YYYY-MM-DD(本地零点)。
+ */
+/** 返回截止时间(ms);0 表示不限制。非法输入抛错。 */
+export declare function parseSince(input: string, now?: number): number;
+/** 展示用:0 显示 all,其它显示本地日期时间。 */
+export declare function formatSince(cutoff: number): string;

package/dist/core/time-window.js

@@ -0,0 +1,36 @@
+/**
+ * 同步时间窗:只收集「最近变更」的会话,避免首次全量过大。
+ * 单位支持 m/h/d/w;all 表示不限制;也接受 YYYY-MM-DD(本地零点)。
+ */
+const UNIT_MS = {
+    m: 60_000,
+    h: 3600_000,
+    d: 86_400_000,
+    w: 7 * 86_400_000,
+};
+/** 返回截止时间(ms);0 表示不限制。非法输入抛错。 */
+export function parseSince(input, now = Date.now()) {
+    const raw = input.trim().toLowerCase();
+    if (raw === 'all' || raw === '' || raw === '0')
+        return 0;
+    const rel = /^(\d+)([mhdw])$/.exec(raw);
+    if (rel) {
+        const n = Number(rel[1]);
+        return now - n * UNIT_MS[rel[2]];
+    }
+    if (/^\d{4}-\d{2}-\d{2}$/.test(raw)) {
+        const t = new Date(`${raw}T00:00:00`).getTime();
+        if (Number.isFinite(t))
+            return t;
+    }
+    throw new Error(`无法解析时间范围 "${input}"(示例:7d / 24h / 2026-10-01 / all)`);
+}
+/** 展示用:0 显示 all,其它显示本地日期时间。 */
+export function formatSince(cutoff) {
+    if (!cutoff)
+        return 'all';
+    const d = new Date(cutoff);
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+}
+//# sourceMappingURL=time-window.js.map

package/dist/core/time-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-window.js","sourceRoot":"","sources":["../../src/core/time-window.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,GAA2B;IACtC,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,CAAC,GAAG,UAAU;CAClB,CAAC;AAEF,iCAAiC;AACjC,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAChE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC;IAEzD,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAE,CAAE,CAAC;IACrC,CAAC;IAED,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;QAChD,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,mCAAmC,CAAC,CAAC;AACzE,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AAC/G,CAAC"}

package/dist/daemon.d.ts

@@ -0,0 +1,73 @@
+import { isProcessAlive } from './core/lock.js';
+import type { Progress } from './progress.js';
+import type { SyncReport } from './core/sync.js';
+import type { TrovePaths } from './paths.js';
+export interface DaemonStatusFile {
+    running: boolean;
+    pid: number;
+    startedAt: number;
+    intervalSeconds: number;
+    since: string;
+    lastRunAt?: number;
+    lastDurationMs?: number;
+    lastError?: string;
+    lastResult?: Pick<SyncReport, 'collected' | 'pulled' | 'pushed'>;
+    nextRunAt?: number;
+}
+export interface DaemonRuntime {
+    paths: TrovePaths;
+    intervalSeconds: number;
+    since: string;
+    /** 一轮同步;由 CLI 注入(config/adapters/remote 的组装) */
+    runOnce: (progress: Progress, signal: AbortSignal) => Promise<SyncReport>;
+    /** 同步成功后触发(把本轮新会话入队等);返回可选的日志行。失败只记日志,不中断循环。 */
+    afterSync?: (report: SyncReport) => Promise<string | undefined>;
+    /** learn 独立循环的 tick:处理队列里最多 learnBatch 个候选。缺省不启 learn 循环。 */
+    learnTick?: () => Promise<string | undefined>;
+    /** learn 循环间隔秒数;缺省等同 intervalSeconds。 */
+    learnIntervalSeconds?: number;
+}
+export declare const isAlive: typeof isProcessAlive;
+/** 单实例锁:pid 文件不存在才创建;陈旧 pid(进程已死)自动接管。 */
+export declare function acquireDaemonPid(paths: TrovePaths): Promise<void>;
+export declare function releaseDaemonPid(paths: TrovePaths): Promise<void>;
+export declare function readDaemonStatus(paths: TrovePaths): Promise<DaemonStatusFile | null>;
+/** 日志超过 10MB 轮转一份,避免 daemon 无限写。 */
+export declare function daemonLog(paths: TrovePaths, text: string): Promise<void>;
+/**
+ * daemon 主循环:sync 与 learn 两个循环并发跑,共享 abort 信号;SIGTERM/abort 后清理 pid 退出。
+ * sync 循环每轮状态写 daemon.status.json,供 `trove daemon status` 读取;learn 循环只写日志。
+ */
+export declare function runDaemon(runtime: DaemonRuntime, signal: AbortSignal): Promise<void>;
+export interface StartDaemonOptions {
+    paths: TrovePaths;
+    intervalSeconds: number;
+    since: string;
+    /** 显式 raw 同步开关;undefined = 跟随配置 */
+    raw?: boolean;
+    /** 默认 process.argv[1](构建后的 dist/main.js) */
+    entry?: string;
+    /** 追加/覆盖子进程环境变量(init 用它把 TROVE_HOME 传给子进程) */
+    env?: NodeJS.ProcessEnv;
+}
+/** 后台启动:spawn 一个独立进程,等待 pid 文件落盘后返回。 */
+export declare function startDaemon(opts: StartDaemonOptions): Promise<number>;
+/** 优雅停止:发 SIGTERM,最多等 5 秒;不做 SIGKILL,避免中断写入。 */
+export declare function stopDaemon(paths: TrovePaths): Promise<boolean>;
+export interface RestartDaemonOptions extends StartDaemonOptions {
+    /** 停止函数;测试注入 stub */
+    stop?: (paths: TrovePaths) => Promise<boolean>;
+}
+/**
+ * 重启:先优雅停止(没在跑就直接跳过),再按同样的参数后台拉起。
+ * 停止失败(进程没退)时 startDaemon 会因 pid 锁仍在而报错,不会起两个实例。
+ */
+export declare function restartDaemon(opts: RestartDaemonOptions): Promise<{
+    pid: number;
+    wasRunning: boolean;
+}>;
+export declare function daemonState(paths: TrovePaths): Promise<{
+    running: boolean;
+    pid?: number;
+    status: DaemonStatusFile | null;
+}>;