Remove workstream/decision tags and section banners from comments

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YShymaPrXmc3KYRUg2HMSs
This commit is contained in:
ariandClaude Sonnet 5.5 committed 2026-10-16 08:57:21 -04:00
1 parent e39d885fae
commit 8b3f91dcb7
17 files changed
+19 -35

No files matched your search

+2 -2
View File
@@ -131,8 +131,8 @@ async fn wrong_method_is_json_405() {
}
/// Stub that validates names and states like the real sources do. The fakes
/// do not validate; real validation is covered by the source unit tests
/// (WS-A/B/C). These tests prove the handlers surface the source's 400 and
/// do not validate; real validation is covered by the source unit tests.
/// These tests prove the handlers surface the source's 400 and
/// that percent-encoded `/` and `;` reach the source intact.
struct Strict;
+1 -1
View File
@@ -1,4 +1,4 @@
//! GET /api/v1/docker/* handlers (WS-E)
//! GET /api/v1/docker/* handlers
use axum::extract::rejection::QueryRejection;
use axum::extract::{Path, Query, State};
+1 -1
View File
@@ -1,4 +1,4 @@
//! GET /api/v1/journal and /journal/follow handlers (WS-E)
//! GET /api/v1/journal and /journal/follow handlers
use std::convert::Infallible;
+1 -1
View File
@@ -1,4 +1,4 @@
//! GET /api/v1/systemd/* handlers (WS-E)
//! GET /api/v1/systemd/* handlers
use axum::extract::rejection::QueryRejection;
use axum::extract::{Path, Query, State};
+2 -2
View File
@@ -1,7 +1,7 @@
//! Bearer-token auth (WS-D owns `src/auth/`).
//! Bearer-token auth.
//!
//! Failures respond `401` with `WWW-Authenticate: Bearer` and the standard
//! JSON error body (DEC-4), for both REST and `/mcp`. Apply the layer to the
//! JSON error body, for both REST and `/mcp`. Apply the layer to the
//! protected router only; `/healthz` stays outside it.
pub mod tokens;
+1 -1
View File
@@ -1,4 +1,4 @@
//! Token CRUD and the `slinuxm token` CLI (WS-D owns this file).
//! Token CRUD and the `slinuxm token` CLI.
//!
//! Tokens have the prefix `slinuxm_` and 32 random bytes. Only the sha256 hex
//! digest is stored; the plaintext is printed once on create.
+1 -1
View File
@@ -1,4 +1,4 @@
//! SQLite pool for access tokens (WS-D owns this file).
//! SQLite pool for access tokens.
use std::path::Path;
use std::time::Duration;
+1 -1
View File
@@ -1,4 +1,4 @@
//! MCP prompts: `diagnose_unit` and `container_health_report` (WS-F).
//! MCP prompts: `diagnose_unit` and `container_health_report`.
//!
//! Prompts only return instructions that tell the agent which tools to call;
//! they do not read live data themselves.
+1 -1
View File
@@ -1,4 +1,4 @@
//! MCP resources (WS-F). Resolved live on every read; not subscribable (DEC-5).
//! MCP resources. Resolved live on every read; not subscribable.
use rmcp::model::{ReadResourceResult, Resource, ResourceContents};
+1 -3
View File
@@ -1,4 +1,4 @@
//! Docker source over the unix socket via `bollard` (WS-C).
//! Docker source over the unix socket via `bollard`.
//!
//! The client is built lazily on first use, so a missing or denied socket
//! never fails startup (review G9). Every call retries the connection until it
@@ -219,8 +219,6 @@ impl DockerSource for BollardDocker {
}
}
// ---------------------------------------------------------------- helpers
/// Strip the leading `/` and reject names that could alter the request path.
fn normalize_name(name: &str) -> Result<String, AppError> {
let n = name.trim().trim_start_matches('/');
+1 -7
View File
@@ -1,5 +1,5 @@
//! Fixture-backed in-memory sources for tests and for developing surfaces
//! without systemd, journald or Docker (DEC-2).
//! without systemd, journald or Docker.
//!
//! `fake_state(config)` returns a ready `AppState`. Each fake exposes its
//! fixtures as public fields so tests can replace them.
@@ -37,8 +37,6 @@ pub fn fake_state(config: Config) -> AppState {
}
}
// ---------------------------------------------------------------- systemd
pub struct FakeSystemd {
pub units: Vec<UnitStatus>,
pub timers: Vec<TimerInfo>,
@@ -127,8 +125,6 @@ impl SystemdSource for FakeSystemd {
}
}
// ---------------------------------------------------------------- journal
pub struct FakeJournal {
pub entries: Vec<JournalEntry>,
shutdown: CancellationToken,
@@ -219,8 +215,6 @@ impl JournalSource for FakeJournal {
}
}
// ----------------------------------------------------------------- docker
pub struct FakeDocker {
pub containers: Vec<ContainerStatus>,
pub logs: Vec<LogLine>,
+1 -1
View File
@@ -1,4 +1,4 @@
//! journald source over libsystemd (WS-B).
//! journald source over libsystemd.
//!
//! `systemd::journal::Journal` is neither `Send` nor `Sync`, so every
//! sd-journal call happens inside a `spawn_blocking` closure that opens its own
-8
View File
@@ -26,8 +26,6 @@ use tokio::sync::mpsc;
use crate::error::AppError;
// ---------------------------------------------------------------- systemd
/// One row of `ListUnits`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct UnitSummary {
@@ -89,8 +87,6 @@ pub trait SystemdSource: Send + Sync {
async fn unit_status(&self, name: &str) -> Result<UnitStatus, AppError>;
}
// ---------------------------------------------------------------- journal
/// Syslog severity, 0 (most severe) to 7.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[repr(u8)]
@@ -251,8 +247,6 @@ pub trait JournalSource: Send + Sync {
async fn follow(&self, q: &JournalQuery) -> Result<mpsc::Receiver<JournalEntry>, AppError>;
}
// ----------------------------------------------------------------- docker
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct ContainerSummary {
/// Full container id.
@@ -322,8 +316,6 @@ pub trait DockerSource: Send + Sync {
) -> Result<mpsc::Receiver<LogLine>, AppError>;
}
// ---------------------------------------------------------------- helpers
/// Default value of `JournalQuery.lines` and `LogOptions.tail`.
pub const DEFAULT_LINES: usize = 100;
+1 -1
View File
@@ -1,4 +1,4 @@
//! Journal and docker log fan-out to OTel logs (WS-G).
//! Journal and docker log fan-out to OTel logs.
//!
//! Journal: one `follow()` per configured unit, or one unfiltered follow when
//! `otel.logs.journal_units` is empty. Docker: a reconciler keeps one
+2 -2
View File
@@ -1,4 +1,4 @@
//! Metrics poll loop and observable gauges (WS-G).
//! Metrics poll loop and observable gauges.
//!
//! A background task polls the sources every `metrics_interval_secs` and
//! replaces a shared snapshot. Observable gauge callbacks read the latest
@@ -57,7 +57,7 @@ pub struct Obs {
pub attrs: Vec<(&'static str, String)>,
}
/// DEC-7: empty list means `*.service` and `*.timer`; otherwise a glob allowlist.
/// empty list means `*.service` and `*.timer`; otherwise a glob allowlist.
pub fn unit_in_scope(cfg: &OtelMetricsConfig, name: &str) -> bool {
if cfg.units.is_empty() {
name.ends_with(".service") || name.ends_with(".timer")
+1 -1
View File
@@ -1,4 +1,4 @@
//! OpenTelemetry export (WS-G owns `src/telemetry/`).
//! OpenTelemetry export.
//!
//! One exporter config (`otel.endpoint`, `otel.protocol`, `otel.headers`)
//! feeds traces, metrics and logs. The app's own `tracing` events go to
+1 -1
View File
@@ -1,4 +1,4 @@
//! Native TLS (DEC-12): rustls with the `ring` provider passed explicitly to
//! Native TLS: rustls with the `ring` provider passed explicitly to
//! the config builder (nothing is installed process-wide, so the OTLP
//! clients' provider choice is unaffected). Only used when
//! `server.tls.enabled`; the plain path never touches this module.