@ttfw/envoi 1.0.0

package/dist/commands/idea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idea.js","sourceRoot":"","sources":["../../src/commands/idea.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Initialize Envoi workspace in the current directory.
+ *
+ * Creates the directory structure, copies templates, and sets up configuration.
+ */
+/**
+ * Initializes an Envoi workspace in the current directory.
+ *
+ * @param options - Command options
+ * @param options.force - Overwrite existing files
+ * @param options.workspaceDir - Workspace directory name (default: 'envoi')
+ */
+export declare function initCommand(options?: {
+    force?: boolean;
+    workspaceDir?: string;
+    showNextSteps?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoWH;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+IlI"}

package/dist/commands/init.js

@@ -0,0 +1,423 @@
+/**
+ * Initialize Envoi workspace in the current directory.
+ *
+ * Creates the directory structure, copies templates, and sets up configuration.
+ */
+import { mkdir, copyFile, access, readFile, writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { addEnvoiIgnores, getEnvoiGitignoreEntries } from '../lib/gitignore.js';
+import { atomicWriteJson } from '../lib/fs.js';
+import { getGitTopLevel, isGitRepo } from '../lib/git.js';
+import { CLI_NAME, CONFIG_FILE_NAME, PRODUCT_NAME, WORKSPACE_DIR_NAME } from '../lib/branding.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Path to package assets (prompts/schemas templates)
+ */
+const ASSET_PACKAGE_ROOT = join(__dirname, '../../relais');
+/**
+ * Prompts to copy from package prompts to workspace
+ */
+const PROMPTS_TO_COPY = [
+    'orchestrator.system.txt',
+    'orchestrator.user.txt',
+    'builder.system.txt',
+    'builder.user.txt',
+    'reviewer.system.txt',
+    'reviewer.user.txt',
+];
+/**
+ * Schemas to copy from package schemas to workspace
+ */
+const SCHEMAS_TO_COPY = [
+    'task.schema.json',
+    'builder_result.schema.json',
+    'report.schema.json',
+    'reviewer_result.schema.json',
+];
+/**
+ * Default STATE.json content for new workspace
+ */
+function createInitialState() {
+    return {
+        v: 3,
+        phase: 'IDLE',
+        mode: 'single',
+        task: null,
+        milestone: null,
+        branch: 'main',
+        batch_tasks: [],
+        attempt: 0,
+        blockers: [],
+        next: null,
+        ts: new Date().toISOString(),
+        milestone_id: null,
+        budgets: {
+            ticks: 0,
+            orchestrator_calls: 0,
+            builder_calls: 0,
+            verify_runs: 0,
+        },
+        budget_warning: false,
+        last_run_id: null,
+        last_verdict: null,
+        idea_inbox: [],
+        planning_digest: null,
+        open_product_questions: [],
+    };
+}
+/**
+ * Checks if a file or directory exists
+ */
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function writeTextFileSafe(dest, contents, force) {
+    if (await exists(dest)) {
+        if (!force) {
+            return { written: false, reason: `File already exists: ${dest} (use --force to overwrite)` };
+        }
+    }
+    await mkdir(dirname(dest), { recursive: true });
+    await writeFile(dest, contents, 'utf-8');
+    return { written: true };
+}
+/**
+ * Detects the package manager based on lockfiles present in the directory.
+ *
+ * @param repoRoot - The repository root directory to check
+ * @returns The detected package manager: 'pnpm', 'npm', 'yarn', 'bun', or 'pnpm' as default
+ */
+async function detectPackageManager(repoRoot) {
+    // Check in order of preference (pnpm-workspace.yaml first, then lockfiles)
+    if (await exists(join(repoRoot, 'pnpm-workspace.yaml'))) {
+        return 'pnpm';
+    }
+    if (await exists(join(repoRoot, 'pnpm-lock.yaml'))) {
+        return 'pnpm';
+    }
+    if (await exists(join(repoRoot, 'package-lock.json'))) {
+        return 'npm';
+    }
+    if (await exists(join(repoRoot, 'yarn.lock'))) {
+        return 'yarn';
+    }
+    if (await exists(join(repoRoot, 'bun.lockb'))) {
+        return 'bun';
+    }
+    // Default to pnpm if no lockfile found
+    return 'pnpm';
+}
+/**
+ * Checks if pnpm workspace is configured (pnpm-workspace.yaml exists).
+ *
+ * @param repoRoot - The repository root directory to check
+ * @returns true if pnpm-workspace.yaml exists
+ */
+async function isPnpmWorkspace(repoRoot) {
+    return await exists(join(repoRoot, 'pnpm-workspace.yaml'));
+}
+/**
+ * Generates verification template args based on package manager and workspace detection.
+ *
+ * @param pkgManager - The detected package manager
+ * @param isWorkspace - Whether this is a pnpm workspace
+ * @returns Array of args for the verification command
+ */
+function getVerificationArgs(pkgManager, isWorkspace) {
+    if (pkgManager === 'pnpm') {
+        return isWorkspace ? ['-w'] : [];
+    }
+    // npm, yarn, and bun don't have workspace flags in the same way
+    return [];
+}
+/**
+ * Gets the command name for the package manager.
+ *
+ * @param pkgManager - The detected package manager
+ * @returns The command name (e.g., 'pnpm', 'npm', 'yarn', 'bun')
+ */
+function getPackageManagerCommand(pkgManager) {
+    return pkgManager;
+}
+/**
+ * Copies a file from source to destination, optionally overwriting
+ */
+async function copyFileSafe(source, dest, force) {
+    if (!(await exists(source))) {
+        return { copied: false, reason: `Source file does not exist: ${source}` };
+    }
+    if (await exists(dest)) {
+        if (!force) {
+            return { copied: false, reason: `File already exists: ${dest} (use --force to overwrite)` };
+        }
+    }
+    // Ensure destination directory exists
+    await mkdir(dirname(dest), { recursive: true });
+    await copyFile(source, dest);
+    return { copied: true };
+}
+/**
+ * Reads the default config template and adjusts workspace_dir and verification templates
+ */
+async function createConfigFile(workspaceDir, force, repoRoot, pkgManager, isWorkspace) {
+    const configPath = join(repoRoot, CONFIG_FILE_NAME);
+    if (await exists(configPath) && !force) {
+        return { created: false, reason: `Config file already exists: ${configPath} (use --force to overwrite)` };
+    }
+    // Read the template from package root (prefer envoi config, fallback to legacy)
+    const primaryTemplatePath = join(ASSET_PACKAGE_ROOT, `../${CONFIG_FILE_NAME}`);
+    const legacyTemplatePath = join(ASSET_PACKAGE_ROOT, '../relais.config.json');
+    const templatePath = (await exists(primaryTemplatePath)) ? primaryTemplatePath : legacyTemplatePath;
+    if (!(await exists(templatePath))) {
+        // Fallback: create a minimal config
+        const minimalConfig = {
+            version: '1.0',
+            product_name: PRODUCT_NAME.toLowerCase(),
+            workspace_dir: workspaceDir,
+            runner: {
+                require_git: true,
+                max_tick_seconds: 900,
+                lockfile: `${workspaceDir}/lock.json`,
+                runner_owned_globs: [
+                    `${workspaceDir}/STATE.json`,
+                    `${workspaceDir}/TASK.json`,
+                    `${workspaceDir}/REPORT.json`,
+                    `${workspaceDir}/REPORT.md`,
+                    `${workspaceDir}/BLOCKED.json`,
+                    `${workspaceDir}/FACTS.md`,
+                    `${workspaceDir}/history/**`,
+                    `${workspaceDir}/lock.json`,
+                    `${workspaceDir}/schemas/**`,
+                    `${workspaceDir}/prompts/**`,
+                ],
+            },
+            claude_code_cli: {
+                command: 'claude',
+                output_format: 'json',
+                no_session_persistence: true,
+            },
+            models: {
+                orchestrator_model: 'opus',
+                orchestrator_fallback_model: 'sonnet',
+                builder_model: 'sonnet',
+                builder_fallback_model: 'haiku',
+            },
+        };
+        await atomicWriteJson(configPath, minimalConfig);
+        return { created: true };
+    }
+    // Read and adjust the template
+    const template = JSON.parse(await readFile(templatePath, 'utf-8'));
+    template.workspace_dir = workspaceDir;
+    // Adjust paths in runner_owned_globs
+    if (template.runner?.runner_owned_globs) {
+        template.runner.runner_owned_globs = template.runner.runner_owned_globs.map((glob) => glob.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`));
+    }
+    // Adjust lockfile path
+    if (template.runner?.lockfile) {
+        template.runner.lockfile = template.runner.lockfile.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    // Adjust prompt and schema paths
+    if (template.orchestrator?.system_prompt_file) {
+        template.orchestrator.system_prompt_file = template.orchestrator.system_prompt_file.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    if (template.orchestrator?.user_prompt_file) {
+        template.orchestrator.user_prompt_file = template.orchestrator.user_prompt_file.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    if (template.orchestrator?.task_schema_file) {
+        template.orchestrator.task_schema_file = template.orchestrator.task_schema_file.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    if (template.builder?.claude_code?.system_prompt_file) {
+        template.builder.claude_code.system_prompt_file = template.builder.claude_code.system_prompt_file.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    if (template.builder?.claude_code?.user_prompt_file) {
+        template.builder.claude_code.user_prompt_file = template.builder.claude_code.user_prompt_file.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    if (template.builder?.claude_code?.builder_result_schema_file) {
+        template.builder.claude_code.builder_result_schema_file = template.builder.claude_code.builder_result_schema_file.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    if (template.history?.dir) {
+        template.history.dir = template.history.dir.replace(/^(?:relais|envoi)\//, `${workspaceDir}/`);
+    }
+    // Adjust verification templates based on detected package manager and workspace
+    if (template.verification?.templates && Array.isArray(template.verification.templates)) {
+        const cmd = getPackageManagerCommand(pkgManager);
+        const baseArgs = getVerificationArgs(pkgManager, isWorkspace);
+        for (const templateItem of template.verification.templates) {
+            if (templateItem.cmd) {
+                templateItem.cmd = cmd;
+            }
+            if (Array.isArray(templateItem.args)) {
+                // Replace args, preserving any template params
+                const newArgs = [];
+                for (const arg of templateItem.args) {
+                    // If it's a workspace flag (-w), only include if isWorkspace
+                    if (arg === '-w' && !isWorkspace) {
+                        continue;
+                    }
+                    // If it's the command name, replace with detected package manager command
+                    if (arg === 'pnpm' || arg === 'npm' || arg === 'yarn' || arg === 'bun') {
+                        // Skip, we'll add base args separately
+                        continue;
+                    }
+                    // Keep other args (like 'lint', 'test', etc.)
+                    newArgs.push(arg);
+                }
+                // Prepend base args (workspace flag if needed)
+                templateItem.args = [...baseArgs, ...newArgs];
+            }
+        }
+    }
+    await atomicWriteJson(configPath, template);
+    return { created: true };
+}
+/**
+ * Initializes an Envoi workspace in the current directory.
+ *
+ * @param options - Command options
+ * @param options.force - Overwrite existing files
+ * @param options.workspaceDir - Workspace directory name (default: 'envoi')
+ */
+export async function initCommand(options = {}) {
+    const { force = false, workspaceDir = WORKSPACE_DIR_NAME, showNextSteps = true } = options;
+    // Determine repository root: use git top-level if in git, otherwise use current directory
+    let repoRoot;
+    if (isGitRepo()) {
+        const gitTopLevel = getGitTopLevel();
+        if (gitTopLevel) {
+            repoRoot = gitTopLevel;
+        }
+        else {
+            repoRoot = process.cwd();
+        }
+    }
+    else {
+        repoRoot = process.cwd();
+    }
+    // Detect package manager and workspace configuration
+    const pkgManager = await detectPackageManager(repoRoot);
+    const isWorkspace = await isPnpmWorkspace(repoRoot);
+    const workspacePath = join(repoRoot, workspaceDir);
+    const errors = [];
+    const skippedExisting = [];
+    // 1. Create directory structure
+    const directories = [
+        workspacePath,
+        join(workspacePath, 'prompts'),
+        join(workspacePath, 'schemas'),
+        join(workspacePath, 'history'),
+    ];
+    for (const dir of directories) {
+        try {
+            await mkdir(dir, { recursive: true });
+        }
+        catch (error) {
+            errors.push(`Failed to create directory ${dir}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // 2. Copy prompt templates
+    for (const prompt of PROMPTS_TO_COPY) {
+        const source = join(ASSET_PACKAGE_ROOT, 'prompts', prompt);
+        const dest = join(workspacePath, 'prompts', prompt);
+        const result = await copyFileSafe(source, dest, force);
+        if (!result.copied) {
+            if (result.reason?.includes('already exists')) {
+                skippedExisting.push(result.reason);
+            }
+            else {
+                errors.push(`Failed to copy ${prompt}: ${result.reason || 'Unknown error'}`);
+            }
+        }
+    }
+    // 3. Copy schema files
+    for (const schema of SCHEMAS_TO_COPY) {
+        const source = join(ASSET_PACKAGE_ROOT, 'schemas', schema);
+        const dest = join(workspacePath, 'schemas', schema);
+        const result = await copyFileSafe(source, dest, force);
+        if (!result.copied) {
+            if (result.reason?.includes('already exists')) {
+                skippedExisting.push(result.reason);
+            }
+            else {
+                errors.push(`Failed to copy ${schema}: ${result.reason || 'Unknown error'}`);
+            }
+        }
+    }
+    // 4. Initialize STATE.json
+    const statePath = join(workspacePath, 'STATE.json');
+    if (await exists(statePath) && !force) {
+        skippedExisting.push(`STATE.json already exists: ${statePath} (use --force to overwrite)`);
+    }
+    else {
+        try {
+            await atomicWriteJson(statePath, createInitialState());
+        }
+        catch (error) {
+            errors.push(`Failed to create STATE.json: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // 4b. Create FACTS.md + PRD.md placeholders (user-authored, runner-owned)
+    const factsPath = join(workspacePath, 'FACTS.md');
+    const prdPath = join(workspacePath, 'PRD.md');
+    const factsResult = await writeTextFileSafe(factsPath, `# FACTS\n\n(Short, curated facts about this repo. Keep it tight.)\n`, force);
+    if (!factsResult.written && factsResult.reason?.includes('already exists')) {
+        // Do not treat as fatal; it's expected on re-init without --force
+    }
+    else if (!factsResult.written && factsResult.reason) {
+        errors.push(factsResult.reason);
+    }
+    const prdResult = await writeTextFileSafe(prdPath, `# PRD\n\n(Paste the user PRD here. This is the source of truth.)\n`, force);
+    if (!prdResult.written && prdResult.reason?.includes('already exists')) {
+        // expected
+    }
+    else if (!prdResult.written && prdResult.reason) {
+        errors.push(prdResult.reason);
+    }
+    // 5. Create config file
+    const configResult = await createConfigFile(workspaceDir, force, repoRoot, pkgManager, isWorkspace);
+    if (!configResult.created && configResult.reason) {
+        if (configResult.reason.includes('already exists')) {
+            skippedExisting.push(configResult.reason);
+        }
+        else {
+            errors.push(`Failed to create config file: ${configResult.reason}`);
+        }
+    }
+    // 6. Add .gitignore entries
+    try {
+        await addEnvoiIgnores(repoRoot, getEnvoiGitignoreEntries(workspaceDir));
+    }
+    catch (error) {
+        errors.push(`Failed to update .gitignore: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Report errors
+    if (errors.length > 0) {
+        console.error('Errors during initialization:');
+        for (const error of errors) {
+            console.error(`  - ${error}`);
+        }
+        throw new Error(`Initialization failed with ${errors.length} error(s)`);
+    }
+    // 7. Print success message
+    const wasAlreadyInitialized = !force && skippedExisting.length > 0;
+    if (wasAlreadyInitialized) {
+        console.log(`${PRODUCT_NAME} workspace already initialized (kept existing files)\n`);
+    }
+    else {
+        console.log(`${PRODUCT_NAME} workspace initialized\n`);
+    }
+    if (showNextSteps) {
+        console.log('Next steps:');
+        console.log('  1. Run ' + CLI_NAME + ' start for guided onboarding');
+        console.log('  2. Or run ' + CLI_NAME + ' brief for PRD intake only');
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/mode.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Interactive (or flag-based) loop mode selection.
+ *
+ * Persists the default loop mode into envoi.config.json so users can re-run
+ * `envoi loop` without remembering flags.
+ */
+export type LoopMode = 'task' | 'milestone' | 'autonomous';
+export declare function modeCommand(options: {
+    configPath?: string;
+    set?: string;
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../src/commands/mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;AAuD3D,wBAAsB,WAAW,CAAC,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC/G"}

package/dist/commands/mode.js

@@ -0,0 +1,96 @@
+/**
+ * Interactive (or flag-based) loop mode selection.
+ *
+ * Persists the default loop mode into envoi.config.json so users can re-run
+ * `envoi loop` without remembering flags.
+ */
+import { resolve } from 'node:path';
+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, ConfigError, findConfigFile, loadConfig } from '../lib/config.js';
+import { CLI_NAME } from '../lib/branding.js';
+function describeMode(mode) {
+    switch (mode) {
+        case 'task':
+            return {
+                title: 'Task (small, controlled)',
+                desc: 'Stops when the orchestrator signals stop (good for short bursts).',
+            };
+        case 'milestone':
+            return {
+                title: 'Milestone (recommended default)',
+                desc: 'Stops when the milestone changes (good for iterative progress).',
+            };
+        case 'autonomous':
+            return {
+                title: 'Autonomous (hands-off)',
+                desc: 'Allows milestone changes (good for longer runs, higher drift risk).',
+            };
+    }
+}
+async function promptForMode(current) {
+    const rl = readline.createInterface({ input, output });
+    try {
+        console.log('\nChoose loop mode:');
+        const options = ['task', 'milestone', 'autonomous'];
+        options.forEach((m, i) => {
+            const meta = describeMode(m);
+            const suffix = current === m ? ' (current)' : '';
+            console.log(`  ${i + 1}. ${m} — ${meta.title}${suffix}`);
+            console.log(`     ${meta.desc}`);
+        });
+        const answer = (await rl.question(`Mode [1-3]${current ? ` (default ${current})` : ''}: `)).trim();
+        if (answer === '' && current)
+            return current;
+        const idx = Number.parseInt(answer, 10);
+        if (idx >= 1 && idx <= 3)
+            return options[idx - 1];
+        if (answer === 'task' || answer === 'milestone' || answer === 'autonomous')
+            return answer;
+        throw new Error('Invalid selection');
+    }
+    finally {
+        rl.close();
+    }
+}
+async function resolveConfigPath(configPath) {
+    if (configPath)
+        return resolve(configPath);
+    const found = await findConfigFile();
+    if (!found) {
+        throw new ConfigError(`Configuration file not found. Expected ${CONFIG_FILE_NAME} in current directory or parent directories.`);
+    }
+    return found;
+}
+export async function modeCommand(options) {
+    // Ensure config exists and is valid (also confirms we are in repo root via caller).
+    const config = await loadConfig(options.configPath);
+    const current = config.runner.default_loop_mode;
+    let next;
+    if (options.set) {
+        if (options.set !== 'task' && options.set !== 'milestone' && options.set !== 'autonomous') {
+            throw new Error(`Invalid mode: ${options.set}. Must be 'task', 'milestone', or 'autonomous'.`);
+        }
+        next = options.set;
+    }
+    else if (input.isTTY) {
+        next = await promptForMode(current);
+    }
+    else {
+        throw new Error('No --set provided and stdin is not a TTY (cannot prompt).');
+    }
+    const configPath = await resolveConfigPath(options.configPath);
+    const raw = await atomicReadJson(configPath);
+    raw.runner = { ...raw.runner, default_loop_mode: next };
+    await atomicWriteJson(configPath, raw);
+    if (options.json) {
+        console.log(JSON.stringify({ default_loop_mode: next }, null, 2));
+        return;
+    }
+    const meta = describeMode(next);
+    console.log(`\nDefault loop mode set to: ${next} — ${meta.title}`);
+    console.log(`Next: ${CLI_NAME} loop --mode ${next}`);
+    console.log(`Change again anytime: ${CLI_NAME} mode`);
+}
+//# sourceMappingURL=mode.js.map

package/dist/commands/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../src/commands/mode.ts"],"names":[],"mappings":"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"}

package/dist/commands/onboard.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Guided onboarding flow for Envoi.
+ *
+ * Goals:
+ * - Ensure workspace is initialized
+ * - Capture project brief (PRD)
+ * - Configure execution mode + builder + optional reviewer
+ * - Validate role connectivity
+ * - Generate initial roadmap snapshot
+ * - Optionally start execution immediately
+ */
+type PrdSource = 'file' | 'stdin' | 'existing' | 'paste' | 'editor' | 'skip';
+export declare function validateNonInteractiveOptions(options: {
+    mode?: string;
+    builder?: string;
+}): void;
+export declare function validateNonInteractivePrdCapture(prdCapture: {
+    text: string;
+    source: PrdSource;
+}): void;
+export declare function isMeaningfulPrdText(value: string): boolean;
+export declare const PRD_DISCOVERY_CANDIDATES: readonly ["PRD.md", "prd.md", "docs/PRD.md", "docs/prd.md", "specs/PRD.md", "product/PRD.md"];
+export declare function discoverLocalPrdCandidates(repoRoot: string): Promise<string[]>;
+export declare function extractRoadmapMilestones(prompt: string): string[];
+export declare function extractRoadmapQuestions(prompt: string): string[];
+export declare function onboardCommand(options: {
+    configPath?: string;
+    forceInit?: boolean;
+    prdFile?: string;
+    mode?: string;
+    builder?: string;
+    reviewer?: string;
+    showTourPrompt?: boolean;
+    autoRun?: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=onboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwBH,KAAK,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAyB7E,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBhG;AAED,wBAAgB,gCAAgC,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAWtG;AA+CD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAU1D;AAsED,eAAO,MAAM,wBAAwB,+FAO3B,CAAC;AAEX,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBpF;AA0ND,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBhE;AAuJD,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgNhB"}