Skip to content

Commit ac7a375

Browse files
westgatewestgate
authored andcommitted
S188: Cross-primal doc cleanup — 550→425, capability-based language in 61 files
Replace primal-specific names (Songbird, BearDog, NestGate, Squirrel, CoralReef, BarraCuda) with capability-based language in doc comments, error messages, and user-facing strings across all crates. Remaining 425 references are intentional backward-compatibility mechanisms: serde aliases, env var fallbacks, interned string constants, and wire-protocol mapping tables. All quality gates green: fmt, clippy -D warnings, doc 0 warnings, 21,500+ tests pass with 0 failures. Made-with: Cursor
1 parent 89e959b commit ac7a375

61 files changed

Lines changed: 120 additions & 119 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

crates/auto_config/src/ai_mcp_interface/mod.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ impl AiMcpInterface {
9999

100100
/// Process MCP requests from any AI provider
101101
///
102-
/// Handles requests from Squirrel, Claude, `OpenAI`, or any MCP-compatible service
102+
/// Handles requests from intelligence services, Claude, `OpenAI`, or any MCP-compatible service
103103
pub async fn process_ai_request(
104104
&mut self,
105105
request: McpRequest,

crates/auto_config/src/ecosystem_types.rs

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,13 @@ pub struct ServicePattern {
2727
/// Type of ecosystem service
2828
#[derive(Debug, Clone, Serialize, Deserialize)]
2929
pub enum ServiceType {
30-
/// Network coordination (e.g., Songbird)
30+
/// Network coordination
3131
NetworkCoordination,
32-
/// Security and crypto (e.g., BearDog)
32+
/// Security and crypto
3333
Security,
34-
/// Storage (e.g., NestGate)
34+
/// Storage
3535
Storage,
36-
/// AI/ML compute (e.g., Squirrel)
36+
/// AI/ML compute
3737
AI,
3838
/// OS orchestration (e.g., BiomeOS)
3939
OperatingSystem,
@@ -72,7 +72,7 @@ pub struct DiscoveredServices {
7272
/// Information about a discovered service
7373
#[derive(Debug, Clone, Serialize, Deserialize)]
7474
pub struct ServiceInfo {
75-
/// Service name (e.g., "songbird", "beardog")
75+
/// Service name (e.g., "coordination", "security")
7676
pub name: String,
7777
/// Full endpoint URL
7878
pub endpoint: String,

crates/auto_config/src/error.rs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,8 @@ pub enum ToadStoolError {
3030
#[error("JSON parsing error: {0}")]
3131
Json(#[from] serde_json::Error),
3232

33-
/// External HTTP not supported; use Songbird for external HTTP.
34-
#[error("External HTTP not supported - use Songbird for external HTTP")]
33+
/// External HTTP not supported; use coordination service for external HTTP.
34+
#[error("External HTTP not supported - use coordination service for external HTTP")]
3535
ExternalHttpNotSupported,
3636

3737
/// Other auto-configuration error.

crates/auto_config/src/lib.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@
8282
//! - **Performance Classification**: Optimizes based on system capabilities
8383
//!
8484
//! ### 🌐 Ecosystem Discovery
85-
//! - **Service Discovery**: Automatically finds Songbird, `BearDog`, `NestGate`, Squirrel
85+
//! - **Service Discovery**: Automatically finds coordination, security, storage, and intelligence services
8686
//! - **Network Scanning**: Scans local networks for available services
8787
//! - **Health Monitoring**: Continuous service health assessment
8888
//! - **Auto-Integration**: Seamless ecosystem service integration

crates/cli/src/daemon/jsonrpc_server.rs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,8 +69,8 @@ pub struct ServerState {
6969

7070
/// Workload manager
7171
pub workload_manager: Arc<WorkloadManager>,
72-
// Nautilus methods are proxied to barraCuda via capability-based IPC.
73-
// No local state needed — barraCuda owns the brain.
72+
// Nautilus methods are proxied to the compute service via capability-based IPC.
73+
// No local state needed — the compute service owns the brain.
7474
}
7575

7676
/// JSON-RPC 2.0 request

crates/client/src/client/core.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -323,7 +323,7 @@ impl ToadStoolClient {
323323
/// Subscribe to server events.
324324
///
325325
/// `WebSocket` deprecated. Use JSON-RPC 2.0 polling: `compute.status` for execution
326-
/// status, `toadstool.health` for cluster health. biomeOS/songbird coordination.
326+
/// status, `toadstool.health` for cluster health via coordination service.
327327
#[expect(
328328
clippy::unused_async,
329329
reason = "API surface; may perform async I/O in future"

crates/client/src/client/types.rs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -222,8 +222,8 @@ pub struct ExecutionMetrics {
222222
/// Real-time execution events.
223223
///
224224
/// These events are NOT delivered via `WebSocket` (deprecated, used C-FFI ring).
225-
/// Use JSON-RPC 2.0 polling (`compute.status` method) or biomeOS/songbird
226-
/// coordination for event streaming over Unix sockets.
225+
/// Use JSON-RPC 2.0 polling (`compute.status` method) or coordination service
226+
/// for event streaming over Unix sockets.
227227
#[derive(Debug, Clone, Serialize, Deserialize)]
228228
pub enum ToadStoolEvent {
229229
/// Execution status changed — poll via `compute.status` JSON-RPC call.

crates/client/src/lib.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
//!
1313
//! - **JSON-RPC Client**: JSON-RPC 2.0 workload submission and status monitoring
1414
//! - **`WebSocket` Client**: Real-time event streaming and notifications
15-
//! - **Ecosystem Integration**: Direct integration with Songbird, BearDog, NestGate
15+
//! - **Ecosystem Integration**: Direct integration with coordination, security, and storage services
1616
//! - **Load Balancing**: Automatic discovery and load balancing across ToadStool nodes
1717
//! - **Retry Logic**: Configurable retry policies for resilient execution
1818
//! - **Authentication**: Support for API keys, tokens, and ecosystem authentication

crates/core/common/src/infant_discovery/detectors.rs

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@
55
//!
66
//! ToadStool only cares about **hardware capabilities** (CPU, GPU, NPU, memory).
77
//! Vendor-specific orchestration (K8s, Docker, Consul, AWS/GCP/Azure) is not
8-
//! ToadStool's concern - service discovery is delegated to Songbird (comms primal).
8+
//! ToadStool's concern - service discovery is delegated to the coordination service.
99
//!
1010
//! ## Philosophy
1111
//!
1212
//! - **Hardware-first**: We detect compute substrates, not vendor platforms
1313
//! - **Vendor-agnostic**: No K8s, Docker, cloud provider detection
14-
//! - **Songbird delegation**: mDNS/service discovery handled by comms primal
15-
//! - **Self-knowledge**: ToadStool knows its own hardware, Songbird knows the network
14+
//! - **Coordination delegation**: mDNS/service discovery handled by coordination service
15+
//! - **Self-knowledge**: ToadStool knows its own hardware, coordination service knows the network
1616
//!
1717
//! ## Evolution (Feb 15, 2026)
1818
//!
@@ -137,9 +137,9 @@ impl SubstrateDetector for BareMetalDetector {
137137
/// ## Evolution (Feb 15, 2026)
138138
///
139139
/// Only `BareMetalDetector` remains. Vendor-specific detectors removed:
140-
/// - No `KubernetesDetector` (Songbird handles service discovery)
140+
/// - No `KubernetesDetector` (coordination service handles service discovery)
141141
/// - No `DockerDetector` (container detection is generic now)
142-
/// - No `ConsulDetector` (Songbird handles service mesh)
142+
/// - No `ConsulDetector` (coordination service handles service mesh)
143143
/// - No `CloudDetector` (vendor lock-in, not our concern)
144144
#[must_use]
145145
pub fn standard_detectors() -> Vec<Box<dyn SubstrateDetector>> {

crates/core/ember/src/lend_reclaim.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
//! handle is in the consumer's possession. When the consumer is done, they
88
//! **reclaim** — ember takes the handle back and restores full ownership.
99
//!
10-
//! This models coralReef's lend/reclaim pattern for VFIO group FDs but
10+
//! This models the visualization service's lend/reclaim pattern for VFIO group FDs but
1111
//! generalizes it to any resource type.
1212
1313
use std::time::Instant;

0 commit comments

Comments
 (0)