Egonetics · Runtime & Core Workspace

prvse_world_workspace · Branch: opencode
L0/L1/L2 Runtime, Kernel, CLI & AI dispatch 的工作区。
与 egonetics-opencode（大前端 React SPA）通过 P29 Vite proxy 耦合。

一、一句话定位

这是 Egonetics 系统的运行时躯干——所有 kernel 逻辑、CLI/TUI、AI 路由分发、PRVSE 核心类型和 L2 控制面都在这里。大前端（egonetics-opencode）是 UI 壳；这个是引擎。

两者通过 @prvse/* TypeScript alias 类型级对接（已配），API 级对接待 P29 完成。

二、目录结构

prvse_world_workspace/
├── src/
│   ├── index.ts              包入口，export types + ai-resources
│   ├── types/                类型定义 [ → kernel/cfl/types.ts + ai-resources/types.ts ]
│   │
│   ├── ai-resources/         AI 路由分发层（24 files）【实现度：95%】
│   │   ├── orchestrator.ts   核心 dispatch: role→slot chain→binding→provider runner
│   │   ├── registry.ts       ModelRegistry + ProviderSlots (T0/T1/T2) + ROLE_ROUTES
│   │   ├── runners/          14 个 runner 适配器（Anthropic/OpenAI/Gemini/Claude/Codex/Volcengine等）
│   │   └── usagePerceiver.ts Gemini 状态实时探针
│   │
│   ├── kernel/
│   │   ├── cfl/              CFL 形式类型系统【实现度：100%】
│   │   │   ├── types.ts      PRVSE 全部类型：Pattern/Value/Contract/Patch/State/Constitution等
│   │   │   ├── patch.ts      半格合并代数（mergeTwoPatches, applyPatches）
│   │   │   └── registry.ts   能力注册
│   │   │
│   │   ├── primitives/       基础原语【实现度：100%】
│   │   │   ├── bus.ts        KernelBus pub/sub 事件总线
│   │   │   ├── event-log.ts  SQLite 追加式哈希链事件存储
│   │   │   ├── evaluator.ts  可注册规则的 Evaluator
│   │   │   ├── schemas.ts    运行时校验器
│   │   │   └── redaction-layer.ts  隐私红action
│   │   │
│   │   ├── compiler/         PRVSE Compiler（Scanner→Binder→Checker→Emitter）【实现度：90%】
│   │   │   ├── types.ts      1035 行完整编译类型系统
│   │   │   ├── scanner.ts    原始→PatternToken 分类
│   │   │   ├── binder.ts     MidIR 构造 + 宪法规则绑定
│   │   │   ├── checker.ts    权限/合法性/V-gate 校验
│   │   │   └── emitter.ts    LowIR→Kernel Patches/Effects/EvolutionEvents
│   │   │
│   │   ├── value/            Value 裁判系统【实现度：100%】
│   │   │   ├── evaluator.ts  L0→L1→L2 裁判链聚合
│   │   │   ├── checkers/     L0/L1/L2 三层 checker
│   │   │   └── rewards/      奖励函数注册 + 内建函数
│   │   │
│   │   ├── harness/          Harness Runtime 引擎【实现度：90%】
│   │   │   ├── runtime.ts    born→alive→dead 相位引擎 + strike 计数
│   │   │   ├── turn-loop.ts  主执行循环：dispatch→evaluate→tool→goal check
│   │   │   ├── hook-runner.ts   PreToolUse/PostToolUse 钩子
│   │   │   └── inbox.ts      InboxQueue 推送/列表/解决
│   │   │
│   │   ├── memory/           记忆系统【实现度：85%】
│   │   │   ├── lossless-store.ts  双存储 SQLite+JSONL + 哈希验证
│   │   │   ├── memory-provider.ts  预取/注入/验证
│   │   │   ├── compactor.ts  T0/T1/T2 三级压缩策略
│   │   │   └── pattern-schema.ts  Pattern 7 字段校验
│   │   │
│   │   ├── skills/           Skill 系统【实现度：100%】
│   │   │   ├── skill-registry.ts  注册/解析/列表
│   │   │   ├── skill-runner.ts    执行 + 仲裁 + 证据
│   │   │   └── builtins/     code-review/memory-consolidate/task-decompose/sandbox-test-run
│   │   │
│   │   ├── permissions/      权限与仲裁【实现度：100%】
│   │   │   ├── auto-arbitrator.ts  V-gate 行动评估
│   │   │   ├── deletion-guard.ts  关键/重要内容删除保护
│   │   │   └── content-classifier.ts  关键/重要/临时内容分类
│   │   │
│   │   ├── communication/    外部通信【实现度：100%】
│   │   │   └── external-bridge.ts  MCP transport（stdio/SSE）465 行
│   │   │
│   │   ├── patterns/         Perceptor 模式【实现度：100%】
│   │   │   ├── perceptor.ts      3-strike 超时 watchdog
│   │   │   └── resource-perceptor-cfl.ts  资源快照轮询
│   │   │
│   │   ├── ops/              L1 运维【实现度：100%】
│   │   │   └── l1-handler.ts    从 EventLog 分析中断任务
│   │   │
│   │   ├── adapters/         适配器【实现度：100%】
│   │   │   └── cli.ts        CLI 能力观察 + 指令执行
│   │   │
│   │   ├── e-layer/          Evolution 层【实现度：30% → 大量文件为 stub/partial】
│   │   │   ├── 现有文件（以下均为思辨阶段、未接入运行时）：
│   │   │   │   replay-runner.ts / outcome-diff.ts        ← P15 时间旅行模拟器
│   │   │   │   limit-atlas.ts / limit-gate.ts             ← P16 极限物理引擎
│   │   │   │   semantic-anomaly-detector.ts / anomaly-atlas.ts ← P18 异常专家
│   │   │   │   freshness-scorer.ts / drift-detector.ts    ← P19 遗忘与漂移
│   │   │   │   reference-bank.ts / layered-kl-trainer.ts  ← P20 分层 KL 训练
│   │   │   │   clause-proposer.ts / constitution-versioner.ts ← P21 宪法发现
│   │   │   │   multi-view-processor.ts / reconciliation-strategy.ts / conflict-detector.ts ← P22 多视角调和
│   │   │   │   credit-reranker.ts / model-credit-store.ts ← P17 模型信用市场
│   │   │   │   death-clusterizer.ts / bornfly-preference-graph.ts / trace-curator.ts / domain-splitter.ts / behavioral-anomaly-detector.ts / red-team-runner.ts / sandbox-validator.ts / approval-queue.ts / multi-view-inbox.ts / observer-prior.ts / market-guard.ts / anomaly-types.ts
│   │   │   └── 所有 E 层文件均为思辨产物（P14-P23 理论 PRD），未集成到运行时
│   │   │
│   │   └── experiment/       实验框架【实现度：70%】
│   │       ├── experiment-runner.ts  V-gate 执行循环
│   │       ├── experiment-registry.ts  CRUD + 磁盘持久化
│   │       └── experiment-vgate.ts    代码 diff 模式禁止
│   │
│   ├── cli/                  CLI/TUI（43 files）【实现度：95%】
│   │   ├── index.ts          CLI 入口 + 命令分发器
│   │   ├── boot-sequencer.ts 启动序列编排
│   │   ├── input-loop.ts     交互式输入循环
│   │   ├── control-store.ts  L2 控制面持久化
│   │   ├── commands/         23 个 CLI 子命令
│   │   │   ├── start/status/stop          Runtime 生命周期
│   │   │   ├── inbox/chronicle/audit      L2 数据查看
│   │   │   ├── tool/skill/model/sandbox   L1 能力操作
│   │   │   ├── web/mcp                    L2 网络服务
│   │   │   ├── replay/train/forget/credit/reconcile/anomaly/experiment   E 层命令（壳已建，逻辑待接）
│   │   │   ├── rid/bus-tap/debug-context  R/S 调试
│   │   │   └── memory                     S 记忆操作
│   │   ├── tui/              终端主题 + 类型定义
│   │   └── web/              L2 Product Console HTTP 服务器
│   │       └── app.js        697 行——当前唯一 L2 控制面 UI（待被大前端 RuntimeControlPanel 替代）
│   │
│   └── kernel/phase1.test.ts Phase 1 集成测试
│
├── desktop/                  Electron Desktop 壳【实现度：100%，已合并】
│   └── src/
│       ├── main/index.ts     主进程：左 xterm + 右 webview（P28B）
│       ├── preload/          node-pty IPC bridge
│       └── renderer/         xterm.js 渲染
│
├── harness/                  示例配置
│   └── examples/             resources.example.yaml + constitution.example.yaml
│
├── config/                   环境变量
├── bin/                      入口脚本 bin/egonetics → bun run src/cli/index.ts
├── server/                   遗留 daemon（已废弃，存留仅作历史参考）
├── docs/                     PRD/架构/规格文档
├── daily-tasks/              有日期任务执行记录
├── sessions/                 会话恢复备注
├── knowledge-base/           长期理论/宪法/模式知识
└── chronicle/                项目图谱/模式/关系记录

三、按 PRVSE 层汇总（渐进式）

P 层 — Pattern（信息结构化）

| 文件 | 功能 | 对应 PRD | 代码状态 | |---|---|---|---| | kernel/cfl/types.ts | 完整 Pattern 类型系统（7 字段） | P02 | ✅ 完成 | | kernel/compiler/scanner.ts | 原始信息 → PatternToken 分类 | P04 | ✅ 完成 | | memory/pattern-schema.ts | Pattern 结构校验 + 情感密度检测 | P03 | ✅ 完成 | | kernel/patterns/perceptor.ts | 3-strike 超时 watchdog | P02 | ✅ 完成 | | cli/model-probe.ts | 模型能力探测 | P11 | ✅ 完成 | | cli/intelligence-probe.ts | 智能档位探针 | P11 | ✅ 完成 | | kernel/e-layer/anomaly-types.ts | 异常类型定义 | P18 | ✅ 完成，但未串联 | | kernel/e-layer/behavioral-anomaly-detector.ts | 行为异常检测器 | P18 | ⚠️ stub | | kernel/e-layer/drift-detector.ts | 漂移检测 | P19 | ⚠️ stub | | kernel/e-layer/observer-prior.ts | 观察者先验 | P22 | ⚠️ stub | | kernel/e-layer/semantic-anomaly-detector.ts | 语义异常检测 | P18 | ⚠️ stub |

R 层 — Relation（关系/通信）

| 文件 | 功能 | 对应 PRD | 代码状态 | |---|---|---|---| | ai-resources/orchestrator.ts | 核心 dispatch 路由 | P01 | ✅ 完成 | | ai-resources/registry.ts | ProviderSlots (T0/T1/T2) + ROLE_ROUTES | P01 | ✅ 完成 | | ai-resources/runners/* | 14 个 provider runner | P01 | ✅ 完成 | | kernel/communication/external-bridge.ts | MCP transport | P07 | ✅ 完成 | | kernel/cfl/registry.ts | CFLRegistry 能力注册 | P02 | ✅ 完成 | | kernel/primitives/bus.ts | KernelBus 事件总线 | P07 | ✅ 完成 | | kernel/skills/* | Skill 注册/执行/仲裁 | P05 | ✅ 完成 | | cli/commands/rid.ts | rid 命令 | P25 | ✅ CLI 壳完成，逻辑待接 | | cli/commands/mcp.ts | MCP 命令 | P07 | ✅ CLI 壳完成 | | cli/commands/bus-tap.ts | 总线监听 | P07 | ✅ CLI 壳完成 |

V 层 — Value（价值/裁判）

| 文件 | 功能 | 对应 PRD | 代码状态 | |---|---|---|---| | kernel/value/evaluator.ts | L0→L1→L2 裁判链 | P02 | ✅ 完成 | | kernel/value/checkers/* | 三层 checker | P02 | ✅ 完成 | | kernel/value/rewards/* | 奖励函数注册 | P02 | ✅ 完成 | | kernel/permissions/* | 自动仲裁/删除保护/内容分类 | P06 | ✅ 完成 | | kernel/e-layer/limit-gate.ts | 限制门 | P16 | ⚠️ stub | | kernel/e-layer/market-guard.ts | 市场护闸 | P17 | ⚠️ stub | | kernel/e-layer/conflict-detector.ts | 冲突检测 | P22 | ⚠️ stub | | kernel/e-layer/sandbox-validator.ts | 沙箱验证 | P21 | ⚠️ stub |

S 层 — State（生命周期/存储）

| 文件 | 功能 | 对应 PRD | 代码状态 | |---|---|---|---| | kernel/harness/runtime.ts | born→alive→dead 引擎 | P02 | ✅ 完成 | | kernel/memory/lossless-store.ts | SQLite+JSONL 双存储 | P03 | ✅ 完成 | | kernel/memory/compactor.ts | T0/T1/T2 压缩 | P03 | ✅ 完成 | | kernel/primitives/event-log.ts | 哈希链事件日志 | P02 | ✅ 完成 | | kernel/primitives/replay-event-log.ts | Replay 存储 | P15 | ✅ 完成 | | kernel/harness/inbox.ts | Inbox 队列 | P05 | ✅ 完成 | | cli/control-store.ts | L2 控制面持久化 | P26 | ✅ 完成 | | cli/model-capabilities-store.ts | 模型能力存储 | P11 | ✅ 完成 | | cli/commands/credit.ts | 模型信用存储 | P17 | ✅ CLI 壳完成 | | kernel/e-layer/limit-atlas.ts | 极限图谱 | P16 | ⚠️ stub | | kernel/e-layer/anomaly-atlas.ts | 异常图谱 | P18 | ⚠️ stub | | kernel/e-layer/reference-bank.ts | 参考库 | P20 | ⚠️ stub | | kernel/e-layer/model-credit-store.ts | 模型信用库 | P17 | ⚠️ stub | | kernel/e-layer/bornfly-preference-graph.ts | 偏好图谱 | P20 | ⚠️ stub | | kernel/e-layer/constitution-versioner.ts | 宪法版本管理 | P21 | ⚠️ stub |

E 层 — Evolution（进化/反思）

| 文件 | 功能 | 对应 PRD | 代码状态 | |---|---|---|---| | kernel/harness/turn-loop.ts | 主执行循环 | P02 | ✅ 完成 | | kernel/compiler/index.ts | compile() 管道编排 | P02 | ✅ 完成 | | kernel/compiler/emitter.ts | LowIR→Patches/Effects | P02 | ✅ 完成 | | cli/boot-sequencer.ts | 启动序列 | P24 | ✅ 完成 | | cli/commands/start.ts | start 命令 | P02 | ✅ 完成 | | cli/commands/web.ts | web 命令（L2 Console） | P26 | ✅ 完成 | | desktop/ | Electron Desktop 壳 | P28B | ✅ 完成 | | kernel/experiment/* | 实验框架 | P23 | ✅ 基本完成 | | kernel/e-layer/replay-runner.ts | Replay 执行器 | P15 | ⚠️ stub | | kernel/e-layer/outcome-diff.ts | 结果差分 | P15 | ⚠️ stub | | kernel/e-layer/credit-reranker.ts | 信用重排序 | P17 | ⚠️ stub | | kernel/e-layer/clause-proposer.ts | 宪法条款提案 | P21 | ⚠️ stub | | kernel/e-layer/death-clusterizer.ts | 死亡原因聚类 | P21 | ⚠️ stub | | kernel/e-layer/red-team-runner.ts | 红队测试 | P21 | ⚠️ stub | | kernel/e-layer/trace-curator.ts | 轨迹筛选 | P20 | ⚠️ stub | | kernel/e-layer/domain-splitter.ts | 领域拆分 | P20 | ⚠️ stub | | kernel/e-layer/multi-view-processor.ts | 多视角处理 | P22 | ⚠️ stub | | kernel/e-layer/reconciliation-strategy.ts | 调和策略 | P22 | ⚠️ stub | | kernel/e-layer/approval-queue.ts | 审批队列 | P21 | ⚠️ stub | | kernel/e-layer/multi-view-inbox.ts | 多视角 Inbox | P22 | ⚠️ stub | | cli/commands/replay.ts | replay 命令 | P15 | ✅ CLI 壳完成 | | cli/commands/train.ts | train 命令 | P20 | ✅ CLI 壳完成 | | cli/commands/forget.ts | forget 命令 | P19 | ✅ CLI 壳完成 | | cli/commands/anomaly.ts | anomaly 命令 | P18 | ✅ CLI 壳完成 | | cli/commands/experiment.ts | experiment 命令 | P23 | ✅ CLI 壳完成 | | cli/commands/reconcile.ts | reconcile 命令 | P22 | ✅ CLI 壳完成 |

四、29 个 PRD 对应关系（已实现 vs 待实现）

| 阶段 | PRD | 标题 | 实现度 | 关键代码路径 | |---|---|---|---|---| | Phase 1 ✅ | P01 | Model Provider Integration | 95% | ai-resources/runners/*, orchestrator.ts, registry.ts | | | P02 | PRVSE Architecture | 90% | kernel/cfl/*, kernel/harness/*, kernel/primitives/* | | | P03 | Memory System | 85% | kernel/memory/* | | | P04 | Context Assembly | 80% | kernel/compiler/*, cli/commands/debug-context.ts | | | P05 | Tool + SKILL | 100% | kernel/skills/*, cli/commands/tool.ts | | | P10 | Three-Thoughts Review | 100% | 宪法级 SOP，无代码 | | | P11 | Model Capability Assessment | 100% | cli/model-probe.ts, cli/intelligence-probe.ts | | | P12 | UI/UX (TUI) | 90% | cli/tui/*, cli/commands/audit.ts | | Phase 2 ⏳ | P06 | Permission + Sandbox | 20% | kernel/permissions/*（仲裁完成，沙箱待实现） | | | P07 | Communication System | 60% | kernel/communication/*（KernelBus/MCP 完成，JSON-RPC 待实现） | | | P08 | Integration Test | 10% | kernel/phase1.test.ts（需大幅扩展） | | | P09 | Cloud Storage | 0% | 未开始 | | E 层 ⚠️ | P13 | Multimodal L1 Module | 0% | 未开始 | | | P14-P23 | Evolution Layer（14 PRDs） | 30% | kernel/e-layer/*（大量 stub，已建 CLI 壳） | | 当前活跃 🔥 | P24 | CLI TUI Impl Spec | 70% | cli/web/app.js（待升级） | | | P25 | Living Relation Layer | 5% | cli/commands/rid.ts（CLI 壳新建，逻辑待实现） | | | P26 | L2 Control Surface | 60% | cli/control-store.ts, cli/web/*, cli/commands/web.ts | | | P27 | Resource Management | 40% | cli/resources-v2-schema.ts, migrate-resources-v1-to-v2.ts | | | P28A | L2 Product Console MVP | 50% | 当前 P0——P25/26/27 收敛于此 | | | P28B | Merge Desktop Shell | 100% | desktop/ 已合并 | | | P28 | L2 Isolation Refactor | 5% | 已暂停，10K 行重构延期 | | | P29 | Frontend-Runtime Integration | 0% | 当前 P0——本 README 即为此 PRD 准备 |

五、关键状态摘要

实现完整度：        █████████░░░░░░░░░░░░  ~42%（按代码量）
Phase 1 完成度：    ████████████████████░  ~95%
Phase 2 完成度：    ██░░░░░░░░░░░░░░░░░░  ~12%
E 层实现度：         ███░░░░░░░░░░░░░░░░░  ~30%（CLI 壳已建，逻辑 stub）
当前活跃 (P28A)：   █████░░░░░░░░░░░░░░░  ~50%
P29 桌面集成：       ░░░░░░░░░░░░░░░░░░░░  ~0%

核心矛盾：

• Phase 1 代码骨架完整，但 E 层（进化/反思/训练）停留在思辨阶段——P14-P23 有 22+ 个 stub 文件
• P25/P26/P27 三份理论 PRD 正在向 P28A 收敛，但 P28A 的 MVP 还没有明确完成线
• P29 要求大前端理解这个 workspace 的全部能力——当前 README 就是这个使命

六、给新 LLM 的引导（P29 场景）

当接到 P29 任务时，你需要知道：

1. 这个 workspace 是 Runtime 侧，egonetics-opencode 是 UI 侧。两者各自独立，P29 搭桥
2. desktop/src/main/index.ts 是 Electron 壳入口，负责启动双后端 + 打开 webview
3. src/cli/web/app.js（697 行）是当前 L2 控制面 UI，P29 要用 React RuntimeControlPanel 替代它
4. src/cli/control-store.ts 是 L2 控制面状态源——Goals/Constitution/Resources 的 CRUD
5. src/cli/commands/web.ts 是 :7171 HTTP 服务器的 CLI 入口
6. 所有 kernel/e-layer/ 的 stub 文件不要碰——它们是 P14-P23 的理论产物，当前聚焦 P28A
7. 现有 ai-resources/ 是 Egonetics 的核心引擎，API 路由需要 Vite proxy 映射到 :3000 前端

开发规则（摘要）

• AGENTS.md 和 INDEX.md 存完整规则
• Node.js ≥ 22.5（node:sqlite DatabaseSync）
• 所有数据结构必须支持完整 CRUD
• L0 不能 import L1/L2；L1 不能 import L2；V 独立
• 变更走 opencode 分支 → PR 审阅；git rebase 同步 origin/main