skill-bill 0.2.0 → 0.2.1

package/dist/setup/run.js

@@ -0,0 +1,188 @@
+/** `bill.setup.run`（开始使用）的处理体：**六种 op 一处分流** ＋ 四条「零决策」op 的活。
+ *
+ * 谁在用（一个调用点，指名）：`./commands.js` 那条命令声明引本件——出口分派 `src/cli/cmd_read.ts`
+ *   只查注册表再调声明里的 `run`，不认这个命令名（#691 起「入口跟着声明走」）。
+ *
+ * **本件住哪四条 op**：初始化（`./init` 的做派：环境检测 → 数据目录 → 建库自愈 → 真跑一次读）、
+ *   初始化状态（三重判定＋迁移块）、一键备份、查看备份。另外两条**各住自己的件**——
+ *   恢复（`./restore.js`）与导入（`./import.js` 那一条：CSV）——因为它们各自带着一整套安全顺序
+ *   （D1 三件套／D2 四件），与本件的四条只读／幂等 op 不是同一批改动。
+ *
+ * 六种 op 与三片页型的对应写在 `./params.js` 的 `PAGE_OF_OP`；每条 op 的差异值住它那一件场景件。
+ * 本件只做三件事：**取数（库／备份目录）→ 按 op 的规矩动或不动数据 → 交给对应页型出整页**。
+ *
+ * **出口载荷的形状**（一处口径，六条 op 同形）：`data = { ok, message, receipt }`——
+ *   `ok`／`message` 是 `base-link-core` 的 `receipt` 形必填的两格；`receipt` 是本域自己的事实
+ *   （哪种 op、报了什么读数），页面内置 envelope 与出口载荷**同源**（同一个对象摊开两处用），
+ *   与写入域／账户域「`receipt` 那一格的形状由各域自己定」同一条口径（`src/shared/commandSpec.ts`）。
+ */
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { resolveBackupDir, resolveGoalsPath } from '../fetch/paths.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { backupStampOf, createBackup, humanBytes, listBackups } from './backups.js';
+import { blockedWizardDoc } from './blocked.js';
+import { parseSetupOp, setupBlocked } from './params.js';
+import { receiptEnvelopeOf } from './pageParts.js';
+import { runImport } from './import.js';
+import { runRestore } from './restore.js';
+import { setupSceneFor } from './scene.js';
+import { initSteps } from './steps.js';
+import { readSetupStatus } from './status.js';
+import { backupReceiptDoc } from './template-receipt.js';
+import { listDoc } from './template-list.js';
+import { wizardDoc } from './template-wizard.js';
+/** 目录可写探测（老侧 `cli.py:111-125` 的 `.write_probe` 同法：真写一个再删，不凭猜）。 */
+function dirWritable(dir) {
+    const probe = join(dir, '.write_probe');
+    try {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(probe, 'ok', 'utf8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        try {
+            rmSync(probe, { force: true });
+        }
+        catch { /* 删不掉不影响「写得进」这个结论 */ }
+    }
+}
+/** 运行环境那一项（与出口预检同一条线：node ≥ 22.13）。 */
+function nodeOk() {
+    const v = process.versions.node.split('.').map(Number);
+    return v[0] > 22 || (v[0] === 22 && v[1] >= 13);
+}
+/** 真跑一次读（`SELECT 1` ＋ 数一遍 bills）——老侧把那句「SELECT 1 ✓ · bills 表 ✓」写死在文案里，
+ *  实际只跑了 `PRAGMA table_info` 与 `SELECT COUNT(*)`（`cli.py:252-253/262`）；新侧真跑真报。 */
+function verifyReadable(db) {
+    try {
+        db.db.prepare('SELECT 1 AS one').all();
+        db.db.prepare('SELECT COUNT(*) AS n FROM bills').all();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 记第一笔那句口令（老侧 `init_wizard.html:158` 逐字同句：初始化完成后顺势推进到下一步，`#688` §二 D3）。 */
+const NEXT_RECORD_PROMPT = '请加载「饼干记账」技能,帮我记一笔支出(唤醒词:记支出):\n\n'
+    + '  分类: ____(如:餐饮/外卖/午餐)\n  金额: ____(支出为负)\n  备注: ____(选填)';
+/** 初始化（`op=init`）：环境检测 → 数据目录 → 建库自愈 → 真跑一次读。**幂等**，重复跑安全。 */
+function runInit(db, key, params) {
+    const scene = setupSceneFor('init');
+    const dir = dirname(db.path);
+    const status = readSetupStatus(db);
+    const writable = dirWritable(dir);
+    const envChecks = [
+        { label: '运行环境', ok: nodeOk(), detail: 'node ' + process.versions.node + '（要 22.13 以上）' },
+        { label: '数据目录', ok: writable, detail: dir + (writable ? '（可写）' : '（不可写）') },
+    ];
+    const verifyOk = status.tableExists && verifyReadable(db);
+    const steps = initSteps({
+        envCount: envChecks.length,
+        envOk: envChecks.every((c) => c.ok),
+        envSummary: envChecks.every((c) => c.ok) ? '两项都过了' : '有没过的项',
+        dirPath: dir,
+        dirWritable: writable,
+        schemaOk: status.checks[1]?.ok === true,
+        columns: status.columns.length,
+        records: status.rows,
+        verifyOk,
+    });
+    const ready = status.ready && verifyOk;
+    const message = ready
+        ? '已初始化：' + db.path + '（' + String(status.columns.length) + ' 列，现有记录 ' + String(status.rows) + ' 条）'
+        : '初始化没走完：库结构还不齐（现有记录 ' + String(status.rows) + ' 条）';
+    const receipt = {
+        op: 'init', db_path: db.path, records: status.rows, schema_ok: ready, repaired: status.repaired,
+        created: db.initialized,
+    };
+    const envelope = receiptEnvelopeOf(key, { ok: ready, message, ...receipt });
+    const html = wizardDoc({
+        op: 'init', scene, key, params, actionAt: actionStamp(), steps, envelope,
+        blocked: [], prompt: ready ? NEXT_RECORD_PROMPT : scene.promptOf(params),
+        promptLabel: ready ? '复制给助手：直接开始记第一笔' : '复制给助手：照这句先把初始化走完',
+        envChecks, ready, dbPath: db.path, records: status.rows, created: db.initialized,
+    });
+    return { data: { ok: ready, message, receipt }, html };
+}
+/** 初始化状态（`op=init-status`）：只读三重判定 ＋ 独立的迁移块。 */
+function runStatus(db, key, params) {
+    const scene = setupSceneFor('init-status');
+    const status = readSetupStatus(db);
+    const message = status.ready
+        ? '就绪：' + String(status.columns.length) + ' 列齐（含 deleted_at），库 ' + db.path
+            + '，现有记录 ' + String(status.rows) + ' 条'
+        : '未就绪：' + (status.needsMigration ? '结构还是老版本' : '这个位置还不是一个记账库') + '（' + db.path + '）';
+    const receipt = {
+        op: 'init-status', db_path: db.path, records: status.rows, version: status.version,
+        repaired: status.repaired, ready: status.ready,
+    };
+    const envelope = receiptEnvelopeOf(key, { ok: status.ready, message, ...receipt });
+    const html = listDoc({ op: 'init-status', scene, key, params, actionAt: actionStamp(), status, envelope });
+    return { data: { ok: status.ready, message, receipt }, html };
+}
+/** 一键备份（`op=backup-create`）：无条件造一份，出结果回执。 */
+function runBackupCreate(db, key, params) {
+    const scene = setupSceneFor('backup-create');
+    const dir = resolveBackupDir();
+    const entry = createBackup({ db, dir, stamp: backupStampOf(new Date()), goalsPath: resolveGoalsPath() });
+    const entries = listBackups(dir);
+    const message = '已备份：' + entry.file + '（' + humanBytes(entry.bytes)
+        + (entry.hasGoals ? ' ＋ 目标那一份' : '') + '）';
+    const receipt = {
+        op: 'backup-create', backup: entry.file, path: entry.path, time: entry.time, bytes: entry.bytes,
+        has_goals: entry.hasGoals, count: entries.length,
+    };
+    const envelope = receiptEnvelopeOf(key, { ok: true, message, ...receipt });
+    const html = backupReceiptDoc({ scene, key, params, actionAt: actionStamp(), entry, total: entries.length, envelope });
+    return { data: { ok: true, message, receipt }, html };
+}
+/** 查看备份（`op=backup-list`）：只读列一遍目录，空目录出空态与引导。 */
+function runBackupList(key, params) {
+    const scene = setupSceneFor('backup-list');
+    const entries = listBackups(resolveBackupDir());
+    const ok = entries.length > 0;
+    const message = ok
+        ? '备份 ' + String(entries.length) + ' 份，最新一份是 ' + entries[0].time
+        : '还没有备份（跟助手说一遍「备份」就会存一份）';
+    const receipt = {
+        op: 'backup-list', count: entries.length,
+        backups: entries.map((e) => ({
+            name: e.file, time: e.time, size: e.bytes, files: e.hasGoals ? '库 ＋ 目标' : '只有库',
+        })),
+    };
+    const envelope = receiptEnvelopeOf(key, { ok, message, ...receipt });
+    const html = listDoc({ op: 'backup-list', scene, key, params, actionAt: actionStamp(), entries, envelope });
+    return { data: { ok, message, receipt }, html };
+}
+/** `bill.setup.run`：六种 op 一处分流（`op` 缺省＝初始化状态，照老出口那一支的缺省）。 */
+export function setupRun(params, db) {
+    const key = 'bill.setup.run';
+    const op = parseSetupOp(params);
+    // 缺必需槽位那一条只可能出在导入这一支（六种 op 里只有它有一个必填格）。
+    const missing = setupBlocked(op, params);
+    if (missing.length > 0) {
+        const scene = setupSceneFor('import');
+        const html = blockedWizardDoc({ op: 'import', scene, key, params, blocked: missing, actionAt: actionStamp() });
+        const message = projectWakeWord({ key: 'bill.setup.run', op: 'import' }) + '还差 ' + String(missing.length)
+            + ' 项：' + missing.map((b) => b.label).join('、') + '（已出向导页，补齐之后跟助手说一遍）';
+        return { data: { ok: false, message, receipt: { op: 'import', blocked: missing } }, html };
+    }
+    if (op === 'init')
+        return runInit(db, key, params);
+    if (op === 'init-status')
+        return runStatus(db, key, params);
+    if (op === 'backup-create')
+        return runBackupCreate(db, key, params);
+    if (op === 'backup-list')
+        return runBackupList(key, params);
+    if (op === 'restore')
+        return runRestore(db, key, params);
+    return runImport(db, key, params);
+}
+//# sourceMappingURL=run.js.map

package/dist/setup/run.js.map

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

package/dist/setup/scene-backup-create.d.ts

@@ -0,0 +1,3 @@
+import type { SetupScene } from './scene.js';
+export declare const SCENE: SetupScene;
+//# sourceMappingURL=scene-backup-create.d.ts.map

package/dist/setup/scene-backup-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-backup-create.d.ts","sourceRoot":"","sources":["../../src/setup/scene-backup-create.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,eAAO,MAAM,KAAK,EAAE,UAUnB,CAAC"}

package/dist/setup/scene-backup-create.js

@@ -0,0 +1,26 @@
+/** 场景件：**一键备份**（`op=backup-create`）——本件只是差异声明，块位序列住 `./template-receipt.js`。
+ *
+ * 本件的差异（老侧 `templates/开始使用/backup.html` ＋ `scripts/setup/cli.py` 的 `cmd_backup_create`）：
+ *   ① 「备份」这一条词**两个场景**（本条出结果回执页、`./scene-backup-list.js` 出记录列表页）——
+ *      `t687-parity-审计清单.md` §2 第 66-70 行点名的形状，本域两条各一件；
+ *   ② 老侧一份备份是**一个目录**（`backup.py:63-69` 新建时间戳目录，里面放库与 `goals.json`），
+ *      新侧一份备份是**一个文件**（`backup.dir` ＋ `backup.stem`，`src/fetch/paths.js:71-74`）——
+ *      与 #726 定的配置口径同源，差异记在差异表；
+ *   ③ 老侧 `content` 那句「数据库 + 目标(goals.json)」是**硬编码**（`cli.py:328`），影子件不在也不改口；
+ *      新侧照实报「这一份里有什么」。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+const WORD = projectWakeWord({ key: 'bill.setup.run', op: 'backup-create' });
+const KEY = 'bill.setup.run';
+export const SCENE = {
+    id: 'backup-create',
+    sceneId: 'setup_backup_create',
+    key: KEY,
+    op: 'backup-create',
+    page: 'receipt',
+    title: '一键备份',
+    caliber: '备份完成',
+    subtitle: '数据库 + 目标(goals.json)已归档',
+    promptOf: () => '请加载「饼干记账」技能,帮我备份饼干记账的数据(唤醒词:' + WORD + '):\n',
+};
+//# sourceMappingURL=scene-backup-create.js.map

package/dist/setup/scene-backup-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-backup-create.js","sourceRoot":"","sources":["../../src/setup/scene-backup-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;AACrF,MAAM,GAAG,GAAG,gBAAyB,CAAC;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,eAAe;IACnB,OAAO,EAAE,qBAAqB;IAC9B,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,yBAAyB;IACnC,QAAQ,EAAE,GAAG,EAAE,CAAC,8BAA8B,GAAG,IAAI,GAAG,MAAM;CAC/D,CAAC"}

package/dist/setup/scene-backup-list.d.ts

@@ -0,0 +1,3 @@
+import type { SetupScene } from './scene.js';
+export declare const SCENE: SetupScene;
+//# sourceMappingURL=scene-backup-list.d.ts.map

package/dist/setup/scene-backup-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-backup-list.d.ts","sourceRoot":"","sources":["../../src/setup/scene-backup-list.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,eAAO,MAAM,KAAK,EAAE,UAUnB,CAAC"}

package/dist/setup/scene-backup-list.js

@@ -0,0 +1,24 @@
+/** 场景件：**查看备份**（`op=backup-list`）——本件只是差异声明，块位序列住 `./template-list.js`。
+ *
+ * 本件的差异（老侧 `templates/开始使用/backup_list.html` ＋ `scripts/setup/cli.py` 的 `cmd_backup_list`）：
+ *   ① 与 `./scene-backup-create.js` 同一个唤醒词「备份」，**两条场景各一件**；
+ *   ② 老侧列表项报的是「目录名 · 时间 · 该目录下所有文件大小之和」（`cli.py:361-364`），
+ *      新侧一份备份是一个文件，故报「备份文件 · 备份时间 · 大小 · 里面有什么」；
+ *   ③ 老侧空态那一句「还没有备份 ＋ 点下方「一键备份」，数据库和目标数据会自动归档」（`backup_list.html:117`）
+ *      是本模板唯一的 `emptyState`——新侧照它的意思落成空态块 ＋ 引导句（`./template-list.js` 里那一支）。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+const WORD = projectWakeWord({ key: 'bill.setup.run', op: 'backup-list' });
+const KEY = 'bill.setup.run';
+export const SCENE = {
+    id: 'backup-list',
+    sceneId: 'setup_backup_list',
+    key: KEY,
+    op: 'backup-list',
+    page: 'list',
+    title: '查看备份',
+    caliber: '备份列表',
+    subtitle: '备份目录里的这些份',
+    promptOf: () => '请加载「饼干记账」技能,帮我看看有哪些备份(唤醒词:' + WORD + '):\n',
+};
+//# sourceMappingURL=scene-backup-list.js.map

package/dist/setup/scene-backup-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-backup-list.js","sourceRoot":"","sources":["../../src/setup/scene-backup-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AACnF,MAAM,GAAG,GAAG,gBAAyB,CAAC;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,aAAa;IACjB,OAAO,EAAE,mBAAmB;IAC5B,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,GAAG,EAAE,CAAC,4BAA4B,GAAG,IAAI,GAAG,MAAM;CAC7D,CAAC"}

package/dist/setup/scene-import.d.ts

@@ -0,0 +1,3 @@
+import type { SetupScene } from './scene.js';
+export declare const SCENE: SetupScene;
+//# sourceMappingURL=scene-import.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-import.d.ts","sourceRoot":"","sources":["../../src/setup/scene-import.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,eAAO,MAAM,KAAK,EAAE,UAiBnB,CAAC"}

package/dist/setup/scene-import.js

@@ -0,0 +1,36 @@
+/** 场景件：**导入 CSV 账单**（`op=import`）——本件只是差异声明，块位序列住 `./template-wizard.js`。
+ *
+ * 本件的差异（老侧 `templates/开始使用/import.html` ＋ `scripts/setup/cli.py` 的 `cmd_import`）：
+ *   ① **老侧这一支四位一体的安全缺口**（`#688` §二 D2）：风险词「备份／覆盖／警告／注意／丢失」
+ *      在 `import.html` 与其数据源里**逐词 0 命中**（`.scratch/t731/old-setup.md` §10）——
+ *      新侧四件全补：明示「本次将新增 N 行、不覆盖已有记录」＋ 导入前**自动备份一次** ＋
+ *      **重复导入检测** ＋ 页面级结果卡（成功／失败行数 ＋ 失败原因）；
+ *   ② 老侧确认门形态里**好的一半照抄**：把机器猜的每一列都写明猜了哪一列、哪些必填
+ *      （`import.html:159/161-163`，预览只显示前 8 行）——新侧的列映射表与预览表同义；
+ *   ③ 老侧逐行 `insert_record`（每行一次连接、各自 commit，`cli.py:621-625`）——中途失败已写的行不回退；
+ *      新侧整批一个事务（`./importer.js` 的 `applyImport`）；
+ *   ④ 「向导」这条形状老侧在本页其实没有（无步骤模型，`setup.yaml:82` 标了 `向导` 但页里没有步骤条）——
+ *      新侧按片型补齐步骤条（`./steps.js` 的四步）。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+const WORD = projectWakeWord({ key: 'bill.setup.run', op: 'import' });
+const KEY = 'bill.setup.run';
+export const SCENE = {
+    id: 'import',
+    sceneId: 'setup_import',
+    key: KEY,
+    op: 'import',
+    page: 'wizard',
+    title: '导入 CSV 账单',
+    caliber: '列映射向导',
+    subtitle: '列映射向导 · 前几行预览，映射可修改',
+    promptOf: (params) => {
+        const file = typeof params['file'] === 'string' && params['file'].trim() !== '' ? params['file'].trim() : '____';
+        const mapping = typeof params['mapping'] === 'string' && params['mapping'].trim() !== ''
+            ? params['mapping'].trim()
+            : '____(自动识别)';
+        return '请加载「饼干记账」技能,帮我导入 CSV 账单(唤醒词:' + WORD + '):\n\n'
+            + '  文件路径: ' + file + '\n  列映射: ' + mapping + '\n';
+    },
+};
+//# sourceMappingURL=scene-import.js.map

package/dist/setup/scene-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-import.js","sourceRoot":"","sources":["../../src/setup/scene-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC9E,MAAM,GAAG,GAAG,gBAAyB,CAAC;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,QAAQ;IACZ,OAAO,EAAE,cAAc;IACvB,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACjH,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YACtF,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE;YAC1B,CAAC,CAAC,YAAY,CAAC;QACjB,OAAO,8BAA8B,GAAG,IAAI,GAAG,QAAQ;cACnD,UAAU,GAAG,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC;IACvD,CAAC;CACF,CAAC"}

package/dist/setup/scene-init-status.d.ts

@@ -0,0 +1,14 @@
+/** 场景件：**初始化状态**（`op=init-status`）——本件只是差异声明，块位序列住 `./template-list.js`。
+ *
+ * 本件的差异（老侧 `templates/开始使用/init_status.html` ＋ `scripts/setup/cli.py` 的 `cmd_init_status`）：
+ *   ① 判定项名照老侧：数据存在／schema／版本（`cli.py:162/206/207`）——新侧落成「数据存在／结构版本／就绪」
+ *      三格读数（`./status.js` 的三重判定），三件的**与**才是 `ready`；
+ *   ② 迁移提示**独立成块**（`#688` §二 C11）：老侧那段提示指的是「运行某个迁移脚本」并**印出脚本路径**
+ *      （`cli.py:186-188`）——新侧不印脚本路径（裁定 1），改报「本次打开时自动补了什么」
+ *      （库句柄的 DDL 自愈，见 `src/fetch/db.ts` 的 `repaired`）；
+ *   ③ 老侧 `init_status.html:145` 在零记录时正确显示「现有记录 0 条」（不吞 0）——这条**照抄**
+ *      （`#688` 裁定 4 的正面例子）。
+ */
+import type { SetupScene } from './scene.js';
+export declare const SCENE: SetupScene;
+//# sourceMappingURL=scene-init-status.d.ts.map

package/dist/setup/scene-init-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-init-status.d.ts","sourceRoot":"","sources":["../../src/setup/scene-init-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C,eAAO,MAAM,KAAK,EAAE,UAUnB,CAAC"}

package/dist/setup/scene-init-status.js

@@ -0,0 +1,16 @@
+const KEY = 'bill.setup.run';
+/** 未就绪时那块引导说的仍是「初始化」那一句（老侧 `init_status.html:151` 逐字同句）。
+ *  本件不另取唤醒词字面量：引导那一句是**另一条场景**的口令，取自 `./scene-init.js` 那一支的写法。 */
+const INIT_PROMPT = '请加载「饼干记账」技能,帮我开始使用饼干记账(唤醒词:初始化):\n';
+export const SCENE = {
+    id: 'init-status',
+    sceneId: 'setup_init_status',
+    key: KEY,
+    op: 'init-status',
+    page: 'list',
+    title: '初始化状态',
+    caliber: '三重判定',
+    subtitle: '数据存在 · 结构版本 · 就绪',
+    promptOf: () => INIT_PROMPT,
+};
+//# sourceMappingURL=scene-init-status.js.map

package/dist/setup/scene-init-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-init-status.js","sourceRoot":"","sources":["../../src/setup/scene-init-status.ts"],"names":[],"mappings":"AAaA,MAAM,GAAG,GAAG,gBAAyB,CAAC;AAEtC;kEACkE;AAClE,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,aAAa;IACjB,OAAO,EAAE,mBAAmB;IAC5B,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,GAAG,EAAE,CAAC,WAAW;CAC5B,CAAC"}

package/dist/setup/scene-init.d.ts

@@ -0,0 +1,3 @@
+import type { SetupScene } from './scene.js';
+export declare const SCENE: SetupScene;
+//# sourceMappingURL=scene-init.d.ts.map

package/dist/setup/scene-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-init.d.ts","sourceRoot":"","sources":["../../src/setup/scene-init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,eAAO,MAAM,KAAK,EAAE,UAUnB,CAAC"}

package/dist/setup/scene-init.js

@@ -0,0 +1,25 @@
+/** 场景件：**初始化**（`op=init`）——本件只是差异声明，块位序列住 `./template-wizard.js`。
+ *
+ * 本件的差异（老侧 `templates/开始使用/init_wizard.html` ＋ `scripts/setup/cli.py` 的 `cmd_init`）：
+ *   ① 步骤名四条照老侧四处同名写法：环境检测／数据目录确认／建库(幂等自愈)／只读验证；
+ *   ② 老侧「只读验证」那一步的 detail 是**硬编码**「SELECT 1 ✓ · bills 表 ✓」（`cli.py:262`），
+ *      而它实际只跑了 `PRAGMA table_info` 与 `SELECT COUNT(*)`（`cli.py:252-253`）——新侧真跑真报，
+ *      那两句读数由 `./run.js` 从真结果里取（见 `docs/skills/skill-bill/t731-差异表.md`）；
+ *   ③ 老侧环境检测在**每一步**都会 `mkdir` 数据目录并短暂写一个探测文件（`cli.py:114-133`），
+ *      新侧照旧做真探测（可写才报可写），但探测文件用完即删、不留痕。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+const WORD = projectWakeWord({ key: 'bill.setup.run', op: 'init' });
+const KEY = 'bill.setup.run';
+export const SCENE = {
+    id: 'init',
+    sceneId: 'setup_init_wizard',
+    key: KEY,
+    op: 'init',
+    page: 'wizard',
+    title: '首次使用向导',
+    caliber: '4 步零决策',
+    subtitle: '4 步零决策 · 自动检测 · 一次成功',
+    promptOf: () => '请加载「饼干记账」技能,帮我开始使用饼干记账(唤醒词:' + WORD + '):\n',
+};
+//# sourceMappingURL=scene-init.js.map

package/dist/setup/scene-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-init.js","sourceRoot":"","sources":["../../src/setup/scene-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5E,MAAM,GAAG,GAAG,gBAAyB,CAAC;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,MAAM;IACV,OAAO,EAAE,mBAAmB;IAC5B,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,sBAAsB;IAChC,QAAQ,EAAE,GAAG,EAAE,CAAC,6BAA6B,GAAG,IAAI,GAAG,MAAM;CAC9D,CAAC"}

package/dist/setup/scene-restore.d.ts

@@ -0,0 +1,3 @@
+import type { SetupScene } from './scene.js';
+export declare const SCENE: SetupScene;
+//# sourceMappingURL=scene-restore.d.ts.map

package/dist/setup/scene-restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-restore.d.ts","sourceRoot":"","sources":["../../src/setup/scene-restore.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,eAAO,MAAM,KAAK,EAAE,UAenB,CAAC"}

package/dist/setup/scene-restore.js

@@ -0,0 +1,33 @@
+/** 场景件：**从备份恢复**（`op=restore`）——本件只是差异声明，块位序列住 `./template-wizard.js`。
+ *
+ * 本件的差异（老侧 `templates/开始使用/restore.html` ＋ `scripts/backup.py` 的 `restore_backup`）：
+ *   ① **本域最高危缺陷在这里被修掉**（`#688` §二 D5／`.scratch/t731/old-setup.md` §7(a)）：老侧切换备份后
+ *      详情卡与步骤说明仍读初值 `sel`（`restore.html:141-145`／`:135`），而高亮与复制文案用新选的
+ *      （`restore.html:167-169`／`:174`）——**确认前看到的不是将要恢复的**。新侧「选中的那一份」只有一处
+ *      （`./template-wizard.js` 的 `RestoreWizardInput.selected`），详情、步骤说明、口令三处都从它派生；
+ *   ② 恢复前**无条件**自动备份现状（老侧 `backup.py:122-124`，原样继承）＋ 显式覆盖警告
+ *      （老侧 `restore.html:159` 的原文意思）＋ 警告里写清「怎么回去」；
+ *   ③ 老侧是「先覆盖、后校验」（`backup.py:128-131` 在 `:139-142` 之前）——新侧把**校验挪到覆盖之前**
+ *      （先验那一份备份读得动，再动现状），失败时点名现状备份（老侧 `backup.py:145` 那句的意思）；
+ *   ④ 老侧步骤号写死 2／3 且总数不显示（`restore.html:136/138`）——新侧编号与总数都由 `./steps.js` 算。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+const WORD = projectWakeWord({ key: 'bill.setup.run', op: 'restore' });
+const KEY = 'bill.setup.run';
+export const SCENE = {
+    id: 'restore',
+    sceneId: 'setup_restore',
+    key: KEY,
+    op: 'restore',
+    page: 'wizard',
+    title: '从备份恢复',
+    caliber: '详情预览',
+    subtitle: '预览详情 → 确认 → 恢复 → 验证（恢复前自动备份现状）',
+    /** 口令里那一格照老侧写「备  份」（中间两个空格，`scenes/setup.yaml:72` 逐字同形）；
+     *  给了 `name` 就填选中的那一份，没给写占位（与老侧 `restore.html:174` 的 `'____'` 同义）。 */
+    promptOf: (params) => {
+        const name = typeof params['name'] === 'string' && params['name'].trim() !== '' ? params['name'].trim() : '____';
+        return '请加载「饼干记账」技能,帮我从备份恢复数据(唤醒词:' + WORD + '):\n\n  备  份: ' + name + ' (默认最新备份)\n';
+    },
+};
+//# sourceMappingURL=scene-restore.js.map

package/dist/setup/scene-restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-restore.js","sourceRoot":"","sources":["../../src/setup/scene-restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AAC/E,MAAM,GAAG,GAAG,gBAAyB,CAAC;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,EAAE,SAAS;IACb,OAAO,EAAE,eAAe;IACxB,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,gCAAgC;IAC1C;0EACsE;IACtE,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACjH,OAAO,4BAA4B,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,GAAG,aAAa,CAAC;IACvF,CAAC;CACF,CAAC"}

package/dist/setup/scene.d.ts

@@ -0,0 +1,26 @@
+import type { SetupOp, SetupPage } from './params.js';
+/** 一件场景件：一条场景（＝一种 op）的落点与差异值。 */
+export interface SetupScene {
+    /** 件的名字（与文件名 `scene-<id>.ts` 对得上）。 */
+    readonly id: string;
+    /** 域声明里的场景 id（`./declaration.js` 的 `scenes[].id`；`测试`按它逐条对账）。 */
+    readonly sceneId: string;
+    readonly key: 'bill.setup.run';
+    readonly op: SetupOp;
+    /** 这一件出哪一片页型。 */
+    readonly page: SetupPage;
+    /** 页面名（正文最大那一个字；老侧六张模板的 `<h1>` 逐字同句）。 */
+    readonly title: string;
+    /** 徽章第二枚那句口径（老侧 chips 里那一枚，如「4 步零决策」）。 */
+    readonly caliber: string;
+    /** 副标题（老侧六张模板的 `data.subtitle` 同句）。 */
+    readonly subtitle: string;
+    /** 给助手那句口令（复制按钮拷走的那一段；**纯文本**，不带任何渲染调用）。 */
+    readonly promptOf: (params: Record<string, unknown>) => string;
+}
+/** 6 行的落点表（**唯一定义地**）：顺序＝域声明里那五条词的书写顺序（初始化／初始化状态／备份／恢复备份／导入）。 */
+export declare const SETUP_SCENES: readonly SetupScene[];
+/** 取件：按 `op` 认（六种 op 各一件）。认不得的 op 即抛——**不猜、不兜底**
+ *  （`op` 已在 `./params.js` 的 `parseSetupOp` 拦过一道，走到这里还认不得即是代码缺陷）。 */
+export declare function setupSceneFor(op: SetupOp): SetupScene;
+//# sourceMappingURL=scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/setup/scene.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQtD,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CAChE;AAED,iEAAiE;AACjE,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAE7C,CAAC;AAIF;oEACoE;AACpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,UAAU,CAMrD"}

package/dist/setup/scene.js

@@ -0,0 +1,42 @@
+/** 开始使用域场景件的公共契约与落点表（**唯一定义地**）。
+ *
+ * 本件回答两件事：
+ *   ① 一件场景件长什么样——`SetupScene`（id／命令全名／认的 op／哪一片页型／页面名／徽章口径／
+ *      副标题／给助手那句口令）；
+ *   ② 一条 op 该落哪一件——`setupSceneFor`。
+ *
+ * 落点表有 **6 行**：六条场景（`scenes/setup.yaml` 的六个 `scenario_id`）一件一支，其中「备份」一词两支
+ *   （一键备份 `scene-backup-create.ts` 出结果回执页、查看备份 `scene-backup-list.ts` 出记录列表页）——
+ *   这正是 `t687-parity-审计清单.md` §2 第 66-70 行点名的那个形状。
+ *
+ * 六件按**三片页型**分（`packages/skill-bill/docs/t685-按域页型表.md` §2.7 那三行）：
+ *   向导（`./template-wizard.js`）盖初始化／恢复备份／导入；结果回执（`./template-receipt.js`）盖一键备份；
+ *   记录列表（`./template-list.js`）盖查看备份／初始化状态。
+ *
+ * 场景件**只声明差异值**（页面名、徽章口径、副标题、给助手那句口令），一行块序都不写、不 import 任何
+ *   块位渲染函数——判据乙那道门（`scripts/check-scene-shape.mjs`）扫的就是这里。
+ *
+ * 谁在用（两个调用点，指名）：① `./run.js`——六种 op 的处理体按 op 取件；② 测试按既有取法直取本表。
+ */
+import { BillPolicyError } from '../fetch/errors.js';
+import { SCENE as sceneBackupCreate } from './scene-backup-create.js';
+import { SCENE as sceneBackupList } from './scene-backup-list.js';
+import { SCENE as sceneImport } from './scene-import.js';
+import { SCENE as sceneInitStatus } from './scene-init-status.js';
+import { SCENE as sceneInit } from './scene-init.js';
+import { SCENE as sceneRestore } from './scene-restore.js';
+/** 6 行的落点表（**唯一定义地**）：顺序＝域声明里那五条词的书写顺序（初始化／初始化状态／备份／恢复备份／导入）。 */
+export const SETUP_SCENES = [
+    sceneInit, sceneInitStatus, sceneBackupCreate, sceneBackupList, sceneRestore, sceneImport,
+];
+const BY_OP = new Map(SETUP_SCENES.map((s) => [s.op, s]));
+/** 取件：按 `op` 认（六种 op 各一件）。认不得的 op 即抛——**不猜、不兜底**
+ *  （`op` 已在 `./params.js` 的 `parseSetupOp` 拦过一道，走到这里还认不得即是代码缺陷）。 */
+export function setupSceneFor(op) {
+    const hit = BY_OP.get(op);
+    if (hit === undefined) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', '开始使用域没有这一支操作：' + String(op));
+    }
+    return hit;
+}
+//# sourceMappingURL=scene.js.map

package/dist/setup/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../src/setup/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,KAAK,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsB3D,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW;CAC1F,CAAC;AAEF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAsB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/E;oEACoE;AACpE,MAAM,UAAU,aAAa,CAAC,EAAW;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/setup/status.d.ts

@@ -0,0 +1,47 @@
+/** 开始使用域的**初始化状态**事实（`op=init-status`，`t685-按域页型表.md` §2.7 的「记录列表」页型里那一支状态页）。
+ *
+ * 老侧对应件：`开始使用/init_status.html:140-147`（英雄区 ＋ 检查清单 ＋ 迁移块 ＋ 引导块）与
+ *   `scripts/setup/cli.py` 的 `cmd_init_status`。三重判定＝**数据存在／结构版本／就绪**；
+ *   迁移提示**独立成块**（`#688` §二 C11：`schema` 迁移有专属样式块与「需要迁移」标题，不混进普通检查项）。
+ *
+ * 一处与老侧不同的口径（记在 `docs/skills/skill-bill/t731-差异表.md`）：老侧靠「读 schema 版本号再自己迁移」，
+ *   本仓的库句柄在打开时就把 v1.0 的老库补成 v2.0（`src/fetch/db.ts` 的 DDL 自愈）——补了什么**当面报出来**
+ *   （`BillDb.repaired`），所以迁移块报的是「本次补了什么」这一件真事实，而不是一句无人看见的提示。
+ */
+import type { BillDb } from '../fetch/index.js';
+/** 一条检查项（三重判定里的一重）。 */
+export interface StatusCheck {
+    readonly label: string;
+    readonly ok: boolean;
+    readonly detail: string;
+}
+/** 初始化状态的全部事实（状态页与出口载荷都读这一件）。 */
+export interface SetupStatus {
+    readonly dbPath: string;
+    /** 库文件在不在（老侧第一重：数据存在）。 */
+    readonly dbExists: boolean;
+    /** `bills` 表在不在（表不在＝这个位置还不是一个记账库）。 */
+    readonly tableExists: boolean;
+    /** 表里的列名（结构版本的判据）。 */
+    readonly columns: readonly string[];
+    /** 库里有几条记录（含软删；0 是真实读数，照实写 0）。 */
+    readonly rows: number;
+    /** 结构版本：`v2.0`＝十列齐（含 `deleted_at`）、`v1.0`＝缺那一列、`—`＝表还没建。 */
+    readonly version: string;
+    /** 三重全过＝可以开始记账。 */
+    readonly ready: boolean;
+    readonly checks: readonly StatusCheck[];
+    /** 本次打开库时自动补的东西（空数组＝结构本来就是齐的）。 */
+    readonly repaired: readonly string[];
+    /** 结构仍不是 v2.0（`deleted_at` 缺着）＝需要迁移。 */
+    readonly needsMigration: boolean;
+    /** 表在但一条记录都没有（空库两态里的「库里没数据」，与「窗口为空」不是一件事）。 */
+    readonly emptyLibrary: boolean;
+}
+/** v2.0 的判据列（老侧 `bills` 十列里唯一区分两代结构的那一列）。 */
+export declare const V2_MARKER_COLUMN = "deleted_at";
+/** `bills` 十列（v2.0 的全集；缺哪一列就在状态页上点名）。 */
+export declare const BILLS_COLUMNS: readonly string[];
+/** 读一次初始化状态（只读：不建目录、不写文件、不改结构——结构自愈发生在开库那一步，本件只报）。 */
+export declare function readSetupStatus(db: BillDb): SetupStatus;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/setup/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,uBAAuB;AACvB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,yCAAyC;AACzC,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAE1C,CAAC;AAgBF,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAyCvD"}