61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# Tasks: enterprise-gaming-behavior-tree
|
|
|
|
## 0. Pre-flight (non-negotiable)
|
|
|
|
- [ ] 0.1 Confirm clean working tree (`git status` reports nothing) and no in-flight worktrees with uncommitted work (`git worktree list` then `git status` in each)
|
|
- [ ] 0.2 If any worktrees exist under `.claude/worktrees/`, account for each one: still-active agent, work-pending-merge, or stale-and-prune. Stale worktrees MUST be removed (`git worktree remove`) before opening a new one — code that has been lost twice on main is the failure mode this guards against.
|
|
- [ ] 0.3 Confirm the package set in `MANIFEST.md` matches `find packages -maxdepth 3 -name package.json` count. Drift here means a prior change archived without regenerating the manifest.
|
|
|
|
## Phase 1 — Scaffold
|
|
|
|
- [ ] Create `gaming/ai/behavior-tree/` (`@suaveplan/behavior-tree`, `0.1.0`, `sideEffects: false`)
|
|
- [ ] `tsconfig.json`, `vitest.config.ts`
|
|
|
|
## Phase 2 — Error codes & constants
|
|
|
|
- [ ] `src/error-codes.ts` + `src/constants/index.ts`
|
|
|
|
## Phase 3 — Types
|
|
|
|
- [ ] `src/types/common.ts` + `common.md`
|
|
|
|
## Phase 4 — Blackboard
|
|
|
|
- [ ] `src/core/blackboard/blackboard.ts` — get/set/has/delete/clear/clone
|
|
- [ ] Tests + docs
|
|
|
|
## Phase 5 — Leaf nodes
|
|
|
|
- [ ] `src/core/nodes/leaves.ts` — `action`, `condition`, `wait` with clock
|
|
- [ ] Tests + docs
|
|
|
|
## Phase 6 — Composite nodes
|
|
|
|
- [ ] `src/core/nodes/composites.ts` — `sequence`, `selector`, `parallel` with success/failure policies
|
|
- [ ] Tests + docs
|
|
|
|
## Phase 7 — Decorator nodes
|
|
|
|
- [ ] `src/core/nodes/decorators.ts` — `inverter`, `repeater`, `cooldown`, `timeout`
|
|
- [ ] Tests + docs
|
|
|
|
## Phase 8 — Runner
|
|
|
|
- [ ] `src/core/runner/runner.ts` — tick loop, reset, OTel histogram, lastStatus
|
|
- [ ] Tests + docs
|
|
|
|
## Phase 9 — Fluent builder
|
|
|
|
- [ ] `src/builder/builder.ts` — `bt()` chainable API producing `TreeNode` tree
|
|
- [ ] Tests + docs
|
|
|
|
## Phase 10 — Property tests
|
|
|
|
- [ ] `tests/property.test.ts` — sequence: all-success → SUCCESS; selector: first-success → SUCCESS; parallel policies
|
|
|
|
## Phase 11 — Pre-publish gate
|
|
|
|
- [ ] `bunx turbo lint typecheck test --filter=@suaveplan/behavior-tree` green
|
|
- [ ] 100% coverage
|
|
- [ ] Publish: `bun scripts/publish.ts --package @suaveplan/behavior-tree`
|