@contentful/experience-design-system-cli 2.6.2-dev-build-864e323.0 → 2.7.0

package/dist/package.json

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

package/dist/src/analyze/command.js

@@ -153,7 +153,7 @@ export function registerAnalyzeCommand(program) {
                 propCount: c.props.length,
                 slotCount: c.slots.length,
                 warnings: allWarnings.filter((w) => w.startsWith(c.name + ':')),
-                extractionConfidence: c.extractionConfidence ?? 100,
+                extractionConfidence: c.extractionConfidence ?? null,
                 needsReview: c.needsReview ?? false,
             })),
             totalWarnings: allWarnings.length,

package/dist/src/analyze/extract/scoring.d.ts

@@ -1,7 +1,8 @@
 import type { RawComponentDefinition } from '../../types.js';
+export type ExtractionConfidence = 1 | 2 | 3 | 4 | 5;
 export type ExtractionScore = {
-    confidence: number;
+    confidence: ExtractionConfidence;
     reasons: string[];
 };
 export declare function computeExtractionScore(component: RawComponentDefinition): ExtractionScore;
-export declare function deriveNeedsReview(confidence: number): boolean;
+export declare function deriveNeedsReview(confidence: ExtractionConfidence): boolean;

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

@@ -41,47 +41,64 @@ function isWidePrimitiveUnion(type) {
     const nullability = new Set(['null', 'undefined']);
     const baseCount = parts.filter((p) => basePrimitives.has(p)).length;
     const nullabilityCount = parts.filter((p) => nullability.has(p)).length;
-    // Wide only when there are 3+ base primitives, or 2+ base primitives combined with nullability modifiers
     return baseCount >= 3 || (baseCount >= 2 && nullabilityCount > 0 && baseCount + nullabilityCount >= 3);
 }
-export function computeExtractionScore(component) {
-    let confidence = 100;
+// Count the number of issues found for scoring
+function countIssues(component) {
+    let count = 0;
     const reasons = [];
-    // No props and no slots — extractor likely missed something or component is a wrapper
     if (component.props.length === 0 && component.slots.length === 0) {
-        confidence -= 15;
+        count++;
         reasons.push('no-props-or-slots');
     }
+    if (component.props.length > 50) {
+        count++;
+        reasons.push(`high-prop-count:${component.props.length}`);
+    }
     for (const prop of component.props) {
-        // Opaque types — extractor couldn't resolve the real type
         if (OPAQUE_TYPES.has(prop.type.trim())) {
-            confidence -= 20;
+            count++;
             reasons.push(`opaque-type:${prop.name}`);
-            break; // only penalise once per component
+            break;
         }
-        // Wide primitive union — hard for the AI agent to classify meaningfully
         if (isWidePrimitiveUnion(prop.type)) {
-            confidence -= 10;
+            count++;
             reasons.push(`wide-union:${prop.name}`);
-            break; // only penalise once
+            break;
         }
-        // Non-obvious prop name with no description
         if (!prop.description && !OBVIOUS_PROP_NAMES.has(prop.name)) {
-            confidence -= 10;
+            count++;
             reasons.push('props-missing-description');
-            break; // only penalise once
+            break;
         }
     }
-    // High prop count — possible DOM inflation near-miss or overly broad extraction
-    if (component.props.length > 50) {
-        confidence -= 20;
-        reasons.push(`high-prop-count:${component.props.length}`);
-    }
+    return { count, reasons: [...new Set(reasons)] };
+}
+// Maps issue count to a 1–5 confidence scale:
+//   0 issues → 5 (clean)
+//   1 issue  → 4 (minor concern)
+//   2 issues → 3 (moderate concern)
+//   3 issues → 2 (significant concern)
+//   4+ issues → 1 (likely wrong)
+function issueCountToConfidence(count) {
+    if (count === 0)
+        return 5;
+    if (count === 1)
+        return 4;
+    if (count === 2)
+        return 3;
+    if (count === 3)
+        return 2;
+    return 1;
+}
+export function computeExtractionScore(component) {
+    const { count, reasons } = countIssues(component);
     return {
-        confidence: Math.max(0, Math.min(100, confidence)),
-        reasons: [...new Set(reasons)], // deduplicate
+        confidence: issueCountToConfidence(count),
+        reasons,
     };
 }
+// Flag components scoring 2 or below for human review
 export function deriveNeedsReview(confidence) {
-    return confidence < 70;
+    return confidence <= 2;
 }

package/dist/src/analyze/select/tui/App.js

@@ -3,6 +3,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Box, Text, useStdout } from 'ink';
 import { readFile } from 'node:fs/promises';
 import { createReviewSessionDetail } from '../types.js';
+import { stripScoringFields } from '../../../types.js';
 import { TopBar } from './components/TopBar.js';
 import { Sidebar } from './components/Sidebar.js';
 import { ComponentDetail } from './components/ComponentDetail.js';
@@ -285,10 +286,7 @@ export function App({ sessionId, artifactsRoot, reviewRoot }) {
             setEditMode(true);
             setDraftsByComponentId((prev) => ({
                 ...prev,
-                [selectedId]: (() => {
-                    const { extractionConfidence: _c, reviewReasons: _r, needsReview: _n, ...rest } = component.editedProposal;
-                    return prev[selectedId] ?? JSON.stringify(rest, null, 2);
-                })(),
+                [selectedId]: prev[selectedId] ?? JSON.stringify(stripScoringFields(component.editedProposal), null, 2),
             }));
         },
         onToggleSource: () => {
@@ -339,7 +337,7 @@ export function App({ sessionId, artifactsRoot, reviewRoot }) {
         name: c.name,
         status: c.status,
         previewAnnotation: previewAnnotations[c.name],
-        extractionConfidence: c.originalProposal.extractionConfidence ?? 100,
+        extractionConfidence: c.originalProposal.extractionConfidence ?? null,
         needsReview: c.originalProposal.needsReview ?? false,
     }))
         .sort((a, b) => {
@@ -347,7 +345,10 @@ export function App({ sessionId, artifactsRoot, reviewRoot }) {
         const bFlagged = b.needsReview && b.status === 'needs-review' ? 0 : 1;
         if (aFlagged !== bFlagged)
             return aFlagged - bFlagged;
-        return a.extractionConfidence - b.extractionConfidence;
+        // null (unscored) sorts last; lower numeric score sorts first (most concerning)
+        const aConf = a.extractionConfidence ?? 6;
+        const bConf = b.extractionConfidence ?? 6;
+        return aConf - bConf;
     }), [session?.components, previewAnnotations]);
     // Stable ID order — kept in a ref for use inside keymap handlers
     const sortedIds = useMemo(() => sessionSummary.map((c) => c.id), [sessionSummary]);

package/dist/src/analyze/select/tui/components/ComponentDetail.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
+import { stripScoringFields } from '../../../../types.js';
 import { JsonPanel } from './JsonPanel.js';
 import { FieldEditor } from './FieldEditor.js';
 import { SourcePanel } from './SourcePanel.js';
@@ -34,14 +35,12 @@ export function ComponentDetail({ component, sourceCode, draftValue, editMode, s
         editWidth = availableWidth - originalWidth - 3;
         sourceWidth = 0;
     }
-    // Strip internal scoring fields — they're metadata, not part of the component definition
-    const stripScoring = ({ extractionConfidence: _c, reviewReasons: _r, needsReview: _n, ...rest }) => rest;
-    const originalJson = JSON.stringify(stripScoring(component.originalProposal), null, 2);
-    const editedJson = JSON.stringify(stripScoring(component.editedProposal), null, 2);
-    const conf = component.originalProposal.extractionConfidence ?? 100;
+    const originalJson = JSON.stringify(stripScoringFields(component.originalProposal), null, 2);
+    const editedJson = JSON.stringify(stripScoringFields(component.editedProposal), null, 2);
+    const conf = component.originalProposal.extractionConfidence ?? null;
     const nr = component.originalProposal.needsReview ?? false;
-    const confColor = nr ? 'red' : conf >= 80 ? 'white' : conf >= 50 ? 'yellow' : 'red';
-    const confLabel = (nr ? '⚑ ' : '') + 'confidence: ' + String(conf);
+    const confColor = conf === null ? 'gray' : nr ? 'red' : conf >= 4 ? 'white' : conf >= 3 ? 'yellow' : 'red';
+    const confLabel = conf === null ? 'confidence: —' : (nr ? '⚑ ' : '') + 'confidence: ' + String(conf) + '/5';
     return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: component.name }), (() => {
                         const ann = annotationLabel(previewAnnotation);
                         return ann ? _jsx(Text, { color: ann.color, children: ann.text }) : null;

package/dist/src/analyze/select/types.d.ts

@@ -22,7 +22,7 @@ export type ReviewComponentSummary = {
     name: string;
     status: ReviewComponentStatus;
     previewAnnotation?: PreviewAnnotation;
-    extractionConfidence: number;
+    extractionConfidence: number | null;
     needsReview: boolean;
 };
 export type ReviewSessionSnapshot = {

package/dist/src/analyze/select/types.js

@@ -4,7 +4,7 @@ export function createReviewSessionSummary(session) {
             id: component.id,
             name: component.name,
             status: component.status,
-            extractionConfidence: component.originalProposal.extractionConfidence ?? 100,
+            extractionConfidence: component.originalProposal.extractionConfidence ?? null,
             needsReview: component.originalProposal.needsReview ?? false,
         })),
     };

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

@@ -9,7 +9,7 @@ export type AnalyzeViewResult = {
         propCount: number;
         slotCount: number;
         warnings: string[];
-        extractionConfidence: number;
+        extractionConfidence: number | null;
         needsReview: boolean;
     }>;
     totalWarnings: number;

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

@@ -50,9 +50,9 @@ export function AnalyzeView({ result, onExit }) {
                                     result.components.length +
                                     ')'
                                 : '') }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), showScrollUp && _jsx(Text, { dimColor: true, children: " \u25B2 scroll up" }), visible.map((component) => {
-                        const conf = component.extractionConfidence ?? 100;
-                        const confColor = component.needsReview ? 'red' : conf >= 80 ? 'white' : conf >= 50 ? 'yellow' : 'red';
-                        const confLabel = (component.needsReview ? '⚑ ' : '') + String(conf);
+                        const conf = component.extractionConfidence;
+                        const confColor = conf === null ? 'gray' : component.needsReview ? 'red' : conf >= 4 ? 'white' : conf >= 3 ? 'yellow' : 'red';
+                        const confLabel = conf === null ? '—' : (component.needsReview ? '⚑ ' : '') + String(conf);
                         return (_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')).padEnd(8) }), _jsx(Text, { color: confColor, children: confLabel }), component.warnings.length > 0 && (_jsx(Text, { color: "yellow", children: '  ⚠ ' + component.warnings.length + ' warning' + (component.warnings.length === 1 ? '' : 's') }))] }, component.name));
                     }), showScrollDown && _jsx(Text, { dimColor: true, children: " \u25BC scroll down" }), 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)

package/dist/src/generate/agent-runner.js

@@ -30,8 +30,13 @@ export function parseSelectToolCallLines(stdout) {
         };
         if (typeof rec.reason === 'string')
             call.reason = rec.reason;
-        if (typeof rec.confidence === 'number' && rec.confidence >= 0 && rec.confidence <= 100) {
-            call.confidence = rec.confidence;
+        if (typeof rec.confidence === 'number' && rec.confidence >= 1 && rec.confidence <= 5) {
+            if (call.tool === 'select_component') {
+                call.confidence = rec.confidence;
+            }
+            else {
+                call.confidence = rec.confidence;
+            }
         }
         calls.push(call);
     }

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

@@ -185,7 +185,7 @@ export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, }) {
         id: c.key,
         name: c.key,
         status: c.status,
-        extractionConfidence: 100,
+        extractionConfidence: null,
         needsReview: false,
     }));
     const longestName = components.reduce((m, c) => Math.max(m, c.key.length), 0);

package/dist/src/session/db.js

@@ -43,7 +43,7 @@ CREATE TABLE IF NOT EXISTS raw_components (
   status                 TEXT NOT NULL DEFAULT 'extracted',
   cdf_schema             TEXT,
   description            TEXT,
-  extraction_confidence  INTEGER NOT NULL DEFAULT 100,
+  extraction_confidence  INTEGER,
   review_reasons         TEXT NOT NULL DEFAULT '[]',
   needs_review           INTEGER NOT NULL DEFAULT 0,
   PRIMARY KEY (session_id, component_id)
@@ -171,7 +171,7 @@ function applyDbMigrations(db) {
     const rawCompCols = db.prepare('PRAGMA table_info(raw_components)').all();
     const rawCompColNames = new Set(rawCompCols.map((c) => c.name));
     if (!rawCompColNames.has('extraction_confidence')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN extraction_confidence INTEGER NOT NULL DEFAULT 100');
+        db.exec('ALTER TABLE raw_components ADD COLUMN extraction_confidence INTEGER');
     }
     if (!rawCompColNames.has('review_reasons')) {
         db.exec("ALTER TABLE raw_components ADD COLUMN review_reasons TEXT NOT NULL DEFAULT '[]'");
@@ -402,7 +402,7 @@ export function storeRawComponents(db, sessionId, components, options) {
         db.prepare('DELETE FROM raw_components WHERE session_id = ?').run(sessionId);
         for (const comp of components) {
             const componentId = deriveComponentId(comp.name, comp.source);
-            insertComp.run(sessionId, componentId, comp.name, comp.source, comp.framework, now, comp.extractionConfidence ?? 100, JSON.stringify(comp.reviewReasons ?? []), comp.needsReview ? 1 : 0);
+            insertComp.run(sessionId, componentId, comp.name, comp.source, comp.framework, now, comp.extractionConfidence ?? null, JSON.stringify(comp.reviewReasons ?? []), comp.needsReview ? 1 : 0);
             for (let i = 0; i < comp.props.length; i++) {
                 const prop = comp.props[i];
                 insertProp.run(sessionId, componentId, prop.name, prop.type, prop.required ? 1 : 0, prop.category ?? null, prop.defaultValue ?? null, prop.description ?? null, prop.tokenReference ?? null, i);
@@ -513,7 +513,7 @@ export function loadRawComponents(db, sessionId, allowedNames) {
         name: c.name,
         source: c.source,
         framework: c.framework,
-        extractionConfidence: c.extraction_confidence ?? 100,
+        extractionConfidence: c.extraction_confidence ?? null,
         reviewReasons: (() => {
             try {
                 return JSON.parse(c.review_reasons ?? '[]');

package/dist/src/types.d.ts

@@ -34,7 +34,7 @@ export interface RawComponentDefinition {
      * non-authorable context-provider components.
      */
     usesCreateContext?: boolean;
-    extractionConfidence?: number;
+    extractionConfidence?: number | null;
     reviewReasons?: string[];
     needsReview?: boolean;
 }
@@ -55,3 +55,5 @@ export interface TokenExtractor {
     name: string;
     extract(projectRoot: string): Promise<RawTokenDefinition[]>;
 }
+/** Strip internal scoring fields before serialising a RawComponentDefinition for display or editing. */
+export declare function stripScoringFields({ extractionConfidence: _c, reviewReasons: _r, needsReview: _n, ...rest }: RawComponentDefinition): Omit<RawComponentDefinition, 'extractionConfidence' | 'reviewReasons' | 'needsReview'>;

package/dist/src/types.js

@@ -1 +1,4 @@
-export {};
+/** Strip internal scoring fields before serialising a RawComponentDefinition for display or editing. */
+export function stripScoringFields({ extractionConfidence: _c, reviewReasons: _r, needsReview: _n, ...rest }) {
+    return rest;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.6.2-dev-build-864e323.0",
+  "version": "2.7.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -36,7 +36,7 @@
     "react-dom": "^18.3.1",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
-    "@contentful/experience-design-system-types": "2.6.2-dev-build-864e323.0"
+    "@contentful/experience-design-system-types": "2.7.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.3",

package/skills/select-components.md

@@ -70,16 +70,21 @@ Emit one JSON object on a single line. Lines not starting with `{` are ignored b
 **Two tool calls — emit exactly one:**
 
 ```
-{"tool":"select_component","name":"<ComponentName>","reason":"<brief reason>","confidence":<0-100>}
+{"tool":"select_component","name":"<ComponentName>","reason":"<brief reason>","confidence":<1-5>}
 
-{"tool":"reject_component","name":"<ComponentName>","reason":"<brief reason>","confidence":<0-100>}
+{"tool":"reject_component","name":"<ComponentName>","reason":"<brief reason>","confidence":<1-5>}
 ```
 
 **Rules:**
 - Emit exactly one JSON object, on one line. No multi-line JSON. No markdown fences.
 - The `name` must match the component name in the input.
 - `reason` is a brief phrase documenting your decision.
-- `confidence` is your certainty (0–100) that the decision is correct. Use 90–100 for obvious cases (clear UI atom or obvious infrastructure), 60–80 for borderline cases (few props, ambiguous purpose), and below 60 when you're genuinely unsure.
+- `confidence` is your certainty (1–5) that the decision is correct:
+  - **5** — obvious case, no doubt (clear UI atom, or clear infrastructure with no visual output)
+  - **4** — likely correct, minor ambiguity
+  - **3** — uncertain, borderline component (few props, ambiguous purpose, could go either way)
+  - **2** — low confidence, guessing
+  - **1** — very unsure, human review strongly recommended
 - Emit prose lines (not starting with `{`) to log your reasoning before the final tool call.
 
 ---