@codeyam/codeyam-cli 0.1.0-staging.1669d45 → 0.1.0-staging.27d5a59

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

@@ -0,0 +1,134 @@
+/**
+ * Pure logic for transforming {{scenario:Name:ID}} markers into OSC 8
+ * clickable hyperlinks in terminal output.
+ *
+ * Extracted from terminalServer.ts for testability. Zero side-effects.
+ *
+ * Claude Code's renderer inserts ANSI escape codes (colors/styles) within the
+ * marker text, so we can't regex-match on raw PTY data directly. Instead,
+ * strip ANSI codes to find markers, then map positions back to the original
+ * string for replacement.
+ */
+// Matches CSI sequences: \x1b[ followed by params and a letter.
+// Also handles private-mode params (?) and colon-delimited SGR (e.g., 38:2:R:G:B).
+const ANSI_ESCAPE_RE = /\x1b\[[?]?[0-9;:]*[a-zA-Z]/g;
+// Additional non-CSI escapes: charset selection (\x1b(B), save/restore cursor, etc.
+const OTHER_ESCAPE_RE = /\x1b[()][A-Z0-9]/g;
+/**
+ * Strip all ANSI escape sequences from a string.
+ */
+function stripAnsi(data) {
+    return data.replace(ANSI_ESCAPE_RE, '').replace(OTHER_ESCAPE_RE, '');
+}
+/**
+ * Build a position map from ANSI-stripped indices to original indices.
+ * posMap[strippedIndex] = originalIndex, skipping over ANSI sequences.
+ */
+function buildAnsiPositionMap(data, stripped) {
+    const posMap = [];
+    for (let di = 0, si = 0; di < data.length; di++) {
+        if (data[di] === '\x1b') {
+            // Try CSI sequence (with optional ? for private mode, : for colon-delimited SGR)
+            const seqMatch = data.slice(di).match(/^\x1b\[?\??[0-9;:]*[a-zA-Z]/);
+            if (seqMatch) {
+                di += seqMatch[0].length - 1;
+                continue;
+            }
+            // Try charset selection: \x1b(B, \x1b)0, etc.
+            const charsetMatch = data.slice(di).match(/^\x1b[()][A-Z0-9]/);
+            if (charsetMatch) {
+                di += charsetMatch[0].length - 1;
+                continue;
+            }
+        }
+        posMap[si] = di;
+        si++;
+    }
+    posMap[stripped.length] = data.length; // sentinel for end-of-string markers
+    return posMap;
+}
+const MARKER_RE = /\{\{scenario:([^:}]+):([^}]+)\}\}/g;
+/**
+ * Transform {{scenario:Name:ID}} markers into OSC 8 hyperlinks.
+ * OSC 8 format: \x1b]8;;URL\x07VISIBLE_TEXT\x1b]8;;\x07
+ *
+ * Stateless — operates on a single string. For streaming PTY data,
+ * use createMarkerTransformer() which buffers partial markers.
+ */
+export function transformScenarioMarkers(data, port) {
+    const stripped = stripAnsi(data);
+    if (!stripped.includes('{{scenario:'))
+        return data;
+    const posMap = buildAnsiPositionMap(data, stripped);
+    const replacements = [];
+    let m;
+    while ((m = MARKER_RE.exec(stripped)) !== null) {
+        const url = `http://localhost:${port}/editor?scenario=${m[2]}&ref=link`;
+        const visibleName = m[1];
+        // Pad replacement to match the original marker's visible width so table
+        // columns stay aligned after the shorter hyperlink text replaces the marker.
+        const pad = ' '.repeat(Math.max(0, m[0].length - visibleName.length));
+        replacements.push({
+            origStart: posMap[m.index],
+            origEnd: posMap[m.index + m[0].length],
+            replacement: `\x1b]8;;${url}\x07${visibleName}\x1b]8;;\x07${pad}`,
+        });
+    }
+    if (replacements.length === 0)
+        return data;
+    // Replace from end to start so earlier positions stay valid
+    let result = data;
+    for (let i = replacements.length - 1; i >= 0; i--) {
+        const r = replacements[i];
+        result =
+            result.slice(0, r.origStart) + r.replacement + result.slice(r.origEnd);
+    }
+    return result;
+}
+/**
+ * Create a stateful scenario marker transformer that buffers partial markers
+ * across PTY chunks. Claude Code streams output token by token, so the PTY
+ * can split a {{scenario:Name:ID}} marker across two (or more) data events.
+ *
+ * Also handles Ink-style line rewrites where \r (carriage return) invalidates
+ * buffered content from the same line.
+ */
+export function createMarkerTransformer(port) {
+    let buffer = '';
+    return function transform(data) {
+        // If the incoming data contains \r (carriage return), Ink is rewriting
+        // the current line. Any buffered partial marker from that line is stale —
+        // discard it so the new content isn't confused with old fragments.
+        // The buffer only ever holds content after an unclosed {{ (i.e., a partial
+        // marker on the current line), so discarding it is always safe when the
+        // line is being rewritten.
+        if (buffer && data.includes('\r')) {
+            buffer = '';
+            return transform(data);
+        }
+        // Prepend any buffered partial-marker text from the previous chunk
+        const combined = buffer + data;
+        buffer = '';
+        // Strip ANSI to detect partial markers at the end
+        const stripped = stripAnsi(combined);
+        // Check for an unclosed {{ at the end — potential partial marker
+        const lastOpen = stripped.lastIndexOf('{{');
+        if (lastOpen !== -1 && !stripped.slice(lastOpen).includes('}}')) {
+            // Map the stripped position back to the original string
+            const posMap = buildAnsiPositionMap(combined, stripped);
+            const splitPos = posMap[lastOpen];
+            // Safety: if partial marker exceeds 500 chars, it's not a real marker — flush it
+            if (combined.length - splitPos > 500) {
+                return transformScenarioMarkers(combined, port);
+            }
+            buffer = combined.slice(splitPos);
+            const toSend = combined.slice(0, splitPos);
+            // If nothing to send yet (entire chunk is a partial marker), return empty
+            if (toSend.length === 0)
+                return '';
+            return transformScenarioMarkers(toSend, port);
+        }
+        return transformScenarioMarkers(combined, port);
+    };
+}
+//# sourceMappingURL=scenarioMarkers.js.map

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

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

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

@@ -53,21 +53,48 @@ export function isProcessRunning(pid) {
  */
 export function findCodeYamProcesses() {
     try {
-        // Use ps to find processes with 'codeyam-server' in the command
-        const output = execSync('ps aux | grep codeyam-server | grep -v grep', {
+        const isWindows = process.platform === 'win32';
+        const command = isWindows
+            ? 'tasklist /FI "IMAGENAME eq node.exe" /FO CSV /NH'
+            : 'ps aux | grep codeyam-server | grep -v grep';
+        const output = execSync(command, {
             encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
         }).trim();
         if (!output)
             return [];
-        // Parse ps output to extract PIDs
         const pids = [];
-        for (const line of output.split('\n')) {
-            // ps aux format: USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
-            const parts = line.trim().split(/\s+/);
-            if (parts.length >= 2) {
-                const pid = parseInt(parts[1], 10);
-                if (!isNaN(pid)) {
-                    pids.push(pid);
+        if (isWindows) {
+            // tasklist CSV format: "node.exe","12345","Console","1","50,000 K"
+            // We get all node processes, then filter by checking their command line
+            for (const line of output.split('\n')) {
+                const match = line.match(/"[^"]*","(\d+)"/);
+                if (match) {
+                    const pid = parseInt(match[1], 10);
+                    if (!isNaN(pid)) {
+                        // Check if this node process is a codeyam-server
+                        try {
+                            const cmdline = execSync(`wmic process where "ProcessId=${pid}" get CommandLine /FORMAT:LIST`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+                            if (cmdline.includes('codeyam-server')) {
+                                pids.push(pid);
+                            }
+                        }
+                        catch {
+                            // Can't inspect this process, skip it
+                        }
+                    }
+                }
+            }
+        }
+        else {
+            for (const line of output.split('\n')) {
+                // ps aux format: USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
+                const parts = line.trim().split(/\s+/);
+                if (parts.length >= 2) {
+                    const pid = parseInt(parts[1], 10);
+                    if (!isNaN(pid)) {
+                        pids.push(pid);
+                    }
                 }
             }
         }
@@ -98,32 +125,57 @@ export function isServerRunning() {
     }
     return { running: false };
 }
+/**
+ * Wait for processes to exit, polling every 100ms up to the given timeout.
+ * Returns true if all processes exited, false if timed out.
+ */
+export function waitForProcessExit(pids, timeoutMs = 5000) {
+    if (pids.length === 0)
+        return true;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const stillRunning = pids.some((pid) => isProcessRunning(pid));
+        if (!stillRunning)
+            return true;
+        // Synchronous sleep 100ms (can't use async in this context)
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100);
+    }
+    return false;
+}
 export function killServer() {
     let killedAny = false;
+    const pidsToWait = [];
     // First try to kill from state file
     const state = loadServerState();
     if (state) {
         try {
             process.kill(state.pid, 'SIGTERM');
-            clearServerState();
+            pidsToWait.push(state.pid);
             killedAny = true;
         }
         catch {
             // Process might already be dead
-            clearServerState();
         }
+        clearServerState();
     }
     // Also find and kill any processes by name
     const pids = findCodeYamProcesses();
     for (const pid of pids) {
         try {
             process.kill(pid, 'SIGTERM');
+            if (!pidsToWait.includes(pid)) {
+                pidsToWait.push(pid);
+            }
             killedAny = true;
         }
         catch {
             // Process might already be dead or not killable
         }
     }
+    // Wait for killed processes to actually exit (up to 5 seconds)
+    // Without this, a new server can be spawned while the old one is still dying,
+    // causing port conflicts and memory pressure from two concurrent Node processes.
+    waitForProcessExit(pidsToWait);
     return killedAny;
 }
 //# sourceMappingURL=serverState.js.map

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

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

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

@@ -3,13 +3,15 @@ import * as path from 'path';
 /**
  * Configure Claude Code settings to auto-approve CodeYam skills and commands
  *
- * Adds CodeYam skills and CLI commands explicitly to the allow list in .claude/settings.local.json
- * This prevents Claude from asking permission every time it uses CodeYam
+ * In memory mode (default), only memory-related permissions are added.
+ * In full mode, simulation permissions are also added.
  *
  * @param projectRoot - The root directory of the project
+ * @param options - Configuration options (mode defaults to 'memory')
  * @returns True if successfully configured, false otherwise
  */
-export function setupClaudeCodeSettings(projectRoot) {
+export function setupClaudeCodeSettings(projectRoot, options) {
+    const mode = options?.mode ?? 'memory';
     try {
         const claudeDir = path.join(projectRoot, '.claude');
         const settingsPath = path.join(claudeDir, 'settings.local.json');
@@ -35,27 +37,55 @@ export function setupClaudeCodeSettings(projectRoot) {
         if (!settings.permissions.allow) {
             settings.permissions.allow = [];
         }
-        // Add CodeYam skills and CLI commands to allow list
-        const codeyamPermissions = [
-            // Skills
-            'Skill(codeyam:setup)',
-            'Skill(codeyam:sim)',
-            'Skill(codeyam:debug)',
-            'Skill(codeyam:test)',
-            'Skill(codeyam:verify)',
-            // CodeYam CLI commands
+        // Memory permissions — always included
+        const memoryPermissions = [
+            'Skill(codeyam-memory)',
+            'Skill(codeyam-new-rule)',
             'Bash(codeyam)',
             'Bash(codeyam:*)',
-            // File operations for .codeyam directory
             'Read(.codeyam/**)',
             'Edit(.codeyam/**)',
             'Write(.codeyam/**)',
             'Glob(.codeyam/**)',
+        ];
+        // Editor permissions — only in editor mode
+        const editorPermissions = ['Skill(codeyam-editor)'];
+        // Simulation permissions — only in full mode
+        const simulationPermissions = [
+            'Skill(codeyam-setup)',
+            'Skill(codeyam-sim)',
+            'Skill(codeyam-debug)',
+            'Skill(codeyam-test)',
+            'Skill(codeyam-verify)',
+            'Skill(codeyam-dev-mode)',
             'Read(/tmp/codeyam/**)',
             'Edit(/tmp/codeyam/**)',
             'Write(/tmp/codeyam/**)',
             'Glob(/tmp/codeyam/**)',
         ];
+        const isEditorMode = mode === 'editor' || options?.editorMode === true;
+        let codeyamPermissions;
+        if (mode === 'full') {
+            codeyamPermissions = [...memoryPermissions, ...simulationPermissions];
+        }
+        else if (mode === 'editor') {
+            codeyamPermissions = [
+                ...memoryPermissions,
+                ...editorPermissions,
+                ...simulationPermissions,
+            ];
+        }
+        else {
+            codeyamPermissions = memoryPermissions;
+        }
+        // When editorMode flag is set (e.g. full mode + editor), ensure editor permissions are included
+        if (isEditorMode && mode !== 'editor') {
+            for (const perm of [...editorPermissions, ...simulationPermissions]) {
+                if (!codeyamPermissions.includes(perm)) {
+                    codeyamPermissions.push(perm);
+                }
+            }
+        }
         let updated = false;
         for (const permission of codeyamPermissions) {
             if (!settings.permissions.allow.includes(permission)) {
@@ -63,34 +93,24 @@ export function setupClaudeCodeSettings(projectRoot) {
                 updated = true;
             }
         }
-        // // Configure Stop hook for automatic verification
-        // if (!settings.hooks) {
-        //   settings.hooks = {};
-        // }
-        // if (!settings.hooks.Stop) {
-        //   settings.hooks.Stop = [];
-        // }
-        // // Install CodeYam stop hook that returns JSON to trigger verification
-        // const hookScriptPath = path.join(
-        //   projectRoot,
-        //   '.codeyam',
-        //   'bin',
-        //   'codeyam-stop-hook.sh',
-        // );
-        // const hookExists = settings.hooks.Stop.some((hook: any) =>
-        //   hook.hooks?.some((h: any) => h.command?.includes('codeyam-stop-hook.sh')),
-        // );
-        // if (!hookExists) {
-        //   settings.hooks.Stop.push({
-        //     hooks: [
-        //       {
-        //         type: 'command',
-        //         command: `bash "${hookScriptPath}"`,
-        //       },
-        //     ],
-        //   });
-        //   updated = true;
-        // }
+        // Editor mode: register PostToolUse + Stop hooks for step tracking
+        if (isEditorMode) {
+            if (!settings.hooks) {
+                settings.hooks = {};
+            }
+            const hookCommand = 'test -f "$CLAUDE_PROJECT_DIR"/.codeyam/bin/editor-step-hook.py && python3 "$CLAUDE_PROJECT_DIR"/.codeyam/bin/editor-step-hook.py || true';
+            for (const event of ['PostToolUse', 'Stop']) {
+                const existing = settings.hooks[event] || [];
+                const alreadyRegistered = existing.some((entry) => entry.hooks?.some((h) => h.command?.includes('editor-step-hook')));
+                if (!alreadyRegistered) {
+                    existing.push({
+                        hooks: [{ type: 'command', command: hookCommand, timeout: 5 }],
+                    });
+                    settings.hooks[event] = existing;
+                    updated = true;
+                }
+            }
+        }
         // Write updated settings if any permissions or hooks were added
         if (updated) {
             fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');

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

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

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

@@ -0,0 +1,159 @@
+import { findProjectRoot } from "./project.js";
+import { initializeEnvironment, requireBranchAndProject } from "./database.js";
+import Database from 'better-sqlite3';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Commands hidden from the default help section.
+ * All require simulations to be enabled via the dashboard.
+ */
+export const HIDDEN_COMMANDS = [
+    { name: 'init', describe: 'Initialize a project for CodeYam CLI analysis' },
+    { name: 'update-config', describe: 'Update project configuration' },
+    { name: 'setup-simulations', describe: 'Enable simulation commands' },
+    { name: 'analyze', describe: 'Analyze local code changes before committing' },
+    {
+        name: 'verify',
+        describe: 'Detect changed visual/library entities and verify',
+    },
+    {
+        name: 'test-startup',
+        describe: 'Test project startup without external services',
+    },
+    {
+        name: 'setup-sandbox',
+        describe: 'Create sandbox copy for iterating on startup',
+    },
+    { name: 'recapture', describe: 'Re-run capture for an analysis or scenario' },
+    { name: 'baseline', describe: 'Run baseline analysis of all entities' },
+    {
+        name: 'debug',
+        describe: 'Setup debug environment for an analysis or scenario',
+    },
+    {
+        name: 'generate-data-structure',
+        describe: 'Generate Jest mock template via partial analysis',
+    },
+    { name: 'suggest', describe: 'Suggest components for analysis' },
+    { name: 'status', describe: 'Show status of local code changes vs database' },
+    { name: 'entities', describe: 'Search for entities in the project by name' },
+    { name: 'queue', describe: 'Show the current job queue status' },
+    {
+        name: 'validate-mock',
+        describe: 'Validate a universal mock file before applying',
+    },
+    {
+        name: 'report',
+        describe: 'Create a debug bundle for sharing with the CodeYam team',
+    },
+    {
+        name: 'wipe',
+        describe: 'Delete all analysis data (entities, analyses, scenarios)',
+    },
+];
+export const HIDDEN_COMMAND_NAMES = HIDDEN_COMMANDS.map((c) => c.name);
+/**
+ * Load project context from the DB for middleware use.
+ * Stashes the result on argv.__projectContext to avoid duplicate loads
+ * when multiple middlewares need the same data.
+ */
+export async function loadProjectForMiddleware(argv) {
+    if (argv.__projectContext) {
+        return argv.__projectContext;
+    }
+    const projectRoot = findProjectRoot();
+    if (!projectRoot)
+        return null;
+    const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+    if (!fs.existsSync(configPath))
+        return null;
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    const { projectSlug } = config;
+    if (!projectSlug)
+        return null;
+    await initializeEnvironment();
+    const { project } = await requireBranchAndProject(projectSlug);
+    const context = { projectRoot, projectSlug, project };
+    argv.__projectContext = context;
+    return context;
+}
+/**
+ * Middleware that gates simulation commands behind the labs.simulations flag.
+ * Runs before command execution — for non-simulation commands, returns immediately.
+ */
+export async function simulationGateMiddleware(argv) {
+    const command = String(argv._[0] ?? '');
+    if (!HIDDEN_COMMAND_NAMES.includes(command)) {
+        return;
+    }
+    try {
+        const context = await loadProjectForMiddleware(argv);
+        if (!context) {
+            // Not in a project — let the command handle its own error
+            return;
+        }
+        if (!context.project.metadata?.labs?.simulations) {
+            console.error(`\n"codeyam ${command}" requires simulations to be enabled.`);
+            console.error('Enable simulations from the CodeYam dashboard.\n');
+            process.exit(1);
+        }
+    }
+    catch {
+        // If we can't load the project, let the command handle it
+        return;
+    }
+}
+/**
+ * Synchronously check if the current project has simulations enabled
+ * by reading the SQLite database directly. Returns false if not in a
+ * project or if the flag isn't set.
+ */
+function areSimulationsEnabled() {
+    try {
+        const projectRoot = findProjectRoot();
+        if (!projectRoot)
+            return false;
+        const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+        if (!fs.existsSync(configPath))
+            return false;
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        const { projectSlug } = config;
+        if (!projectSlug)
+            return false;
+        const dbPath = path.join(projectRoot, '.codeyam', 'db.sqlite3');
+        if (!fs.existsSync(dbPath))
+            return false;
+        const db = new Database(dbPath, { readonly: true });
+        try {
+            const row = db
+                .prepare('SELECT metadata FROM projects WHERE slug = ?')
+                .get(projectSlug);
+            if (!row?.metadata)
+                return false;
+            const metadata = JSON.parse(row.metadata);
+            return !!metadata?.labs?.simulations;
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build the epilogue string for --help. Only shows hidden commands
+ * when simulations are enabled for the current project.
+ */
+export function buildSimulationEpilogue() {
+    if (!areSimulationsEnabled()) {
+        return 'Enable simulations from the CodeYam dashboard to unlock more commands.';
+    }
+    const maxNameLen = Math.max(...HIDDEN_COMMANDS.map((c) => c.name.length));
+    const lines = HIDDEN_COMMANDS.map((c) => {
+        const padded = c.name.padEnd(maxNameLen + 2);
+        return `  codeyam ${padded}${c.describe}`;
+    });
+    return `All Commands:\n${lines.join('\n')}`;
+}
+//# sourceMappingURL=simulationGateMiddleware.js.map

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

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

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

@@ -1,8 +1,5 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { findProjectRoot } from "./project.js";
-import { initializeEnvironment, requireBranchAndProject } from "./database.js";
 import { syncUniversalMocks } from "./syncUniversalMocks.js";
+import { loadProjectForMiddleware } from "./simulationGateMiddleware.js";
 // Commands that should NOT trigger sync
 const SKIP_SYNC_COMMANDS = ['init', 'help', 'version', '$0'];
 /**
@@ -16,28 +13,12 @@ export async function syncMocksMiddleware(argv) {
     if (SKIP_SYNC_COMMANDS.includes(command)) {
         return;
     }
-    // Check if we're in a codeyam project
-    const projectRoot = findProjectRoot();
-    if (!projectRoot) {
-        return; // Not in a codeyam project, skip sync
-    }
-    const configPath = path.join(projectRoot, '.codeyam', 'config.json');
-    if (!fs.existsSync(configPath)) {
-        return; // No config file, skip sync
-    }
     try {
-        // Load project config
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-        const { projectSlug } = config;
-        if (!projectSlug) {
-            return; // No project slug, skip sync
-        }
-        // Initialize environment (sets up database connection)
-        await initializeEnvironment();
-        // Load project from database
-        const { project } = await requireBranchAndProject(projectSlug);
+        const context = await loadProjectForMiddleware(argv);
+        if (!context)
+            return;
         // Sync mocks
-        const result = await syncUniversalMocks(projectRoot, project);
+        const result = await syncUniversalMocks(context.projectRoot, context.project);
         if (result.synced) {
             console.log(`Synced ${result.mockCount} universal mock(s) from .codeyam/universal-mocks/`);
         }