OpenCode-GraphAgent AGENTS.md

• To regenerate the JavaScript SDK, run ./packages/sdk/js/script/build.ts.
• The default branch in this repo is main.

Git Workflow (铁律)

feat/**, fix/** ──PR(Typecheck + Unit Tests 门禁)──▶ dev ──push 触发全量测试──▶
    dev ──手动 release-fork──▶ prerelease 测试版
    dev ──PR(全量测试门禁)──▶ main ──手动 release-fork──▶ 正式版

分层门禁：dev 是快速集成层（Typecheck + Unit Tests (linux)；E2E 不阻塞），main 是正式质量门禁（Typecheck + 全量 Unit Tests + E2E）。所有改动通过 PR 流转，禁止直推 main 和 dev（由 GitHub Rulesets 强制）。

Branch	直推	PR 门禁	CI 触发	Purpose
{type}/**	✅ 允许	—	push 不触发；PR 触发目标分支门禁	开发分支，频繁变更
dev	❌ 禁止	PR 必须通过 Typecheck + Unit Tests (linux)	✅ push 触发 Typecheck + 全量测试	快速集成层
main	❌ 禁止	PR 必须通过 Typecheck + Unit Tests + E2E (linux + windows) + SpecGit Acceptance	✅ push 触发全量	正式质量门禁 + 发版

流程：

1. 从 main 切出 feat/** 或 fix/** 分支开发
2. PR → dev（Typecheck + Unit Tests (linux) 门禁，快速合并）
3. push 到 dev 自动触发全量测试验证
4. 从 dev 手动 release-fork → 产出 prerelease 测试版
5. PR dev → main（全量测试门禁：Typecheck + Unit Tests + E2E）
6. 合并到 main 后手动 release-fork → 产出正式版

Rulesets（GitHub Settings → Rules → Rulesets）：

• protect-main：禁止直推/删除/force-push；PR 需通过 5 项检查（Typecheck、Unit Tests (linux)、E2E Tests (linux)、E2E Tests (windows)、SpecGit Acceptance）
• protect-dev：禁止直推/删除/force-push；PR 需通过 Typecheck
• branch-naming：只允许创建 feat/**、fix/**、chore/**、docs/**、refactor/**、test/**、release/**、hotfix/** 前缀的新分支

CI 配置：

• ci-typecheck.yml：push 到 main/dev + PR → main/dev 时触发；除 lint + typecheck 外还跑 test:dag-core DAG 核心行为/覆盖率门禁（10min 超时）
• ci-test.yml：push 到 main/dev + PR → main/dev 时触发全量测试（cancel-in-progress: false 保证跑完）；Linux unit-tests job 额外校验生成物新鲜度（packages/client 与 packages/sdk/js 的 check:generated）并跑 HttpAPI 契约门禁（test:httpapi:ci）
• specgit-accept.yml：仅 PR → main 时触发；安装 pinned [email protected]，等 spec_git/policy.yaml required_checks 全部到终态后运行 specgit finish --json 产出 SpecGit Acceptance 裁决
• release-fork.yml：手动 workflow_dispatch 是唯一真实构建路径（push 到 main/dev 仅注册不构建）；从 dev 发布自动产出 X.Y.Z-dev.N prerelease，从 main 发布 X.Y.Z 并标 Latest