@sema-agent/server 7.151.0 → 7.152.0

package/dist/config-d-migration.d.ts

@@ -1,37 +0,0 @@
-import { type ConfigDirectoryDocument, type ConfigDirectoryMigration } from "@sema-agent/settings-schema/node";
-/** 本地读腿读的那几份(便携域 + 退役域 + remote-exec 文档)= 迁移的覆盖面 = 目录信任判官(`config-dir-trust.ts`)判的文档名单。取契约的表与文档名,不手抄。 */
-export declare const LOCAL_READER_DOCUMENTS: readonly ConfigDirectoryDocument[];
-/** 一次起服迁移的结果:契约的结果闭集,外加本仓入口的两形(目录不在 ⇒ 不调;调用抛 ⇒ 失败)。纯数据。 */
-export type ConfigDirMigration = {
-    readonly kind: "no-config-dir";
-    readonly dir: string;
-} | {
-    readonly kind: "threw";
-    readonly dir: string;
-    readonly reason: string;
-} | (ConfigDirectoryMigration & {
-    readonly dir: string;
-});
-/**
- * 对 `<root>/config.d` 的读回面跑一次契约的目录迁移(见文件头)。`root` = 本地配置根(`FileConfigStore` 吃的同一个)。
- * 不抛:每一形都是一个结果,调用方 {@link logConfigDirMigration}。
- */
-export declare function migrateLocalConfigDirectory(root: string): Promise<ConfigDirMigration>;
-/** 迁移结果的日志口(logger 的子集)。 */
-export interface ConfigDirMigrationLog {
-    info(msg: string, meta?: Record<string, unknown>): void;
-    warn(msg: string, meta?: Record<string, unknown>): void;
-}
-/**
- * 一次起服迁移的**唯一**说法(两个入口同调),对契约结果穷举:
- *  · `applied` ⇒ info `config_dir_migrated`(收据:迁移 id / 文档 / 坐标 / 处置,不带值;写回 / 删除的文件名);
- *  · `noop` / `no-documents` / 目录不在 ⇒ 不出声(没有东西可迁);
- *  · `refused` ⇒ warn `config_dir_migration_refused`(一字未写;逐条点名迁移 id、坐标与契约的拒句 —— 读侧随后对这些旧形照旧响亮拒);
- *  · `unreadable` / 调用抛 ⇒ warn `config_dir_migration_failed`(一字未写或写到一半;原因 —— 坏文件的句子与读腿同一只判官)。
- *    契约的 `unreadable` 不带成因,本仓分不出两类:① 读腿同一拍也会拒的(坏文本:空 / 坏 JSON / 不是对象 / 嵌得过深〔根下 199 层〕,同一只文本判官;悬空的文档符号链接:契约 17.0.0 起读腿同样拒、同一句悬空句,此前读腿读成缺席)
- *    —— 读腿随后另有一行 `config_candidate_rejected`(`remote-exec.json` 则是执行车道合成步先拒启,读腿到不了),同一件事两行;
- *    ② 只有迁移读不了的(目录列不了:`config.d` 有 x 无 r —— 读腿按名逐份打开,读得进,这一行是唯一的信号)。静默 ① 就会连 ② 一起吞,所以两类同一行;契约交出成因后 ① 改为只留读腿那一行(待契约)。
- *  · `pending` 只在契约的 `check: true` 下出现,本仓从不传 ⇒ 撞上即是接线错,响亮抛。
- */
-export declare function logConfigDirMigration(log: ConfigDirMigrationLog, m: ConfigDirMigration): void;
-//# sourceMappingURL=config-d-migration.d.ts.map

package/dist/config-d-migration.js

@@ -1,60 +0,0 @@
-import { stat } from "node:fs/promises";
-import { join } from "node:path";
-import { RETIRED_DOMAINS, formatConfigPath, isRetiredDomainName } from "@sema-agent/settings-schema";
-import { PORTABLE_DOMAINS, migrateConfigDirectory, nodeConfigDirectoryIo } from "@sema-agent/settings-schema/node";
-import { REMOTE_EXEC_DOCUMENT } from "@sema-agent/settings-schema/remote-exec";
-export const LOCAL_READER_DOCUMENTS = [...PORTABLE_DOMAINS, ...Object.keys(RETIRED_DOMAINS).filter(isRetiredDomainName), REMOTE_EXEC_DOCUMENT];
-const errnoOf = (err) => (err instanceof Error && "code" in err && typeof err.code === "string" ? err.code : undefined);
-export async function migrateLocalConfigDirectory(root) {
-    const dir = join(root, "config.d");
-    try {
-        if (!(await stat(dir)).isDirectory())
-            return { kind: "no-config-dir", dir };
-    }
-    catch (err) {
-        if (errnoOf(err) === "ENOENT")
-            return { kind: "no-config-dir", dir };
-    }
-    try {
-        return { ...(await migrateConfigDirectory(dir, { documents: LOCAL_READER_DOCUMENTS, io: nodeConfigDirectoryIo })), dir };
-    }
-    catch (err) {
-        return { kind: "threw", dir, reason: err instanceof Error ? err.message : String(err) };
-    }
-}
-export function logConfigDirMigration(log, m) {
-    switch (m.kind) {
-        case "no-config-dir":
-        case "no-documents":
-        case "noop":
-            return;
-        case "applied":
-            log.info("config_dir_migrated", {
-                dir: m.dir,
-                receipts: m.applied.map((r) => ({ migration: r.migration, document: r.document, path: formatConfigPath(r.path), appliedAs: r.appliedAs })),
-                written: m.written,
-                removed: m.removed,
-                note: "settings-schema one-time migrations rewrote the documents the local reader reads, once (idempotent: the next run changes nothing); files outside the reader's coverage were not touched",
-            });
-            return;
-        case "refused":
-            log.warn("config_dir_migration_refused", {
-                dir: m.dir,
-                refusals: m.refused,
-                why: m.why,
-                note: "nothing was written — the named coordinates cannot be migrated automatically; the reader refuses those old forms (each refusal names its migration id) until they are fixed by hand",
-            });
-            return;
-        case "unreadable":
-        case "threw":
-            log.warn("config_dir_migration_failed", { dir: m.dir, reason: m.reason, note: "the one-time migration did not complete — the reader judges the files as they are (old forms are refused loudly)" });
-            return;
-        case "pending":
-            throw new Error(`config.d migration: the contract answered "pending" (check-only) but this engine never asks for a check-only run — wiring error at ${m.dir}`);
-        default: {
-            const unhandled = m;
-            throw new Error(`config.d migration: unknown result ${JSON.stringify(unhandled)}`);
-        }
-    }
-}
-//# sourceMappingURL=config-d-migration.js.map