@proletariat/cli 0.3.34 → 0.3.36

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);
 }
 /**
@@ -538,6 +539,8 @@ 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',
@@ -690,6 +693,200 @@ 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: 'test',
             name: 'Write Tests',
@@ -730,56 +927,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
@@ -984,7 +1132,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();
@@ -993,6 +1140,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;
+}