core — 执行核心库（窄腰）

发行名 gherkai-core / import 名 gherkai_core（ADR 0037 决策 2a「三名分离」）。

解析 .feature → 分组 scope → 调度 → 收集结果。零引擎依赖：核心不 import Midscene / Nova Act，引擎跑在 worker 子进程里，靠 worker↔core JSON 协议通信。

设计见 ADR：

• 0016 执行架构 / Run 数据模型 / ports
• 0024 worker↔core 协议
• 0025 plan 模块（解析 + scope 分组）
• 0026 schedule 模块（并发调度）
• 0027 RunReport 归集索引
• 0030 实时写接缝 / 0031 job 生命周期态 + severity
• 0034 无状态跑批 core 侧拆分（project 纯归约投影 + reconcile 推进编排 + event_log 持久事件通道）

模块

core/gherkai_core/
├── model.py      ← 领域模型：Job / Scenario / Step / 7 类事件（含 step_skipped 短路）/ 四层结果 RunResult / RunMeta（definition，含 worker_variant·worker_task_defs，ADR 0038）/ Status 七态 / ResourceUri（纯数据）
├── parse.py      ← .feature → 领域模型（借 gherkin-official Compiler；库藏在此 seam 后）
├── scope.py      ← tag 分组 + engine 校验 → Job[]；对外 plan(features, config) -> Job[]
├── serialize.py  ← 领域模型↔dict 的单一序列化真理源（store adapter 复用，ADR 0016/0027）
├── wire.py       ← Job↔JSON 与 0024 事件↔JSON 的线序列化 + 退出码约定 EX_WORKER_NETWORK/raise_for_worker_exit（两 Engine adapter 共用一份，ADR 0024/0028）——worker↔core 协议落地
├── errors.py     ← core 类型化异常：WorkerNetworkError（network_error 重试分类，ADR 0028）/ PlanError（feature 写法与配置违约，parse/scope 共用，ADR 0019/0025）
├── ports.py      ← Engine / WorkerHandle / EngineResolver / Sink / JobSink / RunStore / ResultStore / ReportStore 接口（组合根注入）
├── schedule.py   ← schedule(run_meta, engines, sink, opts, on_job_complete?, on_event?) -> RunResult（同步 run：并发/隔离/超时/优雅停）
├── project.py    ← 无状态跑批纯归约投影（ADR 0034）：project(events)→RunState/JobResult + plan_next(state)→actions + reduce_event（与 schedule 共用一份归约）+ projected_run_status（投影写该落的 run 级 status，两 RunStore adapter 共用）
├── reconcile.py  ← 无状态跑批推进编排（ADR 0034）：tick(run_id, meta, event_log, run_store, launcher, N)——幂等、多触发源、CAS/HWM 条件写；起 job 经注入 Launcher（core 不 import boto3）+ finalize_artifacts(...)（done 后聚合收尾，cloud Lambda/local per-run 两宿主共用）
├── persist.py    ← RunPersistence：编排 Store ports 随进度实时落库（commit-point 写序，ADR 0030）
└── adapters/
    ├── subprocess_engine.py        ← Engine 实装（local）：spawn worker 子进程 + 读事件流
    ├── fargate_engine.py           ← Engine 实装（cloud）：RunTask 起 Fargate 容器（task-def 恒为组合根注入的**显式 revision ARN**、绝不 family 名，ADR 0038）+ job-in 走 S3 / events-out 走 DDB / stop→StopTask + start_scope fire-and-forget（ADR 0024/0032/0034）
    ├── cloud_launcher.py           ← 无状态跑批 cloud Launcher（ADR 0034）：经 resolver 选 FargateEngine 调 start_scope 起 task（fire-and-forget）
    ├── event_log/{sqlite,ddb}.py   ← 无状态跑批持久事件通道（ADR 0034）：local=SQLite / cloud=DDB events 表，reconciler 从此全量重放推演
    ├── _boto.py                    ← 云端 adapter 共享的 boto3 依赖守卫（缺 boto3 友好报错，ADR 0016 窄腰）
    ├── run_store/{local,ddb}.py    ← RunStore：本地文件 + DynamoDB（+ arg_offload.py：StepArgument→S3 指针，解 DDB 400KB 限；+ 无状态跑批条件写 try_claim_job/project_state/try_finalize，ADR 0034；+ STATE 顶层 worker_task_def_arns 供清理 pass 的在跑 run 安全阀，ADR 0038）
    ├── result_store/{local,s3}.py  ← ResultStore：本地文件 + S3（每 job 一对象）
    └── report_store/{local,s3}.py  ← ReportStore：本地文件 + S3（manifest+index）

云端 adapter（DDB/S3）已建，行为对拍 local、moto 全程 mock 单测（ADR 0030 决定六）；boto3 是可选依赖 gherkai-core[aws]（库消费者按需装；CLI 发行包 gherkai 已硬依赖 gherkai-runtime[aws]、装它即带 boto3，ADR 0037 决策 2c）。 组合根按 backend 注入哪套 adapter——cli 已实装 --backend {local,cloud}（装配逻辑在产品本体 runtime/gherkai_runtime/compose.py 的 build_local_stores/build_cloud_stores，cli/Lambda/未来 WebUI 共用；ADR 0016「演进」节/0030 决定七）。

跑测试

uv run pytest          # 仓库根：跑全部 workspace 成员（core/runtime/cli/engines/novaact/deploy_aws）的单测
cd core && uv run pytest   # 只跑 core 的（cwd 决定收集范围）

实际执行（跑 .feature）

core 是库，不自带可执行入口。用 cli/ 这张皮来跑（它是组合根：读 feature、注入引擎 adapter、渲染结果）：

uv run gherkai run features/wikipedia_generic.feature      # 仓库根