@codeyam/codeyam-cli 0.1.0-staging.dd216e0 → 0.1.0-staging.e057775

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

@@ -0,0 +1,332 @@
+/**
+ * Shared scenario utilities used across editor routes and components.
+ *
+ * Extracted from inline logic in editor.tsx, api.editor-journal-entry.ts,
+ * and api.editor-register-scenario.ts.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Generic Map-based deduplication that keeps the last item for each key.
+ * Items are iterated in order, so later entries overwrite earlier ones.
+ * Map preserves insertion order of first appearance.
+ */
+export function deduplicateByName(items, keyFn) {
+    const byKey = new Map();
+    for (const item of items) {
+        byKey.set(keyFn(item), item);
+    }
+    return [...byKey.values()];
+}
+/**
+ * Convert a scenario name to a URL-safe slug.
+ * Replaces any run of non-alphanumeric, non-underscore characters with a single underscore.
+ */
+export function generateScenarioSlug(name) {
+    return name.replace(/[^a-zA-Z0-9_]+/g, '_');
+}
+/**
+ * Convert an ISO 8601 timestamp (e.g. "2026-02-28T19:00:00.000Z") to
+ * SQLite-compatible format (e.g. "2026-02-28 19:00:00").
+ *
+ * SQLite's CURRENT_TIMESTAMP uses space-separated "YYYY-MM-DD HH:MM:SS" format,
+ * so we need this conversion for date comparisons.
+ */
+export function convertIsoToSqliteTimestamp(iso) {
+    return iso.replace('T', ' ').replace(/\.\d{3}Z$/, '');
+}
+/**
+ * Properties in config.json that are user-configured and must survive a re-init.
+ * Auto-detected properties (projectSlug, packageManager, webapps, createdAt, etc.)
+ * are intentionally NOT preserved — init should re-detect them.
+ */
+const PRESERVED_CONFIG_KEYS = [
+    'defaultScreenSize',
+    'screenSizes',
+    'projectTitle',
+    'projectDescription',
+];
+/**
+ * Read user-configured properties from an existing config.json that should be
+ * preserved when `codeyam init --force` overwrites the file.
+ *
+ * Returns only the properties listed in PRESERVED_CONFIG_KEYS.
+ * Returns an empty object if the file doesn't exist or can't be parsed.
+ */
+export function readPreservedConfigProperties(configPath) {
+    try {
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        const preserved = {};
+        for (const key of PRESERVED_CONFIG_KEYS) {
+            if (config[key] !== undefined) {
+                preserved[key] = config[key];
+            }
+        }
+        return preserved;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Validate that a step transition is allowed.
+ *
+ * Rules:
+ * - Step 1 is always allowed (starts a new feature).
+ * - Steps 2–13 require the current state step to be at least (requestedStep - 1),
+ *   i.e. you can advance one step at a time or re-run the current step, but
+ *   you cannot skip ahead.
+ *
+ * Returns null if valid, or an error message string if invalid.
+ */
+export function validateStepTransition(requestedStep, currentStep) {
+    // Step 1 always allowed — it starts or restarts a feature
+    if (requestedStep === 1)
+        return null;
+    // No state at all — must start from step 1
+    if (currentStep === null) {
+        return `Cannot jump to step ${requestedStep} — no feature in progress. Run step 1 first.`;
+    }
+    // Allow re-running the current step or advancing to the next step
+    if (requestedStep <= currentStep + 1)
+        return null;
+    return `Cannot jump from step ${currentStep} to step ${requestedStep}. Complete step ${currentStep + 1} first.`;
+}
+/**
+ * Resolve which URL to use for Playwright screenshot capture.
+ *
+ * Priority:
+ * 1. Path-based URL + proxy → combine (component isolation with API interception)
+ * 2. Full URL → use directly (legacy)
+ * 3. No URL → proxy root or dev server root (page scenarios)
+ */
+/**
+ * Resolve the navigation path for preview refresh.
+ * Priority: explicit path > scenario URL from DB > undefined (plain refresh).
+ */
+export function resolvePreviewNavPath(explicitPath, scenarioUrl) {
+    if (explicitPath)
+        return explicitPath;
+    if (scenarioUrl)
+        return scenarioUrl;
+    return undefined;
+}
+/**
+ * Clear the editor step state file (for starting a new feature).
+ * This should NOT touch the user prompt file — the prompt is captured
+ * by the hook before step 1 runs, so deleting it here would lose it.
+ */
+export function clearEditorState(root) {
+    const statePath = path.join(root, '.codeyam', 'editor-step.json');
+    try {
+        fs.unlinkSync(statePath);
+    }
+    catch {
+        // File doesn't exist, that's fine
+    }
+}
+/**
+ * Clear the user prompt file so the hook can capture the next feature request.
+ * Call this after a feature is committed, not during step 1.
+ */
+export function clearEditorUserPrompt(root) {
+    const promptPath = path.join(root, '.codeyam', 'editor-user-prompt.txt');
+    try {
+        fs.unlinkSync(promptPath);
+    }
+    catch {
+        // File doesn't exist, that's fine
+    }
+}
+export function determineCaptureUrl(url, proxyUrl, devServerUrl) {
+    const isPath = url && url.startsWith('/');
+    if (isPath && proxyUrl) {
+        return `${proxyUrl}${url}`;
+    }
+    else if (url && !isPath) {
+        return url;
+    }
+    else {
+        return proxyUrl || devServerUrl || null;
+    }
+}
+/**
+ * Read the project's default screen size from .codeyam/config.json.
+ * Returns { width, height } or null if not configured.
+ */
+export function readDefaultScreenSize(codeyamRoot) {
+    try {
+        const configPath = path.join(codeyamRoot, '.codeyam', 'config.json');
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        if (config.defaultScreenSize?.width && config.defaultScreenSize?.height) {
+            return {
+                width: config.defaultScreenSize.width,
+                height: config.defaultScreenSize.height,
+            };
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    return null;
+}
+/**
+ * Read named screen sizes from .codeyam/config.json.
+ * Returns a map of name → { width, height }, or empty object if not configured.
+ *
+ * Config format:
+ *   "screenSizes": {
+ *     "Desktop": { "width": 1440, "height": 900 },
+ *     "Mobile": { "width": 375, "height": 667 }
+ *   }
+ */
+export function readScreenSizes(codeyamRoot) {
+    try {
+        const configPath = path.join(codeyamRoot, '.codeyam', 'config.json');
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        if (config.screenSizes &&
+            typeof config.screenSizes === 'object' &&
+            !Array.isArray(config.screenSizes)) {
+            return config.screenSizes;
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    return {};
+}
+/**
+ * Resolve the viewport dimensions for a scenario capture.
+ * Priority: explicit body values > project default > hardcoded fallback (1280×720).
+ */
+export function resolveScenarioViewport(params) {
+    return {
+        width: params.bodyWidth || params.projectDefault?.width || 1280,
+        height: params.bodyHeight || params.projectDefault?.height || 720,
+    };
+}
+/**
+ * Resolve viewport dimensions by reading the project config.
+ *
+ * Priority chain:
+ * 1. Explicit bodyWidth/bodyHeight (highest)
+ * 2. Named dimension → lookup in config screenSizes map
+ * 3. Project defaultScreenSize from config
+ * 4. 1280×720 hardcoded fallback (lowest)
+ *
+ * Use this in any capture endpoint that needs viewport resolution.
+ */
+export function resolveViewportWithProjectDefault(params) {
+    // Look up named dimension from screenSizes if provided
+    let dimensionSize = null;
+    if (params.dimension) {
+        const screenSizes = readScreenSizes(params.codeyamRoot);
+        const entry = screenSizes[params.dimension];
+        if (entry?.width && entry?.height) {
+            dimensionSize = { width: entry.width, height: entry.height };
+        }
+    }
+    const projectDefault = dimensionSize || readDefaultScreenSize(params.codeyamRoot);
+    return resolveScenarioViewport({
+        bodyWidth: params.bodyWidth,
+        bodyHeight: params.bodyHeight,
+        projectDefault,
+    });
+}
+/**
+ * Insert or update an editor scenario by name + project.
+ *
+ * When a scenario with the same name already exists for the project:
+ * - Reuses the most recent row's ID (so data files at that path get overwritten naturally)
+ * - Updates the row with the new values
+ * - Deletes any additional duplicate rows that accumulated from past always-insert behavior
+ *
+ * When no existing scenario matches: inserts a new row with a fresh UUID.
+ */
+export async function upsertEditorScenario(db, params) {
+    // Find all existing scenarios with the same name + project
+    const existing = await db
+        .selectFrom('editor_scenarios')
+        .selectAll()
+        .where('name', '=', params.name)
+        .where('project_id', '=', params.projectId)
+        .orderBy('created_at', 'desc')
+        .execute();
+    if (existing.length > 0) {
+        // Reuse the most recent row's ID
+        const latest = existing[0];
+        const scenarioId = latest.id;
+        // Update the existing row with new values
+        await db
+            .updateTable('editor_scenarios')
+            .set({
+            description: params.description,
+            component_name: params.componentName,
+            component_path: params.componentPath,
+            url: params.url,
+            type: params.type,
+            viewport_width: params.viewportWidth,
+            viewport_height: params.viewportHeight,
+            dimension: params.dimension,
+            updated_at: new Date()
+                .toISOString()
+                .replace('T', ' ')
+                .replace(/\.\d{3}Z$/, ''),
+        })
+            .where('id', '=', scenarioId)
+            .execute();
+        // Delete duplicate rows (all except the latest)
+        const duplicateIds = existing.slice(1).map((r) => r.id);
+        if (duplicateIds.length > 0) {
+            await db
+                .deleteFrom('editor_scenarios')
+                .where('id', 'in', duplicateIds)
+                .execute();
+        }
+        return { scenarioId, isNew: false, cleanedUpIds: duplicateIds };
+    }
+    // No existing scenario — insert new
+    // Use globalThis.crypto (Web Crypto API) to avoid pulling Node's crypto
+    // module into the Vite client bundle (this file is also imported client-side
+    // for deduplicateByName).
+    const scenarioId = globalThis.crypto.randomUUID();
+    await db
+        .insertInto('editor_scenarios')
+        .values({
+        id: scenarioId,
+        project_id: params.projectId,
+        name: params.name,
+        description: params.description,
+        component_name: params.componentName,
+        component_path: params.componentPath,
+        url: params.url,
+        type: params.type,
+        viewport_width: params.viewportWidth,
+        viewport_height: params.viewportHeight,
+        dimension: params.dimension,
+    })
+        .execute();
+    return { scenarioId, isNew: true, cleanedUpIds: [] };
+}
+/**
+ * Delete data files (.json, .seed.json) and screenshots for a list of scenario IDs.
+ * Used to clean up orphaned files after deduplication.
+ */
+export function cleanupScenarioFiles(codeyamRoot, scenarioIds) {
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    for (const id of scenarioIds) {
+        for (const file of [
+            `${id}.json`,
+            `${id}.seed.json`,
+            path.join('screenshots', `${id}.png`),
+        ]) {
+            try {
+                fs.unlinkSync(path.join(scenariosDir, file));
+            }
+            catch {
+                // File doesn't exist, that's fine
+            }
+        }
+    }
+}
+//# sourceMappingURL=editorScenarios.js.map

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

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

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

@@ -0,0 +1,173 @@
+/**
+ * Seed adapter runner for application/user scenarios.
+ *
+ * Runs the project's seed-adapter script to wipe and re-seed
+ * the dev database with scenario-specific data.
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+const DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * Run a seed adapter script, passing the seed data JSON file path as the first CLI arg.
+ *
+ * For .ts files, runs via `npx tsx`. For other files, runs directly.
+ * The cwd defaults to the project root (parent of `.codeyam/`) so the adapter
+ * can access node_modules, prisma/, etc.
+ */
+export function runSeedAdapter(scriptPath, seedDataPath, options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    // Default cwd: go up from .codeyam/ to project root
+    const cwd = options?.cwd ??
+        (path.basename(path.dirname(scriptPath)) === '.codeyam'
+            ? path.dirname(path.dirname(scriptPath))
+            : path.dirname(scriptPath));
+    return new Promise((resolve) => {
+        const start = Date.now();
+        const isTsFile = scriptPath.endsWith('.ts');
+        const command = isTsFile ? 'npx' : scriptPath;
+        const args = isTsFile ? ['tsx', scriptPath, seedDataPath] : [seedDataPath];
+        const child = spawn(command, args, {
+            cwd,
+            env: { ...process.env },
+        });
+        let stdout = '';
+        let stderr = '';
+        let killed = false;
+        const timer = setTimeout(() => {
+            killed = true;
+            child.kill('SIGTERM');
+        }, timeoutMs);
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            const durationMs = Date.now() - start;
+            if (killed) {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: `Seed adapter timeout after ${timeoutMs}ms`,
+                    durationMs,
+                });
+            }
+            else if (code === 0) {
+                resolve({ success: true, output: stdout, durationMs });
+            }
+            else {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: stderr || `Seed adapter exited with code ${code}`,
+                    durationMs,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({
+                success: false,
+                output: '',
+                error: err.message,
+                durationMs: Date.now() - start,
+            });
+        });
+    });
+}
+/**
+ * Extract just the seed data from a scenario JSON file and write it to a
+ * temporary file. The adapter receives clean seed data ({drinks: [...]})
+ * without the CodeYam envelope ({type, seed, externalApis}).
+ *
+ * Returns the path to the temp file (caller should clean up after use).
+ */
+export function prepareSeedDataFile(scenarioFilePath) {
+    try {
+        const raw = fs.readFileSync(scenarioFilePath, 'utf-8');
+        const data = JSON.parse(raw);
+        // Extract seed data from envelope, or use as-is if no envelope
+        const seedData = data.seed || data;
+        const tempPath = scenarioFilePath.replace(/\.json$/, '.seed.json');
+        fs.writeFileSync(tempPath, JSON.stringify(seedData, null, 2));
+        return tempPath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Clean up a temporary seed data file created by prepareSeedDataFile.
+ */
+export function cleanupSeedDataFile(tempPath) {
+    try {
+        if (fs.existsSync(tempPath)) {
+            fs.unlinkSync(tempPath);
+        }
+    }
+    catch {
+        // Best effort
+    }
+}
+/**
+ * Detect a seed adapter script in the project's .codeyam directory.
+ * Returns the absolute path if found, null otherwise.
+ */
+export function detectSeedAdapter(projectRoot) {
+    const candidates = ['seed-adapter.ts', 'seed-adapter.js'];
+    for (const filename of candidates) {
+        const fullPath = path.join(projectRoot, '.codeyam', filename);
+        try {
+            fs.accessSync(fullPath);
+            return fullPath;
+        }
+        catch {
+            // Try next
+        }
+    }
+    return null;
+}
+/**
+ * Validate that seed data has the expected structure:
+ * a non-empty object where every value is an array of objects (table rows).
+ */
+export function validateSeedData(data) {
+    const errors = [];
+    const keys = Object.keys(data);
+    if (keys.length === 0) {
+        errors.push('Seed data must contain at least one table');
+        return { valid: false, errors };
+    }
+    for (const key of keys) {
+        const value = data[key];
+        if (!Array.isArray(value)) {
+            errors.push(`"${key}" must be an array of objects, got ${typeof value}`);
+            continue;
+        }
+        for (let i = 0; i < value.length; i++) {
+            if (typeof value[i] !== 'object' || value[i] === null) {
+                errors.push(`"${key}[${i}]" must be an object, got ${typeof value[i]}`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Merge base scenario seed data with an overlay (user scenario).
+ * Overlay tables replace base tables entirely (no row-level merge).
+ * Does not mutate inputs.
+ */
+export function mergeSeedData(base, overlay) {
+    const result = {};
+    for (const [key, value] of Object.entries(base)) {
+        result[key] = JSON.parse(JSON.stringify(value));
+    }
+    for (const [key, value] of Object.entries(overlay)) {
+        result[key] = JSON.parse(JSON.stringify(value));
+    }
+    return result;
+}
+//# sourceMappingURL=editorSeedAdapter.js.map

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

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