@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/db/repositories/project-repository.d.ts

@@ -115,6 +115,12 @@ export declare const projectRepository: {
     touch(id: number): void;
     /**
      * Delete a project (cascades to work_items, documents, history)
+     * Also cleans up session files and team data from disk.
+     *
+     * IMPORTANT: Project must be archived before deletion.
+     * Use archive() first, then delete().
+     *
+     * @throws Error if project is not archived
      */
     delete(id: number): boolean;
     /**

package/dist/db/repositories/project-repository.js

@@ -4,6 +4,9 @@
  * Handles all database operations for projects.
  */
 import { getDb } from '../index.js';
+import { getSessionsPath } from '../../settings/paths.js';
+import { rmSync, existsSync } from 'fs';
+import { join } from 'path';
 /**
  * Convert database record to Project object
  */
@@ -287,10 +290,48 @@ export const projectRepository = {
     },
     /**
      * Delete a project (cascades to work_items, documents, history)
+     * Also cleans up session files and team data from disk.
+     *
+     * IMPORTANT: Project must be archived before deletion.
+     * Use archive() first, then delete().
+     *
+     * @throws Error if project is not archived
      */
     delete(id) {
         const db = getDb();
+        // Check if project is archived first
+        const project = db.prepare('SELECT status FROM projects WHERE id = ?').get(id);
+        if (!project) {
+            return false; // Project doesn't exist
+        }
+        if (project.status !== 'archived') {
+            throw new Error('Project must be archived before deletion. Use archive() first.');
+        }
         const result = db.prepare('DELETE FROM projects WHERE id = ?').run(id);
+        if (result.changes > 0) {
+            // Clean up session files for this project
+            try {
+                const sessionsPath = getSessionsPath();
+                const projectSessionPath = join(sessionsPath, `project-${String(id)}`);
+                if (existsSync(projectSessionPath)) {
+                    rmSync(projectSessionPath, { recursive: true, force: true });
+                }
+            }
+            catch {
+                // Session cleanup is best-effort - don't fail delete if cleanup fails
+            }
+            // Clean up anchor files for this project
+            try {
+                const anchorsPath = join(getSessionsPath(), '..', 'anchors');
+                const projectAnchorsPath = join(anchorsPath, `project-${String(id)}.json`);
+                if (existsSync(projectAnchorsPath)) {
+                    rmSync(projectAnchorsPath, { force: true });
+                }
+            }
+            catch {
+                // Anchor cleanup is best-effort
+            }
+        }
         return result.changes > 0;
     },
     /**

package/dist/db/repositories/work-item-repository.d.ts

@@ -11,12 +11,14 @@ export interface CreateWorkItemInput {
     description?: string;
     priority?: WorkItemPriority;
     estimated_effort?: 'low' | 'medium' | 'high';
+    owner?: string;
 }
 export interface UpdateWorkItemInput {
     type?: WorkItemType;
     status?: WorkItemStatus;
     priority?: WorkItemPriority;
     guided_step?: GuidedStep | null;
+    owner?: string | null;
     title?: string;
     description?: string;
     estimated_effort?: 'low' | 'medium' | 'high';
@@ -28,6 +30,8 @@ export interface QueryWorkItemsInput {
     status?: WorkItemStatus | 'all';
     type?: WorkItemType | 'all';
     priority?: WorkItemPriority | 'all';
+    /** Filter by owner: agent ID, 'unassigned', or 'all' */
+    owner?: string;
     search?: string;
     limit?: number;
     offset?: number;
@@ -41,6 +45,7 @@ export interface WorkItem {
     status: WorkItemStatus;
     priority: WorkItemPriority;
     guidedStep: GuidedStep | null;
+    owner: string | null;
     title: string;
     description: string | null;
     estimatedEffort: string | null;
@@ -88,6 +93,15 @@ export declare const workItemRepository: {
      * Delete a work item
      */
     delete(id: number): boolean;
+    /**
+     * Get work items by owner
+     * @param owner - Agent ID or 'unassigned' for items without owner
+     */
+    getByOwner(projectId: number, owner: string, status?: WorkItemStatus): WorkItem[];
+    /**
+     * Get work item counts by owner for a project
+     */
+    getOwnerCounts(projectId: number): Record<string, number>;
     /**
      * Get work item counts by status for a project
      */
@@ -111,5 +125,6 @@ export declare const workItemRepository: {
         title: string;
         description?: string;
         priority?: WorkItemPriority;
+        owner?: string;
     }>): WorkItem[];
 };

package/dist/db/repositories/work-item-repository.js

@@ -17,6 +17,7 @@ function recordToWorkItem(record) {
         status: record.status,
         priority: record.priority,
         guidedStep: record.guided_step,
+        owner: record.owner,
         title: record.title,
         description: record.description,
         estimatedEffort: record.estimated_effort,
@@ -57,11 +58,11 @@ export const workItemRepository = {
             .prepare(`
       INSERT INTO work_items (
         project_id, item_number, item_id, type, status, priority,
-        title, description, estimated_effort,
+        owner, title, description, estimated_effort,
         created_at, updated_at
       ) VALUES (
         @project_id, @item_number, @item_id, @type, @status, @priority,
-        @title, @description, @estimated_effort,
+        @owner, @title, @description, @estimated_effort,
         @created_at, @updated_at
       )
     `)
@@ -72,6 +73,7 @@ export const workItemRepository = {
             type: input.type,
             status: 'backlog',
             priority: input.priority ?? 'medium',
+            owner: input.owner ?? null,
             title: input.title,
             description: input.description ?? null,
             estimated_effort: input.estimated_effort ?? null,
@@ -126,6 +128,15 @@ export const workItemRepository = {
             conditions.push('priority = @priority');
             params.priority = input.priority;
         }
+        if (input.owner && input.owner !== 'all') {
+            if (input.owner === 'unassigned') {
+                conditions.push('owner IS NULL');
+            }
+            else {
+                conditions.push('owner = @owner');
+                params.owner = input.owner;
+            }
+        }
         if (input.search) {
             conditions.push('(title LIKE @search OR description LIKE @search)');
             params.search = `%${input.search}%`;
@@ -226,6 +237,10 @@ export const workItemRepository = {
             updates.push('guided_step = @guided_step');
             params.guided_step = input.guided_step;
         }
+        if (input.owner !== undefined) {
+            updates.push('owner = @owner');
+            params.owner = input.owner;
+        }
         if (input.title !== undefined) {
             updates.push('title = @title');
             params.title = input.title;
@@ -285,6 +300,13 @@ export const workItemRepository = {
         VALUES (?, ?, 'step_advance', ?, ?, 'agent', ?)
       `).run(workItemId, projectId, oldItem.guidedStep ?? 'none', changes.guided_step ?? 'none', now);
         }
+        // Record owner changes
+        if (changes.owner !== undefined && changes.owner !== oldItem.owner) {
+            db.prepare(`
+        INSERT INTO work_item_history (work_item_id, project_id, action, old_value, new_value, changed_by, changed_at)
+        VALUES (?, ?, 'owner_change', ?, ?, 'agent', ?)
+      `).run(workItemId, projectId, oldItem.owner ?? 'unassigned', changes.owner ?? 'unassigned', now);
+        }
     },
     /**
      * Delete a work item
@@ -294,6 +316,48 @@ export const workItemRepository = {
         const result = db.prepare('DELETE FROM work_items WHERE id = ?').run(id);
         return result.changes > 0;
     },
+    /**
+     * Get work items by owner
+     * @param owner - Agent ID or 'unassigned' for items without owner
+     */
+    getByOwner(projectId, owner, status) {
+        const db = getDb();
+        let query = 'SELECT * FROM work_items WHERE project_id = ?';
+        const params = [projectId];
+        if (owner === 'unassigned') {
+            query += ' AND owner IS NULL';
+        }
+        else {
+            query += ' AND owner = ?';
+            params.push(owner);
+        }
+        if (status) {
+            query += ' AND status = ?';
+            params.push(status);
+        }
+        query += ' ORDER BY priority, created_at ASC';
+        const records = db.prepare(query).all(...params);
+        return records.map(recordToWorkItem);
+    },
+    /**
+     * Get work item counts by owner for a project
+     */
+    getOwnerCounts(projectId) {
+        const db = getDb();
+        const results = db
+            .prepare(`
+      SELECT COALESCE(owner, 'unassigned') as owner, COUNT(*) as count
+      FROM work_items
+      WHERE project_id = ? AND status != 'completed' AND status != 'skipped'
+      GROUP BY owner
+    `)
+            .all(projectId);
+        const counts = {};
+        for (const row of results) {
+            counts[row.owner] = row.count;
+        }
+        return counts;
+    },
     /**
      * Get work item counts by status for a project
      */
@@ -354,10 +418,10 @@ export const workItemRepository = {
         const insertStmt = db.prepare(`
       INSERT INTO work_items (
         project_id, item_number, item_id, type, status, priority,
-        title, description, created_at, updated_at
+        owner, title, description, created_at, updated_at
       ) VALUES (
         @project_id, @item_number, @item_id, @type, @status, @priority,
-        @title, @description, @created_at, @updated_at
+        @owner, @title, @description, @created_at, @updated_at
       )
     `);
         // Use transaction for atomicity
@@ -371,6 +435,7 @@ export const workItemRepository = {
                     type: item.type,
                     status: 'backlog',
                     priority: item.priority ?? 'medium',
+                    owner: item.owner ?? null,
                     title: item.title,
                     description: item.description ?? null,
                     created_at: now,

package/dist/db/schema.d.ts

@@ -4,8 +4,8 @@
  * Based on: db-workflow-architecture.md
  * Database: SQLite via better-sqlite3
  */
-export declare const SCHEMA_VERSION = 1;
-export declare const SCHEMA_SQL = "\n-- Schema version tracking\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER PRIMARY KEY,\n  applied_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\n-- Projects table\nCREATE TABLE IF NOT EXISTS projects (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  name TEXT UNIQUE NOT NULL,\n  display_name TEXT NOT NULL,\n  description TEXT,\n\n  -- Project type and status\n  type TEXT DEFAULT 'general',\n  status TEXT DEFAULT 'active',\n\n  -- Paths\n  path TEXT NOT NULL,\n  docs_path TEXT,\n  repo_pattern TEXT DEFAULT 'single',\n\n  -- Tech stack (auto-detected)\n  language TEXT,\n  framework TEXT,\n  package_manager TEXT,\n  runtime_version TEXT,\n\n  -- Commands (JSON)\n  commands TEXT,\n\n  -- Git info\n  git_remote TEXT,\n  git_branch TEXT DEFAULT 'main',\n\n  -- Workflow\n  workflow_mode TEXT DEFAULT 'flexible',\n  lifecycle_state TEXT DEFAULT 'setup',\n  current_item_id TEXT,\n\n  -- Context & Metadata (JSON)\n  last_context TEXT,\n  metadata TEXT,\n\n  -- Timestamps\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  last_activity_at DATETIME\n);\n\n-- Work items (backlog items, tasks, bugs)\nCREATE TABLE IF NOT EXISTS work_items (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n\n  -- Identity\n  item_number INTEGER NOT NULL,\n  item_id TEXT NOT NULL,\n\n  -- Classification\n  type TEXT NOT NULL,\n  status TEXT DEFAULT 'backlog',\n  priority TEXT DEFAULT 'medium',\n\n  -- Guided mode: current step in work item cycle\n  guided_step TEXT,\n\n  -- Content\n  title TEXT NOT NULL,\n  description TEXT,\n\n  -- Effort tracking\n  estimated_effort TEXT,\n  actual_minutes INTEGER,\n\n  -- Completion\n  completed_at DATETIME,\n  completed_by TEXT,\n  commit_hash TEXT,\n\n  -- Timestamps\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  UNIQUE (project_id, item_id)\n);\n\n-- Project documents (PRD, architecture, etc.)\nCREATE TABLE IF NOT EXISTS project_documents (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n\n  doc_type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\n\n-- Work item history (audit trail)\nCREATE TABLE IF NOT EXISTS work_item_history (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  work_item_id INTEGER NOT NULL,\n  project_id INTEGER NOT NULL,\n\n  action TEXT NOT NULL,\n  old_value TEXT,\n  new_value TEXT,\n  notes TEXT,\n\n  changed_by TEXT,\n  changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\n\n-- Indexes for common queries\nCREATE INDEX IF NOT EXISTS idx_projects_path ON projects(path);\nCREATE INDEX IF NOT EXISTS idx_projects_docs_path ON projects(docs_path);\nCREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);\n\nCREATE INDEX IF NOT EXISTS idx_work_items_project ON work_items(project_id);\nCREATE INDEX IF NOT EXISTS idx_work_items_status ON work_items(status);\nCREATE INDEX IF NOT EXISTS idx_work_items_priority ON work_items(priority);\n\nCREATE INDEX IF NOT EXISTS idx_project_documents_project ON project_documents(project_id);\nCREATE INDEX IF NOT EXISTS idx_project_documents_type ON project_documents(doc_type);\n\nCREATE INDEX IF NOT EXISTS idx_work_item_history_item ON work_item_history(work_item_id);\n";
+export declare const SCHEMA_VERSION = 6;
+export declare const SCHEMA_SQL = "\n-- Schema version tracking\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER PRIMARY KEY,\n  applied_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\n-- Projects table\nCREATE TABLE IF NOT EXISTS projects (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  name TEXT UNIQUE NOT NULL,\n  display_name TEXT NOT NULL,\n  description TEXT,\n\n  -- Project type and status\n  type TEXT DEFAULT 'general',\n  status TEXT DEFAULT 'active',\n\n  -- Paths\n  path TEXT NOT NULL,\n  docs_path TEXT,\n  repo_pattern TEXT DEFAULT 'single',\n\n  -- Tech stack (auto-detected)\n  language TEXT,\n  framework TEXT,\n  package_manager TEXT,\n  runtime_version TEXT,\n\n  -- Commands (JSON)\n  commands TEXT,\n\n  -- Git info\n  git_remote TEXT,\n  git_branch TEXT DEFAULT 'main',\n\n  -- Workflow\n  workflow_mode TEXT DEFAULT 'flexible',\n  lifecycle_state TEXT DEFAULT 'setup',\n  current_item_id TEXT,\n\n  -- Context & Metadata (JSON)\n  last_context TEXT,\n  metadata TEXT,\n\n  -- Timestamps\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  last_activity_at DATETIME\n);\n\n-- Work items (backlog items, tasks, bugs)\nCREATE TABLE IF NOT EXISTS work_items (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n\n  -- Identity\n  item_number INTEGER NOT NULL,\n  item_id TEXT NOT NULL,\n\n  -- Classification\n  type TEXT NOT NULL,\n  status TEXT DEFAULT 'backlog',\n  priority TEXT DEFAULT 'medium',\n\n  -- Guided mode: current step in work item cycle\n  guided_step TEXT,\n\n  -- Ownership (for multi-agent teams)\n  owner TEXT,\n\n  -- Content\n  title TEXT NOT NULL,\n  description TEXT,\n\n  -- Effort tracking\n  estimated_effort TEXT,\n  actual_minutes INTEGER,\n\n  -- Completion\n  completed_at DATETIME,\n  completed_by TEXT,\n  commit_hash TEXT,\n\n  -- Timestamps\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  UNIQUE (project_id, item_id)\n);\n\n-- Project documents (PRD, architecture, plans, etc.)\nCREATE TABLE IF NOT EXISTS project_documents (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n\n  doc_type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n\n  -- Plan-specific fields (NULL for non-plan documents)\n  status TEXT,\n  work_item_id INTEGER,\n\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE SET NULL\n);\n\n-- Work item history (audit trail)\nCREATE TABLE IF NOT EXISTS work_item_history (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  work_item_id INTEGER NOT NULL,\n  project_id INTEGER NOT NULL,\n\n  action TEXT NOT NULL,\n  old_value TEXT,\n  new_value TEXT,\n  notes TEXT,\n\n  changed_by TEXT,\n  changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\n\n-- Indexes for common queries\nCREATE INDEX IF NOT EXISTS idx_projects_path ON projects(path);\nCREATE INDEX IF NOT EXISTS idx_projects_docs_path ON projects(docs_path);\nCREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);\n\nCREATE INDEX IF NOT EXISTS idx_work_items_project ON work_items(project_id);\nCREATE INDEX IF NOT EXISTS idx_work_items_status ON work_items(status);\nCREATE INDEX IF NOT EXISTS idx_work_items_priority ON work_items(priority);\nCREATE INDEX IF NOT EXISTS idx_work_items_owner ON work_items(owner);\n\nCREATE INDEX IF NOT EXISTS idx_project_documents_project ON project_documents(project_id);\nCREATE INDEX IF NOT EXISTS idx_project_documents_type ON project_documents(doc_type);\nCREATE INDEX IF NOT EXISTS idx_project_documents_status ON project_documents(status);\nCREATE INDEX IF NOT EXISTS idx_project_documents_work_item ON project_documents(work_item_id);\n\nCREATE INDEX IF NOT EXISTS idx_work_item_history_item ON work_item_history(work_item_id);\n\n-- Terminal sessions (multi-terminal awareness)\nCREATE TABLE IF NOT EXISTS terminal_sessions (\n  id TEXT PRIMARY KEY,\n  project_id INTEGER,\n  pid INTEGER NOT NULL,\n  tty_path TEXT,\n  label TEXT,\n  started_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  last_heartbeat DATETIME DEFAULT CURRENT_TIMESTAMP,\n  active_agent TEXT DEFAULT 'default',\n  agents_json TEXT DEFAULT '[]',\n  status TEXT DEFAULT 'active',\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE SET NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_terminal_sessions_project ON terminal_sessions(project_id);\nCREATE INDEX IF NOT EXISTS idx_terminal_sessions_status ON terminal_sessions(status);\n\n-- File locks (multi-terminal file lock awareness)\nCREATE TABLE IF NOT EXISTS file_locks (\n  path TEXT NOT NULL,\n  project_id INTEGER NOT NULL,\n  session_id TEXT NOT NULL,\n  agent_id TEXT NOT NULL,\n  locked_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  PRIMARY KEY (path, project_id),\n  FOREIGN KEY (session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\n\nCREATE INDEX IF NOT EXISTS idx_file_locks_session ON file_locks(session_id);\n\n-- Session notifications (cross-session notifications)\nCREATE TABLE IF NOT EXISTS session_notifications (\n  id TEXT PRIMARY KEY,\n  project_id INTEGER NOT NULL,\n  from_session_id TEXT NOT NULL,\n  to_session_id TEXT,\n  type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  message TEXT,\n  payload_json TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  read_at DATETIME,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  FOREIGN KEY (from_session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE\n);\n\nCREATE INDEX IF NOT EXISTS idx_session_notifications_project ON session_notifications(project_id);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_to_session ON session_notifications(to_session_id);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_unread ON session_notifications(read_at);\n";
 export interface ProjectRecord {
     id: number;
     name: string;
@@ -41,6 +41,7 @@ export interface WorkItemRecord {
     status: string;
     priority: string;
     guided_step: string | null;
+    owner: string | null;
     title: string;
     description: string | null;
     estimated_effort: string | null;
@@ -57,6 +58,8 @@ export interface ProjectDocumentRecord {
     doc_type: string;
     title: string;
     content: string;
+    status: string | null;
+    work_item_id: number | null;
     created_at: string;
     updated_at: string;
 }
@@ -80,4 +83,38 @@ export type WorkItemType = 'feature' | 'bug' | 'tech-debt' | 'chore';
 export type WorkItemStatus = 'backlog' | 'in_progress' | 'completed' | 'skipped';
 export type WorkItemPriority = 'critical' | 'high' | 'medium' | 'low';
 export type GuidedStep = 'plan' | 'implement' | 'test' | 'commit' | 'review';
-export type DocumentType = 'prd' | 'architecture' | 'design' | 'notes';
+export type DocumentType = 'prd' | 'architecture' | 'design' | 'notes' | 'plan';
+export type PlanStatus = 'draft' | 'approved' | 'in_progress' | 'completed' | 'abandoned';
+export type TerminalSessionStatus = 'active' | 'stale' | 'dead';
+export interface TerminalSessionRecord {
+    id: string;
+    project_id: number | null;
+    pid: number;
+    tty_path: string | null;
+    label: string | null;
+    started_at: string;
+    last_heartbeat: string;
+    active_agent: string;
+    agents_json: string;
+    status: TerminalSessionStatus;
+}
+export interface FileLockRecord {
+    path: string;
+    project_id: number;
+    session_id: string;
+    agent_id: string;
+    locked_at: string;
+}
+export type SessionNotificationType = 'pending_request' | 'agent_finished';
+export interface SessionNotificationRecord {
+    id: string;
+    project_id: number;
+    from_session_id: string;
+    to_session_id: string | null;
+    type: SessionNotificationType;
+    title: string;
+    message: string | null;
+    payload_json: string | null;
+    created_at: string;
+    read_at: string | null;
+}

package/dist/db/schema.js

@@ -4,7 +4,7 @@
  * Based on: db-workflow-architecture.md
  * Database: SQLite via better-sqlite3
  */
-export const SCHEMA_VERSION = 1;
+export const SCHEMA_VERSION = 6;
 export const SCHEMA_SQL = `
 -- Schema version tracking
 CREATE TABLE IF NOT EXISTS schema_version (
@@ -73,6 +73,9 @@ CREATE TABLE IF NOT EXISTS work_items (
   -- Guided mode: current step in work item cycle
   guided_step TEXT,
 
+  -- Ownership (for multi-agent teams)
+  owner TEXT,
+
   -- Content
   title TEXT NOT NULL,
   description TEXT,
@@ -94,7 +97,7 @@ CREATE TABLE IF NOT EXISTS work_items (
   UNIQUE (project_id, item_id)
 );
 
--- Project documents (PRD, architecture, etc.)
+-- Project documents (PRD, architecture, plans, etc.)
 CREATE TABLE IF NOT EXISTS project_documents (
   id INTEGER PRIMARY KEY AUTOINCREMENT,
   project_id INTEGER NOT NULL,
@@ -103,10 +106,15 @@ CREATE TABLE IF NOT EXISTS project_documents (
   title TEXT NOT NULL,
   content TEXT NOT NULL,
 
+  -- Plan-specific fields (NULL for non-plan documents)
+  status TEXT,
+  work_item_id INTEGER,
+
   created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
   updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
 
-  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
+  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE SET NULL
 );
 
 -- Work item history (audit trail)
@@ -135,9 +143,64 @@ CREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);
 CREATE INDEX IF NOT EXISTS idx_work_items_project ON work_items(project_id);
 CREATE INDEX IF NOT EXISTS idx_work_items_status ON work_items(status);
 CREATE INDEX IF NOT EXISTS idx_work_items_priority ON work_items(priority);
+CREATE INDEX IF NOT EXISTS idx_work_items_owner ON work_items(owner);
 
 CREATE INDEX IF NOT EXISTS idx_project_documents_project ON project_documents(project_id);
 CREATE INDEX IF NOT EXISTS idx_project_documents_type ON project_documents(doc_type);
+CREATE INDEX IF NOT EXISTS idx_project_documents_status ON project_documents(status);
+CREATE INDEX IF NOT EXISTS idx_project_documents_work_item ON project_documents(work_item_id);
 
 CREATE INDEX IF NOT EXISTS idx_work_item_history_item ON work_item_history(work_item_id);
+
+-- Terminal sessions (multi-terminal awareness)
+CREATE TABLE IF NOT EXISTS terminal_sessions (
+  id TEXT PRIMARY KEY,
+  project_id INTEGER,
+  pid INTEGER NOT NULL,
+  tty_path TEXT,
+  label TEXT,
+  started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  last_heartbeat DATETIME DEFAULT CURRENT_TIMESTAMP,
+  active_agent TEXT DEFAULT 'default',
+  agents_json TEXT DEFAULT '[]',
+  status TEXT DEFAULT 'active',
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_terminal_sessions_project ON terminal_sessions(project_id);
+CREATE INDEX IF NOT EXISTS idx_terminal_sessions_status ON terminal_sessions(status);
+
+-- File locks (multi-terminal file lock awareness)
+CREATE TABLE IF NOT EXISTS file_locks (
+  path TEXT NOT NULL,
+  project_id INTEGER NOT NULL,
+  session_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  locked_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (path, project_id),
+  FOREIGN KEY (session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_file_locks_session ON file_locks(session_id);
+
+-- Session notifications (cross-session notifications)
+CREATE TABLE IF NOT EXISTS session_notifications (
+  id TEXT PRIMARY KEY,
+  project_id INTEGER NOT NULL,
+  from_session_id TEXT NOT NULL,
+  to_session_id TEXT,
+  type TEXT NOT NULL,
+  title TEXT NOT NULL,
+  message TEXT,
+  payload_json TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  read_at DATETIME,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
+  FOREIGN KEY (from_session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_session_notifications_project ON session_notifications(project_id);
+CREATE INDEX IF NOT EXISTS idx_session_notifications_to_session ON session_notifications(to_session_id);
+CREATE INDEX IF NOT EXISTS idx_session_notifications_unread ON session_notifications(read_at);
 `;

package/dist/episodes/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Episodes Module (CLI)
+ *
+ * Work history tracking with file-based persistence and automatic recording.
+ */
+import type { EpisodeStore } from '@compilr-dev/agents';
+export { FileEpisodeStore } from './store.js';
+export type { FileEpisodeStoreOptions } from './store.js';
+export { EpisodeRecorder } from './recorder.js';
+export type { EpisodeRecorderConfig } from './recorder.js';
+export { isSignificantWork, extractAffectedFiles, extractLinesChanged } from './significant-work.js';
+export { queryWorkAtRisk } from './work-at-risk.js';
+export { buildWorkSummaryContent, updateWorkSummaryAnchor } from './work-summary-anchor.js';
+export type { WorkSummaryAnchorConfig } from './work-summary-anchor.js';
+export type { PendingToolSignal, EpisodeFile } from './types.js';
+export type { Effort, WorkEpisode, EffortSignals, EffortWeights, EffortSummary, ProjectWorkSummary, WorkAtRisk, EpisodeStore, } from './types.js';
+/** Set the global episode store (called during startup) */
+export declare function setGlobalEpisodeStore(store: EpisodeStore): void;
+/** Get the global episode store (used by recall_work tool) */
+export declare function getGlobalEpisodeStore(): EpisodeStore | null;

package/dist/episodes/index.js

@@ -0,0 +1,27 @@
+/**
+ * Episodes Module (CLI)
+ *
+ * Work history tracking with file-based persistence and automatic recording.
+ */
+// Store
+export { FileEpisodeStore } from './store.js';
+// Recorder
+export { EpisodeRecorder } from './recorder.js';
+// Significant work detection
+export { isSignificantWork, extractAffectedFiles, extractLinesChanged } from './significant-work.js';
+// Work at risk
+export { queryWorkAtRisk } from './work-at-risk.js';
+// Work summary anchor
+export { buildWorkSummaryContent, updateWorkSummaryAnchor } from './work-summary-anchor.js';
+// =============================================================================
+// Global Episode Store
+// =============================================================================
+let _globalStore = null;
+/** Set the global episode store (called during startup) */
+export function setGlobalEpisodeStore(store) {
+    _globalStore = store;
+}
+/** Get the global episode store (used by recall_work tool) */
+export function getGlobalEpisodeStore() {
+    return _globalStore;
+}

package/dist/episodes/recorder.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Episode Recorder
+ *
+ * Collects tool call signals via an AfterToolHook, batches them within
+ * a time window, and persists as WorkEpisode records.
+ */
+import type { AfterToolHook, Effort, EpisodeStore } from '@compilr-dev/agents';
+export interface EpisodeRecorderConfig {
+    /** Episode store for persistence */
+    store: EpisodeStore;
+    /** Agent ID (e.g., 'default', 'backend') */
+    agentId: string;
+    /** Terminal session prefix (first 8 chars) */
+    terminalPrefix: string;
+    /** Session ID for grouping */
+    sessionId: string;
+    /** Enable automatic recording via hook (default: true) */
+    autoRecord?: boolean;
+    /** Minimum effort level to record (default: 'low') */
+    minEffortToRecord?: Effort;
+    /** Batch window in milliseconds (default: 5000) */
+    batchWindowMs?: number;
+    /** Called after each batch is flushed as a WorkEpisode */
+    onBatchFlushed?: () => void;
+}
+export declare class EpisodeRecorder {
+    private readonly store;
+    private readonly agentId;
+    private readonly terminalPrefix;
+    private readonly sessionId;
+    private readonly autoRecord;
+    private readonly minEffortToRecord;
+    private readonly batchWindowMs;
+    private readonly onBatchFlushed?;
+    private pendingSignals;
+    private batchTimer;
+    private batchStartTime;
+    constructor(config: EpisodeRecorderConfig);
+    /**
+     * Create an AfterToolHook for observing tool calls.
+     * Always returns undefined (observation only — never modifies results).
+     */
+    createHook(): AfterToolHook;
+    /**
+     * Force-flush all pending signals as a WorkEpisode.
+     * Called on shutdown to avoid losing data.
+     */
+    flush(): void;
+    private scheduleBatch;
+    private buildAndSaveEpisode;
+}