@compilr-dev/sdk 0.2.3 → 0.2.4

package/dist/platform/sqlite/project-repository.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SQLite Project Repository — Concrete implementation of IProjectRepository.
+ *
+ * All methods return Promises (wrapping synchronous better-sqlite3 calls)
+ * to satisfy the async IProjectRepository interface.
+ */
+import type Database from 'better-sqlite3';
+import type { IProjectRepository } from '../repositories.js';
+import type { Project, ProjectStatus, CreateProjectInput, UpdateProjectInput, ProjectListOptions, ProjectListResult } from '../types.js';
+/**
+ * Options for customizing project deletion behavior.
+ * Consumers can provide a callback to clean up platform-specific files.
+ */
+export interface ProjectDeleteHooks {
+    onDelete?: (projectId: number) => void;
+}
+export declare class SQLiteProjectRepository implements IProjectRepository {
+    private readonly db;
+    private readonly deleteHooks?;
+    constructor(db: Database.Database, hooks?: ProjectDeleteHooks);
+    create(input: CreateProjectInput): Promise<Project>;
+    getById(id: number): Promise<Project | null>;
+    getByName(name: string): Promise<Project | null>;
+    getByPath(path: string): Promise<Project | null>;
+    getByDocsPath(docsPath: string): Promise<Project | null>;
+    findByPath(searchPath: string): Promise<Project | null>;
+    list(options?: ProjectListOptions): Promise<ProjectListResult>;
+    update(id: number, input: UpdateProjectInput): Promise<Project | null>;
+    touch(id: number): Promise<void>;
+    delete(id: number): Promise<boolean>;
+    archive(id: number): Promise<Project | null>;
+    isNameAvailable(name: string, excludeId?: number): Promise<boolean>;
+    getStatusCounts(): Promise<Record<ProjectStatus, number>>;
+}

package/dist/platform/sqlite/project-repository.js

@@ -0,0 +1,282 @@
+/**
+ * SQLite Project Repository — Concrete implementation of IProjectRepository.
+ *
+ * All methods return Promises (wrapping synchronous better-sqlite3 calls)
+ * to satisfy the async IProjectRepository interface.
+ */
+function recordToProject(record) {
+    return {
+        id: record.id,
+        name: record.name,
+        displayName: record.display_name,
+        description: record.description,
+        type: record.type,
+        status: record.status,
+        path: record.path,
+        docsPath: record.docs_path,
+        repoPattern: record.repo_pattern,
+        language: record.language,
+        framework: record.framework,
+        packageManager: record.package_manager,
+        runtimeVersion: record.runtime_version,
+        commands: record.commands ? JSON.parse(record.commands) : null,
+        gitRemote: record.git_remote,
+        gitBranch: record.git_branch,
+        workflowMode: record.workflow_mode,
+        lifecycleState: record.lifecycle_state,
+        currentItemId: record.current_item_id,
+        lastContext: record.last_context
+            ? JSON.parse(record.last_context)
+            : null,
+        metadata: record.metadata ? JSON.parse(record.metadata) : null,
+        createdAt: new Date(record.created_at),
+        updatedAt: new Date(record.updated_at),
+        lastActivityAt: record.last_activity_at ? new Date(record.last_activity_at) : null,
+    };
+}
+export class SQLiteProjectRepository {
+    db;
+    deleteHooks;
+    constructor(db, hooks) {
+        this.db = db;
+        this.deleteHooks = hooks;
+    }
+    create(input) {
+        const now = new Date().toISOString();
+        const result = this.db
+            .prepare(`INSERT INTO projects (
+        name, display_name, description, type, path, docs_path, repo_pattern,
+        language, framework, package_manager, runtime_version, commands,
+        git_remote, git_branch, workflow_mode, metadata,
+        created_at, updated_at, last_activity_at
+      ) VALUES (
+        @name, @display_name, @description, @type, @path, @docs_path, @repo_pattern,
+        @language, @framework, @package_manager, @runtime_version, @commands,
+        @git_remote, @git_branch, @workflow_mode, @metadata,
+        @created_at, @updated_at, @last_activity_at
+      )`)
+            .run({
+            name: input.name,
+            display_name: input.display_name,
+            description: input.description ?? null,
+            type: input.type ?? 'general',
+            path: input.path,
+            docs_path: input.docs_path ?? null,
+            repo_pattern: input.repo_pattern ?? 'single',
+            language: input.language ?? null,
+            framework: input.framework ?? null,
+            package_manager: input.package_manager ?? null,
+            runtime_version: input.runtime_version ?? null,
+            commands: input.commands ? JSON.stringify(input.commands) : null,
+            git_remote: input.git_remote ?? null,
+            git_branch: input.git_branch ?? 'main',
+            workflow_mode: input.workflow_mode ?? 'flexible',
+            metadata: input.metadata ? JSON.stringify(input.metadata) : null,
+            created_at: now,
+            updated_at: now,
+            last_activity_at: now,
+        });
+        const record = this.db
+            .prepare('SELECT * FROM projects WHERE id = ?')
+            .get(Number(result.lastInsertRowid));
+        if (!record)
+            throw new Error('Failed to create project');
+        return Promise.resolve(recordToProject(record));
+    }
+    getById(id) {
+        const record = this.db.prepare('SELECT * FROM projects WHERE id = ?').get(id);
+        return Promise.resolve(record ? recordToProject(record) : null);
+    }
+    getByName(name) {
+        const record = this.db.prepare('SELECT * FROM projects WHERE name = ?').get(name);
+        return Promise.resolve(record ? recordToProject(record) : null);
+    }
+    getByPath(path) {
+        const record = this.db.prepare('SELECT * FROM projects WHERE path = ?').get(path);
+        return Promise.resolve(record ? recordToProject(record) : null);
+    }
+    getByDocsPath(docsPath) {
+        const record = this.db.prepare('SELECT * FROM projects WHERE docs_path = ?').get(docsPath);
+        return Promise.resolve(record ? recordToProject(record) : null);
+    }
+    async findByPath(searchPath) {
+        let project = await this.getByPath(searchPath);
+        if (project)
+            return project;
+        project = await this.getByDocsPath(searchPath);
+        if (project)
+            return project;
+        const parts = searchPath.split('/').filter(Boolean);
+        for (let i = parts.length - 1; i >= 0; i--) {
+            const parentPath = '/' + parts.slice(0, i).join('/');
+            if (!parentPath || parentPath === '/')
+                break;
+            project = await this.getByPath(parentPath);
+            if (project)
+                return project;
+            project = await this.getByDocsPath(parentPath);
+            if (project)
+                return project;
+        }
+        return null;
+    }
+    list(options) {
+        const conditions = [];
+        const params = {};
+        if (options?.status && options.status !== 'all') {
+            conditions.push('status = @status');
+            params.status = options.status;
+        }
+        if (options?.type && options.type !== 'all') {
+            conditions.push('type = @type');
+            params.type = options.type;
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const countResult = this.db
+            .prepare(`SELECT COUNT(*) as count FROM projects ${whereClause}`)
+            .get(params);
+        let query = `SELECT * FROM projects ${whereClause} ORDER BY last_activity_at DESC NULLS LAST, updated_at DESC`;
+        if (options?.limit) {
+            query += ` LIMIT @limit`;
+            params.limit = options.limit;
+        }
+        if (options?.offset) {
+            query += ` OFFSET @offset`;
+            params.offset = options.offset;
+        }
+        const records = this.db.prepare(query).all(params);
+        return Promise.resolve({
+            projects: records.map(recordToProject),
+            total: countResult.count,
+        });
+    }
+    update(id, input) {
+        const updates = [];
+        const params = { id };
+        if (input.display_name !== undefined) {
+            updates.push('display_name = @display_name');
+            params.display_name = input.display_name;
+        }
+        if (input.description !== undefined) {
+            updates.push('description = @description');
+            params.description = input.description;
+        }
+        if (input.type !== undefined) {
+            updates.push('type = @type');
+            params.type = input.type;
+        }
+        if (input.status !== undefined) {
+            updates.push('status = @status');
+            params.status = input.status;
+        }
+        if (input.docs_path !== undefined) {
+            updates.push('docs_path = @docs_path');
+            params.docs_path = input.docs_path;
+        }
+        if (input.repo_pattern !== undefined) {
+            updates.push('repo_pattern = @repo_pattern');
+            params.repo_pattern = input.repo_pattern;
+        }
+        if (input.language !== undefined) {
+            updates.push('language = @language');
+            params.language = input.language;
+        }
+        if (input.framework !== undefined) {
+            updates.push('framework = @framework');
+            params.framework = input.framework;
+        }
+        if (input.package_manager !== undefined) {
+            updates.push('package_manager = @package_manager');
+            params.package_manager = input.package_manager;
+        }
+        if (input.runtime_version !== undefined) {
+            updates.push('runtime_version = @runtime_version');
+            params.runtime_version = input.runtime_version;
+        }
+        if (input.commands !== undefined) {
+            updates.push('commands = @commands');
+            params.commands = JSON.stringify(input.commands);
+        }
+        if (input.git_remote !== undefined) {
+            updates.push('git_remote = @git_remote');
+            params.git_remote = input.git_remote;
+        }
+        if (input.git_branch !== undefined) {
+            updates.push('git_branch = @git_branch');
+            params.git_branch = input.git_branch;
+        }
+        if (input.workflow_mode !== undefined) {
+            updates.push('workflow_mode = @workflow_mode');
+            params.workflow_mode = input.workflow_mode;
+        }
+        if (input.lifecycle_state !== undefined) {
+            updates.push('lifecycle_state = @lifecycle_state');
+            params.lifecycle_state = input.lifecycle_state;
+        }
+        if (input.current_item_id !== undefined) {
+            updates.push('current_item_id = @current_item_id');
+            params.current_item_id = input.current_item_id;
+        }
+        if (input.last_context !== undefined) {
+            updates.push('last_context = @last_context');
+            params.last_context = JSON.stringify(input.last_context);
+        }
+        if (input.metadata !== undefined) {
+            updates.push('metadata = @metadata');
+            params.metadata = JSON.stringify(input.metadata);
+        }
+        if (updates.length === 0) {
+            return this.getById(id);
+        }
+        updates.push('updated_at = @updated_at');
+        params.updated_at = new Date().toISOString();
+        this.db.prepare(`UPDATE projects SET ${updates.join(', ')} WHERE id = @id`).run(params);
+        return this.getById(id);
+    }
+    touch(id) {
+        const now = new Date().toISOString();
+        this.db
+            .prepare('UPDATE projects SET last_activity_at = ?, updated_at = ? WHERE id = ?')
+            .run(now, now, id);
+        return Promise.resolve();
+    }
+    delete(id) {
+        const project = this.db.prepare('SELECT status FROM projects WHERE id = ?').get(id);
+        if (!project)
+            return Promise.resolve(false);
+        if (project.status !== 'archived') {
+            throw new Error('Project must be archived before deletion. Use archive() first.');
+        }
+        const result = this.db.prepare('DELETE FROM projects WHERE id = ?').run(id);
+        if (result.changes > 0) {
+            this.deleteHooks?.onDelete?.(id);
+        }
+        return Promise.resolve(result.changes > 0);
+    }
+    archive(id) {
+        return this.update(id, { status: 'archived' });
+    }
+    isNameAvailable(name, excludeId) {
+        const query = excludeId
+            ? 'SELECT id FROM projects WHERE name = ? AND id != ?'
+            : 'SELECT id FROM projects WHERE name = ?';
+        const params = excludeId ? [name, excludeId] : [name];
+        const result = this.db.prepare(query).get(...params);
+        return Promise.resolve(!result);
+    }
+    getStatusCounts() {
+        const results = this.db
+            .prepare('SELECT status, COUNT(*) as count FROM projects GROUP BY status')
+            .all();
+        const counts = {
+            active: 0,
+            paused: 0,
+            completed: 0,
+            archived: 0,
+        };
+        for (const row of results) {
+            counts[row.status] = row.count;
+        }
+        return Promise.resolve(counts);
+    }
+}

package/dist/platform/sqlite/schema.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Database Schema for compilr-dev workflow system
+ *
+ * Shared between CLI and Desktop — both access ~/.compilr-dev/projects.db
+ * Schema version must be kept in sync across all consumers.
+ */
+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  type TEXT DEFAULT 'general',\n  status TEXT DEFAULT 'active',\n  path TEXT NOT NULL,\n  docs_path TEXT,\n  repo_pattern TEXT DEFAULT 'single',\n  language TEXT,\n  framework TEXT,\n  package_manager TEXT,\n  runtime_version TEXT,\n  commands TEXT,\n  git_remote TEXT,\n  git_branch TEXT DEFAULT 'main',\n  workflow_mode TEXT DEFAULT 'flexible',\n  lifecycle_state TEXT DEFAULT 'setup',\n  current_item_id TEXT,\n  last_context TEXT,\n  metadata TEXT,\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  item_number INTEGER NOT NULL,\n  item_id TEXT NOT NULL,\n  type TEXT NOT NULL,\n  status TEXT DEFAULT 'backlog',\n  priority TEXT DEFAULT 'medium',\n  guided_step TEXT,\n  owner TEXT,\n  title TEXT NOT NULL,\n  description TEXT,\n  estimated_effort TEXT,\n  actual_minutes INTEGER,\n  completed_at DATETIME,\n  completed_by TEXT,\n  commit_hash TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\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  doc_type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n  status TEXT,\n  work_item_id INTEGER,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\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  action TEXT NOT NULL,\n  old_value TEXT,\n  new_value TEXT,\n  notes TEXT,\n  changed_by TEXT,\n  changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,\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\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);\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);\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);\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);\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);\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);\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;
+    display_name: string;
+    description: string | null;
+    type: string;
+    status: string;
+    path: string;
+    docs_path: string | null;
+    repo_pattern: string;
+    language: string | null;
+    framework: string | null;
+    package_manager: string | null;
+    runtime_version: string | null;
+    commands: string | null;
+    git_remote: string | null;
+    git_branch: string;
+    workflow_mode: string;
+    lifecycle_state: string;
+    current_item_id: string | null;
+    last_context: string | null;
+    metadata: string | null;
+    created_at: string;
+    updated_at: string;
+    last_activity_at: string | null;
+}
+export interface WorkItemRecord {
+    id: number;
+    project_id: number;
+    item_number: number;
+    item_id: string;
+    type: string;
+    status: string;
+    priority: string;
+    guided_step: string | null;
+    owner: string | null;
+    title: string;
+    description: string | null;
+    estimated_effort: string | null;
+    actual_minutes: number | null;
+    completed_at: string | null;
+    completed_by: string | null;
+    commit_hash: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface ProjectDocumentRecord {
+    id: number;
+    project_id: number;
+    doc_type: string;
+    title: string;
+    content: string;
+    status: string | null;
+    work_item_id: number | null;
+    created_at: string;
+    updated_at: string;
+}

package/dist/platform/sqlite/schema.js

@@ -0,0 +1,159 @@
+/**
+ * Database Schema for compilr-dev workflow system
+ *
+ * Shared between CLI and Desktop — both access ~/.compilr-dev/projects.db
+ * Schema version must be kept in sync across all consumers.
+ */
+export const SCHEMA_VERSION = 6;
+export const SCHEMA_SQL = `
+-- Schema version tracking
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Projects table
+CREATE TABLE IF NOT EXISTS projects (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT UNIQUE NOT NULL,
+  display_name TEXT NOT NULL,
+  description TEXT,
+  type TEXT DEFAULT 'general',
+  status TEXT DEFAULT 'active',
+  path TEXT NOT NULL,
+  docs_path TEXT,
+  repo_pattern TEXT DEFAULT 'single',
+  language TEXT,
+  framework TEXT,
+  package_manager TEXT,
+  runtime_version TEXT,
+  commands TEXT,
+  git_remote TEXT,
+  git_branch TEXT DEFAULT 'main',
+  workflow_mode TEXT DEFAULT 'flexible',
+  lifecycle_state TEXT DEFAULT 'setup',
+  current_item_id TEXT,
+  last_context TEXT,
+  metadata TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  last_activity_at DATETIME
+);
+
+-- Work items (backlog items, tasks, bugs)
+CREATE TABLE IF NOT EXISTS work_items (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id INTEGER NOT NULL,
+  item_number INTEGER NOT NULL,
+  item_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  status TEXT DEFAULT 'backlog',
+  priority TEXT DEFAULT 'medium',
+  guided_step TEXT,
+  owner TEXT,
+  title TEXT NOT NULL,
+  description TEXT,
+  estimated_effort TEXT,
+  actual_minutes INTEGER,
+  completed_at DATETIME,
+  completed_by TEXT,
+  commit_hash TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
+  UNIQUE (project_id, item_id)
+);
+
+-- Project documents (PRD, architecture, plans, etc.)
+CREATE TABLE IF NOT EXISTS project_documents (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id INTEGER NOT NULL,
+  doc_type TEXT NOT NULL,
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  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 (work_item_id) REFERENCES work_items(id) ON DELETE SET NULL
+);
+
+-- Work item history (audit trail)
+CREATE TABLE IF NOT EXISTS work_item_history (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  work_item_id INTEGER NOT NULL,
+  project_id INTEGER NOT NULL,
+  action TEXT NOT NULL,
+  old_value TEXT,
+  new_value TEXT,
+  notes TEXT,
+  changed_by TEXT,
+  changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE CASCADE,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_projects_path ON projects(path);
+CREATE INDEX IF NOT EXISTS idx_projects_docs_path ON projects(docs_path);
+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/platform/sqlite/work-item-repository.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SQLite Work Item Repository — Concrete implementation of IWorkItemRepository.
+ */
+import type Database from 'better-sqlite3';
+import type { IWorkItemRepository } from '../repositories.js';
+import type { WorkItem, WorkItemType, WorkItemStatus, HistoryEntry, CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, WorkItemQueryResult, BulkCreateItem } from '../types.js';
+export declare class SQLiteWorkItemRepository implements IWorkItemRepository {
+    private readonly db;
+    constructor(db: Database.Database);
+    create(input: CreateWorkItemInput): Promise<WorkItem>;
+    getById(id: number): Promise<WorkItem | null>;
+    getByItemId(projectId: number, itemId: string): Promise<WorkItem | null>;
+    query(input: QueryWorkItemsInput): Promise<WorkItemQueryResult>;
+    getNext(projectId: number, type?: WorkItemType): Promise<WorkItem | null>;
+    update(id: number, input: UpdateWorkItemInput): Promise<WorkItem | null>;
+    delete(id: number): Promise<boolean>;
+    getByOwner(projectId: number, owner: string, status?: WorkItemStatus): Promise<WorkItem[]>;
+    getOwnerCounts(projectId: number): Promise<Record<string, number>>;
+    getStatusCounts(projectId: number): Promise<Record<WorkItemStatus, number>>;
+    getHistory(workItemId: number): Promise<HistoryEntry[]>;
+    bulkCreate(projectId: number, items: BulkCreateItem[]): Promise<WorkItem[]>;
+    private recordHistory;
+}