Deprecate JSON hydrate endpoints; move to .deprecated/

[AdaWorldAPI]

Summary

Remove the qualia substrate JSON endpoints (/api/v1/qualia/hydrate and /api/v1/qualia/write-back) from the active server codebase and archive them in .deprecated/. This enforces the architectural principle that internal operations must never serialize to JSON—they communicate via &BindSpace borrows, not HTTP.

Key Changes

• Removed from src/bin/server.rs (−418 lines):

  • handle_qualia_hydrate() handler (~240 lines)
  • handle_qualia_writeback() handler (~100 lines)
  • Helper functions: text_to_container(), text_to_dn(), serde_json_escape()
  • Route entries for both endpoints
  • DbState fields: qualia_graph: ContainerGraph and self_dims: SelfDimensions
  • 13 imports used only by hydrate handlers (Container, PackedDn, ContainerGraph, CogRecord, ContainerGeometry, GraphMetrics, AgentState, PresenceMode, SelfDimensions, GhostEcho, GhostType, CouncilWeights, RungLevel, ContractTruthValue)

• Archived to .deprecated/pr127_128_json_hydrate/:

  • server_hydrate_block.rs — complete extracted handler code (406 lines)
  • README.md — deprecation rationale and salvage notes

• Added DEPRECATION_CHANGELOG.md:

  • Comprehensive architectural decision document explaining the RISC-not-CISC principle
  • Deprecation notes for PR feat(api): POST /api/v1/hydrate — full QualiaSnapshot endpoint #127/feat(server): POST /api/v1/qualia/hydrate + write-back — substrate-dr… #128 (ladybug-rs), PR Universal Bind Space - The DTO All Languages Hit #20 (neo4j-rs), PR Updated exports for 16 prefixes #22 (n8n-rs), PR Updated exports for 16 prefixes #29 (crewai-rust)
  • Salvage guidance for future rewrites
  • Policy enforcement rules for future PRs

Rationale

The hydrate endpoints violated the one-binary, zero-JSON-on-hot-path architecture:

1. JSON serialization forbidden internally — crates in the same binary communicate via borrows, not HTTP/JSON
2. text_to_dn() is semantically meaningless — DN paths must encode viewpoint/perspective in the tree, not hash collisions
3. Hollow pipeline — endpoints constructed empty data structures (FeltPath, VolitionalAgenda) with hardcoded defaults or random noise (ghost types via match i % 8)
4. Wrong integration model — assumed crewai-rust calls ladybug-rs via HTTP; correct model is shared &BindSpace in one binary

The route concept (message → qualia state → preamble) is sound and will be rewritten as &Container → &Container operations, not JSON endpoints.

Not Changed

• /api/v1/graph/* endpoints — unchanged
• UDP bitpacked Hamming handler — unchanged
• PR feat(qualia): felt_parse + MirrorField + TrustFabric + SoulResonance … #126 qualia stack (felt_parse, agent_state) — these are real substrate work, not JSON serialization
• All existing tests — unchanged

https://claude.ai/code/session_01PJXVVtCXFi2BvJMrM8gmwE

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.