depth-first-thinking 2.1.1 → 2.1.4

package/README.md

@@ -22,7 +22,7 @@ bun add -g depth-first-thinking
 
 ### Options
 
-- `dft delete <name> --yes` - Skip confirmation prompt when deleting
+- `dft delete <name> -y, --yes` - Skip confirmation prompt when deleting
 - `dft tree <name> --show-status` - Show status markers (default: true)
 - `dft tree <name> --no-status` - Hide status markers
 
@@ -34,9 +34,12 @@ Running `dft` without any arguments will:
 
 ## Navigation
 
-- `↑` `↓` - Select task
-- `→` `Space` `Enter` - Enter task / view subtasks
-- `←` - Go back to parent
+When you open a project, **Zen Mode** is enabled by default. In Zen Mode, only the currently selected task is displayed, while navigation still works across the full tree:
+
+- `↑` `↓` - Move between sibling tasks at the current level
+- `→` `Space` `Enter` - Enter task / view its subtasks (move deeper in the hierarchy)
+- `←` - Go back to parent task (move up in the hierarchy)
+- `m` - Toggle between **Zen Mode** (single-task view) and **List Mode** (full list at current level)
 - `n` - New subtask
 - `e` - Edit task title
 - `d` - Toggle done status

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "depth-first-thinking",
-	"version": "2.1.1",
-	"description": "A terminal-based task manager with depth-first navigation. Break down tasks into subtasks, navigate recursively, and track progress.",
+	"version": "2.1.4",
+	"description": "A terminal-based task manager with depth-first navigation.",
 	"keywords": [
 		"cli",
 		"tui",

package/src/data/types.ts

@@ -27,10 +27,13 @@ export interface ModalState {
 	selectedButton?: number;
 }
 
+export type ViewMode = "list" | "zen";
+
 export interface AppState {
 	project: Project;
 	navigationStack: string[];
 	selectedIndex: number;
+	viewMode: ViewMode;
 	modalState: ModalState | null;
 	feedbackMessage: string | null;
 	feedbackTimeout?: ReturnType<typeof setTimeout>;

package/src/index.ts

@@ -15,7 +15,7 @@ const program = new Command();
 
 program
 	.name("dft")
-	.description("Depth-First Thinking - Solve problems the depth-first way")
+	.description("A terminal-based task manager with depth-first navigation.")
 	.version(VERSION);
 
 program

package/src/tui/app.test.ts

@@ -0,0 +1,109 @@
+import { describe, expect, test } from "bun:test";
+import type { AppState, Project } from "../data/types";
+import {
+	diveIn,
+	ensureValidSelection,
+	getCurrentList,
+	goBack,
+	initializeNavigation,
+} from "./navigation";
+
+function createTestProject(): Project {
+	const now = new Date().toISOString();
+	return {
+		project_name: "Test Project",
+		version: "1.0.0",
+		created_at: now,
+		modified_at: now,
+		root: {
+			id: "root",
+			title: "Root",
+			status: "open",
+			children: [
+				{
+					id: "a",
+					title: "Task A",
+					status: "open",
+					children: [],
+					created_at: now,
+					completed_at: null,
+				},
+				{
+					id: "b",
+					title: "Task B",
+					status: "open",
+					children: [],
+					created_at: now,
+					completed_at: null,
+				},
+			],
+			created_at: now,
+			completed_at: null,
+		},
+	};
+}
+
+describe("viewMode and navigation state", () => {
+	test("initial state uses zen mode and selection is valid", () => {
+		const project = createTestProject();
+		const state: AppState = {
+			project,
+			navigationStack: [],
+			selectedIndex: 0,
+			viewMode: "zen",
+			modalState: null,
+			feedbackMessage: null,
+		};
+
+		initializeNavigation(state);
+		ensureValidSelection(state);
+
+		expect(state.viewMode).toBe("zen");
+		expect(getCurrentList(state)).toHaveLength(2);
+		expect(state.selectedIndex).toBe(0);
+	});
+
+	test("selection survives mode changes", () => {
+		const project = createTestProject();
+		const state: AppState = {
+			project,
+			navigationStack: [],
+			selectedIndex: 1,
+			viewMode: "zen",
+			modalState: null,
+			feedbackMessage: null,
+		};
+
+		// simulate toggling between modes
+		state.viewMode = "list";
+		expect(state.selectedIndex).toBe(1);
+
+		state.viewMode = "zen";
+		expect(state.selectedIndex).toBe(1);
+	});
+
+	test("going back restores parent selection", () => {
+		const project = createTestProject();
+		const state: AppState = {
+			project,
+			navigationStack: [],
+			selectedIndex: 1,
+			viewMode: "zen",
+			modalState: null,
+			feedbackMessage: null,
+		};
+
+		// Dive into Task B
+		const diveResult = diveIn(state);
+		expect(diveResult.success).toBe(true);
+		expect(state.navigationStack).toEqual(["b"]);
+
+		// Go back to parent list and expect Task B to be selected again
+		const backResult = goBack(state);
+		expect(backResult.success).toBe(true);
+		expect(state.navigationStack).toEqual([]);
+
+		const list = getCurrentList(state);
+		expect(list[state.selectedIndex]?.id).toBe("b");
+	});
+});

package/src/tui/app.ts

@@ -16,7 +16,7 @@ import {
 	toggleNodeStatus,
 } from "../data/operations";
 import { saveProject } from "../data/storage";
-import type { AppState, ModalState, Node, Project } from "../data/types";
+import type { AppState, ModalState, Node, Project, ViewMode } from "../data/types";
 import { truncate } from "../utils/formatting";
 import { validateTitle } from "../utils/validation";
 import {
@@ -62,6 +62,7 @@ export class TUIApp {
 			project,
 			navigationStack: [],
 			selectedIndex: 0,
+			viewMode: "zen",
 			modalState: null,
 			feedbackMessage: null,
 		};
@@ -110,7 +111,7 @@ export class TUIApp {
 
 		this.hintsText = new TextRenderable(this.renderer, {
 			id: "hints",
-			content: "↑↓ select  →/space enter  ← back  n new  e edit  d done  x del  q quit",
+			content: "↑↓ select  →/space enter  ← back  n new  e edit  d done  x del  m mode  q quit",
 			fg: colors.keyHints,
 			position: "absolute",
 			left: 1,
@@ -145,7 +146,12 @@ export class TUIApp {
 		const width = process.stdout.columns || 80;
 		ensureValidSelection(this.state);
 		this.breadcrumbText.content = this.formatBreadcrumb(width);
-		this.listText.content = this.formatList(width);
+		const height = process.stdout.rows || 24;
+		if (this.state.viewMode === "zen") {
+			this.listText.content = this.formatZen(width, height);
+		} else {
+			this.listText.content = this.formatList(width);
+		}
 		this.feedbackText.content = this.state.feedbackMessage || "";
 		this.updateModal();
 	}
@@ -200,6 +206,28 @@ export class TUIApp {
 		return ` [${count}]`;
 	}
 
+	private formatZen(width: number, height: number): string {
+		const selected = getSelectedNode(this.state);
+		if (!selected) {
+			return "No items. Press 'n' to create one.";
+		}
+
+		const lines: string[] = [];
+
+		const title = truncate(selected.title, width - 4);
+		const status = this.getStatusDisplay(selected);
+		const childCount = this.getChildCountDisplay(selected);
+
+		lines.push(`> ${title}${childCount}${status}`);
+
+		const availableLines = (height || 24) - 6;
+		for (let i = 1; i < availableLines; i++) {
+			lines.push("");
+		}
+
+		return lines.join("\n");
+	}
+
 	private formatList(width: number): string {
 		const list = getCurrentList(this.state);
 
@@ -388,9 +416,19 @@ export class TUIApp {
 			case "q":
 				this.quit();
 				break;
+
+			case "m":
+				this.toggleViewMode();
+				break;
 		}
 	}
 
+	private toggleViewMode(): void {
+		const currentMode: ViewMode = this.state.viewMode;
+		this.state.viewMode = currentMode === "zen" ? "list" : "zen";
+		this.showFeedback(this.state.viewMode === "zen" ? "Zen Mode" : "List Mode");
+	}
+
 	private handleNavigation(result: { success: boolean; feedbackMessage?: string }): void {
 		if (!result.success && result.feedbackMessage) {
 			this.showFeedback(result.feedbackMessage);

package/src/tui/navigation.ts

@@ -98,8 +98,15 @@ export function goBack(state: AppState): NavigationResult {
 		return { success: false, feedbackMessage: "At root" };
 	}
 
+	// Remember the node we are leaving so we can re-select it
+	// when we return to its parent list.
+	const lastId = state.navigationStack[state.navigationStack.length - 1];
 	state.navigationStack.pop();
-	state.selectedIndex = 0;
+
+	const list = getCurrentList(state);
+	const previousIndex = list.findIndex((node) => node.id === lastId);
+
+	state.selectedIndex = previousIndex >= 0 ? previousIndex : 0;
 	return { success: true };
 }
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "2.1.1";
+export const VERSION = "2.1.4";