Skip to content

docs: cross-repo handoff brief for consuming meos-api.json artifacts#9

Merged
estebanzimanyi merged 1 commit into
masterfrom
docs/cross-repo-handoff
Jul 7, 2026
Merged

docs: cross-repo handoff brief for consuming meos-api.json artifacts#9
estebanzimanyi merged 1 commit into
masterfrom
docs/cross-repo-handoff

Conversation

@estebanzimanyi

@estebanzimanyi estebanzimanyi commented May 18, 2026

Copy link
Copy Markdown
Member

Adds docs/cross-repo-handoff.md: a guide for downstream generators (PyMEOS, JMEOS, MEOS.NET, MobilityDuck, MobilitySpark, …) on consuming meos-api.json as the single source of truth.

It documents:

  • the artifacts and how to regenerate them (meos-idl.json, meos-coverage.json, meos-portable-parity.json);
  • what each contract contains (portableAliases, the per-function network/wire model, the coverage worklist);
  • what each consumer produces from them, with its acceptance check for bare-name parity;
  • the technical invariants — cbuffer/npoint/pose/rgeo are first-class temporal types, aliases reuse each operator's own backing function, trgeometry naming, and 100% bare-name parity as the bar.

A single reference so each downstream repo's own session knows exactly which meos-api.json artifact to read (portableAliases / meos-coverage worklist / portable-parity / OpenAPI-MCP-server) and the acceptance check for 100% parity. Restates the non-negotiable invariants (cbuffer/npoint/pose/rgeo in scope — no exclusion; trgeometry naming; reuse operator backing; clean no-attribution PRs; one session per repo). Enables closing this session and spinning per-repo sessions cleanly.
@estebanzimanyi estebanzimanyi force-pushed the docs/cross-repo-handoff branch from 02e14a7 to ed5a6c4 Compare July 7, 2026 12:54
@estebanzimanyi estebanzimanyi merged commit 7e442b0 into master Jul 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant