#AIGC: Label: "1" ContentProducer: 001191440300708461136T1XGW3 ProduceID: 9f2a11add43fbf12a546606fb2b962ab_a9040e79b1b011f18f26525400287e28 ReservedCode1: gqaLfUShhHiQRS1EzJF7Uro7Y1DmWppGM5ptSJMt1Sa/oiiB0agGywKVnF6CVW+FibYYdcMTiKVLgPeIRq6q66IWRCiIpXfQv5PS5MhO8uHoxxiOooFGGDD7q62tfOot4vM7KttnAfTheQyUgyjntzjTzjRJGagyhS9hRcfILiP25jWSud82zEO918g= ContentPropagator: 001191440300708461136T1XGW3 PropagateID: 9f2a11add43fbf12a546606fb2b962ab_a9040e79b1b011f18f26525400287e28 ReservedCode2: gqaLfUShhHiQRS1EzJF7Uro7Y1DmWppGM5ptSJMt1Sa/oiiB0agGywKVnF6CVW+FibYYdcMTiKVLgPeIRq6q66IWRCiIpXfQv5PS5MhO8uHoxxiOooFGGDD7q62tfOot4vM7KttnAfTheQyUgyjntzjTzjRJGagyhS9hRcfILiP25jWSud82zEO918g=

#FIST-Mbt

该项目为 FIST（Python）的 MoonBit 原生重写 + MCP 化，非原代码搬运。

#快速开始

# 依赖解析 & 编译
moon check

# 运行测试（103 项全部通过）
moon test

# 启动 MCP Server（STDIO 传输）
moon run cmd/main

# 启动 HTTP/SSE 桥接（可选）
FIST_MCP_PORT=3000 python scripts/fist-mbt-http.py

#最小调用示例（JSON-RPC over STDIO）

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
  "name":"publish",
  "arguments":{"project_dir":"E:/proj/demo","description":"示例根任务","created_by":"human_steward","now":"2026-09-05T10:00:00Z"},
  "_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}
}}

#MCP 暴露面

#Tools（41 个）

适用范围提示：watchdog_tick（定时任务看门狗编排）推荐仅用于定时任务 / 无人值守自动化场景，不用于人工指挥官任务分配流程（自动 heal / 自动续轮在人工流程中有害）。

配套元提示词模板：templates/cron_pipeline_meta_prompt.md（统一版：单一提示词 + 单一定时任务，一次唤醒内四分支自决策——①有活跃任务且心跳新鲜则退出；②心跳超时只交给 watchdog_tick 的 heal 分支；③无活跃任务且最新提示词未消费则接一个新根任务；④无活跃任务且提示词已消费则生成下一份 yyyyMMdd.HH.mm.ss.md。含按目标项目替换的参数清单、作用域隔离要求与无人值守边界说明）。

#生命周期八件套（九态状态机）

#查询

#深拆与运维

#Omega 验证闭环（M6 金条八）

#Omega 强验证（可选开关，默认关闭）

1. 语料创建：语料创建者 spec_author 调用 omega_spec_create 为本轮任务创建语料，真正持久化写入 specs 表（status = pending）。
2. 语料审核：验证者 verifier 调用 omega_spec_review 审核并质疑语料——approve 放行，其余值视为打回，由语料创建者重做。
3. 执行门禁：语料通过前 execute 被 omega_execute_gate 拒绝；通过后由执行者执行具体任务。
4. 成果复验：执行者完成后，验证者调用 omega_result_verify 复验成果与对应语料是否达标，不达标继续打回重做（verify 前受 omega_verify_gate 约束）。
5. 上限与升级：打回累计达到 max_rounds（默认 3，最大 10）时写入 escalation 记录、返回 escalated=true 并暂停任务转人工裁决，禁止死循环。

角色约束：spec_author 仅可创建语料、verifier 仅可审核与复验，且验证者不得审核自己创建的语料；human_steward 可执行全部环节。 持久化：语料 / 复验 / 升级记录均落 specs 表，跨进程与跨引擎实例可读；Store::clear 会连同语料账本一并清空。

#智能调度与成本（M6 增强）

#执行与交付

#DAG 扩展（依赖图）

#审计与权限（M5 治理）

#多租户命名空间（M5 多库隔离）

#Resources（2）

#Prompts（2）

#架构

FIST-Mbt/
├── .mcp.json            # MCP server 注册（moon run cmd/main）
├── AGENTS.md            # FIST 指挥官模式行为指令
├── README.md            # 本文档
├── USAGE.md             # 实操调用手册
├── cmd/
│   ├── main/            # STDIO MCP server 入口（moon run cmd/main）
│   └── cli/             # CLI 入口（moon run cmd/cli/main）
├── scripts/
│   └── fist-mbt-http.py # HTTP/SSE 桥接（FIST_MCP_PORT=3000）
├── src/
│   ├── core/            # 领域核心实体
│   │   ├── core_task.mbt       # 任务实体 + 九态状态机 + DAG depends_on
│   │   ├── core_role.mbt       # 角色权限矩阵（human_steward/leader/agent）
│   │   └── core_principle.mbt  # 七条金条原则常量
│   ├── store/           # 持久化
│   │   ├── store.mbt           # Store 抽象 + StoreBackend 工厂
│   │   ├── store_sqlite.mbt    # SQLite 实现（内建 DB）
│   │   ├── store_specs.mbt     # specs 表：Omega 语料/复验/升级持久化
│   │   └── multi_store.mbt     # 多库命名空间管理器（内部可变性）
│   ├── engine/          # FistEngine：业务逻辑闭环 + DAG 扩展
│   │   ├── engine.mbt          # publish/plan/claim/execute/submit/verify/archive + reject/retry/pause/resume
│   │   ├── engine_dag_ext.mbt  # critical_path/parallelism/dag_ascii
│   │   ├── decompose.mbt       # 任务拆解计算
│   │   ├── omega_strong.mbt          # Omega 强验证：语料创建/审核/成果复验 + 门禁 + 打回升级
│   │   └── *_test.mbt          # 引擎测试
│   ├── ops/             # 运维与治理
│   │   ├── audit.mbt           # 追加式审计日志 + Role 权限矩阵
│   │   ├── ops_conflicts.mbt   # 冲突检测
│   │   ├── ops_heartbeat.mbt   # 心跳上报
│   │   ├── ops_heal.mbt        # 超时回滚
│   │   ├── ops_cleanup.mbt     # 归档清理
│   │   ├── ops_watchdog.mbt    # 看门狗编排 watchdog_tick（跨进程 heal + 自动续轮）
│   │   └── ops_ts.mbt          # 时间戳工具
│   ├── omega/           # 可解释性子包：spec/gate/check
│   └── server/          # MCP server 装配
│       ├── server.mbt          # 41 个工具注册 + run_server
│       ├── stdio_js.mbt        # JS 后端 STDIO 传输
│       └── stdio_native.mbt    # 原生后端 STDIO 传输
└── moon.mod             # 模块元数据

• 纯 MoonBit 实现，无 Rust / C 包装；MCP 协议层使用 colmugx/mcp（Apache-2.0，协议 2026-07-28）。
• 领域核心（core*/store/engine）与协议层（server）分离，核心为纯逻辑、易单测。
• K 值递归衰减：根任务 depth=3，每拆一层减 1，depth≤1 为原子任务不再拆分。
• plan 需任务处于已领取态（先 claim 再 plan），保证拆分动作归属到具体负责人。
• 多租户：MultiStore 按 ns 路由到独立 SQLite 文件 {data_dir}/{ns}.db，惰性打开。
• 审计：AuditLog 进程内追加式日志，不落库；角色权限矩阵遵循"唯一指挥官/人类主权"原则。

#状态机（九态）

                    ┌─ pause ──┐
                    ▼          │
待领取 ──claim──► 已领取 ──plan──► 拆分中 ──execute──► 执行中
   │                │                                       │
   │                └──────execute───────────────────────────┘
   │                                                        ▼
   │               待验收 ◄── submit ─── 执行中
   │                │    │
   │           verify    reject
   │                │    │
   │                ▼    ▼
   │           已完成   已打回 ──retry──► 执行中
   │                │
   │           archive
   │                │
   │                ▼
   │           已归档 ──delete──► 移除
   │
   └── resume ◄── 已暂停

#测试

moon test   # 93 项测试全部通过

#多租户（命名空间）使用

// 1. 打开命名空间 "project-alpha"
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
  "name":"store_open",
  "arguments":{"namespace":"project-alpha","data_dir":"."},
  "_meta":{...}
}}

// 2. 发布任务到该 namespace
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
  "name":"publish",
  "arguments":{"project_dir":"...","description":"...","namespace":"project-alpha","created_by":"human_steward","now":"2026-09-05T10:00:00Z"},
  "_meta":{...}
}}

// 3. 查看已打开的命名空间
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
  "name":"store_list",
  "arguments":{},
  "_meta":{...}
}}

// 4. 关闭命名空间（不删除物理库文件）
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{
  "name":"store_close",
  "arguments":{"namespace":"project-alpha"},
  "_meta":{...}
}}

#HTTP/SSE 桥接（可选）

FIST_MCP_PORT=3000 python scripts/fist-mbt-http.py

#移植与合规声明

• 来源：FIST（Python），Apache-2.0 许可证。
• 许可证：Apache-2.0。
• 本期范围：用 MoonBit 原生重写核心领域逻辑与状态机，并封装为 MCP Server； 未搬运 Python 原代码，未包含原项目未开源的业务数据。
• 原 Python 项目中的 scheduler / executor / webpanel 等模块不在本期范围内（见 CHANGELOG 演进说明）。

#License