Add plan and task indicators to session list

Session list now shows plan slugs and task progress bars when sessions
have associated plans or team tasks. Loads plans once and indexes by
slug, caches task summaries per team name. Includes text and JSON
output support with full test coverage.

Author: AnExiledDev

cli/src/commands/session/list.ts

@@ -2,11 +2,14 @@ import chalk from "chalk";
 import type { Command } from "commander";
 import { basename } from "path";
 import { loadHistory } from "../../loaders/history-loader.js";
+import { loadPlans } from "../../loaders/plan-loader.js";
 import { extractSessionMeta } from "../../loaders/session-meta.js";
+import { loadTasks } from "../../loaders/task-loader.js";
 import {
 	formatSessionListJson,
 	formatSessionListText,
 	type SessionListEntry,
+	type TaskSummary,
 } from "../../output/session-list.js";
 import { discoverSessionFiles } from "../../utils/glob.js";
 import { parseRelativeTime, parseTime } from "../../utils/time.js";
@@ -78,6 +81,39 @@ export function registerListCommand(parent: Command): void {
 					entries.push({ summary, meta });
 				}
 
+				// Load plans once and index by slug
+				const plans = await loadPlans();
+				const planSlugs = new Set(plans.map((p) => p.slug));
+
+				// Cache tasks by team name
+				const taskCache = new Map<string, TaskSummary>();
+
+				for (const entry of entries) {
+					// Plan indicator: match session slug to plan slug
+					if (entry.meta?.slug && planSlugs.has(entry.meta.slug)) {
+						entry.planSlug = entry.meta.slug;
+					}
+
+					// Task indicator: only load for sessions with teamName
+					if (entry.meta?.teamName) {
+						const teamName = entry.meta.teamName;
+						if (!taskCache.has(teamName)) {
+							const tasks = await loadTasks({ team: teamName });
+							taskCache.set(teamName, {
+								total: tasks.length,
+								completed: tasks.filter((t) => t.status === "completed").length,
+								inProgress: tasks.filter((t) => t.status === "in_progress")
+									.length,
+								pending: tasks.filter((t) => t.status === "pending").length,
+							});
+						}
+						const ts = taskCache.get(teamName)!;
+						if (ts.total > 0) {
+							entry.taskSummary = ts;
+						}
+					}
+				}
+
 				if (options.format === "json") {
 					console.log(formatSessionListJson(entries));
 				} else {

cli/src/output/session-list.ts

@@ -2,9 +2,25 @@ import chalk from "chalk";
 import type { SessionSummary } from "../loaders/history-loader.js";
 import type { SessionMeta } from "../loaders/session-meta.js";
 
+export interface TaskSummary {
+	total: number;
+	completed: number;
+	inProgress: number;
+	pending: number;
+}
+
 export interface SessionListEntry {
 	summary: SessionSummary;
 	meta?: SessionMeta;
+	planSlug?: string;
+	taskSummary?: TaskSummary;
+}
+
+function formatTaskBar(ts: TaskSummary): string {
+	const filled = ts.completed;
+	const total = ts.total;
+	const bar = "\u2588".repeat(filled) + "\u2591".repeat(total - filled);
+	return `[${bar}] ${filled}/${total} tasks`;
 }
 
 function formatTimestamp(iso: string): string {
@@ -50,6 +66,17 @@ export function formatSessionListText(
 		const end = formatTimestamp(summary.timestamps.last);
 		const msgPart = meta ? `  (${meta.messageCount} messages)` : "";
 		lines.push(`  ${start} \u2192 ${end}${msgPart}`);
+
+		const indicators: string[] = [];
+		if (entry.planSlug) {
+			indicators.push(chalk.cyan(`plan: ${entry.planSlug}`));
+		}
+		if (entry.taskSummary && entry.taskSummary.total > 0) {
+			indicators.push(formatTaskBar(entry.taskSummary));
+		}
+		if (indicators.length > 0) {
+			lines.push(`  ${indicators.join("  ")}`);
+		}
 		lines.push("---");
 	}
 
@@ -71,6 +98,8 @@ export function formatSessionListJson(entries: SessionListEntry[]): string {
 				start: summary.timestamps.first,
 				end: summary.timestamps.last,
 			},
+			plan: entry.planSlug ?? null,
+			taskSummary: entry.taskSummary ?? null,
 		};
 	});
 

cli/tests/session-list.test.ts

@@ -5,6 +5,7 @@ import {
 	formatSessionListJson,
 	formatSessionListText,
 	type SessionListEntry,
+	type TaskSummary,
 } from "../src/output/session-list.js";
 
 const makeSummary = (overrides?: Partial<SessionSummary>): SessionSummary => ({
@@ -172,3 +173,115 @@ describe("session list formatter", () => {
 		expect(output).toContain("0 sessions listed");
 	});
 });
+
+describe("session list plan and task indicators", () => {
+	test("text format shows plan indicator", () => {
+		const entries: SessionListEntry[] = [
+			{
+				summary: makeSummary(),
+				meta: makeMeta(),
+				planSlug: "wondrous-rainbow",
+			},
+		];
+		const output = formatSessionListText(entries, { noColor: true });
+		expect(output).toContain("plan: wondrous-rainbow");
+	});
+
+	test("text format shows task progress bar", () => {
+		const ts: TaskSummary = {
+			total: 4,
+			completed: 2,
+			inProgress: 1,
+			pending: 1,
+		};
+		const entries: SessionListEntry[] = [
+			{
+				summary: makeSummary(),
+				meta: makeMeta(),
+				taskSummary: ts,
+			},
+		];
+		const output = formatSessionListText(entries, { noColor: true });
+		expect(output).toContain("2/4 tasks");
+		expect(output).toContain("\u2588");
+		expect(output).toContain("\u2591");
+	});
+
+	test("text format shows both plan and tasks", () => {
+		const ts: TaskSummary = {
+			total: 4,
+			completed: 2,
+			inProgress: 1,
+			pending: 1,
+		};
+		const entries: SessionListEntry[] = [
+			{
+				summary: makeSummary(),
+				meta: makeMeta(),
+				planSlug: "test-plan",
+				taskSummary: ts,
+			},
+		];
+		const output = formatSessionListText(entries, { noColor: true });
+		expect(output).toContain("plan:");
+		expect(output).toContain("tasks");
+	});
+
+	test("text format omits indicator line when neither present", () => {
+		const entries: SessionListEntry[] = [
+			{
+				summary: makeSummary(),
+				meta: makeMeta(),
+			},
+		];
+		const output = formatSessionListText(entries, { noColor: true });
+		expect(output).not.toContain("plan:");
+		expect(output).not.toContain("tasks");
+	});
+
+	test("JSON format includes plan field", () => {
+		const entries: SessionListEntry[] = [
+			{
+				summary: makeSummary(),
+				meta: makeMeta(),
+				planSlug: "test-plan",
+			},
+		];
+		const output = formatSessionListJson(entries);
+		const parsed = JSON.parse(output);
+		expect(parsed[0].plan).toBe("test-plan");
+	});
+
+	test("JSON format includes taskSummary field", () => {
+		const ts: TaskSummary = {
+			total: 4,
+			completed: 2,
+			inProgress: 1,
+			pending: 1,
+		};
+		const entries: SessionListEntry[] = [
+			{
+				summary: makeSummary(),
+				meta: makeMeta(),
+				taskSummary: ts,
+			},
+		];
+		const output = formatSessionListJson(entries);
+		const parsed = JSON.parse(output);
+		expect(parsed[0].taskSummary.total).toBe(4);
+		expect(parsed[0].taskSummary.completed).toBe(2);
+	});
+
+	test("JSON format has null plan and taskSummary when absent", () => {
+		const entries: SessionListEntry[] = [
+			{
+				summary: makeSummary(),
+				meta: makeMeta(),
+			},
+		];
+		const output = formatSessionListJson(entries);
+		const parsed = JSON.parse(output);
+		expect(parsed[0].plan).toBeNull();
+		expect(parsed[0].taskSummary).toBeNull();
+	});
+});