Skip to content

docs(model-ports): proposed draft validation contracts for pending identities (issue #200) - #202

Open
DarthCeltic wants to merge 7 commits into
aifoundry-org:mainfrom
DarthCeltic:propose-model-port-validation-contracts
Open

docs(model-ports): proposed draft validation contracts for pending identities (issue #200)#202
DarthCeltic wants to merge 7 commits into
aifoundry-org:mainfrom
DarthCeltic:propose-model-port-validation-contracts

Conversation

@DarthCeltic

@DarthCeltic DarthCeltic commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Draft validation contracts for 20 model-port identity candidates (see #200). New files only, own subdirectory, not merged into active contracts.

…identities

Stage 1 of docs/MODEL_PORTS_TRACK_PLAN.md needs a reviewed host oracle/
validation contract per new identity before it can be registered --
drafting these to save the review effort of writing 20 from scratch,
not to self-certify anything.

Placed under .github/ci/reference/proposed_model_ports/ (a new
subdirectory, not the active .github/ci/reference/ contracts) so
there's no ambiguity that these are proposals pending maintainer
review, not already-trusted fixtures.

Every field is either verified fact (upstream repo + 40-char pinned
commit, license, the exact GGUF sha256 we downloaded and hashed
locally) or explicitly marked measurement_status: pending_host_or_board_run
with a note explaining why -- no PPL numbers or correctness thresholds
are fabricated. We don't have board access to produce those; a real
host/board run should populate them, not an assumed number.

Covers the same 20 models as issue aifoundry-org#200 plus the follow-up comment.
mpt7b is excluded here too -- same reason as its missing claim file
(mosaicml/mpt-7b returns 401 anonymously, no pinnable revision).
@DarthCeltic
DarthCeltic requested a review from AFOliveira as a code owner July 25, 2026 12:52
@github-actions github-actions Bot added the misc Hackathon work outside the competition tracks label Jul 25, 2026
…nite_3_1b_a400m, phi3_mini, minicpm3_4b

Same draft-only pattern as the original 20 (see PR body). Unlike
those, these 5 carry real measured host-CPU perplexity
(measurement_status: measured_host_cpu_only) instead of a pending
placeholder -- produced this session with a plain CPU-only
(GGML_ET=OFF) llama-perplexity build against the board-pinned
WikiText-2 corpus. ET-SoC1 board perplexity is still not measured;
that requires the maintainer's own trusted workflow.
@AFOliveira

Copy link
Copy Markdown
Member

These proposed contracts need to be tied to the exact qualifying PR/artifact for each execution family, deduplicated against overlapping claims, and backed by reproducible committed oracle outputs/hashes and justified thresholds. Please remove entries whose corresponding port is incomplete or unclaimed. This proposal alone does not grant credit; maintainers must review and promote accepted contracts into the authoritative protected reference/identity ledger.

…nclaimed proposed contracts

Hackathon deadline has passed; this is record-completeness cleanup
only. Per maintainer review, removed bloom560m and pythia410m --
neither has completed hosting or a registered board benchmark, so
their proposed contracts don't correspond to a valid claim yet.
@DarthCeltic

Copy link
Copy Markdown
Contributor Author

Note: this update was made after the official hackathon deadline and is not a hackathon submission or seeking credit — cleaning up for aiNekko's ET-SoC1 card records.

Removed bloom560m and pythia410m — neither has completed hosting or a registered board benchmark, so they don't correspond to a valid claim.

For the remaining 31 proposed contracts here: most of the corresponding model ports now have a real ported_models/<model>/oracle/*.json committed in their own PR (with actual measured PPL/completion data, not the pending_host_or_board_run placeholder these contract files still show) — that oracle file, not this one, is the up-to-date reproducible reference for each model. Didn't rewrite all 31 files individually given this is post-deadline cleanup rather than active submission work; flagging so the correspondence is clear for whoever reviews this next.

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

Labels

misc Hackathon work outside the competition tracks

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants