Commit Graph

134 Commits

Author SHA1 Message Date
iomgaa 58061c7536 feat: add AIMD adaptive concurrency pacing per source
P6 round 2 showed routing convergence turns account-level 429s into
the binding constraint (62% throttle rate at full concurrency). Each
source now carries a local AIMD limit: multiplicative cut on 429,
additive growth on success. Over-limit picks queue via the existing
quota-wait poll instead of burning retry budget or tripping the
circuit-open verdict.
2026-07-21 10:38:48 -04:00
iomgaa 910857fd13 docs: sync env template, migration notes and architecture for M2.5 2026-07-21 10:00:11 -04:00
iomgaa 8e2673487a docs: revise M2.5 plan per independent review 2026-07-21 08:41:17 -04:00
iomgaa 3542917ba8 docs: register M2.5 plan in wiki graph 2026-07-21 08:30:36 -04:00
iomgaa f92124fb8c docs: add M2.5 resilience implementation plan 2026-07-21 08:30:33 -04:00
iomgaa f621508117 docs: add M2.5 resilience design with review revisions 2026-07-21 08:26:43 -04:00
iomgaa 1a8931613a docs: correct P6 finding per verifier review 2026-07-21 07:42:54 -04:00
iomgaa 8c178a249c docs: record P6 soak baseline and scoreboard artifact fixes 2026-07-21 07:22:34 -04:00
iomgaa 3f7a0ecebb docs: mark M2 milestone complete in roadmap 2026-07-21 03:46:33 -04:00
iomgaa 326dd24dd1 fix: address M2 verifier findings in soak harness 2026-07-21 02:05:49 -04:00
iomgaa 724dc3c328 docs: backfill env template and migration notes for M2 2026-07-21 01:28:33 -04:00
iomgaa f9677fbd8e docs: revise M2 plan per independent plan review 2026-07-21 00:13:12 -04:00
iomgaa b1778fd278 docs: add M2 distributed implementation plan 2026-07-20 23:47:40 -04:00
iomgaa b165c2aae6 docs: finalize M2 design after human approval gate 2026-07-20 23:41:20 -04:00
iomgaa dfd9dcfee4 docs: revise M2 design per independent review findings 2026-07-20 23:17:24 -04:00
iomgaa 8aaf8f200b docs: add M2 distributed design and record Q3 embedding decision 2026-07-20 23:01:29 -04:00
iomgaa e101d82400 docs: record completed soak corpus pull and redis isolation rules 2026-07-20 22:37:00 -04:00
iomgaa 2e9e2b7c36 docs: add M2 soak-test scenario matrix and data manifest
Records the human decision to test against the real gateway with real
data instead of building a mock gateway, six execution scenarios with
fault-source mixing, hard invariants scored from our own telemetry,
and the corpus inventory pulled from the lab server.
2026-07-20 22:27:47 -04:00
iomgaa 7163005edf docs: mark M1 milestone complete in roadmap 2026-07-20 22:04:00 -04:00
iomgaa 0b8460b6d5 fix: address independent verification findings
Classify empty completions as transient per human ruling (fixes flaky
real-gateway smoke and prevents caching empty responses), rename the
factory injection parameter gate to breaker per the frozen design,
rewrite the probe-entry cleanup without except BaseException, declare
python-dotenv explicitly, add a mid-backoff cancellation test, and
record all implementation errata in the design and architecture docs.
2026-07-20 22:01:26 -04:00
iomgaa 0be111d64c docs: register llm_calls telemetry schema in wiki 2026-07-20 07:12:27 -04:00
iomgaa b568b61a34 docs: pin register_provider as pure function per plan review
Also note that the seven architecture amendments predate the plan,
tighten T12 to independent implementation layers, and add fallback
guidance for read-only reference protocol imports.
2026-07-20 06:26:46 -04:00
iomgaa f5623166a6 chore: register M1 plan entity in research wiki 2026-07-20 06:19:38 -04:00
iomgaa 8b64274add docs: add M1 implementation plan with fifteen verifiable tasks 2026-07-20 06:18:08 -04:00
iomgaa 2fb968b851 docs: apply seven M1-design feedback amendments to architecture
Correct the section 6.1 reason enum against actual CHS code, make
retry_after_s a non-optional float, add structured_data to LLMResponse
extensions, finalize the structured parameter type, document SSE
missing-done semantics and watchdog thinking-token liveness, add the
StructuredMW layer to the default onion order, and register
middleware/structured.py in the module map.
2026-07-20 06:12:52 -04:00
iomgaa 0e271f2b06 chore: initialize research wiki graph and register M1 design entity 2026-07-20 05:56:27 -04:00
iomgaa 2daeb4ae36 docs: revise M1 design per independent review findings
Fix Decision/Update field freeze (retry_after_s in seconds, source_name
included), freeze the 18 telemetry fields with model_name->model rename,
add thinking-token watchdog liveness semantics (CHS R1), add client
lifecycle/from_settings/gather_bounded/shared-backend injection
signatures, and register two more ARCHITECTURE feedback amendments.
2026-07-20 05:54:12 -04:00
iomgaa 6442461201 docs: add M1 core milestone design with frozen public signatures 2026-07-20 05:41:24 -04:00
iomgaa 034605c2b4 docs: move full multi-source behavior into M1 scope
Per 2026-07-20 human decisions: multi-source switching/cooldown ships
with M1 (retry-loop signatures freeze there), both GovDoc and
Video-Tree must pass the M1 onboarding smoke test, and Redis
integration tests use the lab's remote Redis with isolated namespaces.
2026-07-20 05:26:58 -04:00
iomgaa 48f82404ee docs: add D14 structured-output ladder decision
Define the five-step ladder (native-schema prevention, repair, shape
validation, bounded feedback re-ask, ResultInvalidError) as D14;
rewrite section 7.9 accordingly, give the structured parameter its
three-tier semantics in the chat() signature, and scope the bounded
re-ask outside transport retry and breaker counting.
2026-07-20 04:00:07 -04:00
iomgaa 07e772f522 docs: amend architecture per migration reverse constraints
Resolve 13 gaps flagged by the three migration documents: finalize
chat() signature with per-call cache namespace/salt, fix middleware
onion ordering (per-attempt source-scoped admission inside retry
loop), structured AllSourcesExhausted fields, est_tokens in
SourceConfig, per-scope resilience config keys, probe lease TTL,
settle/release idempotency, shared limiter/breaker backend semantics,
multimodal digest in telemetry, OCR trust_env and health check, API
stability rules, and correct the Q3 embedding claim.
2026-07-20 02:57:32 -04:00
iomgaa 583c012706 docs: add per-project migration documents as design constraints
Add research-wiki/migrations/ (govdoc-saas, video-tree-trm5,
chsanalyzer): deletion lists, component mappings, call-site
inventories, config migration, stepwise rollback plans, legacy
behavior audits, and reverse constraints on the library design
including flagged architecture gaps.
2026-07-20 01:26:23 -04:00
iomgaa 4f2c149a9d docs: add D13 retry decision and development roadmap
Record tenacity vs self-built evaluation as D13 in ARCHITECTURE.md
(self-built wins: per-attempt orchestration, cancellation guarantees,
supply-chain discipline). Add research-wiki/ROADMAP.md expanding the
milestone table with ordering rationale and exit criteria.
2026-07-20 01:02:35 -04:00
iomgaa 3058f4c744 chore: bootstrap project scaffolding
Add architecture doc (research-wiki/ARCHITECTURE.md), CLAUDE.md with
tiered SOP for Fable 5, adapted .claude skills/hooks/settings, package
skeleton (src/polygateway), pyproject with import-linter contracts,
Makefile, .env.example and smoke test.
2026-07-20 00:49:10 -04:00