@telora/daemon 0.12.33

package/dist/prompt-builder.js

@@ -0,0 +1,174 @@
+/**
+ * Prompt builder - constructs the initial prompt for Claude Code agents.
+ *
+ * Assembles full delivery context including product vision, strategy,
+ * pipeline position, work structure (context groups and tasks),
+ * and guard directives into a structured markdown prompt.
+ */
+/**
+ * Build the prompt for the agent with full delivery context.
+ * When guardDirective is provided, it's injected as a governance section.
+ */
+export function buildDeliveryPrompt(role, context, guardDirective) {
+    const parts = [];
+    // Role context
+    if (role.system_prompt_template) {
+        parts.push(role.system_prompt_template);
+        parts.push('');
+    }
+    // Domain boundaries
+    if (role.allowed_file_patterns.length > 0) {
+        parts.push('## Domain Boundaries');
+        parts.push('You are authorized to work on files matching these patterns:');
+        for (const pattern of role.allowed_file_patterns) {
+            parts.push(`- ${pattern}`);
+        }
+        parts.push('');
+    }
+    // Product vision -- north star for judgment calls
+    if (context.product) {
+        parts.push('## Product');
+        parts.push(`**${context.product.name}**`);
+        if (context.product.vision) {
+            parts.push(`**Vision:** ${context.product.vision}`);
+        }
+        if (context.product.target_audience) {
+            parts.push(`**Target Audience:** ${context.product.target_audience}`);
+        }
+        parts.push('');
+    }
+    // Strategy context -- the semantic throughline connecting deliveries
+    if (context.strategy) {
+        parts.push('## Strategy');
+        parts.push(`**${context.strategy.name}**`);
+        if (context.strategy.description) {
+            parts.push(context.strategy.description);
+        }
+        parts.push('');
+        parts.push('This delivery is part of the above strategy. Use this strategic context to guide scope decisions and prioritization.');
+        parts.push('');
+    }
+    // Pipeline context -- show where this delivery sits in the strategy sequence
+    if (context.pipelineDeliveries.length > 1) {
+        parts.push('## Pipeline');
+        for (let i = 0; i < context.pipelineDeliveries.length; i++) {
+            const sibling = context.pipelineDeliveries[i];
+            const status = sibling.executionStatus ?? 'draft';
+            const isCurrent = sibling.id === context.delivery.id;
+            const marker = isCurrent ? '  <-- you are here' : '';
+            parts.push(`${i + 1}. [${status}] ${sibling.name}${marker}`);
+        }
+        parts.push('');
+        parts.push('Complete your delivery with awareness of what downstream deliveries will need from your output.');
+        parts.push('');
+    }
+    // Delivery assignment -- keep prompt lean, agent pulls details via MCP
+    parts.push('## Delivery Assignment');
+    parts.push(`**Delivery ID:** ${context.delivery.id}`);
+    parts.push(`**Delivery:** ${context.delivery.name}`);
+    if (context.delivery.description) {
+        parts.push(`**Description:** ${context.delivery.description}`);
+    }
+    if (context.acceptanceCriteria) {
+        parts.push('');
+        parts.push('**Acceptance Criteria:**');
+        parts.push(context.acceptanceCriteria);
+    }
+    if (context.techContext) {
+        parts.push('');
+        parts.push('**Technical Context:**');
+        parts.push(context.techContext);
+    }
+    parts.push('');
+    // Work structure -- render Context Groups so agent understands grouping, context, and scope
+    const hasIssues = context.contextGroups.length > 0;
+    if (hasIssues) {
+        parts.push('## Work Structure');
+        parts.push('');
+        const realGroups = context.contextGroups.filter(g => g.children.length > 0);
+        const standalone = context.contextGroups.filter(g => g.children.length === 0);
+        for (const group of realGroups) {
+            const { issue, children } = group;
+            parts.push(`### Group: "${issue.title}"`);
+            if (issue.context) {
+                parts.push('**Context:**');
+                parts.push(issue.context);
+                parts.push('');
+            }
+            if (issue.relevant_files) {
+                parts.push('**Relevant Files:**');
+                for (const fileLine of issue.relevant_files.split('\n')) {
+                    const trimmed = fileLine.trim();
+                    if (trimmed)
+                        parts.push(`- ${trimmed}`);
+                }
+                parts.push('');
+            }
+            parts.push('**Tasks:**');
+            for (const child of children) {
+                const checkbox = child.status === 'Done' ? '[x]' : '[ ]';
+                const label = child.key ? `${child.key}: ${child.title}` : child.title;
+                parts.push(`- ${checkbox} ${label} (${child.status})`);
+            }
+            parts.push('');
+        }
+        if (standalone.length > 0) {
+            parts.push('### Standalone Tasks');
+            for (const item of standalone) {
+                const checkbox = item.issue.status === 'Done' ? '[x]' : '[ ]';
+                const label = item.issue.key ? `${item.issue.key}: ${item.issue.title}` : item.issue.title;
+                parts.push(`- ${checkbox} ${label} (${item.issue.status})`);
+            }
+            parts.push('');
+        }
+    }
+    // Guard directive -- injected when delivery resumes after human routing decision
+    if (guardDirective) {
+        parts.push('## Guard Directive');
+        parts.push('The following governance directive has been set by a guard decision. Follow these instructions in addition to the delivery requirements:');
+        parts.push('');
+        parts.push(guardDirective);
+        parts.push('');
+    }
+    // Mandatory status update rules
+    parts.push('## Status Update Rules (MANDATORY)');
+    parts.push('');
+    parts.push('- Every issue MUST follow: To Do -> In Progress -> Done');
+    parts.push('- NEVER skip "In Progress". Set it BEFORE starting any work on an issue.');
+    parts.push('- NEVER move an issue directly from "To Do" to "Done".');
+    parts.push('- Use `telora_product_issue_update`:');
+    parts.push('  - Start work: `{ "issueId": "<id>", "status": "In Progress" }`');
+    parts.push('  - Finish work: `{ "issueId": "<id>", "status": "Done" }`');
+    parts.push('');
+    // Instructions -- adapt based on whether the delivery has issues
+    parts.push('## Instructions');
+    if (hasIssues) {
+        parts.push('1. Read the CLAUDE.md file at the repo root for repository conventions before starting implementation');
+        parts.push('2. Review the Work Structure above for context and relevant files per group');
+        parts.push(`3. Use \`telora_product_issue_list\` with deliveryId "${context.delivery.id}" to get current work items (issues may have been added or updated since this prompt was built)`);
+        parts.push('4. Work through groups in order. Within each group, complete all child tasks before moving to the next group.');
+        parts.push('5. For each task:');
+        parts.push('   - Update its status to "In Progress" using `telora_product_issue_update`');
+        parts.push('   - Implement the required changes, focusing on the relevant files listed for its group');
+        parts.push('   - Create commits as you make progress');
+        parts.push('   - Update status to "Done" when complete');
+        parts.push('6. If you discover work not covered by existing issues, create new issues using `telora_product_issue_create` — assign them to the appropriate Context Group via parentIssueId, or create them as standalone tasks');
+        parts.push('7. If you get stuck or need human input, use `telora_agent_escalate`');
+        parts.push('8. Before finishing, re-query `telora_product_issue_list` and verify EVERY issue is Done. If any remain open, either complete them or escalate — do not exit with incomplete work');
+        parts.push('9. When all items are Done, summarize the changes made');
+    }
+    else {
+        parts.push('1. Read the CLAUDE.md file at the repo root for repository conventions before starting implementation');
+        parts.push('2. Implement the acceptance criteria above — that is your work breakdown');
+        parts.push(`3. Check \`telora_product_issue_list\` with deliveryId "${context.delivery.id}" in case issues have been added since this prompt was generated`);
+        parts.push('4. Create commits as you make progress');
+        parts.push('5. If you discover work not covered by existing issues, create new issues using `telora_product_issue_create`');
+        parts.push('   For any issues created, follow the Status Update Rules above (In Progress before Done)');
+        parts.push('6. If you get stuck or need human input, use `telora_agent_escalate`');
+        parts.push('7. Before finishing, re-query `telora_product_issue_list` and verify all issues are Done if any were created');
+        parts.push('8. When done, summarize the changes made');
+    }
+    parts.push('');
+    return parts.join('\n');
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/prompt-builder.js.map

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

package/dist/qa-crash-recovery.d.ts

@@ -0,0 +1,77 @@
+/**
+ * QA environment crash recovery.
+ *
+ * When the daemon crashes, QA dev server processes may be left in inconsistent
+ * states. This module runs on daemon startup AFTER normal crash recovery to
+ * reconcile QA-specific state.
+ *
+ * Under the persistent worktree model, QA does not own its own worktrees.
+ * Recovery is purely DB-driven: query strategies with QA state and reset
+ * dead dev servers to 'requested' for re-provisioning by the poll loop.
+ *
+ * Runs after recoverFromCrash() and before startListeners().
+ */
+import type { DaemonConfig } from './types.js';
+export interface QaRecoveryDeps {
+    getQaStrategies: () => Promise<Array<{
+        strategyId: string;
+        strategyName: string;
+        qaStatus: string | null;
+        qaWorktreePath: string | null;
+        qaPort: number | null;
+        strategyStatus: string;
+    }>>;
+    updateQaStatus: (strategyId: string, fields: Record<string, unknown>) => Promise<void>;
+}
+export interface QaRecoveryResult {
+    strategiesWithQa: number;
+    resetToRequested: number;
+    deactivatedTeardowns: number;
+    errors: string[];
+}
+/**
+ * Reconcile QA environments after a daemon crash.
+ *
+ * DB-driven recovery: queries strategies with active QA states and handles:
+ *
+ * 1. 'ready': Dev server died in crash. Reset to 'requested' for re-provision.
+ * 2. 'provisioning': Crashed mid-provision. Reset to 'requested'.
+ * 3. 'requested': Normal (daemon was down). Leave for poll loop.
+ * 4. 'stop_requested': Leave for poll loop to handle.
+ * 5. Deactivated strategy: Clear QA state. Worktree cleanup handled by
+ *    strategy lifecycle (teardownStrategy).
+ *
+ * Safe to call multiple times -- idempotent by design.
+ */
+export declare function reconcileQaEnvironments(config: DaemonConfig, deps: QaRecoveryDeps): Promise<QaRecoveryResult>;
+export interface ProductQaRecoveryDeps {
+    getProductQaStatus: (productId: string) => Promise<{
+        productId: string;
+        productName: string;
+        qaStatus: string | null;
+        qaPort: number | null;
+        qaWorktreePath: string | null;
+        productStatus: string;
+    }>;
+    updateProductQaStatus: (productId: string, fields: Record<string, unknown>) => Promise<void>;
+    removeQaWorktree: (repoPath: string, worktreePath: string) => void;
+}
+export interface ProductQaRecoveryResult {
+    hadQaState: boolean;
+    resetToRequested: boolean;
+    cleared: boolean;
+    errors: string[];
+}
+/**
+ * Reconcile product-level QA environment after a daemon crash.
+ *
+ * Handles:
+ * 1. 'ready': Dev server died in crash. Reset to 'requested' for re-provision.
+ * 2. 'provisioning': Crashed mid-provision. Clean up worktree, reset to 'requested'.
+ * 3. 'requested': Normal. Leave for poll loop.
+ * 4. 'stop_requested': Clean up worktree, clear to null.
+ *
+ * Safe to call multiple times -- idempotent by design.
+ */
+export declare function reconcileProductQaEnvironment(config: DaemonConfig, deps: ProductQaRecoveryDeps): Promise<ProductQaRecoveryResult>;
+//# sourceMappingURL=qa-crash-recovery.d.ts.map

package/dist/qa-crash-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-crash-recovery.d.ts","sourceRoot":"","sources":["../src/qa-crash-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC,CAAC;IACJ,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAmGD,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QACjD,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CA+GlC"}

package/dist/qa-crash-recovery.js

@@ -0,0 +1,243 @@
+/**
+ * QA environment crash recovery.
+ *
+ * When the daemon crashes, QA dev server processes may be left in inconsistent
+ * states. This module runs on daemon startup AFTER normal crash recovery to
+ * reconcile QA-specific state.
+ *
+ * Under the persistent worktree model, QA does not own its own worktrees.
+ * Recovery is purely DB-driven: query strategies with QA state and reset
+ * dead dev servers to 'requested' for re-provisioning by the poll loop.
+ *
+ * Runs after recoverFromCrash() and before startListeners().
+ */
+// -- Main entry point -------------------------------------------------------
+/**
+ * Reconcile QA environments after a daemon crash.
+ *
+ * DB-driven recovery: queries strategies with active QA states and handles:
+ *
+ * 1. 'ready': Dev server died in crash. Reset to 'requested' for re-provision.
+ * 2. 'provisioning': Crashed mid-provision. Reset to 'requested'.
+ * 3. 'requested': Normal (daemon was down). Leave for poll loop.
+ * 4. 'stop_requested': Leave for poll loop to handle.
+ * 5. Deactivated strategy: Clear QA state. Worktree cleanup handled by
+ *    strategy lifecycle (teardownStrategy).
+ *
+ * Safe to call multiple times -- idempotent by design.
+ */
+export async function reconcileQaEnvironments(config, deps) {
+    console.log('[qa-recovery] Starting QA environment recovery scan...');
+    const result = {
+        strategiesWithQa: 0,
+        resetToRequested: 0,
+        deactivatedTeardowns: 0,
+        errors: [],
+    };
+    // Query DB for strategies with active QA states
+    let strategies;
+    try {
+        strategies = await deps.getQaStrategies();
+        result.strategiesWithQa = strategies.length;
+        console.log(`[qa-recovery] Found ${strategies.length} strategy/strategies with QA state in DB`);
+    }
+    catch (err) {
+        const msg = `Failed to query QA strategies from DB: ${err instanceof Error ? err.message : String(err)}`;
+        console.error(`[qa-recovery] ${msg}`);
+        result.errors.push(msg);
+        return result;
+    }
+    // Process each strategy with QA state
+    for (const strategy of strategies) {
+        try {
+            await handleStrategyRecovery(strategy, config, deps, result);
+        }
+        catch (err) {
+            const msg = `Error recovering QA for strategy ${strategy.strategyId} (${strategy.strategyName}): ${err instanceof Error ? err.message : String(err)}`;
+            console.error(`[qa-recovery] ${msg}`);
+            result.errors.push(msg);
+        }
+    }
+    // Summary
+    console.log(`[qa-recovery] Recovery complete: ` +
+        `${result.strategiesWithQa} strategy/strategies with QA state, ` +
+        `${result.resetToRequested} reset to requested, ` +
+        `${result.deactivatedTeardowns} deactivated teardown(s)`);
+    if (result.errors.length > 0) {
+        console.warn(`[qa-recovery] ${result.errors.length} error(s) during recovery (non-fatal)`);
+    }
+    return result;
+}
+// -- Internal helpers -------------------------------------------------------
+/**
+ * Handle recovery for a single strategy based on its QA status.
+ */
+async function handleStrategyRecovery(strategy, _config, deps, result) {
+    const { strategyId, strategyName, qaStatus, strategyStatus } = strategy;
+    const label = `${strategyId.slice(0, 8)} (${strategyName})`;
+    // Deactivated strategy -- clear QA DB state.
+    // Worktree removal is handled by strategy lifecycle (teardownStrategy / rebuildStrategyWorktreeState).
+    if (strategyStatus !== 'active') {
+        console.log(`[qa-recovery] Strategy ${label}: status is '${strategyStatus}' (not active) with qa_status '${qaStatus}'. ` +
+            `Clearing QA state.`);
+        await deps.updateQaStatus(strategyId, {
+            qaStatus: null,
+            qaUrl: null,
+            qaPort: null,
+            qaWorktreePath: null,
+            qaRequestedAt: null,
+            qaReadyAt: null,
+            qaError: null,
+        });
+        result.deactivatedTeardowns++;
+        return;
+    }
+    switch (qaStatus) {
+        case 'ready': {
+            // Dev server died in crash. Reset to 'requested' so poll loop re-provisions.
+            console.log(`[qa-recovery] Strategy ${label}: dev server dead (daemon crashed). Resetting to 'requested'.`);
+            await deps.updateQaStatus(strategyId, { qaStatus: 'requested' });
+            result.resetToRequested++;
+            break;
+        }
+        case 'provisioning': {
+            // Crashed mid-provision. Reset to 'requested'.
+            console.log(`[qa-recovery] Strategy ${label}: crashed mid-provision. Resetting to 'requested'.`);
+            await deps.updateQaStatus(strategyId, {
+                qaStatus: 'requested',
+                qaWorktreePath: null,
+                qaPort: null,
+            });
+            result.resetToRequested++;
+            break;
+        }
+        case 'requested': {
+            // Normal -- daemon was down when request came in. Leave for poll loop.
+            console.log(`[qa-recovery] Strategy ${label}: 'requested' -- leaving for poll loop.`);
+            break;
+        }
+        case 'stop_requested': {
+            // Leave for poll loop to handle.
+            console.log(`[qa-recovery] Strategy ${label}: 'stop_requested' -- leaving for poll loop.`);
+            break;
+        }
+        default: {
+            if (qaStatus != null) {
+                console.log(`[qa-recovery] Strategy ${label}: unexpected qa_status '${qaStatus}' -- no action taken.`);
+            }
+            break;
+        }
+    }
+}
+/**
+ * Reconcile product-level QA environment after a daemon crash.
+ *
+ * Handles:
+ * 1. 'ready': Dev server died in crash. Reset to 'requested' for re-provision.
+ * 2. 'provisioning': Crashed mid-provision. Clean up worktree, reset to 'requested'.
+ * 3. 'requested': Normal. Leave for poll loop.
+ * 4. 'stop_requested': Clean up worktree, clear to null.
+ *
+ * Safe to call multiple times -- idempotent by design.
+ */
+export async function reconcileProductQaEnvironment(config, deps) {
+    console.log('[product-qa-recovery] Starting product QA environment recovery scan...');
+    const result = {
+        hadQaState: false,
+        resetToRequested: false,
+        cleared: false,
+        errors: [],
+    };
+    let product;
+    try {
+        product = await deps.getProductQaStatus(config.productId);
+    }
+    catch (err) {
+        const msg = `Failed to query product QA status: ${err instanceof Error ? err.message : String(err)}`;
+        console.error(`[product-qa-recovery] ${msg}`);
+        result.errors.push(msg);
+        return result;
+    }
+    if (!product.qaStatus) {
+        console.log('[product-qa-recovery] No product QA state in DB -- nothing to recover.');
+        return result;
+    }
+    result.hadQaState = true;
+    const label = `${product.productId.slice(0, 8)} (${product.productName})`;
+    switch (product.qaStatus) {
+        case 'ready':
+        case 'provisioning': {
+            // Dev server died in crash. Clean up stale worktree and reset to 'requested'.
+            const reason = product.qaStatus === 'ready' ? 'dev server dead (daemon crashed)' : 'crashed mid-provision';
+            console.log(`[product-qa-recovery] Product ${label}: ${reason}. Resetting to 'requested'.`);
+            // Remove stale worktree so re-provision creates a fresh one
+            if (product.qaWorktreePath) {
+                try {
+                    deps.removeQaWorktree(config.repoPath, product.qaWorktreePath);
+                }
+                catch (err) {
+                    console.warn(`[product-qa-recovery] Failed to remove stale worktree: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            try {
+                await deps.updateProductQaStatus(config.productId, {
+                    qaStatus: 'requested',
+                    qaPort: null,
+                    qaWorktreePath: null,
+                });
+                result.resetToRequested = true;
+            }
+            catch (err) {
+                const msg = `Failed to reset product QA: ${err instanceof Error ? err.message : String(err)}`;
+                console.error(`[product-qa-recovery] ${msg}`);
+                result.errors.push(msg);
+            }
+            break;
+        }
+        case 'requested': {
+            // Normal -- daemon was down when request came in. Leave for poll loop.
+            console.log(`[product-qa-recovery] Product ${label}: 'requested' -- leaving for poll loop.`);
+            break;
+        }
+        case 'stop_requested': {
+            // Daemon was down when user requested stop. Clean up worktree and clear state.
+            console.log(`[product-qa-recovery] Product ${label}: 'stop_requested' -- clearing QA state.`);
+            if (product.qaWorktreePath) {
+                try {
+                    deps.removeQaWorktree(config.repoPath, product.qaWorktreePath);
+                }
+                catch (err) {
+                    console.warn(`[product-qa-recovery] Failed to remove worktree: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            try {
+                await deps.updateProductQaStatus(config.productId, {
+                    qaStatus: null,
+                    qaUrl: null,
+                    qaPort: null,
+                    qaWorktreePath: null,
+                    qaReadyAt: null,
+                    qaError: null,
+                });
+                result.cleared = true;
+            }
+            catch (err) {
+                const msg = `Failed to clear product QA: ${err instanceof Error ? err.message : String(err)}`;
+                console.error(`[product-qa-recovery] ${msg}`);
+                result.errors.push(msg);
+            }
+            break;
+        }
+        default: {
+            console.log(`[product-qa-recovery] Product ${label}: unexpected qa_status '${product.qaStatus}' -- no action taken.`);
+            break;
+        }
+    }
+    console.log(`[product-qa-recovery] Recovery complete: ` +
+        `hadQaState=${result.hadQaState}, resetToRequested=${result.resetToRequested}, cleared=${result.cleared}`);
+    if (result.errors.length > 0) {
+        console.warn(`[product-qa-recovery] ${result.errors.length} error(s) during recovery (non-fatal)`);
+    }
+    return result;
+}
+//# sourceMappingURL=qa-crash-recovery.js.map

package/dist/qa-crash-recovery.js.map

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

package/dist/qa-dev-server.d.ts

@@ -0,0 +1,73 @@
+/**
+ * QA dev server spawn and health monitoring.
+ *
+ * Manages the lifecycle of Vite dev servers in QA worktrees:
+ * runs npm install, spawns `npm run dev` on an allocated port,
+ * streams stdout/stderr to log files, and provides stop/health helpers.
+ */
+import type { DaemonConfig } from './types.js';
+/** Options for starting a QA dev server. */
+export interface StartQaDevServerOptions {
+    /** Daemon configuration (for logDir). */
+    config: DaemonConfig;
+    /** Strategy UUID (used for log directory naming). */
+    strategyId: string;
+    /** Absolute path to the QA worktree. */
+    worktreePath: string;
+    /** Port to bind the dev server to. */
+    port: number;
+    /** Callback invoked if the dev server exits unexpectedly. */
+    onUnexpectedExit: (error: string) => void;
+}
+/** Result from a successful dev server start. */
+export interface StartQaDevServerResult {
+    /** PID of the spawned dev server process. */
+    pid: number;
+    /** Absolute path to the stdout log file. */
+    stdoutPath: string;
+    /** Absolute path to the stderr log file. */
+    stderrPath: string;
+}
+/**
+ * Install dependencies and spawn a dev server in a QA worktree.
+ *
+ * 1. Runs `npm install` synchronously in the worktree.
+ * 2. Spawns `npm run dev` with `PORT` env var set to the allocated port.
+ * 3. Pipes stdout/stderr to log files under `{logDir}/qa-{strategyId-prefix}/`.
+ * 4. Registers an on-exit handler that calls `onUnexpectedExit` if the
+ *    process exits without an intentional stop.
+ *
+ * @returns The child process PID and log file paths.
+ * @throws If npm install fails or the dev server process cannot be spawned.
+ */
+export declare function startQaDevServer(options: StartQaDevServerOptions): StartQaDevServerResult;
+/**
+ * Gracefully stop a running QA dev server.
+ *
+ * Sends SIGTERM first, then escalates to SIGKILL if the process
+ * does not exit within the grace period.
+ */
+export declare function stopQaDevServer(pid: number): Promise<void>;
+/**
+ * Check if a QA dev server process is still alive.
+ *
+ * Uses the `process.kill(pid, 0)` pattern which sends no signal
+ * but throws if the process does not exist.
+ */
+export declare function isQaDevServerRunning(pid: number): boolean;
+/**
+ * Build the browser-accessible Supabase URL for a QA environment.
+ *
+ * The local Supabase typically listens on 127.0.0.1:54321, but the QA
+ * browser is remote (e.g. on a different machine). Replace the host
+ * portion with the daemon's LAN IP (qaHost) so the browser can reach it.
+ */
+export declare function buildQaSupabaseUrl(localSupabaseUrl: string, qaHost: string): string;
+type DevFramework = 'vite' | 'nextjs' | 'unknown';
+/**
+ * Detect the dev framework from the project's package.json.
+ * Checks devDependencies and dependencies for known frameworks.
+ */
+export declare function detectFramework(worktreePath: string): DevFramework;
+export {};
+//# sourceMappingURL=qa-dev-server.d.ts.map

package/dist/qa-dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-dev-server.d.ts","sourceRoot":"","sources":["../src/qa-dev-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAmHzF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuChE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOzD;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASnF;AAED,KAAK,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAclE"}