aitable-workflow-cli 0.1.23 → 0.1.24

package/templates/support-qa/lib/owner-resolver.ts

@@ -1,94 +0,0 @@
-/**
- * Owner 身份确定性解析（spec §8）
- *
- * 输入 Agent 给出的 module，按「精确 key 查找，不做扩展词/模糊匹配/二次 LLM」解析：
- *   module → 功能模块人员配置表快照（config-sync 发布到 ${globalVar.module_owners}）
- *
- * 快照由 config-sync 定时从 AI 表格「功能模块人员配置表」（模块-文本 + 人员-人员字段）
- * 拉取，人员经 dws contact user get→search 链式解析出 userId/nick/openDingTalkId 后
- * 才会入快照，因此本模块只做纯查找，不再回读文件、不再二次解析联系人。
- *
- * Owner 数组视为「主负责人 + 备选负责人」：取第一个 Owner 作为主负责人（群内只 @ 一人）。
- */
-
-export type OwnerResolution =
-  | {
-      status: "resolved";
-      module: string;
-      ownerName: string;
-      ownerUserId: string;
-      ownerOpenDingTalkId?: string;
-    }
-  | {
-      status: "failed";
-      module: string;
-      reason: "missing_module" | "unknown_module" | "missing_contact" | "invalid_config";
-    };
-
-export type OwnerContact = {
-  userId: string;
-  nick: string;
-  openDingTalkId: string;
-};
-
-export type ModuleOwners = {
-  module: string;
-  owners: OwnerContact[];
-};
-
-function asRecord(value: unknown): Record<string, unknown> | null {
-  return value !== null && typeof value === "object" && !Array.isArray(value)
-    ? value as Record<string, unknown>
-    : null;
-}
-
-function cellString(v: unknown): string {
-  return typeof v === "string" ? v.trim() : typeof v === "number" ? String(v) : "";
-}
-
-/**
- * 模块人员快照标准化（config-sync 发布前与消费端共用）：
- * 丢弃缺 module 的行、缺 userId/nick/openDingTalkId 的人；按 module 排序保证快照稳定。
- */
-export function normalizeModuleOwners(raw: unknown): ModuleOwners[] {
-  if (!Array.isArray(raw)) return [];
-  return raw.flatMap((value): ModuleOwners[] => {
-    const record = asRecord(value);
-    const module = cellString(record?.module);
-    if (!module) return [];
-    const owners = (Array.isArray(record?.owners) ? record.owners : [])
-      .flatMap((o): OwnerContact[] => {
-        const contact = asRecord(o);
-        const userId = cellString(contact?.userId);
-        const nick = cellString(contact?.nick);
-        const openDingTalkId = cellString(contact?.openDingTalkId);
-        return userId && nick && openDingTalkId ? [{ userId, nick, openDingTalkId }] : [];
-      });
-    return owners.length > 0 ? [{ module, owners }] : [];
-  }).sort((left, right) => (
-    left.module.localeCompare(right.module)
-    || JSON.stringify(left).localeCompare(JSON.stringify(right))
-  ));
-}
-
-export function resolveOwner(snapshot: unknown, rawModule: string): OwnerResolution {
-  const module = String(rawModule ?? "").trim();
-  if (!module) return { status: "failed", module, reason: "missing_module" };
-
-  const moduleOwners = normalizeModuleOwners(snapshot);
-  if (moduleOwners.length === 0) return { status: "failed", module, reason: "invalid_config" };
-
-  // 精确 module 匹配（禁止扩展词/子串/模糊匹配）
-  const matched = moduleOwners.find((entry) => entry.module === module);
-  if (!matched) return { status: "failed", module, reason: "unknown_module" };
-
-  const owner = matched.owners[0];
-  if (!owner) return { status: "failed", module, reason: "missing_contact" };
-  return {
-    status: "resolved",
-    module,
-    ownerName: owner.nick,
-    ownerUserId: owner.userId,
-    ownerOpenDingTalkId: owner.openDingTalkId,
-  };
-}

package/templates/support-qa/lib/preflight.ts

@@ -1,294 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-import { parse as parseYaml } from "yaml";
-import { isCapabilityEnabled, loadClassifierRules, loadReplyRules } from "./declarative-matcher.js";
-import type { PreflightIssue } from "aitable-workflow-core";
-import { SUPPORT_ACTIONS, KB_STATUS, KB_STATUS_VALUES } from "./contract.js";
-
-/**
- * support-qa 实例 preflight（纯校验，零写盘）
- *
- * 由 core 的 preflight 扩展点在 `aitable-workflow config` 与 `run` / `setup` 启动期加载
- * （约定：实例根 `lib/preflight.ts` 导出 `preflight(configDir)`）。
- *
- * 分档语义（core 按此决定停到什么程度）：
- *   - fatal：实例级不可信 → 拒绝启动。profile.yml 结构错、persona 缺失/为空、
- *            persona 疑似放开通用闸门（"闸门只准收紧不准放开"纪律的落点）。
- *   - error：可归因到单个 workflow → 只停该轨道，其余工作流照跑。
- *   - warn ：L3 可选能力关不上 → 该能力优雅关闭，主环照跑。
- *
- * 为什么不再写盘：persona 早已由 core 读取 profile 的 `persona: { file }` 并注入每次
- * coding.run 的 prompt（registry.resolvePersonaFile → RoleContext → agent-adapter），
- * 曾经生成的 workspaces/<role>/persona.md 是第二条冗余通路，已删。
- * 但 core 对 persona 读取失败只 warn + 跳过该角色（会静默降级成 persona=role-id 的
- * 临时角色），因此「persona.file 存在且非空」必须由本文件按 fatal 拦住。
- */
-
-const GROUP_QA_WORKFLOW = "group-qa";
-const ADMIN_KB_WORKFLOW = "admin-kb-update";
-
-/** persona 疑似放开通用闸门的特征：闸门只准收紧，不准放开 */
-const PERSONA_GATE_RELAXING = /忽略(上述|以上|通用)|必须回复所有|无据也(可以|要)回答|不用静默/;
-
-function readRawProfile(configDir: string, issues: PreflightIssue[]): Record<string, unknown> | null {
-  const file = path.resolve(configDir, "profile", "profile.yml");
-  if (!existsSync(file)) {
-    issues.push({ level: "fatal", message: `profile/profile.yml 不存在: ${file}` });
-    return null;
-  }
-  try {
-    const raw = (parseYaml(readFileSync(file, "utf8")) ?? {}) as Record<string, unknown>;
-    if (raw.schema_version !== 2) {
-      issues.push({
-        level: "fatal",
-        message: `profile.yml schema_version 必须为 2（当前: ${raw.schema_version ?? "缺失"}）。请按迁移指引升级。`,
-      });
-      return null;
-    }
-    return raw;
-  } catch (err) {
-    issues.push({
-      level: "fatal",
-      message: `profile/profile.yml 解析失败: ${err instanceof Error ? err.message : String(err)}`,
-    });
-    return null;
-  }
-}
-
-/** collections 校验：trim、去空、必须是不含 .. 的相对路径、目录须存在 */
-function validateCollections(configDir: string, raw: unknown, issues: PreflightIssue[]): void {
-  const list = Array.isArray(raw)
-    ? raw.map((c) =>
-        typeof c === "string" ? c.trim()
-        : c && typeof c === "object" && "collection" in c ? String((c as { collection: string }).collection).trim()
-        : String(c ?? "").trim())
-    : [];
-  if (list.length === 0 || list.some((c) => !c)) {
-    issues.push({
-      level: "fatal",
-      message: "roles.support.knowledge_scope.kb_collections 缺失、为空或含空字符串（必填）",
-    });
-  }
-  for (const c of list.filter(Boolean)) {
-    if (path.isAbsolute(c) || c.split(/[\\/]/).includes("..")) {
-      issues.push({ level: "fatal", message: `kb_collections 必须是实例内的相对路径（不含 ..）: ${c}` });
-      continue;
-    }
-    if (!existsSync(path.resolve(configDir, c))) {
-      issues.push({ level: "fatal", message: `kb_collections 目录不存在: ${c}` });
-    }
-  }
-}
-
-/**
- * persona 校验（两项都是 fatal，缺一不可）：
- *   1. `{ file }` 引用的文件必须存在且内容非空——否则 core 会静默跳过该角色，
- *      Agent 拿到的 persona 退化成角色 id 字面量，答疑质量无声崩塌；
- *   2. 内容不得含"放开通用闸门"的措辞。
- */
-function validatePersona(configDir: string, supportRole: Record<string, unknown> | undefined, issues: PreflightIssue[]): void {
-  if (!supportRole) return;
-  const personaField = supportRole.persona;
-  let personaText = "";
-
-  if (typeof personaField === "string") {
-    personaText = personaField.trim();
-    if (!personaText) {
-      issues.push({ level: "fatal", message: "roles.support.persona 为空字符串" });
-      return;
-    }
-  } else if (personaField && typeof personaField === "object" && "file" in personaField) {
-    const fileRel = String((personaField as { file: string }).file ?? "").trim();
-    if (!fileRel) {
-      issues.push({ level: "fatal", message: "roles.support.persona.file 为空" });
-      return;
-    }
-    const abs = path.resolve(configDir, "profile", fileRel);
-    if (!existsSync(abs)) {
-      issues.push({ level: "fatal", message: `roles.support.persona.file 引用的文件不存在: profile/${fileRel}` });
-      return;
-    }
-    personaText = readFileSync(abs, "utf8").trim();
-    if (!personaText) {
-      issues.push({ level: "fatal", message: `roles.support.persona.file 文件内容为空: profile/${fileRel}` });
-      return;
-    }
-  } else {
-    issues.push({ level: "fatal", message: "roles.support.persona 缺失（必填）" });
-    return;
-  }
-
-  if (PERSONA_GATE_RELAXING.test(personaText)) {
-    issues.push({
-      level: "fatal",
-      message: "persona 内容疑似放开通用闸门（只准收紧，不准放开），请修改后重试",
-    });
-  }
-}
-
-/** 集合严格相等比较 */
-function diffSets(actual: string[], expected: readonly string[]): { missing: string[]; extra: string[] } {
-  const a = new Set(actual);
-  const e = new Set(expected);
-  return { missing: expected.filter((v) => !a.has(v)), extra: actual.filter((v) => !e.has(v)) };
-}
-
-function getIn(obj: unknown, ...keys: string[]): unknown {
-  let current = obj;
-  for (const key of keys) {
-    if (!current || typeof current !== "object") return undefined;
-    current = (current as Record<string, unknown>)[key];
-  }
-  return current;
-}
-
-/**
- * on_action policies 闭集校验：键必须 ⊆ SUPPORT_ACTIONS；group 只允许 answer / silent。
- * group 只表达「群里说不说话」（轴1）；Owner 指引由 Runtime 按「action 需要找人 + Owner
- * 可解析」派生（轴2），不存在「通知 Owner」档位。
- */
-function validateOnActionPolicies(groupQaWf: unknown, issues: PreflightIssue[]): void {
-  const onActionStep = getIn(groupQaWf, "steps", "on_action") as Record<string, unknown> | undefined;
-  const policiesRaw = onActionStep?.policies;
-  if (policiesRaw && typeof policiesRaw === "object") {
-    const { extra } = diffSets(Object.keys(policiesRaw), SUPPORT_ACTIONS);
-    if (extra.length > 0) {
-      issues.push({
-        level: "error",
-        workflowId: GROUP_QA_WORKFLOW,
-        message: `on_action.policies 含未知 action [${extra.join(",")}]，合法值: [${SUPPORT_ACTIONS.join(",")}]`,
-      });
-    }
-    for (const [actionName, cfg] of Object.entries(policiesRaw as Record<string, { group?: unknown }>)) {
-      const group = cfg && typeof cfg === "object" ? cfg.group : undefined;
-      if (group === undefined) continue;
-      if (group !== "answer" && group !== "silent") {
-        issues.push({
-          level: "error",
-          workflowId: GROUP_QA_WORKFLOW,
-          message: `on_action.policies.${actionName}.group 只能是 answer / silent（Owner 尾注不在 group 里配，由 Runtime 按 action 与 Owner 解析结果派生），实际: ${JSON.stringify(group)}`,
-        });
-      }
-    }
-  }
-  // 旧 on_silence 步配置仍存在 → 提醒迁移（拍平 action 后该步已改名 on_action）
-  if (getIn(groupQaWf, "steps", "on_silence")) {
-    issues.push({
-      level: "warn",
-      workflowId: GROUP_QA_WORKFLOW,
-      message: "workflows.group-qa.steps.on_silence 已废弃（拍平 action 后步为 on_action）：请迁移为 steps.on_action.policies（track/group）",
-    });
-  }
-}
-
-/** group-qa 单选列 options 与 contract 常量的镜像强校验（双源分家会让路由静默错位） */
-function validateGroupQaFieldOptions(configDir: string, issues: PreflightIssue[]): void {
-  const groupQaFile = path.resolve(configDir, "workflows", GROUP_QA_WORKFLOW, "workflow.yml");
-  if (!existsSync(groupQaFile)) return;
-  try {
-    const wf = (parseYaml(readFileSync(groupQaFile, "utf8")) ?? {}) as Record<string, any>;
-    const defs = Array.isArray(wf?.tracker?.field_definitions) ? wf.tracker.field_definitions : [];
-    for (const [fieldName, expected] of [
-      ["处置动作", SUPPORT_ACTIONS],
-      ["知识沉淀", KB_STATUS_VALUES],
-    ] as const) {
-      const matched = defs.filter((d: any) => d?.name === fieldName);
-      if (matched.length !== 1) {
-        issues.push({
-          level: "error",
-          workflowId: GROUP_QA_WORKFLOW,
-          message: `field_definitions 中「${fieldName}」字段必须恰好 1 个，实际 ${matched.length} 个`,
-        });
-        continue;
-      }
-      const options = Array.isArray(matched[0]?.options) ? matched[0].options.map((o: any) => String(o)) : [];
-      const { missing, extra } = diffSets(options, expected);
-      if (missing.length > 0 || extra.length > 0) {
-        issues.push({
-          level: "error",
-          workflowId: GROUP_QA_WORKFLOW,
-          message: `「${fieldName}」options 与 lib/contract.ts 不一致：缺[${missing.join(",")}] 多[${extra.join(",")}]`,
-        });
-      }
-    }
-  } catch (err) {
-    issues.push({
-      level: "error",
-      workflowId: GROUP_QA_WORKFLOW,
-      message: `workflow.yml 解析失败: ${err instanceof Error ? err.message : String(err)}`,
-    });
-  }
-}
-
-/** admin-kb-update 事件过滤锚点：锚错了知识更新轨道根本不拉单 */
-function validateAdminKbFilter(workflows: Record<string, Record<string, unknown>>, issues: PreflightIssue[]): void {
-  const adminKbWf = workflows[ADMIN_KB_WORKFLOW];
-  if (!adminKbWf) return;
-  const esConfig = getIn(adminKbWf, "event_sources", "管理员更新监听") as Record<string, unknown> | undefined;
-  const filterEquals = typeof esConfig?.filter === "object" && esConfig.filter
-    ? String((esConfig.filter as Record<string, unknown>).equals ?? "")
-    : "";
-  if (filterEquals && filterEquals !== KB_STATUS.READY_TO_PERSIST) {
-    issues.push({
-      level: "error",
-      workflowId: ADMIN_KB_WORKFLOW,
-      message: `事件过滤 filter.equals="${filterEquals}" 必须为 "${KB_STATUS.READY_TO_PERSIST}"（否则知识更新轨道不拉单）`,
-    });
-  }
-}
-
-/** L3 可选能力预检（一律 warn：运行期缺失即优雅关闭，不阻断 L0 主环） */
-function validateOptionalCapabilities(configDir: string, groupQaWf: unknown, issues: PreflightIssue[]): void {
-  const fastpathStep = getIn(groupQaWf, "steps", "fastpath") as Record<string, unknown> | undefined;
-  const fastpathRel = typeof fastpathStep?.rules === "string" ? fastpathStep.rules.trim() : "";
-  if (fastpathRel) {
-    const { issues: fpIssues } = loadReplyRules(configDir, fastpathRel);
-    for (const msg of fpIssues) {
-      issues.push({ level: "warn", workflowId: GROUP_QA_WORKFLOW, message: `fastpath: ${msg}` });
-    }
-  }
-
-  const troubleshootStep = getIn(groupQaWf, "steps", "troubleshoot") as Record<string, unknown> | undefined;
-  const skillsDirRel = typeof troubleshootStep?.skills_dir === "string" ? troubleshootStep.skills_dir.trim() : "";
-  if (skillsDirRel && !isCapabilityEnabled(configDir, skillsDirRel)) {
-    issues.push({
-      level: "warn",
-      workflowId: GROUP_QA_WORKFLOW,
-      message: `troubleshoot: skills_dir 目录不存在，整档将关闭: ${skillsDirRel}`,
-    });
-  }
-  const classifiersRel = typeof troubleshootStep?.classifiers === "string" ? troubleshootStep.classifiers.trim() : "";
-  if (classifiersRel) {
-    const { issues: tsIssues } = loadClassifierRules(configDir, classifiersRel);
-    for (const msg of tsIssues) {
-      issues.push({ level: "warn", workflowId: GROUP_QA_WORKFLOW, message: `troubleshoot: ${msg}` });
-    }
-    // classifier.module 合法性不在此交叉校验：模块闭集来自功能模块人员配置表
-    // （config-sync 运行期快照），拼写不匹配时运行期降级并记 owner_resolution_failed。
-  }
-}
-
-/** core preflight 扩展点约定的导出 */
-export function preflight(configDir: string): PreflightIssue[] {
-  const issues: PreflightIssue[] = [];
-
-  const raw = readRawProfile(configDir, issues);
-  if (!raw) return issues; // profile 读不了，后续校验都无意义
-
-  const roles = (raw.roles ?? {}) as Record<string, Record<string, unknown>>;
-  const workflows = (raw.workflows ?? {}) as Record<string, Record<string, unknown>>;
-  const supportRole = roles.support;
-  const groupQaWf = workflows[GROUP_QA_WORKFLOW];
-
-  const roleName = typeof supportRole?.name === "string" ? supportRole.name.trim() : "";
-  if (!roleName) issues.push({ level: "fatal", message: "roles.support.name 缺失（必填）" });
-  validateCollections(configDir, (supportRole?.knowledge_scope as Record<string, unknown> | undefined)?.kb_collections, issues);
-  validatePersona(configDir, supportRole, issues);
-
-  validateOnActionPolicies(groupQaWf, issues);
-  validateGroupQaFieldOptions(configDir, issues);
-  validateAdminKbFilter(workflows, issues);
-  validateOptionalCapabilities(configDir, groupQaWf, issues);
-
-  return issues;
-}

package/templates/support-qa/lib/profile.ts

@@ -1,51 +0,0 @@
-import type { SupportAction } from "./contract.js";
-
-/**
- * support-qa 处置策略类型 + 默认值（拍平 action 模型）
- *
- * profile v2 后 loadProfile() 已废弃（由 core profile-loader 统一注入 ctx.config）：
- * on-action 步从 ctx.config.policies 读逐 action 覆写（profile.yml 的
- * workflows.group-qa.steps.on_action.policies 段），在 recipe 内与默认值 spread 合并
- * （与 dev 基线 on_silence 的读取方式一致）；本文件仅保留类型与常量。
- * group 合法值由 assemble preflight 闭集校验把关（answer/silent，无 notify_owner）。
- */
-
-/**
- * 群内行为（轴1：只管群里说不说话）：
- * - `answer`：发送回答；
- * - `silent`：群里不说话（留痕与通知字段不受影响）。
- *
- * 是否附 Owner 指引（轴2）**不由本字段控制**，由 Runtime 按
- * 「action 是否需要找人 + Owner 能不能解析出来」派生（见 action-dispatch 的
- * needsOwnerResolution）——两个轴正交，`answer` 也能带 Owner 尾注。
- */
-export type GroupAction = "answer" | "silent";
-
-export type ActionPolicy = {
-  /** 是否建行留痕（tracker materialize） */
-  track: boolean;
-  /** 群里做什么（不用裸字段 silence：group: silent 只表示群内不说话，留痕由 track 单独表达） */
-  group: GroupAction;
-};
-
-/** profile.yml 里 policies 段的原始形状（逐 action 局部覆写） */
-export type ActionPolicyOverrides = Partial<Record<SupportAction, Partial<ActionPolicy>>>;
-
-/** 群内是否说话（轴1 的唯一判定点） */
-export function speaksInGroup(policy: ActionPolicy): boolean {
-  return policy.group !== "silent";
-}
-
-/** Pattern 默认 action 处置（spec §7.1）：可被 policies 逐项覆写（recipe 内 spread 合并） */
-export const DEFAULT_ON_ACTION: Record<SupportAction, ActionPolicy> = {
-  reply: { track: true, group: "answer" },
-  // bug/feature 群内说话；Owner 尾注由 Runtime 派生附加（不在 group 里表达）
-  bug: { track: true, group: "answer" },
-  feature: { track: true, group: "answer" },
-  kb_gap: { track: true, group: "silent" },
-  no_question: { track: false, group: "silent" },
-  human_handled: { track: false, group: "silent" },
-  owner_mentioned: { track: true, group: "silent" },
-  safety: { track: true, group: "silent" },
-  agent_failure: { track: true, group: "silent" },
-};