AGENTS.md (2766B)
1 # hyf - code directives 2 3 - this repo defines `hyf`, the contextual intelligence layer for Radroots networks; the primary daemon is `hyfd` 4 - treat this repo root as the source of truth for source, runtime behavior, repo-local release-candidate validation, and documentation 5 - official Radroots signed artifact provisioning, builder selection, target matrices, publication, promotion, and deploy transport are not defined by this repo 6 - keep docs and manifests honest about current implementation status and documented command surfaces 7 - prefer the smallest coherent change that fully addresses the request; do not mix unrelated cleanup, speculative refactors, or roadmap work into the same change 8 - read `README.md`, `pixi.toml`, and `flake.nix` before broad edits, and inspect the current implementation before changing behavior 9 - validate from this repo root with documented commands first; the current bootstrap smoke check is `pixi run run` 10 - `.github/**` and capsule-local CI workflows are forbidden; keep validation forge-agnostic, and place any required monorepo orchestration exclusively under the parent monorepo's root `.act/**` authority 11 - keep the service boundary as stdio rpc; `hyfd` is the canonical local process interface 12 - keep the service core in mojo; use the checked-in repo tooling surface for development, validation, and launch workflows 13 - if validation cannot run, report the blocker clearly instead of guessing past it 14 - toolchain: Mojo via the locally installed Modular toolchain 15 - prefer explicit typed models, deterministic behavior, and direct service boundaries over stringly or implicit behavior 16 17 ## hyf_v1_jev specification execution 18 19 - Execute the owner-approved `hyf_v1_jev` handoff as a multi-RCLD sequence: one 20 active slice at a time, one tested/reviewed/known-good commit per step. Do not 21 merge, skip, reorder, broaden or auto-split steps. 22 - The durable governing document, decision register, step ledger and step 23 evidence live under the parent monorepo `docs/` tree, not in this capsule: 24 `docs/execution/rcl/hyf-v1-jev-multi-rcld-sequence.md`, 25 `docs/execution/evidence/hyf_v1_jev/`. 26 - Per step record a report; allowed result states are `PLANNED`, `IN_PROGRESS`, 27 `PASSED`, `FAILED`, `BLOCKED`, `NOT_RUN`, `NOT_APPLICABLE`. A step is `PASSED` 28 only with executed evidence; never label an unrun source/model/provider check 29 as passed. 30 - A deviation requires repository evidence recorded in the deviation ledger 31 before proceeding; never silently skip or reorder. 32 - Conditional Cargo is `N/A — Mojo core` unless a real relevant Rust workspace 33 is discovered. 34 - Stage only owned paths; never `git add -A`; never stage `secrets.txt`. 35 - Use `pixi run --frozen` for repo-owned tasks to avoid incidental lock rewrite.