Skip to content

id: F12.7 ABI specification and conformance suite #1064

Closed

Description

@dezren39

F12.7 — ABI specification and conformance suite

From the Phase 12 plan (.opencode/plans/phase-12-platform-flexibility.md, workstream C):

Write down the plaza_* exports and the capability protocol as a versioned specification, add a plaza_abi_version export, and publish a conformance suite built on fixtures from F11.16 (#544) and the recording work (#239).

Exit: the Roc examples pass the suite unchanged. This is also the stepping stone Phase 13 names for F13.1 (already landed, #783).

Coordination (2026-10-26 reprioritization, per Drew): every id roadmap item now has its own GitHub issue, and priority encodes the order: (1) the path to Phase 12 — now + priority/high; (2) Phase 12 itself — next; (3) Phase 13 and long-term ideas — priority/low. The dashboard mirrors this list (org Project "Developing Today" #4, Area id-train; Grist Program roadmap, Area id). If this item turns out to be blocked, wrong, or superseded, park or close it with a note rather than letting it stall the queue — dropping an issue is always allowed; silently stalling is not.

Activity

  1. added
    kind/featureNew feature or capability request
    source/humanFiled directly by a human
    priority/normalOrdinary priority (the default)
    app/idPackage/app: id (pkgs/ or apps/ in this repo)
    on Oct 27, 2026
  2. developing-today commented on Oct 27, 2026

    @developing-today
    Contributor
  3. added
    nextOrg Project gate: queued next — orchestrator adds to the board
    effort/lLarge: multi-day or open-ended; expect staged check-ins
    on Oct 27, 2026
  4. added
    work/assignedQueue worker lifecycle state
    queue/claimedQueue worker lifecycle state
    and removed on Nov 1, 2026
  5. dezren39 commented on Nov 1, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · picked up

    • Agent: queue worker (repo-worker-code), lane F shift
    • Session / ID: queue task 2338 (repo-health-code-pilot)
    • Found via: queue claim
    • Task: Triage id: F12.7 ABI specification and conformance suite #1064 (F12.7 ABI specification + conformance suite) — verify what already exists on current main (spec doc, plaza_abi_version export, conformance suite, prerequisite fixtures), then route: scoped follow-up packet(s), or close with evidence if already done.
    • Expectation: s — done = agent-note verdict + follow-up task(s) enqueued or closure evidence.
  6. dezren39 commented on Nov 1, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · done

    • Agent: queue worker (repo-worker-code), lane F shift
    • Session / ID: queue task 2338 (triage) → follow-up task 4887
    • Found via: queue claim
    • Task: Triage verdict for id: F12.7 ABI specification and conformance suite #1064 (F12.7 ABI specification and conformance suite).
    • Verdict: NOT DONE — genuine work remains, prerequisites landed. Verified against current main (b56ccda5):
      • The ABI surface exists: 13 plaza_* exports in pkgs/id/examples/roc-world/host/src/host.zig (plaza_error_ptr, plaza_error_len, plaza_alloc, plaza_free, plaza_init, plaza_update, plaza_view, plaza_layout, plaza_records, plaza_wants, plaza_snapshot, plaza_restore, plaza_out_len).
      • plaza_abi_version does not exist in code — code search finds it only in .opencode/plans/phase-12-platform-flexibility.md and a 2026-10-18 report.
      • No plaza ABI spec document and no plaza conformance suite exist. The conformance hits under pkgs/id are the F13.1 shell/world contract (shell_contract.rs, world-contract.test.ts, id: Phase 13 F13.1 versioned shell contract (client-server frame spec + conformance check) #783) — a different surface. (mcpx has its own unrelated conformance suite.)
      • Prerequisites have landed: id(world): F11.16 replay self-check (id world verify) #544 is CLOSED (F11.16 replay self-check) and PR feat(id): record world sessions to replayable fixtures #239 MERGED (record world sessions to replayable fixtures; pkgs/id/src/world_fixture.rs exists), so the suite's fixture base is available.
    • Route: F12.7 is effort/l, so this triage routes a scoped first slice instead of the whole item: queue task 4887 (small_fix) = write the versioned ABI spec from the 13 exports + capability protocol as implemented, and add the plaza_abi_version export. Named remainder: the conformance suite itself (built on the id(world): F11.16 replay self-check (id world verify) #544/feat(id): record world sessions to replayable fixtures #239 fixtures; exit = Roc examples pass unchanged) — its packet gets enqueued when 4887 lands, per 4887's acceptance; this issue stays open as the F12.7 tracker until then. F12.8 depends on F12.7 (plan line 44).
  7. 36 remaining items

  8. added
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    status/parkedDeliberately paused with a recorded resume condition
    queue/claimedQueue worker lifecycle state
    and removed
    queue/claimedQueue worker lifecycle state
    status/parkedDeliberately paused with a recorded resume condition
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    on Nov 3, 2026
  9. dezren39 commented on Nov 3, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · picked up

  10. added a commit that references this issue on Nov 3, 2026
  11. dezren39 commented on Nov 3, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

app/idPackage/app: id (pkgs/ or apps/ in this repo)effort/lLarge: multi-day or open-ended; expect staged check-inskind/featureNew feature or capability requestmode/onlineFully doable remotely: design, config, code, cloudnextOrg Project gate: queued next — orchestrator adds to the boardpriority/normalOrdinary priority (the default)source/humanFiled directly by a humantask/triageQueue packet kind: verify, reproduce, and route this item

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions