dsh-data-domain-knowledge 0.1.0-alpha.1

package/lib/types/intent/types.js

@@ -0,0 +1,62 @@
+/**
+ * 出厂 act 词表。16 个动作覆盖"提问 / 让做 / 补充 / 反馈 / 终止 / 闲聊"六种交互。
+ *
+ * 记录仍是自由文本（模型可以写没配置过的 act，只给 warning），这份词表是**先验**：
+ * 它进 routing prompt，也进设置页与 `intent_registry_list`。
+ */
+export const DEFAULT_ACTS = [
+    { id: 'query', label: '查询', description: '向数据或知识提问，要一个答案或一批结果。', enabled: true },
+    { id: 'request', label: '执行请求', description: '让 Agent 做一件事并产生副作用：写入、发送、导出、修改。', enabled: true },
+    { id: 'inform', label: '补充信息', description: '用户提供事实、参数或上下文，本身不要求动作。', enabled: true },
+    { id: 'confirm', label: '确认', description: '用户认可某个提议或方案，允许继续。', enabled: true },
+    { id: 'select', label: '选择', description: '在多个候选中指定一个。', enabled: true },
+    { id: 'correct', label: '纠正', description: '指出前面的理解或结果不对，要求改。', enabled: true },
+    { id: 'cancel', label: '取消', description: '终止或撤回正在进行的任务。', enabled: true },
+    { id: 'review', label: '审阅', description: '对已产出的内容做检查、评估与把关。', enabled: true },
+    { id: 'explain', label: '解释', description: '要求讲清原理、口径或原因，而不是要新数据。', enabled: true },
+    { id: 'compare', label: '对比', description: '把两个及以上对象放在一起比较差异。', enabled: true },
+    { id: 'recommend', label: '推荐', description: '要建议与取舍意见。', enabled: true },
+    { id: 'resume', label: '继续', description: '回到之前中断的任务继续做。', enabled: true },
+    { id: 'reject', label: '拒绝', description: '不接受某个提议或结果。', enabled: true },
+    { id: 'greet', label: '问候', description: '打招呼、开场。', enabled: true },
+    { id: 'chat', label: '闲聊', description: '非任务性的对话。', enabled: true },
+    { id: 'unknown', label: '未判定', description: '无法归入以上任何一类，或本轮信息不足以判断。', enabled: true },
+];
+function category(id, label, route, description, examples) {
+    return { id, label, route, description, examples, enabled: true };
+}
+/**
+ * 出厂预置的意图分类。
+ *
+ * 每一项都**必须**带 `description` 与 `examples`：只给标签（"数据分析"）时模型
+ * 只能靠猜，同一句话在不同轮次会被分到不同类。这些文案是模型的匹配依据，全部
+ * 可以在「意图」页里改。
+ */
+export const DEFAULT_CATEGORIES = [
+    category('data_analysis', '数据分析', 'query', '取数、算指标、拆口径的请求：给一个数或一段分析结论。', ['帮我算一下上个月的 GMV', '这个指标怎么拆', '跑个数看看环比']),
+    category('metadata_exploration', '元数据探索', 'query', '问"有哪些表/字段/口径"本身，要的是结构而不是数字。', ['这张表有哪些字段', '库里有几张订单表', '这些指标的口径是怎么定义的']),
+    category('data_validation', '数据校验', 'query', '核对数据是否可信：对不上、空值、重复、异常波动。', ['这两个数对不上，查一下', '帮我看下这列有没有重复', '空值率是不是偏高了']),
+    category('knowledge_consultation', '知识咨询', 'query', '问组织既有的结论、规则、流程或负责人，答案在知识库里。', ['我们去年是怎么定这个口径的', '知识库里有没有相关文档', '这个流程找谁确认']),
+    category('knowledge_building', '知识构建', 'request', '把材料沉淀进知识库：录入来源、写卡片、重建索引。', ['把这份文档存进知识库', '记一条：这个口径改成…', '帮我整理成一张知识卡片']),
+    category('document_research', '文档研究', 'query', '对一份或多份长文档做通读、归纳、对比、找证据。', ['把这份 PRD 读一遍，总结需求点', '这几篇文档有没有冲突', '从报告里找出支持这个结论的证据']),
+    category('message_collaboration', '消息协作', 'request', '替用户发消息、同步进度、在群里通知或拉人。', ['发条消息给张三', '在群里同步一下进度', '@一下负责人催确认']),
+    category('artifact_delivery', '产物交付', 'request', '要一个可交付的文件：表格、报告、周报、导出件。', ['导出一份 Excel', '生成这周的周报', '把结果做成表格发我']),
+    category('agent_engineering', 'Agent 工程', 'request', '改 Agent 自身：加工具、调提示词、改 skill、查它为什么这么答。', ['加一个工具', '这个 skill 怎么改', '它刚才为什么没调那个工具']),
+    category('tooling_operations', '工具运维', 'request', '运维动作：重启、看队列、清缓存、处理环境报错。', ['重启一下服务', '看看任务队列', '这个报错怎么修']),
+    category('personal_assistant', '个人助理', 'request', '个人日程与提醒类事务。', ['明天提醒我开会', '帮我约个会', '看下我今天的日程']),
+    category('conversation', '普通对话', 'chat', '寒暄、闲聊、对 Agent 本身的提问，没有数据或交付目标。', ['你好', '你是谁', '谢谢，先这样']),
+];
+export const DEFAULT_PREDICATES = [
+    'query_babel_data', 'query_knowledge', 'query_source_truth', 'query_metadata',
+    'query_graph', 'add_source', 'write_knowledge_card', 'rebuild_knowledge',
+    'send_message', 'export_artifact', 'unknown',
+];
+export const DEFAULT_INTENT_SETTINGS = {
+    clarifyThreshold: 0.65,
+    ttlSeconds: 600,
+    fallbackEnabled: true,
+    categories: DEFAULT_CATEGORIES,
+    acts: DEFAULT_ACTS,
+    predicates: DEFAULT_PREDICATES,
+};
+//# sourceMappingURL=types.js.map

package/lib/types/intent/types.js.map

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

package/lib/types/knowledge-bases.d.ts

@@ -0,0 +1,266 @@
+/**
+ * 多知识库注册表（0021）。
+ *
+ * 产品参照 WeKnora：**一个知识库 = 独立配置 + 独立内容**。每个库有自己的
+ * `rootDir`（沿用既有的 `01_source_truth` / `02_wiki` / `03_compiled` /
+ * `04_memory` 布局）和一套「文件类型 → 解析引擎」规则；库下面挂文档列表、
+ * 文档详情与版本历史。
+ *
+ * 0029：库的 `rootDir` 不再是各写各的自由路径，而是**从 Tita Agent 根路径推出来的
+ * 一格**：`<agentRoot>/domain_knowledge/<库 id>`。注册表因此不再需要用户为每个库
+ * 挑一个目录 —— 见 `layout.ts` 的三条原理。
+ *
+ * 注册表本身只持久化**配置**（id / name / description / rootDir / sourceTypes / wikiTypes），
+ * 落到 `<dataHome>/knowledge-bases.json`，`dataHome =
+ * process.env.TITA_DATA_AGENT_HOME || ~/.tita-data-agent`。
+ * `sourceCount` / `cardCount` / `noteCount` / `buildVersion` 和每条分类/类型的
+ * 计数都是**计算字段**，缓存在同一个 JSON 里，由 `refresh()` 从真实
+ * runtime 重新统计；这样 `list()` / `get()` 保持同步签名（前端首屏直接用），
+ * 路由在返回前 `await refresh()` 拿到准确值。
+ *
+ * 默认库 id 固定为 `default`，其 `rootDir` 始终来自 `defaultRootDir()`
+ * （即插件设置里的 `agentRoot` 推出来的那一格），因此旧接口 / 旧工具不传 `kb`
+ * 时行为完全不变。
+ */
+import { type Envelope, type KnowledgeBase, type KnowledgeConfig, type SourceTypeDef, type SourceTypeDraft, type WikiSchemaMode, type WikiTypeDef } from './types.js';
+import { type WikiTypeDraft } from './wiki-types.js';
+import { KnowledgeRuntime } from './runtime.js';
+/**
+ * 默认知识库的 id。
+ *
+ * 导出成常量而不是只放在类字段上：`index.ts` 里 `runtimeOptions()` 会被
+ * **`bases` 构造之前**调用一次（默认库的 runtime 要先于注册表存在，因为注册表要
+ * 复用它），那时读 `bases.defaultId` 会撞上 TDZ。id 本身是契约的一部分，本来就
+ * 不该只挂在一个实例上。
+ */
+export declare const DEFAULT_KB_ID = "default";
+export interface KnowledgeBasesOptions {
+    /** 覆盖 `~/.tita-data-agent`；测试用临时目录，避免写用户主目录。 */
+    dataHome?: string;
+    /** 默认库的根目录来源；插件传入由 `agentRoot` 推出来的那一格。 */
+    defaultRootDir?: () => string;
+    /**
+     * Tita Agent 根路径来源（0029）。给了它，**新建**的知识库就落在
+     * `<agentRoot>/domain_knowledge/<id>`；不给则退回旧行为
+     * （`<dataHome>/knowledge-bases/<id>`），这样只关心注册表逻辑的单元测试
+     * 不必先造一个根路径。
+     */
+    agentRoot?: () => string;
+    /**
+     * 默认库已由宿主（settings 驱动）持有 runtime 时，复用它而不是另建一个，
+     * 否则同一个 rootDir 会被两个 runtime 同时写。
+     */
+    defaultRuntime?: () => KnowledgeRuntime;
+    /** 非默认库的 runtime 配置来源（embedding / rerank / topK 等跟随插件设置）。 */
+    config?: () => Partial<Omit<KnowledgeConfig, 'rootDir' | 'agentRoot'>>;
+    /**
+     * 覆盖注册表文件位置（默认 `<dataHome>/knowledge-bases.json`）。
+     *
+     * 可以是函数：0029 起它跟着 `agentRoot` 走（`<agentRoot>/resource/knowledge-bases.json`），
+     * 而 agentRoot 由设置决定、构造时还不知道。
+     */
+    registryFile?: string | (() => string);
+}
+export declare function defaultDataHome(): string;
+export declare class KnowledgeBases {
+    readonly defaultId = "default";
+    private readonly dataHome;
+    /** 路径来源可以是函数（跟着 agentRoot 走），所以现算。 */
+    private resolveRegistry;
+    /**
+     * **实际在用**的注册表文件。
+     *
+     * 由 `repoint()` 决定，`ensureLoaded()` 与 `persist()` 都读它。之所以不能每次都现算：
+     * 家当搬迁失败时（跨卷等）我们要**留在旧位置**，而「留在哪」必须是一个被记住的
+     * 决定，不能每次重新推导 —— 否则读在旧位置、写在新的，两边就分叉了。
+     */
+    private activeRegistry;
+    /** 实际在用的注册表文件；`repoint()` 还没跑过时就是配置算出来的那个。 */
+    private get registryPath();
+    private readonly options;
+    private records;
+    private stats;
+    /** runtime 缓存按 rootDir 建键，两个库共用目录时也就共用 runtime。 */
+    private readonly runtimes;
+    private loaded;
+    constructor(options?: KnowledgeBasesOptions);
+    /**
+     * 注册表位置变了就重新读一遍（0029：它跟着 `agentRoot` 走）。
+     *
+     * 位置没变时是空操作。变了的场景只有一个：用户改了根路径，于是注册表要跟着
+     * 搬过去 —— 那时旧位置的记录必须丢掉，否则会出现「两个库列表叠在一起」。
+     * 缓存的 runtime 一并关掉：它们的 `rootDir` 是按旧 agentRoot 算的。
+     */
+    repoint(): Promise<void>;
+    list(): KnowledgeBase[];
+    get(id: string): KnowledgeBase | undefined;
+    /**
+     * 某个知识库的 runtime（按 rootDir 缓存）。
+     *
+     * 未知 id 抛 `BASE_NOT_FOUND`（契约签名是同步返回 runtime，没有 Envelope
+     * 可承载错误）；路由先用 `get()` 做 404 判定。
+     */
+    runtimeOf(id: string): KnowledgeRuntime;
+    /**
+     * 设置变化后调用：关掉并丢弃非默认库的 runtime，下次 `runtimeOf` 会用新的
+     * embedding / rerank 配置重建。默认库由宿主自己重建，这里不动。
+     */
+    invalidate(): void;
+    closeAll(): void;
+    /**
+     * 从真实 runtime 重新统计一个（或全部）知识库的 sourceCount / cardCount /
+     * noteCount / buildVersion 与每条规则的 fileCount，并落盘缓存。
+     * 目录不可读时保留上一次统计，不抛错、不谎报 0。
+     */
+    refresh(id?: string): Promise<void>;
+    private refreshOne;
+    /**
+     * 新建知识库。名字为空时抛 `NAME_REQUIRED`（契约签名返回裸
+     * `KnowledgeBase`，没有 Envelope 可承载错误，路由捕获后转 400）。
+     * `rootDir` 缺省为 `<agentRoot>/domain_knowledge/<id>`（0029）；没接根路径时
+     * 退回 `<dataHome>/knowledge-bases/<id>`。
+     */
+    create(input: {
+        name: string;
+        description?: string;
+        rootDir?: string;
+    }): Promise<KnowledgeBase>;
+    /**
+     * 更新名称 / 描述 / 来源类型注册表 / Wiki 类型注册表。
+     *
+     * `patch.fileTypes` 与 `patch.sourceTypes` 都是**完整的期望列表**：凡是提供了
+     * 列表却丢掉了某个「在用」的条目，就返回 `*_IN_USE` 并且**整体不写入**（不做
+     * 部分更新），这样前端不会出现「名称改了、规则没删掉」的半成品状态。
+     *
+     * `sourceTypes` 另有三条注册表专属守卫（0013）：内置分类不允许删除（缺失即
+     * 恢复，并给出 warning）、兜底分类 `document` 不允许停用、新建自定义分类必须
+     * 提交完整判定文案。
+     */
+    update(id: string, patch: {
+        name?: string;
+        description?: string;
+        sourceTypes?: SourceTypeDef[];
+        wikiTypes?: WikiTypeDef[];
+        wikiSchemaMode?: WikiSchemaMode;
+        resetWikiTypes?: boolean;
+    }): Promise<Envelope<KnowledgeBase>>;
+    /** 某个知识库当前生效的分类注册表（含 `sourceCount`）。供 runtime provider 使用。 */
+    sourceTypesOf(id: string): SourceTypeDef[];
+    /**
+     * 新增一个自定义分类。
+     *
+     * 必须先满足判定文案要求（`validateSourceTypeDraft`）——0013 的「用户追加新
+     * 类型时要用文字标明怎么判断」在这里落成硬校验：没有 `description` /
+     * 至少 2 条 `signals` / 至少 1 条指向已知分类的 `excludes`，一律不进注册表。
+     */
+    addSourceType(id: string, draft: SourceTypeDraft): Promise<Envelope<SourceTypeDef>>;
+    /**
+     * 编辑一个分类的文案 / 启用状态。
+     *
+     * - 内置分类：可以改 `label` / `description` / `signals` / `excludes` / `enabled`；
+     * - 兜底分类 `document`：**不允许停用**（判定链最后一步落在它上）；
+     * - 自定义分类：同样可以改，`id` 永远锁定。
+     */
+    updateSourceType(id: string, typeId: string, patch: SourceTypeDraft): Promise<Envelope<SourceTypeDef>>;
+    /**
+     * 删除知识库。
+     *
+     * 只删注册表条目，**不动磁盘内容**（删用户文档是不可逆的，必须先显式清空文档，
+     * 这也是 `BASE_IN_USE` 守卫的另一半含义）。默认库拒绝删除。
+     */
+    remove(id: string): Promise<Envelope<{
+        deleted: true;
+    }>>;
+    /**
+     * 删除一个来源分类（0013）。
+     *
+     * 三层守卫，顺序即优先级：
+     * 1. 内置分类**不允许删除**（只能停用）；
+     * 2. 兜底分类**不允许删除**（它必须永远存在）；
+     * 3. 该分类下还有来源（`sourceCount > 0`）→ `SOURCE_TYPE_IN_USE`，先迁移再删。
+     */
+    removeSourceType(id: string, typeId: string): Promise<Envelope<{
+        deleted: true;
+    }>>;
+    /** 某个知识库当前生效的卡片类型（含 `cardCount`）。供 runtime provider 使用。 */
+    wikiTypesOf(id: string): WikiTypeDef[];
+    /** 卡片 schema 生效方式；未知 id 回退出厂值。 */
+    wikiSchemaModeOf(id: string): WikiSchemaMode;
+    /**
+     * 新增一个卡片类型。
+     *
+     * 与 0013 的 source type 同一条要求：光给名字不让入库——`sections` / `fields` 会直接
+     * 变成"卡片该怎么写"的约束，也是模板卡的来源。
+     */
+    addWikiType(id: string, draft: WikiTypeDraft): Promise<Envelope<WikiTypeDef>>;
+    /** 编辑一个卡片类型的文案 / 小节 / 字段 / 启停。内置类型也可以改，但 id 与 `builtin` 锁定。 */
+    updateWikiType(id: string, typeId: string, patch: WikiTypeDraft & {
+        enabled?: boolean;
+    }): Promise<Envelope<WikiTypeDef>>;
+    /**
+     * 删除一个卡片类型。
+     *
+     * 两层守卫：内置类型不可删（只能停用）；该类型下还有卡片时不可删（先改卡片类型）。
+     */
+    removeWikiType(id: string, typeId: string): Promise<Envelope<{
+        deleted: true;
+    }>>;
+    /** 切换卡片 schema 的生效方式（`report` 只标记，`strict` 拒绝不合规的写入）。 */
+    setWikiSchemaMode(id: string, mode: WikiSchemaMode): Promise<Envelope<{
+        mode: WikiSchemaMode;
+    }>>;
+    /** 把一条 draft 转成完整类型（模板卡由小节派生，不手写第二份）。 */
+    private wikiTypeFromDraft;
+    private stringList;
+    /**
+     * 把磁盘上的 `wikiTypes` 规整成**必定包含全部内置类型**的合法注册表。
+     *
+     * 与 `normalizeSourceTypes` 同一套语义：老配置（没有 `wikiTypes` 字段）升级时补齐内置，
+     * 缺失的内置类型被恢复（内置只允许停用，不允许删除）。
+     */
+    private normalizeWikiTypes;
+    /** 用一条持久化记录覆盖默认值；`builtin` / `id` 只信服务端。 */
+    private wikiTypeFromRecord;
+    /** `wikiTypes` 是否已偏离出厂定义（只看语义字段，不看计算字段）。 */
+    private wikiTypesDifferFromDefaults;
+    /**
+     * 把 `wikiTypes` 恢复成出厂定义（模式一并回到 `report`）。
+     *
+     * 与"整表提交里缺了某个内置类型"不同：那条路径只是**恢复缺失项**，保留了用户改过的内容；
+     * 这里是货真价实的重置，所以单独一个开关，语义不含糊。
+     */
+    resetWikiTypes(id: string): Promise<Envelope<KnowledgeBase>>;
+    private defaultRootDir;
+    private requireRecord;
+    private view;
+    private seedDefault;
+    private ensureLoaded;
+    private normalize;
+    /**
+     * 把磁盘上的 `sourceTypes` 规整成一个**必定包含全部内置分类**的合法注册表。
+     *
+     * 两个关键行为：
+     * 1. 老注册表（没有 `sourceTypes` 字段）升级时自动补上全部内置分类；
+     * 2. 任何缺失的内置分类都会被补回来——内置分类只允许停用，不允许删除。
+     */
+    private normalizeSourceTypes;
+    /** 用一条持久化记录覆盖默认值；`builtin` / `fallback` / `id` 只信服务端。 */
+    private sourceTypeFromRecord;
+    /**
+     * 合并前端提交的**完整**注册表列表。
+     *
+     * 返回 `error` 表示整体拒绝（不做部分写入）；返回 `warnings` 表示有内容被
+     * 静默纠正（目前只有"试图删除内置分类"这一种），前端据此提示用户。
+     */
+    private mergeSourceTypes;
+    /**
+     * 合并前端提交的**完整**卡片类型列表。
+     *
+     * 与 `mergeSourceTypes` 同一套语义：内置类型不可删除（缺失即恢复 + warning），
+     * 在用类型不可删除（整体拒绝，不做部分写入），自定义类型必须能写出骨架。
+     */
+    private mergeWikiTypes;
+    private nextId;
+    private persist;
+}
+//# sourceMappingURL=knowledge-bases.d.ts.map

package/lib/types/knowledge-bases.d.ts.map

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