@proletariat/cli 0.3.9 → 0.3.11

package/dist/lib/execution/spawner.d.ts

@@ -8,7 +8,7 @@ import Database from 'better-sqlite3';
 import { SQLiteStorage } from '../pmo/storage-sqlite.js';
 import { WorkspaceInfo } from '../agents/commands.js';
 import { ExecutionStorage } from './storage.js';
-import { isDockerRunning } from './runners.js';
+import { isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled } from './runners.js';
 import { DisplayMode, SessionManager, ExecutorType, ExecutionEnvironment, ExecutionConfig } from './types.js';
 import { Ticket } from '../pmo/types.js';
 export type AgentStrategy = 'round-robin' | 'least-busy' | 'random';
@@ -84,4 +84,4 @@ export declare function spawnForColumn(projectId: string, columnName: string, st
     ticketIds?: string[];
     log?: (msg: string) => void;
 } & SpawnOptions): Promise<BatchSpawnResult>;
-export { isDockerRunning };
+export { isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled };

package/dist/lib/execution/spawner.js

@@ -12,7 +12,7 @@ import { getWorkColumnSetting, findColumnByName } from '../pmo/utils.js';
 import { findHQRoot } from '../repos/index.js';
 import { hasDevcontainerConfig } from './devcontainer.js';
 import { loadExecutionConfig, getOrPromptCoderName } from './config.js';
-import { runExecution, isDockerRunning } from './runners.js';
+import { runExecution, isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled } from './runners.js';
 import { generateBranchName, DEFAULT_EXECUTION_CONFIG, } from './types.js';
 // =============================================================================
 // Git Utilities
@@ -514,6 +514,7 @@ export async function spawnForColumn(projectId, columnName, storage, executionSt
             continue;
         }
         log(`Spawning ${agentName} for ${ticket.id}: ${ticket.title}`);
+        // eslint-disable-next-line no-await-in-loop -- Sequential spawning with user feedback
         const spawnResult = await spawnAgentForTicket(ticket, agentName, storage, executionStorage, workspaceInfo, db, pmoPath, options);
         if (spawnResult.success) {
             result.spawned.push(spawnResult);
@@ -550,6 +551,6 @@ export async function spawnForColumn(projectId, columnName, storage, executionSt
     return result;
 }
 // =============================================================================
-// Docker Check
+// Docker & GitHub Token Checks
 // =============================================================================
-export { isDockerRunning };
+export { isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled };

package/dist/lib/execution/storage.d.ts

@@ -9,7 +9,8 @@ export declare class ExecutionStorage {
     private db;
     constructor(db: Database.Database);
     /**
-     * Create a new execution record
+     * Create a new execution record.
+     * Uses UUID-based IDs to guarantee uniqueness without race conditions.
      */
     createExecution(params: {
         ticketId: string;

package/dist/lib/execution/storage.js

@@ -4,6 +4,7 @@
  * Database operations for agent_work table.
  */
 import { execSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
 import { PMO_TABLES } from '../pmo/schema.js';
 const T = PMO_TABLES;
 // =============================================================================
@@ -31,16 +32,6 @@ function rowToAgentWork(row) {
     };
 }
 // =============================================================================
-// ID Generation
-// =============================================================================
-function generateWorkId(db) {
-    const result = db
-        .prepare(`SELECT COUNT(*) as count FROM ${T.agent_work}`)
-        .get();
-    const num = (result?.count || 0) + 1;
-    return `WORK-${String(num).padStart(3, '0')}`;
-}
-// =============================================================================
 // Execution Storage Class
 // =============================================================================
 export class ExecutionStorage {
@@ -49,11 +40,14 @@ export class ExecutionStorage {
         this.db = db;
     }
     /**
-     * Create a new execution record
+     * Create a new execution record.
+     * Uses UUID-based IDs to guarantee uniqueness without race conditions.
      */
     createExecution(params) {
-        const id = generateWorkId(this.db);
         const now = Date.now();
+        // Generate a unique ID using UUID (first 8 chars, uppercase)
+        // Format: WORK-A1B2C3D4 - guaranteed unique, no race conditions
+        const id = `WORK-${randomUUID().substring(0, 8).toUpperCase()}`;
         this.db.prepare(`
       INSERT INTO ${T.agent_work} (
         id, ticket_id, agent_name, executor, environment, display_mode, sandboxed,
@@ -468,7 +462,9 @@ export class ContainerStorage {
      */
     syncFromDocker(dockerContainers) {
         const now = Date.now();
-        let added = 0, updated = 0, removed = 0;
+        let added = 0;
+        let updated = 0;
+        let removed = 0;
         // Create a set of docker IDs currently running
         const activeDockerIds = new Set(dockerContainers.map(c => c.id.substring(0, 12)));
         // Wrap all operations in a transaction for atomicity

package/dist/lib/execution/types.d.ts

@@ -19,14 +19,21 @@ export type SessionManager = 'tmux' | 'direct';
  * DisplayMode - How output is presented to the user.
  * - terminal: Opens a new terminal tab attached to the tmux session
  * - background: Runs detached, reattach later with `prlt session attach`
+ * - foreground: Attaches tmux in current terminal (blocking)
  */
-export type DisplayMode = 'terminal' | 'background';
+export type DisplayMode = 'terminal' | 'background' | 'foreground';
 /**
  * OutputMode - How Claude Code displays its output.
  * - interactive: Shows streaming UI with real-time tool calls, file reads, etc.
  * - print: Outputs final result only (uses -p flag), better for logs/automation
  */
 export type OutputMode = 'interactive' | 'print';
+/**
+ * PermissionMode - How Claude Code handles permission checks.
+ * - danger: Skip permission checks (faster, relies on container/environment isolation)
+ * - safe: Requires approval for dangerous operations
+ */
+export type PermissionMode = 'danger' | 'safe';
 export type ExecutorType = 'claude-code' | 'codex' | 'aider' | 'custom';
 export type TerminalApp = 'Terminal' | 'iTerm' | 'Alacritty' | 'Ghostty' | 'Kitty' | 'tmux' | 'Warp' | 'WezTerm';
 export type Shell = 'bash' | 'zsh' | 'fish';
@@ -113,9 +120,11 @@ export interface ExecutionConfig {
         session: string;
         layout: 'split' | 'window';
         controlMode: boolean;
+        windowMode: 'tab' | 'window';
     };
     terminal: {
         app: TerminalApp;
+        openInBackground: boolean;
     };
     devcontainer: {
         defaultImage: string;

package/dist/lib/execution/types.js

@@ -135,10 +135,12 @@ export const DEFAULT_EXECUTION_CONFIG = {
     tmux: {
         session: 'proletariat',
         layout: 'window',
-        controlMode: true, // Enable -CC for iTerm native integration by default
+        controlMode: true, // Use -u -CC for native iTerm scrolling/selection
+        windowMode: 'tab', // Open tmux windows as tabs in current window by default
     },
     terminal: {
         app: 'Terminal',
+        openInBackground: true, // Don't steal focus when opening new tabs
     },
     devcontainer: {
         defaultImage: 'mcr.microsoft.com/devcontainers/base:ubuntu',

package/dist/lib/init/index.js

@@ -121,6 +121,7 @@ export async function promptForHQLocation(hqName) {
         defaultPath = `./${folderName}`;
     }
     while (true) {
+        // eslint-disable-next-line no-await-in-loop -- Interactive validation loop
         const { location } = await inquirer.prompt([{
                 type: 'input',
                 name: 'location',

package/dist/lib/machine-config.js

@@ -151,7 +151,7 @@ export function registerHeadquarters(hqPath, name, setActive = true, orgName) {
         registeredAt: new Date().toISOString(),
         orgName,
     };
-    if (existingIndex >= 0) {
+    if (existingIndex !== -1) {
         // Update existing entry
         config.headquarters[existingIndex] = entry;
     }

package/dist/lib/pmo/base-command.js

@@ -78,15 +78,10 @@ export class PMOCommand extends Command {
         // Parse flags to get project ID if provided
         const { flags } = await this.parse(this.constructor);
         this.projectFlag = flags.project;
-        try {
-            this.pmoContext = await getPMOContext({
-                logger: (msg) => this.pmoLogger(msg),
-            });
-            this.contextInitialized = true;
-        }
-        catch (error) {
-            throw error;
-        }
+        this.pmoContext = await getPMOContext({
+            logger: (msg) => this.pmoLogger(msg),
+        });
+        this.contextInitialized = true;
     }
     /**
      * Require a project to be selected.
@@ -116,6 +111,7 @@ export class PMOCommand extends Command {
         if (options?.filterEmptyProjects) {
             const projectsWithTickets = [];
             for (const p of projects) {
+                // eslint-disable-next-line no-await-in-loop -- Sequential filtering for project selection
                 const tickets = await this.storage.listTickets(p.id);
                 if (tickets.length > 0) {
                     projectsWithTickets.push(p);

package/dist/lib/pmo/index.js

@@ -284,6 +284,7 @@ export async function createPMO(options) {
                 category = 'canceled';
             }
             // Default: backlog (for first columns, custom backlogs, etc.)
+            // eslint-disable-next-line no-await-in-loop -- Sequential status creation in order
             await storage.createStatus(projectId, {
                 name,
                 category,
@@ -410,6 +411,7 @@ export function hasPMO(hqPath) {
         return false;
     }
     try {
+        // eslint-disable-next-line unicorn/prefer-module
         const Database = require('better-sqlite3');
         const db = new Database(dbPath);
         const result = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='pmo_projects'").get();

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

@@ -25,12 +25,15 @@ export declare const PMO_TABLES: {
     readonly settings: "pmo_settings";
     readonly agent_work: "agent_work";
     readonly containers: "containers";
+    readonly id_sequences: "id_sequences";
     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 roadmaps: "pmo_roadmaps";
+    readonly roadmap_projects: "pmo_roadmap_projects";
     readonly columns: "pmo_columns";
     readonly board_tickets: "pmo_board_tickets";
     readonly statuses: "pmo_statuses";
@@ -60,11 +63,14 @@ export declare const PMO_TABLE_SCHEMAS: {
     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 id_sequences: "\n    CREATE TABLE IF NOT EXISTS id_sequences (\n      table_name TEXT PRIMARY KEY,\n      next_id INTEGER NOT NULL DEFAULT 1\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    )";
+    readonly roadmaps: "\n    CREATE TABLE IF NOT EXISTS pmo_roadmaps (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL UNIQUE,\n      description TEXT,\n      is_default INTEGER NOT NULL DEFAULT 0,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n    )";
+    readonly roadmap_projects: "\n    CREATE TABLE IF NOT EXISTS pmo_roadmap_projects (\n      roadmap_id TEXT NOT NULL REFERENCES pmo_roadmaps(id) ON DELETE CASCADE,\n      project_id TEXT NOT NULL REFERENCES pmo_projects(id) ON DELETE CASCADE,\n      position INTEGER NOT NULL DEFAULT 0,\n      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n      PRIMARY KEY (roadmap_id, project_id)\n    )";
 };
 export declare const PMO_INDEXES: string;
 /**

package/dist/lib/pmo/schema.js

@@ -28,6 +28,7 @@ export const PMO_TABLES = {
     settings: 'pmo_settings',
     agent_work: 'agent_work',
     containers: 'containers', // Docker containers per agent
+    id_sequences: 'id_sequences', // Sequence counters for ID generation
     // Workflow tables (consolidated - workflows are the single source of truth for board columns)
     workflows: 'pmo_workflows', // Shared workflow definitions
     workflow_statuses: 'pmo_workflow_statuses', // Statuses belonging to workflows (= board columns)
@@ -36,6 +37,9 @@ export const PMO_TABLES = {
     phase_templates: 'pmo_phase_templates', // Phase configuration templates
     actions: 'pmo_actions', // Work actions (reusable agent prompts)
     ticket_templates: 'pmo_ticket_templates', // Ticket templates for quick creation
+    // Roadmap tables (ordered collections of projects for documentation)
+    roadmaps: 'pmo_roadmaps', // Named roadmap definitions
+    roadmap_projects: 'pmo_roadmap_projects', // Many-to-many: roadmaps ↔ projects with ordering
     // Legacy tables (deprecated, kept for migration)
     columns: 'pmo_columns', // DEPRECATED: use workflow_statuses
     board_tickets: 'pmo_board_tickets', // DEPRECATED: tickets now use status_id directly
@@ -331,6 +335,12 @@ export const PMO_TABLE_SCHEMAS = {
       FOREIGN KEY (agent_name) REFERENCES agents(name) ON DELETE CASCADE,
       FOREIGN KEY (current_execution_id) REFERENCES ${PMO_TABLES.agent_work}(id) ON DELETE SET NULL
     )`,
+    // Sequence counters for ID generation (avoids collisions after deletions)
+    id_sequences: `
+    CREATE TABLE IF NOT EXISTS ${PMO_TABLES.id_sequences} (
+      table_name TEXT PRIMARY KEY,
+      next_id INTEGER NOT NULL DEFAULT 1
+    )`,
     // DEPRECATED: Legacy per-project statuses - use workflow_statuses instead
     // Kept for migration from old schema
     statuses: `
@@ -402,6 +412,25 @@ export const PMO_TABLE_SCHEMAS = {
       suggested_subtasks TEXT NOT NULL DEFAULT '[]',
       created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
     )`,
+    // Roadmap definitions (named collections of projects for documentation)
+    roadmaps: `
+    CREATE TABLE IF NOT EXISTS ${PMO_TABLES.roadmaps} (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL UNIQUE,
+      description TEXT,
+      is_default INTEGER NOT NULL DEFAULT 0,
+      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+    )`,
+    // Roadmap-to-project associations with ordering
+    roadmap_projects: `
+    CREATE TABLE IF NOT EXISTS ${PMO_TABLES.roadmap_projects} (
+      roadmap_id TEXT NOT NULL REFERENCES ${PMO_TABLES.roadmaps}(id) ON DELETE CASCADE,
+      project_id TEXT NOT NULL REFERENCES ${PMO_TABLES.projects}(id) ON DELETE CASCADE,
+      position INTEGER NOT NULL DEFAULT 0,
+      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+      PRIMARY KEY (roadmap_id, project_id)
+    )`,
 };
 // =============================================================================
 // Indexes
@@ -451,6 +480,10 @@ export const PMO_INDEXES = `
   CREATE INDEX IF NOT EXISTS idx_pmo_workflow_statuses_category ON ${PMO_TABLES.workflow_statuses}(workflow_id, category);
   CREATE INDEX IF NOT EXISTS idx_pmo_workflow_statuses_position ON ${PMO_TABLES.workflow_statuses}(workflow_id, position);
   CREATE INDEX IF NOT EXISTS idx_pmo_workflows_builtin ON ${PMO_TABLES.workflows}(is_builtin);
+  CREATE INDEX IF NOT EXISTS idx_pmo_roadmaps_default ON ${PMO_TABLES.roadmaps}(is_default);
+  CREATE INDEX IF NOT EXISTS idx_pmo_roadmap_projects_roadmap ON ${PMO_TABLES.roadmap_projects}(roadmap_id);
+  CREATE INDEX IF NOT EXISTS idx_pmo_roadmap_projects_project ON ${PMO_TABLES.roadmap_projects}(project_id);
+  CREATE INDEX IF NOT EXISTS idx_pmo_roadmap_projects_position ON ${PMO_TABLES.roadmap_projects}(roadmap_id, position);
 `;
 // =============================================================================
 // Combined Schema
@@ -485,8 +518,11 @@ export const PMO_SCHEMA_SQL = [
     PMO_TABLE_SCHEMAS.settings,
     PMO_TABLE_SCHEMAS.agent_work, // Execution tracking
     PMO_TABLE_SCHEMAS.containers, // Docker containers per agent
+    PMO_TABLE_SCHEMAS.id_sequences, // Sequence counters for ID generation
     PMO_TABLE_SCHEMAS.actions, // Work actions (reusable agent prompts)
     PMO_TABLE_SCHEMAS.ticket_templates, // Ticket templates for quick creation
+    PMO_TABLE_SCHEMAS.roadmaps, // Named roadmap definitions
+    PMO_TABLE_SCHEMAS.roadmap_projects, // Roadmap-to-project associations
     // Legacy tables (kept for migration, will be dropped after data migrated)
     PMO_TABLE_SCHEMAS.columns, // DEPRECATED
     PMO_TABLE_SCHEMAS.board_tickets, // DEPRECATED

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

@@ -120,8 +120,8 @@ export function runMigrations(db) {
     // Migration: Add position column to actions table
     if (tableExists(T.actions)) {
         const actionsColumns = db.pragma(`table_info(${T.actions})`);
-        const actionsColumnNames = actionsColumns.map(c => c.name);
-        if (!actionsColumnNames.includes('position')) {
+        const actionsColumnNames = new Set(actionsColumns.map(c => c.name));
+        if (!actionsColumnNames.has('position')) {
             try {
                 db.exec(`ALTER TABLE ${T.actions} ADD COLUMN position INTEGER NOT NULL DEFAULT 0`);
                 const positionMap = {
@@ -135,7 +135,7 @@ export function runMigrations(db) {
                 // Column may already exist
             }
         }
-        if (!actionsColumnNames.includes('end_prompt')) {
+        if (!actionsColumnNames.has('end_prompt')) {
             try {
                 db.exec(`ALTER TABLE ${T.actions} ADD COLUMN end_prompt TEXT`);
             }

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

@@ -5,7 +5,7 @@
  * Uses the unified workspace.db database with pmo_ prefixed tables.
  */
 import Database from 'better-sqlite3';
-import { AcceptanceCriterion, Board, BoardConfig, BoardView, BoardViewFilter, BoardViewFilters, Column, CreateTicketInput, Epic, EpicDependency, EpicDependencyType, EpicFilter, PhaseFilter, PhaseTemplate, PhaseTemplateFilter, PMOStorage, Project, ProjectFilter, ProjectPhase, Spec, SpecDependency, SpecDependencyType, SpecFilter, StateCategory, Subtask, SyncResult, SyncStatus, Ticket, TicketDependency, TicketDependencyType, TicketFilter, TicketTemplate, TicketTemplateFilter, WorkAction, WorkActionFilter, Workflow, WorkflowFilter, WorkflowStatus } from '../types.js';
+import { AcceptanceCriterion, Board, BoardConfig, BoardView, BoardViewFilter, BoardViewFilters, Column, CreateTicketInput, Epic, EpicDependency, EpicDependencyType, EpicFilter, PhaseFilter, PhaseTemplate, PhaseTemplateFilter, PMOStorage, Project, ProjectFilter, ProjectPhase, Roadmap, RoadmapFilter, RoadmapProject, Spec, SpecDependency, SpecDependencyType, SpecFilter, StateCategory, Subtask, SyncResult, SyncStatus, Ticket, TicketDependency, TicketDependencyType, TicketFilter, TicketTemplate, TicketTemplateFilter, WorkAction, WorkActionFilter, Workflow, WorkflowFilter, WorkflowStatus } from '../types.js';
 export declare class SQLiteStorage implements PMOStorage {
     readonly type: "sqlite";
     private db;
@@ -22,6 +22,7 @@ export declare class SQLiteStorage implements PMOStorage {
     private phaseStorage;
     private actionStorage;
     private viewStorage;
+    private roadmapStorage;
     constructor(dbPath: string);
     /**
      * Get the underlying database connection.
@@ -162,6 +163,20 @@ export declare class SQLiteStorage implements PMOStorage {
     deleteBoardView(id: string): Promise<void>;
     getDefaultBoardView(projectId: string): Promise<BoardView | null>;
     getBoardWithView(projectId: string, viewId?: string, filters?: BoardViewFilters): Promise<Board>;
+    listRoadmaps(filter?: RoadmapFilter): Promise<Roadmap[]>;
+    getRoadmap(id: string): Promise<Roadmap | null>;
+    createRoadmap(roadmap: Partial<Roadmap> & {
+        name: string;
+    }): Promise<Roadmap>;
+    updateRoadmap(id: string, changes: Partial<Roadmap>): Promise<Roadmap>;
+    deleteRoadmap(id: string): Promise<void>;
+    getDefaultRoadmap(): Promise<Roadmap | null>;
+    setDefaultRoadmap(id: string): Promise<Roadmap>;
+    listRoadmapProjects(roadmapId: string): Promise<Project[]>;
+    addProjectToRoadmap(roadmapId: string, projectId: string, position?: number): Promise<RoadmapProject>;
+    removeProjectFromRoadmap(roadmapId: string, projectId: string): Promise<void>;
+    reorderRoadmapProject(roadmapId: string, projectId: string, newPosition: number): Promise<RoadmapProject>;
+    getRoadmapsForProject(projectId: string): Promise<Roadmap[]>;
     pull(): Promise<SyncResult>;
     push(): Promise<SyncResult>;
     status(): Promise<SyncStatus>;

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

@@ -18,6 +18,7 @@ import { TemplateStorage } from './templates.js';
 import { PhaseStorage } from './phases.js';
 import { ActionStorage } from './actions.js';
 import { ViewStorage } from './views.js';
+import { RoadmapStorage } from './roadmaps.js';
 const T = PMO_TABLES;
 export class SQLiteStorage {
     type = 'sqlite';
@@ -36,6 +37,7 @@ export class SQLiteStorage {
     phaseStorage;
     actionStorage;
     viewStorage;
+    roadmapStorage;
     constructor(dbPath) {
         this.dbPath = dbPath;
         // Open database (creates if doesn't exist)
@@ -60,6 +62,7 @@ export class SQLiteStorage {
         this.phaseStorage = new PhaseStorage(ctx);
         this.actionStorage = new ActionStorage(ctx);
         this.viewStorage = new ViewStorage(ctx);
+        this.roadmapStorage = new RoadmapStorage(ctx);
         // Ensure PMO tables exist
         this.ensurePMOTables();
     }
@@ -520,6 +523,48 @@ export class SQLiteStorage {
         return this.viewStorage.getBoardWithView(projectId, viewId, filters);
     }
     // ===========================================================================
+    // Roadmap Operations
+    // ===========================================================================
+    async listRoadmaps(filter) {
+        return this.roadmapStorage.listRoadmaps(filter);
+    }
+    async getRoadmap(id) {
+        return this.roadmapStorage.getRoadmap(id);
+    }
+    async createRoadmap(roadmap) {
+        return this.roadmapStorage.createRoadmap(roadmap);
+    }
+    async updateRoadmap(id, changes) {
+        return this.roadmapStorage.updateRoadmap(id, changes);
+    }
+    async deleteRoadmap(id) {
+        return this.roadmapStorage.deleteRoadmap(id);
+    }
+    async getDefaultRoadmap() {
+        return this.roadmapStorage.getDefaultRoadmap();
+    }
+    async setDefaultRoadmap(id) {
+        return this.roadmapStorage.setDefaultRoadmap(id);
+    }
+    // ===========================================================================
+    // Roadmap Project Operations
+    // ===========================================================================
+    async listRoadmapProjects(roadmapId) {
+        return this.roadmapStorage.listRoadmapProjects(roadmapId);
+    }
+    async addProjectToRoadmap(roadmapId, projectId, position) {
+        return this.roadmapStorage.addProjectToRoadmap(roadmapId, projectId, position);
+    }
+    async removeProjectFromRoadmap(roadmapId, projectId) {
+        return this.roadmapStorage.removeProjectFromRoadmap(roadmapId, projectId);
+    }
+    async reorderRoadmapProject(roadmapId, projectId, newPosition) {
+        return this.roadmapStorage.reorderRoadmapProject(roadmapId, projectId, newPosition);
+    }
+    async getRoadmapsForProject(projectId) {
+        return this.roadmapStorage.getRoadmapsForProject(projectId);
+    }
+    // ===========================================================================
     // Sync Operations (no-op for pure SQLite)
     // ===========================================================================
     async pull() {

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

@@ -0,0 +1,62 @@
+/**
+ * Roadmap operations for PMO.
+ * Roadmaps are curated collections of projects for documentation/visualization.
+ */
+import { Roadmap, RoadmapProject, RoadmapFilter, Project } from '../types.js';
+import { StorageContext } from './types.js';
+export declare class RoadmapStorage {
+    private ctx;
+    constructor(ctx: StorageContext);
+    /**
+     * Create a new roadmap.
+     */
+    createRoadmap(roadmap: Partial<Roadmap> & {
+        name: string;
+    }): Promise<Roadmap>;
+    /**
+     * Get a roadmap by ID.
+     */
+    getRoadmap(id: string): Promise<Roadmap | null>;
+    /**
+     * List roadmaps with optional filters.
+     */
+    listRoadmaps(filter?: RoadmapFilter): Promise<Roadmap[]>;
+    /**
+     * Update a roadmap.
+     */
+    updateRoadmap(id: string, changes: Partial<Roadmap>): Promise<Roadmap>;
+    /**
+     * Delete a roadmap.
+     */
+    deleteRoadmap(id: string): Promise<void>;
+    /**
+     * Get the default roadmap.
+     */
+    getDefaultRoadmap(): Promise<Roadmap | null>;
+    /**
+     * Set a roadmap as the default.
+     */
+    setDefaultRoadmap(id: string): Promise<Roadmap>;
+    /**
+     * List projects in a roadmap, ordered by position.
+     */
+    listRoadmapProjects(roadmapId: string): Promise<Project[]>;
+    /**
+     * Add a project to a roadmap.
+     */
+    addProjectToRoadmap(roadmapId: string, projectId: string, position?: number): Promise<RoadmapProject>;
+    /**
+     * Remove a project from a roadmap.
+     */
+    removeProjectFromRoadmap(roadmapId: string, projectId: string): Promise<void>;
+    /**
+     * Reorder a project within a roadmap.
+     */
+    reorderRoadmapProject(roadmapId: string, projectId: string, newPosition: number): Promise<RoadmapProject>;
+    /**
+     * Get all roadmaps that contain a project.
+     */
+    getRoadmapsForProject(projectId: string): Promise<Roadmap[]>;
+    private rowToRoadmap;
+    private rowToProject;
+}