@kody-ade/kody-engine 0.4.194 → 0.4.195-dev.0

package/dist/bin/kody.js

@@ -545,7 +545,11 @@ var init_issue = __esm({
 var dutyMcp_exports = {};
 __export(dutyMcp_exports, {
   DUTY_MCP_TOOL_NAMES: () => DUTY_MCP_TOOL_NAMES,
-  buildDutyMcpServer: () => buildDutyMcpServer
+  buildDutyMcpServer: () => buildDutyMcpServer,
+  dispatchWorkflow: () => dispatchWorkflow,
+  ensureComment: () => ensureComment,
+  ensureIssue: () => ensureIssue,
+  readCheckRuns: () => readCheckRuns
 });
 import { createSdkMcpServer as createSdkMcpServer3, tool as tool3 } from "@anthropic-ai/claude-agent-sdk";
 import { z as z3 } from "zod";
@@ -599,20 +603,7 @@ function listRepairCandidates(repoSlug) {
   });
 }
 function dispatchVerb(workflowFile, executable, prNumber) {
-  try {
-    gh([
-      "workflow",
-      "run",
-      workflowFile,
-      "-f",
-      `executable=${executable}`,
-      "-f",
-      `issue_number=${prNumber}`
-    ]);
-    return { ok: true };
-  } catch (err) {
-    return { ok: false, error: err instanceof Error ? err.message : String(err) };
-  }
+  return dispatchWorkflow(workflowFile, executable, prNumber);
 }
 function postRecommendation(prNumber, mention, message) {
   const body = mention ? `${mention} ${message}` : message;
@@ -660,6 +651,64 @@ function readLedger(label) {
     return { found: false, payload: { error: err instanceof Error ? err.message : String(err) } };
   }
 }
+function readCheckRuns(repoSlug, ref, ignoreNames) {
+  const sha = gh(["api", `repos/${repoSlug}/commits/${ref}`, "--jq", ".sha"]).trim();
+  const raw = gh([
+    "api",
+    `repos/${repoSlug}/commits/${sha}/check-runs`,
+    "--paginate",
+    "--jq",
+    ".check_runs[] | {name, status, conclusion, details_url}"
+  ]);
+  const ignore = new Set(ignoreNames.map((n) => n.toLowerCase()));
+  const checks = raw.split("\n").map((l) => l.trim()).filter(Boolean).map((l) => JSON.parse(l)).filter((c) => !ignore.has(String(c.name).toLowerCase()));
+  const failing = checks.filter((c) => CHECK_FAIL_CONCLUSIONS.has(String(c.conclusion ?? "").toUpperCase())).map((c) => ({ name: c.name, conclusion: String(c.conclusion), detailsUrl: c.details_url }));
+  const pending = checks.filter((c) => String(c.status).toLowerCase() !== "completed").map((c) => ({ name: c.name, status: c.status }));
+  const state = failing.length > 0 ? "RED" : pending.length > 0 ? "PENDING" : "GREEN";
+  return { sha, state, failing, pending };
+}
+function ensureIssue(repoSlug, key, title, body) {
+  const marker = trackMarker(key);
+  try {
+    const raw = gh(["issue", "list", "-R", repoSlug, "--state", "open", "--limit", "100", "--json", "number,body"]);
+    const issues = JSON.parse(raw);
+    const existing = issues.find((i) => (i.body ?? "").includes(marker));
+    if (existing) return { created: false, number: existing.number };
+    const url = gh(["issue", "create", "-R", repoSlug, "--title", title, "--body-file", "-"], {
+      input: `${body}
+
+${marker}`
+    });
+    const m = url.trim().match(/\/(\d+)\s*$/);
+    if (!m) return { error: `issue created but could not parse its number from: ${url}` };
+    return { created: true, number: Number(m[1]) };
+  } catch (err) {
+    return { error: err instanceof Error ? err.message : String(err) };
+  }
+}
+function ensureComment(repoSlug, issue, key, body) {
+  const marker = commentMarker(key);
+  try {
+    const raw = gh(["issue", "view", String(issue), "-R", repoSlug, "--json", "comments"]);
+    const parsed = JSON.parse(raw);
+    const already = (parsed.comments ?? []).some((c) => (c.body ?? "").includes(marker));
+    if (already) return { posted: false };
+    gh(["issue", "comment", String(issue), "-R", repoSlug, "--body-file", "-"], { input: `${body}
+
+${marker}` });
+    return { posted: true };
+  } catch (err) {
+    return { error: err instanceof Error ? err.message : String(err) };
+  }
+}
+function dispatchWorkflow(workflowFile, executable, issueNumber) {
+  try {
+    gh(["workflow", "run", workflowFile, "-f", `executable=${executable}`, "-f", `issue_number=${issueNumber}`]);
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  }
+}
 function buildDutyMcpServer(opts) {
   const workflowFile = opts.workflowFile ?? "kody.yml";
   const listTool = tool3(
@@ -737,27 +786,97 @@ function buildDutyMcpServer(opts) {
       };
     }
   );
+  const checkRunsTool = tool3(
+    "read_check_runs",
+    "Read CI for a branch or commit ref (e.g. 'dev'). Returns {sha, state, failing:[{name,conclusion,detailsUrl}], pending:[{name,status}]}. state is RED (\u22651 check has a terminal-failure conclusion: failure/timed_out/startup_failure/action_required), PENDING (none failed but some still running), or GREEN (all completed, none failed). Kody's own job check-runs (run/kody/job-tick/\u2026) are excluded by default. This reads the commit's authoritative check-runs \u2014 use it instead of guessing CI health from a run list.",
+    {
+      ref: z3.string().min(1).describe("Branch name or commit SHA to read CI for (e.g. 'dev')."),
+      ignoreNames: z3.array(z3.string()).optional().describe("Check names to exclude (default: Kody's own job names).")
+    },
+    async (args) => {
+      const result = readCheckRuns(opts.repoSlug, args.ref, args.ignoreNames ?? DEFAULT_IGNORE_CHECKS);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  const ensureIssueTool = tool3(
+    "ensure_issue",
+    "Idempotently ensure ONE open tracking issue exists for `key`. Searches OPEN issues (issues API, not the laggy search index) for `key`'s hidden marker; if found, returns {created:false, number} and creates NOTHING; otherwise creates the issue (title + body, marker appended) and returns {created:true, number}. This is the anti-duplication primitive: use one stable `key` per recurring finding so re-ticks reuse the same issue. Only take follow-up actions (dispatch/comment) when created===true.",
+    {
+      key: z3.string().min(1).describe("Stable dedup identity for this finding (e.g. 'dev-ci-red', 'docs-drift:<feature>'). Same key across ticks = same issue."),
+      title: z3.string().min(1).describe("Issue title (used only on first creation)."),
+      body: z3.string().min(1).describe("Issue body markdown (used only on first creation). Include the operator mention verbatim if the duty body has one.")
+    },
+    async (args) => {
+      const result = ensureIssue(opts.repoSlug, args.key, args.title, args.body);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  const ensureCommentTool = tool3(
+    "ensure_comment",
+    "Idempotently post ONE comment on an issue for `key`. If a comment carrying `key`'s marker already exists on the issue, returns {posted:false}; otherwise posts the comment (marker appended) and returns {posted:true}. Use for a notify/audit comment that must appear exactly once.",
+    {
+      issue: z3.number().int().positive().describe("Issue number to comment on."),
+      key: z3.string().min(1).describe("Stable dedup identity for this comment (e.g. 'dev-ci-red:dispatched')."),
+      body: z3.string().min(1).describe("Comment body markdown.")
+    },
+    async (args) => {
+      const result = ensureComment(opts.repoSlug, args.issue, args.key, args.body);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  const dispatchTool = tool3(
+    "dispatch_workflow",
+    "Dispatch a kody.yml workflow_dispatch run for an executable against an issue (the cross-run bot\u2192engine path; a bot `@kody` comment would be dropped). E.g. dispatch_workflow({executable:'run', issueNumber:<n>}) opens a fix PR from a tracking issue. Returns {ok} or {ok:false,error}.",
+    {
+      executable: z3.string().min(1).describe("Executable/stage to run (e.g. 'run')."),
+      issueNumber: z3.number().int().positive().describe("Issue (or PR) number forwarded as issue_number.")
+    },
+    async (args) => {
+      const result = dispatchWorkflow(workflowFile, args.executable, args.issueNumber);
+      const text = result.ok ? `Dispatched \`${args.executable}\` on #${args.issueNumber} via workflow_dispatch.` : `Dispatch failed for \`${args.executable}\` on #${args.issueNumber}: ${result.error}`;
+      return { content: [{ type: "text", text }] };
+    }
+  );
   const server = createSdkMcpServer3({
     name: "kody-duty",
     version: "0.1.0",
-    tools: [listTool, syncTool, fixCiTool, resolveTool, recommendTool, ledgerTool]
+    tools: [
+      listTool,
+      syncTool,
+      fixCiTool,
+      resolveTool,
+      recommendTool,
+      ledgerTool,
+      checkRunsTool,
+      ensureIssueTool,
+      ensureCommentTool,
+      dispatchTool
+    ]
   });
   return { server };
 }
-var FAIL_CONCLUSIONS, RUNNING_STATUSES, DUTY_MCP_TOOL_NAMES;
+var FAIL_CONCLUSIONS, RUNNING_STATUSES, CHECK_FAIL_CONCLUSIONS, DEFAULT_IGNORE_CHECKS, trackMarker, commentMarker, DUTY_MCP_TOOL_NAMES;
 var init_dutyMcp = __esm({
   "src/dutyMcp.ts"() {
     "use strict";
     init_issue();
     FAIL_CONCLUSIONS = /* @__PURE__ */ new Set(["FAILURE", "TIMED_OUT", "ACTION_REQUIRED", "STARTUP_FAILURE", "CANCELLED"]);
     RUNNING_STATUSES = /* @__PURE__ */ new Set(["IN_PROGRESS", "QUEUED", "PENDING", "WAITING", "REQUESTED"]);
+    CHECK_FAIL_CONCLUSIONS = /* @__PURE__ */ new Set(["FAILURE", "TIMED_OUT", "STARTUP_FAILURE", "ACTION_REQUIRED"]);
+    DEFAULT_IGNORE_CHECKS = ["run", "kody", "job-tick", "goal-tick", "worker-ask", "chat"];
+    trackMarker = (key) => `<!-- kody-track:${key} -->`;
+    commentMarker = (key) => `<!-- kody-track-comment:${key} -->`;
     DUTY_MCP_TOOL_NAMES = [
       "list_prs_to_repair",
       "sync_pr",
       "fix_ci_pr",
       "resolve_pr",
       "recommend_to_operator",
-      "read_ledger"
+      "read_ledger",
+      "read_check_runs",
+      "ensure_issue",
+      "ensure_comment",
+      "dispatch_workflow"
     ];
   }
 });
@@ -1309,7 +1428,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.194",
+  version: "0.4.195-dev.0",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.194",
+  "version": "0.4.195-dev.0",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",