weflow-cli 1.6.4 → 1.8.0

package/dist/src/services/syncService.js

@@ -0,0 +1,263 @@
+import { DEFAULT_OVERLAP_SECONDS, SYNC_SOURCE, emptySyncState, makeJobId, syncStateStore, } from './syncState.js';
+/** A window wider than this is worth warning about: the read is not bounded. */
+export const WIDE_WINDOW_SECONDS = 90 * 24 * 3600;
+export class SyncRangeRequiredError extends Error {
+    code = 'SYNC_RANGE_REQUIRED';
+    constructor() {
+        super('首次同步需要 --since <日期> 或 --full');
+        this.name = 'SyncRangeRequiredError';
+    }
+}
+/**
+ * Stable identity for one message.
+ *
+ * `serverId` wins when nonzero; otherwise `localId` is paired with
+ * `createTime`. A bare `localId` is never an identity - it restarts in every
+ * shard, which is the whole reason D-014 exists.
+ *
+ * `shard` is intentionally absent: messages do not carry it, adding one would
+ * touch the fenced export contract, and overlap dedup does not need it (the
+ * same message read twice yields the same serverId or the same pair).
+ */
+export function messageIdentity(source, talker, message) {
+    const serverId = String(message.serverId ?? '').trim();
+    if (serverId && serverId !== '0')
+        return `${source}|${talker}|s:${serverId}`;
+    return `${source}|${talker}|l:${message.localId}|t:${message.createTime}`;
+}
+/**
+ * Work out what to read.
+ *
+ * Without a prior checkpoint there is nothing to resume from, so the caller
+ * must say how far back to go - guessing "everything" would silently turn a
+ * routine sync into a full-history read.
+ */
+export function computeWindow(prior, options) {
+    const overlapSeconds = options.overlapSeconds ?? prior?.checkpoint.overlapSeconds
+        ?? DEFAULT_OVERLAP_SECONDS;
+    const to = options.now ?? Math.floor(Date.now() / 1000);
+    if (options.full) {
+        return { from: null, to, overlapSeconds, full: true };
+    }
+    if (options.since !== undefined) {
+        return { from: options.since, to, overlapSeconds, full: false };
+    }
+    const newest = prior?.checkpoint.newestCreateTime;
+    if (prior && typeof newest === 'number') {
+        // Back up by the overlap: a second-resolution timestamp is not a cursor,
+        // so the boundary messages have to be read again and deduplicated.
+        return { from: Math.max(0, newest - overlapSeconds), to, overlapSeconds, full: false };
+    }
+    throw new SyncRangeRequiredError();
+}
+/** Drop repeats the overlap window re-read. */
+export function dedupeMessages(messages, source, talker) {
+    const seen = new Set();
+    const unique = [];
+    for (const message of messages) {
+        const identity = messageIdentity(source, talker, message);
+        if (seen.has(identity))
+            continue;
+        seen.add(identity);
+        unique.push(message);
+    }
+    return { unique, duplicateCount: messages.length - unique.length };
+}
+/**
+ * Decide how much of the read we can stand behind.
+ *
+ * `partial` is the only value that must not be reported as success.
+ *
+ * A short-page truncation cannot occur here because this pass reads in one
+ * call rather than paging; `collectMessagesInRangeDetailed` detects that case
+ * for the paged readers and is where a future revision of this should look.
+ */
+export function deriveCoverage(input) {
+    if (input.mayHaveMore)
+        return 'partial';
+    // Any per-shard reason means those rows were not read: a fault after opening
+    // (READ_FAILED), a table the reader can name nothing in (SCHEMA_MISMATCH), or
+    // a window the shard cannot express (WINDOW_UNAVAILABLE). Coverage is about
+    // whether the range was read, so all of them make it partial. A shard read
+    // with columns missing is *not* one of these - its rows did come back.
+    // A shard that never opened is a different answer and stays 'unverified'
+    // below: nothing is known about its rows either way, which is not the same
+    // claim as knowing they were missed.
+    const anyShardUnread = input.shards?.items.some(item => item.opened && item.reason);
+    if (anyShardUnread)
+        return 'partial';
+    if (!input.shards)
+        return 'unverified';
+    // A shard that never opened is not knowable either way; say so rather than
+    // claiming completeness or declaring failure.
+    if (input.shards.failed > 0)
+        return 'unverified';
+    return 'complete';
+}
+export function buildNextState(input) {
+    const state = input.prior ?? emptySyncState(input.talker, input.scope, input.source, input.window.overlapSeconds);
+    // Same form as coveredFrom/coveredTo: an offset, not a bare Z. A file that
+    // mixes the two makes "which local day was this?" unanswerable.
+    const stamp = isoFromSeconds(input.now ?? Math.floor(Date.now() / 1000));
+    const priorFrom = state.coveredFrom;
+    let coveredFrom = priorFrom;
+    if (input.window.full) {
+        // The database's true minimum is not knowable without another query, so
+        // this is the oldest row we actually saw and says so in `warnings`.
+        coveredFrom = input.oldestCreateTime ? isoFromSeconds(input.oldestCreateTime) : priorFrom;
+    }
+    else if (input.window.from !== null) {
+        const candidate = isoFromSeconds(input.window.from);
+        coveredFrom = priorFrom && priorFrom < candidate ? priorFrom : candidate;
+    }
+    return {
+        ...state,
+        scope: input.scope,
+        talker: input.talker,
+        source: input.source,
+        coveredFrom,
+        coveredTo: isoFromSeconds(input.window.to),
+        checkpoint: {
+            newestCreateTime: input.newestCreateTime ?? state.checkpoint.newestCreateTime,
+            overlapSeconds: input.window.overlapSeconds,
+        },
+        recordsRead: input.recordsRead,
+        recordsDeduplicated: input.recordsDeduplicated,
+        recordsReturned: input.recordsReturned,
+        shardsRead: input.shards?.opened ?? 0,
+        shardsFailed: input.shards?.failed ?? 0,
+        shards: input.shards
+            ? { scanned: input.shards.scanned, opened: input.shards.opened,
+                failed: input.shards.failed, items: input.shards.items }
+            : { scanned: 0, opened: 0, failed: 0, items: [] },
+        coverage: input.coverage,
+        mayHaveMore: input.mayHaveMore,
+        warnings: input.warnings,
+        // The attempt always advances; the success does not, so a partial run is
+        // never mistaken for a good one later.
+        lastAttempt: stamp,
+        lastSuccessfulRun: input.coverage === 'partial' ? state.lastSuccessfulRun : stamp,
+        updatedAt: stamp,
+    };
+}
+function isoFromSeconds(seconds) {
+    const date = new Date(seconds * 1000);
+    const offsetMinutes = -date.getTimezoneOffset();
+    const sign = offsetMinutes >= 0 ? '+' : '-';
+    const pad = (value) => String(Math.floor(Math.abs(value))).padStart(2, '0');
+    const local = new Date(date.getTime() + offsetMinutes * 60_000);
+    const body = local.toISOString().slice(0, 19);
+    return `${body}${sign}${pad(offsetMinutes / 60)}:${pad(offsetMinutes % 60)}`;
+}
+/**
+ * Run one pass. Writes state and a job record unless `write: false`.
+ *
+ * A partial run still writes (the spec forbids discarding usable results) but
+ * returns `success: false` with `code: 'SYNC_PARTIAL'` so nothing downstream
+ * treats it as complete.
+ */
+export async function runSync(talker, options) {
+    const source = options.source ?? SYNC_SOURCE;
+    const scope = options.scope ?? talker;
+    const store = options.store ?? syncStateStore;
+    const prior = store.read(source, talker);
+    const window = computeWindow(prior, options);
+    const warnings = [];
+    if (window.full)
+        warnings.push('full-scan');
+    if (window.from !== null && window.to - window.from > WIDE_WINDOW_SECONDS) {
+        warnings.push('wide-window');
+    }
+    const limit = options.limit ?? 0;
+    const read = await options.read(talker, limit, window.from);
+    const { unique, duplicateCount } = dedupeMessages(read.messages, source, talker);
+    // The window is applied here as well as being pushed down, and this filter -
+    // not the pushdown - is what makes the result correct: a backend without
+    // range support returns the whole conversation, and one that cannot express
+    // the lower bound says so per shard rather than quietly dropping the bound.
+    const inWindow = window.from === null
+        ? unique
+        : unique.filter(m => Number(m.createTime) >= window.from);
+    const newestCreateTime = inWindow.length
+        ? Math.max(...inWindow.map(m => Number(m.createTime) || 0))
+        : null;
+    const oldestCreateTime = inWindow.length
+        ? Math.min(...inWindow.map(m => Number(m.createTime) || 0))
+        : null;
+    const mayHaveMore = limit > 0 && read.messages.length >= limit;
+    const coverage = deriveCoverage({ shards: read.shards, mayHaveMore });
+    if (!read.shards)
+        warnings.push('shard-report-unavailable');
+    if (read.shards) {
+        for (const item of read.shards.items) {
+            if (!item.opened)
+                warnings.push(`shard-unverified:${item.name}`);
+            else if (item.reason === 'READ_FAILED')
+                warnings.push(`shard-read-failed:${item.name}`);
+            // A shard the reader could not name anything in, or could not apply the
+            // window to. Both mean "this range was not read here", which must not
+            // pass as covered - hence a warning rather than a silent skip.
+            else if (item.reason)
+                warnings.push(`shard-not-read:${item.name}:${item.reason}`);
+            // Read, but with fields missing. Column names are schema, not content,
+            // so this stays safe to record in the state file.
+            else if (item.missingColumns?.length) {
+                warnings.push(`shard-columns-missing:${item.name}:${item.missingColumns.join('+')}`);
+            }
+        }
+    }
+    const next = buildNextState({
+        prior, talker, scope, source, window,
+        recordsRead: read.messages.length,
+        recordsDeduplicated: duplicateCount,
+        recordsReturned: inWindow.length,
+        newestCreateTime, oldestCreateTime,
+        shards: read.shards, coverage, mayHaveMore, warnings,
+        // Same clock as the window: without this the recorded attempt would come
+        // from Date.now() while window.to came from the caller's `now`.
+        now: options.now,
+    });
+    const partial = coverage === 'partial';
+    let jobId = null;
+    if (options.write !== false) {
+        jobId = makeJobId();
+        const job = {
+            schema: 'weflow-job/v1',
+            jobId,
+            kind: 'sync.messages',
+            state: partial ? 'partial' : 'completed',
+            createdAt: next.lastAttempt,
+            updatedAt: next.lastAttempt,
+            window: { from: window.from, to: window.to },
+            progress: { completed: inWindow.length, total: read.messages.length },
+            resumeable: partial,
+            result: {
+                records: inWindow.length,
+                recordsDeduplicated: duplicateCount,
+                shardsFailed: read.shards?.failed ?? 0,
+                coverage,
+            },
+            error: partial ? 'SYNC_PARTIAL' : null,
+        };
+        store.write(next);
+        store.writeJob(job);
+    }
+    return {
+        success: !partial,
+        code: partial ? 'SYNC_PARTIAL' : undefined,
+        action: 'sync.messages',
+        scope,
+        window,
+        recordsRead: read.messages.length,
+        recordsDeduplicated: duplicateCount,
+        recordsReturned: inWindow.length,
+        shards: read.shards,
+        coverage,
+        mayHaveMore,
+        partial,
+        warnings,
+        jobId,
+        state: next,
+    };
+}
+//# sourceMappingURL=syncService.js.map

package/dist/src/services/syncService.js.map

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

package/dist/src/services/syncState.d.ts

@@ -0,0 +1,113 @@
+export declare const SYNC_SCHEMA = "weflow-sync/v1";
+export declare const JOB_SCHEMA = "weflow-job/v1";
+export declare const SYNC_SOURCE = "wechat-nt";
+export declare const DEFAULT_OVERLAP_SECONDS = 300;
+/** 单次运行的结局。partial 是本项目新增的一档——部分完成不算成功。 */
+export type JobState = 'planned' | 'waiting_confirmation' | 'running' | 'paused' | 'completed' | 'partial' | 'failed' | 'cancelled';
+/**
+ * 覆盖可信度。这是对「有没有读全」的正面回答, 不是内部细节。
+ *
+ *  - complete   扫到的分片全部打开、打开的全读成功, 且没有更多
+ *  - unverified 有分片打不开, 但打开的都读成功——已读部分可信, 未打开的分片内容无法判断
+ *  - partial    已打开的分片读失败, 或还有更多, 或分页提前结束
+ */
+export type SyncCoverage = 'complete' | 'unverified' | 'partial';
+export interface SyncShardItem {
+    /** 仅 basename——绝不落绝对路径 */
+    name: string;
+    opened: boolean;
+    hasTalkerTable: boolean | null;
+    rowsForTalker: number | null;
+    /** null | KEY_REJECTED | OPEN_FAILED | READ_FAILED */
+    reason: string | null;
+}
+export interface SyncState {
+    schema: string;
+    schemaVersion: number;
+    source: string;
+    scope: string;
+    talker: string;
+    lastSuccessfulRun: string | null;
+    lastAttempt: string | null;
+    coveredFrom: string | null;
+    coveredTo: string | null;
+    checkpoint: {
+        newestCreateTime: number | null;
+        overlapSeconds: number;
+    };
+    recordsRead: number;
+    recordsDeduplicated: number;
+    recordsReturned: number;
+    shardsRead: number;
+    shardsFailed: number;
+    shards: {
+        scanned: number;
+        opened: number;
+        failed: number;
+        items: SyncShardItem[];
+    };
+    coverage: SyncCoverage;
+    mayHaveMore: boolean;
+    warnings: string[];
+    updatedAt: string | null;
+}
+export interface JobRecord {
+    schema: string;
+    jobId: string;
+    kind: string;
+    state: JobState;
+    createdAt: string;
+    updatedAt: string;
+    window: {
+        from: number | null;
+        to: number | null;
+    } | null;
+    progress: {
+        completed: number;
+        total: number;
+    } | null;
+    resumeable: boolean;
+    result: Record<string, unknown> | null;
+    error: string | null;
+}
+/** 未知 schema 时不覆盖原文件, 交由调用方决定如何处理。 */
+export declare class UnknownSchemaError extends Error {
+    readonly path: string;
+    readonly found: unknown;
+    constructor(path: string, found: unknown);
+}
+/**
+ * 递归剔除不该落盘的字段。
+ *
+ * 状态文件是本机产物, 但一旦被日志、issue 或截图带出去就是泄露, 所以在写入
+ * 这一层兜底, 而不是指望每个调用方都记得。
+ */
+export declare function sanitizeForState(value: unknown): unknown;
+/**
+ * 文件名里只放一个可读前缀和一个 hash。
+ *
+ * hash 后缀让 `wxid_a@chatroom` 与 `wxid_a_chatroom` 落到不同文件, 而显示名
+ * 不会出现在目录列表里。
+ */
+export declare function talkerSlug(talker: string): string;
+export declare function emptySyncState(talker: string, scope?: string, source?: string, overlapSeconds?: number): SyncState;
+export declare class SyncStateStore {
+    private readonly syncDir;
+    private readonly jobsDir;
+    constructor(syncDir?: string, jobsDir?: string);
+    statePath(source: string, talker: string): string;
+    /** 读取检查点。无记录返回 null; schema 不认识则抛错, 不猜测。 */
+    read(source: string, talker: string): SyncState | null;
+    write(state: SyncState): void;
+    /** 所有会话的检查点, 最近尝试在前。目录缺失或单个文件损坏都不影响其余。 */
+    list(): SyncState[];
+    jobPath(jobId: string): string;
+    writeJob(job: JobRecord): void;
+    readJob(jobId: string): JobRecord | null;
+    /** 最近的 job 记录, 最新在前。 */
+    recentJobs(limit?: number): JobRecord[];
+}
+export declare const syncStateStore: SyncStateStore;
+/** jobId 形如 job_20260919_0001。同日按时间戳后四位递增, 保证可排序。 */
+export declare function makeJobId(now?: Date): string;
+//# sourceMappingURL=syncState.d.ts.map

package/dist/src/services/syncState.d.ts.map

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

package/dist/src/services/syncState.js

@@ -0,0 +1,214 @@
+/**
+ * 同步检查点与任务记录的本地状态。
+ *
+ * 两个位置, 生命周期不同 (见 docs/SYNC_CONTRACT.md):
+ *   ~/.weflow-cli/sync/<source>-<name>-<hash>.json  跨运行的检查点, 每会话一份
+ *   ~/.weflow-cli/jobs/<jobId>.json                 单次运行的记录
+ *
+ * 按会话分文件而不是一个全局文件: 全局文件要求跨会话读改写并合并, 分文件则每次
+ * 写入都是整文件原子替换 (沿用 assistantMemory.ts 的 tmp + rename 做法)。
+ *
+ * 两条本模块特有的规矩:
+ *   - 遇到不认识的 schema 一律拒绝覆盖并报错, 不猜测字段含义;
+ *   - 写盘前统一过一遍脱敏, 保证密钥/绝对路径不会进状态文件 (D-001 / D-002 / D-025)。
+ */
+import { createHash } from 'crypto';
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import os from 'os';
+export const SYNC_SCHEMA = 'weflow-sync/v1';
+export const JOB_SCHEMA = 'weflow-job/v1';
+export const SYNC_SOURCE = 'wechat-nt';
+export const DEFAULT_OVERLAP_SECONDS = 300;
+/** 未知 schema 时不覆盖原文件, 交由调用方决定如何处理。 */
+export class UnknownSchemaError extends Error {
+    path;
+    found;
+    constructor(path, found) {
+        super(`不认识的 schema: ${String(found)} (${path})`);
+        this.path = path;
+        this.found = found;
+        this.name = 'UnknownSchemaError';
+    }
+}
+const CONFIG_DIR = join(os.homedir(), '.weflow-cli');
+const SYNC_DIR = join(CONFIG_DIR, 'sync');
+const JOBS_DIR = join(CONFIG_DIR, 'jobs');
+const FORBIDDEN_KEYS = /^(ntKey|ntSalt|decryptKey|favKey|favPassphrase|contactKey|snsKey|wechatOcToken|apiKey|password|auth)$/i;
+/** 密钥形状的十六进制串 (>=32 hex)。 */
+const HEX_KEY = /\b[0-9a-f]{32,}\b/gi;
+/** Windows 盘符、UNC、以及 POSIX 绝对路径。三类都要, 早期只处理了第一类。 */
+const ABS_PATH = /(?:[A-Za-z]:[\\/][^\s"']*|\\\\[^\s"']+|\/(?:Users|home|root|var|tmp|opt|mnt)\/[^\s"']*)/g;
+/**
+ * 递归剔除不该落盘的字段。
+ *
+ * 状态文件是本机产物, 但一旦被日志、issue 或截图带出去就是泄露, 所以在写入
+ * 这一层兜底, 而不是指望每个调用方都记得。
+ */
+export function sanitizeForState(value) {
+    if (typeof value === 'string') {
+        return value.replace(HEX_KEY, '<redacted>').replace(ABS_PATH, '<path>');
+    }
+    if (Array.isArray(value))
+        return value.map(sanitizeForState);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (FORBIDDEN_KEYS.test(key))
+                continue;
+            out[key] = sanitizeForState(item);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * 文件名里只放一个可读前缀和一个 hash。
+ *
+ * hash 后缀让 `wxid_a@chatroom` 与 `wxid_a_chatroom` 落到不同文件, 而显示名
+ * 不会出现在目录列表里。
+ */
+export function talkerSlug(talker) {
+    const readable = talker.replace(/[^A-Za-z0-9._-]+/g, '_').slice(0, 60);
+    const digest = createHash('sha256').update(talker).digest('hex').slice(0, 8);
+    return `${readable}-${digest}`;
+}
+function writeAtomic(path, payload) {
+    if (!existsSync(CONFIG_DIR))
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, JSON.stringify(payload, null, 2), 'utf8');
+    renameSync(tmp, path);
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function emptySyncState(talker, scope = talker, source = SYNC_SOURCE, overlapSeconds = DEFAULT_OVERLAP_SECONDS) {
+    return {
+        schema: SYNC_SCHEMA,
+        schemaVersion: 1,
+        source,
+        scope,
+        talker,
+        lastSuccessfulRun: null,
+        lastAttempt: null,
+        coveredFrom: null,
+        coveredTo: null,
+        checkpoint: { newestCreateTime: null, overlapSeconds },
+        recordsRead: 0,
+        recordsDeduplicated: 0,
+        recordsReturned: 0,
+        shardsRead: 0,
+        shardsFailed: 0,
+        shards: { scanned: 0, opened: 0, failed: 0, items: [] },
+        coverage: 'unverified',
+        mayHaveMore: false,
+        warnings: [],
+        updatedAt: null,
+    };
+}
+export class SyncStateStore {
+    syncDir;
+    jobsDir;
+    constructor(syncDir = SYNC_DIR, jobsDir = JOBS_DIR) {
+        this.syncDir = syncDir;
+        this.jobsDir = jobsDir;
+    }
+    statePath(source, talker) {
+        return join(this.syncDir, `${source}-${talkerSlug(talker)}.json`);
+    }
+    /** 读取检查点。无记录返回 null; schema 不认识则抛错, 不猜测。 */
+    read(source, talker) {
+        const path = this.statePath(source, talker);
+        const raw = readJson(path);
+        if (raw === null)
+            return null;
+        const state = raw;
+        if (state.schema !== SYNC_SCHEMA)
+            throw new UnknownSchemaError(path, state.schema);
+        return state;
+    }
+    write(state) {
+        const path = this.statePath(state.source, state.talker);
+        if (!existsSync(this.syncDir))
+            mkdirSync(this.syncDir, { recursive: true });
+        writeAtomic(path, sanitizeForState({ ...state, schema: SYNC_SCHEMA }));
+    }
+    /** 所有会话的检查点, 最近尝试在前。目录缺失或单个文件损坏都不影响其余。 */
+    list() {
+        try {
+            if (!existsSync(this.syncDir))
+                return [];
+            const states = [];
+            for (const name of readdirSync(this.syncDir)) {
+                if (!name.endsWith('.json'))
+                    continue;
+                const raw = readJson(join(this.syncDir, name));
+                if (!raw || raw.schema !== SYNC_SCHEMA)
+                    continue;
+                states.push(raw);
+            }
+            return states.sort((a, b) => String(b.lastAttempt ?? '').localeCompare(String(a.lastAttempt ?? '')));
+        }
+        catch {
+            return [];
+        }
+    }
+    jobPath(jobId) {
+        return join(this.jobsDir, `${jobId}.json`);
+    }
+    writeJob(job) {
+        if (!existsSync(this.jobsDir))
+            mkdirSync(this.jobsDir, { recursive: true });
+        writeAtomic(this.jobPath(job.jobId), sanitizeForState({ ...job, schema: JOB_SCHEMA }));
+    }
+    readJob(jobId) {
+        const path = this.jobPath(jobId);
+        const raw = readJson(path);
+        if (raw === null)
+            return null;
+        const job = raw;
+        if (job.schema !== JOB_SCHEMA)
+            throw new UnknownSchemaError(path, job.schema);
+        return job;
+    }
+    /** 最近的 job 记录, 最新在前。 */
+    recentJobs(limit = 10) {
+        try {
+            if (!existsSync(this.jobsDir))
+                return [];
+            const ids = readdirSync(this.jobsDir)
+                .filter(name => name.endsWith('.json'))
+                .map(name => name.slice(0, -'.json'.length))
+                .sort()
+                .reverse()
+                .slice(0, limit);
+            const jobs = [];
+            for (const id of ids) {
+                const job = this.readJob(id);
+                if (job)
+                    jobs.push(job);
+            }
+            return jobs;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+export const syncStateStore = new SyncStateStore();
+/** jobId 形如 job_20260919_0001。同日按时间戳后四位递增, 保证可排序。 */
+export function makeJobId(now = new Date()) {
+    const stamp = [
+        now.getFullYear(),
+        String(now.getMonth() + 1).padStart(2, '0'),
+        String(now.getDate()).padStart(2, '0'),
+    ].join('');
+    return `job_${stamp}_${String(now.getTime() % 10000).padStart(4, '0')}`;
+}
+//# sourceMappingURL=syncState.js.map

package/dist/src/services/syncState.js.map

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