Skip to content

Commit 0c7e0cf

Browse files
committed
docs: state what is actually built, and what is not
Both tracked design docs said "Status: proposed" for work that shipped months ago. The memory doc in particular was edited across #64/#65/#66 while its own header claimed none of it existed. Replaced the headers and the milestone list with a state AUDITED against the code rather than recalled: sessions-experience E1/E3 shipped, E4 partial, E2 NOT STARTED sessions-memory M1-M4 complete The finding worth having: **E2 — the switcher and in-panel search — is entirely unbuilt.** No search input, no filter chips, no scope switch, no keybindings; `AI: Sessions` is the only command. That is the largest remaining gap in the experience and the one users hit first once a project holds more than a screenful of sessions: the panel scrolls but does not search. Also corrected: the FLIP filter reflow was listed in E4 as an independent item, but it cannot ship before E2 — it would have no filters to reflow. Scope note: only TWO of these docs are in the repo. levelcode-chat-sessions- design.md and MEMORIES.md are UNTRACKED local drafts, so they are not repo documentation and not mine to commit. `git grep` had been silently skipping them, which is how they were miscounted as part of this debt in the first place. No code changed.
1 parent a86120a commit 0c7e0cf

2 files changed

Lines changed: 6 additions & 6 deletions

File tree

docs/levelcode-sessions-experience.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# LevelCode Sessions — Experience Design
22

3-
**Status:** proposed · **Scope:** `extensions/levelcode-ai` webview + a thin store · **Builds on:** [`levelcode-chat-sessions-design.md`](./levelcode-chat-sessions-design.md) (the persistence spine) · **Owns:** everything a user sees, touches, and feels
3+
**Status:** **partially shipped** — E1/E3 done, E4 mostly done, **E2 (search + switcher) not started**; see §10 · **Scope:** `extensions/levelcode-ai` webview + a thin store · **Builds on:** [`levelcode-chat-sessions-design.md`](./levelcode-chat-sessions-design.md) (the persistence spine) · **Owns:** everything a user sees, touches, and feels
44

55
> The spine doc answers *"how is a chat saved and resumed?"* — append-only JSONL, project-slug directories, three-tier resume. It is right, and this document does not relitigate it. This document answers the harder, unspecced half: **what is it like to live with your chat history?** That half is where Copilot and Cursor are beatable, and where an award is won or lost.
66
@@ -380,13 +380,13 @@ The webview never reads JSONL directly for the list — it reads this index (fas
380380

381381
Layered on the spine's Phase 1–4. Each phase ships something usable; none blocks on the next.
382382

383-
**E1 — the panel & the card** *(M)* — the Sessions overlay, time buckets, the rich card (title/meta/state), resume (verbatim tier), New Chat seal + fly-to-history. *Ships the moment History stops being a dropdown.* Exit: three sessions, browsable, resumable, recognizable at a glance; theme-correct in all three kinds.
383+
**E1 — the panel & the card** *(M)***shipped.**the Sessions overlay, time buckets, the rich card (title/meta/state), resume (verbatim tier), New Chat seal + fly-to-history. *Ships the moment History stops being a dropdown.* Exit: three sessions, browsable, resumable, recognizable at a glance; theme-correct in all three kinds.
384384

385-
**E2 — the switcher & search** *(M)*`⌃⌘P` fuzzy jump; in-panel search over title+files+commands; filter chips; scope switch. *Ships the keyboard-first, search-what-it-did lead over Cursor.* Exit: type a filename, resume the session that edited it, in three keystrokes.
385+
**E2 — the switcher & search** *(M)***not started.** There is no in-panel search input, no filter chips, no scope switch, and no `⌃⌘P` jump — `AI: Sessions` is the only command and there are no keybindings. This is the largest remaining gap in the experience, and the one users will notice first once a project has more than a screenful of sessions: the panel can be scrolled but not *searched*. — `⌃⌘P` fuzzy jump; in-panel search over title+files+commands; filter chips; scope switch. *Ships the keyboard-first, search-what-it-did lead over Cursor.* Exit: type a filename, resume the session that edited it, in three keystrokes.
386386

387-
**E3 — the honesty layer & rich recognition** *(M)* — activity sparkline, files-touched chips, state pills, the interrupted/reload/summarize strips, the compact-on-resume sheet. *Ships the trust story and the visual lead.* Exit: an interrupted session is unmistakable in the list and on resume; a too-big session resumes via the honest sheet.
387+
**E3 — the honesty layer & rich recognition** *(M)***shipped.** Sparkline, files-touched chips, state pills, and the compact-on-resume plan + its honest note. — activity sparkline, files-touched chips, state pills, the interrupted/reload/summarize strips, the compact-on-resume sheet. *Ships the trust story and the visual lead.* Exit: an interrupted session is unmistakable in the list and on resume; a too-big session resumes via the honest sheet.
388388

389-
**E4 — signature polish** *(S)* — the resume morph, FLIP filter reflow, sparkline draw-in, pins/tags, seal-to-history fly, empty states, export-as-Markdown. *Ships the award.* Exit: the demo reel — open, search, fork, resume-with-morph — reads as one considered product.
389+
**E4 — signature polish** *(S)*⚠️ **partial.** Shipped: pins, empty states, export-as-Markdown, Undo behind Done/Delete. Not built: the resume morph and the seal-to-history fly (animation), and the FLIP filter reflow — which cannot ship before E2 gives it filters to reflow. — the resume morph, FLIP filter reflow, sparkline draw-in, pins/tags, seal-to-history fly, empty states, export-as-Markdown. *Ships the award.* Exit: the demo reel — open, search, fork, resume-with-morph — reads as one considered product.
390390

391391
**Deliberately later:** fork-visualized-as-a-branch-graph; cross-session recall agent tool; LevelLinks share-a-run; the M9 encrypted sync of the same files.
392392

docs/levelcode-sessions-memory.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# LevelCode Sessions — Project Memory & Continuity
22

3-
**Status:** proposed · **Scope:** `extensions/levelcode-ai` + the sessions store · **Third of the triad:** [`levelcode-chat-sessions-design.md`](./levelcode-chat-sessions-design.md) stores a chat · [`levelcode-sessions-experience.md`](./levelcode-sessions-experience.md) lets you browse it · **this doc lets the project *remember itself*.**
3+
**Status:** **shipped** — M1–M4 complete (§10) · **Scope:** `extensions/levelcode-ai` + the sessions store · **Third of the triad:** [`levelcode-chat-sessions-design.md`](./levelcode-chat-sessions-design.md) stores a chat · [`levelcode-sessions-experience.md`](./levelcode-sessions-experience.md) lets you browse it · **this doc lets the project *remember itself*.**
44

55
> The wish, in the user's words: *"if in one session we tidy the CHANGELOG for v1.0.4, then a new session already knows something about what was achieved — the past experience keeps growing, and it feels like home."* That is the right ambition. It is also the feature most likely to become expensive, stale, creepy, or wrong. This document is mostly about **not** doing those four things while still delivering the magic.
66

0 commit comments

Comments
 (0)