Skip to content

G144 cross-topic memory smoke and docs - #364

Merged
delete-cloud merged 1 commit into
mainfrom
codex/cross-topic-memory-g144-smoke-docs
May 23, 2026
Merged

delete-cloud merged 1 commit into
mainfrom
codex/cross-topic-memory-g144-smoke-docs

Conversation

@delete-cloud

@delete-cloud delete-cloud commented May 23, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • add cross-topic memory E2E smoke covering topic range search, Bee-derived memory, review, recall anchors/context, console, and metrics
  • add cross-topic memory usage and implementation report docs
  • complete ADR-0046 final acceptance criteria

Verification

  • uv run pytest tests/coding_agent/test_cross_topic_memory_smoke.py -v
  • uv run pytest tests/coding_agent/test_topic_range_index.py tests/coding_agent/test_topic_memory.py tests/coding_agent/test_memory_review.py tests/coding_agent/test_recall_context.py tests/coding_agent/test_recall_evaluation.py -v
  • uv run pytest tests/coding_agent/test_cross_topic_memory_smoke.py tests/coding_agent/test_topic_layer_smoke.py tests/coding_agent/test_context_system_smoke.py -v
  • uv run pytest tests/ui/test_developer_console.py tests/coding_agent/test_observability.py tests/coding_agent/test_observability_platform_smoke.py -v
  • uv run pytest tests/coding_agent/action_safety/test_safe_action_smoke.py tests/integration/test_durable_runtime_smoke.py -v
  • uv run pytest tests/coding_agent/evaluation/ -v
  • uv run pytest tests/agentkit/runtime/test_pipeline.py -k "build_context or runtime_stage_spans" -v
  • uv run ruff format --check --preview docs/cross_topic_memory/GOAL_PROGRESS.md docs/cross_topic_memory/IMPLEMENTATION_REPORT.md docs/cross_topic_memory/USAGE.md docs/adr/0046-cross-topic-memory-and-topic-range-search.md tests/coding_agent/test_cross_topic_memory_smoke.py
  • uv run ruff check tests/coding_agent/test_cross_topic_memory_smoke.py
  • git diff --check -- .

Local review: Boole found one docs precision issue; fixed and re-reviewed with no blockers.

Summary by CodeRabbit

  • Documentation

    • Added comprehensive usage guide for cross-topic memory workflows
    • Added implementation report documenting the memory system
    • Updated technical design documentation with completion status
  • Tests

    • Added end-to-end smoke test covering cross-topic memory functionality

Review Change Stack

@coderabbitai

coderabbitai Bot commented May 23, 2026 •

Copy link
Copy Markdown
Contributor

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR documents the completion of the cross-topic memory implementation phase (goals G136–G144) and validates the full feature with an end-to-end smoke test. Documentation updates mark acceptance criteria as complete, record the phase ledger, explain the implementation and usage, and provide verification commands. The smoke test exercises topic indexing, memory candidate generation, review and deduplication, cross-topic recall planning, recall rendering, Developer Console UI, Prometheus metrics recording, and sensitive-content filtering.

Changes

Cross-topic memory phase completion

Layer / File(s) Summary
Phase documentation and acceptance criteria
coding-agent/docs/adr/0046-cross-topic-memory-and-topic-range-search.md, coding-agent/docs/cross_topic_memory/GOAL_PROGRESS.md, coding-agent/docs/cross_topic_memory/IMPLEMENTATION_REPORT.md, coding-agent/docs/cross_topic_memory/USAGE.md
ADR 0046 acceptance criteria updated with test and verification checkboxes. GOAL_PROGRESS records G144 ledger entry with intended/changed files and E2E coverage. IMPLEMENTATION_REPORT documents phase scope (G136–G144), verification commands (smoke and regression tests), safety notes (evidence-only recall, explicit memory review, low-cardinality metrics, filtered rendering), and out-of-scope items. USAGE guide describes end-to-end workflow, guarantees about reference-only behavior and provenance preservation, and local smoke test commands.
End-to-end smoke test and helpers
coding-agent/tests/coding_agent/test_cross_topic_memory_smoke.py
New pytest smoke test constructs prior topic, indexes into TopicRangeIndex, generates and reviews memory candidates with deduplication, creates new topic, plans cross-topic recall via TopicRecallPlanner, records recall links to tape via FakeRecallStore, validates tape metadata and recall context payload sections, renders Developer Console memory inbox and topic detail pages with identity assertion, records Prometheus metrics with counter validation, and verifies absence of sensitive substrings. Includes _bee_artifacts(), _topic(), and _assert_no_sensitive_content() helpers.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • delete-cloud/Coding-Agent-Loop#362: Introduces recall observability features (G142 recall evaluation and metrics) exercised directly by this PR's smoke test assertions on Prometheus metric counters and sensitive-content filtering.

Poem

🐰 The memory flows from topic to topic,
Through indexing, review, and recall—
Each stage smoke-tested and doc'd,
A phase complete, from spring to fall! 📚✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly describes the main change: adding cross-topic memory smoke tests and documentation to complete goal G144, which aligns with the changeset's primary purpose.
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 codex/cross-topic-memory-g144-smoke-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@delete-cloud
delete-cloud merged commit 411e36f into main May 23, 2026
1 check was pending
@delete-cloud
delete-cloud deleted the codex/cross-topic-memory-g144-smoke-docs branch May 23, 2026 15:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant