@yss123/cage-ontology 0.0.0-stage → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shunshunyue and Cage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,62 @@
-# Temporary Holding Version
+# @yss123/cage-ontology
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Cage 的运行时本体与能力发现包。从当前注册表提取聚合、命令、查询和审批的可解释声明，再按调用人的能力过滤并检索。主要用于服务端 AI 工具发现或受控能力目录，不是业务数据查询引擎、向量数据库或前端图谱组件。
+
+## 安装
+
+需要 Node.js 24+，与 kernel 等框架包保持同版本：
+
+```powershell
+pnpm add @yss123/cage-ontology @yss123/cage-kernel
+```
+
+普通应用启用 `@yss123/cage-ai` 时由运行时使用本包，无需再创建另一套本体服务。开发期间查源码、图谱、路径或影响范围，使用 `@yss123/cage-cli` 的 `cage context/graph`。
+
+## 服务端检索示例
+
+下面是服务端集成函数；`registry` 必须来自当前应用，`ctx` 来自已认证且实时解析授权的身份。不要从浏览器输入构造权限上下文。
+
+```ts
+/** 从当前注册表构建目录；函数只提取声明，不查询业务表或执行命令。 */
+import { type Ctx, type Registry } from '@yss123/cage-kernel';
+import { ontologyCatalog, runtimeOntology } from '@yss123/cage-ontology';
+
+/**
+ * 为受信任服务端调用方检索当前身份可发现的节点。
+ * @param registry 当前运行的领域注册表。
+ * @param ctx 认证层提供的身份和能力；行级范围由实际读取另行落实。
+ * @param query 中文说明、标识或字段关键词。
+ * @returns 有界摘要页；nextOffset 非空表示还存在后续结果。
+ */
+export function discover(registry: Registry, ctx: Ctx, query: string) {
+  const ontology = runtimeOntology(registry);
+  const catalog = ontologyCatalog(ontology);
+  return catalog.search(ctx, { query, offset: 0, limit: 10 });
+}
+```
+
+高频使用时在注册表确定后构建一次 `RuntimeOntology` 与目录，并在每次请求中传入当前 `ctx`；不要缓存用户授权结果。注册声明变化后重新构建，本体的 `fingerprint` 记录来源注册表。
+
+## 主要入口与结果
+
+| 入口 | 作用 |
+| --- | --- |
+| `runtimeOntology(registry)` | 提取公开字段、状态、输入、调用身份、规则名称与审批步骤 |
+| `ontologyCatalog(ontology)`、`OntologyCatalog` | 为稳定本体建立检索与关联索引 |
+| `catalog.search(ctx, input)` | 返回摘要、total、nextOffset、truncated；每页最多 20 项 |
+| `catalog.describe(ctx, key, section)` | 按 overview、fields、input、related 展开详情；字段和关系支持分页 |
+| `catalog.node(ctx, key)` | 读取一个授权可见节点；不存在和无权限均返回 NOT_FOUND |
+| `nodeKey(node)` | 得到 `aggregate:Note`、`command:Note.create` 等稳定键 |
+| `visibleNodes`、`searchOntology` | 直接过滤及简单关键词召回；大目录优先使用分页 catalog |
+
+运行本体不包含 handler 函数体、SQL、隐藏字段或密钥。命令可发现性按命令能力判断，其他节点要求其读依赖的 read 能力；可发现不等于可以访问任意业务记录或立即执行命令。状态、版本、数据范围与硬约束仍在实际读写阶段判断。
+
+搜索是确定性的关键词匹配，名称命中不是执行证据。规则只有名称时不能推断其阈值；分页未取完必须检查 `nextOffset/truncated`，不能把当前页当成完整业务集合。
+
+## 文档
+
+- [运行本体与 AI 工具发现](https://github.com/shunshunyue/cage/blob/main/docs/ai/intelligence.md)
+- [开发时的本体查询与源码定位](https://github.com/shunshunyue/cage/blob/main/docs/ai/ontology-context.md)
+- [能力发现与诊断](https://github.com/shunshunyue/cage/blob/main/docs/ai/diagnostics.md)
+
+源码与反馈：[GitHub](https://github.com/shunshunyue/cage)。许可证：[MIT](https://github.com/shunshunyue/cage/blob/main/LICENSE)。

package/dist/catalog.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 运行本体的确定性检索索引。构造时建立标题、字段和双向关系索引；查询时按当前权限过滤。
+ * 搜索与详情提供分页及原始 key，不使用向量推理；弱引用缓存随本体对象释放，不能缓存用户授权结果。
+ */
+import { type Ctx } from '@yss123/cage-kernel';
+import type { RuntimeNode, RuntimeOntology } from './index.js';
+/**
+ * 组合节点类型与稳定 ID，避免命令/查询等同名节点碰撞。
+ */
+export declare const nodeKey: (node: RuntimeNode) => string;
+/**
+ * 模型发现阶段的精简节点摘要，完整 schema 按 key 另读。
+ */
+export interface OntologySummary {
+    /**
+     * 类型与 ID 组成的查询 key。
+     */
+    key: string;
+    /**
+     * 原始声明标识。
+     */
+    id: string;
+    /**
+     * 声明种类。
+     */
+    kind: RuntimeNode['kind'];
+    /**
+     * 有界显示标题。
+     */
+    title: string;
+    /**
+     * 关联聚合名列表。
+     */
+    aggregates: string[];
+}
+/**
+ * 目录过滤与分页输入，空关键词可浏览全部授权候选。
+ */
+export interface OntologySearch {
+    /**
+     * 关键词，省略或空值浏览目录。
+     */
+    query?: string;
+    /**
+     * 限定种类，省略不限制。
+     */
+    kinds?: RuntimeNode['kind'][];
+    /**
+     * 限定关联聚合，不隐式授予其读取权。
+     */
+    aggregate?: string;
+    /**
+     * 零基分页偏移，由调用层 schema 校验。
+     */
+    offset?: number;
+    /**
+     * 期望数量，搜索及详情各有内部上限。
+     */
+    limit?: number;
+}
+/**
+ * 命令按自身能力可见；其他节点需所有依赖聚合可读。可发现创建输入不要求同时授予对象 read，实际执行另行校验。
+ */
+export declare function nodeVisible(node: RuntimeNode, ctx: Ctx): boolean;
+/** 对稳定声明预建索引；完整 schema 留在后端。搜索、详情和关系均可分页，不静默截断目录。 */
+export declare class OntologyCatalog {
+    readonly ontology: RuntimeOntology;
+    /** 稳定 kind:id 到节点的索引；存声明数据，不缓存任何用户授权判断。 */
+    private nodes;
+    /** 聚合之间的双向关系发现索引；双向可发现不表示读权限或业务写关系也是双向。 */
+    private relations;
+    /** 搜索用的规范化文本和标题快照，构造时一次生成，命中后仍按当前 ctx 过滤可见性。 */
+    private documents;
+    /**
+     * 索引稳定本体；重复 key 立即拒绝，关系同时记录两端便于反向发现，但不改变实际读权限。
+     */
+    constructor(ontology: RuntimeOntology);
+    /**
+     * 读取指定 key 并核对当前可见性；不存在与无权均返回 NOT_FOUND。
+     */
+    node(ctx: Ctx, key: string): RuntimeNode;
+    /**
+     * 先按当前权限、调用方筛选器与聚合/种类过滤，再对标题和字段打分；同分按 key 稳定排序。
+     */
+    private hits;
+    /** 服务端规划工具预算时只需 key，不受面向模型的摘要分页大小限制。 */
+    /**
+     * 返回全部合格 key 供后端预算规划；只省略摘要分页，不省略授权检查。
+     */
+    keys(ctx: Ctx, input?: OntologySearch, eligible?: (node: RuntimeNode) => boolean): string[];
+    /**
+     * 返回至多 20 条摘要及 total/nextOffset；空查询仍分页，truncated 明确提示未取完。
+     */
+    search(ctx: Ctx, input?: OntologySearch, eligible?: (node: RuntimeNode) => boolean): {
+        query: string;
+        total: number;
+        offset: number;
+        limit: number;
+        nextOffset: number | null;
+        truncated: boolean;
+        items: OntologySummary[];
+    };
+    /**
+     * 按 overview/fields/input/related 展开：输入 schema 保持完整，字段和关联分页。
+     * 关系沿双向声明扩展但逐节点检查可见性；返回数量上限不表示其他节点不存在。
+     */
+    describe(ctx: Ctx, key: string, section?: 'overview' | 'fields' | 'input' | 'related', offset?: number, limit?: number): unknown;
+}
+/**
+ * 按本体对象复用索引，WeakMap 不延长本体生命周期；权限仍在每次方法调用时传入。
+ */
+export declare function ontologyCatalog(ontology: RuntimeOntology): OntologyCatalog;

package/dist/catalog.js

@@ -0,0 +1,197 @@
+/**
+ * 运行本体的确定性检索索引。构造时建立标题、字段和双向关系索引；查询时按当前权限过滤。
+ * 搜索与详情提供分页及原始 key，不使用向量推理；弱引用缓存随本体对象释放，不能缓存用户授权结果。
+ */
+import { cageError } from '@yss123/cage-kernel';
+/**
+ * 组合节点类型与稳定 ID，避免命令/查询等同名节点碰撞。
+ */
+export const nodeKey = (node) => `${node.kind}:${node.id}`;
+/**
+ * 命令按自身能力可见；其他节点需所有依赖聚合可读。可发现创建输入不要求同时授予对象 read，实际执行另行校验。
+ */
+export function nodeVisible(node, ctx) {
+    // 获授创建命令不等于能读对象，但用户仍需发现该命令的合法参数。
+    return node.kind === 'command'
+        ? ctx.capabilities.has(node.id)
+        : node.reads.every((name) => ctx.capabilities.has(`${name}.read`));
+}
+/**
+ * 规范化 Unicode 和大小写，使中英文标识以同一形式参与确定性匹配。
+ */
+const normalize = (value) => value.normalize('NFKC').toLowerCase();
+/**
+ * 压缩显示标题并保留来源 key/聚合关联，不复制完整字段与输入 schema。
+ */
+const summary = (node) => ({
+    key: nodeKey(node),
+    id: node.id,
+    kind: node.kind,
+    title: node.title.slice(0, 300),
+    aggregates: node.reads,
+});
+/**
+ * 提取英文标识和中文整段及相邻双字词，去重后打分；没有语义向量召回。
+ */
+function terms(query) {
+    const normalized = normalize(query), words = [...(normalized.match(/[a-z0-9_.-]+/g) ?? [])];
+    for (const run of normalized.match(/[\p{Script=Han}]+/gu) ?? []) {
+        words.push(run);
+        for (let i = 0; i + 1 < run.length; i++)
+            words.push(run.slice(i, i + 2));
+    }
+    return [...new Set(words)];
+}
+/** 对稳定声明预建索引；完整 schema 留在后端。搜索、详情和关系均可分页，不静默截断目录。 */
+export class OntologyCatalog {
+    ontology;
+    /** 稳定 kind:id 到节点的索引；存声明数据，不缓存任何用户授权判断。 */
+    nodes = new Map();
+    /** 聚合之间的双向关系发现索引；双向可发现不表示读权限或业务写关系也是双向。 */
+    relations = new Map();
+    /** 搜索用的规范化文本和标题快照，构造时一次生成，命中后仍按当前 ctx 过滤可见性。 */
+    documents;
+    /**
+     * 索引稳定本体；重复 key 立即拒绝，关系同时记录两端便于反向发现，但不改变实际读权限。
+     */
+    constructor(ontology) {
+        this.ontology = ontology;
+        this.documents = ontology.nodes.map((node) => {
+            const key = nodeKey(node);
+            if (this.nodes.has(key))
+                throw new Error(`重复本体节点：${key}`);
+            this.nodes.set(key, node);
+            if (node.kind === 'aggregate')
+                for (const field of Object.values((node.data.fields ?? {}))) {
+                    if (typeof field.relation !== 'string')
+                        continue;
+                    // 目录关系可双向发现；从关联对象进入也应找到引用它的业务，不改变实际读取授权。
+                    for (const [from, to] of [
+                        [node.id, field.relation],
+                        [field.relation, node.id],
+                    ]) {
+                        if (!this.relations.has(from))
+                            this.relations.set(from, new Set());
+                        this.relations.get(from).add(to);
+                    }
+                }
+            const fields = Object.entries((node.data.fields ?? {}))
+                .map(([name, f]) => `${name} ${f.description ?? ''}`)
+                .join(' ');
+            return {
+                node,
+                title: normalize(`${node.id} ${node.title}`),
+                text: normalize(`${key} ${node.title} ${node.reads.join(' ')} ${fields}`),
+            };
+        });
+    }
+    /**
+     * 读取指定 key 并核对当前可见性；不存在与无权均返回 NOT_FOUND。
+     */
+    node(ctx, key) {
+        const node = this.nodes.get(key);
+        if (!node || !nodeVisible(node, ctx))
+            throw cageError('NOT_FOUND');
+        return node;
+    }
+    /**
+     * 先按当前权限、调用方筛选器与聚合/种类过滤，再对标题和字段打分；同分按 key 稳定排序。
+     */
+    hits(ctx, input, eligible) {
+        const query = normalize(input.query?.trim() ?? ''), words = terms(query);
+        return this.documents
+            .filter(({ node }) => nodeVisible(node, ctx) &&
+            eligible(node) &&
+            (!input.kinds?.length || input.kinds.includes(node.kind)) &&
+            (!input.aggregate || node.reads.includes(input.aggregate)))
+            .map((doc) => ({
+            ...doc,
+            score: !query
+                ? 1
+                : (normalize(nodeKey(doc.node)) === query || normalize(doc.node.id) === query ? 1000 : 0) +
+                    words.reduce((score, word) => score + (doc.title.includes(word) ? Math.min(20, word.length) * 3 : doc.text.includes(word) ? 1 : 0), 0),
+        }))
+            .filter((hit) => hit.score > 0)
+            .sort((a, b) => b.score - a.score || nodeKey(a.node).localeCompare(nodeKey(b.node)));
+    }
+    /** 服务端规划工具预算时只需 key，不受面向模型的摘要分页大小限制。 */
+    /**
+     * 返回全部合格 key 供后端预算规划；只省略摘要分页，不省略授权检查。
+     */
+    keys(ctx, input = {}, eligible = () => true) {
+        return this.hits(ctx, input, eligible).map((hit) => nodeKey(hit.node));
+    }
+    /**
+     * 返回至多 20 条摘要及 total/nextOffset；空查询仍分页，truncated 明确提示未取完。
+     */
+    search(ctx, input = {}, eligible = () => true) {
+        const offset = input.offset ?? 0, limit = Math.max(1, Math.min(20, input.limit ?? 10));
+        const hits = this.hits(ctx, input, eligible);
+        return {
+            query: input.query ?? '',
+            total: hits.length,
+            offset,
+            limit,
+            nextOffset: offset + limit < hits.length ? offset + limit : null,
+            truncated: offset + limit < hits.length,
+            items: hits.slice(offset, offset + limit).map((hit) => summary(hit.node)),
+        };
+    }
+    /**
+     * 按 overview/fields/input/related 展开：输入 schema 保持完整，字段和关联分页。
+     * 关系沿双向声明扩展但逐节点检查可见性；返回数量上限不表示其他节点不存在。
+     */
+    describe(ctx, key, section = 'overview', offset = 0, limit = 12) {
+        const node = this.node(ctx, key), base = summary(node);
+        limit = Math.max(1, Math.min(30, limit));
+        if (section === 'input')
+            return { ...base, input: node.data.input ?? null };
+        if (section === 'fields') {
+            const fields = Object.entries((node.data.fields ?? {}));
+            return {
+                ...base,
+                total: fields.length,
+                offset,
+                nextOffset: offset + limit < fields.length ? offset + limit : null,
+                fields: Object.fromEntries(fields.slice(offset, offset + limit)),
+            };
+        }
+        if (section === 'related') {
+            const aggregates = new Set(node.reads);
+            for (const aggregate of node.reads)
+                for (const related of this.relations.get(aggregate) ?? [])
+                    aggregates.add(related);
+            const related = this.ontology.nodes
+                .filter((candidate) => candidate !== node && nodeVisible(candidate, ctx) && candidate.reads.some((a) => aggregates.has(a)))
+                .sort((a, b) => nodeKey(a).localeCompare(nodeKey(b)));
+            return {
+                ...base,
+                total: related.length,
+                offset,
+                nextOffset: offset + limit < related.length ? offset + limit : null,
+                items: related.slice(offset, offset + limit).map(summary),
+            };
+        }
+        return {
+            ...base,
+            definition: Object.fromEntries(Object.entries(node.data).filter(([key]) => !['fields', 'input'].includes(key))),
+            fieldCount: Object.keys((node.data.fields ?? {})).length,
+            hasInput: !!node.data.input,
+            sections: ['overview', 'fields', 'input', 'related'],
+        };
+    }
+}
+/** 按不可变本体对象复用检索索引；弱引用随本体释放，不跨对象复用旧注册表内容。 */
+const catalogs = new WeakMap();
+/**
+ * 按本体对象复用索引，WeakMap 不延长本体生命周期；权限仍在每次方法调用时传入。
+ */
+export function ontologyCatalog(ontology) {
+    let catalog = catalogs.get(ontology);
+    if (!catalog) {
+        catalog = new OntologyCatalog(ontology);
+        catalogs.set(ontology, catalog);
+    }
+    return catalog;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 从运行注册表构建可解释的领域目录，供 AI 发现声明和读取规则摘要。
+ * 不导出 handler、SQL、隐藏字段和密钥；本体只描述声明，实际数据读取/写入仍走内核。
+ */
+import { type Registry, type Ctx } from '@yss123/cage-kernel';
+export { OntologyCatalog, ontologyCatalog, nodeKey, type OntologySummary, type OntologySearch } from './catalog.js';
+/**
+ * 一个聚合、命令、查询或审批的公开声明节点，data 只保存可解释事实。
+ */
+export interface RuntimeNode {
+    id: string; /** 节点种类，和 id 一起形成唯一 key。 */
+    kind: 'aggregate' | 'command' | 'query' | 'approval'; /** 声明中文说明，缺失时回退稳定标识。 */
+    title: string; /** 可解释的字段、输入、状态和规则摘要，不含函数体。 */
+    data: Record<string, unknown>; /** 关联的聚合名，用于发现权限和关系组织。 */
+    reads: string[];
+}
+/**
+ * 带版本与注册指纹的运行本体，可在启动时验证与当前注册表一致。
+ */
+export interface RuntimeOntology {
+    version: 1; /** 来源注册表指纹，防止旧目录与新运行混用。 */
+    fingerprint: string; /** 公开声明节点列表，不代表全部业务数据。 */
+    nodes: RuntimeNode[];
+}
+/** 只导出可解释的声明事实；handler、SQL、隐藏字段与密钥不会成为模型上下文。 */
+/**
+ * 提取公开字段、状态、命令输入与调用身份、查询依赖和审批步骤；不序列化可执行函数。
+ * @param registry 当前运行注册表。
+ * @returns 与注册指纹绑定的目录；规则只有名称时不能据此推断阈值。
+ */
+export declare function runtimeOntology(registry: Registry): RuntimeOntology;
+/**
+ * 按当前能力筛选可发现节点；命令依赖命令能力，其他节点依赖全部 reads 的 read 能力，行范围仍由实际读取处理。
+ */
+export declare function visibleNodes(ontology: RuntimeOntology, ctx: Ctx): RuntimeNode[];
+/** 确定性召回保留来源 ID；模型解释不能把名称匹配当作执行证据。 */
+/**
+ * 旧式确定性关键词检索，按匹配数和 ID 排序，最多 40 项；名称匹配不是执行证据，大目录优先用分页 catalog。
+ */
+export declare function searchOntology(ontology: RuntimeOntology, ctx: Ctx, query: string, limit?: number): RuntimeNode[];

package/dist/index.js

@@ -0,0 +1,58 @@
+/**
+ * 从运行注册表构建可解释的领域目录，供 AI 发现声明和读取规则摘要。
+ * 不导出 handler、SQL、隐藏字段和密钥；本体只描述声明，实际数据读取/写入仍走内核。
+ */
+import { registryFingerprint } from '@yss123/cage-kernel';
+import { z } from 'zod';
+import { nodeVisible } from './catalog.js';
+export { OntologyCatalog, ontologyCatalog, nodeKey } from './catalog.js';
+/** 只导出可解释的声明事实；handler、SQL、隐藏字段与密钥不会成为模型上下文。 */
+/**
+ * 提取公开字段、状态、命令输入与调用身份、查询依赖和审批步骤；不序列化可执行函数。
+ * @param registry 当前运行注册表。
+ * @returns 与注册指纹绑定的目录；规则只有名称时不能据此推断阈值。
+ */
+export function runtimeOntology(registry) {
+    const nodes = [];
+    for (const aggregate of registry.aggregates)
+        nodes.push({ id: aggregate.name, kind: 'aggregate', title: aggregate.description ?? aggregate.name, reads: [aggregate.name],
+            data: { fields: Object.fromEntries(Object.entries(aggregate.fields).filter(([, f]) => !f.isHidden).map(([name, f]) => [name, {
+                        kind: f.kind, description: f.description, optional: f.isOptional, sensitive: f.sensitiveKind, relation: f.ref, values: f.values,
+                    }])), states: aggregate.states.values, invariants: Object.keys(aggregate.invariants) } });
+    for (const { capability, cmd } of registry.commands)
+        nodes.push({ id: capability, kind: 'command', title: cmd.description ?? capability, reads: [cmd.agg.name],
+            data: { aggregate: cmd.agg.name, input: z.toJSONSchema(cmd.input, { io: 'input', unrepresentable: 'any' }), from: cmd.from, to: cmd.to,
+                invokedBy: cmd.invokedBy, constraints: cmd.constraints.map(c => c.name) } });
+    for (const query of registry.queries)
+        nodes.push({ id: query.name, kind: 'query', title: query.description ?? query.name, reads: query.reads.map(a => a.name),
+            data: { input: z.toJSONSchema(query.input, { io: 'input', unrepresentable: 'any' }), purpose: query.audit?.purpose } });
+    for (const { a } of registry.approvals) {
+        const route = registry.extensions.find(e => e.kind === 'ROUTE' && e.value.process === a.process);
+        const publicStep = (step) => step.kind === 'when' ? { kind: 'when', condition: step.cond, steps: step.steps.map(publicStep) }
+            : step.kind === 'parallel' ? { kind: 'parallel', title: step.title, join: 'all',
+                branches: step.branches.map((branch) => ({ title: branch.title, steps: branch.nodes.map(publicStep) })) }
+                : step.kind === 'ai' ? { kind: 'ai', title: step.title, outcomes: ['pass', 'return', 'manual'] }
+                    : { kind: 'human', title: step.title, approver: step.approver, mode: step.mode };
+        nodes.push({ id: a.process, kind: 'approval', title: a.process, reads: [a.agg.name], data: { aggregate: a.agg.name,
+                onApproved: registry.capabilityOf(a.onApproved), onRejected: registry.capabilityOf(a.onRejected),
+                onReturned: a.onReturned && registry.capabilityOf(a.onReturned), steps: route?.value.nodes.map(publicStep) ?? [] } });
+    }
+    return { version: 1, fingerprint: registryFingerprint(registry), nodes };
+}
+/**
+ * 按当前能力筛选可发现节点；命令依赖命令能力，其他节点依赖全部 reads 的 read 能力，行范围仍由实际读取处理。
+ */
+export function visibleNodes(ontology, ctx) {
+    return ontology.nodes.filter(node => nodeVisible(node, ctx));
+}
+/** 确定性召回保留来源 ID；模型解释不能把名称匹配当作执行证据。 */
+/**
+ * 旧式确定性关键词检索，按匹配数和 ID 排序，最多 40 项；名称匹配不是执行证据，大目录优先用分页 catalog。
+ */
+export function searchOntology(ontology, ctx, query, limit = 12) {
+    const text = query.normalize('NFKC').toLowerCase();
+    const words = text.match(/[a-z0-9_.]+|[\p{Script=Han}]{2}/gu) ?? [text];
+    return visibleNodes(ontology, ctx).map(node => ({ node, score: words.reduce((n, word) => n + (JSON.stringify(node).toLowerCase().includes(word) ? 1 : 0), 0) }))
+        .filter(entry => !text || entry.score > 0).sort((a, b) => b.score - a.score || a.node.id.localeCompare(b.node.id)).slice(0, Math.min(40, limit)).map(entry => entry.node);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@yss123/cage-ontology",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.1",
+  "type": "module",
+  "description": "Cage 运行时本体与受控能力发现",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.1.5",
+    "@yss123/cage-kernel": "0.3.1"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shunshunyue/cage.git",
+    "directory": "packages/ontology"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }