@proletariat/cli 0.3.34 → 0.3.35

package/dist/commands/ticket/template/delete.d.ts

@@ -0,0 +1,18 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketTemplateDelete extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+}

package/dist/commands/ticket/template/delete.js

@@ -0,0 +1,61 @@
+import { Args, Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../../lib/prompt-json.js';
+export default class TicketTemplateDelete extends PMOCommand {
+    static description = 'Delete a ticket template';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-template --force',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Template ID to delete',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip confirmation',
+            default: false,
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { args, flags } = await this.parse(TicketTemplateDelete);
+        const jsonMode = shouldOutputJson(flags);
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('ticket template delete', flags));
+            }
+            this.error(message);
+        };
+        const template = await this.storage.getTicketTemplate(args.id);
+        if (!template) {
+            return handleError('NOT_FOUND', `Ticket template not found: ${args.id}`);
+        }
+        if (template.isBuiltin) {
+            return handleError('BUILTIN', `Cannot delete built-in template "${template.name}".`);
+        }
+        if (!flags.force) {
+            const { confirm } = await this.prompt([{
+                    type: 'list',
+                    name: 'confirm',
+                    message: `Delete ticket template "${template.name}"?`,
+                    choices: [
+                        { name: 'No', value: false },
+                        { name: 'Yes', value: true },
+                    ],
+                }], jsonMode ? { flags, commandName: 'ticket template delete' } : null);
+            if (!confirm) {
+                this.log(styles.muted('Cancelled.'));
+                return;
+            }
+        }
+        await this.storage.deleteTicketTemplate(args.id);
+        this.log(styles.success(`\nDeleted template "${template.name}"`));
+    }
+}

package/dist/commands/ticket/template/list.d.ts

@@ -0,0 +1,17 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketTemplateList extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        builtin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        custom: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+    private printTemplate;
+}

package/dist/commands/ticket/template/list.js

@@ -0,0 +1,77 @@
+import { Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+export default class TicketTemplateList extends PMOCommand {
+    static description = 'List ticket templates';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --builtin',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        builtin: Flags.boolean({
+            description: 'Show only built-in templates',
+            exclusive: ['custom'],
+        }),
+        custom: Flags.boolean({
+            description: 'Show only custom templates',
+            exclusive: ['builtin'],
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { flags } = await this.parse(TicketTemplateList);
+        let builtinFilter;
+        if (flags.builtin)
+            builtinFilter = { isBuiltin: true };
+        if (flags.custom)
+            builtinFilter = { isBuiltin: false };
+        const templates = await this.storage.listTicketTemplates(builtinFilter);
+        if (flags.json) {
+            this.log(JSON.stringify(templates, null, 2));
+            return;
+        }
+        if (templates.length === 0) {
+            this.log(styles.muted('\nNo ticket templates found.'));
+            return;
+        }
+        this.log(`\n${styles.emphasis('Ticket Templates')}`);
+        this.log('═'.repeat(60));
+        const builtinTemplates = templates.filter(t => t.isBuiltin);
+        const customTemplates = templates.filter(t => !t.isBuiltin);
+        if (builtinTemplates.length > 0 && !flags.custom) {
+            this.log(`\n${styles.emphasis('Built-in Templates')}`);
+            this.log('─'.repeat(40));
+            for (const template of builtinTemplates) {
+                this.printTemplate(template);
+            }
+        }
+        if (customTemplates.length > 0 && !flags.builtin) {
+            this.log(`\n${styles.emphasis('Custom Templates')}`);
+            this.log('─'.repeat(40));
+            for (const template of customTemplates) {
+                this.printTemplate(template);
+            }
+        }
+        this.log('');
+    }
+    printTemplate(template) {
+        this.log(`  ${styles.emphasis(template.name)} ${styles.muted(`(${template.id})`)}`);
+        if (template.description) {
+            this.log(`    ${styles.muted(template.description)}`);
+        }
+        const details = [];
+        if (template.defaultPriority)
+            details.push(`Priority: ${template.defaultPriority}`);
+        if (template.defaultCategory)
+            details.push(`Category: ${template.defaultCategory}`);
+        if (template.suggestedSubtasks.length > 0)
+            details.push(`Subtasks: ${template.suggestedSubtasks.length}`);
+        if (details.length > 0) {
+            this.log(`    ${styles.muted(details.join(' | '))}`);
+        }
+    }
+}

package/dist/commands/ticket/template/save.d.ts

@@ -0,0 +1,17 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketTemplateSave extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        ticket: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        'template-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+}

package/dist/commands/ticket/template/save.js

@@ -0,0 +1,97 @@
+import { Flags, Args } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputPromptAsJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class TicketTemplateSave extends PMOCommand {
+    static description = 'Create a ticket template from an existing ticket';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 "Bug Report Template"',
+        '<%= config.bin %> <%= command.id %> TKT-042 "Feature Request" -d "Standard feature request"',
+    ];
+    static args = {
+        ticket: Args.string({
+            description: 'Ticket ID to create template from',
+            required: false,
+        }),
+        name: Args.string({
+            description: 'Template name',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        'template-name': Flags.string({
+            char: 'n',
+            description: 'Template name (alternative to positional arg)',
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'Template description',
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketTemplateSave);
+        const jsonMode = shouldOutputJson(flags);
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('ticket template save', flags));
+            }
+            this.error(message);
+        };
+        // Get ticket ID
+        let ticketId = args.ticket;
+        if (!ticketId) {
+            const projectId = await this.requireProject();
+            const tickets = await this.storage.listTickets(projectId);
+            if (tickets.length === 0) {
+                return handleError('NO_TICKETS', 'No tickets found. Create a ticket first.');
+            }
+            if (jsonMode) {
+                const choices = tickets.slice(0, 20).map(t => ({ name: `${t.id} - ${t.title}`, value: t.id }));
+                outputPromptAsJson(buildPromptConfig('list', 'ticket', 'Select ticket:', choices), createMetadata('ticket template save', flags));
+                return;
+            }
+            const { selected } = await this.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message: 'Select ticket:',
+                    choices: tickets.slice(0, 20).map(t => ({ name: `${t.id} - ${t.title}`, value: t.id })),
+                }], null);
+            ticketId = selected;
+        }
+        const ticket = await this.storage.getTicket(ticketId);
+        if (!ticket) {
+            return handleError('TICKET_NOT_FOUND', `Ticket not found: ${ticketId}`);
+        }
+        // Get template name
+        let templateName = flags['template-name'] || args.name;
+        if (!templateName) {
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('input', 'name', 'Template name:', undefined, ticket.category || ticket.title.split(' ')[0]), createMetadata('ticket template save', flags));
+                return;
+            }
+            const { name } = await this.prompt([{
+                    type: 'input',
+                    name: 'name',
+                    message: 'Template name:',
+                    default: ticket.category || ticket.title.split(' ')[0],
+                    validate: (i) => i.length > 0 || 'Required',
+                }], null);
+            templateName = name;
+        }
+        // Get description
+        let description = flags.description;
+        if (description === undefined && !jsonMode) {
+            const { desc } = await this.prompt([{ type: 'input', name: 'desc', message: 'Description (optional):' }], null);
+            description = desc || undefined;
+        }
+        const template = await this.storage.createTicketTemplateFromTicket(ticketId, templateName, description);
+        if (flags.json === true) {
+            outputSuccessAsJson({ template, sourceTicketId: ticketId }, createMetadata('ticket template save', flags));
+            return;
+        }
+        this.log(styles.success(`\nCreated template "${styles.emphasis(template.name)}" from ${ticketId}`));
+        this.log(styles.muted(`  ID: ${template.id}`));
+        this.log(styles.muted(`\nApply with: prlt ticket template apply ${template.id}`));
+    }
+}

package/dist/commands/ticket/view.d.ts

@@ -1,5 +1,6 @@
 import { PMOCommand } from '../../lib/pmo/index.js';
 export default class TicketView extends PMOCommand {
+    static aliases: string[];
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/ticket/view.js

@@ -3,6 +3,7 @@ import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class TicketView extends PMOCommand {
+    static aliases = ['ticket:show'];
     static description = 'View detailed ticket information';
     static examples = [
         '<%= config.bin %> <%= command.id %> TICK-001',

package/dist/commands/work/ready.js

@@ -254,6 +254,23 @@ export default class WorkReady extends PMOCommand {
         }
         try {
             const baseBranch = getDefaultBaseBranch();
+            // Check if PR already exists for this branch
+            const existingPR = getPRForBranch(currentBranch);
+            if (existingPR) {
+                if (existingPR.state === 'MERGED') {
+                    this.log(styles.muted(`   PR #${existingPR.number} already merged: ${existingPR.url}`));
+                    return existingPR.url;
+                }
+                if (existingPR.state === 'OPEN') {
+                    // Push any unpushed commits so the existing PR is up to date
+                    if (hasUnpushedCommits(currentBranch)) {
+                        this.log(styles.muted(`   Pushing unpushed commits to existing PR...`));
+                        pushBranch(currentBranch);
+                    }
+                    this.log(styles.muted(`   PR #${existingPR.number} already exists: ${existingPR.url}`));
+                    return existingPR.url;
+                }
+            }
             // Push branch if needed
             if (!hasBranchBeenPushed(currentBranch)) {
                 this.log(styles.muted(`   Pushing branch to origin...`));

package/dist/commands/work/resolve.js

@@ -26,7 +26,7 @@ export default class WorkResolve extends PMOCommand {
         }),
     };
     async execute() {
-        const { args, flags, argv } = await this.parse(WorkResolve);
+        const { flags, argv } = await this.parse(WorkResolve);
         const projectId = flags.project;
         const jsonMode = shouldOutputJson(flags);
         const handleError = (code, message) => {

package/dist/commands/work/spawn.js

@@ -491,18 +491,18 @@ export default class WorkSpawn extends PMOCommand {
                 let candidates = [...allTickets];
                 // Apply category filter
                 if (flags.category) {
-                    const categoryList = flags.category.split(',').map(c => c.trim().toLowerCase());
+                    const categoryList = new Set(flags.category.split(',').map(c => c.trim().toLowerCase()));
                     candidates = candidates.filter(t => {
                         const ticketCat = (t.category || '').toLowerCase();
-                        return categoryList.includes(ticketCat);
+                        return categoryList.has(ticketCat);
                     });
                 }
                 // Apply priority filter
                 if (flags.priority) {
-                    const priorityList = flags.priority.split(',').map(p => p.trim().toUpperCase());
+                    const priorityList = new Set(flags.priority.split(',').map(p => p.trim().toUpperCase()));
                     candidates = candidates.filter(t => {
                         const ticketPriority = (t.priority || '').toUpperCase();
-                        return priorityList.includes(ticketPriority);
+                        return priorityList.has(ticketPriority);
                     });
                 }
                 // Apply epic filter

package/dist/commands/work/start.d.ts

@@ -28,6 +28,7 @@ export default class WorkStart extends PMOCommand {
         focus: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         clone: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'use-api-key': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/work/start.js

@@ -1,3 +1,4 @@
+/* eslint-disable max-lines -- large command with many execution paths */
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -179,6 +180,11 @@ export default class WorkStart extends PMOCommand {
             description: 'Skip confirmation prompt (for non-TTY/scripted execution)',
             default: false,
         }),
+        'use-api-key': Flags.boolean({
+            description: 'Use ANTHROPIC_API_KEY for Docker containers instead of OAuth credentials',
+            default: false,
+            hidden: true,
+        }),
     };
     async execute() {
         const { args, flags } = await this.parse(WorkStart);
@@ -1000,8 +1006,10 @@ export default class WorkStart extends PMOCommand {
             // Default to interactive output mode (streaming UI)
             // Can be overridden via --output flag if needed
             const outputMode = flags.output || DEFAULT_EXECUTION_CONFIG.outputMode;
+            // Track whether user explicitly chose to use API key instead of OAuth
+            let useApiKey = flags['use-api-key'] || false;
             // Check Docker credentials for devcontainer environment
-            if (environment === 'devcontainer') {
+            if (environment === 'devcontainer' && !useApiKey) {
                 const hasCredentials = dockerCredentialsExist();
                 if (!hasCredentials) {
                     // In JSON mode with --yes, continue anyway (agent can run /login)
@@ -1009,10 +1017,19 @@ export default class WorkStart extends PMOCommand {
                         // Continue without prompting - agent will need to handle auth
                     }
                     else {
+                        const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
                         this.log('');
-                        this.log(styles.warning('⚠️  No Claude Code credentials found for Docker containers'));
-                        this.log(styles.muted('   Agents will fail with 401 authentication errors without credentials.'));
+                        this.log(styles.warning('⚠️  No Claude Code OAuth credentials found for Docker containers'));
+                        this.log(styles.muted('   Agents need credentials to authenticate with Claude.'));
                         this.log('');
+                        // Build choices based on available options
+                        const authChoices = [
+                            { name: `🔐 Run ${this.config.bin} agent auth now (recommended — uses Max subscription)`, value: 'auth' },
+                        ];
+                        if (hasApiKey) {
+                            authChoices.push({ name: '🔑 Use ANTHROPIC_API_KEY (⚠️  uses API credits, not Max subscription)', value: 'apikey' });
+                        }
+                        authChoices.push({ name: '💻 Switch to host environment instead', value: 'host' }, { name: '✗  Cancel', value: 'cancel' });
                         // Use FlagResolver for auth action
                         const authResolver = new FlagResolver({
                             commandName: 'work start',
@@ -1024,12 +1041,7 @@ export default class WorkStart extends PMOCommand {
                             flagName: 'authAction',
                             type: 'list',
                             message: 'What would you like to do?',
-                            choices: () => [
-                                { name: `🔐 Run ${this.config.bin} agent auth now (one-time setup)`, value: 'auth' },
-                                { name: '💻 Switch to host environment instead', value: 'host' },
-                                { name: '⏩ Continue anyway (must run /login in first agent)', value: 'continue' },
-                                { name: '✗  Cancel', value: 'cancel' },
-                            ],
+                            choices: () => authChoices,
                         });
                         const authResult = await authResolver.resolve();
                         const authAction = authResult.authAction;
@@ -1042,6 +1054,12 @@ export default class WorkStart extends PMOCommand {
                             environment = 'host';
                             this.log(styles.muted('Switched to host environment.'));
                         }
+                        else if (authAction === 'apikey') {
+                            useApiKey = true;
+                            this.log(styles.warning('Using ANTHROPIC_API_KEY — this will consume API credits.'));
+                            this.log(styles.muted(`Run "${this.config.bin} agent auth" to set up OAuth and use your Max subscription instead.`));
+                            this.log('');
+                        }
                         else if (authAction === 'auth') {
                             this.log('');
                             this.log(styles.primary(`Opening ${this.config.bin} agent auth in new tab...`));
@@ -1094,10 +1112,13 @@ export default class WorkStart extends PMOCommand {
                             }
                             this.log('');
                         }
-                        // authAction === 'continue' falls through
                     }
                 }
             }
+            // Pass API key preference to execution context
+            if (useApiKey) {
+                context.useApiKey = true;
+            }
             // Prompt for permissions mode (all environments)
             // Use FlagResolver to handle both JSON mode and interactive prompts consistently
             if (flags['permission-mode']) {
@@ -1611,23 +1632,30 @@ export default class WorkStart extends PMOCommand {
             const agentDir = path.join(workspaceInfo.agentsPath, agent.name);
             return hasDevcontainerConfig(agentDir) && !flags['run-on-host'];
         });
+        // Track whether user explicitly chose to use API key instead of OAuth
+        let batchUseApiKey = false;
         if (anyUseDevcontainer) {
             const hasCredentials = dockerCredentialsExist();
             if (!hasCredentials) {
+                const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
                 this.log('');
-                this.log(styles.warning('⚠️  No Claude Code credentials found for Docker containers'));
-                this.log(styles.muted('   Agents will fail with 401 authentication errors without credentials.'));
+                this.log(styles.warning('⚠️  No Claude Code OAuth credentials found for Docker containers'));
+                this.log(styles.muted('   Agents need credentials to authenticate with Claude.'));
                 this.log('');
+                // Build choices based on available options
+                const batchAuthChoices = [
+                    { name: `🔐 Run ${this.config.bin} agent auth now (recommended — uses Max subscription)`, value: 'auth', command: `${this.config.bin} agent auth` },
+                ];
+                if (hasApiKey) {
+                    batchAuthChoices.push({ name: '🔑 Use ANTHROPIC_API_KEY (⚠️  uses API credits, not Max subscription)', value: 'apikey', command: '' });
+                }
+                batchAuthChoices.push({ name: '💻 Run all agents on host instead (--run-on-host)', value: 'host', command: 'prlt work start --all --run-on-host --json' }, { name: '✗  Cancel', value: 'cancel', command: '' });
                 const { authAction } = await this.prompt([
                     {
                         type: 'list',
                         name: 'authAction',
                         message: 'What would you like to do?',
-                        choices: [
-                            { name: `🔐 Run ${this.config.bin} agent auth now (one-time setup)`, value: 'auth', command: `${this.config.bin} agent auth` },
-                            { name: '💻 Run all agents on host instead (--run-on-host)', value: 'host', command: 'prlt work start --all --run-on-host --json' },
-                            { name: '✗  Cancel', value: 'cancel', command: '' },
-                        ],
+                        choices: batchAuthChoices,
                     },
                 ], batchJsonModeConfig);
                 if (authAction === 'cancel') {
@@ -1639,6 +1667,12 @@ export default class WorkStart extends PMOCommand {
                     flags['run-on-host'] = true;
                     this.log(styles.muted('All agents will run on host.'));
                 }
+                else if (authAction === 'apikey') {
+                    batchUseApiKey = true;
+                    this.log(styles.warning('Using ANTHROPIC_API_KEY — this will consume API credits.'));
+                    this.log(styles.muted(`Run "${this.config.bin} agent auth" to set up OAuth and use your Max subscription instead.`));
+                    this.log('');
+                }
                 else if (authAction === 'auth') {
                     this.log('');
                     this.log(styles.primary(`Opening ${this.config.bin} agent auth in new tab...`));
@@ -1715,6 +1749,7 @@ export default class WorkStart extends PMOCommand {
                     '--display', flags.display || 'background',
                     ...(flags.executor ? ['--executor', flags.executor] : []),
                     ...(flags['run-on-host'] ? ['--run-on-host'] : []),
+                    ...(batchUseApiKey ? ['--use-api-key'] : []),
                     ...(flags.force ? ['--force'] : []),
                     '--permission-mode', batchPermissionMode,
                     ...(flags.clone ? ['--clone'] : []),

package/dist/lib/database/index.d.ts

@@ -52,7 +52,7 @@ export interface AgentWorktree {
     is_clean: boolean;
     last_checked?: string;
 }
-export declare const CREATE_TABLES_SQL = "\n-- Core workspace metadata\nCREATE TABLE IF NOT EXISTS workspace (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  type TEXT NOT NULL CHECK (type IN ('hq', 'workspace')),\n  workspace_name TEXT NOT NULL,\n  has_pmo BOOLEAN DEFAULT FALSE,\n  active_theme_id TEXT,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (active_theme_id) REFERENCES agent_themes(id) ON DELETE SET NULL\n);\n\n-- Repository management\nCREATE TABLE IF NOT EXISTS repositories (\n  name TEXT PRIMARY KEY,\n  path TEXT NOT NULL,\n  type TEXT DEFAULT 'main' CHECK (type IN ('main', 'dependency')),\n  source_url TEXT,\n  action TEXT CHECK (action IN ('clone', 'move', 'link')),\n  added_at TEXT NOT NULL\n);\n\n-- Agent naming themes (optional)\nCREATE TABLE IF NOT EXISTS agent_themes (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  display_name TEXT NOT NULL,\n  description TEXT,\n  builtin BOOLEAN DEFAULT FALSE,\n  created_at TEXT NOT NULL\n);\n\n-- Names available within each theme\nCREATE TABLE IF NOT EXISTS agent_theme_names (\n  theme_id TEXT NOT NULL,\n  name TEXT NOT NULL,\n  PRIMARY KEY (theme_id, name),\n  FOREIGN KEY (theme_id) REFERENCES agent_themes(id) ON DELETE CASCADE\n);\n\n-- Agent instances in workspace\nCREATE TABLE IF NOT EXISTS agents (\n  name TEXT PRIMARY KEY,\n  type TEXT NOT NULL DEFAULT 'persistent' CHECK (type IN ('persistent', 'ephemeral')),\n  status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active', 'cleaned')),\n  base_name TEXT,\n  theme_id TEXT,\n  worktree_path TEXT,\n  mount_mode TEXT NOT NULL DEFAULT 'worktree' CHECK (mount_mode IN ('worktree', 'clone')),\n  created_at TEXT NOT NULL,\n  cleaned_at TEXT,\n  FOREIGN KEY (theme_id) REFERENCES agent_themes(id) ON DELETE SET NULL\n);\n\n-- Agent-owned worktrees\nCREATE TABLE IF NOT EXISTS agent_worktrees (\n  agent_name TEXT NOT NULL,\n  repo_name TEXT NOT NULL,\n  worktree_path TEXT NOT NULL,\n  branch TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  PRIMARY KEY (agent_name, repo_name),\n  FOREIGN KEY (agent_name) REFERENCES agents(name) ON DELETE CASCADE,\n  FOREIGN KEY (repo_name) REFERENCES repositories(name) ON DELETE CASCADE\n);\n\n-- Workspace-level settings (key-value store)\nCREATE TABLE IF NOT EXISTS workspace_settings (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n);\n\n-- =============================================================================\n-- Indexes\n-- =============================================================================\n\nCREATE INDEX IF NOT EXISTS idx_worktrees_agent ON agent_worktrees(agent_name);\nCREATE INDEX IF NOT EXISTS idx_worktrees_repo ON agent_worktrees(repo_name);\nCREATE INDEX IF NOT EXISTS idx_theme_names_theme ON agent_theme_names(theme_id);\nCREATE INDEX IF NOT EXISTS idx_agents_theme ON agents(theme_id);\n";
+export declare const CREATE_TABLES_SQL = "\n-- Core workspace metadata\nCREATE TABLE IF NOT EXISTS workspace (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  type TEXT NOT NULL CHECK (type IN ('hq', 'workspace')),\n  workspace_name TEXT NOT NULL,\n  has_pmo BOOLEAN DEFAULT FALSE,\n  active_theme_id TEXT,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (active_theme_id) REFERENCES agent_themes(id) ON DELETE SET NULL\n);\n\n-- Repository management\nCREATE TABLE IF NOT EXISTS repositories (\n  name TEXT PRIMARY KEY,\n  path TEXT NOT NULL,\n  type TEXT DEFAULT 'main' CHECK (type IN ('main', 'dependency')),\n  source_url TEXT,\n  action TEXT CHECK (action IN ('clone', 'move', 'link')),\n  added_at TEXT NOT NULL\n);\n\n-- Agent naming themes (optional)\nCREATE TABLE IF NOT EXISTS agent_themes (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  display_name TEXT NOT NULL,\n  description TEXT,\n  builtin BOOLEAN DEFAULT FALSE,\n  created_at TEXT NOT NULL\n);\n\n-- Names available within each theme\nCREATE TABLE IF NOT EXISTS agent_theme_names (\n  theme_id TEXT NOT NULL,\n  name TEXT NOT NULL,\n  PRIMARY KEY (theme_id, name),\n  FOREIGN KEY (theme_id) REFERENCES agent_themes(id) ON DELETE CASCADE\n);\n\n-- Agent instances in workspace\nCREATE TABLE IF NOT EXISTS agents (\n  name TEXT PRIMARY KEY,\n  type TEXT NOT NULL DEFAULT 'persistent' CHECK (type IN ('persistent', 'ephemeral')),\n  status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active', 'cleaned')),\n  base_name TEXT,\n  theme_id TEXT,\n  worktree_path TEXT,\n  mount_mode TEXT NOT NULL DEFAULT 'worktree' CHECK (mount_mode IN ('worktree', 'clone')),\n  created_at TEXT NOT NULL,\n  cleaned_at TEXT,\n  FOREIGN KEY (theme_id) REFERENCES agent_themes(id) ON DELETE SET NULL\n);\n\n-- Agent-owned worktrees\nCREATE TABLE IF NOT EXISTS agent_worktrees (\n  agent_name TEXT NOT NULL,\n  repo_name TEXT NOT NULL,\n  worktree_path TEXT NOT NULL,\n  branch TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  last_commit_hash TEXT,\n  commits_ahead INTEGER NOT NULL DEFAULT 0,\n  is_clean INTEGER NOT NULL DEFAULT 1,\n  last_checked TEXT,\n  PRIMARY KEY (agent_name, repo_name),\n  FOREIGN KEY (agent_name) REFERENCES agents(name) ON DELETE CASCADE,\n  FOREIGN KEY (repo_name) REFERENCES repositories(name) ON DELETE CASCADE\n);\n\n-- Workspace-level settings (key-value store)\nCREATE TABLE IF NOT EXISTS workspace_settings (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n);\n\n-- =============================================================================\n-- Indexes\n-- =============================================================================\n\nCREATE INDEX IF NOT EXISTS idx_worktrees_agent ON agent_worktrees(agent_name);\nCREATE INDEX IF NOT EXISTS idx_worktrees_repo ON agent_worktrees(repo_name);\nCREATE INDEX IF NOT EXISTS idx_theme_names_theme ON agent_theme_names(theme_id);\nCREATE INDEX IF NOT EXISTS idx_agents_theme ON agents(theme_id);\n";
 /**
  * Get the database path for a workspace
  */

package/dist/lib/database/index.js

@@ -64,6 +64,10 @@ CREATE TABLE IF NOT EXISTS agent_worktrees (
   worktree_path TEXT NOT NULL,
   branch TEXT NOT NULL,
   created_at TEXT NOT NULL,
+  last_commit_hash TEXT,
+  commits_ahead INTEGER NOT NULL DEFAULT 0,
+  is_clean INTEGER NOT NULL DEFAULT 1,
+  last_checked TEXT,
   PRIMARY KEY (agent_name, repo_name),
   FOREIGN KEY (agent_name) REFERENCES agents(name) ON DELETE CASCADE,
   FOREIGN KEY (repo_name) REFERENCES repositories(name) ON DELETE CASCADE
@@ -184,6 +188,22 @@ export function openWorkspaceDatabase(workspacePath) {
     catch {
         // Ignore migration errors - table might not exist yet
     }
+    // Migration: add missing columns to agent_worktrees table (TKT-1014)
+    try {
+        const worktreesTableExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='agent_worktrees'").get();
+        if (worktreesTableExists) {
+            const worktreeTableInfo = db.prepare("PRAGMA table_info(agent_worktrees)").all();
+            if (!worktreeTableInfo.some(col => col.name === 'commits_ahead')) {
+                db.exec("ALTER TABLE agent_worktrees ADD COLUMN last_commit_hash TEXT");
+                db.exec("ALTER TABLE agent_worktrees ADD COLUMN commits_ahead INTEGER NOT NULL DEFAULT 0");
+                db.exec("ALTER TABLE agent_worktrees ADD COLUMN is_clean INTEGER NOT NULL DEFAULT 1");
+                db.exec("ALTER TABLE agent_worktrees ADD COLUMN last_checked TEXT");
+            }
+        }
+    }
+    catch {
+        // Ignore migration errors - table might not exist yet or columns already exist
+    }
     // Migration: add mount_mode column to agents table (TKT-686)
     try {
         const agentsTableInfo = db.prepare("PRAGMA table_info(agents)").all();

package/dist/lib/execution/devcontainer.js

@@ -96,7 +96,9 @@ export function generateDevcontainerJson(options, config) {
         mounts,
         containerEnv: {
             DEVCONTAINER: 'true',
-            ANTHROPIC_API_KEY: '${localEnv:ANTHROPIC_API_KEY}',
+            // NOTE: ANTHROPIC_API_KEY is intentionally NOT passed by default.
+            // Claude Code prefers API key over OAuth, so passing it would cause agents
+            // to burn API credits instead of using Max subscription via OAuth.
             // GH_TOKEN enables gh CLI in container (for PR creation, etc.)
             GH_TOKEN: '${localEnv:GH_TOKEN}',
             GITHUB_TOKEN: '${localEnv:GITHUB_TOKEN}',

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

@@ -46,8 +46,13 @@ export declare function configureITermTmuxWindowMode(mode: 'tab' | 'window'): vo
  */
 export declare function credentialsVolumeExists(): boolean;
 /**
- * Check if valid Claude credentials exist in the Docker volume.
- * Returns true if credentials exist and are not expired.
+ * Check if valid Claude OAuth credentials exist in the Docker volume.
+ * Returns true if OAuth credentials are stored (even if access token is expired,
+ * since Claude Code handles refresh internally using stored refresh tokens).
+ *
+ * NOTE: This intentionally does NOT check for ANTHROPIC_API_KEY. If the user
+ * has an API key but no OAuth credentials, we want to prompt them to set up
+ * OAuth (which uses their Max subscription) rather than silently burning API credits.
  */
 export declare function dockerCredentialsExist(): boolean;
 /**