586 lines
37 KiB
Markdown
586 lines
37 KiB
Markdown
# Graphify Code-Architecture Scope
|
||
|
||
This graph deliberately covers the executable `packages/` code (98 detected source/configuration files). The six package-local documentation/build artifacts were excluded from semantic extraction for this code-only pass.
|
||
|
||
# Graph Report - packages (2026-07-29)
|
||
|
||
## Corpus Check
|
||
- 106 files · ~188,575 words
|
||
- Verdict: corpus is large enough that graph structure adds value.
|
||
|
||
## Summary
|
||
- 2556 nodes · 5763 edges · 123 communities (100 shown, 23 thin omitted)
|
||
- Extraction: 92% EXTRACTED · 8% INFERRED · 0% AMBIGUOUS · INFERRED: 451 edges (avg confidence: 0.51)
|
||
- Token cost: 0 input · 0 output
|
||
|
||
## Community Hubs (Navigation)
|
||
- Tracker Routing & Placement
|
||
- Validator Proof Audits
|
||
- Capability Admission
|
||
- Shard Artifact Download
|
||
- PyTorch Shard Execution
|
||
- Native Shard Lifecycle
|
||
- Tracker Operations & CLI
|
||
- Node Capability Reports
|
||
- Gateway Request Routing
|
||
- Activation Transport & Binary Frames
|
||
- Tracker Capability Evaluation
|
||
- Node Diagnostics
|
||
- Relay Peer Registry
|
||
- Native Worker Adapter
|
||
- KV Session Cache
|
||
- Performance Contracts
|
||
- Route Session Benchmarks
|
||
- GLM Alpha Planning
|
||
- Tracker Admin & Network APIs
|
||
- Benchmark Recipe Drivers
|
||
- Community 20
|
||
- Community 21
|
||
- Community 22
|
||
- Community 23
|
||
- Community 24
|
||
- Community 25
|
||
- Community 26
|
||
- Community 27
|
||
- Community 28
|
||
- Community 29
|
||
- Community 30
|
||
- Community 31
|
||
- Community 32
|
||
- Community 33
|
||
- Community 34
|
||
- Community 35
|
||
- Community 36
|
||
- Community 37
|
||
- Community 38
|
||
- Community 39
|
||
- Community 40
|
||
- Community 41
|
||
- Community 42
|
||
- Community 43
|
||
- Community 44
|
||
- Community 45
|
||
- Community 46
|
||
- Community 47
|
||
- Community 48
|
||
- Community 49
|
||
- Community 50
|
||
- Community 51
|
||
- Community 52
|
||
- Community 53
|
||
- Community 54
|
||
- Community 55
|
||
- Community 56
|
||
- Community 57
|
||
- Community 58
|
||
- Community 59
|
||
- Community 60
|
||
- Community 61
|
||
- Community 62
|
||
- Community 63
|
||
- Community 64
|
||
- Community 65
|
||
- Community 66
|
||
- Community 67
|
||
- Community 68
|
||
- Community 69
|
||
- Community 70
|
||
- Community 71
|
||
- Community 72
|
||
- Community 73
|
||
- Community 74
|
||
- Community 75
|
||
- Community 76
|
||
- Community 77
|
||
- Community 78
|
||
- Community 79
|
||
- Community 80
|
||
- Community 81
|
||
- Community 82
|
||
- Community 83
|
||
- Community 84
|
||
- Community 85
|
||
- Community 86
|
||
- Community 87
|
||
- Community 88
|
||
- Community 89
|
||
- Community 90
|
||
- Community 91
|
||
- Community 92
|
||
- Community 93
|
||
- Community 94
|
||
- Community 95
|
||
- Community 96
|
||
- Community 97
|
||
- Community 98
|
||
- Community 99
|
||
- Community 100
|
||
- Community 101
|
||
- Community 102
|
||
- Community 103
|
||
- Community 104
|
||
- Community 105
|
||
- Community 106
|
||
- Community 107
|
||
- Community 109
|
||
- Community 110
|
||
- Community 111
|
||
- Community 112
|
||
- Community 113
|
||
- Community 114
|
||
- Community 115
|
||
- Community 116
|
||
- Community 117
|
||
- Community 118
|
||
- Community 119
|
||
- Community 120
|
||
- Community 121
|
||
- Community 122
|
||
|
||
## God Nodes (most connected - your core abstractions)
|
||
1. `_TrackerHandler` - 93 edges
|
||
2. `_NodeEntry` - 50 edges
|
||
3. `run_startup()` - 46 edges
|
||
4. `BillingLedger` - 45 edges
|
||
5. `TorchModelShard` - 41 edges
|
||
6. `AccountStore` - 37 edges
|
||
7. `TrackerServer` - 37 edges
|
||
8. `CapabilityReport` - 35 edges
|
||
9. `RaftNode` - 33 edges
|
||
10. `_StatsCollector` - 32 edges
|
||
|
||
## Surprising Connections (you probably didn't know these)
|
||
- `main()` --calls--> `LocalSolanaContracts` [INFERRED]
|
||
tracker/meshnet_tracker/cli.py → contracts/meshnet_contracts/__init__.py
|
||
- `main()` --calls--> `SolanaCustodialTreasury` [INFERRED]
|
||
tracker/meshnet_tracker/cli.py → contracts/meshnet_contracts/solana_adapter.py
|
||
- `_RollingCounter` --uses--> `ToplocProofClaim` [INFERRED]
|
||
tracker/meshnet_tracker/server.py → validator/meshnet_validator/audit.py
|
||
- `_RollingThroughput` --uses--> `ToplocProofClaim` [INFERRED]
|
||
tracker/meshnet_tracker/server.py → validator/meshnet_validator/audit.py
|
||
- `_ModelStats` --uses--> `ToplocProofClaim` [INFERRED]
|
||
tracker/meshnet_tracker/server.py → validator/meshnet_validator/audit.py
|
||
|
||
## Import Cycles
|
||
- None detected.
|
||
|
||
## Communities (123 total, 23 thin omitted)
|
||
|
||
### Community 0 - "Tracker Routing & Placement"
|
||
Cohesion: 0.06
|
||
Nodes (84): tracker_logger(), _add_shard_directive(), _assign_redundant_managed_nodes(), _assignment_memory_bytes(), _available_quantizations(), _billable_stream_tokens(), _coverage_gaps(), _coverage_map() (+76 more)
|
||
|
||
### Community 1 - "Validator Proof Audits"
|
||
Cohesion: 0.05
|
||
Nodes (57): ProofEncoding, build_activation_proofs(), _call_toploc(), _chunk_field(), _extract_divergence(), _load_toploc(), _proof_encoding(), Any (+49 more)
|
||
|
||
### Community 2 - "Capability Admission"
|
||
Cohesion: 0.05
|
||
Nodes (25): CapabilityState, The tracker's sanitized verdict on one node's presented proof. This is what the…, The presented proof covers exactly what the node advertised., What route formation compares. `None` when the node declares no identity., CertificationLedger, DistributedForwardEvidence, PresentedIdentity, One node's declared artifact/recipe identity, with digests re-derived here.… (+17 more)
|
||
|
||
### Community 3 - "Shard Artifact Download"
|
||
Cohesion: 0.06
|
||
Nodes (51): _allow_patterns_from_remote_index(), _allow_patterns_from_sources(), compute_shard_checksum(), _download_huggingface_subset(), _download_model_source(), download_shard(), _download_shard_from_peer(), _download_source_files() (+43 more)
|
||
|
||
### Community 4 - "PyTorch Shard Execution"
|
||
Cohesion: 0.08
|
||
Nodes (55): _active_modules_for_shard(), build_quantization_config(), _call_layer(), _causal_lm_config(), _checkpoint_tensor_name_for_model(), _config_candidates(), _decoder_attention_mask(), _embed_tokens() (+47 more)
|
||
|
||
### Community 5 - "Native Shard Lifecycle"
|
||
Cohesion: 0.06
|
||
Nodes (35): CacheExpectation, CacheResult, CancellationToken, CancelRequest, CapabilityRequest, CapabilityResponse, DeadlinePolicy, FlowControl (+27 more)
|
||
|
||
### Community 6 - "Tracker Operations & CLI"
|
||
Cohesion: 0.05
|
||
Nodes (42): HTMLParser, Logger, LogRecord, Namespace, RotatingFileHandler, TextIO, _load_env_defaults(), _load_env_file() (+34 more)
|
||
|
||
### Community 7 - "Node Capability Reports"
|
||
Cohesion: 0.06
|
||
Nodes (40): CapabilityContext, probe_capability(), Production validator: one bounded real forward through the loaded shard., What is about to be advertised, and the loaded backend that would serve it., BackendIdentity, build_capability_report(), CapabilityReport, config_fingerprint() (+32 more)
|
||
|
||
### Community 8 - "Gateway Request Routing"
|
||
Cohesion: 0.07
|
||
Nodes (50): Any, route_signature(), _admitted_nodes(), _billable_non_stream_split(), _billable_non_stream_tokens(), _capability_routable(), _clear_proxy_progress_log_state(), _effective_queue_depth() (+42 more)
|
||
|
||
### Community 9 - "Activation Transport & Binary Frames"
|
||
Cohesion: 0.06
|
||
Nodes (43): ConnectionError, MissingModelDependencyError, Tail-shard decode result: decoded text plus the raw token id. The token id lets…, Raised when optional model dependencies are not installed., TailTokenResult, _tensor_from_bfloat16_bytes(), decode_binary_frame(), encode_binary_frame() (+35 more)
|
||
|
||
### Community 10 - "Tracker Capability Evaluation"
|
||
Cohesion: 0.09
|
||
Nodes (46): absent_state(), catalogue_is_compatible(), _diagnostics(), evaluate_report(), _index(), _maybe_int(), _object(), _optional_text() (+38 more)
|
||
|
||
### Community 11 - "Node Diagnostics"
|
||
Cohesion: 0.08
|
||
Nodes (40): _backend_device(), _backend_device_name(), build_probe_input(), classify_failure(), default_load_backend(), _describe(), _describe_output(), DoctorError (+32 more)
|
||
|
||
### Community 12 - "Relay Peer Registry"
|
||
Cohesion: 0.07
|
||
Nodes (22): main(), meshnet-relay CLI entry point., PeerEntry, PeerRegistry, In-memory registry of connected gossip peers., _broadcast(), decode_binary_frame(), encode_binary_frame() (+14 more)
|
||
|
||
### Community 13 - "Native Worker Adapter"
|
||
Cohesion: 0.08
|
||
Nodes (28): ImmutableArtifactPin, NativeIdentityInputs, NativeLoadedArtifactReport, NativeNumericalRecipe, NativeSessionRejected, NativeWorkerBackendAdapter, Authoritative identity boundary for a native GGUF Shard backend. The native…, A native worker refused a ``SessionOpen`` before allocating session state. (+20 more)
|
||
|
||
### Community 14 - "KV Session Cache"
|
||
Cohesion: 0.07
|
||
Nodes (20): _cache_unsupported_for_shard(), KVCacheMiss, BaseException, True when a layer failure means session cache is unsupported, not fatal., Per-session cached state for one shard's layer range. `cache` is whatever…, TTL + LRU bounded map of session_id → SessionCacheEntry. Each node caches state…, Executable subset of a HuggingFace causal language model., Decode step: embed one new token against this head's cached session. Raises… (+12 more)
|
||
|
||
### Community 15 - "Performance Contracts"
|
||
Cohesion: 0.10
|
||
Nodes (35): baseline_from_report(), _canonical_sha256(), _cell(), ContractEvaluation, ContractThresholds, _decode_base64(), evaluate_contract(), _evaluate_recipe() (+27 more)
|
||
|
||
### Community 16 - "Route Session Benchmarks"
|
||
Cohesion: 0.09
|
||
Nodes (33): CacheMode, _activation(), assert_benchmark(), assert_performance_gate(), BenchmarkRun, BenchmarkScenario, format_summary(), main() (+25 more)
|
||
|
||
### Community 17 - "GLM Alpha Planning"
|
||
Cohesion: 0.11
|
||
Nodes (28): IndexerLayout, The locked GLM-5.2 Max alpha target: identity, resource plan, and acceptance…, ArchitectureSnapshot, Architecture-critical metadata derived from the pinned ``config.json``., kv_bytes(), NodeMemory, plan_all_tiers(), plan_route() (+20 more)
|
||
|
||
### Community 18 - "Tracker Admin & Network APIs"
|
||
Cohesion: 0.11
|
||
Nodes (11): _normalize_current_requests(), ParseResult, Gate a privileged handler; sends 401/403 and returns False on failure. 401 when…, Return head workers: worker nodes that can start inference for a model. The…, Admin session first, then the explicit enable gate — both fail closed., Privileged: forfeit a node's pending balance + record a strike (US-034).…, Dispute-auditability log for the dynamic HF-benchmarked pricing (issue 23)., Return an optimal shard assignment for a node given its hardware profile. Query… (+3 more)
|
||
|
||
### Community 19 - "Benchmark Recipe Drivers"
|
||
Cohesion: 0.12
|
||
Nodes (34): Ed25519PrivateKey, BenchmarkError, RuntimeError, Raised when a benchmark cannot be run as specified., _artifact_sha256(), build_driver(), _directory_bytes(), _gpu_offload_evidence() (+26 more)
|
||
|
||
### Community 20 - "Community 20"
|
||
Cohesion: 0.10
|
||
Nodes (23): deque, Popen, CollectionError, discover_repo_root(), _function_metadata(), Exception, Path, Opt-in tracker test runner backing the dashboard Testing tab. Security posture… (+15 more)
|
||
|
||
### Community 21 - "Community 21"
|
||
Cohesion: 0.10
|
||
Nodes (20): Random, Minimal Raft consensus for tracker shard assignments. Only shard-assignment…, choose_route(), Learned route statistics for dynamic bandit-style route selection (ADR-0021).…, Fold one completed request into the route's EWMA. Returns False (and records…, Point-in-time view of one route's learned state., All measured route samples, including pinned experiment routes., Drop routes with no samples for `prune_after_seconds`. (+12 more)
|
||
|
||
### Community 22 - "Community 22"
|
||
Cohesion: 0.10
|
||
Nodes (9): AccountStore, _hash_password(), _normalize_nickname(), Tracker user accounts: registration, login, API-key management. Accounts are…, Update display fields for an account. Pass nickname=None to clear., Return the public account view when credentials match, else None., Revoke a key owned by ``account_id``. Returns False if not owned., Thread-safe account/API-key store with SQLite persistence and event replication. (+1 more)
|
||
|
||
### Community 23 - "Community 23"
|
||
Cohesion: 0.12
|
||
Nodes (24): ProbeInput, One recipe's validation outcome, with the report it produced., A synthetic hidden-state payload in the same wire format peers send., RecipeResult, load_recipe_manifest(), _parse_recipe(), parse_recipe_manifest(), Any (+16 more)
|
||
|
||
### Community 24 - "Community 24"
|
||
Cohesion: 0.11
|
||
Nodes (31): Return a hardware profile forced to CPU execution. Keeps detected GPU metadata…, with_forced_cpu(), peer_id_from_wallet(), Build a per-node relay peer id from the wallet plus node identity. Multiple…, _assignment_bytes_per_layer(), _cap_auto_assigned_shard(), _configure_torch_threads(), _discover_relay_url() (+23 more)
|
||
|
||
### Community 25 - "Community 25"
|
||
Cohesion: 0.12
|
||
Nodes (18): ChatCompletion, _chat_completion(), Client, CostEstimate, _ModelsClient, _openai_base_url(), Any, Typed Python SDK for the meshnet OpenAI-compatible gateway. (+10 more)
|
||
|
||
### Community 26 - "Community 26"
|
||
Cohesion: 0.11
|
||
Nodes (15): Deposit, load_keypair(), Custodial Solana treasury adapter (ADR-0015, US-032/US-033). The entire on-…, Confirmed incoming USDT transfers whose signature is not yet seen.…, Send one batched transaction of USDT transfers treasury → wallets. Creates the…, Create a fresh 6-decimal mock-USDT mint (treasury = mint authority). Returns a…, Mint mock USDT to a wallet (devnet only — treasury is mint authority)., A confirmed incoming USDT transfer into the treasury token account. (+7 more)
|
||
|
||
### Community 27 - "Community 27"
|
||
Cohesion: 0.12
|
||
Nodes (22): compress_activation(), CompressionPolicies, CompressionPolicy, CompressionResult, decompress_activation(), _env_bool(), _env_float(), _env_int() (+14 more)
|
||
|
||
### Community 28 - "Community 28"
|
||
Cohesion: 0.09
|
||
Nodes (19): Lock, normalize_policy(), policy_from_env(), Return a known policy name, falling back to the default for anything else., HfPricingLog, Thread-safe SQLite-backed audit log of dynamic price changes (issue 23). Every…, _clone_model_presets(), _preset_price_keys() (+11 more)
|
||
|
||
### Community 29 - "Community 29"
|
||
Cohesion: 0.12
|
||
Nodes (28): _apply_relay_concurrency_flag(), _cmd_default(), _cmd_doctor(), _cmd_models(), _cmd_start(), _doctor_overrides(), _first_available_port(), _load_env_defaults() (+20 more)
|
||
|
||
### Community 30 - "Community 30"
|
||
Cohesion: 0.11
|
||
Nodes (14): _LoopbackHttpClientPool, _make_envelope(), _max_concurrency_from_env(), _peer_id_suffix(), HTTPConnection, Outbound relay bridge for NAT-safe node HTTP requests., Connect outbound to a relay and proxy relay HTTP requests to localhost.…, Send one relay-http-response frame; False if the socket is gone. The lock is… (+6 more)
|
||
|
||
### Community 31 - "Community 31"
|
||
Cohesion: 0.09
|
||
Nodes (17): _capability_from_registration(), _local_relay_url(), _node_id_for_registration(), _normalize_friendly_name(), Resolve the active precision a registration is routable at. Only the raw body…, Return a node-consumable ws:// URL for an embedded relay bind address., HTTP tracker that manages node registration and resolves inference routes.…, Start the shared RelayServer class in-process for tracker+relay deployments. (+9 more)
|
||
|
||
### Community 32 - "Community 32"
|
||
Cohesion: 0.09
|
||
Nodes (12): validate_quantization(), _load_backend(), Any, Path, HTTP server backed by a HuggingFace causal language model shard., The loaded backend serving `model_id` — full repo id or short name., Apply tracker shard directives (LOAD_SHARD replace, ADD_SHARD load-more)., Set the LAN-facing endpoint used for route self-detection. (+4 more)
|
||
|
||
### Community 33 - "Community 33"
|
||
Cohesion: 0.16
|
||
Nodes (25): Checksum, checksum_of(), crc32c(), decode_bundle(), decode_step_bundle(), decode_tensor(), encode_tensor(), expected_bytes() (+17 more)
|
||
|
||
### Community 34 - "Community 34"
|
||
Cohesion: 0.12
|
||
Nodes (22): _api_key_from_authorization(), _BinaryActivation, _completion_response(), _compress_body(), _decompress_body(), _estimate_token_count(), _last_message_content(), _majority_response() (+14 more)
|
||
|
||
### Community 35 - "Community 35"
|
||
Cohesion: 0.15
|
||
Nodes (23): AlphaContract, AlphaContractError, compute_contract_digest(), contract_signing_payload(), _freeze_json(), load_alpha_contract(), parse_alpha_contract(), Any (+15 more)
|
||
|
||
### Community 36 - "Community 36"
|
||
Cohesion: 0.13
|
||
Nodes (8): LogEntry, RaftNode, Leader: append and replicate an entry. Returns True when committed. Blocks…, Send AppendEntries to all peers and update commit_index on majority ack., Single Raft participant. ``apply_fn(command, payload)`` is called (under no…, Must be called with _lock held., Must be called with _lock held., Must be called with _lock held.
|
||
|
||
### Community 37 - "Community 37"
|
||
Cohesion: 0.13
|
||
Nodes (18): _build_rich_renderable(), _EMA, _format_uptime(), _gpu_stats(), is_interactive_tty(), _make_bar(), _node_stats(), _nvml_gpu_util() (+10 more)
|
||
|
||
### Community 38 - "Community 38"
|
||
Cohesion: 0.14
|
||
Nodes (25): browse_hf_hub(), detect_num_layers(), Return num_hidden_layers from HuggingFace config.json (downloads ~1 KB only)., Fetch top downloaded text-generation models from HuggingFace Hub., _ask(), _ask_int(), _ask_quant(), _ask_yn() (+17 more)
|
||
|
||
### Community 39 - "Community 39"
|
||
Cohesion: 0.08
|
||
Nodes (12): Drop session state out of band. Idempotent., Cancel out of band, on a fresh call. In-band CancelSignal is preferred, but a…, ---------------------------------------------------------------------------…, ---------------------------------------------------------------------------…, Constructor. Args: channel: A grpc.Channel., ---------------------------------------------------------------------------…, What this worker can execute. Read before a route is built., Live load and serving state. (+4 more)
|
||
|
||
### Community 40 - "Community 40"
|
||
Cohesion: 0.13
|
||
Nodes (19): check_handshake(), check_route(), check_session_open(), _coverage_gap(), explain_mismatch(), handshake_error(), Exact Model Artifact and runtime recipe identity (DGR-003). A route is a chain…, The protocol status a rejected handshake closes the stream with. Each rejection… (+11 more)
|
||
|
||
### Community 41 - "Community 41"
|
||
Cohesion: 0.13
|
||
Nodes (16): adapter_for(), Architecture, ArchitectureBoundaryAdapter, BoundaryStage, ProtocolIdentity, Enum, str, Certified architecture adapters for the public TensorBundle boundary. The… (+8 more)
|
||
|
||
### Community 42 - "Community 42"
|
||
Cohesion: 0.24
|
||
Nodes (22): GlmTargetError, load_architecture_snapshot(), _load_json(), load_target_manifest(), parse_architecture_snapshot(), _parse_shards(), parse_target_manifest(), Any (+14 more)
|
||
|
||
### Community 43 - "Community 43"
|
||
Cohesion: 0.16
|
||
Nodes (10): _canonical_json(), _fragment_bytes(), NamedTensor, _normalize_shape(), Any, Versioned activation-stream envelope for shard hops. The transport still moves…, A tensor named within a versioned activation envelope., One bounded chunk of a named tensor. (+2 more)
|
||
|
||
### Community 44 - "Community 44"
|
||
Cohesion: 0.14
|
||
Nodes (6): Read + verify a hive gossip body (HMAC per ADR-0017 §3). Fails closed: without…, Record a rolling wish-list signal for an unavailable precision., Privileged: run the same prompt through 1/2/3-node pinned routes (US-030). Data…, Privileged: honest-noise TOPLOC calibration dispatch (issue 21). Fans the same…, One node's calibration outcome: fetch its on-demand commitment, teacher-force…, _TrackerHandler
|
||
|
||
### Community 45 - "Community 45"
|
||
Cohesion: 0.18
|
||
Nodes (8): Registry wrapper for node stake, strikes, and bans., Stake, strike, and ban state for a node operator wallet., Snapshot of all known wallets (dashboard / monitoring)., ADR-0018 §6: the only reputation signal — clean audits build score slowly, a…, ADR-0018 §6: ×0.8 routing/payout weight per strike, separate from the…, ADR-0018 §6: reputation decays for wallets with no completed job in…, RegistryContract, RegistryWallet
|
||
|
||
### Community 46 - "Community 46"
|
||
Cohesion: 0.12
|
||
Nodes (22): benchmark_throughput(), benchmark_throughput_checked(), detect_hardware(), _detect_nvidia_smi_gpu_memory(), _detect_ram_mb(), _detect_torch_cuda_inventory(), _detect_windows_gpu_memory(), _detect_windows_ram_mb() (+14 more)
|
||
|
||
### Community 47 - "Community 47"
|
||
Cohesion: 0.14
|
||
Nodes (15): measure_recipe(), _PeakMemory, Event, One runtime recipe under test. ``is_reference`` marks the single recipe every…, The seam every runtime implements; the measurement core knows nothing else., Load the artifact and return its cost., Run one complete generation under the given sampling policy., Return ``(rss_bytes, vram_bytes)`` observed right now. (+7 more)
|
||
|
||
### Community 48 - "Community 48"
|
||
Cohesion: 0.25
|
||
Nodes (12): _as_mapping(), Any, ValueError, Malformed identity input. Messages name the field, never echo a payload., A revision must identify one immutable thing, not a ref that moves., Parse an identity block, re-deriving — never trusting — its fingerprint. A…, RecipeIdentityError, _require_hex64() (+4 more)
|
||
|
||
### Community 49 - "Community 49"
|
||
Cohesion: 0.19
|
||
Nodes (3): Stream tokens from an iterator as SSE chunks., Open an OpenAI-compatible SSE response and return a token emitter., _TorchHandler
|
||
|
||
### Community 50 - "Community 50"
|
||
Cohesion: 0.26
|
||
Nodes (4): _GatewayHandler, _lamports_to_sol(), ParseResult, Forward a raw request body to a head worker and relay SSE without buffering.
|
||
|
||
### Community 51 - "Community 51"
|
||
Cohesion: 0.23
|
||
Nodes (10): _as_mapping(), CapabilityReportError, _optional_text(), Any, ValueError, Inclusive layer range, matching the CLI and backend convention., Raised when report input is malformed. Messages name the offending field and…, _require_int() (+2 more)
|
||
|
||
### Community 52 - "Community 52"
|
||
Cohesion: 0.13
|
||
Nodes (17): ConcurrencyMetrics, format_summary(), Lane, main(), _mean(), _percentile(), Enum, str (+9 more)
|
||
|
||
### Community 53 - "Community 53"
|
||
Cohesion: 0.13
|
||
Nodes (14): BenchmarkPlan, build_report(), compute_drift(), DriftReport, _first_divergence(), Any, Everything measured for one recipe across every concurrency level., First successful output per prompt, at the lowest concurrency measured. Drift… (+6 more)
|
||
|
||
### Community 54 - "Community 54"
|
||
Cohesion: 0.13
|
||
Nodes (9): GossipClient, _make_envelope(), WebSocket gossip client — connects to relay, publish/subscribe to topics., Thread-safe WebSocket gossip client. Usage:: client =…, Register a sync callback for messages on topic., Send a gossip message to all peers via the relay. Thread-safe., Start the gossip client in a background thread., Block until connected to relay or timeout. Returns True if connected. (+1 more)
|
||
|
||
### Community 55 - "Community 55"
|
||
Cohesion: 0.19
|
||
Nodes (17): files_for_layer_range(), _is_head_tensor(), _is_tail_tensor(), _layer_index(), _layers_from_config(), _metadata_files(), _normalise_relative_file(), Any (+9 more)
|
||
|
||
### Community 56 - "Community 56"
|
||
Cohesion: 0.18
|
||
Nodes (6): Resolve the session token in the Authorization header, or None., Balance, usage totals, and API keys for the logged-in account., Per-request charge history for the logged-in account (billing tab)., Devnet faucet (US-040): credit the configured amount to one of the logged-in…, Admin-only: all accounts with their keys and balances., _session_cookie_header()
|
||
|
||
### Community 57 - "Community 57"
|
||
Cohesion: 0.20
|
||
Nodes (15): _canonical_sha256(), load_runtime_pin(), Path, ValueError, Canonical runtime pin identity for the recipe fingerprint (DGR-025). The recipe…, Derive the exact runtime pin from a DGR-027 lock workspace, or refuse. Refuses…, The lock workspace is missing, malformed, or internally inconsistent., One exact runtime: a name, an upstream commit, and an ordered patch stack. (+7 more)
|
||
|
||
### Community 58 - "Community 58"
|
||
Cohesion: 0.16
|
||
Nodes (8): GenerationSample, PromptSpec, One completed generation as reported by a driver. ``prefill_ms``/``decode_ms``…, The sampling policy every recipe must be given, identically. Greedy by default:…, One fixed prompt, tagged with the context length it is meant to exercise., SamplingPolicy, The current Transformers/safetensors recipe: the correctness reference.…, TransformersDriver
|
||
|
||
### Community 59 - "Community 59"
|
||
Cohesion: 0.16
|
||
Nodes (8): LoadStats, What loading the recipe cost, before any token is generated., _free_port(), _gpu_layer_config_detail(), LlamaCppServerDriver, _process_rss(), Resident bytes for a process and its children, or 0 when unobservable., The whole-model llama.cpp/GGUF recipe, driven through ``llama-server``.…
|
||
|
||
### Community 60 - "Community 60"
|
||
Cohesion: 0.15
|
||
Nodes (9): main(), meshnet-gateway CLI entry point., _GatewayHTTPServer, GatewayServer, _get_head_workers(), Any, Return head-worker endpoint URLs for this model, or empty list on failure., HTTP gateway that routes /v1/chat/completions through an ordered inference… (+1 more)
|
||
|
||
### Community 61 - "Community 61"
|
||
Cohesion: 0.15
|
||
Nodes (15): _admit_capability(), _capability_device(), _capability_refresher(), _post_json(), _probationary_status_line(), Any, CapabilityValidator, Daemon thread: sends heartbeats and re-registers automatically after tracker… (+7 more)
|
||
|
||
### Community 62 - "Community 62"
|
||
Cohesion: 0.33
|
||
Nodes (14): Fingerprint, CheckFingerprint(), path, Crc32c(), main(), ReadFile(), ReassembleUncompressed(), TestCapabilityReportVector() (+6 more)
|
||
|
||
### Community 63 - "Community 63"
|
||
Cohesion: 0.17
|
||
Nodes (10): _local_model_path(), model_metadata_for(), ModelPreset, Path, Curated list of models supported by the network with VRAM requirements., Resolve a curated name, repository, or alias case-insensitively., Return operator-facing model metadata for a HuggingFace repo., Return VRAM requirement in GB for the given quantization. (+2 more)
|
||
|
||
### Community 64 - "Community 64"
|
||
Cohesion: 0.15
|
||
Nodes (6): GenerationTelemetry, Bounded, in-process telemetry for distributed activation seams. The generation…, Attach compression work to the same bounded seam aggregate., Aggregate activation measurements for one stable Route Session., Record one activation locally and say whether a summary is due., _SeamAggregate
|
||
|
||
### Community 65 - "Community 65"
|
||
Cohesion: 0.16
|
||
Nodes (6): _Listener, _local_ip(), MdnsDiscovery, mDNS peer discovery using zeroconf (optional dependency). Falls back gracefully…, Internal zeroconf service listener., Announce this node on mDNS and discover peers on the same LAN. If `zeroconf` is…
|
||
|
||
### Community 66 - "Community 66"
|
||
Cohesion: 0.13
|
||
Nodes (5): BillingLedger, Wallets due a payout: pending ≥ threshold OR pending age ≥ max_period, never…, Settlement batches whose pending was debited but whose transaction has not been…, Thread-safe USDT ledger with SQLite persistence and event replication., Aggregate charge totals without per-request records (dashboard summary).
|
||
|
||
### Community 67 - "Community 67"
|
||
Cohesion: 0.14
|
||
Nodes (6): NodeGossip, CRDT gossip for node liveness heartbeats. Uses a last-write-wins (LWW) register…, LWW gossip table for inference-node heartbeat timestamps. ``record(node_id)``…, Record a heartbeat for *node_id* at *wall_ts* (default: now)., Merge a gossip snapshot from a peer tracker (LWW per key)., Return wall-clock timestamp of last known heartbeat, or None.
|
||
|
||
### Community 68 - "Community 68"
|
||
Cohesion: 0.21
|
||
Nodes (10): AdmissionRequirement, admit(), CapabilityAdmissionError, _diagnostics_suffix(), _mismatch(), RuntimeError, Fail-closed admission: no routable registration without a fresh matching proof.…, Return `report` if it admits `requirement`; otherwise refuse to register.… (+2 more)
|
||
|
||
### Community 69 - "Community 69"
|
||
Cohesion: 0.14
|
||
Nodes (6): Grant the one-time Caller Credit for an account (US-039). The event id is…, Bind a client wallet pubkey to an API key (US-032 deposits, C6). A wallet…, Credit an on-chain deposit exactly once. The event id embeds the transaction…, Record the on-chain transaction signature for a settlement batch., Deduct a paid-out amount from a node's pending balance (US-033 hook). ADR-0015:…, Apply peer events not yet seen locally. Returns how many applied.
|
||
|
||
### Community 70 - "Community 70"
|
||
Cohesion: 0.18
|
||
Nodes (11): _api_key_from_headers(), Resolve the caller to (role, account). Roles: "validator" (service token),…, Bind a client wallet pubkey to an API key (US-032, C6). Deposits from that…, _session_token_from_headers(), b58decode(), binding_message(), Ed25519 proof-of-ownership for client wallet binding (ADR-0017 §5, issue C6).…, Decode a base58 string (Solana/Bitcoin alphabet) to bytes. (+3 more)
|
||
|
||
### Community 71 - "Community 71"
|
||
Cohesion: 0.21
|
||
Nodes (8): _notify_slash(), Solana contract boundary for the Distributed Inference Network. The prototype…, Completed inference data consumed by fraud validators., Local slash transaction receipt., Validation event log consumed by the optimistic fraud detector., SlashReceipt, ValidationContract, ValidationEvent
|
||
|
||
### Community 72 - "Community 72"
|
||
Cohesion: 0.19
|
||
Nodes (6): ApiKeyBalance, ComputeAttribution, PaymentContract, Client API key payment account balance., On-chain work attribution recorded by the gateway after inference., Payment wrapper for funded API keys and compute attribution.
|
||
|
||
### Community 73 - "Community 73"
|
||
Cohesion: 0.17
|
||
Nodes (13): DecodeStep, encode_bundle(), encode_decode_step(), Encode a decode boundary, retaining the deliberate compact fallback., Reject an oversized complete stream frame, including protobuf overhead. Bundle…, validate_session_message_size(), canonical_decode_step(), canonical_session_request() (+5 more)
|
||
|
||
### Community 74 - "Community 74"
|
||
Cohesion: 0.18
|
||
Nodes (7): Path, Single-process stub node that returns fixed inference responses. shard_start /…, True if this node received an activation tensor since it was started., Number of binary /forward chunks handled since this node was started., _StubHTTPServer, StubNodeServer, _attach_relay_bridge()
|
||
|
||
### Community 75 - "Community 75"
|
||
Cohesion: 0.21
|
||
Nodes (11): cert_fingerprint(), generate_self_signed_cert(), make_client_ssl_context(), make_server_ssl_context(), Path, TLS certificate generation and fingerprint helpers for node-to-node comms., Return a client SSLContext. verify=False for self-signed TOFU connections., Generate a self-signed RSA-2048 cert valid for 10 years. Returns (cert_path,… (+3 more)
|
||
|
||
### Community 76 - "Community 76"
|
||
Cohesion: 0.23
|
||
Nodes (8): _ceiling(), _false_positive_rate(), _floor(), _percentile(), TOPLOC honest-noise calibration corpus (ADR-0018 consequences, issue 21).…, Fraction of the (honest, by construction) corpus that would be flagged by the…, Whether the corpus is broad enough to enable production thresholds. Alpha…, Recommended tolerance constants derived from the corpus. `exp_intersections`…
|
||
|
||
### Community 77 - "Community 77"
|
||
Cohesion: 0.20
|
||
Nodes (7): _positive_env(), PrefillTransferLimits, Bounded, ordered prefill transfer primitives. Prefill chunks mutate the…, Configuration for one ordered prefill seam., Current peers require ordered session-cache mutation, hence one ack., Hard accounting bound, including any future wider ack window., _chunk_token_count()
|
||
|
||
### Community 78 - "Community 78"
|
||
Cohesion: 0.31
|
||
Nodes (10): _cmd_config(), Print current config., config_path(), delete_config(), load_config(), Path, Persistent node configuration — stored in ~/.config/meshnet/config.json., Return parsed config dict, or None if no config file exists. (+2 more)
|
||
|
||
### Community 79 - "Community 79"
|
||
Cohesion: 0.18
|
||
Nodes (8): _detect_layers(), DoctorResult, Path, The outcome of a doctor run over one or more recipes., Write the capability report(s) as JSON. A failed run writes too., The human summary: what was validated, what to do if it failed., render_result(), write_reports()
|
||
|
||
### Community 80 - "Community 80"
|
||
Cohesion: 0.18
|
||
Nodes (6): The pinned, self-consistent GLM-5.2 ``UD-IQ1_S`` target., Reject any target whose revisions are not the ones alpha was locked against.…, One GGUF shard of the alpha artifact., require_pinned_target(), Shard, TargetManifest
|
||
|
||
### Community 81 - "Community 81"
|
||
Cohesion: 0.22
|
||
Nodes (9): _hive_digest(), is_validator_token(), Unified tracker auth primitives (ADR-0017, alpha issues 01/02/20). Two…, Headers a tracker attaches when pushing gossip to a hive peer., True only when the request carries a fresh, valid hive signature. Fails closed:…, Constant-time check of a presented bearer token against the configured…, sign_hive_request(), verify_hive_request() (+1 more)
|
||
|
||
### Community 82 - "Community 82"
|
||
Cohesion: 0.29
|
||
Nodes (3): Thread-safe registry wallet event log with SQLite persistence., _registry_wallet_with(), RegistryEventLog
|
||
|
||
### Community 83 - "Community 83"
|
||
Cohesion: 0.22
|
||
Nodes (7): BoundedPrefillSender, Event, Release accounting after cancellation or route failure. The sender deliberately…, Send lazily-produced chunks with bounded ownership and ordered acks., Forward chunks in source order, releasing each body after its ack. ``forward``…, R, T
|
||
|
||
### Community 84 - "Community 84"
|
||
Cohesion: 0.20
|
||
Nodes (8): default_flow_control(), canonical_capability_report(), canonical_payload(), Canonical conformance vectors for the native Shard protocol. Two independently-…, The canonical capability report a worker answers admission with., Serialize deterministically, so committed golden bytes are stable., Deterministic bfloat16-sized payload for the canonical tensor., serialize()
|
||
|
||
### Community 85 - "Community 85"
|
||
Cohesion: 0.25
|
||
Nodes (5): Summary returned by an epoch settlement transaction., Settlement wrapper that debits clients and credits token rewards., Return the configured manual testnet deployment targets., SettlementContract, SettlementResult
|
||
|
||
### Community 86 - "Community 86"
|
||
Cohesion: 0.39
|
||
Nodes (7): _banned_route_wallet(), _get_json(), _ModelUnavailable, Exception, HTTPError, _safe_error_body(), _TrackerUnavailable
|
||
|
||
### Community 87 - "Community 87"
|
||
Cohesion: 0.31
|
||
Nodes (4): An immutable, request-owned binary activation payload. ``body`` is always the…, TensorPayload, ActivationEnvelope, Versioned envelope for shard activation traffic.
|
||
|
||
### Community 88 - "Community 88"
|
||
Cohesion: 0.22
|
||
Nodes (6): canonical_sha256(), _digest(), SHA-256 over canonical JSON — the repository's digest convention., The artifact half of the compatibility fingerprint. Commits to the source…, The recipe half of the compatibility fingerprint., This Shard's own bytes and exact range, bound to the source artifact. The…
|
||
|
||
### Community 89 - "Community 89"
|
||
Cohesion: 0.29
|
||
Nodes (8): _detect_num_layers(), _downloaded_model_inventory(), _model_cache_path(), Path, Only checksum tiny stub shards; real model folders are too large to hash at…, Fetch num_hidden_layers from HuggingFace model config (downloads ~1 KB…, Return a cheap local inventory record without reading model file contents., _registration_shard_checksum()
|
||
|
||
### Community 90 - "Community 90"
|
||
Cohesion: 0.32
|
||
Nodes (7): _generate_keypair(), load_or_create_identity(), _peer_id_from_pubkey(), Path, Peer identity — stable peer_id and RSA keypair, persisted to disk., Return (private_key_pem, public_key_pem) for a new RSA-2048 keypair., Return identity dict with peer_id, private_key_pem, public_key_pem. Creates and…
|
||
|
||
### Community 92 - "Community 92"
|
||
Cohesion: 0.29
|
||
Nodes (4): ChunkInfo, PrefillChunk, One token-aligned slice of a prefill., PositionSpan
|
||
|
||
### Community 93 - "Community 93"
|
||
Cohesion: 0.29
|
||
Nodes (3): _LocalContractState, LocalSolanaContracts, Facade that exposes all three contract wrappers over local validator state.
|
||
|
||
### Community 94 - "Community 94"
|
||
Cohesion: 0.29
|
||
Nodes (3): _normalize_rates(), Off-chain USDT billing ledger (ADR-0015, US-031). Tracks client API-key…, Coerce a price spec into an (input_per_1k, output_per_1k) pair.
|
||
|
||
### Community 95 - "Community 95"
|
||
Cohesion: 0.40
|
||
Nodes (5): _b58encode(), load_or_create_wallet(), Path, Solana wallet management — load or generate an Ed25519 keypair. Solana keypair…, Return (secret_32, public_32, address_base58). Loads from *path* if it exists;…
|
||
|
||
### Community 96 - "Community 96"
|
||
Cohesion: 0.33
|
||
Nodes (3): Debit the client and split the fee 90/10. With…, Blended (average) per-1k rate — kept for estimators and history logs., (input_per_1k, output_per_1k) for a model (US-045).
|
||
|
||
### Community 97 - "Community 97"
|
||
Cohesion: 0.40
|
||
Nodes (3): canonical_sha256(), Stable identity of this manifest, for the DGR-003 runtime recipe., SHA-256 over canonical JSON — the repository's digest convention.
|
||
|
||
### Community 99 - "Community 99"
|
||
Cohesion: 0.50
|
||
Nodes (4): _coverage_map_detailed(), _node_health(), Per-node health detail for the availability map., Like _coverage_map but with per-node identity and health in each band. Includes…
|
||
|
||
### Community 100 - "Community 100"
|
||
Cohesion: 0.67
|
||
Nodes (3): HTTPError, Describe an HTTP rejection from the tracker, including its JSON error., _tracker_http_error_message()
|
||
|
||
## Knowledge Gaps
|
||
- **16 isolated node(s):** `meshnet-contracts`, `meshnet-gateway`, `CapabilityRequest`, `HealthRequest`, `HealthResponse` (+11 more)
|
||
These have ≤1 connection - possible missing edges or undocumented components.
|
||
- **23 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
|
||
|
||
## Suggested Questions
|
||
_Questions this graph is uniquely positioned to answer:_
|
||
|
||
- **Why does `_coverage_map_detailed()` connect `Community 99` to `Tracker Routing & Placement`, `Community 48`, `Tracker Admin & Network APIs`?**
|
||
_High betweenness centrality (0.315) - this node is a cross-community bridge._
|
||
- **Why does `DerivativeBinding` connect `Native Worker Adapter` to `Community 40`, `Community 48`?**
|
||
_High betweenness centrality (0.261) - this node is a cross-community bridge._
|
||
- **Why does `NativeWorkerBackendAdapter` connect `Native Worker Adapter` to `Node Capability Reports`, `Node Diagnostics`, `Community 79`, `Community 48`, `Community 23`?**
|
||
_High betweenness centrality (0.186) - this node is a cross-community bridge._
|
||
- **Are the 18 inferred relationships involving `_TrackerHandler` (e.g. with `AccountStore` and `BillingLedger`) actually correct?**
|
||
_`_TrackerHandler` has 18 INFERRED edges - model-reasoned connections that need verification._
|
||
- **Are the 18 inferred relationships involving `_NodeEntry` (e.g. with `AccountStore` and `BillingLedger`) actually correct?**
|
||
_`_NodeEntry` has 18 INFERRED edges - model-reasoned connections that need verification._
|
||
- **Are the 10 inferred relationships involving `BillingLedger` (e.g. with `_ActiveProxyContext` and `_ModelStats`) actually correct?**
|
||
_`BillingLedger` has 10 INFERRED edges - model-reasoned connections that need verification._
|
||
- **Are the 9 inferred relationships involving `TorchModelShard` (e.g. with `ActivationEnvelope` and `_DirectHopClient`) actually correct?**
|
||
_`TorchModelShard` has 9 INFERRED edges - model-reasoned connections that need verification._ |