mesh-llm/docs
Ivan Golovach fef0f4dedd
Harden LAN-only mDNS mesh startup (#746)
Make mDNS mesh startup LAN-only

Validation
* Validation tier: Tier 2R - post-review/rebase correction for PR #746; LAN/mDNS relay policy remains runtime-significant, but the final update is a narrow same-PR correction that gates relay-health monitoring by discovery mode and refreshes proof on current main.
* git fetch --no-tags origin main:refs/remotes/origin/main: PASS, origin/main at 95695f9f7d.
* git rebase origin/main: PASS, no conflicts.
* git rev-list --left-right --count origin/main...HEAD: PASS, 0 behind / 1 ahead.
* git diff --check origin/main...HEAD: PASS, no output.
* git diff --check: PASS, no output.
* git diff --cached --check: PASS, no output.
* cargo fmt --all -- --check: PASS.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> cargo test -p mesh-llm-host-runtime relay_policy --lib -- --test-threads=1: PASS, 4 passed.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> cargo test -p mesh-llm-host-runtime relay_health_monitor --lib -- --test-threads=1: PASS, 2 passed.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> cargo test -p mesh-llm-host-runtime mdns --lib -- --test-threads=1: PASS, 6 passed.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> cargo test -p mesh-llm-host-runtime relay_health --lib -- --test-threads=1: PASS, 6 passed.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> cargo test -p mesh-llm-host-runtime runtime_data --lib -- --test-threads=1: PASS, 27 passed.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> cargo test -p mesh-llm-host-runtime status_payload --lib -- --test-threads=1: PASS, 12 passed.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> cargo check -p mesh-llm: PASS.
* LLAMA_STAGE_BUILD_DIR=<stage-build-dir> /opt/homebrew/bin/cargo-clippy clippy -p mesh-llm-host-runtime --all-targets -- -D warnings: PASS.
* Remote PR Quality Checks on c060d1dc7a: PASS.
* Remote PR Builds on c060d1dc7a: PASS.
* Ledger: not applicable - not required for selected validation tier/change family.
* Version: not applicable - no release/version sync required for this non-release runtime discovery hardening PR.
* Not run: live two-node LAN mDNS smoke - no second LAN node was available in this isolated worktree; relay policy, monitor gating, CLI rejection, status propagation, and host-runtime targeted tests cover the changed paths.

Rollback
* git revert HEAD
2026-05-29 23:49:41 -07:00
..
design fix(cuda-gpus): correct gpu detection, and split CI CUDA lanes by version (#721) 2026-05-29 17:20:36 -04:00
plans fix(cuda-gpus): correct gpu detection, and split CI CUDA lanes by version (#721) 2026-05-29 17:20:36 -04:00
plugins Move openai-endpoint to external plugin (#738) 2026-05-30 06:05:13 +10:00
skippy Add Skippy package preflight diagnostics (#703) 2026-05-27 12:51:01 -07:00
specs Gate Skippy artifact transfer behind trust policy (#485) 2026-05-10 19:38:06 +10:00
AGENTS.md Add mesh MCP HTTP endpoint + auto configure agents (#708) 2026-05-28 11:43:49 +10:00
BENCHMARKS.md feature(tool-calling): harden tool calling for agent harnesses (#645) 2026-05-25 01:44:59 -04:00
CLI.md Harden LAN-only mDNS mesh startup (#746) 2026-05-29 23:49:41 -07:00
CNAME fix(docs): restore docs.anarchai.org as Pages custom domain 2026-05-23 17:18:59 +10:00
cuda-release-lanes.md Fix update flavor detection (#712) 2026-05-27 19:32:55 +10:00
EXO_COMPARISON.md chore(docs): update docs to match planned updates 2026-05-12 17:52:17 -04:00
index.html Move openai-endpoint to external plugin (#738) 2026-05-30 06:05:13 +10:00
LAYER_PACKAGE_REPOS.md Add Skippy package preflight diagnostics (#703) 2026-05-27 12:51:01 -07:00
mesh-llm-logo.svg Improve layer package model cards (#482) 2026-05-09 16:32:04 +10:00
mesh-llm-wordmark.png chore(docs): update docs to match planned updates 2026-05-12 17:52:17 -04:00
mesh.png add console screenshot to README and landing page 2026-02-20 18:30:46 +11:00
MESHES.md Harden LAN-only mDNS mesh startup (#746) 2026-05-29 23:49:41 -07:00
README.md feature(mesh-genesis): add mesh genesis rules (#589) 2026-05-29 16:41:36 -04:00
SDK.md bump version to 0.68.0 (#711) 2026-05-27 18:38:56 +10:00
SKIPPY.md Fix HF layer-package split serving (#705) 2026-05-27 18:29:10 +10:00
SKIPPY_SPLITS.md [codex] Add Skippy diagnostics to doctor bundles (#744) 2026-05-30 07:56:55 +10:00
SWARM_CAPTURE.md feature(swarm-capture): add swarm-capture debug tool (#573) 2026-05-25 15:53:51 +10:00
USAGE.md fix(cuda-gpus): correct gpu detection, and split CI CUDA lanes by version (#721) 2026-05-29 17:20:36 -04:00

Documentation

Use this hub to find project guides that are not owned by a single Rust crate.

Start here

Need Doc
Install, run, service mode, model storage USAGE.md
Private meshes, published meshes, public joining MESHES.md
SDK usage, examples, errors, lifecycle, platform support SDK.md
Run big models with Skippy layer splits SKIPPY_SPLITS.md
Contribute or publish layer package repositories LAYER_PACKAGE_REPOS.md
Goose, Claude Code, OpenCode, Pi, curl, blackboard AGENTS.md
Command-by-command CLI reference CLI.md
Exo comparison EXO_COMPARISON.md

Skippy and model-package docs

Doc What it covers
skippy/FAMILY_STATUS.md Certified family/split/wire-dtype status
skippy/NEW_MODEL_ONBOARDING.md New-model split/certification intake checklist
skippy/FAMILY_CERTIFY.md Certification workflow for new families
skippy/TOPOLOGY_PLANNER.md Stage topology planning behavior
skippy/CONFIGURATION.md Authoritative operator matrix for Skippy config keys and rejection boundaries
skippy/DATA_FLOW.md Stage data flow and transport details
skippy/LLAMA_PARITY.md Remaining llama.cpp parity queue
specs/layer-package-repos.md Manifest schema and package artifact rules
SKIPPY.md Skippy integration readiness and parity notes

Use SKIPPY_SPLITS.md for Skippy split-serving workflows.

Other references

Doc or directory What belongs there
BENCHMARKS.md Current benchmark numbers and performance context
SWARM_CAPTURE.md Opt-in local debug capture for mesh membership and connection diagnostics
design/ Architecture notes, protocol design, testing playbooks, carried llama.cpp patch documentation
design/NODE_OWNER_IDENTITY.md Owner identity, trust policy, and how owner trust stays separate from release attestation
plugins/ Plugin architecture and implementation planning
plans/ Narrow implementation plans that are not yet general design docs
specs/ Focused behavior specs for individual features
design/OPENAI_GUARDRAILS.md OpenAI guardrail rollout defaults, v1 limits, telemetry privacy, and evidence scaffolding

Per-crate docs stay with their crates. The main binary crate overview lives at ../crates/mesh-llm/README.md, and the web console/embedded asset crate overview lives at ../crates/mesh-llm-ui/README.md. Shared protocol-facing model/type ownership lives at ../crates/mesh-llm-types/README.md. Shared owner identity and envelope crypto lives at ../crates/mesh-llm-identity/README.md. Shared wire protocol ownership lives at ../crates/mesh-llm-protocol/README.md. Shared routing target ownership lives at ../crates/mesh-llm-routing/README.md.