@rulemetric/cli 0.1.1 → 0.2.0

package/dist/lib/handlers/process-insights.d.ts

@@ -0,0 +1,39 @@
+import type { JobHelpers } from 'graphile-worker';
+interface InsightsPayload {
+    mirrorId: string;
+    projectPath: string | null;
+    config?: {
+        sessionId?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Graphile-shaped handler for the `process_insights` task.
+ *
+ * Lifted from the legacy `insights-worker.ts:processInsightsJob` and
+ * `processSessionAnalysisJob`, with the queue plumbing stripped out:
+ *   - no claim — Graphile already claimed the job before invoking us
+ *   - no /complete POST — we return the result object (or throw)
+ *   - no "could not claim" early-return branches
+ *
+ * Mid-job progress patches still hit the existing
+ * `PATCH /api/insights-jobs/:id/progress` endpoint, just keyed by the
+ * mirror row's id.
+ *
+ * The session-analysis branch (selected when `payload.config.sessionId`
+ * is set) lives inline below — it's a different code path but cheap to
+ * keep co-located.
+ *
+ * The `buildDataSummary*` helpers are duplicated here as private locals;
+ * Task 21 will hoist them into a shared `insights-data.ts` once
+ * `insights-worker.ts` is deleted.
+ *
+ * User-facing notifications go through the API's `notifyUser()` path
+ * (insert into `notifications` → Supabase Realtime → service-worker
+ * `showNotification` with a deep-link). The worker no longer fires native
+ * `osascript` banners — those duplicated the browser path, weren't
+ * clickable to a URL, and stacked one-per-project on macOS.
+ */
+export declare function processInsights(payload: InsightsPayload, helpers: JobHelpers): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=process-insights.d.ts.map

package/dist/lib/handlers/process-insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-insights.d.ts","sourceRoot":"","sources":["../../../src/lib/handlers/process-insights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMlD,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4LlC"}

package/dist/lib/handlers/process-insights.js

@@ -0,0 +1,300 @@
+import { apiGet, apiPost, apiPatch } from '../api-client.js';
+import { RECOMMENDATION_PROMPTS, AT_A_GLANCE_PROMPT, FACET_GENERATION_PROMPT } from '../insights-prompts.js';
+import { runLlmPrompt, detectLlmBackend, runToolPrompt } from '../llm-client.js';
+import { PermanentJobError } from '../permanent-job-error.js';
+/**
+ * Graphile-shaped handler for the `process_insights` task.
+ *
+ * Lifted from the legacy `insights-worker.ts:processInsightsJob` and
+ * `processSessionAnalysisJob`, with the queue plumbing stripped out:
+ *   - no claim — Graphile already claimed the job before invoking us
+ *   - no /complete POST — we return the result object (or throw)
+ *   - no "could not claim" early-return branches
+ *
+ * Mid-job progress patches still hit the existing
+ * `PATCH /api/insights-jobs/:id/progress` endpoint, just keyed by the
+ * mirror row's id.
+ *
+ * The session-analysis branch (selected when `payload.config.sessionId`
+ * is set) lives inline below — it's a different code path but cheap to
+ * keep co-located.
+ *
+ * The `buildDataSummary*` helpers are duplicated here as private locals;
+ * Task 21 will hoist them into a shared `insights-data.ts` once
+ * `insights-worker.ts` is deleted.
+ *
+ * User-facing notifications go through the API's `notifyUser()` path
+ * (insert into `notifications` → Supabase Realtime → service-worker
+ * `showNotification` with a deep-link). The worker no longer fires native
+ * `osascript` banners — those duplicated the browser path, weren't
+ * clickable to a URL, and stacked one-per-project on macOS.
+ */
+export async function processInsights(payload, helpers) {
+    const { mirrorId, projectPath, config } = payload;
+    const log = (msg) => helpers.logger.info(msg);
+    // Session-analysis branch — single-session deep analysis through tool CLI
+    if (config?.sessionId) {
+        return processSessionAnalysisInline({ mirrorId, sessionId: config.sessionId }, log);
+    }
+    log(`Processing insights job ${mirrorId}...`);
+    // Update status to running
+    await apiPatch(`/api/insights-jobs/${mirrorId}/progress`, {
+        status: 'running',
+        progress: { step: 'reading_data' },
+    });
+    // Self-heal orphan analyses missing `analyzed_at`. Without this, the
+    // freshness banner on the dashboard nags forever — the worker's
+    // facet-drain query (`hasAnalysis=false`) skips already-analyzed rows,
+    // so pre-instrumentation orphans never get touched. Stamps a conservative
+    // lower bound (`analyzed_at = started_at`); idempotent on subsequent runs.
+    // Best-effort: a failure here must not block the recommendation pass.
+    try {
+        const { repaired } = await apiPost('/api/sessions/repair-analyzed-at', {});
+        if (repaired > 0) {
+            log(`  Repaired analyzed_at on ${repaired} orphan session(s).`);
+        }
+    }
+    catch (repairErr) {
+        log(`  Warning: analyzed_at repair failed: ${repairErr instanceof Error ? repairErr.message : String(repairErr)}`);
+    }
+    // API-based summary is the only source. The previous file-based fallback
+    // (`buildDataSummary` reading ~/.claude/usage-data/) was deleted on
+    // 2026-05-05 — it required `rulemetric insights sync` to populate JSON
+    // files locally, which nobody ever ran. The DB-derived summary is
+    // tool-agnostic and authoritative.
+    const data = await buildDataSummaryFromApi(projectPath);
+    if (!data) {
+        throw new PermanentJobError('No session data found — ensure sessions are captured and enriched.');
+    }
+    log(`  Found ${data.stats.sessions} sessions, generating recommendations...`);
+    // Drain un-analyzed sessions in batches until empty (or until we hit the
+    // hard cap, to keep the per-job runtime bounded). Previously this took at
+    // most 20 sessions per run, which meant catch-up after a backlog could
+    // span days. Batching keeps memory bounded while letting one job clear
+    // the entire queue when needed.
+    const FACET_BATCH_SIZE = 20;
+    const FACET_HARD_CAP = 200; // protect against runaway runtime
+    if (detectLlmBackend() !== 'none') {
+        let totalFaceted = 0;
+        try {
+            while (totalFaceted < FACET_HARD_CAP) {
+                const unfaceted = await apiGet(`/api/sessions?hasAnalysis=false&limit=${FACET_BATCH_SIZE}`);
+                if (unfaceted.length === 0)
+                    break;
+                log(`  Generating facets for ${unfaceted.length} un-analyzed sessions (drained ${totalFaceted} so far)...`);
+                for (const session of unfaceted) {
+                    if (totalFaceted >= FACET_HARD_CAP)
+                        break;
+                    try {
+                        const events = await apiGet(`/api/sessions/${session.id}/events?limit=100`);
+                        if (events.length < 2) {
+                            totalFaceted++;
+                            continue;
+                        }
+                        const eventSummary = events
+                            .filter(e => e.eventType === 'user_message' || e.eventType === 'human')
+                            .map(e => e.content?.slice(0, 200) ?? '')
+                            .filter(Boolean)
+                            .join('\n---\n');
+                        if (!eventSummary) {
+                            totalFaceted++;
+                            continue;
+                        }
+                        const facets = await runLlmPrompt(FACET_GENERATION_PROMPT, eventSummary, 4096);
+                        if (facets) {
+                            const userMessageCount = events.filter(e => e.eventType === 'user_message' || e.eventType === 'human').length;
+                            await apiPatch(`/api/sessions/${session.id}/enrich`, {
+                                analysis: { source: 'generated_facets', ...facets },
+                                analyzedEventCount: events.length,
+                                analyzedTurnCount: userMessageCount,
+                            });
+                            log(`    Generated facets for session ${session.id} (${session.tool})`);
+                        }
+                        totalFaceted++;
+                    }
+                    catch (sessionErr) {
+                        log(`    Failed to generate facets for session ${session.id}: ${sessionErr instanceof Error ? sessionErr.message : String(sessionErr)}`);
+                        totalFaceted++; // count it so we don't infinite-loop on a poison row
+                    }
+                }
+                // If the batch returned fewer than the requested size, the queue is
+                // empty — break before another fetch.
+                if (unfaceted.length < FACET_BATCH_SIZE)
+                    break;
+            }
+        }
+        catch (facetErr) {
+            log(`  Warning: facet generation failed after ${totalFaceted} sessions: ${facetErr instanceof Error ? facetErr.message : String(facetErr)}`);
+        }
+    }
+    // Run recommendation prompts sequentially
+    const recommendations = {};
+    const totalPrompts = RECOMMENDATION_PROMPTS.length + 1; // +1 for at_a_glance
+    // Persist sections-so-far on every progress PATCH so the web UI can render
+    // them incrementally — each prompt takes 30-60s and shipping a label-only
+    // progress update for that whole window leaves the page looking dead. The
+    // detail page reads `progress.partial` and renders each section card as it
+    // arrives.
+    for (let i = 0; i < RECOMMENDATION_PROMPTS.length; i++) {
+        const spec = RECOMMENDATION_PROMPTS[i];
+        log(`  [${i + 1}/${totalPrompts}] Generating ${spec.name}...`);
+        try {
+            await apiPatch(`/api/insights-jobs/${mirrorId}/progress`, {
+                status: 'running',
+                progress: {
+                    step: spec.name,
+                    current: i + 1,
+                    total: totalPrompts,
+                    partial: { ...recommendations },
+                },
+            });
+        }
+        catch (patchErr) {
+            log(`  Warning: progress update failed for ${spec.name}: ${patchErr instanceof Error ? patchErr.message : String(patchErr)}`);
+        }
+        log(`  Running LLM prompt for ${spec.name}...`);
+        const result = await runLlmPrompt(spec.prompt, data.summary, spec.maxTokens);
+        if (result) {
+            recommendations[spec.name] = result;
+            log(`  Got result for ${spec.name}`);
+        }
+        else {
+            log(`  No result for ${spec.name} (LLM returned null)`);
+        }
+    }
+    // At a glance (uses outputs from previous prompts)
+    log(`  [${totalPrompts}/${totalPrompts}] Generating at_a_glance...`);
+    await apiPatch(`/api/insights-jobs/${mirrorId}/progress`, {
+        status: 'running',
+        progress: {
+            step: 'at_a_glance',
+            current: totalPrompts,
+            total: totalPrompts,
+            partial: { ...recommendations },
+        },
+    });
+    const glanceData = [
+        data.summary,
+        recommendations.what_works ? `\n## What Works\n${JSON.stringify(recommendations.what_works)}` : '',
+        recommendations.friction_analysis ? `\n## Friction\n${JSON.stringify(recommendations.friction_analysis)}` : '',
+        recommendations.suggestions ? `\n## Suggestions\n${JSON.stringify(recommendations.suggestions)}` : '',
+        recommendations.on_the_horizon ? `\n## On the Horizon\n${JSON.stringify(recommendations.on_the_horizon)}` : '',
+    ].join('\n');
+    const glance = await runLlmPrompt(AT_A_GLANCE_PROMPT, glanceData, 8192);
+    if (glance) {
+        recommendations.at_a_glance = glance;
+    }
+    log('  Uploading results...');
+    log(`  Done! Recommendations generated for job ${mirrorId}`);
+    const result = { recommendations };
+    // Graphile discards task return values, so persist `{ recommendations }`
+    // onto the mirror row here so the dashboard can read it. Best-effort.
+    await apiPatch(`/api/insights-jobs/${mirrorId}/state`, { result }).catch((err) => {
+        log(`result persist failed: ${err instanceof Error ? err.message : String(err)}`);
+    });
+    return result;
+}
+/**
+ * Single-session deep analysis branch. Runs the session's own tool CLI
+ * against the captured event stream to produce facets, then enriches the
+ * session row.
+ *
+ * Idempotency guard: if the session already has analysis from a prior
+ * `session_analysis` run, we short-circuit. This is independent of the
+ * Graphile-side `job_key` dedup added in Task 9 — that prevents duplicate
+ * enqueues; this prevents redoing work even if a different mirrorId
+ * targets the same session.
+ */
+async function processSessionAnalysisInline(args, log) {
+    const { mirrorId, sessionId } = args;
+    log(`Analyzing session ${sessionId} via tool CLI...`);
+    await apiPatch(`/api/insights-jobs/${mirrorId}/progress`, {
+        status: 'running',
+        progress: { step: 'fetching_session' },
+    });
+    const session = await apiGet(`/api/sessions/${sessionId}`);
+    // Idempotency: skip if session already has analysis from a prior run
+    if (session.analysis && session.analysis.source === 'session_analysis') {
+        log(`  Session ${sessionId} already analyzed — skipping (idempotency guard)`);
+        return { sessionId, skipped: true, reason: 'already_analyzed' };
+    }
+    const events = await apiGet(`/api/sessions/${sessionId}/events?limit=100`);
+    if (events.length < 2) {
+        throw new PermanentJobError('Session has too few events to analyze');
+    }
+    const eventSummary = events
+        .filter(e => e.eventType === 'user_message' || e.eventType === 'human')
+        .map(e => e.content?.slice(0, 200) ?? '')
+        .filter(Boolean)
+        .join('\n---\n');
+    if (!eventSummary) {
+        throw new PermanentJobError('No user messages found in session');
+    }
+    await apiPatch(`/api/insights-jobs/${mirrorId}/progress`, {
+        status: 'running',
+        progress: { step: 'running_analysis', tool: session.tool },
+    });
+    // Run through the session's tool CLI
+    const facets = runToolPrompt(session.tool, FACET_GENERATION_PROMPT, eventSummary);
+    if (!facets) {
+        throw new Error(`Analysis failed — ${session.tool} CLI returned no result`);
+    }
+    const userMessageCount = events.filter(e => e.eventType === 'user_message' || e.eventType === 'human').length;
+    await apiPatch(`/api/sessions/${sessionId}/enrich`, {
+        analysis: { source: 'session_analysis', tool: session.tool, ...facets },
+        analyzedEventCount: events.length,
+        analyzedTurnCount: userMessageCount,
+    });
+    log(`  Session ${sessionId} analyzed via ${session.tool}`);
+    return { sessionId, tool: session.tool, facets };
+}
+// ---------------------------------------------------------------------------
+// Local helpers (copied from `insights-worker.ts`; Task 21 hoists to shared)
+// ---------------------------------------------------------------------------
+async function buildDataSummaryFromApi(projectPath) {
+    try {
+        const params = new URLSearchParams();
+        if (projectPath)
+            params.set('projectPath', projectPath);
+        const computed = await apiGet(`/api/insights/compute?${params}`);
+        if (!computed || computed.total_sessions === 0)
+            return null;
+        // Build the same text summary format the prompts expect
+        const topTools = Object.entries(computed.tool_counts ?? {})
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([t, c]) => `${t}: ${c}`)
+            .join(', ');
+        const summary = [
+            `Sessions: ${computed.total_sessions}, Messages: ${computed.total_messages}, Hours: ${Math.round(computed.total_duration_hours)}`,
+            `Top tools: ${topTools}`,
+            computed.goal_categories && Object.keys(computed.goal_categories).length > 0
+                ? `Goals: ${JSON.stringify(computed.goal_categories)}`
+                : '',
+            computed.friction && Object.keys(computed.friction).length > 0
+                ? `Friction: ${JSON.stringify(computed.friction)}`
+                : '',
+            computed.outcomes && Object.keys(computed.outcomes).length > 0
+                ? `Outcomes: ${JSON.stringify(computed.outcomes)}`
+                : '',
+            computed.projects && Object.keys(computed.projects).length > 0
+                ? `Projects: ${JSON.stringify(computed.projects)}`
+                : '',
+        ].filter(Boolean).join('\n');
+        return {
+            summary,
+            stats: {
+                sessions: computed.total_sessions,
+                totalMessages: computed.total_messages,
+                totalHours: computed.total_duration_hours,
+                toolCounts: computed.tool_counts,
+                goalCounts: computed.goal_categories,
+                frictionCounts: computed.friction,
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=process-insights.js.map

package/dist/lib/handlers/process-insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-insights.js","sourceRoot":"","sources":["../../../src/lib/handlers/process-insights.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAW9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB,EACxB,OAAmB;IAEnB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEtD,0EAA0E;IAC1E,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;QACtB,OAAO,4BAA4B,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;IACtF,CAAC;IAED,GAAG,CAAC,2BAA2B,QAAQ,KAAK,CAAC,CAAC;IAE9C,2BAA2B;IAC3B,MAAM,QAAQ,CAAC,sBAAsB,QAAQ,WAAW,EAAE;QACxD,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;KACnC,CAAC,CAAC;IAEH,qEAAqE;IACrE,gEAAgE;IAChE,uEAAuE;IACvE,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,CAChC,kCAAkC,EAClC,EAAE,CACH,CAAC;QACF,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,GAAG,CAAC,6BAA6B,QAAQ,qBAAqB,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,GAAG,CAAC,yCAAyC,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACrH,CAAC;IAED,yEAAyE;IACzE,oEAAoE;IACpE,uEAAuE;IACvE,kEAAkE;IAClE,mCAAmC;IACnC,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,iBAAiB,CACzB,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,0CAA0C,CAAC,CAAC;IAE9E,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,uEAAuE;IACvE,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,EAAE,CAAC;IAC5B,MAAM,cAAc,GAAG,GAAG,CAAC,CAAC,kCAAkC;IAC9D,IAAI,gBAAgB,EAAE,KAAK,MAAM,EAAE,CAAC;QAClC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,YAAY,GAAG,cAAc,EAAE,CAAC;gBACrC,MAAM,SAAS,GAAG,MAAM,MAAM,CAC5B,yCAAyC,gBAAgB,EAAE,CAC5D,CAAC;gBACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM;gBAClC,GAAG,CAAC,2BAA2B,SAAS,CAAC,MAAM,kCAAkC,YAAY,aAAa,CAAC,CAAC;gBAC5G,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;oBAChC,IAAI,YAAY,IAAI,cAAc;wBAAE,MAAM;oBAC1C,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,iBAAiB,OAAO,CAAC,EAAE,mBAAmB,CAC/C,CAAC;wBACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACtB,YAAY,EAAE,CAAC;4BACf,SAAS;wBACX,CAAC;wBAED,MAAM,YAAY,GAAG,MAAM;6BACxB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,cAAc,IAAI,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC;6BACtE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;6BACxC,MAAM,CAAC,OAAO,CAAC;6BACf,IAAI,CAAC,SAAS,CAAC,CAAC;wBAEnB,IAAI,CAAC,YAAY,EAAE,CAAC;4BAClB,YAAY,EAAE,CAAC;4BACf,SAAS;wBACX,CAAC;wBAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,uBAAuB,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;wBAC/E,IAAI,MAAM,EAAE,CAAC;4BACX,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,cAAc,IAAI,CAAC,CAAC,SAAS,KAAK,OAAO,CAC/D,CAAC,MAAM,CAAC;4BACT,MAAM,QAAQ,CAAC,iBAAiB,OAAO,CAAC,EAAE,SAAS,EAAE;gCACnD,QAAQ,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE;gCACnD,kBAAkB,EAAE,MAAM,CAAC,MAAM;gCACjC,iBAAiB,EAAE,gBAAgB;6BACpC,CAAC,CAAC;4BACH,GAAG,CAAC,oCAAoC,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;wBAC1E,CAAC;wBACD,YAAY,EAAE,CAAC;oBACjB,CAAC;oBAAC,OAAO,UAAU,EAAE,CAAC;wBACpB,GAAG,CAAC,6CAA6C,OAAO,CAAC,EAAE,KAAK,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;wBACzI,YAAY,EAAE,CAAC,CAAC,qDAAqD;oBACvE,CAAC;gBACH,CAAC;gBACD,oEAAoE;gBACpE,sCAAsC;gBACtC,IAAI,SAAS,CAAC,MAAM,GAAG,gBAAgB;oBAAE,MAAM;YACjD,CAAC;QACH,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,GAAG,CAAC,4CAA4C,YAAY,cAAc,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/I,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,eAAe,GAA4B,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,sBAAsB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,qBAAqB;IAE7E,2EAA2E;IAC3E,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,WAAW;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,sBAAsB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACvC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,YAAY,gBAAgB,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,sBAAsB,QAAQ,WAAW,EAAE;gBACxD,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE;oBACR,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE,CAAC,GAAG,CAAC;oBACd,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE,EAAE,GAAG,eAAe,EAAE;iBAChC;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,GAAG,CAAC,yCAAyC,IAAI,CAAC,IAAI,KAAK,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAChI,CAAC;QAED,GAAG,CAAC,4BAA4B,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,MAAM,EAAE,CAAC;YACX,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YACpC,GAAG,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,mBAAmB,IAAI,CAAC,IAAI,sBAAsB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,GAAG,CAAC,MAAM,YAAY,IAAI,YAAY,6BAA6B,CAAC,CAAC;IACrE,MAAM,QAAQ,CAAC,sBAAsB,QAAQ,WAAW,EAAE;QACxD,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE;YACR,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,EAAE,GAAG,eAAe,EAAE;SAChC;KACF,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO;QACZ,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAClG,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC9G,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QACrG,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;KAC/G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,kBAAkB,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACxE,IAAI,MAAM,EAAE,CAAC;QACX,eAAe,CAAC,WAAW,GAAG,MAAM,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC9B,GAAG,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,EAAE,eAAe,EAAE,CAAC;IAEnC,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,QAAQ,CAAC,sBAAsB,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACxF,GAAG,CAAC,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,4BAA4B,CACzC,IAA6C,EAC7C,GAA0B;IAE1B,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAErC,GAAG,CAAC,qBAAqB,SAAS,kBAAkB,CAAC,CAAC;IAEtD,MAAM,QAAQ,CAAC,sBAAsB,QAAQ,WAAW,EAAE;QACxD,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE;KACvC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAyE,iBAAiB,SAAS,EAAE,CAAC,CAAC;IAEnI,qEAAqE;IACrE,IAAI,OAAO,CAAC,QAAQ,IAAK,OAAO,CAAC,QAAoC,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;QACpG,GAAG,CAAC,aAAa,SAAS,kDAAkD,CAAC,CAAC;QAC9E,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,iBAAiB,SAAS,mBAAmB,CAC9C,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,iBAAiB,CAAC,uCAAuC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,YAAY,GAAG,MAAM;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,cAAc,IAAI,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC;SACtE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;SACxC,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,SAAS,CAAC,CAAC;IAEnB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,QAAQ,CAAC,sBAAsB,QAAQ,WAAW,EAAE;QACxD,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;KAC3D,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,uBAAuB,EAAE,YAAY,CAAC,CAAC;IAElF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,CAAC,IAAI,yBAAyB,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,cAAc,IAAI,CAAC,CAAC,SAAS,KAAK,OAAO,CAC/D,CAAC,MAAM,CAAC;IACT,MAAM,QAAQ,CAAC,iBAAiB,SAAS,SAAS,EAAE;QAClD,QAAQ,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE;QACvE,kBAAkB,EAAE,MAAM,CAAC,MAAM;QACjC,iBAAiB,EAAE,gBAAgB;KACpC,CAAC,CAAC;IAEH,GAAG,CAAC,aAAa,SAAS,iBAAiB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE3D,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAE9E,KAAK,UAAU,uBAAuB,CAAC,WAA0B;IAC/D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,WAAW;YAAE,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAa1B,yBAAyB,MAAM,EAAE,CAAC,CAAC;QAEtC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,cAAc,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5D,wDAAwD;QACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;aACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;aAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,OAAO,GAAG;YACd,aAAa,QAAQ,CAAC,cAAc,eAAe,QAAQ,CAAC,cAAc,YAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE;YACjI,cAAc,QAAQ,EAAE;YACxB,QAAQ,CAAC,eAAe,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC1E,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;gBACtD,CAAC,CAAC,EAAE;YACN,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC5D,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAClD,CAAC,CAAC,EAAE;YACN,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC5D,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAClD,CAAC,CAAC,EAAE;YACN,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC5D,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAClD,CAAC,CAAC,EAAE;SACP,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7B,OAAO;YACL,OAAO;YACP,KAAK,EAAE;gBACL,QAAQ,EAAE,QAAQ,CAAC,cAAc;gBACjC,aAAa,EAAE,QAAQ,CAAC,cAAc;gBACtC,UAAU,EAAE,QAAQ,CAAC,oBAAoB;gBACzC,UAAU,EAAE,QAAQ,CAAC,WAAW;gBAChC,UAAU,EAAE,QAAQ,CAAC,eAAe;gBACpC,cAAc,EAAE,QAAQ,CAAC,QAAQ;aAClC;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/handlers/process-launch.d.ts

@@ -0,0 +1,29 @@
+import type { JobHelpers } from 'graphile-worker';
+interface LaunchPayload {
+    mirrorId: string;
+    tool: string;
+    config: {
+        projectPath: string;
+        prompt?: string;
+        systemPrompt?: string;
+        model?: string;
+        mode: 'headless' | 'interactive';
+        timeout?: number;
+    };
+}
+/**
+ * Graphile-shaped handler for the `process_launch` task.
+ *
+ * Lifted from the legacy `eval-worker.ts:processLaunchJob`, with the queue
+ * plumbing stripped out:
+ *   - no claim — Graphile already claimed the job before invoking us
+ *   - no /complete POST — we return the launcher result (or throw)
+ *   - no surrounding try/catch — errors propagate to Graphile's retry path
+ *
+ * The dynamic import of `@rulemetric/session` is intentional: it avoids
+ * loading the launcher (and its tool-specific subprocess wrappers) unless a
+ * launch job actually fires.
+ */
+export declare function processLaunch(payload: LaunchPayload, helpers: JobHelpers): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=process-launch.d.ts.map

package/dist/lib/handlers/process-launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-launch.d.ts","sourceRoot":"","sources":["../../../src/lib/handlers/process-launch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,UAAU,GAAG,aAAa,CAAC;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+BlC"}

package/dist/lib/handlers/process-launch.js

@@ -0,0 +1,41 @@
+import { apiPatch } from '../api-client.js';
+import { PermanentJobError } from '../permanent-job-error.js';
+/**
+ * Graphile-shaped handler for the `process_launch` task.
+ *
+ * Lifted from the legacy `eval-worker.ts:processLaunchJob`, with the queue
+ * plumbing stripped out:
+ *   - no claim — Graphile already claimed the job before invoking us
+ *   - no /complete POST — we return the launcher result (or throw)
+ *   - no surrounding try/catch — errors propagate to Graphile's retry path
+ *
+ * The dynamic import of `@rulemetric/session` is intentional: it avoids
+ * loading the launcher (and its tool-specific subprocess wrappers) unless a
+ * launch job actually fires.
+ */
+export async function processLaunch(payload, helpers) {
+    const { mirrorId, tool, config } = payload;
+    const log = (msg) => helpers.logger.info(msg);
+    // Fail-fast on retry. The launcher spawns subprocesses and registers a
+    // session — re-running on Graphile retry would create a second session
+    // with no link back to the first. Until the launcher path is properly
+    // idempotent (resume from sessionId persisted to the mirror row),
+    // surface the failure to the user instead of silently double-launching.
+    // See docs/audits/2026-05-07-worker-audit.md "Handlers not idempotent".
+    if (helpers.job.attempts > 1) {
+        throw new PermanentJobError(`process_launch is not safe to retry (attempt ${helpers.job.attempts}). Re-launch manually.`);
+    }
+    log(`Launching ${tool}...`);
+    const { getLauncher } = await import('@rulemetric/session');
+    const launcher = getLauncher(tool);
+    const launcherResult = await launcher.launch(config);
+    log(`Launch completed: sessionId=${launcherResult.sessionId}`);
+    const result = { ...launcherResult };
+    // Graphile discards task return values, so persist the launcher result
+    // (sessionId, etc.) onto the mirror row. Best-effort.
+    await apiPatch(`/api/launch-jobs/${mirrorId}/state`, { result }).catch((err) => {
+        log(`result persist failed: ${err instanceof Error ? err.message : String(err)}`);
+    });
+    return result;
+}
+//# sourceMappingURL=process-launch.js.map

package/dist/lib/handlers/process-launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-launch.js","sourceRoot":"","sources":["../../../src/lib/handlers/process-launch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAe9D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAsB,EACtB,OAAmB;IAEnB,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEtD,uEAAuE;IACvE,uEAAuE;IACvE,sEAAsE;IACtE,kEAAkE;IAClE,wEAAwE;IACxE,wEAAwE;IACxE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,iBAAiB,CACzB,gDAAgD,OAAO,CAAC,GAAG,CAAC,QAAQ,wBAAwB,CAC7F,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;IAC5B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,GAAG,CAAC,+BAA+B,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;IAErC,uEAAuE;IACvE,sDAAsD;IACtD,MAAM,QAAQ,CAAC,oBAAoB,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtF,GAAG,CAAC,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/hooks-config.d.ts

@@ -19,11 +19,19 @@ export declare function generateCursorHooksConfig(): object;
  */
 export declare function generateCopilotHooksConfig(): object;
 /**
- * Write Cursor hooks config to `.cursor/hooks.json`.
+ * Write Cursor hooks config to `<projectPath>/.cursor/hooks.json`.
  * Merges with existing config — appends rulemetric hooks without duplicating.
  * Returns the config file path, or null if `.cursor/` doesn't exist.
  */
 export declare function writeCursorHooks(projectPath: string): string | null;
+/**
+ * Write Cursor hooks config to user-level `~/.cursor/hooks.json` so capture
+ * works for every Cursor conversation without per-project setup.
+ *
+ * Returns the config file path, or null if `~/.cursor/` doesn't exist
+ * (i.e., Cursor has never been launched on this machine).
+ */
+export declare function writeCursorUserHooks(): string | null;
 /**
  * Write Copilot Agent hooks config to `.github/hooks/rulemetric.json`.
  * Creates the hooks directory if needed.
@@ -31,11 +39,13 @@ export declare function writeCursorHooks(projectPath: string): string | null;
  */
 export declare function writeCopilotHooks(projectPath: string): string | null;
 /**
- * Remove rulemetric hooks from `.cursor/hooks.json`.
- * Preserves other hooks and removes empty event arrays.
- * Returns true if changes were made.
+ * Remove rulemetric hooks from `<projectPath>/.cursor/hooks.json`.
  */
 export declare function removeCursorHooks(projectPath: string): boolean;
+/**
+ * Remove rulemetric hooks from user-level `~/.cursor/hooks.json`.
+ */
+export declare function removeCursorUserHooks(): boolean;
 /**
  * Write Cursor proxy config to `.cursor/settings.json`.
  * Sets `http.proxy` and `http.proxyStrictSSL` while preserving existing settings.
@@ -92,4 +102,18 @@ export declare function writeVSCodeUserProxyConfig(gatewayPort: number): boolean
  * Remove RuleMetric proxy config from VS Code user settings.
  */
 export declare function removeVSCodeUserProxyConfig(): boolean;
+/**
+ * Set http.proxy in Cursor user settings (not workspace). Mirrors
+ * `writeVSCodeUserProxyConfig` — workspace-level http.proxy is silently
+ * ignored due to APPLICATION-scope restriction (Cursor inherits this from
+ * VS Code, see microsoft/vscode#236932).
+ *
+ * Returns true if config was written, false if Cursor isn't installed
+ * (User dir absent) or the user already has a non-localhost proxy set.
+ */
+export declare function writeCursorUserProxyConfig(gatewayPort: number): boolean;
+/**
+ * Remove RuleMetric proxy config from Cursor user settings.
+ */
+export declare function removeCursorUserProxyConfig(): boolean;
 //# sourceMappingURL=hooks-config.d.ts.map

package/dist/lib/hooks-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-config.d.ts","sourceRoot":"","sources":["../../src/lib/hooks-config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,eAAe,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAYxE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAqBlD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAkBnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+CnE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAyC9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc1G;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoB1G;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CA6BpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAQ/D;AAYD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6CnF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAmBhD;AAgBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAmBvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAcrD"}
+{"version":3,"file":"hooks-config.d.ts","sourceRoot":"","sources":["../../src/lib/hooks-config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,eAAe,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAYxE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAqDlD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAkBnD;AAsDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcpE;AAiDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc1G;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoB1G;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CA6BpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAQ/D;AAYD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6CnF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAmBhD;AAgBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAmBvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAcrD;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAkBvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAcrD"}