@contentful/experience-design-system-cli 2.15.2-dev-build-0e302c8.0 → 2.15.2-dev-build-a2c2d9e.0

package/dist/package.json

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

package/dist/src/analyze/command.js

@@ -2,6 +2,7 @@ import { createElement } from 'react';
 import { render } from 'ink';
 import { mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';
 import { isAbsolute, join, relative, resolve } from 'node:path';
+import { addAgentModelOptions } from '../lib/agent-model-options.js';
 import { extractComponents, preClassifyComponent, isNonAuthorableComponent, computeExtractionScore, deriveNeedsReview, describeReviewReasons, inspectComponentSource, validateExtractedComponents, } from '@contentful/experience-design-system-extraction';
 import { AnalyzeView } from './tui/AnalyzeView.js';
 import { registerAnalyzeEditCommand } from './select/command.js';
@@ -165,7 +166,7 @@ export function registerAnalyzeCommand(program) {
     const analyze = program
         .command('analyze')
         .description('Extract component definitions from a project, or correct analysis output');
-    analyze
+    const extractCmd = analyze
         .command('extract')
         .description('Extract component definitions from a project')
         .requiredOption('--project <path>', 'Path to the project root')
@@ -177,8 +178,11 @@ export function registerAnalyzeCommand(program) {
         .option('--composition-agent', 'Opt into agentic mapping resolution when deterministic sources find no groups (implies --composite)')
         .option('--composition-refresh', 'Force the mapping agent to run even where deterministic sources answered (implies --composite)')
         .option('--generate-map <path>', 'Write a skeleton interchange map from resolved composition (implies --composite)')
-        .option('--prompt <stage=value>', 'Override a stage prompt (repeatable). value is a file path or literal text, e.g. --prompt composition=./p.md', (v, acc) => [...acc, v], [])
-        .option('--agent <name>', 'Coding agent for composition mapping resolution (claude|codex|opencode|cursor)')
+        .option('--prompt <stage=value>', 'Override a stage prompt (repeatable). value is a file path or literal text, e.g. --prompt composition=./p.md', (v, acc) => [...acc, v], []);
+    addAgentModelOptions(extractCmd, {
+        includeModel: false,
+        agentDescription: 'Coding agent for composition mapping resolution (claude|codex|opencode|cursor)',
+    })
         .option('--composition-agent-mode <mode>', "Agent resolution mode: 'parser' (agent writes a sandboxed parser — deterministic, default) or 'edges' (agent lists edges directly)", 'parser')
         .action(async (opts) => {
         const resolveUnreachable = (() => {

package/dist/src/analyze/select-agent/command.js

@@ -1,3 +1,4 @@
+import { addAgentModelOptions } from '../../lib/agent-model-options.js';
 import { openPipelineDb, loadRawComponents, loadScannedFiles, createStep, updateStep, computeComponentInputHash, lookupSelectCache, storeSelectCache, getCliCacheVersion, } from '../../session/db.js';
 import { hashPromptForSkill } from '../../session/cache-keys.js';
 import { appendReviewEvent, getRefineArtifactsRoot, ensureRefineSession, getRefineSessionPaths, saveReviewState, } from '../select/persistence.js';
@@ -300,13 +301,12 @@ async function selectAllComponents(agent, model, components, verbose, skillPathO
     return results;
 }
 export function registerAnalyzeSelectAgentCommand(program) {
-    program
+    const cmd = program
         .command('select-agent')
         .description('Use an AI agent to select components for Contentful Experience Orchestration')
         .option('--session <id>', 'Session ID from analyze extract (defaults to most recent)')
-        .option('--project-root <path>', 'Project root for resolving component source files')
-        .option('--agent <name>', 'Agent to use: claude, codex, opencode, cursor (defaults to value saved by experiences setup)')
-        .option('--model <name>', 'Model to use (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)')
+        .option('--project-root <path>', 'Project root for resolving component source files');
+    addAgentModelOptions(cmd)
         .option('--verbose', 'Show full agent output including reasoning text')
         .option('--dry-run', 'Print the prompt for the first component without invoking the agent')
         .option('--exclude-invalid', 'Auto-reject components with validation errors instead of failing loud (LLM cannot fix structural issues)')

package/dist/src/generate/command.js

@@ -14,6 +14,7 @@ import { openPipelineDb, loadRawComponents, applyToolCalls, applyTokenToolCalls,
 import { hashPromptForSkill } from '../session/cache-keys.js';
 import { getRefineArtifactsRoot, getRefineSessionPaths } from '../analyze/select/persistence.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
+import { addAgentModelOptions } from '../lib/agent-model-options.js';
 const execFileAsync = promisify(execFile);
 const VALID_AGENTS = new Set(['claude', 'codex', 'opencode', 'cursor']);
 const DEFAULT_TIMEOUT_MS = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 3 * 60 * 1000);
@@ -568,9 +569,7 @@ async function runGenerateSkill(skill, opts, verbose = false) {
     }
 }
 function addAgentFlags(cmd) {
-    return cmd
-        .option('--agent <name>', 'Agent to use: claude, codex, opencode, cursor (defaults to value saved by experiences setup)')
-        .option('--model <name>', 'Model to use (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)')
+    return addAgentModelOptions(cmd)
         .option('--verbose', 'Show full agent output including reasoning text')
         .option('--dry-run', 'Print the prompt without invoking the agent')
         .option('--no-cache', 'Bypass ALL fine-grained caches (extract, select, generate) and force AI re-run. ' +

package/dist/src/import/command.js

@@ -2,6 +2,7 @@ import { resolve, join } from 'node:path';
 import { runPipeline } from './orchestrator.js';
 import { resolveAutoFilter } from './auto-filter-resolve.js';
 import { resolveAgent, resolveModel } from './agent-model-resolve.js';
+import { addAgentModelOptions } from '../lib/agent-model-options.js';
 import { resolveCompositionMode } from '../lib/composition-mode.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../host-utils.js';
@@ -11,16 +12,18 @@ import { resolvePromptFlags } from './print-prompt.js';
 import { shouldShowRunPicker } from '../runs/run-picker-mount.js';
 import { dispatchPickerSelection } from './picker-dispatch.js';
 export function registerImportCommand(program) {
-    program
+    const cmd = program
         .command('import')
         .description('Run the full pipeline: analyze → select → generate → push')
         .option('--space-id <id>', 'Contentful space ID (required unless --skip-apply)')
         .option('--environment-id <id>', 'Contentful environment ID (required unless --skip-apply)')
         .option('--cma-token <token>', 'CMA personal access token (or set CONTENTFUL_MANAGEMENT_TOKEN)')
         .option('--project <path>', 'Path to the project root to analyze', '.')
-        .option('--out <path>', 'Output directory for pipeline artifacts')
-        .option('--agent <name>', 'Agent to use for generate components (overrides credentials.json; falls back to "claude")')
-        .option('--model <name>', 'Model to use for generate components (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)')
+        .option('--out <path>', 'Output directory for pipeline artifacts');
+    addAgentModelOptions(cmd, {
+        agentDescription: 'Agent to use for generate components (overrides credentials.json; falls back to "claude")',
+        modelDescription: 'Model to use for generate components (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)',
+    })
         .option('--tokens <path>', 'Path to a DTCG tokens.json file to push alongside generated components')
         .option('--raw-tokens <path>', 'Path to a raw token source file (SCSS, CSS variables, JS/TS, Style Dictionary, etc.) to classify and import alongside components. Bypasses the interactive token prompt.')
         .option('--select-all', 'Select all extracted components for generation (default)')

package/dist/src/lib/agent-model-options.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+export declare const AGENT_DESCRIPTION = "Agent to use: claude, codex, opencode, cursor (defaults to value saved by experiences setup)";
+export declare const MODEL_DESCRIPTION = "Model to use (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)";
+export interface AgentModelOptionsConfig {
+    agentDescription?: string;
+    includeModel?: boolean;
+    modelDescription?: string;
+}
+/**
+ * Register --agent and optionally --model flags to a Commander command, with customizable descriptions.
+ * Pass `includeModel: false` for commands where the model dimension is not applicable (e.g., mapping-resolution agents that select an agent for logic, not model choice).
+ */
+export declare function addAgentModelOptions(cmd: Command, config?: AgentModelOptionsConfig): Command;

package/dist/src/lib/agent-model-options.js

@@ -0,0 +1,14 @@
+export const AGENT_DESCRIPTION = 'Agent to use: claude, codex, opencode, cursor (defaults to value saved by experiences setup)';
+export const MODEL_DESCRIPTION = 'Model to use (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)';
+/**
+ * Register --agent and optionally --model flags to a Commander command, with customizable descriptions.
+ * Pass `includeModel: false` for commands where the model dimension is not applicable (e.g., mapping-resolution agents that select an agent for logic, not model choice).
+ */
+export function addAgentModelOptions(cmd, config = {}) {
+    const { agentDescription = AGENT_DESCRIPTION, includeModel = true, modelDescription = MODEL_DESCRIPTION } = config;
+    cmd.option('--agent <name>', agentDescription);
+    if (includeModel) {
+        cmd.option('--model <name>', modelDescription);
+    }
+    return cmd;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.15.2-dev-build-0e302c8.0",
+  "version": "2.15.2-dev-build-a2c2d9e.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -34,8 +34,8 @@
     "react": "^18.3.1",
     "react-devtools-core": "^4.19.1",
     "react-dom": "^18.3.1",
-    "@contentful/experience-design-system-extraction": "2.15.2-dev-build-0e302c8.0",
-    "@contentful/experience-design-system-types": "2.15.2-dev-build-0e302c8.0"
+    "@contentful/experience-design-system-types": "2.15.2-dev-build-a2c2d9e.0",
+    "@contentful/experience-design-system-extraction": "2.15.2-dev-build-a2c2d9e.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.3",