Skip to content

docs(repo): state host role instead of machine identity #82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
forkwright merged 1 commit into from
Sep 16, 2026
Merged

docs(repo): state host role instead of machine identity #82

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions .kanon-ci.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,13 @@
# Forge CI pipeline for forkwright/zetesis.
#
# Mirrors the hardcoded default Rust gate (fmt → check → clippy → nextest
# → lint) but pins per-stage build + test concurrency to 8. Without this
# cap, cargo defaults to num_cpus (64 on this Threadripper) and parallel
# rustc + nextest processes can contend with other fleet work.
# → lint) but pins per-stage build + test concurrency to 8. The pin is a
# co-residency cap: cargo's default parallelism is the host's total core
# count, so an unpinned run sizes itself to the entire machine rather than
# to its share of it and contends with whatever else is running there.
# A dedicated machine does not retire the pin, because concurrent runs and
# co-resident services still share those cores; only an executor that
# confines each run to its own CPU budget does.
#
# Keep in sync with `crates/archeion/src/ci_config.rs::default_rust_gate`
# when the upstream default changes — only the `--jobs` / `--test-threads`
Expand Down
6 changes: 3 additions & 3 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!--
scope: zetesis repo conventions (research substrate: Tier-0 free APIs, self-hosted deep research, budget ledger)
defers_to: menos-ops CLAUDE.md for machine topology (including `menos gpu research` mode); operator global CLAUDE.md for operator principles; kanon standards for universal engineering policy
defers_to: host-operations docs for machine topology and GPU mode selection; operator global CLAUDE.md for operator principles; kanon standards for universal engineering policy
tightens: free-first routing discipline, budget as first-class constraint, caching-by-default via koina+fjall
-->

Expand Down Expand Up @@ -39,7 +39,7 @@ Zetesis has three planned fleet consumers (aletheia, dioptron, akroasis) plus li

- Free-tier APIs have aggressive rate limits; `sylloge` tracks free-tier quotas separately from paid spend.
- Deep research can blow $10+ in token costs per query if orchestrated against Anthropic/OpenAI. Default backend is local logismos.
- `menos gpu research` mode (Phase 6, in coordination with menos-ops) is exclusive with `menos gpu inference` on the W7900; operator picks.
- GPU research mode (Phase 6) is mutually exclusive with GPU inference mode on a single-GPU host; the operator picks which one holds the device.
- Downstream use must comply with the scoped license map above; commercial client-contract work must not depend on zetesis.

## Related
Expand All @@ -52,7 +52,7 @@ Zetesis has three planned fleet consumers (aletheia, dioptron, akroasis) plus li
| logismos | Self-hosted orchestration backend |
| koina + fjall | Cache + budget ledger persistence |
| heurēma | Future semantic rerank of Tier 0 results |
| menos-ops | `menos gpu research` mode owner |
| host-operations environment | Owns GPU research/inference mode selection |
| hermeneus (inside aletheia) | Sibling primitive: hermeneus unifies LLM providers, zetesis unifies research providers |

<!-- kanon:auto-start -->
Expand Down