legion-ref/mesh-llm
1
0
Fork 0
mirror of https://github.com/Mesh-LLM/mesh-llm.git synced 2026-08-08 22:23:19 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions
mesh-llm/docs
History
Ivan Golovach 84da8b6d52
Harden mDNS LAN discovery contract (#766) 
Harden LAN-only mDNS discovery

Validation
* Validation tier: Tier 2R - post-review correction for PR #766. mDNS LAN detail advertisement is gated by management API reachability, and LAN detail responses use the same publication metadata as the mDNS publish loop. No mesh wire/protobuf, Skippy ABI, plugin protocol, or release metadata changed.
* git fetch --no-tags origin main:refs/remotes/origin/main: PASS, origin/main at f9bd75a973.
* git rebase origin/main: PASS, no conflicts.
* 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=/Users/Funtland/Downloads/mesh-llm/.deps/llama-build/build-stage-abi-metal cargo test -p mesh-llm-host-runtime lan_advertisement --lib -- --test-threads=1: PASS, 4 passed.
* LLAMA_STAGE_BUILD_DIR=/Users/Funtland/Downloads/mesh-llm/.deps/llama-build/build-stage-abi-metal cargo test -p mesh-llm-host-runtime mdns --lib -- --test-threads=1: PASS, 8 passed.
* LLAMA_STAGE_BUILD_DIR=/Users/Funtland/Downloads/mesh-llm/.deps/llama-build/build-stage-abi-metal cargo test -p mesh-llm-host-runtime lan_details --lib -- --test-threads=1: PASS, 4 passed.
* LLAMA_STAGE_BUILD_DIR=/Users/Funtland/Downloads/mesh-llm/.deps/llama-build/build-stage-abi-metal cargo check -p mesh-llm: PASS.
* LLAMA_STAGE_BUILD_DIR=/Users/Funtland/Downloads/mesh-llm/.deps/llama-build/build-stage-abi-metal /opt/homebrew/bin/cargo-clippy clippy -p mesh-llm-host-runtime --all-targets -- -D warnings: PASS.
* Ledger: not applicable - not required for selected validation tier/change family.
* Version: not applicable - no release/version sync required for this non-release LAN discovery hardening correction.
* Not run: live two-node LAN mDNS smoke - no second LAN node was available in this isolated worktree; advertisement gating, route metadata, token-proof, mDNS mode, relay policy, shipped-binary check, and clippy cover the changed branches.
* Not run: full workspace suite locally - mandatory PR CI is the final full-suite proof for the pushed SHA.

Rollback
* git revert HEAD
2026-06-02 09:17:05 -07:00
..
design Harden mDNS LAN discovery contract (#766) 2026-06-02 09:17:05 -07: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 Add plugin startup resilience diagnostics (#759) 2026-05-31 13:52:48 -07: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 mDNS LAN discovery contract (#766) 2026-06-02 09:17:05 -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 Drop deprecated mesh-bundle release asset (#755) 2026-05-31 11:18:07 +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 mDNS LAN discovery contract (#766) 2026-06-02 09:17:05 -07:00
NODE_REP.md Add local target reputation routing (#767) 2026-06-01 17:08:39 +10:00
README.md Add local target reputation routing (#767) 2026-06-01 17:08:39 +10: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 Add plugin startup resilience diagnostics (#759) 2026-05-31 13:52:48 -07:00
SWARM_CAPTURE.md feature(swarm-capture): add swarm-capture debug tool (#573) 2026-05-25 15:53:51 +10:00
USAGE.md Add plugin startup resilience diagnostics (#759) 2026-05-31 13:52:48 -07:00

README.md

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
Local routing reputation and target cooldowns NODE_REP.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.