skill-home 0.3.52 → 0.3.53

package/dist/fetch/paths.js

@@ -0,0 +1,100 @@
+// 库、产物目录、主密钥文件与备份的**落点解析**：配置文件的唯一真相（#695；口径见「配置的存与生效口径裁定」#675）。
+// 改造前这里读 `SKILLS_DB_PATH`（无默认值、缺失即抛），并按 `HOME_FORCE_PROD=1` 守「非 tmp 不许写库」；
+// #695 按用户裁决把两个环境变量**一并删掉**：路径改从 `~/.ilife/home.yaml` 取，写库边界改由
+// 家目录注入＋生产守卫（`base-link-core` 的 `CONFIG_TEST_ISOLATION_MISSING`，要落到真实家目录即抛）承担——
+// 把「忘了配」从静默写真实库变成响亮失败。
+// 老家 home_manager/db.py Q6 fallback 链（D:/.db 等）TS 线仍有意不继承：拒绝隐式写生产。
+//
+// **#794 起本件是全部落点算式的唯一定义地**（设置页只读行显示的那一组绝对路径由这里算，
+// `src/health.ts` 的体检报告与 `src/help/manifest.ts` 的产物目录名都调这里，各处不许走散；
+// 照记账 #749 样板）：算式一律是**纯函数**（只拼路径、不读配置、不碰盘），读配置只在下面几个
+// `resolve*` 薄壳里发生。
+import { mkdirSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { HOME_CONFIG_DEFAULTS, loadHomeConfig } from '../config.js';
+/** 库文件名的默认值：＝改造前的代码常量 `DB_FILENAME`（配置项 `db.name` 空串即用它）。 */
+export const DEFAULT_DB_FILENAME = 'home.db';
+/** 备份目录名的默认值：＝改造前的代码常量 `BACKUP_DIR_NAME`（配置项 `backup.dir` 空串即用它）。 */
+export const DEFAULT_BACKUP_DIR_NAME = 'backups';
+/** 主密钥文件名的默认值：新键 `key.file` 空串即用它（#793 定稿）。 */
+export const DEFAULT_MASTER_KEY_FILENAME = '.master.key';
+/** 库文件名：配置 `db.name`，空串＝默认（`home.db`）。 */
+export function dbFilename() {
+    const name = loadHomeConfig().values.db.name;
+    return name === '' ? DEFAULT_DB_FILENAME : name;
+}
+/** 库目录算式：`db.dir` 非空即用它，空串＝默认数据目录（默认 `~/.ilife/data/`）。
+ *  这是「面板上唯一可改的落点」，写盘时那一格写成算出来的绝对路径（见 `src/config.ts`）。 */
+export function dbDirOf(dataDir, configured) {
+    return configured !== '' ? configured : dataDir;
+}
+/** 库目录：配置 `db.dir` 的解析结果。 */
+export function resolveDbDir() {
+    const cfg = loadHomeConfig();
+    return dbDirOf(cfg.dataDir, cfg.values.db.dir);
+}
+/** 库文件算式（目录 ＋ 文件名）。 */
+export function dbFileOf(dbDir, name) {
+    return join(dbDir, name !== '' ? name : DEFAULT_DB_FILENAME);
+}
+/** 库文件完整路径（目录不存在即建，`mkdir -p` 语义）。 */
+export function resolveDbPath(filename = dbFilename(), dir = resolveDbDir()) {
+    mkdirSync(dir, { recursive: true });
+    return dbFileOf(dir, filename);
+}
+/** 目录名配置值 → 目录段：值里带分隔符时按段拼（`a/b` 是两层子目录，不是两处落点）；
+ *  空段丢弃——Windows 用户手写路径时两种分隔符都会用。 */
+function dirSegments(value) {
+    return value.split(/[\\/]+/).filter((seg) => seg !== '' && seg !== '.');
+}
+/** 产物目录算式：`<库目录>/<html.dir 值>`（空串＝默认子目录名）——设置页那一行与体检都调它。 */
+export function htmlDirOf(dbDir, configured) {
+    const name = configured !== '' ? configured : HOME_CONFIG_DEFAULTS.html.dir;
+    return join(dbDir, ...dirSegments(name));
+}
+/** 产物目录：配置 `html.dir` 的解析结果（算式见 `htmlDirOf`）。只算路径，落盘归交付那条链。 */
+export function resolveHtmlDir(dbDir = resolveDbDir()) {
+    return htmlDirOf(dbDir, loadHomeConfig().values.html.dir);
+}
+/** 主密钥文件算式：值绝对 ⇒ 用它；相对 ⇒ `<数据目录>/<值>`；空串 ⇒ `<数据目录>/.master.key`
+ *  （#793 定稿：与 `backup.dir` 同一条「绝对优先」规则）。文件名与绝对路径两种取值都要能解。 */
+export function keyFileOf(dataDir, configured) {
+    if (configured === '')
+        return join(dataDir, DEFAULT_MASTER_KEY_FILENAME);
+    return isAbsolute(configured) ? configured : join(dataDir, configured);
+}
+/** 主密钥文件：配置 `key.file` 的解析结果（算式见 `keyFileOf`）。只算路径，不建文件、
+ *  不生成口令——密钥是人的口令，文件不在时报错＋人话指引（见 `src/fetch/masterKey.ts`）。 */
+export function resolveKeyFile(dataDir) {
+    const cfg = loadHomeConfig();
+    return keyFileOf(dataDir ?? cfg.dataDir, cfg.values.key.file);
+}
+/** 备份目录算式：值绝对 ⇒ 用它；相对 ⇒ `<库目录>/<值>`；空串 ⇒ `<库目录>/backups`
+ *  （#793 定稿口径，与记账同名键统一——相对值不再按当刻工作目录解：技能是被宿主 spawn 的，
+ *  宿主不传 `cwd`，相对值于是跟着「宿主从哪儿启动」变）。
+ *
+ * 为什么相对值不再按**当刻工作目录**解：同一个相对值换个启动位置就是另一个目录，
+ * 而面板只读显示的是技能回执算出来的绝对路径，两边会走散。 */
+export function backupDirOf(dbDir, configured) {
+    if (configured === '')
+        return join(dbDir, DEFAULT_BACKUP_DIR_NAME);
+    return isAbsolute(configured) ? configured : join(dbDir, configured);
+}
+/** 备份目录：配置 `backup.dir` 的解析结果（算式见 `backupDirOf`）。
+ *  「不自动建」是体检那条判据的口径——本函数只算路径，建目录归调用方。 */
+export function resolveBackupDir(dbDir = resolveDbDir()) {
+    return backupDirOf(dbDir, loadHomeConfig().values.backup.dir);
+}
+/** 算那一组解析后的绝对路径。**只算路径、不建目录、不写盘**（设置页与体检都能随时调）。 */
+export function resolvedHomePaths() {
+    const cfg = loadHomeConfig();
+    const dbDir = dbDirOf(cfg.dataDir, cfg.values.db.dir);
+    return {
+        dbDir,
+        dbFile: dbFileOf(dbDir, cfg.values.db.name),
+        htmlDir: htmlDirOf(dbDir, cfg.values.html.dir),
+        backupDir: backupDirOf(dbDir, cfg.values.backup.dir),
+        keyFile: keyFileOf(cfg.dataDir, cfg.values.key.file),
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/fetch/paths.js.map

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

package/dist/health.d.ts

@@ -0,0 +1,50 @@
+/** 报告里的三档判据（与面板侧镜像同值）。 */
+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 HomeHealthReport {
+    readonly skill: string;
+    readonly configPath: string;
+    readonly dataDir: string;
+    readonly items: readonly HealthItem[];
+}
+/** 库表数门槛：`src/fetch/db.ts` 的建表语句里那 16 张表齐了才算正常（少了报黄：还能用，但缺功能的表要重建）。 */
+export declare const DB_TABLE_THRESHOLD: 16;
+/** 只读解析结果：文件不在／读得出取值与「哪些键真在文件里」／读不出来（报文带行号与文件名）。 */
+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 readHomeConfigReadOnly(): ConfigRead;
+/** 跑一次体检，返回整份报告。**只读**：任何一处都不落盘（只有写探针那一个文件，且当场删掉）。 */
+/** 数据目录那一行的告警事实（#915 第二步）：**真用不了**才给一格，能用就缺席（没问题就不显示）。
+ *
+ *  只算「数据目录」这一格——**不跑整份体检**（那份报告要碰库表数、主密钥、包内种子那些与读配置无关的链，
+ *  读一次配置不该被它们拖累）。判定与文案逐字复用体检②那条（`dirVerdict` ＋ 同一句「不在／在，但写不进去」），
+ *  避免同一件事在两处各写一套措辞。面板只画 `message`，不比较、不合成。 */
+export declare function homeDataDirAlert(values: unknown, defaultDataDir: string): Record<string, {
+    readonly code: string;
+    readonly message: string;
+}> | undefined;
+export declare function buildHomeHealthReport(): HomeHealthReport;
+//# 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":"AA+BA,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,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,EAAG,EAAW,CAAC;AAiB9C,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;AA+QD,sDAAsD;AACtD;;;;8CAI8C;AAC9C,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAYjF;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,CA2KxD"}