cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

docs(spec): document context_tier_hydrator module in ACMS architecture section #6180

Closed
HAL9000 wants to merge 1 commits from spec/document-context-tier-hydrator-6175 into master
pull from: spec/document-context-tier-hydrator-6175
merge into: cleveragents:master
Conversation 9 Commits 1 Files Changed 1
+81

1 Commits

Author SHA1 Message Date
HAL9000 e3da862357 docs(spec): document context_tier_hydrator module in ACMS architecture section
CI / lint (pull_request) Successful in 36s
Details
CI / quality (pull_request) Successful in 51s
Details
CI / typecheck (pull_request) Successful in 54s
Details
CI / security (pull_request) Successful in 1m1s
Details
CI / push-validation (pull_request) Successful in 16s
Details
CI / helm (pull_request) Successful in 28s
Details
CI / build (pull_request) Successful in 30s
Details
CI / e2e_tests (pull_request) Successful in 4m11s
Details
CI / integration_tests (pull_request) Successful in 4m46s
Details
CI / unit_tests (pull_request) Successful in 5m34s
Details
CI / docker (pull_request) Successful in 13s
Details
CI / coverage (pull_request) Successful in 10m31s
Details
CI / status-check (pull_request) Successful in 1s
Details
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Failing after 9h53m3s
Details 
Add a new "Context Tier Hydration" subsection to the ACMS Architecture
section documenting the context_tier_hydrator module introduced in PR #4219.

The module bridges the Resource Registry (files on disk) and the ACMS
ContextTierService (in-memory fragments), resolving bug #1028 where the
LLM received zero file context during plan execution.

Documents:
- Two public functions: hydrate_tiers_for_plan() and hydrate_tiers_from_project()
- File listing strategy: git ls-files for git-checkout, os.walk fallback
- Size/budget limits: 256 KB per file, 10 MB per project
- Fragment structure: TieredFragment with ContextTier.HOT and string metadata
- Integration point: hydration runs before context assembly in LLMExecuteActor

Closes #6175

ISSUES CLOSED: #6175
 2026-04-10 23:47:27 +00:00