架构文档（architecture/）

面向架构与研发。

文档	用途
overview.md	分层、数据流、仓库地图
harness.md	门禁权力矩阵（与代码一一对应）
modules.md	可重生 moduleId 登记
rag.md	RAG：导入 / 嵌入 / 混合检索 / 生成式问答 / Skill 消费 / 工艺模板库
skills.md	外部算法排产 Skill 与中性 DTO / Skill 管理台
desktop.md	桌面/Web 双形态、~/.aps 目录、开发与打包命令
database.md	SQLite 主数据库：schema / world 投影 / 数据包 / 导入 profile
dialog.md	对话入口已下线：Pi 唯一语义入口与工具参数边界
fallback.md	Pi Agent 主入口：封闭参数 schema、只读分析、P0/P2/P3 门禁、审计
auth-tenancy.md	登录闸门、租户隔离、项目成员权限与用户系统适配

本轮跨层边界

fallback_lane._PRIMARY_TOOL_PARAM_SCHEMAS 为已登记工具提供封闭参数契约；_validate_tool_params() 拒绝未知字段、错误类型、非法枚举或范围，未单独登记参数的工具使用 _OPEN_PARAMS_SCHEMA。
analyze_project_deep(..., apply=False) 与 analyze_work_dir(..., apply_sql=False) 只做预览；workflow._stage_pending_adoption() 把 pendingAdoption 冻结为 P2 import.commit 确认卡，批准后才写入。
mesh.resume_goal_after_confirmation() 在审批后恢复 Goal；网关接入失败不阻断确认结果，MeshPanel.tsx 展示 AWAITING_APPROVAL / confirmationIds。
SOP 控制台经 /api/sop/compilable 读取候选，postSopStage(sessionId, assetId) 调 /api/sop/stage，由 compile_sop_by_asset(kb_assets, asset_id) 生成 P2 sop.apply 确认卡。

蓝图全文：../../plan.md（目标态多，落地以本目录 + algorithm/ 为准）