 FastheiandClaude Opus 4.8
|
efa865cac4
|
fix(launcher/#63): 拉起 agent 注入 git 绑定（GIT_REPO_URL + azkv 凭据）— 修 HM #92
现象（HM #92）：蜂群"需绑定 git 仓库才能使用"，但 agent 实际拿不到仓库。
根因：HM 已在 swarm create 的 resource_grants 下发 git 绑定（resource_type=git +
metadata.repo_url + secret_ref=azkv://），但 swarm 拉起侧只把 grant 用于校验/脱敏/审批，
launcher 从不消费它 → 被拉起 agent 的 env 没有 GIT_REPO_URL/凭据 → 无法 clone。
（agent 侧 agent/main.py + agent/git_operations.py 早已读取这些 env，缺的纯是注入。）
修复（仅 launcher 注入，比照模型 key 的服务端解析路径）：
- 新增 resolve_git_grant(body)：从 resource_grants（含 per-agent）取首个 git grant，
repo_url(metadata) → GIT_REPO_URL（非密文 inline）；secret_ref(azkv) 服务端解析 →
GIT_USERNAME/GIT_PASSWORD。复用 azkv 读取（workload identity；dev/CI 用
HEICODE_SECRET_<name>）。有 repo 无凭据仍注入 GIT_REPO_URL（公有仓可 clone；私有仓
报错，不伪造）。
- plan_launch_specs 增加 git_env 合并；create 路径解析并透传。
- k8s 后端：GIT_PASSWORD 与模型 key 同走 per-swarm Secret 的 secretKeyRef，绝不内联
PodSpec；GIT_REPO_URL/GIT_USERNAME 为非密文 inline。SENSITIVE_ENV_KEYS 统一管控。
- git KV secret 值约定 JSON {"git_username","git_password"}（接受 git_token/token 形式
+ 裸 token），待 HM #92 对齐。
git 凭据不入 create 请求体/回调/日志/argv（_reject_plaintext_secrets 已覆盖
resource_grants）。
文档：runtime-contract §3.3 env 表 + 约束、security-boundary §6 增 git 绑定解析口径。
测试：scripts/test-agent-launcher.py 增 resolve_git_grant/凭据提取/k8s git secret 用例。
影响：仅 agent_swarm（Swarm/Agent + 密钥/secret_ref + 文档）；不改 Manager/客户端/release/
契约状态机/计费/审计字段。HM 侧 binding_id（B 路径）解析另在 HM #92 处理，与本 PR 无关。
验收：
python scripts/test-runtime-contract.py
python scripts/test-contract-freeze.py
REDIS_FAKE=1 python scripts/test-key-injection-contract.py
python scripts/test-security-boundary.py
python scripts/test-agent-launcher.py
python scripts/test-git-workflow.py
python scripts/test-merge-smoke.py
python scripts/test-workflow-e2e.py
（全部通过）
Refs HM #92, Closes #63
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
2026-06-15 12:17:51 +08:00 |
|
|
gongzhiyongandClaude Opus 4.8
|
207e027fbb
|
feat(#56): 补 azkv SECRET_RESOLVER —— 用 Pod workload identity 从 heicode-vault 读模型 key
#56 缺口:`_resolve_secret_ref` 此前只读 dev 环境映射 `HEICODE_SECRET_<name>`,
没有生产从 Azure Key Vault 取 key 的实现(原注释写"适配器在仓外",实际缺)。
本次在仓内补上,走刚建好的 Pod workload identity:
- `_resolve_from_keyvault`:`DefaultAzureCredential` + `SecretClient` 读 azkv:// ref;
**lazy import** azure SDK,任何失败(未启用/不可解析/SDK 缺/无凭证/网络/secret 不存在)
返回 None —— 不伪造、不抛。
- `_azkv_enabled`:**仅当** Pod 注入了 workload identity(`AZURE_FEDERATED_TOKEN_FILE`)
或显式 `SECRET_RESOLVER=azkv` 才真连 KV —— dev/CI/测试保持 hermetic、不碰网络。
- `_parse_azkv_ref`:解析 `azkv://<vault>/secrets/<name>[/<ver>]`(裸名→`https://<name>.vault.azure.net`,
全 host 保留,兼容短形式)。
- `_resolve_secret_ref` 顺序:dev 环境映射 → KV(workload identity),保持既有 dev 行为不变。
- requirements:加 `azure-keyvault-secrets`(lazy import;`azure-identity` 已在)。
测试 `test-agent-launcher.py` 新增:azkv 解析、gating(默认关、两种开关)、disabled→None。
`test-agent-launcher` / `test-key-injection-contract` 全绿。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
2026-06-14 19:17:29 +08:00 |
|
|
Songhaoz666andClaude Opus 4.8
|
af26455a8b
|
agent_launcher：新增一等 kubernetes 后端（每 agent 一 Pod，key 经 Secret 引用不内联）（Refs #16）
回应「我们跑在 k8s pods 上」——此前 launcher 只有 dev 的 subprocess + 通用 command hook，
未把 k8s 作为一等后端，且把 OPENAI_API_KEY 内联进 env（在 k8s 会落 etcd）。本次：
- 新增 AGENT_LAUNCH_BACKEND=kubernetes：每 agent 一个 Pod（build_pod_manifest）——资源
requests/limits、标签 heicode-swarm-id/heicode-user-id（GC/teardown）、restartPolicy OnFailure、
serviceAccountName；非敏感 env 内联，**OPENAI_API_KEY 经 secretKeyRef 引用每-swarm k8s Secret
（build_secret_manifest，via kubectl apply -f - stdin），绝不内联进 PodSpec（不落 etcd/argv）**。
- stop_launched：k8s 按标签 kubectl delete pod,secret；subprocess 仍 terminate。
- config：AGENT_POD_IMAGE/NAMESPACE/SERVICE_ACCOUNT/CPU|MEM_REQUEST|LIMIT；ORCHESTRATOR_URL=
集群内 Service DNS。文档注明前置（kubectl + 最小 RBAC ServiceAccount + NetworkPolicy）与
硬化替代（azkv CSI SecretProviderClass，编排器全程不碰明文）。
文档：runtime-contract §3.3 后端列表加 kubernetes（含密钥/RBAC/Service DNS/CSI）；
security-boundary §6 增 K8s pod 边界（Secret 引用不内联、最小 RBAC、NetworkPolicy、CSI 硬化）。
测试：test-agent-launcher 增 k8s manifest 断言（标签、secretKeyRef 非内联、原文不在 Pod manifest、
资源限额、无 secret 则省略 key）。
影响范围：仅 agent_swarm（launcher + 文档 + 测试）。默认仍 backend=none，CI/e2e 不变。
Refs #16
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
2026-06-11 17:19:35 +08:00 |
|
|
Songhaoz666andClaude Opus 4.8
|
9516b5c696
|
Swarm 负责拉起 agent + 执行限额（team 决议，反转 AM 拉起）（Refs #16）
团队决议：由 Swarm 运行时（非 AM）拉起专家 agent 池并执行每用户限额。
代码：
- orchestrator/agent_launcher.py（新）：plan_launch_specs（纯，按 min(池大小, MAX_AGENTS_PER_USER
−已连) 限额 + 组装每 agent env）、resolve_model_key（override→azkv secret_ref 解析(部署
SecretResolver/dev HEICODE_SECRET_<name>)→OPENAI_API_KEY 兜底，解析不到不伪造）、可插拔后端
launch()（none 默认/subprocess/command 模板，fail-soft）、stop_launched。
- orchestrator/main.py：create 播种后调 launch_swarm_agents（仅去中心化、非 Manager 显式 agent；
从 create x-user-id 取 user_id；key 服务端解析，不入 create 体）；stop_swarm_run 调 stop_launched。
文档：runtime-contract §3.3 由「AM 拉起（提案待确认）」改为「Swarm 拉起 + 限额（已定）」，
更新 env 来源列（key=Swarm 从 secret_ref 解析、AGENT_ID/CAPABILITIES=Swarm launcher、
HEICODE_USER_ID=从 create 透传）+ 后端/限额/解析约束；security-boundary §6 增 Swarm 拉起 +
服务端解析 key（不上 argv/日志）说明。
测试：scripts/test-agent-launcher.py（限额封顶、env 组装、key 解析优先级、command 模板、
none no-op）接入 CI。e2e/contract 回归通过（默认 backend=none，行为不变）。
影响范围：仅 agent_swarm（orchestrator + docs + 测试 + CI）。默认 backend=none 不自动拉起、
向后兼容；密钥仅服务端 env 注入、不入 create 体/回调/日志/argv（满足 §3.1 + security-boundary）。
不改 Manager↔Swarm 契约鉴权/计费账本/审批链。
Refs #16
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
2026-06-11 15:07:23 +08:00 |
|