@yss123/cage-cli 0.2.0 → 0.3.1

package/dist/graph-business.js

@@ -0,0 +1,404 @@
+/**
+ * 把语义图整理为业务板块、显式流程、对象生命周期和操作触发树。
+ * 供图谱浏览器使用，优先采用 businessProcess 声明，旧项目按模块或聚合归属组织。
+ * 所有投影只辅助阅读，不调度操作；状态迁移、读取依赖、声明调用能力与真实自动触发分别处理。
+ */
+import { nodeLabel } from './graph-model.js';
+/**
+ * 识别 User、Role、Dept 及其成员的系统组织前缀，供默认隐藏开关使用；不表示权限检查。
+ */
+export const isSystemObject = (node) => /^(User|Role|Dept)(\.|$)/.test(node.id);
+/**
+ * 只对有明确标识归属的节点寻找聚合，取最长匹配前缀。
+ * @param model 语义图。
+ * @param node 待定位节点。
+ * @returns 聚合或 undefined；事件/查询等任意名称不会按前缀误归属。
+ */
+export function businessOwner(model, node) {
+    if (node.kind === 'aggregate')
+        return node;
+    // 查询、事件等可任意命名，不能凭同名前缀把它们归入某个对象。
+    if (!['command', 'state', 'field', 'capability', 'entry'].includes(node.kind))
+        return undefined;
+    return model.nodes
+        .filter((n) => n.kind === 'aggregate' && node.id.startsWith(`${n.id}.`))
+        .sort((a, b) => b.id.length - a.id.length)[0];
+}
+/** 板块只组织展示，不新增本体关系。模块目录提供归属，旧的平铺项目按对象分组；
+ * 查询与任务允许出现在多个相关板块，但不会沿读取关系扩散出一整张业务图。 */
+/**
+ * 按显式业务区、模块路径或聚合整理板块，并附声明相关查询与任务。
+ * @param model 语义图，不被修改。
+ * @param labels 显示覆盖。
+ * @param showSystem 是否保留系统组织对象。
+ * @returns 稳定排序的板块；同一操作可出现在多个相关板块，不表示重复执行。
+ */
+export function businessBlocks(model, labels = {}, showSystem = false) {
+    const blocks = new Map();
+    const owners = new Map();
+    const commands = model.nodes.filter((n) => n.kind === 'command');
+    const count = (n) => commands.filter((c) => businessOwner(model, c)?.key === n.key).length;
+    const objects = model.nodes
+        .filter((n) => n.kind === 'aggregate')
+        .sort((a, b) => count(b) - count(a) || a.id.localeCompare(b.id));
+    const processes = model.nodes.filter((n) => n.kind === 'process');
+    for (const node of objects) {
+        const system = isSystemObject(node);
+        if (system && !showSystem)
+            continue;
+        const module = node.file?.replaceAll('\\', '/').match(/(?:^|\/)modules\/([^/]+)\//)?.[1];
+        const process = processes.find((p) => p.attrs.subject === node.id);
+        const area = process?.attrs.area;
+        const id = system
+            ? 'system:organization'
+            : area
+                ? `module:${area.id}`
+                : module
+                    ? `module:${module}`
+                    : node.key;
+        let block = blocks.get(id);
+        if (!block) {
+            block = {
+                id,
+                title: system ? '组织与权限' : (area?.title ?? businessLabel(node, labels)),
+                description: area?.description,
+                objects: [],
+                flows: [],
+                processes: [],
+                system,
+            };
+            blocks.set(id, block);
+        }
+        block.objects.push(node);
+        owners.set(node.id, block);
+    }
+    for (const block of blocks.values()) {
+        block.title = labels[block.id] || block.title;
+    }
+    for (const process of processes) {
+        const subject = model.nodes.find((n) => n.kind === 'aggregate' && n.id === process.attrs.subject);
+        if (subject && isSystemObject(subject) && !showSystem)
+            continue;
+        const area = process.attrs.area;
+        const id = `module:${area.id}`;
+        let block = blocks.get(id);
+        if (!block) {
+            block = {
+                id,
+                title: labels[id] || area.title,
+                description: area.description,
+                objects: [],
+                flows: [],
+                processes: [],
+                system: false,
+            };
+            blocks.set(id, block);
+        }
+        block.title = labels[id] || area.title;
+        block.description = area.description;
+        block.processes.push(process);
+    }
+    const byKey = new Map(model.nodes.map((n) => [n.key, n]));
+    for (const node of model.nodes) {
+        if (!['command', 'query', 'job', 'inbound'].includes(node.kind))
+            continue;
+        const related = new Set();
+        const addOwner = (target) => {
+            const owner = target && businessOwner(model, target);
+            const block = owner && owners.get(owner.id);
+            if (block)
+                related.add(block);
+        };
+        addOwner(node);
+        for (const edge of model.edges) {
+            if (edge.from !== node.key || !['queries', 'calls', 'targets'].includes(edge.kind))
+                continue;
+            addOwner(byKey.get(edge.to));
+        }
+        // 组织模型在开关关闭时不借“其他业务”重新出现。
+        if (!related.size && businessOwner(model, node) && !showSystem)
+            continue;
+        if (!related.size) {
+            const belongsToHiddenSystem = model.edges.some((e) => e.from === node.key &&
+                ['queries', 'calls', 'targets'].includes(e.kind) &&
+                isSystemObject(byKey.get(e.to)));
+            if (belongsToHiddenSystem && !showSystem)
+                continue;
+            const id = 'other:collaboration';
+            if (!blocks.has(id))
+                blocks.set(id, {
+                    id,
+                    title: '其他业务协作',
+                    objects: [],
+                    flows: [],
+                    processes: [],
+                    system: false,
+                });
+            related.add(blocks.get(id));
+        }
+        for (const block of related)
+            block.flows.push(node);
+    }
+    for (const block of blocks.values())
+        block.flows.sort((a, b) => {
+            const rank = (n) => n.kind !== 'command'
+                ? 3
+                : n.attrs.from === 'new'
+                    ? 0
+                    : n.attrs.invokedBy?.includes('user')
+                        ? 1
+                        : 2;
+            return (rank(a) - rank(b) ||
+                (a.file ?? '').localeCompare(b.file ?? '') ||
+                (a.line ?? 0) - (b.line ?? 0) ||
+                a.id.localeCompare(b.id));
+        });
+    return [...blocks.values()].sort((a, b) => Number(a.system) - Number(b.system) || b.flows.length - a.flows.length || a.id.localeCompare(b.id));
+}
+/** 业务页面缺少文案时明确提示补充，不用程序标识替代业务名称。完整本体仍保留标识。 */
+/**
+ * 优先使用中文覆盖与声明文案，缺失时明确显示待命名。
+ * @param node 展示节点。
+ * @param labels 中文标签映射。
+ * @returns 阅读标题，不改实际标识。
+ */
+export function businessLabel(node, labels = {}) {
+    if (node.kind === 'entry')
+        return '新建业务';
+    if (labels[node.key] || node.attrs.title || node.attrs.description)
+        return nodeLabel(node, labels);
+    return `待命名${{ aggregate: '业务对象', command: '操作', state: '状态', process: '流程', stage: '阶段', event: '业务结果', reaction: '自动处理', approval: '审批', inbound: '外部通知', outbound: '外部同步', query: '查询', job: '定时处理' }[node.kind] ?? '声明'}`;
+}
+/**
+ * 优先返回板块显式流程并保持源码顺序；没有流程规格时返回有状态迁移的对象供生命周期阅读。
+ */
+export const businessJourneys = (block, model) => block.processes.length
+    ? [...block.processes].sort((a, b) => (a.file ?? '').localeCompare(b.file ?? '') ||
+        (a.line ?? 0) - (b.line ?? 0) ||
+        a.id.localeCompare(b.id))
+    : block.objects.filter((object) => model.edges.some((e) => e.kind === 'transition' && e.to.startsWith(`state:${object.id}.`)));
+/** 显式流程的阶段是唯一身份。汇合与循环回连已有阶段，避免复制成多份业务。 */
+/**
+ * 把显式流程阶段组织成阅读树，汇合/循环只保留回连标记。
+ * @param model 语义图。
+ * @param process 已声明业务流程。
+ * @param options branches 控制次要分支，related 控制对象关联。
+ * @returns 流程入口树；关联不充当下一步，遍历不执行命令。
+ */
+export function traceBusinessProcess(model, process, options) {
+    const nodes = new Map(model.nodes.map((n) => [n.key, n]));
+    const seen = new Set();
+    const walk = (key, incoming) => {
+        const node = nodes.get(key);
+        const repeated = seen.has(key);
+        const mode = incoming?.mode;
+        const step = {
+            id: repeated ? `${incoming.from}>${key}` : key,
+            node,
+            via: model.edges.filter((e) => e.from === key && e.kind === 'implements').map((e) => nodes.get(e.to)),
+            label: incoming
+                ? `${{ manual: '人工', automatic: '自动', wait: '等待' }[mode]} · ${incoming.label}`
+                : '流程起点',
+            note: mode === 'automatic'
+                ? '由实际声明触发；执行条件、事务与映射以实现为准。'
+                : mode === 'wait'
+                    ? '等待外部通知或定时处理，流程图本身不发起调用。'
+                    : '由参与人发起，仍需通过权限和业务规则检查。',
+            mode,
+            branch: incoming?.branch,
+            children: [],
+            repeated,
+            boundary: false,
+        };
+        if (repeated)
+            return step;
+        seen.add(key);
+        step.children = model.edges
+            .filter((e) => e.kind === 'follows' && e.from === key && (options.branches || !e.branch))
+            .map((e) => walk(e.to, e));
+        if (options.related)
+            for (const relation of model.edges.filter((e) => e.kind === 'relates' && e.from === key)) {
+                const object = nodes.get(relation.to);
+                step.children.push({
+                    id: `${key}>${object.key}`,
+                    node: object,
+                    via: relation.via && nodes.has(relation.via) ? [nodes.get(relation.via)] : [],
+                    label: relation.label ?? '关联对象',
+                    note: '业务对象关联；不表示下一步操作或额外触发。',
+                    mode: 'association',
+                    children: [],
+                    repeated: false,
+                    boundary: false,
+                });
+            }
+        return step;
+    };
+    return walk(`stage:${process.attrs.entry}`);
+}
+/** 旧项目按实际状态迁移阅读；只表达允许的操作，绝不推断成自动调用链。 */
+/**
+ * 对没有业务流程规格的对象沿允许状态迁移生成阅读树。
+ * @param model 语义图。
+ * @param object 目标聚合。
+ * @param labels 中文文案。
+ * @returns 从新建入口或初始状态开始的树；只表示允许操作，不推断自动触发。
+ */
+export function traceBusinessLifecycle(model, object, labels) {
+    const nodes = new Map(model.nodes.map((n) => [n.key, n]));
+    const seen = new Set();
+    const entry = nodes.get(`entry:${object.id}.[new]`) ??
+        model.nodes.find((n) => n.kind === 'state' && n.id.startsWith(`${object.id}.`) && n.attrs.initial);
+    const walk = (node, via = [], parent = '') => {
+        const repeated = seen.has(node.key);
+        const action = via[0];
+        const actor = (action?.attrs.invokedBy ?? []);
+        const label = action
+            ? `${actor.includes('user') ? '人工' : actor.includes('external') ? '外部通知' : actor.includes('process') ? '审批结论' : '业务操作'} · ${businessLabel(action, labels)}`
+            : '生命周期起点';
+        const step = {
+            id: repeated ? `${parent}>${node.key}` : node.key,
+            node,
+            via,
+            label,
+            note: '根据已声明状态迁移整理，表示允许执行的操作；条件与触发方式请查看实现。',
+            mode: 'lifecycle',
+            repeated,
+            boundary: false,
+            children: [],
+        };
+        if (repeated)
+            return step;
+        seen.add(node.key);
+        step.children = model.edges
+            .filter((e) => e.kind === 'transition' && e.from === node.key)
+            .map((e) => walk(nodes.get(e.to), [nodes.get(`command:${e.via}`)], node.key));
+        return step;
+    };
+    return walk(entry);
+}
+/** 只沿会驱动后续操作的声明追踪。状态可达性和 reads 均不当作调用顺序。
+ * 事件与反应收进步骤的实现依据，但保留事务、条件映射、取消及审批结论语义。 */
+/**
+ * 沿事件、反应、审批结论及外部回写构建有界操作树。
+ * @param model 语义图。
+ * @param root 完整节点 key。
+ * @param maxDepth 默认 6，另以累计步骤计数限制膨胀。
+ * @returns 入口树或 undefined；取消审批停止展开，循环/上限通过 repeated/boundary 显示。
+ */
+export function traceBusinessFlow(model, root, maxDepth = 6) {
+    const nodes = new Map(model.nodes.map((n) => [n.key, n]));
+    const outgoing = (key) => model.edges.filter((e) => e.from === key && !e.derived);
+    const next = (node) => {
+        const result = [];
+        const add = (key, via, label, note = '') => {
+            const target = nodes.get(key);
+            if (target)
+                result.push({ node: target, via, label, note });
+        };
+        for (const edge of outgoing(node.key)) {
+            const target = nodes.get(edge.to);
+            if (node.kind === 'command' && edge.kind === 'emits') {
+                const effects = outgoing(target.key).filter((e) => ['triggers', 'cancels'].includes(e.kind));
+                if (!effects.length)
+                    add(target.key, [], '成功后产生的结果');
+                for (const effect of effects) {
+                    const handler = nodes.get(effect.to);
+                    if (effect.kind === 'cancels') {
+                        add(handler.key, [target], '取消审批', '该分支终止审批，不继续执行审批结论。');
+                    }
+                    else if (handler.kind === 'reaction') {
+                        for (const call of outgoing(handler.key).filter((e) => e.kind === 'targets')) {
+                            add(call.to, [target, handler], handler.attrs.tx === 'same' ? '成功后 · 同一事务' : '成功后 · 异步处理', '是否调用及输入由映射函数决定；返回 null 时跳过。');
+                        }
+                    }
+                    else {
+                        add(handler.key, [target], handler.kind === 'approval' ? '成功后 · 异步启动审批' : '成功后 · 异步外部同步');
+                    }
+                }
+            }
+            else if (node.kind === 'approval' && edge.kind === 'binds' && target.kind === 'command') {
+                add(target.key, [], node.attrs.onApproved === target.id ? '审批通过时' : '审批驳回时', '审批结论仍须通过目标业务操作的权限与规则检查。');
+            }
+            else if (node.kind === 'outbound' && edge.kind === 'targets' && target.kind === 'command') {
+                add(target.key, [], '外部调用成功后回写');
+            }
+            else if (node.kind === 'inbound' && edge.kind === 'targets' && target.kind === 'command') {
+                add(target.key, [], '验签与映射后');
+            }
+            else if (node.kind === 'job' && edge.kind === 'calls') {
+                add(target.key, [], '任务声明可调用', '实际调用条件和次数由任务实现决定。');
+            }
+            else if (node.kind === 'reaction' && edge.kind === 'targets') {
+                add(target.key, [], node.attrs.tx === 'same' ? '同一事务' : '异步处理', '是否调用由映射函数决定。');
+            }
+            else if (node.kind === 'event' && edge.kind === 'triggers') {
+                add(target.key, [], '结果触发的后续处理');
+            }
+        }
+        return result;
+    };
+    let count = 0;
+    const walk = (item, path, seen, depth) => {
+        const nextPath = [...path, ...item.via.map((n) => n.key), item.node.key];
+        const id = nextPath.join('>');
+        const repeated = seen.has(item.node.key);
+        // 取消审批是终止动作，不能再展示“通过/驳回”的后续调用。
+        const children = item.label === '取消审批' ? [] : next(item.node);
+        const boundary = !repeated && children.length > 0 && (depth >= maxDepth || count >= 60);
+        count++;
+        const step = { ...item, id, children: [], repeated, boundary };
+        if (!repeated && !boundary) {
+            const visited = new Set([...seen, item.node.key]);
+            step.children = children.map((child) => walk(child, nextPath, visited, depth + 1));
+        }
+        return step;
+    };
+    const node = nodes.get(root);
+    return node && walk({ node, via: [], label: '业务入口', note: '' }, [], new Set(), 0);
+}
+/**
+ * 按先序把已经有界的阅读树展开成列表。
+ * @param root 由追踪函数生成的根。
+ * @returns 包含重复引用占位节点的数组，不去重、不执行关系。
+ */
+export function flattenBusinessSteps(root) {
+    return [root, ...root.children.flatMap(flattenBusinessSteps)];
+}
+/**
+ * 把命令 from/to 转成中文状态摘要。
+ * @param node 非命令返回空字符串。
+ * @param labels 状态名称覆盖。
+ * @returns 允许起始状态与目标，to=null 描述保持当前状态。
+ */
+export function businessStateSummary(node, labels) {
+    if (node.kind !== 'command')
+        return '';
+    const owner = node.id.slice(0, node.id.lastIndexOf('.'));
+    const name = (s) => (s === 'new' ? '新建' : (labels[`state:${owner}.${s}`] ?? '待命名状态'));
+    const from = (Array.isArray(node.attrs.from) ? node.attrs.from : [node.attrs.from]);
+    return `${from.filter(Boolean).map(name).join(' / ')} → ${node.attrs.to == null ? '保持当前状态' : name(String(node.attrs.to))}`;
+}
+/**
+ * 把已知约束名翻译为业务提示，并解析额度与职责分离字段。
+ * @param name 内核约束标识。
+ * @param owner 所属聚合 ID。
+ * @param labels 字段中文标签。
+ * @returns 展示文案，未知约束保留原名，不求值或授予能力。
+ */
+export function businessConstraintLabel(name, owner, labels) {
+    const field = (id) => labels[`field:${owner}.${id}`] ?? id;
+    const ceiling = /^ceiling\((.+)\)$/.exec(name);
+    if (ceiling)
+        return `${field(ceiling[1])}不超过审批额度`;
+    const sod = /^sod\.notSameAs\((.+)\)$/.exec(name);
+    if (sod)
+        return `审批人与${field(sod[1])}不同`;
+    return ({
+        stepUp: '需要二次认证',
+        knownCapability: '能力点必须已声明',
+        noEscalation: '不能授予超出自身的能力',
+        noWiderScope: '不能授予超出自身的数据范围',
+        noEscalationViaRoles: '不能通过分配角色提权',
+    }[name] ?? name);
+}
+//# sourceMappingURL=graph-business.js.map

package/dist/graph-business.js.map

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

package/dist/graph-command.d.ts

@@ -1,11 +1,28 @@
 import { type CageConfig } from './config.js';
+/**
+ * 查询分支接受的原始 CLI 字符串选项，在执行前按子命令校验。
+ */
 interface QueryOptions {
+    /** 命令行输入的深度文本，后续解析并验证范围。 */
     depth?: string;
+    /** 节点/结果上限文本，不自动证明覆盖完整。 */
     limit?: string;
+    /** 可选节点种类筛选，必须属于支持词汇。 */
     kind?: string;
+    /** 路径遍历方向，both 允许反向读取关系。 */
     direction?: string;
+    /** 报告输出格式，支持值由入口校验。 */
     format?: string;
+    /** 可选输出文件路径；缺省写标准输出。 */
     out?: string;
 }
+/**
+ * 校验查询参数、抽取新快照并输出 JSON 或 Markdown。
+ * @param cfg 应用配置。
+ * @param action 支持的查询操作。
+ * @param targets 一个需求/节点，path 为两个端点。
+ * @param options 格式、输出路径和各操作的边界参数。
+ * @returns 命中且无错误为 0，否则为 1；out 可写报告，但不更新本体缓存。
+ */
 export declare function graphCommand(cfg: CageConfig, action: 'context' | 'search' | 'inspect' | 'path', targets: string[], options: QueryOptions): Promise<number>;
 export {};

package/dist/graph-command.js

@@ -1,3 +1,8 @@
+/**
+ * graph search/inspect/path 与 context 的命令行参数和输出适配层。
+ * 校验查询参数适用范围与数值，取得一次独立抽取快照，再调用共享查询或上下文构建器。
+ * 可写指定报告文件但不改当前本体缓存；未命中、歧义或图规则错误返回非零退出码。
+ */
 // CLI 负责参数和输出；查询函数本身可组合，Web 和其他工具无需再解析终端文本。
 import { mkdirSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
@@ -7,6 +12,14 @@ import { collectGraph } from './graph.js';
 import { kindLabels } from './graph-model.js';
 import { searchGraph, inspectGraph, findGraphPath, formatGraphQuery } from './graph-query.js';
 import { buildContext, formatContext } from './context.js';
+/**
+ * 把可选字符串转换为有下界的安全整数。
+ * @param name 错误文案中的参数名。
+ * @param raw 原始 CLI 值，undefined 使用默认值。
+ * @param fallback 缺省值。
+ * @param minimum 允许最小值。
+ * @returns 整数；空白、非整数或越界抛出。
+ */
 function integerOption(name, raw, fallback, minimum) {
     if (raw === undefined)
         return fallback;
@@ -15,6 +28,14 @@ function integerOption(name, raw, fallback, minimum) {
         throw new Error(`--${name} 必须是大于等于 ${minimum} 的整数`);
     return value;
 }
+/**
+ * 校验查询参数、抽取新快照并输出 JSON 或 Markdown。
+ * @param cfg 应用配置。
+ * @param action 支持的查询操作。
+ * @param targets 一个需求/节点，path 为两个端点。
+ * @param options 格式、输出路径和各操作的边界参数。
+ * @returns 命中且无错误为 0，否则为 1；out 可写报告，但不更新本体缓存。
+ */
 export async function graphCommand(cfg, action, targets, options) {
     const count = action === 'path' ? 2 : 1;
     if (targets.length !== count || targets.some((target) => !target.trim()))

package/dist/graph-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-command.js","sourceRoot":"","sources":["../src/graph-command.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAW3D,SAAS,aAAa,CAAC,IAAY,EAAE,GAAuB,EAAE,QAAgB,EAAE,OAAe;IAC7F,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO;QAChE,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,YAAY,OAAO,MAAM,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAe,EACf,MAAiD,EACjD,OAAiB,EACjB,OAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CACb,MAAM,KAAK,MAAM;YACf,CAAC,CAAC,6CAA6C;YAC/C,CAAC,CAAC,GAAG,MAAM,0BAA0B,CACxC,CAAC;IACJ,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG;QACpB,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,SAAS,EAAE,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC7B,CAAC;IACF,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;QAC3D,IAAI,OAAO,CAAC,MAAoC,CAAC,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC1F,MAAM,IAAI,KAAK,CAAC,KAAK,MAAM,QAAQ,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,GACV,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC3D,CAAC,CAAC,MAAM,KAAK,QAAQ;YACnB,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAoC,EAAE,CAAC;YAClG,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;gBACpC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE;oBAC9C,KAAK;oBACL,SAAS,EAAE,OAAO,CAAC,SAAuC;iBAC3D,CAAC,CAAC;IACb,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,MAAM;QACvB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS;YAC9B,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC;YACvB,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;;QAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,kCAAkC;IAClC,OAAO,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC"}
+{"version":3,"file":"graph-command.js","sourceRoot":"","sources":["../src/graph-command.ts"],"names":[],"mappings":"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"}

package/dist/graph-model.d.ts

@@ -1,21 +1,65 @@
+/**
+ * Web 图谱与 agent 查询共用的语义投影，不负责像素布局或业务执行。
+ * 把原始节点转换为带 kind 的稳定 key，按关系类型解析边端点，并补充只用于整理的归属虚线。
+ * 中文标签是展示覆盖，不改变业务标识；无法解析端点的边不会伪造节点，归属推导应与显式关系区分。
+ */
 import type { NodeKind, OntEdge, OntNode, Ontology } from './ontology.js';
+/**
+ * 节点类型的固定中文词汇，CLI 报告和浏览器共用；只影响呈现，不改变本体 kind。
+ */
 export declare const kindLabels: Record<NodeKind | 'entry', string>;
+/**
+ * 本体及展示归属边的中文短名，未知扩展关系由具体解释层处理。
+ */
 export declare const edgeLabels: Record<string, string>;
+/**
+ * 带稳定 key 的展示节点，entry 是为新建状态迁移补出的虚拟入口。
+ */
 export interface ViewNode extends Omit<OntNode, 'kind'> {
+    /** kind:id 组成的完整身份，避免同名命令与能力点混淆。 */
     key: string;
+    /** 原节点类型或状态迁移补出的虚拟 entry。 */
     kind: NodeKind | 'entry';
 }
+/**
+ * 端点已转换为完整节点 key 的展示边，derived 区分推导归属与原始声明。
+ */
 export interface ViewEdge extends Omit<OntEdge, 'kind'> {
+    /** 本次投影内的边身份，供选择和布局查找。 */
     key: string;
+    /** 原关系类型或仅供组织展示的 ownership。 */
     kind: OntEdge['kind'] | 'ownership';
+    /** true 表示推导归属，不能作为真实执行依赖证据。 */
     derived: boolean;
 }
+/**
+ * 与布局无关的节点和边投影，供查询、规则解释及浏览器布局共享。
+ */
 export interface GraphModel {
+    /** 包含原始节点与必要虚拟新建入口的展示节点。 */
     nodes: ViewNode[];
+    /** 两端已解析为节点 key 的展示关系。 */
     edges: ViewEdge[];
 }
 /** graph.labels 的显示覆盖不参与本体哈希；声明内的 description 仍由抽取器
  * 按该声明的含义处理。中文展示不会替换路由、权限或数据表使用的稳定标识。 */
+/**
+ * 按显示覆盖、标题、description、原 ID 的顺序选择文案。
+ * @param node 展示节点，虚拟 entry 固定使用新建入口文案。
+ * @param labels 仅用于显示的中文映射。
+ * @returns 展示名称，不修改节点或业务标识。
+ */
 export declare function nodeLabel(node: ViewNode, labels?: Record<string, string>): string;
+/**
+ * 将本体 ID 按关系端点类型转成唯一 key，并补新建入口及归属边。
+ * @param graph 原始本体，不会被修改。
+ * @returns 新展示模型；无法匹配两端的关系不输出，派生 ownership 不代表调用。
+ */
 export declare function projectGraph(graph: Ontology): GraphModel;
+/**
+ * 计算节点的一跳无向邻域，供画布高亮。
+ * @param model 展示图。
+ * @param key 完整节点身份。
+ * @returns 包含自身和直接邻居的集合；不继续传递，不区分执行方向。
+ */
 export declare function neighborhood(model: GraphModel, key: string): Set<string>;