Creatidy/scarcity-router
5
0
Fork 0
Code Issues 13 Pull requests Projects Releases Packages Wiki Activity Actions

M1: Freeze normalized capacity contract v1 #2

Merged
creatidy merged 1 commit from m1-capacity-contract-v1 into main 2026-09-02 11:36:56 +00:00
Conversation 0 Commits 1 Files changed 4 +311 -127
creatidy commented 2026-09-02 09:16:10 +00:00 (Migrated from github.com)
Copy link

Closes #1

Summary

  • Freeze the internal v1 normalized capacity snapshot contract for independent OpenAI/Codex and Z.ai adapters.
  • Define six provider statuses, canonical UTC timestamps, unordered quota windows, validated percentage pairs, safe metadata/diagnostics and honest Ollama local runtime facts.
  • Resolve U-002 and keep freshness/refresh policy for U-003 and scarcity/selection for M2.

Important choices

  • used_percent is normalized only after provider orientation validation; remaining_percent is derived as its exact complement, or both fields are omitted.
  • Unknown resource/period semantics remain as explicit windows; provider raw identifiers are limited to an opaque allowlisted window ID.
  • Account identifiers, raw responses, provider epoch units, Codex primary/secondary, Z.ai orientation fields and fake local quota are excluded.
  • The contract is internal M1 serialization, not REST/MCP/CLI versioning.

Verification

  • git diff --check
  • README documentation targets verified
  • Internal links in the changed contract verified
  • Required OpenAI, Z.ai, schema drift, authentication, Ollama and missing-versus-zero scenarios reviewed in docs/capacity-model.md
  • No executable test suite or production code exists in this documentation-only change
Closes #1 ## Summary - Freeze the internal v1 normalized capacity snapshot contract for independent OpenAI/Codex and Z.ai adapters. - Define six provider statuses, canonical UTC timestamps, unordered quota windows, validated percentage pairs, safe metadata/diagnostics and honest Ollama local runtime facts. - Resolve U-002 and keep freshness/refresh policy for U-003 and scarcity/selection for M2. ## Important choices - `used_percent` is normalized only after provider orientation validation; `remaining_percent` is derived as its exact complement, or both fields are omitted. - Unknown resource/period semantics remain as explicit windows; provider raw identifiers are limited to an opaque allowlisted window ID. - Account identifiers, raw responses, provider epoch units, Codex `primary`/`secondary`, Z.ai orientation fields and fake local quota are excluded. - The contract is internal M1 serialization, not REST/MCP/CLI versioning. ## Verification - `git diff --check` - README documentation targets verified - Internal links in the changed contract verified - Required OpenAI, Z.ai, schema drift, authentication, Ollama and missing-versus-zero scenarios reviewed in `docs/capacity-model.md` - No executable test suite or production code exists in this documentation-only change
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
accessibility
Barrier affecting people with disabilities

  
bug
Something isn't working

  
documentation
Improvements or additions to documentation

  
duplicate
This issue or pull request already exists

  
enhancement
New feature or request

  
good first issue
Good for newcomers

  
help wanted
Extra attention is needed

  
invalid
This doesn't seem right

  
P1
Owner-declared highest explicit implementation priority (loop ordering rank)

  
P2
Required product and integration work

  
P3
Deferred or producer-dependent work

  
question
Further information is requested

  
wontfix
This will not be worked on

No labels
accessibility
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
P1
P2
P3
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Creatidy/scarcity-router!2
No description provided.