@archsight/aios 1.0.1 → 1.1.0

package/runtime/README.md

@@ -6,6 +6,9 @@
 
 - [Agent Routing](agent-routing.md)
 - [Skill Routing](skill-routing.md)
+- [Capability Registry](capability-registry.json)
+- [Capability Registry Schema](capability-registry.schema.json)
+- [Capability Adapters](capability-adapters.json)
 - [Hermes 运行线](hermes/)（可选企业适配器）
 - 权限边界
 - 工具调用策略
@@ -20,3 +23,7 @@
 - 运行时 Adapter 只负责入口、调度、权限和回传证据。
 - 项目工作区中的代码、测试、构建和 `.ai/` 上下文始终是工程事实来源。
 - 不得因为启用了某个 Adapter，就把 Hermes、飞书或建筑行业背景写成所有项目的默认事实。
+- Capability 是 Agent 可调用或要求的外部证据接口；Adapter 可以实现 Capability，但不得把未执行的工具结果伪装成已验证事实。
+- 本地 stdio MCP 阶段先使用 Capability Registry 的 `ownerAgents` 和 `allowedSkills` 做权限边界；传统 API Key、mTLS、租户隔离等远程鉴权留给 HTTP / SSE / Gateway Adapter 阶段。
+- `archsight-aios capability:call` 是最小本地调用闭环：校验 Agent / Skill 权限，校验输入 schema，调用 MCP Tool，校验输出证据契约，再给出仲裁 Decision。
+- 多 Agent 冲突时，Runtime 应回传 `Claim / Evidence / Tool Result / Decision`，供治理层按 `governance/arbitration-protocol.md` 仲裁。

package/runtime/agent-routing.md

@@ -26,10 +26,10 @@
 | Atlas | 总架构师 | GPT | 架构设计、技术路线、边界治理、复杂 tradeoff | 不直接大规模写代码 |
 | Mason | 工程总工 | Gemini / GPT | 任务拆解、工程组织、CI/CD、交付计划 | 不越过审查直接发布 |
 | Argus | 代码审查官 | Claude / GPT | Code Review、安全、性能、技术债、Prompt 注入风险 | 不做无关风格挑刺 |
-| Vitruvius | 建筑数字化专家 | GPT / 行业知识模型 | BIM、IFC、规范、审图、行业知识结构化 | 不替代结构计算求解 |
-| Daedalus | AI 研发工程师 | GPT / Codex | RAG、GraphRAG、MCP、Tool Calling、Agent Runtime | 不擅自扩大工具权限 |
-| Hephaestus | 受控执行官 | Codex | 代码修改、脚本执行、自动化测试、文档生成 | 不擅自加功能或重构 |
-| Euclid | 结构力学专家 | GPT / 数值计算模型 | 梁系、桁架、FEM、刚度矩阵、荷载分析 | 不在未验证公式时输出工程结论 |
+| Vitruvius | 建筑数字化专家 | GPT / 行业知识模型 | BIM、IFC、规范、审图、行业知识结构化 | 不替代结构计算求解 |
+| Daedalus | AI 研发工程师 | GPT / Codex | RAG、GraphRAG、MCP、Tool Calling、Agent Runtime | 不擅自扩大工具权限 |
+| Hephaestus | 受控执行官 | Codex | 代码修改、脚本执行、自动化测试、文档生成 | 不擅自加功能或重构 |
+| Euclid | 结构力学专家 | GPT / 数值计算模型 | 梁系、桁架、FEM、刚度矩阵、荷载分析 | 不在未验证公式时输出工程结论 |
 | Athena | 知识治理官 | GPT | 标准治理、版本管理、知识图谱治理、条文差异 | 不直接改运行系统 |
 | Mercury | AI 情报官 | DeepSeek / 搜索增强模型 | AI 情报、GitHub 趋势、MCP 生态、开源分析 | 不把未验证资讯当事实 |
 | Janus | 产品策略官 | GPT / Gemini | MVP、SaaS、用户分层、商业化路径 | 不替代工程验收 |
@@ -48,11 +48,28 @@
 - AI 行业情报和开源趋势先走 Mercury。
 - 产品范围、MVP 和商业化路径先走 Janus。
 - AIOS 是建筑行业增强层；普通非建筑任务不强行套用 BIM、IFC、规范、审图或工程证据链假设，优先使用宿主工具的通用能力。
-- 是否启用行业增强，先看项目 profile、`.ai/project-context.md`、README 和当前任务事实。
-
----
-
-## 四、成本控制
+- 是否启用行业增强，先看项目 profile、`.ai/project-context.md`、README 和当前任务事实。
+
+---
+
+## 四、仲裁与 Capability 证据
+
+Agent 之间的冲突不按“谁的模型更强”裁决，而按 `governance/arbitration-protocol.md` 的证据等级裁决。
+
+证据优先级摘要：
+
+1. 人类硬约束和授权。
+2. 确定性工具返回值，例如测试、构建、schema 校验、安全扫描、规范检查和求解器。
+3. 当前项目事实，例如代码、配置、契约、迁移、部署和 CI。
+4. 结构化知识库，例如规范条文、版本、适用地区、来源页码和质量状态。
+5. 专项 Agent 判断。
+6. LLM 自然语言推理。
+
+Runtime 可通过 `runtime/capability-registry.json` 声明 Capability。Agent 提出阻断或放行结论时，应输出 `Claim / Evidence / Tool Result / Decision`；没有工具实现或证据缺失时，只能标注 `Need verify`。
+
+---
+
+## 五、成本控制
 
 - 简单分类、摘要、文档整理优先低成本模型。
 - 架构、审查、安全、复杂调试使用高能力模型。
@@ -61,7 +78,7 @@
 
 ---
 
-## 五、上下文控制
+## 六、上下文控制
 
 - 每个 Agent 只接收完成任务所需的最小上下文。
 - 不把完整仓库、完整聊天记录或无关文档直接塞给执行型 Agent。
@@ -70,7 +87,7 @@
 
 ---
 
-## 六、升级规则
+## 七、升级规则
 
 需要升级到 Atlas：
 
@@ -86,9 +103,16 @@
 - 涉及依赖升级。
 - 涉及 AI 自动生成大段代码。
 
-需要升级到 Mason：
-
-- 涉及多模块协同。
-- 涉及 CI/CD。
-- 涉及交付顺序。
-- 涉及团队 workflow。
+需要升级到 Mason：
+
+- 涉及多模块协同。
+- 涉及 CI/CD。
+- 涉及交付顺序。
+- 涉及团队 workflow。
+
+需要升级到 Euclid：
+
+- 涉及结构力学建模。
+- 涉及荷载、边界条件、截面参数或 FEM。
+- 涉及结构计算工具链输入输出。
+- 涉及结构计算结果解释，但缺少确定性求解器证据。

package/runtime/archsight-aios.manifest.json

@@ -111,18 +111,25 @@
       "path": "skills/aios-review/SKILL.md",
       "openaiConfigPath": "skills/aios-review/agents/openai.yaml"
     },
-    {
-      "id": "aios-knowledge",
-      "primaryAgent": "vitruvius",
-      "defaultWorkflow": "rag-pipeline",
-      "path": "skills/aios-knowledge/SKILL.md",
-      "openaiConfigPath": "skills/aios-knowledge/agents/openai.yaml"
-    },
-    {
-      "id": "aios-runtime",
-      "primaryAgent": "daedalus",
-      "defaultWorkflow": "rag-pipeline",
-      "path": "skills/aios-runtime/SKILL.md",
+    {
+      "id": "aios-knowledge",
+      "primaryAgent": "vitruvius",
+      "defaultWorkflow": "rag-pipeline",
+      "path": "skills/aios-knowledge/SKILL.md",
+      "openaiConfigPath": "skills/aios-knowledge/agents/openai.yaml"
+    },
+    {
+      "id": "aios-structural",
+      "primaryAgent": "euclid",
+      "defaultWorkflow": "architecture-review",
+      "path": "skills/aios-structural/SKILL.md",
+      "openaiConfigPath": "skills/aios-structural/agents/openai.yaml"
+    },
+    {
+      "id": "aios-runtime",
+      "primaryAgent": "daedalus",
+      "defaultWorkflow": "rag-pipeline",
+      "path": "skills/aios-runtime/SKILL.md",
       "openaiConfigPath": "skills/aios-runtime/agents/openai.yaml"
     },
     {
@@ -212,17 +219,23 @@
       "agent": "hephaestus",
       "workflow": "bug-fixing"
     },
-    {
-      "taskType": "BIM / IFC / 建筑规范 / 审图规则",
-      "skill": "aios-knowledge",
-      "agent": "vitruvius",
-      "workflow": "rag-pipeline"
-    },
-    {
-      "taskType": "建筑行业项目中的 Prompt / Context / Memory / MCP / Tool",
-      "skill": "aios-runtime",
-      "agent": "daedalus",
-      "workflow": "architecture-review"
+    {
+      "taskType": "BIM / IFC / 建筑规范 / 审图规则",
+      "skill": "aios-knowledge",
+      "agent": "vitruvius",
+      "workflow": "rag-pipeline"
+    },
+    {
+      "taskType": "结构力学、荷载、FEM、确定性求解和结构计算工具链",
+      "skill": "aios-structural",
+      "agent": "euclid",
+      "workflow": "architecture-review"
+    },
+    {
+      "taskType": "建筑行业项目中的 Prompt / Context / Memory / MCP / Tool",
+      "skill": "aios-runtime",
+      "agent": "daedalus",
+      "workflow": "architecture-review"
     },
     {
       "taskType": "建筑行业知识库 / 工程知识 RAG / GraphRAG Pipeline",
@@ -287,15 +300,21 @@
     "antigravityLegacySkills": "~/.gemini/antigravity/skills",
     "geminiSupportAssets": "~/.gemini/archsight-aios"
   },
-  "hermes": {
-    "registryPath": "runtime/hermes/agent-registry.md",
-    "syncPolicyPath": "runtime/hermes/sync-policy.md",
-    "syncRecordTemplatePath": "runtime/hermes/sync-record-template.md"
-  },
-  "requiredAssets": [
-    "governance/ai-review-policy.md",
-    "governance/security-policy.md",
-    "governance/agent-boundary.md",
+  "hermes": {
+    "registryPath": "runtime/hermes/agent-registry.md",
+    "syncPolicyPath": "runtime/hermes/sync-policy.md",
+    "syncRecordTemplatePath": "runtime/hermes/sync-record-template.md"
+  },
+  "capabilityRegistry": {
+    "schemaPath": "runtime/capability-registry.schema.json",
+    "registryPath": "runtime/capability-registry.json",
+    "adapterPath": "runtime/capability-adapters.json"
+  },
+  "requiredAssets": [
+    "governance/arbitration-protocol.md",
+    "governance/ai-review-policy.md",
+    "governance/security-policy.md",
+    "governance/agent-boundary.md",
     "governance/context-policy.md",
     "governance/memory-policy.md",
     "governance/delivery-policy.md",
@@ -320,7 +339,10 @@
     "infra/environment-policy.md",
     "infra/permissions.md",
     "infra/service-boundaries.md",
-    "runtime/hermes/sync-policy.md",
-    "runtime/hermes/sync-record-template.md"
-  ]
-}
+    "runtime/hermes/sync-policy.md",
+    "runtime/hermes/sync-record-template.md",
+    "runtime/capability-adapters.json",
+    "runtime/capability-registry.schema.json",
+    "runtime/capability-registry.json"
+  ]
+}

package/runtime/capability-adapters.json

@@ -0,0 +1,27 @@
+{
+  "schema": 1,
+  "description": "ArchSight AIOS 本地 Capability Adapter 映射。当前只声明 stdio MCP 本地调用，不开放网络服务。",
+  "adapters": [
+    {
+      "id": "archsight-solver.local-mcp",
+      "transport": "stdio-mcp",
+      "capabilityIds": [
+        "solver.beam_deflection",
+        "solver.beam_deflection_serviceability_check",
+        "solver.frame_displacement",
+        "solver.truss_member_force"
+      ],
+      "command": "python",
+      "args": ["-m", "backend.capabilities.mcp_server"],
+      "cwdEnv": "ARCHSIGHT_SOLVER_HOME",
+      "defaultSiblingDir": "archsight-solver",
+      "timeoutMs": 30000,
+      "toolNameMap": {
+        "solver.beam_deflection": "beam_deflection",
+        "solver.beam_deflection_serviceability_check": "beam_deflection_serviceability_check",
+        "solver.frame_displacement": "frame_displacement",
+        "solver.truss_member_force": "truss_member_force"
+      }
+    }
+  ]
+}