npm - @openboard/start - Versions diffs - 1.0.20 → 1.0.22 - Mend

@openboard/start 1.0.20 → 1.0.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

package/packages/client/dist/index.html CHANGED Viewed

@@ -6,7 +6,7 @@
     <title>OpenBoard</title>
     <meta name="description" content="A local project management board — create boards, columns, and tickets." />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
-    <script type="module" crossorigin src="/assets/index-B5qL8ybM.js"></script>
+    <script type="module" crossorigin src="/assets/index-D6WEx7Lr.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-B5k_YB6Y.css">
   </head>
   <body>

package/packages/server/dist/agents/agent-queue.js CHANGED Viewed

File without changes

package/packages/server/dist/agents/agent-runner.js CHANGED Viewed

File without changes

package/packages/server/dist/agents/agent.interface.js CHANGED Viewed

File without changes

package/packages/server/dist/agents/codereview.agent.js CHANGED Viewed

@@ -1,27 +1,10 @@
-import { createOpencodeClient } from '@opencode-ai/sdk';
 import { ticketRepository } from '../repositories/ticket.repository.js';
+import { boardRepository } from '../repositories/board.repository.js';
 import { commentRepository } from '../repositories/comment.repository.js';
 import { setupOpencodeEventListener } from './opencode.events.js';
-import { execFile, exec } from 'child_process';
-import { promisify } from 'util';
-const execAsync = promisify(exec);
-const execFileAsync = promisify(execFile);
-// Helper function to execute commands robustly on Windows
-async function runCmd(cmd, args, cwd) {
-    console.log(`[codereview-agent] Running: ${cmd} ${args.join(' ')} in cwd: ${cwd}`);
-    try {
-        return await execFileAsync(cmd, args, { cwd });
-    }
-    catch (e) {
-        if (e.code === 'ENOENT') {
-            console.log(`[codereview-agent] ENOENT finding binary. Trying fallback exec...`);
-            return await execAsync(`${cmd} ${args.join(' ')}`, { cwd });
-        }
-        throw e;
-    }
-}
+import { createBoardScopedClient } from '../utils/opencode.js';
+import { runCmd, normalizePathForOS } from '../utils/os.js';
 const opencodePort = process.env.OPENCODE_PORT || 4096;
-const opencodeClient = createOpencodeClient({ baseUrl: `http://127.0.0.1:${opencodePort}` });
 const activeSessions = {};
 export class CodeReviewAgent {
     async run(ticket, config) {
@@ -46,6 +29,9 @@ export class CodeReviewAgent {
             });
             return;
         }
+        // Create a board-scoped Opencode client for this ticket
+        const board = boardRepository.findById(ticket.board_id);
+        const opencodeClient = createBoardScopedClient(board?.path);
         ticketRepository.updateAgentSession(ticket.id, {
             column_id: ticket.column_id,
             agent_type: 'code_review',
@@ -62,7 +48,7 @@ export class CodeReviewAgent {
             delete activeSessions[ticket.id];
         }
         // Resolve workspace path — code review runs in the main workspace (no new worktree needed).
-        let workspacePath = process.cwd();
+        let workspacePath = normalizePathForOS(board?.path || process.cwd());
         try {
             const session = await opencodeClient.session.create({
                 body: { title: `Code Review for Ticket: ${ticket.title}` },
@@ -91,7 +77,7 @@ export class CodeReviewAgent {
             // Fetch GH token so the LLM environment can execute `gh` commands
             let ghTokenEnv = '';
             try {
-                const { stdout: ghToken } = await runCmd('gh', ['auth', 'token'], workspacePath);
+                const { stdout: ghToken } = await runCmd('gh', ['auth', 'token'], workspacePath, 'codereview-agent');
                 if (ghToken.trim()) {
                     ghTokenEnv = `export GH_TOKEN=${ghToken.trim()}; `;
                 }

package/packages/server/dist/agents/dummy.agent.js CHANGED Viewed

File without changes

package/packages/server/dist/agents/opencode.agent.js CHANGED Viewed

@@ -1,54 +1,12 @@
-import { createOpencodeClient } from '@opencode-ai/sdk';
 import { ticketRepository } from '../repositories/ticket.repository.js';
+import { boardRepository } from '../repositories/board.repository.js';
 import { commentRepository } from '../repositories/comment.repository.js';
 import { setupOpencodeEventListener } from './opencode.events.js';
-import { execFile, exec } from 'child_process';
-import { promisify } from 'util';
-import os from 'os';
+import { createBoardScopedClient } from '../utils/opencode.js';
+import { runCmd, normalizePathForOS } from '../utils/os.js';
 import path from 'path';
 import fs from 'fs';
-const execAsync = promisify(exec);
-const execFileAsync = promisify(execFile);
-// Cache the gh token so we only fetch it once per server process
-let cachedGhToken = null;
-async function getGhToken(cwd) {
-    if (cachedGhToken !== null)
-        return cachedGhToken;
-    try {
-        const { stdout } = await execFileAsync('gh', ['auth', 'token'], { cwd });
-        cachedGhToken = stdout.trim() || null;
-    }
-    catch {
-        cachedGhToken = null;
-    }
-    return cachedGhToken;
-}
-// Helper function to execute commands robustly on Windows.
-// Automatically injects GH_TOKEN for any `gh` subcommand.
-async function runCmd(cmd, args, cwd) {
-    console.log(`[opencode-agent] Running: ${cmd} ${args.join(' ')} in cwd: ${cwd}`);
-    let extraEnv = {};
-    if (cmd === 'gh') {
-        const token = await getGhToken(cwd);
-        if (token)
-            extraEnv['GH_TOKEN'] = token;
-    }
-    const env = Object.keys(extraEnv).length > 0 ? { ...process.env, ...extraEnv } : undefined;
-    try {
-        return await execFileAsync(cmd, args, { cwd, ...(env && { env }) });
-    }
-    catch (e) {
-        if (e.code === 'ENOENT') {
-            console.log(`[opencode-agent] ENOENT finding binary. Trying fallback exec...`);
-            const envPrefix = extraEnv['GH_TOKEN'] ? (process.platform === 'win32' ? `set GH_TOKEN=${extraEnv['GH_TOKEN']}&& ` : `GH_TOKEN=${extraEnv['GH_TOKEN']} `) : '';
-            return await execAsync(`${envPrefix}${cmd} ${args.join(' ')}`, { cwd });
-        }
-        throw e;
-    }
-}
-// Central OpenCode client connecting to the user's running OpenCode server
 const opencodePort = process.env.OPENCODE_PORT || 4096;
-const opencodeClient = createOpencodeClient({ baseUrl: `http://127.0.0.1:${opencodePort}` });
 // Track active session IDs by ticket ID to prevent/cancel overlaps
 const activeSessions = {};
 export class OpencodeAgent {
@@ -61,20 +19,12 @@ export class OpencodeAgent {
             status: 'processing',
             port: Number(opencodePort)
         });
+        // Create a board-scoped Opencode client for this ticket
+        const board = boardRepository.findById(ticket.board_id);
+        const opencodeClient = createBoardScopedClient(board?.path);
         // Prevent duplicate runs blocking new requests: replace the old session.
-        if (activeSessions[ticket.id]) {
-            console.log(`[opencode-agent] Session already running for ticket ${ticket.id}. Aborting old session to start a fresh one.`);
-            try {
-                // Ignore typescript error if abort typing differs slightly in SDK version
-                await opencodeClient.session.abort({ path: { id: activeSessions[ticket.id] } });
-            }
-            catch (e) {
-                console.error(`[opencode-agent] Error aborting previous session:`, e);
-            }
-            delete activeSessions[ticket.id];
-        }
-        // 1. Find Worktree (Use the directory where openboard was started)
-        let originalWorkspacePath = process.cwd();
+        // 1. Find Worktree (Use the board's designated path)
+        let originalWorkspacePath = normalizePathForOS(board?.path || process.cwd());
         // 2. Set up Worktree
         // If this ticket already has a PR, we reuse the existing branch and worktree.
         // Worktree paths are derived from branch name so they are stable across re-runs.
@@ -87,7 +37,7 @@ export class OpencodeAgent {
             // Ticket was already worked on — reuse the existing branch & worktree
             console.log(`[opencode-agent] Found existing PR ${existingPrUrl}. Fetching branch name.`);
             try {
-                const { stdout: prDataStr } = await runCmd('gh', ['pr', 'view', existingPrUrl, '--json', 'headRefName'], originalWorkspacePath);
+                const { stdout: prDataStr } = await runCmd('gh', ['pr', 'view', existingPrUrl, '--json', 'headRefName'], originalWorkspacePath, 'opencode-agent');
                 const prData = JSON.parse(prDataStr);
                 if (!prData.headRefName)
                     throw new Error('Could not parse headRefName from PR');
@@ -97,13 +47,13 @@ export class OpencodeAgent {
                 console.warn(`[opencode-agent] Could not read PR branch name, will create a new branch.`, ghErr.message);
                 branchName = `ticket-${ticket.id}-${Date.now()}`;
             }
-            worktreePath = path.join(os.tmpdir(), 'openboard-worktrees', branchName);
         }
         else {
             // Fresh ticket — create a new branch and worktree
             branchName = `ticket-${ticket.id}-${Date.now()}`;
-            worktreePath = path.join(os.tmpdir(), 'openboard-worktrees', branchName);
         }
+        // Use a local folder within the board path for worktrees
+        worktreePath = normalizePathForOS(path.join(originalWorkspacePath, '.openboard-worktrees', branchName));
         try {
             if (fs.existsSync(worktreePath)) {
                 // Worktree directory already on disk — just reuse it, no git command needed
@@ -112,12 +62,27 @@ export class OpencodeAgent {
             else if (existingPrUrl) {
                 // Branch exists but worktree was cleaned up — check out the branch into the path
                 console.log(`[opencode-agent] Checking out existing branch ${branchName} into new worktree at ${worktreePath}`);
-                await runCmd('git', ['worktree', 'add', worktreePath, branchName], originalWorkspacePath);
+                await runCmd('git', ['worktree', 'add', worktreePath, branchName], originalWorkspacePath, 'opencode-agent');
             }
             else {
-                // Completely new — create branch and worktree together
-                console.log(`[opencode-agent] Creating new worktree at ${worktreePath} on branch ${branchName}`);
-                await runCmd('git', ['worktree', 'add', '-b', branchName, worktreePath], originalWorkspacePath);
+                // Completely new — check if the repo is empty (no commits yet)
+                let isRepoEmpty = false;
+                try {
+                    await runCmd('git', ['rev-parse', 'HEAD'], originalWorkspacePath, 'opencode-agent');
+                }
+                catch (e) {
+                    // if rev-parse HEAD fails, it usually means the repo has no commits
+                    isRepoEmpty = true;
+                    console.log(`[opencode-agent] Repository appears to be empty. Using --orphan for worktree.`);
+                }
+                if (isRepoEmpty) {
+                    console.log(`[opencode-agent] Creating new orphan worktree at ${worktreePath} on branch ${branchName}`);
+                    await runCmd('git', ['worktree', 'add', '--orphan', '-b', branchName, worktreePath], originalWorkspacePath, 'opencode-agent');
+                }
+                else {
+                    console.log(`[opencode-agent] Creating new worktree at ${worktreePath} on branch ${branchName}`);
+                    await runCmd('git', ['worktree', 'add', '-b', branchName, worktreePath], originalWorkspacePath, 'opencode-agent');
+                }
             }
         }
         catch (e) {
@@ -171,7 +136,7 @@ export class OpencodeAgent {
             // Fetch GH token so the LLM environment can execute `gh` commands
             let ghTokenEnv = '';
             try {
-                const { stdout: ghToken } = await runCmd('gh', ['auth', 'token'], originalWorkspacePath);
+                const { stdout: ghToken } = await runCmd('gh', ['auth', 'token'], originalWorkspacePath, 'opencode-agent');
                 if (ghToken.trim()) {
                     ghTokenEnv = `export GH_TOKEN=${ghToken.trim()}; `;
                 }

package/packages/server/dist/agents/opencode.events.js CHANGED Viewed

@@ -1,53 +1,11 @@
 import { ticketRepository } from '../repositories/ticket.repository.js';
 import { commentRepository } from '../repositories/comment.repository.js';
 import { agentQueue } from './agent-queue.js';
-import { execFile, exec } from 'child_process';
-import { promisify } from 'util';
-import fs from 'fs';
-const execAsync = promisify(exec);
-const execFileAsync = promisify(execFile);
-// Cache the gh token so we only fetch it once per server process
-let cachedGhToken = null;
-async function getGhToken(cwd) {
-    if (cachedGhToken !== null)
-        return cachedGhToken;
-    try {
-        const { stdout } = await execFileAsync('gh', ['auth', 'token'], { cwd, shell: true });
-        cachedGhToken = stdout.trim() || null;
-    }
-    catch {
-        cachedGhToken = null;
-    }
-    return cachedGhToken;
-}
-// Helper function to execute commands robustly on Windows.
-// Automatically injects GH_TOKEN for any `gh` subcommand.
-async function runCmd(cmd, args, cwd) {
-    console.log(`[opencode-events] Running: ${cmd} ${args.join(' ')} in cwd: ${cwd}`);
-    // Safety check for CWD to avoid obscure ENOENT shell errors
-    if (!fs.existsSync(cwd)) {
-        throw new Error(`Directory does not exist: ${cwd}`);
-    }
-    let extraEnv = {};
-    if (cmd === 'gh') {
-        const token = await getGhToken(cwd);
-        if (token)
-            extraEnv['GH_TOKEN'] = token;
-    }
-    const env = Object.keys(extraEnv).length > 0 ? { ...process.env, ...extraEnv } : undefined;
-    try {
-        return await execFileAsync(cmd, args, { cwd, shell: true, ...(env && { env }) });
-    }
-    catch (e) {
-        if (e.code === 'ENOENT') {
-            console.log(`[opencode-events] ENOENT with shell: true. Trying fallback exec...`);
-            const envPrefix = extraEnv['GH_TOKEN'] ? `GH_TOKEN=${extraEnv['GH_TOKEN']} ` : '';
-            return await execAsync(`${envPrefix}${cmd} ${args.join(' ')}`, { cwd });
-        }
-        throw e;
-    }
-}
-export async function setupOpencodeEventListener(events, opencodeClient, sessionID, ticket, agentUrl, config, activeSessions, worktreePath, originalWorkspacePath, branchName, agentType = 'opencode') {
+import { runCmd, getGhToken } from '../utils/os.js';
+import { createBoardScopedClient } from '../utils/opencode.js';
+export async function setupOpencodeEventListener(events, _unused, // kept for signature compatibility if called elsewhere
+sessionID, ticket, agentUrl, config, activeSessions, worktreePath, originalWorkspacePath, branchName, agentType = 'opencode') {
+    const opencodeClient = createBoardScopedClient(originalWorkspacePath);
     const processedMessages = new Set();
     const activeParts = new Map();
     let rawSessionCost = 0;
@@ -200,7 +158,7 @@ export async function setupOpencodeEventListener(events, opencodeClient, session
                             const prUrlSession = [...(latestTicket.agent_sessions || [])].reverse().find(s => s.pr_url);
                             const prUrl = prUrlSession?.pr_url;
                             if (prUrl) {
-                                const { stdout: prStatus } = await runCmd('gh', ['pr', 'view', prUrl, '--json', 'comments'], worktreePath);
+                                const { stdout: prStatus } = await runCmd('gh', ['pr', 'view', prUrl, '--json', 'comments'], worktreePath, 'opencode-events');
                                 const comments = JSON.parse(prStatus).comments;
                                 // Find the latest comment that contains a decision
                                 let reviewDecision = 'NONE';
@@ -275,11 +233,11 @@ export async function setupOpencodeEventListener(events, opencodeClient, session
                         // Commit, push, and create PR before moving ticket
                         try {
                             console.log(`[opencode-agent] Checking for changes in worktree ${worktreePath}`);
-                            const { stdout: statusOut } = await runCmd('git', ['status', '--porcelain'], worktreePath);
+                            const { stdout: statusOut } = await runCmd('git', ['status', '--porcelain'], worktreePath, 'opencode-events');
                             if (statusOut.trim()) {
                                 console.log(`[opencode-agent] Changes found for ticket ${ticket.id}. Committing and pushing.`);
-                                await runCmd('git', ['add', '.'], worktreePath);
-                                await runCmd('git', ['commit', '-m', `"${ticket.title.replace(/"/g, '\\"')}"`], worktreePath);
+                                await runCmd('git', ['add', '.'], worktreePath, 'opencode-events');
+                                await runCmd('git', ['commit', '-m', `"${ticket.title.replace(/"/g, '\\"')}"`], worktreePath, 'opencode-events');
                                 // Inject GH_TOKEN into remote URL for git push authentication
                                 const token = await getGhToken(worktreePath);
                                 if (token) {
@@ -288,14 +246,14 @@ export async function setupOpencodeEventListener(events, opencodeClient, session
                                         const remoteUrl = remoteUrlOut.trim();
                                         if (remoteUrl.startsWith('https://github.com/')) {
                                             const authedUrl = remoteUrl.replace('https://github.com/', `https://x-access-token:${token}@github.com/`);
-                                            await runCmd('git', ['remote', 'set-url', 'origin', authedUrl], worktreePath);
+                                            await runCmd('git', ['remote', 'set-url', 'origin', authedUrl], worktreePath, 'opencode-events');
                                         }
                                     }
                                     catch (urlErr) {
                                         console.warn(`[opencode-agent] Could not set authenticated remote URL:`, urlErr);
                                     }
                                 }
-                                await runCmd('git', ['push', '-u', 'origin', branchName], worktreePath);
+                                await runCmd('git', ['push', '-u', 'origin', branchName], worktreePath, 'opencode-events');
                                 // Check if a PR already exists for this ticket (fetch fresh from DB)
                                 const freshTicket = ticketRepository.findById(ticket.id) || ticket;
                                 const existingPrUrlSession = [...(freshTicket.agent_sessions || [])].reverse().find(s => s.pr_url);
@@ -304,7 +262,7 @@ export async function setupOpencodeEventListener(events, opencodeClient, session
                                     updateSessionComment(`🚀 **Pull Request Updated**\n\nThe agent has updated the existing PR:\n${prUrl}${rawSessionCost > 0 ? `\n\n**Total Cost:** $${rawSessionCost.toFixed(4)}` : ''}`, 'pr');
                                 }
                                 else {
-                                    const { stdout: prOut } = await runCmd('gh', ['pr', 'create', '--title', `"${ticket.title.replace(/"/g, '\\"')}"`, '--body', `"Automated PR from OpenCode Agent for ticket #${ticket.id}"`], worktreePath);
+                                    const { stdout: prOut } = await runCmd('gh', ['pr', 'create', '--title', `"${ticket.title.replace(/"/g, '\\"')}"`, '--body', `"Automated PR from OpenCode Agent for ticket #${ticket.id}"`], worktreePath, 'opencode-events');
                                     prUrl = prOut.trim();
                                     updateSessionComment(`🚀 **Pull Request Created**\n\nThe agent has proposed the following changes in a PR. Check it out:\n${prUrl}${rawSessionCost > 0 ? `\n\n**Total Cost:** $${rawSessionCost.toFixed(4)}` : ''}`, 'pr');
                                 }

package/packages/server/dist/db/database.js CHANGED Viewed

File without changes

package/packages/server/dist/gh-worker.js CHANGED Viewed

File without changes

package/packages/server/dist/index.js CHANGED Viewed

File without changes

package/packages/server/dist/repositories/board.repository.js CHANGED Viewed

@@ -23,11 +23,22 @@ export const boardRepository = {
             workspaces
         };
     },
-    create(name, workspaces = []) {
+    findByPath(path) {
+        const db = getDb();
+        const board = db.prepare('SELECT * FROM boards WHERE path = ?').get(path);
+        if (!board)
+            return undefined;
+        const workspaces = db.prepare('SELECT * FROM board_workspaces WHERE board_id = ?').all(board.id);
+        return {
+            ...board,
+            workspaces
+        };
+    },
+    create(name, path, workspaces = []) {
         const boardId = randomUUID();
         const db = getDb();
         db.transaction(() => {
-            db.prepare('INSERT INTO boards (id, name) VALUES (?, ?)').run(boardId, name);
+            db.prepare('INSERT INTO boards (id, name, path) VALUES (?, ?, ?)').run(boardId, name, path || null);
             for (const ws of workspaces) {
                 db.prepare('INSERT INTO board_workspaces (id, board_id, type, path) VALUES (?, ?, ?, ?)')
                     .run(randomUUID(), boardId, ws.type, ws.path);
@@ -35,10 +46,15 @@ export const boardRepository = {
         })();
         return this.findById(boardId);
     },
-    update(id, name, workspaces) {
+    update(id, name, path, workspaces) {
         const db = getDb();
         db.transaction(() => {
-            db.prepare('UPDATE boards SET name = ? WHERE id = ?').run(name, id);
+            if (path !== undefined) {
+                db.prepare('UPDATE boards SET name = ?, path = ? WHERE id = ?').run(name, path, id);
+            }
+            else {
+                db.prepare('UPDATE boards SET name = ? WHERE id = ?').run(name, id);
+            }
             if (workspaces) {
                 // Simple sync: delete all and re-create
                 db.prepare('DELETE FROM board_workspaces WHERE board_id = ?').run(id);

package/packages/server/dist/repositories/column-config.repository.js CHANGED Viewed

File without changes

package/packages/server/dist/repositories/column.repository.js CHANGED Viewed

File without changes

package/packages/server/dist/repositories/comment.repository.js CHANGED Viewed

File without changes

package/packages/server/dist/repositories/ticket.repository.js CHANGED Viewed

File without changes

package/packages/server/dist/routes/boards.router.js CHANGED Viewed

@@ -6,18 +6,18 @@ router.get('/', (_req, res) => {
     res.json(boardRepository.findAll());
 });
 router.post('/', (req, res) => {
-    const { name, workspaces } = req.body;
+    const { name, path, workspaces } = req.body;
     if (!name?.trim()) {
         res.status(400).json({ error: 'Name is required' });
         return;
     }
-    const board = boardRepository.create(name.trim(), workspaces);
+    const board = boardRepository.create(name.trim(), path, workspaces);
     sseManager.emitGlobal('board:created', board);
     res.status(201).json(board);
 });
 router.patch('/:id', (req, res) => {
-    const { name, workspaces } = req.body;
-    const board = boardRepository.update(req.params.id, name?.trim(), workspaces);
+    const { name, path, workspaces } = req.body;
+    const board = boardRepository.update(req.params.id, name?.trim(), path, workspaces);
     if (!board) {
         res.status(404).json({ error: 'Board not found' });
         return;

package/packages/server/dist/routes/column-config.router.js CHANGED Viewed

File without changes

package/packages/server/dist/routes/columns.router.js CHANGED Viewed

File without changes

package/packages/server/dist/routes/tickets.router.js CHANGED Viewed

File without changes

package/packages/server/dist/sse.js CHANGED Viewed

File without changes

package/packages/server/dist/types.js CHANGED Viewed

File without changes

package/packages/server/dist/utils/opencode.js ADDED Viewed

@@ -0,0 +1,11 @@
+import { createOpencodeClient } from '@opencode-ai/sdk';
+const opencodePort = process.env.OPENCODE_PORT || 4096;
+/**
+ * Creates an Opencode client instance scoped to a specific board directory.
+ */
+export function createBoardScopedClient(boardPath) {
+    return createOpencodeClient({
+        baseUrl: `http://127.0.0.1:${opencodePort}`,
+        directory: boardPath
+    });
+}

package/packages/server/dist/utils/os.js ADDED Viewed

@@ -0,0 +1,73 @@
+import { execFile, exec } from 'child_process';
+import { promisify } from 'util';
+import fs from 'fs';
+const execFileAsync = promisify(execFile);
+const execAsync = promisify(exec);
+/**
+ * Normalizes paths for mixed environments (e.g. WSL-style paths in a Windows process).
+ */
+export function normalizePathForOS(p) {
+    if (!p)
+        return p;
+    let normalized = p;
+    if (process.platform === 'win32') {
+        // Convert all forward slashes to backslashes first for consistency on Windows
+        normalized = normalized.replace(/\//g, '\\');
+        // Match \mnt\c\... or /mnt/c/... (case insensitive)
+        const mntMatch = normalized.match(/^[\\\/]mnt[\\\/]([a-z])([\\\/]|$)/i);
+        if (mntMatch) {
+            const drive = mntMatch[1].toUpperCase();
+            // Remove the /mnt/c/ prefix
+            const rest = normalized.substring(mntMatch[0].length);
+            normalized = `${drive}:\\${rest}`;
+        }
+    }
+    else {
+        normalized = normalized.replace(/\\/g, '/');
+    }
+    return normalized;
+}
+// Cache the gh token so we only fetch it once per server process
+let cachedGhToken = null;
+export async function getGhToken(cwd) {
+    if (cachedGhToken !== null)
+        return cachedGhToken;
+    try {
+        const { stdout } = await execFileAsync('gh', ['auth', 'token'], { cwd: normalizePathForOS(cwd), shell: true });
+        cachedGhToken = stdout.trim() || null;
+    }
+    catch {
+        cachedGhToken = null;
+    }
+    return cachedGhToken;
+}
+/**
+ * Helper function to execute commands robustly across OS.
+ * Automatically injects GH_TOKEN for any `gh` subcommand and handles shell execution on Windows.
+ */
+export async function runCmd(cmd, args, cwd, prefix = '') {
+    const normalizedCwd = normalizePathForOS(cwd);
+    console.log(`[${prefix || 'os-util'}] Running: ${cmd} ${args.join(' ')} in cwd: ${normalizedCwd}`);
+    // Safety check for CWD
+    if (!fs.existsSync(normalizedCwd)) {
+        throw new Error(`Directory does not exist: ${normalizedCwd}`);
+    }
+    let extraEnv = {};
+    if (cmd === 'gh') {
+        const token = await getGhToken(normalizedCwd);
+        if (token)
+            extraEnv['GH_TOKEN'] = token;
+    }
+    const env = { ...process.env, ...extraEnv };
+    try {
+        // use shell: true to help find binaries in PATH on Windows
+        return await execFileAsync(cmd, args, { cwd: normalizedCwd, env, shell: true });
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            const envPrefix = extraEnv['GH_TOKEN'] ? (process.platform === 'win32' ? `set GH_TOKEN=${extraEnv['GH_TOKEN']}&& ` : `GH_TOKEN=${extraEnv['GH_TOKEN']} `) : '';
+            return await execAsync(`${envPrefix}${cmd} ${args.join(' ')}`, { cwd: normalizedCwd });
+        }
+        throw e;
+    }
+}