@proletariat/cli 0.2.0 → 0.3.0

package/dist/lib/pmo/markdown.js

@@ -0,0 +1,245 @@
+/**
+ * PMO Markdown Parser and Generator
+ *
+ * Handles conversion between Obsidian Kanban markdown format and Board objects.
+ */
+import { slugify } from './utils.js';
+// =============================================================================
+// Parser
+// =============================================================================
+/**
+ * Parse an Obsidian Kanban markdown board into a Board object
+ * @param markdown The markdown content
+ * @param projectId The project ID to use (defaults to 'default')
+ */
+export function parseBoard(markdown, projectId = 'default') {
+    const lines = markdown.split('\n');
+    const board = {
+        id: projectId,
+        name: 'Board',
+        columns: [],
+        updatedAt: new Date(),
+    };
+    let currentColumn = null;
+    let currentTicket = null;
+    let inDescription = false;
+    let descriptionLines = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Board title: # Title (optional)
+        if (line.startsWith('# ')) {
+            board.name = line.slice(2).trim();
+            continue;
+        }
+        // Column header: ## Column Name (with optional emoji)
+        if (line.startsWith('## ')) {
+            // Save previous ticket's description
+            if (currentTicket && descriptionLines.length > 0) {
+                currentTicket.description = descriptionLines.join('\n').trim();
+                descriptionLines = [];
+            }
+            // Remove emoji prefix if present (e.g., "📥 Backlog" -> "Backlog")
+            let columnName = line.slice(3).trim();
+            const emojiMatch = columnName.match(/^[\p{Emoji}\s]+/u);
+            if (emojiMatch) {
+                columnName = columnName.slice(emojiMatch[0].length).trim();
+            }
+            currentColumn = {
+                id: slugify(columnName),
+                name: columnName,
+                position: board.columns.length,
+                tickets: [],
+            };
+            board.columns.push(currentColumn);
+            currentTicket = null;
+            inDescription = false;
+            continue;
+        }
+        // Ticket: - [ ] **ID** [[ID]] Title or - [ ] Title
+        // Note: ID pattern is case-insensitive to handle both TKT-054 and tkt-054
+        const ticketMatch = line.match(/^- \[[ x]\] (?:\*\*([a-zA-Z0-9-]+)\*\* \[\[\1\]\] )?(.+)$/i);
+        if (ticketMatch && currentColumn) {
+            // Save previous ticket's description
+            if (currentTicket && descriptionLines.length > 0) {
+                currentTicket.description = descriptionLines.join('\n').trim();
+                descriptionLines = [];
+            }
+            const id = ticketMatch[1] || slugify(ticketMatch[2]);
+            const title = ticketMatch[2];
+            currentTicket = {
+                id,
+                title: title.trim(),
+                statusId: '', // Will be resolved when syncing to DB
+                statusCategory: 'backlog', // Default status category when parsing from board
+                statusName: currentColumn.name,
+                position: currentColumn.tickets.length,
+                subtasks: [],
+                labels: [],
+                metadata: {},
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            };
+            currentColumn.tickets.push(currentTicket);
+            inDescription = false;
+            continue;
+        }
+        // Metadata: **Key:** Value (indented)
+        const metaMatch = line.match(/^\s+\*\*(.+?):\*\*\s*(.*)$/);
+        if (metaMatch && currentTicket) {
+            const [, key, value] = metaMatch;
+            const trimmedValue = value.trim();
+            switch (key) {
+                case 'Priority':
+                    currentTicket.priority = trimmedValue;
+                    break;
+                case 'Category':
+                    currentTicket.category = trimmedValue;
+                    break;
+                case 'Spec': {
+                    // Parse spec: [[spec-id]] (single spec per ticket)
+                    const specMatch = trimmedValue.match(/\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/);
+                    if (specMatch) {
+                        currentTicket.specId = specMatch[1];
+                    }
+                    break;
+                }
+                default:
+                    currentTicket.metadata[key] = trimmedValue;
+            }
+            continue;
+        }
+        // Separator: *** (marks start of description/subtasks)
+        if (line.trim() === '***' && currentTicket) {
+            inDescription = true;
+            continue;
+        }
+        // Subtask: - [ ] or - [x] (indented under ticket)
+        const subtaskMatch = line.match(/^\s+- \[([ x])\] (.+)$/);
+        if (subtaskMatch && currentTicket) {
+            currentTicket.subtasks.push({
+                id: slugify(subtaskMatch[2]),
+                title: subtaskMatch[2].trim(),
+                done: subtaskMatch[1] === 'x',
+            });
+            continue;
+        }
+        // Description text (after *** separator, indented)
+        if (inDescription && currentTicket) {
+            const trimmedLine = line.replace(/^\s{6}/, ''); // Remove 6-space indent
+            if (trimmedLine || descriptionLines.length > 0) {
+                descriptionLines.push(trimmedLine);
+            }
+        }
+    }
+    // Save last ticket's description
+    if (currentTicket && descriptionLines.length > 0) {
+        currentTicket.description = descriptionLines.join('\n').trim();
+    }
+    return board;
+}
+// =============================================================================
+// Generator
+// =============================================================================
+/**
+ * Generate Obsidian Kanban markdown from a Board object
+ */
+export function generateBoardMarkdown(board) {
+    const lines = [];
+    // Frontmatter for Obsidian Kanban plugin
+    lines.push('---');
+    lines.push('kanban-plugin: basic');
+    lines.push('---');
+    lines.push('');
+    // Board title
+    lines.push(`# ${board.name}`);
+    lines.push('');
+    for (const column of board.columns) {
+        // Column header
+        lines.push(`## ${column.name}`);
+        lines.push('');
+        for (const ticket of column.tickets) {
+            // Ticket header with bold ID, wikilink, and title
+            lines.push(`- [ ] **${ticket.id}** [[${ticket.id}]] ${ticket.title}`);
+            // Metadata
+            if (ticket.priority) {
+                lines.push(`      **Priority:** ${ticket.priority}`);
+            }
+            if (ticket.category) {
+                lines.push(`      **Category:** ${ticket.category}`);
+            }
+            if (ticket.specId) {
+                lines.push(`      **Spec:** [[${ticket.specId}]]`);
+            }
+            for (const [key, value] of Object.entries(ticket.metadata)) {
+                lines.push(`      **${key}:** ${value}`);
+            }
+            // Separator and description/subtasks
+            if (ticket.description || ticket.subtasks.length > 0) {
+                lines.push(`      ***`);
+            }
+            if (ticket.description) {
+                // Indent each line of description
+                const descLines = ticket.description.split('\n');
+                for (const descLine of descLines) {
+                    lines.push(`      ${descLine}`);
+                }
+            }
+            // Subtasks
+            for (const subtask of ticket.subtasks) {
+                const checkbox = subtask.done ? '[x]' : '[ ]';
+                lines.push(`      - ${checkbox} ${subtask.title}`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+// =============================================================================
+// Diff/Merge Utilities
+// =============================================================================
+/**
+ * Find tickets that exist in newBoard but not in oldBoard
+ */
+export function findAddedTickets(oldBoard, newBoard) {
+    const oldIds = new Set(oldBoard.columns.flatMap((c) => c.tickets.map((t) => t.id)));
+    return newBoard.columns.flatMap((c) => c.tickets.filter((t) => !oldIds.has(t.id)));
+}
+/**
+ * Find tickets that exist in oldBoard but not in newBoard
+ */
+export function findRemovedTickets(oldBoard, newBoard) {
+    const newIds = new Set(newBoard.columns.flatMap((c) => c.tickets.map((t) => t.id)));
+    return oldBoard.columns.flatMap((c) => c.tickets.filter((t) => !newIds.has(t.id)));
+}
+/**
+ * Find tickets that changed between boards
+ */
+export function findModifiedTickets(oldBoard, newBoard) {
+    const oldTickets = new Map();
+    oldBoard.columns.forEach((c) => c.tickets.forEach((t) => oldTickets.set(t.id, t)));
+    const modified = [];
+    for (const column of newBoard.columns) {
+        for (const ticket of column.tickets) {
+            const oldTicket = oldTickets.get(ticket.id);
+            if (oldTicket && !ticketsEqual(oldTicket, ticket)) {
+                modified.push({ old: oldTicket, new: ticket });
+            }
+        }
+    }
+    return modified;
+}
+/**
+ * Check if two tickets are equal (ignoring timestamps)
+ */
+function ticketsEqual(a, b) {
+    return (a.id === b.id &&
+        a.title === b.title &&
+        a.statusName === b.statusName &&
+        a.position === b.position &&
+        a.priority === b.priority &&
+        a.category === b.category &&
+        a.description === b.description &&
+        a.specId === b.specId &&
+        JSON.stringify(a.subtasks) === JSON.stringify(b.subtasks) &&
+        JSON.stringify(a.metadata) === JSON.stringify(b.metadata));
+}

package/dist/lib/pmo/pmo-context.d.ts

@@ -0,0 +1,27 @@
+import { SQLiteStorage } from './index.js';
+/**
+ * PMO context for commands.
+ * Note: Storage is project-agnostic. projectId is passed explicitly to operations.
+ */
+export interface PMOContext {
+    pmoPath: string;
+    storage: SQLiteStorage;
+    storageType: 'sqlite' | 'git';
+}
+export interface GetPMOContextOptions {
+    logger?: (msg: string) => void;
+}
+/**
+ * Get PMO context (path, storage) without requiring config.json
+ * Reads everything from workspace.db instead
+ *
+ * Note: Storage is project-agnostic. Commands pass projectId explicitly to operations.
+ * For project-scoped operations, commands should either:
+ * - Derive project from an entity (e.g., ticket.projectId)
+ * - Call requireProject() to prompt user for selection
+ *
+ * @param options - Configuration options
+ * @param options.logger - Optional logging function
+ * @returns PMO context with storage and metadata
+ */
+export declare function getPMOContext(options?: GetPMOContextOptions): Promise<PMOContext>;

package/dist/lib/pmo/pmo-context.js

@@ -0,0 +1,44 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { getStorageWithAutoSync } from './index.js';
+import { findPMO } from './find-pmo.js';
+import { warnIfMultipleHQs } from '../workspace.js';
+// Track if we've already warned about multiple HQs this session
+let hasWarnedAboutMultipleHQs = false;
+/**
+ * Get PMO context (path, storage) without requiring config.json
+ * Reads everything from workspace.db instead
+ *
+ * Note: Storage is project-agnostic. Commands pass projectId explicitly to operations.
+ * For project-scoped operations, commands should either:
+ * - Derive project from an entity (e.g., ticket.projectId)
+ * - Call requireProject() to prompt user for selection
+ *
+ * @param options - Configuration options
+ * @param options.logger - Optional logging function
+ * @returns PMO context with storage and metadata
+ */
+export async function getPMOContext(options) {
+    const logger = options?.logger;
+    // Find PMO
+    const pmoPath = findPMO();
+    if (!pmoPath) {
+        throw new Error('PMO not found. Run "prlt pmo init" first.');
+    }
+    // Warn once per session if multiple HQ workspaces detected
+    if (!hasWarnedAboutMultipleHQs) {
+        warnIfMultipleHQs();
+        hasWarnedAboutMultipleHQs = true;
+    }
+    // Detect sync mode: 'git' enables multi-machine sync via git push/pull of board.md
+    // Note: Storage is always SQLite (workspace.db). This flag controls sync strategy.
+    const gitPath = path.join(pmoPath, '.git');
+    const storageType = fs.existsSync(gitPath) ? 'git' : 'sqlite';
+    // Get storage - project-agnostic, projectId passed to operations explicitly
+    const storage = getStorageWithAutoSync(pmoPath, storageType, logger);
+    return {
+        pmoPath,
+        storage,
+        storageType,
+    };
+}

package/dist/lib/pmo/schema.d.ts

@@ -0,0 +1,82 @@
+/**
+ * PMO Schema - Single Source of Truth
+ *
+ * All PMO table definitions live here. Both database/index.ts and
+ * storage-sqlite.ts import from this file to ensure schema consistency.
+ */
+export declare const PMO_TABLES: {
+    readonly projects: "pmo_projects";
+    readonly initiatives: "pmo_initiatives";
+    readonly tickets: "pmo_tickets";
+    readonly board_views: "pmo_board_views";
+    readonly subtasks: "pmo_subtasks";
+    readonly ticket_metadata: "pmo_ticket_metadata";
+    readonly ticket_dependencies: "pmo_ticket_dependencies";
+    readonly ticket_affected_paths: "pmo_ticket_affected_paths";
+    readonly ticket_acceptance_criteria: "pmo_ticket_acceptance_criteria";
+    readonly specs: "pmo_specs";
+    readonly spec_dependencies: "pmo_spec_dependencies";
+    readonly ticket_specs: "pmo_ticket_specs";
+    readonly ticket_assignments: "pmo_ticket_assignments";
+    readonly epics: "pmo_epics";
+    readonly epic_dependencies: "pmo_epic_dependencies";
+    readonly project_specs: "pmo_project_specs";
+    readonly cache_metadata: "pmo_cache_metadata";
+    readonly settings: "pmo_settings";
+    readonly agent_work: "agent_work";
+    readonly containers: "containers";
+    readonly workflows: "pmo_workflows";
+    readonly workflow_statuses: "pmo_workflow_statuses";
+    readonly phases: "pmo_phases";
+    readonly phase_templates: "pmo_phase_templates";
+    readonly actions: "pmo_actions";
+    readonly ticket_templates: "pmo_ticket_templates";
+    readonly columns: "pmo_columns";
+    readonly board_tickets: "pmo_board_tickets";
+    readonly statuses: "pmo_statuses";
+};
+export declare const PMO_TABLE_SCHEMAS: {
+    readonly projects: "\n    CREATE TABLE IF NOT EXISTS pmo_projects (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL,\n      template TEXT,\n      description TEXT,\n      status TEXT NOT NULL DEFAULT 'active',\n      phase_id TEXT,\n      workflow_id TEXT,\n      is_archived INTEGER NOT NULL DEFAULT 0,\n      target_date TIMESTAMP,\n      initiative_id TEXT,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      FOREIGN KEY (phase_id) REFERENCES pmo_phases(id) ON DELETE SET NULL,\n      FOREIGN KEY (workflow_id) REFERENCES pmo_workflows(id) ON DELETE SET NULL\n    )";
+    readonly initiatives: "\n    CREATE TABLE IF NOT EXISTS pmo_initiatives (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL,\n      objective TEXT,\n      key_results TEXT,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly workflows: "\n    CREATE TABLE IF NOT EXISTS pmo_workflows (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL UNIQUE,\n      description TEXT,\n      is_builtin INTEGER NOT NULL DEFAULT 0,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly workflow_statuses: "\n    CREATE TABLE IF NOT EXISTS pmo_workflow_statuses (\n      id TEXT PRIMARY KEY,\n      workflow_id TEXT NOT NULL,\n      name TEXT NOT NULL,\n      category TEXT NOT NULL,\n      position INTEGER NOT NULL DEFAULT 0,\n      color TEXT,\n      description TEXT,\n      is_default INTEGER NOT NULL DEFAULT 0,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      FOREIGN KEY (workflow_id) REFERENCES pmo_workflows(id) ON DELETE CASCADE,\n      UNIQUE(workflow_id, name)\n    )";
+    readonly columns: "\n    CREATE TABLE IF NOT EXISTS pmo_columns (\n      id TEXT NOT NULL,\n      project_id TEXT NOT NULL DEFAULT 'default',\n      name TEXT NOT NULL,\n      position INTEGER NOT NULL,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      PRIMARY KEY (project_id, id)\n    )";
+    readonly tickets: "\n    CREATE TABLE IF NOT EXISTS pmo_tickets (\n      id TEXT PRIMARY KEY,\n      project_id TEXT NOT NULL DEFAULT 'default',\n      title TEXT NOT NULL,\n      description TEXT,\n      priority TEXT,\n      category TEXT,\n      status TEXT NOT NULL DEFAULT 'backlog',\n      status_id TEXT,\n      owner TEXT,\n      assignee TEXT,\n      branch TEXT,\n      spec_id TEXT,\n      epic_id TEXT,\n      labels TEXT NOT NULL DEFAULT '[]',\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      last_synced_from_spec TIMESTAMP,\n      last_synced_from_board TIMESTAMP,\n      FOREIGN KEY (project_id) REFERENCES pmo_projects(id) ON DELETE CASCADE,\n      FOREIGN KEY (spec_id) REFERENCES pmo_specs(id) ON DELETE SET NULL,\n      FOREIGN KEY (epic_id) REFERENCES pmo_epics(id) ON DELETE SET NULL,\n      FOREIGN KEY (status_id) REFERENCES pmo_workflow_statuses(id) ON DELETE SET NULL\n    )";
+    readonly board_tickets: "\n    CREATE TABLE IF NOT EXISTS pmo_board_tickets (\n      project_id TEXT NOT NULL,\n      ticket_id TEXT NOT NULL,\n      column_id TEXT NOT NULL,\n      position INTEGER NOT NULL,\n      PRIMARY KEY (project_id, ticket_id),\n      FOREIGN KEY (project_id) REFERENCES pmo_projects(id) ON DELETE CASCADE,\n      FOREIGN KEY (ticket_id) REFERENCES pmo_tickets(id) ON DELETE CASCADE,\n      FOREIGN KEY (project_id, column_id) REFERENCES pmo_columns(project_id, id) ON DELETE CASCADE\n    )";
+    readonly board_views: "\n    CREATE TABLE IF NOT EXISTS pmo_board_views (\n      id TEXT PRIMARY KEY,\n      project_id TEXT NOT NULL,\n      name TEXT NOT NULL,\n      description TEXT,\n      is_default INTEGER NOT NULL DEFAULT 0,\n      filters TEXT NOT NULL DEFAULT '{}',\n      group_by TEXT,\n      sort_by TEXT,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      FOREIGN KEY (project_id) REFERENCES pmo_projects(id) ON DELETE CASCADE,\n      UNIQUE(project_id, name)\n    )";
+    readonly subtasks: "\n    CREATE TABLE IF NOT EXISTS pmo_subtasks (\n      id TEXT NOT NULL,\n      ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE CASCADE,\n      title TEXT NOT NULL,\n      done INTEGER DEFAULT 0,\n      position INTEGER NOT NULL,\n      PRIMARY KEY (ticket_id, id)\n    )";
+    readonly ticket_metadata: "\n    CREATE TABLE IF NOT EXISTS pmo_ticket_metadata (\n      ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE CASCADE,\n      key TEXT NOT NULL,\n      value TEXT,\n      PRIMARY KEY (ticket_id, key)\n    )";
+    readonly ticket_dependencies: "\n    CREATE TABLE IF NOT EXISTS pmo_ticket_dependencies (\n      ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE RESTRICT,\n      depends_on_ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE RESTRICT,\n      dependency_type TEXT NOT NULL DEFAULT 'blocks' CHECK (dependency_type IN ('blocks', 'relates_to', 'duplicates')),\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      PRIMARY KEY (ticket_id, depends_on_ticket_id, dependency_type),\n      CHECK (ticket_id != depends_on_ticket_id)\n    )";
+    readonly ticket_affected_paths: "\n    CREATE TABLE IF NOT EXISTS pmo_ticket_affected_paths (\n      id INTEGER PRIMARY KEY AUTOINCREMENT,\n      ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE CASCADE,\n      path_pattern TEXT NOT NULL,\n      path_type TEXT NOT NULL DEFAULT 'file',\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly ticket_acceptance_criteria: "\n    CREATE TABLE IF NOT EXISTS pmo_ticket_acceptance_criteria (\n      id TEXT NOT NULL,\n      ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE CASCADE,\n      criterion TEXT NOT NULL,\n      verifiable INTEGER DEFAULT 1,\n      verified INTEGER DEFAULT 0,\n      verified_at TIMESTAMP,\n      verified_by TEXT,\n      position INTEGER NOT NULL DEFAULT 0,\n      PRIMARY KEY (ticket_id, id)\n    )";
+    readonly specs: "\n    CREATE TABLE IF NOT EXISTS pmo_specs (\n      id TEXT PRIMARY KEY,\n      title TEXT NOT NULL,\n      status TEXT DEFAULT 'draft',\n      type TEXT,\n      tags TEXT,\n      depends_on TEXT,\n      problem TEXT,\n      solution TEXT,\n      decisions TEXT,\n      not_now TEXT,\n      ui_ux TEXT,\n      acceptance_criteria TEXT,\n      open_questions TEXT,\n      requirements_functional TEXT,\n      requirements_technical TEXT,\n      context TEXT,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly spec_dependencies: "\n    CREATE TABLE IF NOT EXISTS pmo_spec_dependencies (\n      spec_id TEXT NOT NULL REFERENCES pmo_specs(id) ON DELETE RESTRICT,\n      depends_on_spec_id TEXT NOT NULL REFERENCES pmo_specs(id) ON DELETE RESTRICT,\n      dependency_type TEXT NOT NULL DEFAULT 'depends_on' CHECK (dependency_type IN ('depends_on', 'relates_to', 'duplicates')),\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      PRIMARY KEY (spec_id, depends_on_spec_id, dependency_type),\n      CHECK (spec_id != depends_on_spec_id)\n    )";
+    readonly ticket_specs: "\n    CREATE TABLE IF NOT EXISTS pmo_ticket_specs (\n      ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE CASCADE,\n      spec_id TEXT NOT NULL REFERENCES pmo_specs(id) ON DELETE CASCADE,\n      PRIMARY KEY (ticket_id, spec_id)\n    )";
+    readonly ticket_assignments: "\n    CREATE TABLE IF NOT EXISTS pmo_ticket_assignments (\n      ticket_id TEXT NOT NULL REFERENCES pmo_tickets(id) ON DELETE CASCADE,\n      agent_name TEXT NOT NULL,\n      assigned_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      PRIMARY KEY (ticket_id, agent_name)\n    )";
+    readonly epics: "\n    CREATE TABLE IF NOT EXISTS pmo_epics (\n      id TEXT PRIMARY KEY,\n      project_id TEXT NOT NULL,\n      title TEXT NOT NULL,\n      description TEXT,\n      status TEXT NOT NULL DEFAULT 'active',\n      position INTEGER NOT NULL DEFAULT 0,\n      file_path TEXT,\n      spec_id TEXT,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      FOREIGN KEY (project_id) REFERENCES pmo_projects(id) ON DELETE CASCADE,\n      FOREIGN KEY (spec_id) REFERENCES pmo_specs(id) ON DELETE SET NULL\n    )";
+    readonly epic_dependencies: "\n    CREATE TABLE IF NOT EXISTS pmo_epic_dependencies (\n      epic_id TEXT NOT NULL REFERENCES pmo_epics(id) ON DELETE RESTRICT,\n      depends_on_epic_id TEXT NOT NULL REFERENCES pmo_epics(id) ON DELETE RESTRICT,\n      dependency_type TEXT NOT NULL DEFAULT 'blocks' CHECK (dependency_type IN ('blocks', 'relates_to', 'duplicates')),\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      PRIMARY KEY (epic_id, depends_on_epic_id, dependency_type),\n      CHECK (epic_id != depends_on_epic_id)\n    )";
+    readonly project_specs: "\n    CREATE TABLE IF NOT EXISTS pmo_project_specs (\n      project_id TEXT NOT NULL REFERENCES pmo_projects(id) ON DELETE CASCADE,\n      spec_id TEXT NOT NULL REFERENCES pmo_specs(id) ON DELETE CASCADE,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      PRIMARY KEY (project_id, spec_id)\n    )";
+    readonly cache_metadata: "\n    CREATE TABLE IF NOT EXISTS pmo_cache_metadata (\n      key TEXT PRIMARY KEY,\n      value TEXT NOT NULL\n    )";
+    readonly settings: "\n    CREATE TABLE IF NOT EXISTS pmo_settings (\n      key TEXT PRIMARY KEY,\n      value TEXT NOT NULL\n    )";
+    readonly agent_work: "\n    CREATE TABLE IF NOT EXISTS agent_work (\n      id TEXT PRIMARY KEY,\n      ticket_id TEXT NOT NULL,\n      agent_name TEXT NOT NULL,\n      executor TEXT NOT NULL,\n      environment TEXT NOT NULL DEFAULT 'host',\n      display_mode TEXT NOT NULL DEFAULT 'terminal',\n      sandboxed INTEGER NOT NULL DEFAULT 0,\n      status TEXT NOT NULL DEFAULT 'starting',\n      branch TEXT,\n      pid TEXT,\n      container_id TEXT,\n      session_id TEXT,\n      host TEXT,\n      log_path TEXT,\n      started_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      completed_at TIMESTAMP,\n      exit_code INTEGER,\n      FOREIGN KEY (ticket_id) REFERENCES pmo_tickets(id) ON DELETE CASCADE\n    )";
+    readonly containers: "\n    CREATE TABLE IF NOT EXISTS containers (\n      id TEXT PRIMARY KEY,\n      agent_name TEXT NOT NULL,\n      docker_id TEXT NOT NULL,\n      docker_name TEXT,\n      image TEXT,\n      status TEXT NOT NULL DEFAULT 'unknown',\n      current_execution_id TEXT,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      last_seen_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      FOREIGN KEY (agent_name) REFERENCES agents(name) ON DELETE CASCADE,\n      FOREIGN KEY (current_execution_id) REFERENCES agent_work(id) ON DELETE SET NULL\n    )";
+    readonly statuses: "\n    CREATE TABLE IF NOT EXISTS pmo_statuses (\n      id TEXT PRIMARY KEY,\n      project_id TEXT NOT NULL,\n      name TEXT NOT NULL,\n      category TEXT NOT NULL,\n      position INTEGER NOT NULL DEFAULT 0,\n      color TEXT,\n      description TEXT,\n      is_default INTEGER NOT NULL DEFAULT 0,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      FOREIGN KEY (project_id) REFERENCES pmo_projects(id) ON DELETE CASCADE,\n      UNIQUE(project_id, name)\n    )";
+    readonly phases: "\n    CREATE TABLE IF NOT EXISTS pmo_phases (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL UNIQUE,\n      category TEXT NOT NULL,\n      position INTEGER NOT NULL DEFAULT 0,\n      color TEXT,\n      description TEXT,\n      is_default INTEGER NOT NULL DEFAULT 0,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly phase_templates: "\n    CREATE TABLE IF NOT EXISTS pmo_phase_templates (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL UNIQUE,\n      description TEXT,\n      is_builtin INTEGER NOT NULL DEFAULT 0,\n      phases TEXT NOT NULL,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly actions: "\n    CREATE TABLE IF NOT EXISTS pmo_actions (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL UNIQUE,\n      description TEXT,\n      prompt TEXT NOT NULL,\n      end_prompt TEXT,\n      suggested_for_categories TEXT,\n      default_move_to_category TEXT,\n      modifies_code INTEGER NOT NULL DEFAULT 1,\n      is_builtin INTEGER NOT NULL DEFAULT 0,\n      position INTEGER NOT NULL DEFAULT 0,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly ticket_templates: "\n    CREATE TABLE IF NOT EXISTS pmo_ticket_templates (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL UNIQUE,\n      description TEXT,\n      is_builtin INTEGER NOT NULL DEFAULT 0,\n      title_pattern TEXT,\n      description_template TEXT,\n      default_priority TEXT,\n      default_category TEXT,\n      default_status_id TEXT,\n      default_assignee TEXT,\n      default_owner TEXT,\n      default_labels TEXT NOT NULL DEFAULT '[]',\n      suggested_subtasks TEXT NOT NULL DEFAULT '[]',\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+};
+export declare const PMO_INDEXES: string;
+/**
+ * All PMO table creation statements combined.
+ * Order matters due to foreign key dependencies.
+ */
+export declare const PMO_SCHEMA_SQL: string;
+export declare const EXPECTED_TICKET_COLUMNS: readonly ["id", "project_id", "title", "description", "priority", "category", "status", "status_id", "owner", "assignee", "branch", "spec_id", "epic_id", "labels", "created_at", "updated_at", "last_synced_from_spec", "last_synced_from_board"];
+/**
+ * Validate that pmo_tickets table has all expected columns.
+ * Throws if columns are missing (indicates schema mismatch).
+ */
+export declare function validateTicketSchema(db: {
+    pragma: (sql: string) => unknown;
+}): void;