feat: add whats-new review feed#55
Merged
Merged
Conversation
Add a derived, read-only review feed over local SQLite so CLI, HTTP, and MCP callers can review newly imported, updated, enriched, failed, or blocked evidence after a timestamp or continuation cursor. The feed normalizes event timestamps to UTC, uses deterministic cursor pagination, supports imports/enrichments/failures filters, and preserves empty arrays in structured JSON output. Expose the feed as `dbrain whats-new`, `GET /api/whats-new`, and MCP `dbrain_whats_new`. Keep the default `events` view for raw pipeline chronology and add `view=entities` for compact item/source groups with preferred summaries, collapsed event kinds, actionability, importance, and compact event refs. Add migration 11 with review-feed timestamp indexes for items, sources, feed entries, and item enrichments, and align fresh database schema creation with upgraded databases. Update command, MCP, README, route-capability, changelog, and dbrain MCP skill docs around the new agent review workflow. Behavior changes: - adds a new root CLI command and authenticated web API route - adds a new read-only MCP tool with explicit output schema - opens the CLI store normally so review-feed indexes/migrations can apply - rejects ambiguous date-only `since` values and unknown type/view filters - requires exactly one of `since` or `cursor` on all surfaces Risks: - this is a derived read-side feed, not a durable activity log, so it can only surface events with trustworthy existing timestamps - `view=entities` pagination is still event-based, so multi-page callers must de-duplicate entity rows by `entity_key` - review importance and actionability are deterministic hints, not filtering or ranking authority Follow-ups: - consider a durable `review_events` table if derived unions become ambiguous or too expensive - add agent ack/claim state, watchlists, sync cursor output, or a web review UI only after the v1 feed proves stable - add categorization events once categorization writes trustworthy timestamps
PR Diff StatsPR #55 changed 32 file(s), with +4,197 / -15 (4,212 changed lines).
Largest Changed Files
Bucket rules
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add a derived, read-only review feed over local SQLite so CLI, HTTP, and MCP callers can review newly imported, updated, enriched, failed, or blocked evidence after a timestamp or continuation cursor. The feed normalizes event timestamps to UTC, uses deterministic cursor pagination, supports imports/enrichments/failures filters, and preserves empty arrays in structured JSON output.
Expose the feed as
dbrain whats-new,GET /api/whats-new, and MCPdbrain_whats_new. Keep the defaulteventsview for raw pipeline chronology and addview=entitiesfor compact item/source groups with preferred summaries, collapsed event kinds, actionability, importance, and compact event refs.Add migration 11 with review-feed timestamp indexes for items, sources, feed entries, and item enrichments, and align fresh database schema creation with upgraded databases. Update command, MCP, README, route-capability, changelog, and dbrain MCP skill docs around the new agent review workflow.
Behavior changes:
sincevalues and unknown type/view filterssinceorcursoron all surfacesRisks:
view=entitiespagination is still event-based, so multi-page callers must de-duplicate entity rows byentity_keyFollow-ups:
review_eventstable if derived unions become ambiguous or too expensiveCloses #54