@codeyam/codeyam-cli 0.1.0-staging.b8a55ba → 0.1.0-staging.b8b17a5

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

@@ -0,0 +1,248 @@
+/**
+ * Stateful mock state manager for the editor proxy.
+ *
+ * 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.
+ */
+import crypto from 'crypto';
+function hashData(data) {
+    return crypto.createHash('sha256').update(JSON.stringify(data)).digest('hex');
+}
+/**
+ * Parse a route key like "POST /api/drinks/:id" into method, path pattern, and regex.
+ */
+function parseRouteKey(key) {
+    const methodMatch = key.match(/^(GET|POST|PUT|DELETE|PATCH)\s+(\/\S+)$/);
+    if (methodMatch) {
+        return { method: methodMatch[1], pathPattern: methodMatch[2] };
+    }
+    // Path-only — treat as GET
+    return { method: null, pathPattern: key };
+}
+/**
+ * Build a regex and extract param names from a path pattern like /api/drinks/:id.
+ */
+function buildPathRegex(pattern) {
+    const paramNames = [];
+    const regexStr = pattern.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (_, name) => {
+        paramNames.push(name);
+        return '([^/]+)';
+    });
+    return { regex: new RegExp(`^${regexStr}$`), paramNames };
+}
+/**
+ * Find the state path that corresponds to a given pathname.
+ * For "/api/drinks/1", checks if "/api/drinks" is a state key.
+ */
+function findStateBasePath(pathname, stateKeys) {
+    // Exact match first
+    if (stateKeys.includes(pathname))
+        return pathname;
+    // Try parent path (e.g., /api/drinks/1 → /api/drinks)
+    const lastSlash = pathname.lastIndexOf('/');
+    if (lastSlash > 0) {
+        const parent = pathname.substring(0, lastSlash);
+        if (stateKeys.includes(parent))
+            return parent;
+    }
+    return null;
+}
+export function createMockStateManager() {
+    let routes = [];
+    let mutableState = {};
+    let initialStateSnapshot = null;
+    let scenarioHash = null;
+    let hasState = false;
+    let scenarioData = null;
+    function parseRoutes(data) {
+        const parsed = [];
+        const routesObj = data.routes;
+        if (routesObj && typeof routesObj === 'object') {
+            for (const [key, value] of Object.entries(routesObj)) {
+                const { method, pathPattern } = parseRouteKey(key);
+                const { regex, paramNames } = buildPathRegex(pathPattern);
+                const entry = typeof value === 'object' && value !== null
+                    ? value
+                    : { body: value };
+                parsed.push({
+                    method,
+                    pathPattern,
+                    pathRegex: regex,
+                    paramNames,
+                    response: {
+                        body: entry.body,
+                        status: typeof entry.status === 'number' ? entry.status : 200,
+                    },
+                });
+            }
+        }
+        return parsed;
+    }
+    function initializeState(data) {
+        const stateObj = data.state;
+        if (stateObj && typeof stateObj === 'object') {
+            hasState = true;
+            mutableState = {};
+            for (const [key, value] of Object.entries(stateObj)) {
+                mutableState[key] = Array.isArray(value)
+                    ? JSON.parse(JSON.stringify(value))
+                    : [];
+            }
+            initialStateSnapshot = JSON.stringify(stateObj);
+        }
+        else {
+            hasState = false;
+            mutableState = {};
+            initialStateSnapshot = null;
+        }
+    }
+    return {
+        loadScenario(data) {
+            const newHash = hashData(data);
+            // Smart reload: if same data, preserve mutations
+            if (scenarioHash && newHash === scenarioHash) {
+                return;
+            }
+            scenarioHash = newHash;
+            scenarioData = data;
+            routes = parseRoutes(data);
+            initializeState(data);
+        },
+        matchRequest(method, pathname, body) {
+            if (!scenarioData && routes.length === 0 && !hasState) {
+                return null;
+            }
+            const stateKeys = Object.keys(mutableState);
+            // --- Stateful matching ---
+            if (hasState) {
+                const stateBasePath = findStateBasePath(pathname, stateKeys);
+                if (stateBasePath && method === 'GET' && stateBasePath === pathname) {
+                    // Return mutable state array
+                    return { body: mutableState[stateBasePath], status: 200 };
+                }
+                // For mutations, find a matching route first, then apply state changes
+                if (stateBasePath) {
+                    const matchedRoute = matchRoute(method, pathname);
+                    if (method === 'POST' && stateBasePath === pathname && matchedRoute) {
+                        const arr = mutableState[stateBasePath];
+                        const newItem = typeof body === 'object' && body !== null
+                            ? { ...body }
+                            : {};
+                        if (!('id' in newItem)) {
+                            const maxId = arr.reduce((max, item) => {
+                                const id = typeof item.id === 'number' ? item.id : 0;
+                                return Math.max(max, id);
+                            }, 0);
+                            newItem.id = maxId + 1;
+                        }
+                        arr.push(newItem);
+                        return {
+                            body: newItem,
+                            status: matchedRoute.response.status,
+                        };
+                    }
+                    if (method === 'DELETE' && matchedRoute && matchedRoute.params) {
+                        const idParam = matchedRoute.params.id;
+                        const arr = mutableState[stateBasePath];
+                        const idx = arr.findIndex((item) => String(item.id) === String(idParam));
+                        if (idx === -1) {
+                            return { body: { error: 'Not found' }, status: 404 };
+                        }
+                        arr.splice(idx, 1);
+                        return { body: null, status: matchedRoute.response.status };
+                    }
+                    if (method === 'PUT' && matchedRoute && matchedRoute.params) {
+                        const idParam = matchedRoute.params.id;
+                        const arr = mutableState[stateBasePath];
+                        const idx = arr.findIndex((item) => String(item.id) === String(idParam));
+                        if (idx === -1) {
+                            return { body: { error: 'Not found' }, status: 404 };
+                        }
+                        const replacement = typeof body === 'object' && body !== null
+                            ? { ...body }
+                            : arr[idx];
+                        arr[idx] = replacement;
+                        return { body: replacement, status: matchedRoute.response.status };
+                    }
+                }
+            }
+            // --- Non-stateful route matching ---
+            const matched = matchRoute(method, pathname);
+            if (matched) {
+                return {
+                    body: matched.response.body ?? null,
+                    status: matched.response.status,
+                    params: matched.params,
+                };
+            }
+            // --- Legacy format ---
+            if (scenarioData && method === 'GET') {
+                const apiMatch = pathname.match(/^\/api\/(.+)$/);
+                if (apiMatch) {
+                    const key = apiMatch[1];
+                    if (key in scenarioData && key !== 'routes' && key !== 'state') {
+                        return { body: scenarioData[key], status: 200 };
+                    }
+                }
+            }
+            return null;
+        },
+        resetState() {
+            if (initialStateSnapshot) {
+                const restored = JSON.parse(initialStateSnapshot);
+                mutableState = {};
+                for (const [key, value] of Object.entries(restored)) {
+                    mutableState[key] = Array.isArray(value)
+                        ? JSON.parse(JSON.stringify(value))
+                        : [];
+                }
+            }
+        },
+        getState() {
+            return { ...mutableState };
+        },
+    };
+    function matchRoute(method, pathname) {
+        // Priority 1: Exact method-prefixed match
+        for (const route of routes) {
+            if (route.method !== null &&
+                route.method === method &&
+                route.paramNames.length === 0) {
+                const match = route.pathRegex.exec(pathname);
+                if (match) {
+                    return { response: route.response };
+                }
+            }
+        }
+        // Priority 2: Method-less (GET only)
+        if (method === 'GET') {
+            for (const route of routes) {
+                if (route.method === null && route.paramNames.length === 0) {
+                    const match = route.pathRegex.exec(pathname);
+                    if (match) {
+                        return { response: route.response };
+                    }
+                }
+            }
+        }
+        // Priority 3: Parameterized routes
+        for (const route of routes) {
+            if (route.paramNames.length > 0) {
+                const expectedMethod = route.method ?? 'GET';
+                if (expectedMethod !== method)
+                    continue;
+                const match = route.pathRegex.exec(pathname);
+                if (match) {
+                    const params = {};
+                    for (let i = 0; i < route.paramNames.length; i++) {
+                        params[route.paramNames[i]] = match[i + 1];
+                    }
+                    return { response: route.response, params };
+                }
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=editorMockState.js.map

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

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

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

@@ -0,0 +1,135 @@
+/**
+ * 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).
+ */
+/**
+ * If `url` points to the dev server, return a redirected URL going through the proxy.
+ * Otherwise return the original URL unchanged.
+ */
+export function redirectUrl(url, devServerUrl, proxyUrl) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        // Relative URL or invalid — pass through
+        return url;
+    }
+    const dev = new URL(devServerUrl);
+    const proxy = new URL(proxyUrl);
+    if (parsed.hostname === dev.hostname && parsed.port === dev.port) {
+        parsed.hostname = proxy.hostname;
+        parsed.port = proxy.port;
+        parsed.protocol = proxy.protocol;
+        return parsed.toString();
+    }
+    return url;
+}
+/**
+ * If http.request options target the dev server, patch them to go through the proxy.
+ * Returns the original options object if no redirect is needed.
+ */
+export function redirectOptions(options, devServerUrl, proxyUrl) {
+    const dev = new URL(devServerUrl);
+    const proxy = new URL(proxyUrl);
+    const devPort = parseInt(dev.port, 10);
+    const proxyPort = parseInt(proxy.port, 10);
+    // Match on hostname + port
+    if (options.hostname &&
+        parseInt(String(options.port), 10) === devPort &&
+        options.hostname === dev.hostname) {
+        return {
+            ...options,
+            hostname: proxy.hostname,
+            port: proxyPort,
+            headers: options.headers
+                ? { ...options.headers, host: `${proxy.hostname}:${proxyPort}` }
+                : options.headers,
+        };
+    }
+    // Match on host field (hostname:port combined)
+    if (options.host) {
+        const expectedHost = `${dev.hostname}:${devPort}`;
+        if (options.host === expectedHost) {
+            return {
+                ...options,
+                host: `${proxy.hostname}:${proxyPort}`,
+            };
+        }
+    }
+    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

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