Skip to content

Commit 8372872

Browse files
micschr0claude
andcommitted
docs(claude-md): refresh project context
- Drop stale "MQTT lands in V2" tense (V2 already shipped per Roadmap) - Surface Taskfile.yml shortcuts above raw cargo commands - Document MSRV (Rust 1.95) and mock-source feature in Stack section - Reference docs/EXTENDING.md and docs/OPERATIONS.md in Files map Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent d841143 commit 8372872

1 file changed

Lines changed: 7 additions & 1 deletion

File tree

CLAUDE.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ Rust stable, edition 2024. Tokio + axum. reqwest with rustls (no OpenSSL). thise
88

99
Always latest minor versions via Renovate. No exact pins outside `Cargo.lock`.
1010

11+
MSRV pinned to Rust 1.95 (see `Cargo.toml` workspace `rust-version`). Optional `mock-source` feature swaps LLU for an in-memory fixture for offline testing.
12+
1113
## Architecture
1214

1315
Workspace, two crates:
@@ -17,10 +19,12 @@ Workspace, two crates:
1719

1820
Flow: LibreLink Up → Source poller → in-memory reading cache → fan-out to Nightscout sink and HTTP API.
1921

20-
V1 ships one Source impl (LibreLinkUp) and one Sink impl (Nightscout v3). Trait-based design — adding sources or sinks is a new file plus a Cargo feature, not a refactor. MQTT sink lands in V2.
22+
Trait-based design — adding sources or sinks is a new file plus a Cargo feature, not a refactor. V1 shipped LLU source + Nightscout sink; V2 added MQTT v5. See Roadmap below for what's next.
2123

2224
## Commands
2325

26+
Use `task <name>` (Taskfile.yml) for the canonical workflow shortcuts (`task build-all`, `task lint`, `task test-all`, `task check`). Raw cargo commands below for reference:
27+
2428
- Build: `cargo build` / `cargo build --release`
2529
- Build with all sinks: `cargo build --features "source-llu sink-nightscout sink-mqtt"`
2630
- Test: `cargo test`
@@ -60,6 +64,8 @@ V1 ships one Source impl (LibreLinkUp) and one Sink impl (Nightscout v3). Trait-
6064
- `gluco-hub/src/e2e_tests.rs` — integration tests (wiremock)
6165
- `config.example.toml` — config schema reference
6266
- `docs/ARCHITECTURE.md` — Mermaid data-flow and sequence diagrams
67+
- `docs/EXTENDING.md` — how to add a new Source or Sink (read before scaffolding)
68+
- `docs/OPERATIONS.md` — runbook for deployment, backup, monitoring
6369

6470
## Don'ts
6571

0 commit comments

Comments
 (0)