@contentful/experience-design-system-cli 2.5.3-dev-build-727fd69.0 → 2.5.3-dev-build-985b472.0

package/README.md

@@ -1,10 +1,8 @@
 # @contentful/experience-design-system-cli
 
-CLI for extracting, reviewing, generating, validating, and pushing Contentful Experience Design System component definitions into [Experience Orchestration (ExO)](https://www.contentful.com/help/experience-orchestration/).
+CLI for extracting, reviewing, generating, validating, and pushing Contentful Experience Design System component definitions into Experiences
 
-**Binary names:** `experiences` (primary), `exo` (alias), `experience-design-system-cli` (long-form). All three point to the same executable.
-
-## Pipeline Overview
+## CLI Overview
 
 The commands form a pipeline. Run them in order, or use `import` to orchestrate the whole thing at once:
 
@@ -14,6 +12,8 @@ analyze extract   →   analyze select-agent   →   generate components   →
 
 `analyze select-agent` uses an AI agent to decide which extracted components belong in Contentful Experience Orchestration. You can substitute it with `analyze select` for manual/pattern-based selection.
 
+**Determinism boundary.** `analyze extract` is fully deterministic: ts-morph AST parsing produces the same component list and prop shape on every run, then a deterministic pre-classifier and a structural non-authorable filter (see below) shape the output. AI enters the pipeline at `analyze select-agent` and `generate components`, where coding agents make per-component decisions. This split keeps the extracted artifact reproducible and inspectable — if an extracted component looks wrong, the cause is in the rules, not in agent variability.
+
 All intermediate data flows through a local SQLite session database (`~/.contentful/experience-design-system-cli/pipeline.db`). No JSON files are written between steps — each command reads its inputs from the session and writes its outputs back to it. Use `print` to export session data to JSON files on demand (e.g. for inspection or manual validation).
 
 ---
@@ -93,6 +93,18 @@ Scans `.tsx`, `.ts`, `.jsx`, `.js`, `.vue`, and `.astro` files. Ignores `node_mo
 
 Writes extracted components to the session database and prints `session=<id>` to stdout. In an interactive terminal, a scrollable TUI displays the extraction summary (including a warning for any components with 0 props and 0 slots); press `q` or `Enter` to exit.
 
+#### Non-authorable component filter
+
+Before storing components, `analyze extract` runs a deterministic filter that drops infrastructure components which have no authoring surface (Context providers, analytics shims, security utilities, layout helpers). The filter uses prop-shape signals only — no component-name or source-path patterns — so it works regardless of how a host repo organizes its design system. A component is dropped if **any** of:
+
+1. Zero props and zero slots.
+2. Source calls `createContext()` and the component has a prop literally named `value`.
+3. Source calls `createContext()` and the component has zero props.
+4. Source calls `createContext()` and the component has exactly one non-handler prop.
+5. Every prop is a handler or ref (function-typed, `EventHandler`, `Dispatch`, `SetStateAction`, `Ref<>`, name starts with `on`/`set`, or named `ref`/`innerRef`).
+
+Each dropped component is reported as a warning (`Skipped non-authorable component: <Name> (<reason>)`) so the operator can audit. The rule set was selected via Monte-Carlo evaluation against a hand-labelled corpus to maximize precision (zero false positives) over recall — components that look like normal authoring surface but are actually infrastructure are deferred to the AI selection stage rather than dropped here.
+
 ---
 
 ### `analyze select`

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.5.3-dev-build-727fd69.0",
+  "version": "2.5.3-dev-build-985b472.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -18,6 +18,10 @@
       "node": "./dist/src/index.js"
     }
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://npm.pkg.github.com/"
+  },
   "files": [
     "bin/",
     "dist/",

package/dist/src/analyze/command.js

@@ -8,6 +8,7 @@ import { registerAnalyzeEditCommand } from './select/command.js';
 import { registerAnalyzeSelectAgentCommand } from './select-agent/command.js';
 import { openPipelineDb, getOrCreateSession, createStep, updateStep, storeRawComponents } from '../session/db.js';
 import { preClassifyComponent } from './pre-classify.js';
+import { isNonAuthorableComponent } from './extract/non-authorable-filter.js';
 const SCANNED_FILE_EXTENSIONS = new Set(['.astro', '.js', '.jsx', '.ts', '.tsx', '.vue']);
 const IGNORED_DIRECTORY_NAMES = new Set([
     '.git',
@@ -121,23 +122,32 @@ export function registerAnalyzeCommand(program) {
         });
         const stepId = createStep(db, sessionId, 'analyze extract', { project: projectRoot });
         const classifiedComponents = extraction.components.map(preClassifyComponent);
-        storeRawComponents(db, sessionId, classifiedComponents);
+        const filteredComponents = [];
+        const filterWarnings = [];
+        for (const component of classifiedComponents) {
+            const verdict = isNonAuthorableComponent(component);
+            if (verdict.skip) {
+                filterWarnings.push(`Skipped non-authorable component: ${component.name} (${verdict.reason})`);
+                continue;
+            }
+            filteredComponents.push(component);
+        }
+        storeRawComponents(db, sessionId, filteredComponents);
         updateStep(db, stepId, 'complete', { sessionId });
         db.close();
-        const zeroPropComponents = classifiedComponents.filter((c) => c.props.length === 0 && c.slots.length === 0);
+        const allWarnings = [...extraction.warnings, ...filterWarnings];
         const analyzeResult = {
             sourceDirectory,
             sessionId,
             fileCount: sourceFiles.length,
-            components: classifiedComponents.map((c) => ({
+            components: filteredComponents.map((c) => ({
                 name: c.name,
                 framework: c.framework,
                 propCount: c.props.length,
                 slotCount: c.slots.length,
-                warnings: extraction.warnings.filter((w) => w.startsWith(c.name + ':')),
+                warnings: allWarnings.filter((w) => w.startsWith(c.name + ':')),
             })),
-            totalWarnings: extraction.warnings.length,
-            zeroPropComponents: zeroPropComponents.map((c) => ({ name: c.name, source: c.source })),
+            totalWarnings: allWarnings.length,
         };
         if (process.stdout.isTTY) {
             const { waitUntilExit } = render(createElement(AnalyzeView, {
@@ -153,15 +163,9 @@ export function registerAnalyzeCommand(program) {
                 `Scanned ${pluralize(sourceFiles.length, 'source file')} in ${sourceDirectory}`,
                 `Extracted ${pluralize(extraction.components.length, 'component')}`,
             ];
-            if (zeroPropComponents.length > 0) {
-                summaryLines.push(`Warning: ${pluralize(zeroPropComponents.length, 'component')} extracted with 0 props and 0 slots:`);
-                summaryLines.push(...zeroPropComponents.map((c) => `  ${c.name} (${c.source})`));
-                summaryLines.push('These may be Storybook stories, context providers, or SSR utilities.');
-                summaryLines.push("Review them in 'analyze select' before generating.");
-            }
-            if (extraction.warnings.length > 0) {
-                summaryLines.push(`Warnings (${extraction.warnings.length}):`);
-                summaryLines.push(...extraction.warnings.map((w) => `- ${w}`));
+            if (allWarnings.length > 0) {
+                summaryLines.push(`Warnings (${allWarnings.length}):`);
+                summaryLines.push(...allWarnings.map((w) => `- ${w}`));
             }
             else {
                 summaryLines.push('Warnings: none');

package/dist/src/analyze/extract/non-authorable-filter.d.ts

@@ -0,0 +1,16 @@
+import type { RawComponentDefinition } from '../../types.js';
+export interface NonAuthorableResult {
+    skip: boolean;
+    reason?: string;
+}
+/**
+ * Decides whether a component is non-authorable infrastructure (Context.Provider,
+ * analytics shim, layout-only utility, etc.) and should be filtered out of the
+ * analyze TUI before authoring-token generation.
+ *
+ * Uses prop-shape signals only — no component-name or source-path patterns.
+ * A design system can live anywhere under any naming convention; relying on
+ * suffixes like `*Provider` or paths like `src/lib/` would silently fail in
+ * other repos.
+ */
+export declare function isNonAuthorableComponent(component: RawComponentDefinition): NonAuthorableResult;

package/dist/src/analyze/extract/non-authorable-filter.js

@@ -0,0 +1,60 @@
+const HANDLER_TYPE_PATTERN = /=>|EventHandler|Dispatch<|SetStateAction/;
+const REF_TYPE_PATTERN = /Ref<|RefObject<|MutableRefObject/;
+function isHandlerOrRefProp(prop) {
+    if (HANDLER_TYPE_PATTERN.test(prop.type))
+        return true;
+    if (REF_TYPE_PATTERN.test(prop.type))
+        return true;
+    if (/^on[A-Z]/.test(prop.name) || /^set[A-Z]/.test(prop.name))
+        return true;
+    if (prop.name === 'ref' || prop.name === 'innerRef')
+        return true;
+    return false;
+}
+/**
+ * Decides whether a component is non-authorable infrastructure (Context.Provider,
+ * analytics shim, layout-only utility, etc.) and should be filtered out of the
+ * analyze TUI before authoring-token generation.
+ *
+ * Uses prop-shape signals only — no component-name or source-path patterns.
+ * A design system can live anywhere under any naming convention; relying on
+ * suffixes like `*Provider` or paths like `src/lib/` would silently fail in
+ * other repos.
+ */
+export function isNonAuthorableComponent(component) {
+    const { props, slots, usesCreateContext } = component;
+    // R1: zero props AND zero slots — nothing for an editor to author.
+    // Catches analytics scripts, GTM tags, layout fixers, security tokens, etc.
+    if (props.length === 0 && slots.length === 0) {
+        return { skip: true, reason: 'component has no props and no slots' };
+    }
+    // R2: createContext source + prop literally named `value` — canonical
+    // `<Context.Provider value={...}>` call site.
+    if (usesCreateContext && props.some((p) => p.name === 'value')) {
+        return {
+            skip: true,
+            reason: 'source uses createContext and component exposes a Context.Provider value prop',
+        };
+    }
+    // R3: createContext source + zero props — Provider wrapper that hard-codes
+    // the context value internally (e.g. FontProvider, BottomSheetProvider).
+    if (usesCreateContext && props.length === 0) {
+        return { skip: true, reason: 'source uses createContext and component has no props' };
+    }
+    // R4: createContext source + exactly one non-handler prop — Provider that
+    // takes the context value as its sole data prop, named after the data
+    // (e.g. `LocaleProvider({ locale })`, `NavigationProvider({ navItems })`).
+    if (usesCreateContext && props.length === 1 && !isHandlerOrRefProp(props[0])) {
+        return {
+            skip: true,
+            reason: 'source uses createContext and component has a single non-handler prop',
+        };
+    }
+    // R5: every prop is a handler/ref — pure data plumbing, no authoring surface.
+    // Catches components like `OsanoCookiePlaceholder({ onBannerLoaded })` or
+    // `FeedbackCard({ setShowModal })`.
+    if (props.length > 0 && props.every(isHandlerOrRefProp)) {
+        return { skip: true, reason: 'every prop is a handler or ref' };
+    }
+    return { skip: false };
+}

package/dist/src/analyze/extract/react.js

@@ -233,6 +233,14 @@ function getBoundedImportedJsxDomSurface(tagNameNode) {
 function isStencilFile(sourceFile) {
     return sourceFile.getImportDeclarations().some((imp) => imp.getModuleSpecifierValue() === '@stencil/core');
 }
+function sourceFileUsesCreateContext(sourceFile) {
+    // Match React.createContext(...) and createContext(...) call expressions
+    return sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).some((call) => {
+        const expr = call.getExpression();
+        const text = expr.getText();
+        return text === 'createContext' || text === 'React.createContext';
+    });
+}
 function isNextJsComponent(filePath, exportedNames) {
     const normalized = filePath.replace(/\\/g, '/');
     const isAppRouterFile = /\/app\/.*\/(page|layout)\.[jt]sx?$/.test(normalized);
@@ -1634,6 +1642,7 @@ export async function extractReactComponents(filePaths) {
 function extractFromSourceFile(sourceFile, isNext) {
     const components = [];
     const exported = sourceFile.getExportedDeclarations();
+    const usesCreateContext = sourceFileUsesCreateContext(sourceFile);
     for (const [exportKey, declarations] of exported) {
         let name = exportKey;
         if (exportKey === 'default') {
@@ -1668,6 +1677,7 @@ function extractFromSourceFile(sourceFile, isNext) {
                 framework: isNext ? 'next' : 'react',
                 props: [],
                 slots: [],
+                ...(usesCreateContext && { usesCreateContext: true }),
             });
             continue;
         }
@@ -1752,6 +1762,7 @@ function extractFromSourceFile(sourceFile, isNext) {
             framework: isNext ? 'next' : 'react',
             props: propsAfterSlotExpansion,
             slots: finalSlots,
+            ...(usesCreateContext && { usesCreateContext: true }),
         });
     }
     return components;

package/dist/src/analyze/tui/AnalyzeView.d.ts

@@ -11,10 +11,6 @@ export type AnalyzeViewResult = {
         warnings: string[];
     }>;
     totalWarnings: number;
-    zeroPropComponents?: Array<{
-        name: string;
-        source: string;
-    }>;
 };
 type AnalyzeViewProps = {
     result: AnalyzeViewResult;

package/dist/src/analyze/tui/AnalyzeView.js

@@ -31,7 +31,7 @@ export function AnalyzeView({ result, onExit }) {
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(TopBar, { subcommand: "analyze", hints: [
                     { key: '?', label: 'help' },
                     { key: 'q', label: 'quit' },
-                ] }), _jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Text, { children: 'Scanned ' + result.fileCount + ' source files in ' + result.sourceDirectory }), _jsx(Text, { children: 'Extracted ' + result.components.length + ' components' }), _jsx(Text, { dimColor: true, children: 'Session: ' + result.sessionId }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, children: "Components" }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), result.components.slice(scrollOffset).map((component) => (_jsxs(Box, { children: [component.warnings.length > 0 && _jsx(Text, { color: "yellow", children: "\u26A0 " }), component.warnings.length === 0 && _jsx(Text, { children: " " }), _jsx(Text, { children: truncateName(component.name).padEnd(20) }), _jsx(Text, { dimColor: true, children: component.framework.padEnd(10) }), _jsx(Text, { children: (component.propCount + ' props').padEnd(10) }), _jsx(Text, { children: component.slotCount + ' ' + (component.slotCount === 1 ? 'slot' : 'slots') }), component.warnings.length > 0 && (_jsx(Text, { color: "yellow", children: '  ' + component.warnings.length + ' warning' + (component.warnings.length === 1 ? '' : 's') }))] }, component.name))), result.zeroPropComponents && result.zeroPropComponents.length > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, color: "yellow", children: 'Zero-prop components (' + result.zeroPropComponents.length + ')' }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { color: "yellow", children: '  These may be Storybook stories, context providers, or SSR utilities.' }), _jsx(Text, { color: "yellow", children: '  Review them in `analyze select` before generating.' }), _jsx(Text, { children: " " }), result.zeroPropComponents.map((c) => (_jsx(Text, { color: "yellow", children: '  ' + c.name + ' (' + c.source + ')' }, c.name)))] })), result.totalWarnings > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, color: "yellow", children: 'Warnings (' + result.totalWarnings + ')' }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), result.components
+                ] }), _jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Text, { children: 'Scanned ' + result.fileCount + ' source files in ' + result.sourceDirectory }), _jsx(Text, { children: 'Extracted ' + result.components.length + ' components' }), _jsx(Text, { dimColor: true, children: 'Session: ' + result.sessionId }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, children: "Components" }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), result.components.slice(scrollOffset).map((component) => (_jsxs(Box, { children: [component.warnings.length > 0 && _jsx(Text, { color: "yellow", children: "\u26A0 " }), component.warnings.length === 0 && _jsx(Text, { children: " " }), _jsx(Text, { children: truncateName(component.name).padEnd(20) }), _jsx(Text, { dimColor: true, children: component.framework.padEnd(10) }), _jsx(Text, { children: (component.propCount + ' props').padEnd(10) }), _jsx(Text, { children: component.slotCount + ' ' + (component.slotCount === 1 ? 'slot' : 'slots') }), component.warnings.length > 0 && (_jsx(Text, { color: "yellow", children: '  ' + component.warnings.length + ' warning' + (component.warnings.length === 1 ? '' : 's') }))] }, component.name))), result.totalWarnings > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, color: "yellow", children: 'Warnings (' + result.totalWarnings + ')' }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), result.components
                                 .filter((c) => c.warnings.length > 0)
                                 .flatMap((c) => c.warnings.map((w) => ({ component: c.name, warning: w })))
                                 .map((w, i) => (_jsx(Text, { color: "yellow", children: '  ⚠ ' + w.component + ': ' + w.warning }, i)))] })), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: 'Run: analyze select --session ' + result.sessionId }), _jsx(Text, { children: " " })] }), _jsx(Box, { borderStyle: "single", paddingX: 1, children: _jsx(Text, { dimColor: true, children: "Press Enter or q to exit" }) })] }));

package/dist/src/apply/api-client.js

@@ -1,4 +1,5 @@
-export const DEFAULT_HOST = 'https://api.contentful.com';
+import { DEFAULT_API_HOST, toApiHost } from '../host-utils.js';
+export const DEFAULT_HOST = DEFAULT_API_HOST;
 export class ApiError extends Error {
     status;
     body;
@@ -33,7 +34,7 @@ export class ImportApiClient {
     spaceId;
     environmentId;
     constructor(opts) {
-        this.host = opts.host ?? DEFAULT_HOST;
+        this.host = toApiHost(opts.host);
         this.token = opts.cmaToken;
         this.spaceId = opts.spaceId;
         this.environmentId = opts.environmentId;

package/dist/src/apply/command.js

@@ -1,5 +1,5 @@
-import { createElement } from 'react';
-import { render } from 'ink';
+import { createElement, useState } from 'react';
+import { render, useInput } from 'ink';
 import { access, readFile, readdir, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { validateCDF, flattenDTCG, validateDTCG, buildManifest, buildFilteredManifest, } from '@contentful/experience-design-system-types';
@@ -7,8 +7,6 @@ import { ApiError, ImportApiClient } from './api-client.js';
 import { openPipelineDb, loadCDFComponents } from '../session/db.js';
 import { ServerPreviewApp, ServerPreviewConfirm, ServerApplyProgress, ServerApplyDone } from './tui/ServerApplyView.js';
 import { SelectView, makeSelectKey } from './tui/SelectView.js';
-import { useState } from 'react';
-import { useInput } from 'ink';
 function die(message) {
     process.stderr.write(`${message}\n`);
     process.exit(1);

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

@@ -2,6 +2,7 @@ export type ExperiencesCredentials = {
     spaceId: string;
     environmentId: string;
     cmaToken: string;
+    host?: string;
 };
 export declare function readExperiencesCredentials(): Promise<ExperiencesCredentials>;
 export declare function writeExperiencesCredentials(creds: ExperiencesCredentials): Promise<void>;

package/dist/src/credentials-store.js

@@ -1,29 +1,39 @@
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { toConfiguredHost } from './host-utils.js';
 const CREDENTIALS_DIR = join(homedir(), '.config', 'experiences');
 const CREDENTIALS_PATH = join(CREDENTIALS_DIR, 'credentials.json');
 export async function readExperiencesCredentials() {
     try {
         const raw = await readFile(CREDENTIALS_PATH, 'utf8');
         const parsed = JSON.parse(raw);
+        const host = toConfiguredHost(process.env['EDS_HOST'] ?? parsed.host);
         return {
             spaceId: process.env['CONTENTFUL_SPACE_ID'] ?? parsed.spaceId ?? '',
             environmentId: process.env['CONTENTFUL_ENVIRONMENT_ID'] ?? parsed.environmentId ?? '',
             cmaToken: process.env['CONTENTFUL_MANAGEMENT_TOKEN'] ?? parsed.cmaToken ?? '',
+            ...(host ? { host } : {}),
         };
     }
     catch {
+        const host = toConfiguredHost(process.env['EDS_HOST']);
         return {
             spaceId: process.env['CONTENTFUL_SPACE_ID'] ?? '',
             environmentId: process.env['CONTENTFUL_ENVIRONMENT_ID'] ?? '',
             cmaToken: process.env['CONTENTFUL_MANAGEMENT_TOKEN'] ?? '',
+            ...(host ? { host } : {}),
         };
     }
 }
 export async function writeExperiencesCredentials(creds) {
+    const { host: _host, ...rest } = creds;
+    const host = toConfiguredHost(creds.host);
     await mkdir(CREDENTIALS_DIR, { recursive: true });
-    await writeFile(CREDENTIALS_PATH, JSON.stringify(creds, null, 2) + '\n', { mode: 0o600 });
+    await writeFile(CREDENTIALS_PATH, JSON.stringify({
+        ...rest,
+        ...(host ? { host } : {}),
+    }, null, 2) + '\n', { mode: 0o600 });
 }
 export function experiencesCredentialsPath() {
     return CREDENTIALS_PATH;

package/dist/src/host-utils.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_API_HOST = "https://api.contentful.com";
+export declare const DEFAULT_CONFIGURED_HOST = "api.contentful.com";
+export declare function toConfiguredHost(host?: string): string | undefined;
+export declare function toApiHost(host?: string): string;

package/dist/src/host-utils.js

@@ -0,0 +1,26 @@
+export const DEFAULT_API_HOST = 'https://api.contentful.com';
+export const DEFAULT_CONFIGURED_HOST = 'api.contentful.com';
+function trimTrailingSlashes(value) {
+    return value.replace(/\/+$/, '');
+}
+function normalizeHostInput(host) {
+    const value = host?.trim();
+    if (!value)
+        return undefined;
+    return trimTrailingSlashes(value);
+}
+export function toConfiguredHost(host) {
+    const normalized = normalizeHostInput(host);
+    if (!normalized)
+        return undefined;
+    return normalized.replace(/^https:\/\//i, '');
+}
+export function toApiHost(host) {
+    const normalized = normalizeHostInput(host);
+    if (!normalized)
+        return DEFAULT_API_HOST;
+    if (/^[a-z][a-z\d+\-.]*:\/\//i.test(normalized)) {
+        return normalized;
+    }
+    return `https://${normalized}`;
+}

package/dist/src/import/command.js

@@ -1,6 +1,7 @@
 import { resolve, join } from 'node:path';
 import { runPipeline } from './orchestrator.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../host-utils.js';
 export function registerImportCommand(program) {
     program
         .command('import')
@@ -45,6 +46,7 @@ export function registerImportCommand(program) {
                 initialSpaceId: creds.spaceId,
                 initialEnvironmentId: creds.environmentId || 'master',
                 initialCmaToken: creds.cmaToken,
+                initialHost: toConfiguredHost(opts.host ?? creds.host) ?? DEFAULT_CONFIGURED_HOST,
                 initialAgent: opts.agent !== 'claude' ? opts.agent : undefined,
                 initialProjectPath: opts.project !== '.' ? resolve(opts.project) : undefined,
                 host: opts.host,

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

@@ -3,8 +3,9 @@ export type WizardAppProps = {
     initialSpaceId?: string;
     initialEnvironmentId?: string;
     initialCmaToken?: string;
+    initialHost?: string;
     initialAgent?: string;
     initialProjectPath?: string;
     host?: string;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialAgent, initialProjectPath, host, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialProjectPath, host, }?: WizardAppProps): React.ReactElement;

package/dist/src/import/tui/WizardApp.js

@@ -24,6 +24,8 @@ import { buildManifest } from '@contentful/experience-design-system-types';
 import { openPipelineDb, loadCDFComponents, seedCDFFromPreviewResponse, seedDefaultsFromChangedItems, backfillUnclassifiedProps, } from '../../session/db.js';
 import { checkAgentAuth } from '../../generate/agent-runner.js';
 import { normalizePath } from '../path-utils.js';
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../../host-utils.js';
+import { writeExperiencesCredentials } from '../../credentials-store.js';
 function findCliPath() {
     return join(fileURLToPath(import.meta.url), '..', '..', '..', '..', '..', 'bin', 'cli.js');
 }
@@ -39,8 +41,9 @@ function logStep(entry) {
     const line = JSON.stringify({ ts: new Date().toISOString(), ...entry }) + '\n';
     appendFileSync(WIZARD_LOG, line);
 }
-export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialAgent, initialProjectPath, host, } = {}) {
-    const apiHost = host ?? process.env['EDS_HOST'];
+export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialHost, initialAgent, initialProjectPath, host, } = {}) {
+    const defaultConfiguredHost = toConfiguredHost(host || process.env['EDS_HOST']) ?? DEFAULT_CONFIGURED_HOST;
+    const resolveWizardHost = (hostValue) => hostValue || defaultConfiguredHost;
     const { stdout } = useStdout();
     const terminalWidth = stdout?.columns ?? 80;
     const logInit = useRef(false);
@@ -75,6 +78,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         spaceId: initialSpaceId,
         environmentId: initialEnvironmentId,
         cmaToken: initialCmaToken,
+        host: resolveWizardHost(toConfiguredHost(initialHost)),
         credentialsError: '',
         serverPreview: null,
         manifest: null,
@@ -375,7 +379,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         }
         if (returnToPreview) {
             const { extractSessionId, tokensPath } = sessionRef.current;
-            void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken);
+            void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken, state.host);
         }
         else {
             advanceToPushFlow(generatedAcceptedCount);
@@ -431,19 +435,46 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         }
         // Re-preview with updated definitions
         const { extractSessionId: sid, tokensPath: tp } = sessionRef.current;
-        void runPreview(sid, tp, state.spaceId, state.environmentId, state.cmaToken);
+        void runPreview(sid, tp, state.spaceId, state.environmentId, state.cmaToken, state.host);
     };
-    const confirmCredentials = (spaceId, environmentId, cmaToken) => {
+    const advanceWithCredentials = (spaceId, environmentId, cmaToken, host) => {
+        const resolvedHost = resolveWizardHost(host);
         credentialsRef.current = { spaceId, environmentId, cmaToken };
-        update({ spaceId, environmentId, cmaToken, step: 'credential-test-gate' });
+        update({
+            spaceId,
+            environmentId,
+            cmaToken,
+            host: resolvedHost,
+            credentialsError: '',
+            step: 'credential-test-gate',
+        });
+    };
+    const confirmCredentials = async (spaceId, environmentId, cmaToken, host) => {
+        const resolvedHost = resolveWizardHost(host);
+        try {
+            await writeExperiencesCredentials({ spaceId, environmentId, cmaToken, host: resolvedHost });
+            advanceWithCredentials(spaceId, environmentId, cmaToken, resolvedHost);
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : 'Unable to save credentials';
+            update({
+                spaceId,
+                environmentId,
+                cmaToken,
+                host: resolvedHost,
+                credentialsError: `Failed to save credentials: ${message}`,
+                step: 'credentials',
+            });
+        }
     };
-    const validateCredentials = async (spaceId, environmentId, cmaToken) => {
+    const validateCredentials = async (spaceId, environmentId, cmaToken, host) => {
         update({ step: 'validating-credentials' });
         try {
-            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: apiHost });
+            const resolvedHost = resolveWizardHost(host);
+            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: resolvedHost });
             await client.validateToken();
             const { extractSessionId, tokensPath } = sessionRef.current;
-            void runPreview(extractSessionId, tokensPath, spaceId, environmentId, cmaToken);
+            void runPreview(extractSessionId, tokensPath, spaceId, environmentId, cmaToken, resolvedHost);
         }
         catch (e) {
             if (e instanceof ApiError && (e.status === 401 || e.status === 403)) {
@@ -459,10 +490,11 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
             });
         }
     };
-    const runPreview = async (extractSessionId, tokensPath, spaceId, environmentId, cmaToken) => {
+    const runPreview = async (extractSessionId, tokensPath, spaceId, environmentId, cmaToken, host) => {
         update({ step: 'previewing' });
+        const resolvedHost = resolveWizardHost(host);
         try {
-            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: apiHost });
+            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: resolvedHost });
             let components = [];
             if (extractSessionId) {
                 const db = openPipelineDb();
@@ -548,7 +580,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                         errorMessage: `Not found (404). Check that the space ID, environment ID, and host are correct.\n\n` +
                             `  Space:       ${spaceId}\n` +
                             `  Environment: ${environmentId}\n` +
-                            (apiHost ? `  Host:        ${apiHost}\n` : '') +
+                            (resolvedHost ? `  Host:        ${resolvedHost}\n` : '') +
                             `\nIf using a custom --host, make sure the space exists on that host.`,
                     });
                     return;
@@ -560,7 +592,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
             update({ step: 'error', errorStep: 'apply preview', errorMessage: msg, errorAllowCredentialRetry: true });
         }
     };
-    const runPush = async (manifest, spaceId, environmentId, cmaToken, acknowledgeBreakingChanges, preview) => {
+    const runPush = async (manifest, spaceId, environmentId, cmaToken, host, acknowledgeBreakingChanges, preview) => {
         if (preview) {
             const hasComponentChanges = preview.components.new.length > 0 ||
                 preview.components.changed.length > 0 ||
@@ -579,7 +611,8 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         }
         update({ step: 'pushing' });
         try {
-            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: apiHost });
+            const resolvedHost = resolveWizardHost(host);
+            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: resolvedHost });
             let operation = await client.applyImport(manifest, acknowledgeBreakingChanges);
             try {
                 logStep({
@@ -835,13 +868,15 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                     }, onQuit: () => process.exit(0) }));
             }
             case 'credentials':
-                return (_jsx(CredentialsStep, { initialSpaceId: state.spaceId, initialEnvironmentId: state.environmentId, initialCmaToken: state.cmaToken, error: state.credentialsError || undefined, onConfirm: confirmCredentials, onContinue: confirmCredentials, onQuit: () => process.exit(0) }));
+                return (_jsx(CredentialsStep, { initialSpaceId: state.spaceId, initialEnvironmentId: state.environmentId, initialCmaToken: state.cmaToken, initialHost: state.host, error: state.credentialsError || undefined, onConfirm: (spaceId, environmentId, cmaToken, host) => {
+                        void confirmCredentials(spaceId, environmentId, cmaToken, host);
+                    }, onContinue: advanceWithCredentials, onQuit: () => process.exit(0) }));
             case 'credential-test-gate':
                 return (_jsx(GateStep, { successMessage: "Credentials entered", summary: `Space: ${state.spaceId}  ·  Environment: ${state.environmentId}`, context: "Verify your credentials work before running the import, or skip and find out during the push step.", continueLabel: "Test credentials", skipLabel: "Skip and continue", showSkip: true, onContinue: () => {
-                        void validateCredentials(state.spaceId, state.environmentId, state.cmaToken);
+                        void validateCredentials(state.spaceId, state.environmentId, state.cmaToken, state.host);
                     }, onSkip: () => {
                         const { extractSessionId, tokensPath } = sessionRef.current;
-                        void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken);
+                        void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken, state.host);
                     }, onQuit: () => process.exit(0) }));
             case 'validating-credentials':
                 return (_jsx(RunningStep, { stepNumber: totalSteps - 1, totalSteps: totalSteps, title: "Validating credentials", description: "Checking that your space ID and CMA token are valid..." }));
@@ -849,7 +884,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 return (_jsx(RunningStep, { stepNumber: totalSteps, totalSteps: totalSteps, title: "Computing diff", description: "Computing diff against your Contentful space..." }));
             case 'preview-gate':
                 return (_jsx(WizardPreviewStep, { preview: state.serverPreview, spaceId: state.spaceId, environmentId: state.environmentId, stepNumber: totalSteps, totalSteps: totalSteps, onConfirm: (acknowledge) => {
-                        void runPush(state.manifest, state.spaceId, state.environmentId, state.cmaToken, acknowledge, state.serverPreview);
+                        void runPush(state.manifest, state.spaceId, state.environmentId, state.cmaToken, state.host, acknowledge, state.serverPreview);
                     }, onEdit: () => {
                         void runEditFromPreview(state.serverPreview);
                     }, onSaveFiles: () => {

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

@@ -5,11 +5,12 @@ type CredentialsStepProps = {
     initialSpaceId?: string;
     initialEnvironmentId?: string;
     initialCmaToken?: string;
-    /** Called when the user submits with all fields changed from their initial values */
-    onConfirm: (spaceId: string, environmentId: string, cmaToken: string) => void;
+    initialHost?: string;
+    /** Called when the user submits with any field changed from its initial value */
+    onConfirm: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
     /** Called when the user submits without changing any field (use existing creds as-is) */
-    onContinue?: (spaceId: string, environmentId: string, cmaToken: string) => void;
+    onContinue?: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
     onQuit: () => void;
 };
-export declare function CredentialsStep({ summary, error: externalError, initialSpaceId, initialEnvironmentId, initialCmaToken, onConfirm, onContinue, onQuit, }: CredentialsStepProps): React.ReactElement;
+export declare function CredentialsStep({ summary, error: externalError, initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, onConfirm, onContinue, onQuit, }: CredentialsStepProps): React.ReactElement;
 export {};

package/dist/src/import/tui/steps/CredentialsStep.js

@@ -2,10 +2,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useEffect } from 'react';
 import { Box, Text } from 'ink';
 import { useImmediateInput } from '../../../analyze/select/tui/hooks/useImmediateInput.js';
-export function CredentialsStep({ summary, error: externalError, initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', onConfirm, onContinue, onQuit, }) {
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../../../host-utils.js';
+export function CredentialsStep({ summary, error: externalError, initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialHost, onConfirm, onContinue, onQuit, }) {
+    const normalizedInitialHost = toConfiguredHost(initialHost) ?? DEFAULT_CONFIGURED_HOST;
     const [spaceId, setSpaceId] = useState(initialSpaceId);
     const [environmentId, setEnvironmentId] = useState(initialEnvironmentId);
     const [cmaToken, setCmaToken] = useState(initialCmaToken);
+    const [host, setHost] = useState(normalizedInitialHost);
     const [activeField, setActiveField] = useState('spaceId');
     const [inlineError, setInlineError] = useState(null);
     const [cursorVisible, setCursorVisible] = useState(true);
@@ -23,25 +26,31 @@ export function CredentialsStep({ summary, error: externalError, initialSpaceId
                 setActiveField('cmaToken');
                 return;
             }
+            if (activeField === 'cmaToken') {
+                setActiveField('host');
+                return;
+            }
             // Submit
             if (!spaceId.trim() || !environmentId.trim() || !cmaToken.trim()) {
                 setInlineError('All fields are required.');
                 return;
             }
             setInlineError(null);
+            const submittedHost = toConfiguredHost(host) ?? DEFAULT_CONFIGURED_HOST;
             const unchanged = spaceId.trim() === initialSpaceId &&
                 environmentId.trim() === initialEnvironmentId &&
-                cmaToken.trim() === initialCmaToken;
+                cmaToken.trim() === initialCmaToken &&
+                submittedHost === normalizedInitialHost;
             if (unchanged && onContinue) {
-                onContinue(spaceId.trim(), environmentId.trim(), cmaToken.trim());
+                onContinue(spaceId.trim(), environmentId.trim(), cmaToken.trim(), submittedHost);
             }
             else {
-                onConfirm(spaceId.trim(), environmentId.trim(), cmaToken.trim());
+                onConfirm(spaceId.trim(), environmentId.trim(), cmaToken.trim(), submittedHost);
             }
             return;
         }
         if (key.tab) {
-            setActiveField((f) => (f === 'spaceId' ? 'environmentId' : f === 'environmentId' ? 'cmaToken' : 'spaceId'));
+            setActiveField((f) => f === 'spaceId' ? 'environmentId' : f === 'environmentId' ? 'cmaToken' : f === 'cmaToken' ? 'host' : 'spaceId');
             return;
         }
         if (key.escape || input === 'q') {
@@ -53,8 +62,10 @@ export function CredentialsStep({ summary, error: externalError, initialSpaceId
                 setSpaceId((v) => v.slice(0, -1));
             else if (activeField === 'environmentId')
                 setEnvironmentId((v) => v.slice(0, -1));
-            else
+            else if (activeField === 'cmaToken')
                 setCmaToken((v) => v.slice(0, -1));
+            else
+                setHost((v) => v.slice(0, -1));
             return;
         }
         if (input && !key.ctrl && !key.meta) {
@@ -62,18 +73,21 @@ export function CredentialsStep({ summary, error: externalError, initialSpaceId
                 setSpaceId((v) => v + input);
             else if (activeField === 'environmentId')
                 setEnvironmentId((v) => v + input);
-            else
+            else if (activeField === 'cmaToken')
                 setCmaToken((v) => v + input);
+            else
+                setHost((v) => v + input);
         }
     });
     const cursor = cursorVisible ? '█' : ' ';
     function renderField(label, value, field, masked = false) {
         const isActive = activeField === field;
         const display = masked ? '•'.repeat(value.length) : value;
-        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isActive ? 'cyan' : undefined, children: '?' }), _jsxs(Text, { bold: isActive, children: [label, ":"] }), _jsx(Text, { children: isActive ? display + cursor : display || _jsx(Text, { dimColor: true, children: "(empty)" }) })] }));
+        const fallback = field === 'host' ? DEFAULT_CONFIGURED_HOST : _jsx(Text, { dimColor: true, children: "(empty)" });
+        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isActive ? 'cyan' : undefined, children: '?' }), _jsxs(Text, { bold: isActive, children: [label, ":"] }), _jsx(Text, { children: isActive ? display + cursor : display || fallback })] }));
     }
     const displayError = inlineError ?? externalError ?? null;
     return (_jsxs(Box, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [summary && _jsxs(Text, { color: "green", children: ["\u2713 ", summary] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: initialSpaceId && initialCmaToken
                         ? 'Credentials pre-filled from experiences setup. Press Enter to continue or edit any field to update.'
-                        : 'Enter your Contentful credentials to continue.' }) }), !(initialSpaceId && initialCmaToken) && (_jsx(Text, { dimColor: true, children: "Tip: run experiences setup to save these to ~/.config/experiences/credentials.json so they pre-fill here automatically." })), _jsxs(Box, { flexDirection: "column", gap: 0, marginTop: 1, children: [renderField('Space ID', spaceId, 'spaceId'), renderField('Environment', environmentId, 'environmentId'), renderField('CMA Token', cmaToken, 'cmaToken', true)] }), displayError && _jsxs(Text, { color: "red", children: ["\u2717 ", displayError] }), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Next field / Submit" }), _jsx(Text, { dimColor: true, children: "[Tab] Switch field" }), _jsx(Text, { dimColor: true, children: "[q] Quit" })] })] }));
+                        : 'Enter your Contentful credentials to continue.' }) }), !(initialSpaceId && initialCmaToken) && (_jsx(Text, { dimColor: true, children: "Tip: run experiences setup to save these to ~/.config/experiences/credentials.json so they pre-fill here automatically." })), _jsxs(Box, { flexDirection: "column", gap: 0, marginTop: 1, children: [renderField('Space ID', spaceId, 'spaceId'), renderField('Environment', environmentId, 'environmentId'), renderField('CMA Token', cmaToken, 'cmaToken', true), renderField('API Host', host, 'host')] }), activeField === 'host' && _jsx(Text, { dimColor: true, children: "Default: api.contentful.com \u00B7 EU spaces: api.eu.contentful.com" }), displayError && _jsxs(Text, { color: "red", children: ["\u2717 ", displayError] }), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Next field / Submit" }), _jsx(Text, { dimColor: true, children: "[Tab] Switch field" }), _jsx(Text, { dimColor: true, children: "[q] Quit" })] })] }));
 }

package/dist/src/index.js

@@ -1,2 +1,7 @@
 import { createProgram } from './program.js';
-await createProgram().parseAsync();
+createProgram()
+    .parseAsync()
+    .catch((err) => {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/src/setup/command.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from 'node:url';
 import { createInterface } from 'node:readline';
 import { promisify } from 'node:util';
 import { readExperiencesCredentials, writeExperiencesCredentials, experiencesCredentialsPath, } from '../credentials-store.js';
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../host-utils.js';
 const execFileAsync = promisify(execFile);
 const REQUIRED_NODE_MAJOR = 24;
 // ── Output helpers ────────────────────────────────────────────────────────────
@@ -29,7 +30,13 @@ function dim(msg) {
     process.stdout.write(`\x1b[2m${msg}\x1b[0m\n`);
 }
 // ── Prompt helpers ────────────────────────────────────────────────────────────
+function isInteractivePromptSession() {
+    return !!(process.stdin.isTTY && process.stdout.isTTY);
+}
 function prompt(question) {
+    if (!isInteractivePromptSession()) {
+        return Promise.resolve('');
+    }
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     return new Promise((resolve) => {
         rl.question(question, (answer) => {
@@ -39,6 +46,9 @@ function prompt(question) {
     });
 }
 function promptSecret(question) {
+    if (!isInteractivePromptSession()) {
+        return Promise.resolve('');
+    }
     // Use readline for all prompts — mixing raw-mode stdin listeners with
     // readline createInterface causes readline to buffer+unshift unconsumed
     // input back onto the stream, which the raw listener then re-reads,
@@ -51,9 +61,10 @@ function promptSecret(question) {
         });
         let value = '';
         process.stdout.write(question);
+        let origWrite = null;
         if (process.stdin.isTTY) {
             // Intercept the readline output write so we can replace echoed chars with *
-            const origWrite = rl.output.write.bind(rl.output);
+            origWrite = rl.output.write.bind(rl.output);
             rl.output.write = (s) => {
                 // Allow newline through; suppress everything else (the echoed characters)
                 if (s === '\r\n' || s === '\n' || s === '\r')
@@ -65,12 +76,24 @@ function promptSecret(question) {
             rl.close();
         });
         rl.once('close', () => {
-            process.stdout.write('\n');
+            // Restore stdout.write before resolving — the interceptor patches rl.output.write
+            // which is process.stdout.write, so without restoring it all subsequent output is swallowed.
+            if (origWrite) {
+                rl.output.write = origWrite;
+            }
+            // In TTY mode readline already emitted \n when Enter was pressed; only add one in non-TTY.
+            if (!process.stdin.isTTY)
+                process.stdout.write('\n');
+            // rl.close() pauses stdin; resume it so subsequent prompt() calls work.
+            process.stdin.resume();
             resolve(value);
         });
     });
 }
 async function confirm(question, defaultYes = true) {
+    if (!isInteractivePromptSession()) {
+        return false;
+    }
     const hint = defaultYes ? '[Y/n]' : '[y/N]';
     const answer = await prompt(`  ${question} ${hint} `);
     if (!answer)
@@ -387,6 +410,8 @@ async function setupContentfulCredentials() {
     const currentSpace = stored.spaceId;
     const currentEnv = stored.environmentId;
     const currentToken = stored.cmaToken;
+    const storedHost = stored.host;
+    const currentHost = storedHost ?? DEFAULT_CONFIGURED_HOST;
     const hasAny = !!(currentSpace || currentEnv || currentToken);
     if (hasAny) {
         info('Current values:');
@@ -408,6 +433,7 @@ async function setupContentfulCredentials() {
         else {
             warn('CMA Token       (not set)');
         }
+        ok(`API Host        ${currentHost}`);
         info('');
     }
     const allSet = !!(currentSpace && currentEnv && currentToken);
@@ -434,9 +460,12 @@ async function setupContentfulCredentials() {
         warn('Space ID and CMA token are required. Skipped.');
         return false;
     }
-    await writeExperiencesCredentials({ spaceId, environmentId, cmaToken });
+    const hostInput = await prompt(`  API host [${currentHost}]: `);
+    const host = toConfiguredHost(hostInput) ?? storedHost;
+    await writeExperiencesCredentials({ spaceId, environmentId, cmaToken, ...(host ? { host } : {}) });
     ok(`Credentials saved to ${experiencesCredentialsPath()}`);
-    info('Run experiences import — the credentials step will be pre-filled automatically.');
+    ok(`API host set to ${host ?? DEFAULT_CONFIGURED_HOST}`);
+    info('Run experiences import — credentials will be pre-filled automatically.');
     return true;
 }
 // ── Step 6: Optional quality-of-life ─────────────────────────────────────────

package/dist/src/types.d.ts

@@ -28,6 +28,12 @@ export interface RawComponentDefinition {
     framework: 'react' | 'next' | 'vue' | 'astro' | 'web-component' | 'stencil';
     props: RawPropDefinition[];
     slots: RawSlotDefinition[];
+    /**
+     * True when the source file declaring this component calls
+     * React.createContext / createContext. Used downstream to filter
+     * non-authorable context-provider components.
+     */
+    usesCreateContext?: boolean;
 }
 export interface ComponentExtractionResult {
     components: RawComponentDefinition[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.5.3-dev-build-727fd69.0",
+  "version": "2.5.3-dev-build-985b472.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -18,6 +18,10 @@
       "node": "./dist/src/index.js"
     }
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://npm.pkg.github.com/"
+  },
   "files": [
     "bin/",
     "dist/",
@@ -32,7 +36,7 @@
     "react-dom": "^18.3.1",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
-    "@contentful/experience-design-system-types": "2.5.3-dev-build-727fd69.0"
+    "@contentful/experience-design-system-types": "2.5.3-dev-build-985b472.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.3",