@codeyam/codeyam-cli 0.1.13 → 0.1.15

package/analyzer-template/.build-info.json

@@ -1,10 +1,10 @@
 {
-  "buildTimestamp": "2026-03-17T22:42:54.370Z",
-  "buildTime": 1773787374370,
-  "gitCommit": "6af1ab46096de2c86af4f0947046703a16ac9786",
+  "buildTimestamp": "2026-03-18T20:56:41.501Z",
+  "buildTime": 1773867401501,
+  "gitCommit": "3328e60080cd05630588c6f1b139c2caffcb164a",
   "nodeVersion": "v20.20.1",
   "contentHash": "b046e014847d5b02d10d6795839ccd0d5117627cbd0be413260824610596a63d",
-  "buildNumber": 1087,
-  "semanticVersion": "0.1.1087",
-  "version": "0.1.1087 (2026-03-17T22:42+b046e01)"
+  "buildNumber": 1100,
+  "semanticVersion": "0.1.1100",
+  "version": "0.1.1100 (2026-03-18T20:56+b046e01)"
 }

package/analyzer-template/log.txt

@@ -1,7 +1,7 @@
 
-[3/17/2026, 10:42:54 PM] > codeyam-combo@1.0.0 mergeDependencies
-[3/17/2026, 10:42:54 PM] > node ./scripts/mergePackageJsonFiles.cjs
+[3/18/2026, 8:56:41 PM] > codeyam-combo@1.0.0 mergeDependencies
+[3/18/2026, 8:56:41 PM] > node ./scripts/mergePackageJsonFiles.cjs
 
 
-[3/17/2026, 10:42:54 PM] Merged dependencies into root package.json
+[3/18/2026, 8:56:41 PM] Merged dependencies into root package.json
 

package/codeyam-cli/src/commands/editor.js

@@ -205,6 +205,8 @@ function checkbox(text) {
  * Prints seed-based scenarios, mock-based fallback, @ file prefix, externalApis, url requirement, and error checking.
  */
 function printAppScenarioInstructions(pageName, route) {
+    const root = process.cwd();
+    const hasSeedAdapter = !!detectSeedAdapter(root);
     checkbox('Check existing scenarios: `codeyam editor scenarios`');
     console.log(chalk.dim('    Review existing scenarios — reuse and update their data rather than'));
     console.log(chalk.dim('    creating duplicates. Re-register with the same name to update a scenario.'));
@@ -230,10 +232,18 @@ function printAppScenarioInstructions(pageName, route) {
     console.log(chalk.yellow('    Required fields: "type":"application", "url" (real route), "pageFilePath" (source file)'));
     console.log(chalk.yellow('    Do NOT include "componentName" — that would make it a component scenario'));
     console.log();
-    checkbox('Choose the right data approach for scenarios:');
-    console.log(chalk.dim('    With seed adapter: add "seed":{...} to populate the database for each state'));
-    console.log(chalk.dim('    Without seed adapter: add "mockData":{"routes":{"/api/...":{"body":[...]}}} to mock API responses'));
-    console.log(chalk.dim('    For external APIs (Stripe, weather, etc.): add "externalApis":{"GET https://...":{"body":[...],"status":200}}'));
+    if (hasSeedAdapter) {
+        checkbox(chalk.bold.red('REQUIRED: Every app scenario MUST include "seed" data — without it the page will be empty!'));
+        console.log(chalk.yellow('    A seed adapter exists — you MUST include "seed":{...} in every app scenario registration.'));
+        console.log(chalk.yellow('    An app scenario without seed data will render an empty page (no database rows = nothing to show).'));
+        console.log(chalk.dim('    "seed" maps table names to arrays of rows: "seed":{"user":[{"id":1,"name":"Alice"}],"article":[...]}'));
+        console.log(chalk.dim('    For external APIs: also add "externalApis":{"GET https://...":{"body":[...],"status":200}}'));
+    }
+    else {
+        checkbox('Include data in every app scenario — without it the page will be empty:');
+        console.log(chalk.dim('    Use "mockData":{"routes":{"/api/...":{"body":[...]}}} to mock API responses'));
+        console.log(chalk.dim('    For external APIs: add "externalApis":{"GET https://...":{"body":[...],"status":200}}'));
+    }
     checkbox('For large seed/mock data, write JSON to a temp file and use @ prefix:');
     console.log(chalk.dim('    Write JSON to .codeyam/tmp/scenario.json then register with:'));
     console.log(chalk.dim('    codeyam editor register @.codeyam/tmp/scenario.json'));
@@ -320,7 +330,7 @@ function printComponentCaptureInstructions() {
     console.log(chalk.dim('       The route defines a `scenarios` object mapping scenario names to props,'));
     console.log(chalk.dim('       reads `?s=ScenarioName` from the URL, and renders the component with those props.'));
     console.log(chalk.dim('       Wrap the component in a capture container with id="codeyam-capture":'));
-    console.log(chalk.dim('       <div id="codeyam-capture" style={{ display:"inline-block", padding:"20px" }}>'));
+    console.log(chalk.dim('       <div id="codeyam-capture" style={{ display:"inline-block" }}>'));
     console.log(chalk.dim('         <div style={{ width:"100%", maxWidth:"..." }}> ← match the app\'s container width'));
     console.log(chalk.dim('       e.g. card in a 3-col grid → maxWidth:"24rem", full-width component → omit maxWidth'));
     console.log(chalk.dim('       The screenshot captures just this wrapper, so the component fills the image.'));
@@ -1444,8 +1454,6 @@ function printStep12(root, feature) {
 }
 // ─── Step 13: Present ─────────────────────────────────────────────────
 function printStep13(root, feature) {
-    const port = getServerPort();
-    const { defaultName: dim, names: dimNames } = getProjectDimensions(root);
     const prevState = readState(root);
     const isResuming = prevState?.step === 13;
     const now = new Date().toISOString();
@@ -1464,18 +1472,9 @@ function printStep13(root, feature) {
     console.log('Present the results to the user and get their approval.');
     console.log();
     console.log(chalk.bold('Checklist:'));
-    checkbox('Fetch all scenarios: `codeyam editor scenarios`');
-    console.log(chalk.dim('    Each scenario has a `changeStatus` field: "new", "edited", "impacted", or null.'));
-    checkbox('Pick the best scenario to showcase from this working session:');
-    console.log(chalk.dim('    Prefer scenarios with changeStatus "new" or "edited" (directly changed in this session).'));
-    console.log(chalk.dim('    For app-level scenarios, prefer those showing the new/changed functionality.'));
-    console.log(chalk.dim('    NEVER pick a scenario with changeStatus null — those are unchanged from a previous commit.'));
-    checkbox('Switch the preview to that scenario using its `id` and `dimension`:');
-    console.log(chalk.dim(`    codeyam editor preview '{"scenarioId":"<id>","dimension":"${dim}"}'`));
-    console.log(chalk.dim('    Use the dimension that matches the scenario — check its registered dimensions.'));
-    printDimensionGuidance(dim, dimNames);
     checkbox(`Show the results panel: \`codeyam editor show-results\``);
     console.log(chalk.dim('    This opens a visual panel below the terminal showing all scenarios with screenshots.'));
+    console.log(chalk.dim('    The preview automatically switches to the first app-level scenario.'));
     console.log(chalk.dim('    The user can click scenarios to switch the live preview.'));
     checkbox('Write a 1-2 sentence summary of what was built');
     checkbox('Report test count and audit status (one line)');
@@ -1705,7 +1704,6 @@ function printMigrateStep4(root) {
     }
     const { pageName, pageIndex, totalPages } = pageInfo;
     writeMigrationStepState(root, 4, pageName, pageIndex, totalPages);
-    const { defaultName: dim, names: dimNames } = getProjectDimensions(root);
     console.log();
     console.log(chalk.bold.cyan(`━━━ Migration Step 4: Preview — ${pageName} (${pageIndex + 1}/${totalPages}) ━━━`));
     console.log();
@@ -1715,11 +1713,8 @@ function printMigrateStep4(root) {
     checkbox('Review all scenario screenshots for this page — do they look correct?');
     checkbox('Check for client errors: `codeyam editor client-errors`');
     checkbox('If any issues: fix the scenario data, re-register affected scenarios');
-    checkbox('Fetch all scenarios: `codeyam editor scenarios`');
-    checkbox('Pick the best scenario to showcase:');
-    console.log(chalk.dim(`    codeyam editor preview '{"scenarioId":"<id>","dimension":"${dim}"}'`));
-    printDimensionGuidance(dim, dimNames);
     checkbox('Show results: `codeyam editor show-results`');
+    console.log(chalk.dim('    The preview automatically switches to the first app-level scenario.'));
     console.log();
     console.log(chalk.dim('The user should now see their existing page with live screenshots in the preview.'));
     migrationStopGate(4, pageName, pageIndex, totalPages);
@@ -1879,18 +1874,14 @@ function printMigrateStep10(root) {
     }
     const { pageName, pageIndex, totalPages } = pageInfo;
     writeMigrationStepState(root, 10, pageName, pageIndex, totalPages);
-    const { defaultName: dim, names: dimNames } = getProjectDimensions(root);
     console.log();
     console.log(chalk.bold.cyan(`━━━ Migration Step 10: Present — ${pageName} (${pageIndex + 1}/${totalPages}) ━━━`));
     console.log();
     console.log("Show results and commit this page's migration.");
     console.log();
     console.log(chalk.bold('Checklist:'));
-    checkbox('Fetch all scenarios: `codeyam editor scenarios`');
-    checkbox('Pick the best scenario to showcase:');
-    console.log(chalk.dim(`    codeyam editor preview '{"scenarioId":"<id>","dimension":"${dim}"}'`));
-    printDimensionGuidance(dim, dimNames);
     checkbox('Show results: `codeyam editor show-results`');
+    console.log(chalk.dim('    The preview automatically switches to the first app-level scenario.'));
     checkbox('Write a 1-2 sentence summary of what was migrated');
     console.log();
     console.log(chalk.bold('Present a selection menu (AskUserQuestion with these EXACT option labels):'));
@@ -2363,6 +2354,8 @@ async function handleAnalyzeImports(options = {}) {
             sha: e.sha,
             name: e.name,
             filePath: e.filePath || '',
+            isDefaultExport: e.metadata?.notExported === false &&
+                e.metadata?.namedExport === false,
         })));
         if (backfillResult.updated > 0 && !options.silent) {
             console.log(chalk.green(`Linked ${backfillResult.updated} scenario(s) to their entities.`));
@@ -2668,6 +2661,13 @@ async function handleRegister(jsonArg) {
             if (data.captureError)
                 parts.push(chalk.yellow(`captureError="${data.captureError}"`));
             console.log(prefix + parts.join(' '));
+            // Warn when application scenario is missing seed data
+            if (data.missingSeedWarning) {
+                console.log(chalk.red.bold('WARNING: No seed data in this application scenario!'));
+                console.log(chalk.yellow('  This scenario has type "application" but no "seed" data was provided.'));
+                console.log(chalk.yellow('  The page will render with an empty database — nothing will be visible.'));
+                console.log(chalk.yellow('  Re-register with "seed":{...} containing the database rows this page needs.'));
+            }
             // Surface client errors prominently so they can't be missed
             if (data.clientErrors && data.clientErrors.length > 0) {
                 console.log(chalk.red.bold(`⚠ WARNING: ${data.clientErrors.length} client error${data.clientErrors.length !== 1 ? 's' : ''} detected during capture:`));
@@ -2996,6 +2996,8 @@ function printAuditGateFailures(data) {
         issues.push(`${s.functionsMissing} function(s) missing test files`);
     if (s.functionsFailing > 0)
         issues.push(`${s.functionsFailing} function(s) with failing tests`);
+    if (s.functionsRunnerError > 0)
+        issues.push(`${s.functionsRunnerError} function(s) with test runner errors (the runner crashed — not a test failure)`);
     if (s.functionsNameMismatch > 0)
         issues.push(`${s.functionsNameMismatch} function(s) with test name mismatch`);
     if (s.missingFromGlossary > 0)
@@ -3004,6 +3006,8 @@ function printAuditGateFailures(data) {
         issues.push(`${s.incompleteEntities} entity/entities need import analysis`);
     if (s.miscategorizedScenarios > 0)
         issues.push(`${s.miscategorizedScenarios} component(s) using page URLs instead of isolation routes`);
+    if (s.scenariosNeedingRecapture > 0)
+        issues.push(`${s.scenariosNeedingRecapture} scenario(s) need recapture (dependency tree changed)`);
     if (issues.length > 0) {
         console.error(chalk.yellow('\nAudit failures:'));
         for (const issue of issues) {
@@ -3122,6 +3126,14 @@ async function handleAudit() {
                 case 'ok':
                     detail = chalk.dim(` (${f.testFile})`);
                     break;
+                case 'runner_error':
+                    detail = chalk.red(` — test runner crashed: ${f.testFile}`);
+                    if (f.errorMessage) {
+                        detail += `\n      ${chalk.red(f.errorMessage)}`;
+                        detail += `\n      ${chalk.yellow('Note: This is NOT a test failure — the test runner itself could not execute.')}`;
+                        detail += `\n      ${chalk.yellow('Try running the test manually: npx vitest run ' + f.testFile)}`;
+                    }
+                    break;
                 case 'failing':
                     detail = chalk.red(` — tests failing: ${f.testFile}`);
                     break;
@@ -3186,6 +3198,19 @@ async function handleAudit() {
         console.log(chalk.yellow('    or re-register with an isolation URL.'));
         console.log();
     }
+    // Scenarios needing recapture (entity or dependency tree changed)
+    const scenariosNeedingRecapture = data.scenariosNeedingRecapture || [];
+    if (scenariosNeedingRecapture.length > 0) {
+        console.log(chalk.bold('Scenarios needing recapture (dependency tree changed):'));
+        for (const s of scenariosNeedingRecapture) {
+            const reason = s.status.status === 'impacted' && s.status.impactedBy?.length
+                ? `impacted by: ${s.status.impactedBy.map((d) => `${d.name} [${d.changeType}]`).join(', ')}`
+                : `${s.status.status}`;
+            console.log(`  ${chalk.red('✗')} ${s.scenarioName} ${chalk.dim(`(${s.entityName} — ${reason})`)}`);
+        }
+        console.log(chalk.yellow('    Re-register these scenarios to capture updated screenshots.'));
+        console.log();
+    }
     // Summary
     const allOk = summary.allPassing;
     if (allOk) {
@@ -3206,6 +3231,9 @@ async function handleAudit() {
         if (summary.functionsFailing > 0) {
             parts.push(`${summary.functionsFailing} function${summary.functionsFailing !== 1 ? 's' : ''} with failing tests`);
         }
+        if (summary.functionsRunnerError > 0) {
+            parts.push(`${summary.functionsRunnerError} function${summary.functionsRunnerError !== 1 ? 's' : ''} with test runner errors (not test failures — see details above)`);
+        }
         if (summary.functionsNameMismatch > 0) {
             parts.push(`${summary.functionsNameMismatch} function${summary.functionsNameMismatch !== 1 ? 's' : ''} with test name mismatch (missing top-level describe)`);
         }
@@ -3218,6 +3246,9 @@ async function handleAudit() {
         if (summary.miscategorizedScenarios > 0) {
             parts.push(`${summary.miscategorizedScenarios} component${summary.miscategorizedScenarios !== 1 ? 's' : ''} using page URLs instead of isolation routes`);
         }
+        if (summary.scenariosNeedingRecapture > 0) {
+            parts.push(`${summary.scenariosNeedingRecapture} scenario${summary.scenariosNeedingRecapture !== 1 ? 's' : ''} need recapture`);
+        }
         console.log(chalk.red.bold('Audit failed: ') + parts.join(', '));
     }
     console.log();
@@ -3352,6 +3383,8 @@ async function handleScenarioCoverage() {
                     sha: e.sha,
                     name: e.name,
                     filePath: e.filePath || '',
+                    isDefaultExport: e.metadata?.notExported === false &&
+                        e.metadata?.namedExport === false,
                 })));
             }
         }
@@ -4408,6 +4441,8 @@ const editorCommand = {
                             sha: e.sha,
                             name: e.name,
                             filePath: e.filePath || '',
+                            isDefaultExport: e.metadata?.notExported === false &&
+                                e.metadata?.namedExport === false,
                         })));
                         if (result.updated > 0) {
                             console.log(chalk.green(`  Linked ${result.updated} scenario(s) to their entities`));