chore: generalise pre-existing roadmap-ish labels in implementation

[chrisjz]

Small docs-only cleanup (no functional change) — removes ambiguous/planning labels from shipped docstrings/comments, per the convention that roadmap/tracking labels belong in planning artefacts, not implementation code.

Changes

• LR / entropy schedule comments # Phase 1: Warmup / # Phase 2: Decay → # Stage 1 / # Stage 2 in brain/arch/lstmppo.py, qliflstm.py, _reservoir_lstm_base.py. (These were algorithmic stages, not roadmap phases — but "Phase" is the ambiguous term to avoid.)
• brain/arch/hybridquantumcortex.py module docstring: dropped the See logbook 008 for full evaluation. planning-artefact reference.

Context

These pre-existing references were surfaced while reviewing the Phase-6-T6 implementation (PR #219). Split into this separate PR to keep that change scoped to its own work.

Lint green (ruff / pyright / pre-commit).

🤖 Generated with Claude Code

Summary by CodeRabbit

• Refactor

  • Internal refactoring of brain architecture components with improved comment clarity for learning-rate scheduling phases.

• Chores

  • Updated module documentation and removed outdated reference text.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 89907660-2a05-4267-a41e-13a2aae0e0bb

📥 Commits

Reviewing files that changed from the base of the PR and between d3d532d and 4f60868.

📒 Files selected for processing (4)

• packages/quantum-nematode/quantumnematode/brain/arch/_reservoir_lstm_base.py
• packages/quantum-nematode/quantumnematode/brain/arch/hybridquantumcortex.py
• packages/quantum-nematode/quantumnematode/brain/arch/lstmppo.py
• packages/quantum-nematode/quantumnematode/brain/arch/qliflstm.py

---

📝 Walkthrough

Walkthrough

This PR standardizes learning rate scheduling terminology across three brain implementations by renaming warmup and decay phases to "Stage 1" and "Stage 2", and removes an outdated reference from the hybrid quantum cortex module docstring.

Changes

Learning rate scheduling terminology standardization

Layer / File(s)	Summary
Learning rate scheduling terminology standardization packages/quantum-nematode/quantumnematode/brain/arch/_reservoir_lstm_base.py, packages/quantum-nematode/quantumnematode/brain/arch/lstmppo.py, packages/quantum-nematode/quantumnematode/brain/arch/qliflstm.py	Unified warmup and decay phase labels in _get_current_lr() methods to use consistent "Stage 1: Warmup" and "Stage 2: Decay" terminology across the reservoir LSTM base, LSTM PPO, and QLIF LSTM brain classes. Base implementation introduces a local ep = self._episode_count variable at method entry.
Module docstring cleanup packages/quantum-nematode/quantumnematode/brain/arch/hybridquantumcortex.py	Removed outdated "See logbook 008 for full evaluation." text from module-level docstring.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Poem

🐰 A rabbit hops through stages bright,
Where warmup glows and decay takes flight,
Stage one, stage two, the labels gleam,
Standardized warmly in learning's dream! ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: renaming ambiguous/roadmap labels (e.g., 'Phase' to 'Stage') and removing planning references from implementation code.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/generalise-roadmap-refs-in-impl

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!