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

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.34.5-dev-build-5e798cb1.0",
+  "version": "2.34.5-dev-build-ea694b2.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -40,6 +40,7 @@
   "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/analyze/composition/interchange-schema.d.ts

@@ -1,17 +1,11 @@
 /**
  * The CLI-owned composition interchange format (spec T1).
  *
- * Two views of the same data:
- *  - `InterchangeMap` — the human-authored / on-disk `{ version, groups }`
- *    shape (parent → children), consumed by the composition-map option.
- *    `--composition-map` consumes and the resolver can emit.
- *  - `CompositionEdge[]` — the flat internal runtime view, one edge per
- *    parent→child relationship, carrying optional `slot` (T7), `confidence`,
- *    and `provenance`. Easier to merge/dedupe across sources (T2).
- *
- * This module owns both shapes and the converters between them.
+ * `CompositionEdge[]` is the flat internal runtime view, one edge per
+ * parent→child relationship, carrying optional `slot` (T7), `confidence`,
+ * and `provenance`. It is easier to merge and dedupe across sources (T2).
  */
-export type EdgeProvenance = 'user' | 'typed-slot' | 'structural' | 'manifest' | 'doc' | `adapter:${string}` | 'agent';
+export type EdgeProvenance = 'typed-slot' | 'structural' | 'manifest' | 'doc' | `adapter:${string}` | 'agent';
 export type CompositionEdge = {
     parent: string;
     child: string;
@@ -21,17 +15,3 @@ export type CompositionEdge = {
     confidence?: number;
     provenance: EdgeProvenance;
 };
-export type InterchangeMap = {
-    version: 1;
-    groups: Record<string, string[]>;
-};
-export type ValidateResult = {
-    valid: true;
-    map: InterchangeMap;
-} | {
-    valid: false;
-    errors: string[];
-};
-export declare function validateInterchangeMap(input: unknown): ValidateResult;
-export declare function groupsToEdges(map: InterchangeMap, provenance: EdgeProvenance): CompositionEdge[];
-export declare function edgesToGroups(edges: CompositionEdge[]): InterchangeMap;

package/dist/src/analyze/composition/resolve-mapping-cli.d.ts

@@ -1,18 +1,7 @@
-import { type InterchangeMap } from './interchange-schema.js';
 export type CompositionCliOptions = {
-    /** `--composition-map <path>` — hand-authored interchange file. */
-    compositionMap?: string;
     /** `--composition-refresh` — force edge emission to run even over resolved residue. */
     compositionRefresh?: boolean;
 };
-export type LoadUserMapResult = {
-    ok: true;
-    map: InterchangeMap;
-} | {
-    ok: false;
-    error: string;
-};
-export declare function loadUserMap(path: string): Promise<LoadUserMapResult>;
 export type ResolvedCompositionSources = {
     forceAgent: boolean;
 };

package/dist/src/analyze/composition/resolve-mapping.d.ts

@@ -1,9 +1,8 @@
 import type { RawComponentDefinition } from '../../types.js';
-import { type CompositionEdge, type InterchangeMap } from './interchange-schema.js';
+import type { CompositionEdge } from './interchange-schema.js';
 import { type EdgeConflict } from './merge-edges.js';
 export type ResolveMappingResult = {
     components: RawComponentDefinition[];
-    userMap?: InterchangeMap;
     edges: CompositionEdge[];
     conflicts: EdgeConflict[];
     warnings: string[];
@@ -11,9 +10,9 @@ export type ResolveMappingResult = {
 /**
  * Orchestrate composition-edge acquisition and enrichment.
  *
- * Sources by rank: user map (1) > typed-slot / "code slots" (2) > structural
- * usage evidence (3) > manifest (4) > doc (5) > adapter-resolved / extraEdges
- * (6) > edge-emitting agent (7). Manifest/doc edges are computed deterministically outside
+ * Sources by rank: typed-slot / "code slots" (2) > structural usage evidence
+ * (3) > manifest (4) > doc (5) > adapter-resolved / extraEdges (6) >
+ * edge-emitting agent (7). Manifest/doc edges are computed deterministically outside
  * this function (see manifest-doc-evidence.ts) and joined via `extraEdges`.
  * ALL sources — including the code slots already on the incoming components —
  * are fed into one ranked merge and unioned; non-conflicting edges from every
@@ -28,7 +27,6 @@ export type ResolveMappingResult = {
  */
 export declare function resolveMapping(input: {
     components: RawComponentDefinition[];
-    userMap?: InterchangeMap;
     forceAgent?: boolean;
     files: Array<{
         path: string;
@@ -55,7 +53,7 @@ export declare function resolveMapping(input: {
     /**
      * Pre-resolved edges from an external source (e.g. manifest or documentation)
      * path). They join the ranked merge at their own provenance rank alongside
-     * code slots and the user map.
+     * code slots and other automatic mapping sources.
      */
     extraEdges?: CompositionEdge[];
 }): Promise<ResolveMappingResult>;

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

@@ -9,23 +9,10 @@ export type ExperiencesCredentials = {
     generatePromptPath?: string;
     /** 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`. */
+    /** Print plain text with no color; an exported NO_COLOR still wins. */
+    noColor?: boolean;
     analyticsDisabled?: boolean;
 };
-/**
- * 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/doctor/checks.d.ts

@@ -0,0 +1,5 @@
+export declare function reportNode(): Promise<boolean>;
+export declare function reportPnpm(pkgRoot: string): Promise<boolean>;
+export declare function reportDependencies(pkgRoot: string): Promise<boolean>;
+export declare function reportBuild(pkgRoot: string): Promise<boolean>;
+export declare function reportAgent(): Promise<boolean>;

package/dist/src/doctor/command.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerDoctorCommand(program: Command): void;

package/dist/src/doctor/report.d.ts

@@ -0,0 +1,7 @@
+export declare function ok(msg: string): void;
+export declare function fail(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function info(msg: string): void;
+export declare function section(title: string): void;
+/** Echo the first `limit` lines of a failed command's stderr. */
+export declare function infoStderr(stderr: string, limit: number): void;

package/dist/src/import/agent-model-resolve.d.ts

@@ -1,11 +1,11 @@
 /**
- * Resolution chain for `--agent` and `--model` overrides on `experiences import`.
+ * Resolution chain for the combined `--agent` override on `experiences import`.
  *
  * The wizard path previously hard-defaulted `--agent` to `'claude'` at the
  * commander layer, which (a) shadowed the stored `credentials.json` value when
  * the user passed no flag, and (b) made it impossible to distinguish "user
- * explicitly passed --agent claude" from "user passed nothing". `--model` was
- * registered but never threaded into the wizard subprocesses at all.
+ * explicitly passed --agent claude" from "user passed nothing". The combined
+ * flag accepts either `agent:model` or `agent model`.
  *
  * These helpers produce the resolved values to feed into `WizardApp` /
  * the import wizard:
@@ -15,9 +15,13 @@
  *      `experiences setup`) is used.
  *   3. Otherwise, the built-in default (currently `'claude'`) is used for
  *      the agent. Model has no default — agents pick a small/fast model
- *      themselves when `--model` is omitted.
+ *      themselves when no model is included in `--agent`.
  */
 /** Built-in fallback agent when neither a flag nor a stored preference is set. */
 export declare const DEFAULT_AGENT = "claude";
+export declare function parseAgentModel(value: string | undefined): {
+    agent?: string;
+    model?: string;
+};
 export declare function resolveAgent(flagValue: string | undefined, storedValue: string | undefined): string;
 export declare function resolveModel(flagValue: string | undefined, storedValue: string | undefined): string | undefined;

package/dist/src/import/composition-options.d.ts

@@ -1,9 +1,7 @@
 export type CompositionOptionInput = {
-    compositionMap?: string;
     prompt?: string[];
 };
 export type CompositionForwardingOptions = {
-    compositionMap?: string;
     promptOverrides?: string[];
 };
 export declare function buildCompositionForwardingOptions(options: CompositionOptionInput): CompositionForwardingOptions;

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

@@ -17,6 +17,7 @@ export declare function buildGenerateTokensArgs(opts: {
     model?: string;
     bedrock?: boolean;
     noCache?: boolean;
+    promptOverrides?: string[];
 }): string[];
 export declare function buildMapTokensArgs(opts: {
     sessionId: string;
@@ -24,6 +25,7 @@ export declare function buildMapTokensArgs(opts: {
     model?: string;
     noCache?: boolean;
     skipAgent?: boolean;
+    promptOverrides?: string[];
     existingEntitiesPath?: string;
 }): string[];
 export declare function shouldRunMapTokens(opts: {
@@ -51,7 +53,6 @@ export type WizardAppProps = {
     bedrock?: boolean;
     initialProjectPath?: string;
     host?: string;
-    compositionMap?: string;
     promptOverrides?: string[];
     noCache?: boolean;
     livePreview?: boolean;
@@ -59,4 +60,4 @@ export type WizardAppProps = {
     skipMapTokens?: boolean;
     initialRawTokensPath?: string;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, compositionMap, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;

package/dist/src/import/tui/run-selection-agent.d.ts

@@ -0,0 +1,8 @@
+import { type AgentName } from '@contentful/experience-design-system-generation';
+export declare function runSelectionAgent(options: {
+    sessionId: string;
+    agent: AgentName;
+    model?: string;
+    promptText?: string;
+    promptPath?: string;
+}): Promise<void>;