SuperBizAgent-java/openspec/changes/archive/2026-07-21-single-react-rag-log-projections/tasks.md

Tasks: single-react-rag-log-projections

1. Projection limits and request-aware interfaces

• 1.1 Add ToolProjectionLimits with explicit item, excerpt/message, collection and total UTF-8 limits.
• 1.2 Add request-aware projector methods and adapter-facing typed execution helpers without changing the generic ToolBoundary API.

2. RAG projection and adapter

• 2.1 Implement JSON parsing, usable excerpt filtering, source/document ID fallback, deduplication, exact excerpt bounding and RagToolResult serialization.
• 2.2 Implement the RAG adapter that maps typed request JSON to the legacy knowledge tool and invokes ToolBoundary with the framework ID.
• 2.3 Add tests for field exclusion, no evidence, duplicate documents, excerpt/total bounds, malformed raw response and canonical ID preservation.

3. Query-log projection and adapter

• 3.1 Implement logical topic mapping, injected legacy Mock invocation, lookback scope construction and source_kind=MOCK.
• 3.2 Implement redaction, pattern aggregation, deterministic timeline sampling, counts and bounded serialization.
• 3.3 Add tests for scope, provenance, pattern/timeline bounds, redaction, empty result, malformed/error response and no topic discovery call.

4. Boundary integration and verification

• 4.1 Route both adapters through the existing ToolBoundary and verify raw data remains canonical-only.
• 4.2 Run focused projector/adapter/boundary tests and the prior stage regression suite.
• 4.3 Validate OpenSpec, update devflow acceptance/evidence, archive the change and commit before stage 3C.