Skip to content

Specify and compile deterministic bounded ABIN and AMAP artifacts #6

Description

@zoeyrose

Outcome

Own portable, language-neutral compiled content specifications and a Rust reference compiler/decoder consumed safely by Go and Rust without native FFI.

Scope and invariants

  • Specify magic/version/feature flags, canonical scalar encoding, string/table/reference identities, sections, limits, alignment, integrity digest, optional compression, and unknown/required-feature behavior.
  • Compile immutable archetype/catalog data (ABIN) and tiled/map/surface/action data (AMAP) deterministically from validated catalog/documents.
  • Keep raw Protobuf serialization out of canonical content hashes; define canonical digest input explicitly.
  • Provide Rust reference decoder plus language-neutral golden/negative fixtures; Go implements an independent bounded loader.
  • Map source spans/IDs into optional debug manifests separate from production payload where size/privacy requires.

Acceptance criteria

  • Same source/revision/toolchain inputs produce byte-identical artifacts across repeated supported builds.
  • Go and Rust consumers pass shared round-trip, boundary, truncation, oversize, duplicate, invalid-reference, unknown-feature, and corruption fixtures.
  • Compiler rejects invalid whole-package state before writing and emits atomically with manifest/checksums.
  • Artifact limits are derived from measured corpus plus explicit headroom and enforced before allocation.
  • Format compatibility/breaking-change policy and version negotiation are documented.

Dependencies and parallelization

Depends on #3/#4 and coordinates with content#11, server loader, editor adapter, and protocol-change review. Compiler and independent Go loader proceed in parallel after spec/fixtures freeze.

Licensing

Toolkit code is MIT. Original past contributions by a person listed in the merged approved MIT provenance-grantor registry in atrinik/atrinik#275 may be copied, migrated, translated, or relicensed under MIT only after a complete, non-shallow Git-history audit, including renames and moves, proves the selected material is that grantor's solely authored original work and contains no embedded third-party or conflicting-licensed material. Record the exact evidence, applicable grantor, and destination. Mixed authored data and fixtures retain their actual licenses.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Fields

    Priority

    None yet

    Effort

    None yet

    Projects

    Status
    Backlog

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions