@ttfw/envoi 1.0.8 → 1.0.9

package/README.md

@@ -89,13 +89,14 @@ envoi start
 6. configures reviewer (`codex|none`, default recommended: `codex`),
 7. auto-initializes git (`git init`) when no repository exists,
 8. runs role connectivity checks,
-9. writes `ROADMAP.json` from the planner snapshot,
-10. asks whether to start execution now.
+9. writes `envoi/ROADMAP.json` from the planner snapshot,
+10. asks whether to start execution now,
+11. if starting immediately in a brand-new repo, auto-commits scaffold files before first tick.
 
 Non-TTY (agent-run) onboarding:
 - Envoi emits exactly one next question per run (`envoi.onboarding.next_question.v1`) and returns exit code `0` by default (to avoid noisy error wrappers in agent CLIs).
 - Reply with one answer envelope at a time (`envoi.onboarding.answer.v1`), then rerun to get the next question.
-- After required fields are collected, Envoi asks for explicit review/confirm (`confirm`, `confirm_and_start`, or `edit:<field>`).
+- After required fields are collected, Envoi asks for explicit review/confirm (`confirm`, `confirm_and_start`, or `edit:<field>`), including full PRD content plus preview/path.
 - Output defaults to JSON payloads; switch with:
   - `--json` (single-line payload; explicit for automation)
   - `--verbose-onboarding` (human + pretty JSON)
@@ -131,7 +132,7 @@ envoi idea "Need staging validation faster" --testability soon --target-by 2026-
 
 Ideas are persisted in state (`idea_inbox`) and fed into planner decisions.
 Planner should choose sequencing, scope, and timing; user should not be forced into low-level technical choices.
-Planner snapshots are written to ROADMAP.json and refreshed by onboarding when needed.
+Planner snapshots are written to `envoi/ROADMAP.json` and refreshed by onboarding when needed.
 
 ## Optional Reviewer Gate
 When configured, reviewer can:
@@ -237,6 +238,7 @@ Default runtime files live under `envoi/`:
 - `REPORT.json`
 - `REPORT.md` (optional)
 - `BLOCKED.json`
+- `ROADMAP.json`
 - `history/<run_id>/...`
 
 ## PR Attribution
@@ -255,5 +257,4 @@ pnpm typecheck
 ## Additional Docs
 - `docs/DOGFOOD.md`
 - `docs/NEW-PLAN.md`
-- `ROADMAP.json`
 - `pilot/` (legacy workflow docs)

package/dist/commands/onboard.d.ts

@@ -46,6 +46,8 @@ interface OnboardingReviewPayload {
         reviewer?: string;
         reviewer_model?: string;
         prd_preview?: string;
+        prd_full?: string;
+        prd_path?: string;
     };
     options: Array<{
         value: 'confirm' | 'confirm_and_start' | 'edit';
@@ -100,6 +102,8 @@ export declare function resolveOnboardingNeedsInputPolicy(options: {
 export declare function buildNonInteractiveQuestions(input: OnboardingQuestionInputs): OnboardingQuestion[];
 export declare function parseInlineAnswer(line: string): OnboardingAnswerPayload;
 export declare function normalizeQuestionAnswer(question: OnboardingQuestion, raw: unknown): string | undefined;
+export declare function parseGitPorcelainPaths(stdout: string): string[];
+export declare function isScaffoldOnlyInitialDirtyFiles(files: string[], workspaceDir: string, configFileName: string): boolean;
 export declare function buildReviewPayload(sessionId: string, state: InlineAnswersState): OnboardingReviewPayload;
 export declare function isMeaningfulPrdText(value: string): boolean;
 export interface OnboardCommandResult {

package/dist/commands/onboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,KAAK,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;AACpD,KAAK,aAAa,GAAG,aAAa,GAAG,QAAQ,CAAC;AAC9C,KAAK,eAAe,GAAG,aAAa,GAAG,SAAS,CAAC;AACjD,KAAK,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AA2BvC,QAAA,MAAM,8BAA8B,+BAA+B,CAAC;AAOpE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;CACrB;AAsBD,KAAK,sBAAsB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoCD,UAAU,uBAAuB;IAC/B,IAAI,EAAE,OAAO,8BAA8B,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,SAAS,GAAG,mBAAmB,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnG;AAED,UAAU,uBAAuB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAcD,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ,CAAC;QACf,OAAO,EAAE,aAAa,CAAC;QACvB,eAAe,EAAE,eAAe,CAAC;QACjC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,cAAc,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0CD,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAE/E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAO1F;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,0BAA0B,CAmB7B;AAmFD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,wBAAwB,GAAG,kBAAkB,EAAE,CAoFlG;AAwID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAYvE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBtG;AAkFD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,CAqBxG;AAkdD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAU1D;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;CACrB;AAqFD,eAAO,MAAM,wBAAwB,+FAO3B,CAAC;AAEX,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBpF;AAmQD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBhE;AAyJD,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAwchC"}
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"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"}

package/dist/commands/onboard.js

@@ -10,14 +10,14 @@
  * - Optionally start execution immediately
  */
 import { mkdir, writeFile, readFile } from 'node:fs/promises';
-import { dirname, resolve, join } from 'node:path';
+import { resolve, join, relative } from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
 import readline from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
 import { atomicReadJson, atomicWriteJson } from '../lib/fs.js';
 import { CONFIG_FILE_NAME, findConfigFile, loadConfig, validateConfig, ConfigError } from '../lib/config.js';
-import { checkCursorAgent, checkCodexCli } from '../lib/doctor.js';
+import { checkCursorAgent, checkCodexCli, checkClaudeCodeCli } from '../lib/doctor.js';
 import { getGitTopLevel, isGitRepo, getHeadCommit } from '../lib/git.js';
 import { CLI_NAME, PRODUCT_NAME, PACKAGE_NAME } from '../lib/branding.js';
 import { createInitialState } from '../lib/state.js';
@@ -422,6 +422,89 @@ function summarizePrdPreview(text) {
         return compact;
     return `${compact.slice(0, 177)}...`;
 }
+function normalizeGitStatusPath(pathText) {
+    const trimmed = pathText.trim();
+    if (!trimmed.startsWith('"') || !trimmed.endsWith('"'))
+        return trimmed;
+    const body = trimmed.slice(1, -1);
+    return body
+        .replace(/\\n/g, '\n')
+        .replace(/\\t/g, '\t')
+        .replace(/\\"/g, '"')
+        .replace(/\\\\/g, '\\');
+}
+export function parseGitPorcelainPaths(stdout) {
+    return stdout
+        .split(/\r?\n/)
+        .map((line) => line.trimEnd())
+        .filter((line) => line.length >= 4)
+        .map((line) => {
+        const pathPart = line.slice(3).trim();
+        const renamedIndex = pathPart.indexOf(' -> ');
+        const candidate = renamedIndex >= 0 ? pathPart.slice(renamedIndex + 4) : pathPart;
+        return normalizeGitStatusPath(candidate);
+    })
+        .filter((path) => path.length > 0);
+}
+export function isScaffoldOnlyInitialDirtyFiles(files, workspaceDir, configFileName) {
+    const normalizedWorkspacePrefix = `${workspaceDir.replace(/^\.\/+/, '').replace(/\/+$/, '')}/`;
+    return files.every((file) => {
+        const normalized = file.replace(/^\.\/+/, '');
+        return (normalized === '.gitignore' ||
+            normalized === configFileName ||
+            normalized.startsWith(normalizedWorkspacePrefix));
+    });
+}
+async function autoCommitInitialScaffoldIfSafe(config, configFilePath) {
+    if (!isGitRepo())
+        return;
+    const hasHeadCommit = spawnSync('git', ['rev-parse', '--verify', 'HEAD'], { stdio: 'pipe' }).status === 0;
+    if (hasHeadCommit)
+        return;
+    const statusResult = spawnSync('git', ['status', '--porcelain'], { stdio: 'pipe' });
+    if (statusResult.status !== 0)
+        return;
+    const dirtyFiles = parseGitPorcelainPaths(statusResult.stdout?.toString('utf-8') ?? '');
+    if (dirtyFiles.length === 0) {
+        console.log('Skipping auto-start: repository has no initial commit yet.');
+        console.log('Create an initial commit, then run envoi start again.');
+        throw new Error('Initial repository commit required before auto-start.');
+    }
+    const normalizedConfigPath = (() => {
+        if (!configFilePath)
+            return CONFIG_FILE_NAME;
+        const relPath = relative(process.cwd(), resolve(configFilePath)).replace(/\\/g, '/');
+        return relPath.startsWith('../') ? CONFIG_FILE_NAME : relPath;
+    })();
+    if (!isScaffoldOnlyInitialDirtyFiles(dirtyFiles, config.workspace_dir, normalizedConfigPath)) {
+        console.log('Skipping auto-start: initial repo has non-Envoi uncommitted files.');
+        console.log('Commit your existing files first, then run envoi start again.');
+        throw new Error('Initial repository contains non-scaffold changes; not auto-committing.');
+    }
+    const addResult = spawnSync('git', ['add', '--', '.gitignore', normalizedConfigPath, config.workspace_dir], { stdio: 'pipe' });
+    if (addResult.status !== 0) {
+        const stderr = addResult.stderr?.toString('utf-8').trim();
+        throw new Error(`Failed to stage Envoi scaffold for initial commit: ${stderr || 'git add failed'}`);
+    }
+    const commitResult = spawnSync('git', [
+        '-c',
+        'user.name=Envoi',
+        '-c',
+        'user.email=envoi@local',
+        'commit',
+        '-m',
+        'Initialize Envoi workspace',
+    ], { stdio: 'pipe' });
+    if (commitResult.status !== 0) {
+        const stderr = commitResult.stderr?.toString('utf-8').trim();
+        const stdout = commitResult.stdout?.toString('utf-8').trim();
+        const combined = `${stderr}\n${stdout}`.toLowerCase();
+        if (combined.includes('nothing to commit'))
+            return;
+        throw new Error(`Failed to create initial scaffold commit: ${stderr || stdout || 'git commit failed'}`);
+    }
+    console.log('Created initial git commit for Envoi scaffold.');
+}
 function clearInlineField(state, field) {
     switch (field) {
         case 'mode':
@@ -495,10 +578,11 @@ function applyQuestionValue(state, questionId, value) {
     }
 }
 export function buildReviewPayload(sessionId, state) {
+    const prdFull = (state.prdText ?? '').trim();
     return {
         type: ONBOARDING_REVIEW_PAYLOAD_TYPE,
         session_id: sessionId,
-        message: 'Review onboarding choices before saving. Reply with confirm, confirm_and_start, or edit.',
+        message: 'Review onboarding choices before saving. Full PRD is included below and saved to envoi/PRD.md.',
         summary: {
             mode: state.mode,
             builder: state.builder,
@@ -507,7 +591,9 @@ export function buildReviewPayload(sessionId, state) {
             builder_model: state.builderModel,
             reviewer: state.reviewer,
             reviewer_model: state.reviewerModel,
-            prd_preview: summarizePrdPreview(state.prdText ?? ''),
+            prd_preview: summarizePrdPreview(prdFull),
+            prd_full: prdFull,
+            prd_path: 'envoi/PRD.md',
         },
         options: [
             { value: 'confirm', label: 'confirm', desc: 'Save and continue onboarding.' },
@@ -776,6 +862,8 @@ function buildReviewQuestion(state) {
         `reviewer=${summary.reviewer ?? 'n/a'}`,
         `reviewer_model=${summary.reviewer_model ?? 'n/a'}`,
         `prd_preview=${summary.prd_preview ?? '(empty)'}`,
+        `prd_path=${summary.prd_path ?? 'envoi/PRD.md'}`,
+        `prd_full=${summary.prd_full ?? '(empty)'}`,
     ].join('\n');
     return {
         id: 'review',
@@ -933,6 +1021,211 @@ export function isMeaningfulPrdText(value) {
         .trim();
     return compact.length >= 30;
 }
+function roleLabel(role) {
+    if (role === 'planner')
+        return 'planner';
+    if (role === 'builder')
+        return 'builder';
+    return 'reviewer';
+}
+function isAuthenticatedStatus(status) {
+    return status === 'authenticated' || status === 'api_key_present';
+}
+function mergeAuthIssue(issues, issue) {
+    const existing = issues.get(issue.key);
+    if (!existing) {
+        issues.set(issue.key, issue);
+        return;
+    }
+    const mergedRoles = new Set([...existing.roles, ...issue.roles]);
+    existing.roles = Array.from(mergedRoles);
+}
+function formatAuthIssue(issue) {
+    const roles = issue.roles.map((role) => roleLabel(role)).join('/');
+    const details = issue.details ? ` (${issue.details})` : '';
+    const remediation = issue.remediation.map((step) => `- ${step}`).join('\n');
+    return `${roles}: ${issue.reason}${details}\n${remediation}`;
+}
+function buildAuthQuestion(issues) {
+    const helpLines = [
+        'Authenticate the required CLI(s), then reply with: done',
+        ...issues.flatMap((issue) => formatAuthIssue(issue).split('\n')),
+    ];
+    return {
+        id: 'auth',
+        label: 'Authentication required before continuing onboarding',
+        type: 'text',
+        required: true,
+        default: 'done',
+        help: helpLines.join('\n'),
+    };
+}
+function printAuthIssues(issues) {
+    console.log('\nAuthentication required before continuing onboarding:');
+    for (const issue of issues) {
+        console.log(`- ${formatAuthIssue(issue).replace(/\n/g, '\n  ')}`);
+    }
+}
+async function collectOnboardingAuthIssues(params) {
+    const issues = new Map();
+    const claudeCommand = params.config.claude_code_cli.command ?? 'claude';
+    let claudeCheckPromise;
+    let codexCheckPromise;
+    let cursorCheckPromise;
+    const checkClaude = async () => {
+        if (!claudeCheckPromise)
+            claudeCheckPromise = checkClaudeCodeCli(claudeCommand);
+        return await claudeCheckPromise;
+    };
+    const checkCodex = async () => {
+        if (!codexCheckPromise)
+            codexCheckPromise = checkCodexCli(params.config);
+        return await codexCheckPromise;
+    };
+    const checkCursor = async () => {
+        if (!cursorCheckPromise)
+            cursorCheckPromise = checkCursorAgent(params.config);
+        return await cursorCheckPromise;
+    };
+    if (params.plannerProvider === 'claude_code') {
+        const claude = await checkClaude();
+        if (!claude.cli_available) {
+            mergeAuthIssue(issues, {
+                key: 'claude-missing-cli',
+                roles: ['planner'],
+                reason: `CLI '${claude.command}' is not available`,
+                remediation: [
+                    `Install Claude Code and ensure '${claude.command}' is on your PATH.`,
+                ],
+                details: claude.details,
+            });
+        }
+        else if (!isAuthenticatedStatus(claude.auth_status)) {
+            mergeAuthIssue(issues, {
+                key: 'claude-auth-required',
+                roles: ['planner'],
+                reason: `CLI '${claude.command}' is not authenticated`,
+                remediation: [
+                    `Run '${claude.command}' and complete login/authentication in the CLI.`,
+                    "If you use API auth, set ANTHROPIC_API_KEY in your environment.",
+                ],
+                details: claude.details,
+            });
+        }
+    }
+    else {
+        const codex = await checkCodex();
+        if (!codex.cli_available) {
+            mergeAuthIssue(issues, {
+                key: 'codex-missing-cli',
+                roles: ['planner'],
+                reason: "CLI 'codex' is not available",
+                remediation: [
+                    "Install Codex CLI and ensure 'codex' is on your PATH.",
+                ],
+            });
+        }
+        else if (!isAuthenticatedStatus(codex.auth_status)) {
+            mergeAuthIssue(issues, {
+                key: 'codex-auth-required',
+                roles: ['planner'],
+                reason: "CLI 'codex' is not authenticated",
+                remediation: [
+                    "Run 'codex login' in this shell.",
+                    'Or set CODEX_API_KEY in your environment.',
+                ],
+            });
+        }
+    }
+    if (params.builderChoice === 'cursor') {
+        const cursor = await checkCursor();
+        if (!cursor.cli_available) {
+            mergeAuthIssue(issues, {
+                key: 'cursor-missing-cli',
+                roles: ['builder'],
+                reason: `CLI '${cursor.command}' is not available`,
+                remediation: [
+                    `Install Cursor CLI and ensure '${cursor.command}' is on your PATH.`,
+                ],
+                details: cursor.details,
+            });
+        }
+        else if (!cursor.agent_available) {
+            mergeAuthIssue(issues, {
+                key: 'cursor-agent-missing',
+                roles: ['builder'],
+                reason: `'${cursor.command} agent' is unavailable`,
+                remediation: [
+                    `Update Cursor CLI so '${cursor.command} agent' is supported.`,
+                ],
+                details: cursor.details,
+            });
+        }
+        else if (!isAuthenticatedStatus(cursor.auth_status)) {
+            mergeAuthIssue(issues, {
+                key: 'cursor-auth-required',
+                roles: ['builder'],
+                reason: `'${cursor.command} agent' is not authenticated`,
+                remediation: [
+                    `Run '${cursor.command} agent login' in this shell.`,
+                    'Or set CURSOR_API_KEY in your environment.',
+                ],
+                details: cursor.details,
+            });
+        }
+    }
+    else {
+        const claude = await checkClaude();
+        if (!claude.cli_available) {
+            mergeAuthIssue(issues, {
+                key: 'claude-missing-cli',
+                roles: ['builder'],
+                reason: `CLI '${claude.command}' is not available`,
+                remediation: [
+                    `Install Claude Code and ensure '${claude.command}' is on your PATH.`,
+                ],
+                details: claude.details,
+            });
+        }
+        else if (!isAuthenticatedStatus(claude.auth_status)) {
+            mergeAuthIssue(issues, {
+                key: 'claude-auth-required',
+                roles: ['builder'],
+                reason: `CLI '${claude.command}' is not authenticated`,
+                remediation: [
+                    `Run '${claude.command}' and complete login/authentication in the CLI.`,
+                    "If you use API auth, set ANTHROPIC_API_KEY in your environment.",
+                ],
+                details: claude.details,
+            });
+        }
+    }
+    if (params.reviewerChoice === 'codex') {
+        const codex = await checkCodex();
+        if (!codex.cli_available) {
+            mergeAuthIssue(issues, {
+                key: 'codex-missing-cli',
+                roles: ['reviewer'],
+                reason: "CLI 'codex' is not available",
+                remediation: [
+                    "Install Codex CLI and ensure 'codex' is on your PATH.",
+                ],
+            });
+        }
+        else if (!isAuthenticatedStatus(codex.auth_status)) {
+            mergeAuthIssue(issues, {
+                key: 'codex-auth-required',
+                roles: ['reviewer'],
+                reason: "CLI 'codex' is not authenticated",
+                remediation: [
+                    "Run 'codex login' in this shell.",
+                    'Or set CODEX_API_KEY in your environment.',
+                ],
+            });
+        }
+    }
+    return Array.from(issues.values());
+}
 function normalizeReviewerChoice(value) {
     if (!value || value.trim() === '')
         return 'none';
@@ -1354,8 +1647,8 @@ async function generateRoadmapDraft(config, mode) {
         },
     };
 }
-function printRoadmapPreview(roadmap) {
-    console.log('\nPlanner snapshot (ROADMAP.json):');
+function printRoadmapPreview(roadmap, roadmapPath) {
+    console.log(`\nPlanner snapshot (${roadmapPath}):`);
     console.log(`- Source: ${roadmap.source}`);
     console.log(`- Task: ${roadmap.task_id} (${roadmap.milestone_id})`);
     if (roadmap.milestones.length > 0) {
@@ -1424,8 +1717,11 @@ async function runConnectivityChecks(config) {
             if (!codex.cli_available) {
                 console.log('- checker: BLOCKED (codex CLI not available)');
             }
-            else if (codex.auth_status === 'api_key_present') {
-                console.log('- checker: CLEARED (codex CLI + API key detected)');
+            else if (codex.auth_status === 'api_key_present' || codex.auth_status === 'authenticated') {
+                console.log('- checker: CLEARED (codex CLI authenticated)');
+            }
+            else if (codex.auth_status === 'unauthenticated') {
+                console.log('- checker: STANDBY (codex CLI available; login required)');
             }
             else {
                 console.log('- checker: STANDBY (codex CLI available; auth status unknown)');
@@ -1445,13 +1741,14 @@ async function runConnectivityChecks(config) {
         console.log('- checker: STANDBY (optional reviewer disabled)');
     }
 }
-async function maybeStartRun(config, mode, autoRun) {
+async function maybeStartRun(config, mode, autoRun, configFilePath) {
     if (!autoRun) {
         console.log('\nSetup complete. Waiting for you.');
         console.log(`- Run '${CLI_NAME} tick' for one bounded cycle`);
         console.log(`- Or run '${CLI_NAME} loop --mode ${mode}'`);
         return;
     }
+    await autoCommitInitialScaffoldIfSafe(config, configFilePath);
     console.log(`\nStarting now using mode '${mode}'...`);
     if (mode === 'task') {
         const { runTick } = await import('../runner/tick.js');
@@ -1528,7 +1825,7 @@ export async function onboardCommand(options) {
         console.log(`${PRODUCT_NAME} onboarding already complete.`);
         const mode = raw.runner.default_loop_mode ?? defaults.mode;
         const autoRunRequested = options.autoRun ?? false;
-        await maybeStartRun(raw, mode, autoRunRequested);
+        await maybeStartRun(raw, mode, autoRunRequested, configPath);
         return { needsInput: false };
     }
     const sessionId = asNonEmptyString(answerBag.__session_id) ??
@@ -1604,6 +1901,28 @@ export async function onboardCommand(options) {
             });
             return { needsInput: true };
         }
+        const effectivePlannerProvider = plannerProviderSeed ?? defaults.plannerProvider;
+        const effectiveBuilderChoice = builderSeed ?? defaults.builder;
+        const effectiveReviewerChoice = reviewerSeed ?? defaults.reviewer;
+        const authIssues = await collectOnboardingAuthIssues({
+            config: raw,
+            plannerProvider: effectivePlannerProvider,
+            builderChoice: effectiveBuilderChoice,
+            reviewerChoice: effectiveReviewerChoice,
+        });
+        if (authIssues.length > 0) {
+            await emitNextQuestion({
+                workspaceDir: config.workspace_dir,
+                sessionId,
+                question: buildAuthQuestion(authIssues),
+                pendingQuestionIds: ['auth'],
+                answers: answerBag,
+                awaitingReview: false,
+                policy: needsInputPolicy,
+            });
+            return { needsInput: true };
+        }
+        delete answerBag.auth;
         const parsedReviewAction = parseReviewAction(asNonEmptyString(answerBag.__review_action));
         if (!parsedReviewAction) {
             const reviewQuestion = buildReviewQuestion({
@@ -1784,6 +2103,29 @@ export async function onboardCommand(options) {
     else if (raw.reviewer) {
         raw.reviewer = { ...raw.reviewer, enabled: false };
     }
+    const authIssues = await collectOnboardingAuthIssues({
+        config: raw,
+        plannerProvider,
+        builderChoice,
+        reviewerChoice,
+    });
+    if (authIssues.length > 0) {
+        if (input.isTTY) {
+            printAuthIssues(authIssues);
+            throw new Error('Authentication required. Complete the steps above, then rerun onboarding.');
+        }
+        await emitNextQuestion({
+            workspaceDir: config.workspace_dir,
+            sessionId,
+            question: buildAuthQuestion(authIssues),
+            pendingQuestionIds: ['auth'],
+            answers: answerBag,
+            awaitingReview: false,
+            policy: needsInputPolicy,
+        });
+        return { needsInput: true };
+    }
+    delete answerBag.auth;
     // Ensure PRD is runner-owned (protects from builder edits)
     if (Array.isArray(raw.runner.runner_owned_globs) && !raw.runner.runner_owned_globs.includes(`${config.workspace_dir}/PRD.md`)) {
         raw.runner.runner_owned_globs = [...raw.runner.runner_owned_globs, `${config.workspace_dir}/PRD.md`];
@@ -1813,7 +2155,7 @@ export async function onboardCommand(options) {
     console.log(`- Planner: ${plannerProvider} (${orchestratorModel})`);
     console.log(`- Reviewer: ${raw.reviewer?.enabled ? 'enabled' : 'disabled'}`);
     await runConnectivityChecks(raw);
-    const roadmapPath = join(dirname(configPath), 'ROADMAP.json');
+    const roadmapPath = join(config.workspace_dir, 'ROADMAP.json');
     let existingPrdContent = '';
     try {
         existingPrdContent = (await readFile(prdPath, 'utf-8')).trim();
@@ -1826,7 +2168,7 @@ export async function onboardCommand(options) {
         const draftResult = await generateRoadmapDraft(raw, mode);
         if (draftResult.draft) {
             await writeFile(roadmapPath, `${JSON.stringify(draftResult.draft, null, 2)}\n`, 'utf-8');
-            printRoadmapPreview(draftResult.draft);
+            printRoadmapPreview(draftResult.draft, roadmapPath);
             console.log(`- Saved: ${roadmapPath}`);
         }
         else {
@@ -1841,7 +2183,7 @@ export async function onboardCommand(options) {
     const shouldRunNow = input.isTTY
         ? await promptYesNo(`Start now with mode '${mode}'?`, autoRunRequested)
         : nonInteractiveStartNow;
-    await maybeStartRun(raw, mode, shouldRunNow);
+    await maybeStartRun(raw, mode, shouldRunNow, configPath);
     return { needsInput: false };
 }
 //# sourceMappingURL=onboard.js.map