@proletariat/cli 0.3.35 → 0.3.40

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

@@ -178,6 +178,39 @@ export function runMigrations(db) {
             }
         }
     }
+    // Migration: Migrate old ticket_dependencies schema (blocked_by_ticket_id) to new format
+    if (tableExists(T.ticket_dependencies)) {
+        const depsColumns = db.pragma(`table_info(${T.ticket_dependencies})`);
+        const depsColumnNames = new Set(depsColumns.map(c => c.name));
+        if (depsColumnNames.has('blocked_by_ticket_id') && !depsColumnNames.has('depends_on_ticket_id')) {
+            // Old schema detected - migrate to new format
+            try {
+                // Create new table with correct schema
+                db.exec(`
+          CREATE TABLE pmo_ticket_dependencies_new (
+            ticket_id TEXT NOT NULL REFERENCES ${T.tickets}(id) ON DELETE RESTRICT,
+            depends_on_ticket_id TEXT NOT NULL REFERENCES ${T.tickets}(id) ON DELETE RESTRICT,
+            dependency_type TEXT NOT NULL DEFAULT 'blocks' CHECK (dependency_type IN ('blocks', 'relates_to', 'duplicates')),
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            PRIMARY KEY (ticket_id, depends_on_ticket_id, dependency_type),
+            CHECK (ticket_id != depends_on_ticket_id)
+          )
+        `);
+                // Copy existing blocking relationships (old schema: ticket_id is blocked by blocked_by_ticket_id)
+                db.exec(`
+          INSERT OR IGNORE INTO pmo_ticket_dependencies_new (ticket_id, depends_on_ticket_id, dependency_type, created_at)
+          SELECT ticket_id, blocked_by_ticket_id, 'blocks', created_at
+          FROM ${T.ticket_dependencies}
+        `);
+                // Replace old table with new one
+                db.exec(`DROP TABLE ${T.ticket_dependencies}`);
+                db.exec(`ALTER TABLE pmo_ticket_dependencies_new RENAME TO ${T.ticket_dependencies}`);
+            }
+            catch {
+                // Migration may have already been applied partially
+            }
+        }
+    }
     // Migration: Convert legacy priority values (URGENT/HIGH/MEDIUM/LOW) to P0-P3
     if (tableExists(T.tickets)) {
         try {
@@ -252,6 +285,19 @@ export function runMigrations(db) {
             // Column may already exist
         }
     }
+    // Migration: Add error_message column to agent_work table (TKT-1082)
+    if (tableExists(T.agent_work)) {
+        const agentWorkColumns = db.pragma(`table_info(${T.agent_work})`);
+        const agentWorkColumnNames = new Set(agentWorkColumns.map(c => c.name));
+        if (!agentWorkColumnNames.has('error_message')) {
+            try {
+                db.exec(`ALTER TABLE ${T.agent_work} ADD COLUMN error_message TEXT`);
+            }
+            catch {
+                // Column may already exist
+            }
+        }
+    }
     // Migration: Reassign orphaned tickets (TKT-940)
     // Tickets with project_id that doesn't match any existing project are "orphaned".
     // This can happen when a 'default' project never existed or was deleted.
@@ -693,6 +739,361 @@ git add -A && prlt commit "your change" && git push
             modifiesCode: true,
             position: 3,
         },
+        {
+            id: 'review',
+            name: 'Code Review',
+            description: 'Review the implementation and post feedback on the PR',
+            prompt: `${PRLT_USAGE_RULE}
+
+---
+
+# Action: Code Review
+
+Review this ticket's implementation thoroughly:
+- Check for bugs, edge cases, and potential issues
+- Look for security vulnerabilities
+- Verify it meets all acceptance criteria
+- Check code quality and maintainability
+- Suggest improvements if appropriate
+
+After reviewing, determine your verdict:
+- **APPROVE**: Code is ready to merge, no significant issues
+- **REQUEST_CHANGES**: There are issues that must be fixed before merging
+- **COMMENT**: General feedback, no blocking issues but some suggestions
+
+Do NOT modify any code. This is a read-only review.`,
+            endPrompt: `When you have finished reviewing, post your review on the PR using \`gh pr review\`.
+
+Choose the appropriate command based on your verdict:
+
+**If approving:**
+\`\`\`bash
+gh pr review --approve --body "## Code Review
+
+### What looks good
+- ...
+
+### Verdict
+APPROVED - Code is ready to merge."
+\`\`\`
+
+**If requesting changes:**
+\`\`\`bash
+gh pr review --request-changes --body "## Code Review
+
+### What looks good
+- ...
+
+### Concerns
+- ...
+
+### Suggested improvements
+- ...
+
+### Verdict
+REQUEST CHANGES - Issues must be addressed before merging."
+\`\`\`
+
+**If commenting:**
+\`\`\`bash
+gh pr review --comment --body "## Code Review
+
+### What looks good
+- ...
+
+### Suggestions
+- ...
+
+### Verdict
+COMMENT - Some suggestions but no blocking issues."
+\`\`\`
+
+Format the body with: what looks good, concerns (if any), suggested improvements (if any), and your verdict.
+
+No commits are needed for code review.`,
+            suggestedForCategories: ['started', 'completed'],
+            modifiesCode: false,
+            position: 4,
+        },
+        {
+            id: 'review-fix',
+            name: 'Review & Fix',
+            description: 'Review the implementation, fix issues, and post feedback on the PR',
+            prompt: `${PRLT_USAGE_RULE}
+
+---
+
+# Action: Review & Fix
+
+Review this ticket's implementation thoroughly and fix any issues found:
+- Check for bugs, edge cases, and potential issues
+- Look for security vulnerabilities
+- Verify it meets all acceptance criteria
+- Check code quality and maintainability
+- Fix any issues you find directly in the code
+
+**IMPORTANT: Commit and push frequently!**
+- Commit after each fix or logical group of changes
+- Push after every 1-2 commits to save your work
+
+\`\`\`bash
+git add -A && prlt commit "fix: address code review findings" && git push
+\`\`\``,
+            endPrompt: `When you have finished reviewing and fixing:
+
+1. **If issues were found and fixed**, post a review summary and push your fixes:
+   \`\`\`bash
+   gh pr review --comment --body "## Code Review & Fix Summary
+
+   ### Issues found and fixed
+   - ...
+
+   ### What looks good
+   - ...
+
+   ### Changes made
+   - ...
+   "
+   prlt commit "fix: address code review findings"
+   git push
+   \`\`\`
+
+2. **If no issues were found**, approve the PR:
+   \`\`\`bash
+   gh pr review --approve --body "## Code Review
+
+   ### What looks good
+   - ...
+
+   ### Verdict
+   APPROVED - Code looks great, no issues found."
+   \`\`\``,
+            suggestedForCategories: ['started', 'completed'],
+            modifiesCode: true,
+            position: 5,
+        },
+        {
+            id: 'revise',
+            name: 'Revise',
+            description: 'Pull the branch, read PR review feedback, implement fixes, and push',
+            prompt: `${PRLT_USAGE_RULE}
+
+---
+
+# Action: Revise
+
+Address the feedback on this ticket's pull request:
+
+1. **Pull the latest branch** to ensure you have the most recent code:
+   \`\`\`bash
+   git pull
+   \`\`\`
+
+2. **Read all review comments and requested changes** from the PR:
+   \`\`\`bash
+   gh pr view
+   gh api repos/{owner}/{repo}/pulls/{number}/comments
+   \`\`\`
+
+3. **Understand each piece of feedback** before making changes — read carefully and understand the reviewer's intent
+
+4. **Implement the requested fixes** and address each review comment:
+   - Make the necessary code changes to address each point
+   - Respond to questions with explanations
+   - Ensure all requested changes are addressed
+
+**IMPORTANT: Commit and push frequently!**
+- Commit after each fix or logical group of changes
+- Push after every 1-2 commits to save your work
+
+\`\`\`bash
+git add -A && prlt commit "fix: address PR review feedback" && git push
+\`\`\``,
+            endPrompt: `After addressing all feedback:
+
+1. **Commit your changes**:
+   \`\`\`bash
+   git add -A
+   prlt commit "fix: address PR review feedback"
+   \`\`\`
+
+2. **Push your changes**:
+   \`\`\`bash
+   git push
+   \`\`\`
+
+3. **Optionally reply to resolved review threads** using the GitHub API:
+   \`\`\`bash
+   gh api repos/{owner}/{repo}/pulls/{number}/comments
+   \`\`\`
+
+The PR will be updated automatically with your pushed changes.`,
+            suggestedForCategories: ['completed'],
+            defaultMoveToCategory: 'started',
+            modifiesCode: true,
+            position: 6,
+        },
+        {
+            id: 'explore-cli',
+            name: 'Explore CLI',
+            description: 'AI QA agent that autonomously explores the interactive CLI to discover bugs',
+            prompt: `${PRLT_USAGE_RULE}
+
+---
+
+# Action: Explore CLI (Autonomous QA)
+
+You are an AI QA tester for the prlt CLI. You have access to a tmux session where the CLI is running.
+Your job is to **systematically explore every menu, try every option, and find bugs**.
+
+## Your Tools
+
+- **tmux_send_keys** — send keystrokes to the tmux session (typing, arrows, Enter, Escape, Ctrl+C, etc.)
+- **tmux_capture_pane** — read the current terminal screen to see what's displayed
+- **tmux_start_session** — start a new tmux session to run the CLI in
+- **tmux_list_sessions** — list active tmux sessions
+- **ticket_create** — file a bug ticket when you find something broken
+
+## Getting Started
+
+1. Start a tmux session for testing:
+   \`\`\`
+   tmux_start_session({ session: "qa-test", command: "prlt" })
+   \`\`\`
+2. Wait a moment, then capture the screen to see the main menu:
+   \`\`\`
+   tmux_capture_pane({ session: "qa-test" })
+   \`\`\`
+3. Begin systematic exploration.
+
+## Exploration Strategies
+
+Work through these systematically. After each action, always capture the screen to see the result.
+
+### 1. Navigate Every Top-Level Menu Item
+- Use arrow keys (Up/Down) to highlight each option
+- Press Enter to select each one
+- Capture the screen to see what happens
+- Press Escape or Ctrl+C to go back
+
+### 2. Test Every Submenu Option
+- For each menu item, explore all sub-options
+- Try selecting each choice in every list/menu
+
+### 3. Test Input Handling
+- **Valid inputs**: Normal expected values
+- **Empty inputs**: Just press Enter without typing anything
+- **Invalid inputs**: Random strings, numbers where text is expected, etc.
+- **Long strings**: Very long ticket titles, descriptions (100+ characters)
+- **Special characters**: Quotes, backslashes, Unicode (emojis, CJK characters)
+- **SQL injection-like**: \`'; DROP TABLE --\` style strings
+- **Boundary values**: 0, -1, 999999, etc. for numeric inputs
+
+### 4. Test Cancellation Flows
+- Press Ctrl+C mid-flow (should exit gracefully, no crash)
+- Press Escape in menus (should go back)
+- Press q or Q in menus (common quit shortcut)
+- Rapidly press Escape multiple times
+
+### 5. Test Navigation Edge Cases
+- Rapid arrow key presses (Up Up Up Down Down Down)
+- Arrow keys at the top/bottom of lists (should not crash)
+- Tab key in various contexts
+- Home/End keys
+
+### 6. Test Error Recovery
+- Navigate to ticket operations without any tickets
+- Try to create items with duplicate names
+- Try operations on non-existent IDs
+
+## What to Look For
+
+- **Crashes**: Unhandled exceptions, stack traces visible on screen
+- **Rendering glitches**: Items cut off, wrong alignment, overlapping text, garbled output
+- **Wrong data**: Incorrect values displayed, stale data, missing information
+- **Missing options**: Menu items that should exist but don't
+- **Broken navigation**: Arrow keys don't work, can't go back, infinite loops
+- **Unhelpful errors**: Generic "Error" with no details, or raw error objects
+- **Hangs**: Screen freezes, no response to input (wait 10 seconds before declaring a hang)
+- **Screen overflow**: Content pushed off screen, no scrolling available
+- **Partial renders**: Screen shows half-drawn UI elements
+- **State corruption**: Operations succeed but data is wrong afterward
+
+## Cross-Validation
+
+Compare what you see on screen with what the MCP tools return:
+- After creating a ticket via the interactive menu, use \`ticket_list\` to verify it was created correctly
+- After moving a ticket, verify the status changed via \`ticket_show\`
+- Check that counts displayed in menus match actual data
+
+## When You Find a Bug
+
+1. **Document exact reproduction steps** — which keys you pressed, in what order
+2. **Capture the screen** showing the bug
+3. **File a ticket** using the ticket_create MCP tool:
+   - Title: Clear description of the bug
+   - Category: "bug"
+   - Priority: P1 for crashes/data loss, P2 for rendering/UX issues, P3 for minor issues
+   - Description: Include exact reproduction steps, screen capture, and expected vs actual behavior
+
+## Session Management
+
+- If the CLI crashes, restart it: kill the session and start a new one
+- If you get stuck, use Ctrl+C to escape, or kill and restart the session
+- Periodically capture the screen even when not expecting changes (catch intermittent issues)
+
+## Test Prioritization
+
+Start with the most commonly used flows, then move to edge cases:
+1. Main menu navigation
+2. Ticket operations (create, list, view, edit, move)
+3. Project operations
+4. Board view
+5. Work/session operations
+6. Epic and spec operations
+7. Settings and configuration
+8. Edge cases and stress testing`,
+            endPrompt: `## Wrap-Up
+
+When you've completed your exploration:
+
+1. **Summarize your findings**: List all bugs found with their ticket IDs
+2. **Note areas not tested**: If you couldn't reach certain features, list them
+3. **Rate overall CLI quality**: Brief assessment of stability, UX, and completeness
+
+Output a structured summary:
+\`\`\`
+## Exploratory QA Summary
+
+### Bugs Filed
+- TKT-XXX: [brief description]
+- TKT-YYY: [brief description]
+
+### Areas Tested
+- [ ] Main menu navigation
+- [ ] Ticket CRUD
+- [ ] Project operations
+- [ ] Board view
+- [ ] Work sessions
+- [ ] Epics & specs
+- [ ] Error handling
+- [ ] Input validation
+
+### Areas Not Tested
+- [list any areas you couldn't reach]
+
+### Overall Assessment
+[Brief quality assessment]
+\`\`\`
+
+Clean up your tmux session:
+\`\`\`
+tmux_kill_session({ session: "qa-test" })
+\`\`\``,
+            suggestedForCategories: [],
+            modifiesCode: false,
+            position: 8,
+        },
         {
             id: 'test',
             name: 'Write Tests',
@@ -733,56 +1134,7 @@ git add -A && prlt commit "add tests for X" && git push
 **IMPORTANT:** Use the global \`prlt\` command.`,
             suggestedForCategories: ['started', 'completed'],
             modifiesCode: true,
-            position: 4,
-        },
-        {
-            id: 'review',
-            name: 'Code Review',
-            description: 'Review the implementation for issues',
-            prompt: `Review this ticket's implementation thoroughly:
-- Check for bugs, edge cases, and potential issues
-- Look for security vulnerabilities
-- Verify it meets all acceptance criteria
-- Check code quality and maintainability
-- Suggest improvements if appropriate
-
-Output a review summary with your findings and any concerns.`,
-            endPrompt: `When you have finished reviewing, output a detailed review summary with:
-- ✅ What looks good
-- ⚠️ Concerns or potential issues
-- 🔧 Suggested improvements
-- 📋 Verdict: Approve, Request Changes, or Needs Discussion
-
-No commits are needed for code review.`,
-            suggestedForCategories: ['started', 'completed'],
-            modifiesCode: false,
-            position: 5,
-        },
-        {
-            id: 'revise',
-            name: 'Revise',
-            description: 'Address PR feedback and review comments',
-            prompt: `${PRLT_USAGE_RULE}
-
----
-
-# Action: Revise
-
-Address the feedback on this ticket's pull request:
-- Review all comments and requested changes carefully
-- Make the necessary code changes to address each point
-- Respond to questions with explanations
-- Push updates to the PR branch
-- Mark resolved conversations as resolved`,
-            endPrompt: `After addressing the feedback:
-1. Commit your changes using \`prlt commit "your message"\`
-2. Push your changes: \`git push\`
-
-The PR will be updated automatically.`,
-            suggestedForCategories: ['completed'],
-            defaultMoveToCategory: 'started',
-            modifiesCode: true,
-            position: 6,
+            position: 7,
         },
     ];
     // Use INSERT OR REPLACE to always update builtin actions with latest prompts

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

@@ -16,6 +16,7 @@ export declare class DependencyStorage {
     deleteTicketDependency(ticketId: string, dependsOnTicketId: string, dependencyType?: TicketDependencyType): Promise<void>;
     /**
      * List dependencies for a ticket.
+     * For relates_to dependencies, also returns reverse relationships (symmetric).
      */
     listTicketDependencies(ticketId: string): Promise<TicketDependency[]>;
     /**

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

@@ -63,14 +63,22 @@ export class DependencyStorage {
     }
     /**
      * List dependencies for a ticket.
+     * For relates_to dependencies, also returns reverse relationships (symmetric).
      */
     async listTicketDependencies(ticketId) {
         const rows = this.ctx.db.prepare(`
       SELECT ticket_id, depends_on_ticket_id, dependency_type, created_at
       FROM ${T.ticket_dependencies}
       WHERE ticket_id = ?
+
+      UNION
+
+      SELECT depends_on_ticket_id AS ticket_id, ticket_id AS depends_on_ticket_id, dependency_type, created_at
+      FROM ${T.ticket_dependencies}
+      WHERE depends_on_ticket_id = ? AND dependency_type = 'relates_to'
+
       ORDER BY created_at DESC
-    `).all(ticketId);
+    `).all(ticketId, ticketId);
         return rows.map((row) => ({
             ticketId: row.ticket_id,
             dependsOnTicketId: row.depends_on_ticket_id,
@@ -92,7 +100,7 @@ export class DependencyStorage {
       LEFT JOIN ${T.workflow_statuses} ws ON t.status_id = ws.id
       WHERE d.ticket_id = ? AND d.dependency_type = 'blocks'
     `).all(ticketId);
-        return Promise.all(rows.map((row) => rowToTicket(this.ctx.db, row)));
+        return Promise.all(rows.map((row) => rowToTicket(this.ctx.drizzle, row)));
     }
     /**
      * Get tickets that depend on this ticket (blocking).
@@ -108,7 +116,7 @@ export class DependencyStorage {
       LEFT JOIN ${T.workflow_statuses} ws ON t.status_id = ws.id
       WHERE d.depends_on_ticket_id = ? AND d.dependency_type = 'blocks'
     `).all(ticketId);
-        return Promise.all(rows.map((row) => rowToTicket(this.ctx.db, row)));
+        return Promise.all(rows.map((row) => rowToTicket(this.ctx.drizzle, row)));
     }
     /**
      * Check if a ticket is blocked by incomplete dependencies.

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

@@ -186,7 +186,7 @@ export class EpicStorage {
       WHERE t.project_id = ? AND t.epic_id = ?
       ORDER BY ws.position, t.position ASC, t.created_at ASC
     `).all(projectId, epicId);
-        return Promise.all(rows.map((row) => rowToTicket(this.ctx.db, row)));
+        return Promise.all(rows.map((row) => rowToTicket(this.ctx.drizzle, row)));
     }
     /**
      * Link a ticket to an epic.

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

@@ -1,7 +1,7 @@
 /**
  * Helper functions for converting database rows to domain types.
  */
-import Database from 'better-sqlite3';
+import type { DrizzleDB } from '../../database/drizzle.js';
 import { AcceptanceCriterion, Spec, StateCategory, Ticket } from '../types.js';
 import { SpecRow, TicketRow, WorkflowStatusRow } from './types.js';
 /**
@@ -16,13 +16,13 @@ import { SpecRow, TicketRow, WorkflowStatusRow } from './types.js';
 export declare function wrapSqliteError(entityType: string, operation: 'create' | 'update' | 'delete', err: unknown): never;
 /**
  * Convert a database row to a Ticket object.
- * Fetches related data (subtasks, metadata, status info).
+ * Fetches related data (subtasks, metadata, status info) using Drizzle ORM.
  */
-export declare function rowToTicket(db: Database.Database, row: TicketRow): Promise<Ticket>;
+export declare function rowToTicket(drizzle: DrizzleDB, row: TicketRow): Promise<Ticket>;
 /**
  * Get acceptance criteria for a ticket (sync version).
  */
-export declare function getAcceptanceCriteriaSync(db: Database.Database, ticketId: string): AcceptanceCriterion[];
+export declare function getAcceptanceCriteriaSync(drizzle: DrizzleDB, ticketId: string): AcceptanceCriterion[];
 /**
  * Convert a database row to a Spec object.
  */

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

@@ -1,7 +1,8 @@
 /**
  * Helper functions for converting database rows to domain types.
  */
-import { PMO_TABLES } from '../schema.js';
+import { eq, asc } from 'drizzle-orm';
+import { pmoSubtasks, pmoTicketMetadata, pmoWorkflowStatuses, pmoTicketAcceptanceCriteria, } from '../../database/drizzle-schema.js';
 import { PMOError, normalizePriority, } from '../types.js';
 /**
  * Check if an error is a SQLite UNIQUE constraint violation.
@@ -61,31 +62,37 @@ export function wrapSqliteError(entityType, operation, err) {
     // Re-throw unknown errors
     throw err;
 }
-const T = PMO_TABLES;
 /**
  * Convert a database row to a Ticket object.
- * Fetches related data (subtasks, metadata, status info).
+ * Fetches related data (subtasks, metadata, status info) using Drizzle ORM.
  */
-export async function rowToTicket(db, row) {
+export async function rowToTicket(drizzle, row) {
     // Get subtasks
-    const subtasks = db
-        .prepare(`SELECT * FROM ${T.subtasks} WHERE ticket_id = ? ORDER BY position`)
-        .all(row.id);
+    const subtaskRows = drizzle
+        .select()
+        .from(pmoSubtasks)
+        .where(eq(pmoSubtasks.ticketId, row.id))
+        .orderBy(asc(pmoSubtasks.position))
+        .all();
     // Get metadata
-    const metaRows = db
-        .prepare(`SELECT key, value FROM ${T.ticket_metadata} WHERE ticket_id = ?`)
-        .all(row.id);
+    const metaRows = drizzle
+        .select({ key: pmoTicketMetadata.key, value: pmoTicketMetadata.value })
+        .from(pmoTicketMetadata)
+        .where(eq(pmoTicketMetadata.ticketId, row.id))
+        .all();
     const metadata = {};
     for (const m of metaRows) {
-        metadata[m.key] = m.value;
+        metadata[m.key] = m.value || '';
     }
     // Get status info from workflow_statuses
     let statusName;
     let statusCategory;
     if (row.status_id) {
-        const statusRow = db
-            .prepare(`SELECT name, category FROM ${T.workflow_statuses} WHERE id = ?`)
-            .get(row.status_id);
+        const statusRow = drizzle
+            .select({ name: pmoWorkflowStatuses.name, category: pmoWorkflowStatuses.category })
+            .from(pmoWorkflowStatuses)
+            .where(eq(pmoWorkflowStatuses.id, row.status_id))
+            .get();
         if (statusRow) {
             statusName = statusRow.name;
             statusCategory = statusRow.category;
@@ -126,14 +133,14 @@ export async function rowToTicket(db, row) {
         branch: row.branch || undefined,
         specId: row.spec_id || undefined,
         epicId: row.epic_id || undefined,
-        subtasks: subtasks.map((st) => ({
+        subtasks: subtaskRows.map((st) => ({
             id: st.id,
             title: st.title,
-            done: st.done === 1,
+            done: st.done ?? false,
         })),
         labels,
         metadata,
-        acceptanceCriteria: getAcceptanceCriteriaSync(db, row.id),
+        acceptanceCriteria: getAcceptanceCriteriaSync(drizzle, row.id),
         createdAt: new Date(row.created_at),
         updatedAt: new Date(row.updated_at),
         lastSyncedFromSpec: row.last_synced_from_spec
@@ -148,18 +155,21 @@ export async function rowToTicket(db, row) {
 /**
  * Get acceptance criteria for a ticket (sync version).
  */
-export function getAcceptanceCriteriaSync(db, ticketId) {
-    const rows = db
-        .prepare(`SELECT * FROM ${T.ticket_acceptance_criteria} WHERE ticket_id = ? ORDER BY position`)
-        .all(ticketId);
+export function getAcceptanceCriteriaSync(drizzle, ticketId) {
+    const rows = drizzle
+        .select()
+        .from(pmoTicketAcceptanceCriteria)
+        .where(eq(pmoTicketAcceptanceCriteria.ticketId, ticketId))
+        .orderBy(asc(pmoTicketAcceptanceCriteria.position))
+        .all();
     return rows.map((row) => ({
         id: row.id,
-        ticketId: row.ticket_id,
+        ticketId: row.ticketId,
         criterion: row.criterion,
-        verifiable: row.verifiable === 1,
-        verified: row.verified === 1,
-        verifiedAt: row.verified_at ? new Date(row.verified_at) : undefined,
-        verifiedBy: row.verified_by || undefined,
+        verifiable: row.verifiable ?? true,
+        verified: row.verified ?? false,
+        verifiedAt: row.verifiedAt ? new Date(row.verifiedAt) : undefined,
+        verifiedBy: row.verifiedBy || undefined,
         position: row.position,
     }));
 }

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

@@ -1,6 +1,8 @@
 /**
  * Project operations.
  * Board columns are now derived from workflow statuses (single source of truth).
+ *
+ * This module uses Drizzle ORM for type-safe database queries.
  */
 import { Board, BoardConfig, Project, ProjectFilter } from '../types.js';
 import { StorageContext } from './types.js';