feat: linear interactive wizard command (#271)

* feat(wizard): add shared wizard utilities (credential prompt, browse-or-url)

Shared utilities for integration wizards:
- ensureCredentials(): check for existing auth, prompt for API key if missing
- askBrowseOrUrl(): common "browse or paste URL" prompt
- askForUrl(): URL input with domain validation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(wizard): add Linear interactive wizard command

Interactive wizard for working with Linear issues:
- Auth check (Linear CLI or API key)
- Browse teams → projects → issues, or paste a URL
- Priority badges in issue selector
- Delegates to runCommand() for execution

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(cli): register ralph-starter linear command

- Add linear wizard to CLI as top-level command
- Add wizard fallback in run.ts for --from linear without project

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add Linear wizard documentation and examples

- Add interactive wizard section to Linear source docs
- Add ralph-starter linear to README commands table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: anchor regex patterns and use type over interface

- Anchor Linear URL regex patterns with ^https?:// (CodeQL fix)
- Change interface to type for plain data structures (Greptile)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: rubenmarcus

README.md

@@ -471,6 +471,7 @@ This creates:
 | `ralph-starter fix [task]` | Fix build errors, lint issues, or design problems |
 | `ralph-starter auto` | Batch-process issues from GitHub/Linear |
 | `ralph-starter task <action>` | Manage tasks across GitHub and Linear (list, create, update, close, comment) |
+| `ralph-starter linear` | Interactive Linear issues wizard |
 | `ralph-starter notion` | Interactive Notion pages wizard |
 | `ralph-starter integrations <action>` | Manage integrations (list, help, test, fetch) |
 | `ralph-starter plan` | Create implementation plan from specs |

docs/docs/sources/linear.md

@@ -17,6 +17,38 @@ Get your API key from [Linear Settings > API > Personal API keys](https://linear
 ralph-starter config set linear.apiKey lin_api_xxxxxxxxxxxx
 ```
 
+## Interactive Wizard
+
+The easiest way to get started:
+
+```bash
+ralph-starter linear
+```
+
+This will:
+1. Check your authentication (prompt for API key if needed)
+2. Let you select a team, then browse projects or issues
+3. Start the build loop automatically
+
+You can also paste a Linear issue URL directly when prompted.
+
+### Wizard Options
+
+```bash
+ralph-starter linear --commit          # Auto-commit after tasks
+ralph-starter linear --push            # Push commits to remote
+ralph-starter linear --pr              # Create PR when done
+ralph-starter linear --agent claude-code  # Use a specific agent
+```
+
+### Fallback
+
+If you run `--from linear` without specifying a project, the wizard launches automatically:
+
+```bash
+ralph-starter run --from linear        # Launches wizard
+```
+
 ## Usage
 
 ```bash

src/cli.ts

@@ -10,6 +10,7 @@ import { figmaCommand } from './commands/figma.js';
 import { fixCommand } from './commands/fix.js';
 import { initCommand } from './commands/init.js';
 import { integrationsCommand } from './commands/integrations.js';
+import { linearCommand } from './commands/linear.js';
 import { notionCommand } from './commands/notion.js';
 import { pauseCommand } from './commands/pause.js';
 import { planCommand } from './commands/plan.js';
@@ -188,6 +189,28 @@ program
     });
   });
 
+// ralph-starter linear - Linear issues wizard
+program
+  .command('linear')
+  .description('Build from Linear issues with an interactive wizard')
+  .option('--commit', 'Auto-commit after tasks')
+  .option('--push', 'Push to remote')
+  .option('--pr', 'Create PR when done')
+  .option('--validate', 'Run validation', true)
+  .option('--no-validate', 'Skip validation')
+  .option('--max-iterations <n>', 'Max loop iterations')
+  .option('--agent <name>', 'Agent to use')
+  .action(async (options) => {
+    await linearCommand({
+      commit: options.commit,
+      push: options.push,
+      pr: options.pr,
+      validate: options.validate,
+      maxIterations: options.maxIterations ? parseInt(options.maxIterations, 10) : undefined,
+      agent: options.agent,
+    });
+  });
+
 // ralph-starter notion - Notion pages wizard
 program
   .command('notion')