跳到主要内容

FinClaw Controller State

状态：Active 最后更新：2026-05-15 Controller 类型：产品 / 系统 Program Controller

1. 身份​

FinClaw Controller 负责 FinClaw 在 FinTec AI Ecosystem 中的产品定义、MVP 边界、设计支撑、参考吸收和工程对齐。

2. 负责范围​

  • projects/finclaw/
  • references/finclaw/
  • evaluation/finclaw/
  • source/project-prealignment/finclaw/
  • packets/sync/finclaw-*
  • 与 FinClaw 工程仓库 /Users/mlabs/Programs/fin-claw 的对齐输入

3. 不负责范围​

  • 直接修改 Data Horizon、AI Trading Matrix、RLE、FEFM 的正式事实；
  • 直接修改公共入口，除非本轮明确授权 public-entrypoints；
  • 将 FinClaw 设计支撑文档提升为 official product entry；
  • 直接触发交易、下单、调仓、资金划转或执行系统调用。

4. Authoritative Docs​

4.1 Canonical（产品定义入口）​

  • projects/finclaw/strategic-whitepaper.md
  • projects/finclaw/product-definition.md
  • projects/finclaw/mvp-product-definition.md

4.2 Design Foundation​

  • projects/finclaw/design/foundation/product-object-and-advisor-design.md
  • projects/finclaw/design/foundation/terminology-and-object-naming.md

4.3 V1 Design Control​

  • projects/finclaw/design/v1/v1-design-kickoff-packet.md
  • projects/finclaw/design/v1/v1-prd.md
  • projects/finclaw/design/v1/v1-collaboration-and-task-packet-plan.md

4.4 V1 Design Outputs（Controller reviewed 2026-05-15）​

  • projects/finclaw/design/v1/v1-user-journey-and-interaction-flow.md — pass
  • projects/finclaw/design/v1/v1-product-object-and-schema-design.md — pass
  • projects/finclaw/design/v1/v1-ui-ux-interaction-design.md — pass (deepened §6A/6B)
  • projects/finclaw/design/v1/v1-agent-orchestration-design.md — pass (deepened §10A/10B/10C)
  • projects/finclaw/design/v1/v1-evaluation-initial-plan.md — pass
  • projects/finclaw/design/v1/v1-evaluation-review-and-acceptance-plan.md — pass (deepened §9A)
  • projects/finclaw/design/v1/v1-trial-operations-plan.md — pass

4.5 Evaluation​

  • evaluation/finclaw/README.md

5. 当前状态​

  • Official product entry 保持三份：战略白皮书、产品定义、MVP 产品定义；
  • 设计支撑层已独立承载产品对象、命名、V1 PRD、V1 kickoff 和 task packets；
  • FinClaw 定位为金融链路中的认知环节，非直接执行系统；
  • 工程对齐目标是把现有 /Users/mlabs/Programs/fin-claw 与上位定义、V1 PRD 和设计任务包对齐。
  • R4 doc-IA 审计已完成（2026-05-15）：IA / 命名 / 内容深度审查覆盖 projects/finclaw/、evaluation/finclaw/、references/finclaw/、source/project-prealignment/finclaw/、controllers/finclaw/ 和 FinClaw 相关 packets/sync/。审计产出 packets/sync/finclaw-doc-ia-audit-2026-05-15.md（§1–§16）。
  • V1 Design Packet 7 个初稿已通过 Controller review（2026-05-15）：术语一致、DAG 合规、跨文档一致性验证通过。UI/UX 和 Agent Orchestration 已 deepened。详见 audit §14。
  • Admin 裁定已关闭 OG-1/2/9：前缀规范、finclaw-reviewer 注销、design-output 后缀豁免均已生效。public-entrypoints relink 已由 Admin 完成。
  • 全部 14 个 design/ 文件已补齐 YAML frontmatter（N-10 resolved）。
  • 全部 12 个 OG 已关闭（2026-05-15）：OG-3 closed-for-controller、OG-6 保持分离、OG-7 worklog 路径已修复、OG-8 accepted-by-design、OG-11 三层角色已澄清（references/finclaw/ 补 README）、OG-12 case-schema §7.1 补映射约定。

6. 当前任务队列​

6.1 已完成​

  • 推进 V1 设计任务包与工程实现之间的 gap 对齐 → V1 Design 7 个初稿已通过 Controller review（§14），UI/UX 和 Agent Orchestration 已 deepened（§15）。
  • 向 Labs-FinTecAI Admin 提交公共入口修正请求 → Admin 已完成 public-entrypoints relink（§16.4）。
  • 按 packets/sync/labs-fintecai-finclaw-project-doc-audit-2026-05-14.md 承接 Batch 8C-2 后续 → R4 doc-IA 审计已覆盖全部 FinClaw scope 文档，7 个 V1 design 深度审查通过。
  • 已执行 labs-fintecai-finclaw-canonical-reader-surface-proposal-2026-05-15.md 路径 A + L1：首屏清洗见上文；独立 reader 证据见 evidence/reader-tests/2026-05-15-finclaw-canonical-l1/codex-low-context-l1-report.md（Codex MCP，gpt-5.5）。

6.2 进行中 / 下一步​

  • Engineering-start 6 Phase 工程方案已全部完成（2026-05-15）：
    • Phase 1 数据模型重构 ✅ 2fec1d3 — 33 V1 models + 10 enums，legacy models deprecated
    • Phase 2 编排层重构 ✅ 09e605d — TaskRouter / BoundaryGuard / ObjectWriter 三层独立模块
    • Phase 3 Thread 持久化 ✅ 5b137a2 — CognitionStore（Snapshot 不可覆盖 + Thread 7 态状态机 + Checkpoint）
    • Phase 4 API 层重构 ✅ 4169d3f — /api/v1/cognition Snapshot/Thread/Checkpoint REST endpoints
    • Phase 5 Evaluation Runner ✅ 6ebb9b2 — YAML case loader + 字段级自动检查 + EvaluationStore
    • Phase 6 UI Shell ✅ a07f46a — Web 前端 Snapshots / Threads / Checkpoints 页面
    • 后端 379 tests 全绿 + lint clean，前端 TSC + Vite build green
    • Gate 7/8 端到端集成测试 ✅ e80abd5 — API→CognitionStore round-trip + Thread 全生命周期 + Snapshot 不可覆盖 + 跨对象共存
    • Gate 8/8 Evaluation Runner 实际运行 ✅ e80abd5 — 6 个治理库 YAML case 全部通过 Runner pipeline，结果持久化验证通过
    • Engineering-start gate 条件：8/8 全部满足
  • 将稳定设计结论回写到 FinClaw design support 或 sync。
  • 按 controllers/finclaw/checkpoints/2026-05-13-admin-batch4-pickup.md 继续处理 reference absorption review（deferred OG-11 三层叙事收敛）。
  • 在需要多人多 Agent 执行时形成 open-cowork 输入。
  • Deferred OGs（OG-3/6/7/8/11/12） → 全部 12 个 OG 已关闭，doc-IA audit 完结。

7. Lane 命名规则​

  • mlabs-codex-controller
  • member-m-personal-agent
  • member-e-personal-agent
  • open-cowork-finclaw-batch-<id>

8. 默认验证命令​

DOC_CHANGE_SCOPE=finclaw npm run verify:change-scope
git diff --check
npm run build

若需要公共入口：

DOC_CHANGE_SCOPE=finclaw,public-entrypoints npm run verify:change-scope

9. Recovery Instructions​

新会话恢复为 FinClaw Controller 时：

  1. 读取 controllers/README.md；
  2. 读取 controllers/registry.md；
  3. 读取本文件；
  4. 若属于特定个人域或团队 lane，读取对应 controllers/finclaw/lanes/<lane-id>.md；
  5. 读取最新未吸收 checkpoint；
  6. 不重新扫描整个仓库；
  7. 若需要公共入口变更，向 Labs-FinTecAI Admin 输出短请求。

10. 未吸收 Checkpoints​

  • checkpoints/2026-05-13-admin-batch4-pickup.md：接收 Labs-FinTecAI Admin Batch 4 Controller 分发，记录 FinClaw 后续角色标注、证据吸收和公共入口请求边界。部分已处理（reference absorption review 待续）。

11. 已吸收 Checkpoints / Audit Records​

  • checkpoints/2026-05-13-current-session-recovery.md：superseded by 2026-05-14 checkpoint。
  • checkpoints/2026-05-13-reviewer-session-recovery.md：Admin 注销 finclaw-reviewer 后迁入，已归档。
  • checkpoints/2026-05-14-controller-rewrite-dispatch-pickup.md：Controller rewrite dispatch 接收记录。
  • ../../packets/sync/labs-fintecai-finclaw-project-doc-audit-2026-05-14.md：Batch 8C-2 项目层文档 audit 输入，已被 R4 审计覆盖。
  • ../../packets/sync/finclaw-doc-ia-audit-2026-05-15.md：R4 doc-IA 审计主产出（§1–§16）。记录目录树、文件角色、命名问题、处置建议、V1 design 深度审查、Admin 裁定和 OG 状态表。
  • ../../packets/sync/finclaw-engineering-start-gap-analysis-2026-05-15.md：Engineering-start gap analysis。V1 Design vs 工程仓库 gap 比对，6 phase 工程方案拆解，8 项 gate 条件评估。