@yss123/cage-cli 0.2.0 → 0.3.0

package/dist/graph-approvals.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 将本体中的审批绑定和路由 JSON 投影为业务流程图的审批步骤。
+ * 由流程图读取层调用，沿主要实现找到审批，再按声明顺序翻译条件、选人及会签规则。
+ * 不导入审批引擎、不执行条件或选人；取消和普通关联不展开审批，缺路由时保留空步骤说明证据不足。
+ */
+import type { BusinessStep } from './graph-business.js';
+import type { GraphModel, ViewNode } from './graph-model.js';
+/**
+ * 审批子图的一步显示数据，序号是展示顺序，不对应数据库任务 ID。
+ */
+export interface ApprovalTask {
+    /** 按整个审批顺序递增的展示序号，从 1 开始。 */
+    number: number;
+    /** 步骤名称，智能步骤同样保留声明标题。 */
+    title: string;
+    /** 由选人规则生成的中文角色/部门/用户说明。 */
+    actor: string;
+    /** 同意规则或智能审查说明，不是实际执行结论。 */
+    rule: string;
+    /** 用于人工任务规则展示的 any/all 标记。 */
+    mode: 'any' | 'all';
+}
+/**
+ * 按声明保留的步骤组；condition 缺省表示无条件，tasks 按原顺序展示。
+ */
+export interface ApprovalGroup {
+    /** 条件组的中文表达；缺省表示无条件步骤组。 */
+    condition?: string;
+    /** 该组按声明顺序排列的任务，条件不满足时整组跳过。 */
+    tasks: ApprovalTask[];
+}
+/**
+ * 主要审批的阅读投影，route 缺省及空 groups 表示当前抽取没有绑定路线证据。
+ */
+export interface ApprovalFlow {
+    /** 主要审批声明节点，提供起止和领域归属证据。 */
+    approval: ViewNode;
+    /** 找到的审批路由节点；缺省表示当前图没有可展开路由。 */
+    route?: ViewNode;
+    /** 按原路由顺序归并的条件组与任务。 */
+    groups: ApprovalGroup[];
+}
+/** 只展开阶段的主要审批。details 中作为实现依据出现的审批不代表此处执行审批；
+ * 取消动作也不能被画成重新走一轮审批。步骤顺序完全来自绑定的 route。 */
+/**
+ * 为业务步骤提取主要审批的路线，不展开仅作为 details 的旁证审批。
+ * @param model 语义图。
+ * @param step 当前阅读步骤，取消和对象关联返回 undefined。
+ * @param labels 字段、状态与角色中文覆盖。
+ * @returns 审批与按顺序分组的任务；不运行条件、不选人、不检查授权。
+ */
+export declare function approvalFlowForStep(model: GraphModel, step: BusinessStep, labels?: Record<string, string>): ApprovalFlow | undefined;
+/** 从真实驳回结论绑定辨认出口，不依赖阶段标题里是否含有“驳回”二字。 */
+/**
+ * 用真实 onRejected 绑定辨认驳回出口，不从标题猜测。
+ * @param flow 当前审批投影。
+ * @param target 待检查的命令或业务阶段。
+ * @returns 目标主要命令是否等于驳回结论，纯计算无副作用。
+ */
+export declare function isApprovalRejection(flow: ApprovalFlow, target: BusinessStep): boolean;

package/dist/graph-approvals.js

@@ -0,0 +1,80 @@
+/** 只展开阶段的主要审批。details 中作为实现依据出现的审批不代表此处执行审批；
+ * 取消动作也不能被画成重新走一轮审批。步骤顺序完全来自绑定的 route。 */
+/**
+ * 为业务步骤提取主要审批的路线，不展开仅作为 details 的旁证审批。
+ * @param model 语义图。
+ * @param step 当前阅读步骤，取消和对象关联返回 undefined。
+ * @param labels 字段、状态与角色中文覆盖。
+ * @returns 审批与按顺序分组的任务；不运行条件、不选人、不检查授权。
+ */
+export function approvalFlowForStep(model, step, labels = {}) {
+    if (step.label === '取消审批' || step.mode === 'association')
+        return undefined;
+    const approval = step.node.kind === 'approval'
+        ? step.node
+        : step.node.kind === 'stage'
+            ? model.nodes.find((n) => n.kind === 'approval' && n.key === step.node.attrs.primary)
+            : undefined;
+    if (!approval)
+        return undefined;
+    const route = model.nodes.find((n) => n.kind === 'route' &&
+        model.edges.some((e) => e.kind === 'binds' && e.from === n.key && e.to === approval.key));
+    if (!route)
+        return { approval, groups: [] };
+    const owner = String(approval.attrs.aggregate);
+    const fieldName = (field) => labels[`field:${owner}.${field}`] ?? '待命名字段';
+    const valueName = (value) => typeof value === 'number'
+        ? value.toLocaleString('zh-CN', { maximumFractionDigits: 20 })
+        : typeof value === 'boolean'
+            ? value
+                ? '是'
+                : '否'
+            : (labels[`state:${owner}.${value}`] ?? value);
+    const conditionName = (condition) => {
+        const field = fieldName(condition.field);
+        if (condition.op === 'eq' && condition.value === true)
+            return field;
+        const op = { gt: '大于', gte: '大于等于', lt: '小于', lte: '小于等于', eq: '为', ne: '不为', in: '属于' };
+        const value = Array.isArray(condition.value)
+            ? condition.value.map(valueName).join('、')
+            : valueName(condition.value);
+        return `${field}${op[condition.op]}${value}`;
+    };
+    let number = 0;
+    const task = (item) => item.kind === 'ai' ? {
+        number: ++number, title: item.title, actor: 'AI 审核', rule: '通过继续；退回修改结束本轮；转人工由本节点接管人处理', mode: 'any',
+    } : ({
+        number: ++number,
+        title: item.title,
+        actor: item.approver.kind === 'deptLeader'
+            ? `${fieldName(item.approver.field)}的负责人`
+            : item.approver.kind === 'role'
+                ? (labels[`role:${item.approver.code}`] ?? '待命名审批角色')
+                : `指定用户 ${item.approver.userId}`,
+        rule: item.mode === 'all' ? '所有审批人同意后继续' : '任一审批人同意即可继续',
+        mode: item.mode,
+    });
+    return {
+        approval,
+        route,
+        groups: route.attrs.nodes.map((item) => item.kind !== 'when'
+            ? { tasks: [task(item)] }
+            : { condition: conditionName(item.cond), tasks: item.steps.map(task) }),
+    };
+}
+/** 从真实驳回结论绑定辨认出口，不依赖阶段标题里是否含有“驳回”二字。 */
+/**
+ * 用真实 onRejected 绑定辨认驳回出口，不从标题猜测。
+ * @param flow 当前审批投影。
+ * @param target 待检查的命令或业务阶段。
+ * @returns 目标主要命令是否等于驳回结论，纯计算无副作用。
+ */
+export function isApprovalRejection(flow, target) {
+    const command = target.node.kind === 'command'
+        ? target.node.key
+        : target.node.kind === 'stage'
+            ? target.node.attrs.primary
+            : undefined;
+    return command === `command:${flow.approval.attrs.onRejected}`;
+}
+//# sourceMappingURL=graph-approvals.js.map

package/dist/graph-approvals.js.map

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

package/dist/graph-business.d.ts

@@ -0,0 +1,135 @@
+/**
+ * 把语义图整理为业务板块、显式流程、对象生命周期和操作触发树。
+ * 供图谱浏览器使用，优先采用 businessProcess 声明，旧项目按模块或聚合归属组织。
+ * 所有投影只辅助阅读，不调度操作；状态迁移、读取依赖、声明调用能力与真实自动触发分别处理。
+ */
+import { type GraphModel, type ViewNode } from './graph-model.js';
+/**
+ * 浏览器业务板块，包含对象、可阅读操作与显式流程；分组不新增执行关系。
+ */
+export interface BusinessBlock {
+    /** 稳定板块身份，来源于显式流程板块、模块路径或回退分组。 */
+    id: string;
+    /** 板块中文标题，可由展示配置覆盖。 */
+    title: string;
+    /** 归入板块的聚合展示节点。 */
+    objects: ViewNode[];
+    /** 板块内可探索的操作/查询等入口节点。 */
+    flows: ViewNode[];
+    /** 板块显式声明的业务流程节点，区别于自动触发链。 */
+    processes: ViewNode[];
+    /** 显式板块说明，缺省时不虚构业务目的。 */
+    description?: string;
+    /** 是否属于系统组织板块，决定默认过滤。 */
+    system: boolean;
+}
+/**
+ * 识别 User、Role、Dept 及其成员的系统组织前缀，供默认隐藏开关使用；不表示权限检查。
+ */
+export declare const isSystemObject: (node: ViewNode) => boolean;
+/**
+ * 只对有明确标识归属的节点寻找聚合，取最长匹配前缀。
+ * @param model 语义图。
+ * @param node 待定位节点。
+ * @returns 聚合或 undefined；事件/查询等任意名称不会按前缀误归属。
+ */
+export declare function businessOwner(model: GraphModel, node: ViewNode): ViewNode | undefined;
+/** 板块只组织展示，不新增本体关系。模块目录提供归属，旧的平铺项目按对象分组；
+ * 查询与任务允许出现在多个相关板块，但不会沿读取关系扩散出一整张业务图。 */
+/**
+ * 按显式业务区、模块路径或聚合整理板块，并附声明相关查询与任务。
+ * @param model 语义图，不被修改。
+ * @param labels 显示覆盖。
+ * @param showSystem 是否保留系统组织对象。
+ * @returns 稳定排序的板块；同一操作可出现在多个相关板块，不表示重复执行。
+ */
+export declare function businessBlocks(model: GraphModel, labels?: Record<string, string>, showSystem?: boolean): BusinessBlock[];
+/**
+ * 业务阅读树节点，保留实现依据、连线语义、重复引用和截断边界；不是运行中任务状态。
+ */
+export interface BusinessStep {
+    /** 路径身份区分相同命令在不同分支中的映射来源。 */
+    id: string;
+    /** 当前阶段或执行主体的展示节点。 */
+    node: ViewNode;
+    /** 从父步骤到本步骤的中间事件/反应等证据。 */
+    via: ViewNode[];
+    /** 父子连线的阅读说明，保留事务或条件语义。 */
+    label: string;
+    /** 步骤补充边界，例如 map 可返回 null 或仅声明可调用。 */
+    note: string;
+    /** 已展开的后续步骤，不代表运行时一定都会执行。 */
+    children: BusinessStep[];
+    /** 当前路径重复命中已有节点，布局应回连而非无限展开。 */
+    repeated: boolean;
+    /** 深度限制等导致停止展开，不能当作业务终点。 */
+    boundary: boolean;
+    /** 人工、自动、等待、关联或状态图的展示语义；缺省沿传统触发链解释。 */
+    mode?: 'manual' | 'automatic' | 'wait' | 'association' | 'lifecycle';
+    /** 来自业务流程声明的次要分支，只影响阅读与布线，不推断取消等业务含义。 */
+    branch?: boolean;
+}
+/** 业务页面缺少文案时明确提示补充，不用程序标识替代业务名称。完整本体仍保留标识。 */
+/**
+ * 优先使用中文覆盖与声明文案，缺失时明确显示待命名。
+ * @param node 展示节点。
+ * @param labels 中文标签映射。
+ * @returns 阅读标题，不改实际标识。
+ */
+export declare function businessLabel(node: ViewNode, labels?: Record<string, string>): string;
+/**
+ * 优先返回板块显式流程并保持源码顺序；没有流程规格时返回有状态迁移的对象供生命周期阅读。
+ */
+export declare const businessJourneys: (block: BusinessBlock, model: GraphModel) => ViewNode[];
+/** 显式流程的阶段是唯一身份。汇合与循环回连已有阶段，避免复制成多份业务。 */
+/**
+ * 把显式流程阶段组织成阅读树，汇合/循环只保留回连标记。
+ * @param model 语义图。
+ * @param process 已声明业务流程。
+ * @param options branches 控制次要分支，related 控制对象关联。
+ * @returns 流程入口树；关联不充当下一步，遍历不执行命令。
+ */
+export declare function traceBusinessProcess(model: GraphModel, process: ViewNode, options: {
+    branches: boolean;
+    related: boolean;
+}): BusinessStep;
+/** 旧项目按实际状态迁移阅读；只表达允许的操作，绝不推断成自动调用链。 */
+/**
+ * 对没有业务流程规格的对象沿允许状态迁移生成阅读树。
+ * @param model 语义图。
+ * @param object 目标聚合。
+ * @param labels 中文文案。
+ * @returns 从新建入口或初始状态开始的树；只表示允许操作，不推断自动触发。
+ */
+export declare function traceBusinessLifecycle(model: GraphModel, object: ViewNode, labels: Record<string, string>): BusinessStep;
+/** 只沿会驱动后续操作的声明追踪。状态可达性和 reads 均不当作调用顺序。
+ * 事件与反应收进步骤的实现依据，但保留事务、条件映射、取消及审批结论语义。 */
+/**
+ * 沿事件、反应、审批结论及外部回写构建有界操作树。
+ * @param model 语义图。
+ * @param root 完整节点 key。
+ * @param maxDepth 默认 6，另以累计步骤计数限制膨胀。
+ * @returns 入口树或 undefined；取消审批停止展开，循环/上限通过 repeated/boundary 显示。
+ */
+export declare function traceBusinessFlow(model: GraphModel, root: string, maxDepth?: number): BusinessStep | undefined;
+/**
+ * 按先序把已经有界的阅读树展开成列表。
+ * @param root 由追踪函数生成的根。
+ * @returns 包含重复引用占位节点的数组，不去重、不执行关系。
+ */
+export declare function flattenBusinessSteps(root: BusinessStep): BusinessStep[];
+/**
+ * 把命令 from/to 转成中文状态摘要。
+ * @param node 非命令返回空字符串。
+ * @param labels 状态名称覆盖。
+ * @returns 允许起始状态与目标，to=null 描述保持当前状态。
+ */
+export declare function businessStateSummary(node: ViewNode, labels: Record<string, string>): string;
+/**
+ * 把已知约束名翻译为业务提示，并解析额度与职责分离字段。
+ * @param name 内核约束标识。
+ * @param owner 所属聚合 ID。
+ * @param labels 字段中文标签。
+ * @returns 展示文案，未知约束保留原名，不求值或授予能力。
+ */
+export declare function businessConstraintLabel(name: string, owner: string, labels: Record<string, string>): string;