@kody-ade/kody-engine 0.4.95 → 0.4.96

package/dist/bin/kody.js

@@ -626,28 +626,28 @@ var loadMemoryContext_exports = {};
 __export(loadMemoryContext_exports, {
   loadMemoryContext: () => loadMemoryContext
 });
-import * as fs31 from "fs";
-import * as path29 from "path";
+import * as fs32 from "fs";
+import * as path30 from "path";
 function collectPages(memoryAbs) {
   const out = [];
   walkMd(memoryAbs, (file) => {
     let stat;
     try {
-      stat = fs31.statSync(file);
+      stat = fs32.statSync(file);
     } catch {
       return;
     }
     let raw;
     try {
-      raw = fs31.readFileSync(file, "utf-8");
+      raw = fs32.readFileSync(file, "utf-8");
     } catch {
       return;
     }
     const fm = raw.match(/^---\s*\n([\s\S]*?)\n---/);
-    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path29.basename(file, ".md");
+    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path30.basename(file, ".md");
     const updated = fm?.[1]?.match(/^updated:\s*([0-9T:.+\-Z]+)/m)?.[1]?.trim() ?? "";
     out.push({
-      relPath: path29.relative(memoryAbs, file),
+      relPath: path30.relative(memoryAbs, file),
       title,
       updated,
       content: raw.length > PER_PAGE_MAX_BYTES ? raw.slice(0, PER_PAGE_MAX_BYTES) + TRUNCATED_SUFFIX : raw,
@@ -715,16 +715,16 @@ function walkMd(root, visit) {
     const dir = stack.pop();
     let names;
     try {
-      names = fs31.readdirSync(dir);
+      names = fs32.readdirSync(dir);
     } catch {
       continue;
     }
     for (const name of names) {
       if (name.startsWith(".")) continue;
-      const full = path29.join(dir, name);
+      const full = path30.join(dir, name);
       let stat;
       try {
-        stat = fs31.statSync(full);
+        stat = fs32.statSync(full);
       } catch {
         continue;
       }
@@ -747,8 +747,8 @@ var init_loadMemoryContext = __esm({
     TRUNCATED_SUFFIX = "\n\n\u2026 (truncated)";
     loadMemoryContext = async (ctx) => {
       if (typeof ctx.data.memoryContext === "string") return;
-      const memoryAbs = path29.join(ctx.cwd, MEMORY_DIR_RELATIVE);
-      if (!fs31.existsSync(memoryAbs)) {
+      const memoryAbs = path30.join(ctx.cwd, MEMORY_DIR_RELATIVE);
+      if (!fs32.existsSync(memoryAbs)) {
         ctx.data.memoryContext = "";
         return;
       }
@@ -877,7 +877,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.95",
+  version: "0.4.96",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -932,8 +932,8 @@ var package_default = {
 
 // src/chat-cli.ts
 import { execFileSync as execFileSync31 } from "child_process";
-import * as fs37 from "fs";
-import * as path34 from "path";
+import * as fs38 from "fs";
+import * as path35 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -2255,8 +2255,8 @@ async function emit2(sink, type, sessionId, suffix, payload) {
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync30 } from "child_process";
-import * as fs36 from "fs";
-import * as path33 from "path";
+import * as fs37 from "fs";
+import * as path34 from "path";
 
 // src/dispatch.ts
 import * as fs10 from "fs";
@@ -2578,8 +2578,8 @@ init_issue();
 
 // src/executor.ts
 import { execFileSync as execFileSync29, spawn as spawn6 } from "child_process";
-import * as fs35 from "fs";
-import * as path32 from "path";
+import * as fs36 from "fs";
+import * as path33 from "path";
 init_events();
 
 // src/lifecycleLabels.ts
@@ -7983,10 +7983,10 @@ import * as fs29 from "fs";
 import * as path27 from "path";
 var VALID_STATES = /* @__PURE__ */ new Set(["active", "abandoned", "closed", "awaiting-merge", "done"]);
 var GoalStateError = class extends Error {
-  constructor(path35, message) {
-    super(`Invalid goal state at ${path35}:
+  constructor(path36, message) {
+    super(`Invalid goal state at ${path36}:
   ${message}`);
-    this.path = path35;
+    this.path = path36;
     this.name = "GoalStateError";
   }
   path;
@@ -8212,6 +8212,79 @@ function humanizeSlug(slug) {
   return slug.split(/[-_]+/).filter((s) => s.length > 0).map((s) => s[0].toUpperCase() + s.slice(1)).join(" ");
 }
 
+// src/scripts/loadWorkerAdhoc.ts
+import * as fs31 from "fs";
+import * as path29 from "path";
+var loadWorkerAdhoc = async (ctx, _profile, args) => {
+  const workersDir = String(args?.workersDir ?? ".kody/workers");
+  const workerSlug = String(ctx.args.worker ?? "").trim();
+  if (!workerSlug) {
+    throw new Error("loadWorkerAdhoc: ctx.args.worker must be a non-empty slug");
+  }
+  const workerPath = path29.join(ctx.cwd, workersDir, `${workerSlug}.md`);
+  if (!fs31.existsSync(workerPath)) {
+    throw new Error(`loadWorkerAdhoc: worker persona not found: ${workerPath}`);
+  }
+  const { title, body } = parsePersona(fs31.readFileSync(workerPath, "utf-8"), workerSlug);
+  const message = resolveMessage(ctx.args.message);
+  if (!message) {
+    throw new Error(
+      "loadWorkerAdhoc: no message \u2014 neither the dispatching comment body nor ctx.args.message provided one"
+    );
+  }
+  ctx.data.workerSlug = workerSlug;
+  ctx.data.workerTitle = title;
+  ctx.data.workerPersona = body;
+  ctx.data.message = message;
+  ctx.data.thread = String(ctx.args.thread ?? "").trim();
+};
+function resolveMessage(messageArg) {
+  const fromComment = readCommentBody();
+  if (fromComment) return stripDirective(fromComment);
+  return String(messageArg ?? "").trim();
+}
+function readCommentBody() {
+  const eventPath = process.env.GITHUB_EVENT_PATH;
+  if (!eventPath || !fs31.existsSync(eventPath)) return "";
+  try {
+    const event = JSON.parse(fs31.readFileSync(eventPath, "utf-8"));
+    return String(event.comment?.body ?? "");
+  } catch {
+    return "";
+  }
+}
+function stripDirective(body) {
+  const lines = body.split("\n");
+  let start = 0;
+  while (start < lines.length) {
+    const line = lines[start].trim();
+    if (line.length === 0) {
+      start++;
+      continue;
+    }
+    if (/@kody\s+worker-ask\b/i.test(line)) {
+      start++;
+      continue;
+    }
+    break;
+  }
+  return lines.slice(start).join("\n").trim();
+}
+function parsePersona(raw, slug) {
+  const stripped = splitFrontmatter(raw).body;
+  const trimmed = stripped.trim();
+  const firstLine2 = trimmed.split("\n", 1)[0] ?? "";
+  const h1 = /^#\s+(.+?)\s*$/.exec(firstLine2);
+  if (h1) {
+    const rest = trimmed.slice(firstLine2.length).replace(/^\n+/, "");
+    return { title: h1[1].trim(), body: rest };
+  }
+  return { title: humanizeSlug2(slug), body: trimmed };
+}
+function humanizeSlug2(slug) {
+  return slug.split(/[-_]+/).filter((s) => s.length > 0).map((s) => s[0].toUpperCase() + s.slice(1)).join(" ");
+}
+
 // src/scripts/index.ts
 init_loadMemoryContext();
 init_loadPriorArt();
@@ -8220,8 +8293,8 @@ init_loadPriorArt();
 init_events();
 
 // src/taskContext.ts
-import * as fs32 from "fs";
-import * as path30 from "path";
+import * as fs33 from "fs";
+import * as path31 from "path";
 var TASK_CONTEXT_SCHEMA_VERSION = 1;
 function buildTaskContext(args) {
   return {
@@ -8237,10 +8310,10 @@ function buildTaskContext(args) {
 }
 function persistTaskContext(cwd, ctx) {
   try {
-    const dir = path30.join(cwd, ".kody", "runs", ctx.runId);
-    fs32.mkdirSync(dir, { recursive: true });
-    const file = path30.join(dir, "task-context.json");
-    fs32.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
+    const dir = path31.join(cwd, ".kody", "runs", ctx.runId);
+    fs33.mkdirSync(dir, { recursive: true });
+    const file = path31.join(dir, "task-context.json");
+    fs33.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
 `);
     return file;
   } catch (err) {
@@ -9603,8 +9676,8 @@ function resolveBaseOverride(value) {
 
 // src/scripts/runTickScript.ts
 import { spawnSync } from "child_process";
-import * as fs33 from "fs";
-import * as path31 from "path";
+import * as fs34 from "fs";
+import * as path32 from "path";
 var runTickScript = async (ctx, _profile, args) => {
   ctx.skipAgent = true;
   const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
@@ -9616,13 +9689,13 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
     return;
   }
-  const jobPath = path31.join(ctx.cwd, jobsDir, `${slug}.md`);
-  if (!fs33.existsSync(jobPath)) {
+  const jobPath = path32.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs34.existsSync(jobPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: job file not found: ${jobPath}`;
     return;
   }
-  const raw = fs33.readFileSync(jobPath, "utf-8");
+  const raw = fs34.readFileSync(jobPath, "utf-8");
   const { frontmatter } = splitFrontmatter(raw);
   const tickScript = frontmatter.tickScript;
   if (!tickScript) {
@@ -9630,8 +9703,8 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: job ${slug} has no \`tickScript:\` frontmatter \u2014 route via job-tick instead`;
     return;
   }
-  const scriptPath = path31.isAbsolute(tickScript) ? tickScript : path31.join(ctx.cwd, tickScript);
-  if (!fs33.existsSync(scriptPath)) {
+  const scriptPath = path32.isAbsolute(tickScript) ? tickScript : path32.join(ctx.cwd, tickScript);
+  if (!fs34.existsSync(scriptPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
     return;
@@ -10653,7 +10726,7 @@ var writeJobStateFile = async (ctx, _profile, _agentResult, args) => {
 };
 
 // src/scripts/writeRunSummary.ts
-import * as fs34 from "fs";
+import * as fs35 from "fs";
 var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
@@ -10675,7 +10748,7 @@ var writeRunSummary = async (ctx, profile) => {
   if (reason) lines.push(`- **Reason:** ${reason}`);
   lines.push("");
   try {
-    fs34.appendFileSync(summaryPath, `${lines.join("\n")}
+    fs35.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
   } catch {
   }
@@ -10696,6 +10769,7 @@ var preflightScripts = {
   loadIssueContext,
   loadIssueStateComment,
   loadJobFromFile,
+  loadWorkerAdhoc,
   loadConventions,
   loadCoverageRules,
   loadMemoryContext,
@@ -10900,9 +10974,9 @@ async function runExecutable(profileName, input) {
     data: { ...input.preloadedData ?? {} },
     output: { exitCode: 0 }
   };
-  const ndjsonDir = path32.join(input.cwd, ".kody");
+  const ndjsonDir = path33.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path32.isAbsolute(p) ? p : path32.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path33.isAbsolute(p) ? p : path33.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     return runAgent({
@@ -11097,7 +11171,7 @@ function clearStampedLifecycleLabels(profile, ctx) {
 function getProfileInputsForChild(profileName, _cwd) {
   try {
     const profilePath = resolveProfilePath(profileName);
-    if (!fs35.existsSync(profilePath)) return null;
+    if (!fs36.existsSync(profilePath)) return null;
     return loadProfile(profilePath).inputs;
   } catch {
     return null;
@@ -11106,17 +11180,17 @@ function getProfileInputsForChild(profileName, _cwd) {
 function resolveProfilePath(profileName) {
   const found = resolveExecutable(profileName);
   if (found) return found;
-  const here = path32.dirname(new URL(import.meta.url).pathname);
+  const here = path33.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path32.join(here, "executables", profileName, "profile.json"),
+    path33.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path32.join(here, "..", "executables", profileName, "profile.json"),
+    path33.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path32.join(here, "..", "src", "executables", profileName, "profile.json")
+    path33.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs35.existsSync(c)) return c;
+    if (fs36.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -11216,8 +11290,8 @@ function resolveShellTimeoutMs(entry) {
 var SIGKILL_GRACE_MS = 5e3;
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
-  const shellPath = path32.join(profile.dir, shellName);
-  if (!fs35.existsSync(shellPath)) {
+  const shellPath = path33.join(profile.dir, shellName);
+  if (!fs36.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -11696,9 +11770,9 @@ function resolveAuthToken(env = process.env) {
   return token;
 }
 function detectPackageManager2(cwd) {
-  if (fs36.existsSync(path33.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs36.existsSync(path33.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs36.existsSync(path33.join(cwd, "bun.lockb"))) return "bun";
+  if (fs37.existsSync(path34.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs37.existsSync(path34.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs37.existsSync(path34.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
@@ -11785,11 +11859,11 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path33.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path34.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
-    if (fs36.existsSync(logPath)) {
-      const content = fs36.readFileSync(logPath, "utf-8");
+    if (fs37.existsSync(logPath)) {
+      const content = fs37.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -11814,7 +11888,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path33.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path34.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -11824,9 +11898,9 @@ async function runCi(argv) {
   const eventName = process.env.GITHUB_EVENT_NAME;
   const dispatchEventPath = process.env.GITHUB_EVENT_PATH;
   let manualWorkflowDispatch = false;
-  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs36.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs37.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs36.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs37.readFileSync(dispatchEventPath, "utf-8"));
       const issueInput = parseInt(String(evt?.inputs?.issue_number ?? ""), 10);
       const sessionInput = String(evt?.inputs?.sessionId ?? "");
       manualWorkflowDispatch = !sessionInput && !(Number.isFinite(issueInput) && issueInput > 0);
@@ -12085,9 +12159,9 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path34.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path34.relative(cwd, eventsFilePath(cwd, sessionId));
-  const paths = [sessionFile, eventsFile].filter((p) => fs37.existsSync(path34.join(cwd, p)));
+  const sessionFile = path35.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path35.relative(cwd, eventsFilePath(cwd, sessionId));
+  const paths = [sessionFile, eventsFile].filter((p) => fs38.existsSync(path35.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
@@ -12125,7 +12199,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path34.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path35.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {
@@ -12177,7 +12251,7 @@ ${CHAT_HELP}`);
   const sink = buildSink(cwd, sessionId, args.dashboardUrl);
   const meta = readMeta(sessionFile);
   process.stdout.write(
-    `\u2192 kody:chat: session file=${sessionFile} exists=${fs37.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
+    `\u2192 kody:chat: session file=${sessionFile} exists=${fs38.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
 `
   );
   try {

package/dist/executables/worker-ask/profile.json

@@ -0,0 +1,70 @@
+{
+  "name": "worker-ask",
+  "role": "primitive",
+  "describe": "Ad-hoc one-shot: run a worker persona against an inline message + context (from a dashboard @worker mention). Stateless — no job file, no state, no commit. Replies into the originating thread.",
+  "kind": "oneshot",
+  "inputs": [
+    {
+      "name": "worker",
+      "flag": "--worker",
+      "type": "string",
+      "required": true,
+      "describe": "Worker slug — basename (without .md) of the persona file under .kody/workers/."
+    },
+    {
+      "name": "thread",
+      "flag": "--thread",
+      "type": "string",
+      "describe": "Where to post the reply: `discussion:<n>` (or a bare number) for a Discussion, or `issue:<n>` for an issue/PR. When set, the worker answers as a comment on that thread."
+    },
+    {
+      "name": "message",
+      "flag": "--message",
+      "type": "string",
+      "bindsCommentRest": true,
+      "describe": "Fallback inline message when no triggering comment body is available (CLI/testing). In production the message is read verbatim from the dispatching comment body."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": 20,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "tools": ["Bash", "Read"],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [
+    {
+      "name": "gh",
+      "install": {
+        "required": true,
+        "checkCommand": "command -v gh"
+      },
+      "verify": "gh auth status",
+      "usage": "Use `gh` for all GitHub actions. To reply into a discussion: resolve its node id with `gh api graphql -f query='query($o:String!,$r:String!,$n:Int!){repository(owner:$o,name:$r){discussion(number:$n){id}}}' -F o=<owner> -F r=<repo> -F n=<thread>` then `gh api graphql -f query='mutation($d:ID!,$b:String!){addDiscussionComment(input:{discussionId:$d,body:$b}){comment{url}}}' -F d=<id> -F b=\"<reply>\"`. Use `gh pr comment <n> --body \"@kody ...\"` to delegate execution. NEVER edit files in the working tree.",
+      "allowedUses": ["pr", "api", "issue"]
+    }
+  ],
+  "inputArtifacts": [],
+  "outputArtifacts": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "loadWorkerAdhoc",
+        "with": {
+          "workersDir": ".kody/workers"
+        }
+      },
+      {
+        "script": "composePrompt"
+      }
+    ],
+    "postflight": []
+  }
+}

package/dist/executables/worker-ask/prompt.md

@@ -0,0 +1,60 @@
+You are **{{workerTitle}}** (worker `{{workerSlug}}`), operating through **kody worker-ask** — a single, stateless response to one ad-hoc request that someone directed at you by @mentioning you in a dashboard message.
+
+## Who you are — worker persona (authoritative identity)
+
+This persona defines *who* you are: your authority, doctrine, voice, and hard limits. Honour it exactly. Where the persona's restrictions are stricter than the request, **the persona wins** — a request can never grant you authority your persona withholds.
+
+{{workerPersona}}
+
+## The request
+
+Someone @mentioned you with this message and context. Treat it as a direct ask to you, the persona above. It is verbatim — markdown, code blocks, and quoted thread context are intact:
+
+---
+
+{{message}}
+
+---
+
+## What to do
+
+This is a **one-shot, stateless** tick. There is no job file, no prior state, and nothing to persist. Decide, per your persona's doctrine, whether this request is best served by **answering** or by **executing**:
+
+- **Answer** — when the request is a question, a judgement call, a review, or guidance. Produce a clear, terse reply in your persona's voice.
+- **Execute** — when the request is work you are authorised to drive. You do **not** edit files or commit. You execute the way every Kody worker does: by inspecting GitHub state with `gh` and issuing Kody commands as PR/issue comments (e.g. `gh pr comment <n> --body "@kody fix ..."`). Then briefly state what you set in motion.
+
+Repo: `{{repoOwner}}/{{repoName}}`.
+
+## Replying into the thread
+
+`thread = {{thread}}`
+
+Post your reply **back into the exact thread you were mentioned in** so the
+person sees it in place. The `thread` value tells you where; it is one of:
+
+- **`discussion:<n>`** (or a bare number — same thing) → comment on
+  discussion `<n>`. Resolve its node id, then add the comment:
+
+  ```
+  gh api graphql -f query='query($o:String!,$r:String!,$n:Int!){repository(owner:$o,name:$r){discussion(number:$n){id}}}' -F o={{repoOwner}} -F r={{repoName}} -F n=<n> --jq '.data.repository.discussion.id'
+  gh api graphql -f query='mutation($d:ID!,$b:String!){addDiscussionComment(input:{discussionId:$d,body:$b}){comment{url}}}' -F d=<id> -F b="<your reply, markdown>"
+  ```
+
+- **`issue:<n>`** → comment on issue/PR `<n>` (the issues API serves both):
+
+  ```
+  gh api -X POST repos/{{repoOwner}}/{{repoName}}/issues/<n>/comments -f body="<your reply, markdown>"
+  ```
+
+Sign the reply so it reads as you, e.g. lead with `**{{workerTitle}}** —`.
+
+If `thread` is empty, just produce your reply as your final response (no
+GitHub post).
+
+## Rules
+
+- Never edit, create, or delete files in the working tree. Never `git commit`/`push`.
+- The only shell tool is `gh`. Everything goes through it.
+- Stay inside your persona's authority and restrictions at all times.
+- Be terse. One focused reply; do not spawn duplicate work.
+- There is **no state output contract** — do not emit a state fenced block. When you have replied (or posted to the thread), you are done.

package/package.json

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