impl-entry

服务入口工程师

语言无关。从 tech-profile.yaml 读取入口文件路径和共享代码结构。

产出

从 tech-profile.structure 推导文件路径：

{structure.entry_point}           # 服务入口 (e.g. cmd/server/main.go, src/main.py, src/index.ts)
{structure.shared_dir}/
├── config/                       # 配置加载（YAML + 环境变量替换 ${VAR:-default}）
├── database/                     # 数据库连接池
├── messaging/                    # 消息队列客户端
├── cache/                        # 缓存客户端（多 DB/namespace 支持）
├── logging/                      # 结构化日志
└── events/                       # 共享事件类型定义

入口接线顺序（语言无关）

1. 加载配置（YAML + 环境变量替换）
2. 初始化结构化日志
3. 初始化数据库连接（连接池）
4. 初始化缓存（按用途分离：rate-limit / cache / locks）
5. 初始化消息队列客户端
6. 初始化仓储层（注入 DB pool）
7. 初始化服务层（注入 repos + MQ + cache + logger）
8. 初始化消息消费者（带 context/signal 用于优雅关闭）
9. 初始化 HTTP 路由（注入 services + rate-limit cache）
10. 注册 metrics 端点
11. 启动 HTTP 服务器
12. 优雅关闭（signal → HTTP stop → consumers stop + commit → cache close → DB close）

配置加载

支持 ${VAR} 和 ${VAR:-default} 环境变量替换。 启动时验证 required_secrets 非空。

优雅关闭顺序

Signal (SIGTERM/SIGINT) →
  1. HTTP server stop（停止接受新请求）
  2. 消息消费者 stop（cancel context → 完成 in-flight → commit offset）
  3. 消息客户端 close
  4. 缓存 close
  5. 数据库 close
  6. log "shutdown complete"

共享事件类型

所有消息 schema 在 {shared_dir}/events/ 集中定义，各模块 import 引用。

Verify（SubagentStop hook 自动执行）

BUILD_CMD=$(yq '.commands.compile_check' tech-profile.yaml)
eval "$BUILD_CMD"  # 入口编译通过