refactor: Remove epic/adr types, simplify to tasks-only; add cached tab completion

- Remove task_type parameter from create_task (hardcode "task")
- Remove Type display from /task show output
- Remove epic/adr/contract/base schema references from docs
- Add _get_cached_task_ids with mtime-based cache for tab completion
- Fix simplify review issues: stale 'todo' fallback, duplicate session
  title, redundant find_task after create, hoisted store construction

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 1broseidon

cecli/brainfile/store.py

@@ -178,7 +178,6 @@ def create_task(
         self,
         title: str,
         column: str = "in-progress",
-        task_type: str = "task",
         description: Optional[str] = None,
         subtasks: Optional[List[str]] = None,
     ) -> Dict[str, Any]:
@@ -188,7 +187,7 @@ def create_task(
             {
                 "title": title,
                 "column": column,
-                "type": task_type,
+                "type": "task",
                 "description": description or "",
                 "subtasks": subtasks or [],
             },
@@ -202,10 +201,10 @@ def create_task(
             "id": task.id,
             "title": task.title,
             "column": task.column,
-            "type": task.type or "task",
             "location": "board",
             "path": Path(result["filePath"]),
             "relpath": self.relpath(result["filePath"]),
+            "task": task,
         }
 
     def update_task(
@@ -351,13 +350,10 @@ def get_or_create_session_task(self, coder) -> dict:
             task_id = best["id"]
         else:
             # Create a new task
-            from datetime import date
-
-            title = f"Session {date.today().isoformat()}"
+            title = self.auto_title(None)
             created = self.create_task(title=title, column="in-progress")
             task_id = created["id"]
-            found = self.find_task(task_id)
-            task = found["task"]
+            task = created["task"]
 
         # Set active_task_id + update TUI — but do NOT add the file to
         # coder context so the agent never sees raw YAML.
@@ -662,6 +658,6 @@ def render_task_todo_block(self, task_id: str) -> Optional[str]:
 
         total = len(done_tasks) + len(remaining_tasks)
         done = len(done_tasks)
-        result += f"\nActive: {task.title} | {task.column or 'todo'} | {done}/{total}\n"
+        result += f"\nActive: {task.title} | {task.column or 'in-progress'} | {done}/{total}\n"
         result += "</context>"
         return result

cecli/coders/agent_coder.py

@@ -1193,30 +1193,23 @@ def get_todo_list(self):
         already exists (to avoid creating one before the agent has done anything).
         """
         try:
+            from cecli.brainfile import CecliTaskStore
+
+            store = CecliTaskStore(self.root)
             active_task_id = getattr(self, "active_task_id", None)
 
             # Auto-resume: pick up an incomplete board task if one exists
-            if not active_task_id:
+            if not active_task_id and store.board_exists():
                 try:
-                    from cecli.brainfile import CecliTaskStore
-
-                    store = CecliTaskStore(self.root)
-                    if store.board_exists():
-                        opened = store.get_or_create_session_task(self)
-                        active_task_id = opened["id"]
+                    opened = store.get_or_create_session_task(self)
+                    active_task_id = opened["id"]
                 except Exception:
                     pass
 
             if active_task_id:
-                try:
-                    from cecli.brainfile import CecliTaskStore
-
-                    store = CecliTaskStore(self.root)
-                    block = store.render_task_todo_block(active_task_id)
-                    if block:
-                        return block
-                except Exception:
-                    pass
+                block = store.render_task_todo_block(active_task_id)
+                if block:
+                    return block
 
             return (
                 '<context name="todo_list" from="agent">\n'

cecli/commands/task.py

@@ -14,6 +14,34 @@ class TaskCommand(BaseCommand):
         "(list/add/new/show/open/update/delete/complete/drop)"
     )
 
+    _cached_task_ids: List[str] = []
+    _cached_mtime: float = 0.0
+
+    @classmethod
+    def _get_cached_task_ids(cls, coder) -> List[str]:
+        """Return task IDs, using a cache invalidated by directory mtime."""
+        tasks_dir = Path(coder.root) / ".cecli" / "tasks"
+        board_dir = tasks_dir / "board"
+        logs_dir = tasks_dir / "logs"
+
+        # Sum mtimes of both directories for a cheap staleness check
+        current_mtime = 0.0
+        for d in (board_dir, logs_dir):
+            try:
+                current_mtime += d.stat().st_mtime
+            except OSError:
+                pass
+
+        if current_mtime != cls._cached_mtime or not cls._cached_task_ids:
+            try:
+                store = CecliTaskStore(Path(coder.root))
+                cls._cached_task_ids = [t["id"] for t in store.list_tasks("all")]
+            except Exception:
+                cls._cached_task_ids = []
+            cls._cached_mtime = current_mtime
+
+        return cls._cached_task_ids
+
     @classmethod
     async def execute(cls, io, coder, args, **kwargs):
         if coder is None:
@@ -73,7 +101,6 @@ async def execute(cls, io, coder, args, **kwargs):
                 total = len(subtasks)
                 io.tool_output(f"Task: {task['id']}")
                 io.tool_output(f"Title: {t.title}")
-                io.tool_output(f"Type: {t.type or 'task'}")
                 io.tool_output(f"Location: {task['location']}")
                 io.tool_output(f"Column: {t.column or 'logs'}")
                 io.tool_output(f"Progress: {done}/{total}")
@@ -197,9 +224,7 @@ async def execute(cls, io, coder, args, **kwargs):
             if command == "new":
                 title = " ".join(tokens[1:]).strip() if len(tokens) > 1 else None
                 if not title:
-                    from datetime import date
-
-                    title = f"Session {date.today().isoformat()}"
+                    title = store.auto_title(None)
                 created = store.create_task(title=title, column="in-progress")
                 opened = store.open_task_in_context(
                     coder, created["id"], mode="auto", explicit=False
@@ -247,9 +272,6 @@ def get_completions(cls, io, coder, args) -> List[str]:
             prefix = tokens[0].lower()
             return [sc for sc in subcommands if sc.startswith(prefix)]
 
-        store = CecliTaskStore(Path(coder.root))
-        task_ids = [task["id"] for task in store.list_tasks("all")]
-
         action = tokens[0].lower()
         if action == "list":
             if len(tokens) <= 1:
@@ -260,6 +282,7 @@ def get_completions(cls, io, coder, args) -> List[str]:
             return []
 
         if action in {"show", "open", "update", "delete", "complete", "drop"}:
+            task_ids = cls._get_cached_task_ids(coder)
             if len(tokens) == 1:
                 return task_ids
             if len(tokens) == 2 and not args.endswith(" "):

cecli/sessions.py

@@ -249,7 +249,7 @@ def _apply_session_data(self, session_data: Dict, session_file: Path) -> bool:
                     )
                 else:
                     # Task file no longer exists or was completed — clear it
-                    setattr(self.coder, "active_task_id", None)
+                    store.clear_active_task(self.coder)
 
             # Legacy field handling:
             # session_data["todo_list"] was used for deprecated todo.txt snapshots.

cecli/website/docs/sessions.md

@@ -78,13 +78,9 @@ List all available saved sessions in `.cecli/sessions/`.
 The persistent board in `.cecli/tasks/` is initialized with Brainfile v2 schema URLs:
 
 - Board: `https://brainfile.md/v2/board.json`
-- Base (reference): `https://brainfile.md/v2/base.json`
 - Task: `https://brainfile.md/v2/task.json`
-- Contract: `https://brainfile.md/v2/contract.json`
-- Epic: `https://brainfile.md/v2/epic.json`
-- ADR: `https://brainfile.md/v2/adr.json`
 
-The default `types` map includes `task`, `epic`, and `adr` and can be extended later.
+Tasks are the only item type used in the initial version.
 
 ## How Sessions Work