@fragments-sdk/cli 0.7.0 → 0.7.2

package/src/commands/enhance.ts

@@ -71,9 +71,9 @@ export interface EnhanceOptions {
 }
 
 /**
- * Enhanced segment data
+ * Enhanced fragment data
  */
-export interface EnhancedSegment {
+export interface EnhancedFragment {
   componentName: string;
   added: {
     when: string[];
@@ -90,7 +90,7 @@ export interface EnhancedSegment {
  */
 export interface EnhanceResult {
   success: boolean;
-  enhanced: EnhancedSegment[];
+  enhanced: EnhancedFragment[];
   totalTokens: number;
   estimatedCost: number;
   /** Context output for IDE AI mode */
@@ -211,9 +211,9 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
   }
 
   // Search entire root dir, not just src/
-  const segmentFiles = await findSegmentFiles(rootDir);
+  const fragmentFiles = await findFragmentFiles(rootDir);
 
-  if (segmentFiles.length === 0) {
+  if (fragmentFiles.length === 0) {
     const msg = 'No fragment files found';
     if (format === 'json') {
       console.log(JSON.stringify({ success: false, error: msg }));
@@ -224,7 +224,7 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
   }
 
   if (isInteractive) {
-    console.log(pc.green(`  Found ${segmentFiles.length} fragment files`));
+    console.log(pc.green(`  Found ${fragmentFiles.length} fragment files`));
   }
 
   // Filter components if specified
@@ -232,7 +232,7 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
   if (component && component !== 'all') {
     componentsToEnhance = [component];
   } else {
-    componentsToEnhance = segmentFiles.map(f => extractComponentName(f));
+    componentsToEnhance = fragmentFiles.map(f => extractComponentName(f));
   }
 
   // Phase 4: Extract props from TypeScript source files
@@ -242,16 +242,16 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
 
   const propsExtractions = new Map<string, PropsExtractionResult>();
   for (const compName of componentsToEnhance) {
-    const segmentFile = segmentFiles.find(f => extractComponentName(f) === compName);
-    if (!segmentFile) continue;
+    const fragmentFile = fragmentFiles.find(f => extractComponentName(f) === compName);
+    if (!fragmentFile) continue;
 
-    // Try to find the component source file relative to the segment file
-    const segmentDir = segmentFile.replace(/\.segment\.(tsx?|jsx?)$/, '');
+    // Try to find the component source file relative to the fragment file
+    const fragmentDir = fragmentFile.replace(/\.fragment\.(tsx?|jsx?)$/, '');
     const possiblePaths = [
-      `${segmentDir}.tsx`,
-      `${segmentDir}.ts`,
-      `${segmentDir}/index.tsx`,
-      `${segmentDir}/index.ts`,
+      `${fragmentDir}.tsx`,
+      `${fragmentDir}.ts`,
+      `${fragmentDir}/index.tsx`,
+      `${fragmentDir}/index.ts`,
       join(rootDir, 'src', 'components', `${compName}.tsx`),
       join(rootDir, 'src', 'components', compName, `${compName}.tsx`),
       join(rootDir, 'src', 'components', compName, 'index.tsx'),
@@ -332,14 +332,14 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
   }
 
   // Build contexts for all components
-  const contexts: Array<{ name: string; context: ComponentContext; segmentFile: string }> = [];
+  const contexts: Array<{ name: string; context: ComponentContext; fragmentFile: string }> = [];
   for (const compName of componentsToEnhance) {
     const analysis = usageAnalysis.components[compName];
     const stories = storyFiles.get(compName);
-    const segmentFile = segmentFiles.find(f => extractComponentName(f) === compName);
+    const fragmentFile = fragmentFiles.find(f => extractComponentName(f) === compName);
     const propsExtraction = propsExtractions.get(compName);
 
-    if (!segmentFile) continue;
+    if (!fragmentFile) continue;
 
     const context = generateComponentContext(
       compName,
@@ -348,7 +348,7 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
       stories,
       propsExtraction
     );
-    contexts.push({ name: compName, context, segmentFile });
+    contexts.push({ name: compName, context, fragmentFile });
   }
 
   // Context-only mode: output prompts for IDE AI
@@ -361,13 +361,13 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
     console.log(pc.dim(`\nPhase 6: Generating AI enhancements for ${componentsToEnhance.length} component(s)...\n`));
   }
 
-  const enhanced: EnhancedSegment[] = [];
+  const enhanced: EnhancedFragment[] = [];
   let totalTokens = 0;
 
   // Initialize AI client
   const aiClient = await createAIClient(provider, apiKey!);
 
-  for (const { name: compName, context, segmentFile } of contexts) {
+  for (const { name: compName, context, fragmentFile } of contexts) {
     // Check if we have enough data
     if (!context.usageAnalysis || context.usageAnalysis.totalUsages < 2) {
       enhanced.push({
@@ -426,7 +426,7 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
   // Phase 7: Apply changes
   if (!dryRun) {
     if (isInteractive) {
-      console.log(pc.dim('\nPhase 7: Updating segment files...'));
+      console.log(pc.dim('\nPhase 7: Updating fragment files...'));
     }
 
     for (const result of enhanced) {
@@ -434,17 +434,17 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
         continue;
       }
 
-      const segmentFile = segmentFiles.find(f => extractComponentName(f) === result.componentName);
-      if (!segmentFile) continue;
+      const fragmentFile = fragmentFiles.find(f => extractComponentName(f) === result.componentName);
+      if (!fragmentFile) continue;
 
       try {
-        await updateSegmentFile(segmentFile, result.added);
+        await updateFragmentFile(fragmentFile, result.added);
         if (isInteractive) {
-          console.log(pc.green(`  Updated: ${relative(rootDir, segmentFile)}`));
+          console.log(pc.green(`  Updated: ${relative(rootDir, fragmentFile)}`));
         }
       } catch {
         if (isInteractive) {
-          console.log(pc.red(`  Failed to update: ${relative(rootDir, segmentFile)}`));
+          console.log(pc.red(`  Failed to update: ${relative(rootDir, fragmentFile)}`));
         }
       }
     }
@@ -488,7 +488,7 @@ export async function enhance(options: EnhanceOptions = {}): Promise<EnhanceResu
  * Handle context-only mode for IDE AI
  */
 function handleContextOnlyMode(
-  contexts: Array<{ name: string; context: ComponentContext; segmentFile: string }>,
+  contexts: Array<{ name: string; context: ComponentContext; fragmentFile: string }>,
   format: string,
   isInteractive: boolean
 ): EnhanceResult {
@@ -544,7 +544,7 @@ For each component, provide your response in JSON format:
     console.log(pc.dim('─'.repeat(60)));
     console.log();
     console.log(pc.green('Tip: In Cursor, press Cmd+L to open chat and paste this prompt.'));
-    console.log(pc.dim('After getting suggestions, manually update your segment files.'));
+    console.log(pc.dim('After getting suggestions, manually update your fragment files.'));
     console.log();
   }
 
@@ -783,11 +783,11 @@ function calculateCost(provider: AIProvider, tokens: number): number {
 }
 
 /**
- * Find all segment files in a directory
+ * Find all fragment files in a directory
  */
-async function findSegmentFiles(dir: string): Promise<string[]> {
+async function findFragmentFiles(dir: string): Promise<string[]> {
   const fg = await import('fast-glob');
-  return fg.default(['**/*.segment.tsx', '**/*.segment.ts'], {
+  return fg.default(['**/*.fragment.tsx', '**/*.fragment.ts'], {
     cwd: dir,
     absolute: true,
     ignore: ['**/node_modules/**', '**/dist/**'],
@@ -795,17 +795,17 @@ async function findSegmentFiles(dir: string): Promise<string[]> {
 }
 
 /**
- * Extract component name from segment file path
+ * Extract component name from fragment file path
  */
 function extractComponentName(filePath: string): string {
-  const match = filePath.match(/([^/\\]+)\.segment\.(tsx?|jsx?)$/);
+  const match = filePath.match(/([^/\\]+)\.fragment\.(tsx?|jsx?)$/);
   return match ? match[1] : '';
 }
 
 /**
- * Update a segment file with new when/whenNot suggestions
+ * Update a fragment file with new when/whenNot suggestions
  */
-async function updateSegmentFile(
+async function updateFragmentFile(
   filePath: string,
   suggestions: { when: string[]; whenNot: string[] }
 ): Promise<void> {

package/src/commands/generate.ts

@@ -57,7 +57,7 @@ export async function generate(options: GenerateOptions = {}): Promise<GenerateR
     ignore: [
       "**/node_modules/**",
       "**/*.stories.*",
-      "**/*.segment.*",
+      "**/*.fragment.*",
       "**/*.test.*",
       "**/*.spec.*",
       "**/*.d.ts",

package/src/commands/graph.ts

@@ -8,7 +8,7 @@
 import pc from 'picocolors';
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
-import type { CompiledSegmentsFile } from '../core/index.js';
+import type { CompiledFragmentsFile } from '../core/index.js';
 import { BRAND } from '../core/index.js';
 import { loadConfig } from '../core/node.js';
 import {
@@ -33,10 +33,10 @@ export async function graph(
   const { config, configDir } = await loadConfig(options.config);
   const outputPath = resolve(configDir, config.outFile ?? BRAND.outFile);
 
-  let data: CompiledSegmentsFile;
+  let data: CompiledFragmentsFile;
   try {
     const content = await readFile(outputPath, 'utf-8');
-    data = JSON.parse(content) as CompiledSegmentsFile;
+    data = JSON.parse(content) as CompiledFragmentsFile;
   } catch {
     console.error(
       pc.red(`Error: Could not load ${BRAND.outFile}. Run \`${BRAND.cliCommand} build\` first.`),
@@ -205,8 +205,8 @@ export async function graph(
       if (tree.subComponents.length > 0) {
         console.log(`  ${pc.cyan('Sub-components:')}`);
         for (const sub of tree.subComponents) {
-          const isRequired = tree.requiredChildren.includes(sub);
-          console.log(`    ${pc.yellow(sub)}${isRequired ? pc.red(' (required)') : ''}`);
+          const isChild = tree.children.includes(sub);
+          console.log(`    ${pc.yellow(sub)}${isChild ? pc.dim(' (child)') : ''}`);
         }
       }
       if (tree.siblings.length > 0) {

package/src/commands/init.ts

@@ -428,7 +428,7 @@ export async function init(options: InitOptions = {}): Promise<InitResult> {
   // Note: Stories are loaded separately by the viewer, not via include patterns
   const includePaths: string[] = [
     `${componentPath}/**/*.fragment.tsx`,
-    `${componentPath}/**/*.segment.tsx`, // Legacy support
+    `${componentPath}/**/*.fragment.tsx`, // Legacy support
   ];
 
   // Create config file