@compilr-dev/cli 0.4.0

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

@@ -0,0 +1,389 @@
+/**
+ * Work Item Repository
+ *
+ * Handles all database operations for work items (backlog items, tasks, bugs).
+ */
+import { getDb } from '../index.js';
+/**
+ * Convert database record to WorkItem object
+ */
+function recordToWorkItem(record) {
+    return {
+        id: record.id,
+        projectId: record.project_id,
+        itemNumber: record.item_number,
+        itemId: record.item_id,
+        type: record.type,
+        status: record.status,
+        priority: record.priority,
+        guidedStep: record.guided_step,
+        title: record.title,
+        description: record.description,
+        estimatedEffort: record.estimated_effort,
+        actualMinutes: record.actual_minutes,
+        completedAt: record.completed_at ? new Date(record.completed_at) : null,
+        completedBy: record.completed_by,
+        commitHash: record.commit_hash,
+        createdAt: new Date(record.created_at),
+        updatedAt: new Date(record.updated_at),
+    };
+}
+/**
+ * Get prefix for item ID based on type
+ */
+function getTypePrefix(type) {
+    const prefixes = {
+        feature: 'REQ',
+        bug: 'BUG',
+        'tech-debt': 'TEC',
+        chore: 'CHR',
+    };
+    return prefixes[type];
+}
+export const workItemRepository = {
+    /**
+     * Create a new work item
+     */
+    create(input) {
+        const db = getDb();
+        const now = new Date().toISOString();
+        // Get next item number for this project
+        const maxResult = db
+            .prepare('SELECT MAX(item_number) as max_num FROM work_items WHERE project_id = ?')
+            .get(input.project_id);
+        const itemNumber = (maxResult.max_num ?? 0) + 1;
+        const itemId = `${getTypePrefix(input.type)}-${String(itemNumber).padStart(3, '0')}`;
+        const result = db
+            .prepare(`
+      INSERT INTO work_items (
+        project_id, item_number, item_id, type, status, priority,
+        title, description, estimated_effort,
+        created_at, updated_at
+      ) VALUES (
+        @project_id, @item_number, @item_id, @type, @status, @priority,
+        @title, @description, @estimated_effort,
+        @created_at, @updated_at
+      )
+    `)
+            .run({
+            project_id: input.project_id,
+            item_number: itemNumber,
+            item_id: itemId,
+            type: input.type,
+            status: 'backlog',
+            priority: input.priority ?? 'medium',
+            title: input.title,
+            description: input.description ?? null,
+            estimated_effort: input.estimated_effort ?? null,
+            created_at: now,
+            updated_at: now,
+        });
+        const item = this.getById(Number(result.lastInsertRowid));
+        if (!item)
+            throw new Error('Failed to create work item');
+        return item;
+    },
+    /**
+     * Get work item by database ID
+     */
+    getById(id) {
+        const db = getDb();
+        const record = db
+            .prepare('SELECT * FROM work_items WHERE id = ?')
+            .get(id);
+        return record ? recordToWorkItem(record) : null;
+    },
+    /**
+     * Get work item by item_id (e.g., "REQ-001")
+     */
+    getByItemId(projectId, itemId) {
+        const db = getDb();
+        const record = db
+            .prepare('SELECT * FROM work_items WHERE project_id = ? AND item_id = ?')
+            .get(projectId, itemId);
+        return record ? recordToWorkItem(record) : null;
+    },
+    /**
+     * Query work items with filters
+     */
+    query(input) {
+        const db = getDb();
+        const conditions = [];
+        const params = {};
+        if (input.project_id) {
+            conditions.push('project_id = @project_id');
+            params.project_id = input.project_id;
+        }
+        if (input.status && input.status !== 'all') {
+            conditions.push('status = @status');
+            params.status = input.status;
+        }
+        if (input.type && input.type !== 'all') {
+            conditions.push('type = @type');
+            params.type = input.type;
+        }
+        if (input.priority && input.priority !== 'all') {
+            conditions.push('priority = @priority');
+            params.priority = input.priority;
+        }
+        if (input.search) {
+            conditions.push('(title LIKE @search OR description LIKE @search)');
+            params.search = `%${input.search}%`;
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        // Get total count
+        const countResult = db
+            .prepare(`SELECT COUNT(*) as count FROM work_items ${whereClause}`)
+            .get(params);
+        // Priority order: critical > high > medium > low
+        const priorityOrder = `
+      CASE priority
+        WHEN 'critical' THEN 1
+        WHEN 'high' THEN 2
+        WHEN 'medium' THEN 3
+        WHEN 'low' THEN 4
+        ELSE 5
+      END
+    `;
+        // Get items with pagination
+        let query = `
+      SELECT * FROM work_items ${whereClause}
+      ORDER BY
+        CASE status WHEN 'in_progress' THEN 0 ELSE 1 END,
+        ${priorityOrder},
+        created_at ASC
+    `;
+        const limit = input.limit ?? 50;
+        const offset = input.offset ?? 0;
+        query += ` LIMIT @limit OFFSET @offset`;
+        params.limit = limit;
+        params.offset = offset;
+        const records = db.prepare(query).all(params);
+        return {
+            items: records.map(recordToWorkItem),
+            total: countResult.count,
+            hasMore: offset + records.length < countResult.count,
+        };
+    },
+    /**
+     * Get next work item (highest priority backlog item)
+     */
+    getNext(projectId, type) {
+        const db = getDb();
+        const priorityOrder = `
+      CASE priority
+        WHEN 'critical' THEN 1
+        WHEN 'high' THEN 2
+        WHEN 'medium' THEN 3
+        WHEN 'low' THEN 4
+        ELSE 5
+      END
+    `;
+        let query = `
+      SELECT * FROM work_items
+      WHERE project_id = ? AND status = 'backlog'
+    `;
+        const params = [projectId];
+        if (type) {
+            query += ' AND type = ?';
+            params.push(type);
+        }
+        query += ` ORDER BY ${priorityOrder}, created_at ASC LIMIT 1`;
+        const record = db.prepare(query).get(...params);
+        return record ? recordToWorkItem(record) : null;
+    },
+    /**
+     * Update a work item
+     */
+    update(id, input) {
+        const db = getDb();
+        const updates = [];
+        const params = { id };
+        const oldItem = this.getById(id);
+        if (!oldItem)
+            return null;
+        if (input.type !== undefined) {
+            updates.push('type = @type');
+            params.type = input.type;
+        }
+        if (input.status !== undefined) {
+            updates.push('status = @status');
+            params.status = input.status;
+            // Handle status transitions
+            if (input.status === 'completed' && oldItem.status !== 'completed') {
+                updates.push('completed_at = @completed_at');
+                params.completed_at = new Date().toISOString();
+            }
+            if (input.status === 'in_progress' && oldItem.status === 'backlog') {
+                // Starting work - could track start time here
+            }
+        }
+        if (input.priority !== undefined) {
+            updates.push('priority = @priority');
+            params.priority = input.priority;
+        }
+        if (input.guided_step !== undefined) {
+            updates.push('guided_step = @guided_step');
+            params.guided_step = input.guided_step;
+        }
+        if (input.title !== undefined) {
+            updates.push('title = @title');
+            params.title = input.title;
+        }
+        if (input.description !== undefined) {
+            updates.push('description = @description');
+            params.description = input.description;
+        }
+        if (input.estimated_effort !== undefined) {
+            updates.push('estimated_effort = @estimated_effort');
+            params.estimated_effort = input.estimated_effort;
+        }
+        if (input.actual_minutes !== undefined) {
+            updates.push('actual_minutes = @actual_minutes');
+            params.actual_minutes = input.actual_minutes;
+        }
+        if (input.commit_hash !== undefined) {
+            updates.push('commit_hash = @commit_hash');
+            params.commit_hash = input.commit_hash;
+        }
+        if (updates.length === 0) {
+            return oldItem;
+        }
+        // Always update updated_at
+        updates.push('updated_at = @updated_at');
+        params.updated_at = new Date().toISOString();
+        const query = `UPDATE work_items SET ${updates.join(', ')} WHERE id = @id`;
+        db.prepare(query).run(params);
+        // Record history
+        this.recordHistory(id, oldItem.projectId, input, oldItem);
+        return this.getById(id);
+    },
+    /**
+     * Record change in history
+     */
+    recordHistory(workItemId, projectId, changes, oldItem) {
+        const db = getDb();
+        const now = new Date().toISOString();
+        // Record status changes
+        if (changes.status && changes.status !== oldItem.status) {
+            db.prepare(`
+        INSERT INTO work_item_history (work_item_id, project_id, action, old_value, new_value, changed_by, changed_at)
+        VALUES (?, ?, 'status_change', ?, ?, 'agent', ?)
+      `).run(workItemId, projectId, oldItem.status, changes.status, now);
+        }
+        // Record priority changes
+        if (changes.priority && changes.priority !== oldItem.priority) {
+            db.prepare(`
+        INSERT INTO work_item_history (work_item_id, project_id, action, old_value, new_value, changed_by, changed_at)
+        VALUES (?, ?, 'priority_change', ?, ?, 'agent', ?)
+      `).run(workItemId, projectId, oldItem.priority, changes.priority, now);
+        }
+        // Record guided step changes
+        if (changes.guided_step !== undefined && changes.guided_step !== oldItem.guidedStep) {
+            db.prepare(`
+        INSERT INTO work_item_history (work_item_id, project_id, action, old_value, new_value, changed_by, changed_at)
+        VALUES (?, ?, 'step_advance', ?, ?, 'agent', ?)
+      `).run(workItemId, projectId, oldItem.guidedStep ?? 'none', changes.guided_step ?? 'none', now);
+        }
+    },
+    /**
+     * Delete a work item
+     */
+    delete(id) {
+        const db = getDb();
+        const result = db.prepare('DELETE FROM work_items WHERE id = ?').run(id);
+        return result.changes > 0;
+    },
+    /**
+     * Get work item counts by status for a project
+     */
+    getStatusCounts(projectId) {
+        const db = getDb();
+        const results = db
+            .prepare(`
+      SELECT status, COUNT(*) as count
+      FROM work_items
+      WHERE project_id = ?
+      GROUP BY status
+    `)
+            .all(projectId);
+        const counts = {
+            backlog: 0,
+            in_progress: 0,
+            completed: 0,
+            skipped: 0,
+        };
+        for (const row of results) {
+            counts[row.status] = row.count;
+        }
+        return counts;
+    },
+    /**
+     * Get history for a work item
+     */
+    getHistory(workItemId) {
+        const db = getDb();
+        const records = db
+            .prepare(`
+      SELECT * FROM work_item_history
+      WHERE work_item_id = ?
+      ORDER BY changed_at DESC
+    `)
+            .all(workItemId);
+        return records.map((r) => ({
+            action: r.action,
+            oldValue: r.old_value,
+            newValue: r.new_value,
+            notes: r.notes,
+            changedBy: r.changed_by,
+            changedAt: new Date(r.changed_at),
+        }));
+    },
+    /**
+     * Bulk import work items (for /promote command)
+     */
+    bulkCreate(projectId, items) {
+        const db = getDb();
+        const now = new Date().toISOString();
+        const createdIds = [];
+        // Get starting item number
+        const maxResult = db
+            .prepare('SELECT MAX(item_number) as max_num FROM work_items WHERE project_id = ?')
+            .get(projectId);
+        let itemNumber = (maxResult.max_num ?? 0) + 1;
+        const insertStmt = db.prepare(`
+      INSERT INTO work_items (
+        project_id, item_number, item_id, type, status, priority,
+        title, description, created_at, updated_at
+      ) VALUES (
+        @project_id, @item_number, @item_id, @type, @status, @priority,
+        @title, @description, @created_at, @updated_at
+      )
+    `);
+        // Use transaction for atomicity
+        const insertAll = db.transaction(() => {
+            for (const item of items) {
+                const itemId = `${getTypePrefix(item.type)}-${String(itemNumber).padStart(3, '0')}`;
+                const result = insertStmt.run({
+                    project_id: projectId,
+                    item_number: itemNumber,
+                    item_id: itemId,
+                    type: item.type,
+                    status: 'backlog',
+                    priority: item.priority ?? 'medium',
+                    title: item.title,
+                    description: item.description ?? null,
+                    created_at: now,
+                    updated_at: now,
+                });
+                createdIds.push(Number(result.lastInsertRowid));
+                itemNumber++;
+            }
+        });
+        insertAll();
+        // Fetch all created items
+        return createdIds
+            .map((id) => this.getById(id))
+            .filter((item) => item !== null);
+    },
+};

package/dist/db/schema.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Database Schema for compilr-cli workflow system
+ *
+ * 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 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;
+    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;
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkItemHistoryRecord {
+    id: number;
+    work_item_id: number;
+    project_id: number;
+    action: string;
+    old_value: string | null;
+    new_value: string | null;
+    notes: string | null;
+    changed_by: string | null;
+    changed_at: string;
+}
+export type ProjectType = 'general' | 'web' | 'cli' | 'library' | 'api';
+export type ProjectStatus = 'active' | 'paused' | 'completed' | 'archived';
+export type RepoPattern = 'single' | 'two-repo';
+export type WorkflowMode = 'flexible' | 'guided';
+export type LifecycleState = 'setup' | 'active' | 'maintenance' | 'complete';
+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';

package/dist/db/schema.js

@@ -0,0 +1,143 @@
+/**
+ * Database Schema for compilr-cli workflow system
+ *
+ * Based on: db-workflow-architecture.md
+ * Database: SQLite via better-sqlite3
+ */
+export const SCHEMA_VERSION = 1;
+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,
+
+  -- Project type and status
+  type TEXT DEFAULT 'general',
+  status TEXT DEFAULT 'active',
+
+  -- Paths
+  path TEXT NOT NULL,
+  docs_path TEXT,
+  repo_pattern TEXT DEFAULT 'single',
+
+  -- Tech stack (auto-detected)
+  language TEXT,
+  framework TEXT,
+  package_manager TEXT,
+  runtime_version TEXT,
+
+  -- Commands (JSON)
+  commands TEXT,
+
+  -- Git info
+  git_remote TEXT,
+  git_branch TEXT DEFAULT 'main',
+
+  -- Workflow
+  workflow_mode TEXT DEFAULT 'flexible',
+  lifecycle_state TEXT DEFAULT 'setup',
+  current_item_id TEXT,
+
+  -- Context & Metadata (JSON)
+  last_context TEXT,
+  metadata TEXT,
+
+  -- Timestamps
+  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,
+
+  -- Identity
+  item_number INTEGER NOT NULL,
+  item_id TEXT NOT NULL,
+
+  -- Classification
+  type TEXT NOT NULL,
+  status TEXT DEFAULT 'backlog',
+  priority TEXT DEFAULT 'medium',
+
+  -- Guided mode: current step in work item cycle
+  guided_step TEXT,
+
+  -- Content
+  title TEXT NOT NULL,
+  description TEXT,
+
+  -- Effort tracking
+  estimated_effort TEXT,
+  actual_minutes INTEGER,
+
+  -- Completion
+  completed_at DATETIME,
+  completed_by TEXT,
+  commit_hash TEXT,
+
+  -- Timestamps
+  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, 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,
+
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+);
+
+-- 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 for common queries
+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_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_work_item_history_item ON work_item_history(work_item_id);
+`;

package/dist/debug.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Debug Logger
+ *
+ * Writes debug output to a file for troubleshooting.
+ * Enable with DEBUG=1 environment variable.
+ */
+export declare function debug(category: string, message: string, data?: unknown): void;
+export declare function debugError(category: string, error: unknown): void;

package/dist/debug.js

@@ -0,0 +1,48 @@
+/**
+ * Debug Logger
+ *
+ * Writes debug output to a file for troubleshooting.
+ * Enable with DEBUG=1 environment variable.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const DEBUG_ENABLED = process.env.DEBUG === '1';
+const LOG_FILE = path.join(process.cwd(), 'compilr-debug.log');
+let initialized = false;
+function ensureInit() {
+    if (!initialized && DEBUG_ENABLED) {
+        // Clear log file on start
+        fs.writeFileSync(LOG_FILE, `=== Debug Log Started: ${new Date().toISOString()} ===\n`);
+        initialized = true;
+    }
+}
+export function debug(category, message, data) {
+    if (!DEBUG_ENABLED)
+        return;
+    ensureInit();
+    const timestamp = new Date().toISOString();
+    let line = `[${timestamp}] [${category}] ${message}`;
+    if (data !== undefined) {
+        try {
+            line += '\n  ' + JSON.stringify(data, null, 2).replace(/\n/g, '\n  ');
+        }
+        catch {
+            line += '\n  [Unstringifiable data]';
+        }
+    }
+    fs.appendFileSync(LOG_FILE, line + '\n');
+}
+export function debugError(category, error) {
+    if (!DEBUG_ENABLED)
+        return;
+    ensureInit();
+    const timestamp = new Date().toISOString();
+    let line = `[${timestamp}] [${category}] ERROR: `;
+    if (error instanceof Error) {
+        line += `${error.message}\n  Stack: ${error.stack ?? 'no stack'}`;
+    }
+    else {
+        line += String(error);
+    }
+    fs.appendFileSync(LOG_FILE, line + '\n');
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};