@gurulu/cli 0.4.6 → 1.0.0

package/dist/commands/install.d.ts

@@ -1,259 +0,0 @@
-/**
- * Phase 16 A2 — `gurulu install` user-facing auto-install command.
- *
- * Runs the full bootstrap loop against a target repo:
- *   1. scan            (scripts/gurulu-scan.mjs)
- *   2. confirm         (interactive, skipped with --yes)
- *   3. agentic plan    (scripts/gurulu-agentic-install.mjs --dry-run)
- *   4. apply           (scripts/gurulu-agentic-install.mjs --apply)
- *   5. npm install     (pm detected from lockfile)
- *   6. .env merge      (.env.local for Next.js, .env otherwise)
- *   7. ingest ping     (POST <ingestUrl>/api/ingest/v1/health)
- *
- * The command is designed so the flow orchestration (`runInstallFlow`) can
- * be unit-tested with injected deps — no real spawns or fetches required.
- */
-import { type ActiveProfile } from '../config';
-import { type InstallIntent, type ProposalDecision, type ProposalIo } from '../install-intent-proposal';
-export interface InstallArgs {
-    path?: string;
-    siteId?: string;
-    tenantId?: string;
-    framework?: string;
-    dryRun?: boolean;
-    skipNpm?: boolean;
-    skipEnv?: boolean;
-    yes?: boolean;
-    ingestUrl?: string;
-    verify?: boolean;
-    profile?: string;
-    site?: string;
-    publishableKey?: string;
-    apply?: boolean;
-    rollback?: boolean;
-    skipIntent?: boolean;
-    intentDryRun?: boolean;
-    verticalHint?: string;
-    autoInstrument?: boolean;
-    autoProperties?: boolean;
-    /** Internal: path to the serialized intent JSON forwarded to the agentic-install script. */
-    intentResultPath?: string;
-    /**
-     * Internal: API token (active profile secret key) forwarded to the
-     * agentic-install script as `--token`. The script's `tryLlmExtraction`
-     * needs this to call the LLM property-extraction endpoint; without it
-     * extraction silently 401s and every injected `gurulu.track(...)` ends
-     * up with `// TODO: <prop>` placeholders. See Sprint A fix A2.
-     */
-    authToken?: string;
-    /** Sprint E1.5 — explicit workspace path inside an npm/pnpm/yarn workspace repo. */
-    workspace?: string;
-    /** FA-1 P0-2 — override the tracker tag asset URL (self-hosted ingest). */
-    scriptSrc?: string;
-}
-export declare function resolveWorkspaceRoot(repoRoot: string, args: InstallArgs, deps: InstallDeps): Promise<string>;
-export interface IntentPreSeedResult {
-    ok: boolean;
-    proposalId?: string;
-    created?: {
-        goals: number;
-        funnels: number;
-        milestones: number;
-        events?: number;
-    };
-    skipped?: {
-        goals: number;
-        funnels: number;
-    };
-    quotaExceeded?: boolean;
-    error?: string;
-}
-export interface IntentProposalDeps {
-    analyze: (signals: unknown) => Promise<InstallIntent>;
-    preSeed: (body: {
-        siteId: string;
-        intent: InstallIntent;
-        accepted: ProposalDecision['accepted'];
-        rejected: ProposalDecision['rejected'];
-    }) => Promise<IntentPreSeedResult>;
-    io?: ProposalIo;
-}
-export interface VerifyResult {
-    ok: boolean;
-    reason?: string | null;
-    pageViewSeen?: boolean;
-    capturedEventCount?: number;
-    [k: string]: any;
-}
-export interface ScanSummary {
-    framework: {
-        name: string;
-        version?: string;
-    };
-    orm: {
-        name: string;
-    };
-    auth: {
-        name: string;
-    };
-    routes: Array<{
-        path: string;
-        methods?: string[];
-        file?: string;
-    }>;
-    [k: string]: any;
-}
-export interface SpawnResult {
-    code: number;
-    stdout: string;
-    stderr: string;
-}
-export interface InstallDeps {
-    /** Spawn a subprocess (node <script> args...) and collect stdout/stderr. */
-    runNode: (args: string[], opts?: {
-        cwd?: string;
-        input?: string;
-    }) => Promise<SpawnResult>;
-    /** Spawn an arbitrary shell command and wait for exit. */
-    runCmd: (cmd: string, args: string[], opts?: {
-        cwd?: string;
-    }) => Promise<SpawnResult>;
-    /** Make an HTTP POST; must return `{ ok, status }`. */
-    fetchJson: (url: string, body: any) => Promise<{
-        ok: boolean;
-        status: number;
-    }>;
-    /** Interactive prompt. */
-    prompt: (question: string) => Promise<string>;
-    /** Optional live-smoke verifier (Phase 16 A3). Returns verifier result. */
-    verify?: (args: {
-        repoRoot: string;
-        framework: string;
-        siteId: string;
-        tenantId: string;
-        ingestUrl: string;
-        scriptsDir: string;
-    }) => Promise<VerifyResult>;
-    /** Logger (defaults to the ui helpers). */
-    log?: {
-        info: (msg: string) => void;
-        warn: (msg: string) => void;
-        error: (msg: string) => void;
-        step: (msg: string) => void;
-        success: (msg: string) => void;
-    };
-}
-export interface InstallSummary {
-    scan: ScanSummary | null;
-    framework: string | null;
-    planDiff: string;
-    filesChanged: number;
-    packageManager: 'pnpm' | 'yarn' | 'npm' | 'bun' | null;
-    packageInstalled: boolean;
-    envKeysWritten: string[];
-    ingestOk: boolean | null;
-    dryRun: boolean;
-    verify: VerifyResult | null;
-    rolledBack: boolean;
-    errors: string[];
-    partiallyInstalled?: boolean;
-    installedComponents?: string[];
-    intent?: {
-        skipped: boolean;
-        dryRun: boolean;
-        analyzed: boolean;
-        preSeeded: boolean;
-        proposalId?: string;
-        vertical?: string;
-        accepted?: {
-            events: number;
-            funnels: number;
-        };
-        created?: {
-            goals: number;
-            funnels: number;
-            milestones: number;
-            events?: number;
-        };
-        error?: string;
-    };
-    instrumentation?: {
-        enabled: boolean;
-        filesModified: number;
-        eventsInstrumented: number;
-        eventsSkipped: number;
-        notes?: string[];
-        error?: string;
-    };
-}
-/**
- * Locate the repo scripts/ directory (works when installed from source tree
- * or as a bundled package; falls back to GURULU_SCRIPTS_DIR env override).
- */
-export declare function resolveScriptsDir(startDir?: string): string;
-export declare function detectPackageManager(repoRoot: string): 'pnpm' | 'yarn' | 'npm' | 'bun';
-export declare function packageInstallArgs(pm: 'pnpm' | 'yarn' | 'npm' | 'bun'): string[];
-export interface EnvMergeResult {
-    file: string;
-    added: string[];
-    skipped: string[];
-}
-export declare function parseEnvFile(text: string): Set<string>;
-export declare function mergeEnvFile(repoRoot: string, framework: string, vars: Record<string, string>): EnvMergeResult;
-export declare function createDefaultDeps(scriptsDir: string): InstallDeps;
-export declare function runInstallFlow(args: InstallArgs, deps: InstallDeps, scriptsDir: string): Promise<InstallSummary>;
-export interface AuthenticatedInstallDeps {
-    profile: ActiveProfile;
-    sites: Array<{
-        id: string;
-        name: string | null;
-        domain: string;
-        publishableKey: string;
-    }>;
-    tenantId: string;
-    postVerify: (body: any) => Promise<{
-        ok: boolean;
-        status: number;
-    }>;
-    promptSelect?: (question: string, options: string[]) => Promise<number>;
-    prompt?: (question: string) => Promise<string>;
-    /** Phase 18.6 — intent analyze + pre-seed integrations. */
-    intent?: IntentProposalDeps;
-}
-export declare function isTelemetryDisabled(): boolean;
-/**
- * First-run consent prompt. Persists the decision so we never re-ask.
- * No-op when telemetry is already disabled, when a decision is already
- * recorded, or in non-interactive (`--yes` / `--no-interactive`) mode.
- */
-export declare function maybePromptTelemetryConsent(ask: (q: string) => Promise<string>, args?: {
-    yes?: boolean;
-}): Promise<void>;
-export declare function repoHashOf(repoRoot: string, remoteUrl?: string | null): string;
-export declare function pickSite(sites: AuthenticatedInstallDeps['sites'], target?: string): {
-    id: string;
-    name: string | null;
-    domain: string;
-    publishableKey: string;
-} | null;
-/** Send a telemetry POST. Never throws — quota errors are surfaced via `ok`. */
-export declare function emitInstallTelemetry(deps: AuthenticatedInstallDeps, payload: {
-    siteId: string;
-    status: 'dry-run' | 'applied' | 'verified' | 'failed' | 'rolled-back';
-    framework: string;
-    cliVersion: string;
-    repoHash: string;
-    errorMessage?: string | null;
-    /** Phase 18.7 B — optional auto-instrument summary. Backend treats as opt-in. */
-    instrumentation?: {
-        filesModified: number;
-        eventsInstrumented: number;
-        eventsSkipped: number;
-    };
-}): Promise<{
-    ok: boolean;
-    quotaExceeded: boolean;
-}>;
-export declare function detectCiEnv(env?: NodeJS.ProcessEnv): boolean;
-export declare function runAuthenticatedInstallFlow(args: InstallArgs, authDeps: AuthenticatedInstallDeps, installDeps: InstallDeps, scriptsDir: string): Promise<InstallSummary>;
-export declare function installCommand(args: InstallArgs): Promise<void>;