@contentful/experience-design-system-cli 2.37.1-dev-build-ef8b693f.0 → 2.37.1-dev-build-a7704a7f.0

package/dist/package.json

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

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

@@ -1,3 +1,11 @@
+export declare const PALETTE: {
+    readonly accent: "#1773EB";
+    readonly success: "#00C459";
+    readonly error: "#E44F20";
+    readonly warning: "#FFDA00";
+    readonly muted: "#8B8D91";
+    readonly border: "#C4D1DE";
+};
 export declare function brandBar(width: number, ramp?: readonly string[]): {
     text: string;
     color: string;

package/dist/src/tui/import/steps/07-scope-gate/sidebar/theme.d.ts

@@ -1,8 +1,8 @@
 export declare const PALETTE: {
-    readonly info: "#40a0ff" | "#0059c8";
-    readonly success: "#5DB057" | "#006D23";
-    readonly error: "#ff707d" | "#bd002a";
-    readonly warning: "#FFC835" | "#CC4500";
-    readonly muted: "#aec1cc" | "#5A657C";
-    readonly border: "#aec1cc" | "#5A657C";
+    readonly info: "#1773EB";
+    readonly success: "#00C459";
+    readonly error: "#E44F20";
+    readonly warning: "#FFDA00";
+    readonly muted: "#8B8D91";
+    readonly border: "#C4D1DE";
 };

package/dist/src/tui/import/steps/09-review/theme.d.ts

@@ -0,0 +1,9 @@
+export declare const PALETTE: {
+    readonly info: "#1773EB";
+    readonly success: "#00C459";
+    readonly error: "#E44F20";
+    readonly warning: "#FFDA00";
+    readonly muted: "#8B8D91";
+    readonly border: "#C4D1DE";
+    readonly inverse: "#FFFFFF";
+};

package/{legacy/dist/src/analyze/select/tui → dist/src/tui/import/steps/10-flow}/theme.d.ts

@@ -1,18 +1,13 @@
-import type { ReviewComponentStatus } from '../types.js';
 export declare const PALETTE: {
-    readonly info: "#1773EB";
     readonly link: "#58A6FF";
+    readonly info: "#1773EB";
     readonly success: "#00C459";
     readonly error: "#E44F20";
     readonly warning: "#FFDA00";
-    readonly fg: "#000000";
-    readonly inverse: "#FFFFFF";
     readonly muted: "#8B8D91";
     readonly border: "#C4D1DE";
-    readonly subtle: "#DDE5EC";
-    readonly bg: "#EFF2F6";
+    readonly inverse: "#FFFFFF";
 };
 export declare const INK_UI_THEME: {
     components: Record<string, import("@inkjs/ui").ComponentTheme>;
 };
-export declare function statusPaletteColor(status: ReviewComponentStatus, validationErrorCount: number, validationWarningCount: number): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-ef8b693f.0",
+  "version": "2.37.1-dev-build-a7704a7f.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-ef8b693f.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-ef8b693f.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-a7704a7f.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-a7704a7f.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/dist/src/commands/forwarded.d.ts

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

package/dist/src/legacy/forwarded-import-args.d.ts

@@ -1 +0,0 @@
-export declare function forwardedImportArgs(argv: string[]): string[];

package/dist/src/legacy/legacy-cli-path.d.ts

@@ -1 +0,0 @@
-export declare function findLegacyCliPath(): string;

package/dist/src/legacy/run-legacy.d.ts

@@ -1 +0,0 @@
-export declare function runLegacy(args: string[]): Promise<number>;

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

@@ -1,19 +0,0 @@
-export type ColorMode = 'dark' | 'light';
-export declare function detectColorMode(env?: NodeJS.ProcessEnv): ColorMode;
-export declare const PALETTE: {
-    readonly text: "#f7f9fa";
-    readonly muted: "#aec1cc";
-    readonly border: "#aec1cc";
-    readonly accent: "#40a0ff";
-    readonly error: "#ff707d";
-    readonly success: "#5DB057";
-    readonly warning: "#FFC835";
-} | {
-    readonly text: "#111B2B";
-    readonly muted: "#5A657C";
-    readonly border: "#5A657C";
-    readonly accent: "#0059c8";
-    readonly error: "#bd002a";
-    readonly success: "#006D23";
-    readonly warning: "#CC4500";
-};

package/legacy/bin/cli.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-// Suppress the SQLite ExperimentalWarning before any modules load.
-// Must use dynamic import so this handler registers before sqlite is imported.
-process.removeAllListeners("warning");
-process.on("warning", (w) => {
-  if (w.name === "ExperimentalWarning" && w.message.includes("SQLite")) return;
-  process.stderr.write(`${w.name}: ${w.message}\n`);
-});
-
-// Auto-rebuild when running from source (dev mode only).
-// Skipped when src/ doesn't exist (e.g. npm-installed users).
-import { existsSync, statSync, readdirSync } from "node:fs";
-import { execFileSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { dirname, resolve, join } from "node:path";
-
-function newestMtime(dir, depth = 0) {
-  if (depth > 10) return 0;
-  let max = 0;
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    if (entry.isSymbolicLink()) continue;
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      max = Math.max(max, newestMtime(full, depth + 1));
-    } else if (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx")) {
-      max = Math.max(max, statSync(full).mtimeMs);
-    }
-  }
-  return max;
-}
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkgRoot = resolve(__dirname, "..");
-const srcDir = join(pkgRoot, "src");
-const distEntry = join(pkgRoot, "dist", "src", "index.js");
-
-if (
-  existsSync(srcDir) &&
-  existsSync(distEntry) &&
-  process.env.NODE_ENV !== "test"
-) {
-  const distMtime = statSync(distEntry).mtimeMs;
-  if (newestMtime(srcDir) > distMtime) {
-    process.stderr.write("⚙ Source changed — rebuilding...\n");
-    const tsc = join(pkgRoot, "node_modules", ".bin", "tsc");
-    try {
-      execFileSync(tsc, ["-p", join(pkgRoot, "tsconfig.build.json")], {
-        stdio: ["ignore", "ignore", "inherit"],
-        cwd: pkgRoot,
-      });
-      process.stderr.write("✓ Build complete\n");
-    } catch {
-      process.stderr.write("✗ Build failed — running with existing dist\n");
-    }
-  }
-}
-
-await import("../dist/src/index.js");

package/legacy/dist/package.json

@@ -1,76 +0,0 @@
-{
-  "name": "@contentful/experience-design-system-cli-legacy",
-  "version": "2.35.0",
-  "description": "Legacy Contentful Experiences import CLI (internal, not published; used by @contentful/experience-design-system-cli)",
-  "license": "MIT",
-  "private": true,
-  "type": "module",
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js",
-      "node": "./dist/src/index.js"
-    }
-  },
-  "files": [
-    "bin/",
-    "dist/",
-    "prompts/",
-    "skills/"
-  ],
-  "scripts": {
-    "build": "nx build experience-design-system-cli-legacy",
-    "typecheck": "nx typecheck experience-design-system-cli-legacy",
-    "clean": "nx clean experience-design-system-cli-legacy",
-    "test": "nx test experience-design-system-cli-legacy",
-    "test:watch": "nx test:watch experience-design-system-cli-legacy",
-    "lint": "nx lint experience-design-system-cli-legacy",
-    "lint:fix": "nx lint:fix experience-design-system-cli-legacy"
-  },
-  "dependencies": {
-    "@contentful/experience-design-system-backend-pipeline": "workspace:*",
-    "@contentful/experience-design-system-types": "workspace:*",
-    "@inkjs/ui": "^2.0.0",
-    "@segment/analytics-node": "^3.0.0",
-    "@vue/compiler-sfc": "^3.5.31",
-    "ajv": "^8.17.1",
-    "commander": "^13.1.0",
-    "contentful-management": "^12.17.0",
-    "figures": "6.1.0",
-    "ink": "^5.2.1",
-    "react": "^18.3.1",
-    "react-devtools-core": "^4.19.1",
-    "svelte": "^5.56.4",
-    "ts-morph": "^27.0.2",
-    "typescript": "^5.9.3",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@contentful/experience-design-system-client": "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",
-    "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"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/contentful/experience-design-system-sdk-public.git",
-    "directory": "packages/experience-design-system-cli-legacy"
-  },
-  "homepage": "https://github.com/contentful/experience-design-system-sdk-public#readme",
-  "bugs": {
-    "url": "https://github.com/contentful/experience-design-system-sdk-public/issues"
-  },
-  "engines": {
-    "node": ">=24"
-  }
-}

package/legacy/dist/src/analytics/exit.d.ts

@@ -1,4 +0,0 @@
-import { type CommandFailure } from '@contentful/experience-design-system-backend-pipeline';
-import type { ApiError } from '../apply/api-client.js';
-export declare function exitWithAnalytics(code: number, fields?: CommandFailure): Promise<never>;
-export declare function failureFromApiError(error: ApiError): CommandFailure;

package/legacy/dist/src/analytics/index.d.ts

@@ -1,3 +0,0 @@
-export { bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, flushAnalytics, isPipelineAnalyticsChild, noteCommandStart, recordApplyOutcome, recordContentfulContext, setCliVersion, setPersistedAnalyticsDisabled, } from '@contentful/experience-design-system-backend-pipeline';
-export type { CommandFailure } from '@contentful/experience-design-system-backend-pipeline';
-export { exitWithAnalytics, failureFromApiError } from './exit.js';

package/legacy/dist/src/analyze/composite-closure.d.ts

@@ -1,26 +0,0 @@
-export interface ComponentGraphNode {
-    name: string;
-    slots: Array<{
-        name: string;
-        allowedComponents?: string[];
-    }>;
-}
-interface ClosureNode {
-    name: string;
-    depth: number;
-    path: string[];
-    parents: string[];
-}
-export interface Closure {
-    root: string;
-    nodes: ClosureNode[];
-    containsCycle: boolean;
-    cyclePath?: string[];
-}
-export type NodeStatus = 'ok' | 'warning' | 'error';
-export declare function findRoots(components: ComponentGraphNode[], selected?: Set<string>): string[];
-export declare function computeClosure(root: string, components: ComponentGraphNode[]): Closure;
-export declare function computeAllClosures(components: ComponentGraphNode[], selected?: Set<string>): Map<string, Closure>;
-export declare function aggregateStatus(closure: Closure, perNodeStatus: Map<string, NodeStatus>): NodeStatus;
-export declare function findSharedDeps(closures: Map<string, Closure>): Map<string, string[]>;
-export {};

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

@@ -1,22 +0,0 @@
-import type { RawComponentDefinition } from '../../types.js';
-import type { CompositionEdge } from './interchange-schema.js';
-export type ApplyMappingResult = {
-    components: RawComponentDefinition[];
-    warnings: string[];
-};
-/**
- * Enrichment pass (spec T7): merge a resolved composition edge list into the
- * extracted components' `allowedComponents`. Runs AFTER extraction; it is the
- * mapping resolver's entire job — populating the one field every downstream
- * graph consumer reads.
- *
- * Slot targeting:
- *  - edge.slot present + slot exists → write there.
- *  - edge.slot present + slot missing → synthesize for high-trust
- *    (typed-slot / adapter) edges; drop-and-warn for `agent` edges.
- *  - edge.slot absent → default slot (isDefault), synthesized if none exists.
- *
- * Edges naming unknown parents/children are dropped-and-warned (§1.3). Inputs
- * are not mutated; a deep-enough clone of touched slots is returned.
- */
-export declare function applyMapping(components: RawComponentDefinition[], edges: CompositionEdge[]): ApplyMappingResult;

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

@@ -1,34 +0,0 @@
-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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1,17 +0,0 @@
-/**
- * The CLI-owned composition interchange format (spec T1).
- *
- * `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 = 'typed-slot' | 'structural' | 'manifest' | 'doc' | `adapter:${string}` | 'agent';
-export type CompositionEdge = {
-    parent: string;
-    child: string;
-    /** Optional named slot (T7). Default slot when omitted. */
-    slot?: string;
-    /** 1–5 scale, same as select/reject agent tools. */
-    confidence?: number;
-    provenance: EdgeProvenance;
-};

package/legacy/dist/src/analyze/composition/manifest-doc-evidence.d.ts

@@ -1,49 +0,0 @@
-import type { CompositionEdge } from './interchange-schema.js';
-type CandidateFile = {
-    path: string;
-    content: string;
-};
-type ComponentRef = {
-    name: string;
-    sourcePath?: string;
-};
-/**
- * Prompt-injection safeguard for this signal: both parsers below are plain
- * deterministic code, never an LLM prompt. `manifest.json`/`AGENTS.md`
- * content is attacker-adjacent (Figma-authored / free-form prose respectively)
- * but it only ever flows through JSON field access and a fixed regex, then is
- * validated against the real `componentNames` allowlist before an edge is
- * emitted — there is no path from this file's content to model instructions.
- */
-/** Figma/manifest names are kebab-case (`blue-accordion-item`); React exports are PascalCase. */
-export declare function kebabToPascal(name: string): string;
-/**
- * Deterministic parse of a Figma-exported `manifest.json` — no LLM involved.
- * Schema (confirmed against a real design-system manifest):
- *   { component: { name: "blue-accordion" },
- *     variantsMeta: { componentPropertyDefinitions: {
- *       "Slot#1533:33": { type: "SLOT", preferredValues: [{ name: "blue-accordion-item" }] }
- *     } } }
- * The manifest's own `component.name` identifies its owning/parent component
- * (more robust than inferring from directory proximity, since manifest.json
- * typically lives one level below the component's source file, e.g. in a
- * sibling `design/` directory).
- */
-export declare function collectManifestEdges(files: CandidateFile[], componentNames: ReadonlySet<string>): CompositionEdge[];
-/**
- * Deterministic parse of a component-level `AGENTS.md` — no LLM involved.
- * Only a bold-backtick component mention (`` **`ComponentName`** ``) on a
- * line that ALSO carries a composition keyword is accepted, e.g. "Direct
- * **`AccordionItem`** children only." A bare cross-reference mention (no
- * composition keyword on the same line, e.g. "see `other-component`") is
- * rejected — it isn't asserting a parent-child relationship.
- *
- * The doc's owning component is resolved by directory colocation: the
- * component whose `sourcePath` sits in the same directory as the doc file
- * (the real-world convention — `<component>/AGENTS.md` next to
- * `<component>/Component.tsx`).
- */
-export declare function collectAgentsDocEdges(files: CandidateFile[], components: ComponentRef[], componentNames: ReadonlySet<string>): CompositionEdge[];
-/** Both deterministic sources, combined for the `extraEdges` wiring in command.ts. */
-export declare function collectManifestDocEdges(files: CandidateFile[], components: ComponentRef[], componentNames: ReadonlySet<string>): CompositionEdge[];
-export {};

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

@@ -1,19 +0,0 @@
-import type { CompositionEdge, EdgeProvenance } from './interchange-schema.js';
-export type EdgeConflict = {
-    parent: string;
-    child: string;
-    winner: EdgeProvenance;
-    loser: EdgeProvenance;
-};
-export type MergeResult = {
-    edges: CompositionEdge[];
-    conflicts: EdgeConflict[];
-};
-/**
- * Union all edges, resolving conflicts by provenance rank. A conflict is two
- * edges that share `parent::child` but disagree on existence-detail (here:
- * slot placement). The higher-ranked edge wins; the loser is recorded (never
- * silently dropped) so the review UI can surface it. Identical edges (same
- * parent/child/slot) collapse to the highest-ranked copy with no conflict.
- */
-export declare function mergeEdges(all: CompositionEdge[]): MergeResult;

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

@@ -1,16 +0,0 @@
-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

@@ -1,3 +0,0 @@
-/** 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

@@ -1,10 +0,0 @@
-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,59 +0,0 @@
-import type { RawComponentDefinition } from '../../types.js';
-import type { CompositionEdge } from './interchange-schema.js';
-import { type EdgeConflict } from './merge-edges.js';
-export type ResolveMappingResult = {
-    components: RawComponentDefinition[];
-    edges: CompositionEdge[];
-    conflicts: EdgeConflict[];
-    warnings: string[];
-};
-/**
- * Orchestrate composition-edge acquisition and enrichment.
- *
- * 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. 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[];
-}): Promise<ResolveMappingResult>;

package/legacy/dist/src/analyze/cycle-detection.d.ts

@@ -1,27 +0,0 @@
-/** A directed edge in the slot-dependency graph. */
-export interface SlotEdge {
-    fromComponent: string;
-    slotName: string;
-    toComponent: string;
-}
-/** A single elementary cycle, with `path[0] === path[path.length - 1]`. */
-export interface SlotCycle {
-    path: string[];
-    edges: SlotEdge[];
-}
-/** Input shape mirroring the slot definition on CDFComponentEntry. */
-export interface ComponentSlotInfo {
-    name: string;
-    slots: Array<{
-        name: string;
-        allowedComponents?: string[];
-    }>;
-}
-export declare function findSlotCycles(components: ComponentSlotInfo[]): SlotCycle[];
-export declare function suggestCycleBreakEdge(cycle: SlotCycle, allCycles: SlotCycle[]): SlotEdge;
-export declare function formatCyclePath(cycle: SlotCycle, maxHops?: number): string;
-export interface CyclePathSegment {
-    kind: 'component' | 'slot' | 'arrow';
-    text: string;
-}
-export declare function formatCyclePathSegments(cycle: SlotCycle, maxHops?: number): CyclePathSegment[];

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

@@ -1,7 +0,0 @@
-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/analyze/fuzzy-search.d.ts

@@ -1,3 +0,0 @@
-export declare function fuzzyMatches(query: string, text: string): boolean;
-export declare function fuzzyScore(query: string, text: string): number | null;
-export declare function fuzzyFilter(query: string, candidates: string[]): string[];

package/legacy/dist/src/analyze/issue-inheritance.d.ts

@@ -1,8 +0,0 @@
-import type { Closure, NodeStatus } from './composite-closure.js';
-export interface RenderStatus {
-    status: NodeStatus;
-    isOwn: boolean;
-    sourceComponents: string[];
-}
-export declare function computeRenderStatuses(closure: Closure, directIssues: Map<string, NodeStatus>): Map<string, RenderStatus>;
-export declare function pickDrillTarget(ancestor: string, closure: Closure, directIssues: Map<string, NodeStatus>): string | null;

package/legacy/dist/src/analyze/lineage.d.ts

@@ -1,29 +0,0 @@
-import type { ComponentGraphNode } from './composite-closure.js';
-export interface LineageParentEdge {
-    parent: string;
-    slotName: string;
-}
-export interface LineageEdge {
-    from: string;
-    slotName: string;
-    to: string;
-}
-export type LineageChain = LineageEdge[];
-export declare function findDirectParents(target: string, components: ComponentGraphNode[]): LineageParentEdge[];
-export declare function findAllAncestors(target: string, components: ComponentGraphNode[]): Set<string>;
-export declare function findAllAncestorChains(target: string, components: ComponentGraphNode[]): LineageChain[];
-export interface AncestorTreeNode {
-    name: string;
-    incomingSlotName?: string;
-    depth: number;
-    shared: boolean;
-    cycle: boolean;
-    parents: AncestorTreeNode[];
-}
-export declare function buildAncestorTree(target: string, components: ComponentGraphNode[]): AncestorTreeNode;
-export interface AncestorTreeLine {
-    text: string;
-    jumpTarget?: string;
-    depth: number;
-}
-export declare function renderAncestorTree(node: AncestorTreeNode): AncestorTreeLine[];

package/legacy/dist/src/analyze/search-neighborhood.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentGraphNode } from './composite-closure.js';
-export declare function computeDirectNeighborhood(matches: Iterable<string>, graph: ComponentGraphNode[]): Set<string>;
-export declare function findAllAncestors(target: string, graph: ComponentGraphNode[]): Set<string>;