Skip to content

docs: state that beta1 model routes are user-owned - #439

Merged
barbatdev merged 1 commit into
mainfrom
docs/426-user-owned-model-routes
Nov 13, 2026
Merged

barbatdev merged 1 commit into
mainfrom
docs/426-user-owned-model-routes

Conversation

@barbatdev

Copy link
Copy Markdown
Contributor

Pull Request

Linked Issue

Refs #426

PR Type

  • type:feature Feature
  • type:bug Bug fix
  • type:docs Documentation
  • type:refactor Refactoring
  • type:chore Maintenance
  • type:breaking-change Breaking change

Summary

Cortex users choose their own provider and model. The beta1 matrix did not say so, so verification evidence gathered with one model could be read as certifying it. This states that model routes are user-owned and outside the supported matrix, and that each result records the route it ran with as context only.

Changes

  • docs/verification.md, "Beta1 declared matrix": one bullet on user-owned model routes.

Focused Tests

Claim Test command Observed result Limit State Observed by
The matrix states models are not certified Manual read of the section Bullet present after "Runtime versions" Human reading Verified Agent that made the change
Repository policy tests still pass python3 -m unittest discover -s tests OK Does not check content Verified Agent that made the change

Failed or not done: none.

Runtime Harness

N/A: documentation only.

Rollback

Revert the single commit.

Chain Dependencies / Out of Scope

  • Maintainer decision during beta1 planning. Out of scope: running any verification.

Checklist

  • Linked issue is open and status:approved.
  • Exactly one matching type:* label is applied.
  • Focused tests and runtime harness evidence are recorded.
  • Rollback and out-of-scope boundaries are documented.

@barbatdev barbatdev added the type:docs Documentation label Nov 13, 2026
@barbatdev
barbatdev merged commit 62b0bf9 into main Nov 13, 2026
3 checks passed
@barbatdev
barbatdev deleted the docs/426-user-owned-model-routes branch November 13, 2026 21:58
@barbatdev

Copy link
Copy Markdown
Contributor Author

Post-merge QA (glm)

Documentation-only merge: one bullet added to the beta1 declared matrix in docs/verification.md stating that model routes are user-owned and outside the supported matrix, with each result recording the backend, provider and model as context only. The bullet is present in the diff exactly as described in the PR body, is consistent with the surrounding matrix wording (platforms, runtimes, Pi experimental), and introduces no code, no behavior change, and no contradiction with the linked issue #426 acceptance criteria, which concern the platform/runtime/capability matrix. No defects found.

No findings.

Verdict: clean

@barbatdev

Copy link
Copy Markdown
Contributor Author

Post-merge QA (deepseek)

Lens: evidence + test design. Docs-only change: one bullet in docs/verification.md (line 92) that states model routes are user-owned and outside the beta1 matrix, which is exactly what the PR promised and what a maintainer clarification like #426 needs (it adds a reason-bearing statement instead of a new matrix dimension, so the declared 2x2x12 scope is unchanged). Evidence is proportional for documentation: the only factual claim (the bullet sits after 'Runtime versions') is a manual read any reviewer can repeat, and the python3 -m unittest discover -s tests claim is reproducible. The untested part is the bullet's own second sentence, 'Each result records the backend, provider and model it ran with': the section that actually tells a verifier what to record is 'Reporting results' (line 109), and it still lists only 'backend/version'. Test condition that is missing: a check that the reporting guidance and the matrix bullet name the same result fields.

Suggestion (1)

  • 'Reporting results' does not ask for provider or model, so line 92 promises a record the guidance never requests (docs/verification.md:109): Line 92 asserts that each result records the backend, provider and model it ran with, but 'Reporting results' (line 109) enumerates only 'platform, archive filename and SHA-256, backend/version, QA role, exit status, and bounded redacted output'. A verifier following the reporting section literally produces results with no provider and no model, which is the situation the new bullet says it fixed. The claim and the guidance should name the same fields, or the bullet should say the draft result template does not exist yet.

Verdict: clean

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

Labels

type:docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant