@gurulu/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,429 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const init_1 = require("./commands/init");
+const login_1 = require("./commands/login");
+const auth_1 = require("./commands/auth");
+const logout_1 = require("./commands/logout");
+const whoami_1 = require("./commands/whoami");
+const config_1 = require("./commands/config");
+const sites_1 = require("./commands/sites");
+const api_keys_1 = require("./commands/api-keys");
+const events_1 = require("./commands/events");
+const status_1 = require("./commands/status");
+const doctor_1 = require("./commands/doctor");
+const add_server_1 = require("./commands/add-server");
+const install_1 = require("./commands/install");
+const warehouse_1 = require("./commands/warehouse");
+// Phase 19.5 W2 — Read-surface subcommands
+const audiences_1 = require("./commands/audiences");
+const destinations_1 = require("./commands/destinations");
+const alerts_1 = require("./commands/alerts");
+const insights_1 = require("./commands/insights");
+const warehouses_1 = require("./commands/warehouses");
+const experiments_1 = require("./commands/experiments");
+const identity_1 = require("./commands/identity");
+const playground_1 = require("./commands/playground");
+// Phase 20 W3 C4 — audit log tail/export
+const audit_1 = require("./commands/audit");
+// Gurulu Chat — NL → SQL analytics
+const chat_1 = require("./commands/chat");
+// Error tracking — source map upload
+const sourcemap_1 = require("./commands/sourcemap");
+// Phase 21 — database connect
+const db_1 = require("./commands/db");
+(0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+    .scriptName('gurulu')
+    .option('profile', { type: 'string', describe: 'Use a specific profile (default: personal)' })
+    .command('init', 'Set up Gurulu analytics in your project', (y) => y
+    .option('site-id', { type: 'string', describe: 'Site ID' })
+    .option('token', { type: 'string', describe: 'Site token' })
+    .option('framework', { type: 'string', describe: 'Override framework detection' })
+    .option('no-interactive', { type: 'boolean', describe: 'Non-interactive mode' })
+    .option('dry-run', { type: 'boolean', describe: 'Show what would be done' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => {
+    (0, init_1.initCommand)({
+        siteId: args['site-id'],
+        token: args.token,
+        framework: args.framework,
+        noInteractive: args['no-interactive'],
+        dryRun: args['dry-run'],
+        json: args.json,
+    });
+})
+    .command('login', 'Authenticate with your Gurulu account', (y) => y
+    .option('email', { type: 'string', describe: 'Email address' })
+    .option('secret-key', { type: 'string', describe: 'Secret key (gsk_live_... or gsk_test_...)' })
+    .option('api-key', { type: 'string', describe: 'Legacy flag (alias for --secret-key)' })
+    .option('no-interactive', { type: 'boolean', describe: 'Non-interactive mode' })
+    .option('keychain', { type: 'boolean', describe: 'Store secret in macOS Keychain if available' })
+    .option('api-base', { type: 'string', describe: 'Override API base URL' }), (args) => (0, login_1.loginCommand)({
+    profile: args.profile,
+    email: args.email,
+    secretKey: args['secret-key'],
+    apiKey: args['api-key'],
+    noInteractive: args['no-interactive'],
+    useKeychain: args.keychain,
+    apiBase: args['api-base'],
+}))
+    .command('auth', 'Authenticate via device-link flow (default) or --key for legacy manual', (y) => y
+    .option('key', { type: 'string', describe: 'Secret key (gsk_live_... or gsk_test_...) — legacy manual flow' })
+    .option('email', { type: 'string', describe: 'Email address (legacy flow)' })
+    .option('secret-key', { type: 'string', describe: 'Secret key (legacy flow alias for --key)' })
+    .option('no-browser', { type: 'boolean', describe: 'Do not auto-open the browser' })
+    .option('no-interactive', { type: 'boolean', describe: 'Non-interactive mode (legacy flow)' })
+    .option('keychain', { type: 'boolean', describe: 'Store secret in macOS Keychain if available' })
+    .option('api-base', { type: 'string', describe: 'Override API base URL' }), (args) => (0, auth_1.authCommand)({
+    profile: args.profile,
+    key: args.key,
+    email: args.email,
+    secretKey: args['secret-key'],
+    noInteractive: args['no-interactive'],
+    useKeychain: args.keychain,
+    apiBase: args['api-base'],
+    noBrowser: args['no-browser'],
+}))
+    .command('logout', 'Remove a stored profile', (y) => y
+    .option('all', { type: 'boolean', describe: 'Remove all profiles' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' }), (args) => (0, logout_1.logoutCommand)({
+    profile: args.profile,
+    all: args.all,
+    yes: args.yes,
+}))
+    .command('whoami', 'Show current authentication state', (y) => y.option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, whoami_1.whoamiCommand)({
+    profile: args.profile,
+    json: args.json,
+}))
+    .command('config <action> [name]', 'Manage CLI profiles', (y) => y
+    .positional('action', {
+    type: 'string',
+    describe: 'list | show | set-default | path',
+})
+    .positional('name', { type: 'string', describe: 'Profile name (for show / set-default)' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, config_1.configCommand)({
+    action: args.action,
+    name: args.name,
+    json: args.json,
+}))
+    .command('sites <action> [target]', 'Manage sites (list, create, show, delete, rotate-token)', (y) => y
+    .positional('action', {
+    type: 'string',
+    describe: 'list | create | show | delete | rotate-token',
+})
+    .positional('target', { type: 'string', describe: 'Site name or id' })
+    .option('name', { type: 'string', describe: 'Site name (for create)' })
+    .option('domain', { type: 'string', describe: 'Site domain (for create)' })
+    .option('json', { type: 'boolean', describe: 'JSON output' })
+    .option('archived', { type: 'boolean', describe: 'Include archived sites' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' }), (args) => (0, sites_1.sitesCommand)({
+    action: args.action,
+    target: args.target,
+    name: args.name,
+    domain: args.domain,
+    json: args.json,
+    archived: args.archived,
+    yes: args.yes,
+    profile: args.profile,
+}))
+    .command('api-keys <action> [id]', 'Manage API keys (list, create, revoke, rotate)', (y) => y
+    .positional('action', {
+    type: 'string',
+    describe: 'list | create | revoke | rotate',
+})
+    .positional('id', { type: 'string', describe: 'API key id (for revoke/rotate)' })
+    .option('name', { type: 'string', describe: 'Key name (for create)' })
+    .option('mode', { type: 'string', choices: ['live', 'test'], describe: 'Key mode' })
+    .option('scopes', { type: 'string', describe: 'Comma-separated scopes' })
+    .option('filter-mode', { type: 'string', choices: ['live', 'test'], describe: 'Filter list by mode' })
+    .option('json', { type: 'boolean', describe: 'JSON output' })
+    .option('format', { type: 'string', describe: 'Output format (json)' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' }), (args) => (0, api_keys_1.apiKeysCommand)({
+    action: args.action,
+    id: args.id,
+    name: args.name,
+    mode: args.mode,
+    scopes: args.scopes,
+    filterMode: args['filter-mode'],
+    json: args.json,
+    format: args.format,
+    yes: args.yes,
+    profile: args.profile,
+}))
+    .command('events <action>', 'View events ingested by Gurulu (list, tail)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | tail' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('event-name', { type: 'string', describe: 'Filter by event name' })
+    .option('filter', { type: 'string', describe: 'Filter expression (event_name:...)' })
+    .option('since', { type: 'string', describe: 'ISO timestamp or 1h/24h/7d' })
+    .option('limit', { type: 'number', describe: 'Max rows (1..500)' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => {
+    (0, events_1.eventsCommand)({
+        action: args.action,
+        site: args.site,
+        eventName: args['event-name'],
+        filter: args.filter,
+        since: args.since,
+        limit: args.limit,
+        json: args.json,
+        profile: args.profile,
+    });
+})
+    .command('status', 'Check SDK health and connection', (y) => y
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => {
+    (0, status_1.statusCommand)({ site: args.site, json: args.json });
+})
+    .command('doctor', 'Diagnose setup issues', (y) => y
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => {
+    (0, doctor_1.doctorCommand)({ site: args.site, json: args.json });
+})
+    .command('add-server', 'Add server-side SDK to your project', (y) => y
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('no-interactive', { type: 'boolean', describe: 'Non-interactive mode' })
+    .option('dry-run', { type: 'boolean', describe: 'Show what would be done' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => {
+    (0, add_server_1.addServerCommand)({
+        site: args.site,
+        noInteractive: args['no-interactive'],
+        dryRun: args['dry-run'],
+        json: args.json,
+    });
+})
+    .command('install [path]', 'Install Gurulu tracker in a repository', (y) => y
+    .positional('path', { type: 'string', describe: 'Target project path (default: cwd)' })
+    .option('site', { type: 'string', describe: 'Site name or id (authenticated mode)' })
+    .option('site-id', { type: 'string', describe: 'Site ID (legacy fallback)' })
+    .option('tenant-id', { type: 'string', describe: 'Tenant ID (legacy fallback)' })
+    .option('publishable-key', { type: 'string', describe: 'Publishable key (legacy)' })
+    .option('framework', { type: 'string', describe: 'Override framework' })
+    .option('dry-run', { type: 'boolean', describe: 'Show plan without applying' })
+    .option('apply', { type: 'boolean', describe: 'Apply pending patches' })
+    .option('rollback', { type: 'boolean', describe: 'Rollback previously-applied patches' })
+    .option('skip-npm', { type: 'boolean', describe: 'Skip package manager install step' })
+    .option('skip-env', { type: 'boolean', describe: 'Skip .env file merge' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Non-interactive (assume yes)' })
+    .option('ingest-url', { type: 'string', describe: 'Override ingest base URL' })
+    .option('verify', { type: 'boolean', describe: 'Live smoke test after install' })
+    .option('skip-intent', { type: 'boolean', describe: 'Skip install-time intent discovery' })
+    .option('intent-dry-run', { type: 'boolean', describe: 'Show intent proposal without pre-seeding' })
+    .option('vertical', { type: 'string', describe: 'Vertical hint for intent analyzer' })
+    // BEGIN: Agent B (Phase 18.7) — auto-instrument opt-in flag
+    .option('auto-instrument', {
+    type: 'boolean',
+    description: 'Also auto-instrument route handlers with gurulu.track() calls (opt-in)',
+    default: false,
+})
+    .option('auto-properties', {
+    type: 'boolean',
+    default: false,
+    description: 'Opt-in: ask Minimax to propose properties for each auto-instrumented handler (Phase 20 W1 A2)',
+}), 
+// END: Agent B (Phase 18.7)
+(args) => {
+    (0, install_1.installCommand)({
+        path: args.path,
+        site: args.site,
+        siteId: args['site-id'],
+        tenantId: args['tenant-id'],
+        publishableKey: args['publishable-key'],
+        framework: args.framework,
+        dryRun: args['dry-run'],
+        apply: args.apply,
+        rollback: args.rollback,
+        skipNpm: args['skip-npm'],
+        skipEnv: args['skip-env'],
+        yes: args.yes,
+        ingestUrl: args['ingest-url'],
+        verify: args.verify,
+        profile: args.profile,
+        skipIntent: args['skip-intent'],
+        intentDryRun: args['intent-dry-run'],
+        verticalHint: args.vertical,
+        autoInstrument: args['auto-instrument'],
+        autoProperties: args['auto-properties'],
+    });
+})
+    .command('warehouse <action>', 'Warehouse exports (BigQuery)', (y) => y
+    .positional('action', { type: 'string', describe: 'Action: export' })
+    .option('tenant', { type: 'string', describe: 'Tenant id (forward-compat)' })
+    .option('export', { type: 'string', describe: 'Warehouse export id' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => {
+    if (args.action !== 'export') {
+        console.error(`Unknown warehouse action: ${args.action}`);
+        process.exit(1);
+    }
+    (0, warehouse_1.warehouseExportCommand)({
+        tenant: args.tenant,
+        export: args.export,
+        json: args.json,
+    });
+})
+    // ── Phase 19.5 W2 — read-surface subcommands ─────────────────────────
+    .command('audiences <action> [target]', 'View audiences (list, show)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show' })
+    .positional('target', { type: 'string', describe: 'Audience name or id' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, audiences_1.audiencesCommand)({
+    action: args.action,
+    target: args.target,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('destinations <action> [target]', 'View activation destinations (list, show)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show' })
+    .positional('target', { type: 'string', describe: 'Destination id' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, destinations_1.destinationsCommand)({
+    action: args.action,
+    target: args.target,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('alerts <action> [sub] [target]', 'View anomaly alerts (list, show <id>, channels list)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show | channels' })
+    .positional('sub', { type: 'string', describe: 'Subaction (e.g. list for channels)' })
+    .positional('target', { type: 'string', describe: 'Alert id (for show)' })
+    .option('severity', { type: 'string', describe: 'low | medium | high | critical' })
+    .option('acknowledged', { type: 'string', describe: 'true | false' })
+    .option('limit', { type: 'number', describe: 'Max rows (1..200)' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, alerts_1.alertsCommand)({
+    action: args.action,
+    sub: args.sub,
+    target: args.target,
+    severity: args.severity,
+    acknowledged: args.acknowledged,
+    limit: args.limit,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('insights <action>', 'View daily insights (today, history, weekly)', (y) => y
+    .positional('action', { type: 'string', describe: 'today | history | weekly' })
+    .option('days', { type: 'number', describe: 'History window in days (1..30)' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, insights_1.insightsCommand)({
+    action: args.action,
+    days: args.days,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('warehouses <action> [target]', 'View warehouse exports (list, runs <export-id>)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | runs' })
+    .positional('target', { type: 'string', describe: 'Warehouse export id' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, warehouses_1.warehousesCommand)({
+    action: args.action,
+    target: args.target,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('experiments <action> [target]', 'View experiments (list, show <key>, results <key>)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show | results' })
+    .positional('target', { type: 'string', describe: 'Experiment key or id' })
+    .option('conversion-event', { type: 'string', describe: 'Conversion event name' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, experiments_1.experimentsCommand)({
+    action: args.action,
+    target: args.target,
+    conversionEvent: args['conversion-event'],
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('identity <action> [sub]', 'View identity state (decay stats, transfers list, cdc-sources list)', (y) => y
+    .positional('action', { type: 'string', describe: 'decay | transfers | cdc-sources' })
+    .positional('sub', { type: 'string', describe: 'Subaction (stats, list)' })
+    .option('direction', { type: 'string', describe: 'outbound | inbound | all' })
+    .option('status', { type: 'string', describe: 'Filter by transfer status' })
+    .option('limit', { type: 'number', describe: 'Max rows' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, identity_1.identityCommand)({
+    action: args.action,
+    sub: args.sub,
+    direction: args.direction,
+    status: args.status,
+    limit: args.limit,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('playground <action>', 'View playground sessions (list)', (y) => y
+    .positional('action', { type: 'string', describe: 'list' })
+    .option('status', { type: 'string', describe: 'active | closed' })
+    .option('limit', { type: 'number', describe: 'Max rows (1..100)' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, playground_1.playgroundCommand)({
+    action: args.action,
+    status: args.status,
+    limit: args.limit,
+    json: args.json,
+    profile: args.profile,
+}))
+    // ── Phase 20 W3 C4 — audit log tail/export ───────────────────────────
+    .command('audit <action>', 'Stream or export the CLI audit log (tail, export)', (y) => y
+    .positional('action', { type: 'string', describe: 'tail | export' })
+    .option('since', { type: 'string', describe: 'ISO ts or 1h/24h/30d window' })
+    .option('limit', { type: 'number', describe: 'Max rows for export (1..10000)' })
+    .option('format', { type: 'string', describe: 'Export format (jsonl)' })
+    .option('json', { type: 'boolean', describe: 'Raw SSE frames for tail' }), (args) => (0, audit_1.auditCommand)({
+    action: args.action,
+    since: args.since,
+    limit: args.limit,
+    format: args.format,
+    json: args.json,
+    profile: args.profile,
+}))
+    // ── Gurulu Chat — NL → SQL analytics ─────────────────────────────────
+    .command('chat [question]', 'Ask analytics questions in natural language (NL → SQL)', (y) => y
+    .positional('question', { type: 'string', describe: 'Question to ask (omit for REPL mode)' })
+    .option('json', { type: 'boolean', describe: 'Machine-readable JSON output' })
+    .option('show-sql', { type: 'boolean', describe: 'Also print the generated SQL' })
+    .option('context', { type: 'string', describe: 'Additional context for the query' }), (args) => (0, chat_1.chatCommand)({
+    question: args.question,
+    json: args.json,
+    showSql: args['show-sql'],
+    context: args.context,
+    profile: args.profile,
+}))
+    // ── Error tracking — source map upload ────────────────────────────────
+    .command('sourcemap <action>', 'Upload source maps for error deobfuscation (upload)', (y) => y
+    .positional('action', { type: 'string', describe: 'upload' })
+    .option('release', { type: 'string', describe: 'Release version (e.g. v1.0.0)' })
+    .option('dir', { type: 'string', describe: 'Directory containing .map files' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, sourcemap_1.sourcemapCommand)({
+    action: args.action,
+    release: args.release,
+    dir: args.dir,
+    site: args.site,
+    json: args.json,
+    profile: args.profile,
+}))
+    // ── Phase 21 — database connect ────────────────────────────────────────
+    .command('db <action> [target]', 'Connect, list, sync, or remove database sources', (y) => y
+    .positional('action', { type: 'string', describe: 'connect | list | sync | remove' })
+    .positional('target', { type: 'string', describe: 'Source ID (for sync/remove)' })
+    .option('type', { type: 'string', describe: 'Database type: postgres | mysql' })
+    .option('host', { type: 'string', describe: 'Database host' })
+    .option('port', { type: 'number', describe: 'Database port' })
+    .option('database', { type: 'string', describe: 'Database name' })
+    .option('user', { type: 'string', describe: 'Database user' })
+    .option('password', { type: 'string', describe: 'Database password' })
+    .option('table', { type: 'string', describe: 'Table(s) to sync (comma-separated)' })
+    .option('schedule', { type: 'string', describe: 'Sync schedule: hourly | daily | manual' })
+    .option('no-interactive', { type: 'boolean', describe: 'Non-interactive mode' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, db_1.dbCommand)({
+    action: args.action,
+    target: args.target,
+    type: args.type,
+    host: args.host,
+    port: args.port,
+    database: args.database,
+    user: args.user,
+    password: args.password,
+    table: args.table,
+    schedule: args.schedule,
+    noInteractive: args['no-interactive'],
+    json: args.json,
+    profile: args.profile,
+}))
+    .demandCommand(1, 'Run gurulu --help for available commands')
+    .strict()
+    .help()
+    .version()
+    .parse();

package/dist/install-intent-proposal.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Phase 18.6 — CLI install-time intent proposal rendering + interaction.
+ *
+ * Pure UI logic (plus a small interactive loop) that turns an `InstallIntent`
+ * payload into a human-readable proposal and lets the user toggle individual
+ * events/funnels before sending the accepted subset to the backend. This file
+ * has NO hard limit on event/funnel count — a full iGaming intent with 20
+ * events is rendered in full.
+ *
+ * Testability: the render function returns a plain string so snapshot-style
+ * tests can assert structure. The interactive runner accepts injected I/O so
+ * tests can drive it without real stdin/stdout.
+ */
+export type Confidence = 'high' | 'medium' | 'low';
+export interface ProposedEvent {
+    name: string;
+    category: 'acquisition' | 'activation' | 'retention' | 'revenue' | 'referral' | 'compliance' | 'support' | 'engagement';
+    source: {
+        route?: string;
+        mutation?: string;
+        inferred?: boolean;
+        inferredFrom?: string;
+    };
+    properties: string[];
+    confidence: Confidence;
+    reasoning: string;
+}
+export interface ProposedFunnel {
+    name: string;
+    category: 'activation' | 'monetization' | 'retention' | 'compliance' | 'engagement';
+    steps: string[];
+    reasoning: string;
+}
+export interface InstallIntent {
+    vertical: string;
+    confidence: Confidence;
+    reasoning: string;
+    alternativeVerticals: Array<{
+        name: string;
+        confidence: Confidence;
+        note?: string;
+    }>;
+    events: ProposedEvent[];
+    funnels: ProposedFunnel[];
+    analyzerMode: 'llm' | 'heuristic';
+    modelVersion?: string;
+    promptVersion?: string;
+}
+export interface ProposalState {
+    intent: InstallIntent;
+    eventSelected: boolean[];
+    funnelSelected: boolean[];
+}
+export declare function initProposalState(intent: InstallIntent): ProposalState;
+/**
+ * Render the proposal to a plain string (TTY colour escapes applied by the
+ * caller if `colorize` is true). No truncation — every event/funnel is shown.
+ */
+export declare function renderProposal(state: ProposalState, opts?: {
+    colorize?: boolean;
+}): string;
+export interface ApplyCommandResult {
+    state: ProposalState;
+    done: boolean;
+    quit: boolean;
+}
+/**
+ * Apply a single user command to the proposal state. Exported so tests can
+ * exercise the state machine directly without any I/O.
+ */
+export declare function applyCommand(state: ProposalState, raw: string): ApplyCommandResult;
+export interface ProposalIo {
+    print: (line: string) => void;
+    prompt: (q: string) => Promise<string>;
+    isPiped: boolean;
+}
+export interface ProposalDecision {
+    accepted: {
+        events: ProposedEvent[];
+        funnels: ProposedFunnel[];
+    };
+    rejected: {
+        events: ProposedEvent[];
+        funnels: ProposedFunnel[];
+    };
+    quit: boolean;
+}
+export declare function splitDecision(state: ProposalState): ProposalDecision;
+export interface RunProposalOpts {
+    intent: InstallIntent;
+    io: ProposalIo;
+    /** If true (piped / --yes / CI), skip interactive loop and accept everything. */
+    nonInteractive?: boolean;
+}
+/**
+ * Drive the interactive proposal loop. Returns the accepted + rejected split
+ * plus a `quit` flag the caller uses to decide whether to continue the install.
+ */
+export declare function runProposal(opts: RunProposalOpts): Promise<ProposalDecision>;