cuioss/ref-toon-format

TOON Format Reference

REFERENCE MODE: Pure reference skill providing TOON (Token-Oriented Object Notation) format specification, usage patterns, and the parser module.

Enforcement

Execution mode: Reference library with parser module; load reference on-demand.

Prohibited actions:

• Do not use TOON for external APIs or configuration files
• Do not bypass toon_parser.py with custom parsing logic

Constraints:

• TOON is only for internal plan-marshall marketplace operations
• Length declarations [N] must match actual row counts
• Field headers {fields} must match all rows
• Import parser via from toon_parser import parse_toon, serialize_toon

Reference

File: knowledge/toon-specification.md

Contents: Core syntax, uniform arrays, nested structures, conversion examples, agent handoff patterns, toon_parser.py usage, known limitations, performance characteristics, best practices.

Parser Module

| Module | Purpose | |--------|---------| | scripts/toon_parser.py | TOON parsing and serialization (parse_toon, serialize_toon, parse_toon_table) |

Known Limitations

• Only 2-space indentation is supported (not tabs or 4-space)
• Percentage values ('95%') are parsed as int (95) — lossy round-trip
• The parser does not validate [N] count against actual rows

Related Skills

• plan-marshall:shared-workflow-helpers — Shared workflow infrastructure (triage helpers, CLI construction, error codes)
• plan-marshall:ref-workflow-architecture — Architecture documentation including workflow skill conventions