@codeyam/codeyam-cli 0.1.0-staging.ae0de75 → 0.1.0-staging.b147f46

package/codeyam-cli/src/utils/editorMigration.js

@@ -0,0 +1,224 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/** Extract an array from an object with a known wrapper key (e.g. {"components": [...]}). */
+function extractArrayFromObject(obj) {
+    if (!obj || typeof obj !== 'object')
+        return [];
+    for (const val of Object.values(obj)) {
+        if (Array.isArray(val))
+            return val;
+    }
+    return [];
+}
+function getMigrationStatePath(root) {
+    return path.join(root, '.codeyam', 'migration-state.json');
+}
+export function readMigrationState(root) {
+    const statePath = getMigrationStatePath(root);
+    try {
+        const content = fs.readFileSync(statePath, 'utf8');
+        const raw = JSON.parse(content);
+        return sanitizeMigrationState(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * migration-state.json is written by the LLM — fields may be missing
+ * despite what the TypeScript types say. Fill in safe defaults.
+ */
+function sanitizeMigrationState(raw) {
+    const pages = Array.isArray(raw.pages) ? raw.pages : [];
+    const sharedComponents = Array.isArray(raw.sharedComponents)
+        ? raw.sharedComponents
+        : [];
+    return {
+        status: raw.status || 'surveyed',
+        startedAt: raw.startedAt || new Date().toISOString(),
+        completedAt: raw.completedAt ?? null,
+        currentPageIndex: typeof raw.currentPageIndex === 'number' ? raw.currentPageIndex : 0,
+        pages: pages.map((p) => ({
+            name: p.name || 'Unknown',
+            route: p.route || '/',
+            filePath: p.filePath || '',
+            status: p.status || 'pending',
+            startedAt: p.startedAt ?? null,
+            completedAt: p.completedAt ?? null,
+            extractedComponents: Array.isArray(p.extractedComponents)
+                ? p.extractedComponents
+                : [],
+            extractedFunctions: Array.isArray(p.extractedFunctions)
+                ? p.extractedFunctions
+                : [],
+            scenarioCount: typeof p.scenarioCount === 'number' ? p.scenarioCount : 0,
+        })),
+        sharedComponents: sharedComponents.map((sc) => ({
+            name: sc.name || '',
+            filePath: sc.filePath || '',
+            extractedFromPage: sc.extractedFromPage || '',
+            usedInPages: Array.isArray(sc.usedInPages) ? sc.usedInPages : [],
+        })),
+    };
+}
+export function writeMigrationState(root, state) {
+    const statePath = getMigrationStatePath(root);
+    const dir = path.dirname(statePath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf8');
+}
+/**
+ * Detect whether the project is a migration candidate.
+ *
+ * A project is a candidate when ALL of these are true:
+ * - package.json exists (has a project)
+ * - No editor scenarios exist
+ * - No glossary entries (glossary.json missing or empty array)
+ * - No active feature in progress (editor-step.json missing or no feature field)
+ * - No completed migration (migration-state.json missing or status !== 'complete')
+ *
+ * We intentionally do NOT check for page files here — the project structure
+ * is unknown until Claude surveys it. The UI shows a generic migration prompt
+ * and Claude handles discovery.
+ *
+ * The hasEditorScenarios option allows callers to pass the DB check result
+ * (since this module doesn't do database queries).
+ */
+export function detectMigrationCandidate(root, opts) {
+    // 1. Must have package.json
+    if (!fs.existsSync(path.join(root, 'package.json'))) {
+        return false;
+    }
+    // 2. No editor scenarios
+    if (opts?.hasEditorScenarios) {
+        return false;
+    }
+    // 3. No glossary entries (handles LLM-written object wrappers like {"components": [...]})
+    const glossaryPath = path.join(root, '.codeyam', 'glossary.json');
+    if (fs.existsSync(glossaryPath)) {
+        try {
+            const raw = JSON.parse(fs.readFileSync(glossaryPath, 'utf8'));
+            const entries = Array.isArray(raw) ? raw : extractArrayFromObject(raw);
+            if (entries.length > 0) {
+                return false;
+            }
+        }
+        catch {
+            // Parse failure → treat as no glossary
+        }
+    }
+    // 4. No active feature in progress
+    const stepPath = path.join(root, '.codeyam', 'editor-step.json');
+    if (fs.existsSync(stepPath)) {
+        try {
+            const state = JSON.parse(fs.readFileSync(stepPath, 'utf8'));
+            if (state.feature || state.scaffolded) {
+                return false;
+            }
+        }
+        catch {
+            // Parse failure → treat as no state
+        }
+    }
+    // 5. No completed migration
+    const migrationState = readMigrationState(root);
+    if (migrationState?.status === 'complete') {
+        return false;
+    }
+    return true;
+}
+/**
+ * Check if editor-step.json indicates an active migration.
+ * Used by the loader to detect migration even before migration-state.json exists
+ * (e.g. during the survey phase).
+ */
+export function isMigrationActiveInEditorState(root) {
+    const stepPath = path.join(root, '.codeyam', 'editor-step.json');
+    try {
+        const content = fs.readFileSync(stepPath, 'utf8');
+        const state = JSON.parse(content);
+        return !!state.migration;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Pure function that determines what CLI command to resume migration with.
+ * Used by printCycleOverview to give Claude the right next command.
+ */
+export function getMigrationResumeInfo(editorState, migrationState) {
+    // Complete
+    if (migrationState?.status === 'complete') {
+        return { mode: 'complete', resumeCommand: null };
+    }
+    // Survey phase: editor state at step 0 with migration field, or migration-state surveyed
+    if ((editorState?.migration && editorState.step === 0) ||
+        migrationState?.status === 'surveyed') {
+        return { mode: 'survey', resumeCommand: 'codeyam editor migrate' };
+    }
+    // In progress with editor state migration field (knows current step)
+    if (editorState?.migration) {
+        return {
+            mode: 'page-in-progress',
+            resumeCommand: `codeyam editor migrate ${editorState.step}`,
+            pageName: editorState.migration.pageName,
+            pageIndex: editorState.migration.pageIndex,
+            totalPages: editorState.migration.totalPages,
+            step: editorState.step,
+            stepLabel: editorState.label,
+        };
+    }
+    // migration-state.json in-progress but no editor state (fresh session)
+    if (migrationState?.status === 'in-progress') {
+        const currentPage = migrationState.pages[migrationState.currentPageIndex];
+        return {
+            mode: 'page-in-progress',
+            resumeCommand: 'codeyam editor migrate 1',
+            pageName: currentPage?.name ?? 'Unknown',
+            pageIndex: migrationState.currentPageIndex,
+            totalPages: migrationState.pages.length,
+        };
+    }
+    return { mode: 'none', resumeCommand: null };
+}
+/**
+ * Advance to the next pending page in the migration.
+ * Returns the page info or null if all pages are complete.
+ */
+export function advanceToNextPage(root) {
+    const state = readMigrationState(root);
+    if (!state)
+        return null;
+    const nextIndex = state.pages.findIndex((p) => p.status === 'pending');
+    if (nextIndex === -1) {
+        // All pages done — mark migration complete
+        state.status = 'complete';
+        state.completedAt = new Date().toISOString();
+        writeMigrationState(root, state);
+        return null;
+    }
+    state.currentPageIndex = nextIndex;
+    state.pages[nextIndex].status = 'in-progress';
+    state.pages[nextIndex].startedAt = new Date().toISOString();
+    writeMigrationState(root, state);
+    return { name: state.pages[nextIndex].name, index: nextIndex };
+}
+/**
+ * Mark the current page as complete with extraction stats.
+ */
+export function completePage(root, stats) {
+    const state = readMigrationState(root);
+    if (!state)
+        return;
+    const page = state.pages[state.currentPageIndex];
+    if (!page)
+        return;
+    page.status = 'complete';
+    page.completedAt = new Date().toISOString();
+    page.extractedComponents = stats.extractedComponents;
+    page.extractedFunctions = stats.extractedFunctions;
+    page.scenarioCount = stats.scenarioCount;
+    writeMigrationState(root, state);
+}
+//# sourceMappingURL=editorMigration.js.map

package/codeyam-cli/src/utils/editorMigration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorMigration.js","sourceRoot":"","sources":["../../../../src/utils/editorMigration.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/src/utils/editorMockState.js

@@ -1,7 +1,7 @@
 /**
  * Stateful mock state manager for the editor proxy.
  *
- * Replaces the static findMatchingRoute() with method-aware, stateful matching.
+ * Provides method-aware, stateful mock matching for the editor proxy.
  * Supports legacy key-based format, route-keyed format, method-prefixed routes,
  * parameterized routes, and mutable state for CRUD operations.
  */

package/codeyam-cli/src/utils/editorPreloadHelpers.js

@@ -1,5 +1,5 @@
 /**
- * Pure redirect functions for the Node.js preload module.
+ * Pure redirect and mock-matching functions for the Node.js preload module.
  *
  * Extracted so they can be unit-tested without loading the actual preload
  * (which patches global fetch and http).
@@ -61,4 +61,75 @@ export function redirectOptions(options, devServerUrl, proxyUrl) {
     }
     return options;
 }
+/**
+ * Match a request URL against scenario mock data routes.
+ *
+ * Supports:
+ * - Path-only routes:    "/api/drinks" matches fetch("http://localhost:3000/api/drinks")
+ * - Full URL routes:     "https://api.stripe.com/v1/charges" matches external API calls
+ * - Method-prefixed:     "POST /api/drinks" matches POST requests only
+ *
+ * Returns the mock response if matched, or null if no match.
+ */
+export function matchScenarioRoute(requestUrl, method, scenarioData) {
+    const routes = scenarioData.routes;
+    if (!routes || typeof routes !== 'object')
+        return null;
+    // Extract pathname from the request URL
+    let pathname;
+    try {
+        const parsed = new URL(requestUrl);
+        pathname = parsed.pathname;
+    }
+    catch {
+        // Relative URL — use as-is
+        pathname = requestUrl.split('?')[0];
+    }
+    const upperMethod = method.toUpperCase();
+    for (const [routeKey, routeValue] of Object.entries(routes)) {
+        if (!routeValue || typeof routeValue !== 'object')
+            continue;
+        const entry = routeValue;
+        // Check for method-prefixed route: "POST /api/drinks"
+        const spaceIdx = routeKey.indexOf(' ');
+        if (spaceIdx !== -1) {
+            const routeMethod = routeKey.slice(0, spaceIdx).toUpperCase();
+            const routePath = routeKey.slice(spaceIdx + 1);
+            if (routeMethod === upperMethod && routePath === pathname) {
+                return {
+                    body: entry.body ?? routeValue,
+                    status: typeof entry.status === 'number' ? entry.status : 200,
+                };
+            }
+            continue;
+        }
+        // Full URL route: "https://api.stripe.com/v1/charges"
+        if (routeKey.startsWith('http://') || routeKey.startsWith('https://')) {
+            try {
+                const routeParsed = new URL(routeKey);
+                const reqParsed = new URL(requestUrl);
+                if (routeParsed.hostname === reqParsed.hostname &&
+                    routeParsed.port === reqParsed.port &&
+                    routeParsed.pathname === reqParsed.pathname) {
+                    return {
+                        body: entry.body ?? routeValue,
+                        status: typeof entry.status === 'number' ? entry.status : 200,
+                    };
+                }
+            }
+            catch {
+                // Invalid URL in route key — skip
+            }
+            continue;
+        }
+        // Path-only route: "/api/drinks"
+        if (routeKey === pathname) {
+            return {
+                body: entry.body ?? routeValue,
+                status: typeof entry.status === 'number' ? entry.status : 200,
+            };
+        }
+    }
+    return null;
+}
 //# sourceMappingURL=editorPreloadHelpers.js.map

package/codeyam-cli/src/utils/editorPreloadHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"editorPreloadHelpers.js","sourceRoot":"","sources":["../../../../src/utils/editorPreloadHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,YAAoB,EACpB,QAAgB;IAEhB,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEhC,IAAI,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAYD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAuB,EACvB,YAAoB,EACpB,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE3C,2BAA2B;IAC3B,IACE,OAAO,CAAC,QAAQ;QAChB,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO;QAC9C,OAAO,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,EACjC,CAAC;QACD,OAAO;YACL,GAAG,OAAO;YACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;gBACtB,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,SAAS,EAAE,EAAE;gBAChE,CAAC,CAAC,OAAO,CAAC,OAAO;SACpB,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO;gBACL,GAAG,OAAO;gBACV,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,SAAS,EAAE;aACvC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"editorPreloadHelpers.js","sourceRoot":"","sources":["../../../../src/utils/editorPreloadHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,YAAoB,EACpB,QAAgB;IAEhB,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEhC,IAAI,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAYD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAuB,EACvB,YAAoB,EACpB,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE3C,2BAA2B;IAC3B,IACE,OAAO,CAAC,QAAQ;QAChB,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO;QAC9C,OAAO,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,EACjC,CAAC;QACD,OAAO;YACL,GAAG,OAAO;YACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;gBACtB,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,SAAS,EAAE,EAAE;gBAChE,CAAC,CAAC,OAAO,CAAC,OAAO;SACpB,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO;gBACL,GAAG,OAAO;gBACV,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,SAAS,EAAE;aACvC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,MAAc,EACd,YAAqC;IAErC,MAAM,MAAM,GAAG,YAAY,CAAC,MAA6C,CAAC;IAC1E,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEvD,wCAAwC;IACxC,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QACnC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;QAC3B,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;YAAE,SAAS;QAE5D,MAAM,KAAK,GAAG,UAAqC,CAAC;QAEpD,sDAAsD;QACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9D,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC/C,IAAI,WAAW,KAAK,WAAW,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC1D,OAAO;oBACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;oBAC9B,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;iBAC9D,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QAED,sDAAsD;QACtD,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACtC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;gBACtC,IACE,WAAW,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;oBAC3C,WAAW,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;oBACnC,WAAW,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAC3C,CAAC;oBACD,OAAO;wBACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;wBAC9B,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;qBAC9D,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;YACpC,CAAC;YACD,SAAS;QACX,CAAC;QAED,iCAAiC;QACjC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;gBAC9B,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/codeyam-cli/src/utils/editorPreview.js

@@ -25,7 +25,7 @@ export function buildPreviewUrl(params) {
     if (activeAnalyzedScenario && !analyzedPreviewUrl) {
         return null;
     }
-    // Component isolation scenarios store a path (e.g. /codeyam-isolate/DrinkCard?s=Default)
+    // Component isolation scenarios store a path (e.g. /isolated-components/DrinkCard?s=Default)
     if (activeScenarioId) {
         const scenario = scenarios.find((s) => s.id === activeScenarioId);
         if (scenario?.url) {
@@ -50,10 +50,83 @@ export function buildPreviewUrl(params) {
     }
     return baseUrl;
 }
+/**
+ * Apply a navigation path override to a preview URL.
+ *
+ * Correctly handles paths with query strings (e.g. `/isolated-components/DrinkCard?s=Default`)
+ * by parsing the path into pathname + search components instead of naively assigning
+ * to `URL.pathname` (which would URL-encode the `?`).
+ */
+export function applyNavigatePath(previewUrl, navigatePath) {
+    if (!previewUrl)
+        return previewUrl;
+    if (!navigatePath)
+        return previewUrl;
+    try {
+        const base = new URL(previewUrl);
+        // Parse navigatePath to separate pathname from query string
+        const qIndex = navigatePath.indexOf('?');
+        if (qIndex >= 0) {
+            base.pathname = navigatePath.slice(0, qIndex);
+            base.search = navigatePath.slice(qIndex);
+        }
+        else {
+            base.pathname = navigatePath;
+            base.search = '';
+        }
+        return base.href;
+    }
+    catch {
+        return previewUrl;
+    }
+}
 /**
  * Compute CSS scale factor to fit a viewport in a container.
  * Returns 1 if the target fits, otherwise the smallest scale that fits both dimensions.
  */
+/**
+ * Determines whether the proxy needs to be synced to the active scenario.
+ * Returns true only when activeScenarioId actually changes — NOT when
+ * allScenarios gets a new array reference from SSE revalidation.
+ */
+export function shouldSyncScenarioToProxy(activeScenarioId, lastSyncedId) {
+    if (!activeScenarioId)
+        return false;
+    return activeScenarioId !== lastSyncedId;
+}
+/**
+ * Resolve which scenario to display when no scenario is explicitly selected.
+ * Prefers the home page scenario (url "/") since the App tab sorts "Home"
+ * first, then falls back to the first application-type scenario, then any.
+ */
+export function getDefaultScenario(scenarios) {
+    if (scenarios.length === 0)
+        return undefined;
+    return (scenarios.find((s) => s.url === '/') ||
+        scenarios.find((s) => s.type === 'application') ||
+        scenarios[0]);
+}
+/**
+ * Resolve the viewport size for a scenario. If the scenario has custom
+ * dimensions, returns a ScreenSize (matching a preset name if possible,
+ * otherwise "Custom"). Returns null when the scenario has no custom viewport
+ * and no defaultSize fallback is provided.
+ *
+ * @param defaultSize - Optional fallback size when scenario has no viewport.
+ *   Pass the project default so null-viewport scenarios still resolve.
+ */
+export function resolveScenarioViewport(scenario, presets, defaultSize) {
+    if (!scenario.viewportWidth || !scenario.viewportHeight) {
+        return defaultSize ?? null;
+    }
+    const match = presets.find((p) => p.width === scenario.viewportWidth &&
+        p.height === scenario.viewportHeight);
+    return {
+        name: match?.name || 'Custom',
+        width: scenario.viewportWidth,
+        height: scenario.viewportHeight,
+    };
+}
 export function calculatePreviewScale(containerSize, targetSize) {
     const targetW = targetSize.width;
     const targetH = targetSize.height ?? 900;

package/codeyam-cli/src/utils/editorPreview.js.map

@@ -1 +1 @@
-{"version":3,"file":"editorPreview.js","sourceRoot":"","sources":["../../../../src/utils/editorPreview.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAkBzD;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,MAAM,EACJ,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,GAAG,MAAM,CAAC;IAEX,oEAAoE;IACpE,IAAI,sBAAsB,IAAI,kBAAkB,EAAE,CAAC;QACjD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,iFAAiF;IACjF,kDAAkD;IAClD,IAAI,sBAAsB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yFAAyF;IACzF,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,gBAAgB,CAAC,CAAC;QAClE,IAAI,QAAQ,EAAE,GAAG,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,QAAQ,IAAI,YAAY,CAAC;YACtC,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;YAClC,CAAC;YACD,OAAO,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,aAAa,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,gBAAgB,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,QAAQ;YAC3B,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrC,CAAC,CAAC,SAAS,CAAC;QACd,OAAO,GAAG,OAAO,gBAAgB,aAAa,IAAI,YAAY,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAgD,EAChD,UAAoD;IAEpD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;IACjC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,IAAI,GAAG,CAAC;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IACpC,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"editorPreview.js","sourceRoot":"","sources":["../../../../src/utils/editorPreview.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/src/utils/editorRecapture.js

@@ -0,0 +1,109 @@
+/**
+ * Shared capture loop for recapturing scenarios.
+ *
+ * Extracted from api.editor-register-scenario.ts so both the inline
+ * recapture (after registration) and the batch `recapture-stale` endpoint
+ * can share the same logic.
+ */
+import * as path from 'path';
+import { switchActiveScenario } from "./editorScenarioSwitch.js";
+import { generateScenarioSlug, determineCaptureUrl, resolveViewportWithProjectDefault, } from "./editorScenarios.js";
+import { invalidateScenarioCache } from "../webserver/editorProxy.js";
+import { resolveWebserverDir, resolveCaptureScript, runCaptureScript, } from "./editorCapture.js";
+/**
+ * Recapture a list of scenarios by switching to each one and running
+ * the Playwright capture script.
+ *
+ * @param scenarios  - Scenario rows to recapture (need id, name, url, dimensions, viewport)
+ * @param codeyamRoot - Project root containing .codeyam/
+ * @param proxyUrl   - Proxy server URL (for intercepting API calls)
+ * @param devUrl     - Dev server URL (direct, for route checking)
+ * @param db         - Database instance for updating screenshot_path
+ * @param importMetaUrl - import.meta.url from the calling route (for resolving webserver dir)
+ * @param onProgress - Optional callback for streaming progress
+ */
+export async function recaptureScenarios(params) {
+    const { scenarios, codeyamRoot, proxyUrl, devUrl, db, importMetaUrl, onProgress, } = params;
+    const result = { recaptured: [], failed: [] };
+    if (scenarios.length === 0)
+        return result;
+    const webserverDir = resolveWebserverDir(importMetaUrl);
+    const scriptPath = await resolveCaptureScript(webserverDir, codeyamRoot);
+    const screenshotsDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios', 'screenshots');
+    for (const row of scenarios) {
+        try {
+            const scenarioSlug = generateScenarioSlug(row.name);
+            await switchActiveScenario({
+                scenarioId: row.id,
+                scenarioSlug,
+                projectRoot: codeyamRoot,
+            });
+            invalidateScenarioCache();
+            await new Promise((resolve) => setTimeout(resolve, 300));
+            const captureUrl = determineCaptureUrl(row.url || null, proxyUrl, devUrl);
+            if (!captureUrl) {
+                result.failed.push({
+                    name: row.name,
+                    error: 'No capture URL available',
+                });
+                continue;
+            }
+            const outputPath = path.join(screenshotsDir, `${row.id}.png`);
+            // Resolve viewport from dimension or explicit values
+            let recaptureDimension;
+            try {
+                const dims = row.dimensions ? JSON.parse(row.dimensions) : null;
+                if (Array.isArray(dims) && dims.length > 0)
+                    recaptureDimension = dims[0];
+            }
+            catch {
+                /* ignore */
+            }
+            const viewport = resolveViewportWithProjectDefault({
+                bodyWidth: row.viewport_width || undefined,
+                bodyHeight: row.viewport_height || undefined,
+                dimension: recaptureDimension,
+                codeyamRoot,
+            });
+            const captureArgs = JSON.stringify({
+                url: captureUrl,
+                outputPath,
+                viewportWidth: viewport.width,
+                viewportHeight: viewport.height,
+                ...(row.component_name ? { selector: '#codeyam-capture' } : {}),
+            });
+            onProgress?.(`Capturing "${row.name}"...`);
+            console.log(`[recapture] Capturing "${row.name}" at ${viewport.width}x${viewport.height}`);
+            const captureResult = await runCaptureScript(scriptPath, captureArgs, codeyamRoot);
+            if (captureResult.success) {
+                await db
+                    .updateTable('editor_scenarios')
+                    .set({
+                    screenshot_path: `screenshots/${row.id}.png`,
+                    updated_at: new Date()
+                        .toISOString()
+                        .replace('T', ' ')
+                        .replace(/\.\d{3}Z$/, ''),
+                })
+                    .where('id', '=', row.id)
+                    .execute();
+                result.recaptured.push(row.name);
+                onProgress?.(`Recaptured "${row.name}"`);
+                console.log(`[recapture] Succeeded: "${row.name}"`);
+            }
+            else {
+                const error = captureResult.error || 'Unknown capture error';
+                result.failed.push({ name: row.name, error });
+                onProgress?.(`Failed: "${row.name}" — ${error}`);
+                console.warn(`[recapture] Failed: "${row.name}": ${error}`);
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            result.failed.push({ name: row.name, error });
+            console.warn(`[recapture] Error for "${row.name}": ${error}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=editorRecapture.js.map

package/codeyam-cli/src/utils/editorRecapture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorRecapture.js","sourceRoot":"","sources":["../../../../src/utils/editorRecapture.ts"],"names":[],"mappings":"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"}