# Tasks — enterprise-controller

## 0. Pre-flight (non-negotiable)

- [x] 0.1 Confirm clean working tree and worktree-isolation verified (`pwd` is `.claude/worktrees/agent-…`)
- [x] 0.2 Worktree branch renamed to `feat/controller`
- [x] 0.3 Confirm `STATUS.md` lists `@suaveplan/controller` as `–` (pending migration)

## 1. Spec authoring

- [x] 1.1 Read upstream source at `../suaveplan/packages/universal/controller/src/`
- [x] 1.2 Draft `proposal.md` with Source mapping + deferred Out-of-scope section
- [x] 1.3 Draft `specs/controller/spec.md` with 9 requirements + `**Verified by:**` lines
- [x] 1.4 Confirm no `openspec/specs/controller/` exists yet (forbidden until archive)

## 2. Implementation (Priority 1)

- [ ] 2.1 Scaffold `packages/gaming/games/controller/` with `package.json`, `vite.config.ts`,
      `vitest.config.ts`, `tsconfig.lib.json`, `README.md`
- [ ] 2.2 `src/types/controller.types.ts` + `.md` — `ControllerInput`, `Vector2D`, callback aliases
- [ ] 2.3 `src/schemas/options.schemas.ts` + `.md` — Zod schemas for every options bundle
- [ ] 2.4 `src/errors/controller-error.ts` + `.md` — `defineCodes` + `ControllerError`
- [ ] 2.5 `src/observability/otel.ts` + `.md` — counter + attribute helpers
- [ ] 2.6 `src/event-emitter/event-emitter.ts` + `.md` + `.test.ts`
- [ ] 2.7 `src/base/base-controller.ts` + `.md` + `.test.ts` — Clock-injected, threshold/deadzone
- [ ] 2.8 `src/keyboard/keyboard-controller.ts` + `.md` + `.test.ts`
- [ ] 2.9 `src/gamepad/gamepad-controller.ts` + `.md` + `.test.ts`
- [ ] 2.10 `src/controller-merger/controller-merger.ts` + `.md` + `.test.ts`
- [ ] 2.11 `src/index.ts` — explicit named re-exports per CLAUDE.md rule 10

## 3. Tests

- [ ] 3.1 Every requirement's `**Verified by:**` test exists and passes
- [ ] 3.2 Errors test enumerates `CONTROLLER_CODES` and asserts each is thrown
- [ ] 3.3 OTel test uses real in-memory `MeterProvider` (no `vi.mock`)
- [ ] 3.4 Every `it(...)` has `{ timeout: 5000 }` (30000 for async)
- [ ] 3.5 All test files import runner primitives from `@suaveplan/testing/runner`

## 4. Documentation

- [ ] 4.1 Sibling `.md` ≥200 words for every implementation `.ts`
- [ ] 4.2 `README.md` links every co-located `.md` under `## Modules`
- [ ] 4.3 Update root `CLAUDE.md` to list `@suaveplan/controller` under `### Games (universal-tier)`

## 5. Pre-archive verification (the 5-gate triple)

- [ ] 5.1 `bun run check` — Biome 0/0/0 across monorepo
- [ ] 5.2 `bunx turbo lint typecheck test --filter=@suaveplan/controller` green
- [ ] 5.3 `bunx turbo test:coverage --filter=@suaveplan/controller` 100/100/100/100
- [ ] 5.4 `bun scripts/openspec-conformance.ts @suaveplan/controller` exit 0
- [ ] 5.5 `bunx turbo build --filter=@suaveplan/controller` green

## 6. Pre-archive 7-row checklist

- [ ] 6.1 Generics threaded; no `any`
- [ ] 6.2 Zod schemas wired at every constructor `options` boundary
- [ ] 6.3 Every `CONTROLLER_CODES` entry thrown by a real path
- [ ] 6.4 Strict-mode/destroyed-state behaviour tested both on and off
- [ ] 6.5 OTel asserted with in-memory `MeterProvider`
- [ ] 6.6 `destroy()` dedup tested
- [ ] 6.7 No retroactive ticks

## 7. Archive

- [ ] 7.1 Fold `specs/controller/spec.md` into `openspec/specs/controller/spec.md`
- [ ] 7.2 Move change folder to `openspec/archive/2026-05-24-enterprise-controller/`
- [ ] 7.3 Refresh `MANIFEST.md` via `bun scripts/folder-reorg/generate-manifest.ts`