xonecas.io
64875
Mc

mini-coder / commit 0ef0b73

feat: add /session command and session truncation

- /session: overlay Select listing sessions for current CWD, Enter resumes
- Session labels show relative timestamp + model + (current) marker
- truncateSessions(db, cwd, keep): delete oldest beyond limit per CWD
- Called on init with MAX_SESSIONS_PER_CWD = 20
- listSessions SQL uses rowid DESC tiebreaker for deterministic ordering
- Fixed flaky listSessions test (same-millisecond timestamp)
- 4 new truncation tests (162 total across 9 files)

xonecas2026-04-05 0ef0b730d113c14e2112dc6d6af280d282805080 parent 320ab5f

5 files changed

TODO.md+1−0
@@ -137,6 +137,7 @@
137137 ## Future ideas
138138
139139 - [ ] User preferences persistence (model, effort) — not in spec, currently resets to defaults on launch
140+- [ ] Session list preview — show first user message snippet in `/session` selector for easier identification
140141 - [ ] Divider theme plugin — customizable divider animations. Candidates designed during Phase 4 UI exploration:
141142 - **Scanning pulse** (current default): bright segment sweeps across the dimmed divider
142143 - **Breathing**: divider alternates between two dim levels, subtle pulse
src/index.ts+5−0
@@ -41,6 +41,7 @@ import {
4141 openDatabase,
4242 type Session,
4343 type SessionStats,
44+ truncateSessions,
4445 } from "./session.ts";
4546 import { discoverSkills, type Skill } from "./skills.ts";
4647 import { DEFAULT_THEME, mergeThemes, type Theme } from "./theme.ts";
@@ -72,6 +73,9 @@ const AUTH_PATH = join(DATA_DIR, "auth.json");
7273 /** Default effort level. */
7374 const DEFAULT_EFFORT: ThinkingLevel = "medium";
7475
76+/** Maximum sessions to keep per CWD. */
77+const MAX_SESSIONS_PER_CWD = 20;
78+
7579 // ---------------------------------------------------------------------------
7680 // OAuth credential persistence
7781 // ---------------------------------------------------------------------------
@@ -334,6 +338,7 @@ export async function init(): Promise<AppState> {
334338 model: modelLabel,
335339 effort,
336340 });
341+ truncateSessions(db, cwd, MAX_SESSIONS_PER_CWD);
337342 const messages = loadMessages(db, session.id);
338343 const stats = computeStats(messages);
339344
src/session.test.ts+70−3
@@ -15,6 +15,7 @@ import {
1515 listSessions,
1616 loadMessages,
1717 openDatabase,
18+ truncateSessions,
1819 undoLastTurn,
1920 } from "./session.ts";
2021
@@ -117,12 +118,15 @@ describe("session persistence", () => {
117118 const s2 = createSession(db, { cwd: "/tmp/a" });
118119 createSession(db, { cwd: "/tmp/b" }); // different cwd
119120
120- // Touch s1 so it becomes more recent
121- appendMessage(db, s1.id, makeUser("hello"));
121+ // Explicitly bump s1's updated_at so it sorts first
122+ db.run("UPDATE sessions SET updated_at = ? WHERE id = ?", [
123+ Date.now() + 1000,
124+ s1.id,
125+ ]);
122126
123127 const list = listSessions(db, "/tmp/a");
124128 expect(list).toHaveLength(2);
125- // s1 was updated more recently (message appended)
129+ // s1 was updated more recently
126130 expect(list[0]?.id).toBe(s1.id);
127131 expect(list[1]?.id).toBe(s2.id);
128132 db.close();
@@ -379,3 +383,66 @@ describe("cumulative stats", () => {
379383 expect(stats.totalCost).toBe(0);
380384 });
381385 });
386+
387+describe("truncateSessions", () => {
388+ test("deletes oldest sessions beyond the keep limit for a CWD", () => {
389+ const db = openDatabase(":memory:");
390+ const ids: string[] = [];
391+ for (let i = 0; i < 5; i++) {
392+ const s = createSession(db, { cwd: "/tmp/test" });
393+ ids.push(s.id);
394+ }
395+
396+ truncateSessions(db, "/tmp/test", 3);
397+
398+ const remaining = listSessions(db, "/tmp/test");
399+ expect(remaining).toHaveLength(3);
400+ // Most recent 3 survive (listSessions returns newest first)
401+ expect(remaining.map((s) => s.id)).toEqual([ids[4], ids[3], ids[2]]);
402+ db.close();
403+ });
404+
405+ test("no-op when session count is within the limit", () => {
406+ const db = openDatabase(":memory:");
407+ for (let i = 0; i < 3; i++) {
408+ createSession(db, { cwd: "/tmp/test" });
409+ }
410+
411+ truncateSessions(db, "/tmp/test", 5);
412+
413+ const remaining = listSessions(db, "/tmp/test");
414+ expect(remaining).toHaveLength(3);
415+ db.close();
416+ });
417+
418+ test("does not affect sessions in other CWDs", () => {
419+ const db = openDatabase(":memory:");
420+ for (let i = 0; i < 5; i++) {
421+ createSession(db, { cwd: "/tmp/a" });
422+ }
423+ for (let i = 0; i < 3; i++) {
424+ createSession(db, { cwd: "/tmp/b" });
425+ }
426+
427+ truncateSessions(db, "/tmp/a", 2);
428+
429+ expect(listSessions(db, "/tmp/a")).toHaveLength(2);
430+ expect(listSessions(db, "/tmp/b")).toHaveLength(3);
431+ db.close();
432+ });
433+
434+ test("cascades to delete messages of truncated sessions", () => {
435+ const db = openDatabase(":memory:");
436+ const old = createSession(db, { cwd: "/tmp/test" });
437+ appendMessage(db, old.id, makeUser("hello"));
438+ const keep = createSession(db, { cwd: "/tmp/test" });
439+ appendMessage(db, keep.id, makeUser("world"));
440+
441+ truncateSessions(db, "/tmp/test", 1);
442+
443+ expect(listSessions(db, "/tmp/test")).toHaveLength(1);
444+ expect(loadMessages(db, old.id)).toHaveLength(0);
445+ expect(loadMessages(db, keep.id)).toHaveLength(1);
446+ db.close();
447+ });
448+});
src/session.ts+28−1
@@ -93,7 +93,8 @@ type DataRow = { data: string };
9393 // ---------------------------------------------------------------------------
9494
9595 const SQL = {
96- listSessions: "SELECT * FROM sessions WHERE cwd = ? ORDER BY updated_at DESC",
96+ listSessions:
97+ "SELECT * FROM sessions WHERE cwd = ? ORDER BY updated_at DESC, rowid DESC",
9798 maxTurn: "SELECT MAX(turn) as max_turn FROM messages WHERE session_id = ?",
9899 loadMessages: "SELECT data FROM messages WHERE session_id = ? ORDER BY id",
99100 } as const;
@@ -238,6 +239,32 @@ export function deleteSession(db: Database, id: string): void {
238239 db.run("DELETE FROM sessions WHERE id = ?", [id]);
239240 }
240241
242+/**
243+ * Keep only the most recent sessions for a CWD, deleting the rest.
244+ *
245+ * Sessions are ordered by `updated_at DESC`; those beyond `keep` are
246+ * deleted (cascade removes their messages too). No-op if the count is
247+ * already within the limit.
248+ *
249+ * @param db - Open database handle.
250+ * @param cwd - Working directory to scope the truncation to.
251+ * @param keep - Maximum number of sessions to retain.
252+ */
253+export function truncateSessions(
254+ db: Database,
255+ cwd: string,
256+ keep: number,
257+): void {
258+ db.run(
259+ `DELETE FROM sessions WHERE id IN (
260+ SELECT id FROM sessions WHERE cwd = ?
261+ ORDER BY updated_at DESC, rowid DESC
262+ LIMIT -1 OFFSET ?
263+ )`,
264+ [cwd, keep],
265+ );
266+}
267+
241268 // ---------------------------------------------------------------------------
242269 // Messages
243270 // ---------------------------------------------------------------------------
src/ui.ts+69−1
@@ -40,7 +40,12 @@ import {
4040 shutdown,
4141 } from "./index.ts";
4242 import { parseInput } from "./input.ts";
43-import { appendMessage, computeStats } from "./session.ts";
43+import {
44+ appendMessage,
45+ computeStats,
46+ listSessions,
47+ loadMessages,
48+} from "./session.ts";
4449 import { truncateOutput } from "./tools.ts";
4550
4651 // ---------------------------------------------------------------------------
@@ -676,6 +681,66 @@ function handleEffortCommand(state: AppState): void {
676681 cel.render();
677682 }
678683
684+/** Handle the /session command: list and resume sessions. */
685+function handleSessionCommand(state: AppState): void {
686+ const sessions = listSessions(state.db, state.cwd);
687+ if (sessions.length === 0) {
688+ return;
689+ }
690+
691+ const items = sessions.map((s) => {
692+ const date = new Date(s.updatedAt);
693+ const dateStr = formatSessionDate(date);
694+ const model = s.model ?? "no model";
695+ const current = s.id === state.session.id ? " (current)" : "";
696+ return {
697+ label: `${dateStr} ${model}${current}`,
698+ value: s.id,
699+ filterText: `${dateStr} ${model}`,
700+ };
701+ });
702+
703+ const select = Select({
704+ items,
705+ maxVisible: OVERLAY_MAX_VISIBLE,
706+ placeholder: "type to filter sessions...",
707+ focused: true,
708+ highlightColor: "color06",
709+ onSelect: (sessionId) => {
710+ if (sessionId !== state.session.id) {
711+ const picked = sessions.find((s) => s.id === sessionId);
712+ if (picked) {
713+ state.session = picked;
714+ state.messages = loadMessages(state.db, picked.id);
715+ state.stats = computeStats(state.messages);
716+ stickToBottom = true;
717+ }
718+ }
719+ dismissOverlay();
720+ },
721+ onBlur: dismissOverlay,
722+ });
723+
724+ inputFocused = false;
725+ activeOverlay = { select, title: "Resume a session" };
726+ cel.render();
727+}
728+
729+/** Format a session date for display. */
730+function formatSessionDate(date: Date): string {
731+ const now = new Date();
732+ const diffMs = now.getTime() - date.getTime();
733+ const diffMins = Math.floor(diffMs / 60_000);
734+ const diffHours = Math.floor(diffMs / 3_600_000);
735+ const diffDays = Math.floor(diffMs / 86_400_000);
736+
737+ if (diffMins < 1) return "just now";
738+ if (diffMins < 60) return `${diffMins}m ago`;
739+ if (diffHours < 24) return `${diffHours}h ago`;
740+ if (diffDays < 7) return `${diffDays}d ago`;
741+ return date.toLocaleDateString();
742+}
743+
679744 /** Dispatch a parsed command. Returns true if handled. */
680745 function handleCommand(command: string, state: AppState): boolean {
681746 switch (command) {
@@ -685,6 +750,9 @@ function handleCommand(command: string, state: AppState): boolean {
685750 case "effort":
686751 handleEffortCommand(state);
687752 return true;
753+ case "session":
754+ handleSessionCommand(state);
755+ return true;
688756 default:
689757 return false;
690758 }