@compilr-dev/cli 0.4.0 → 0.5.1

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

@@ -0,0 +1,101 @@
+/**
+ * Plan Repository
+ *
+ * Handles all database operations for plans.
+ * Plans are stored in project_documents with doc_type='plan'.
+ */
+import type { PlanStatus } from '../schema.js';
+export interface CreatePlanInput {
+    project_id: number;
+    name: string;
+    content: string;
+    work_item_id?: number;
+}
+export interface UpdatePlanInput {
+    content?: string;
+    status?: PlanStatus;
+    work_item_id?: number | null;
+}
+export interface ListPlansOptions {
+    status?: PlanStatus | PlanStatus[];
+    work_item_id?: number;
+    limit?: number;
+    order_by?: 'updated_desc' | 'updated_asc' | 'created_desc' | 'name_asc';
+}
+export interface Plan {
+    id: number;
+    projectId: number;
+    name: string;
+    content: string;
+    status: PlanStatus;
+    workItemId: number | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface PlanSummary {
+    id: number;
+    name: string;
+    status: PlanStatus;
+    workItemId: number | null;
+    workItemTitle?: string;
+    workItemItemId?: string;
+    updatedAt: Date;
+}
+export interface PlanWithWorkItem extends Plan {
+    workItem?: {
+        id: number;
+        itemId: string;
+        title: string;
+        status: string;
+    };
+}
+export declare const planRepository: {
+    /**
+     * Create a new plan
+     */
+    create(input: CreatePlanInput): Plan;
+    /**
+     * Get plan by ID
+     */
+    getById(id: number): Plan | null;
+    /**
+     * Get plan by name for a project
+     */
+    getByName(projectId: number, name: string): Plan | null;
+    /**
+     * Get plan with linked work item details
+     */
+    getWithWorkItem(id: number): PlanWithWorkItem | null;
+    /**
+     * Update a plan
+     */
+    update(id: number, input: UpdatePlanInput): Plan | null;
+    /**
+     * Delete a plan
+     */
+    delete(id: number): boolean;
+    /**
+     * List plans for a project
+     */
+    list(projectId: number, options?: ListPlansOptions): PlanSummary[];
+    /**
+     * Count plans by status for a project
+     */
+    countByStatus(projectId: number): Record<PlanStatus, number>;
+    /**
+     * Get plans with status 'in_progress' for a project
+     */
+    getInProgress(projectId: number): PlanSummary[];
+    /**
+     * Check if there are any in_progress plans for a project
+     */
+    hasInProgress(projectId: number): boolean;
+    /**
+     * Link a plan to a work item
+     */
+    linkWorkItem(planId: number, workItemId: number): Plan | null;
+    /**
+     * Unlink a plan from its work item
+     */
+    unlinkWorkItem(planId: number): Plan | null;
+};

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

@@ -0,0 +1,275 @@
+/**
+ * Plan Repository
+ *
+ * Handles all database operations for plans.
+ * Plans are stored in project_documents with doc_type='plan'.
+ */
+import { getDb } from '../index.js';
+// =============================================================================
+// Status Transition Rules
+// =============================================================================
+const VALID_TRANSITIONS = {
+    draft: ['approved', 'abandoned'],
+    approved: ['in_progress', 'abandoned'],
+    in_progress: ['completed', 'abandoned'],
+    completed: [], // Terminal state
+    abandoned: ['draft'], // Can re-open
+};
+function isValidTransition(from, to) {
+    return VALID_TRANSITIONS[from].includes(to);
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+function recordToPlan(record) {
+    return {
+        id: record.id,
+        projectId: record.project_id,
+        name: record.title,
+        content: record.content,
+        status: record.status ?? 'draft',
+        workItemId: record.work_item_id,
+        createdAt: new Date(record.created_at),
+        updatedAt: new Date(record.updated_at),
+    };
+}
+function recordToPlanSummary(record) {
+    return {
+        id: record.id,
+        name: record.title,
+        status: record.status ?? 'draft',
+        workItemId: record.work_item_id,
+        workItemTitle: record.work_item_title,
+        workItemItemId: record.work_item_item_id,
+        updatedAt: new Date(record.updated_at),
+    };
+}
+// =============================================================================
+// Repository
+// =============================================================================
+export const planRepository = {
+    /**
+     * Create a new plan
+     */
+    create(input) {
+        const db = getDb();
+        const now = new Date().toISOString();
+        const result = db
+            .prepare(`
+        INSERT INTO project_documents (
+          project_id, doc_type, title, content, status, work_item_id,
+          created_at, updated_at
+        ) VALUES (?, 'plan', ?, ?, 'draft', ?, ?, ?)
+      `)
+            .run(input.project_id, input.name, input.content, input.work_item_id ?? null, now, now);
+        const plan = this.getById(Number(result.lastInsertRowid));
+        if (!plan)
+            throw new Error('Failed to create plan');
+        return plan;
+    },
+    /**
+     * Get plan by ID
+     */
+    getById(id) {
+        const db = getDb();
+        const record = db
+            .prepare(`SELECT * FROM project_documents WHERE id = ? AND doc_type = 'plan'`)
+            .get(id);
+        return record ? recordToPlan(record) : null;
+    },
+    /**
+     * Get plan by name for a project
+     */
+    getByName(projectId, name) {
+        const db = getDb();
+        const record = db
+            .prepare(`SELECT * FROM project_documents
+         WHERE project_id = ? AND doc_type = 'plan' AND title = ?`)
+            .get(projectId, name);
+        return record ? recordToPlan(record) : null;
+    },
+    /**
+     * Get plan with linked work item details
+     */
+    getWithWorkItem(id) {
+        const db = getDb();
+        const record = db
+            .prepare(`
+        SELECT pd.*, wi.item_id as wi_item_id, wi.title as wi_title, wi.status as wi_status
+        FROM project_documents pd
+        LEFT JOIN work_items wi ON pd.work_item_id = wi.id
+        WHERE pd.id = ? AND pd.doc_type = 'plan'
+      `)
+            .get(id);
+        if (!record)
+            return null;
+        const plan = recordToPlan(record);
+        if (record.wi_item_id && record.work_item_id !== null) {
+            plan.workItem = {
+                id: record.work_item_id,
+                itemId: record.wi_item_id,
+                title: record.wi_title ?? '',
+                status: record.wi_status ?? '',
+            };
+        }
+        return plan;
+    },
+    /**
+     * Update a plan
+     */
+    update(id, input) {
+        const db = getDb();
+        // Get current plan for status validation
+        const current = this.getById(id);
+        if (!current)
+            return null;
+        // Validate status transition if changing status
+        if (input.status && input.status !== current.status) {
+            if (!isValidTransition(current.status, input.status)) {
+                throw new Error(`Invalid status transition: ${current.status} → ${input.status}`);
+            }
+        }
+        const updates = [];
+        const params = [];
+        if (input.content !== undefined) {
+            updates.push('content = ?');
+            params.push(input.content);
+        }
+        if (input.status !== undefined) {
+            updates.push('status = ?');
+            params.push(input.status);
+        }
+        if (input.work_item_id !== undefined) {
+            updates.push('work_item_id = ?');
+            params.push(input.work_item_id);
+        }
+        if (updates.length === 0) {
+            return current;
+        }
+        updates.push('updated_at = ?');
+        params.push(new Date().toISOString());
+        params.push(id);
+        const query = `UPDATE project_documents SET ${updates.join(', ')} WHERE id = ? AND doc_type = 'plan'`;
+        db.prepare(query).run(...params);
+        return this.getById(id);
+    },
+    /**
+     * Delete a plan
+     */
+    delete(id) {
+        const db = getDb();
+        const result = db
+            .prepare(`DELETE FROM project_documents WHERE id = ? AND doc_type = 'plan'`)
+            .run(id);
+        return result.changes > 0;
+    },
+    /**
+     * List plans for a project
+     */
+    list(projectId, options = {}) {
+        const db = getDb();
+        const conditions = ["pd.project_id = ?", "pd.doc_type = 'plan'"];
+        const params = [projectId];
+        // Filter by status
+        if (options.status) {
+            if (Array.isArray(options.status)) {
+                const placeholders = options.status.map(() => '?').join(', ');
+                conditions.push(`pd.status IN (${placeholders})`);
+                params.push(...options.status);
+            }
+            else {
+                conditions.push('pd.status = ?');
+                params.push(options.status);
+            }
+        }
+        // Filter by work item
+        if (options.work_item_id !== undefined) {
+            conditions.push('pd.work_item_id = ?');
+            params.push(options.work_item_id);
+        }
+        // Order by
+        let orderBy = 'pd.updated_at DESC';
+        switch (options.order_by) {
+            case 'updated_asc':
+                orderBy = 'pd.updated_at ASC';
+                break;
+            case 'created_desc':
+                orderBy = 'pd.created_at DESC';
+                break;
+            case 'name_asc':
+                orderBy = 'pd.title ASC';
+                break;
+        }
+        // Limit
+        const limit = options.limit ?? 20;
+        const query = `
+      SELECT pd.*, wi.title as work_item_title, wi.item_id as work_item_item_id
+      FROM project_documents pd
+      LEFT JOIN work_items wi ON pd.work_item_id = wi.id
+      WHERE ${conditions.join(' AND ')}
+      ORDER BY ${orderBy}
+      LIMIT ?
+    `;
+        params.push(limit);
+        const records = db.prepare(query).all(...params);
+        return records.map(recordToPlanSummary);
+    },
+    /**
+     * Count plans by status for a project
+     */
+    countByStatus(projectId) {
+        const db = getDb();
+        const results = db
+            .prepare(`
+        SELECT status, COUNT(*) as count
+        FROM project_documents
+        WHERE project_id = ? AND doc_type = 'plan'
+        GROUP BY status
+      `)
+            .all(projectId);
+        const counts = {
+            draft: 0,
+            approved: 0,
+            in_progress: 0,
+            completed: 0,
+            abandoned: 0,
+        };
+        for (const row of results) {
+            if (row.status && row.status in counts) {
+                counts[row.status] = row.count;
+            }
+        }
+        return counts;
+    },
+    /**
+     * Get plans with status 'in_progress' for a project
+     */
+    getInProgress(projectId) {
+        return this.list(projectId, { status: 'in_progress' });
+    },
+    /**
+     * Check if there are any in_progress plans for a project
+     */
+    hasInProgress(projectId) {
+        const db = getDb();
+        const result = db
+            .prepare(`
+        SELECT COUNT(*) as count FROM project_documents
+        WHERE project_id = ? AND doc_type = 'plan' AND status = 'in_progress'
+      `)
+            .get(projectId);
+        return result.count > 0;
+    },
+    /**
+     * Link a plan to a work item
+     */
+    linkWorkItem(planId, workItemId) {
+        return this.update(planId, { work_item_id: workItemId });
+    },
+    /**
+     * Unlink a plan from its work item
+     */
+    unlinkWorkItem(planId) {
+        return this.update(planId, { work_item_id: null });
+    },
+};

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,