Skip to content

Remove dead feature gate references from documentation #2098

@bug-ops

Description

@bug-ops

Summary

8 feature flags are referenced in documentation (CLAUDE.md, README.md) as feature gates, but have zero #[cfg(feature)] annotations in any .rs file. The code compiles unconditionally regardless of whether these features are specified. The documentation references are misleading.

Dead Feature Gates

Feature Evidence
graph-memory petgraph is non-optional dep; SYNAPSE, BFS, entities all compile unconditionally
orchestration zeph-orchestration is non-optional dep of zeph-core
self-learning FeedbackDetector, Wilson score, BM25+RRF compile unconditionally
qdrant qdrant-client is non-optional dep of zeph-memory and zeph-skills
router Thompson Sampling, cascade routing, RAPS all compile unconditionally
vault-age age backend compiles unconditionally
openai OpenAI provider compiles unconditionally
compatible Compatible provider compiles unconditionally

Stability Evidence

All verified across 15+ CI sessions (CI-1 through CI-61). Zero open bugs for any of these subsystems.

Scope

  • Update CLAUDE.md "Always-on features" and "Optional features" lists
  • Update README.md feature documentation
  • Clarify which features are always-on vs genuinely feature-gated
  • No Cargo.toml or code changes needed

Analysis

Full details: .local/reports/feature-stabilization-analysis.md, Section 1

Metadata

Metadata

Assignees

No one assigned

    Labels

    choreMaintenance tasksdocsDocumentationsize/SSmall PR (11-50 lines)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions