@contentful/experience-design-system-cli 2.40.1-dev-build-46595419.0 → 2.40.1-dev-build-d17741e4.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.40.1-dev-build-46595419.0",
+  "version": "2.40.1-dev-build-d17741e4.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/import/steps/04-credentials/logic.d.ts

@@ -7,6 +7,28 @@ export type CredentialValues = Record<CredentialField, string>;
  */
 export declare function credentialsPurpose(tokensOnly: boolean): string;
 export declare function normalize(values: CredentialValues): CredentialValues;
-export declare function missingField(values: CredentialValues): boolean;
+/** The required fields that are still empty, by name. */
+export declare function missingFields(values: CredentialValues): CredentialField[];
 export declare function isUnchanged(current: CredentialValues, initial: CredentialValues): boolean;
+export type CredentialAttempt = {
+    host: string;
+    reason: string;
+};
+/**
+ * One rejected attempt as the log records it. The reason is scrubbed of the token first: an API error can echo what it
+ * was sent, so the message the user saw may contain it.
+ */
+export declare function rejectedAttempt(reason: string, credentials: CredentialValues): CredentialAttempt;
+/**
+ * The credentials as the log shows them. `cma_token` is the only key the token may be under: the logger reduces it to
+ * "present, N chars", which is enough to spot a truncated paste without writing the secret.
+ */
+export declare function credentialsLog(credentials: CredentialValues): Record<string, unknown>;
+/** The log's outputs: where the user ended up, the credentials, which fields they changed (names only), and the rejections. */
+export declare function credentialsOutputs({ outcome, credentials, initial, attempts, }: {
+    outcome: 'validated' | 'back';
+    credentials: CredentialValues;
+    initial: CredentialValues;
+    attempts: readonly CredentialAttempt[];
+}): Record<string, unknown>;
 export {};

package/dist/src/tui/import/steps/04-credentials/screen.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { ImportTarget } from '../00-preflight/logic.js';
 import { type CredentialValues } from './logic.js';
 import { type ValidationResult } from './validate.js';
 export type CredentialsResult = {
@@ -8,6 +9,8 @@ export type CredentialsResult = {
     skipped: true;
 };
 interface CredentialsScreenProps {
+    /** What the user chose to import at Preflight; it decides which steps run, so every log notes it. */
+    mode: ImportTarget;
     onDone: (result: CredentialsResult) => void;
     onBack: () => void;
     initial?: Partial<CredentialValues>;
@@ -15,5 +18,5 @@ interface CredentialsScreenProps {
     /** The import only generates tokens, so there are no components to look up in the space. */
     tokensOnly?: boolean;
 }
-export declare function CredentialsScreen({ onDone, onBack, initial, validate, tokensOnly, }: CredentialsScreenProps): React.ReactElement;
+export declare function CredentialsScreen({ mode, onDone, onBack, initial, validate, tokensOnly, }: CredentialsScreenProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/06-extraction/logic.d.ts

@@ -1,7 +1,20 @@
 import type { ExtractAndComposeProgress } from '@contentful/experience-design-system-backend-pipeline';
-import type { ExtractionProgress } from './types.js';
+import type { ExtractionInput, ExtractionProgress, ExtractionResult } from './types.js';
 /** Structured progress events emitted by the orchestrator (extraction + composition). */
 export type ProgressEvent = ExtractAndComposeProgress;
+/**
+ * What the debug log says the stage started with. The credentials come with the input, so the CMA token is only ever put
+ * under `cma_token`, which the logger reduces to "present, N chars" (or "not set" when the credentials were skipped).
+ */
+export declare function extractionLogInputs(input: ExtractionInput): Record<string, unknown>;
+/**
+ * How the stage ended. A failure names the step that failed and its message, scrubbed of the CMA token; the last progress
+ * says which of the parallel jobs had finished, failed or was still running.
+ */
+export declare function extractionLogOutputs(result: ExtractionResult, progress: ExtractionProgress | undefined, cmaToken: string): {
+    outputs: Record<string, unknown>;
+    status: 'success' | 'error';
+};
 /**
  * Every job the stage will run starts on the first frame, so no row appears later as a surprise. A job that does not
  * apply stays 'idle' and has no row: existing entities need credentials, and token definitions need a raw tokens file.

package/dist/src/tui/import/steps/07-scope-gate/log.d.ts

@@ -0,0 +1,8 @@
+import type { ScopeComponent, ScopeDecisions } from './types.js';
+/** What the gate starts with: how many components, and what the AI suggested for them. */
+export declare function scopeGateLogInputs(components: ScopeComponent[], tokenCount: number): Record<string, unknown>;
+/**
+ * What the user decided. Everything not accepted counts as rejected, so a component the AI accepted and the user never
+ * touched shows as left out. Components with the same name share one decision, so names are counted once.
+ */
+export declare function scopeGateLogOutputs(components: ScopeComponent[], decisions: ScopeDecisions): Record<string, unknown>;

package/dist/src/tui/import/steps/08-generation/logic.d.ts

@@ -1,4 +1,11 @@
-import type { GenerationProgress } from './types.js';
+import type { GenerationInput, GenerationProgress, GenerationResult } from './types.js';
+/** What the debug log says the stage started with. The counts are logged, not the lists of names. */
+export declare function generationLogInputs(input: GenerationInput): Record<string, unknown>;
+/** How the stage ended. A failure names the step that failed (save decisions, generate components, map tokens). */
+export declare function generationLogOutputs(result: GenerationResult, progress: GenerationProgress | undefined): {
+    outputs: Record<string, unknown>;
+    status: 'success' | 'error';
+};
 export declare function initialProgress(): GenerationProgress;
 export declare function shouldRunMapTokens(counts: {
     mappablePropCount: number;

package/dist/src/tui/import/steps/10-flow/flow/flow-log.d.ts

@@ -0,0 +1,21 @@
+import type { FlowState } from './types.js';
+type FlowStep = FlowState['step'];
+/** Where a step's log goes and what it is called. */
+export declare function flowStepRun(step: FlowStep): {
+    flow: string;
+    step: string;
+    menuOption: string;
+};
+/** What a step started with. The token is only ever under `cma_token`, which the logger reduces to "present, N chars". */
+export declare function flowStepInputs(state: FlowState): Record<string, unknown>;
+/**
+ * How a step ended. `to` is the state it moved to, or undefined when the import was left while the step was open. A step
+ * that ended by moving to the error screen is itself an error, with that screen's step and message, so a failed push or
+ * preview names its cause in its own log.
+ */
+export declare function flowStepOutputs(from: FlowState, to: FlowState | undefined): {
+    outputs: Record<string, unknown>;
+    status: 'success' | 'error';
+    exitMethod: 'saved' | 'discarded';
+};
+export {};

package/dist/src/tui/import/steps/10-flow/flow/use-flow-log.d.ts

@@ -0,0 +1,7 @@
+import type { FlowState } from './types.js';
+/**
+ * Writes a debug log for every step of the flow. When the step changes it finishes the log of the step that ended, with
+ * where it went next, and starts the next one; leaving the import finishes whichever step was open. One hook covers every
+ * screen after the review, so none of them has to log for itself.
+ */
+export declare function useFlowLog(state: FlowState): void;

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

@@ -1,5 +1,5 @@
 import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
-import type { Snapshot } from '../../shared/debug-trail.js';
+import type { Snapshot } from '@tui/shared/debug-trail.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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.40.1-dev-build-46595419.0",
+  "version": "2.40.1-dev-build-d17741e4.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.40.1-dev-build-46595419.0"
+    "@contentful/experience-design-system-types": "2.40.1-dev-build-d17741e4.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.40.1-dev-build-46595419.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.40.1-dev-build-d17741e4.0"
   },
   "repository": {
     "type": "git",