@contentful/experience-design-system-cli 2.34.5-dev-build-d08439d.0 → 2.34.5-dev-build-5e798cb1.0

package/dist/src/import/orchestrator.d.ts

@@ -1,76 +0,0 @@
-import type { CompositionMode } from '../lib/composition-mode.js';
-export interface PipelineOptions {
-    project: string;
-    out: string;
-    spaceId?: string;
-    environmentId?: string;
-    cmaToken?: string;
-    agent: string;
-    model?: string;
-    bedrock?: boolean;
-    skipAnalyze: boolean;
-    skipGenerate: boolean;
-    print: boolean;
-    skipApply: boolean;
-    noCache: boolean;
-    yes: boolean;
-    verbose: boolean;
-    tokens?: string;
-    viewports?: string;
-    host?: string;
-    dryRun?: boolean;
-    excludeInvalid?: boolean;
-    selectAll?: boolean;
-    select?: string[];
-    deselect?: string[];
-    /** Forwarded to the spawned `analyze select-agent` subprocess. */
-    selectPromptPath?: string;
-    /** When true, auto-reject cycle participants and retry push instead of surfacing an error. */
-    autoRejectCycles?: boolean;
-    allowDeletions?: boolean;
-    compositionMode?: CompositionMode;
-    compositionMap?: string;
-    compositionAgent?: boolean;
-    compositionAgentMode?: string;
-    compositionRefresh?: boolean;
-    generateMap?: string;
-    promptOverrides?: string[];
-    skipMapTokens?: boolean;
-}
-export interface StepResult {
-    step: string;
-    status: 'complete' | 'failed' | 'skipped';
-    durationMs?: number;
-    reason?: string;
-    detail?: Record<string, unknown>;
-    error?: string;
-}
-export interface PipelineResult {
-    session: string;
-    project: string;
-    steps: StepResult[];
-    cycleError?: {
-        report: string[];
-    };
-}
-export declare function isSlotCycleError(result: {
-    exitCode: number;
-    stderr: string;
-}): boolean;
-export declare function extractCycleReport(stderr: string): string[];
-export declare function parseCycleComponentNames(report: string[]): string[];
-export declare function isPreviewValidationError(result: {
-    exitCode: number;
-    stderr: string;
-}): boolean;
-export declare function parseOffendingComponentNames(output: string): string[];
-export declare function buildPushStepResult(args: {
-    created: number;
-    updated: number;
-    failed: number;
-    durationMs: number;
-    stderr: string;
-    excludedByRetry: string[];
-    totalFailure?: boolean;
-}): StepResult;
-export declare function runPipeline(opts: PipelineOptions, progressWriter: (line: string) => void, cliPathOverride?: string): Promise<PipelineResult>;

package/dist/src/import/picker-dispatch.d.ts

@@ -1,28 +0,0 @@
-import type { RunPickerSelection } from '../runs/run-picker.js';
-import type { replayRun as replayRunFn, modifyRun as modifyRunFn } from '../runs/replay-helpers.js';
-import type { pickerPushRun as pickerPushRunFn } from '../runs/push-launcher.js';
-export type PickerDispatchOptions = {
-    spaceId?: string;
-    environmentId?: string;
-    cmaToken?: string;
-    host?: string;
-    interactive?: boolean;
-    outDir?: string;
-    overwrite?: boolean;
-    saveAsNew?: boolean;
-    force?: boolean;
-};
-export type PickerDispatchDeps = {
-    replayRun: typeof replayRunFn;
-    modifyRun: typeof modifyRunFn;
-    /**
-     * Interactive picker-Push launcher — mounts the wizard so the operator sees
-     * preview + push progress + view URL rather than a single-line summary.
-     * Optional so existing test fixtures that only stub {replayRun, modifyRun}
-     * still type-check; when omitted, picker-Push falls back to replayRun.
-     */
-    pickerPushRun?: typeof pickerPushRunFn;
-};
-export declare function buildPickerCredentialOptions(opts: Pick<PickerDispatchOptions, 'spaceId' | 'environmentId' | 'cmaToken' | 'host' | 'force'>): Pick<PickerDispatchOptions, 'spaceId' | 'environmentId' | 'cmaToken' | 'host' | 'force'>;
-export declare function buildPickerModifyOptions(opts: Pick<PickerDispatchOptions, 'outDir' | 'overwrite' | 'saveAsNew' | 'force'>): Pick<PickerDispatchOptions, 'outDir' | 'overwrite' | 'saveAsNew' | 'force'>;
-export declare function dispatchPickerSelection(selection: RunPickerSelection, opts: PickerDispatchOptions, deps: PickerDispatchDeps): Promise<void>;

package/dist/src/import/print-prompt.d.ts

@@ -1,34 +0,0 @@
-/**
- * `experiences import --print-prompt` / `--dry-run` — prompt-print helpers.
- *
- * Both flags currently surface the same behaviour: print the generate-prompt
- * (delegated downstream by the orchestrator via `generate components --dry-run`)
- * and exit before invoking the agent. `--print-prompt` is the new, explicit
- * name. `--dry-run` is preserved for one deprecation cycle: it keeps working
- * but emits a stderr notice signalling that its semantics will change in a
- * future release (to "manifest preview, no push", matching `apply push`'s
- * `--dry-run`).
- *
- * Keeping the routing in a small pure module lets the command surface stay
- * declarative and lets the deprecation notice be asserted from tests without
- * spawning the full pipeline.
- */
-export type PromptFlags = {
-    /** True when the user passed --dry-run. */
-    dryRun?: boolean;
-    /** True when the user passed --print-prompt. */
-    printPrompt?: boolean;
-};
-export type PromptFlagsResolution = {
-    /** Whether to forward `--dry-run` semantics to the downstream generate step. */
-    forwardDryRun: boolean;
-    /** Stderr message to emit, or null when the flags need no warning. */
-    deprecationNotice: string | null;
-};
-/**
- * Resolve the user's `--dry-run` / `--print-prompt` choice into the
- * downstream-forwarded dry-run boolean plus an optional deprecation message.
- * Pure (no IO) so it's trivially unit-testable; the caller writes the notice
- * to stderr.
- */
-export declare function resolvePromptFlags(flags: PromptFlags): PromptFlagsResolution;

package/dist/src/import/strip-allowed-components.d.ts

@@ -1,18 +0,0 @@
-import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-/**
- * Atomic-mode normalization (spec T8, option a): keep every slot's structure
- * but drop its `$allowedComponents` composition constraint. Applied over the
- * loaded component array regardless of source (`--session` or `--components`),
- * so the atomic bypass cannot leak a live composition link into the pushed
- * manifest. Starving `$allowedComponents` at this single point also makes
- * slot-cycle detection structurally return zero (see T12).
- *
- * Returns a new array with cloned entries; inputs are not mutated.
- */
-export declare function stripAllowedComponents(components: Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>): Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>;

package/dist/src/import/tui/auto-filter-error.d.ts

@@ -1 +0,0 @@
-export declare function buildAutoFilterErrorTail(raw: string): string;

package/dist/src/import/tui/components/AutoFilterBanner.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-export type AutoFilterStatus = 'idle' | 'running' | 'complete' | 'cancelled' | 'failed';
-export declare function AutoFilterBanner(props: {
-    status?: AutoFilterStatus;
-    progress?: {
-        done: number;
-        total: number;
-    } | null;
-    error?: string | null;
-}): React.ReactElement | null;

package/dist/src/import/tui/merge-ai-decisions.d.ts

@@ -1,5 +0,0 @@
-import type { ScopeComponent } from './steps/ScopeGateStep.js';
-export declare function mergeAiDecisions(components: ReadonlyArray<ScopeComponent>, aiDecisions: Record<string, {
-    decision: 'accepted' | 'rejected' | 'failed';
-    reason: string;
-}>): ScopeComponent[];

package/dist/src/import/tui/steps/AtomicGenerateReviewStep.d.ts

@@ -1,28 +0,0 @@
-import React from 'react';
-type GenerateReviewStepProps = {
-    extractSessionId: string;
-    tokenSessionId?: string | null;
-    onFinalize: (accepted: number, rejected: number, unresolved: number) => void;
-    onQuit: () => void;
-    /**
-     * Feature 2 (live preview after every save). When `true` (default), the
-     * wizard re-runs `previewImport` after each successful FieldEditor Ctrl+S
-     * (debounced 500ms) and refreshes the sidebar's previewAnnotation badges.
-     * Operator opts out via `experiences import --no-live-preview`.
-     */
-    livePreview?: boolean;
-    spaceId?: string;
-    environmentId?: string;
-    cmaToken?: string;
-    host?: string;
-    tokensPath?: string;
-    /**
-     * INTEG-4411 refined: initial value for the inline `finalizeError` banner.
-     * The wizard sets this when it routes back to `final-review` after the
-     * preview API returned an empty diff (pure no-op push). Cleared on the
-     * next `a` / `A` keystroke.
-     */
-    initialFinalizeError?: string | null;
-};
-export declare function AtomicGenerateReviewStep({ extractSessionId, tokenSessionId, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }: GenerateReviewStepProps): React.ReactElement;
-export {};

package/dist/src/import/tui/steps/AtomicScopeGateStep.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-import type { ScopeGateStepProps } from './ScopeGateStep.js';
-export declare function AtomicScopeGateStep({ components, onConfirm, onQuit, aiFilterStatus, aiFilterProgress, aiFilterError, onCancelAutoFilter, }: ScopeGateStepProps): React.ReactElement;

package/dist/src/import/tui/wizard-save-flow.d.ts

@@ -1,37 +0,0 @@
-import { type RunRecord } from '../../runs/store.js';
-import { type ConflictMode } from '../../runs/save-path-resolver.js';
-/**
- * Wizard save-flow orchestration helpers (Task 4 / spec part 1+2).
- *
- * Kept as a separate module so the logic is testable without rendering the
- * full Ink WizardApp.
- */
-export type PlanSaveFlowInput = {
-    /** Resolved default save path (e.g. `${project}/.contentful`). */
-    defaultPath: string;
-    /** When set, bypass the inline prompt entirely (`--out-dir` flag). */
-    outDirOverride?: string | undefined;
-    /**
-     * Headless conflict-resolution mode (`--on-conflict`). Only meaningful when
-     * `outDirOverride` is also set — otherwise we still need to prompt for the
-     * path interactively. When provided alongside an override, the conflict
-     * gate is bypassed and the mode is applied via `resolveSavePath`.
-     */
-    onConflict?: ConflictMode | undefined;
-};
-export type PlanSaveFlowOutput = {
-    kind: 'write';
-    path: string;
-} | {
-    kind: 'prompt';
-    defaultPath: string;
-} | {
-    kind: 'fail';
-    conflict: {
-        path: string;
-        files: string[];
-    };
-};
-export declare function planSaveFlow(input: PlanSaveFlowInput): Promise<PlanSaveFlowOutput>;
-export type RecordRunAfterSaveInput = Omit<RunRecord, 'id' | 'createdAt'>;
-export declare function recordRunAfterSave(input: RecordRunAfterSaveInput): Promise<RunRecord>;

package/dist/src/lib/composition-mode.d.ts

@@ -1,30 +0,0 @@
-export declare const COMPOSITION_MODES: readonly ["composite", "atomic"];
-export type CompositionMode = (typeof COMPOSITION_MODES)[number];
-export declare function isCompositionMode(value: string): value is CompositionMode;
-/**
- * Options that, when present, IMPLY composite mode — passing any of them is a
- * clear opt-in, so requiring an explicit `--composite` alongside is redundant.
- */
-export type CompositionSourceOptions = {
-    compositionMap?: string;
-    compositionAgent?: boolean;
-    compositionRefresh?: boolean;
-    generateMap?: string;
-};
-/**
- * Resolve the effective composition mode with precedence
- * `explicit flag > implied source > env > persisted config > default`.
- * Default is `atomic` (composition OFF); `--composite` opts into the hierarchy
- * machinery.
- *
- * `--atomic` is accepted for symmetry and wins when passed — even alongside a
- * composition source, since it's an explicit "no" that overrides the implicit
- * opt-in. If both `--composite` and `--atomic` are present, `--composite`
- * wins. Passing a composition source (`--composition-map/-agent`,
- * `--composition-refresh`, or `--generate-map`) implies composite without a
- * separate `--composite`.
- */
-export declare function resolveCompositionMode(opts: {
-    composite?: boolean;
-    atomic?: boolean;
-} & CompositionSourceOptions, configMode?: CompositionMode): CompositionMode;

package/dist/src/runs/export-helpers.d.ts

@@ -1,5 +0,0 @@
-import { findCliPath } from '../lib/cli-path.js';
-/** Internal test surface. Not part of the public API. */
-export declare const __testing: {
-    findCliPath: typeof findCliPath;
-};

package/dist/src/runs/ls-command.d.ts

@@ -1,12 +0,0 @@
-import type { Command } from 'commander';
-export type RunLsOptions = {
-    write?: (chunk: string) => void;
-    projectPath?: string;
-    limit?: number;
-    target?: string;
-    json?: boolean;
-    pushed?: boolean;
-    notPushed?: boolean;
-};
-export declare function runLsCommand(opts?: RunLsOptions): Promise<void>;
-export declare function registerRunsCommand(program: Command): void;

package/dist/src/runs/modify-launcher.d.ts

@@ -1,34 +0,0 @@
-/**
- * Thin indirection so `runModifyCommand` can be unit-tested without spinning
- * up the real Ink wizard. The production implementation lives here.
- */
-import type { CompositionMode } from '../lib/composition-mode.js';
-export type ModifyLauncherInput = {
-    extractSessionId: string;
-    generateSessionId: string | null;
-    /** Token session id from the run record; null when no tokens were
-     *  generated. Forwarded to the wizard so the modify entry pre-loads
-     *  tokens alongside the extract/generate sessions. */
-    tokenSessionId?: string | null;
-    /** Absolute path to the complete DTCG token catalog written for this run. */
-    tokensPath?: string | null;
-    projectPath: string;
-    savePath: string;
-    entryStep: 'scope-gate' | 'final-review';
-    saveMode: 'overwrite' | 'new' | 'prompt';
-    /** Composition mode from the run record, so the modify wizard resumes in the
-     *  same mode. Omitted → the wizard's default (`atomic`). */
-    compositionMode?: CompositionMode;
-    outDirOverride?: string;
-    /** Pre-fill space id (from the run record's pushedTo). */
-    initialSpaceId?: string;
-    /** Pre-fill environment id (from the run record's pushedTo). */
-    initialEnvironmentId?: string;
-    /** Pre-fill host (from the run record's pushedTo). */
-    initialHost?: string;
-    /** Pre-fill CMA token (from credentials.json / env). */
-    initialCmaToken?: string;
-    /** From `--allow-deletions` flag. Forwarded to wizard's push step. */
-    allowDeletions?: boolean;
-};
-export declare function launchModifyWizard(input: ModifyLauncherInput): Promise<void>;

package/dist/src/runs/picker-labels.d.ts

@@ -1,24 +0,0 @@
-export type LabelInput = {
-    id: string;
-    projectPath: string;
-};
-/**
- * Map each run to a display label. Labels start as the project path's leaf
- * directory and expand one segment at a time (`<parent>/<leaf>`,
- * `<gp>/<parent>/<leaf>`, …) until every label in the input set is unique.
- * When two rows share the exact same absolute path, the collision is broken
- * with numeric suffixes (`(#1)`, `(#2)`, …) in input order.
- */
-export declare function disambiguateLabels(runs: readonly LabelInput[]): Map<string, string>;
-/**
- * Format an ISO-8601 timestamp relative to `now`. Buckets:
- *   < 60s      → "just now"
- *   < 60 min   → "Nm ago"
- *   < 24 h     → "Nh ago"
- *   < 7 days   → "Nd ago"
- *   otherwise  → "YYYY-MM-DD HH:MM" (local time)
- *
- * Future timestamps (created after `now`) also render as "just now" — they
- * only occur with clock skew and the delta is not worth surfacing.
- */
-export declare function formatRelativeTime(iso: string, now?: Date): string;

package/dist/src/runs/push-creds-prompt.d.ts

@@ -1,25 +0,0 @@
-/**
- * Interactive credentials fallback for `experiences import --push-from-run`.
- *
- * The wizard ships a full `CredentialsStep` Ink component already — rather
- * than reimplementing the field-entry UI, we mount that step in a tiny Ink
- * app that resolves a promise once the operator confirms.
- *
- * Returns the four credential values (host comes back as a configured host
- * string, e.g. `api.contentful.com`).
- */
-export type CollectedCredentials = {
-    spaceId: string;
-    environmentId: string;
-    cmaToken: string;
-    host: string;
-};
-export type PromptForCredentialsOptions = {
-    initialSpaceId?: string;
-    initialEnvironmentId?: string;
-    initialCmaToken?: string;
-    initialHost?: string;
-    /** Short summary line rendered above the form. */
-    summary?: string;
-};
-export declare function promptForPushCredentials(opts?: PromptForCredentialsOptions): Promise<CollectedCredentials>;

package/dist/src/runs/push-helpers.d.ts

@@ -1,20 +0,0 @@
-export type PushSessionResult = {
-    ok: true;
-} | {
-    ok: false;
-    error: string;
-};
-export type PushSessionOptions = {
-    sessionId: string;
-    spaceId: string;
-    environmentId: string;
-    cmaToken: string;
-    host?: string;
-    allowDeletions?: boolean;
-};
-/**
- * Push a recorded pipeline.db session's components + tokens to Contentful by
- * shelling out to `experiences apply push --session <id>`. Does no local
- * file I/O — that is the whole point of --push-from-run.
- */
-export declare function pushRunSession(opts: PushSessionOptions): Promise<PushSessionResult>;

package/dist/src/runs/push-launcher.d.ts

@@ -1,52 +0,0 @@
-/**
- * Push-from-picker launcher. When the operator selects "Push" from the
- * interactive run-picker, we mount the wizard with seeded session IDs and
- * `initialStep: 'push-from-picker'` so they see the same preview + push UX
- * as a fresh `experiences import` (preview → diff review → pushing progress
- * bars → done with view URL).
- *
- * This is deliberately parallel to `modify-launcher.ts`. The `--push-from-run`
- * CLI flag path (headless shell-out via `replayRun`) is preserved for
- * scripted / non-TTY use.
- */
-export type PushLauncherInput = {
-    extractSessionId: string;
-    generateSessionId: string | null;
-    /** Token session id from the run record; null when no tokens were
-     *  generated. Forwarded to the wizard so preview picks up tokens too. */
-    tokenSessionId?: string | null;
-    projectPath: string;
-    savePath: string;
-    /** Absolute path to the run's tokens.json on disk (from the run record).
-     *  Forwarded to the wizard so runPreview can hydrate DTCG tokens without
-     *  re-emitting them to disk. Null when the run had no tokens. */
-    tokensPath?: string | null;
-    /** Pre-fill space id (from the run record's pushedTo or credentials.json). */
-    initialSpaceId?: string;
-    /** Pre-fill environment id (from the run record's pushedTo or credentials.json). */
-    initialEnvironmentId?: string;
-    /** Pre-fill host (from the run record's pushedTo or credentials.json). */
-    initialHost?: string;
-    /** Pre-fill CMA token (from credentials.json / env). */
-    initialCmaToken?: string;
-};
-export declare function launchPushWizard(input: PushLauncherInput): Promise<void>;
-export type PickerPushRunOptions = {
-    runIdOrPath: string;
-    /** From `--space-id` flag. */
-    spaceId?: string;
-    /** From `--environment-id` flag. */
-    environmentId?: string;
-    /** From `--cma-token` flag. */
-    cmaToken?: string;
-    /** From `--host` flag. */
-    host?: string;
-    /** When true, bypass the source/saved-file staleness check. */
-    force?: boolean;
-};
-/**
- * Interactive picker-Push entry point. Resolves the run record, applies the
- * staleness gate, layers credentials (flag → pushedTo → credentials.json),
- * and mounts the wizard via `launchPushWizard`.
- */
-export declare function pickerPushRun(opts: PickerPushRunOptions): Promise<void>;

package/dist/src/runs/replay-helpers.d.ts

@@ -1,71 +0,0 @@
-export type ReplayRunOptions = {
-    runIdOrPath: string;
-    /** From `--space-id` flag. */
-    spaceId?: string;
-    /** From `--environment-id` flag. */
-    environmentId?: string;
-    /** From `--cma-token` flag (or CONTENTFUL_MANAGEMENT_TOKEN env). */
-    cmaToken?: string;
-    /** From `--host` flag. */
-    host?: string;
-    /**
-     * When true (interactive TTY), prompt for missing credentials via the
-     * wizard's CredentialsStep. When false (non-TTY / CI), throw with the
-     * pinned error string from the spec.
-     */
-    interactive?: boolean;
-    /** When true, bypass the source/saved-file staleness check. */
-    force?: boolean;
-    /** From `--allow-deletions` flag. Forwarded verbatim to the pushed session's apply request. */
-    allowDeletions?: boolean;
-    /**
-     * Test seam: replace the interactive prompt with a deterministic resolver.
-     * The CLI surface never sets this; only used by tests.
-     */
-    promptForCredentials?: (need: {
-        spaceId?: string;
-        environmentId?: string;
-        cmaToken?: string;
-        host?: string;
-    }) => Promise<{
-        spaceId: string;
-        environmentId: string;
-        cmaToken: string;
-        host: string;
-    }>;
-};
-/**
- * Push a prior run's recorded pipeline.db session directly to Contentful
- * without re-running extraction or generation, and without writing any
- * components.json / tokens.json to disk.
- *
- * Exposed as `experiences import --push-from-run <id-or-path>`.
- *
- * Credentials resolution order:
- *   1. Flags on the command (`--space-id`, `--environment-id`, `--cma-token`,
- *      `--host`).
- *   2. The run record's `pushedTo` field (space / env / host only — the
- *      CMA token is never persisted).
- *   3. `~/.config/experiences/credentials.json` (the `experiences setup`
- *      store) and matching env vars.
- *   4. If still incomplete and interactive: open the wizard's existing
- *      credentials step. If non-TTY: error.
- */
-export declare function replayRun(opts: ReplayRunOptions): Promise<void>;
-export type ModifyRunOptions = {
-    runIdOrPath: string;
-    saveAsNew?: boolean;
-    overwrite?: boolean;
-    outDir?: string;
-    /** When true, bypass the source/saved-file staleness check. */
-    force?: boolean;
-    /** From `--allow-deletions` flag. Forwarded through the modify wizard's push step. */
-    allowDeletions?: boolean;
-};
-/**
- * Re-open the wizard with a prior run's extract/generate session pre-populated
- * so the operator can tweak fields. Exposed as
- * `experiences import --modify <id-or-path>`. Default entry step is
- * `final-review`.
- */
-export declare function modifyRun(opts: ModifyRunOptions): Promise<void>;

package/dist/src/runs/resolve-run-target.d.ts

@@ -1,12 +0,0 @@
-import { type RunRecord } from './store.js';
-/**
- * Decide whether a positional CLI arg refers to a run-id or a filesystem path,
- * then look up the corresponding RunRecord.
- *
- * Mirrors `git checkout` accepting either a sha or a ref: anything that *looks
- * like* a path is treated as one; otherwise we fall back to a run-id lookup.
- *
- * Path detection: arg starts with `/`, `./`, `../`, or `~/`, OR equals `.`,
- * OR equals `~`.
- */
-export declare function resolveRunTarget(arg: string): Promise<RunRecord>;

package/dist/src/runs/run-picker-mount.d.ts

@@ -1,46 +0,0 @@
-import { type RunRecord } from './store.js';
-/**
- * Flags whose presence suppresses the run-picker. The picker is meant for the
- * fresh interactive `experiences import` entry point; any flag that already
- * routes the wizard down a non-default path means the operator has been
- * specific about intent, so we honor that and skip silently.
- *
- * Flag names match the camelCase option object commander hands to the action
- * handler (see `command.ts`).
- */
-export type RunPickerFlags = {
-    pushFromRun?: string;
-    modify?: string;
-    /** Set only when the operator explicitly passed `--project`. */
-    project?: string;
-    autoAcceptScope?: boolean;
-    printPrompt?: boolean;
-    dryRun?: boolean;
-};
-export type ShouldShowRunPickerInput = {
-    flags: RunPickerFlags;
-    isTTY: boolean;
-    /** Absolute path to runs.json. Defaults to the platform-standard path. */
-    runsJsonPath?: string;
-};
-export type ShouldShowRunPickerResult = {
-    shouldShow: boolean;
-    runs: RunRecord[];
-};
-/**
- * Pure decision helper for whether the wizard should open with the run picker.
- *
- * Picker shows iff ALL hold:
- *   1. `~/.config/experiences/runs.json` exists
- *   2. The file has >=1 run entry
- *   3. None of `--push-from-run`, `--modify`, `--project`,
- *      `--auto-accept-scope`, `--print-prompt`, or `--dry-run` were passed
- *   4. stdin is a TTY
- *
- * On any failure (including ENOENT or a parse error), the helper returns
- * `{ shouldShow: false, runs: [] }`. We deliberately swallow parse errors
- * here: the wizard's normal entry point is more important than surfacing a
- * malformed runs.json — the operator can still use `experiences runs ls` to
- * diagnose later.
- */
-export declare function shouldShowRunPicker(input: ShouldShowRunPickerInput): Promise<ShouldShowRunPickerResult>;

package/dist/src/runs/run-picker.d.ts

@@ -1,18 +0,0 @@
-import React from 'react';
-import type { RunRecord } from './store.js';
-type RunPickerAction = 'push' | 'modify' | 'new';
-export type RunPickerSelection = {
-    /** null only when `action === 'new'`. */
-    runId: string | null;
-    action: RunPickerAction;
-};
-export type RunPickerProps = {
-    runs: RunRecord[];
-    /** Optional set of run ids that have been classified stale by the
-     *  invalidation check. Rows in this set render with a dim "(stale)" tag. */
-    staleRunIds?: ReadonlySet<string>;
-    onSelect: (selection: RunPickerSelection) => void;
-    onCancel: () => void;
-};
-export declare function RunPicker({ runs, staleRunIds, onSelect, onCancel }: RunPickerProps): React.ReactElement;
-export {};

package/dist/src/runs/staleness.d.ts

@@ -1,38 +0,0 @@
-import type { RunRecord } from './store.js';
-export type Staleness = {
-    stale: boolean;
-    /** Component names whose source file's mtime no longer matches the
-     *  recorded fingerprint. */
-    staleComponents: string[];
-    /** True when the raw tokens file's mtime OR content hash drifted (or the
-     *  file went missing). */
-    staleTokens: boolean;
-    /** True when components.json on disk differs from the hash recorded at
-     *  save time, OR the file is missing. */
-    savedComponentsEdited: boolean;
-    /** True when tokens.json on disk differs from the hash recorded at save
-     *  time, OR the file is missing while a hash was recorded. */
-    savedTokensEdited: boolean;
-    /** Absolute paths of source files that were fingerprinted but have since
-     *  disappeared. Empty when nothing is missing. */
-    missingSourceFiles: string[];
-};
-/**
- * Re-stat the source files and re-hash the saved artifacts captured by a
- * run record's fingerprints, and report what (if anything) drifted.
- *
- * Returns `stale: false` when the run is missing a source fingerprint
- * entirely (v2 records pre-dating runs.json v3 — treat as UNKNOWN, not
- * stale, so existing runs keep replaying).
- */
-export declare function checkRunStaleness(run: RunRecord): Promise<Staleness>;
-/**
- * Render a short human-readable summary of a Staleness result, e.g.
- * `src: 3, tokens, saved`. Returns the empty string when not stale.
- */
-export declare function shortStalenessSummary(s: Staleness): string;
-/**
- * Render a multi-line detail block for staleness output (used by `runs <id>`
- * detail view and replay refusals). Caps long lists at 5 entries.
- */
-export declare function formatStalenessDetail(s: Staleness): string[];

package/dist/src/runs/wizard-launcher.d.ts

@@ -1,2 +0,0 @@
-import type { WizardAppProps } from '../import/tui/WizardApp.js';
-export declare function launchWizard(props: WizardAppProps): Promise<void>;