@codeyam/codeyam-cli 0.1.0-bleeding-edge.8afd3ee

package/analyzer-template/scripts/mergePackageJsonFiles.cjs

@@ -0,0 +1,81 @@
+/* eslint-disable @typescript-eslint/no-var-requires */
+const fs = require('fs');
+const path = require('path');
+
+async function findPackageJsonFiles(rootPackageJsonPath, dir) {
+  let filesToMerge = [];
+  const files = await fs.readdirSync(dir);
+
+  for (const file of files) {
+    const filePath = path.join(dir, file);
+    const stat = await fs.statSync(filePath);
+
+    if (stat.isDirectory()) {
+      const nestedFiles = await findPackageJsonFiles(
+        rootPackageJsonPath,
+        filePath,
+      );
+      filesToMerge = filesToMerge.concat(nestedFiles);
+    } else if (
+      file === 'package.json' &&
+      filePath !== path.resolve(rootPackageJsonPath)
+    ) {
+      filesToMerge.push(filePath);
+    }
+  }
+
+  return filesToMerge;
+}
+
+function mergeDependencies(rootDependencies, newDependencies) {
+  for (const [dep, version] of Object.entries(newDependencies)) {
+    if (!rootDependencies[dep] || rootDependencies[dep] < version) {
+      rootDependencies[dep] = version;
+    }
+  }
+}
+
+async function mergePackageJsonFiles(rootPackageJsonPath, searchDirectory) {
+  try {
+    const rootPackageJsonString = await fs.readFileSync(
+      rootPackageJsonPath,
+      'utf8',
+    );
+    const rootPackageJson = JSON.parse(rootPackageJsonString);
+    const packageJsonFiles = await findPackageJsonFiles(
+      rootPackageJsonPath,
+      searchDirectory,
+    );
+
+    for (const file of packageJsonFiles) {
+      const packageJsonString = await fs.readFileSync(file, 'utf8');
+      const packageJson = JSON.parse(packageJsonString);
+      if (packageJson.dependencies) {
+        mergeDependencies(
+          rootPackageJson.dependencies ?? {},
+          packageJson.dependencies ?? {},
+        );
+      }
+
+      if (packageJson.devDependencies) {
+        mergeDependencies(
+          rootPackageJson.devDependencies ?? {},
+          packageJson.devDependencies ?? {},
+        );
+      }
+    }
+
+    await fs.writeFileSync(
+      rootPackageJsonPath,
+      JSON.stringify(rootPackageJson, null, 2),
+    );
+    console.log('Merged dependencies into root package.json');
+  } catch (error) {
+    console.log('Error merging package.json files:', error);
+  }
+}
+
+mergePackageJsonFiles(
+  path.join(__dirname, '..', 'package.json'),
+  path.join(__dirname, '..', 'packages'),
+);

package/analyzer-template/scripts/postbuild.cjs

@@ -0,0 +1,95 @@
+/* eslint-disable @typescript-eslint/no-var-requires */
+const fs = require('fs');
+const path = require('path');
+
+function updateImportStatements(directory, level = 0) {
+  const relativeLevel = Array(level).fill('..').join('/');
+  const files = fs.readdirSync(directory, { withFileTypes: true });
+
+  files.forEach((file) => {
+    const filePath = path.join(directory, file.name);
+    if (file.isDirectory()) {
+      updateImportStatements(filePath, level + 1);
+    } else if (file.isFile() && file.name.endsWith('.js')) {
+      fs.readFile(filePath, 'utf8', function (err, data) {
+        if (err) {
+          console.log('Error reading file:', filePath, err);
+          return;
+        }
+
+        let result = data.replace(
+          /import \* as lib from ['"](.*)lib['"]/g,
+          "import * as lib from '$1lib/index.js'",
+        );
+        result = result.replace(
+          /import \* as lib from ['"](.*)['"]/g,
+          "import * as lib from '$1/index.js'",
+        );
+        result = result.replace(
+          /import \* as (.*)(_\d)* from\s+['"](\.+\/)(.*?)['"]/g,
+          "import * as $1 from '$3$4/index.js'",
+        );
+        result = result.replace(
+          /from\s+['"](\.+\/)(.*?)['"]/g,
+          (match, relativePath, moduleName) => {
+            const fullPath = path.resolve(
+              path.dirname(filePath),
+              relativePath + moduleName,
+            );
+            const indexPath = path.join(fullPath, 'index.js');
+
+            // Check if there's a directory with index.js
+            if (fs.existsSync(indexPath)) {
+              return `from "${relativePath}${moduleName}/index.js"`;
+            } else {
+              return `from "${relativePath}${moduleName}.js"`;
+            }
+          },
+        );
+        result = result.replace(
+          /['"]~codeyam\/(.*)['"]/g,
+          (match, importPath) => {
+            // Construct the full path to check if it's a file or directory
+            const packagesPath = path.resolve(
+              path.dirname(filePath),
+              relativeLevel,
+              'packages',
+              importPath,
+            );
+
+            // Check if it's a .server file (like killProcess.server)
+            if (importPath.endsWith('.server')) {
+              // It's a .server file, add .js extension
+              return `'${relativeLevel}/packages/${importPath}.js'`;
+            }
+
+            // Check if there's a direct file with .js extension
+            if (fs.existsSync(packagesPath + '.js')) {
+              return `'${relativeLevel}/packages/${importPath}.js'`;
+            }
+
+            // Check if there's a directory with index.js
+            const indexPath = path.join(packagesPath, 'index.js');
+            if (fs.existsSync(indexPath)) {
+              return `'${relativeLevel}/packages/${importPath}/index.js'`;
+            }
+
+            // Default to /index.js for backward compatibility
+            return `'${relativeLevel}/packages/${importPath}/index.js'`;
+          },
+        );
+        result = result.replace(/.js.js/g, '.js');
+        result = result.replace(/index\/index\.js/g, 'index.js');
+        result = result.replace(/(index\.js\/)+/g, '');
+
+        fs.writeFile(filePath, result, 'utf8', function (err) {
+          if (err) {
+            console.log('Error writing file:', filePath, err);
+          }
+        });
+      });
+    }
+  });
+}
+
+updateImportStatements(path.join(__dirname, '..', 'dist'));

package/analyzer-template/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "include": ["**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules", "dist"],
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "lib": ["ES2020", "ES2022.Error", "DOM", "DOM.Iterable"],
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "jsx": "react-jsx",
+    "outDir": "./dist",
+    "baseUrl": ".",
+    "paths": {
+      "~codeyam/*": ["./packages/*"]
+    },
+    "sourceMap": true
+  }
+}

package/background/src/lib/copyFolderToArchive.js

@@ -0,0 +1,34 @@
+import * as fs from 'fs';
+import writeFile from "./writeFile.js";
+export default async function copyFolderToArchive({ source, destination, archive, recursive, exclude, }) {
+    const files = fs.readdirSync(source);
+    for (const file of files) {
+        if (file.indexOf('.test.') > -1)
+            continue;
+        const fullDestination = `${destination}/${file}`;
+        const stats = fs.statSync(`${source}/${file}`);
+        if (stats.isDirectory()) {
+            if (exclude?.includes(file))
+                continue;
+            if (recursive) {
+                await copyFolderToArchive({
+                    source: `${source}/${file}`,
+                    destination: fullDestination,
+                    archive,
+                    recursive,
+                    exclude,
+                });
+            }
+        }
+        else {
+            const content = fs.readFileSync(`${source}/${file}`, 'utf8');
+            if (archive) {
+                archive.append(content, { name: fullDestination });
+            }
+            else {
+                await writeFile(fullDestination, content);
+            }
+        }
+    }
+}
+//# sourceMappingURL=copyFolderToArchive.js.map

package/background/src/lib/copyFolderToArchive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyFolderToArchive.js","sourceRoot":"","sources":["../../../../../background/src/lib/copyFolderToArchive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,SAAS,MAAM,aAAa,CAAC;AAcpC,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,mBAAmB,CAAC,EAChD,MAAM,EACN,WAAW,EACX,OAAO,EACP,SAAS,EACT,OAAO,GACiB;IACxB,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,SAAS;QAE1C,MAAM,eAAe,GAAG,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YACtC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,mBAAmB,CAAC;oBACxB,MAAM,EAAE,GAAG,MAAM,IAAI,IAAI,EAAE;oBAC3B,WAAW,EAAE,eAAe;oBAC5B,OAAO;oBACP,SAAS;oBACT,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YAC7D,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/background/src/lib/local/createLocalAnalyzer.js

@@ -0,0 +1,160 @@
+import copyFolderToArchive from "../copyFolderToArchive.js";
+import writeFile from "../writeFile.js";
+import execAsync, { execAsyncWithProcess } from "./execAsync.js";
+import buildCliArgs from "../virtualized/project/buildCliArgs.js";
+import * as fs from 'fs';
+/**
+ * Creates analyzer template by copying source files and merging dependencies.
+ * This is the lightweight phase suitable for npm package build.
+ *
+ * NOTE: This method is crucially dependent on $CWD being ./background
+ */
+export async function createAnalyzerTemplate(absoluteCodeyamRootPath) {
+    const folders = ['common', 'project', 'playwright'];
+    for (const folderName of folders) {
+        const folder = `./src/lib/virtualized/${folderName}`;
+        await copyFolderToArchive({
+            source: folder,
+            destination: `${absoluteCodeyamRootPath}/${folderName}`,
+            exclude: ['__tests__'],
+            recursive: true,
+        });
+    }
+    // Copy the process management system at the root level
+    await copyFolderToArchive({
+        source: './src/lib/process',
+        destination: `${absoluteCodeyamRootPath}/process`,
+        exclude: ['__tests__'],
+        recursive: true,
+    });
+    // Fix the import path in common/execAsync.ts for the flat template structure
+    const execAsyncPath = `${absoluteCodeyamRootPath}/common/execAsync.ts`;
+    if (fs.existsSync(execAsyncPath)) {
+        let content = fs.readFileSync(execAsyncPath, 'utf8');
+        // Change ../../process to ../process to match the flat structure
+        // Use template literals to avoid postbuild.cjs modifying these strings
+        const oldImport = `from ${String.fromCharCode(39)}../../process${String.fromCharCode(39)}`;
+        const newImport = `from ${String.fromCharCode(39)}../process${String.fromCharCode(39)}`;
+        content = content.replace(oldImport, newImport);
+        fs.writeFileSync(execAsyncPath, content);
+    }
+    // Fix the import path in project/start.ts for the flat template structure
+    const startPath = `${absoluteCodeyamRootPath}/project/start.ts`;
+    if (fs.existsSync(startPath)) {
+        let content = fs.readFileSync(startPath, 'utf8');
+        // Change ../../process to ../process to match the flat structure
+        const oldImport = `from ${String.fromCharCode(39)}../../process${String.fromCharCode(39)}`;
+        const newImport = `from ${String.fromCharCode(39)}../process${String.fromCharCode(39)}`;
+        content = content.replace(oldImport, newImport);
+        fs.writeFileSync(startPath, content);
+    }
+    await copyFolderToArchive({
+        source: '../packages',
+        destination: `${absoluteCodeyamRootPath}/packages`,
+        recursive: true,
+        exclude: ['node_modules', '__tests__', '__testUtils__'],
+    });
+    await copyFolderToArchive({
+        source: './src/lib/configs/combo',
+        destination: `${absoluteCodeyamRootPath}`,
+    });
+    await copyFolderToArchive({
+        source: './src/lib/configs/scripts',
+        destination: `${absoluteCodeyamRootPath}/scripts`,
+    });
+    await execAsync({
+        command: 'npm',
+        args: ['run', 'mergeDependencies'],
+        workingDir: absoluteCodeyamRootPath,
+    });
+}
+/**
+ * Finalizes analyzer template by installing dependencies, playwright, and building.
+ * This is the expensive phase suitable for postinstall scripts.
+ */
+export async function finalizeAnalyzerTemplate(absoluteCodeyamRootPath) {
+    await execAsync({
+        command: 'npm',
+        args: ['i'],
+        workingDir: absoluteCodeyamRootPath,
+    });
+    await execAsync({
+        command: 'npx',
+        args: ['playwright', 'install'],
+        workingDir: absoluteCodeyamRootPath,
+    });
+    await execAsync({
+        command: 'npm',
+        args: ['run', 'build'],
+        workingDir: absoluteCodeyamRootPath,
+    });
+}
+/**
+ * Creates a complete local analyzer (backwards compatible).
+ * @param absoluteCodeyamRootPath - Path where analyzer should be created
+ * @param skipFinalization - If true, only creates template without expensive finalization steps
+ *
+ * NOTE: This method is crucially dependent on $CWD being ./background
+ */
+export async function createLocalAnalyzer(absoluteCodeyamRootPath, skipFinalization = false) {
+    await createAnalyzerTemplate(absoluteCodeyamRootPath);
+    if (!skipFinalization) {
+        await finalizeAnalyzerTemplate(absoluteCodeyamRootPath);
+    }
+}
+export async function runLocalAnalyzerStart(absoluteCodeyamRootPath, startEnv, startArgs) {
+    const env = Object.entries(startEnv)
+        .map(([key, value]) => `${key}=${value}`)
+        .join('\n');
+    await writeFile(`${absoluteCodeyamRootPath}/.env`, env);
+    console.log('Calling start.js with args:', JSON.stringify(startArgs));
+    const cliArgs = buildCliArgs(startArgs);
+    return await execAsync({
+        command: 'node',
+        args: ['--enable-source-maps', './dist/project/start.js', ...cliArgs],
+        workingDir: absoluteCodeyamRootPath,
+    });
+}
+export async function runLocalAnalyzerCapture(projectSlug, absoluteCodeyamRootPath) {
+    return await execAsync({
+        command: 'node',
+        args: [
+            '--enable-source-maps',
+            './dist/playwright/capture.js',
+            '--slug',
+            projectSlug,
+        ],
+        workingDir: absoluteCodeyamRootPath,
+    });
+}
+export function runLocalAnalyzerStartWithProcess({ absoluteCodeyamRootPath, startEnv, startArgs, outputOptions, }) {
+    // Write environment file for compatibility with code that reads .env
+    const env = Object.entries(startEnv)
+        .map(([key, value]) => `${key}=${value}`)
+        .join('\n');
+    fs.writeFileSync(`${absoluteCodeyamRootPath}/.env`, env);
+    const cliArgs = buildCliArgs(startArgs);
+    return execAsyncWithProcess({
+        command: 'node',
+        args: ['--enable-source-maps', './dist/project/start.js', ...cliArgs],
+        workingDir: absoluteCodeyamRootPath,
+        outputOptions,
+        processName: 'analyzer',
+        env: startEnv, // Pass environment variables to the spawned process
+    });
+}
+export function runLocalAnalyzerCaptureWithProcess({ projectSlug, absoluteCodeyamRootPath, outputOptions, }) {
+    return execAsyncWithProcess({
+        command: 'node',
+        args: [
+            '--enable-source-maps',
+            './dist/playwright/capture.js',
+            '--slug',
+            projectSlug,
+        ],
+        workingDir: absoluteCodeyamRootPath,
+        outputOptions,
+        processName: 'capture',
+    });
+}
+//# sourceMappingURL=createLocalAnalyzer.js.map

package/background/src/lib/local/createLocalAnalyzer.js.map

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

package/background/src/lib/local/execAsync.js

@@ -0,0 +1,100 @@
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import path from 'path';
+import { loadEnv } from "../../../../packages/utils/server.js";
+import { getGlobalProcessManager, ProcessType } from "../process/index.js";
+loadEnv();
+const DEFAULT_OUTPUT_OPTIONS = {
+    stdoutToConsole: true,
+    stdoutToFile: true,
+    stderrToConsole: true,
+    stderrToFile: true,
+};
+export default async function execAsync({ command, args, workingDir, outputOptions = DEFAULT_OUTPUT_OPTIONS, processName = 'codeyam', }) {
+    const result = execAsyncWithProcess({
+        command,
+        args,
+        workingDir,
+        outputOptions,
+        processName,
+    });
+    return result.promise;
+}
+export function execAsyncWithProcess({ command, args, workingDir, outputOptions = DEFAULT_OUTPUT_OPTIONS, processName, env, }) {
+    const spawnEnv = {
+        ...process.env,
+        ...(env || {}),
+        ...(processName && { CODEYAM_PROCESS_NAME: `codeyam-${processName}` }),
+    };
+    const childProcess = spawn(command, args, {
+        cwd: workingDir,
+        env: spawnEnv,
+    });
+    // Register with global process manager for automatic cleanup
+    const manager = getGlobalProcessManager();
+    const processId = manager.register({
+        process: childProcess,
+        type: ProcessType.Other,
+        name: processName,
+        metadata: {
+            command,
+            args,
+            workingDir,
+        },
+    });
+    const promise = new Promise((resolve) => {
+        const writeToLog = (text) => {
+            const logPath = path.join(workingDir, 'log.txt');
+            fs.appendFile(logPath, text, (err) => {
+                if (err) {
+                    console.log('Error writing to log file:', err);
+                }
+            });
+        };
+        // Helper to add timestamps to multi-line output
+        const timestampLines = (data, prefix = '') => {
+            const timestamp = new Date().toLocaleString();
+            const lines = data.split('\n');
+            // Timestamp each non-empty line, preserve empty lines
+            return lines
+                .map((line) => {
+                if (line.trim()) {
+                    return `[${timestamp}]${prefix} ${line}`;
+                }
+                return line; // Preserve empty lines without timestamp
+            })
+                .join('\n');
+        };
+        childProcess.stdout.on('data', function (data) {
+            const dataString = data?.toString() ?? '';
+            const timestampedOutput = timestampLines(dataString);
+            if (outputOptions.stdoutToConsole) {
+                console.log(timestampedOutput);
+            }
+            if (outputOptions.stdoutToFile) {
+                writeToLog(timestampedOutput + '\n');
+            }
+            if (outputOptions.stdoutCallback) {
+                outputOptions.stdoutCallback(dataString);
+            }
+        });
+        childProcess.stderr.on('data', function (data) {
+            const dataString = data?.toString() ?? '';
+            const timestampedOutput = timestampLines(dataString, '<STDERR>');
+            if (outputOptions.stderrToConsole) {
+                console.error(timestampedOutput);
+            }
+            if (outputOptions.stderrToFile) {
+                writeToLog(timestampedOutput + '\n');
+            }
+            if (outputOptions.stderrCallback) {
+                outputOptions.stderrCallback(dataString);
+            }
+        });
+        childProcess.on('exit', function (code) {
+            resolve(code);
+        });
+    });
+    return { promise, process: childProcess };
+}
+//# sourceMappingURL=execAsync.js.map

package/background/src/lib/local/execAsync.js.map

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

package/background/src/lib/process/GlobalProcessManager.js

@@ -0,0 +1,75 @@
+import { ProcessManager, ProcessType, ProcessState } from "./ProcessManager.js";
+export { ProcessManager, ProcessType, ProcessState };
+let globalInstance = null;
+let signalHandlersInstalled = false;
+/**
+ * Get the global singleton ProcessManager instance
+ */
+export function getGlobalProcessManager() {
+    if (!globalInstance) {
+        globalInstance = new ProcessManager();
+    }
+    return globalInstance;
+}
+/**
+ * Install signal handlers to cleanup processes on exit
+ * Can be called multiple times safely - will only install once
+ */
+export function installSignalHandlers() {
+    if (signalHandlersInstalled) {
+        return;
+    }
+    const manager = getGlobalProcessManager();
+    const cleanup = async (signal) => {
+        console.log(`\n${signal} received, cleaning up processes...`);
+        try {
+            await manager.shutdownAll({ escalationTimeoutMs: 2000 });
+            console.log('All processes cleaned up successfully');
+        }
+        catch (error) {
+            console.error('Error during cleanup:', error);
+        }
+        // Exit with appropriate code
+        process.exit(signal === 'SIGTERM' ? 0 : 1);
+    };
+    // Handle termination signals
+    process.on('SIGINT', () => void cleanup('SIGINT'));
+    process.on('SIGTERM', () => void cleanup('SIGTERM'));
+    // Handle uncaught exceptions
+    process.on('uncaughtException', (error) => {
+        console.error('Uncaught exception:', error);
+        void manager
+            .shutdownAll({ escalationTimeoutMs: 1000 })
+            .catch((cleanupError) => console.error('Error during emergency cleanup:', cleanupError))
+            .finally(() => process.exit(1));
+    });
+    // Handle unhandled promise rejections
+    process.on('unhandledRejection', (reason, promise) => {
+        console.error('Unhandled rejection at:', promise, 'reason:', reason);
+        void manager
+            .shutdownAll({ escalationTimeoutMs: 1000 })
+            .catch((cleanupError) => console.error('Error during emergency cleanup:', cleanupError))
+            .finally(() => process.exit(1));
+    });
+    // Handle normal exit
+    process.on('beforeExit', () => {
+        // Only cleanup if there are running processes
+        const runningProcesses = manager.listByState(ProcessState.Running);
+        if (runningProcesses.length > 0) {
+            console.log('Process exiting, cleaning up running processes...');
+            void manager.shutdownAll({ escalationTimeoutMs: 2000 });
+        }
+    });
+    signalHandlersInstalled = true;
+}
+/**
+ * Reset the global instance (primarily for testing)
+ */
+export function resetGlobalProcessManager() {
+    if (globalInstance) {
+        // Don't await, just fire and forget
+        globalInstance.shutdownAll().catch(console.error);
+        globalInstance = null;
+    }
+}
+//# sourceMappingURL=GlobalProcessManager.js.map

package/background/src/lib/process/GlobalProcessManager.js.map

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