@yss123/cage-cli 0.1.0 → 0.3.0

package/dist/project-structure.js

@@ -0,0 +1,104 @@
+/**
+ * 模块化应用的目录与公开入口门禁，随 analyze 在领域求值前执行。
+ * 检查 domain、Web 的允许层次、模块入口以及跨模块引用边界，用诊断定位不符合约定的文件。
+ * 只在 structure=modular 时启用，不自动移动代码、不修改路径；文本与 AST 检查不能替代业务分层设计。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import ts from 'typescript';
+import { abs } from './config.js';
+import { listTs } from './static-check.js';
+/** 相对 src 识别归属；检查目录职责，不强迫小模块拆出空的 components/hooks 文件夹。 */
+function area(root, file) {
+    const path = relative(root, file).replace(/\\/g, '/');
+    if (isAbsolute(path) || path.startsWith('../') || path === '..')
+        return;
+    const parts = path.split('/');
+    return {
+        layer: parts.length === 1 ? 'entry' : parts[0],
+        module: parts[0] === 'modules' ? parts[1] : undefined,
+        path,
+    };
+}
+/**
+ * 目录规则只在 structure: modular 的应用启用，不约束框架自身或旧应用。
+ * 使用 TypeScript 的模块解析处理 .js 源码导入、目录 index 和 tsconfig paths，
+ * 这样换用别名也不能绕过模块边界。这里只读源码，绝不加载或执行页面模块。
+ */
+/**
+ * 检查模块布局及跨层导入，发现问题只返回诊断。
+ * @param cfg structure=modular 才启用；源码位置由应用配置决定。
+ * @returns CAGE-STRUCT 诊断；缺少一侧目录时跳过，不移动代码或改写导入。
+ */
+export function checkProjectStructure(cfg) {
+    if (cfg.structure !== 'modular')
+        return [];
+    const findings = [];
+    for (const kind of ['domain', 'web']) {
+        const root = kind === 'domain' ? dirname(abs(cfg, cfg.domain)) : abs(cfg, join(cfg.web, 'src'));
+        if (!existsSync(root))
+            continue;
+        const entry = kind === 'domain' ? resolve(abs(cfg, cfg.domain)) : join(root, 'main.tsx');
+        const layers = kind === 'domain' ? ['modules', 'workflows', 'integrations', 'shared'] : ['app', 'modules', 'shared'];
+        const configFile = ts.findConfigFile(dirname(root), ts.sys.fileExists);
+        const options = configFile
+            ? ts.parseJsonConfigFileContent(ts.readConfigFile(configFile, ts.sys.readFile).config, ts.sys, dirname(configFile)).options
+            : { moduleResolution: ts.ModuleResolutionKind.Bundler };
+        const resolutionCache = ts.createModuleResolutionCache(cfg.root, (name) => name, options);
+        for (const file of listTs(root)) {
+            const from = area(root, file);
+            const at = relative(cfg.root, file).replace(/\\/g, '/');
+            if ((from.layer === 'entry' && resolve(file) !== entry) ||
+                (from.layer !== 'entry' && !layers.includes(from.layer))) {
+                findings.push({
+                    code: 'CAGE-STRUCT-001',
+                    at,
+                    reason: `${kind} 源码没有放入约定模块：${from.path}`,
+                    fix: `src 根目录只保留${kind === 'domain' ? '领域 index.ts' : '浏览器 main.tsx'}；业务按归属放入 ${layers.join(' / ')}，见 docs/ai/project-structure.md`,
+                });
+            }
+            const source = readFileSync(file, 'utf8');
+            // preProcessFile 同时收集 import、export ... from 和字面量动态导入，防止转导出绕过边界。
+            for (const spec of ts.preProcessFile(source, true, true).importedFiles) {
+                const target = ts.resolveModuleName(spec.fileName, file, options, ts.sys, resolutionCache).resolvedModule;
+                const to = target && area(root, target.resolvedFileName);
+                if (!to)
+                    continue;
+                let reason;
+                if (from.layer === 'shared' && to.layer !== 'shared')
+                    reason = 'shared 不能依赖业务模块或应用组合层';
+                else if (from.layer === 'modules') {
+                    if (kind === 'web' &&
+                        to.layer !== 'shared' &&
+                        !(to.layer === 'modules' && from.module === to.module))
+                        reason = '前端模块只依赖本模块与 shared；跨业务页面由 app 组合或通过参数协作';
+                    if (kind === 'domain' && !['modules', 'shared'].includes(to.layer))
+                        reason = '领域模块不能反向依赖 workflows、integrations 或领域总入口';
+                }
+                // 聚合间允许单向 reads/命令依赖，但其他模块必须经过 index，避免内部文件成为事实公共 API。
+                if (!reason &&
+                    to.layer === 'modules' &&
+                    from.module !== to.module &&
+                    to.path !== `modules/${to.module}/index.ts`)
+                    reason = '跨模块导入必须经过目标模块的 index.ts 公开入口';
+                if (!reason &&
+                    kind === 'web' &&
+                    from.layer === 'entry' &&
+                    to.layer !== 'app' &&
+                    to.layer !== 'shared')
+                    reason = '浏览器入口只挂载 app 和共享基础设施，不直接组装业务页面';
+                if (!reason && kind === 'domain' && from.layer === 'integrations' && to.layer === 'workflows')
+                    reason = '连接器不能反向依赖跨模块流程；流程和外部协议分别组合领域声明';
+                if (reason)
+                    findings.push({
+                        code: 'CAGE-STRUCT-002',
+                        at: `${at}:${source.slice(0, spec.pos).split('\n').length}`,
+                        reason: `${reason}（${spec.fileName}）`,
+                        fix: '调整依赖归属；共用纯逻辑下沉到 shared，页面协作由 app 传参，领域交互通过模块公开声明。见 docs/ai/project-structure.md',
+                    });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=project-structure.js.map

package/dist/project-structure.js.map

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

package/dist/registration.d.ts

@@ -0,0 +1,16 @@
+import { type CageConfig } from './config.js';
+import type { DeclSite } from './static-check.js';
+/** Resolve barrel exports with the TypeScript checker, including aliases and tsconfig paths. */
+/**
+ * 按 TypeScript 符号解析入口转导出、别名和路径映射，不执行模块。
+ * @param cfg domain 入口与 tsconfig 所在应用。
+ * @param sites 静态扫描的声明位置。
+ * @returns 每条声明的公开名称和首条转导出链；空列表表示未找到证据。
+ */
+export declare function registrationEvidence(cfg: CageConfig, sites: DeclSite[]): {
+    name: string;
+    file: string;
+    line: number;
+    exportedAs: string[];
+    chain: string[];
+}[];

package/dist/registration.js

@@ -0,0 +1,56 @@
+/**
+ * 通过 TypeScript 导出符号建立静态声明到 domain 公共入口的注册证据。
+ * 解析 re-export 与别名，按声明真实文件和导出名称关联入口公开名称，供 doctor 和缺失导出检查使用。
+ * 不执行领域模块，不把同名但来源不同的符号混为一体；只描述入口导出关系，不证明运行时权限。
+ */
+import { relative, resolve } from 'node:path';
+import ts from 'typescript';
+import { abs } from './config.js';
+/** Resolve barrel exports with the TypeScript checker, including aliases and tsconfig paths. */
+/**
+ * 按 TypeScript 符号解析入口转导出、别名和路径映射，不执行模块。
+ * @param cfg domain 入口与 tsconfig 所在应用。
+ * @param sites 静态扫描的声明位置。
+ * @returns 每条声明的公开名称和首条转导出链；空列表表示未找到证据。
+ */
+export function registrationEvidence(cfg, sites) {
+    const entry = abs(cfg, cfg.domain);
+    const configFile = ts.findConfigFile(cfg.root, ts.sys.fileExists);
+    const parsed = configFile ? ts.parseJsonConfigFileContent(ts.readConfigFile(configFile, ts.sys.readFile).config, ts.sys, resolve(configFile, '..')) : undefined;
+    const options = { ...parsed?.options, module: ts.ModuleKind.NodeNext, moduleResolution: ts.ModuleResolutionKind.NodeNext, noEmit: true };
+    const program = ts.createProgram([entry], options);
+    const checker = program.getTypeChecker();
+    const source = program.getSourceFile(entry);
+    const rootSymbol = source && checker.getSymbolAtLocation(source);
+    const exports = rootSymbol ? checker.getExportsOfModule(rootSymbol) : [];
+    const normalized = (file) => resolve(file).replace(/\\/g, '/').toLowerCase();
+    const exported = new Map();
+    for (const symbol of exports) {
+        const target = symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;
+        for (const declaration of target.declarations ?? []) {
+            const name = declaration.name;
+            if (!name || !ts.isIdentifier(name))
+                continue;
+            const key = `${normalized(declaration.getSourceFile().fileName)}:${name.text}`;
+            exported.set(key, [...(exported.get(key) ?? []), symbol.name]);
+        }
+    }
+    const paths = new Map([[normalized(entry), [cfg.domain]]]);
+    const queue = source ? [source] : [];
+    for (const file of queue) {
+        for (const statement of file.statements) {
+            if (!ts.isExportDeclaration(statement) || !statement.moduleSpecifier || !ts.isStringLiteral(statement.moduleSpecifier))
+                continue;
+            const resolved = ts.resolveModuleName(statement.moduleSpecifier.text, file.fileName, options, ts.sys).resolvedModule;
+            const next = resolved && program.getSourceFile(resolved.resolvedFileName);
+            if (!next || paths.has(normalized(next.fileName)))
+                continue;
+            paths.set(normalized(next.fileName), [...paths.get(normalized(file.fileName)), relative(cfg.root, next.fileName).replace(/\\/g, '/')]);
+            queue.push(next);
+        }
+    }
+    return sites.map(site => ({ name: site.exportName, file: site.file, line: site.line,
+        exportedAs: exported.get(`${normalized(abs(cfg, site.file))}:${site.exportName}`) ?? [],
+        chain: paths.get(normalized(abs(cfg, site.file))) ?? [] }));
+}
+//# sourceMappingURL=registration.js.map

package/dist/registration.js.map

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

package/dist/rules.d.ts

@@ -1,23 +1,75 @@
+/**
+ * 分析阶段的领域图规则集合，检查组织模型、状态可达性、资源配对及事件兼容。
+ * 规则消费本体而不执行命令，生成带错误码的 Finding；提供旧基线时才检查跨版本事件载荷。
+ * 静态资源标签、SQL 文本和状态图只是结构证据，实际事务、权限与 map 分支仍由运行时及业务测试验证。
+ */
 import type { Finding } from './findings.js';
 import type { Ontology } from './ontology.js';
 /** 状态 → 进入时获得的资源：命令迁移到 S、发出事件、事件触发标注了 acquires 的反应 */
+/**
+ * 沿迁移→事件→反应→命令的 acquires 标签归纳持有状态。
+ * @param g 本体图。
+ * @returns 状态、资源名和来源命令；只说明静态配对，不保证 map 每次执行。
+ */
 export declare function statesHoldingResources(g: Ontology): {
     state: string;
     resource: string;
     via: string;
 }[];
 /** CAGE-PAIR-002：进入某状态时获得了资源，从该状态出发的每一条迁移都必须释放它，或进入一个同样持有它的状态 */
+/**
+ * 检查离开持有状态的迁移是否声明释放，或进入同样持有资源的状态。
+ * @param g 当前图。
+ * @returns CAGE-PAIR-002 问题；标签一致不等于真实库存等业务动作已验证。
+ */
 export declare function checkPairing(g: Ontology): Finding[];
 /** CAGE-STATE-010：每个状态都能从初始状态到达；CAGE-STATE-011：非终态必须有出边 */
+/**
+ * 从新建或初始状态计算可达性，并检查非终态出边。
+ * @param g 当前图。
+ * @returns 状态规则问题；默认 active/deleted 生命周期按框架约定特别处理。
+ */
 export declare function checkStates(g: Ontology): Finding[];
 /** CAGE-SENS-001：敏感字段不得原样进入事件载荷 */
+/**
+ * 检查事件同名载荷字段是否保留聚合敏感标记。
+ * @param g 当前图。
+ * @returns 可能进入 outbox 的敏感字段诊断；任意自定义映射仍须业务审查。
+ */
 export declare function checkSensitiveEvents(g: Ontology): Finding[];
 /** CAGE-APPR-010：invokedBy 为 process 的命令必须有审批绑定或反应调用它，否则没有人能调用 */
+/**
+ * 检查仅流程/外部可调用的命令是否有声明调用入口。
+ * @param g 当前图。
+ * @returns 缺流程入口错误或缺外部入口警告；有入口不表示已授权。
+ */
 export declare function checkProcessCommands(g: Ontology): Finding[];
 /** CAGE-QUERY-003：手写 SQL 只能引用 reads 里聚合的安全视图 */
+/**
+ * 从 SQL 文本检查 safe 视图与 reads 对应关系及显式基表引用。
+ * @param g 当前图。
+ * @returns 文本可识别的读取问题；不是完整 SQL 解析器，运行时只读账号仍是边界。
+ */
 export declare function checkQueries(g: Ontology): Finding[];
 /** CAGE-ORG-001：domain 必须包含框架自带的组织模型 */
+/**
+ * 确认 domain 注册了 User、Dept、Role 三个框架组织聚合。
+ * @param g 当前图。
+ * @returns 缺少时单条 CAGE-ORG-001，否则空数组；不初始化组织数据。
+ */
 export declare function checkOrg(g: Ontology): Finding[];
 /** CAGE-EVENT-002：事件载荷只允许向后兼容的变更（只能新增可选字段） */
+/**
+ * 比较同名事件字段的删除、类型改变及新增必填项。
+ * @param base 旧本体，代表可能仍有在途事件的声明。
+ * @param head 新本体。
+ * @returns 可识别的载荷兼容问题，不改写已入 outbox 的事件。
+ */
 export declare function checkEventCompat(base: Ontology, head: Ontology): Finding[];
+/**
+ * 汇总当前结构规则，存在基线时再加入事件兼容检查。
+ * @param g 当前本体。
+ * @param base 可选旧本体。
+ * @returns 按规则顺序拼接的发现，不修改图或尝试自动修复。
+ */
 export declare function runRules(g: Ontology, base?: Ontology | null): Finding[];

package/dist/rules.js

@@ -1,4 +1,11 @@
+import { checkBusinessProcesses } from './process-rules.js';
+/**
+ * 将已有节点源码位置转成诊断定位，缺少文件时返回 undefined，不虚构跨包路径。
+ */
 const at = (n) => (n?.file ? `${n.file}:${n.line ?? 1}` : undefined);
+/**
+ * 为当前本体建立 kind+id 节点索引及按边方向筛选器，避免同名类别混淆；不缓存跨次分析状态。
+ */
 function index(g) {
     const byId = new Map(g.nodes.map((n) => [`${n.kind}:${n.id}`, n]));
     const get = (kind, id) => byId.get(`${kind}:${id}`);
@@ -7,6 +14,11 @@ function index(g) {
     return { get, out, into };
 }
 /** 状态 → 进入时获得的资源：命令迁移到 S、发出事件、事件触发标注了 acquires 的反应 */
+/**
+ * 沿迁移→事件→反应→命令的 acquires 标签归纳持有状态。
+ * @param g 本体图。
+ * @returns 状态、资源名和来源命令；只说明静态配对，不保证 map 每次执行。
+ */
 export function statesHoldingResources(g) {
     const { out } = index(g);
     const held = [];
@@ -22,6 +34,9 @@ export function statesHoldingResources(g) {
     }
     return held;
 }
+/**
+ * 沿给定命令发出的事件查找直接反应 releases 标签；只认声明配对，不执行释放动作或递归证明任意程序。
+ */
 function releasesOnPath(g, via, resource) {
     const { out } = index(g);
     for (const ev of out('emits', via)) {
@@ -33,6 +48,11 @@ function releasesOnPath(g, via, resource) {
     return false;
 }
 /** CAGE-PAIR-002：进入某状态时获得了资源，从该状态出发的每一条迁移都必须释放它，或进入一个同样持有它的状态 */
+/**
+ * 检查离开持有状态的迁移是否声明释放，或进入同样持有资源的状态。
+ * @param g 当前图。
+ * @returns CAGE-PAIR-002 问题；标签一致不等于真实库存等业务动作已验证。
+ */
 export function checkPairing(g) {
     const { get } = index(g);
     const findings = [];
@@ -53,6 +73,11 @@ export function checkPairing(g) {
     return findings;
 }
 /** CAGE-STATE-010：每个状态都能从初始状态到达；CAGE-STATE-011：非终态必须有出边 */
+/**
+ * 从新建或初始状态计算可达性，并检查非终态出边。
+ * @param g 当前图。
+ * @returns 状态规则问题；默认 active/deleted 生命周期按框架约定特别处理。
+ */
 export function checkStates(g) {
     const { get } = index(g);
     const findings = [];
@@ -101,6 +126,11 @@ export function checkStates(g) {
     return findings;
 }
 /** CAGE-SENS-001：敏感字段不得原样进入事件载荷 */
+/**
+ * 检查事件同名载荷字段是否保留聚合敏感标记。
+ * @param g 当前图。
+ * @returns 可能进入 outbox 的敏感字段诊断；任意自定义映射仍须业务审查。
+ */
 export function checkSensitiveEvents(g) {
     const { get, out } = index(g);
     const findings = [];
@@ -127,6 +157,11 @@ export function checkSensitiveEvents(g) {
     return findings;
 }
 /** CAGE-APPR-010：invokedBy 为 process 的命令必须有审批绑定或反应调用它，否则没有人能调用 */
+/**
+ * 检查仅流程/外部可调用的命令是否有声明调用入口。
+ * @param g 当前图。
+ * @returns 缺流程入口错误或缺外部入口警告；有入口不表示已授权。
+ */
 export function checkProcessCommands(g) {
     const { into } = index(g);
     const findings = [];
@@ -154,6 +189,11 @@ export function checkProcessCommands(g) {
     return findings;
 }
 /** CAGE-QUERY-003：手写 SQL 只能引用 reads 里聚合的安全视图 */
+/**
+ * 从 SQL 文本检查 safe 视图与 reads 对应关系及显式基表引用。
+ * @param g 当前图。
+ * @returns 文本可识别的读取问题；不是完整 SQL 解析器，运行时只读账号仍是边界。
+ */
 export function checkQueries(g) {
     const { get } = index(g);
     const findings = [];
@@ -186,6 +226,11 @@ export function checkQueries(g) {
     return findings;
 }
 /** CAGE-ORG-001：domain 必须包含框架自带的组织模型 */
+/**
+ * 确认 domain 注册了 User、Dept、Role 三个框架组织聚合。
+ * @param g 当前图。
+ * @returns 缺少时单条 CAGE-ORG-001，否则空数组；不初始化组织数据。
+ */
 export function checkOrg(g) {
     const has = (id) => g.nodes.some((n) => n.kind === 'aggregate' && n.id === id);
     return has('User') && has('Dept') && has('Role')
@@ -199,6 +244,12 @@ export function checkOrg(g) {
         ];
 }
 /** CAGE-EVENT-002：事件载荷只允许向后兼容的变更（只能新增可选字段） */
+/**
+ * 比较同名事件字段的删除、类型改变及新增必填项。
+ * @param base 旧本体，代表可能仍有在途事件的声明。
+ * @param head 新本体。
+ * @returns 可识别的载荷兼容问题，不改写已入 outbox 的事件。
+ */
 export function checkEventCompat(base, head) {
     const findings = [];
     const b = new Map(base.nodes.filter((n) => n.kind === 'event').map((n) => [n.id, n]));
@@ -237,8 +288,15 @@ export function checkEventCompat(base, head) {
     }
     return findings;
 }
+/**
+ * 汇总当前结构规则，存在基线时再加入事件兼容检查。
+ * @param g 当前本体。
+ * @param base 可选旧本体。
+ * @returns 按规则顺序拼接的发现，不修改图或尝试自动修复。
+ */
 export function runRules(g, base) {
     return [
+        ...checkBusinessProcesses(g),
         ...checkOrg(g),
         ...checkStates(g),
         ...checkPairing(g),

package/dist/rules.js.map

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

package/dist/runtime-diagnostics.d.ts

@@ -0,0 +1,27 @@
+import { type CageConfig } from './config.js';
+/**
+ * 运行证据请求配置；地址不带凭据，Cookie 来自文件，fetch 可注入测试实现。
+ */
+export interface RuntimeOptions {
+    runtimeUrl?: string; /** 可选纯 Cookie 头文件路径，仅请求时读取，不回显到诊断报告。 */
+    cookieFile?: string; /** 可注入网络实现供测试使用；缺省使用平台 fetch。 */
+    fetch?: typeof fetch;
+}
+/**
+ * 请求实际服务的诊断，POST 先取得 CSRF 并合并 Cookie。
+ * @param cfg 解析 Cookie 文件的应用根。
+ * @param options HTTP(S) 地址、Cookie 文件与可注入 fetch。
+ * @param path 必须位于指定服务同一 origin。
+ * @param request query 省略 undefined 值，body 存在时使用 POST。
+ * @returns 时间、HTTP 状态与数据，HTTP 拒绝为 ok=false；网络、超时、JSON 错误抛出。
+ */
+export declare function runtimeDiagnostic(cfg: CageConfig, options: RuntimeOptions, path: string, request?: {
+    query?: Record<string, string | undefined>;
+    body?: unknown;
+}): Promise<{
+    schemaVersion: number;
+    observedAt: string;
+    ok: boolean;
+    status: number;
+    data: any;
+}>;

package/dist/runtime-diagnostics.js

@@ -0,0 +1,60 @@
+/**
+ * CLI 获取运行态诊断的受控 HTTP 客户端，供 doctor、timeline、explain 调用。
+ * 校验同源 HTTP 地址，从单行 Cookie 文件读会话；POST 先取 CSRF 并合并服务端 Cookie，再提交解释请求。
+ * 不把凭据放进返回报告，不跟随重定向；单请求超时为 5 秒，网络/JSON 错误传播，HTTP 拒绝保留状态。
+ */
+// Credentials stay in controlled files. Diagnostic POST explains authorization without executing the command.
+import { readFileSync } from 'node:fs';
+import { abs } from './config.js';
+/**
+ * 请求实际服务的诊断，POST 先取得 CSRF 并合并 Cookie。
+ * @param cfg 解析 Cookie 文件的应用根。
+ * @param options HTTP(S) 地址、Cookie 文件与可注入 fetch。
+ * @param path 必须位于指定服务同一 origin。
+ * @param request query 省略 undefined 值，body 存在时使用 POST。
+ * @returns 时间、HTTP 状态与数据，HTTP 拒绝为 ok=false；网络、超时、JSON 错误抛出。
+ */
+export async function runtimeDiagnostic(cfg, options, path, request = {}) {
+    if (!options.runtimeUrl)
+        throw new Error('[CAGE-DIAG-001] 指定 --runtime-url；会话凭据通过 --cookie-file 传入，不放在命令行或 URL');
+    let base;
+    try {
+        base = new URL(options.runtimeUrl);
+    }
+    catch {
+        throw new Error('[CAGE-DIAG-001] 无法解析运行证据地址；请提供 HTTP(S) 服务地址');
+    }
+    if (!['http:', 'https:'].includes(base.protocol) || base.username || base.password || base.search || base.hash)
+        throw new Error('[CAGE-DIAG-001] 运行证据地址须为无内嵌凭证、查询参数或片段的 HTTP(S) 地址');
+    const target = new URL(path, base);
+    if (target.origin !== base.origin)
+        throw new Error('[CAGE-DIAG-001] 诊断路径必须位于指定运行服务的同一来源');
+    for (const [key, value] of Object.entries(request.query ?? {}))
+        if (value !== undefined)
+            target.searchParams.set(key, value);
+    let cookie = options.cookieFile ? readFileSync(abs(cfg, options.cookieFile), 'utf8').trim() : '';
+    if (/[\r\n]/.test(cookie))
+        throw new Error('[CAGE-DIAG-001] Cookie 文件必须只包含一行 Cookie 请求头值');
+    const fetcher = options.fetch ?? fetch;
+    const headers = cookie ? { cookie } : {};
+    if (request.body !== undefined) {
+        const csrf = await fetcher(new URL('/auth/csrf', target), { headers, signal: AbortSignal.timeout(5000), redirect: 'error' });
+        if (!csrf.ok)
+            return { schemaVersion: 1, observedAt: new Date().toISOString(), ok: false, status: csrf.status, data: { code: 'CSRF_UNAVAILABLE' } };
+        const cookies = new Map(cookie.split(';').filter(Boolean).map(part => { const value = part.trim(); const index = value.indexOf('='); return [value.slice(0, index), value.slice(index + 1)]; }));
+        for (const setCookie of csrf.headers.getSetCookie()) {
+            const pair = setCookie.split(';')[0];
+            const index = pair.indexOf('=');
+            if (index > 0)
+                cookies.set(pair.slice(0, index), pair.slice(index + 1));
+        }
+        headers.cookie = [...cookies].map(([key, value]) => `${key}=${value}`).join('; ');
+        const body = await csrf.json();
+        headers['x-csrf-token'] = body.token;
+        headers['content-type'] = 'application/json';
+    }
+    const response = await fetcher(target, { method: request.body === undefined ? 'GET' : 'POST', headers, body: request.body === undefined ? undefined : JSON.stringify(request.body), signal: AbortSignal.timeout(5000), redirect: 'error' });
+    const data = await response.json();
+    return { schemaVersion: 1, observedAt: new Date().toISOString(), ok: response.ok, status: response.status, data };
+}
+//# sourceMappingURL=runtime-diagnostics.js.map

package/dist/runtime-diagnostics.js.map

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

package/dist/snapshots.d.ts

@@ -0,0 +1,40 @@
+import { type CageConfig } from './config.js';
+import type { Ontology } from './ontology.js';
+/**
+ * 命名基线信封，保存来源时间、版本、指纹和完整本体；不是可反复覆盖的当前缓存。
+ */
+export interface NamedSnapshot {
+    schemaVersion: 1; /** 经过安全校验的快照名，用于文件定位。 */
+    name: string; /** 保存时的 ISO 时间，不会随后续分析刷新。 */
+    createdAt: string; /** 保存该基线的 CLI/框架版本。 */
+    frameworkVersion: string; /** 按图内容计算的摘要，用于核对快照身份。 */
+    graphHash: string; /** 保存时的完整本体，供后续 impact 比较。 */
+    graph: Ontology;
+}
+/**
+ * 限制安全命名并生成固定目录下的快照路径。
+ * @param cfg 应用根。
+ * @param name 字母开头，最多 64 字符，只含字母数字、下划线或连字符。
+ * @returns .cage/snapshots 内路径；非法名称抛 CAGE-IMPACT-002。
+ */
+export declare function snapshotPath(cfg: CageConfig, name: string): string;
+/**
+ * 读取命名快照，不重新分析领域。
+ * @param cfg 应用配置。
+ * @param name 快照名，仍会验证安全命名。
+ * @returns JSON 信封；文件缺失或损坏时抛出，不自动创建。
+ */
+export declare function readSnapshot(cfg: CageConfig, name: string): NamedSnapshot;
+/**
+ * 按文件名稳定列出基线。
+ * @param cfg 应用根配置。
+ * @returns 快照数组，目录不存在时为空；损坏文件的错误不吞掉。
+ */
+export declare function listSnapshots(cfg: CageConfig): NamedSnapshot[];
+/**
+ * 重新抽取通过规则的声明并独占保存基线。
+ * @param cfg 当前应用配置。
+ * @param name 尚未使用的名称。
+ * @returns 已保存信封；声明错误、同名或 IO 失败抛出，wx 防止并发覆盖。
+ */
+export declare function saveSnapshot(cfg: CageConfig, name: string): Promise<NamedSnapshot>;