@telora/daemon 0.12.33

package/dist/qa-orchestrator.js

@@ -0,0 +1,349 @@
+/**
+ * QA environment orchestration.
+ *
+ * Called by the daemon poll loop to process pending QA requests.
+ * Coordinates provisioning and teardown using the lower-level modules.
+ */
+import { getQaRequests, updateQaStatus, getDeactivatedQaStrategies, getProductQaRequests, updateProductQaStatus } from './supabase.js';
+import { symlinkEnvFiles, createQaWorktree, removeQaWorktree } from './qa-provisioner.js';
+import { getStrategyWorktree as getStrategyWorktreeImpl } from './strategy-worktree-state.js';
+import { allocatePort, buildQaUrl } from './qa-port-allocator.js';
+import { startQaDevServer, stopQaDevServer } from './qa-dev-server.js';
+import { getQaEnvironment, setQaEnvironment, removeQaEnvironment, hasActiveQaEnvironment, getProductQaEnvironment, setProductQaEnvironment, removeProductQaEnvironment, hasActiveProductQaEnvironment, } from './qa-state.js';
+/** Default deps wired to real implementations. */
+const defaultDeps = {
+    getQaRequests,
+    getDeactivatedQaStrategies,
+    updateQaStatus,
+    getStrategyWorktree: getStrategyWorktreeImpl,
+    symlinkEnvFiles,
+    allocatePort,
+    buildQaUrl,
+    startQaDevServer,
+    stopQaDevServer,
+    getQaEnvironment,
+    setQaEnvironment,
+    removeQaEnvironment,
+    hasActiveQaEnvironment,
+};
+/**
+ * Check for and process pending QA requests.
+ * Called each poll cycle from listener.ts.
+ */
+export async function checkQaRequests(config, deps = defaultDeps) {
+    let requests;
+    try {
+        requests = await deps.getQaRequests(config.productId);
+    }
+    catch (err) {
+        console.warn(`[qa] Failed to fetch QA requests: ${err.message}`);
+        return;
+    }
+    if (requests.length === 0)
+        return;
+    for (const req of requests) {
+        try {
+            if (req.qa_status === 'requested') {
+                await handleQaProvision(config, req, deps);
+            }
+            else if (req.qa_status === 'stop_requested') {
+                await handleQaTeardown(config, req, deps);
+            }
+        }
+        catch (err) {
+            console.error(`[qa] Error processing QA request for strategy ${req.strategy_name}: ${err.message}`);
+            // Update DB to failed state
+            try {
+                await deps.updateQaStatus(req.strategy_id, {
+                    qaStatus: 'failed',
+                    qaError: err.message,
+                });
+            }
+            catch (updateErr) {
+                console.warn(`[qa] Failed to update error state: ${updateErr.message}`);
+            }
+        }
+    }
+}
+/**
+ * Provision a QA environment for a strategy.
+ *
+ * 1. If already active (refresh case), tear down first.
+ * 2. Set DB status to 'provisioning'.
+ * 3. Allocate a port and create a worktree.
+ * 4. Install deps and start the dev server.
+ * 5. Update in-memory state and DB to 'ready'.
+ */
+async function handleQaProvision(config, req, deps) {
+    const { strategy_id: strategyId, strategy_name: strategyName } = req;
+    // If already active (refresh), tear down first
+    if (deps.hasActiveQaEnvironment(strategyId)) {
+        console.log(`[qa] Refreshing QA environment for "${strategyName}"`);
+        await handleQaTeardown(config, req, deps);
+    }
+    // 1. Set provisioning in DB
+    await deps.updateQaStatus(strategyId, { qaStatus: 'provisioning' });
+    // 2. Allocate port
+    const port = await deps.allocatePort(config);
+    const url = deps.buildQaUrl(config, port);
+    // 3. Look up the persistent strategy worktree (QA runs inside it)
+    const worktreeInfo = deps.getStrategyWorktree(strategyId);
+    if (!worktreeInfo) {
+        throw new Error(`No persistent worktree found for strategy "${strategyName}" (${strategyId})`);
+    }
+    const worktreePath = worktreeInfo.worktreePath;
+    deps.symlinkEnvFiles(config.repoPath, worktreePath);
+    // 4. Track in memory (status provisioning, dev server not yet started)
+    const state = {
+        strategyId,
+        strategyName,
+        worktreePath,
+        pid: null,
+        port,
+        url,
+        status: 'provisioning',
+        createdAt: new Date(),
+        lastError: null,
+    };
+    deps.setQaEnvironment(strategyId, state);
+    // 5. Start dev server (npm install + npm run dev)
+    const result = deps.startQaDevServer({
+        config,
+        strategyId,
+        worktreePath,
+        port,
+        onUnexpectedExit: (error) => {
+            console.error(`[qa] Dev server crashed for "${strategyName}": ${error}`);
+            deps.setQaEnvironment(strategyId, { ...state, pid: null, status: 'failed', lastError: error });
+            deps.updateQaStatus(strategyId, { qaStatus: 'failed', qaError: error }).catch((e) => {
+                console.warn(`[qa] Failed to report dev server crash: ${e.message}`);
+            });
+        },
+    });
+    // 6. Update state with PID and mark ready
+    const readyState = {
+        ...state,
+        pid: result.pid,
+        status: 'ready',
+    };
+    deps.setQaEnvironment(strategyId, readyState);
+    // 7. Update DB to ready
+    await deps.updateQaStatus(strategyId, {
+        qaStatus: 'ready',
+        qaUrl: url,
+        qaPort: port,
+        qaWorktreePath: worktreePath,
+        qaReadyAt: new Date().toISOString(),
+    });
+    console.log(`[qa] QA environment ready for "${strategyName}" at ${url}`);
+}
+/**
+ * Tear down a QA environment for a strategy.
+ *
+ * 1. Kill the dev server process if running.
+ * 2. Remove the worktree.
+ * 3. Clear in-memory and DB state.
+ */
+async function handleQaTeardown(config, req, deps) {
+    const { strategy_id: strategyId, strategy_name: strategyName } = req;
+    console.log(`[qa] Tearing down QA environment for "${strategyName}"`);
+    // Kill dev server if running
+    const state = deps.getQaEnvironment(strategyId);
+    if (state?.pid) {
+        await deps.stopQaDevServer(state.pid);
+    }
+    // Worktree is strategy-owned -- do NOT remove here.
+    // Removal happens via coordinated teardown when the strategy is deactivated.
+    // Clear in-memory state
+    deps.removeQaEnvironment(strategyId);
+    // Clear DB state
+    await deps.updateQaStatus(strategyId, {
+        qaStatus: null,
+        qaUrl: null,
+        qaPort: null,
+        qaWorktreePath: null,
+        qaReadyAt: null,
+        qaError: null,
+    });
+    console.log(`[qa] QA environment torn down for "${strategyName}"`);
+}
+/**
+ * Check for strategies that have been deactivated while QA was running.
+ * Tears down any QA environment whose strategy is no longer in 'active' status.
+ * Called each poll cycle from listener.ts.
+ */
+export async function checkQaForDeactivatedStrategies(config, deps = defaultDeps) {
+    let deactivated;
+    try {
+        deactivated = await deps.getDeactivatedQaStrategies(config.productId);
+    }
+    catch (err) {
+        console.warn(`[qa] Failed to fetch deactivated QA strategies: ${err.message}`);
+        return;
+    }
+    if (deactivated.length === 0)
+        return;
+    for (const strategy of deactivated) {
+        console.log(`[qa] Strategy "${strategy.strategy_name}" is ${strategy.strategy_status} but has QA state "${strategy.qa_status}" -- tearing down`);
+        try {
+            await handleQaTeardown(config, {
+                strategy_id: strategy.strategy_id,
+                strategy_name: strategy.strategy_name,
+                qa_status: strategy.qa_status,
+                product_id: strategy.product_id,
+            }, deps);
+        }
+        catch (err) {
+            console.error(`[qa] Error tearing down QA for deactivated strategy "${strategy.strategy_name}": ${err.message}`);
+        }
+    }
+}
+/** Default deps wired to real implementations. */
+const defaultProductDeps = {
+    getProductQaRequests,
+    updateProductQaStatus,
+    createQaWorktree,
+    removeQaWorktree,
+    symlinkEnvFiles,
+    allocatePort,
+    buildQaUrl,
+    startQaDevServer,
+    stopQaDevServer,
+    getProductQaEnvironment,
+    setProductQaEnvironment,
+    removeProductQaEnvironment,
+    hasActiveProductQaEnvironment,
+};
+/**
+ * Check for and process pending product QA requests.
+ * Called each poll cycle from listener.ts.
+ */
+export async function checkProductQaRequests(config, deps = defaultProductDeps) {
+    let requests;
+    try {
+        requests = await deps.getProductQaRequests(config.productId);
+    }
+    catch (err) {
+        console.warn(`[product-qa] Failed to fetch product QA requests: ${err.message}`);
+        return;
+    }
+    if (requests.length === 0)
+        return;
+    for (const req of requests) {
+        try {
+            if (req.qa_status === 'requested') {
+                await handleProductQaProvision(config, req, deps);
+            }
+            else if (req.qa_status === 'stop_requested') {
+                await handleProductQaTeardown(config, req, deps);
+            }
+        }
+        catch (err) {
+            console.error(`[product-qa] Error processing product QA request for "${req.product_name}": ${err.message}`);
+            try {
+                await deps.updateProductQaStatus(req.product_id, {
+                    qaStatus: 'failed',
+                    qaError: err.message,
+                });
+            }
+            catch (updateErr) {
+                console.warn(`[product-qa] Failed to update error state: ${updateErr.message}`);
+            }
+        }
+    }
+}
+/**
+ * Provision a product-level QA environment.
+ *
+ * Creates a QA worktree on the integration branch so the dev server
+ * reflects the combined result of all merged strategy work.
+ */
+async function handleProductQaProvision(config, req, deps) {
+    const { product_id: productId, product_name: productName } = req;
+    // If already active (refresh), tear down first
+    if (deps.hasActiveProductQaEnvironment(productId)) {
+        console.log(`[product-qa] Refreshing QA environment for product "${productName}"`);
+        await handleProductQaTeardown(config, req, deps);
+    }
+    // 1. Set provisioning in DB
+    await deps.updateProductQaStatus(productId, { qaStatus: 'provisioning' });
+    // 2. Allocate port
+    const port = await deps.allocatePort(config);
+    const url = deps.buildQaUrl(config, port);
+    // 3. Create QA worktree on integration branch
+    const worktreePath = deps.createQaWorktree(config, config.integrationBranch, `product-${productId}`);
+    deps.symlinkEnvFiles(config.repoPath, worktreePath);
+    // 4. Track in memory
+    const state = {
+        productId,
+        productName,
+        worktreePath,
+        pid: null,
+        port,
+        url,
+        status: 'provisioning',
+        createdAt: new Date(),
+        lastError: null,
+    };
+    deps.setProductQaEnvironment(productId, state);
+    // 5. Start dev server in integration worktree
+    const result = deps.startQaDevServer({
+        config,
+        strategyId: `product-${productId}`,
+        worktreePath,
+        port,
+        onUnexpectedExit: (error) => {
+            console.error(`[product-qa] Dev server crashed for product "${productName}": ${error}`);
+            deps.setProductQaEnvironment(productId, { ...state, pid: null, status: 'failed', lastError: error });
+            deps.updateProductQaStatus(productId, { qaStatus: 'failed', qaError: error }).catch((e) => {
+                console.warn(`[product-qa] Failed to report dev server crash: ${e.message}`);
+            });
+        },
+    });
+    // 6. Update state with PID and mark ready
+    const readyState = {
+        ...state,
+        pid: result.pid,
+        status: 'ready',
+    };
+    deps.setProductQaEnvironment(productId, readyState);
+    // 7. Update DB to ready
+    await deps.updateProductQaStatus(productId, {
+        qaStatus: 'ready',
+        qaUrl: url,
+        qaPort: port,
+        qaWorktreePath: worktreePath,
+        qaReadyAt: new Date().toISOString(),
+    });
+    console.log(`[product-qa] QA environment ready for product "${productName}" at ${url} (integration branch)`);
+}
+/**
+ * Tear down a product-level QA environment.
+ * Kills the dev server and removes the integration worktree.
+ */
+async function handleProductQaTeardown(config, req, deps) {
+    const { product_id: productId, product_name: productName } = req;
+    console.log(`[product-qa] Tearing down QA environment for product "${productName}"`);
+    // Kill dev server if running
+    const state = deps.getProductQaEnvironment(productId);
+    if (state?.pid) {
+        await deps.stopQaDevServer(state.pid);
+    }
+    // Remove QA worktree (read-only checkout, no safety commits needed)
+    if (state?.worktreePath) {
+        deps.removeQaWorktree(config.repoPath, state.worktreePath);
+    }
+    // Clear in-memory state
+    deps.removeProductQaEnvironment(productId);
+    // Clear DB state
+    await deps.updateProductQaStatus(productId, {
+        qaStatus: null,
+        qaUrl: null,
+        qaPort: null,
+        qaWorktreePath: null,
+        qaReadyAt: null,
+        qaError: null,
+    });
+    console.log(`[product-qa] QA environment torn down for product "${productName}"`);
+}
+//# sourceMappingURL=qa-orchestrator.js.map

package/dist/qa-orchestrator.js.map

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

package/dist/qa-port-allocator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * QA environment port allocation and URL construction.
+ *
+ * Allocates ports from the configured range for QA dev servers,
+ * checking both in-memory state and OS-level availability.
+ */
+import type { DaemonConfig } from './types.js';
+/**
+ * Allocate an available port from the configured QA port range.
+ *
+ * 1. Collects ports already in use by active QA environments (in-memory).
+ * 2. Iterates through [qaPortRangeStart, qaPortRangeEnd].
+ * 3. For each port not already allocated, verifies OS-level availability.
+ * 4. Returns the first available port.
+ *
+ * @throws Error if no port is available in the configured range.
+ */
+export declare function allocatePort(config: DaemonConfig): Promise<number>;
+/**
+ * Release a port allocation.
+ *
+ * Currently a no-op: ports are tracked in qa-state.ts via QaEnvironmentState.
+ * When removeQaEnvironment() is called, the port is implicitly released.
+ * This is a placeholder for future explicit port reservation tracking.
+ */
+export declare function releasePort(_port: number): void;
+/**
+ * Build the full QA URL for a given port using the configured host.
+ *
+ * Uses qaHost from config, which is either an auto-detected LAN IP
+ * or an explicitly configured hostname.
+ */
+export declare function buildQaUrl(config: DaemonConfig, port: number): string;
+//# sourceMappingURL=qa-port-allocator.d.ts.map

package/dist/qa-port-allocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-port-allocator.d.ts","sourceRoot":"","sources":["../src/qa-port-allocator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkB/C;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBxE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/qa-port-allocator.js

@@ -0,0 +1,75 @@
+/**
+ * QA environment port allocation and URL construction.
+ *
+ * Allocates ports from the configured range for QA dev servers,
+ * checking both in-memory state and OS-level availability.
+ */
+import { createServer } from 'node:net';
+import { getActiveQaEnvironments } from './qa-state.js';
+/**
+ * Check whether a port is available by briefly binding to it.
+ * Returns true if the port can be bound, false if it is in use.
+ */
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once('error', () => resolve(false));
+        server.once('listening', () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(port, '0.0.0.0');
+    });
+}
+/**
+ * Allocate an available port from the configured QA port range.
+ *
+ * 1. Collects ports already in use by active QA environments (in-memory).
+ * 2. Iterates through [qaPortRangeStart, qaPortRangeEnd].
+ * 3. For each port not already allocated, verifies OS-level availability.
+ * 4. Returns the first available port.
+ *
+ * @throws Error if no port is available in the configured range.
+ */
+export async function allocatePort(config) {
+    const { qaPortRangeStart: start, qaPortRangeEnd: end } = config;
+    // Collect ports already allocated to active QA environments
+    const activeEnvironments = getActiveQaEnvironments();
+    const allocatedPorts = new Set();
+    for (const env of activeEnvironments.values()) {
+        allocatedPorts.add(env.port);
+    }
+    // Iterate through the range looking for an available port
+    for (let port = start; port <= end; port++) {
+        // Skip ports already tracked in memory
+        if (allocatedPorts.has(port)) {
+            continue;
+        }
+        // Verify the port is actually free at the OS level
+        const available = await isPortAvailable(port);
+        if (available) {
+            return port;
+        }
+    }
+    throw new Error(`No available port in range ${start}-${end}`);
+}
+/**
+ * Release a port allocation.
+ *
+ * Currently a no-op: ports are tracked in qa-state.ts via QaEnvironmentState.
+ * When removeQaEnvironment() is called, the port is implicitly released.
+ * This is a placeholder for future explicit port reservation tracking.
+ */
+export function releasePort(_port) {
+    // Port is released implicitly when QA environment state is removed.
+    // This is a placeholder for future explicit port reservation tracking.
+}
+/**
+ * Build the full QA URL for a given port using the configured host.
+ *
+ * Uses qaHost from config, which is either an auto-detected LAN IP
+ * or an explicitly configured hostname.
+ */
+export function buildQaUrl(config, port) {
+    return `http://${config.qaHost}:${port}`;
+}
+//# sourceMappingURL=qa-port-allocator.js.map

package/dist/qa-port-allocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-port-allocator.js","sourceRoot":"","sources":["../src/qa-port-allocator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD;;;GAGG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB;IACrD,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAEhE,4DAA4D;IAC5D,MAAM,kBAAkB,GAAG,uBAAuB,EAAE,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3C,uCAAuC;QACvC,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,mDAAmD;QACnD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,oEAAoE;IACpE,uEAAuE;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAoB,EAAE,IAAY;IAC3D,OAAO,UAAU,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/qa-provisioner.d.ts

@@ -0,0 +1,33 @@
+/**
+ * QA worktree provisioning and teardown.
+ *
+ * Manages git worktrees for QA environments. Unlike agent worktrees,
+ * QA worktrees are read-only checkouts of a strategy's integration branch
+ * used to run a dev server for manual QA verification.
+ */
+import type { DaemonConfig } from './types.js';
+/**
+ * Create (or update) a QA worktree for a strategy's integration branch.
+ *
+ * If the worktree already exists, checks out the correct branch and
+ * pulls the latest changes. Otherwise, creates a fresh worktree.
+ *
+ * @returns The absolute path to the QA worktree directory.
+ */
+export declare function createQaWorktree(config: DaemonConfig, strategyBranchName: string, strategyId: string): string;
+/**
+ * Remove a QA worktree.
+ *
+ * QA worktrees are read-only checkouts so no safety commits are needed.
+ * Falls back to recursive directory removal if `git worktree remove` fails.
+ */
+export declare function removeQaWorktree(repoPath: string, worktreePath: string): void;
+/**
+ * Symlink common environment/config files from the main repo into a QA worktree.
+ *
+ * Only creates symlinks for files that exist in the main repo and don't
+ * already exist (or aren't already correctly symlinked) in the worktree.
+ * Logs each action and warns (but does not throw) on failure.
+ */
+export declare function symlinkEnvFiles(repoPath: string, worktreePath: string): void;
+//# sourceMappingURL=qa-provisioner.d.ts.map

package/dist/qa-provisioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-provisioner.d.ts","sourceRoot":"","sources":["../src/qa-provisioner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,MAAM,GACjB,MAAM,CAsER;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,IAAI,CAgCN;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,IAAI,CA6CN"}

package/dist/qa-provisioner.js

@@ -0,0 +1,141 @@
+/**
+ * QA worktree provisioning and teardown.
+ *
+ * Manages git worktrees for QA environments. Unlike agent worktrees,
+ * QA worktrees are read-only checkouts of a strategy's integration branch
+ * used to run a dev server for manual QA verification.
+ */
+import { existsSync, mkdirSync, symlinkSync, unlinkSync, readlinkSync, rmSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { runGitSync, branchExists } from './git.js';
+/** File names to symlink from the main repo into QA worktrees. */
+const ENV_FILES = ['.env', '.env.local', '.env.development.local'];
+/**
+ * Create (or update) a QA worktree for a strategy's integration branch.
+ *
+ * If the worktree already exists, checks out the correct branch and
+ * pulls the latest changes. Otherwise, creates a fresh worktree.
+ *
+ * @returns The absolute path to the QA worktree directory.
+ */
+export function createQaWorktree(config, strategyBranchName, strategyId) {
+    const worktreePath = join(config.worktreeDir, 'qa-' + strategyId.slice(0, 8));
+    // Ensure parent worktree directory exists
+    if (!existsSync(config.worktreeDir)) {
+        mkdirSync(config.worktreeDir, { recursive: true });
+        console.log(`[qa-provisioner] Created worktree directory: ${config.worktreeDir}`);
+    }
+    // If the worktree directory already exists, update in place (detached HEAD)
+    if (existsSync(worktreePath)) {
+        console.log(`[qa-provisioner] QA worktree already exists, updating: ${worktreePath}`);
+        // Fetch latest then reset to branch tip (detached HEAD, no branch lock)
+        runGitSync(['fetch', 'origin', strategyBranchName], config.repoPath);
+        const resetResult = runGitSync(['checkout', '--detach', strategyBranchName], worktreePath);
+        if (!resetResult.success) {
+            console.warn(`[qa-provisioner] Could not update detached HEAD to ${strategyBranchName}: ${resetResult.error}`);
+        }
+        symlinkEnvFiles(config.repoPath, worktreePath);
+        return worktreePath;
+    }
+    // Prune stale worktree entries before creating a new one
+    runGitSync(['worktree', 'prune'], config.repoPath);
+    // If the branch doesn't exist locally, try fetching from origin
+    if (!branchExists(strategyBranchName, config.repoPath)) {
+        console.log(`[qa-provisioner] Branch ${strategyBranchName} not found locally, fetching from origin...`);
+        const fetchResult = runGitSync(['fetch', 'origin', strategyBranchName], config.repoPath);
+        if (!fetchResult.success) {
+            throw new Error(`[qa-provisioner] Failed to fetch branch ${strategyBranchName} from origin: ${fetchResult.error}`);
+        }
+    }
+    // Create the worktree with detached HEAD to avoid locking the branch.
+    // Locking the branch prevents agent merges into integration while QA is running.
+    console.log(`[qa-provisioner] Creating QA worktree at ${worktreePath} (detached at ${strategyBranchName})`);
+    const addResult = runGitSync(['worktree', 'add', '--detach', worktreePath, strategyBranchName], config.repoPath);
+    if (!addResult.success) {
+        throw new Error(`[qa-provisioner] Failed to create QA worktree: ${addResult.error}`);
+    }
+    // Pull latest changes in the new worktree
+    const pullResult = runGitSync(['pull', '--ff-only'], worktreePath);
+    if (!pullResult.success) {
+        console.warn(`[qa-provisioner] Could not pull latest after worktree creation: ${pullResult.error}`);
+    }
+    symlinkEnvFiles(config.repoPath, worktreePath);
+    return worktreePath;
+}
+/**
+ * Remove a QA worktree.
+ *
+ * QA worktrees are read-only checkouts so no safety commits are needed.
+ * Falls back to recursive directory removal if `git worktree remove` fails.
+ */
+export function removeQaWorktree(repoPath, worktreePath) {
+    try {
+        if (!existsSync(worktreePath)) {
+            console.log(`[qa-provisioner] QA worktree already removed: ${worktreePath}`);
+            runGitSync(['worktree', 'prune'], repoPath);
+            return;
+        }
+        console.log(`[qa-provisioner] Removing QA worktree: ${worktreePath}`);
+        const result = runGitSync(['worktree', 'remove', '--force', worktreePath], repoPath);
+        if (!result.success) {
+            console.warn(`[qa-provisioner] git worktree remove failed, falling back to rmSync: ${result.error}`);
+            rmSync(worktreePath, { recursive: true, force: true });
+            // Prune the now-stale worktree entry
+            runGitSync(['worktree', 'prune'], repoPath);
+            console.log(`[qa-provisioner] Removed QA worktree directory via rmSync: ${worktreePath}`);
+        }
+        else {
+            console.log(`[qa-provisioner] Removed QA worktree: ${worktreePath}`);
+        }
+    }
+    catch (err) {
+        console.error('[qa-provisioner] Error removing QA worktree:', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * Symlink common environment/config files from the main repo into a QA worktree.
+ *
+ * Only creates symlinks for files that exist in the main repo and don't
+ * already exist (or aren't already correctly symlinked) in the worktree.
+ * Logs each action and warns (but does not throw) on failure.
+ */
+export function symlinkEnvFiles(repoPath, worktreePath) {
+    for (const fileName of ENV_FILES) {
+        const sourcePath = resolve(repoPath, fileName);
+        const targetPath = resolve(worktreePath, fileName);
+        if (!existsSync(sourcePath)) {
+            continue;
+        }
+        // If the target already exists, check if it's already a correct symlink
+        if (existsSync(targetPath)) {
+            try {
+                const linkTarget = readlinkSync(targetPath);
+                if (resolve(linkTarget) === sourcePath) {
+                    // Already correctly symlinked
+                    continue;
+                }
+            }
+            catch {
+                // Not a symlink (regular file) -- skip to avoid overwriting
+                console.log(`[qa-provisioner] Skipping ${fileName}: already exists in worktree as a regular file`);
+                continue;
+            }
+            // Symlink exists but points somewhere else -- remove and re-create
+            try {
+                unlinkSync(targetPath);
+            }
+            catch (unlinkErr) {
+                console.warn(`[qa-provisioner] Could not remove stale symlink for ${fileName}: ${unlinkErr instanceof Error ? unlinkErr.message : String(unlinkErr)}`);
+                continue;
+            }
+        }
+        try {
+            symlinkSync(sourcePath, targetPath);
+            console.log(`[qa-provisioner] Symlinked ${fileName} -> ${sourcePath}`);
+        }
+        catch (symlinkErr) {
+            console.warn(`[qa-provisioner] Failed to symlink ${fileName}: ${symlinkErr instanceof Error ? symlinkErr.message : String(symlinkErr)}`);
+        }
+    }
+}
+//# sourceMappingURL=qa-provisioner.js.map