feat(plugin): session-recap injection — personalized onset greeting

[jeonghun-jj-lee]

Summary

Implements #523 — injects a ## Recent sessions (last 7 days) block into the system prompt so the onset router can personalize its greeting from actual session history, rather than depending on vault files only populated by dream-cycle workflows.

What changed

File	Role
opencode-plugin/session_recap.ts	Core module: DB read (bun:sqlite), filtering, caching, mechanical recap extraction, markdown composition
opencode-plugin/amicode_context.ts	Hook wiring: now async, passes sessionID from input, calls buildRecentSessionsBlock
test/session_recap.test.ts	26 unit tests covering all pure logic paths

Design pivot from issue

The issue assumed client.sessions.list() via a PluginInput SDK handle — investigation showed the plugin receives no client. Pivoted to reading the SQLite DB directly via bun:sqlite (Bun built-in, zero deps). Same outcome, simpler surface.

Deferred

• LLM summarization — the mechanical extract (first user prompt + numerical outcomes) is good enough for v1. LLM recaps need provider config the plugin doesn't have access to; will follow up once the small-model hook is wired.
• Latency AC (< 3s for 5 sessions) — mechanical extraction is ~instant; the latency criterion is satisfied trivially without parallelism.

Test results

• 26 new tests pass (filtering, outcome extraction, composition, caching, graceful degradation)
• Full fast suite: 106/106 files, 1505/1505 tests pass
• 2 pre-existing flaky E2E failures (binary server timeout) — unrelated

Closes #523

Summary by CodeRabbit

• New Features

  • Added recent session recaps to context, helping maintain continuity across conversations.
  • Onboarding now includes available profile scoring information.
  • Explicit onboarding requests can resume an existing profile or restart from Stage 1.

• Improvements

  • Removed the “Design a new pulse” option from onboarding choices.
  • Session recap generation and storage now degrade gracefully when unavailable.

• Tests

  • Added coverage for session filtering, recap formatting, caching, and onboarding routing.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 83248ee0-96e8-4e4d-b79d-2cea6edb1a92

📥 Commits

Reviewing files that changed from the base of the PR and between a8d33df and c953b46.

📒 Files selected for processing (7)

• packages/extension/opencode-plugin/amicode_context.ts
• packages/extension/opencode-plugin/session_recap.ts
• packages/extension/src/opencode_config.ts
• packages/extension/src/scores/router.ts
• packages/extension/test/scores/entitlements_router.test.ts
• packages/extension/test/scores/golden/router-section.md
• packages/extension/test/session_recap.test.ts

---

📝 Walkthrough

Walkthrough

The plugin adds cached recent-session recaps to system prompts. Onboarding content now includes the overture score, handles completed profiles, and removes the pulse-designer option. Tests cover recap behavior and updated routing output.

Changes

Session recap injection

Layer / File(s)	Summary
Session recap pipeline packages/extension/opencode-plugin/session_recap.ts, packages/extension/test/session_recap.test.ts	The new pipeline filters recent sessions, extracts outcomes, reads and writes cached JSON recaps, renders Markdown, and degrades gracefully when SQLite or filesystem operations fail.
System prompt recap injection packages/extension/opencode-plugin/amicode_context.ts	The asynchronous system transform builds a recap block for the current session and appends it when available. Recap failures are logged and suppressed.

Onboarding routing updates

Layer / File(s)	Summary
Onboarding completion and choices packages/extension/src/opencode_config.ts, packages/extension/src/scores/router.ts, packages/extension/test/scores/entitlements_router.test.ts, packages/extension/test/scores/golden/router-section.md	Post-onboarding content includes the compiled overture score. Completed onboarding offers profile retention or reset. The pulse-designer option is removed and routing expectations are updated.

Estimated code review effort: 4 (Complex) | ~45 minutes

Suggested reviewers: aarontrowbridge

✨ 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 523-featplugin-session-recap-injection-smart-onset-greeting-from-session-history

---

_{Comment @coderabbitai help to get the list of available commands.}