@merittdev/horus 0.1.16 → 0.1.17

package/dist/index.cjs

@@ -50314,7 +50314,7 @@ init_cjs_shims();
 
 // ../../packages/core/src/version.ts
 init_cjs_shims();
-var HORUS_VERSION = true ? "0.1.16" : "dev";
+var HORUS_VERSION = true ? "0.1.17" : "dev";
 var PINNED_AXON_VERSION = "1.0.7";
 var PINNED_SOURCE_VERSION = PINNED_AXON_VERSION;
 
@@ -59087,7 +59087,7 @@ function sql(strings, ...params) {
     return new SQL([new StringChunk(str)]);
   }
   sql2.raw = raw;
-  function join5(chunks, separator) {
+  function join6(chunks, separator) {
     const result = [];
     for (const [i, chunk] of chunks.entries()) {
       if (i > 0 && separator !== void 0) {
@@ -59097,7 +59097,7 @@ function sql(strings, ...params) {
     }
     return new SQL(result);
   }
-  sql2.join = join5;
+  sql2.join = join6;
   function identifier(value) {
     return new Name(value);
   }
@@ -62688,7 +62688,7 @@ var PgSelectQueryBuilderBase = class extends TypedQueryBuilder {
     return (table, on) => {
       const baseTableName = this.tableName;
       const tableName = getTableLikeName(table);
-      if (typeof tableName === "string" && this.config.joins?.some((join5) => join5.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins?.some((join6) => join6.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (!this.isPartialSelect) {
@@ -63700,7 +63700,7 @@ var PgUpdateBase = class extends QueryPromise {
   createJoin(joinType) {
     return (table, on) => {
       const tableName = getTableLikeName(table);
-      if (typeof tableName === "string" && this.config.joins.some((join5) => join5.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins.some((join6) => join6.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (typeof on === "function") {
@@ -63796,10 +63796,10 @@ var PgUpdateBase = class extends QueryPromise {
           const fromFields = this.getTableLikeFields(this.config.from);
           fields[tableName] = fromFields;
         }
-        for (const join5 of this.config.joins) {
-          const tableName2 = getTableLikeName(join5.table);
-          if (typeof tableName2 === "string" && !is(join5.table, SQL)) {
-            const fromFields = this.getTableLikeFields(join5.table);
+        for (const join6 of this.config.joins) {
+          const tableName2 = getTableLikeName(join6.table);
+          if (typeof tableName2 === "string" && !is(join6.table, SQL)) {
+            const fromFields = this.getTableLikeFields(join6.table);
             fields[tableName2] = fromFields;
           }
         }
@@ -72938,22 +72938,22 @@ function extractQueueGraph(input) {
     }
   }
   const producers = [];
-  for (const pc35 of input.producerClasses) {
-    for (const m of pc35.content.matchAll(INJECT_QUEUE_RE)) {
+  for (const pc36 of input.producerClasses) {
+    for (const m of pc36.content.matchAll(INJECT_QUEUE_RE)) {
       const queue = m[1] ?? "";
-      if (queue) producers.push({ queue, symbol: pc35.name, file: pc35.filePath });
+      if (queue) producers.push({ queue, symbol: pc36.name, file: pc36.filePath });
     }
-    for (const m of pc35.content.matchAll(NEW_BULL_RE)) {
+    for (const m of pc36.content.matchAll(NEW_BULL_RE)) {
       if (m[2] !== "Queue") continue;
       const queue = resolveArg(m[3] ?? "", constMap);
       if (queue) {
-        producers.push({ queue, symbol: (m[1] ?? pc35.name) || baseName(pc35.filePath), file: pc35.filePath });
+        producers.push({ queue, symbol: (m[1] ?? pc36.name) || baseName(pc36.filePath), file: pc36.filePath });
       }
     }
-    for (const m of pc35.content.matchAll(QUEUE_NAME_CONST_RE)) {
+    for (const m of pc36.content.matchAll(QUEUE_NAME_CONST_RE)) {
       const ident = m[1] ?? "";
       const queue = m[2] ?? "";
-      if (queue) producers.push({ queue, symbol: ident || baseName(pc35.filePath), file: pc35.filePath });
+      if (queue) producers.push({ queue, symbol: ident || baseName(pc36.filePath), file: pc36.filePath });
     }
   }
   const workers = [];
@@ -77899,6 +77899,153 @@ async function runReadiness(opts) {
   return blockingFails.length > 0 ? 1 : 0;
 }
 
+// ../../packages/cli/src/commands/skill.ts
+init_cjs_shims();
+var import_node_fs9 = require("fs");
+var import_node_path11 = require("path");
+var import_node_os2 = require("os");
+var import_picocolors35 = __toESM(require_picocolors(), 1);
+var SUPPORTED_TARGETS = ["claude", "codex", "gemini", "cursor", "generic"];
+function isValidTarget(target) {
+  return SUPPORTED_TARGETS.includes(target);
+}
+function getSkillInstallPath(target, opts) {
+  const base2 = opts.global ? (0, import_node_os2.homedir)() : opts.cwd ?? process.cwd();
+  if (target === "claude") {
+    return (0, import_node_path11.join)(base2, ".claude", "skills", "horus.md");
+  }
+  return (0, import_node_path11.join)(base2, ".horus", "skills", `horus-${target}.md`);
+}
+var BASE_SKILL = `# Horus Incident Investigation Skill
+
+When investigating a production issue in a repo with Horus configured, use Horus before guessing.
+
+## When to use Horus
+
+Use Horus when the user asks:
+- why something is broken, slow, or failing
+- about a production incident or outage
+- what changed recently
+- who owns a component or service
+- about blast radius or impact of a change
+- about queues, workers, Redis/BullMQ, logs, metrics, MongoDB state, or source paths
+- to verify a fix or check for regressions after a change
+
+## Getting started
+
+\`\`\`bash
+horus status
+horus explain <symbol-or-hint>
+horus investigate "<incident hint>"
+\`\`\`
+
+## Runtime evidence
+
+\`\`\`bash
+horus logs [service]
+horus state
+horus metrics "<hint>"
+horus queues --live
+\`\`\`
+
+## Source reasoning
+
+\`\`\`bash
+horus blast-radius <symbol>
+horus owner <symbol>
+horus changes <base> [compare]
+horus timeline
+horus what-changed
+\`\`\`
+
+## Saved investigations
+
+\`\`\`bash
+horus replay <id>
+horus ask <id> "what evidence is missing?"
+horus ask <id> "what evidence contradicts <hypothesis>?"
+horus postmortem <id>
+horus score <id>
+\`\`\`
+
+## Rules
+
+- Treat Horus evidence as grounded but not infallible.
+- Mention when Horus evidence is missing, stale, ambient, or not structurally linked.
+- Do not invent runtime evidence Horus did not collect.
+- Prefer exact source locations from Horus over guesses.
+- If Horus output conflicts with filesystem or source inspection, report the discrepancy.
+- For write or fix tasks, use Horus to validate blast radius and rerun relevant checks after changes.
+- Horus is read-only evidence collection \u2014 never use Horus to mutate production systems.
+- Do not hallucinate evidence. If Horus returns nothing, say so explicitly.
+`;
+var CLAUDE_SUFFIX = `## Claude Code notes
+
+This skill is loaded automatically when present at \`.claude/skills/horus.md\`.
+
+Useful starting points:
+- \`horus investigations\` \u2014 list saved investigation IDs
+- \`horus doctor\` \u2014 check system health
+- \`horus onboard [area]\` \u2014 get oriented in a new codebase area
+`;
+function generateSkillContent(target) {
+  if (target === "claude") {
+    return BASE_SKILL + "\n" + CLAUDE_SUFFIX;
+  }
+  return BASE_SKILL;
+}
+async function runSkillInstall(target, opts) {
+  const log = opts.write ?? ((line2) => console.log(line2));
+  if (!isValidTarget(target)) {
+    log(`${import_picocolors35.default.red("\u2717")} Unknown target: ${import_picocolors35.default.bold(target)}`);
+    log(import_picocolors35.default.dim(`  Supported targets: ${SUPPORTED_TARGETS.join(", ")}`));
+    return 1;
+  }
+  const outPath = getSkillInstallPath(target, { global: opts.global, cwd: opts.cwd });
+  const content = generateSkillContent(target);
+  if ((0, import_node_fs9.existsSync)(outPath) && !opts.force) {
+    log(`${import_picocolors35.default.red("\u2717")} ${outPath} already exists`);
+    log(import_picocolors35.default.dim("  pass --force to overwrite"));
+    return 1;
+  }
+  try {
+    (0, import_node_fs9.mkdirSync)((0, import_node_path11.dirname)(outPath), { recursive: true });
+    (0, import_node_fs9.writeFileSync)(outPath, content, "utf8");
+  } catch (err) {
+    log(`${import_picocolors35.default.red("\u2717")} Could not write ${outPath}: ${err.message}`);
+    return 1;
+  }
+  log(`${import_picocolors35.default.green("\u2713")} Horus skill installed \u2192 ${outPath}`);
+  if (target === "claude") {
+    log(import_picocolors35.default.dim("  Claude Code will load this skill automatically."));
+    log(import_picocolors35.default.dim("  Invoke it with: /horus"));
+  } else {
+    log(import_picocolors35.default.dim(`  Copy or reference this file in your ${target} agent instructions.`));
+  }
+  return 0;
+}
+async function runSkillPrint(target, opts) {
+  const log = opts.write ?? ((line2) => console.log(line2));
+  if (!isValidTarget(target)) {
+    log(`${import_picocolors35.default.red("\u2717")} Unknown target: ${import_picocolors35.default.bold(target)}`);
+    log(import_picocolors35.default.dim(`  Supported targets: ${SUPPORTED_TARGETS.join(", ")}`));
+    return 1;
+  }
+  process.stdout.write(generateSkillContent(target));
+  return 0;
+}
+async function runSkillPath(target, opts) {
+  const log = opts.write ?? ((line2) => console.log(line2));
+  if (!isValidTarget(target)) {
+    log(`${import_picocolors35.default.red("\u2717")} Unknown target: ${import_picocolors35.default.bold(target)}`);
+    log(import_picocolors35.default.dim(`  Supported targets: ${SUPPORTED_TARGETS.join(", ")}`));
+    return 1;
+  }
+  const outPath = getSkillInstallPath(target, { global: opts.global, cwd: opts.cwd });
+  log(outPath);
+  return 0;
+}
+
 // ../../packages/cli/src/index.ts
 function buildProgram() {
   const program2 = new Command();
@@ -78211,6 +78358,36 @@ Examples:
       process.exitCode = await runMetrics(hint, opts);
     }
   );
+  const skill = program2.command("skill").description("Manage the Horus agent skill \u2014 install playbooks that teach agents to use Horus as their evidence layer");
+  skill.command("install <target>").description("Install the Horus skill for a coding agent (claude | codex | gemini | cursor | generic)").option("--force", "overwrite an existing skill file").option("--global", "install into the home directory instead of the current repo").action(async (target, opts) => {
+    process.exitCode = await runSkillInstall(target, { force: opts.force, global: opts.global });
+  }).addHelpText("after", `
+Targets:
+  claude   \u2192 .claude/skills/horus.md  (Claude Code \u2014 loaded automatically)
+  codex    \u2192 .horus/skills/horus-codex.md
+  gemini   \u2192 .horus/skills/horus-gemini.md
+  cursor   \u2192 .horus/skills/horus-cursor.md
+  generic  \u2192 .horus/skills/horus-generic.md
+
+Examples:
+  horus skill install claude
+  horus skill install generic --force
+  horus skill install claude --global
+`);
+  skill.command("print <target>").description("Print the Horus skill to stdout \u2014 copy it into any agent setup").action(async (target) => {
+    process.exitCode = await runSkillPrint(target, {});
+  }).addHelpText("after", `
+Examples:
+  horus skill print generic
+  horus skill print claude
+`);
+  skill.command("path <target>").description("Print the install path for the given target").option("--global", "show the global (home directory) path").action(async (target, opts) => {
+    process.exitCode = await runSkillPath(target, { global: opts.global });
+  }).addHelpText("after", `
+Examples:
+  horus skill path claude
+  horus skill path generic --global
+`);
   return program2;
 }
 async function run(argv = process.argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@merittdev/horus",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Local-first, source-aware production-incident investigation engine",
   "type": "module",
   "bin": {