@kody-ade/kody-engine 0.4.274 → 0.4.276

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.274",
+      version: "0.4.276",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -8808,7 +8808,7 @@ function refreshGoalDashboardReport(input) {
   if (!REPORT_SLUG_RE.test(input.goalId)) {
     throw new Error(`goal report: invalid goal id "${input.goalId}"`);
   }
-  const filePath = `reports/${input.goalId}.md`;
+  const filePath = goalDashboardReportRunPath(input.goalId);
   const body = goalReportBody(
     input.goalId,
     input.state,
@@ -8816,17 +8816,15 @@ function refreshGoalDashboardReport(input) {
     latestGoalRunLogEvent(input.data, input.goalId),
     evidenceItems
   );
-  const current = readStateText(input.config, input.cwd, filePath);
-  if (current?.content === body) {
-    const report2 = { slug: input.goalId, path: current.path, changed: false };
-    recordGoalReport(input.data, report2);
-    return report2;
-  }
-  upsertStateText(input.config, input.cwd, filePath, body, `chore(reports): refresh ${input.goalId}`);
+  writeStateText(input.config, input.cwd, filePath, body, `chore(reports): add ${input.goalId} run`);
   const report = { slug: input.goalId, path: filePath, changed: true };
   recordGoalReport(input.data, report);
   return report;
 }
+function goalDashboardReportRunPath(goalId, now = /* @__PURE__ */ new Date()) {
+  const runId = now.toISOString().replace(/\.\d{3}Z$/, "Z").replace(/:/g, "-");
+  return `reports/${goalId}/runs/${runId}.md`;
+}
 function capabilityEvidenceOutput(evidence) {
   return {
     kind: "capability-evidence",
@@ -19581,6 +19579,68 @@ init_job();
 init_registry();
 init_runtimePaths();
 init_stateWorkspace();
+
+// src/run-request.ts
+var RUN_REQUEST_ENV = "KODY_RUN_REQUEST_JSON";
+var INTENTS = /* @__PURE__ */ new Set(["continue", "manage", "run", "tick"]);
+var SOURCES = /* @__PURE__ */ new Set(["dashboard", "github", "schedule"]);
+var TARGET_TYPES = /* @__PURE__ */ new Set(["chat", "goal", "issue", "workflow"]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function parseTarget(input) {
+  if (!isRecord(input)) return { error: "runRequest.target must be an object" };
+  const type = readString(input.type);
+  if (!TARGET_TYPES.has(type)) return { error: "runRequest.target.type is invalid" };
+  if (type === "issue") {
+    const id2 = Number(input.id);
+    if (!Number.isInteger(id2) || id2 <= 0) return { error: "runRequest.target.id must be a positive issue number" };
+    return { target: { type, id: id2 } };
+  }
+  const id = readString(input.id);
+  if (!id) return { error: "runRequest.target.id is required" };
+  return { target: { type, id } };
+}
+function parseRunRequest(input) {
+  let body = input;
+  if (typeof input === "string") {
+    const raw = input.trim();
+    if (!raw) return { error: `${RUN_REQUEST_ENV} is empty` };
+    try {
+      body = JSON.parse(raw);
+    } catch {
+      return { error: `${RUN_REQUEST_ENV} must be valid JSON` };
+    }
+  }
+  if (!isRecord(body)) return { error: "runRequest must be an object" };
+  const parsedTarget = parseTarget(body.target);
+  if ("error" in parsedTarget) return parsedTarget;
+  const intent = readString(body.intent);
+  if (!INTENTS.has(intent)) return { error: "runRequest.intent is invalid" };
+  const source = readString(body.source);
+  if (!SOURCES.has(source)) return { error: "runRequest.source is invalid" };
+  if (body.input !== void 0 && !isRecord(body.input)) {
+    return { error: "runRequest.input must be an object when provided" };
+  }
+  return {
+    request: {
+      target: parsedTarget.target,
+      intent,
+      source,
+      ...body.input !== void 0 ? { input: body.input } : {}
+    }
+  };
+}
+function readRunRequestFromEnv(env = process.env) {
+  const raw = env[RUN_REQUEST_ENV];
+  if (raw == null || raw.trim() === "") return null;
+  return parseRunRequest(raw);
+}
+
+// src/kody-cli.ts
 var CI_HELP = `kody ci \u2014 minimal-YAML autonomous engineer (CI preflight + run)
 
 Usage:
@@ -19639,6 +19699,30 @@ function parseCiArgs(argv) {
   }
   return result;
 }
+function routeRunRequest(request) {
+  const { target, intent } = request;
+  if (target.type === "chat" || target.type === "issue") return { kind: "ignore" };
+  if (target.type === "goal") {
+    if (intent !== "manage" && intent !== "run" && intent !== "tick") {
+      return { kind: "error", error: `goal target does not support intent '${intent}'` };
+    }
+    return {
+      kind: "action",
+      action: "goal-manager",
+      cliArgs: { goal: target.id }
+    };
+  }
+  if (target.type === "workflow") {
+    if (target.id === "scheduled-fanout") {
+      return { kind: "fanout", force: intent === "run" };
+    }
+    if (intent !== "run" && intent !== "tick") {
+      return { kind: "error", error: `workflow target does not support intent '${intent}'` };
+    }
+    return { kind: "action", action: target.id, cliArgs: {} };
+  }
+  return { kind: "error", error: "unsupported run request target" };
+}
 function unpackAllSecrets(env = process.env) {
   const raw = env.ALL_SECRETS;
   if (!raw) return 0;
@@ -19850,15 +19934,38 @@ async function runCi(argv) {
   let manualWorkflowDispatch = false;
   let forceRunAction = null;
   let forceRunCliArgs = {};
+  let runRequestFanOut = false;
+  let runRequestFanOutForce = false;
+  const parsedRunRequest = readRunRequestFromEnv();
+  if (parsedRunRequest && "error" in parsedRunRequest) {
+    process.stderr.write(`[kody] ${parsedRunRequest.error}
+`);
+    return 64;
+  }
+  if (!args.issueNumber && !autoFallback && parsedRunRequest && "request" in parsedRunRequest) {
+    const route = routeRunRequest(parsedRunRequest.request);
+    if (route.kind === "error") {
+      process.stderr.write(`[kody] ${route.error}
+`);
+      return 64;
+    }
+    if (route.kind === "fanout") {
+      runRequestFanOut = true;
+      runRequestFanOutForce = route.force;
+    } else if (route.kind === "action") {
+      forceRunAction = route.action;
+      forceRunCliArgs = route.cliArgs;
+    }
+  }
   const envForceAction = (process.env.KODY_FORCE_ACTION ?? "").trim();
   const envForceMessage = (process.env.KODY_FORCE_MESSAGE ?? "").trim();
-  if (!args.issueNumber && !autoFallback && envForceAction) {
+  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && envForceAction) {
     forceRunAction = envForceAction;
     if (envForceAction === "goal-manager" && envForceMessage) {
       forceRunCliArgs = { goal: envForceMessage };
     }
   }
-  if (!args.issueNumber && !autoFallback && !forceRunAction && eventName === "workflow_dispatch" && dispatchEventPath && fs46.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs46.existsSync(dispatchEventPath)) {
     try {
       const evt = JSON.parse(fs46.readFileSync(dispatchEventPath, "utf-8"));
       const issueInput = parseInt(String(evt?.inputs?.issue_number ?? ""), 10);
@@ -19950,6 +20057,9 @@ async function runCi(argv) {
     const ec = result.exitCode;
     return ec === 0 || ec === 1 || ec === 2 ? ec : 99;
   }
+  if (!args.issueNumber && !autoFallback && runRequestFanOut) {
+    return runScheduledFanOut(cwd, args, { force: runRequestFanOutForce });
+  }
   if (!args.issueNumber && !autoFallback && (eventName === "schedule" || manualWorkflowDispatch)) {
     return runScheduledFanOut(cwd, args, { force: manualWorkflowDispatch });
   }
@@ -21573,6 +21683,10 @@ function parseChatArgs(argv, env = process.env) {
     else if (arg?.startsWith("--")) result.errors.push(`unknown arg: ${arg}`);
     else if (arg) result.errors.push(`unexpected positional: ${arg}`);
   }
+  const runRequest = readRunRequestFromEnv(env);
+  if (runRequest && "error" in runRequest) result.errors.push(runRequest.error);
+  const chatTarget = runRequest && "request" in runRequest && runRequest.request.target.type === "chat" ? runRequest.request.target.id : void 0;
+  result.sessionId = result.sessionId ?? chatTarget;
   result.sessionId = result.sessionId ?? env.SESSION_ID ?? void 0;
   result.initMessage = result.initMessage ?? env.INIT_MESSAGE ?? void 0;
   result.model = result.model ?? env.MODEL ?? void 0;
@@ -21766,7 +21880,11 @@ async function runCapabilityFallbackTick(deps) {
       const res = await deps.claim(owner, repo, {
         jobId: `sched-${owner}-${repo}-${clock()}`,
         repo: tag,
-        mode: "scheduled"
+        runRequest: {
+          target: { type: "workflow", id: "scheduled-fanout" },
+          intent: "tick",
+          source: "schedule"
+        }
       });
       if (res.ok) {
         claimed++;
@@ -22341,7 +22459,7 @@ var PoolRegistry = class {
       jobId: req.jobId,
       repo: `${owner}/${repo}`,
       githubToken: this.cfg.githubToken,
-      mode: req.mode ?? "issue",
+      runRequest: req.runRequest,
       issueNumber: req.issueNumber,
       sessionId: req.sessionId,
       idleExitMs: req.idleExitMs,
@@ -22427,24 +22545,78 @@ function parseClaimRequest(body) {
   const repo = typeof b.repo === "string" ? b.repo.trim() : "";
   if (!/^[^/\s]+\/[^/\s]+$/.test(repo)) return { error: "repo must be 'owner/name'" };
   const mode = b.mode === "interactive" ? "interactive" : b.mode === "scheduled" ? "scheduled" : "issue";
-  const req = { jobId, repo, mode };
-  if (mode === "issue") {
-    const issueNumber = Number(b.issueNumber);
-    if (!Number.isInteger(issueNumber) || issueNumber <= 0) return { error: "issueNumber required for issue mode" };
-    req.issueNumber = issueNumber;
-  } else if (mode === "interactive") {
-    const sessionId = typeof b.sessionId === "string" ? b.sessionId.trim() : "";
-    if (!sessionId) return { error: "sessionId required for interactive mode" };
-    req.sessionId = sessionId;
+  const action = typeof b.action === "string" && b.action.trim() ? b.action.trim() : void 0;
+  const message = typeof b.message === "string" && b.message.trim() ? b.message.trim() : void 0;
+  const runRequest = b.runRequest !== void 0 ? parseRunRequest(b.runRequest) : synthesizeLegacyClaimRequest({
+    mode,
+    issueNumber: b.issueNumber,
+    sessionId: b.sessionId,
+    action,
+    message
+  });
+  if ("error" in runRequest) return { error: runRequest.error };
+  const req = { jobId, repo, runRequest: runRequest.request };
+  if (req.runRequest.target.type === "issue") {
+    req.issueNumber = req.runRequest.target.id;
+  } else if (req.runRequest.target.type === "chat") {
+    req.sessionId = req.runRequest.target.id;
     if (Number.isFinite(Number(b.idleExitMs))) req.idleExitMs = Number(b.idleExitMs);
     if (Number.isFinite(Number(b.hardCapMs))) req.hardCapMs = Number(b.hardCapMs);
   }
   if (typeof b.ref === "string" && b.ref.trim()) req.ref = b.ref.trim();
   if (typeof b.model === "string" && b.model.trim()) req.model = b.model.trim();
-  if (typeof b.sessionId === "string" && b.sessionId.trim()) req.sessionId = b.sessionId.trim();
   if (typeof b.dashboardUrl === "string" && b.dashboardUrl.trim()) req.dashboardUrl = b.dashboardUrl.trim();
   return { req };
 }
+function synthesizeLegacyClaimRequest(input) {
+  if (input.mode === "issue") {
+    const issueNumber = Number(input.issueNumber);
+    if (!Number.isInteger(issueNumber) || issueNumber <= 0) return { error: "issueNumber required for issue mode" };
+    return {
+      request: {
+        target: { type: "issue", id: issueNumber },
+        intent: "run",
+        source: "dashboard"
+      }
+    };
+  }
+  if (input.mode === "interactive") {
+    const sessionId = typeof input.sessionId === "string" ? input.sessionId.trim() : "";
+    if (!sessionId) return { error: "sessionId required for interactive mode" };
+    return {
+      request: {
+        target: { type: "chat", id: sessionId },
+        intent: "continue",
+        source: "dashboard"
+      }
+    };
+  }
+  if (input.action === "goal-manager" && input.message) {
+    return {
+      request: {
+        target: { type: "goal", id: input.message },
+        intent: "manage",
+        source: "dashboard"
+      }
+    };
+  }
+  if (input.action) {
+    return {
+      request: {
+        target: { type: "workflow", id: input.action },
+        intent: "run",
+        source: "dashboard"
+      }
+    };
+  }
+  return {
+    request: {
+      target: { type: "workflow", id: "scheduled-fanout" },
+      intent: "tick",
+      source: "schedule"
+    }
+  };
+}
 async function poolServe() {
   const masterRaw = process.env.KODY_MASTER_KEY?.trim();
   if (!masterRaw) throw new Error("KODY_MASTER_KEY required for pool-serve");
@@ -22612,33 +22784,85 @@ function parseJob(body) {
   if (!/^[^/\s]+\/[^/\s]+$/.test(repo)) return { error: "repo must be 'owner/name'" };
   const githubToken = typeof b.githubToken === "string" ? b.githubToken.trim() : "";
   if (!githubToken) return { error: "githubToken required" };
+  const action = typeof b.action === "string" && b.action.trim() ? b.action.trim() : void 0;
+  const message = typeof b.message === "string" && b.message.trim() ? b.message.trim() : void 0;
   const mode = b.mode === "interactive" ? "interactive" : b.mode === "scheduled" ? "scheduled" : "issue";
-  const job = { jobId, repo, githubToken, mode };
-  if (mode === "issue") {
-    const issueNumber = Number(b.issueNumber);
-    if (!Number.isInteger(issueNumber) || issueNumber <= 0) {
-      return { error: "issueNumber (positive integer) required for issue mode" };
-    }
-    job.issueNumber = issueNumber;
-  } else if (mode === "interactive") {
-    const sessionId = typeof b.sessionId === "string" ? b.sessionId.trim() : "";
-    if (!sessionId) return { error: "sessionId required for interactive mode" };
-    job.sessionId = sessionId;
+  const runRequest = b.runRequest !== void 0 ? parseRunRequest(b.runRequest) : synthesizeLegacyRunRequest({
+    mode,
+    issueNumber: b.issueNumber,
+    sessionId: b.sessionId,
+    action,
+    message
+  });
+  if ("error" in runRequest) return { error: runRequest.error };
+  const job = { jobId, repo, githubToken, runRequest: runRequest.request };
+  if (job.runRequest.target.type === "issue") {
+    job.issueNumber = job.runRequest.target.id;
+  } else if (job.runRequest.target.type === "chat") {
+    job.sessionId = job.runRequest.target.id;
     if (Number.isFinite(Number(b.idleExitMs))) job.idleExitMs = Number(b.idleExitMs);
     if (Number.isFinite(Number(b.hardCapMs))) job.hardCapMs = Number(b.hardCapMs);
   }
   if (typeof b.ref === "string" && b.ref.trim()) job.ref = b.ref.trim();
   if (typeof b.model === "string" && b.model.trim()) job.model = b.model.trim();
   if (typeof b.reasoningEffort === "string" && b.reasoningEffort.trim()) job.reasoningEffort = b.reasoningEffort.trim();
-  if (typeof b.action === "string" && b.action.trim()) job.action = b.action.trim();
-  if (typeof b.message === "string" && b.message.trim()) job.message = b.message.trim();
-  if (typeof b.sessionId === "string" && b.sessionId.trim()) job.sessionId = b.sessionId.trim();
   if (typeof b.dashboardUrl === "string" && b.dashboardUrl.trim()) job.dashboardUrl = b.dashboardUrl.trim();
   if (b.allSecrets && (typeof b.allSecrets === "object" || typeof b.allSecrets === "string")) {
     job.allSecrets = b.allSecrets;
   }
   return { job };
 }
+function synthesizeLegacyRunRequest(input) {
+  if (input.mode === "issue") {
+    const issueNumber = Number(input.issueNumber);
+    if (!Number.isInteger(issueNumber) || issueNumber <= 0) {
+      return { error: "issueNumber (positive integer) required for issue mode" };
+    }
+    return {
+      request: {
+        target: { type: "issue", id: issueNumber },
+        intent: "run",
+        source: "dashboard"
+      }
+    };
+  }
+  if (input.mode === "interactive") {
+    const sessionId = typeof input.sessionId === "string" ? input.sessionId.trim() : "";
+    if (!sessionId) return { error: "sessionId required for interactive mode" };
+    return {
+      request: {
+        target: { type: "chat", id: sessionId },
+        intent: "continue",
+        source: "dashboard"
+      }
+    };
+  }
+  if (input.action === "goal-manager" && input.message) {
+    return {
+      request: {
+        target: { type: "goal", id: input.message },
+        intent: "manage",
+        source: "dashboard"
+      }
+    };
+  }
+  if (input.action) {
+    return {
+      request: {
+        target: { type: "workflow", id: input.action },
+        intent: "run",
+        source: "dashboard"
+      }
+    };
+  }
+  return {
+    request: {
+      target: { type: "workflow", id: "scheduled-fanout" },
+      intent: "tick",
+      source: "schedule"
+    }
+  };
+}
 async function defaultRunJob(job) {
   const workdir = process.env.RUNNER_WORKDIR ?? DEFAULT_WORKDIR;
   const branch = job.ref ?? "main";
@@ -22646,20 +22870,17 @@ async function defaultRunJob(job) {
   fs51.rmSync(workdir, { recursive: true, force: true });
   fs51.mkdirSync(workdir, { recursive: true });
   const allSecrets = typeof job.allSecrets === "string" ? job.allSecrets : JSON.stringify(job.allSecrets ?? {});
-  const interactive = job.mode === "interactive";
-  const scheduled = job.mode === "scheduled";
-  const runMode = interactive ? "interactive" : scheduled ? "scheduled" : "issue";
+  const target = job.runRequest.target;
+  const interactive = target.type === "chat";
+  const scheduled = target.type === "goal" || target.type === "workflow";
+  const issueNumber = target.type === "issue" ? target.id : void 0;
+  const sessionId = target.type === "chat" ? target.id : void 0;
   const childEnv = {
     ...process.env,
     REPO: job.repo,
     REF: branch,
     GITHUB_TOKEN: job.githubToken,
-    KODY_RUN_MODE: runMode,
-    // Scheduled mode drives the engine down the same path GitHub Actions' cron
-    // takes (runScheduledFanOut → due capabilities/goals). Bare `kody` routes on this.
-    ...scheduled ? { GITHUB_EVENT_NAME: "schedule" } : {},
-    ...job.action ? { KODY_FORCE_ACTION: job.action } : {},
-    ...job.message ? { KODY_FORCE_MESSAGE: job.message } : {},
+    [RUN_REQUEST_ENV]: JSON.stringify(job.runRequest),
     // GITHUB_REPOSITORY + GH_TOKEN are normally injected by GitHub Actions.
     // The engine's interactive mode needs GITHUB_REPOSITORY to resolve the
     // configured state repo and persist chat.ready / events (the durable signal
@@ -22667,11 +22888,9 @@ async function defaultRunJob(job) {
     // and the session never appears "ready". GH_TOKEN auths the `gh` CLI.
     GITHUB_REPOSITORY: job.repo,
     GH_TOKEN: job.githubToken,
-    // Issue mode carries ISSUE_NUMBER. Interactive mode leaves it empty and
-    // sets SESSION_ID so the engine boots a chat session.
-    ISSUE_NUMBER: interactive || scheduled ? "" : String(job.issueNumber),
+    ISSUE_NUMBER: issueNumber ? String(issueNumber) : "",
     ALL_SECRETS: allSecrets,
-    SESSION_ID: job.sessionId ?? "",
+    SESSION_ID: sessionId ?? "",
     DASHBOARD_URL: job.dashboardUrl ?? "",
     MODEL: job.model ?? "",
     REASONING_EFFORT: job.reasoningEffort ?? "",
@@ -22700,7 +22919,7 @@ async function defaultRunJob(job) {
   const authorEmail = process.env.GIT_AUTHOR_EMAIL ?? "kody-bot@users.noreply.github.com";
   await run("git", ["config", "user.name", authorName], workdir);
   await run("git", ["config", "user.email", authorEmail], workdir);
-  const jobDesc = interactive ? `interactive session ${job.sessionId}` : scheduled ? "scheduled fan-out" : `running issue #${job.issueNumber}`;
+  const jobDesc = interactive ? `chat session ${sessionId}` : scheduled ? `${target.type} ${target.id}` : `issue #${issueNumber}`;
   process.stdout.write(`[runner-serve] job ${job.jobId}: ${jobDesc}
 `);
   const runCode = await run("kody", [], workdir);
@@ -22783,7 +23002,7 @@ async function runnerServe() {
 init_config();
 init_litellm();
 import { spawn as spawn9 } from "child_process";
-function parseTarget(positional) {
+function parseTarget2(positional) {
   if (!Array.isArray(positional) || positional.length === 0) return "none";
   const first = String(positional[0]).toLowerCase();
   if (first === "vscode" || first === "code") return "vscode";
@@ -22798,7 +23017,7 @@ function buildProxyEnv(url) {
   };
 }
 async function serve(opts) {
-  const target = parseTarget(opts.args);
+  const target = parseTarget2(opts.args);
   const model = parseProviderModel(opts.config.agent.model);
   const usesProxy = needsLitellmProxy(model);
   let handle = null;
@@ -23112,6 +23331,17 @@ function envRunMode(env = process.env) {
   }
   return { ...result, errors: [`unknown KODY_RUN_MODE: ${mode}`] };
 }
+function envRunRequest(env = process.env) {
+  const result = { command: "help", errors: [] };
+  const parsed = readRunRequestFromEnv(env);
+  if (!parsed) return null;
+  if ("error" in parsed) return { ...result, errors: [parsed.error] };
+  const { target } = parsed.request;
+  if (target.type === "chat") return { ...result, command: "chat", chatArgv: [] };
+  if (target.type === "issue") return { ...result, command: "ci", ciArgv: ["--issue", String(target.id)] };
+  if (target.type === "goal" || target.type === "workflow") return { ...result, command: "ci", ciArgv: [] };
+  return { ...result, errors: [`unsupported runRequest target: ${target.type ?? "unknown"}`] };
+}
 var HELP_TEXT = `kody-engine \u2014 single-session autonomous engineer
 
 Usage:
@@ -23148,6 +23378,8 @@ Exit codes:
 function parseArgs(argv) {
   const result = { command: "help", errors: [] };
   if (argv.length === 0) {
+    const runRequest = envRunRequest();
+    if (runRequest) return runRequest;
     const mode = envRunMode();
     if (mode) return mode;
     if (process.env.SESSION_ID) return { ...result, command: "chat", chatArgv: [] };

package/dist/executables/types.ts

@@ -498,6 +498,6 @@ export interface Job {
   flavor: JobFlavor
   /** Manual force-run (bypass cadence) for a scheduled job. */
   force?: boolean
-  /** Ask the owning goal/loop to refresh reports/<goal-or-loop>.md after its persisted decision. */
+  /** Ask the owning goal/loop to write a report run after its persisted decision. */
   saveReport?: boolean
 }

package/package.json

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