@contentful/experience-design-system-cli 2.43.1-dev-build-044e6594.0 → 2.43.1-dev-build-30e824d7.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.43.1-dev-build-044e6594.0",
+  "version": "2.43.1-dev-build-30e824d7.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/debug-store.d.ts

@@ -22,15 +22,23 @@ export declare function startDebugRun({ flow, step, menuOption, inputs, }: {
     flow: string;
     step: string;
     menuOption: string;
-    inputs: Record<string, unknown>;
+    /** What the step starts with. A step that writes a `summary` when it finishes leaves this out and puts its facts in the data. */
+    inputs?: Record<string, unknown>;
 }): void;
 /** Keeps what the open run has so far, in memory. It is only written if the run is cut short. */
 export declare function setDebugRunProgress(outputs: Record<string, unknown>): void;
 /** Resolves once every log that has been finished is on disk. */
 export declare function settleDebugLogs(): Promise<void>;
-export declare function finishDebugRun(args: {
+type FinishArgs = {
     outputs: Record<string, unknown>;
+    /**
+     * The facts for a person, one line each; a line indented by two spaces is a sub-point of the one above. With it the log
+     * has a Summary (for people) and a Data (for AI, the outputs) section that say the same thing twice. Without it the log
+     * keeps its Inputs and Outputs sections. The lines are written as given, so a step must not put a secret in one.
+     */
+    summary?: string[];
     status: Status;
     exitMethod: ExitMethod;
-}): Promise<void>;
+};
+export declare function finishDebugRun(args: FinishArgs): Promise<void>;
 export {};

package/dist/src/tui/import/steps/00-preflight/log.d.ts

@@ -0,0 +1,25 @@
+import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
+import { type AgentReadiness } from '@tui/settings/configuration/agents/agent-debug.js';
+import { type ImportTarget } from './logic.js';
+export type PreflightContext = {
+    settings: {
+        default_agent: AgentName;
+        base_dir_set: boolean;
+        analytics: boolean;
+    };
+    agents: Record<AgentName, AgentReadiness>;
+};
+/**
+ * The settings in effect and each agent's state. Collected while the user reads the screen, because the agent checks run
+ * a command each. Undefined when they cannot be read: logging must never get in the way of the import.
+ */
+export declare function collectPreflightContext(): Promise<PreflightContext | undefined>;
+export type TerminalSize = {
+    columns?: number;
+    rows?: number;
+};
+/** The log's two sections: `summary` for a person, `data` for AI, both carrying the same facts. */
+export declare function preflightLog(chosen: ImportTarget | null, terminal: TerminalSize, context: PreflightContext | undefined): {
+    summary: string[];
+    data: Record<string, unknown>;
+};

package/dist/src/tui/import/steps/00-preflight/logic.d.ts

@@ -4,6 +4,8 @@ export declare const IMPORT_TARGET_OPTIONS: ReadonlyArray<{
     target: ImportTarget;
     label: string;
 }>;
+/** The words the user saw for a choice. The logs of the steps after the preflight say it, since it decides which steps run. */
+export declare function importModeLabel(target: ImportTarget): string;
 export declare function overviewFor(target: ImportTarget): readonly OverviewStep[];
 export type ImportStepId = 'project' | 'token-file' | 'path-validation' | 'credentials' | 'component-extraction' | 'token-generation' | 'scope-gate' | 'generation' | 'review' | 'save-push';
 export declare function stepsFor(target: ImportTarget): readonly ImportStepId[];

package/dist/src/tui/import/steps/01-welcome/log.d.ts

@@ -0,0 +1,13 @@
+import { type ImportTarget } from '../00-preflight/logic.js';
+/** The log's two sections: `summary` for a person, `data` for AI, both carrying the same facts. */
+export declare function welcomeLog({ mode, projectPath, initialPath, emptySubmits, }: {
+    mode: ImportTarget;
+    /** The path the user continued with, or null when they left the import. */
+    projectPath: string | null;
+    initialPath: string;
+    /** How many times Enter was pressed on an empty field, which does nothing and can look like a stuck screen. */
+    emptySubmits: number;
+}): {
+    summary: string[];
+    data: Record<string, unknown>;
+};

package/dist/src/tui/settings/configuration/agents/agent-debug.d.ts

@@ -1,5 +1,6 @@
 import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
 import type { Snapshot } from '@tui/shared/debug-trail.js';
+import { type AgentStatus } from './agent-status.js';
 import type { AgentConfig } from './agent-store.js';
 /**
  * The agent settings as flat text, for `diffSnapshots`: `default_agent`, then `<agent>.model` and `<agent>.binary` for
@@ -23,3 +24,12 @@ export type AgentEnvironment = {
  * spends a prompt.
  */
 export declare function describeAgents(config: AgentConfig): Promise<Record<AgentName, AgentEnvironment>>;
+export type AgentReadiness = {
+    status: AgentStatus;
+    version: string;
+};
+/**
+ * The one-word state the Agents list shows for every agent, with its version, for a log that needs to say which agents
+ * could run. Uses the quick checks only, so it never spends a prompt.
+ */
+export declare function agentReadiness(config: AgentConfig): Promise<Record<AgentName, AgentReadiness>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.43.1-dev-build-044e6594.0",
+  "version": "2.43.1-dev-build-30e824d7.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,7 +45,7 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-types": "2.43.1-dev-build-044e6594.0"
+    "@contentful/experience-design-system-types": "2.43.1-dev-build-30e824d7.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -59,7 +59,7 @@
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16",
-    "@contentful/experience-design-system-backend-pipeline": "2.43.1-dev-build-044e6594.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.43.1-dev-build-30e824d7.0"
   },
   "repository": {
     "type": "git",