@proletariat/cli 0.3.16 → 0.3.18

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

@@ -3,8 +3,12 @@
  *
  * This is the main facade that delegates to domain-specific storage modules.
  * Uses the unified workspace.db database with pmo_ prefixed tables.
+ *
+ * This module now supports Drizzle ORM for type-safe queries while maintaining
+ * backward compatibility with raw SQL queries during the migration period.
  */
 import Database from 'better-sqlite3';
+import { createDrizzleConnection } from '../../database/drizzle.js';
 import { PMO_TABLES, PMO_SCHEMA_SQL, validateTicketSchema } from '../schema.js';
 import { runMigrations, seedBuiltinWorkflows, seedBuiltinPhases, seedBuiltinPhaseTemplates, seedBuiltinActions, seedBuiltinTicketTemplates, updateBoardTimestamp, } from './base.js';
 import { ProjectStorage } from './projects.js';
@@ -23,6 +27,7 @@ const T = PMO_TABLES;
 export class SQLiteStorage {
     type = 'sqlite';
     db;
+    drizzle;
     dbPath;
     // Domain-specific storage modules
     projectStorage;
@@ -43,10 +48,13 @@ export class SQLiteStorage {
         // Open database (creates if doesn't exist)
         this.db = new Database(dbPath);
         this.db.pragma('foreign_keys = ON');
+        // Create Drizzle ORM connection wrapping the same database
+        this.drizzle = createDrizzleConnection(this.db);
         // Create the storage context shared by all modules
         // Note: projectId is passed explicitly to operations, not stored in context
         const ctx = {
             db: this.db,
+            drizzle: this.drizzle,
             updateBoardTimestamp: (projectId) => updateBoardTimestamp(this.db, projectId),
         };
         // Initialize domain-specific storage modules
@@ -72,6 +80,12 @@ export class SQLiteStorage {
     getDatabase() {
         return this.db;
     }
+    /**
+     * Get the Drizzle ORM database connection for type-safe queries.
+     */
+    getDrizzle() {
+        return this.drizzle;
+    }
     /**
      * Ensure PMO tables exist in the database.
      */

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

@@ -7,6 +7,19 @@ import { StorageContext } from './types.js';
 export declare class ProjectStorage {
     private ctx;
     constructor(ctx: StorageContext);
+    /**
+     * Resolve a project identifier to its actual ID.
+     * Tries multiple strategies:
+     * 1. Exact ID match
+     * 2. Case-insensitive ID match
+     * 3. Exact name match
+     * 4. Case-insensitive name match
+     * 5. Slugified name match (matches slug of project name)
+     *
+     * @param identifier - Project ID, name, or slug to resolve
+     * @returns The actual project ID, or null if not found
+     */
+    resolveProjectId(identifier: string): string | null;
     /**
      * Initialize a project with a workflow.
      * @deprecated Use createProject with a template instead.
@@ -16,8 +29,10 @@ export declare class ProjectStorage {
      * 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).
+     *
+     * @param projectIdOrName - Project ID, name, or slug. Will be resolved to actual ID.
      */
-    getBoard(projectId: string): Promise<Board>;
+    getBoard(projectIdOrName: string): Promise<Board>;
     /**
      * Get the board as markdown.
      */
@@ -33,9 +48,9 @@ export declare class ProjectStorage {
         description?: string;
     }): Promise<Board>;
     /**
-     * Get project board by ID.
+     * Get project board by ID, name, or slug.
      */
-    getProjectBoard(projectId: string): Promise<Board | null>;
+    getProjectBoard(projectIdOrName: string): Promise<Board | null>;
     /**
      * Get tickets for a status (column).
      * Tickets are sorted by priority (P0 first) then created_at (oldest first).
@@ -52,28 +67,28 @@ export declare class ProjectStorage {
         ticketCount: number;
     }>>;
     /**
-     * Delete a project.
+     * Delete a project by ID, name, or slug.
      */
-    deleteProject(projectId: string): Promise<void>;
+    deleteProject(projectIdOrName: string): Promise<void>;
     /**
-     * Get a project by ID.
+     * Get a project by ID, name, or slug.
      */
-    getProject(id: string): Promise<Project | null>;
+    getProject(idOrName: string): Promise<Project | null>;
     /**
-     * Update a project.
+     * Update a project by ID, name, or slug.
      */
-    updateProject(id: string, changes: Partial<Project>): Promise<Project>;
+    updateProject(idOrName: string, changes: Partial<Project>): Promise<Project>;
     /**
      * List projects with optional filter.
      */
     listProjects(filter?: ProjectFilter): Promise<Project[]>;
     /**
-     * Archive a project.
+     * Archive a project by ID, name, or slug.
      */
-    archiveProject(id: string): Promise<Project>;
+    archiveProject(idOrName: string): Promise<Project>;
     /**
-     * Unarchive a project.
+     * Unarchive a project by ID, name, or slug.
      */
-    unarchiveProject(id: string): Promise<Project>;
+    unarchiveProject(idOrName: string): Promise<Project>;
     private rowToProject;
 }

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

@@ -4,7 +4,7 @@
  */
 import { PMO_TABLES } from '../schema.js';
 import { PMOError, } from '../types.js';
-import { generateEntityId } from '../utils.js';
+import { generateEntityId, slugify } from '../utils.js';
 import { generateBoardMarkdown } from '../markdown.js';
 import { rowToTicket } from './helpers.js';
 const T = PMO_TABLES;
@@ -13,6 +13,59 @@ export class ProjectStorage {
     constructor(ctx) {
         this.ctx = ctx;
     }
+    /**
+     * Resolve a project identifier to its actual ID.
+     * Tries multiple strategies:
+     * 1. Exact ID match
+     * 2. Case-insensitive ID match
+     * 3. Exact name match
+     * 4. Case-insensitive name match
+     * 5. Slugified name match (matches slug of project name)
+     *
+     * @param identifier - Project ID, name, or slug to resolve
+     * @returns The actual project ID, or null if not found
+     */
+    resolveProjectId(identifier) {
+        if (!identifier)
+            return null;
+        // 1. Exact ID match
+        const exactMatch = this.ctx.db.prepare(`
+      SELECT id FROM ${T.projects} WHERE id = ?
+    `).get(identifier);
+        if (exactMatch)
+            return exactMatch.id;
+        // 2. Case-insensitive ID match
+        const caseInsensitiveId = this.ctx.db.prepare(`
+      SELECT id FROM ${T.projects} WHERE LOWER(id) = LOWER(?)
+    `).get(identifier);
+        if (caseInsensitiveId)
+            return caseInsensitiveId.id;
+        // 3. Exact name match
+        const nameMatch = this.ctx.db.prepare(`
+      SELECT id FROM ${T.projects} WHERE name = ?
+    `).get(identifier);
+        if (nameMatch)
+            return nameMatch.id;
+        // 4. Case-insensitive name match
+        const caseInsensitiveName = this.ctx.db.prepare(`
+      SELECT id FROM ${T.projects} WHERE LOWER(name) = LOWER(?)
+    `).get(identifier);
+        if (caseInsensitiveName)
+            return caseInsensitiveName.id;
+        // 5. Slugified name match - check if identifier is a slug of any project name
+        // Get all projects and compare slugified names
+        const allProjects = this.ctx.db.prepare(`
+      SELECT id, name FROM ${T.projects}
+    `).all();
+        const identifierLower = identifier.toLowerCase();
+        for (const project of allProjects) {
+            const projectSlug = slugify(project.name);
+            if (projectSlug === identifierLower || projectSlug === identifier) {
+                return project.id;
+            }
+        }
+        return null;
+    }
     /**
      * Initialize a project with a workflow.
      * @deprecated Use createProject with a template instead.
@@ -31,14 +84,21 @@ export class ProjectStorage {
      * 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).
+     *
+     * @param projectIdOrName - Project ID, name, or slug. Will be resolved to actual ID.
      */
-    async getBoard(projectId) {
-        // Get project metadata with workflow
+    async getBoard(projectIdOrName) {
+        // Resolve project identifier to actual ID
+        const resolvedId = this.resolveProjectId(projectIdOrName);
+        if (!resolvedId) {
+            throw new PMOError('NOT_FOUND', `Project not found: ${projectIdOrName}. Run init() first.`);
+        }
+        // Get project metadata with workflow using resolved ID
         const projectRow = this.ctx.db.prepare(`
       SELECT id, name, workflow_id, updated_at FROM ${T.projects} WHERE id = ?
-    `).get(projectId);
+    `).get(resolvedId);
         if (!projectRow) {
-            throw new PMOError('NOT_FOUND', `Project not found: ${projectId}. Run init() first.`);
+            throw new PMOError('NOT_FOUND', `Project not found: ${projectIdOrName}. Run init() first.`);
         }
         // Get workflow statuses as columns
         const workflowId = projectRow.workflow_id || 'default';
@@ -53,7 +113,7 @@ export class ProjectStorage {
             name: status.name,
             position: status.position,
             status: status.category,
-            tickets: await this.getTicketsForStatus(status.id, projectId),
+            tickets: await this.getTicketsForStatus(status.id, resolvedId),
         })));
         return {
             id: projectRow.id,
@@ -91,12 +151,17 @@ export class ProjectStorage {
         return this.getBoard(id);
     }
     /**
-     * Get project board by ID.
+     * Get project board by ID, name, or slug.
      */
-    async getProjectBoard(projectId) {
+    async getProjectBoard(projectIdOrName) {
+        // Resolve project identifier to actual ID
+        const resolvedId = this.resolveProjectId(projectIdOrName);
+        if (!resolvedId) {
+            return null;
+        }
         const projectRow = this.ctx.db.prepare(`
       SELECT id, name, template, description, workflow_id, updated_at FROM ${T.projects} WHERE id = ?
-    `).get(projectId);
+    `).get(resolvedId);
         if (!projectRow) {
             return null;
         }
@@ -112,7 +177,7 @@ export class ProjectStorage {
             name: status.name,
             position: status.position,
             status: status.category,
-            tickets: await this.getTicketsForStatus(status.id, projectId),
+            tickets: await this.getTicketsForStatus(status.id, resolvedId),
         })));
         return {
             id: projectRow.id,
@@ -165,35 +230,46 @@ export class ProjectStorage {
         }));
     }
     /**
-     * Delete a project.
+     * Delete a project by ID, name, or slug.
      */
-    async deleteProject(projectId) {
-        if (projectId === 'default') {
+    async deleteProject(projectIdOrName) {
+        // Resolve project identifier to actual ID
+        const resolvedId = this.resolveProjectId(projectIdOrName);
+        if (!resolvedId) {
+            throw new PMOError('NOT_FOUND', `Project not found: ${projectIdOrName}`);
+        }
+        if (resolvedId === 'default') {
             throw new PMOError('INVALID', 'Cannot delete the default project');
         }
-        const result = this.ctx.db.prepare(`DELETE FROM ${T.projects} WHERE id = ?`).run(projectId);
+        const result = this.ctx.db.prepare(`DELETE FROM ${T.projects} WHERE id = ?`).run(resolvedId);
         if (result.changes === 0) {
-            throw new PMOError('NOT_FOUND', `Project not found: ${projectId}`);
+            throw new PMOError('NOT_FOUND', `Project not found: ${projectIdOrName}`);
         }
         // Tickets are deleted via CASCADE
     }
     /**
-     * Get a project by ID.
+     * Get a project by ID, name, or slug.
      */
-    async getProject(id) {
-        const row = this.ctx.db.prepare(`SELECT * FROM ${T.projects} WHERE id = ?`).get(id);
+    async getProject(idOrName) {
+        // Resolve project identifier to actual ID
+        const resolvedId = this.resolveProjectId(idOrName);
+        if (!resolvedId)
+            return null;
+        const row = this.ctx.db.prepare(`SELECT * FROM ${T.projects} WHERE id = ?`).get(resolvedId);
         if (!row)
             return null;
         return this.rowToProject(row);
     }
     /**
-     * Update a project.
+     * Update a project by ID, name, or slug.
      */
-    async updateProject(id, changes) {
-        const existing = await this.getProject(id);
+    async updateProject(idOrName, changes) {
+        const existing = await this.getProject(idOrName);
         if (!existing) {
-            throw new PMOError('NOT_FOUND', `Project not found: ${id}`);
+            throw new PMOError('NOT_FOUND', `Project not found: ${idOrName}`);
         }
+        // Use the resolved ID for the update
+        const resolvedId = existing.id;
         const updates = ['updated_at = ?'];
         const params = [Date.now()];
         if (changes.name !== undefined) {
@@ -224,9 +300,9 @@ export class ProjectStorage {
             updates.push('target_date = ?');
             params.push(changes.targetDate ? changes.targetDate.toISOString() : null);
         }
-        params.push(id);
+        params.push(resolvedId);
         this.ctx.db.prepare(`UPDATE ${T.projects} SET ${updates.join(', ')} WHERE id = ?`).run(...params);
-        return (await this.getProject(id));
+        return (await this.getProject(resolvedId));
     }
     /**
      * List projects with optional filter.
@@ -259,30 +335,30 @@ export class ProjectStorage {
         return rows.map((row) => this.rowToProject(row));
     }
     /**
-     * Archive a project.
+     * Archive a project by ID, name, or slug.
      */
-    async archiveProject(id) {
-        const existing = await this.getProject(id);
+    async archiveProject(idOrName) {
+        const existing = await this.getProject(idOrName);
         if (!existing) {
-            throw new PMOError('NOT_FOUND', `Project not found: ${id}`);
+            throw new PMOError('NOT_FOUND', `Project not found: ${idOrName}`);
         }
         if (existing.isArchived) {
             return existing;
         }
-        return this.updateProject(id, { isArchived: true });
+        return this.updateProject(existing.id, { isArchived: true });
     }
     /**
-     * Unarchive a project.
+     * Unarchive a project by ID, name, or slug.
      */
-    async unarchiveProject(id) {
-        const existing = await this.getProject(id);
+    async unarchiveProject(idOrName) {
+        const existing = await this.getProject(idOrName);
         if (!existing) {
-            throw new PMOError('NOT_FOUND', `Project not found: ${id}`);
+            throw new PMOError('NOT_FOUND', `Project not found: ${idOrName}`);
         }
         if (!existing.isArchived) {
             return existing;
         }
-        return this.updateProject(id, { isArchived: false });
+        return this.updateProject(existing.id, { isArchived: false });
     }
     rowToProject(row) {
         return {

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

@@ -1,6 +1,8 @@
 /**
  * Roadmap operations for PMO.
  * Roadmaps are curated collections of projects for documentation/visualization.
+ *
+ * This module uses Drizzle ORM for type-safe database queries.
  */
 import { Roadmap, RoadmapProject, RoadmapFilter, Project } from '../types.js';
 import { StorageContext } from './types.js';