@rulemetric/cli 0.2.0 → 0.2.2

package/dist/chunk-XC6M4CSW.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/dashboard/panels/friction.tsx"],
+  "sourcesContent": ["import React from 'react';\nimport { Text } from 'ink';\nimport { ORANGE, RED, DIM } from '../types.js';\nimport type { ApiInsights } from '../types.js';\nimport { Panel, HBar, fit, friendlyLabel } from './shared.js';\n\nexport function FrictionPanel({ api, width, barWidth }: {\n  api: ApiInsights | null; width: number; barWidth: number;\n}) {\n  if (!api) {\n    return (\n      <Panel title=\"Friction Points\" color={RED} width={width}>\n        <Text dimColor>API offline \u2014 no friction data</Text>\n      </Panel>\n    );\n  }\n\n  const friction = api.friction ?? {};\n  const sorted = Object.entries(friction).sort(([, a], [, b]) => b - a);\n  if (sorted.length === 0) {\n    return (\n      <Panel title=\"Friction Points\" color={ORANGE} width={width}>\n        <Text dimColor>No friction detected \u2014 nice!</Text>\n      </Panel>\n    );\n  }\n\n  const max = sorted[0][1];\n  const total = sorted.reduce((s, [, v]) => s + v, 0);\n  const nw = Math.max(8, width - barWidth - 20);\n\n  return (\n    <Panel title={`Friction Points (${total} incidents)`} color={RED} width={width}>\n      {sorted.map(([key, value]) => {\n        const pct = total > 0 ? Math.round((value / total) * 100) : 0;\n        return (\n          <Text key={key} wrap=\"truncate-end\">\n            <HBar value={value} max={max} width={barWidth} />\n            <Text color={ORANGE}> {fit(friendlyLabel(key), nw)}</Text>\n            <Text>{String(value).padStart(5)}</Text>\n            <Text dimColor>{String(pct + '%').padStart(5)}</Text>\n          </Text>\n        );\n      })}\n    </Panel>\n  );\n}\n"],
+  "mappings": ";;;;;;;;;;;;AACA,SAAS,YAAY;AAWb,cA0BI,YA1BJ;AAND,SAAS,cAAc,EAAE,KAAK,OAAO,SAAS,GAElD;AACD,MAAI,CAAC,KAAK;AACR,WACE,oBAAC,SAAM,OAAM,mBAAkB,OAAO,KAAK,OACzC,8BAAC,QAAK,UAAQ,MAAC,iDAA8B,GAC/C;AAAA,EAEJ;AAEA,QAAM,WAAW,IAAI,YAAY,CAAC;AAClC,QAAM,SAAS,OAAO,QAAQ,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC;AACpE,MAAI,OAAO,WAAW,GAAG;AACvB,WACE,oBAAC,SAAM,OAAM,mBAAkB,OAAO,QAAQ,OAC5C,8BAAC,QAAK,UAAQ,MAAC,+CAA4B,GAC7C;AAAA,EAEJ;AAEA,QAAM,MAAM,OAAO,CAAC,EAAE,CAAC;AACvB,QAAM,QAAQ,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,GAAG,CAAC;AAClD,QAAM,KAAK,KAAK,IAAI,GAAG,QAAQ,WAAW,EAAE;AAE5C,SACE,oBAAC,SAAM,OAAO,oBAAoB,KAAK,eAAe,OAAO,KAAK,OAC/D,iBAAO,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAC5B,UAAM,MAAM,QAAQ,IAAI,KAAK,MAAO,QAAQ,QAAS,GAAG,IAAI;AAC5D,WACE,qBAAC,QAAe,MAAK,gBACnB;AAAA,0BAAC,QAAK,OAAc,KAAU,OAAO,UAAU;AAAA,MAC/C,qBAAC,QAAK,OAAO,QAAQ;AAAA;AAAA,QAAE,IAAI,cAAc,GAAG,GAAG,EAAE;AAAA,SAAE;AAAA,MACnD,oBAAC,QAAM,iBAAO,KAAK,EAAE,SAAS,CAAC,GAAE;AAAA,MACjC,oBAAC,QAAK,UAAQ,MAAE,iBAAO,MAAM,GAAG,EAAE,SAAS,CAAC,GAAE;AAAA,SAJrC,GAKX;AAAA,EAEJ,CAAC,GACH;AAEJ;",
+  "names": []
+}

package/dist/chunk-XPUEGHXN.js

@@ -0,0 +1,243 @@
+import {
+  AT_A_GLANCE_PROMPT,
+  FACET_GENERATION_PROMPT,
+  RECOMMENDATION_PROMPTS
+} from "./chunk-XZXS2W24.js";
+import {
+  PermanentJobError
+} from "./chunk-DGHWRQXL.js";
+import {
+  detectLlmBackend,
+  runLlmPrompt,
+  runToolPrompt
+} from "./chunk-FZKLLNDS.js";
+import {
+  apiGet,
+  apiPatch,
+  apiPost
+} from "./chunk-EJOI2ZGU.js";
+
+// src/lib/handlers/process-insights.ts
+async function processInsights(payload, helpers) {
+  const { mirrorId, projectPath, projectId, config } = payload;
+  const log = (msg) => helpers.logger.info(msg);
+  if (config?.sessionId) {
+    return processSessionAnalysisInline({ mirrorId, sessionId: config.sessionId }, log);
+  }
+  log(`Processing insights job ${mirrorId}...`);
+  await apiPatch(`/api/insights-jobs/${mirrorId}/progress`, {
+    status: "running",
+    progress: { step: "reading_data" }
+  });
+  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)}`);
+  }
+  const data = await buildDataSummaryFromApi(projectPath, projectId);
+  if (!data) {
+    throw new PermanentJobError(
+      "No session data found \u2014 ensure sessions are captured and enriched."
+    );
+  }
+  log(`  Found ${data.stats.sessions} sessions, generating recommendations...`);
+  const FACET_BATCH_SIZE = 20;
+  const FACET_HARD_CAP = 200;
+  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++;
+          }
+        }
+        if (unfaceted.length < FACET_BATCH_SIZE) break;
+      }
+    } catch (facetErr) {
+      log(`  Warning: facet generation failed after ${totalFaceted} sessions: ${facetErr instanceof Error ? facetErr.message : String(facetErr)}`);
+    }
+  }
+  const recommendations = {};
+  const totalPrompts = RECOMMENDATION_PROMPTS.length + 1;
+  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 result2 = await runLlmPrompt(spec.prompt, data.summary, spec.maxTokens);
+    if (result2) {
+      recommendations[spec.name] = result2;
+      log(`  Got result for ${spec.name}`);
+    } else {
+      log(`  No result for ${spec.name} (LLM returned null)`);
+    }
+  }
+  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 ? `
+## What Works
+${JSON.stringify(recommendations.what_works)}` : "",
+    recommendations.friction_analysis ? `
+## Friction
+${JSON.stringify(recommendations.friction_analysis)}` : "",
+    recommendations.suggestions ? `
+## Suggestions
+${JSON.stringify(recommendations.suggestions)}` : "",
+    recommendations.on_the_horizon ? `
+## On the Horizon
+${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 };
+  await apiPatch(`/api/insights-jobs/${mirrorId}/state`, { result }).catch((err) => {
+    log(`result persist failed: ${err instanceof Error ? err.message : String(err)}`);
+  });
+  return result;
+}
+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}`);
+  if (session.analysis && session.analysis.source === "session_analysis") {
+    log(`  Session ${sessionId} already analyzed \u2014 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 }
+  });
+  const facets = runToolPrompt(session.tool, FACET_GENERATION_PROMPT, eventSummary);
+  if (!facets) {
+    throw new Error(`Analysis failed \u2014 ${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 };
+}
+async function buildDataSummaryFromApi(projectPath, projectId) {
+  try {
+    const params = new URLSearchParams();
+    if (projectId) {
+      params.set("projectId", projectId);
+    } else if (projectPath) {
+      params.set("projectPath", projectPath);
+    }
+    const computed = await apiGet(`/api/insights/compute?${params}`);
+    if (!computed || computed.total_sessions === 0) return null;
+    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;
+  }
+}
+
+export {
+  processInsights
+};
+//# sourceMappingURL=chunk-XPUEGHXN.js.map

package/dist/chunk-XPUEGHXN.js.map

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

package/dist/chunk-XZXS2W24.js

@@ -0,0 +1,148 @@
+// src/lib/insights-prompts.ts
+var RECOMMENDATION_PROMPTS = [
+  {
+    name: "project_areas",
+    prompt: `Analyze this Claude Code usage data and identify project areas.
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "areas": [
+    {"name": "Area name", "session_count": N, "description": "2-3 sentences about what was worked on and how Claude Code was used."}
+  ]
+}
+Include 4-5 areas. Skip internal CC operations.`,
+    maxTokens: 8192
+  },
+  {
+    name: "interaction_style",
+    prompt: `Analyze this Claude Code usage data and describe the user's interaction style.
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "narrative": "2-3 paragraphs analyzing HOW the user interacts with Claude Code. Use second person 'you'. Describe patterns: iterate quickly vs detailed upfront specs? Interrupt often or let Claude run? Include specific examples. Use **bold** for key insights.",
+  "key_pattern": "One sentence summary of most distinctive interaction style"
+}`,
+    maxTokens: 8192
+  },
+  {
+    name: "what_works",
+    prompt: `Analyze this Claude Code usage data and identify what's working well for this user. Use second person ("you").
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "intro": "1 sentence of context",
+  "impressive_workflows": [
+    {"title": "Short title (3-6 words)", "description": "2-3 sentences describing the impressive workflow or approach. Use 'you' not 'the user'."}
+  ]
+}
+Include 3 impressive workflows.`,
+    maxTokens: 8192
+  },
+  {
+    name: "friction_analysis",
+    prompt: `Analyze this Claude Code usage data and identify friction points for this user. Use second person ("you").
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "intro": "1 sentence summarizing friction patterns",
+  "categories": [
+    {"category": "Concrete category name", "description": "1-2 sentences explaining this category and what could be done differently. Use 'you' not 'the user'.", "examples": ["Specific example with consequence", "Another example"]}
+  ]
+}
+Include 3 friction categories with 2 examples each.`,
+    maxTokens: 8192
+  },
+  {
+    name: "suggestions",
+    prompt: `Analyze this Claude Code usage data and suggest improvements.
+## CC FEATURES REFERENCE (pick from these for features_to_try):
+1. **MCP Servers**: Connect Claude to external tools, databases, and APIs via Model Context Protocol.
+   - How to use: Run \`claude mcp add <server-name> -- <command>\`
+2. **Custom Skills**: Reusable prompts you define as markdown files that run with a single /command.
+   - How to use: Create \`.claude/skills/commit/SKILL.md\` with instructions. Then type \`/commit\` to run it.
+3. **Hooks**: Shell commands that auto-run at specific lifecycle events.
+   - How to use: Add to \`.claude/settings.json\` under "hooks" key.
+4. **Headless Mode**: Run Claude non-interactively from scripts and CI/CD.
+   - How to use: \`claude -p "fix lint errors" --allowedTools "Edit,Read,Bash"\`
+5. **Task Agents**: Claude spawns focused sub-agents for complex exploration or parallel work.
+   - How to use: Claude auto-invokes when helpful, or ask "use an agent to explore X"
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "claude_md_additions": [
+    {"addition": "A specific line or block to add to CLAUDE.md", "why": "1 sentence explaining why", "prompt_scaffold": "Instructions for where to add this"}
+  ],
+  "features_to_try": [
+    {"feature": "Feature name from above", "one_liner": "What it does", "why_for_you": "Why this would help YOU", "example_code": "Actual command or config to copy"}
+  ],
+  "usage_patterns": [
+    {"title": "Short title", "suggestion": "1-2 sentence summary", "detail": "3-4 sentences explaining how this applies", "copyable_prompt": "A specific prompt to copy and try"}
+  ]
+}
+Include 2-3 items for each category.`,
+    maxTokens: 8192
+  },
+  {
+    name: "on_the_horizon",
+    prompt: `Analyze this Claude Code usage data and identify future opportunities.
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "intro": "1 sentence about evolving AI-assisted development",
+  "opportunities": [
+    {"title": "Short title (4-8 words)", "whats_possible": "2-3 ambitious sentences about autonomous workflows", "how_to_try": "1-2 sentences mentioning relevant tooling", "copyable_prompt": "Detailed prompt to try"}
+  ]
+}
+Include 3 opportunities. Think BIG - autonomous workflows, parallel agents, iterating against tests.`,
+    maxTokens: 8192
+  },
+  {
+    name: "fun_ending",
+    prompt: `Analyze this Claude Code usage data and find a memorable moment.
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "headline": "A memorable QUALITATIVE moment from the transcripts - not a statistic. Something human, funny, or surprising.",
+  "detail": "Brief context about when/where this happened"
+}
+Find something genuinely interesting or amusing from the session summaries.`,
+    maxTokens: 8192
+  }
+];
+var AT_A_GLANCE_PROMPT = `You're writing an "At a Glance" summary for a Claude Code usage insights report.
+Use this 4-part structure:
+1. **What's working** - What is the user's unique style and what impactful things have they done? Don't be fluffy.
+2. **What's hindering you** - Split into (a) Claude's fault and (b) user-side friction. Be honest but constructive.
+3. **Quick wins to try** - Specific Claude Code features they could try, or a compelling workflow technique.
+4. **Ambitious workflows for better models** - As models improve, what workflows should they prepare for?
+Keep each section to 2-3 sentences. Use a coaching tone.
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "whats_working": "(refer to instructions above)",
+  "whats_hindering": "(refer to instructions above)",
+  "quick_wins": "(refer to instructions above)",
+  "ambitious_workflows": "(refer to instructions above)"
+}`;
+var FACET_GENERATION_PROMPT = `Analyze this coding session and produce a structured analysis.
+The session is from a non-Claude-Code tool, so analyze the conversation and tool usage patterns.
+
+RESPOND WITH ONLY A VALID JSON OBJECT:
+{
+  "underlying_goal": "1-2 sentence description of what the user was trying to accomplish",
+  "goal_categories": {"category": count},
+  "outcome": "achieved|mostly_achieved|partially_achieved|not_achieved|abandoned",
+  "session_type": "quick_task|iterative_refinement|exploration|debugging|greenfield",
+  "friction_counts": {"wrong_approach": 0, "tool_failure": 0, "excessive_changes": 0, "misunderstanding": 0},
+  "friction_detail": "Brief description of any friction encountered, or empty string",
+  "primary_success": "Brief description of main achievement, or empty string",
+  "brief_summary": "2-3 sentence summary of the session"
+}
+
+Goal categories to use: debugging, feature_development, refactoring, testing, documentation, investigation, exploration, code_review, deployment, configuration, end_to_end_testing, logging_documentation, ui_testing.
+
+Outcome guide:
+- achieved: Task completed successfully
+- mostly_achieved: Main goal done but minor items remain
+- partially_achieved: Some progress but significant work left
+- not_achieved: Attempted but failed
+- abandoned: User gave up or switched tasks`;
+
+export {
+  RECOMMENDATION_PROMPTS,
+  AT_A_GLANCE_PROMPT,
+  FACET_GENERATION_PROMPT
+};
+//# sourceMappingURL=chunk-XZXS2W24.js.map

package/dist/chunk-XZXS2W24.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/insights-prompts.ts"],
+  "sourcesContent": ["/**\n * Recommendation prompts matching Claude Code's /insights structure.\n * Each prompt is sent to `claude -p` with the aggregated stats data.\n */\n\nexport interface PromptSpec {\n  name: string;\n  prompt: string;\n  maxTokens: number;\n}\n\nexport const RECOMMENDATION_PROMPTS: PromptSpec[] = [\n  {\n    name: 'project_areas',\n    prompt: `Analyze this Claude Code usage data and identify project areas.\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"areas\": [\n    {\"name\": \"Area name\", \"session_count\": N, \"description\": \"2-3 sentences about what was worked on and how Claude Code was used.\"}\n  ]\n}\nInclude 4-5 areas. Skip internal CC operations.`,\n    maxTokens: 8192,\n  },\n  {\n    name: 'interaction_style',\n    prompt: `Analyze this Claude Code usage data and describe the user's interaction style.\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"narrative\": \"2-3 paragraphs analyzing HOW the user interacts with Claude Code. Use second person 'you'. Describe patterns: iterate quickly vs detailed upfront specs? Interrupt often or let Claude run? Include specific examples. Use **bold** for key insights.\",\n  \"key_pattern\": \"One sentence summary of most distinctive interaction style\"\n}`,\n    maxTokens: 8192,\n  },\n  {\n    name: 'what_works',\n    prompt: `Analyze this Claude Code usage data and identify what's working well for this user. Use second person (\"you\").\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"intro\": \"1 sentence of context\",\n  \"impressive_workflows\": [\n    {\"title\": \"Short title (3-6 words)\", \"description\": \"2-3 sentences describing the impressive workflow or approach. Use 'you' not 'the user'.\"}\n  ]\n}\nInclude 3 impressive workflows.`,\n    maxTokens: 8192,\n  },\n  {\n    name: 'friction_analysis',\n    prompt: `Analyze this Claude Code usage data and identify friction points for this user. Use second person (\"you\").\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"intro\": \"1 sentence summarizing friction patterns\",\n  \"categories\": [\n    {\"category\": \"Concrete category name\", \"description\": \"1-2 sentences explaining this category and what could be done differently. Use 'you' not 'the user'.\", \"examples\": [\"Specific example with consequence\", \"Another example\"]}\n  ]\n}\nInclude 3 friction categories with 2 examples each.`,\n    maxTokens: 8192,\n  },\n  {\n    name: 'suggestions',\n    prompt: `Analyze this Claude Code usage data and suggest improvements.\n## CC FEATURES REFERENCE (pick from these for features_to_try):\n1. **MCP Servers**: Connect Claude to external tools, databases, and APIs via Model Context Protocol.\n   - How to use: Run \\`claude mcp add <server-name> -- <command>\\`\n2. **Custom Skills**: Reusable prompts you define as markdown files that run with a single /command.\n   - How to use: Create \\`.claude/skills/commit/SKILL.md\\` with instructions. Then type \\`/commit\\` to run it.\n3. **Hooks**: Shell commands that auto-run at specific lifecycle events.\n   - How to use: Add to \\`.claude/settings.json\\` under \"hooks\" key.\n4. **Headless Mode**: Run Claude non-interactively from scripts and CI/CD.\n   - How to use: \\`claude -p \"fix lint errors\" --allowedTools \"Edit,Read,Bash\"\\`\n5. **Task Agents**: Claude spawns focused sub-agents for complex exploration or parallel work.\n   - How to use: Claude auto-invokes when helpful, or ask \"use an agent to explore X\"\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"claude_md_additions\": [\n    {\"addition\": \"A specific line or block to add to CLAUDE.md\", \"why\": \"1 sentence explaining why\", \"prompt_scaffold\": \"Instructions for where to add this\"}\n  ],\n  \"features_to_try\": [\n    {\"feature\": \"Feature name from above\", \"one_liner\": \"What it does\", \"why_for_you\": \"Why this would help YOU\", \"example_code\": \"Actual command or config to copy\"}\n  ],\n  \"usage_patterns\": [\n    {\"title\": \"Short title\", \"suggestion\": \"1-2 sentence summary\", \"detail\": \"3-4 sentences explaining how this applies\", \"copyable_prompt\": \"A specific prompt to copy and try\"}\n  ]\n}\nInclude 2-3 items for each category.`,\n    maxTokens: 8192,\n  },\n  {\n    name: 'on_the_horizon',\n    prompt: `Analyze this Claude Code usage data and identify future opportunities.\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"intro\": \"1 sentence about evolving AI-assisted development\",\n  \"opportunities\": [\n    {\"title\": \"Short title (4-8 words)\", \"whats_possible\": \"2-3 ambitious sentences about autonomous workflows\", \"how_to_try\": \"1-2 sentences mentioning relevant tooling\", \"copyable_prompt\": \"Detailed prompt to try\"}\n  ]\n}\nInclude 3 opportunities. Think BIG - autonomous workflows, parallel agents, iterating against tests.`,\n    maxTokens: 8192,\n  },\n  {\n    name: 'fun_ending',\n    prompt: `Analyze this Claude Code usage data and find a memorable moment.\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"headline\": \"A memorable QUALITATIVE moment from the transcripts - not a statistic. Something human, funny, or surprising.\",\n  \"detail\": \"Brief context about when/where this happened\"\n}\nFind something genuinely interesting or amusing from the session summaries.`,\n    maxTokens: 8192,\n  },\n];\n\nexport const AT_A_GLANCE_PROMPT = `You're writing an \"At a Glance\" summary for a Claude Code usage insights report.\nUse this 4-part structure:\n1. **What's working** - What is the user's unique style and what impactful things have they done? Don't be fluffy.\n2. **What's hindering you** - Split into (a) Claude's fault and (b) user-side friction. Be honest but constructive.\n3. **Quick wins to try** - Specific Claude Code features they could try, or a compelling workflow technique.\n4. **Ambitious workflows for better models** - As models improve, what workflows should they prepare for?\nKeep each section to 2-3 sentences. Use a coaching tone.\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"whats_working\": \"(refer to instructions above)\",\n  \"whats_hindering\": \"(refer to instructions above)\",\n  \"quick_wins\": \"(refer to instructions above)\",\n  \"ambitious_workflows\": \"(refer to instructions above)\"\n}`;\n\nexport const FACET_GENERATION_PROMPT = `Analyze this coding session and produce a structured analysis.\nThe session is from a non-Claude-Code tool, so analyze the conversation and tool usage patterns.\n\nRESPOND WITH ONLY A VALID JSON OBJECT:\n{\n  \"underlying_goal\": \"1-2 sentence description of what the user was trying to accomplish\",\n  \"goal_categories\": {\"category\": count},\n  \"outcome\": \"achieved|mostly_achieved|partially_achieved|not_achieved|abandoned\",\n  \"session_type\": \"quick_task|iterative_refinement|exploration|debugging|greenfield\",\n  \"friction_counts\": {\"wrong_approach\": 0, \"tool_failure\": 0, \"excessive_changes\": 0, \"misunderstanding\": 0},\n  \"friction_detail\": \"Brief description of any friction encountered, or empty string\",\n  \"primary_success\": \"Brief description of main achievement, or empty string\",\n  \"brief_summary\": \"2-3 sentence summary of the session\"\n}\n\nGoal categories to use: debugging, feature_development, refactoring, testing, documentation, investigation, exploration, code_review, deployment, configuration, end_to_end_testing, logging_documentation, ui_testing.\n\nOutcome guide:\n- achieved: Task completed successfully\n- mostly_achieved: Main goal done but minor items remain\n- partially_achieved: Some progress but significant work left\n- not_achieved: Attempted but failed\n- abandoned: User gave up or switched tasks`;\n"],
+  "mappings": ";AAWO,IAAM,yBAAuC;AAAA,EAClD;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAyBR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOR,WAAW;AAAA,EACb;AACF;AAEO,IAAM,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAe3B,IAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/chunk-YBNW7ARH.js

@@ -0,0 +1,167 @@
+import {
+  detectLlmBackend,
+  runLlmPrompt
+} from "./chunk-FZKLLNDS.js";
+import {
+  buildRecommendationPrompt
+} from "./chunk-K3BFZ7KG.js";
+import {
+  normalizeProjectPath
+} from "./chunk-EKP32DLN.js";
+import {
+  detectLanguages
+} from "./chunk-OQSQC7VB.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-EJOI2ZGU.js";
+
+// src/lib/handlers/cron-suggest-instructions.ts
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+var MAX_SUGGESTIONS_PER_PROJECT = 5;
+var MAX_PROJECTS_PER_RUN = Number(process.env.RULEMETRIC_MAX_SUGGESTION_PROJECTS ?? 10);
+var STALE_THRESHOLD_HOURS = 48;
+var MIN_SCORE = 0.5;
+var CONTENT_PREVIEW_CHARS = 400;
+async function checkSkillsRegistryStale() {
+  const registryPath = path.join(os.homedir(), ".config", "rulemetric", "skills-registry.json");
+  try {
+    const raw = readFileSync(registryPath, "utf-8");
+    const registry = JSON.parse(raw);
+    const ageMs = Date.now() - new Date(registry.generatedAt).getTime();
+    return ageMs > STALE_THRESHOLD_HOURS * 60 * 60 * 1e3;
+  } catch {
+    return true;
+  }
+}
+var cronSuggestInstructions = async (_payload, helpers) => {
+  const backend = detectLlmBackend();
+  if (backend === "none") {
+    helpers.logger.warn("No LLM backend available (claude CLI missing and ANTHROPIC_API_KEY unset); skipping suggestion compute");
+    return;
+  }
+  helpers.logger.info(`Scoring backend: ${backend}`);
+  let projectPaths;
+  try {
+    const res = await apiGet("/api/sessions/project-paths?limit=" + MAX_PROJECTS_PER_RUN);
+    projectPaths = res.projectPaths;
+  } catch (err) {
+    helpers.logger.warn(`Failed to fetch project paths: ${err instanceof Error ? err.message : String(err)}`);
+    return;
+  }
+  if (projectPaths.length === 0) {
+    helpers.logger.info("No recent project paths; nothing to score");
+    return;
+  }
+  const projectIdByPath = /* @__PURE__ */ new Map();
+  try {
+    const projRes = await apiGet("/api/projects?limit=200");
+    for (const p of projRes.projects ?? []) {
+      if (p.primaryCheckoutPath) {
+        projectIdByPath.set(normalizeProjectPath(p.primaryCheckoutPath), p.id);
+      }
+    }
+  } catch (err) {
+    helpers.logger.warn(`Failed to fetch projects for id resolution: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const candidates = /* @__PURE__ */ new Map();
+  try {
+    const catalogRows = await apiGet("/api/catalog?limit=200");
+    for (const row of catalogRows) {
+      candidates.set(row.id, {
+        id: row.id,
+        name: row.name,
+        description: row.description ?? "",
+        tags: row.tags ?? [],
+        contentPreview: (row.content ?? "").slice(0, CONTENT_PREVIEW_CHARS)
+      });
+    }
+  } catch (err) {
+    helpers.logger.warn(`Failed to fetch catalog: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  try {
+    const personalRes = await apiGet("/api/instructions?limit=100");
+    for (const row of personalRes.instructions ?? []) {
+      if (!candidates.has(row.id)) {
+        candidates.set(row.id, {
+          id: row.id,
+          name: row.name,
+          description: row.description ?? "",
+          tags: row.tags ?? [],
+          contentPreview: (row.content ?? "").slice(0, CONTENT_PREVIEW_CHARS)
+        });
+      }
+    }
+  } catch (err) {
+    helpers.logger.warn(`Failed to fetch personal instructions: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const candidateList = [...candidates.values()];
+  if (candidateList.length === 0) {
+    helpers.logger.info("No candidate instructions; nothing to score");
+    return;
+  }
+  helpers.logger.info(`Scoring ${candidateList.length} candidates across ${projectPaths.length} project(s)`);
+  let scored = 0;
+  for (const rawPath of projectPaths) {
+    try {
+      const projectPath = normalizeProjectPath(rawPath);
+      const languages = detectLanguages(projectPath);
+      if (languages.length === 0) {
+        helpers.logger.info(`Skipping ${projectPath}: insufficient language signals`);
+        continue;
+      }
+      const context = {
+        name: path.basename(projectPath),
+        description: null,
+        languages,
+        topics: [],
+        dependencies: []
+      };
+      const prompt = buildRecommendationPrompt(context, candidateList);
+      const parsed = await runLlmPrompt(prompt, "", 4096);
+      if (!parsed) {
+        helpers.logger.warn(`LLM returned null for ${projectPath} (backend ${backend})`);
+        continue;
+      }
+      const raw = parsed.recommendations ?? [];
+      const recommendations = raw.filter((r) => typeof r.instructionId === "string" && typeof r.score === "number" && typeof r.reason === "string").map((r) => ({
+        instructionId: r.instructionId,
+        score: r.score,
+        reason: r.reason
+      }));
+      const top = recommendations.filter((r) => r.score >= MIN_SCORE).sort((a, b) => b.score - a.score).slice(0, MAX_SUGGESTIONS_PER_PROJECT);
+      if (top.length === 0) {
+        helpers.logger.info(`No suggestions over threshold for ${projectPath}`);
+        continue;
+      }
+      const projectId = projectIdByPath.get(projectPath);
+      await apiPost("/api/instruction-suggestions/batch-upsert", {
+        projectPath,
+        ...projectId ? { projectId } : {},
+        suggestions: top.map((r) => ({
+          instructionId: r.instructionId,
+          score: r.score,
+          reason: r.reason
+        }))
+      });
+      scored++;
+    } catch (err) {
+      helpers.logger.warn(`Failed to score ${rawPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  if (await checkSkillsRegistryStale()) {
+    try {
+      await apiPost("/api/instruction-suggestions/mark-stale", {});
+      helpers.logger.warn("Skills registry is stale (>48h); marked all suggestions stale");
+    } catch {
+    }
+  }
+  helpers.logger.info(`Done: scored ${scored}/${projectPaths.length} projects`);
+};
+
+export {
+  cronSuggestInstructions
+};
+//# sourceMappingURL=chunk-YBNW7ARH.js.map