@contentful/experience-design-system-cli 2.32.1-dev-build-6b922ec.0 → 2.32.1-dev-build-b7d2d34.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.32.1-dev-build-6b922ec.0",
+  "version": "2.32.1-dev-build-b7d2d34.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,6 @@
   "dependencies": {
     "@contentful/experience-design-system-cli-v2": "workspace:*",
     "@contentful/experience-design-system-types": "workspace:*",
-    "@inkjs/ui": "^2.0.0",
     "@segment/analytics-node": "^3.0.0",
     "@vue/compiler-sfc": "^3.5.31",
     "commander": "^13.1.0",

package/dist/src/credentials-store.d.ts

@@ -6,13 +6,36 @@ export type ExperiencesCredentials = {
     host?: string;
     agent?: string;
     agentModel?: string;
+    /** Feature 8: persisted custom prompt path for `analyze select-agent`. */
     selectPromptPath?: string;
+    /** Feature 8: persisted custom prompt path for `generate components`. */
     generatePromptPath?: string;
     autoFilter?: boolean;
+    /** Feature: default debug-mode (writes JSONL trace of every decision) for all commands. */
     debug?: boolean;
+    /** Persisted opt-out for anonymous CLI usage analytics, set via `experiences setup`. */
     analyticsDisabled?: boolean;
+    /**
+     * Feature (atomic mode): default composition mode. `atomic` (default) imports
+     * flat components with no embedded-component hierarchy; `composite` opts into
+     * the slot-graph machinery. Resolved `flag > env > this > default`.
+     */
     compositionMode?: CompositionMode;
 };
+/**
+ * Read persisted Contentful credentials.
+ *
+ * Precedence (INTEG-4410): what the operator saved on disk via
+ * `experiences setup` or the wizard's credentials step wins over ambient
+ * `CONTENTFUL_*` / `EDS_HOST` env vars. Env vars are still consulted as a
+ * fallback when the field on disk is missing or empty — this preserves
+ * back-compat for CI / scripts that only export env and never call setup.
+ *
+ * The pre-INTEG-4410 order (env-first) silently shadowed saved values, so
+ * operators who saved a different space via setup kept seeing the env one
+ * pre-filled in the wizard. The saved value now wins; the env fallback only
+ * fires when the on-disk field is empty.
+ */
 export declare function readExperiencesCredentials(): Promise<ExperiencesCredentials>;
 export declare function writeExperiencesCredentials(creds: ExperiencesCredentials): Promise<void>;
 export declare function experiencesCredentialsPath(): string;

package/dist/src/helpers/build-contentful-management-client.d.ts

@@ -0,0 +1,7 @@
+import { type PlainClientAPI } from 'contentful-management';
+interface BuildContentfulManagementClientOptions {
+    cmaToken: string;
+    host?: string;
+}
+export declare function buildContentfulManagementClient(opts: BuildContentfulManagementClientOptions): PlainClientAPI;
+export {};

package/dist/src/helpers/fetch-and-persist-existing-contentful-entities.d.ts

@@ -0,0 +1,29 @@
+import { type ExistingContentfulEntities } from './fetch-existing-contentful-entities.js';
+export interface FetchAndPersistParams {
+    spaceId: string;
+    environmentId: string;
+    cmaToken: string;
+    host?: string;
+    outDir: string;
+}
+export interface FetchAndPersistSuccess {
+    ok: true;
+    path: string;
+    durationMs: number;
+    entities: ExistingContentfulEntities;
+}
+export interface FetchAndPersistFailure {
+    ok: false;
+    durationMs: number;
+    error: string;
+}
+export type FetchAndPersistResult = FetchAndPersistSuccess | FetchAndPersistFailure;
+/**
+ * Build the Contentful management client, fetch the target space's Components
+ * and DesignTokens, and write the raw payload to `<outDir>/.existing-entities.json`.
+ *
+ * Never throws — a failure is reported via `ok: false`. Callers own the
+ * user-facing step/progress reporting. This helper only handles the mechanical
+ * fetch-then-write and returns a structured result.
+ */
+export declare function fetchAndPersistExistingContentfulEntities(params: FetchAndPersistParams): Promise<FetchAndPersistResult>;

package/dist/src/helpers/fetch-existing-contentful-entities.d.ts

@@ -0,0 +1,11 @@
+import { type ComponentProps, type DesignTokenProps, type PlainClientAPI } from 'contentful-management';
+export interface ExistingContentfulEntities {
+    components: ComponentProps[];
+    tokens: DesignTokenProps[];
+}
+interface FetchExistingContentfulEntitiesParams {
+    spaceId: string;
+    environmentId: string;
+}
+export declare function fetchExistingContentfulEntitiesFromContentful(client: PlainClientAPI, params: FetchExistingContentfulEntitiesParams): Promise<ExistingContentfulEntities>;
+export {};

package/dist/src/helpers/find-nearly-matching-component.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentProps } from 'contentful-management';
+/**
+ * Find the space component whose name is closest to the codebase component name,
+ * within a small edit budget. Handles case, punctuation, and plural differences
+ * so `Btn-Primary` matches `btnPrimary`, and `Cards` matches `Card`.
+ */
+export declare function findNearlyMatchingComponent(components: ComponentProps[], codebaseName: string): ComponentProps | undefined;

package/dist/src/helpers/read-existing-contentful-entities-from-session.d.ts

@@ -0,0 +1,7 @@
+import type { ExistingContentfulEntities } from './fetch-existing-contentful-entities.js';
+/**
+ * Read the session file the orchestrator writes after
+ * `fetchExistingContentfulEntitiesFromContentful()`. Returns undefined on
+ * any failure — this is optional enrichment and must never block the step.
+ */
+export declare function readExistingContentfulEntitiesFromSession(path: string | undefined): Promise<ExistingContentfulEntities | undefined>;

package/dist/src/helpers/summarize-existing-contentful-entities.d.ts

@@ -0,0 +1,50 @@
+import type { ExistingContentfulEntities } from './fetch-existing-contentful-entities.js';
+export interface SelectAgentSummary {
+    components: Array<{
+        id: string;
+        name: string;
+        description: string;
+    }>;
+    tokens: {
+        count: number;
+        kinds: string[];
+    };
+}
+export interface GenerateAgentSummary {
+    likelyMatch?: {
+        id: string;
+        name: string;
+        designProperties: Array<{
+            id: string;
+            name: string;
+            type: string;
+        }>;
+        contentProperties: Array<{
+            id: string;
+            name: string;
+            type: string;
+        }>;
+        slots: Array<{
+            id: string;
+            name: string;
+        }>;
+    };
+    otherComponents: Array<{
+        id: string;
+        name: string;
+    }>;
+    tokens: {
+        count: number;
+        kinds: string[];
+    };
+}
+export interface MapTokensSummary {
+    tokens: Array<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+}
+export declare function summarizeForSelectAgent(entities: ExistingContentfulEntities): SelectAgentSummary;
+export declare function summarizeForGenerateAgent(entities: ExistingContentfulEntities, codebaseComponentName: string): GenerateAgentSummary;
+export declare function summarizeForMapTokens(entities: ExistingContentfulEntities): MapTokensSummary;

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

@@ -28,7 +28,6 @@ export interface PipelineOptions {
     /** When true, auto-reject cycle participants and retry push instead of surfacing an error. */
     autoRejectCycles?: boolean;
     allowDeletions?: boolean;
-    withSpaceContext?: boolean;
     compositionMode?: CompositionMode;
     compositionMap?: string;
     compositionAgent?: boolean;

package/dist/src/import/tui/WizardApp.d.ts

@@ -10,6 +10,7 @@ export declare function buildSelectAgentArgs(opts: {
     bedrock?: boolean;
     selectPromptPath?: string;
     noCache?: boolean;
+    existingEntitiesPath?: string;
 }): string[];
 export type AutoFilterProgress = {
     n: number;
@@ -27,6 +28,7 @@ export declare function buildGenerateComponentsArgs(opts: {
     bedrock?: boolean;
     noCache?: boolean;
     generatePromptPath?: string;
+    existingEntitiesPath?: string;
 }): string[];
 export declare function buildMapTokensArgs(opts: {
     sessionId: string;
@@ -34,6 +36,7 @@ export declare function buildMapTokensArgs(opts: {
     model?: string;
     noCache?: boolean;
     skipAgent?: boolean;
+    existingEntitiesPath?: string;
 }): string[];
 export declare function shouldRunMapTokens(opts: {
     mappablePropCount: number;