@contentful/experience-design-system-cli 2.35.1-dev-build-a91cc5b7.0 → 2.35.1-dev-build-f520d7cb.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.35.1-dev-build-a91cc5b7.0",
+  "version": "2.35.1-dev-build-f520d7cb.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -53,9 +53,6 @@
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@contentful/experience-design-system-agents": "workspace:*",
-    "@contentful/experience-design-system-extraction": "workspace:*",
-    "@contentful/experience-design-system-generation": "workspace:*",
     "@tsconfig/node24": "^24.0.4",
     "@types/node": "^24.0.3",
     "@types/react": "^18.3.24",
@@ -63,7 +60,6 @@
     "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.6",
-    "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16"
   },

package/dist/src/tui/home/home.d.ts

@@ -1,6 +1,5 @@
 import React from 'react';
 import type { Screen } from '../../../app.js';
-export declare const MIN_TERMINAL_WIDTH = 164;
 export declare function HomeScreen({ onNavigate }: {
     onNavigate: (screen: Screen) => void;
 }): React.ReactElement;

package/dist/src/tui/home/home.theme.d.ts

@@ -1,14 +1,3 @@
-export declare const BRAND: {
-    readonly blue: "#1773EB";
-    readonly green: "#00C459";
-    readonly orange: "#E44F20";
-    readonly yellow: "#FFDA00";
-    readonly white: "#FFFFFF";
-    readonly slate: "#A6B5C7";
-    readonly steel: "#C4D1DE";
-    readonly mist: "#DDE5EC";
-    readonly fog: "#EFF2F6";
-};
 export declare const PALETTE: {
     readonly accent: "#1773EB";
     readonly heading: "#FFFFFF";

package/legacy/dist/src/analyze/composition/candidate-files.d.ts

@@ -0,0 +1,34 @@
+export declare const CANDIDATE_NAME_PATTERNS: RegExp[];
+export declare const CANDIDATE_CONTENT_MARKERS: string[];
+export declare const CANDIDATE_TOKEN_BUDGET = 6000;
+/**
+ * Token ceiling for the candidate set INLINED into a single agent prompt.
+ * Sized to stay under a 200k-context model once the agent's own system prompt
+ * + tool definitions (~105k observed) are added, so a large design system
+ * (hundreds of components → many matched files) can't overflow the request and
+ * fail resolution. Files beyond the budget are dropped (with a warning), not
+ * silently truncated. Distinct from `CANDIDATE_TOKEN_BUDGET`, which sizes the
+ * unused per-batch chunking.
+ */
+export declare const PROMPT_CANDIDATE_TOKEN_BUDGET = 80000;
+export type CandidateFile = {
+    path: string;
+    content: string;
+};
+export type SelectedCandidate = CandidateFile & {
+    reason: string;
+};
+export declare function selectCandidateFiles(files: CandidateFile[]): SelectedCandidate[];
+/**
+ * Cap a candidate set to what fits in a single agent prompt (see
+ * `PROMPT_CANDIDATE_TOKEN_BUDGET`). Files are kept smallest-first so the budget
+ * admits the most declarations; deterministic tie-break by path. Returns the
+ * kept files plus the paths dropped so the caller can warn (silent truncation
+ * would read as "resolved everything" when it didn't).
+ */
+export declare function capCandidatesToPromptBudget<T extends CandidateFile>(files: T[], budget?: number): {
+    kept: T[];
+    dropped: T[];
+};
+export declare function sliceDeclarationRegions(content: string, markers?: string[], window?: number): string[];
+export declare function batchCandidates(files: CandidateFile[], budget?: number): CandidateFile[][];

package/legacy/dist/src/analyze/composition/composition-cache-key.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Derive the `input_hash` for a composition-cache entry (stored in the pipeline
+ * DB's `composition_cache` table). Content-addresses the candidate file set
+ * (order-independent) plus the producing agent, so a re-run over unchanged
+ * files reuses the (token-costly) agent output.
+ *
+ * Content-hashing — not mtime — means a no-op `git checkout` that only bumps
+ * mtime is still a hit. Prompt/skill changes are handled by the `cli_version`
+ * column on the row (see `getCliCacheVersion`), so no separate resolver-version
+ * constant is needed here.
+ */
+export declare function buildCompositionInputHash(input: {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    agent: string;
+}): string;

package/legacy/dist/src/analyze/composition/interchange-schema.d.ts

@@ -5,7 +5,7 @@
  * parent→child relationship, carrying optional `slot` (T7), `confidence`,
  * and `provenance`. It is easier to merge and dedupe across sources (T2).
  */
-export type EdgeProvenance = 'typed-slot' | 'structural' | 'call-site' | 'manifest' | 'doc' | `adapter:${string}`;
+export type EdgeProvenance = 'typed-slot' | 'structural' | 'manifest' | 'doc' | `adapter:${string}` | 'agent';
 export type CompositionEdge = {
     parent: string;
     child: string;
@@ -13,11 +13,5 @@ export type CompositionEdge = {
     slot?: string;
     /** 1–5 scale, same as select/reject agent tools. */
     confidence?: number;
-    citation?: CompositionCitation;
     provenance: EdgeProvenance;
 };
-export type CompositionCitation = {
-    sourcePath: string;
-    startLine: number;
-    endLine: number;
-};

package/legacy/dist/src/analyze/composition/parse-map-edges.d.ts

@@ -0,0 +1,16 @@
+import type { CompositionEdge } from './interchange-schema.js';
+/**
+ * Lenient JSONL parser for the composition-mapping agent's tool-call output
+ * (spec T4). Mirrors `parseSelectToolCallLines` / `parseToolCallLines` in
+ * `@contentful/experience-design-system-generation`'s `agent-runner.ts`: one JSON object per line, each with a `tool`
+ * field from a fixed allowlist. A line that fails JSON.parse or validation is
+ * DROPPED into `warnings[]` (with a reason) and parsing CONTINUES — no retry,
+ * no throw. Non-`{` prose and blank lines are skipped silently.
+ */
+export type ParseMapEdgesResult = {
+    edges: CompositionEdge[];
+    warnings: string[];
+};
+export declare function parseMapEdges(raw: string, opts: {
+    componentNames: Set<string>;
+}): ParseMapEdgesResult;

package/legacy/dist/src/analyze/composition/prompt-loader.d.ts

@@ -0,0 +1,3 @@
+/** Resolve a bundled composition prompt from the package-root prompts directory. */
+export declare function resolvePromptPath(fileName: string): string;
+export declare function loadPrompt(fileName: string): string;

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

@@ -0,0 +1,10 @@
+export type CompositionCliOptions = {
+    /** `--composition-refresh` — force edge emission to run even over resolved residue. */
+    compositionRefresh?: boolean;
+    /** `--no-cache` — force the composition agent to rerun with the rest of the pipeline. */
+    noCache?: boolean;
+};
+export type ResolvedCompositionSources = {
+    forceAgent: boolean;
+};
+export declare function resolveCompositionSources(opts: CompositionCliOptions): ResolvedCompositionSources;

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

@@ -1,36 +1,59 @@
 import type { RawComponentDefinition } from '../../types.js';
 import type { CompositionEdge } from './interchange-schema.js';
 import { type EdgeConflict } from './merge-edges.js';
-import type { SourceCallSiteEvidence, SourceCallSiteRejection } from './source-call-site-evidence.js';
 export type ResolveMappingResult = {
     components: RawComponentDefinition[];
     edges: CompositionEdge[];
     conflicts: EdgeConflict[];
     warnings: string[];
-    sourceCallSiteEvidence: SourceCallSiteEvidence[];
-    sourceCallSiteRejections: SourceCallSiteRejection[];
 };
 /**
  * Orchestrate composition-edge acquisition and enrichment.
  *
- * Sources by rank: typed-slot / "code slots" (1) > structural usage evidence
- * (2) > cited source call sites (3) > manifest (4) > doc (5) > adapter-resolved
- * / extraEdges (6). 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
  * source survive, and on a conflict (same parent+child, different slot) the
- * higher-rank source wins and the loser is recorded. No agent contributes
- * edges: every edge is backed by code, a manifest or documentation.
+ * higher-rank source wins and the loser is recorded. The edge-emitting agent runs only when
+ * `forceAgent` is set OR there is residue a higher-rank source
+ * didn't cover (routing/cost optimization) — `forceAgent` bypasses that
+ * suppression but never changes rank.
+ *
+ * `runAgentFn` is injected (returns the agent's raw stdout) so this is
+ * testable without spawning a subprocess.
  */
 export declare function resolveMapping(input: {
     components: RawComponentDefinition[];
+    forceAgent?: boolean;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    runAgentFn: (opts: {
+        prompt: string;
+        files: Array<{
+            path: string;
+            content: string;
+        }>;
+    }) => Promise<string>;
+    buildPrompt?: (files: Array<{
+        path: string;
+        content: string;
+    }>, componentNames: string[]) => string;
+    /**
+     * Custom instruction preamble (from `--prompt composition=...`). Replaces the
+     * default guidance line ONLY; the machine-readable output contract + the
+     * component-name allowlist + candidate files are always appended so the
+     * JSONL parser keeps working regardless of the override.
+     */
+    promptOverride?: string;
     /**
      * 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 other automatic mapping sources.
      */
     extraEdges?: CompositionEdge[];
-    sourceCallSiteEvidence?: SourceCallSiteEvidence[];
-    sourceCallSiteRejections?: SourceCallSiteRejection[];
-}): ResolveMappingResult;
+}): Promise<ResolveMappingResult>;

package/legacy/dist/src/analyze/extract-command.d.ts

@@ -1,3 +1,7 @@
 import type { Command } from 'commander';
+export declare function resolveExtractNoCache(opts: {
+    cache?: boolean;
+    noCache?: boolean;
+}): boolean;
 export declare function collectSourceFiles(directory: string, onProgress?: (scannedCount: number) => void): Promise<string[]>;
 export declare function registerInternalExtractCommand(program: Command): void;

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

@@ -7,21 +7,26 @@ export declare function buildGenerateComponentsArgs(opts: {
     agent: string;
     model?: string;
     bedrock?: boolean;
+    noCache?: boolean;
     generatePromptPath?: string;
     promptOverrides?: string[];
     existingEntitiesPath?: string;
+    restoreCache?: boolean;
+    cachedComponents?: string[];
 }): string[];
 export declare function buildGenerateTokensArgs(opts: {
     rawTokensPath: string;
     agent: string;
     model?: string;
     bedrock?: boolean;
+    noCache?: boolean;
     promptOverrides?: string[];
 }): string[];
 export declare function buildMapTokensArgs(opts: {
     sessionId: string;
     agent: string;
     model?: string;
+    noCache?: boolean;
     skipAgent?: boolean;
     promptOverrides?: string[];
     existingEntitiesPath?: string;
@@ -52,10 +57,11 @@ export type WizardAppProps = {
     initialProjectPath?: string;
     host?: string;
     promptOverrides?: string[];
+    noCache?: boolean;
     livePreview?: boolean;
     generatePromptPath?: string;
     skipMapTokens?: boolean;
     initialRawTokensPath?: string;
     initialAgentAuth?: Promise<AgentAuthStatus>;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, initialAgentAuth, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, initialAgentAuth, }?: WizardAppProps): React.ReactElement;

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

@@ -5,4 +5,5 @@ export declare function runSelectionAgent(options: {
     model?: string;
     promptText?: string;
     promptPath?: string;
+    noCache?: boolean;
 }): Promise<void>;

package/legacy/dist/src/import/tui/wizard-state-transitions.d.ts

@@ -8,6 +8,9 @@ export declare function shouldSkipFinalReviewAfterCredentials(state: {
     generateSessionId: string | null;
     finalReviewPassed: boolean;
 }): boolean;
+export declare function resolveNoCacheForGenerate(opts: {
+    cliNoCache: boolean;
+}): boolean;
 export declare function shouldBypassPreview(state: {
     credentialsSkipped: boolean;
 }): boolean;