skill-bill 0.2.0 → 0.2.2

package/dist/goal/write.js

@@ -0,0 +1,131 @@
+/** `bill.goal.write`（设定预算／设定目标）的处理体：两支操作，一处分流。
+ *
+ * 谁在用（一个调用点，指名）：`src/goal/commands.ts` 那条命令声明引本件——
+ *  出口分派 `src/cli/cmd_read.ts` 只查注册表再调声明里的 `run`，不再认这个命令名。
+ *
+ * 两支的分岔口径（照写入域两条写命令、账户域那条写命令的同一套规矩）：
+ *   **有阻断项不再报参数错退出**，改出过程型采集页，退出码 0、`ok:false`、不写库；
+ *   阻断项＝缺必需槽位、值进不去（金额非正数／月份形态不认／截止日不是真实日期），
+ *   **或**目标表那一层的冲突（同月同类预算已存在，且没给「确认覆盖」）。
+ *   阻断项清空即写库：设定预算动 `goals.json` 的 `budgets`（覆盖＝删旧加新），设定目标动 `savings`；
+ *   两支都出结果型回执整页。
+ *
+ * 老侧对应件：`scripts/goal/cli.py` 的 `cmd_set_budget`／`cmd_set_saving`。三处行为差异逐条记在
+ *  `docs/skills/skill-bill/t730-差异表.md`（其中一处最要紧）：
+ *  ① 老侧「同月同类预算已存在」是一句 `emit_ok`（`status:ok` ＋ `data.conflict:true`）＋ 一句
+ *     「确认覆盖请加 --force」，退出码 0 但不写库；新侧出**阻断页**（exit 0、`ok:false`、不写库、逐项点名），
+ *     并把「已存在哪一条、原来的金额」摆到页上——两边的实质相同（都要用户确认），新侧把这件事
+ *     收进与缺项同一条路径（#688 裁定 9），用户不必去 stdout 里读那句提示。
+ *  ② 覆盖是**删旧加新**（新的那条拿新编号），照老侧 `cli.py:149-153` 逐字同形。
+ *  ③ 回执文案用规范词：空分类写「全月总预算」（老侧 CLI 那句写「总」、页面写「总预算」——**同域两套**，
+ *     新侧取一处；见仓规 `用词纪律`）。
+ */
+import { loadGoals, resolveGoalsPath, saveGoals } from '../fetch/index.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { MONTH_RE } from '../shared/dateRange.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { appendBudget, appendSaving, budgetsOf, findBudget, savingsOf } from './goalData.js';
+import { SOURCE_COLLECT, SOURCE_WRITE, money } from './pageParts.js';
+import { FORCE_SLOT, goalBlocked, localMonth, parseGoalWriteOp, textOf, validateSetBudget, validateSetSaving } from './params.js';
+import { writeSceneFor } from './scene.js';
+/** 空分类在上屏时的规范说法（一处定义：回执、页面、日志都读它）。 */
+const ALL_CATEGORY_CN = '全月总预算';
+/** 目标表那一层的阻断：同月同类预算已经有一条，而用户没给「确认覆盖」（老侧 `cli.py:143-147` 那条路）。
+ *  **本件只吃参数与预算表**，判定与文案都在这里一处（缺项那半住 `./params.js`）。 */
+function conflictBlockedOf(op, params, budgets) {
+    if (op !== 'set-budget' || params['force'] === true)
+        return [];
+    const raw = textOf(params['month']);
+    const month = MONTH_RE.test(raw) ? raw : localMonth();
+    const category = textOf(params['category']);
+    const hit = findBudget(budgets, month, category);
+    if (hit === null)
+        return [];
+    return [{
+            name: FORCE_SLOT.name,
+            label: FORCE_SLOT.label,
+            why: '「' + month + ' · ' + (category === '' ? ALL_CATEGORY_CN : category) + '」已经有一条 '
+                + money(hit.amount) + ' 元的预算；要覆盖它就把「' + FORCE_SLOT.label + '」给上',
+        }];
+}
+/** 有阻断项时那句载荷说明（envelope 的 `message`；也是 stdout 上那句 `data.message`）。 */
+function blockedMessageOf(word, blocked) {
+    return word + '还差 ' + String(blocked.length) + ' 项：' + blocked.map((b) => b.label).join('、')
+        + '（已出采集页，补齐之后跟助手说一遍）';
+}
+/** 两支写操作共用的收口：回执事实 ＋ 回执整页。`at` 由调用方取一次（同一次调用只有一个写入时刻）。 */
+function finish(input) {
+    const receipt = {
+        op: input.op,
+        summary: input.summary,
+        /** 改动处数：目标表住 `goals.json`（不在 SQLite），**没有 `total_changes()` 可读**，
+         *  故**自报**——一条预算／一个目标就是一处（与账户域的账户表那一半同一处置与同一理由）。 */
+        affectedRows: 1,
+        actionAt: input.at,
+        source: SOURCE_WRITE,
+        overwritten: input.overwritten,
+        budgetCount: input.goals.budgets.length,
+        savingCount: input.goals.savings.length,
+    };
+    return {
+        data: { ok: true, message: input.summary, receipt },
+        html: input.scene.receipt({ key: input.key, params: input.params, receipt, detail: input.detail }),
+    };
+}
+/** `bill.goal.write`：设定预算与设定目标，一处分流。
+ *  **不收库句柄**：这两支动的都是 `goals.json` 的 `budgets`／`savings` 两键（`bills` 表一字不改），
+ *  故不需要 `BillDb`——声明里的 `WriteHandler` 多给一个参数，本件少收一个（TS 里合法、且是真话）。 */
+export function writeGoal(params) {
+    const key = 'bill.goal.write';
+    const op = parseGoalWriteOp(params);
+    const scene = writeSceneFor(op);
+    const goalsPath = resolveGoalsPath();
+    const goals = loadGoals(goalsPath);
+    const budgets = budgetsOf(goals);
+    const blocked = [...goalBlocked(op, params), ...conflictBlockedOf(op, params, budgets)];
+    if (blocked.length > 0) {
+        const word = projectWakeWord({ key, op });
+        return {
+            data: { ok: false, message: blockedMessageOf(word, blocked) },
+            html: scene.collect({
+                key, op, params, blocked, budgets, savings: savingsOf(goals),
+                source: SOURCE_COLLECT, actionAt: actionStamp(),
+            }),
+        };
+    }
+    const at = actionStamp();
+    if (op === 'set-budget') {
+        const { month, category, amount } = validateSetBudget(params);
+        const before = findBudget(budgets, month, category);
+        appendBudget(goals, { month, category, amount, createdAt: at });
+        saveGoals(goalsPath, goals);
+        const label = category === '' ? ALL_CATEGORY_CN : category;
+        return finish({
+            key, op, params, scene, goals, at,
+            summary: '已设定预算：' + month + ' ' + label + ' ' + money(amount) + ' 元'
+                + (before === null ? '' : '（覆盖了原来的 ' + money(before.amount) + ' 元）'),
+            detail: [
+                { k: '月份', v: month },
+                { k: '分类', v: label },
+                { k: '金额', v: money(amount) + ' 元' },
+                { k: '记下的时间', v: at },
+            ],
+            overwritten: before === null ? null : { month, category, amount: before.amount },
+        });
+    }
+    const { name, amount, deadline } = validateSetSaving(params);
+    appendSaving(goals, { name, amount, deadline, createdAt: at });
+    saveGoals(goalsPath, goals);
+    return finish({
+        key, op, params, scene, goals, at,
+        summary: '已设定目标「' + name + '」' + money(amount) + ' 元' + (deadline === null ? '' : '（截止 ' + deadline + '）'),
+        detail: [
+            { k: '目标', v: name },
+            { k: '目标金额', v: money(amount) + ' 元' },
+            { k: '截止日期', v: deadline === null ? '不限' : deadline },
+            { k: '记下的时间', v: at },
+        ],
+        overwritten: null,
+    });
+}
+//# sourceMappingURL=write.js.map

package/dist/goal/write.js.map

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

package/dist/health.d.ts

@@ -0,0 +1,41 @@
+/** 报告里的三档判据（与面板侧镜像同值）。 */
+export type HealthStatus = 'red' | 'yellow' | 'green';
+export interface HealthItem {
+    readonly id: string;
+    readonly title: string;
+    readonly status: HealthStatus;
+    readonly message: string;
+    readonly action: string;
+    readonly source?: string;
+}
+export interface BillHealthReport {
+    readonly skill: string;
+    readonly configPath: string;
+    readonly dataDir: string;
+    readonly items: readonly HealthItem[];
+}
+/** 库表数门槛：`src/fetch/db.ts` 只建一张业务表 `bills`（＋同表两个索引）。 */
+export declare const DB_TABLE_THRESHOLD: 1;
+/** 只读解析结果：文件不在／读得出取值与「哪些键真在文件里」／读不出来（报文带行号与文件名）。 */
+export type ConfigRead = {
+    readonly kind: 'missing';
+} | {
+    readonly kind: 'ok';
+    readonly values: Record<string, Record<string, unknown>>;
+    readonly present: ReadonlySet<string>;
+} | {
+    readonly kind: 'bad';
+    readonly message: string;
+};
+/**
+ * 只读解析那份配置文件（与 `base-link-core` 的受限子集同一套校验，口径逐条对齐）：
+ * 剥 BOM、去 `\r`、空行与整行注释跳过、缩进只许 2 个空格且不许制表符、不支持列表、
+ * 一行须是「键: 值」、不许重复定义、顶层键冒号后没值即开一个组。
+ *
+ * 与 `loadConfig()` 的差别只有一处、也正是本件要的那一处：**文件不在时不落默认件**。
+ * 取值语义与它一致：文件里缺的项按默认值补。
+ */
+export declare function readBillConfigReadOnly(): ConfigRead;
+/** 跑一次体检，返回整份报告。**只读**：任何一处都不落盘（只有写探针那一个文件，且当场删掉）。 */
+export declare function buildBillHealthReport(): BillHealthReport;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAwBA,0BAA0B;AAC1B,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,EAAG,CAAU,CAAC;AAS7C,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GACxH;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,UAAU,CAYnD;AAoPD,sDAAsD;AACtD,wBAAgB,qBAAqB,IAAI,gBAAgB,CAiKxD"}

package/dist/health.js

@@ -0,0 +1,456 @@
+/** 饼干记账自己的配置体检（票 #706）：一份只读的报告，回答「我配的东西现在通不通」。
+ *
+ * 口径（票面「开工前的形状裁定」）：
+ *   · **判据住技能侧**——每条的有效值（库在哪、产物落哪个目录、第二份库叫什么）只有本包算得出来；
+ *     插件包与总管只透传与渲染，不重写这里的任何一个字。
+ *   · **只报不改**——不建目录、不写文件、不落那份默认配置；凡是要建目录才算得出的结论，一律当「不在」报。
+ *     所以本件**不许**调 `loadBillConfig()`（文件不在即落一份默认件），配置一律本件只读解析
+ *     （`base-link-core` 的受限子集解析器**没有对外**，见其包门只有四条）。
+ *   · 报告形状见面板侧镜像 `packages/plugin-manager/src/health-contract.ts`（唯一消费者）。
+ *
+ * 检查项与检查表 `docs/research/check-table-671-life-panel-20260917.html` 逐条对应：
+ * 六家通用 5 条（配置文件本身／数据目录／库文件表数／产物目录／这个值从哪来）
+ * ＋ 记账特有 2 条（第二份库 goals.json／备份目录）。
+ *
+ * 本件与卡路里那份 `packages/skill-calorie/src/health.ts` 同形（同一套受限子集解析、同一套写探针、
+ * 同一个 `node:sqlite` 只读读表数），只换本家那份配置表与自有项——读的人一眼认得出是同一条链。
+ */
+import { existsSync, readFileSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { configPaths } from 'base-link-core';
+import { BILL_CONFIG_DEFAULTS, BILL_CONFIG_STEM } from './config.js';
+/** 库表数门槛：`src/fetch/db.ts` 只建一张业务表 `bills`（＋同表两个索引）。 */
+export const DB_TABLE_THRESHOLD = 1;
+const SKILL = 'bill';
+/** 人话里的路径一律用正斜杠：报告给页面看，也让跨平台读数可比。 */
+function p(path) {
+    return path.replace(/\\/g, '/');
+}
+/**
+ * 只读解析那份配置文件（与 `base-link-core` 的受限子集同一套校验，口径逐条对齐）：
+ * 剥 BOM、去 `\r`、空行与整行注释跳过、缩进只许 2 个空格且不许制表符、不支持列表、
+ * 一行须是「键: 值」、不许重复定义、顶层键冒号后没值即开一个组。
+ *
+ * 与 `loadConfig()` 的差别只有一处、也正是本件要的那一处：**文件不在时不落默认件**。
+ * 取值语义与它一致：文件里缺的项按默认值补。
+ */
+export function readBillConfigReadOnly() {
+    const file = configPaths(BILL_CONFIG_STEM).configFile;
+    if (!existsSync(file))
+        return { kind: 'missing' };
+    let text;
+    try {
+        text = readFileSync(file, 'utf8');
+    }
+    catch (e) {
+        return { kind: 'bad', message: '读配置文件失败：' + file + '（' + (e instanceof Error ? e.message : String(e)) + '）' };
+    }
+    const parsed = parseSubset(text, file);
+    if (!parsed.ok)
+        return { kind: 'bad', message: parsed.message };
+    return { kind: 'ok', values: projectOnDefaults(parsed.values), present: presentKeysOf(parsed.values) };
+}
+/** 文件里真写了哪些键（扁平成 `组.键`）：给「这个值从哪来」那条判据用。
+ *
+ * 为什么不能直接看投到默认值表之后的值：**空串＝按默认落点**——留空的项值看起来与默认值一样，
+ * 但它的来源是「用户写了空串」，不是「文件里没有这一项」。混起来就会把来源报错。 */
+function presentKeysOf(values) {
+    const out = new Set();
+    for (const [group, got] of Object.entries(values)) {
+        if (typeof got !== 'object' || got === null) {
+            out.add(group);
+            continue;
+        }
+        for (const key of Object.keys(got))
+            out.add(group + '.' + key);
+    }
+    return out;
+}
+/** 受限子集的极简解析：只算值与行号，不算别的（校验口径与配置件同一套）。 */
+function parseSubset(text, file) {
+    const source = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    const lines = source.replace(/\r\n?/g, '\n').split('\n');
+    const values = {};
+    const lineOf = new Map();
+    let openGroup = null;
+    let openGroupLine = 0;
+    /** 标量解析的失败口：`parseScalar` 把报文写进 `scalarError`，调用处读它即可（不抛，免得类型糊）。 */
+    let scalarError = '';
+    const fail = (line, why) => ({ ok: false, message: '配置件第 ' + String(line) + ' 行：' + why + '（文件：' + file + '）' });
+    const closeGroup = () => {
+        if (openGroup !== null && Object.keys(values[openGroup]).length === 0) {
+            return fail(openGroupLine, '键「' + openGroup + '」冒号后没有值，也没有子项').message;
+        }
+        openGroup = null;
+        return null;
+    };
+    for (let i = 0; i < lines.length; i += 1) {
+        const lineNo = i + 1;
+        const raw = lines[i] ?? '';
+        if (raw.trim() === '')
+            continue;
+        if (/^\s*#/.test(raw))
+            continue;
+        const head = /^[ \t]*/.exec(raw)?.[0] ?? '';
+        const body = raw.slice(head.length);
+        if (head.includes('\t'))
+            return fail(lineNo, '缩进里有制表符：本子集只许空格，且嵌套缩进恰好 2 个空格');
+        if (body.startsWith('-'))
+            return fail(lineNo, '本子集不支持列表（「-」开头的行）');
+        const matched = /^([A-Za-z_][A-Za-z0-9_.-]*)[ \t]*:[ \t]*(.*)$/.exec(body);
+        if (matched === null)
+            return fail(lineNo, '不是「键: 值」形状：' + body.trim());
+        const key = matched[1];
+        const rest = (matched[2] ?? '').trim();
+        if (head.length > 0) {
+            if (head.length !== 2)
+                return fail(lineNo, '缩进必须恰好 2 个空格（本子集只支持一层嵌套），实为 ' + String(head.length) + ' 个空格');
+            if (openGroup === null)
+                return fail(lineNo, '缩进的子项「' + key + '」上面没有开着子的顶层键');
+            const group = values[openGroup];
+            if (Object.prototype.hasOwnProperty.call(group, key)) {
+                return fail(lineNo, '键「' + openGroup + '.' + key + '」重复定义（第 ' + String(lineOf.get(openGroup + '.' + key)) + ' 行已定义）');
+            }
+            if (rest === '')
+                return fail(lineNo, '键「' + openGroup + '.' + key + '」冒号后没有值');
+            const scalar = parseScalar(rest, lineNo, fail, (message) => {
+                scalarError = message;
+            });
+            if (scalarError !== '')
+                return { ok: false, message: scalarError };
+            group[key] = scalar;
+            lineOf.set(openGroup + '.' + key, lineNo);
+            continue;
+        }
+        const closedError = closeGroup();
+        if (closedError !== null)
+            return { ok: false, message: closedError };
+        if (Object.prototype.hasOwnProperty.call(values, key)) {
+            return fail(lineNo, '键「' + key + '」重复定义（第 ' + String(lineOf.get(key)) + ' 行已定义）');
+        }
+        lineOf.set(key, lineNo);
+        if (rest === '') {
+            values[key] = {};
+            openGroup = key;
+            openGroupLine = lineNo;
+            continue;
+        }
+        const scalar = parseScalar(rest, lineNo, fail, (message) => {
+            scalarError = message;
+        });
+        if (scalarError !== '')
+            return { ok: false, message: scalarError };
+        values[key] = scalar;
+    }
+    const tailError = closeGroup();
+    if (tailError !== null)
+        return { ok: false, message: tailError };
+    return { ok: true, values };
+}
+/** 标量：带引号／数字／布尔／裸字符串（值后的 `#` 注释照配置件同一口径切掉）。 */
+function parseScalar(text, lineNo, fail, onError) {
+    const first = text[0];
+    if (first === '"' || first === "'") {
+        const quote = first;
+        let out = '';
+        let i = 1;
+        let closed = false;
+        for (; i < text.length; i += 1) {
+            const ch = text[i];
+            if (ch === quote) {
+                if (quote === "'" && text[i + 1] === "'") {
+                    out += "'";
+                    i += 1;
+                    continue;
+                }
+                closed = true;
+                break;
+            }
+            if (quote === '"' && ch === '\\') {
+                const next = text[i + 1];
+                out += next === 'n' ? '\n' : next === 't' ? '\t' : (next ?? '');
+                i += 1;
+                continue;
+            }
+            out += ch;
+        }
+        if (!closed) {
+            onError(fail(lineNo, '引号没有闭合：' + text).message);
+            return '';
+        }
+        return out;
+    }
+    let cut = text.length;
+    for (let i = 0; i < text.length; i += 1) {
+        if (text[i] === '#' && (i === 0 || /\s/.test(text[i - 1]))) {
+            cut = i;
+            break;
+        }
+    }
+    const body = text.slice(0, cut).trim();
+    if (body === '') {
+        onError(fail(lineNo, '冒号后没有值（只有注释）').message);
+        return '';
+    }
+    if (body === 'true')
+        return true;
+    if (body === 'false')
+        return false;
+    if (/^-?(\d+\.?\d*|\.\d+)$/.test(body))
+        return Number(body);
+    return body;
+}
+/** 把文件里读到的取值投到默认值表的形状上（缺项补默认值；组内只取默认值表认得的键）。 */
+function projectOnDefaults(values) {
+    const out = {};
+    for (const [group, def] of Object.entries(BILL_CONFIG_DEFAULTS)) {
+        const bucket = {};
+        const got = values[group];
+        const source = typeof got === 'object' && got !== null ? got : {};
+        for (const [key, defValue] of Object.entries(def)) {
+            const mine = source[key];
+            bucket[key] = typeof mine === typeof defValue ? mine : defValue;
+        }
+        out[group] = bucket;
+    }
+    return out;
+}
+/** 取值：一层嵌套按 `组.键` 读（缺层或类型不符回 undefined）。 */
+function readValue(values, group, key) {
+    return values[group]?.[key];
+}
+/** 有值的字符串（空串＝未配，按 `undefined` 处理，语义与各取用处一致）。 */
+function textOf(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : '';
+}
+/** 「这个值从哪来」：真在文件里写了就是「配置文件」，否则按默认值（文件不存在则全按默认值）。 */
+function sourceOf(present, key) {
+    return present.has(key) ? '配置文件' : '默认值';
+}
+/** 目录那一项的形状是**段串**（`biscuit_accountant_html`；大厨／作息是两段），段数与 `src/config.ts`
+ *  自己的 `splitDirSegments` 同一口径。本件不 import 它：health 面与配置面互锁没有好处，
+ *  而这条规则只有三行。 */
+function splitDirSegments(value) {
+    return value.split(/[\\/]+/).filter((s) => s.length > 0);
+}
+/** 目录能不能写：建一个探针文件再删掉（老技能三家同一套做法）。**不建目录本身**。 */
+function writeProbe(dir) {
+    const probe = join(dir, '.ilife-health-probe-' + String(process.pid) + '-' + String(Date.now()));
+    try {
+        writeFileSync(probe, 'probe', { encoding: 'utf8', flag: 'wx' });
+        unlinkSync(probe);
+        return { ok: true, reason: '' };
+    }
+    catch (e) {
+        return { ok: false, reason: e instanceof Error ? e.message : String(e) };
+    }
+}
+/** 已算过的目录结论按路径记一份：同一份报告里同一个目录不重复起写探针。 */
+const dirMemo = new Map();
+function dirVerdict(dir) {
+    const memoized = dirMemo.get(dir);
+    if (memoized !== undefined)
+        return memoized;
+    const verdict = dirVerdictUncached(dir);
+    dirMemo.set(dir, verdict);
+    return verdict;
+}
+function dirVerdictUncached(dir) {
+    if (!existsSync(dir))
+        return { exists: false, writable: false, reason: '' };
+    try {
+        if (!statSync(dir).isDirectory())
+            return { exists: false, writable: false, reason: '同名文件占了它的位置' };
+    }
+    catch (e) {
+        return { exists: false, writable: false, reason: e instanceof Error ? e.message : String(e) };
+    }
+    const probe = writeProbe(dir);
+    return { exists: true, writable: probe.ok, reason: probe.reason };
+}
+/** 开库读表数（只读打开，不建库、不迁移）。打不开即当作「读不出」。 */
+function tableCount(file) {
+    let db = null;
+    try {
+        db = new DatabaseSync(file, { readOnly: true });
+        const rows = db.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all();
+        const names = rows.map((row) => String(row.name ?? '')).filter((name) => name !== '' && !name.startsWith('sqlite_'));
+        return { ok: true, count: names.length, reason: '' };
+    }
+    catch (e) {
+        return { ok: false, count: 0, reason: e instanceof Error ? e.message : String(e) };
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch {
+            /* 关不掉不影响结论 */
+        }
+    }
+}
+/** 跑一次体检，返回整份报告。**只读**：任何一处都不落盘（只有写探针那一个文件，且当场删掉）。 */
+export function buildBillHealthReport() {
+    const paths = configPaths(BILL_CONFIG_STEM);
+    const items = [];
+    const read = readBillConfigReadOnly();
+    const values = read.kind === 'ok' ? read.values : projectOnDefaults({});
+    const present = read.kind === 'ok' ? read.present : new Set();
+    // ① 配置文件本身：能不能解析；它落在默认位置还是被 ILIFE_CONFIG_DIR 指到别处（只陈述，不评价）。
+    const defaultConfigFile = join(homedir(), '.ilife', BILL_CONFIG_STEM + '.yaml');
+    const relocated = paths.configFile !== defaultConfigFile;
+    const where = relocated ? '位置被 ILIFE_CONFIG_DIR 指到这里' : '默认位置';
+    if (read.kind === 'bad') {
+        items.push({
+            id: 'config.file', title: '配置文件', status: 'red',
+            message: read.message,
+            action: '照报文指的行号改回「键: 值」的写法；改不动就删掉这个文件，让技能按默认值重落一份。',
+            source: '配置文件',
+        });
+    }
+    else if (read.kind === 'missing') {
+        items.push({
+            id: 'config.file', title: '配置文件', status: 'yellow',
+            message: '配置文件还不存在：' + p(paths.configFile) + '（现在跑的是默认值）。',
+            action: '在面板上保存一次即会落一份；也可点「重置为默认」。',
+            source: '默认值',
+        });
+    }
+    else {
+        items.push({
+            id: 'config.file', title: '配置文件', status: 'green',
+            message: '能解析：' + p(paths.configFile) + '（' + where + '）。',
+            action: '',
+            source: '配置文件',
+        });
+    }
+    // ② 数据目录：在不在、能不能写。
+    const dbDirConfigured = textOf(readValue(values, 'db', 'dir'));
+    const dataDir = dbDirConfigured !== '' ? dbDirConfigured : paths.dataDir;
+    const dataDirSource = sourceOf(present, 'db.dir');
+    const dataDirVerdict = dirVerdict(dataDir);
+    items.push({
+        id: 'db.dir', title: '数据目录',
+        status: !dataDirVerdict.exists || !dataDirVerdict.writable ? 'red' : 'green',
+        message: !dataDirVerdict.exists
+            ? '不在：' + p(dataDir) + (dataDirVerdict.reason !== '' ? '（' + dataDirVerdict.reason + '）' : '')
+            : dataDirVerdict.writable
+                ? '在且能写：' + p(dataDir) + '。'
+                : '在，但写不进去：' + p(dataDir) + '（' + dataDirVerdict.reason + '）。',
+        action: !dataDirVerdict.exists
+            ? '先建这个目录，或把配置里的「数据目录」改到一个已存在的位置。'
+            : dataDirVerdict.writable ? '' : '去掉这个目录的只读属性，或把「数据目录」改到别处。',
+        source: dataDirSource,
+    });
+    // ③ 库文件：在不在 ＋ 表数够不够。
+    const dbNameConfigured = textOf(readValue(values, 'db', 'name'));
+    const dbName = dbNameConfigured !== '' ? dbNameConfigured : String(BILL_CONFIG_DEFAULTS.db.name);
+    const dbFile = join(dataDir, dbName);
+    const dbSource = sourceOf(present, 'db.name');
+    if (!existsSync(dbFile)) {
+        items.push({
+            id: 'db.file', title: '库文件', status: 'red',
+            message: '不在：' + p(dbFile) + '。',
+            action: '确认「数据目录」与「库文件名」对不对；新装的话，跑一条会写库的命令即会建库。',
+            source: dbSource,
+        });
+    }
+    else {
+        const tables = tableCount(dbFile);
+        if (!tables.ok) {
+            items.push({
+                id: 'db.file', title: '库文件', status: 'red',
+                message: '在，但打不开：' + p(dbFile) + '（' + tables.reason + '）。',
+                action: '这个文件可能不是库文件或已损坏；先备份，再看要不要让技能重建一份。',
+                source: dbSource,
+            });
+        }
+        else if (tables.count < DB_TABLE_THRESHOLD) {
+            items.push({
+                id: 'db.file', title: '库文件', status: 'yellow',
+                message: '在，但表不全：' + p(dbFile) + '（' + String(tables.count) + ' / ' + String(DB_TABLE_THRESHOLD) + ' 张表）。',
+                action: '缺表会让对应的功能报错；跑一次会写库的命令让它补齐，或从备份恢复。',
+                source: dbSource,
+            });
+        }
+        else {
+            items.push({
+                id: 'db.file', title: '库文件', status: 'green',
+                message: '在，' + String(tables.count) + ' 张表齐：' + p(dbFile) + '。',
+                action: '',
+                source: dbSource,
+            });
+        }
+    }
+    // ④ 产物目录：在不在、能不能写（还没建＝绿：交付页面时才落这里，那时自动建）。
+    const htmlDirValue = textOf(readValue(values, 'html', 'dir'));
+    const htmlDir = join(dataDir, ...splitDirSegments(htmlDirValue !== '' ? htmlDirValue : String(BILL_CONFIG_DEFAULTS.html.dir)));
+    const htmlVerdict = dirVerdict(htmlDir);
+    const htmlSource = sourceOf(present, 'html.dir');
+    items.push({
+        id: 'html.dir', title: '产物目录',
+        status: !htmlVerdict.exists ? 'green' : htmlVerdict.writable ? 'green' : 'yellow',
+        message: !htmlVerdict.exists
+            ? '还没建：' + p(htmlDir) + '（交付页面时才落这里，那时自动建）。'
+            : htmlVerdict.writable
+                ? '在且能写：' + p(htmlDir) + '。'
+                : '在，但写不进去：' + p(htmlDir) + '（交付会转成内联回执，不再落盘）。',
+        action: !htmlVerdict.exists || htmlVerdict.writable ? '' : '去掉这个目录的只读属性，或把「HTML 产物目录名」改到别处。',
+        source: htmlSource,
+    });
+    // ⑤ 这个值从哪来：只陈述数据目录与库文件名的来源，不判好坏（六家通用最后一条）。
+    items.push({
+        id: 'value.source', title: '这个值从哪来', status: 'green',
+        message: '数据目录走「' + dataDirSource + '」，库文件名走「' + dbSource + '」'
+            + (read.kind === 'missing' ? '（配置文件还不存在，落点全按默认值）。' : '。'),
+        action: '', source: dataDirSource,
+    });
+    // ⑥ 第二份库 goals.json（记账特有）：不在＝绿（预算功能没在用）；在但坏了＝红。
+    const goalsName = textOf(readValue(values, 'db', 'goals'));
+    const goalsFile = join(dataDir, goalsName !== '' ? goalsName : String(BILL_CONFIG_DEFAULTS.db.goals));
+    const goalsSource = sourceOf(present, 'db.goals');
+    if (!existsSync(goalsFile)) {
+        items.push({
+            id: 'goals.file', title: '第二份库 goals.json', status: 'green',
+            message: '还没建：' + p(goalsFile) + '（预算功能没在用）。',
+            action: '', source: goalsSource,
+        });
+    }
+    else {
+        let broken = '';
+        try {
+            JSON.parse(readFileSync(goalsFile, 'utf8'));
+        }
+        catch (e) {
+            broken = e instanceof Error ? e.message : String(e);
+        }
+        items.push({
+            id: 'goals.file', title: '第二份库 goals.json',
+            status: broken === '' ? 'green' : 'red',
+            message: broken === '' ? '在，能解析：' + p(goalsFile) + '。' : '在，但坏了：' + p(goalsFile) + '（' + broken + '）。',
+            action: broken === '' ? '' : '预算与储蓄目标读不出来；从备份里拿回一份，或删掉它让预算功能从零开始（本技能不会自动重建）。',
+            source: goalsSource,
+        });
+    }
+    // ⑦ 备份目录（记账特有）：在且能写＝绿；不在＝黄、不可写＝黄——面板**不自动建**，只报。
+    const backupDirConfigured = textOf(readValue(values, 'backup', 'dir'));
+    const backupDir = backupDirConfigured !== '' ? resolve(backupDirConfigured) : join(dataDir, 'backups');
+    const backupVerdict = dirVerdict(backupDir);
+    items.push({
+        id: 'backup.dir', title: '备份目录',
+        status: backupVerdict.exists && backupVerdict.writable ? 'green' : 'yellow',
+        message: !backupVerdict.exists
+            ? '还没建：' + p(backupDir) + '（备份功能没在用；本技能不自动建它）。'
+            : backupVerdict.writable
+                ? '在且能写：' + p(backupDir) + '。'
+                : '在，但写不进去：' + p(backupDir) + '（' + backupVerdict.reason + '）。',
+        action: !backupVerdict.exists
+            ? '要用备份就先把这个目录建出来；也可以用「备份」那条命令第一次跑时让它自己落这里。'
+            : backupVerdict.writable ? '' : '去掉这个目录的只读属性，或把「备份目录」改到别处。',
+        source: sourceOf(present, 'backup.dir'),
+    });
+    return { skill: SKILL, configPath: p(paths.configFile), dataDir: p(dataDir), items };
+}
+//# sourceMappingURL=health.js.map