@codeyam/codeyam-cli 0.1.0-staging.ad88eeb → 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/editorPreview.js

@@ -94,6 +94,39 @@ export function shouldSyncScenarioToProxy(activeScenarioId, lastSyncedId) {
         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":"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"}
+{"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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"}

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

@@ -8,7 +8,7 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { runSeedAdapter, detectSeedAdapter } from "./editorSeedAdapter.js";
+import { runSeedAdapter, detectSeedAdapter, } from "./editorSeedAdapter.js";
 /**
  * Track in-flight seed operations to deduplicate concurrent requests
  * for the same scenario.
@@ -70,6 +70,7 @@ export async function switchActiveScenario(params) {
     }, null, 2));
     // Run seed adapter for application/user scenarios
     let seedResult = null;
+    let sessionCookies;
     const isSeedScenario = effectiveType === 'application' || effectiveType === 'user';
     if (isSeedScenario) {
         // Deduplicate concurrent seed requests for the same scenario
@@ -83,10 +84,16 @@ export async function switchActiveScenario(params) {
                 const seedPromise = runSeedAdapter(adapterPath, seedDataPath).then((result) => ({
                     success: result.success,
                     error: result.error,
+                    sessionCookies: result.sessionCookies,
                 }));
                 activeSeedOperation = { scenarioId, promise: seedPromise };
                 try {
-                    seedResult = await seedPromise;
+                    const fullResult = await seedPromise;
+                    seedResult = {
+                        success: fullResult.success,
+                        error: fullResult.error,
+                    };
+                    sessionCookies = fullResult.sessionCookies;
                 }
                 finally {
                     if (activeSeedOperation &&
@@ -94,6 +101,20 @@ export async function switchActiveScenario(params) {
                         activeSeedOperation = null;
                     }
                 }
+                // Persist session cookies to the scenario data file
+                if (seedResult?.success &&
+                    sessionCookies &&
+                    sessionCookies.length > 0) {
+                    try {
+                        const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
+                        const existing = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
+                        existing.sessionCookies = sessionCookies;
+                        fs.writeFileSync(dataFile, JSON.stringify(existing, null, 2));
+                    }
+                    catch {
+                        // Non-fatal — cookies just won't be persisted
+                    }
+                }
             }
             else if (!adapterPath) {
                 seedResult = { success: false, error: 'No seed adapter found' };
@@ -107,6 +128,7 @@ export async function switchActiveScenario(params) {
         type: effectiveType,
         seeded: isSeedScenario,
         ...(seedResult ? { seedResult } : {}),
+        ...(sessionCookies && sessionCookies.length > 0 ? { sessionCookies } : {}),
     };
 }
 //# sourceMappingURL=editorScenarioSwitch.js.map

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

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