release: v0.9.3 — DX patch (feature-flag visibility + doctor command) #198

PR
PR description

Summary

Developer-experience patch. Every disabled feature flag is now visible in the viewer, the CLI, and REST error responses, so devs no longer hit empty tabs wondering whether the install is broken or just opt-in. Adds a doctor command that diagnoses the whole stack in one shot and a first-run hero in the viewer that points at the magical-moment demo command.

Changes

New surfaces

  • agentmemory doctor — 10 diagnostic checks with fix hints on every failure
  • GET /agentmemory/config/flags — structured flag/provider/embedding state
  • Viewer banner — compact collapsible row at top of every tab
  • Viewer first-run hero — demo command prompt when sessions empty
  • Viewer footer — agentmemory viewer · v{ver} · github · docs · report issue → with preset GitHub issue body
  • Enriched empty states on Actions, Memories, Lessons, Crystals tabs

Enriched

  • status command shows provider + embedding + per-flag tick/cross
  • AGENTMEMORY_URL env now honored (was documented but ignored)
  • REST "not enabled" errors now return { error, flag, enableHow, docsHref } matching viewer banner contract

Website

  • Install section promotes demo to step 2 (magical moment on the critical path)
  • Version auto-derived via gen-meta.mjs prebuild (no more stale version drift)

Version bumps across 8 files per release checklist:

  • package.json, plugin/.claude-plugin/plugin.json, src/version.ts
  • src/types.ts (ExportData union), src/functions/export-import.ts (supportedVersions)
  • test/export-import.test.ts, packages/mcp/package.json, CHANGELOG.md

Test plan

  • npm run build — clean build
  • npm test -- test/consistency.test.ts test/export-import.test.ts — 13/13 pass
  • agentmemory doctor — 10 checks render correctly, hints shown on failures
  • agentmemory status — provider + embedding + flag table renders
  • AGENTMEMORY_URL=http://localhost:3111 agentmemory status — env honored
  • curl /agentmemory/graph/stats with flag OFF — returns { error, flag, enableHow, docsHref }
  • Viewer dashboard (live) — compact banner, expandable, dismissable
  • Viewer footer — version fills, feedback link opens pre-filled GitHub issue
  • Manual: fresh-install first-run hero (no sessions in KV)
  • Manual: agent-memory.dev landing shows v0.9.3 after website redeploy

CHANGELOG

See CHANGELOG.md [0.9.3] section for the complete list.

Summary by CodeRabbit

  • New Features
    • Added agentmemory doctor diagnostics, new REST endpoint for feature-flag metadata, and viewer banners with collapsible, dismissible, per-flag persistence and tab filtering.
    • Status/footer now show version/provider/flag info and a prefilled issue-report link.
  • Bug Fixes
    • Fixed banner scroll/layout behavior; CLI health/status honor custom server URLs/ports.
  • Documentation
    • Install guide updated to promote the demo command.
  • Chores
    • Package/site version bumped; site metadata generation updated; export format/version updated.
CUT
cutter bot commented just now

Cutter Summary

The viewer gains a collapsible feature-flags banner and a first-run hero card on the dashboard, a footer carrying the version string, and the empty Memories state is replaced with one showing a stacked-books icon and "No memories yet" copy.

preview