@skillrecordings/cli 0.17.0 → 0.18.0

package/dist/index.js

@@ -56,8 +56,10 @@ import "./chunk-F4EM72IH.js";
 import {
   addShellIntegration,
   autoBootstrapKeychain,
+  getFromKeychain,
   getKeychainStatus,
   isKeychainSupported,
+  isOpCliAvailable,
   storeInKeychain
 } from "./chunk-7SQU7KCI.js";
 import {
@@ -74618,9 +74620,9 @@ function parseEnvContent(content) {
   return env;
 }
 async function decryptEnvFile(encryptedPath) {
-  const { existsSync: existsSync15 } = await import("fs");
+  const { existsSync: existsSync17 } = await import("fs");
   const { readFile: readFile10 } = await import("fs/promises");
-  if (!existsSync15(encryptedPath)) {
+  if (!existsSync17(encryptedPath)) {
     return {};
   }
   const ageKey = await getAgeKeyFrom1Password();
@@ -74641,8 +74643,8 @@ async function getAgeKeyFrom1Password() {
     return process.env.SKILL_AGE_KEY;
   }
   try {
-    const { getFromKeychain, storeInKeychain: storeInKeychain2, autoBootstrapKeychain: autoBootstrapKeychain2 } = await import("./keychain-IEZHT5WN.js");
-    const fromKeychain = getFromKeychain("age-private-key");
+    const { getFromKeychain: getFromKeychain2, storeInKeychain: storeInKeychain2, autoBootstrapKeychain: autoBootstrapKeychain2 } = await import("./keychain-IEZHT5WN.js");
+    const fromKeychain = getFromKeychain2("age-private-key");
     if (fromKeychain) return fromKeychain;
     let opToken = process.env.OP_SERVICE_ACCOUNT_TOKEN;
     if (!opToken) {
@@ -74750,7 +74752,7 @@ var ROOT_DESCRIPTIONS = {
   minimal: "Skill Recordings support agent CLI. Try: skill wizard, skill keys, skill front inbox, skill front triage. Use --help for details."
 };
 var FRONT_DESCRIPTIONS = {
-  full: "Front conversations, inboxes, tags, archival, and reporting.\n\n  Start here:\n    skill front inbox                    See unassigned conversations\n    skill front inbox support             List conversations in a specific inbox\n    skill front triage                    AI-powered categorization of inbox items\n\n  Investigate a conversation:\n    skill front conversation <id> -m      Full conversation with messages\n    skill front message <id>              Single message details + body\n\n  Take action:\n    skill front assign <id>               Assign to a teammate\n    skill front reply <id>                Draft a reply (HITL, never auto-sends)\n    skill front tag <id>                  Add a tag\n    skill front archive <id>              Archive a resolved conversation\n\n  Bulk operations:\n    skill front bulk-archive              Archive old/spam conversations\n    skill front report                    Volume + tag + sender forensics\n\n  All commands accept --json for HATEOAS-enriched output with _links and _actions.",
+  full: "Front conversations, inboxes, tags, archival, and reporting.\n\n  Start here:\n    skill front inbox                    See unassigned conversations\n    skill front inbox support             List conversations in a specific inbox\n    skill front triage                    AI-powered categorization of inbox items\n\n  Investigate a conversation:\n    skill front conversation <id> -m      Full conversation with messages\n    skill front message <id>              Single message details + body\n\n  Take action:\n    skill front assign <id>               Assign to a teammate\n    skill front reply <id>                Draft a reply (HITL, never auto-sends)\n    skill front tag <id>                  Add a tag\n    skill front archive <id>              Archive a resolved conversation\n\n  Bulk operations:\n    skill front bulk-archive              Archive old/spam conversations\n    skill front report                    Volume + tag + sender forensics\n\n  All commands accept --json for HATEOAS-enriched output with _links and _actions.\n\n  Environment: FRONT_API_TOKEN required. Run `skill doctor` to check.",
   abbreviated: "Front API workflows for inbox triage and conversation actions.\n\n  Common:\n    skill front inbox\n    skill front triage\n    skill front conversation <id> -m\n    skill front reply <id>\n    skill front archive <id>",
   minimal: "Front API commands (inbox, triage, assign, reply, archive)."
 };
@@ -74760,7 +74762,7 @@ var AUTH_DESCRIPTIONS = {
   minimal: "Auth status commands (auth status, auth whoami)."
 };
 var INNGEST_DESCRIPTIONS = {
-  full: "Inngest event and workflow commands.\n\n  Debug pipeline runs:\n    skill inngest runs --status failed --after 1h    Recent failures\n    skill inngest events --after 12h                 Recent events\n    skill inngest investigate <run-id>                Deep-dive a specific run",
+  full: "Inngest event and workflow commands.\n\n  Debug pipeline runs:\n    skill inngest runs --status failed --after 1h    Recent failures\n    skill inngest events --after 12h                 Recent events\n    skill inngest investigate <run-id>                Deep-dive a specific run\n\n  Environment: INNGEST_SIGNING_KEY required. Run `skill doctor` to check.",
   abbreviated: "Inngest events and workflow runs.\n\n  Common:\n    skill inngest runs --status failed --after 1h\n    skill inngest events --after 12h\n    skill inngest investigate <run-id>",
   minimal: "Inngest events and runs debugging."
 };
@@ -76836,7 +76838,9 @@ async function listApprovals(ctx, options) {
   }
 }
 function registerAxiomCommands(program3) {
-  const axiom = program3.command("axiom").description("Query Axiom logs and traces");
+  const axiom = program3.command("axiom").description(
+    "Query Axiom logs and traces.\n  Environment: AXIOM_TOKEN required. Run `skill doctor` to check."
+  );
   axiom.command("query").description("Run a raw APL query").argument("<apl>", "APL query string").option("-s, --since <time>", "Time range (e.g., 1h, 24h, 7d)", "24h").option("--json", "Output as JSON").action(async (apl, options, command) => {
     const opts = typeof command.optsWithGlobals === "function" ? command.optsWithGlobals() : {
       ...command.parent?.opts(),
@@ -77074,11 +77078,11 @@ Saved to ${options.output}`);
   }
 }
 async function toEvalite(options) {
-  const { readFileSync: readFileSync13 } = await import("fs");
+  const { readFileSync: readFileSync14 } = await import("fs");
   const { ctx } = options;
   const outputJson = ctx.format === "json";
   const data2 = JSON.parse(
-    readFileSync13(options.input, "utf-8")
+    readFileSync14(options.input, "utf-8")
   );
   const evaliteData = data2.map((d) => ({
     input: d.triggerMessage.body,
@@ -77882,6 +77886,170 @@ function registerDeployCommands(program3) {
   });
 }
 
+// src/commands/doctor.ts
+init_esm_shims();
+import { execSync as execSync3 } from "child_process";
+import { existsSync as existsSync6 } from "fs";
+import { join as join3 } from "path";
+var REQUIRED_ENV_VARS = [
+  "DATABASE_URL",
+  "INNGEST_SIGNING_KEY",
+  "INNGEST_EVENT_KEY",
+  "FRONT_API_TOKEN",
+  "LINEAR_API_KEY",
+  "AXIOM_TOKEN",
+  "SLACK_BOT_TOKEN",
+  "UPSTASH_REDIS_REST_URL",
+  "UPSTASH_VECTOR_REST_URL"
+];
+function checkEnvVars() {
+  return REQUIRED_ENV_VARS.map((varName) => {
+    const value = process.env[varName];
+    return {
+      name: varName,
+      status: value ? "ok" : "warn",
+      message: value ? void 0 : "Not set"
+    };
+  });
+}
+function checkKeychain() {
+  const checks = [];
+  const opAvailable = isOpCliAvailable();
+  checks.push({
+    name: "op CLI",
+    status: opAvailable ? "ok" : "warn",
+    message: opAvailable ? void 0 : "Not installed or not authenticated"
+  });
+  const opToken = getFromKeychain("op-service-account-token");
+  checks.push({
+    name: "op-service-account-token",
+    status: opToken ? "ok" : "warn",
+    message: opToken ? void 0 : "Not found in keychain"
+  });
+  const ageKey = getFromKeychain("age-private-key");
+  checks.push({
+    name: "age-private-key",
+    status: ageKey ? "ok" : "warn",
+    message: ageKey ? void 0 : "Not found in keychain"
+  });
+  return checks;
+}
+function checkTools() {
+  const checks = [];
+  try {
+    execSync3("gh auth status", { stdio: "pipe", timeout: 3e3 });
+    checks.push({
+      name: "gh CLI",
+      status: "ok"
+    });
+  } catch {
+    checks.push({
+      name: "gh CLI",
+      status: "warn",
+      message: "Not installed or not authenticated"
+    });
+  }
+  return checks;
+}
+function checkWorkspace() {
+  const checks = [];
+  const hivePath = join3(process.cwd(), ".hive");
+  const hiveExists = existsSync6(hivePath);
+  checks.push({
+    name: ".hive directory",
+    status: hiveExists ? "ok" : "warn",
+    message: hiveExists ? void 0 : "Not found in current directory"
+  });
+  return checks;
+}
+function runHealthChecks() {
+  const categories = [
+    {
+      category: "Environment",
+      checks: checkEnvVars()
+    },
+    {
+      category: "Keychain",
+      checks: checkKeychain()
+    },
+    {
+      category: "Tools",
+      checks: checkTools()
+    },
+    {
+      category: "Workspace",
+      checks: checkWorkspace()
+    }
+  ];
+  let total = 0;
+  let ok = 0;
+  let warn = 0;
+  let fail = 0;
+  for (const category of categories) {
+    for (const check of category.checks) {
+      total++;
+      if (check.status === "ok") ok++;
+      else if (check.status === "warn") warn++;
+      else fail++;
+    }
+  }
+  let status;
+  if (fail > 0) {
+    status = "unhealthy";
+  } else if (warn > 3) {
+    status = "degraded";
+  } else {
+    status = "healthy";
+  }
+  return {
+    status,
+    categories,
+    summary: { total, ok, warn, fail }
+  };
+}
+function formatTextOutput(results) {
+  console.log("\n\u{1FA7A} Health Check Results\n");
+  for (const category of results.categories) {
+    console.log(`${category.category}:`);
+    for (const check of category.checks) {
+      const symbol = check.status === "ok" ? "\u2713" : check.status === "warn" ? "\u26A0" : "\u2717";
+      const line = check.message ? `  ${symbol} ${check.name} - ${check.message}` : `  ${symbol} ${check.name}`;
+      console.log(line);
+    }
+    console.log("");
+  }
+  console.log("\u2500".repeat(60));
+  console.log(
+    `Summary: ${results.summary.ok}/${results.summary.total} checks passed`
+  );
+  if (results.summary.warn > 0) {
+    console.log(`\u26A0 ${results.summary.warn} warnings`);
+  }
+  if (results.summary.fail > 0) {
+    console.log(`\u2717 ${results.summary.fail} failures`);
+  }
+  console.log(`
+Overall status: ${results.status.toUpperCase()}`);
+  console.log("");
+}
+function registerDoctorCommand(program3) {
+  program3.command("doctor").description(
+    "Run health checks on environment and tools\n\n  Checks:\n  - Environment variables\n  - Keychain secrets\n  - CLI tools (gh, op)\n  - Workspace setup (.hive)\n\n  Examples:\n    skill doctor\n    skill doctor --json"
+  ).option("--json", "Output as JSON").action(async (options, command) => {
+    const ctx = await createContext({
+      format: options.json ? "json" : "text",
+      verbose: command.optsWithGlobals().verbose,
+      quiet: command.optsWithGlobals().quiet
+    });
+    const results = runHealthChecks();
+    if (options.json || ctx.format === "json") {
+      ctx.output.data(results);
+    } else {
+      formatTextOutput(results);
+    }
+  });
+}
+
 // src/commands/eval.ts
 init_esm_shims();
 import { access, readFile as readFile2 } from "fs/promises";
@@ -79889,12 +80057,12 @@ async function scoreProduction(ctx, options) {
 
 // src/commands/eval-local/seed.ts
 init_esm_shims();
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 import { glob as glob3 } from "glob";
 
 // src/lib/eval-seed.ts
 init_esm_shims();
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import { readFile as readFile5, readdir } from "fs/promises";
 import { glob as glob2 } from "glob";
 import matter from "gray-matter";
@@ -79940,7 +80108,7 @@ async function loadJsonFiles(dirPath) {
     const jsonFiles = files.filter((f) => f.endsWith(".json"));
     const items = await Promise.all(
       jsonFiles.map(async (file) => {
-        const content = await readFile5(join3(dirPath, file), "utf-8");
+        const content = await readFile5(join4(dirPath, file), "utf-8");
         return JSON.parse(content);
       })
     );
@@ -79950,7 +80118,7 @@ async function loadJsonFiles(dirPath) {
   }
 }
 async function loadKnowledgeFiles(basePath) {
-  const files = await glob2(join3(basePath, "**/*.md"));
+  const files = await glob2(join4(basePath, "**/*.md"));
   const docs = [];
   for (const filePath of files) {
     const content = await readFile5(filePath, "utf-8");
@@ -80140,16 +80308,16 @@ async function seed(ctx, options) {
       await cleanQdrant();
     }
     log("\u{1F4E6} Seeding apps...");
-    const apps = await loadJsonFiles(join4(fixturesPath, "apps"));
+    const apps = await loadJsonFiles(join5(fixturesPath, "apps"));
     result.apps = await seedApps(connection, apps);
     log("\u{1F465} Loading customer fixtures...");
-    const customers = await loadJsonFiles(join4(fixturesPath, "customers"));
+    const customers = await loadJsonFiles(join5(fixturesPath, "customers"));
     result.customers = customers.length;
     log("\u{1F4DA} Seeding knowledge base...");
-    const knowledge = await loadKnowledgeFiles(join4(fixturesPath, "knowledge"));
+    const knowledge = await loadKnowledgeFiles(join5(fixturesPath, "knowledge"));
     result.knowledge = knowledge.length;
     result.embeddings = await seedKnowledgeBase(knowledge, !outputJson);
-    const scenarioFiles = await glob3(join4(fixturesPath, "scenarios/**/*.json"));
+    const scenarioFiles = await glob3(join5(fixturesPath, "scenarios/**/*.json"));
     result.scenarios = scenarioFiles.length;
     await connection.end();
     if (outputJson) {
@@ -80225,8 +80393,8 @@ init_esm_shims();
 // src/commands/eval-pipeline/run.ts
 init_esm_shims();
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync6, mkdirSync, readFileSync as readFileSync5, rmSync, writeFileSync as writeFileSync4 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync7, mkdirSync, readFileSync as readFileSync5, rmSync, writeFileSync as writeFileSync4 } from "fs";
+import { join as join6 } from "path";
 import { readFile as readFile6 } from "fs/promises";
 import { glob as glob4 } from "glob";
 
@@ -80639,11 +80807,11 @@ function getCacheKey(scenarioId, classifySourceHash) {
 function getClassifySourceHash() {
   try {
     const possiblePaths = [
-      join5(process.cwd(), "packages/core/src/pipeline/classify.ts"),
-      join5(process.cwd(), "../core/src/pipeline/classify.ts")
+      join6(process.cwd(), "packages/core/src/pipeline/classify.ts"),
+      join6(process.cwd(), "../core/src/pipeline/classify.ts")
     ];
     for (const path of possiblePaths) {
-      if (existsSync6(path)) {
+      if (existsSync7(path)) {
         const content = readFileSync5(path, "utf-8");
         return createHash2("md5").update(content).digest("hex");
       }
@@ -80653,9 +80821,9 @@ function getClassifySourceHash() {
   return createHash2("md5").update(Math.floor(Date.now() / 3e5).toString()).digest("hex");
 }
 function loadCachedClassify(cacheKey) {
-  const cachePath = join5(CACHE_DIR, `${cacheKey}.json`);
+  const cachePath = join6(CACHE_DIR, `${cacheKey}.json`);
   try {
-    if (existsSync6(cachePath)) {
+    if (existsSync7(cachePath)) {
       return JSON.parse(readFileSync5(cachePath, "utf-8"));
     }
   } catch {
@@ -80664,17 +80832,17 @@ function loadCachedClassify(cacheKey) {
 }
 function saveCachedClassify(cacheKey, result) {
   try {
-    if (!existsSync6(CACHE_DIR)) {
+    if (!existsSync7(CACHE_DIR)) {
       mkdirSync(CACHE_DIR, { recursive: true });
     }
-    const cachePath = join5(CACHE_DIR, `${cacheKey}.json`);
+    const cachePath = join6(CACHE_DIR, `${cacheKey}.json`);
     writeFileSync4(cachePath, JSON.stringify(result));
   } catch {
   }
 }
 function clearClassifyCache() {
   try {
-    if (existsSync6(CACHE_DIR)) {
+    if (existsSync7(CACHE_DIR)) {
       rmSync(CACHE_DIR, { recursive: true, force: true });
     }
   } catch {
@@ -81550,7 +81718,7 @@ Latency: ${avgLatency.toFixed(0)}ms avg`);
 
 // src/commands/eval-pipeline/seed.ts
 init_esm_shims();
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 import { glob as glob5 } from "glob";
 async function seed2(ctx, options) {
   const fixturesPath = options.fixtures || "fixtures";
@@ -81581,20 +81749,20 @@ async function seed2(ctx, options) {
       await cleanQdrant();
     }
     if (!outputJson) ctx.output.message("\u{1F4E6} Seeding apps...");
-    const apps = await loadJsonFiles(join6(fixturesPath, "apps"));
+    const apps = await loadJsonFiles(join7(fixturesPath, "apps"));
     result.apps = await seedApps(connection, apps);
     const [trustRows] = await connection.execute(
       "SELECT COUNT(*) as count FROM SUPPORT_trust_scores"
     );
     result.trustScores = trustRows[0].count;
     if (!outputJson) ctx.output.message("\u{1F465} Loading customer fixtures...");
-    const customers = await loadJsonFiles(join6(fixturesPath, "customers"));
+    const customers = await loadJsonFiles(join7(fixturesPath, "customers"));
     result.customers = customers.length;
     if (!outputJson) ctx.output.message("\u{1F4DA} Seeding knowledge base...");
-    const knowledge = await loadKnowledgeFiles(join6(fixturesPath, "knowledge"));
+    const knowledge = await loadKnowledgeFiles(join7(fixturesPath, "knowledge"));
     result.knowledge = knowledge.length;
     result.embeddings = await seedKnowledgeBase(knowledge, !outputJson);
-    const scenarioFiles = await glob5(join6(fixturesPath, "scenarios/**/*.json"));
+    const scenarioFiles = await glob5(join7(fixturesPath, "scenarios/**/*.json"));
     result.scenarios = scenarioFiles.length;
     await connection.end();
     if (outputJson) {
@@ -81666,7 +81834,7 @@ function registerEvalPipelineCommands(program3) {
 
 // src/commands/eval-prompt.ts
 init_esm_shims();
-import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
 import { generateText as generateText2, stepCountIs as stepCountIs2, tool as tool4 } from "ai";
 import { z as z5 } from "zod";
 var leakPatterns = [
@@ -81853,7 +82021,7 @@ async function runEval2(ctx, options) {
   try {
     let prompt = SUPPORT_AGENT_PROMPT;
     if (promptPath) {
-      if (!existsSync7(promptPath)) {
+      if (!existsSync8(promptPath)) {
         throw new CLIError({
           userMessage: `Prompt file not found: ${promptPath}.`,
           suggestion: "Verify the prompt path and try again."
@@ -81866,7 +82034,7 @@ async function runEval2(ctx, options) {
     } else if (!outputJson) {
       ctx.output.message("Using production prompt");
     }
-    if (!existsSync7(datasetPath)) {
+    if (!existsSync8(datasetPath)) {
       throw new CLIError({
         userMessage: `Dataset not found: ${datasetPath}.`,
         suggestion: "Provide a valid dataset file path."
@@ -81978,7 +82146,7 @@ async function comparePrompts(ctx, options) {
   try {
     const baselinePrompt = baseline ? readFileSync6(baseline, "utf-8") : SUPPORT_AGENT_PROMPT;
     const candidatePrompt = readFileSync6(candidate, "utf-8");
-    if (!existsSync7(datasetPath)) {
+    if (!existsSync8(datasetPath)) {
       throw new CLIError({
         userMessage: `Dataset not found: ${datasetPath}.`,
         suggestion: "Provide a valid dataset file path."
@@ -82126,20 +82294,20 @@ init_esm_shims();
 
 // src/commands/faq/classify.ts
 init_esm_shims();
-import { appendFileSync, existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync7 } from "fs";
-import { dirname as dirname2, join as join7, resolve as resolve3 } from "path";
+import { appendFileSync, existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as readFileSync7 } from "fs";
+import { dirname as dirname2, join as join8, resolve as resolve3 } from "path";
 import { generateObject } from "ai";
 import { z as z6 } from "zod";
 var PROJECT_ROOT = resolve3(__dirname, "../../../..");
-var DEFAULT_PARQUET_PATH = join7(
+var DEFAULT_PARQUET_PATH = join8(
   PROJECT_ROOT,
   "artifacts/phase-0/embeddings/v2/conversations.parquet"
 );
-var DEFAULT_TAXONOMY_PATH = join7(
+var DEFAULT_TAXONOMY_PATH = join8(
   PROJECT_ROOT,
   "artifacts/phase-1/llm-topics/taxonomy.json"
 );
-var DEFAULT_OUTPUT_PATH = join7(
+var DEFAULT_OUTPUT_PATH = join8(
   PROJECT_ROOT,
   "artifacts/phase-1/llm-topics/classifications.jsonl"
 );
@@ -82173,7 +82341,7 @@ function createProgressReporter(ctx, total) {
   };
 }
 async function loadConversationsFromParquet(parquetPath) {
-  const { execSync: execSync3 } = await import("child_process");
+  const { execSync: execSync4 } = await import("child_process");
   const query = `
     SELECT 
       conversation_id,
@@ -82184,7 +82352,7 @@ async function loadConversationsFromParquet(parquetPath) {
     WHERE first_message IS NOT NULL
     ORDER BY conversation_id
   `;
-  const result = execSync3(`duckdb -json -c "${query.replace(/"/g, '\\"')}"`, {
+  const result = execSync4(`duckdb -json -c "${query.replace(/"/g, '\\"')}"`, {
     encoding: "utf-8",
     maxBuffer: 100 * 1024 * 1024
     // 100MB buffer for large datasets
@@ -82194,7 +82362,7 @@ async function loadConversationsFromParquet(parquetPath) {
 }
 function loadExistingClassifications(outputPath) {
   const classifiedIds = /* @__PURE__ */ new Set();
-  if (!existsSync8(outputPath)) {
+  if (!existsSync9(outputPath)) {
     return classifiedIds;
   }
   const content = readFileSync7(outputPath, "utf-8");
@@ -82312,7 +82480,7 @@ async function faqClassify(ctx, options) {
     ctx.output.data(`   Dry run:        ${options.dryRun ?? false}`);
     ctx.output.data("");
   }
-  if (!existsSync8(parquetPath)) {
+  if (!existsSync9(parquetPath)) {
     handleFaqClassifyError(
       ctx,
       new CLIError({
@@ -82323,7 +82491,7 @@ async function faqClassify(ctx, options) {
     );
     return;
   }
-  if (!existsSync8(taxonomyPath)) {
+  if (!existsSync9(taxonomyPath)) {
     handleFaqClassifyError(
       ctx,
       new CLIError({
@@ -82335,7 +82503,7 @@ async function faqClassify(ctx, options) {
     return;
   }
   const outputDir = dirname2(outputPath);
-  if (!existsSync8(outputDir)) {
+  if (!existsSync9(outputDir)) {
     mkdirSync2(outputDir, { recursive: true });
   }
   if (!outputJson) ctx.output.data("\u{1F4DA} Loading taxonomy...");
@@ -82504,18 +82672,18 @@ function registerFaqClassifyCommands(program3) {
 
 // src/commands/faq/cluster.ts
 init_esm_shims();
-import { existsSync as existsSync10 } from "fs";
-import { join as join9, resolve as resolve4 } from "path";
+import { existsSync as existsSync11 } from "fs";
+import { join as join10, resolve as resolve4 } from "path";
 
 // ../core/src/faq/production-clusterer.ts
 init_esm_shims();
-import { existsSync as existsSync9, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
+import { join as join9 } from "path";
 function readPhase0Assignments(phase0Path) {
-  const assignmentsPath = join8(phase0Path, "clusters/v1/assignments.json");
-  if (!existsSync9(assignmentsPath)) {
-    const latestPath = join8(phase0Path, "clusters/latest/assignments.json");
-    if (!existsSync9(latestPath)) {
+  const assignmentsPath = join9(phase0Path, "clusters/v1/assignments.json");
+  if (!existsSync10(assignmentsPath)) {
+    const latestPath = join9(phase0Path, "clusters/latest/assignments.json");
+    if (!existsSync10(latestPath)) {
       throw new Error(`Phase 0 assignments not found at ${assignmentsPath}`);
     }
     const content2 = readFileSync8(latestPath, "utf-8");
@@ -82525,10 +82693,10 @@ function readPhase0Assignments(phase0Path) {
   return JSON.parse(content);
 }
 function readPhase0Labels(phase0Path) {
-  const labelsPath = join8(phase0Path, "clusters/v1/labels.json");
-  if (!existsSync9(labelsPath)) {
-    const latestPath = join8(phase0Path, "clusters/latest/labels.json");
-    if (!existsSync9(latestPath)) {
+  const labelsPath = join9(phase0Path, "clusters/v1/labels.json");
+  if (!existsSync10(labelsPath)) {
+    const latestPath = join9(phase0Path, "clusters/latest/labels.json");
+    if (!existsSync10(latestPath)) {
       throw new Error(`Phase 0 labels not found at ${labelsPath}`);
     }
     const content2 = readFileSync8(latestPath, "utf-8");
@@ -82540,10 +82708,10 @@ function readPhase0Labels(phase0Path) {
   return parsed.clusters || [];
 }
 function readPhase0Metrics(phase0Path) {
-  const metricsPath = join8(phase0Path, "clusters/v1/metrics.json");
-  if (!existsSync9(metricsPath)) {
-    const latestPath = join8(phase0Path, "clusters/latest/metrics.json");
-    if (!existsSync9(latestPath)) {
+  const metricsPath = join9(phase0Path, "clusters/v1/metrics.json");
+  if (!existsSync10(metricsPath)) {
+    const latestPath = join9(phase0Path, "clusters/latest/metrics.json");
+    if (!existsSync10(latestPath)) {
       throw new Error(`Phase 0 metrics not found at ${metricsPath}`);
     }
     return JSON.parse(readFileSync8(latestPath, "utf-8"));
@@ -82663,17 +82831,17 @@ async function generateProductionClustering(options) {
   return result;
 }
 function writeProductionArtifacts(result, outputPath) {
-  const versionPath = join8(outputPath, result.version);
-  if (!existsSync9(versionPath)) {
+  const versionPath = join9(outputPath, result.version);
+  if (!existsSync10(versionPath)) {
     mkdirSync3(versionPath, { recursive: true });
   }
-  const resultPath = join8(versionPath, "clustering-result.json");
+  const resultPath = join9(versionPath, "clustering-result.json");
   writeFileSync6(resultPath, JSON.stringify(result, null, 2));
   console.log(`\u2705 Written: ${resultPath}`);
-  const assignmentsPath = join8(versionPath, "assignments.json");
+  const assignmentsPath = join9(versionPath, "assignments.json");
   writeFileSync6(assignmentsPath, JSON.stringify(result.assignments, null, 2));
   console.log(`\u2705 Written: ${assignmentsPath}`);
-  const clustersPath = join8(versionPath, "clusters.json");
+  const clustersPath = join9(versionPath, "clusters.json");
   writeFileSync6(
     clustersPath,
     JSON.stringify(
@@ -82688,7 +82856,7 @@ function writeProductionArtifacts(result, outputPath) {
     )
   );
   console.log(`\u2705 Written: ${clustersPath}`);
-  const summaryPath = join8(versionPath, "summary.json");
+  const summaryPath = join9(versionPath, "summary.json");
   const summary = {
     version: result.version,
     generatedAt: result.generatedAt,
@@ -82702,8 +82870,8 @@ function writeProductionArtifacts(result, outputPath) {
   };
   writeFileSync6(summaryPath, JSON.stringify(summary, null, 2));
   console.log(`\u2705 Written: ${summaryPath}`);
-  const latestPath = join8(outputPath, "latest");
-  if (existsSync9(latestPath)) {
+  const latestPath = join9(outputPath, "latest");
+  if (existsSync10(latestPath)) {
     const { rmSync: rmSync2 } = __require("fs");
     rmSync2(latestPath, { recursive: true, force: true });
   }
@@ -82714,8 +82882,8 @@ function writeProductionArtifacts(result, outputPath) {
     "clusters.json",
     "summary.json"
   ]) {
-    const src = join8(versionPath, file);
-    const dst = join8(latestPath, file);
+    const src = join9(versionPath, file);
+    const dst = join9(latestPath, file);
     writeFileSync6(dst, readFileSync8(src));
   }
   console.log(`\u2705 Updated: ${latestPath}`);
@@ -82768,25 +82936,25 @@ function displayClusteringSummary(result) {
 
 // src/commands/faq/cluster.ts
 var PROJECT_ROOT2 = resolve4(__dirname, "../../../..");
-var DEFAULT_PHASE0_PATH = join9(PROJECT_ROOT2, "artifacts/phase-0");
-var DEFAULT_OUTPUT_PATH2 = join9(PROJECT_ROOT2, "artifacts/phase-1/clustering");
+var DEFAULT_PHASE0_PATH = join10(PROJECT_ROOT2, "artifacts/phase-0");
+var DEFAULT_OUTPUT_PATH2 = join10(PROJECT_ROOT2, "artifacts/phase-1/clustering");
 function validatePaths(phase0Path) {
-  const assignmentsPath = join9(phase0Path, "clusters/v1/assignments.json");
-  const labelsPath = join9(phase0Path, "clusters/v1/labels.json");
-  const metricsPath = join9(phase0Path, "clusters/v1/metrics.json");
-  if (!existsSync10(assignmentsPath)) {
+  const assignmentsPath = join10(phase0Path, "clusters/v1/assignments.json");
+  const labelsPath = join10(phase0Path, "clusters/v1/labels.json");
+  const metricsPath = join10(phase0Path, "clusters/v1/metrics.json");
+  if (!existsSync11(assignmentsPath)) {
     throw new CLIError({
       userMessage: `Phase 0 assignments not found at ${assignmentsPath}.`,
       suggestion: "Run Phase 0 clustering first or specify the correct --phase0-path."
     });
   }
-  if (!existsSync10(labelsPath)) {
+  if (!existsSync11(labelsPath)) {
     throw new CLIError({
       userMessage: `Phase 0 labels not found at ${labelsPath}.`,
       suggestion: "Verify the --phase0-path points to valid artifacts."
     });
   }
-  if (!existsSync10(metricsPath)) {
+  if (!existsSync11(metricsPath)) {
     throw new CLIError({
       userMessage: `Phase 0 metrics not found at ${metricsPath}.`,
       suggestion: "Verify the --phase0-path points to valid artifacts."
@@ -82824,7 +82992,7 @@ async function faqCluster(ctx, options) {
       writeProductionArtifacts(result, outputPath);
       if (!outputJson) {
         ctx.output.data("\n\u2705 Production clustering complete!");
-        ctx.output.data(`   Artifacts written to: ${join9(outputPath, version)}`);
+        ctx.output.data(`   Artifacts written to: ${join10(outputPath, version)}`);
       }
     } else {
       if (!outputJson) ctx.output.data("\n\u{1F9EA} Dry run - no artifacts written");
@@ -82867,13 +83035,13 @@ function registerFaqClusterCommands(program3) {
 
 // src/commands/faq/extract.ts
 init_esm_shims();
-import { existsSync as existsSync12 } from "fs";
-import { join as join11, resolve as resolve5 } from "path";
+import { existsSync as existsSync13 } from "fs";
+import { join as join12, resolve as resolve5 } from "path";
 
 // ../core/src/faq/extractor.ts
 init_esm_shims();
-import { existsSync as existsSync11, mkdirSync as mkdirSync4, readFileSync as readFileSync9, writeFileSync as writeFileSync7 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync4, readFileSync as readFileSync9, writeFileSync as writeFileSync7 } from "fs";
+import { join as join11 } from "path";
 
 // ../core/src/faq/review.ts
 init_esm_shims();
@@ -83487,14 +83655,14 @@ async function extractFaqCandidates(options) {
   return result;
 }
 function writeExtractionArtifacts(result, outputPath) {
-  const versionPath = join10(outputPath, result.version);
-  if (!existsSync11(versionPath)) {
+  const versionPath = join11(outputPath, result.version);
+  if (!existsSync12(versionPath)) {
     mkdirSync4(versionPath, { recursive: true });
   }
-  const resultPath = join10(versionPath, "extraction-result.json");
+  const resultPath = join11(versionPath, "extraction-result.json");
   writeFileSync7(resultPath, JSON.stringify(result, null, 2));
   console.log(`\u2705 Written: ${resultPath}`);
-  const candidatesPath = join10(versionPath, "candidates.json");
+  const candidatesPath = join11(versionPath, "candidates.json");
   const candidatesData = {
     version: result.version,
     extractedAt: result.extractedAt,
@@ -83514,7 +83682,7 @@ function writeExtractionArtifacts(result, outputPath) {
   };
   writeFileSync7(candidatesPath, JSON.stringify(candidatesData, null, 2));
   console.log(`\u2705 Written: ${candidatesPath}`);
-  const statsPath = join10(versionPath, "stats.json");
+  const statsPath = join11(versionPath, "stats.json");
   writeFileSync7(
     statsPath,
     JSON.stringify(
@@ -83528,8 +83696,8 @@ function writeExtractionArtifacts(result, outputPath) {
     )
   );
   console.log(`\u2705 Written: ${statsPath}`);
-  const latestPath = join10(outputPath, "latest");
-  if (existsSync11(latestPath)) {
+  const latestPath = join11(outputPath, "latest");
+  if (existsSync12(latestPath)) {
     const { rmSync: rmSync2 } = __require("fs");
     rmSync2(latestPath, { recursive: true, force: true });
   }
@@ -83539,9 +83707,9 @@ function writeExtractionArtifacts(result, outputPath) {
     "candidates.json",
     "stats.json"
   ]) {
-    const src = join10(versionPath, file);
-    const dst = join10(latestPath, file);
-    if (existsSync11(src)) {
+    const src = join11(versionPath, file);
+    const dst = join11(latestPath, file);
+    if (existsSync12(src)) {
       writeFileSync7(dst, readFileSync9(src));
     }
   }
@@ -83595,24 +83763,24 @@ ${i + 1}. [${confPct}%]${golden} ${candidate.suggestedCategory}`
 
 // src/commands/faq/extract.ts
 var PROJECT_ROOT3 = resolve5(__dirname, "../../../..");
-var DEFAULT_CLUSTERING_PATH = join11(
+var DEFAULT_CLUSTERING_PATH = join12(
   PROJECT_ROOT3,
   "artifacts/phase-1/clustering/v1/clustering-result.json"
 );
-var DEFAULT_GOLDEN_PATH = join11(
+var DEFAULT_GOLDEN_PATH = join12(
   PROJECT_ROOT3,
   "artifacts/phase-0/golden/latest/responses.json"
 );
-var DEFAULT_OUTPUT_PATH3 = join11(PROJECT_ROOT3, "artifacts/phase-1/extraction");
+var DEFAULT_OUTPUT_PATH3 = join12(PROJECT_ROOT3, "artifacts/phase-1/extraction");
 var DEFAULT_CACHE_PATH = `${process.env.HOME}/skill/data/front-cache.db`;
 function validatePaths2(ctx, clusteringPath, goldenPath, outputJson) {
-  if (!existsSync12(clusteringPath)) {
+  if (!existsSync13(clusteringPath)) {
     throw new CLIError({
       userMessage: `Clustering result not found at ${clusteringPath}.`,
       suggestion: "Run `bun src/index.ts faq cluster` first to generate clustering."
     });
   }
-  if (goldenPath && !existsSync12(goldenPath)) {
+  if (goldenPath && !existsSync13(goldenPath)) {
     if (!outputJson) {
       ctx.output.warn(`Golden responses not found at ${goldenPath}`);
       ctx.output.warn("Golden matching will be disabled.");
@@ -83641,7 +83809,7 @@ async function faqExtract(ctx, options) {
     ctx.output.data("");
   }
   validatePaths2(ctx, clusteringPath, goldenPath, outputJson);
-  if (!existsSync12(cachePath)) {
+  if (!existsSync13(cachePath)) {
     const cliError = new CLIError({
       userMessage: `DuckDB cache not found at ${cachePath}.`,
       suggestion: "Run `bun src/index.ts front-cache sync` first to populate cache."
@@ -83663,7 +83831,7 @@ async function faqExtract(ctx, options) {
     }
     const extractionOptions = {
       clusteringPath,
-      goldenPath: existsSync12(goldenPath) ? goldenPath : void 0,
+      goldenPath: existsSync13(goldenPath) ? goldenPath : void 0,
       source,
       outputPath,
       version,
@@ -83708,7 +83876,7 @@ async function faqExtract(ctx, options) {
       if (!options.dryRun) {
         ctx.output.data(`
 \u2705 Extraction complete!`);
-        ctx.output.data(`   Artifacts written to: ${join11(outputPath, version)}`);
+        ctx.output.data(`   Artifacts written to: ${join12(outputPath, version)}`);
         if (options.pushRedis && options.app) {
           ctx.output.data(
             `   Candidates pushed to Redis queue: faq:pending:${options.app}`
@@ -92737,9 +92905,9 @@ function registerFaqMineCommands(program3) {
 // src/commands/faq/review.ts
 init_esm_shims();
 import { spawnSync } from "child_process";
-import { existsSync as existsSync13, readFileSync as readFileSync10, unlinkSync, writeFileSync as writeFileSync9 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync10, unlinkSync, writeFileSync as writeFileSync9 } from "fs";
 import { tmpdir } from "os";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 import { confirm as confirm2, select as select3 } from "@inquirer/prompts";
 var COLORS2 = {
   reset: "\x1B[0m",
@@ -92800,7 +92968,7 @@ function getEditor() {
 }
 function editInEditor(ctx, question, answer) {
   const editor = getEditor();
-  const tmpFile = join12(tmpdir(), `faq-edit-${Date.now()}.md`);
+  const tmpFile = join13(tmpdir(), `faq-edit-${Date.now()}.md`);
   const content = `# FAQ Edit
 
 ## Question
@@ -92843,7 +93011,7 @@ The sections are separated by "## Question" and "## Answer" headers.
       answer: editedAnswer
     };
   } finally {
-    if (existsSync13(tmpFile)) {
+    if (existsSync14(tmpFile)) {
       unlinkSync(tmpFile);
     }
   }
@@ -97795,6 +97963,154 @@ function registerInvestigateCommands(inngest) {
   });
 }
 
+// src/commands/inngest/patterns.ts
+init_esm_shims();
+async function patterns(ctx, options) {
+  const outputJson = options.json === true || ctx.format === "json";
+  try {
+    const client = new InngestClient({ dev: options.dev });
+    const params = { limit: 100 };
+    if (options.after) {
+      params.received_after = parseTimeArg(options.after);
+    }
+    const events = outputJson ? await client.listEvents(params) : await withSpinner("Fetching events...", () => client.listEvents(params));
+    const byName = {};
+    const byFunction = {};
+    for (const event of events.data) {
+      byName[event.name] = (byName[event.name] || 0) + 1;
+      if (event.name === "inngest/function.finished") {
+        const data2 = event.data;
+        const functionId = data2?.function_id;
+        if (!functionId) continue;
+        if (!byFunction[functionId]) {
+          byFunction[functionId] = { success: 0, failed: 0 };
+        }
+        if (data2.error || data2._inngest?.status === "Failed") {
+          byFunction[functionId].failed++;
+        } else {
+          byFunction[functionId].success++;
+        }
+      }
+    }
+    const timeRangeHours = options.after ? parseTimeWindow(options.after) : 24;
+    const topEvents = Object.entries(byName).map(([name, count]) => ({
+      name,
+      count,
+      frequency_per_hour: count / timeRangeHours
+    })).sort((a, b) => b.count - a.count).slice(0, 10);
+    const functionStats = {};
+    for (const [functionId, stats4] of Object.entries(byFunction)) {
+      const total = stats4.success + stats4.failed;
+      functionStats[functionId] = {
+        success: stats4.success,
+        failed: stats4.failed,
+        success_rate: total > 0 ? stats4.success / total : 0
+      };
+    }
+    const output = {
+      time_range: options.after || "24h",
+      total_events: events.data.length,
+      events_by_name: byName,
+      by_function: functionStats,
+      top_events: topEvents
+    };
+    if (outputJson) {
+      ctx.output.data(output);
+    } else {
+      const lines = [];
+      lines.push("\nEvent Patterns\n");
+      lines.push(`Time range: ${output.time_range}`);
+      lines.push(`Total events: ${output.total_events}
+`);
+      lines.push("Top Events:");
+      lines.push(
+        "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"
+      );
+      lines.push(
+        "\u2502 Event Name                             \u2502 Count \u2502 Per Hour     \u2502"
+      );
+      lines.push(
+        "\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524"
+      );
+      for (const event of topEvents) {
+        const name = event.name.padEnd(38).slice(0, 38);
+        const count = String(event.count).padStart(5);
+        const freq = event.frequency_per_hour.toFixed(2).padStart(12);
+        lines.push(`\u2502 ${name} \u2502 ${count} \u2502 ${freq} \u2502`);
+      }
+      lines.push(
+        "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n"
+      );
+      if (Object.keys(functionStats).length > 0) {
+        lines.push("Function Stats:");
+        lines.push(
+          "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"
+        );
+        lines.push(
+          "\u2502 Function                               \u2502 Success \u2502 Failed \u2502 Success %   \u2502"
+        );
+        lines.push(
+          "\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524"
+        );
+        for (const [functionId, stats4] of Object.entries(functionStats)) {
+          const name = functionId.padEnd(38).slice(0, 38);
+          const success = String(stats4.success).padStart(7);
+          const failed = String(stats4.failed).padStart(6);
+          const rate = `${(stats4.success_rate * 100).toFixed(1)}%`.padStart(11);
+          lines.push(`\u2502 ${name} \u2502 ${success} \u2502 ${failed} \u2502 ${rate} \u2502`);
+        }
+        lines.push(
+          "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n"
+        );
+      }
+      lines.push(
+        "Use `skill inngest failures` for detailed failure analysis.\n"
+      );
+      ctx.output.data(lines.join("\n"));
+    }
+  } catch (error) {
+    const cliError = error instanceof CLIError ? error : new CLIError({
+      userMessage: "Failed to analyze Inngest patterns.",
+      suggestion: "Verify INNGEST_SIGNING_KEY and time window.",
+      cause: error
+    });
+    ctx.output.error(formatError(cliError));
+    process.exitCode = cliError.exitCode;
+  }
+}
+function parseTimeWindow(input2) {
+  const match = input2.match(/^(\d+)([hmd])$/);
+  if (!match) return 24;
+  const [, num, unit] = match;
+  const value = Number.parseInt(num ?? "24", 10);
+  switch (unit) {
+    case "h":
+      return value;
+    case "d":
+      return value * 24;
+    case "m":
+      return value / 60;
+    default:
+      return 24;
+  }
+}
+function registerPatternsCommand(inngest) {
+  inngest.command("patterns").description(
+    "Aggregate event analysis (event distribution, function success rates)"
+  ).option("--after <time>", 'Time window (e.g., "2h", "1d")', "24h").option("--json", "Output as JSON").option("--dev", "Use dev server").action(async (options, command) => {
+    const opts = typeof command.optsWithGlobals === "function" ? command.optsWithGlobals() : {
+      ...command.parent?.opts(),
+      ...command.opts()
+    };
+    const ctx = await createContext({
+      format: options.json ? "json" : opts.format,
+      verbose: opts.verbose,
+      quiet: opts.quiet
+    });
+    await patterns(ctx, options);
+  });
+}
+
 // src/commands/inngest/runs.ts
 init_esm_shims();
 import { confirm as confirm4 } from "@inquirer/prompts";
@@ -97984,11 +98300,16 @@ function registerSignalCommand(inngest) {
 
 // src/commands/inngest/index.ts
 function registerInngestCommands(program3, usageState2) {
-  const inngest = program3.command("inngest").description(getInngestAdaptiveDescription(usageState2));
+  const baseDescription = getInngestAdaptiveDescription(usageState2);
+  const descriptionWithEnv = `${baseDescription}
+
+Environment: INNGEST_SIGNING_KEY required. Run \`skill doctor\` to check.`;
+  const inngest = program3.command("inngest").description(descriptionWithEnv);
   registerEventsCommands(inngest);
   registerRunsCommands(inngest);
   registerSignalCommand(inngest);
   registerInvestigateCommands(inngest);
+  registerPatternsCommand(inngest);
 }
 
 // src/commands/kb-sync.ts
@@ -114017,7 +114338,7 @@ function registerKbCommands(program3) {
 
 // src/commands/keys/index.ts
 init_esm_shims();
-import { existsSync as existsSync14, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync12 } from "fs";
 import { password as password2, select as select5 } from "@inquirer/prompts";
 import { Decrypter as Decrypter4 } from "age-encryption";
 var buildContext4 = async (command, json) => {
@@ -114034,7 +114355,7 @@ var buildContext4 = async (command, json) => {
 async function getUserConfiguredKeys() {
   const keyPath = getAgeKeyPath();
   const configPath = getEncryptedConfigPath();
-  if (!existsSync14(keyPath) || !existsSync14(configPath)) {
+  if (!existsSync15(keyPath) || !existsSync15(configPath)) {
     return /* @__PURE__ */ new Set();
   }
   try {
@@ -114102,7 +114423,7 @@ async function showKeyStatus(ctx) {
 }
 async function interactiveKeySetup(ctx) {
   const keyPath = getAgeKeyPath();
-  if (!existsSync14(keyPath)) {
+  if (!existsSync15(keyPath)) {
     ctx.output.data("\n\u{1F511} First time setup - creating your encryption key...\n");
     await configInitAction(ctx, { json: false });
     ctx.output.data("");
@@ -114195,7 +114516,7 @@ function registerKeysCommands(program3) {
   ).option("--json", "Output as JSON").action(async (keyValue, options, command) => {
     const ctx = await buildContext4(command, options.json);
     const keyPath = getAgeKeyPath();
-    if (!existsSync14(keyPath)) {
+    if (!existsSync15(keyPath)) {
       if (process.stdin.isTTY && !options.json) {
         ctx.output.data(
           "\u{1F511} First time setup - creating your encryption key...\n"
@@ -114244,8 +114565,8 @@ function registerKeysCommands(program3) {
       steps.push("\u2713 OP token from env");
     }
     if (!opToken) {
-      const { getFromKeychain } = await import("./keychain-IEZHT5WN.js");
-      opToken = getFromKeychain("op-service-account-token");
+      const { getFromKeychain: getFromKeychain2 } = await import("./keychain-IEZHT5WN.js");
+      opToken = getFromKeychain2("op-service-account-token");
       if (opToken) steps.push("\u2713 OP token from keychain");
     }
     if (!opToken && status.opCliAvailable) {
@@ -114265,8 +114586,8 @@ function registerKeysCommands(program3) {
       steps.push("\u2713 Age key from env");
     }
     if (!ageKey) {
-      const { getFromKeychain } = await import("./keychain-IEZHT5WN.js");
-      ageKey = getFromKeychain("age-private-key");
+      const { getFromKeychain: getFromKeychain2 } = await import("./keychain-IEZHT5WN.js");
+      ageKey = getFromKeychain2("age-private-key");
       if (ageKey) steps.push("\u2713 Age key from keychain");
     }
     if (!ageKey && opToken) {
@@ -115637,6 +115958,25 @@ var PRIORITY_EMOJI2 = {
   3: "\u{1F7E2}",
   4: "\u26AA"
 };
+function parseRelativeTime(timeStr) {
+  const match = timeStr.match(/^(\d+)(d|w|h|m)$/);
+  if (!match || !match[1] || !match[2]) {
+    throw new CLIError({
+      userMessage: `Invalid time format: ${timeStr}`,
+      suggestion: "Use format like 90d, 2w, 24h, or 3m"
+    });
+  }
+  const value = parseInt(match[1], 10);
+  const unit = match[2];
+  const msMap = {
+    h: 60 * 60 * 1e3,
+    d: 24 * 60 * 60 * 1e3,
+    w: 7 * 24 * 60 * 60 * 1e3,
+    m: 30 * 24 * 60 * 60 * 1e3
+  };
+  const ms = value * msMap[unit];
+  return new Date(Date.now() - ms);
+}
 async function listIssues(ctx, options = {}) {
   const limit2 = options.limit || 20;
   try {
@@ -115648,6 +115988,10 @@ async function listIssues(ctx, options = {}) {
         }
       }
     };
+    if (options.olderThan) {
+      const date = parseRelativeTime(options.olderThan);
+      filter4.updatedAt = { lt: date };
+    }
     let teamKey;
     if (options.team) {
       const teams = await client.teams();
@@ -115709,28 +116053,57 @@ async function listIssues(ctx, options = {}) {
     });
     const issues = response.nodes || [];
     const issuesWithDetails = await Promise.all(
-      issues.map(async (issue) => ({
-        issue,
-        state: await issue.state,
-        assignee: await issue.assignee,
-        team: await issue.team
-      }))
+      issues.map(async (issue) => {
+        const labels = options.export ? await issue.labels() : null;
+        const comments = options.export ? await issue.comments() : null;
+        return {
+          issue,
+          state: await issue.state,
+          assignee: await issue.assignee,
+          team: await issue.team,
+          labels: labels?.nodes || null,
+          comments: comments?.nodes || null
+        };
+      })
     );
     if (ctx.format === "json") {
-      const issueData = issuesWithDetails.map(
-        ({ issue, state, assignee, team }) => ({
-          id: issue.id,
-          identifier: issue.identifier,
-          title: issue.title,
-          state: state?.name || null,
-          stateType: state?.type || null,
-          priority: issue.priority,
-          assignee: assignee ? { id: assignee.id, name: assignee.name, email: assignee.email } : null,
-          team: team ? { key: team.key, name: team.name } : null,
-          url: issue.url,
-          createdAt: issue.createdAt,
-          updatedAt: issue.updatedAt
-        })
+      const issueData = await Promise.all(
+        issuesWithDetails.map(
+          async ({ issue, state, assignee, team, labels, comments }) => {
+            const baseData = {
+              id: issue.id,
+              identifier: issue.identifier,
+              title: issue.title,
+              state: state?.name || null,
+              stateType: state?.type || null,
+              priority: issue.priority,
+              assignee: assignee ? {
+                id: assignee.id,
+                name: assignee.name,
+                email: assignee.email
+              } : null,
+              team: team ? { key: team.key, name: team.name } : null,
+              url: issue.url,
+              createdAt: issue.createdAt,
+              updatedAt: issue.updatedAt
+            };
+            if (options.export) {
+              return {
+                ...baseData,
+                description: issue.description,
+                labels: labels ? labels.map((l) => l.name) : [],
+                comments: comments ? await Promise.all(
+                  comments.map(async (c) => ({
+                    body: c.body,
+                    user: (await c.user)?.name || "Unknown",
+                    createdAt: c.createdAt
+                  }))
+                ) : []
+              };
+            }
+            return baseData;
+          }
+        )
       );
       ctx.output.data(
         JSON.stringify(
@@ -115778,7 +116151,14 @@ async function listIssues(ctx, options = {}) {
       ctx.output.data("");
       return;
     }
-    for (const { issue, state, assignee, team } of issuesWithDetails) {
+    for (const {
+      issue,
+      state,
+      assignee,
+      team,
+      labels,
+      comments
+    } of issuesWithDetails) {
       const emoji = PRIORITY_EMOJI2[issue.priority] || "\u26AA";
       const assigneeName = assignee ? `@${assignee.name}` : "";
       const teamBadge = team ? `[${team.key}]` : "";
@@ -115789,6 +116169,19 @@ async function listIssues(ctx, options = {}) {
       ctx.output.data(
         `      Status: ${state?.name || "unknown"}${assigneeName ? ` | Assignee: ${assigneeName}` : ""}`
       );
+      if (options.export) {
+        if (issue.description) {
+          ctx.output.data(`      Description: ${issue.description}`);
+        }
+        if (labels && labels.length > 0) {
+          ctx.output.data(
+            `      Labels: ${labels.map((l) => l.name).join(", ")}`
+          );
+        }
+        if (comments && comments.length > 0) {
+          ctx.output.data(`      Comments: ${comments.length}`);
+        }
+      }
     }
     ctx.output.data("");
     ctx.output.data("   Use `skill linear issue <ID> --json` for full details.");
@@ -116582,6 +116975,13 @@ Quick start:
   skill linear create "Title"        Create issue
   skill linear search "query"        Search issues
 
+Bulk queries:
+  skill linear issues --older-than 90d          Stale issues
+  skill linear issues --older-than 2w --export  Full data export
+
+Environment:
+  LINEAR_API_KEY required. Run 'skill doctor' to check.
+
 All commands support --json for machine-readable output.
 
 \u26A0\uFE0F  Write operations require personal LINEAR_API_KEY (run 'skill keys add').`
@@ -116594,8 +116994,10 @@ Examples:
   skill linear issues --team ENG              Filter by team
   skill linear issues --state "In Progress"   Filter by state
   skill linear issues --assignee me           Your issues
-  skill linear issues --priority 0            Urgent only`
-  ).option("--limit <number>", "Maximum results (default: 20)", "20").option("--team <key>", "Filter by team key (e.g., ENG)").option("--state <name>", "Filter by state name").option("--assignee <email>", 'Filter by assignee (or "me")').option("--project <name>", "Filter by project name").option("--priority <0-4>", "Filter by priority (0=urgent)").option("--json", "Output as JSON with HATEOAS links").action(async (options, command) => {
+  skill linear issues --priority 0            Urgent only
+  skill linear issues --older-than 90d        Stale issues (90+ days)
+  skill linear issues --older-than 2w --export  Full export`
+  ).option("--limit <number>", "Maximum results (default: 20)", "20").option("--team <key>", "Filter by team key (e.g., ENG)").option("--state <name>", "Filter by state name").option("--assignee <email>", 'Filter by assignee (or "me")').option("--project <name>", "Filter by project name").option("--priority <0-4>", "Filter by priority (0=urgent)").option("--older-than <time>", "Filter by last update (90d, 2w, 24h, 3m)").option("--export", "Include full details (description, labels, comments)").option("--json", "Output as JSON with HATEOAS links").action(async (options, command) => {
     const ctx = await contextFromCommand2(command, options);
     await listIssues(ctx, {
       limit: parseInt(options.limit || "20", 10),
@@ -116603,7 +117005,9 @@ Examples:
       state: options.state,
       assignee: options.assignee,
       project: options.project,
-      priority: options.priority !== void 0 ? parseInt(options.priority, 10) : void 0
+      priority: options.priority !== void 0 ? parseInt(options.priority, 10) : void 0,
+      olderThan: options.olderThan,
+      export: options.export
     });
   });
   linear.command("my").description(
@@ -116850,6 +117254,101 @@ Examples:
   });
 }
 
+// src/commands/list.ts
+init_esm_shims();
+import { existsSync as existsSync16, readFileSync as readFileSync13, readdirSync, statSync } from "fs";
+import { join as join14 } from "path";
+function discoverSkills(skillsDir) {
+  if (!existsSync16(skillsDir)) {
+    return [];
+  }
+  const skills = [];
+  try {
+    const entries = readdirSync(skillsDir);
+    for (const entry of entries) {
+      const entryPath = join14(skillsDir, entry);
+      const stat = statSync(entryPath);
+      if (!stat.isDirectory()) continue;
+      const skillPath = join14(entryPath, "SKILL.md");
+      if (!existsSync16(skillPath)) continue;
+      const content = readFileSync13(skillPath, "utf8");
+      const description = extractDescription(content);
+      skills.push({
+        name: entry,
+        description,
+        path: skillPath
+      });
+    }
+  } catch {
+    return [];
+  }
+  return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
+function extractDescription(markdown) {
+  const lines = markdown.split("\n");
+  let inFrontmatter = false;
+  let foundHeading = false;
+  const descriptionLines = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed === "---") {
+      if (!inFrontmatter && !foundHeading) {
+        inFrontmatter = true;
+        continue;
+      } else if (inFrontmatter) {
+        inFrontmatter = false;
+        continue;
+      }
+    }
+    if (inFrontmatter) continue;
+    if (trimmed.startsWith("# ")) {
+      foundHeading = true;
+      continue;
+    }
+    if (foundHeading && trimmed.startsWith("#")) {
+      break;
+    }
+    if (foundHeading) {
+      if (trimmed === "") {
+        if (descriptionLines.length > 0) {
+          break;
+        }
+        continue;
+      }
+      descriptionLines.push(trimmed);
+    }
+  }
+  return descriptionLines.join(" ").trim();
+}
+async function listAction(options, command) {
+  const ctx = await createContext({
+    format: options.json ? "json" : command.optsWithGlobals().format,
+    verbose: command.optsWithGlobals().verbose,
+    quiet: command.optsWithGlobals().quiet
+  });
+  const skillsDir = join14(process.cwd(), ".claude", "skills");
+  const skills = discoverSkills(skillsDir);
+  if (options.json) {
+    ctx.output.data({ skills });
+    return;
+  }
+  if (skills.length === 0) {
+    ctx.output.message("No skills found in .claude/skills/");
+    return;
+  }
+  ctx.output.data(`
+\u{1F4DA} Available Skills (${skills.length})`);
+  ctx.output.data("\u2500".repeat(80));
+  const rows = skills.map((skill) => ({
+    Name: skill.name,
+    Description: skill.description || "(no description)"
+  }));
+  ctx.output.table(rows);
+}
+function registerListCommand(program3) {
+  program3.command("list").description("List available CLI skills for programmatic discovery").option("--json", "Output as JSON").action(listAction);
+}
+
 // src/commands/memory/index.ts
 init_esm_shims();
 
@@ -117979,16 +118478,16 @@ function registerPipelineCommands(program3) {
 // src/commands/plugin-sync.ts
 init_esm_shims();
 import { homedir as homedir3 } from "os";
-import { dirname as dirname3, join as join13, resolve as resolve6 } from "path";
+import { dirname as dirname3, join as join15, resolve as resolve6 } from "path";
 import { fileURLToPath } from "url";
 var PLUGIN_SOURCE_DIR = resolve6(
   dirname3(fileURLToPath(import.meta.url)),
   "../../plugin"
 );
-var PLUGIN_MANIFEST_RELATIVE = join13(".claude-plugin", "plugin.json");
+var PLUGIN_MANIFEST_RELATIVE = join15(".claude-plugin", "plugin.json");
 var resolveTargetDir = (global2) => {
-  const base = join13(homedir3(), ".claude", global2 ? "skills" : "plugins");
-  return join13(base, "skill-cli");
+  const base = join15(homedir3(), ".claude", global2 ? "skills" : "plugins");
+  return join15(base, "skill-cli");
 };
 var readManifest = async (path) => {
   const manifest = await readJson(path);
@@ -118017,7 +118516,7 @@ var writeResult4 = (ctx, payload) => {
 };
 async function executePluginSync(ctx, options) {
   try {
-    const sourceManifestPath = join13(PLUGIN_SOURCE_DIR, PLUGIN_MANIFEST_RELATIVE);
+    const sourceManifestPath = join15(PLUGIN_SOURCE_DIR, PLUGIN_MANIFEST_RELATIVE);
     const sourceExists = await pathExists(sourceManifestPath);
     if (!sourceExists) {
       throw new CLIError({
@@ -118027,7 +118526,7 @@ async function executePluginSync(ctx, options) {
     }
     const sourceManifest = await readManifest(sourceManifestPath);
     const targetDir = resolveTargetDir(options.global);
-    const targetManifestPath = join13(targetDir, PLUGIN_MANIFEST_RELATIVE);
+    const targetManifestPath = join15(targetDir, PLUGIN_MANIFEST_RELATIVE);
     const targetExists = await pathExists(targetManifestPath);
     if (targetExists && !options.force) {
       const targetManifest = await readManifest(targetManifestPath);
@@ -119270,7 +119769,7 @@ init_esm_shims();
 import { spawn } from "child_process";
 import { writeFile as writeFile7 } from "fs/promises";
 import { homedir as homedir4 } from "os";
-import { dirname as dirname4, join as join14 } from "path";
+import { dirname as dirname4, join as join16 } from "path";
 var CONFIG_DIR_NAME = "skill-cli";
 var AUTO_UPDATE_STATE_FILE = "auto-update.json";
 var DEFAULT_PACKAGE = "@skillrecordings/cli";
@@ -119282,7 +119781,7 @@ var AutoUpdateStore = class {
   now;
   constructor(options = {}) {
     const configDir = resolveConfigDir(options.configDir);
-    this.filePath = join14(configDir, AUTO_UPDATE_STATE_FILE);
+    this.filePath = join16(configDir, AUTO_UPDATE_STATE_FILE);
     this.now = options.now ?? (() => /* @__PURE__ */ new Date());
   }
   getNow() {
@@ -119310,9 +119809,9 @@ function resolveConfigDir(configDir) {
   if (configDir) return configDir;
   const xdgConfigHome = process.env.XDG_CONFIG_HOME;
   if (xdgConfigHome && xdgConfigHome.trim() !== "") {
-    return join14(xdgConfigHome, CONFIG_DIR_NAME);
+    return join16(xdgConfigHome, CONFIG_DIR_NAME);
   }
-  return join14(homedir4(), ".config", CONFIG_DIR_NAME);
+  return join16(homedir4(), ".config", CONFIG_DIR_NAME);
 }
 function isAutoUpdateState(value) {
   if (!value || typeof value !== "object") return false;
@@ -119609,13 +120108,13 @@ var writeHints = (hints, stderr) => {
 init_esm_shims();
 import { lstat, readlink, symlink } from "fs/promises";
 import { homedir as homedir5 } from "os";
-import { dirname as dirname5, join as join15, resolve as resolve7 } from "path";
+import { dirname as dirname5, join as join17, resolve as resolve7 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var SKILL_SOURCE_DIR = resolve7(
   dirname5(fileURLToPath2(import.meta.url)),
   "../../../../.claude/skills/skill-cli"
 );
-var SKILL_TARGET_DIR = join15(homedir5(), ".claude", "skills", "skill-cli");
+var SKILL_TARGET_DIR = join17(homedir5(), ".claude", "skills", "skill-cli");
 async function autoLinkSkill() {
   const source = SKILL_SOURCE_DIR;
   const target = SKILL_TARGET_DIR;
@@ -119719,16 +120218,16 @@ async function sendTelemetryEvent(event) {
 init_esm_shims();
 import { writeFile as writeFile8 } from "fs/promises";
 import { homedir as homedir6 } from "os";
-import { dirname as dirname6, join as join16 } from "path";
+import { dirname as dirname6, join as join18 } from "path";
 var CONFIG_DIR_NAME2 = "skill-cli";
 var USAGE_FILE_NAME = "usage.json";
 function resolveConfigDir2(configDir) {
   if (configDir) return configDir;
   const xdgConfigHome = process.env.XDG_CONFIG_HOME;
   if (xdgConfigHome && xdgConfigHome.trim() !== "") {
-    return join16(xdgConfigHome, CONFIG_DIR_NAME2);
+    return join18(xdgConfigHome, CONFIG_DIR_NAME2);
   }
-  return join16(homedir6(), ".config", CONFIG_DIR_NAME2);
+  return join18(homedir6(), ".config", CONFIG_DIR_NAME2);
 }
 function createDefaultState(now) {
   return {
@@ -119766,7 +120265,7 @@ var UsageTracker = class {
   statePromise;
   constructor(options = {}) {
     const configDir = resolveConfigDir2(options.configDir);
-    this.filePath = join16(configDir, USAGE_FILE_NAME);
+    this.filePath = join18(configDir, USAGE_FILE_NAME);
     this.now = options.now ?? (() => /* @__PURE__ */ new Date());
   }
   async loadState() {
@@ -120345,8 +120844,8 @@ if (!envLoaded && !process.env.DATABASE_URL) {
   process.env.SKIP_ENV_VALIDATION = "1";
 }
 var runtimeTarget = `bun-${process.platform}-${process.arch}`;
-var buildVersion = "0.17.0".length > 0 ? "0.17.0" : "0.0.0-dev";
-var buildCommit = "e664abd".length > 0 ? "e664abd" : "dev";
+var buildVersion = "0.18.0".length > 0 ? "0.18.0" : "0.0.0-dev";
+var buildCommit = "8d98b14".length > 0 ? "8d98b14" : "dev";
 var buildTarget = "node".length > 0 ? "node" : runtimeTarget;
 var isDevBuild = buildVersion.includes("dev") || buildCommit === "dev";
 var versionLabel = `skill v${buildVersion} (${buildCommit}) ${buildTarget}`;
@@ -120551,6 +121050,8 @@ registerKbCommands(program2);
 registerAuthCommands(program2, usageState);
 registerConfigCommands(program2);
 registerKeysCommands(program2);
+registerDoctorCommand(program2);
+registerListCommand(program2);
 registerPluginSyncCommand(program2);
 program2.command("mcp").description(
   "Start MCP server for AI coding agent integration.\n  Exposes 9 Front tools over JSON-RPC stdio for Claude Code, Cursor, etc.\n  Tools: inbox, conversation, message, assign, reply, tag, archive, search, report\n  Usage: skill mcp  (then connect your AI editor to stdin/stdout)"