[XDGFX]

Closes #2

What

• Spec and JSON Schema in docs/format/: README.md (versions, checking, editors), drawer.md, printer.md, and drawer-0.2.schema.json / printer-0.2.schema.json.
• One source for the schema. The schemas are TypeBox in src/core/schema.ts, giving the core its types. bun run schema writes the JSON; a test fails if it's stale, and Ajv validates the fixtures against the published JSON as an outside reader would.
• Core check(text) / load(text). It runs YAML, then the format line, then the schema, then the checks a schema can't express:
  • ids resolve: items, zones, holders' holds, and review on / act.aside;
  • ids are unique;
  • poses are valid, and only the first one stacks;
  • things fit inside the walls, edge margin included, and under the drawer's height, stacks included;
  • things don't overlap obstructions or each other, with turned outlines, handles and spouts;
  • holders hold real things, each thing once, in a way the base allows.
• Errors an agent can act on. Each problem has a path such as layout[3].at and a line and column. Union errors are narrowed to the branch the author meant: a holder is judged by its method and an item by box or cylinder, and a bad value gets a list of the values allowed.
• dunnage check prints file:line:col: path: message and exits 1 on any problem. --json gives agents the same as JSON. The CLI also checks that the printer: profile is beside the drawer.
• The format version is separate from the tool's. migrate steps older files up through MIGRATIONS, which is empty because 0.2 is the first published format. Newer files are refused, with versions compared numerically.

Worth knowing

• The check found real bugs in the coffee fixture. Unquoted commas inside flow mappings ({ why: …, left to right. }) had been parsed as extra keys. They're quoted now. Hailey's prototype copy has the same bug.
• Bumps the tool version to 0.2.0, a feature release under AGENTS.md. This is unrelated to the format version.
• Not checked yet, because they depend on holder shapes that don't exist yet (listed in drawer.md):
  • holder floors in the height check;
  • the gap rule;
  • locked holders' shapes;
  • fitting holders to the bed;
  • Gridfinity and pegboard placement.

Tests

bun run typecheck, bun run test (54 passing), bun run build and bun run validate all pass. The built CLI also runs on Node.

🤖 Generated with Claude Code