@tomkapa/tayto 0.1.1 → 0.2.0

package/dist/{chunk-6NQOFUIQ.js → chunk-FUNYPBWJ.js}

@@ -98,10 +98,29 @@ var TaskStatus = {
   Cancelled: "cancelled"
 };
 var TaskType = {
+  Epic: "epic",
   Story: "story",
   TechDebt: "tech-debt",
   Bug: "bug"
 };
+var TaskLevel = {
+  Epic: 1,
+  Work: 2
+};
+var TYPE_TO_LEVEL = {
+  [TaskType.Epic]: TaskLevel.Epic,
+  [TaskType.Story]: TaskLevel.Work,
+  [TaskType.TechDebt]: TaskLevel.Work,
+  [TaskType.Bug]: TaskLevel.Work
+};
+function getTaskLevel(type) {
+  return TYPE_TO_LEVEL[type] ?? TaskLevel.Work;
+}
+var WORK_TYPES = /* @__PURE__ */ new Set([
+  TaskType.Story,
+  TaskType.TechDebt,
+  TaskType.Bug
+]);
 var DependencyType = {
   Blocks: "blocks",
   RelatesTo: "relates-to",
@@ -124,10 +143,13 @@ export {
   logger,
   TaskStatus,
   TaskType,
+  TaskLevel,
+  getTaskLevel,
+  WORK_TYPES,
   DependencyType,
   UIDependencyType,
   RANK_GAP,
   TERMINAL_STATUSES,
   isTerminalStatus
 };
-//# sourceMappingURL=chunk-6NQOFUIQ.js.map
+//# sourceMappingURL=chunk-FUNYPBWJ.js.map

package/dist/chunk-FUNYPBWJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/logger.ts","../src/types/enums.ts"],"sourcesContent":["import { appendFileSync, readdirSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { trace, type Span, SpanStatusCode } from '@opentelemetry/api';\n\nconst tracer = trace.getTracer('task');\nconst LOG_RETENTION_DAYS = 7;\n\nexport interface LogAttributes {\n  [key: string]: string | number | boolean;\n}\n\ntype LogLevel = 'INFO' | 'WARN' | 'ERROR';\n\nfunction formatTimestamp(): string {\n  return new Date().toISOString();\n}\n\nfunction formatAttrs(attrs?: LogAttributes): string {\n  if (!attrs || Object.keys(attrs).length === 0) return '';\n  return ' ' + JSON.stringify(attrs);\n}\n\nclass Logger {\n  private logFilePath: string | null = null;\n\n  init(logDir: string): void {\n    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD\n    this.logFilePath = join(logDir, `task-${date}.log`);\n    this.pruneOldLogs(logDir);\n  }\n\n  info(message: string, attrs?: LogAttributes): void {\n    this.write('INFO', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(message, attrs);\n    }\n  }\n\n  warn(message: string, attrs?: LogAttributes): void {\n    this.write('WARN', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`WARN: ${message}`, attrs);\n    }\n  }\n\n  error(message: string, error?: unknown, attrs?: LogAttributes): void {\n    const errorDetail = error instanceof Error ? ` | ${error.stack ?? error.message}` : '';\n    this.write('ERROR', `${message}${errorDetail}`, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`ERROR: ${message}`, attrs);\n      if (error instanceof Error) {\n        span.recordException(error);\n      }\n      span.setStatus({ code: SpanStatusCode.ERROR, message });\n    }\n  }\n\n  startSpan<T>(name: string, fn: (span: Span) => T): T {\n    return tracer.startActiveSpan(name, (span) => {\n      try {\n        const result = fn(span);\n        span.end();\n        return result;\n      } catch (e) {\n        if (e instanceof Error) {\n          span.recordException(e);\n        }\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        span.end();\n        throw e;\n      }\n    });\n  }\n\n  private write(level: LogLevel, message: string, attrs?: LogAttributes): void {\n    if (!this.logFilePath) return;\n    const line = `${formatTimestamp()} [${level}] ${message}${formatAttrs(attrs)}\\n`;\n    try {\n      appendFileSync(this.logFilePath, line);\n    } catch {\n      // Swallowing here is intentional: logging must never crash the app.\n      // If the log file is unwritable, the OTel span still captures the event.\n    }\n  }\n\n  private pruneOldLogs(logDir: string): void {\n    try {\n      const cutoff = Date.now() - LOG_RETENTION_DAYS * 24 * 60 * 60 * 1000;\n      const files = readdirSync(logDir).filter((f) => f.startsWith('task-') && f.endsWith('.log'));\n      for (const file of files) {\n        const dateStr = file.slice('task-'.length, -'.log'.length);\n        const fileDate = new Date(dateStr).getTime();\n        if (!isNaN(fileDate) && fileDate < cutoff) {\n          unlinkSync(join(logDir, file));\n        }\n      }\n    } catch {\n      // Best-effort cleanup — don't crash if pruning fails\n    }\n  }\n}\n\nexport const logger = new Logger();\n","export const TaskStatus = {\n  Backlog: 'backlog',\n  Todo: 'todo',\n  InProgress: 'in-progress',\n  Review: 'review',\n  Done: 'done',\n  Cancelled: 'cancelled',\n} as const;\nexport type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];\n\nexport const TaskType = {\n  Epic: 'epic',\n  Story: 'story',\n  TechDebt: 'tech-debt',\n  Bug: 'bug',\n} as const;\nexport type TaskType = (typeof TaskType)[keyof typeof TaskType];\n\n/**\n * Task level derived from type.\n * Level 1: epics (grouping/planning layer)\n * Level 2: stories, tech-debt, bugs (execution layer)\n */\nexport const TaskLevel = {\n  Epic: 1,\n  Work: 2,\n} as const;\nexport type TaskLevel = (typeof TaskLevel)[keyof typeof TaskLevel];\n\nconst TYPE_TO_LEVEL: Record<string, TaskLevel> = {\n  [TaskType.Epic]: TaskLevel.Epic,\n  [TaskType.Story]: TaskLevel.Work,\n  [TaskType.TechDebt]: TaskLevel.Work,\n  [TaskType.Bug]: TaskLevel.Work,\n};\n\nexport function getTaskLevel(type: string): TaskLevel {\n  return TYPE_TO_LEVEL[type] ?? TaskLevel.Work;\n}\n\n/** Types that belong to the work (level 2) execution layer. */\nexport const WORK_TYPES: ReadonlySet<string> = new Set([\n  TaskType.Story,\n  TaskType.TechDebt,\n  TaskType.Bug,\n]);\n\n/** Types stored in the database. */\nexport const DependencyType = {\n  Blocks: 'blocks',\n  RelatesTo: 'relates-to',\n  Duplicates: 'duplicates',\n} as const;\nexport type DependencyType = (typeof DependencyType)[keyof typeof DependencyType];\n\n/**\n * UI-level dependency types — includes BlockedBy which is a reverse-Blocks\n * relationship resolved before persisting to the database.\n */\nexport const UIDependencyType = {\n  ...DependencyType,\n  BlockedBy: 'blocked-by',\n} as const;\nexport type UIDependencyType = (typeof UIDependencyType)[keyof typeof UIDependencyType];\n\n/** Gap between consecutive rank values, used for insertion between neighbors. */\nexport const RANK_GAP = 1000.0;\n\n/** Statuses that represent terminal/completed task states. */\nexport const TERMINAL_STATUSES: ReadonlySet<string> = new Set([\n  TaskStatus.Done,\n  TaskStatus.Cancelled,\n]);\n\nexport function isTerminalStatus(status: string): boolean {\n  return TERMINAL_STATUSES.has(status);\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -3,12 +3,15 @@ import {
   DependencyType,
   RANK_GAP,
   TERMINAL_STATUSES,
+  TaskLevel,
   TaskStatus,
   TaskType,
   UIDependencyType,
+  WORK_TYPES,
+  getTaskLevel,
   isTerminalStatus,
   logger
-} from "./chunk-6NQOFUIQ.js";
+} from "./chunk-FUNYPBWJ.js";
 
 // src/config/index.ts
 import { mkdirSync } from "fs";
@@ -31,11 +34,11 @@ function loadConfig() {
 }
 
 // src/db/connection.ts
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
 function createDatabase(dbPath) {
-  const db = new Database(dbPath);
-  db.pragma("journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
+  const db = new DatabaseSync(dbPath);
+  db.exec("PRAGMA journal_mode = WAL");
+  db.exec("PRAGMA foreign_keys = ON");
   return db;
 }
 
@@ -67,14 +70,18 @@ function runMigrations(db) {
   for (const migration of migrations) {
     if (applied.has(migration.name)) continue;
     logger.info(`Applying migration: ${migration.name}`);
-    const migrate = db.transaction(() => {
+    db.exec("BEGIN");
+    try {
       db.exec(migration.sql);
       db.prepare("INSERT INTO _migrations (name, applied_at) VALUES (?, ?)").run(
         migration.name,
         (/* @__PURE__ */ new Date()).toISOString()
       );
-    });
-    migrate();
+      db.exec("COMMIT");
+    } catch (e) {
+      db.exec("ROLLBACK");
+      throw e;
+    }
     logger.info(`Migration applied: ${migration.name}`);
   }
 }
@@ -313,10 +320,11 @@ var SqliteTaskRepository = class {
     return logger.startSpan("TaskRepository.insert", () => {
       try {
         const now = (/* @__PURE__ */ new Date()).toISOString();
-        const maxActiveResult = this.getMaxActiveRank(input.projectId);
+        const level = getTaskLevel(input.type);
+        const maxActiveResult = this.getMaxActiveRankByLevel(input.projectId, level);
         if (!maxActiveResult.ok) return maxActiveResult;
         const maxActiveRank = maxActiveResult.value;
-        const minTerminalResult = this.getMinTerminalRank(input.projectId);
+        const minTerminalResult = this.getMinTerminalRankByLevel(input.projectId, level);
         if (!minTerminalResult.ok) return minTerminalResult;
         const minTerminalRank = minTerminalResult.value;
         let rank;
@@ -376,10 +384,21 @@ var SqliteTaskRepository = class {
         conditions.push("type = ?");
         params.push(filter.type);
       }
+      if (filter.level !== void 0) {
+        const typesForLevel = this.getTypesForLevel(filter.level);
+        const placeholders = typesForLevel.map(() => "?").join(", ");
+        conditions.push(`type IN (${placeholders})`);
+        params.push(...typesForLevel);
+      }
       if (filter.parentId) {
         conditions.push("parent_id = ?");
         params.push(filter.parentId);
       }
+      if (filter.parentIds && filter.parentIds.length > 0) {
+        const placeholders = filter.parentIds.map(() => "?").join(", ");
+        conditions.push(`parent_id IN (${placeholders})`);
+        params.push(...filter.parentIds);
+      }
       if (filter.search) {
         const ftsQuery = filter.search.trim().split(/\s+/).map((term) => `"${term.replace(/"/g, '""')}"*`).join(" ");
         conditions.push(`id IN (SELECT id FROM tasks_fts WHERE tasks_fts MATCH ?)`);
@@ -524,6 +543,65 @@ _${now}_
       return err(new AppError("DB_ERROR", "Failed to get ranked tasks", e));
     }
   }
+  getTypesForLevel(level) {
+    if (level === 1) return ["epic"];
+    return [...WORK_TYPES];
+  }
+  getMaxRankByLevel(projectId, level) {
+    try {
+      const types = this.getTypesForLevel(level);
+      const placeholders = types.map(() => "?").join(", ");
+      const row = this.db.prepare(
+        `SELECT MAX(rank) as max_rank FROM tasks WHERE project_id = ? AND ${NOT_DELETED} AND type IN (${placeholders})`
+      ).get(projectId, ...types);
+      return ok(row?.max_rank ?? 0);
+    } catch (e) {
+      return err(new AppError("DB_ERROR", "Failed to get max rank by level", e));
+    }
+  }
+  getMaxActiveRankByLevel(projectId, level) {
+    try {
+      const types = this.getTypesForLevel(level);
+      const typePlaceholders = types.map(() => "?").join(", ");
+      const row = this.db.prepare(
+        `SELECT MAX(rank) as max_rank FROM tasks WHERE project_id = ? AND ${NOT_DELETED} AND type IN (${typePlaceholders}) AND status NOT IN (${TERMINAL_PLACEHOLDERS})`
+      ).get(projectId, ...types, ...TERMINAL_STATUS_ARRAY);
+      return ok(row?.max_rank ?? 0);
+    } catch (e) {
+      return err(new AppError("DB_ERROR", "Failed to get max active rank by level", e));
+    }
+  }
+  getMinTerminalRankByLevel(projectId, level) {
+    try {
+      const types = this.getTypesForLevel(level);
+      const typePlaceholders = types.map(() => "?").join(", ");
+      const row = this.db.prepare(
+        `SELECT MIN(rank) as min_rank FROM tasks WHERE project_id = ? AND ${NOT_DELETED} AND type IN (${typePlaceholders}) AND status IN (${TERMINAL_PLACEHOLDERS})`
+      ).get(projectId, ...types, ...TERMINAL_STATUS_ARRAY);
+      return ok(row?.min_rank ?? null);
+    } catch (e) {
+      return err(new AppError("DB_ERROR", "Failed to get min terminal rank by level", e));
+    }
+  }
+  getRankedTasksByLevel(projectId, level, status) {
+    try {
+      const types = this.getTypesForLevel(level);
+      const typePlaceholders = types.map(() => "?").join(", ");
+      let sql;
+      let params;
+      if (status) {
+        sql = `SELECT * FROM tasks WHERE project_id = ? AND ${NOT_DELETED} AND type IN (${typePlaceholders}) AND status = ? ORDER BY rank ASC`;
+        params = [projectId, ...types, status];
+      } else {
+        sql = `SELECT * FROM tasks WHERE project_id = ? AND ${NOT_DELETED} AND type IN (${typePlaceholders}) ORDER BY rank ASC`;
+        params = [projectId, ...types];
+      }
+      const rows = this.db.prepare(sql).all(...params);
+      return ok(rows.map(rowToTask));
+    } catch (e) {
+      return err(new AppError("DB_ERROR", "Failed to get ranked tasks by level", e));
+    }
+  }
   search(query, projectId) {
     return logger.startSpan("TaskRepository.search", () => {
       try {
@@ -873,7 +951,10 @@ var TaskFilterSchema = z2.object({
   projectId: z2.string().optional(),
   status: z2.enum(taskStatusValues).optional(),
   type: z2.enum(taskTypeValues).optional(),
+  level: z2.number().int().min(1).max(2).optional(),
   parentId: z2.string().optional(),
+  /** Multi-select filter: show tasks whose parentId is in this list. */
+  parentIds: z2.array(z2.string()).optional(),
   search: z2.string().optional()
 });
 var RerankTaskSchema = z2.object({
@@ -902,12 +983,19 @@ var TaskServiceImpl = class {
       const projectRef = parsed.data.projectId ?? projectIdOrName;
       const projectResult = this.projectService.resolveProject(projectRef);
       if (!projectResult.ok) return projectResult;
+      const taskLevel = getTaskLevel(parsed.data.type);
+      if (taskLevel === TaskLevel.Epic && parsed.data.parentId) {
+        return err(new AppError("VALIDATION", "Epic tasks cannot have a parent"));
+      }
       if (parsed.data.parentId) {
         const parentResult = this.repo.findById(parsed.data.parentId);
         if (!parentResult.ok) return parentResult;
         if (!parentResult.value) {
           return err(new AppError("NOT_FOUND", `Parent task not found: ${parsed.data.parentId}`));
         }
+        if (getTaskLevel(parentResult.value.type) !== TaskLevel.Epic) {
+          return err(new AppError("VALIDATION", "Tasks can only be children of epic-level tasks"));
+        }
       }
       const project = projectResult.value;
       const taskIdResult = this.projectService.nextTaskId(project);
@@ -966,28 +1054,79 @@ var TaskServiceImpl = class {
         if (!blockersResult.ok) return blockersResult;
         const hasNonTerminalBlocker = blockersResult.value.some((b) => !isTerminalStatus(b.status));
         if (hasNonTerminalBlocker) {
-          return err(
-            new AppError("VALIDATION", "Task is blocked by unfinished dependencies")
-          );
+          return err(new AppError("VALIDATION", "Task is blocked by unfinished dependencies"));
         }
       }
-      if (parsed.data.status && isTerminalStatus(parsed.data.status)) {
-        const existingResult = this.repo.findById(id);
-        if (!existingResult.ok) return existingResult;
-        if (!existingResult.value) {
-          return err(new AppError("NOT_FOUND", `Task not found: ${id}`));
+      const existingResult = this.repo.findById(id);
+      if (!existingResult.ok) return existingResult;
+      if (!existingResult.value) {
+        return err(new AppError("NOT_FOUND", `Task not found: ${id}`));
+      }
+      const existing = existingResult.value;
+      if (parsed.data.type) {
+        const newLevel = getTaskLevel(parsed.data.type);
+        const oldLevel = getTaskLevel(existing.type);
+        if (newLevel !== oldLevel) {
+          if (oldLevel === TaskLevel.Epic) {
+            const childrenResult = this.repo.findMany({
+              projectId: existing.projectId,
+              parentId: id
+            });
+            if (childrenResult.ok && childrenResult.value.length > 0) {
+              return err(
+                new AppError(
+                  "VALIDATION",
+                  "Cannot change type from epic: task has children. Remove children first."
+                )
+              );
+            }
+          }
+          if (newLevel === TaskLevel.Epic && existing.parentId) {
+            return err(new AppError("VALIDATION", "Cannot change type to epic: task has a parent"));
+          }
+        }
+      }
+      if (parsed.data.parentId !== void 0) {
+        const effectiveType = parsed.data.type ?? existing.type;
+        const effectiveLevel = getTaskLevel(effectiveType);
+        if (effectiveLevel === TaskLevel.Epic && parsed.data.parentId) {
+          return err(new AppError("VALIDATION", "Epic tasks cannot have a parent"));
+        }
+        if (parsed.data.parentId) {
+          const parentResult = this.repo.findById(parsed.data.parentId);
+          if (!parentResult.ok) return parentResult;
+          if (!parentResult.value) {
+            return err(new AppError("NOT_FOUND", `Parent task not found: ${parsed.data.parentId}`));
+          }
+          if (getTaskLevel(parentResult.value.type) !== TaskLevel.Epic) {
+            return err(
+              new AppError("VALIDATION", "Tasks can only be children of epic-level tasks")
+            );
+          }
         }
-        const existing = existingResult.value;
-        const updateResult = this.repo.update(id, parsed.data);
-        if (!updateResult.ok) return updateResult;
+      }
+      if (parsed.data.status && isTerminalStatus(parsed.data.status)) {
+        const effectiveType = parsed.data.type ?? existing.type;
+        const level = getTaskLevel(effectiveType);
+        const updateResult2 = this.repo.update(id, parsed.data);
+        if (!updateResult2.ok) return updateResult2;
         if (!isTerminalStatus(existing.status)) {
-          const maxRankResult = this.repo.getMaxRank(existing.projectId);
+          const maxRankResult = this.repo.getMaxRankByLevel(existing.projectId, level);
           if (!maxRankResult.ok) return maxRankResult;
-          return this.repo.rerank(id, maxRankResult.value + RANK_GAP);
+          const rerankResult = this.repo.rerank(id, maxRankResult.value + RANK_GAP);
+          if (!rerankResult.ok) return rerankResult;
+          this.propagateParentStatus(existing);
+          return rerankResult;
         }
-        return updateResult;
+        this.propagateParentStatus(existing);
+        return updateResult2;
       }
-      return this.repo.update(id, parsed.data);
+      const updateResult = this.repo.update(id, parsed.data);
+      if (!updateResult.ok) return updateResult;
+      if (parsed.data.status && parsed.data.status !== existing.status) {
+        this.propagateParentStatus(existing);
+      }
+      return updateResult;
     });
   }
   deleteTask(id) {
@@ -1001,6 +1140,9 @@ var TaskServiceImpl = class {
         return err(new AppError("NOT_FOUND", `Parent task not found: ${parentId}`));
       }
       const parent = parentResult.value;
+      if (getTaskLevel(parent.type) !== TaskLevel.Epic) {
+        return err(new AppError("VALIDATION", "Breakdown parent must be an epic-level task"));
+      }
       const projectResult = this.projectService.resolveProject(parent.projectId);
       if (!projectResult.ok) return projectResult;
       const project = projectResult.value;
@@ -1010,6 +1152,9 @@ var TaskServiceImpl = class {
         if (!parsed.success) {
           return err(new AppError("VALIDATION", `Invalid subtask: ${parsed.error.message}`));
         }
+        if (getTaskLevel(parsed.data.type) === TaskLevel.Epic) {
+          return err(new AppError("VALIDATION", `Subtask "${parsed.data.name}" cannot be an epic`));
+        }
         const taskIdResult = this.projectService.nextTaskId(project);
         if (!taskIdResult.ok) return taskIdResult;
         const result = this.repo.insert(taskIdResult.value, {
@@ -1063,11 +1208,16 @@ var TaskServiceImpl = class {
           )
         );
       }
+      const taskLevel = getTaskLevel(task.type);
       const projectRef = projectIdOrName ?? task.projectId;
       const projectResult = this.projectService.resolveProject(projectRef);
       if (!projectResult.ok) return projectResult;
       const projectId = projectResult.value.id;
-      const rankedResult = this.repo.getRankedTasks(projectId, TaskStatus.Backlog);
+      const rankedResult = this.repo.getRankedTasksByLevel(
+        projectId,
+        taskLevel,
+        TaskStatus.Backlog
+      );
       if (!rankedResult.ok) return rankedResult;
       const ranked = rankedResult.value.filter((t) => t.id !== taskId);
       let newRank;
@@ -1151,6 +1301,42 @@ var TaskServiceImpl = class {
       return this.repo.search(query, projectId);
     });
   }
+  /**
+   * Auto-propagate status to the parent task after a child status change.
+   * - If a child moves to in-progress and parent is backlog/todo → parent becomes in-progress.
+   * - If all children are terminal (done/cancelled) → parent becomes done.
+   */
+  propagateParentStatus(child) {
+    if (!child.parentId) return;
+    const parentResult = this.repo.findById(child.parentId);
+    if (!parentResult.ok || !parentResult.value) return;
+    const parent = parentResult.value;
+    const updatedChildResult = this.repo.findById(child.id);
+    if (!updatedChildResult.ok || !updatedChildResult.value) return;
+    const updatedChild = updatedChildResult.value;
+    if (updatedChild.status === TaskStatus.InProgress && (parent.status === TaskStatus.Backlog || parent.status === TaskStatus.Todo)) {
+      this.repo.update(parent.id, { status: TaskStatus.InProgress });
+      return;
+    }
+    if (isTerminalStatus(updatedChild.status)) {
+      const siblingsResult = this.repo.findMany({
+        projectId: parent.projectId,
+        parentId: parent.id
+      });
+      if (!siblingsResult.ok) return;
+      const allTerminal = siblingsResult.value.every((s) => isTerminalStatus(s.status));
+      if (allTerminal && !isTerminalStatus(parent.status)) {
+        const maxRankResult = this.repo.getMaxRankByLevel(
+          parent.projectId,
+          getTaskLevel(parent.type)
+        );
+        this.repo.update(parent.id, { status: TaskStatus.Done });
+        if (maxRankResult.ok) {
+          this.repo.rerank(parent.id, maxRankResult.value + RANK_GAP);
+        }
+      }
+    }
+  }
 };
 
 // src/types/dependency.ts
@@ -1673,7 +1859,7 @@ function registerProjectSetDefault(parent, container) {
 
 // src/cli/commands/task/create.ts
 function registerTaskCreate(parent, container) {
-  parent.command("create").description("Create a new task (appended to bottom of backlog)").requiredOption("-n, --name <name>", "Task name").option("-p, --project <project>", "Project id or name").option("-d, --description <description>", "Task description").option("-t, --type <type>", "Task type: story, tech-debt, bug", "story").option("-s, --status <status>", "Task status", "backlog").option("--parent <parentId>", "Parent task id for subtask").option("--technical-notes <notes>", "Technical notes (markdown)").option("--additional-requirements <requirements>", "Additional requirements (markdown)").option("--depends-on <ids...>", "Task ids this task depends on (blocks relationship)").action(
+  parent.command("create").description("Create a new task (appended to bottom of backlog)").requiredOption("-n, --name <name>", "Task name").option("-p, --project <project>", "Project id or name").option("-d, --description <description>", "Task description").option("-t, --type <type>", "Task type: epic, story, tech-debt, bug", "story").option("-s, --status <status>", "Task status", "backlog").option("--parent <parentId>", "Parent task id for subtask").option("--technical-notes <notes>", "Technical notes (markdown)").option("--additional-requirements <requirements>", "Additional requirements (markdown)").option("--depends-on <ids...>", "Task ids this task depends on (blocks relationship)").action(
     (opts) => {
       const result = container.taskService.createTask(
         {
@@ -1695,12 +1881,13 @@ function registerTaskCreate(parent, container) {
 
 // src/cli/commands/task/list.ts
 function registerTaskList(parent, container) {
-  parent.command("list").description("List tasks in rank order (defaults to backlog)").option("-p, --project <project>", "Filter by project id or name").option("-s, --status <status>", "Filter by status (default: backlog)").option("-t, --type <type>", "Filter by type").option("--parent <parentId>", "Filter by parent task id").option("--search <text>", "Search in name, description, and notes").action(
+  parent.command("list").description("List tasks in rank order (defaults to level 2 backlog tasks)").option("-p, --project <project>", "Filter by project id or name").option("-s, --status <status>", "Filter by status (default: backlog)").option("-t, --type <type>", "Filter by type (epic, story, tech-debt, bug)").option("-l, --level <level>", "Filter by level (1=epic, 2=work). Default: 2").option("--parent <parentId>", "Filter by parent task id").option("--search <text>", "Search in name, description, and notes").action(
     (opts) => {
       const result = container.taskService.listTasks({
         projectId: opts.project,
         status: opts.status ?? "backlog",
         type: opts.type,
+        level: opts.level ? parseInt(opts.level, 10) : void 0,
         parentId: opts.parent,
         search: opts.search
       });
@@ -1719,7 +1906,7 @@ function registerTaskShow(parent, container) {
 
 // src/cli/commands/task/update.ts
 function registerTaskUpdate(parent, container) {
-  parent.command("update <id>").description("Update a task").option("-n, --name <name>", "Task name").option("-d, --description <description>", "Task description").option("-t, --type <type>", "Task type: story, tech-debt, bug").option("-s, --status <status>", "Task status").option("--parent <parentId>", "Parent task id").option("--technical-notes <notes>", "Replace technical notes").option("--additional-requirements <requirements>", "Replace additional requirements").option("--append-notes <notes>", "Append to technical notes").option("--append-requirements <requirements>", "Append to additional requirements").action(
+  parent.command("update <id>").description("Update a task").option("-n, --name <name>", "Task name").option("-d, --description <description>", "Task description").option("-t, --type <type>", "Task type: epic, story, tech-debt, bug").option("-s, --status <status>", "Task status").option("--parent <parentId>", "Parent task id").option("--technical-notes <notes>", "Replace technical notes").option("--additional-requirements <requirements>", "Replace additional requirements").option("--append-notes <notes>", "Append to technical notes").option("--append-requirements <requirements>", "Append to additional requirements").action(
     (id, opts) => {
       const result = container.taskService.updateTask(id, {
         name: opts.name,
@@ -1927,7 +2114,7 @@ function buildCLI(container) {
   registerDepList(dep, container);
   registerDepGraph(dep, container);
   program.command("tui").description("Launch interactive terminal UI").option("-p, --project <project>", "Start with specific project").action(async (opts) => {
-    const { launchTUI } = await import("./tui-JNZRBEIQ.js");
+    const { launchTUI } = await import("./tui-FTXYP3HM.js");
     await launchTUI(container, opts.project);
   });
   return program;
@@ -1943,7 +2130,7 @@ async function main() {
   const container = createContainer(db);
   const args = process.argv.slice(2);
   if (args.length === 0) {
-    const { launchTUI } = await import("./tui-JNZRBEIQ.js");
+    const { launchTUI } = await import("./tui-FTXYP3HM.js");
     await launchTUI(container);
   } else {
     const program = buildCLI(container);