@fractary/faber-cli 1.3.14 → 1.4.0

package/dist/__mocks__/chalk.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Mock implementation of chalk for testing
+ */
+declare const mockChalk: {
+    green: (str: string) => string;
+    red: (str: string) => string;
+    yellow: (str: string) => string;
+    blue: (str: string) => string;
+    cyan: (str: string) => string;
+    gray: (str: string) => string;
+    grey: (str: string) => string;
+    bold: (str: string) => string;
+    dim: (str: string) => string;
+};
+export default mockChalk;
+//# sourceMappingURL=chalk.d.ts.map

package/dist/__mocks__/chalk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chalk.d.ts","sourceRoot":"","sources":["../../src/__mocks__/chalk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,QAAA,MAAM,SAAS;iBACA,MAAM;eACR,MAAM;kBACH,MAAM;gBACR,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;eACP,MAAM;CAClB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/__mocks__/chalk.js

@@ -0,0 +1,15 @@
+/**
+ * Mock implementation of chalk for testing
+ */
+const mockChalk = {
+    green: (str) => str,
+    red: (str) => str,
+    yellow: (str) => str,
+    blue: (str) => str,
+    cyan: (str) => str,
+    gray: (str) => str,
+    grey: (str) => str,
+    bold: (str) => str,
+    dim: (str) => str,
+};
+export default mockChalk;

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,iBAAiB,IAAI,OAAO,CAsE3C"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,iBAAiB,IAAI,OAAO,CAkG3C"}

package/dist/commands/init.js

@@ -5,6 +5,8 @@ import { Command } from 'commander';
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import chalk from 'chalk';
+import { prompt } from '../utils/prompt.js';
+import { createPriorityLabels, isGitHubCLIAvailable } from '../utils/labels.js';
 export function createInitCommand() {
     return new Command('workflow-init')
         .description('Initialize a new FABER project')
@@ -44,20 +46,45 @@ logs/session-*.md
 *.tmp
 `;
             await fs.writeFile(path.join(configDir, '.gitignore'), gitignore);
+            // Offer to create priority labels (if not in JSON mode)
+            let labelsCreated = false;
+            if (!options.json) {
+                const ghAvailable = await isGitHubCLIAvailable();
+                if (ghAvailable) {
+                    console.log('');
+                    const createLabels = await prompt('Create priority labels (priority-1 through priority-4) for backlog management? [Y/n]: ');
+                    if (!createLabels || createLabels.toLowerCase() === 'y' || createLabels.toLowerCase() === 'yes') {
+                        console.log(chalk.cyan('\n→ Creating priority labels...'));
+                        const result = await createPriorityLabels('priority', false);
+                        if (result.created.length > 0) {
+                            labelsCreated = true;
+                        }
+                        if (result.errors.length > 0) {
+                            console.log(chalk.yellow('\n⚠️  Some labels could not be created. You can create them manually later.'));
+                        }
+                    }
+                }
+            }
             if (options.json) {
                 console.log(JSON.stringify({
                     status: 'success',
-                    data: { configPath, preset: options.preset },
+                    data: { configPath, preset: options.preset, labelsCreated },
                 }, null, 2));
             }
             else {
-                console.log(chalk.green('✓ FABER initialized successfully'));
+                console.log(chalk.green('\n✓ FABER initialized successfully'));
                 console.log(chalk.gray(`  Config: ${configPath}`));
                 console.log(chalk.gray(`  Preset: ${options.preset}`));
+                if (labelsCreated) {
+                    console.log(chalk.gray('  Priority labels: Created'));
+                }
                 console.log('\nNext steps:');
                 console.log('  1. Configure work tracking: Edit .fractary/faber/config.json');
                 console.log('  2. Start a workflow: fractary-faber run --work-id <issue-number>');
                 console.log('  3. Check status: fractary-faber status');
+                if (labelsCreated) {
+                    console.log('  4. Use priority labels: gh issue edit <number> --add-label "priority-1"');
+                }
             }
         }
         catch (error) {

package/dist/commands/plan/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/plan/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+CpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAkB3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/plan/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqDpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAqB3C"}

package/dist/commands/plan/index.js

@@ -26,6 +26,9 @@ export function createPlanCommand() {
         .option('--skip-confirm', 'Skip confirmation prompt (use with caution)')
         .option('--output <format>', 'Output format: text|json|yaml', 'text')
         .option('--json', 'Output as JSON (shorthand for --output json)')
+        .option('--limit <n>', 'Maximum number of issues to plan', parseInt)
+        .option('--order-by <strategy>', 'Order issues by: priority|created|updated (default: none)', 'none')
+        .option('--order-direction <dir>', 'Order direction: asc|desc (default: desc)', 'desc')
         .action(async (options) => {
         try {
             await executePlanCommand(options);
@@ -39,7 +42,6 @@ export function createPlanCommand() {
  * Main execution logic for plan command
  */
 async function executePlanCommand(options) {
-    console.error('[DEBUG] Starting executePlanCommand');
     const outputFormat = options.json ? 'json' : options.output || 'text';
     // Validate arguments
     if (!options.workId && !options.workLabel) {
@@ -48,14 +50,31 @@ async function executePlanCommand(options) {
     if (options.workId && options.workLabel) {
         throw new Error('Cannot use both --work-id and --work-label at the same time');
     }
+    // Validate backlog management options
+    if (options.limit !== undefined) {
+        if (!Number.isInteger(options.limit) || options.limit <= 0) {
+            throw new Error('--limit must be a positive integer');
+        }
+        if (options.limit > 100) {
+            throw new Error('--limit cannot exceed 100');
+        }
+    }
+    if (options.orderBy && options.orderBy !== 'none') {
+        const validOrderBy = ['priority', 'created', 'updated'];
+        if (!validOrderBy.includes(options.orderBy)) {
+            throw new Error(`--order-by must be one of: ${validOrderBy.join(', ')}, or 'none'`);
+        }
+    }
+    if (options.orderDirection) {
+        const validDirections = ['asc', 'desc'];
+        if (!validDirections.includes(options.orderDirection)) {
+            throw new Error(`--order-direction must be one of: ${validDirections.join(', ')}`);
+        }
+    }
     // Initialize clients
-    console.error('[DEBUG] Loading config...');
     const config = await ConfigManager.load();
-    console.error('[DEBUG] Creating RepoClient...');
     const repoClient = await RepoClient.create(config);
-    console.error('[DEBUG] Creating AnthropicClient...');
     const anthropicClient = new AnthropicClient(config);
-    console.error('[DEBUG] Clients initialized');
     if (outputFormat === 'text') {
         console.log(chalk.blue('FABER CLI - Workflow Planning'));
         console.log(chalk.gray('═'.repeat(50)));
@@ -116,6 +135,41 @@ async function executePlanCommand(options) {
         }
         return;
     }
+    // Auto-create priority labels if using priority ordering and labels don't exist
+    if (options.orderBy === 'priority') {
+        const { ensurePriorityLabels } = await import('../../utils/labels.js');
+        const priorityLabelPrefix = config.backlog_management?.priority_config?.label_prefix || 'priority';
+        // Try to ensure labels exist (quiet mode - won't spam console)
+        const labelsEnsured = await ensurePriorityLabels(priorityLabelPrefix, true);
+        if (outputFormat === 'text' && labelsEnsured) {
+            console.log(chalk.gray(`\n→ Priority labels are ready (using prefix: ${priorityLabelPrefix})`));
+        }
+    }
+    // Apply ordering if requested
+    if (options.orderBy && options.orderBy !== 'none') {
+        const { sortIssues } = await import('../../utils/sorting.js');
+        // Load priority label prefix from config (with fallback)
+        const priorityLabelPrefix = config.backlog_management?.priority_config?.label_prefix || 'priority';
+        const originalCount = issues.length;
+        issues = sortIssues(issues, {
+            orderBy: options.orderBy,
+            direction: (options.orderDirection || 'desc'),
+            priorityConfig: {
+                labelPrefix: priorityLabelPrefix,
+            }
+        });
+        if (outputFormat === 'text') {
+            console.log(chalk.blue(`\n→ Sorted ${originalCount} issue(s) by ${options.orderBy} (${options.orderDirection || 'desc'})`));
+        }
+    }
+    // Apply limit if specified
+    if (options.limit && issues.length > options.limit) {
+        const totalFound = issues.length;
+        issues = issues.slice(0, options.limit);
+        if (outputFormat === 'text') {
+            console.log(chalk.yellow(`→ Limiting to top ${options.limit} issue(s) (found ${totalFound})`));
+        }
+    }
     // Step 2: Extract workflows from labels or prompt user
     if (outputFormat === 'text') {
         console.log(chalk.cyan('\n→ Identifying workflows...'));
@@ -346,6 +400,8 @@ async function planSingleIssue(issue, config, repoClient, anthropicClient, optio
             console.log(chalk.gray(`  → Plan written to ${planPath}`));
         }
     }
+    // Generate detailed comment for GitHub issue
+    const planSummary = generatePlanComment(plan, issue.workflow, worktreePath, planId);
     // Update GitHub issue with plan_id
     if (outputFormat === 'text') {
         console.log(chalk.gray(`  → Updating GitHub issue...`));
@@ -353,7 +409,7 @@ async function planSingleIssue(issue, config, repoClient, anthropicClient, optio
     try {
         await repoClient.updateIssue({
             id: issue.number.toString(),
-            comment: `🤖 Workflow plan created: ${planId}`,
+            comment: planSummary,
             addLabel: 'faber:planned',
         });
     }
@@ -368,7 +424,7 @@ async function planSingleIssue(issue, config, repoClient, anthropicClient, optio
             }
             await repoClient.updateIssue({
                 id: issue.number.toString(),
-                comment: `🤖 Workflow plan created: ${planId}`,
+                comment: planSummary,
             });
         }
         else {
@@ -385,6 +441,60 @@ async function planSingleIssue(issue, config, repoClient, anthropicClient, optio
         worktree: worktreePath,
     };
 }
+/**
+ * Generate a detailed plan comment for GitHub issue
+ */
+function generatePlanComment(plan, workflow, worktreePath, planId) {
+    let comment = `🤖 **Workflow Plan Created**\n\n`;
+    comment += `**Plan ID:** \`${planId}\`\n`;
+    comment += `**Workflow:** \`${workflow}\`\n`;
+    // Add workflow inheritance info if available
+    if (plan.workflow_config?.inherits_from) {
+        comment += `**Inherits from:** \`${plan.workflow_config.inherits_from}\`\n`;
+    }
+    comment += `\n---\n\n`;
+    // Add plan summary by phase
+    if (plan.phases && Array.isArray(plan.phases)) {
+        comment += `### Workflow Phases\n\n`;
+        plan.phases.forEach((phase, index) => {
+            comment += `**${index + 1}. ${phase.name || phase.phase}**\n\n`;
+            // Show phase description if available
+            if (phase.description) {
+                comment += `*${phase.description}*\n\n`;
+            }
+            // Show steps/tasks
+            if (phase.steps && Array.isArray(phase.steps)) {
+                phase.steps.forEach((step) => {
+                    const action = step.action || step.name || step.description || step;
+                    comment += `  - **${action}**`;
+                    if (step.details) {
+                        comment += `: ${step.details}`;
+                    }
+                    comment += `\n`;
+                });
+            }
+            else if (phase.tasks && Array.isArray(phase.tasks)) {
+                phase.tasks.forEach((task) => {
+                    const taskDesc = task.description || task.name || task;
+                    comment += `  - ${taskDesc}\n`;
+                });
+            }
+            comment += `\n`;
+        });
+    }
+    comment += `---\n\n`;
+    comment += `### Plan Location\n\n`;
+    comment += `\`\`\`\n${worktreePath}/.fractary/plans/${planId}.json\n\`\`\`\n\n`;
+    comment += `### Next Steps\n\n`;
+    comment += `Execute the workflow plan:\n\n`;
+    comment += `\`\`\`bash\n`;
+    comment += `cd ${worktreePath}\n`;
+    comment += `claude\n`;
+    comment += `# Then in Claude Code:\n`;
+    comment += `/fractary-faber:workflow-run ${plan.issue_number || ''}\n`;
+    comment += `\`\`\`\n`;
+    return comment;
+}
 /**
  * Get repository info from config
  */

package/dist/lib/github-app-auth.js

@@ -268,8 +268,8 @@ export class GitHubAppAuth {
 }
 // Token refresh threshold (5 minutes before expiration)
 GitHubAppAuth.REFRESH_THRESHOLD_MS = 5 * 60 * 1000;
-// JWT validity period (10 minutes max for GitHub)
-GitHubAppAuth.JWT_EXPIRY_SECONDS = 600;
+// JWT validity period (reduced to 5 minutes to handle clock skew)
+GitHubAppAuth.JWT_EXPIRY_SECONDS = 300;
 // GitHub API base URL
 GitHubAppAuth.GITHUB_API_URL = 'https://api.github.com';
 /**

package/dist/lib/sdk-type-adapter.d.ts

@@ -12,6 +12,8 @@ interface CLIIssue {
     labels: string[];
     url: string;
     state: string;
+    createdAt?: string;
+    updatedAt?: string;
 }
 interface WorktreeResult {
     path: string;

package/dist/lib/sdk-type-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-type-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-type-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGjF,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAU/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAUhB"}
+{"version":3,"file":"sdk-type-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-type-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGjF,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAY/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAUhB"}

package/dist/lib/sdk-type-adapter.js

@@ -18,6 +18,8 @@ export function sdkIssueToCLIIssue(sdkIssue) {
         labels: sdkIssue.labels.map(label => label.name), // Extract label names
         url: sdkIssue.url,
         state: sdkIssue.state,
+        createdAt: sdkIssue.created_at,
+        updatedAt: sdkIssue.updated_at,
     };
 }
 /**

package/dist/types/config.d.ts

@@ -32,11 +32,19 @@ export interface WorkflowConfig {
     default?: string;
     config_path?: string;
 }
+export interface BacklogManagementConfig {
+    default_limit?: number;
+    default_order_by?: 'priority' | 'created' | 'updated' | 'none';
+    priority_config?: {
+        label_prefix?: string;
+    };
+}
 export interface FaberConfig {
     anthropic?: AnthropicConfig;
     github?: GitHubConfig;
     worktree?: WorktreeConfig;
     workflow?: WorkflowConfig;
+    backlog_management?: BacklogManagementConfig;
 }
 export interface ClaudeConfig {
     worktree?: {

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/D,eAAe,CAAC,EAAE;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/utils/labels.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GitHub Label Management Utilities
+ *
+ * Handles creation and management of priority labels for backlog management
+ */
+export interface PriorityLabel {
+    name: string;
+    description: string;
+    color: string;
+}
+/**
+ * Default priority labels (priority-1 through priority-4)
+ */
+export declare const DEFAULT_PRIORITY_LABELS: PriorityLabel[];
+/**
+ * Generate priority labels based on a custom prefix
+ */
+export declare function generatePriorityLabels(prefix: string): PriorityLabel[];
+/**
+ * Check if a label exists in the repository
+ * @param labelName - Name of the label to check
+ * @returns Promise resolving to true if label exists, false otherwise
+ */
+export declare function labelExists(labelName: string): Promise<boolean>;
+/**
+ * Create a single label in the repository
+ * @param label - Label to create with name, description, and color
+ */
+export declare function createLabel(label: PriorityLabel): Promise<void>;
+/**
+ * Create multiple priority labels
+ * @param prefix - Label prefix (e.g., "priority" for priority-1, priority-2, etc.)
+ * @param quiet - If true, suppress console output
+ * @returns Object with arrays of created, skipped, and error labels
+ */
+export declare function createPriorityLabels(prefix?: string, quiet?: boolean): Promise<{
+    created: string[];
+    skipped: string[];
+    errors: string[];
+}>;
+/**
+ * Check if GitHub CLI is available
+ */
+export declare function isGitHubCLIAvailable(): Promise<boolean>;
+/**
+ * Ensure priority labels exist, creating them if necessary
+ * This is a convenience function for automatic label creation
+ */
+export declare function ensurePriorityLabels(prefix?: string, quiet?: boolean): Promise<boolean>;
+//# sourceMappingURL=labels.d.ts.map

package/dist/utils/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/utils/labels.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,EAqBlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAKtE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAarE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,GAAE,MAAmB,EAC3B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAsDrE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO7D;AAaD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,GAAE,MAAmB,EAC3B,KAAK,GAAE,OAAc,GACpB,OAAO,CAAC,OAAO,CAAC,CAqBlB"}

package/dist/utils/labels.js

@@ -0,0 +1,182 @@
+/**
+ * GitHub Label Management Utilities
+ *
+ * Handles creation and management of priority labels for backlog management
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import chalk from 'chalk';
+const execFileAsync = promisify(execFile);
+/**
+ * Default priority labels (priority-1 through priority-4)
+ */
+export const DEFAULT_PRIORITY_LABELS = [
+    {
+        name: 'priority-1',
+        description: 'Highest priority - Critical issues that need immediate attention',
+        color: 'd73a4a', // Red
+    },
+    {
+        name: 'priority-2',
+        description: 'High priority - Important issues that should be addressed soon',
+        color: 'e99695', // Light red
+    },
+    {
+        name: 'priority-3',
+        description: 'Medium priority - Standard priority issues',
+        color: 'fbca04', // Yellow
+    },
+    {
+        name: 'priority-4',
+        description: 'Low priority - Nice to have, can be deferred',
+        color: 'd4c5f9', // Light purple
+    },
+];
+/**
+ * Generate priority labels based on a custom prefix
+ */
+export function generatePriorityLabels(prefix) {
+    return DEFAULT_PRIORITY_LABELS.map((label, index) => ({
+        ...label,
+        name: `${prefix}-${index + 1}`,
+    }));
+}
+/**
+ * Check if a label exists in the repository
+ * @param labelName - Name of the label to check
+ * @returns Promise resolving to true if label exists, false otherwise
+ */
+export async function labelExists(labelName) {
+    try {
+        const { stdout } = await execFileAsync('gh', ['label', 'list', '--json', 'name', '--jq', '.[].name']);
+        const labels = stdout.trim().split('\n').map(l => l.trim()).filter(l => l.length > 0);
+        return labels.includes(labelName);
+    }
+    catch (error) {
+        // If gh command fails, assume label doesn't exist
+        return false;
+    }
+}
+/**
+ * Create a single label in the repository
+ * @param label - Label to create with name, description, and color
+ */
+export async function createLabel(label) {
+    const { name, description, color } = label;
+    // Use execFileAsync with array arguments to prevent command injection
+    await execFileAsync('gh', [
+        'label',
+        'create',
+        name,
+        '--description',
+        description,
+        '--color',
+        color,
+        '--force'
+    ]);
+}
+/**
+ * Create multiple priority labels
+ * @param prefix - Label prefix (e.g., "priority" for priority-1, priority-2, etc.)
+ * @param quiet - If true, suppress console output
+ * @returns Object with arrays of created, skipped, and error labels
+ */
+export async function createPriorityLabels(prefix = 'priority', quiet = false) {
+    // Validate prefix format
+    if (!isValidLabelPrefix(prefix)) {
+        return {
+            created: [],
+            skipped: [],
+            errors: [`Invalid label prefix: ${prefix}. Must contain only letters, numbers, and hyphens.`]
+        };
+    }
+    const labels = generatePriorityLabels(prefix);
+    const created = [];
+    const skipped = [];
+    const errors = [];
+    // Fetch all existing labels once to optimize API calls
+    let existingLabels = [];
+    try {
+        const { stdout } = await execFileAsync('gh', ['label', 'list', '--json', 'name', '--jq', '.[].name']);
+        existingLabels = stdout.trim().split('\n').map(l => l.trim()).filter(l => l.length > 0);
+    }
+    catch (error) {
+        // If we can't fetch labels, proceed cautiously
+        if (!quiet) {
+            console.log(chalk.yellow('  ⚠️  Could not fetch existing labels, will attempt creation'));
+        }
+    }
+    for (const label of labels) {
+        try {
+            // Check if label already exists (using cached list)
+            if (existingLabels.includes(label.name)) {
+                skipped.push(label.name);
+                if (!quiet) {
+                    console.log(chalk.gray(`  ⊳ Label already exists: ${label.name}`));
+                }
+                continue;
+            }
+            // Create the label
+            await createLabel(label);
+            created.push(label.name);
+            if (!quiet) {
+                console.log(chalk.green(`  ✓ Created label: ${label.name}`));
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(`${label.name}: ${message}`);
+            if (!quiet) {
+                console.log(chalk.red(`  ✗ Failed to create ${label.name}: ${message}`));
+            }
+        }
+    }
+    return { created, skipped, errors };
+}
+/**
+ * Check if GitHub CLI is available
+ */
+export async function isGitHubCLIAvailable() {
+    try {
+        await execFileAsync('gh', ['--version']);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Validate label prefix format
+ * @param prefix - Label prefix to validate
+ * @returns True if valid, false otherwise
+ */
+function isValidLabelPrefix(prefix) {
+    // Label prefix should only contain lowercase letters, numbers, and hyphens
+    // and should not be empty
+    return /^[a-z0-9-]+$/i.test(prefix) && prefix.length > 0 && prefix.length <= 50;
+}
+/**
+ * Ensure priority labels exist, creating them if necessary
+ * This is a convenience function for automatic label creation
+ */
+export async function ensurePriorityLabels(prefix = 'priority', quiet = true) {
+    // Check if gh CLI is available
+    const ghAvailable = await isGitHubCLIAvailable();
+    if (!ghAvailable) {
+        if (!quiet) {
+            console.log(chalk.yellow('  ⚠️  GitHub CLI (gh) not available, skipping label creation'));
+        }
+        return false;
+    }
+    try {
+        const result = await createPriorityLabels(prefix, quiet);
+        // Return true if we created any labels or all were already present
+        return result.created.length > 0 || result.skipped.length > 0;
+    }
+    catch (error) {
+        if (!quiet) {
+            console.log(chalk.yellow(`  ⚠️  Could not create priority labels: ${error instanceof Error ? error.message : String(error)}`));
+        }
+        return false;
+    }
+}

package/dist/utils/sorting.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Issue Sorting Utilities
+ *
+ * Provides sorting and priority extraction for backlog management
+ */
+export interface SortOptions {
+    orderBy: 'priority' | 'created' | 'updated';
+    direction: 'asc' | 'desc';
+    priorityConfig: {
+        labelPrefix: string;
+    };
+}
+export interface Issue {
+    id: string;
+    number: number;
+    title: string;
+    description: string;
+    labels: string[];
+    url: string;
+    state: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * Sort issues according to strategy
+ *
+ * @param issues - Array of issues to sort
+ * @param options - Sort options including orderBy, direction, and priority config
+ * @returns Sorted array of issues
+ *
+ * @remarks
+ * Priority sorting has inverted direction semantics compared to date sorting:
+ *
+ * **Priority Sorting:**
+ * - `direction: 'desc'` (default) = Highest priority first = priority-1, priority-2, priority-3, ...
+ * - `direction: 'asc'` = Lowest priority first = priority-4, priority-3, priority-2, priority-1
+ *
+ * This is because "descending priority" means "descending importance" (highest first),
+ * which corresponds to ascending numeric values (1 < 2 < 3).
+ *
+ * **Date Sorting:**
+ * - `direction: 'desc'` = Newest first (standard descending chronological order)
+ * - `direction: 'asc'` = Oldest first (standard ascending chronological order)
+ */
+export declare function sortIssues(issues: Issue[], options: SortOptions): Issue[];
+//# sourceMappingURL=sorting.d.ts.map

package/dist/utils/sorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../../src/utils/sorting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,cAAc,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,EAAE,CA2BzE"}

package/dist/utils/sorting.js

@@ -0,0 +1,89 @@
+/**
+ * Issue Sorting Utilities
+ *
+ * Provides sorting and priority extraction for backlog management
+ */
+import chalk from 'chalk';
+/**
+ * Extract numeric priority from issue labels
+ * Examples: priority-1 → 1, priority-2 → 2, p-1 → 1
+ * Returns 999 if no priority found (sorts last)
+ *
+ * @param labels - Array of label strings
+ * @param prefix - Label prefix to match (e.g., "priority")
+ * @param issueNumber - Optional issue number for warning messages
+ * @returns Priority number (1-4 for valid priorities, 999 for no/invalid priority)
+ */
+function extractPriority(labels, prefix, issueNumber) {
+    // Use stricter pattern matching: prefix must be followed by hyphen and digits
+    const pattern = new RegExp(`^${prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}-\\d+$`, 'i');
+    const priorityLabels = labels.filter(l => pattern.test(l));
+    if (priorityLabels.length === 0) {
+        return 999; // No priority label found
+    }
+    // Warn if multiple priority labels found
+    if (priorityLabels.length > 1) {
+        const issueRef = issueNumber ? `Issue #${issueNumber}` : 'An issue';
+        console.log(chalk.yellow(`⚠️  ${issueRef} has multiple priority labels: ${priorityLabels.join(', ')}. Using first match: ${priorityLabels[0]}`));
+    }
+    // Extract numeric part: "priority-1" → "1"
+    const match = priorityLabels[0].match(/-(\d+)$/);
+    if (!match) {
+        return 999; // Shouldn't happen with regex, but be safe
+    }
+    const numeric = parseInt(match[1], 10);
+    // Validate priority is in reasonable range (1-10)
+    // We allow up to 10 to be flexible, but typical range is 1-4
+    if (isNaN(numeric) || numeric < 1 || numeric > 10) {
+        const issueRef = issueNumber ? `Issue #${issueNumber}` : 'An issue';
+        console.log(chalk.yellow(`⚠️  ${issueRef} has invalid priority value: ${priorityLabels[0]}. Priority should be between 1-10.`));
+        return 999;
+    }
+    return numeric;
+}
+/**
+ * Sort issues according to strategy
+ *
+ * @param issues - Array of issues to sort
+ * @param options - Sort options including orderBy, direction, and priority config
+ * @returns Sorted array of issues
+ *
+ * @remarks
+ * Priority sorting has inverted direction semantics compared to date sorting:
+ *
+ * **Priority Sorting:**
+ * - `direction: 'desc'` (default) = Highest priority first = priority-1, priority-2, priority-3, ...
+ * - `direction: 'asc'` = Lowest priority first = priority-4, priority-3, priority-2, priority-1
+ *
+ * This is because "descending priority" means "descending importance" (highest first),
+ * which corresponds to ascending numeric values (1 < 2 < 3).
+ *
+ * **Date Sorting:**
+ * - `direction: 'desc'` = Newest first (standard descending chronological order)
+ * - `direction: 'asc'` = Oldest first (standard ascending chronological order)
+ */
+export function sortIssues(issues, options) {
+    const sorted = [...issues];
+    sorted.sort((a, b) => {
+        let comparison = 0;
+        if (options.orderBy === 'priority') {
+            // Pass issue numbers for better warning messages
+            const aPriority = extractPriority(a.labels, options.priorityConfig.labelPrefix, a.number);
+            const bPriority = extractPriority(b.labels, options.priorityConfig.labelPrefix, b.number);
+            comparison = aPriority - bPriority; // Lower number = higher priority
+            // For priority, direction is inverted:
+            // - desc (default) = highest priority first = lowest number first = use comparison as-is
+            // - asc = lowest priority first = highest number first = negate comparison
+            return options.direction === 'asc' ? -comparison : comparison;
+        }
+        else if (options.orderBy === 'created' && a.createdAt && b.createdAt) {
+            comparison = new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime();
+        }
+        else if (options.orderBy === 'updated' && a.updatedAt && b.updatedAt) {
+            comparison = new Date(a.updatedAt).getTime() - new Date(b.updatedAt).getTime();
+        }
+        // Apply direction for dates (standard: asc = oldest first, desc = newest first)
+        return options.direction === 'asc' ? comparison : -comparison;
+    });
+    return sorted;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractary/faber-cli",
-  "version": "1.3.14",
+  "version": "1.4.0",
   "description": "FABER CLI - Command-line interface for FABER development toolkit",
   "main": "dist/index.js",
   "bin": {