@backburner/cli 0.1.0 → 0.1.2

package/README.md

@@ -2,7 +2,7 @@
 
 Backburner is a local GitHub-driven agent orchestration CLI. It uses GitHub labels, issues, and pull requests as the control plane, keeps configuration and state as readable JSON on your machine, and dispatches eligible work to provider CLIs that you already have installed locally.
 
-Backburner currently supports:
+Backburner supports:
 
 - `backburner init` for interactive or non-interactive local setup
 - `backburner run` for one orchestration cycle
@@ -75,7 +75,7 @@ npm run install:local -- --prefix "$env:TEMP\backburner-local"
 & "$env:TEMP\backburner-local\backburner.cmd" journal --json
 ```
 
-Once the current package is published:
+Install from npm:
 
 ```sh
 npm install -g @backburner/cli
@@ -117,12 +117,16 @@ Useful `init` flags:
 --yes, -y                Accept defaults without prompts
 ```
 
-`backburner init` checks local requirements, confirms `gh auth status`, discovers repositories, detects provider CLIs, and writes these files into the management directory:
+`backburner init` checks local requirements, confirms `gh auth status`, discovers repositories, detects provider CLIs, attempts model-list discovery when supported by those CLIs, writes configuration, and creates the configured Backburner labels on each selected repository.
 
 - `repos.json`
 - `agents.json`
 
-If either file already exists, onboarding asks before overwriting it. With `--yes`, defaults are accepted non-interactively.
+If either file already exists, onboarding asks before overwriting it. With `--yes`, defaults are accepted non-interactively, including selecting existing discovered repositories, enabling every discovered provider, creating strong and cheap agents for each one, and creating or updating labels on selected repositories. `--yes` does not create a private demo repository.
+
+Repository setup first asks whether to select existing repositories, create a private Backburner demo repository, or skip repository setup for now. Before choosing existing repositories, onboarding tells you that Backburner will create or update its labels on those repositories. In an interactive terminal, repository and provider selection use a checkbox picker: arrow keys move, space toggles, and enter confirms. Non-TTY sessions fall back to text input and accept comma-separated numbers. If you are authenticated with GitHub but do not want to onboard an existing local clone yet, onboarding can explicitly create a private `backburner-demo` repository and clone it under the configured code root.
+
+Label creation is best-effort. If GitHub rejects a label write because of permissions or repository policy, onboarding continues and prints the repository labels URL plus the exact label names to create manually. The final summary prints the next `backburner run` command, a prefilled GitHub issue URL for the first configured repository, and a terminal QR code for opening that repository's issues page from a phone.
 
 ## Default Directories
 
@@ -158,13 +162,13 @@ Minimal `repos.json`:
       "localPath": "your-github-user/example-repo",
       "enabled": true,
       "labels": {
-        "agentInProgress": "agent-in-progress",
-        "agentProductApproved": "agent-product-approved",
-        "agentPlanApproved": "agent-plan-approved",
-        "agentReview": "agent-review",
-        "planBreakdownNeeded": "plan-breakdown-needed",
-        "agentSyncParentBranch": "agent-sync-parent-branch",
-        "prepareForMerge": "prepare-for-merge"
+        "agentInProgress": "backburner:in-progress",
+        "agentProductApproved": "backburner:product-approved",
+        "agentPlanApproved": "backburner:plan-approved",
+        "agentReview": "backburner:review",
+        "planBreakdownNeeded": "backburner:plan-breakdown-needed",
+        "agentSyncParentBranch": "backburner:sync-parent-branch",
+        "prepareForMerge": "backburner:prepare-for-merge"
       }
     }
   ]
@@ -180,7 +184,7 @@ Minimal `agents.json`:
       "id": "codex-strong",
       "provider": "codex",
       "modelClass": "strong",
-      "model": "gpt-5",
+      "model": "sol",
       "roles": [
         "product",
         "planning",
@@ -192,15 +196,15 @@ Minimal `agents.json`:
       "enabled": true
     },
     {
-      "id": "opencode-cheap",
-      "provider": "opencode",
+      "id": "codex-cheap",
+      "provider": "codex",
       "modelClass": "cheap",
-      "model": "your-fast-model",
+      "model": "luna",
       "roles": [
         "implementation",
         "discussion"
       ],
-      "command": "opencode",
+      "command": "codex",
       "enabled": true
     }
   ]
@@ -209,18 +213,18 @@ Minimal `agents.json`:
 
 `allowedUsers` limits which GitHub users can feed issues, comments, reviews, and pull requests into task derivation. `localPath` must be relative to `--code-root`.
 
-Agent selection filters enabled agents by required role and `modelClass`, then breaks ties by lowest agent `id`. Provider model names are passed through to the provider CLI and are not validated against vendor catalogs.
+Agent selection filters enabled agents by required role and `modelClass`, then breaks ties by lowest agent `id`. Provider model names are passed through to the provider CLI and are not validated against vendor catalogs. During onboarding, model setup shows discovered model options when available, marks strong and cheap defaults, and pressing enter accepts the default. Backburner prefers discovered `sol` for strong, `terra` for balanced/default, and `luna` for cheap model names; Codex defaults are `sol` and `luna`. OpenCode may use discovered OpenRouter model IDs such as `openrouter/openai/gpt-5.6-sol` and `openrouter/openai/gpt-5.6-luna`.
 
 ## Label Control Plane
 
-Configure labels per repository in `repos.json`. The common defaults are:
+Configure labels per repository in `repos.json`. The workflow labels are:
 
-- `agent-product-approved`: approves product discovery and allows Backburner to create the implementation PR/worktree flow for an issue
-- `agent-plan-approved`: approves an implementation plan and allows implementation tasks to run
-- `agent-review`: requests an explicit code review; review tasks are dispatched when the PR has this label and its head SHA changed since the last review
-- `agent-sync-parent-branch`: authorizes Backburner to sync a blocked parent implementation branch from the repository default branch
+- `agentProductApproved`: approves product discovery and allows Backburner to create the implementation PR/worktree flow for an issue
+- `agentPlanApproved`: approves an implementation plan and allows implementation tasks to run
+- `agentReview`: requests an explicit code review; review tasks are dispatched when the PR has this label and its head SHA changed since the last review
+- `agentSyncParentBranch`: authorizes Backburner to sync a blocked parent implementation branch from the repository default branch
 
-Backburner also uses `agent-in-progress`, `plan-breakdown-needed`, and `prepare-for-merge` when those labels are configured.
+Backburner also uses `agentInProgress`, `planBreakdownNeeded`, and `prepareForMerge` when those labels are configured. Onboarding writes `repos.json` with these label values by default: `backburner:product-approved`, `backburner:plan-approved`, `backburner:review`, `backburner:in-progress`, `backburner:plan-breakdown-needed`, `backburner:sync-parent-branch`, and `backburner:prepare-for-merge`. It creates or updates the configured labels through `gh label create --force`. Custom label names, including older unprefixed names, are supported when configured in `repos.json`.
 
 ## Commands
 
@@ -313,7 +317,7 @@ Generated files are readable JSON. Control-plane state is written under `<output
 
 ## Platform Support
 
-Backburner is intended to run on macOS, Linux, and Windows with Node.js 20 or newer. The current CI workflow in this checkout runs on Ubuntu, macOS, and Windows with Node 20 and 22, and includes build, typecheck, tests, package dry-run, and local package install smoke checks.
+Backburner is intended to run on macOS, Linux, and Windows with Node.js 20 or newer. The CI workflow runs on Ubuntu, macOS, and Windows with Node 20 and 22, and includes build, typecheck, tests, package dry-run, and local package install smoke checks.
 
 ## Verification
 

package/dist/src/cli/commands/broker-smoke.js

@@ -1,4 +1,3 @@
-import * as path from "node:path";
 import { ExecFileCommandRunner } from "../../utils/command-runner.js";
 import { loadConfig } from "../../config/loader.js";
 import { GhCliGitHubGateway } from "../../github/gateway.js";
@@ -9,11 +8,11 @@ import { PlanBreakdownSessionStore } from "../../workstreams/plan-breakdown-gene
 import { PlanBreakdownToolService } from "../../workstreams/plan-breakdown-generator/tools.js";
 import { WaveAssessmentSessionStore } from "../../workstreams/wave-assessment/store.js";
 import { WaveAssessmentToolService } from "../../workstreams/wave-assessment/tools.js";
-import { defaultBackburnerManagementRoot } from "../../utils/paths.js";
+import { defaultBackburnerManagementRoot, resolveUserPath } from "../../utils/paths.js";
 import { defaultStderrLogger } from "../../utils/logger.js";
 import { DEFAULT_GITHUB_BROKER_PORT, readOptionalNumberFlag, readOptionalStringFlag, readStringFlag } from "../options.js";
 export async function runBrokerSmokeCli(argv, logger = defaultStderrLogger) {
-    const managementDir = path.resolve(readStringFlag(argv, "--management-dir", defaultBackburnerManagementRoot()));
+    const managementDir = resolveUserPath(readStringFlag(argv, "--management-dir", defaultBackburnerManagementRoot()));
     const host = "127.0.0.1";
     const config = await loadConfig(managementDir);
     const commandRunner = new ExecFileCommandRunner();

package/dist/src/cli/commands/broker.js

@@ -1,4 +1,3 @@
-import * as path from "node:path";
 import { ExecFileCommandRunner } from "../../utils/command-runner.js";
 import { loadConfig } from "../../config/loader.js";
 import { GhCliGitHubGateway } from "../../github/gateway.js";
@@ -9,11 +8,11 @@ import { PlanBreakdownSessionStore } from "../../workstreams/plan-breakdown-gene
 import { PlanBreakdownToolService } from "../../workstreams/plan-breakdown-generator/tools.js";
 import { WaveAssessmentSessionStore } from "../../workstreams/wave-assessment/store.js";
 import { WaveAssessmentToolService } from "../../workstreams/wave-assessment/tools.js";
-import { defaultBackburnerManagementRoot } from "../../utils/paths.js";
+import { defaultBackburnerManagementRoot, resolveUserPath } from "../../utils/paths.js";
 import { defaultStderrLogger } from "../../utils/logger.js";
 import { DEFAULT_GITHUB_BROKER_PORT, readNumberFlag, readStringFlag } from "../options.js";
 export async function runBrokerCli(argv, logger = defaultStderrLogger) {
-    const managementDir = path.resolve(readStringFlag(argv, "--management-dir", defaultBackburnerManagementRoot()));
+    const managementDir = resolveUserPath(readStringFlag(argv, "--management-dir", defaultBackburnerManagementRoot()));
     const port = readNumberFlag(argv, "--port", DEFAULT_GITHUB_BROKER_PORT);
     const host = readStringFlag(argv, "--host", "127.0.0.1");
     const config = await loadConfig(managementDir);

package/dist/src/cli/commands/journal.js

@@ -1,11 +1,10 @@
-import * as path from "node:path";
 import { JournalReader } from "../../journal/index.js";
 import { renderJournalEntries } from "../../journal/renderer.js";
-import { defaultBackburnerOutputsRoot, resolveOutputsJournalRoot } from "../../utils/paths.js";
+import { defaultBackburnerOutputsRoot, resolveOutputsJournalRoot, resolveUserPath } from "../../utils/paths.js";
 import { CliUsageError } from "../errors.js";
 import { readOptionalStringFlag, readStringFlag } from "../options.js";
 export async function runJournalCli(argv, injectedJournal) {
-    const outputsDir = path.resolve(readStringFlag(argv, "--outputs-dir", defaultBackburnerOutputsRoot()));
+    const outputsDir = resolveUserPath(readStringFlag(argv, "--outputs-dir", defaultBackburnerOutputsRoot()));
     const journalDir = resolveOutputsJournalRoot(outputsDir);
     const reader = injectedJournal ? injectedJournal.reader : new JournalReader(journalDir);
     const repoId = readOptionalStringFlag(argv, "--repo");

package/dist/src/cli/commands/tui.js

@@ -1,7 +1,6 @@
-import * as path from "node:path";
 import { loadConfig } from "../../config/loader.js";
 import { StateStore } from "../../state/loader.js";
-import { defaultBackburnerManagementRoot, defaultBackburnerOutputsRoot, resolveOutputsLogsRoot, resolveOutputsStateRoot } from "../../utils/paths.js";
+import { defaultBackburnerManagementRoot, defaultBackburnerOutputsRoot, resolveOutputsLogsRoot, resolveOutputsStateRoot, resolveUserPath } from "../../utils/paths.js";
 import { RuntimeStatusTracker, TuiScreen } from "../tui/index.js";
 import { readIntervalMs, readOptionalStringFlag, readStringFlag } from "../options.js";
 import { runCli } from "./run.js";
@@ -73,7 +72,7 @@ export class SerializedCycleRunner {
 }
 export async function runInteractiveTui(argv) {
     const rest = argv.filter((arg) => arg !== "run");
-    const managementDir = path.resolve(readStringFlag(rest, "--management-dir", defaultBackburnerManagementRoot()));
+    const managementDir = resolveUserPath(readStringFlag(rest, "--management-dir", defaultBackburnerManagementRoot()));
     let repoCount = 0;
     let initialConfig = null;
     try {
@@ -91,9 +90,9 @@ export async function runInteractiveTui(argv) {
     tracker.setIntervalMs(intervalMs);
     // Load initial state for the explorer immediately on start
     try {
-        const outputsDir = path.resolve(readOptionalStringFlag(rest, "--outputs-dir") ?? defaultBackburnerOutputsRoot());
-        const stateDir = path.resolve(resolveOutputsStateRoot(outputsDir));
-        const logDir = path.resolve(resolveOutputsLogsRoot(outputsDir));
+        const outputsDir = resolveUserPath(readOptionalStringFlag(rest, "--outputs-dir") ?? defaultBackburnerOutputsRoot());
+        const stateDir = resolveUserPath(resolveOutputsStateRoot(outputsDir));
+        const logDir = resolveUserPath(resolveOutputsLogsRoot(outputsDir));
         const stateStore = new StateStore({ stateDir, executionDir: logDir });
         const state = await stateStore.load();
         tracker.setState(state);
@@ -114,9 +113,9 @@ export async function runInteractiveTui(argv) {
                 logger: silentLogger,
                 cycleNo: currentCycleNo
             });
-            const outputsDir = path.resolve(readOptionalStringFlag(rest, "--outputs-dir") ?? defaultBackburnerOutputsRoot());
-            const stateDir = path.resolve(resolveOutputsStateRoot(outputsDir));
-            const logDir = path.resolve(resolveOutputsLogsRoot(outputsDir));
+            const outputsDir = resolveUserPath(readOptionalStringFlag(rest, "--outputs-dir") ?? defaultBackburnerOutputsRoot());
+            const stateDir = resolveUserPath(resolveOutputsStateRoot(outputsDir));
+            const logDir = resolveUserPath(resolveOutputsLogsRoot(outputsDir));
             const stateStore = new StateStore({ stateDir, executionDir: logDir });
             const state = await stateStore.load();
             try {

package/dist/src/cli/dispatcher.js

@@ -14,6 +14,10 @@ export async function main(argv = process.argv.slice(2)) {
         process.stdout.write(`${usage}\n`);
         return;
     }
+    if (command !== undefined && hasHelpFlag(rest)) {
+        process.stdout.write(`${usage}\n`);
+        return;
+    }
     if (command === "run") {
         if (shouldUseRuntimeStatusScreen(rest)) {
             await runInteractiveTui([command, ...rest]);
@@ -49,3 +53,6 @@ export async function main(argv = process.argv.slice(2)) {
     }
     throw new CliUsageError(usage);
 }
+function hasHelpFlag(argv) {
+    return argv.includes("--help") || argv.includes("-h");
+}

package/dist/src/cli/init.js

@@ -1,6 +1,6 @@
 import * as path from "node:path";
 import { ExecFileCommandRunner } from "../utils/command-runner.js";
-import { defaultBackburnerCodeRoot, defaultBackburnerManagementRoot, defaultBackburnerOutputsRoot, defaultWorkspacesRootForCodeRoot } from "../utils/paths.js";
+import { defaultBackburnerCodeRoot, defaultBackburnerManagementRoot, defaultBackburnerOutputsRoot, defaultWorkspacesRootForCodeRoot, resolveUserPath } from "../utils/paths.js";
 import { OnboardingEngine } from "../onboarding/engine.js";
 import { NodeReadlinePrompter, NonInteractivePrompter } from "../onboarding/prompt.js";
 import { WelcomeStep } from "../onboarding/steps/welcome.js";
@@ -12,8 +12,10 @@ import { ConfigurePathsStep } from "../onboarding/steps/configure-paths.js";
 import { DiscoverProvidersStep } from "../onboarding/steps/discover-providers.js";
 import { ConfigureModelsStep } from "../onboarding/steps/configure-models.js";
 import { GenerateConfigStep } from "../onboarding/steps/generate-config.js";
+import { ProvisionLabelsStep } from "../onboarding/steps/provision-labels.js";
 import { ReadinessValidationStep } from "../onboarding/steps/readiness-validation.js";
 import { ShowSummaryStep } from "../onboarding/steps/show-summary.js";
+import { DemoRepoCreator } from "../onboarding/services/demo-repo.js";
 export async function runInitCli(argv) {
     const codeRoot = readStringFlag(argv, "--code-root") ?? defaultBackburnerCodeRoot();
     const managementDir = readStringFlag(argv, "--management-dir");
@@ -37,14 +39,14 @@ export async function runInitCli(argv) {
 export async function runInit(options) {
     const commandRunner = new ExecFileCommandRunner();
     const { codeRoot, nonInteractive = false } = options;
-    const resolvedCodeRoot = path.resolve(codeRoot);
-    const resolvedOutputsDir = path.resolve(options.outputsDir ?? defaultBackburnerOutputsRoot());
+    const resolvedCodeRoot = resolveUserPath(codeRoot);
+    const resolvedOutputsDir = resolveUserPath(options.outputsDir ?? defaultBackburnerOutputsRoot());
     const ctx = {
         codeRoot: resolvedCodeRoot,
-        managementDir: path.resolve(options.managementDir ?? defaultBackburnerManagementRoot()),
+        managementDir: resolveUserPath(options.managementDir ?? defaultBackburnerManagementRoot()),
         outputsDir: resolvedOutputsDir,
-        logDir: path.resolve(options.logDir ?? path.join(resolvedOutputsDir, "logs")),
-        workspacesDir: path.resolve(options.workspacesDir ?? defaultWorkspacesRootForCodeRoot(resolvedCodeRoot)),
+        logDir: resolveUserPath(options.logDir ?? path.join(resolvedOutputsDir, "logs")),
+        workspacesDir: resolveUserPath(options.workspacesDir ?? defaultWorkspacesRootForCodeRoot(resolvedCodeRoot)),
         discoveredRepos: [],
         selectedRepos: [],
         discoveredProviders: [],
@@ -56,11 +58,12 @@ export async function runInit(options) {
         new CheckRequirementsStep(commandRunner),
         new CheckGitHubAuthStep(commandRunner),
         new DiscoverReposStep(commandRunner, ctx.codeRoot),
-        new SelectReposStep(),
+        new SelectReposStep(new DemoRepoCreator(commandRunner)),
         new ConfigurePathsStep(),
         new DiscoverProvidersStep(commandRunner),
         new ConfigureModelsStep(),
         new GenerateConfigStep(),
+        new ProvisionLabelsStep(commandRunner),
         new ReadinessValidationStep(commandRunner),
         new ShowSummaryStep()
     ];

package/dist/src/cli/runtime/run-context.js

@@ -15,19 +15,19 @@ import { createSmitheryMcpResolverFromEnv, reconcileMcpStatus } from "../../mcps
 import { StateStore } from "../../state/loader.js";
 import { ExecFileCommandRunner } from "../../utils/command-runner.js";
 import { defaultStderrLogger } from "../../utils/logger.js";
-import { defaultBackburnerCodeRoot, defaultBackburnerManagementRoot, defaultBackburnerOutputsRoot, resolveOutputsStateRoot, resolveOutputsLogsRoot, resolveOutputsJournalRoot } from "../../utils/paths.js";
+import { defaultBackburnerCodeRoot, defaultBackburnerManagementRoot, defaultBackburnerOutputsRoot, resolveOutputsStateRoot, resolveOutputsLogsRoot, resolveOutputsJournalRoot, resolveUserPath } from "../../utils/paths.js";
 import { TriageFollowUpService } from "../../workflows/triage.js";
 import { ImplementationWorkflowService } from "../../worktrees/service.js";
 import { WorkspaceRecoveryService } from "../../worktrees/workspace-recovery.js";
 import { DEFAULT_GITHUB_BROKER_PORT as CLI_DEFAULT_GITHUB_BROKER_PORT, readNumberFlag, readOptionalStringFlag, readStringFlag } from "../options.js";
 export async function createRunContext(input) {
     const { rest, options } = input;
-    const managementDir = path.resolve(options.managementDir ?? readStringFlag(rest, "--management-dir", defaultBackburnerManagementRoot()));
+    const managementDir = resolveUserPath(options.managementDir ?? readStringFlag(rest, "--management-dir", defaultBackburnerManagementRoot()));
     const configuredOutputsDir = options.outputsDir ?? readOptionalStringFlag(rest, "--outputs-dir");
-    const outputsDir = path.resolve(configuredOutputsDir ?? defaultBackburnerOutputsRoot());
+    const outputsDir = resolveUserPath(configuredOutputsDir ?? defaultBackburnerOutputsRoot());
     const useLegacyStateDirWithoutOutputs = options.stateDir !== undefined && configuredOutputsDir === undefined;
     const logger = options.logger ?? defaultStderrLogger;
-    const codeRoot = path.resolve(readOptionalStringFlag(rest, "--code-root") ?? defaultBackburnerCodeRoot());
+    const codeRoot = resolveUserPath(readOptionalStringFlag(rest, "--code-root") ?? defaultBackburnerCodeRoot());
     const brokerPort = readNumberFlag(rest, "--broker-port", CLI_DEFAULT_GITHUB_BROKER_PORT);
     const commandRunner = options.commandRunner ?? new ExecFileCommandRunner();
     const gitGateway = options.gitGateway ?? new GitCliGateway(commandRunner);
@@ -48,9 +48,9 @@ export async function createRunContext(input) {
         logger.info(`Preparing outputs root ${outputsDir}`);
         outputsGitOpsPrepared = await gitOpsLifecycle.prepareOutputsRoot(outputsDir);
     }
-    const stateDir = path.resolve(options.stateDir ?? resolveOutputsStateRoot(outputsDir));
+    const stateDir = resolveUserPath(options.stateDir ?? resolveOutputsStateRoot(outputsDir));
     const defaultLogDir = options.stateDir !== undefined ? stateDir : resolveOutputsLogsRoot(outputsDir);
-    const logDir = path.resolve(options.logDir ?? readStringFlag(rest, "--log-dir", defaultLogDir));
+    const logDir = resolveUserPath(options.logDir ?? readStringFlag(rest, "--log-dir", defaultLogDir));
     let managementRepo;
     try {
         const remoteResult = await commandRunner.run("git", ["remote", "get-url", "origin"], { cwd: managementDir });

package/dist/src/onboarding/config-writer.js

@@ -1,6 +1,15 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { writeJsonFileAtomic } from "../utils/json.js";
+export const DEFAULT_BACKBURNER_LABELS = {
+    agentInProgress: "backburner:in-progress",
+    agentPlanApproved: "backburner:plan-approved",
+    agentProductApproved: "backburner:product-approved",
+    agentReview: "backburner:review",
+    planBreakdownNeeded: "backburner:plan-breakdown-needed",
+    agentSyncParentBranch: "backburner:sync-parent-branch",
+    prepareForMerge: "backburner:prepare-for-merge"
+};
 export class ConfigWriter {
     async detectExisting(managementDir) {
         const reposFile = path.join(managementDir, "repos.json");
@@ -55,15 +64,7 @@ function buildRepoEntry(repo) {
         defaultBranch: repo.defaultBranch,
         localPath: repo.localPath,
         enabled: repo.enabled,
-        labels: {
-            agentInProgress: "agent-in-progress",
-            agentPlanApproved: "agent-plan-approved",
-            agentProductApproved: "agent-product-approved",
-            agentReview: "agent-review",
-            planBreakdownNeeded: "plan-breakdown-needed",
-            agentSyncParentBranch: "agent-sync-parent-branch",
-            prepareForMerge: "prepare-for-merge"
-        }
+        labels: repo.labels
     };
 }
 function buildAgentsJson(draft) {

package/dist/src/onboarding/prompt.js

@@ -1,3 +1,4 @@
+import { emitKeypressEvents } from "node:readline";
 import * as readline from "node:readline/promises";
 /**
  * Interactive prompter backed by Node.js readline/promises.
@@ -5,10 +6,14 @@ import * as readline from "node:readline/promises";
  */
 export class NodeReadlinePrompter {
     rl;
-    constructor() {
+    input;
+    output;
+    constructor(options = {}) {
+        this.input = options.input ?? process.stdin;
+        this.output = options.output ?? process.stdout;
         this.rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout
+            input: this.input,
+            output: this.output
         });
     }
     close() {
@@ -32,7 +37,7 @@ export class NodeReadlinePrompter {
             const marker = i === defaultIndex ? "*" : " ";
             lines.push(`  ${marker} ${i + 1}. ${options[i] ?? ""}`);
         }
-        process.stdout.write(`${lines.join("\n")}\n`);
+        this.output.write(`${lines.join("\n")}\n`);
         const defaultHint = defaultIndex !== undefined ? ` [${defaultIndex + 1}]` : "";
         // eslint-disable-next-line no-constant-condition
         while (true) {
@@ -44,10 +49,16 @@ export class NodeReadlinePrompter {
             if (Number.isInteger(n) && n >= 1 && n <= options.length) {
                 return n - 1;
             }
-            process.stdout.write(`  Please enter a number between 1 and ${options.length}\n`);
+            this.output.write(`  Please enter a number between 1 and ${options.length}\n`);
         }
     }
     async multiSelect(question, options, preSelected) {
+        if (canUseTerminalPicker(this.input, this.output)) {
+            return this.terminalMultiSelect(question, options, preSelected);
+        }
+        return this.textMultiSelect(question, options, preSelected);
+    }
+    async textMultiSelect(question, options, preSelected) {
         const preSet = new Set(preSelected ?? []);
         const lines = [
             question,
@@ -57,30 +68,100 @@ export class NodeReadlinePrompter {
             const marker = preSet.has(i) ? "[x]" : "[ ]";
             lines.push(`  ${marker} ${i + 1}. ${options[i] ?? ""}`);
         }
-        process.stdout.write(`${lines.join("\n")}\n`);
+        this.output.write(`${lines.join("\n")}\n`);
         // eslint-disable-next-line no-constant-condition
         while (true) {
             const answer = (await this.rl.question("Selection: ")).trim().toLowerCase();
-            if (answer === "all")
-                return options.map((_, i) => i);
-            if (answer === "" || answer === "none")
-                return preSelected ?? [];
-            const parts = answer.split(",").map((p) => p.trim());
-            const indices = [];
-            let valid = true;
-            for (const part of parts) {
-                const n = Number(part);
-                if (!Number.isInteger(n) || n < 1 || n > options.length) {
-                    process.stdout.write(`  Invalid selection "${part}". Enter numbers between 1 and ${options.length}\n`);
-                    valid = false;
-                    break;
-                }
-                indices.push(n - 1);
+            const parsed = parseTextMultiSelectAnswer(answer, options.length, preSelected);
+            if (parsed.ok)
+                return parsed.indices;
+            if (parsed.invalidPart !== undefined) {
+                this.output.write(`  Invalid selection "${parsed.invalidPart}". Enter numbers between 1 and ${options.length}\n`);
             }
-            if (valid)
-                return [...new Set(indices)];
         }
     }
+    async terminalMultiSelect(question, options, preSelected) {
+        const selected = new Set(preSelected ?? []);
+        let cursor = preSelected?.[0] ?? 0;
+        if (cursor < 0 || cursor >= options.length)
+            cursor = 0;
+        this.rl.pause();
+        emitKeypressEvents(this.input);
+        this.input.setRawMode?.(true);
+        this.input.resume();
+        return await new Promise((resolve) => {
+            const render = () => {
+                const lines = [
+                    question,
+                    "Use ↑/↓ to move, space to toggle, enter to confirm.",
+                    ...options.map((option, i) => {
+                        const pointer = i === cursor ? ">" : " ";
+                        const marker = selected.has(i) ? "[x]" : "[ ]";
+                        return `${pointer} ${marker} ${option}`;
+                    })
+                ];
+                this.output.write(`\x1b[?25l\x1b[2K\r${lines.join("\n")}`);
+                this.output.write(`\x1b[${lines.length - 1}A`);
+            };
+            const finish = () => {
+                this.input.off("keypress", onKeypress);
+                this.input.setRawMode?.(false);
+                this.output.write(`\x1b[?25h\x1b[${options.length + 1}B\n`);
+                this.rl.resume();
+                resolve([...selected].sort((a, b) => a - b));
+            };
+            const onKeypress = (_chunk, key) => {
+                if (key.ctrl === true && key.name === "c") {
+                    finish();
+                    return;
+                }
+                switch (key.name) {
+                    case "up":
+                        cursor = cursor <= 0 ? options.length - 1 : cursor - 1;
+                        render();
+                        break;
+                    case "down":
+                        cursor = cursor >= options.length - 1 ? 0 : cursor + 1;
+                        render();
+                        break;
+                    case "space":
+                        if (selected.has(cursor)) {
+                            selected.delete(cursor);
+                        }
+                        else {
+                            selected.add(cursor);
+                        }
+                        render();
+                        break;
+                    case "return":
+                    case "enter":
+                        finish();
+                        break;
+                }
+            };
+            this.input.on("keypress", onKeypress);
+            render();
+        });
+    }
+}
+function canUseTerminalPicker(input, output) {
+    return input.isTTY === true && output.isTTY === true && typeof input.setRawMode === "function";
+}
+export function parseTextMultiSelectAnswer(answer, optionCount, preSelected) {
+    if (answer === "all")
+        return { ok: true, indices: Array.from({ length: optionCount }, (_, i) => i) };
+    if (answer === "" || answer === "none")
+        return { ok: true, indices: preSelected ?? [] };
+    const parts = answer.split(",").map((p) => p.trim());
+    const indices = [];
+    for (const part of parts) {
+        const n = Number(part);
+        if (!Number.isInteger(n) || n < 1 || n > optionCount) {
+            return { ok: false, invalidPart: part };
+        }
+        indices.push(n - 1);
+    }
+    return { ok: true, indices: [...new Set(indices)] };
 }
 /**
  * Non-interactive prompter that accepts all defaults.

package/dist/src/onboarding/services/demo-repo.js

@@ -0,0 +1,33 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export class DemoRepoCreator {
+    commandRunner;
+    constructor(commandRunner) {
+        this.commandRunner = commandRunner;
+    }
+    async createPrivateDemoRepo(options) {
+        await fs.mkdir(options.codeRoot, { recursive: true });
+        await this.commandRunner.run("gh", [
+            "repo",
+            "create",
+            `${options.owner}/${options.name}`,
+            "--private",
+            "--clone",
+            "--add-readme",
+            "--description",
+            "Private Backburner onboarding demo repository"
+        ], { cwd: options.codeRoot, timeoutMs: 60_000 });
+        return {
+            owner: options.owner,
+            name: options.name,
+            localPath: path.join(options.codeRoot, options.name),
+            defaultBranch: "main",
+            isLocalClone: true,
+            canFetch: true,
+            canPush: true
+        };
+    }
+}
+export function defaultDemoRepoName() {
+    return "backburner-demo";
+}

package/dist/src/onboarding/services/label-provisioner.js

@@ -0,0 +1,39 @@
+const LABEL_TIMEOUT_MS = 30_000;
+export class GitHubLabelProvisioner {
+    commandRunner;
+    constructor(commandRunner) {
+        this.commandRunner = commandRunner;
+    }
+    async provisionLabels(targets) {
+        const results = [];
+        for (const target of targets) {
+            const repoSlug = `${target.owner}/${target.name}`;
+            for (const label of target.labels) {
+                try {
+                    await this.commandRunner.run("gh", [
+                        "label",
+                        "create",
+                        label.name,
+                        "--repo",
+                        repoSlug,
+                        "--description",
+                        label.description,
+                        "--color",
+                        label.color,
+                        "--force"
+                    ], { timeoutMs: LABEL_TIMEOUT_MS });
+                    results.push({ repoSlug, labelName: label.name, status: "created_or_updated" });
+                }
+                catch (err) {
+                    results.push({
+                        repoSlug,
+                        labelName: label.name,
+                        status: "failed",
+                        message: err instanceof Error ? err.message : String(err)
+                    });
+                }
+            }
+        }
+        return results;
+    }
+}