@proletariat/cli 0.1.4 → 0.3.0

package/dist/lib/branch/index.js

@@ -0,0 +1,334 @@
+/**
+ * Branch Utilities
+ *
+ * Utilities for creating and validating conventional branch names.
+ * Format: {type}/{coder}/{description} or {type}/{description}
+ */
+import { execSync } from 'node:child_process';
+// =============================================================================
+// Branch Types
+// =============================================================================
+export const BRANCH_TYPES = {
+    // Conventional Commits (standard types)
+    feat: 'New feature',
+    fix: 'Bug fix',
+    rfct: 'Refactoring (no functional change)',
+    docs: 'Documentation only',
+    test: 'Test additions or corrections',
+    chore: 'Maintenance tasks, no production code',
+    perf: 'Performance improvement',
+    ci: 'CI/CD configuration changes',
+    build: 'Build system or external dependency changes',
+    // Extended Types (proletariat extras)
+    sec: 'Security fixes or improvements',
+    db: 'Database migrations or schema changes',
+    rel: 'Release preparation',
+    // 5Tool Founder Types
+    ship: 'Shipping, deployment, and launch',
+    grow: 'Growth and marketing initiatives',
+    cx: 'Customer experience and support',
+    strat: 'Strategy and planning',
+    ops: 'Business operations',
+};
+// Conventional Commits (standard types)
+export const CONVENTIONAL_TYPES = [
+    'feat', 'fix', 'rfct', 'docs', 'test', 'chore', 'perf', 'ci', 'build'
+];
+// Extended Types (proletariat extras)
+export const EXTENDED_TYPES = [
+    'sec', 'db', 'rel'
+];
+// 5Tool Founder Types
+export const FOUNDER_TYPES = [
+    'ship', 'grow', 'cx', 'strat', 'ops'
+];
+// Combined for wizard display
+export const DEVELOPMENT_TYPES = [...CONVENTIONAL_TYPES, ...EXTENDED_TYPES];
+export const BUSINESS_TYPES = FOUNDER_TYPES;
+// =============================================================================
+// Validation
+// =============================================================================
+const KEBAB_CASE_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+export function isKebabCase(str) {
+    return KEBAB_CASE_REGEX.test(str);
+}
+export function isValidBranchType(type) {
+    return type in BRANCH_TYPES;
+}
+// Ticket ID pattern (e.g., TKT-001, PROJ-123)
+const TICKET_ID_REGEX = /^[A-Z]+-\d+$/;
+/**
+ * Check if a string looks like a ticket ID.
+ */
+export function isTicketId(str) {
+    return TICKET_ID_REGEX.test(str);
+}
+/**
+ * Parse and validate a branch name against conventional format.
+ *
+ * Supported formats:
+ * - {ticketId}/{type}/{owner}/{agent}/{description} - full format with ticket
+ * - {ticketId}/{type}/{owner}/{description} - ticket format without agent (manual)
+ * - {type}/{owner}/{description} - legacy format without ticket
+ * - {type}/{description} - minimal format
+ */
+export function validateBranchName(name) {
+    const parts = name.split('/');
+    if (parts.length < 2 || parts.length > 5) {
+        return {
+            valid: false,
+            error: 'Branch name must have 2-5 parts separated by /',
+        };
+    }
+    // Check if first part is a ticket ID
+    const hasTicket = isTicketId(parts[0]);
+    if (hasTicket) {
+        // Ticket-first format: {ticketId}/{type}/{owner}/{agent?}/{description}
+        const ticketId = parts[0];
+        const type = parts[1];
+        if (!isValidBranchType(type)) {
+            return {
+                valid: false,
+                error: `Unknown branch type: "${type}". Valid types: ${Object.keys(BRANCH_TYPES).join(', ')}`,
+            };
+        }
+        if (parts.length === 3) {
+            // {ticketId}/{type}/{description}
+            return {
+                valid: true,
+                parts: { ticketId, type: type, description: parts[2] },
+            };
+        }
+        if (parts.length === 4) {
+            // {ticketId}/{type}/{owner}/{description}
+            return {
+                valid: true,
+                parts: { ticketId, type: type, owner: parts[2], description: parts[3] },
+            };
+        }
+        if (parts.length === 5) {
+            // {ticketId}/{type}/{owner}/{agent}/{description}
+            return {
+                valid: true,
+                parts: { ticketId, type: type, owner: parts[2], agent: parts[3], description: parts[4] },
+            };
+        }
+        return {
+            valid: false,
+            error: 'Invalid ticket branch format. Expected: {ticketId}/{type}/{owner}/{description} or {ticketId}/{type}/{owner}/{agent}/{description}',
+        };
+    }
+    // Legacy format without ticket: {type}/{owner?}/{description}
+    const type = parts[0];
+    if (!isValidBranchType(type)) {
+        return {
+            valid: false,
+            error: `Unknown branch type: "${type}". Valid types: ${Object.keys(BRANCH_TYPES).join(', ')}`,
+        };
+    }
+    if (parts.length === 2) {
+        // {type}/{description}
+        const description = parts[1];
+        if (!isKebabCase(description)) {
+            return {
+                valid: false,
+                error: `Description must be kebab-case: "${description}"`,
+            };
+        }
+        return {
+            valid: true,
+            parts: { type: type, description },
+        };
+    }
+    // {type}/{owner}/{description}
+    const owner = parts[1];
+    const description = parts[2];
+    if (!isKebabCase(owner)) {
+        return {
+            valid: false,
+            error: `Owner name must be kebab-case: "${owner}"`,
+        };
+    }
+    if (!isKebabCase(description)) {
+        return {
+            valid: false,
+            error: `Description must be kebab-case: "${description}"`,
+        };
+    }
+    return {
+        valid: true,
+        parts: { type: type, owner, description },
+    };
+}
+/**
+ * Build a branch name from parts.
+ *
+ * Formats:
+ * - With ticket + agent: {ticketId}/{type}/{owner}/{agent}/{description}
+ * - With ticket (manual): {ticketId}/{type}/{owner}/{description}
+ * - Without ticket: {type}/{owner}/{description}
+ * - Minimal: {type}/{description}
+ */
+export function buildBranchName(type, description, options) {
+    const { ticketId, owner, agent } = options || {};
+    if (ticketId) {
+        // Ticket-first format
+        if (agent && owner) {
+            return `${ticketId}/${type}/${owner}/${agent}/${description}`;
+        }
+        if (owner) {
+            return `${ticketId}/${type}/${owner}/${description}`;
+        }
+        return `${ticketId}/${type}/${description}`;
+    }
+    // Legacy format without ticket
+    if (owner) {
+        return `${type}/${owner}/${description}`;
+    }
+    return `${type}/${description}`;
+}
+/**
+ * Convert a string to kebab-case.
+ */
+export function toKebabCase(str) {
+    return str
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Get current branch name.
+ */
+export function getCurrentBranch(cwd) {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all branches with parsed info.
+ */
+export function listBranches(cwd, includeRemote = false) {
+    try {
+        const args = includeRemote ? '-a' : '';
+        const output = execSync(`git branch ${args} --format="%(refname:short)|%(upstream:short)|%(HEAD)"`, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const branches = [];
+        for (const line of output.trim().split('\n')) {
+            if (!line)
+                continue;
+            const [name, tracking, head] = line.split('|');
+            const current = head === '*';
+            // Parse conventional parts
+            const validation = validateBranchName(name);
+            branches.push({
+                name,
+                current,
+                ticketId: validation.parts?.ticketId,
+                type: validation.parts?.type,
+                owner: validation.parts?.owner,
+                agent: validation.parts?.agent,
+                description: validation.parts?.description,
+                tracking: tracking || undefined,
+            });
+        }
+        return branches;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Check if a branch exists.
+ */
+export function branchExists(name, cwd) {
+    try {
+        execSync(`git rev-parse --verify ${name}`, {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a new branch.
+ * @param startPoint - Optional starting point (e.g., 'origin/main')
+ */
+export function createBranch(name, cwd, checkout = true, startPoint) {
+    const startArg = startPoint ? ` ${startPoint}` : '';
+    if (checkout) {
+        execSync(`git checkout -b ${name}${startArg}`, {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    else {
+        execSync(`git branch ${name}${startArg}`, {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+}
+/**
+ * Fetch from origin.
+ */
+export function fetchOrigin(ref, cwd) {
+    try {
+        const refArg = ref ? ` ${ref}` : '';
+        execSync(`git fetch origin${refArg}`, {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Switch to an existing branch.
+ */
+export function checkoutBranch(name, cwd) {
+    execSync(`git checkout ${name}`, {
+        cwd,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+}
+/**
+ * Create an empty commit.
+ */
+export function createEmptyCommit(message, cwd) {
+    execSync(`git commit --allow-empty -m "${message.replace(/"/g, '\\"')}"`, {
+        cwd,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+}
+/**
+ * Check if in a git repository.
+ */
+export function isGitRepo(cwd) {
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/lib/colors.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Centralized color scheme for consistent, readable output across all commands
+ * Optimized for both light and dark terminal backgrounds
+ */
+import chalk from 'chalk';
+export declare const colors: {
+    primary: chalk.Chalk;
+    success: chalk.Chalk;
+    error: chalk.Chalk;
+    warning: chalk.Chalk;
+    text: chalk.Chalk;
+    textBold: chalk.Chalk;
+    textSecondary: chalk.Chalk;
+    textMuted: chalk.Chalk;
+    active: chalk.Chalk;
+    inactive: chalk.Chalk;
+    pending: chalk.Chalk;
+    code: chalk.Chalk;
+    path: chalk.Chalk;
+    command: chalk.Chalk;
+    agentName: chalk.Chalk;
+    repoClean: chalk.Chalk;
+    repoDirty: chalk.Chalk;
+    repoMissing: chalk.Chalk;
+    commitsAhead: chalk.Chalk;
+    selected: chalk.Chalk;
+    unselected: chalk.Chalk;
+    disabled: chalk.Chalk;
+    icon: chalk.Chalk;
+    separator: chalk.Chalk;
+    highlight: chalk.Chalk;
+    attention: chalk.Chalk;
+};
+export declare const format: {
+    title: (text: string) => string;
+    subtitle: (text: string) => string;
+    success: (text: string) => string;
+    error: (text: string) => string;
+    warning: (text: string) => string;
+    info: (text: string) => string;
+    agentActive: (name: string) => string;
+    agentInactive: (name: string) => string;
+    repoStatus: (name: string, status: "clean" | "dirty" | "missing", commits?: number) => string;
+    command: (text: string) => string;
+    path: (text: string) => string;
+    listItem: (text: string, indent?: number) => string;
+    listSubItem: (text: string, indent?: number) => string;
+};
+declare const _default: {
+    colors: {
+        primary: chalk.Chalk;
+        success: chalk.Chalk;
+        error: chalk.Chalk;
+        warning: chalk.Chalk;
+        text: chalk.Chalk;
+        textBold: chalk.Chalk;
+        textSecondary: chalk.Chalk;
+        textMuted: chalk.Chalk;
+        active: chalk.Chalk;
+        inactive: chalk.Chalk;
+        pending: chalk.Chalk;
+        code: chalk.Chalk;
+        path: chalk.Chalk;
+        command: chalk.Chalk;
+        agentName: chalk.Chalk;
+        repoClean: chalk.Chalk;
+        repoDirty: chalk.Chalk;
+        repoMissing: chalk.Chalk;
+        commitsAhead: chalk.Chalk;
+        selected: chalk.Chalk;
+        unselected: chalk.Chalk;
+        disabled: chalk.Chalk;
+        icon: chalk.Chalk;
+        separator: chalk.Chalk;
+        highlight: chalk.Chalk;
+        attention: chalk.Chalk;
+    };
+    format: {
+        title: (text: string) => string;
+        subtitle: (text: string) => string;
+        success: (text: string) => string;
+        error: (text: string) => string;
+        warning: (text: string) => string;
+        info: (text: string) => string;
+        agentActive: (name: string) => string;
+        agentInactive: (name: string) => string;
+        repoStatus: (name: string, status: "clean" | "dirty" | "missing", commits?: number) => string;
+        command: (text: string) => string;
+        path: (text: string) => string;
+        listItem: (text: string, indent?: number) => string;
+        listSubItem: (text: string, indent?: number) => string;
+    };
+};
+export default _default;

package/dist/lib/colors.js

@@ -0,0 +1,68 @@
+/**
+ * Centralized color scheme for consistent, readable output across all commands
+ * Optimized for both light and dark terminal backgrounds
+ */
+import chalk from 'chalk';
+export const colors = {
+    // Primary colors - highly visible
+    primary: chalk.cyan,
+    success: chalk.green,
+    error: chalk.red,
+    warning: chalk.yellow,
+    // Text colors - guaranteed readable
+    text: chalk.white,
+    textBold: chalk.bold.white,
+    textSecondary: chalk.cyan,
+    textMuted: chalk.dim,
+    // Status indicators
+    active: chalk.green,
+    inactive: chalk.red,
+    pending: chalk.yellow,
+    // Special elements
+    code: chalk.bold.white.bgBlue,
+    path: chalk.bold.cyan,
+    command: chalk.bold.white,
+    // Agent-specific
+    agentName: chalk.bold.cyan,
+    // Repository status
+    repoClean: chalk.green,
+    repoDirty: chalk.yellow,
+    repoMissing: chalk.red,
+    commitsAhead: chalk.blue,
+    // Interactive elements
+    selected: chalk.bold.cyan,
+    unselected: chalk.white,
+    disabled: chalk.dim,
+    // Icons and decorations
+    icon: chalk.white,
+    separator: chalk.dim,
+    // Background highlights
+    highlight: chalk.bgBlue.white,
+    attention: chalk.bgYellow.black
+};
+// Utility functions for common patterns
+export const format = {
+    title: (text) => colors.primary.bold(`\n${text}\n`),
+    subtitle: (text) => colors.textSecondary(`${text}`),
+    success: (text) => `${colors.success('✅')} ${colors.text(text)}`,
+    error: (text) => `${colors.error('❌')} ${colors.text(text)}`,
+    warning: (text) => `${colors.warning('⚠️')} ${colors.text(text)}`,
+    info: (text) => `${colors.primary('ℹ️')} ${colors.text(text)}`,
+    // Agent-specific formatters
+    agentActive: (name) => `${colors.success('🟢')} ${colors.agentName(name)} - ${colors.active('Active')}`,
+    agentInactive: (name) => `${colors.error('🔴')} ${colors.agentName(name)} - ${colors.inactive('Inactive')}`,
+    // Repository formatters
+    repoStatus: (name, status, commits) => {
+        const statusColor = status === 'clean' ? colors.repoClean :
+            status === 'dirty' ? colors.repoDirty : colors.repoMissing;
+        const commitsText = commits ? ` ${colors.commitsAhead(`(+${commits})`)}` : '';
+        return `${colors.text(`• ${name}`)} ${statusColor(`(${status})`)}${commitsText}`;
+    },
+    // Command formatters
+    command: (text) => colors.command(`  ${text}`),
+    path: (text) => colors.path(text),
+    // List item formatters
+    listItem: (text, indent = 2) => colors.text(`${' '.repeat(indent)}${text}`),
+    listSubItem: (text, indent = 4) => colors.textSecondary(`${' '.repeat(indent)}${text}`)
+};
+export default { colors, format };

package/dist/lib/commands/docker-command.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+/**
+ * Base command class for commands that require Docker.
+ *
+ * Automatically checks if Docker daemon is running before the command executes.
+ * If Docker is not available, exits with a clear error message.
+ *
+ * Usage:
+ * ```typescript
+ * import { DockerCommand } from '../../lib/commands/docker-command.js'
+ *
+ * export default class MyCommand extends DockerCommand {
+ *   async run() {
+ *     // Docker is guaranteed to be running here
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class DockerCommand extends Command {
+    init(): Promise<void>;
+}

package/dist/lib/commands/docker-command.js

@@ -0,0 +1,27 @@
+import { Command } from '@oclif/core';
+import { isDockerRunning } from '../execution/runners.js';
+/**
+ * Base command class for commands that require Docker.
+ *
+ * Automatically checks if Docker daemon is running before the command executes.
+ * If Docker is not available, exits with a clear error message.
+ *
+ * Usage:
+ * ```typescript
+ * import { DockerCommand } from '../../lib/commands/docker-command.js'
+ *
+ * export default class MyCommand extends DockerCommand {
+ *   async run() {
+ *     // Docker is guaranteed to be running here
+ *   }
+ * }
+ * ```
+ */
+export class DockerCommand extends Command {
+    async init() {
+        await super.init();
+        if (!isDockerRunning()) {
+            this.error('Docker is not running. Please start Docker Desktop and try again.');
+        }
+    }
+}