# Tasks: enterprise-bytes

Plan reference: `docs/superpowers/plans/2026-04-20-utils-migration.md`

## Task 1.1 — OpenSpec + scaffold
- [x] Create `openspec/changes/enterprise-bytes/proposal.md`
- [x] Create `openspec/changes/enterprise-bytes/tasks.md`
- [x] Create package directory `universal/primitives/bytes/` with all config files
- [x] Run `bun install` to register workspace
- [x] Commit: `chore(bytes): scaffold package`

## Task 1.2 — Error class + types
- [x] `src/errors/bytes-error.ts` — BytesError, BYTES_CODES, BytesCode
- [x] `src/errors/index.ts` — barrel
- [x] `src/types/types.ts` — InputFormat, OutputFormat, BytesInput
- [x] `src/types/index.ts` — barrel
- [x] `src/index.ts` — root barrel
- [x] Commit: `feat(bytes): add error class and types`

## Task 1.3 — encoding module (TDD)
- [x] Write tests in `src/encoding/encoding.test.ts` → confirm FAIL
- [x] Implement `src/encoding/encoding.ts`
- [x] Confirm tests PASS
- [x] Create `src/encoding/encoding.schemas.ts`
- [x] Create `src/encoding/encoding.md` (≥200 words, 6 sections)
- [x] Create `src/encoding/index.ts` barrel
- [x] Commit: `feat(bytes): add encoding module (hex/base64/utf8)`

## Task 1.4 — uint8 module (TDD)
- [x] Write tests in `src/uint8/uint8.test.ts` → confirm FAIL
- [x] Implement `src/uint8/uint8.ts`
- [x] Confirm tests PASS
- [x] Create `src/uint8/uint8.schemas.ts`
- [x] Create `src/uint8/uint8.md` (≥200 words, 6 sections)
- [x] Create `src/uint8/index.ts` barrel
- [x] Commit: `feat(bytes): add uint8 module`

## Task 1.5 — uuid module (TDD)
- [x] Write tests in `src/uuid/uuid.test.ts` → confirm FAIL
- [x] Implement `src/uuid/uuid.ts`
- [x] Confirm tests PASS
- [x] Create `src/uuid/uuid.schemas.ts`
- [x] Create `src/uuid/uuid.md` (≥200 words, 6 sections)
- [x] Create `src/uuid/index.ts` barrel
- [x] Commit: `feat(bytes): add uuid module`

## Task 1.6 — Property tests (fast-check)
- [x] Add fast-check tests to encoding.test.ts and uint8.test.ts
- [x] Confirm all PASS
- [x] Commit: `test(bytes): add fast-check property tests`

## Task 1.7 — Benchmarks
- [x] Create `src/__benchmarks__/encoding.bench.ts`
- [x] Run benchmark and capture output
- [x] Commit: `bench(bytes): add encoding benchmarks`

## Task 1.8 — README + docs check
- [x] Create `README.md` at package root
- [x] Run `bun run docs:check --filter=@suaveplan/bytes` — must pass 100%
- [x] Commit: `docs(bytes): add README`

## Task 1.9 — Pre-publish gate + publish
- [x] `bunx turbo lint typecheck test --filter=@suaveplan/bytes` — green
- [x] `bunx turbo test:coverage --filter=@suaveplan/bytes` — 100% all thresholds
- [x] `bun scripts/publish.ts --package @suaveplan/bytes`
- [x] Archive openspec change
- [x] Create `openspec/specs/bytes/spec.md`
- [x] Commit: `release(bytes): v0.0.0 — publish to Verdaccio`