Per-project digest: 'what I worked on' view#2
Open
ezwep wants to merge 2 commits into
Open
Conversation
- Replace UNION-then-date-sort with two FTS5 queries that yield BM25
scores per matching session. Title hits get a 200pt boost so a query
match in the conversation title outranks a body-only match.
- Add a "Best match" sort option (default for active searches) and
preserve existing date/token/cost sorts when the user picks them.
- Pass the FTS5 snippet() output (with <mark> tags) back to the UI,
rendered as a highlighted excerpt under each card so users can see
why a session matches.
- Smarter query parser: multi-word input becomes implicit-AND with
prefix matching on each token; quoted phrases, NEAR, NOT, and column
filters still pass through to FTS5 verbatim.
- Surface invalid FTS syntax (e.g. unbalanced quotes) as an inline
status banner under the search input instead of silently returning
zero results.
- Return shape changed from list to {conversations, search} so the UI
can show match counts and errors. Backward-compatible array fallback
in the JS callsite.
When a single project is selected, the main panel now defaults to a
heuristic project digest that answers "what have I been working on
here." The existing usage dashboard is preserved as a peer sub-view
behind a small toggle.
Backend (dashboard_data.py):
- New get_project_digest() sources entirely from the conversations
table (one row per session) so it stays fast even on a 53k-message
index — measured ~12ms on the largest project (612 sessions).
- Computes a momentum summary: total sessions, active days, tokens,
cost, sessions in last 7d vs prior 7d, plus a trend label
("picking up" / "steady" / "winding down" / "new" / "dormant").
- 42-day daily activity timeline with session count, tokens, cost.
- Heuristic topic extraction: tokenizes titles + excerpts of the most
recent ~60 sessions, filters a curated stopword set (English + Dutch
+ dev/Claude-Code jargon), returns top 10 terms by frequency.
- Returns {unavailable: true} for "all" / null scopes so the UI can
fall back to the existing dashboard view cleanly.
API (app.py):
- New ConversationAPI.get_project_digest() exposed to the webview
frontend, mirroring the get_dashboard_payload pattern.
Frontend (templates/index.html):
- New state.mainSubView ('digest' | 'overview') persisted to
localStorage. When a single project is selected the digest is the
default; "All projects" forces the overview.
- renderMainPanel routes to renderProjectDigest when in dashboard view,
a real project is selected, and the sub-view is 'digest'.
- renderProjectDigest builds a hero card (trend chip + 6 headline
metrics), an activity timeline bar strip, a topic chip cloud sized by
frequency, and a clickable recent-sessions list that opens the
existing session detail view.
- All user-derived strings escaped via existing escHtml(); no new
dependencies; no indexer or schema changes; fully offline.
Risks addressed:
- state.view regression: every existing assignment to state.view in
the project click handler, escape handler, and overview button click
still routes correctly; the dashboard remains the fallback for "all".
- Performance: digest only reads conversations (not messages); topic
extraction capped at 60 sessions and 10 terms.
- XSS: title/excerpt/topic content all interpolated through escHtml().
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
1 participant
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.
Summary
Adds a per-project activity digest that surfaces when a single project is selected, answering "what have I been working on here?" — the missing piece users called out.
Architecture
Performance
Measured against the real index (~53k messages, 252 conversations):
Well under the 200ms budget.
Test plan