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

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

@@ -10,18 +10,28 @@ export async function startBackgroundServer(options) {
     const { port, rootPath, project, branch, processName = 'server' } = options;
     const url = `http://localhost:${port}`;
     // Check if server is already running
-    const { running, state } = isServerRunning();
+    let isRestart = false;
+    const { running, state, pids } = isServerRunning();
     if (running && state) {
         // Check for version mismatch - restart if CLI was updated
         if (state.cliVersion !== cliVersion) {
             console.log(`CLI version mismatch (server: ${state.cliVersion ?? 'unknown'} → CLI: ${cliVersion}), restarting server...`);
-            killServer();
+            killServer(); // Waits up to 5s for old process to exit
+            isRestart = true;
             // Fall through to spawn new server
         }
         else {
             return { url: state.url, pid: state.pid, wasAlreadyRunning: true };
         }
     }
+    else if (running && pids && pids.length > 0) {
+        // Found codeyam-server processes without a state file for this project
+        // (e.g. a server from a different project on the same port).
+        // Kill them all to avoid port conflicts.
+        console.log(`Found ${pids.length} orphaned codeyam-server process(es), killing...`);
+        killServer();
+        isRestart = true;
+    }
     // Bootstrap new background server process
     const serverScriptPath = path.join(__dirname, '..', 'webserver', 'bootstrap.js');
     // Create log files for debugging
@@ -29,25 +39,36 @@ export async function startBackgroundServer(options) {
     if (!fs.existsSync(logDir)) {
         fs.mkdirSync(logDir, { recursive: true });
     }
-    const outLog = fs.openSync(path.join(logDir, 'background-server.log'), 'a');
-    const errLog = fs.openSync(path.join(logDir, 'background-server-error.log'), 'a');
-    const child = spawn('node', [serverScriptPath], {
-        detached: true,
-        stdio: ['ignore', outLog, errLog],
-        env: {
-            ...process.env,
-            CODEYAM_PORT: port.toString(),
-            CODEYAM_ROOT_PATH: rootPath,
-            CODEYAM_PROJECT: project ? JSON.stringify(project) : '',
-            CODEYAM_BRANCH: branch ? JSON.stringify(branch) : '',
-            CODEYAM_PROCESS_NAME: `codeyam-${processName}`,
-        },
-    });
-    // Detach the child process so it can run independently
-    child.unref();
+    const serverEnv = {
+        CODEYAM_PORT: port.toString(),
+        CODEYAM_ROOT_PATH: rootPath,
+        CODEYAM_PROJECT: project ? JSON.stringify(project) : '',
+        CODEYAM_BRANCH: branch ? JSON.stringify(branch) : '',
+        CODEYAM_PROCESS_NAME: `codeyam-${processName}`,
+        // On restart, tell bootstrap to wait for the old process to release the port
+        ...(isRestart ? { CODEYAM_WAIT_FOR_PORT: 'true' } : {}),
+        ...(process.env.CODEYAM_TRACE_TRANSFORMS
+            ? { CODEYAM_TRACE_TRANSFORMS: process.env.CODEYAM_TRACE_TRANSFORMS }
+            : {}),
+    };
+    let childPid;
+    if (process.platform === 'win32') {
+        childPid = await spawnServerWindows(serverScriptPath, serverEnv, logDir);
+    }
+    else {
+        const outLog = fs.openSync(path.join(logDir, 'background-server.log'), 'a');
+        const errLog = fs.openSync(path.join(logDir, 'background-server-error.log'), 'a');
+        const child = spawn('node', ['--max-old-space-size=8192', serverScriptPath], {
+            detached: true,
+            stdio: ['ignore', outLog, errLog],
+            env: { ...process.env, ...serverEnv },
+        });
+        child.unref();
+        childPid = child.pid;
+    }
     // Poll health endpoint until server is ready (includes FileWatcher initial sync)
-    // This replaces the old arbitrary 1-second wait with actual readiness detection
-    const healthUrl = `${url}/api/health`;
+    // Use 127.0.0.1 instead of localhost to avoid IPv6 resolution issues with fetch
+    const healthUrl = `http://127.0.0.1:${port}/api/health`;
     const maxWaitMs = 60000; // 60 second timeout (initial sync can take time for large projects)
     const pollIntervalMs = 200;
     const startTime = Date.now();
@@ -56,6 +77,8 @@ export async function startBackgroundServer(options) {
             const response = await fetch(healthUrl);
             if (response.ok) {
                 // Server is ready - health endpoint only available after full initialization
+                const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+                console.log(`[BackgroundServer] Server ready after ${elapsed}s`);
                 break;
             }
         }
@@ -67,10 +90,11 @@ export async function startBackgroundServer(options) {
     // Check if we timed out
     if (Date.now() - startTime >= maxWaitMs) {
         console.warn(`[BackgroundServer] Warning: Server did not become ready within ${maxWaitMs / 1000}s`);
+        console.warn(`[BackgroundServer] Check logs at: ${path.join(logDir, 'background-server.log')}`);
     }
     // Save server state
     const serverState = {
-        pid: child.pid,
+        pid: childPid,
         port,
         url,
         startTime: Date.now(),
@@ -79,6 +103,69 @@ export async function startBackgroundServer(options) {
         cliVersion,
     };
     saveServerState(serverState);
-    return { url, pid: child.pid, wasAlreadyRunning: false };
+    return { url, pid: childPid, wasAlreadyRunning: false };
+}
+/**
+ * On Windows, Node's spawn with detached:true uses DETACHED_PROCESS |
+ * CREATE_NEW_PROCESS_GROUP flags, and windowsHide adds CREATE_NO_WINDOW.
+ * These flags conflict — the result is neither properly hidden nor properly
+ * detached (the process still gets killed by the parent's Job Object).
+ *
+ * Instead, we use PowerShell's Start-Process which creates a truly independent
+ * process with a hidden window via -WindowStyle Hidden.
+ *
+ * Flow: write .ps1 script that sets env vars and starts node directly →
+ * run PowerShell hidden → capture the node PID from stdout.
+ *
+ * Log redirection is handled by bootstrap.ts via the CODEYAM_LOG_DIR env var
+ * (since Start-Process -WindowStyle Hidden can't use -RedirectStandardOutput).
+ */
+async function spawnServerWindows(serverScriptPath, serverEnv, logDir) {
+    // Escape single quotes for PowerShell single-quoted strings (' → '')
+    const psEscape = (s) => s.replace(/'/g, "''");
+    // Build PowerShell script that sets env vars and starts node hidden
+    const psScriptPath = path.join(logDir, 'start-server.ps1');
+    const envLines = Object.entries(serverEnv).map(([key, val]) => `$env:${key} = '${psEscape(val)}'`);
+    fs.writeFileSync(psScriptPath, [
+        ...envLines,
+        // Tell bootstrap.ts to redirect stdout/stderr to log files
+        `$env:CODEYAM_LOG_DIR = '${psEscape(logDir)}'`,
+        // Start node with bootstrap.js in a hidden window
+        `$bootstrapPath = '${psEscape(serverScriptPath)}'`,
+        `$p = Start-Process -FilePath "node" -ArgumentList ('--max-old-space-size=8192', '"{0}"' -f $bootstrapPath) -WindowStyle Hidden -PassThru`,
+        `Write-Output $p.Id`,
+    ].join('\n'));
+    // Run PowerShell hidden to start the server and get the PID
+    return new Promise((resolve, reject) => {
+        const ps = spawn('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', psScriptPath], {
+            windowsHide: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        ps.stdout.on('data', (d) => {
+            stdout += d.toString();
+        });
+        ps.stderr.on('data', (d) => {
+            stderr += d.toString();
+        });
+        const timeout = setTimeout(() => {
+            ps.kill();
+            reject(new Error('Timed out waiting for PowerShell to start server (30s)'));
+        }, 30000);
+        ps.on('close', (code) => {
+            clearTimeout(timeout);
+            if (code !== 0) {
+                reject(new Error(`Failed to start server via PowerShell (exit ${code}): ${stderr}`));
+                return;
+            }
+            const pid = parseInt(stdout.trim(), 10);
+            if (isNaN(pid)) {
+                reject(new Error(`Failed to parse server PID from PowerShell output: ${stdout}`));
+                return;
+            }
+            resolve(pid);
+        });
+    });
 }
 //# sourceMappingURL=backgroundServer.js.map

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

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

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

@@ -0,0 +1,4 @@
+export const IS_INTERNAL_BUILD = typeof false !== 'undefined'
+    ? false
+    : false;
+//# sourceMappingURL=buildFlags.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildFlags.js","sourceRoot":"","sources":["../../../../src/utils/buildFlags.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,OAAO,0BAA0B,KAAK,WAAW;IAC/C,CAAC,CAAC,0BAA0B;IAC5B,CAAC,CAAC,KAAK,CAAC"}

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

@@ -0,0 +1,40 @@
+import { EventEmitter } from 'events';
+/**
+ * Shared event emitter for dev mode file sync events.
+ * The InteractiveSyncWatcher emits events to this, and the
+ * SSE endpoint (api.dev-mode-events.ts) streams them to the browser.
+ *
+ * Uses a global variable to ensure the CLI's job runner and the Vite SSR
+ * webserver routes share the exact same singleton instance, even though
+ * they're compiled by different bundlers.
+ */
+class DevModeEventEmitter extends EventEmitter {
+    constructor() {
+        super();
+        this.setMaxListeners(20);
+    }
+    emitFileSynced(fileName, filePath) {
+        this.emit('event', {
+            type: 'file-synced',
+            fileName,
+            filePath,
+            timestamp: Date.now(),
+        });
+    }
+    emitError(fileName, filePath) {
+        this.emit('event', {
+            type: 'sync-error',
+            fileName,
+            filePath,
+            timestamp: Date.now(),
+        });
+    }
+}
+// Use a global singleton to ensure the same instance is shared between
+// the CLI's TypeScript compilation and Vite's SSR compilation
+const GLOBAL_KEY = '__codeyam_dev_mode_event_emitter__';
+if (!globalThis[GLOBAL_KEY]) {
+    globalThis[GLOBAL_KEY] = new DevModeEventEmitter();
+}
+export const devModeEventEmitter = globalThis[GLOBAL_KEY];
+//# sourceMappingURL=devModeEvents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"devModeEvents.js","sourceRoot":"","sources":["../../../../src/utils/devModeEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,mBAAoB,SAAQ,YAAY;IAC5C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,QAAgB;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,QAAgB,EAAE,QAAgB;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,EAAE,YAAY;YAClB,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;CACF;AAED,uEAAuE;AACvE,8DAA8D;AAC9D,MAAM,UAAU,GAAG,oCAAoC,CAAC;AACxD,IAAI,CAAE,UAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;IACpC,UAAkB,CAAC,UAAU,CAAC,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAyB,UAAkB,CACzE,UAAU,CACX,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * Pure logic for `codeyam editor audit` — zero I/O, fully testable.
+ *
+ * Cross-references glossary entries against registered scenarios (components)
+ * and test files (functions) to detect gaps Claude may have missed.
+ */
+// ─── Logic ───────────────────────────────────────────────────────────
+const COMPONENT_RETURN_PATTERNS = ['JSX', 'React', 'Element', 'ReactNode'];
+/**
+ * Returns true when the entry's returnType indicates a React component
+ * (contains "JSX", "React", "Element", or "ReactNode").
+ */
+export function isComponent(entry) {
+    if (!entry.returnType)
+        return false;
+    return COMPONENT_RETURN_PATTERNS.some((pat) => entry.returnType.includes(pat));
+}
+/**
+ * Split glossary entries into components (JSX-returning) and functions (everything else).
+ */
+export function classifyGlossaryEntries(entries) {
+    const components = [];
+    const functions = [];
+    for (const entry of entries) {
+        if (isComponent(entry)) {
+            components.push(entry);
+        }
+        else {
+            functions.push(entry);
+        }
+    }
+    return { components, functions };
+}
+/**
+ * Given classified entries and coverage data, produce a structured audit result.
+ *
+ * @param components  - Glossary entries classified as components
+ * @param functions   - Glossary entries classified as functions
+ * @param scenarioCounts - Map of component_name → number of registered scenarios
+ * @param testFileExistence - Map of testFile path → whether the file exists on disk
+ */
+export function computeAudit({ components, functions, scenarioCounts, testFileExistence, }) {
+    const componentResults = components.map((c) => {
+        const count = scenarioCounts[c.name] || 0;
+        return {
+            name: c.name,
+            filePath: c.filePath,
+            scenarioCount: count,
+            status: count > 0 ? 'ok' : 'missing',
+        };
+    });
+    const functionResults = functions.map((f) => {
+        const exists = f.testFile
+            ? (testFileExistence[f.testFile] ?? false)
+            : false;
+        return {
+            name: f.name,
+            filePath: f.filePath,
+            testFile: f.testFile,
+            testFileExists: exists,
+            status: exists ? 'ok' : 'missing',
+        };
+    });
+    const componentsOk = componentResults.filter((c) => c.status === 'ok').length;
+    const componentsMissing = componentResults.length - componentsOk;
+    const functionsOk = functionResults.filter((f) => f.status === 'ok').length;
+    const functionsMissing = functionResults.length - functionsOk;
+    return {
+        components: componentResults,
+        functions: functionResults,
+        summary: {
+            totalComponents: componentResults.length,
+            componentsOk,
+            componentsMissing,
+            totalFunctions: functionResults.length,
+            functionsOk,
+            functionsMissing,
+            allPassing: componentsMissing === 0 && functionsMissing === 0,
+        },
+    };
+}
+//# sourceMappingURL=editorAudit.js.map

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

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

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

@@ -0,0 +1,98 @@
+/**
+ * Dev server process management utilities for the editor.
+ *
+ * Extracted from inline logic in api.editor-dev-server.ts.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Detect the package manager and start script for a project.
+ *
+ * Returns `{ command, args }` on success, or `{ error }` if the project
+ * lacks a runnable dev/start script or package.json.
+ */
+export function detectPackageManagerAndScript(projectRoot) {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return { error: 'No package.json found.' };
+    }
+    let command = 'npm';
+    let args = ['run', 'dev'];
+    try {
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        // Detect package manager from lockfile
+        if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml'))) {
+            command = 'pnpm';
+        }
+        else if (fs.existsSync(path.join(projectRoot, 'yarn.lock'))) {
+            command = 'yarn';
+        }
+        else if (fs.existsSync(path.join(projectRoot, 'bun.lockb'))) {
+            command = 'bun';
+        }
+        // Check for dev or start script
+        if (!pkg.scripts?.dev) {
+            if (pkg.scripts?.start) {
+                args = ['run', 'start'];
+            }
+            else {
+                return { error: 'No "dev" or "start" script found in package.json.' };
+            }
+        }
+    }
+    catch {
+        // Use defaults (npm run dev)
+    }
+    return { command, args };
+}
+/** URL patterns matched in dev server output to detect the running URL. */
+const URL_PATTERNS = [
+    /Local:\s+(https?:\/\/[^\s]+)/, // Vite
+    /Ready on\s+(https?:\/\/[^\s]+)/i, // Next.js
+    /started at\s+(https?:\/\/[^\s]+)/i, // Remix
+    /listening on\s+(https?:\/\/[^\s]+)/i, // Generic
+    /http:\/\/localhost:\d+/, // Bare URL
+];
+/**
+ * Extract a dev server URL from process output text.
+ * Matches common patterns from Vite, Next.js, Remix, and generic servers.
+ * Strips ANSI codes from the result.
+ * Returns null if no URL is found.
+ */
+export function extractDevServerUrl(text) {
+    for (const pattern of URL_PATTERNS) {
+        const match = text.match(pattern);
+        if (match) {
+            const url = match[1] || match[0];
+            return stripAnsiCodes(url).trim();
+        }
+    }
+    return null;
+}
+/**
+ * Remove ANSI escape sequences from text.
+ */
+export function stripAnsiCodes(text) {
+    return text.replace(/\x1b\[[0-9;]*m/g, '');
+}
+/**
+ * Determine what action to take when the dev server process exits.
+ *
+ * - Quick failure (< 10s) on first attempt → retry
+ * - Non-zero exit after retry or after long uptime → error
+ * - Zero or null exit → stopped normally
+ */
+export function determineProcessExitState(params) {
+    const { exitCode, uptime, retryCount } = params;
+    const quickFailure = uptime < 10000;
+    if (exitCode !== 0 && exitCode !== null && quickFailure && retryCount === 0) {
+        return { action: 'retry' };
+    }
+    else if (exitCode !== 0 && exitCode !== null) {
+        return { action: 'error' };
+    }
+    else {
+        return { action: 'stopped' };
+    }
+}
+//# sourceMappingURL=editorDevServer.js.map

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

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

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

@@ -0,0 +1,137 @@
+/**
+ * Journal data transformation utilities for the editor.
+ *
+ * Extracted from inline logic in EditorJournal.tsx, api.editor-journal-entry.ts,
+ * and api.editor-journal-update.ts.
+ */
+/**
+ * Group journal entries by date, reversing so newest entries come first.
+ * Returns a Map preserving insertion order (newest date first).
+ */
+export function groupEntriesByDate(entries) {
+    const grouped = new Map();
+    for (const entry of [...entries].reverse()) {
+        const existing = grouped.get(entry.date) || [];
+        existing.push(entry);
+        grouped.set(entry.date, existing);
+    }
+    return grouped;
+}
+/**
+ * Group scenario screenshots by component name.
+ * Names with " - " are split on the first dash; names without are grouped as "App".
+ * Sorted with "App" first, then alphabetical.
+ */
+export function groupScreenshotsByComponent(screenshots) {
+    const groups = new Map();
+    for (const ss of screenshots) {
+        const dashIdx = ss.name.indexOf(' - ');
+        const group = dashIdx !== -1 ? ss.name.slice(0, dashIdx) : 'App';
+        const existing = groups.get(group) || [];
+        existing.push(ss);
+        groups.set(group, existing);
+    }
+    return [...groups.entries()].sort(([a], [b]) => {
+        if (a === 'App')
+            return -1;
+        if (b === 'App')
+            return 1;
+        return a.localeCompare(b);
+    });
+}
+/**
+ * Generate a sanitized filename for a journal screenshot.
+ * Format: `{ISO timestamp with colons replaced}_{sanitized name}.png`
+ */
+export function generateJournalScreenshotFilename(name, timestamp) {
+    const safeName = name.replace(/[^a-zA-Z0-9_\-]/g, '_');
+    const isoTimestamp = timestamp
+        .toISOString()
+        .replace(/:/g, '-')
+        .replace(/\.\d+Z$/, '');
+    return `${isoTimestamp}_${safeName}.png`;
+}
+/**
+ * Build markdown lines array for a journal entry.
+ * Returns the joined string ready to append to a daily markdown file.
+ */
+export function buildJournalMarkdown(params) {
+    const { title, timeStr, type, description, allScenarioNames, screenshot, scenarioScreenshots, commitSha, commitMessage, } = params;
+    const mdLines = [
+        '',
+        '---',
+        '',
+        `### ${title}`,
+        `**Time:** ${timeStr}`,
+        `**Type:** ${type}`,
+    ];
+    if (allScenarioNames.length > 0) {
+        mdLines.push(`**Scenarios:** ${allScenarioNames.join(', ')}`);
+    }
+    mdLines.push('');
+    mdLines.push(description);
+    if (screenshot) {
+        mdLines.push('');
+        mdLines.push(`![${title}](${screenshot})`);
+    }
+    if (scenarioScreenshots.length > 0) {
+        mdLines.push('');
+        mdLines.push('**Scenario Screenshots:**');
+        for (const ss of scenarioScreenshots) {
+            mdLines.push('');
+            mdLines.push(`![${ss.name}](${ss.path})`);
+        }
+    }
+    if (commitSha && commitMessage) {
+        mdLines.push('');
+        mdLines.push(`**Commit:** \`${commitSha}\` — ${commitMessage}`);
+    }
+    mdLines.push('');
+    return mdLines.join('\n');
+}
+/**
+ * Find a journal entry's index by its time field.
+ * Returns -1 if not found.
+ */
+export function findJournalEntryByTime(entries, time) {
+    return entries.findIndex((e) => e.time === time);
+}
+/**
+ * Apply non-undefined updates to a journal entry.
+ * Returns the mutated entry (same reference).
+ */
+export function applyJournalEntryUpdates(entry, updates) {
+    if (updates.commitSha !== undefined) {
+        entry.commitSha = updates.commitSha;
+    }
+    if (updates.commitMessage !== undefined) {
+        entry.commitMessage = updates.commitMessage;
+    }
+    if (updates.description !== undefined) {
+        entry.description = updates.description;
+    }
+    if (updates.scenarios !== undefined) {
+        entry.scenarios = updates.scenarios;
+    }
+    if (updates.scenarioScreenshots !== undefined) {
+        entry.scenarioScreenshots = updates.scenarioScreenshots;
+    }
+    return entry;
+}
+/**
+ * Insert a commit line into markdown content before the next section separator (---).
+ * Finds the entry by its title marker (### Title), then inserts before the next `\n---\n`.
+ * Returns the modified content, or null if the title was not found.
+ */
+export function insertCommitIntoMarkdown(content, title, commitSha, commitMessage) {
+    const commitLine = `\n**Commit:** \`${commitSha}\` — ${commitMessage || 'no message'}\n`;
+    const titleMarker = `### ${title}`;
+    const titlePos = content.lastIndexOf(titleMarker);
+    if (titlePos === -1) {
+        return null;
+    }
+    const nextSection = content.indexOf('\n---\n', titlePos + 1);
+    const insertPos = nextSection !== -1 ? nextSection : content.length;
+    return content.slice(0, insertPos) + commitLine + content.slice(insertPos);
+}
+//# sourceMappingURL=editorJournal.js.map

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

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