ticket-to-pr 1.2.1 → 1.3.0

package/README.md

@@ -212,6 +212,8 @@ ticket-to-pr --dry-run --once
 |----------------|----------|
 | `init` | Guided setup — validates Notion credentials live, auto-detects build commands, generates starter `CLAUDE.md`, configures projects, writes `.env.local` and `projects.json`. Detects existing config on re-run. |
 | `doctor` | Diagnostic check — verifies environment, Notion connectivity, database schema, tools, and projects |
+| `model` | View current models and available options |
+| `model <review\|execute\|both> <model>` | Set the Claude model for an agent. Accepts aliases (`opus`, `sonnet`, `haiku`) or full model IDs. |
 | *(none)* | Continuous polling every 30s |
 | `--once` | Poll once, wait for agents to finish, exit |
 | `--dry-run` | Poll and log what would happen, don't run agents |
@@ -289,7 +291,7 @@ Environment:
   ○ LICENSE_KEY               Free tier
 
 Models:
-  ✓ Review model              claude-sonnet-4-5-20250929
+  ✓ Review model              claude-sonnet-4-6
   ✓ Execute model             claude-opus-4-6
 
 Notion:
@@ -320,6 +322,35 @@ Docs: https://www.tickettopr.com
 - `gh` missing is a warning (PRs won't auto-create but everything else works), `claude` missing is a hard failure
 - Exits with code 1 if any hard failures, 0 otherwise
 
+### `model` — Change AI Models
+
+View or change which Claude models the agents use:
+
+```bash
+# Show current models and available options
+ticket-to-pr model
+
+# Set review model (used for scoring tickets)
+ticket-to-pr model review sonnet
+
+# Set execute model (used for writing code)
+ticket-to-pr model execute opus
+
+# Set both at once
+ticket-to-pr model both haiku
+```
+
+Available model aliases:
+
+| Alias | Model ID | Best for |
+|-------|----------|----------|
+| `opus` | `claude-opus-4-6` | Best quality (recommended for execute) |
+| `sonnet` | `claude-sonnet-4-6` | Fast and capable (recommended for review) |
+| `sonnet45` | `claude-sonnet-4-5-20250929` | Previous generation Sonnet |
+| `haiku` | `claude-haiku-4-5-20251001` | Fastest, lowest cost |
+
+You can also pass a full model ID directly (e.g. `ticket-to-pr model review claude-sonnet-4-5-20250929`). Changes are saved to `.env.local` and take effect on the next poll cycle.
+
 ### Your First Ticket
 
 1. Click **"+ New"** on your Notion board
@@ -481,6 +512,8 @@ All settings in `config.ts`:
 
 | Setting | Default | Purpose |
 |---------|---------|---------|
+| `REVIEW_MODEL` | `claude-sonnet-4-6` | Review agent model (change with `ticket-to-pr model review <model>`) |
+| `EXECUTE_MODEL` | `claude-opus-4-6` | Execute agent model (change with `ticket-to-pr model execute <model>`) |
 | `POLL_INTERVAL_MS` | 30000 | How often to check Notion (ms) |
 | `REVIEW_BUDGET_USD` | 2.00 | Max USD per review agent run |
 | `EXECUTE_BUDGET_USD` | 15.00 | Max USD per execute agent run |
@@ -505,7 +538,7 @@ Project configuration in `projects.json`:
 ```
 ticket-to-pr/
   index.ts              # Poll loop, agent runner, worktree git workflow, graceful shutdown
-  cli.ts                # init (guided setup with validation) and doctor (diagnostic + schema check)
+  cli.ts                # init, doctor, and model commands
   config.ts             # Budgets, column names, license check, TypeScript types
   projects.json         # Your project directories and build commands (git-ignored, copy from example)
   projects.example.json # Template for projects.json

package/dist/cli.d.ts

@@ -1,2 +1,3 @@
 export declare function runDoctor(): Promise<void>;
 export declare function runInit(): Promise<void>;
+export declare function runModel(args: string[]): Promise<void>;

package/dist/cli.js

@@ -2,7 +2,7 @@ import { createInterface } from 'node:readline';
 import { execSync } from 'node:child_process';
 import { readFileSync, existsSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { mask, shellEscape, writeEnvFile, updateProjectsFile, getDefaultBranch } from './lib/utils.js';
+import { mask, shellEscape, writeEnvFile, updateProjectsFile, getDefaultBranch, parseEnvFile } from './lib/utils.js';
 import { getProjectNames, getProjectDir, getBaseBranch, getBlockedFiles, getSkipPR } from './lib/projects.js';
 import { CONFIG_DIR } from './lib/paths.js';
 // -- Colors --
@@ -624,7 +624,7 @@ export async function runInit() {
         console.log(`  ${DIM}Choose which Claude model each agent uses.${RESET}`);
         console.log(`  ${DIM}Sonnet = fast/cheap, Opus = best quality, Haiku = fastest/cheapest${RESET}\n`);
         const modelChoices = [
-            { label: 'sonnet', id: 'claude-sonnet-4-5-20250929' },
+            { label: 'sonnet', id: 'claude-sonnet-4-6' },
             { label: 'opus', id: 'claude-opus-4-6' },
             { label: 'haiku', id: 'claude-haiku-4-5-20251001' },
         ];
@@ -768,3 +768,84 @@ export async function runInit() {
         rl.close();
     }
 }
+// -- Model --
+const KNOWN_MODELS = [
+    { alias: 'opus', id: 'claude-opus-4-6', description: 'Best quality, highest cost' },
+    { alias: 'sonnet', id: 'claude-sonnet-4-6', description: 'Fast and capable (recommended for review)' },
+    { alias: 'sonnet45', id: 'claude-sonnet-4-5-20250929', description: 'Previous generation Sonnet' },
+    { alias: 'haiku', id: 'claude-haiku-4-5-20251001', description: 'Fastest, lowest cost' },
+];
+function resolveModel(input) {
+    const lower = input.toLowerCase();
+    const byAlias = KNOWN_MODELS.find((m) => m.alias === lower);
+    if (byAlias)
+        return byAlias;
+    const byId = KNOWN_MODELS.find((m) => m.id === lower);
+    if (byId)
+        return byId;
+    // Accept any claude- prefixed model ID as a pass-through
+    if (input.startsWith('claude-'))
+        return { alias: input, id: input };
+    return null;
+}
+export async function runModel(args) {
+    const envPath = join(CONFIG_DIR, '.env.local');
+    const envVars = parseEnvFile(envPath);
+    const currentReview = envVars.REVIEW_MODEL || 'claude-sonnet-4-6';
+    const currentExecute = envVars.EXECUTE_MODEL || 'claude-opus-4-6';
+    // No args: show current models and available options
+    if (args.length === 0) {
+        console.log(`\n${BOLD}Current models:${RESET}`);
+        const reviewAlias = KNOWN_MODELS.find((m) => m.id === currentReview)?.alias;
+        const executeAlias = KNOWN_MODELS.find((m) => m.id === currentExecute)?.alias;
+        console.log(`  Review:   ${GREEN}${currentReview}${RESET}${reviewAlias ? ` (${reviewAlias})` : ''}`);
+        console.log(`  Execute:  ${GREEN}${currentExecute}${RESET}${executeAlias ? ` (${executeAlias})` : ''}`);
+        console.log(`\n${BOLD}Available models:${RESET}`);
+        for (const m of KNOWN_MODELS) {
+            console.log(`  ${BOLD}${m.alias.padEnd(10)}${RESET} ${DIM}${m.id.padEnd(35)}${RESET} ${m.description}`);
+        }
+        console.log(`\n${BOLD}Usage:${RESET}`);
+        console.log(`  ticket-to-pr model review sonnet     ${DIM}# set review model${RESET}`);
+        console.log(`  ticket-to-pr model execute opus       ${DIM}# set execute model${RESET}`);
+        console.log(`  ticket-to-pr model both haiku         ${DIM}# set both at once${RESET}\n`);
+        return;
+    }
+    // Parse: model <agent> <model>
+    if (args.length < 2) {
+        console.log(`${RED}Usage: ticket-to-pr model <review|execute|both> <model>${RESET}`);
+        console.log(`${DIM}Run "ticket-to-pr model" to see available models.${RESET}`);
+        process.exitCode = 1;
+        return;
+    }
+    const agent = args[0].toLowerCase();
+    const modelInput = args[1];
+    if (!['review', 'execute', 'both'].includes(agent)) {
+        console.log(`${RED}Unknown agent "${args[0]}". Use: review, execute, or both${RESET}`);
+        process.exitCode = 1;
+        return;
+    }
+    const resolved = resolveModel(modelInput);
+    if (!resolved) {
+        console.log(`${RED}Unknown model "${modelInput}".${RESET}`);
+        console.log(`\n${BOLD}Available models:${RESET}`);
+        for (const m of KNOWN_MODELS) {
+            console.log(`  ${BOLD}${m.alias.padEnd(10)}${RESET} ${DIM}${m.id}${RESET}`);
+        }
+        console.log(`\n${DIM}You can also pass a full model ID like claude-sonnet-4-5-20250929${RESET}`);
+        process.exitCode = 1;
+        return;
+    }
+    const updates = {};
+    if (agent === 'review' || agent === 'both')
+        updates.REVIEW_MODEL = resolved.id;
+    if (agent === 'execute' || agent === 'both')
+        updates.EXECUTE_MODEL = resolved.id;
+    writeEnvFile(envPath, updates);
+    if (updates.REVIEW_MODEL) {
+        printStatus(true, 'Review model', `${resolved.id}${resolved.alias !== resolved.id ? ` (${resolved.alias})` : ''}`);
+    }
+    if (updates.EXECUTE_MODEL) {
+        printStatus(true, 'Execute model', `${resolved.id}${resolved.alias !== resolved.id ? ` (${resolved.alias})` : ''}`);
+    }
+    console.log(`${DIM}Saved to .env.local. Takes effect on next poll cycle.${RESET}\n`);
+}

package/dist/config.js

@@ -48,7 +48,7 @@ export const CONFIG = {
     EXECUTE_BUDGET_USD: 15.00,
     // Agent models (env override → default)
     get REVIEW_MODEL() {
-        return process.env.REVIEW_MODEL || 'claude-sonnet-4-5-20250929';
+        return process.env.REVIEW_MODEL || 'claude-sonnet-4-6';
     },
     get EXECUTE_MODEL() {
         return process.env.EXECUTE_MODEL || 'claude-opus-4-6';

package/dist/index.js

@@ -13,9 +13,14 @@ loadEnv(join(CONFIG_DIR, '.env.local'));
 delete process.env.CLAUDECODE;
 // -- Subcommand routing --
 const subcommand = process.argv[2];
-if (subcommand === 'init' || subcommand === 'doctor') {
-    const { runInit, runDoctor } = await import('./cli.js');
-    await (subcommand === 'init' ? runInit() : runDoctor());
+if (subcommand === 'init' || subcommand === 'doctor' || subcommand === 'model') {
+    const { runInit, runDoctor, runModel } = await import('./cli.js');
+    if (subcommand === 'model') {
+        await runModel(process.argv.slice(3));
+    }
+    else {
+        await (subcommand === 'init' ? runInit() : runDoctor());
+    }
     process.exit(0);
 }
 // -- CLI flags --

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticket-to-pr",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Drag a Notion ticket, get a pull request. AI-powered dev automation.",
   "type": "module",
   "bin": {
@@ -13,6 +13,22 @@
     "projects.example.json",
     "README.md"
   ],
+  "homepage": "https://www.tickettopr.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JohnRiceML/ticket-to-pr.git"
+  },
+  "bugs": {
+    "url": "https://github.com/JohnRiceML/ticket-to-pr/issues"
+  },
+  "keywords": [
+    "notion",
+    "claude",
+    "ai",
+    "pull-request",
+    "automation",
+    "developer-tools"
+  ],
   "engines": {
     "node": ">=18.0.0"
   },