suaveplan/openspec/archive/2026-05-25-enterprise-emblem-solver/tasks.md

Tasks: enterprise-emblem-solver

Change ID: enterprise-emblem-solver Package: @suaveplan/emblem-solver Target path: packages/media/image/emblem-solver/

0. Pre-flight

• 0.1 git status clean; git worktree list reviewed; worktree synced to EXPECTED_BASE.
• 0.2 Read upstream reference at /mnt/s/web/suaveplan/packages/universal/emblem-solver/.
• 0.3 Read enterprise audit at /mnt/s/web/suaveplan/enterprise/emblem-solver.md.

1. Scaffold

• 1.1 Create packages/media/image/emblem-solver/ and directory tree per design.md.
• 1.2 Write package.json (v 0.1.0, type module, sideEffects false, subpath exports).
• 1.3 Write tsconfig.lib.json extending tsconfig.base.json.
• 1.4 Write vite.config.ts with externalised deps + preserveModules.
• 1.5 Write vitest.config.ts (istanbul, 100% thresholds, forks pool).

2. Types

• 2.1 Write src/types/types.ts — public RGBA/Rect/Island/etc.
• 2.2 Write src/types/types.md.

3. Errors

• 3.1 Write src/errors/errors.ts — defineCodes("EMBLEM_SOLVER", […]) + EmblemSolverError.
• 3.2 Write src/errors/errors.test.ts exercising every code.
• 3.3 Write errors.md + index.ts barrel.

4. Schemas

• 4.1 Write src/schemas/schemas.ts — ConvertOptionsSchema (Zod, strict).
• 4.2 Write src/schemas/schemas.test.ts.
• 4.3 Write schemas.md + index.ts.

5. Helpers

• 5.1 Write src/helpers/helpers.ts.
• 5.2 Write src/helpers/helpers.test.ts.
• 5.3 Write helpers.md + index.ts.

6. Grid analysis

• 6.1 Write src/grid/analyse/analyse.ts.
• 6.2 Write src/grid/analyse/analyse.test.ts.
• 6.3 Write .md + barrels.

7. IO

• 7.1 Write src/io/parse/parse.ts.
• 7.2 Write tests + .md + barrels.

8. Solver kernels

• 8.1 histogram + tests/.md/barrel.
• 8.2 strip + tests/.md/barrel.
• 8.3 greedy + tests/.md/barrel.
• 8.4 ordering + tests/.md/barrel.
• 8.5 layer + tests/.md/barrel.
• 8.6 src/solver/index.ts.

9. Optimizers

• 9.1 merge + tests/.md/barrel.
• 9.2 overlap + tests/.md/barrel.
• 9.3 redundancy + tests/.md/barrel.
• 9.4 src/optimizer/index.ts.

10. SVG + telemetry + fixtures + converter

• 10.1 svg/build + tests/.md/barrel.
• 10.2 telemetry + tests/.md/barrel.
• 10.3 fixtures port.
• 10.4 converter orchestrator.
• 10.5 converter tests (baseline + edges + auto + heuristic + fast-check property).
• 10.6 converter.md.

11. Root barrel + docs

• 11.1 src/index.ts explicit named re-exports.
• 11.2 README.md.

12. Verification

• 12.1 lint green.
• 12.2 typecheck green.
• 12.3 test green.
• 12.4 build green.
• 12.5 coverage 100/100/100/100.

13. Status + manifest

• 13.1 Regenerate MANIFEST.md.
• 13.2 STATUS.md flip + counter adjust.

14. Archive

• 14.1 Fold spec delta into openspec/specs/emblem-solver/spec.md.
• 14.2 Move change folder to openspec/archive/2026-05-25-enterprise-emblem-solver/.