@proletariat/cli 0.3.33 → 0.3.35

package/dist/lib/pmo/schema.js

@@ -41,6 +41,10 @@ export const PMO_TABLES = {
     // 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
+    // Label system tables
+    label_groups: 'pmo_label_groups',
+    labels: 'pmo_labels',
+    ticket_labels: 'pmo_ticket_labels',
     // 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
@@ -427,6 +431,37 @@ export const PMO_TABLE_SCHEMAS = {
       suggested_subtasks TEXT NOT NULL DEFAULT '[]',
       created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
     )`,
+    // Label groups (workspace-scoped grouping for labels)
+    label_groups: `
+    CREATE TABLE IF NOT EXISTS ${PMO_TABLES.label_groups} (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL UNIQUE,
+      description TEXT,
+      is_exclusive INTEGER NOT NULL DEFAULT 1,
+      is_required INTEGER NOT NULL DEFAULT 0,
+      position INTEGER NOT NULL DEFAULT 0,
+      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+    )`,
+    // Labels (workspace-scoped, optionally grouped)
+    labels: `
+    CREATE TABLE IF NOT EXISTS ${PMO_TABLES.labels} (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      color TEXT,
+      description TEXT,
+      group_id TEXT REFERENCES ${PMO_TABLES.label_groups}(id) ON DELETE SET NULL,
+      position INTEGER NOT NULL DEFAULT 0,
+      is_builtin INTEGER NOT NULL DEFAULT 0,
+      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE(name, group_id)
+    )`,
+    // Junction table: ticket-label associations (replaces JSON labels field)
+    ticket_labels: `
+    CREATE TABLE IF NOT EXISTS ${PMO_TABLES.ticket_labels} (
+      ticket_id TEXT NOT NULL REFERENCES ${PMO_TABLES.tickets}(id) ON DELETE CASCADE,
+      label_id TEXT NOT NULL REFERENCES ${PMO_TABLES.labels}(id) ON DELETE CASCADE,
+      PRIMARY KEY (ticket_id, label_id)
+    )`,
     // Roadmap definitions (named collections of projects for documentation)
     roadmaps: `
     CREATE TABLE IF NOT EXISTS ${PMO_TABLES.roadmaps} (
@@ -502,6 +537,12 @@ export const PMO_INDEXES = `
   CREATE INDEX IF NOT EXISTS idx_pmo_roadmap_projects_position ON ${PMO_TABLES.roadmap_projects}(roadmap_id, position);
   CREATE INDEX IF NOT EXISTS idx_pmo_categories_type ON ${PMO_TABLES.categories}(type);
   CREATE INDEX IF NOT EXISTS idx_pmo_categories_position ON ${PMO_TABLES.categories}(type, position);
+  CREATE INDEX IF NOT EXISTS idx_pmo_label_groups_position ON ${PMO_TABLES.label_groups}(position);
+  CREATE INDEX IF NOT EXISTS idx_pmo_labels_group ON ${PMO_TABLES.labels}(group_id);
+  CREATE INDEX IF NOT EXISTS idx_pmo_labels_position ON ${PMO_TABLES.labels}(group_id, position);
+  CREATE INDEX IF NOT EXISTS idx_pmo_labels_builtin ON ${PMO_TABLES.labels}(is_builtin);
+  CREATE INDEX IF NOT EXISTS idx_pmo_ticket_labels_ticket ON ${PMO_TABLES.ticket_labels}(ticket_id);
+  CREATE INDEX IF NOT EXISTS idx_pmo_ticket_labels_label ON ${PMO_TABLES.ticket_labels}(label_id);
 `;
 // =============================================================================
 // Combined Schema
@@ -540,6 +581,9 @@ export const PMO_SCHEMA_SQL = [
     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.label_groups, // Label groups (before labels for FK)
+    PMO_TABLE_SCHEMAS.labels, // Labels (before ticket_labels for FK)
+    PMO_TABLE_SCHEMAS.ticket_labels, // Ticket-label junction table
     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)

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

@@ -42,6 +42,12 @@ export declare function seedBuiltinCategories(db: Database.Database): void;
  * Preserves any existing user-defined priority scale.
  */
 export declare function seedDefaultPriorities(db: Database.Database): void;
+/**
+ * Seed built-in label groups and labels.
+ * Creates Function, Type, and Area groups with their labels.
+ * Migrates existing ticket category values to Function labels.
+ */
+export declare function seedBuiltinLabels(db: Database.Database): void;
 /**
  * Update board timestamp for a project.
  */

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

@@ -5,7 +5,7 @@
 import { PMO_TABLES, PMO_SCHEMA_SQL, validateTicketSchema } from '../schema.js';
 import { TICKET_CATEGORIES, STATE_CATEGORY_ORDER } from '../types.js';
 import { BUILTIN_TEMPLATES } from '../templates-builtin.js';
-import { getWorkspacePriorities, setWorkspacePriorities, DEFAULT_PRIORITIES } from '../utils.js';
+import { setWorkspacePriorities, DEFAULT_PRIORITIES } from '../utils.js';
 const T = PMO_TABLES;
 /**
  * Initialize PMO tables in the database.
@@ -20,6 +20,7 @@ export function initializePMOTables(db) {
     seedBuiltinActions(db);
     seedBuiltinTicketTemplates(db);
     seedDefaultPriorities(db); // Seed default priority scale if not set
+    seedBuiltinLabels(db); // Seed built-in label groups and labels
     validateTicketSchema(db);
 }
 /**
@@ -467,6 +468,22 @@ Analyze this ticket and improve its definition:
 
 Do NOT implement the ticket - only improve its definition so it's ready to be worked on.
 
+## Flagging Ambiguities
+
+If you identify ambiguities or questions that need human clarification, add them to the description using this **exact format**:
+
+\`\`\`
+**Q1:** Should the API use REST or GraphQL?
+**Q2:** What is the expected timeout for sessions?
+**Q3:** Should this feature be behind a feature flag?
+\`\`\`
+
+When questions are added:
+- Add the \`needs-clarification\` label: \`--add-label "needs-clarification"\`
+- Questions can later be resolved with \`prlt ticket resolve\` or \`prlt work resolve\`
+
+If NO ambiguities are found, add the \`ready\` label instead.
+
 **AI Agent Tip:** When running \`prlt\` commands without all required arguments, use \`--json\` to receive interactive prompts as structured JSON.
 
 ## Ticket Schema Reference
@@ -522,12 +539,62 @@ Requirements:
 - Use \`--clear-subtasks\` if replacing existing subtasks
 - Use \`--clear-ac\` if replacing existing acceptance criteria
 
+**Tip:** Use \`prlt ticket view <id>\` to see full ticket details at any time.
+
 After updating, output a brief summary of your grooming changes.`,
             suggestedForCategories: ['backlog'],
             defaultMoveToCategory: 'unstarted',
             modifiesCode: false,
             position: 0,
         },
+        {
+            id: 'resolve',
+            name: 'Resolve',
+            description: 'Help human resolve ambiguity questions flagged during grooming',
+            prompt: `${PRLT_USAGE_RULE}
+
+---
+
+# Action: Resolve Ambiguities
+
+This ticket has been groomed and has open questions (Q1, Q2, etc.) that need human answers.
+
+Your job is to help the human answer each question by:
+1. Reading the ticket description to find all **Q1:**, **Q2:**, etc. questions
+2. For each question, explore the codebase to find relevant context
+3. Present each question to the human with your findings and a suggested answer
+4. Collect the human's answer (they may accept your suggestion or provide their own)
+5. Write the resolved answers back into the ticket description
+
+## Process
+
+For each question:
+1. **Search the codebase** for relevant context (files, patterns, existing implementations)
+2. **Present your findings**: "Q1: Should this use REST or GraphQL? I found you're already using GraphQL in \`src/api/schema.ts\`..."
+3. **Suggest an answer** based on the codebase context
+4. **Ask the human** to confirm or provide their own answer
+5. After collecting all answers, update the ticket:
+   \`\`\`bash
+   prlt ticket edit {{TICKET_ID}} --description "updated description with answers"
+   prlt ticket edit {{TICKET_ID}} --remove-label "needs-clarification" --add-label "ready"
+   \`\`\`
+
+## Important
+- This is an INTERACTIVE session - always ask the human before writing answers
+- If the ticket has acceptance criteria or subtasks that need updating based on answers, update those too
+- After resolving, move the ticket to the Ready column if all questions are answered`,
+            endPrompt: `After resolving all questions:
+1. Update the ticket description with answers below each question
+2. Remove the \`needs-clarification\` label and add \`ready\` label
+3. Update acceptance criteria and subtasks if answers affect them
+
+\`\`\`bash
+prlt ticket edit {{TICKET_ID}} --description "..." --remove-label "needs-clarification" --add-label "ready"
+\`\`\``,
+            suggestedForCategories: [],
+            modifiesCode: false,
+            position: 1,
+        },
         {
             id: 'implement',
             name: 'Implement',
@@ -579,7 +646,7 @@ When complete, the ticket should be ready for code review.`,
             suggestedForCategories: ['unstarted', 'started'],
             defaultMoveToCategory: 'started',
             modifiesCode: true,
-            position: 1,
+            position: 2,
         },
         {
             id: 'continue',
@@ -624,7 +691,7 @@ git add -A && prlt commit "your change" && git push
             suggestedForCategories: ['started'],
             defaultMoveToCategory: 'started',
             modifiesCode: true,
-            position: 2,
+            position: 3,
         },
         {
             id: 'test',
@@ -666,7 +733,7 @@ git add -A && prlt commit "add tests for X" && git push
 **IMPORTANT:** Use the global \`prlt\` command.`,
             suggestedForCategories: ['started', 'completed'],
             modifiesCode: true,
-            position: 3,
+            position: 4,
         },
         {
             id: 'review',
@@ -689,7 +756,7 @@ Output a review summary with your findings and any concerns.`,
 No commits are needed for code review.`,
             suggestedForCategories: ['started', 'completed'],
             modifiesCode: false,
-            position: 4,
+            position: 5,
         },
         {
             id: 'revise',
@@ -715,7 +782,7 @@ The PR will be updated automatically.`,
             suggestedForCategories: ['completed'],
             defaultMoveToCategory: 'started',
             modifiesCode: true,
-            position: 5,
+            position: 6,
         },
     ];
     // Use INSERT OR REPLACE to always update builtin actions with latest prompts
@@ -920,7 +987,6 @@ export function seedBuiltinCategories(db) {
  * Preserves any existing user-defined priority scale.
  */
 export function seedDefaultPriorities(db) {
-    const existing = getWorkspacePriorities(db);
     // getWorkspacePriorities returns DEFAULT_PRIORITIES if not set,
     // but we need to check if it's actually stored in the DB
     const row = db.prepare(`SELECT value FROM ${T.settings} WHERE key = 'priorities'`).get();
@@ -929,6 +995,118 @@ export function seedDefaultPriorities(db) {
         setWorkspacePriorities(db, [...DEFAULT_PRIORITIES]);
     }
 }
+/**
+ * Seed built-in label groups and labels.
+ * Creates Function, Type, and Area groups with their labels.
+ * Migrates existing ticket category values to Function labels.
+ */
+export function seedBuiltinLabels(db) {
+    const now = new Date().toISOString();
+    const insertGroup = db.prepare(`
+    INSERT OR IGNORE INTO ${T.label_groups} (id, name, description, is_exclusive, is_required, position, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `);
+    const insertLabel = db.prepare(`
+    INSERT OR IGNORE INTO ${T.labels} (id, name, color, description, group_id, position, is_builtin, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, 1, ?)
+  `);
+    // Built-in label groups
+    const groups = [
+        {
+            id: 'function',
+            name: 'Function',
+            description: 'Business function category (diet enforcement)',
+            isExclusive: true,
+            isRequired: true,
+            position: 0,
+            labels: [
+                { id: 'fn-ship', name: 'ship', description: 'Core product development', color: '#2da44e' },
+                { id: 'fn-grow', name: 'grow', description: 'Marketing, adoption, community', color: '#bf8700' },
+                { id: 'fn-support', name: 'support', description: 'Docs, error messages, onboarding', color: '#0969da' },
+                { id: 'fn-bizops', name: 'bizops', description: 'Infrastructure, CI/CD, operations', color: '#8250df' },
+                { id: 'fn-strategy', name: 'strategy', description: 'Design decisions, spikes, retros, planning', color: '#cf222e' },
+            ],
+        },
+        {
+            id: 'type',
+            name: 'Type',
+            description: 'Work type classification',
+            isExclusive: true,
+            isRequired: false,
+            position: 1,
+            labels: [
+                { id: 'type-bug', name: 'bug', description: 'Bug fix', color: '#cf222e' },
+                { id: 'type-feature', name: 'feature', description: 'New feature', color: '#2da44e' },
+                { id: 'type-improvement', name: 'improvement', description: 'Enhancement to existing feature', color: '#0969da' },
+                { id: 'type-task', name: 'task', description: 'General task', color: '#6e7781' },
+            ],
+        },
+        {
+            id: 'area',
+            name: 'Area',
+            description: 'System area (non-exclusive)',
+            isExclusive: false,
+            isRequired: false,
+            position: 2,
+            labels: [
+                { id: 'area-cli', name: 'cli', description: 'CLI tool', color: '#0969da' },
+                { id: 'area-pmo', name: 'pmo', description: 'Project management', color: '#8250df' },
+                { id: 'area-agent', name: 'agent', description: 'Agent system', color: '#2da44e' },
+                { id: 'area-docker', name: 'docker', description: 'Docker integration', color: '#bf8700' },
+                { id: 'area-mcp', name: 'mcp', description: 'MCP server', color: '#cf222e' },
+                { id: 'area-desktop', name: 'desktop', description: 'Desktop app', color: '#6e7781' },
+            ],
+        },
+    ];
+    for (const group of groups) {
+        insertGroup.run(group.id, group.name, group.description, group.isExclusive ? 1 : 0, group.isRequired ? 1 : 0, group.position, now);
+        for (let i = 0; i < group.labels.length; i++) {
+            const label = group.labels[i];
+            insertLabel.run(label.id, label.name, label.color, label.description, group.id, i, now);
+        }
+    }
+    // Migrate existing category column values to Function label group
+    // Only run if there are tickets with category set but no Function label yet
+    migrateCategoryToFunctionLabels(db);
+}
+/**
+ * Migrate existing ticket category values to Function label group entries.
+ * Maps known category names to function labels (e.g., 'ship' -> fn-ship).
+ * This is idempotent - only creates associations that don't exist yet.
+ */
+function migrateCategoryToFunctionLabels(db) {
+    // Map of old category values to function label IDs
+    // The ticket's category field contains values like 'feature', 'bug', etc.
+    // The diet system uses ship/grow/support/bizops/strategy which are different
+    // from ticket categories. The diet categories map to the Function label group.
+    // Since existing categories (feature, bug, etc.) don't map to Function labels,
+    // we only migrate if the category field happens to contain a Function label name.
+    const functionLabelMap = {
+        ship: 'fn-ship',
+        grow: 'fn-grow',
+        support: 'fn-support',
+        bizops: 'fn-bizops',
+        strategy: 'fn-strategy',
+    };
+    const tickets = db.prepare(`
+    SELECT id, category FROM ${T.tickets}
+    WHERE category IS NOT NULL AND category != ''
+  `).all();
+    const insertTicketLabel = db.prepare(`
+    INSERT OR IGNORE INTO ${T.ticket_labels} (ticket_id, label_id)
+    VALUES (?, ?)
+  `);
+    for (const ticket of tickets) {
+        const labelId = functionLabelMap[ticket.category.toLowerCase()];
+        if (labelId) {
+            // Check label exists before inserting
+            const labelExists = db.prepare(`SELECT id FROM ${T.labels} WHERE id = ?`).get(labelId);
+            if (labelExists) {
+                insertTicketLabel.run(ticket.id, labelId);
+            }
+        }
+    }
+}
 /**
  * Update board timestamp for a project.
  */

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

@@ -9,7 +9,7 @@
  */
 import Database from 'better-sqlite3';
 import { DrizzleDB } from '../../database/drizzle.js';
-import { AcceptanceCriterion, Board, BoardConfig, BoardView, BoardViewFilter, BoardViewFilters, Category, CategoryFilter, CategoryType, 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';
+import { AcceptanceCriterion, Board, BoardConfig, BoardView, BoardViewFilter, BoardViewFilters, Category, CategoryFilter, CategoryType, 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, Label, LabelFilter, LabelGroup, LabelGroupFilter } from '../types.js';
 export declare class SQLiteStorage implements PMOStorage {
     readonly type: "sqlite";
     private db;
@@ -29,6 +29,7 @@ export declare class SQLiteStorage implements PMOStorage {
     private viewStorage;
     private roadmapStorage;
     private categoryStorage;
+    private labelStorage;
     constructor(dbPath: string);
     /**
      * Get the underlying database connection.
@@ -203,6 +204,27 @@ export declare class SQLiteStorage implements PMOStorage {
     deleteCategory(id: string): Promise<void>;
     getCategoryNames(type: CategoryType): Promise<string[]>;
     isValidCategory(name: string, type: CategoryType): Promise<boolean>;
+    listLabelGroups(filter?: LabelGroupFilter): Promise<LabelGroup[]>;
+    getLabelGroup(id: string): Promise<LabelGroup | null>;
+    getLabelGroupByName(name: string): Promise<LabelGroup | null>;
+    createLabelGroup(group: Partial<LabelGroup> & {
+        name: string;
+    }): Promise<LabelGroup>;
+    updateLabelGroup(id: string, changes: Partial<LabelGroup>): Promise<LabelGroup>;
+    deleteLabelGroup(id: string): Promise<void>;
+    listLabels(filter?: LabelFilter): Promise<Label[]>;
+    getLabel(id: string): Promise<Label | null>;
+    getLabelByName(name: string, groupId?: string): Promise<Label | null>;
+    createLabel(label: Partial<Label> & {
+        name: string;
+    }): Promise<Label>;
+    updateLabel(id: string, changes: Partial<Label>): Promise<Label>;
+    deleteLabel(id: string): Promise<void>;
+    addLabelToTicket(ticketId: string, labelId: string): Promise<void>;
+    removeLabelFromTicket(ticketId: string, labelId: string): Promise<void>;
+    getLabelsForTicket(ticketId: string): Promise<Label[]>;
+    addLabelToTicketByName(ticketId: string, labelName: string): Promise<void>;
+    removeLabelFromTicketByName(ticketId: string, labelName: string): Promise<void>;
     pull(): Promise<SyncResult>;
     push(): Promise<SyncResult>;
     status(): Promise<SyncStatus>;

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

@@ -10,7 +10,7 @@
 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, seedBuiltinCategories, updateBoardTimestamp, } from './base.js';
+import { runMigrations, seedBuiltinWorkflows, seedBuiltinPhases, seedBuiltinPhaseTemplates, seedBuiltinActions, seedBuiltinTicketTemplates, seedBuiltinCategories, seedBuiltinLabels, updateBoardTimestamp, } from './base.js';
 import { ProjectStorage } from './projects.js';
 import { TicketStorage } from './tickets.js';
 import { SubtaskStorage, AcceptanceCriteriaStorage } from './subtasks.js';
@@ -24,6 +24,7 @@ import { ActionStorage } from './actions.js';
 import { ViewStorage } from './views.js';
 import { RoadmapStorage } from './roadmaps.js';
 import { CategoryStorage } from './categories.js';
+import { LabelStorage } from './labels.js';
 const T = PMO_TABLES;
 export class SQLiteStorage {
     type = 'sqlite';
@@ -45,6 +46,7 @@ export class SQLiteStorage {
     viewStorage;
     roadmapStorage;
     categoryStorage;
+    labelStorage;
     constructor(dbPath) {
         this.dbPath = dbPath;
         // Open database (creates if doesn't exist)
@@ -74,6 +76,7 @@ export class SQLiteStorage {
         this.viewStorage = new ViewStorage(ctx);
         this.roadmapStorage = new RoadmapStorage(ctx);
         this.categoryStorage = new CategoryStorage(ctx);
+        this.labelStorage = new LabelStorage(ctx);
         // Ensure PMO tables exist
         this.ensurePMOTables();
     }
@@ -104,6 +107,7 @@ export class SQLiteStorage {
         seedBuiltinActions(this.db);
         seedBuiltinTicketTemplates(this.db);
         seedBuiltinCategories(this.db);
+        seedBuiltinLabels(this.db);
         // Validate schema
         validateTicketSchema(this.db);
     }
@@ -616,6 +620,60 @@ export class SQLiteStorage {
         return this.categoryStorage.isValidCategory(name, type);
     }
     // ===========================================================================
+    // Label Operations
+    // ===========================================================================
+    async listLabelGroups(filter) {
+        return this.labelStorage.listLabelGroups(filter);
+    }
+    async getLabelGroup(id) {
+        return this.labelStorage.getLabelGroup(id);
+    }
+    async getLabelGroupByName(name) {
+        return this.labelStorage.getLabelGroupByName(name);
+    }
+    async createLabelGroup(group) {
+        return this.labelStorage.createLabelGroup(group);
+    }
+    async updateLabelGroup(id, changes) {
+        return this.labelStorage.updateLabelGroup(id, changes);
+    }
+    async deleteLabelGroup(id) {
+        return this.labelStorage.deleteLabelGroup(id);
+    }
+    async listLabels(filter) {
+        return this.labelStorage.listLabels(filter);
+    }
+    async getLabel(id) {
+        return this.labelStorage.getLabel(id);
+    }
+    async getLabelByName(name, groupId) {
+        return this.labelStorage.getLabelByName(name, groupId);
+    }
+    async createLabel(label) {
+        return this.labelStorage.createLabel(label);
+    }
+    async updateLabel(id, changes) {
+        return this.labelStorage.updateLabel(id, changes);
+    }
+    async deleteLabel(id) {
+        return this.labelStorage.deleteLabel(id);
+    }
+    async addLabelToTicket(ticketId, labelId) {
+        return this.labelStorage.addLabelToTicket(ticketId, labelId);
+    }
+    async removeLabelFromTicket(ticketId, labelId) {
+        return this.labelStorage.removeLabelFromTicket(ticketId, labelId);
+    }
+    async getLabelsForTicket(ticketId) {
+        return this.labelStorage.getLabelsForTicket(ticketId);
+    }
+    async addLabelToTicketByName(ticketId, labelName) {
+        return this.labelStorage.addLabelToTicketByName(ticketId, labelName);
+    }
+    async removeLabelFromTicketByName(ticketId, labelName) {
+        return this.labelStorage.removeLabelFromTicketByName(ticketId, labelName);
+    }
+    // ===========================================================================
     // Sync Operations (no-op for pure SQLite)
     // ===========================================================================
     async pull() {

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

@@ -0,0 +1,55 @@
+/**
+ * Label storage operations for PMO.
+ * Handles CRUD for labels, label groups, and ticket-label associations.
+ * Enforces group exclusivity constraints.
+ */
+import { Label, LabelFilter, LabelGroup, LabelGroupFilter } from '../types.js';
+import { StorageContext } from './types.js';
+export declare class LabelStorage {
+    private ctx;
+    constructor(ctx: StorageContext);
+    listLabelGroups(filter?: LabelGroupFilter): Promise<LabelGroup[]>;
+    getLabelGroup(id: string): Promise<LabelGroup | null>;
+    getLabelGroupByName(name: string): Promise<LabelGroup | null>;
+    createLabelGroup(group: Partial<LabelGroup> & {
+        name: string;
+    }): Promise<LabelGroup>;
+    updateLabelGroup(id: string, changes: Partial<LabelGroup>): Promise<LabelGroup>;
+    deleteLabelGroup(id: string): Promise<void>;
+    listLabels(filter?: LabelFilter): Promise<Label[]>;
+    getLabel(id: string): Promise<Label | null>;
+    getLabelByName(name: string, groupId?: string): Promise<Label | null>;
+    createLabel(label: Partial<Label> & {
+        name: string;
+    }): Promise<Label>;
+    updateLabel(id: string, changes: Partial<Label>): Promise<Label>;
+    deleteLabel(id: string): Promise<void>;
+    /**
+     * Add a label to a ticket.
+     * Enforces group exclusivity: if the label belongs to an exclusive group,
+     * removes any existing label from the same group first.
+     */
+    addLabelToTicket(ticketId: string, labelId: string): Promise<void>;
+    /**
+     * Remove a label from a ticket.
+     */
+    removeLabelFromTicket(ticketId: string, labelId: string): Promise<void>;
+    /**
+     * Get all labels for a ticket.
+     */
+    getLabelsForTicket(ticketId: string): Promise<Label[]>;
+    /**
+     * Add a label to a ticket by name.
+     * Resolves the label name to an ID first.
+     * If the label name matches a group:label pattern, resolves within that group.
+     */
+    addLabelToTicketByName(ticketId: string, labelName: string): Promise<void>;
+    /**
+     * Remove a label from a ticket by name.
+     */
+    removeLabelFromTicketByName(ticketId: string, labelName: string): Promise<void>;
+    /**
+     * Resolve a label by name or group:name pattern.
+     */
+    private resolveLabelByName;
+}