railwise-ai 1.2.32 → 1.2.34

package/agent-pack/assets/lib/os_api.ts

@@ -0,0 +1,100 @@
+type QueryValue = string | number | boolean | null | undefined
+export type Obj = Record<string, unknown>
+
+type CallOptions = {
+  method?: "GET" | "POST" | "PUT" | "DELETE"
+  query?: Record<string, QueryValue>
+  body?: unknown
+  timeoutMs?: number
+}
+
+export class OsApiError extends Error {
+  status: number
+  details: unknown
+
+  constructor(message: string, status: number, details: unknown) {
+    super(message)
+    this.name = "OsApiError"
+    this.status = status
+    this.details = details
+  }
+}
+
+export function obj(value: unknown) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null
+  return value as Obj
+}
+
+export function list(value: unknown) {
+  if (!Array.isArray(value)) return []
+  return value.map(obj).filter((item): item is Obj => Boolean(item))
+}
+
+export function text(value: unknown) {
+  if (value === undefined || value === null) return ""
+  return String(value)
+}
+
+export function first(item: Obj | null | undefined, keys: string[]) {
+  return text(keys.map((key) => item?.[key]).find((value) => value !== undefined && value !== null && value !== ""))
+}
+
+export function num(value: unknown) {
+  return Number(value || 0)
+}
+
+function baseUrl() {
+  return (process.env.RAILWISE_OS_API_BASE || "http://railwise-os-api:3001/api/v1").replace(/\/+$/, "")
+}
+
+function appendQuery(url: URL, query: Record<string, QueryValue> = {}) {
+  for (const [key, value] of Object.entries(query)) {
+    if (value === undefined || value === null || value === "") continue
+    url.searchParams.set(key, String(value))
+  }
+}
+
+async function parseResponse(res: Response) {
+  const text = await res.text()
+  if (!text) return null
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { raw: text }
+  }
+}
+
+export async function callOsApi(path: string, options: CallOptions = {}) {
+  const url = new URL(`${baseUrl()}${path.startsWith("/") ? path : `/${path}`}`)
+  appendQuery(url, options.query)
+
+  const token = process.env.RAILWISE_OS_INTERNAL_TOKEN || ""
+  const headers: Record<string, string> = { Accept: "application/json" }
+  if (token) headers["X-Railwise-Internal-Token"] = token
+  if (options.body !== undefined) headers["Content-Type"] = "application/json"
+
+  const res = await fetch(url, {
+    method: options.method || (options.body === undefined ? "GET" : "POST"),
+    headers,
+    body: options.body === undefined ? undefined : JSON.stringify(options.body),
+    signal: AbortSignal.timeout(options.timeoutMs || 60_000),
+  })
+  const payload = await parseResponse(res)
+  const data = obj(payload)
+  const code = typeof data?.code === "number" ? data.code : res.status
+
+  if (!res.ok || (data && typeof data.code === "number" && data.code !== 200)) {
+    throw new OsApiError(first(data, ["message"]) || `OS API request failed: ${url.pathname}`, code, payload)
+  }
+
+  return data?.data ?? payload
+}
+
+export function prettyJson(value: unknown) {
+  return JSON.stringify(value, null, 2)
+}
+
+export function clipText(value: unknown, maxChars = 8000) {
+  const text = typeof value === "string" ? value : prettyJson(value)
+  return text.length > maxChars ? `${text.slice(0, maxChars)}\n...[truncated]` : text
+}

package/agent-pack/assets/skill/adjustment-report/SKILL.md

@@ -0,0 +1,88 @@
+# 内业平差报告 Skill
+
+## 适用对象
+
+- `inhouse_project`
+- `inhouse_result`
+- 通用 `project` 中已绑定内业平差项目的对象
+
+不适用于重新计算正式平差值，也不替代算法引擎、人工复核和成果签认。
+
+## OS Native 输入
+
+优先读取：
+
+1. `input/locked-facts.json`
+2. `input/locked-adjustment-facts.json`
+3. `input/context-pack.json`
+4. `input/inhouse-adjustment-context.json`
+5. `input/capability-blueprint.json`
+
+原始观测、已知点、导线/水准/GPS 记录、确定性检查结果、平差成果、限差、异常点、写回预检都必须来自 locked 文件。
+
+## 数据源优先级
+
+1. OS 内业项目、已知点、原始观测记录。
+2. 算法引擎已产生的 `ih_results`、`ih_check_reports`。
+3. OS 写回预检、快照和审计记录。
+4. 用户补充的返工说明或复核重点。
+
+## 追问策略
+
+缺成果类型时询问：导线、水准、GPS、控制网、全部。
+
+缺报告目的时询问：成果解释、检查报告、返工建议、写回复核。
+
+存在超限但缺现场说明时询问：补充观测记录、补充现场原因、先生成待复核说明。
+
+## 输出 JSON Schema
+
+```json
+{
+  "summary": "string",
+  "resultExplanation": ["string"],
+  "qualityNotes": [
+    {
+      "item": "string",
+      "status": "passed|warning|failed|unknown",
+      "sourceRefs": ["string"],
+      "suggestion": "string"
+    }
+  ],
+  "reworkItems": [
+    {
+      "priority": "high|medium|low",
+      "action": "string",
+      "sourceRefs": ["string"]
+    }
+  ],
+  "missingInputs": ["string"]
+}
+```
+
+## 禁止事项
+
+- 不得重新计算或修改平差成果、闭合差、限差、坐标或高程。
+- 不得把算法未通过的成果写成合格。
+- 不得删除异常点或淡化返工要求。
+- 不得输出没有来源引用的正式技术结论。
+
+## 报告模板
+
+```markdown
+## 内业成果概况
+
+## 输入资料和计算结果
+
+## 限差与质量检查
+
+## 异常点和返工建议
+
+## 写回 OS 前复核意见
+```
+
+## 示例
+
+输入：`inhouse.check.report.generate`，locked facts 有 12 个已知点、1 个平差成果、1 份检查报告。
+
+输出：检查报告草稿引用 locked facts 中的成果 ID 和检查报告 ID，不生成新坐标。

package/agent-pack/assets/skill/approval-flow-intelligence/SKILL.md

@@ -0,0 +1,123 @@
+# 办公审批 AI Native Skill
+
+## 适用对象
+
+- `approval_flow`
+- `approval_instance`
+- `workflow`
+
+用于办公审批台、我的待办、审批详情页中的 AI Native 摘要、附件检查和卡点解释。
+
+## 不适用对象
+
+- 不适用于替代审批人作出通过、驳回、付款或盖章决定。
+- 不适用于经营指标分析、合同条款专业法律审查、发票真伪判定或财务入账结论。
+- 不适用于未进入 RAILWISE-OS 审批 locked facts 的聊天记录、口头意见或外部文件。
+- 不适用于输出员工绩效、态度或责任归因评价。
+
+## OS Native 输入
+
+运行时必须优先读取：
+
+- `input/object-ref.json`
+- `input/actor-context.json`
+- `input/permission-scope.json`
+- `input/context-pack.json`
+- `input/locked-facts.json`
+- `input/capability-blueprint.json`
+- `input/approval-flow-context.json`
+- `input/locked-approval-facts.json`
+- `input/approval-flow-blueprint.json`
+- `input/skill-context.md`
+
+审批标题、类型、状态、当前审批人、金额、表单数据、附件和流转日志均以 locked facts 为准。
+
+## 数据源优先级
+
+1. RAILWISE-OS `locked-approval-facts.json`。
+2. RAILWISE-OS `locked-facts.json`。
+3. 用户在引导面板选择的审批类型、时间范围、输出深度。
+4. 不允许从聊天上下文猜测审批状态或附件。
+
+## locked 数据边界
+
+- AI 不得修改审批状态、审批人、金额、附件列表、日志和流程节点。
+- AI 可以解释卡点、总结流转、列出附件缺口、给出补件或催办建议。
+- 附件缺失必须引用 `attachmentGaps` 或对应 workflow sourceRef。
+
+## 追问策略
+
+当信息不足时，优先追问选择题：
+
+- 范围：我的待办 / 我发起的 / 全公司可见审批。
+- 类型：报销 / 采购 / 发票 / 合同盖章 / 付款。
+- 输出：流转摘要 / 附件核查 / 卡点解释。
+- 动作：提醒审批人 / 补充附件 / 退回修改 / 继续等待。
+
+## 输出 JSON Schema
+
+写入 `output/result.json`：
+
+```json
+{
+  "result": {
+    "summary": "string",
+    "findings": ["string"],
+    "risks": [
+      {
+        "title": "string",
+        "severity": "low|medium|high",
+        "sourceRefs": ["string"]
+      }
+    ],
+    "recommendedActions": ["string"],
+    "missingInputs": ["string"]
+  }
+}
+```
+
+同时写入 `output/summary.md`。
+
+## 禁止事项
+
+- 禁止代替审批人做通过或驳回决定。
+- 禁止编造审批意见、附件和流转日志。
+- 禁止输出未授权审批的申请人、金额或附件信息。
+- 禁止把 AI 卡点解释写成正式审计结论。
+
+## 模板
+
+### 附件缺口
+
+- 审批：`{title}`。
+- 类型：`{workflowType}`。
+- 缺失：`{missing}`。
+- 建议：`{repairAction}`。
+- 来源：`{sourceRef}`。
+
+### 卡点解释
+
+- 当前节点：`{currentApprover}`。
+- 已停留：`{duration}`。
+- 可能原因：`{reason}`。
+- 下一步：`{nextAction}`。
+
+## 示例
+
+```json
+{
+  "result": {
+    "summary": "本次锁定 18 条审批记录，其中 4 条仍在流转。",
+    "findings": ["材料采购审批存在 1 条附件缺口。"],
+    "risks": [
+      {
+        "title": "采购审批缺少报价附件",
+        "severity": "medium",
+        "sourceRefs": ["workflow_instances.wf-1001.data.attachments"]
+      }
+    ],
+    "recommendedActions": ["由申请人补充报价单后再提醒当前审批人。"],
+    "missingInputs": []
+  }
+}
+```

package/agent-pack/assets/skill/bidding-knowledge/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: bidding-knowledge
+description: 工程监测招投标专业知识库。当编制投标文件、分析招标文件或进行商务报价时加载此技能，获取评分要素、报价策略和资质要求指引。
+---
+
+## 适用场景
+
+- 编制工程监测投标技术标和商务标
+- 采集招标公告/招标文件情报，判断是否值得跟进
+- 分析招标文件评分细则，制定投标策略
+- 审核投标文件完整性和合规性
+- 项目报价测算与成本分析
+
+## 投标文件标准结构
+
+### 技术标核心章节
+
+| 序号 | 章节 | 评分权重（典型） | 编制要点 |
+|-----|------|----------------|---------|
+| 1 | 项目理解与分析 | 10~15分 | 体现对项目特点、重难点的深入理解，切忌泛泛而谈 |
+| 2 | 监测方案 | 25~35分 | 测点布设图、仪器选型、监测频率、数据处理方案 |
+| 3 | 质量保证措施 | 10~15分 | ISO体系、三级校核制度、数据复核流程 |
+| 4 | 安全文明施工 | 5~10分 | 安全教育、应急预案、文明施工措施 |
+| 5 | 工期保证 | 5~10分 | 人员及设备投入计划、关键节点时间表 |
+| 6 | 项目业绩 | 10~15分 | 类似工程合同+完工证明，优先选择地铁/基坑类 |
+| 7 | 人员配置 | 10~15分 | 项目负责人资质（注册测绘师）、技术骨干经验 |
+| 8 | 应急预案 | 5~10分 | 超限应急响应流程、24小时值班制度 |
+
+### 商务标核心要素
+
+| 要素 | 说明 |
+|-----|------|
+| 报价构成 | 人工费 + 仪器折旧/租赁费 + 交通差旅费 + 管理费 + 利润 + 税金 |
+| 报价策略 | 基准价浮动法：以成本估算为基础，根据竞争态势调整下浮率 |
+| 不平衡报价 | 前期投入项（基准点埋设、方案编制）可适当提高单价，后期常规监测按次计费 |
+| 资质要求 | 工程测量甲级/乙级、测绘资质、ISO认证、安全生产许可证 |
+
+## 投标常见扣分项（避坑清单）
+
+1. **未响应招标文件的特殊要求**（如指定精度等级、特定仪器品牌）
+2. **监测方案缺少测点布设图**（评审专家最关注的直观材料）
+3. **人员资质证书过期或与投标项目无关**
+4. **业绩证明缺少合同关键页**（合同首页+签字页+金额页+完工证明）
+5. **报价明显低于成本价**（可能被判定为低于成本价投标而废标）
+6. **未单独编制应急预案章节**（部分招标文件明确要求独立章节）
+7. **投标文件页码、目录与正文不对应**
+
+## 工程监测常用费用参考
+
+| 监测项目 | 单次费用参考（元） | 计费方式 |
+|---------|-----------------|---------|
+| 精密水准（沉降） | 15~30/点·次 | 按点按次 |
+| 全站仪（水平位移） | 20~40/点·次 | 按点按次 |
+| 测斜仪（深层位移） | 30~60/孔·次 | 按孔按次 |
+| 地下水位 | 10~20/孔·次 | 按孔按次 |
+| 裂缝监测 | 10~15/处·次 | 按处按次 |
+| 基准点埋设 | 500~2000/个 | 一次性 |
+| 监测方案编制 | 5000~20000/项 | 一次性 |
+| 月报/总报编制 | 2000~8000/份 | 按份 |
+
+## 评标专家关注重点
+
+1. **方案针对性**：是否针对本项目特点定制，而非模板套用
+2. **测点布设合理性**：点位密度是否满足规范，关键部位是否加密
+3. **仪器选型匹配度**：精度等级是否满足监测要求
+4. **团队实力**：项目负责人是否有同类项目经验
+5. **应急能力**：是否有完善的应急预案和快速响应机制
+6. **报价合理性**：不追求最低价，而是性价比和工作量覆盖度
+
+## 投标情报预审表
+
+收到招标公告、链接或招标文件摘录时，先输出下表，再进入正式投标文件编制：
+
+| 字段 | 判定方法 |
+|---|---|
+| 项目匹配度 | 对比公司地铁保护区、基坑、控制测量、自动化监测业绩 |
+| 资质差距 | 核查测绘/勘察资质、人员证书、ISO、安全生产等要求 |
+| 业绩匹配 | 标注可用业绩、缺失业绩和证明材料缺口 |
+| 技术重难点 | 判断保护区距离、施工工况、自动化投入、专家评审风险 |
+| 商务风险 | 付款节点、保证金、履约保证、低价风险、工期压缩 |
+| 建议动作 | 跟进、谨慎跟进、补资料后判断、放弃 |
+
+无法从资料中核验的信息必须写“待核验”，不得补写公告没有给出的预算、评分办法或截止时间。
+
+## 结算对账核验
+
+催款前先做对账：
+
+| 核验项 | 说明 |
+|---|---|
+| 合同金额 | 合同总价、暂定价、单价合同或补充协议 |
+| 已确认产值 | 监测期数、报告数量、工作量签认单 |
+| 已开票金额 | 发票号、开票日期、税率 |
+| 已收款金额 | 银行流水或甲方付款记录 |
+| 应收余额 | 按付款节点计算，不只按合同总价减已收 |
+| 差额原因 | 未开票、已开票未付、付款条件未触发、扣款、口径不一致 |
+
+金额不一致时优先输出《结算对账说明》或《对账确认函》，不要直接生成强硬催款函。

package/agent-pack/assets/skill/bun-file-io/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: bun-file-io
+description: Use this when you are working on file operations like reading, writing, scanning, or deleting files. It summarizes the preferred file APIs and patterns used in this repo. It also notes when to use filesystem helpers for directories.
+---
+
+## Use this when
+
+- Editing file I/O or scans in `packages/railwise`
+- Handling directory operations or external tools
+
+## Bun file APIs (from Bun docs)
+
+- `Bun.file(path)` is lazy; call `text`, `json`, `stream`, `arrayBuffer`, `bytes`, `exists` to read.
+- Metadata: `file.size`, `file.type`, `file.name`.
+- `Bun.write(dest, input)` writes strings, buffers, Blobs, Responses, or files.
+- `Bun.file(...).delete()` deletes a file.
+- `file.writer()` returns a FileSink for incremental writes.
+- `Bun.Glob` + `Array.fromAsync(glob.scan({ cwd, absolute, onlyFiles, dot }))` for scans.
+- Use `Bun.which` to find a binary, then `Bun.spawn` to run it.
+- `Bun.readableStreamToText/Bytes/JSON` for stream output.
+
+## When to use node:fs
+
+- Use `node:fs/promises` for directories (`mkdir`, `readdir`, recursive operations).
+
+## Repo patterns
+
+- Prefer Bun APIs over Node `fs` for file access.
+- Check `Bun.file(...).exists()` before reading.
+- For binary/large files use `arrayBuffer()` and MIME checks via `file.type`.
+- Use `Bun.Glob` + `Array.fromAsync` for scans.
+- Decode tool stderr with `Bun.readableStreamToText`.
+- For large writes, use `Bun.write(Bun.file(path), text)`.
+
+NOTE: Bun.file(...).exists() will return `false` if the value is a directory.
+Use Filesystem.exists(...) instead if path can be file or directory
+
+## Quick checklist
+
+- Use Bun APIs first.
+- Use `path.join`/`path.resolve` for paths.
+- Prefer promise `.catch(...)` over `try/catch` when possible.

package/agent-pack/assets/skill/business-finance/SKILL.md

@@ -0,0 +1,91 @@
+# 商务业财 AI Native Skill
+
+## 适用对象
+
+- `contract`
+- `receivable`
+- `invoice`
+- `quotation`
+- `tender`
+- 与合同、回款、发票、报价、投标相关的 `project`
+
+不适用于公司级经营指标总览；经营趋势和管理简报使用 `business-operations-analytics`。
+
+## OS Native 输入
+
+优先读取：
+
+1. `input/locked-facts.json`
+2. `input/locked-finance-facts.json`
+3. `input/context-pack.json`
+4. `input/business-finance-context.json`
+5. `input/capability-blueprint.json`
+
+合同、回款、发票、附件、报价、投标节点和操作日志必须来自 locked 文件。AI 只做条款抽取、风险解释、附件缺口、待办建议。
+
+## 数据源优先级
+
+1. RAILWISE-OS 合同、回款、发票、报价、投标记录。
+2. OS 附件元数据和飞书附件同步结果。
+3. 财务操作日志、合同转化记录、报价明细。
+4. 用户补充的合同原文或审查重点。
+
+## 追问策略
+
+缺业务对象时询问：合同、应收、发票、报价、投标。
+
+缺审查目的时询问：条款风险、回款风险、附件缺口、报价异常、投标资料缺项。
+
+缺附件时询问：等待飞书同步、上传附件、仅生成缺口清单。
+
+## 输出 JSON Schema
+
+```json
+{
+  "summary": "string",
+  "riskItems": [
+    {
+      "risk": "string",
+      "level": "info|yellow|orange|red",
+      "sourceRefs": ["string"],
+      "ownerAction": "string"
+    }
+  ],
+  "missingAttachments": [
+    {
+      "entityType": "contract|invoice|tender|quotation",
+      "entityId": "string",
+      "missing": ["string"]
+    }
+  ],
+  "recommendedActions": ["string"],
+  "openQuestions": ["string"]
+}
+```
+
+## 禁止事项
+
+- 不得自由编造合同条款、付款节点、发票金额或附件状态。
+- 不得绕过权限输出未授权客户、部门或合同明细。
+- 不得给出法律结论，只能提示商务风险和需人工确认事项。
+- 不得把待签合同当成正式合同金额。
+
+## 报告模板
+
+```markdown
+## 商务业财审查摘要
+
+## 锁定数据范围
+
+## 风险和缺口
+
+## 建议动作
+
+## 待确认问题
+```
+
+## 示例
+
+输入：`finance.invoice.attachment.check`，locked facts 中某发票无附件。
+
+输出：列出缺失附件和对应发票 ID，不生成不存在的附件链接。

package/agent-pack/assets/skill/business-operations-analytics/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: business-operations-analytics
+description: "RAILWISE-OS 经营数据问答、经营简报、指标诊断和项目经营健康检查专项 skill。"
+---
+
+# Business Operations Analytics Skill
+
+用于 RAILWISE-OS AI Native 经营数据能力。默认由 RAILWISE-CLI 在 OS 已准备好的 workspace 中调用。
+
+## 适用对象和不适用对象
+
+适用于：
+
+- `company`
+- `department`
+- `project`
+- `contract`
+- `receivable`
+- `invoice`
+- `dashboard_metric`
+
+不适用于合同条款逐条法律审查、发票附件逐项核查、投标资料缺口扫描；这些使用 `business-finance`。
+
+## OS Native 输入
+
+当工作区存在以下文件时，必须优先使用 OS 已锁定数据：
+
+- `input/context-pack.json`
+- `input/locked-facts.json`
+- `input/capability-blueprint.json`
+- `input/business-metrics-context.json`
+- `input/locked-metric-result.json`
+- `input/business-brief-blueprint.json`
+
+## 数据源优先级
+
+1. RAILWISE-OS 已锁定经营指标和 `locked-metric-result.json`。
+2. 合同、回款、发票、项目台账和 KPI 目标。
+3. 用户选择的时间范围、部门、项目、指标和对比方式。
+4. 缺数据时输出 `missingData`，不得补写不存在的金额。
+
+## 核心原则
+
+1. **OS 数据为准。** 合同额、回款、发票、逾期、项目数、时间范围和权限裁剪均以 `locked-metric-result.json` 为准。
+2. **AI 不改数。** 不得自行重算、补写或猜测 locked facts 中不存在的金额、项目数量、部门明细。
+3. **解释和建议是 AI 的职责。** 可以输出经营摘要、关键发现、风险解释、建议动作、追问问题和缺失数据。
+4. **权限优先。** 不得绕过 `permissionScope` 输出未授权部门、项目、员工或合同明细。
+5. **不做财务最终裁定。** 风险判断是管理建议，正式数据仍以 OS、财务复核和人工验收为准。
+
+## 指标口径
+
+- `contract.amount.signed`：统计周期内签约合同额。
+- `contract.amount.active`：在执行合同额。
+- `collection.amount.received`：统计周期内已回款金额。
+- `collection.amount.due`：合同未收金额。
+- `collection.amount.overdue`：合同到期且未结清的逾期应收。
+- `invoice.amount.issued`：统计周期内已开票金额。
+- `invoice.amount.pending`：估算待开票金额。
+- `project.count.active`：在执行项目数。
+- `project.delivery.risk_count`：交付风险项目数。
+- `cashflow.risk_project_count`：现金流风险项目数。
+
+## 追问策略
+
+如果用户要求不清晰，优先给 2-4 个选择，而不是让用户写长 prompt：
+
+- 时间范围：本月 / 本季度 / 今年截至今天 / 自定义。
+- 经营范围：全公司 / 我的部门 / 指定部门 / 指定项目。
+- 指标范围：合同额 / 回款 / 开票 / 经营健康 / 全部。
+- 对比方式：同比去年 / 环比上月 / 对比目标 / 不对比。
+
+## 输出 JSON Schema 与要求
+
+必须写入 `output/business-insight.json`：
+
+```json
+{
+  "insight": {
+    "executiveSummary": "string",
+    "keyFindings": ["string"],
+    "riskInterpretation": ["string"],
+    "recommendedActions": ["string"],
+    "followUpQuestions": ["string"],
+    "missingData": ["string"]
+  }
+}
+```
+
+同时可以用中文概述：
+
+- 先说结论。
+- 再说关键数字，但数字必须来自 locked facts。
+- 最后给可执行建议。
+
+## 禁止事项
+
+- 不得输出 locked facts 中没有的金额或项目数量。
+- 不得说“利润”“成本”“毛利”等 OS 未锁定的指标，除非 locked facts 明确提供。
+- 不得绕过权限解释其他部门明细。
+- 不得把建议写成财务确认结论。
+
+## 报告 / 摘要模板
+
+```markdown
+## 经营数据摘要
+
+## 锁定指标和统计口径
+
+## 风险解释
+
+## 建议动作
+
+## 待补数据
+```
+
+## 示例输入输出
+
+输入：`company.metrics.query`，周期为今年截至今天，locked facts 有签约合同额、已回款、已开票、逾期应收。
+
+输出：管理摘要中的所有金额均来自 `locked-metric-result.json`，并把缺失同比基准写入 `missingData`。