@proletariat/cli 0.2.0 → 0.3.0

package/dist/lib/pmo/storage/projects.js

@@ -0,0 +1,303 @@
+/**
+ * Project operations.
+ * Board columns are now derived from workflow statuses (single source of truth).
+ */
+import { PMO_TABLES } from '../schema.js';
+import { PMOError, } from '../types.js';
+import { generateEntityId } from '../utils.js';
+import { generateBoardMarkdown } from '../markdown.js';
+import { rowToTicket } from './helpers.js';
+const T = PMO_TABLES;
+export class ProjectStorage {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * Initialize a project with a workflow.
+     * @deprecated Use createProject with a template instead.
+     */
+    async init(projectId, config) {
+        const projectName = config.name || 'Project Board';
+        const now = Date.now();
+        // Create or update project with default workflow
+        this.ctx.db.prepare(`
+      INSERT OR REPLACE INTO ${T.projects} (id, name, template, workflow_id, updated_at)
+      VALUES (?, ?, ?, 'default', ?)
+    `).run(projectId, projectName, 'kanban', now);
+        return this.getBoard(projectId);
+    }
+    /**
+     * Get the project board.
+     * Columns are derived from the project's workflow statuses.
+     * Tickets are sorted by priority (P0 first) then created_at (oldest first).
+     */
+    async getBoard(projectId) {
+        // Get project metadata with workflow
+        const projectRow = this.ctx.db.prepare(`
+      SELECT id, name, workflow_id, updated_at FROM ${T.projects} WHERE id = ?
+    `).get(projectId);
+        if (!projectRow) {
+            throw new PMOError('NOT_FOUND', `Project not found: ${projectId}. Run init() first.`);
+        }
+        // Get workflow statuses as columns
+        const workflowId = projectRow.workflow_id || 'default';
+        const statusRows = this.ctx.db.prepare(`
+      SELECT * FROM ${T.workflow_statuses}
+      WHERE workflow_id = ?
+      ORDER BY position
+    `).all(workflowId);
+        // Build columns from statuses, with tickets sorted by priority then created_at
+        const columns = await Promise.all(statusRows.map(async (status) => ({
+            id: status.id,
+            name: status.name,
+            position: status.position,
+            status: status.category,
+            tickets: await this.getTicketsForStatus(status.id, projectId),
+        })));
+        return {
+            id: projectRow.id,
+            name: projectRow.name,
+            columns,
+            updatedAt: new Date(projectRow.updated_at),
+        };
+    }
+    /**
+     * Get the board as markdown.
+     */
+    async getBoardMarkdown(projectId) {
+        const board = await this.getBoard(projectId);
+        return generateBoardMarkdown(board);
+    }
+    /**
+     * Create a new project.
+     * Assigns a workflow based on the workflow ID (defaults to 'default' workflow).
+     */
+    async createProject(project) {
+        const id = project.id || generateEntityId(this.ctx.db, 'project');
+        const workflowId = project.template || 'default';
+        const now = Date.now();
+        // Try to find a workflow with matching ID
+        const workflow = this.ctx.db.prepare(`
+      SELECT id FROM ${T.workflows} WHERE id = ?
+    `).get(workflowId);
+        // Use the requested workflow if it exists, otherwise fall back to default
+        const finalWorkflowId = workflow ? workflowId : 'default';
+        // Insert project with workflow
+        this.ctx.db.prepare(`
+      INSERT OR REPLACE INTO ${T.projects} (id, name, template, description, workflow_id, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(id, project.name, workflowId, project.description || null, finalWorkflowId, now, now);
+        return this.getBoard(id);
+    }
+    /**
+     * Get project board by ID.
+     */
+    async getProjectBoard(projectId) {
+        const projectRow = this.ctx.db.prepare(`
+      SELECT id, name, template, description, workflow_id, updated_at FROM ${T.projects} WHERE id = ?
+    `).get(projectId);
+        if (!projectRow) {
+            return null;
+        }
+        // Get workflow statuses as columns
+        const workflowId = projectRow.workflow_id || 'default';
+        const statusRows = this.ctx.db.prepare(`
+      SELECT * FROM ${T.workflow_statuses}
+      WHERE workflow_id = ?
+      ORDER BY position
+    `).all(workflowId);
+        const columns = await Promise.all(statusRows.map(async (status) => ({
+            id: status.id,
+            name: status.name,
+            position: status.position,
+            status: status.category,
+            tickets: await this.getTicketsForStatus(status.id, projectId),
+        })));
+        return {
+            id: projectRow.id,
+            name: projectRow.name,
+            columns,
+            updatedAt: new Date(projectRow.updated_at),
+        };
+    }
+    /**
+     * Get tickets for a status (column).
+     * Tickets are sorted by priority (P0 first) then created_at (oldest first).
+     */
+    async getTicketsForStatus(statusId, projectId) {
+        const ticketRows = this.ctx.db.prepare(`
+      SELECT t.*,
+             ws.name as status_name,
+             ws.category as status_category
+      FROM ${T.tickets} t
+      LEFT JOIN ${T.workflow_statuses} ws ON t.status_id = ws.id
+      WHERE t.status_id = ? AND t.project_id = ?
+      ORDER BY
+        CASE t.priority
+          WHEN 'P0' THEN 0
+          WHEN 'P1' THEN 1
+          WHEN 'P2' THEN 2
+          WHEN 'P3' THEN 3
+          ELSE 4
+        END,
+        t.created_at ASC
+    `).all(statusId, projectId);
+        return Promise.all(ticketRows.map((row) => rowToTicket(this.ctx.db, row)));
+    }
+    /**
+     * List project summaries.
+     */
+    async listProjectSummaries() {
+        const projects = this.ctx.db.prepare(`
+      SELECT p.*, COUNT(t.id) as ticket_count
+      FROM ${T.projects} p
+      LEFT JOIN ${T.tickets} t ON p.id = t.project_id
+      GROUP BY p.id
+      ORDER BY p.created_at
+    `).all();
+        return projects.map((p) => ({
+            id: p.id,
+            name: p.name,
+            template: p.template,
+            description: p.description,
+            ticketCount: p.ticket_count,
+        }));
+    }
+    /**
+     * Delete a project.
+     */
+    async deleteProject(projectId) {
+        if (projectId === 'default') {
+            throw new PMOError('INVALID', 'Cannot delete the default project');
+        }
+        const result = this.ctx.db.prepare(`DELETE FROM ${T.projects} WHERE id = ?`).run(projectId);
+        if (result.changes === 0) {
+            throw new PMOError('NOT_FOUND', `Project not found: ${projectId}`);
+        }
+        // Tickets are deleted via CASCADE
+    }
+    /**
+     * Get a project by ID.
+     */
+    async getProject(id) {
+        const row = this.ctx.db.prepare(`SELECT * FROM ${T.projects} WHERE id = ?`).get(id);
+        if (!row)
+            return null;
+        return this.rowToProject(row);
+    }
+    /**
+     * Update a project.
+     */
+    async updateProject(id, changes) {
+        const existing = await this.getProject(id);
+        if (!existing) {
+            throw new PMOError('NOT_FOUND', `Project not found: ${id}`);
+        }
+        const updates = ['updated_at = ?'];
+        const params = [Date.now()];
+        if (changes.name !== undefined) {
+            updates.push('name = ?');
+            params.push(changes.name);
+        }
+        if (changes.description !== undefined) {
+            updates.push('description = ?');
+            params.push(changes.description || null);
+        }
+        if (changes.status !== undefined) {
+            updates.push('status = ?');
+            params.push(changes.status);
+        }
+        if (changes.phaseId !== undefined) {
+            updates.push('phase_id = ?');
+            params.push(changes.phaseId || null);
+        }
+        if (changes.workflowId !== undefined) {
+            updates.push('workflow_id = ?');
+            params.push(changes.workflowId || null);
+        }
+        if (changes.isArchived !== undefined) {
+            updates.push('is_archived = ?');
+            params.push(changes.isArchived ? 1 : 0);
+        }
+        if (changes.targetDate !== undefined) {
+            updates.push('target_date = ?');
+            params.push(changes.targetDate ? changes.targetDate.toISOString() : null);
+        }
+        params.push(id);
+        this.ctx.db.prepare(`UPDATE ${T.projects} SET ${updates.join(', ')} WHERE id = ?`).run(...params);
+        return (await this.getProject(id));
+    }
+    /**
+     * List projects with optional filter.
+     */
+    async listProjects(filter) {
+        let sql = `SELECT * FROM ${T.projects}`;
+        const conditions = [];
+        const params = [];
+        // Filter by archived status if explicitly specified
+        if (filter?.isArchived === true) {
+            conditions.push('is_archived = 1');
+        }
+        else if (filter?.isArchived === false) {
+            conditions.push('is_archived = 0');
+        }
+        if (filter?.phaseId) {
+            conditions.push('phase_id = ?');
+            params.push(filter.phaseId);
+        }
+        if (filter?.search) {
+            conditions.push('(name LIKE ? OR description LIKE ?)');
+            const searchTerm = `%${filter.search}%`;
+            params.push(searchTerm, searchTerm);
+        }
+        if (conditions.length > 0) {
+            sql += ' WHERE ' + conditions.join(' AND ');
+        }
+        sql += ' ORDER BY updated_at DESC';
+        const rows = this.ctx.db.prepare(sql).all(...params);
+        return rows.map((row) => this.rowToProject(row));
+    }
+    /**
+     * Archive a project.
+     */
+    async archiveProject(id) {
+        const existing = await this.getProject(id);
+        if (!existing) {
+            throw new PMOError('NOT_FOUND', `Project not found: ${id}`);
+        }
+        if (existing.isArchived) {
+            return existing;
+        }
+        return this.updateProject(id, { isArchived: true });
+    }
+    /**
+     * Unarchive a project.
+     */
+    async unarchiveProject(id) {
+        const existing = await this.getProject(id);
+        if (!existing) {
+            throw new PMOError('NOT_FOUND', `Project not found: ${id}`);
+        }
+        if (!existing.isArchived) {
+            return existing;
+        }
+        return this.updateProject(id, { isArchived: false });
+    }
+    rowToProject(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            template: row.template || undefined,
+            description: row.description || undefined,
+            status: (row.status || 'active'),
+            phaseId: row.phase_id || undefined,
+            workflowId: row.workflow_id || undefined,
+            isArchived: row.is_archived === 1,
+            targetDate: row.target_date ? new Date(row.target_date) : undefined,
+            initiativeId: row.initiative_id || undefined,
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        };
+    }
+}

package/dist/lib/pmo/storage/specs.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Spec operations for PMO.
+ */
+import { Project, Spec, SpecFilter, Ticket } from '../types.js';
+import { StorageContext } from './types.js';
+export declare class SpecStorage {
+    private ctx;
+    constructor(ctx: StorageContext);
+    /**
+     * Create a new spec.
+     */
+    createSpec(spec: Partial<Spec>): Promise<Spec>;
+    /**
+     * Get a spec by ID.
+     */
+    getSpec(id: string): Promise<Spec | null>;
+    /**
+     * List specs with optional filters.
+     */
+    listSpecs(filter?: SpecFilter): Promise<Spec[]>;
+    /**
+     * Update a spec.
+     */
+    updateSpec(id: string, changes: Partial<Spec>): Promise<Spec>;
+    /**
+     * Delete a spec.
+     */
+    deleteSpec(id: string): Promise<void>;
+    /**
+     * Link a ticket to a spec.
+     */
+    linkTicketToSpec(ticketId: string, specId: string): Promise<void>;
+    /**
+     * Unlink a ticket from a spec.
+     */
+    unlinkTicketFromSpec(ticketId: string, specId: string): Promise<void>;
+    /**
+     * Get tickets for a spec.
+     */
+    getTicketsForSpec(projectId: string, specId: string): Promise<Ticket[]>;
+    /**
+     * Get specs for a ticket.
+     */
+    getSpecsForTicket(ticketId: string): Promise<Spec[]>;
+    /**
+     * Add a spec dependency.
+     */
+    addSpecDependency(specId: string, dependsOnId: string): Promise<void>;
+    /**
+     * Remove a spec dependency.
+     */
+    removeSpecDependency(specId: string, dependsOnId: string): Promise<void>;
+    /**
+     * Get dependencies for a spec.
+     */
+    getSpecDependencies(specId: string): Promise<Spec[]>;
+    /**
+     * Get specs that depend on a spec.
+     */
+    getSpecDependents(specId: string): Promise<Spec[]>;
+    /**
+     * Link a project to a spec.
+     */
+    linkProjectToSpec(projectId: string, specId: string): Promise<void>;
+    /**
+     * Unlink a project from a spec.
+     */
+    unlinkProjectFromSpec(projectId: string, specId: string): Promise<void>;
+    /**
+     * Get specs for a project.
+     */
+    getSpecsForProject(projectId: string): Promise<Spec[]>;
+    /**
+     * Get projects for a spec.
+     */
+    getProjectsForSpec(specId: string): Promise<Project[]>;
+}