skill-bill 0.2.0 → 0.2.2

package/dist/setup/backups.js

@@ -0,0 +1,172 @@
+/** 开始使用域的文件面：**备份目录怎么扫、一份备份怎么造、怎么恢复回去、怎么验。
+ *
+ * 老侧对应件：`scripts/backup.py`（`create_backup`／`restore_backup`）与 `scripts/setup/cli.py` 的
+ *   `cmd_backup_create`／`cmd_backup_list`／`cmd_restore`（备份＝库文件 ＋ 同名的 `goals.json` 影子件）。
+ *
+ * 三处**与老侧不同**、逐条记在 `docs/skills/skill-bill/t731-差异表.md`：
+ *   ① 造一份备份时**先 `wal_checkpoint(TRUNCATE)` 再拷**（本仓库开着 WAL，直接拷主库文件会漏掉 WAL 里
+ *      还没回写的事务）；老侧那一路是把库连接关掉之后 `shutil.copy2`（`backup.py:72-77`），新侧的连接归出口持有，
+ *      故改用 checkpoint 达到同一目的；
+ *   ② 备份的**存储形状**不同：老侧一份备份是**一个时间戳目录**（`backup.py:63-69`，目录里放库与 `goals.json`），
+ *      新侧一份备份是**一个文件**（`backup.dir` ＋ `backup.stem`，`src/fetch/paths.ts:71-74`）＋ 同主体的影子件；
+ *      同一秒内的冲突**两边都躲**（老侧给目录名追加 `_2`／`_3`，新侧给文件名追加 `_2`／`_3`）——这一条不是差异；
+ *   ③ 恢复**无条件**先给现状造一份备份（老侧 `backup.py:122-124`，原样继承），并把这一份的名字交回调用方
+ *      ——页面上要写清「不满意可以怎么回去」。
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { DatabaseSync } from 'node:sqlite';
+import { join, basename } from 'node:path';
+import { backupFileName } from '../fetch/paths.js';
+import { BillFetchError } from '../fetch/errors.js';
+/** 备份文件名里的时间戳（`YYYYMMDD_HHMMSS`；本地时钟，与文件修改时间同源）。 */
+export function backupStampOf(at) {
+    const p = (n, w = 2) => String(n).padStart(w, '0');
+    return String(at.getFullYear()) + p(at.getMonth() + 1) + p(at.getDate())
+        + '_' + p(at.getHours()) + p(at.getMinutes()) + p(at.getSeconds());
+}
+/** 文件名字戳解回人话时刻（`YYYY-MM-DD HH:MM:SS`）；解不出给空串（由调用方退回文件修改时间）。 */
+export function stampToTime(file) {
+    const m = /(\d{4})(\d{2})(\d{2})_(\d{2})(\d{2})(\d{2})/.exec(file);
+    if (m === null)
+        return '';
+    return m[1] + '-' + m[2] + '-' + m[3] + ' ' + m[4] + ':' + m[5] + ':' + m[6];
+}
+/** 备份目录里的一份（库文件名 → 条目；读不到给 `null`，由调用方按「没有这一份」处置）。 */
+function entryOf(dir, file) {
+    const path = join(dir, file);
+    try {
+        const st = statSync(path);
+        const goalsFile = goalsSiblingOf(file);
+        const goalsPath = join(dir, goalsFile);
+        const hasGoals = existsSync(goalsPath);
+        return {
+            file,
+            path,
+            time: stampToTime(file) !== '' ? stampToTime(file) : st.mtime.toISOString().slice(0, 19).replace('T', ' '),
+            bytes: st.size,
+            hasGoals,
+            goalsBytes: hasGoals ? statSync(goalsPath).size : 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** 一份备份的影子件名（`x.db` → `x.goals.json`；老侧同一算式 `name.replace('.db', '.goals.json')`）。 */
+function goalsSiblingOf(file) {
+    return file.endsWith('.db') ? file.slice(0, -3) + '.goals.json' : file + '.goals.json';
+}
+/** 备份目录里的全部备份，**新→旧**（列表页与「默认用最新一份」都读它）。
+ *  目录不存在＝还没有备份过（空表，不是错误——老侧 `cmd_backup_list` 同）。 */
+export function listBackups(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const f of readdirSync(dir)) {
+        if (!f.endsWith('.db'))
+            continue;
+        const e = entryOf(dir, f);
+        if (e !== null)
+            out.push(e);
+    }
+    return out.sort((a, b) => (a.time === b.time ? (a.file < b.file ? 1 : -1) : a.time < b.time ? 1 : -1));
+}
+/** 按名字找一份备份（名字可带路径：只取末段；找不到给 `null`——不猜、不退回最新一份）。 */
+export function findBackup(dir, name) {
+    if (name === '')
+        return null;
+    return entryOf(dir, basename(name.trim()));
+}
+/** 选中的那一份：给了名字照它找，没给用最新的一份（**同源**：详情与确认文本都读这一件的返回值）。 */
+export function selectedBackup(dir, name) {
+    if (name !== '')
+        return findBackup(dir, name);
+    const all = listBackups(dir);
+    return all.length === 0 ? null : all[0];
+}
+/** SQLite 字符串字面量（Windows 路径里的 `'` 要翻倍；反斜杠原样可用）。 */
+function sqlLiteral(p) {
+    return "'" + p.replace(/'/g, "''") + "'";
+}
+/** 造一份备份：库 ＋（有就带上）影子件。**无条件**——调用方不判「用户记不记得」。
+ *  同一秒已有一份时不覆盖：换 `_2`／`_3` 后缀（老侧会静默覆盖，本件不照抄）。 */
+export function createBackup(input) {
+    mkdirSync(input.dir, { recursive: true });
+    const path = uniquePath(input.dir, backupFileName(input.stamp));
+    // WAL 模式下主库文件里可能缺着最近几次提交：先 checkpoint 再拷，拷出来才是完整一份。
+    try {
+        input.db.db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
+    }
+    catch { /* 非 WAL 或只读连接：退回直接拷 */ }
+    copyFileSync(input.db.path, path);
+    const goalsCopy = join(input.dir, goalsSiblingOf(basename(path)));
+    if (existsSync(input.goalsPath)) {
+        try {
+            copyFileSync(input.goalsPath, goalsCopy);
+        }
+        catch { /* 影子件可缺：库那一半照样是完整的 */ }
+    }
+    const made = entryOf(input.dir, basename(path));
+    if (made === null)
+        throw new BillFetchError('BILL_DB_UNREADABLE', '备份写完后读不到：' + path);
+    return made;
+}
+/** 同名文件已存在就换 `_2`／`_3`…（同一秒连造两份时不覆盖前一份）。 */
+function uniquePath(dir, file) {
+    if (!existsSync(join(dir, file)))
+        return join(dir, file);
+    const stem = file.endsWith('.db') ? file.slice(0, -3) : file;
+    for (let i = 2; i < 100; i += 1) {
+        const candidate = join(dir, stem + '_' + String(i) + '.db');
+        if (!existsSync(candidate))
+            return candidate;
+    }
+    throw new BillFetchError('BILL_DB_UNREADABLE', '备份目录里同名文件太多，换个时刻再试：' + file);
+}
+/** 恢复回去：覆盖库文件（有影子件就连影子件一起），并清掉可能残留的 WAL 旁件。
+ *  **调用方必须先关掉手上的库句柄**（Windows 上覆盖打开着的文件会失败，且 WAL 旁件会与恢复回来的库打架）。 */
+export function restoreBackup(input) {
+    copyFileSync(input.entry.path, input.dbPath);
+    for (const suffix of ['-wal', '-shm']) {
+        const side = input.dbPath + suffix;
+        if (existsSync(side))
+            rmSync(side, { force: true });
+    }
+    if (input.entry.hasGoals) {
+        const source = join(input.entry.path, '..', goalsSiblingOf(input.entry.file));
+        try {
+            copyFileSync(source, input.goalsPath);
+        }
+        catch { /* 影子件拷不动不阻断：库那一半已恢复 */ }
+    }
+}
+/** 恢复之后**验库可读**（老侧 `restore.html:136-146` 的 `SELECT 1 FROM bills LIMIT 1`；失败要把现状备份点名）。
+ *  新开一条连接验（手上那条已随恢复关闭），验完即关。 */
+export function verifyRestored(dbPath) {
+    let db = null;
+    try {
+        db = new DatabaseSync(dbPath);
+        db.prepare('SELECT 1 FROM bills LIMIT 1').all();
+        return { ok: true, why: '' };
+    }
+    catch (e) {
+        return { ok: false, why: e.message };
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch { /* ignore */ }
+    }
+}
+/** 字节数写成人话（列表页与回执页共用一处）。 */
+export function humanBytes(n) {
+    if (!Number.isFinite(n) || n < 0)
+        return '—';
+    if (n < 1024)
+        return String(n) + ' B';
+    if (n < 1024 * 1024)
+        return (n / 1024).toFixed(1) + ' KB';
+    return (n / (1024 * 1024)).toFixed(2) + ' MB';
+}
+//# sourceMappingURL=backups.js.map

package/dist/setup/backups.js.map

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

package/dist/setup/blocked.d.ts

@@ -0,0 +1,12 @@
+import type { SetupBlocked } from './params.js';
+import type { SetupScene } from './scene.js';
+/** 缺项那一路的向导页（整页 HTML）。 */
+export declare function blockedWizardDoc(input: {
+    readonly op: 'init' | 'restore' | 'import';
+    readonly scene: SetupScene;
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly blocked: readonly SetupBlocked[];
+    readonly actionAt: string;
+}): string;
+//# sourceMappingURL=blocked.d.ts.map

package/dist/setup/blocked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked.d.ts","sourceRoot":"","sources":["../../src/setup/blocked.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,0BAA0B;AAC1B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CA0CT"}

package/dist/setup/blocked.js

@@ -0,0 +1,65 @@
+/** 开始使用域的**缺项页**：出了一页（向导页型），但**不动任何数据**。
+ *
+ * 谁在用（三个调用点，指名）：`./run.js`（导入缺文件路径那一条）、`./restore.js`（要恢复的那一份不在）、
+ *   `./import.js`（文件不存在／列映射缺必填三列）。三处都走同一支——「缺什么就不往下走」只有一份形状。
+ *
+ * 三支向导各按自己那一支的**最小事实**出页（初始化＝四步都走不通；恢复＝还没有备份；导入＝还没给文件），
+ *   故这一页只报「还差哪几项」与补齐口令，不报任何当刻读数——它是「缺项阻断」（`#688` §四 裁定 9）
+ *   在本域向导页上的落点：**缺项时给看不给复制**（补齐口令走 `./pageParts.js` 的 `blockedOf`，
+ *   那一条自己不带复制按钮）。
+ *
+ * 为什么另立一件（不塞进 `./template-wizard.js`）：那件是**页型**的块序唯一定义地，本件是**缺项这一路
+ *   入参的装配**；两件事的改动频率不同（改版式 vs 改缺项读法），塞一起会让那件越过包内 350 行告警线。
+ */
+import { resolveDbDir } from '../fetch/paths.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { receiptEnvelopeOf } from './pageParts.js';
+import { importSteps, initSteps, restoreSteps } from './steps.js';
+import { wizardDoc } from './template-wizard.js';
+/** 缺项那一路的向导页（整页 HTML）。 */
+export function blockedWizardDoc(input) {
+    const word = projectWakeWord({ key: 'bill.setup.run', op: input.op });
+    const message = word + '还差 ' + String(input.blocked.length) + ' 项：'
+        + input.blocked.map((b) => b.label).join('、') + '（已出向导页，补齐之后跟助手说一遍）';
+    const envelope = receiptEnvelopeOf(input.key, { ok: false, message, op: input.op, blocked: input.blocked });
+    const common = {
+        scene: input.scene,
+        key: input.key,
+        params: input.params,
+        actionAt: input.actionAt,
+        envelope,
+        blocked: input.blocked,
+        prompt: input.scene.promptOf(input.params),
+        promptLabel: '复制给助手：补齐之后照这句说一遍',
+    };
+    let wi;
+    if (input.op === 'init') {
+        wi = {
+            ...common, op: 'init',
+            steps: initSteps({
+                envCount: 0, envOk: false, envSummary: '', dirPath: resolveDbDir(),
+                dirWritable: false, schemaOk: false, columns: 0, records: 0, verifyOk: false,
+            }),
+            envChecks: [], ready: false, dbPath: resolveDbDir(), records: 0, created: false,
+        };
+    }
+    else if (input.op === 'restore') {
+        wi = {
+            ...common, op: 'restore',
+            steps: restoreSteps({ selected: '', count: 0, confirmed: false, safety: '', verified: false }),
+            entries: [], selected: null, confirmed: false, safety: '', verified: false, result: '',
+        };
+    }
+    else {
+        wi = {
+            ...common, op: 'import',
+            steps: importSteps({
+                fileName: '', totalRows: 0, mapped: false, newRows: 0, duplicateRows: 0, badRows: 0,
+                confirmed: false, inserted: 0, failed: 0,
+            }),
+            csv: null, map: {}, plan: null, confirmed: false, backup: '', inserted: 0, failed: [],
+        };
+    }
+    return wizardDoc(wi);
+}
+//# sourceMappingURL=blocked.js.map

package/dist/setup/blocked.js.map

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

package/dist/setup/commands.d.ts

@@ -0,0 +1,10 @@
+import { setupRun } from './run.js';
+export declare const SETUP_COMMANDS: {
+    kind: "write";
+    key: string;
+    shape: "receipt";
+    title: string;
+    example: string;
+    run: typeof setupRun;
+}[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/setup/commands.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,eAAO,MAAM,cAAc;;;;;;;GASO,CAAC"}

package/dist/setup/commands.js

@@ -0,0 +1,12 @@
+import { setupRun } from './run.js';
+export const SETUP_COMMANDS = [
+    {
+        kind: 'write',
+        key: 'bill.setup.run',
+        shape: 'receipt',
+        title: '开始使用',
+        example: 'bill-cmd-read bill.setup.run --params \'{"op":"init-status"}\'',
+        run: setupRun,
+    },
+];
+//# sourceMappingURL=commands.js.map

package/dist/setup/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/setup/commands.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,gEAAgE;QACzE,GAAG,EAAE,QAAQ;KACd;CAC+B,CAAC"}

package/dist/setup/declaration.d.ts

@@ -0,0 +1,9 @@
+/** #721 · 开始使用域的**域声明**（手写、唯一事实源）。
+ *
+ * 一条唤醒词的字面量只准住在这里（判据＝`test/t721-判据与摘要锁.test.mjs` 扫非声明件）；
+ * 场景的 `wake_word` 是投影、不写——词条拥有它；二级组按场景 id 指回词条名下的场景。
+ * 合并方：`src/triggers/wakeTable.ts`（词表＋路由＋派生）与 `src/triggers/wake-assets.ts`（HELP 目录）。
+ */
+import type { DomainDeclaration } from '../triggers/routeSpec.js';
+export declare const SETUP_DECLARATION: DomainDeclaration;
+//# sourceMappingURL=declaration.d.ts.map

package/dist/setup/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/setup/declaration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,iBAAiB,EAAE,iBA0F/B,CAAC"}

package/dist/setup/declaration.js

@@ -0,0 +1,92 @@
+export const SETUP_DECLARATION = {
+    id: 'setup',
+    label: '开始使用',
+    icon: '🚀',
+    order: 7,
+    entries: [
+        {
+            phrase: '初始化',
+            key: 'bill.setup.run',
+            preset: { op: 'init' },
+            scenes: [
+                {
+                    id: 'setup_init_wizard',
+                    title: '首次使用向导(4 步零决策)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我开始使用饼干记账(唤醒词:初始化):\n',
+                    types: ['向导'],
+                },
+            ],
+        },
+        {
+            phrase: '初始化状态',
+            key: 'bill.setup.run',
+            preset: { op: 'init-status' },
+            scenes: [
+                {
+                    id: 'setup_init_status',
+                    title: '初始化状态(是否已就绪)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看看饼干记账初始化了没有(唤醒词:初始化状态):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '备份',
+            key: 'bill.setup.run',
+            preset: { op: 'backup-create' },
+            scenes: [
+                {
+                    id: 'setup_backup_create',
+                    title: '一键备份',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我备份饼干记账的数据(唤醒词:备份):\n',
+                    types: ['回执'],
+                },
+                {
+                    id: 'setup_backup_list',
+                    title: '查看备份',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看看有哪些备份(唤醒词:备份):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '恢复备份',
+            key: 'bill.setup.run',
+            preset: { op: 'restore' },
+            scenes: [
+                {
+                    id: 'setup_restore',
+                    title: '从备份恢复',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我从备份恢复数据(唤醒词:恢复备份):\n\n  备  份: ____ (选填,默认最新备份)\n',
+                    types: ['向导'],
+                },
+            ],
+        },
+        {
+            phrase: '导入',
+            key: 'bill.setup.run',
+            preset: { op: 'import' },
+            needs: ['file'],
+            scenes: [
+                {
+                    id: 'setup_import',
+                    title: '导入 CSV 账单(列映射向导)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我导入 CSV 账单(唤醒词:导入):\n\n  文件路径: ____\n  列映射: ____ (选填,自动识别,如:日期=第1列,金额=第3列)\n',
+                    types: ['向导'],
+                },
+            ],
+        },
+    ],
+    subgroups: [
+        { id: 'setup_1', label: '初始化', scenes: ['setup_init_wizard', 'setup_init_status'] },
+        { id: 'setup_2', label: '备份恢复', scenes: ['setup_backup_create', 'setup_backup_list', 'setup_restore'] },
+        { id: 'setup_3', label: '导入', scenes: ['setup_import'] },
+    ],
+};
+//# sourceMappingURL=declaration.js.map

package/dist/setup/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/setup/declaration.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,CAAC;IACR,OAAO,EAAE;QACP;YACE,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;YACtB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,mBAAmB;oBACvB,KAAK,EAAE,gBAAgB;oBACvB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,oCAAoC;oBACrD,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,OAAO;YACf,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE;YAC7B,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,mBAAmB;oBACvB,KAAK,EAAE,cAAc;oBACrB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,0CAA0C;oBAC3D,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE;YAC/B,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,qBAAqB;oBACzB,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,oCAAoC;oBACrD,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;gBACD;oBACE,EAAE,EAAE,mBAAmB;oBACvB,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,kCAAkC;oBACnD,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;YACzB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,eAAe;oBACnB,KAAK,EAAE,OAAO;oBACd,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,gEAAgE;oBACjF,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,cAAc;oBAClB,KAAK,EAAE,kBAAkB;oBACzB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,2FAA2F;oBAC5G,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;KACF;IACD,SAAS,EAAE;QACT,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,EAAE;QACnF,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,eAAe,CAAC,EAAE;QACvG,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,cAAc,CAAC,EAAE;KACzD;CACF,CAAC"}

package/dist/setup/import.d.ts

@@ -0,0 +1,8 @@
+import type { BillDb } from '../fetch/index.js';
+import type { WriteOut } from '../shared/commandSpec.js';
+import type { ColumnMap } from './importer.js';
+/** 把映射写回人话（复制口令里那一格；`日期=第1列,金额=第3列`）。 */
+export declare function mappingTextOf(map: ColumnMap): string;
+/** 导入 CSV（`op=import`）：不确认只出映射向导页；确认则「自动备份 → 整批一个事务写 → 结果卡」。 */
+export declare function runImport(db: BillDb, key: string, params: Record<string, unknown>): WriteOut;
+//# sourceMappingURL=import.d.ts.map

package/dist/setup/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/setup/import.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAKzD,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AAS3D,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAQpD;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CA0E5F"}

package/dist/setup/import.js

@@ -0,0 +1,111 @@
+/** `op=import`（导入 CSV 账单）——本件住**导入这一条的全部安全顺序**（`#688` §二 D2 的四件）。
+ *
+ * 四件逐条落在哪一行（老侧四件全无，逐条证据见 `docs/skills/skill-bill/t731-差异表.md`）：
+ *   ① **明示「本次将新增 N 行、不覆盖已有记录」**——`planImport` 算出的 `new_rows` 进载荷、进页面；
+ *   ② **导入前自动备份一次**——确认那一路先 `createBackup`，把备份文件名写进载荷与页面；
+ *   ③ **重复导入检测**——`planImport` 拿库里已有记录的签名逐行比，重号的进 `duplicates`、不写库；
+ *   ④ **页面级结果卡**——`applyImport` 回来的成功／失败行数与失败原因进结果卡（`./template-wizard.js`）。
+ *
+ * 另两处**有意与老侧不同**：整批一个事务（老侧逐行各自 commit，中途失败不回退）；三档读数分开报
+ *   （老侧把被跳过的空行算进 `total`）。
+ */
+import { existsSync } from 'node:fs';
+import { resolveBackupDir, resolveGoalsPath } from '../fetch/paths.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { backupStampOf, createBackup } from './backups.js';
+import { FIELD_LABEL, applyImport, existingRows, guessMap, missingRequired, parseMapping, planImport, readCsv, } from './importer.js';
+import { confirmOf, importFileOf, mappingOf } from './params.js';
+import { receiptEnvelopeOf } from './pageParts.js';
+import { setupSceneFor } from './scene.js';
+import { importSteps } from './steps.js';
+import { blockedWizardDoc } from './blocked.js';
+import { wizardDoc } from './template-wizard.js';
+/** 把映射写回人话（复制口令里那一格；`日期=第1列,金额=第3列`）。 */
+export function mappingTextOf(map) {
+    const parts = [];
+    for (const f of ['time', 'amount', 'category', 'account', 'ledger', 'note']) {
+        const col = map[f];
+        if (col === undefined)
+            continue;
+        parts.push(FIELD_LABEL[f] + '=第' + String(col + 1) + '列');
+    }
+    return parts.join(',');
+}
+/** 导入 CSV（`op=import`）：不确认只出映射向导页；确认则「自动备份 → 整批一个事务写 → 结果卡」。 */
+export function runImport(db, key, params) {
+    const scene = setupSceneFor('import');
+    const file = importFileOf(params);
+    const blocked = [];
+    if (file === '')
+        blocked.push({ name: 'file', label: 'CSV 文件路径', why: '没给' });
+    else if (!existsSync(file))
+        blocked.push({ name: 'file', label: 'CSV 文件路径', why: '这个文件不存在' });
+    if (blocked.length > 0) {
+        const html = blockedWizardDoc({ op: 'import', scene, key, params, blocked, actionAt: actionStamp() });
+        const message = '导入还差 ' + String(blocked.length) + ' 项：' + blocked.map((b) => b.label + '（' + b.why + '）').join('、');
+        return { data: { ok: false, message, receipt: { op: 'import', blocked } }, html };
+    }
+    const csv = readCsv(file);
+    const mappingText = mappingOf(params);
+    const map = mappingText === '' ? guessMap(csv) : parseMapping(mappingText);
+    const missing = missingRequired(map);
+    if (missing.length > 0) {
+        const blocked2 = [{
+                name: 'mapping', label: '列映射',
+                why: '还缺 ' + missing.map((f) => FIELD_LABEL[f]).join('、') + ' 这几列（照「日期=第1列,金额=第3列」补上）',
+            }];
+        const html = blockedWizardDoc({ op: 'import', scene, key, params, blocked: blocked2, actionAt: actionStamp() });
+        const message = '导入还差 1 项：列映射（还是缺 ' + missing.map((f) => FIELD_LABEL[f]).join('、') + '）';
+        return { data: { ok: false, message, receipt: { op: 'import', blocked: blocked2 } }, html };
+    }
+    const plan = planImport(csv, map, existingRows(db));
+    const filled = { ...params, mapping: mappingTextOf(map) };
+    const common = {
+        op: 'import', file: csv.file, name: csv.name, total: csv.rows.length,
+        new_rows: plan.newRows, duplicates: plan.duplicates.length, bad: plan.bad.length, mapping: mappingTextOf(map),
+    };
+    if (!confirmOf(params)) {
+        const ok = plan.newRows > 0;
+        const message = ok
+            ? '导入向导：' + csv.name + ' 将新增 ' + String(plan.newRows) + ' 行，不覆盖已有记录'
+            : '导入向导：' + csv.name + ' 没有可新增的行（都是库里已有的或读不出来的）';
+        const receipt = { ...common, imported: 0, failed_count: 0, backup: '', confirmed: false };
+        const envelope = receiptEnvelopeOf(key, { ok, message, ...receipt });
+        const html = wizardDoc({
+            op: 'import', scene, key, params: filled, actionAt: actionStamp(), envelope, blocked: [],
+            steps: importSteps({
+                fileName: csv.name, totalRows: csv.rows.length, mapped: true, newRows: plan.newRows,
+                duplicateRows: plan.duplicates.length, badRows: plan.bad.length, confirmed: false, inserted: 0, failed: 0,
+            }),
+            prompt: scene.promptOf(filled), promptLabel: '复制给助手：照这句确认，导入前会自动备份一次',
+            csv, map, plan, confirmed: false, backup: '', inserted: 0, failed: [],
+        });
+        return { data: { ok, message, receipt }, html };
+    }
+    // ② 导入前自动备份一次（D2 的第二件；与恢复同一支、同一口径）。
+    const backup = createBackup({
+        db, dir: resolveBackupDir(), stamp: backupStampOf(new Date()), goalsPath: resolveGoalsPath(),
+    });
+    const written = applyImport(db, plan);
+    const ok = written.inserted > 0;
+    const message = '已导入：' + String(written.inserted) + ' 行'
+        + (written.failed.length > 0 ? '，失败 ' + String(written.failed.length) + ' 行' : '')
+        + '（导入前已备份：' + backup.file + '）';
+    const receipt = {
+        ...common, imported: written.inserted, failed_count: written.failed.length,
+        backup: backup.file, confirmed: true,
+    };
+    const envelope = receiptEnvelopeOf(key, { ok, message, ...receipt });
+    const html = wizardDoc({
+        op: 'import', scene, key, params: filled, actionAt: actionStamp(), envelope, blocked: [],
+        steps: importSteps({
+            fileName: csv.name, totalRows: csv.rows.length, mapped: true, newRows: plan.newRows,
+            duplicateRows: plan.duplicates.length, badRows: plan.bad.length, confirmed: true,
+            inserted: written.inserted, failed: written.failed.length,
+        }),
+        prompt: scene.promptOf(filled), promptLabel: '复制给助手：同一份文件再导一次会怎样',
+        csv, map, plan, confirmed: true, backup: backup.file, inserted: written.inserted, failed: written.failed,
+    });
+    return { data: { ok, message, receipt }, html };
+}
+//# sourceMappingURL=import.js.map

package/dist/setup/import.js.map

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