@kody-ade/kody-engine 0.4.146 → 0.4.147

package/dist/bin/kody.js

@@ -1061,7 +1061,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.146",
+  version: "0.4.147",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -10211,6 +10211,65 @@ function timingEqual(a, b) {
   return diff === 0;
 }
 
+// src/pool/duty-fallback-tick.ts
+async function runDutyFallbackTick(deps) {
+  if (!await deps.isDegraded()) {
+    return { ran: false, claimed: 0 };
+  }
+  const repos = deps.activeRepos();
+  if (repos.length === 0) {
+    deps.log("GitHub Actions degraded but no active repo pools \u2014 nothing to tick");
+    return { ran: true, claimed: 0 };
+  }
+  deps.log(`GitHub Actions degraded \u2014 running scheduled fan-out on Fly for ${repos.length} repo(s)`);
+  const clock = deps.now ?? Date.now;
+  let claimed = 0;
+  for (const tag of repos) {
+    const [owner, repo] = tag.split("/");
+    if (!owner || !repo) continue;
+    try {
+      const res = await deps.claim(owner, repo, {
+        jobId: `sched-${owner}-${repo}-${clock()}`,
+        repo: tag,
+        mode: "scheduled"
+      });
+      if (res.ok) {
+        claimed++;
+        deps.log(`[${tag}] scheduled fan-out claimed ${res.machineId}`);
+      } else {
+        deps.log(`[${tag}] scheduled fan-out skipped: ${res.reason ?? "pool unavailable"}`);
+      }
+    } catch (err) {
+      deps.log(`[${tag}] scheduled fan-out error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  return { ran: true, claimed };
+}
+
+// src/github-health.ts
+var STATUS_URL = "https://www.githubstatus.com/api/v2/components.json";
+var STATUS_CACHE_TTL_MS = 3e4;
+var statusCache = null;
+async function probeActionsStatus(fetchImpl = fetch) {
+  if (statusCache && statusCache.expiresAt > Date.now()) return statusCache.probe;
+  try {
+    const res = await fetchImpl(STATUS_URL, { headers: { "User-Agent": "kody-engine" } });
+    if (!res.ok) return { degraded: false, label: `http_${res.status}` };
+    const body = await res.json();
+    const actions = (body.components ?? []).find((c) => (c.name ?? "").trim().toLowerCase() === "actions");
+    const label = actions?.status ?? "unknown";
+    const degraded = !!actions && label !== "operational";
+    const probe = { degraded, label };
+    statusCache = { probe, expiresAt: Date.now() + STATUS_CACHE_TTL_MS };
+    return probe;
+  } catch {
+    return { degraded: false, label: "probe_error" };
+  }
+}
+async function gitHubActionsDegraded(fetchImpl = fetch) {
+  return (await probeActionsStatus(fetchImpl)).degraded;
+}
+
 // src/scripts/poolServe.ts
 var PERF_GUEST = {
   low: { cpu_kind: "shared", cpus: 2, memory_mb: 2048 },
@@ -10336,6 +10395,16 @@ var poolServe = async (ctx) => {
   const tick = setInterval(() => {
     registry.resyncAll().catch((err) => log(`resync tick failed: ${err instanceof Error ? err.message : String(err)}`));
   }, refillMs);
+  const dutyTickEnabled = (process.env.POOL_DUTY_TICK ?? "1") !== "0";
+  const dutyTickMs = envInt("POOL_DUTY_TICK_MS", 15 * 6e4);
+  const dutyTick = dutyTickEnabled ? setInterval(() => {
+    runDutyFallbackTick({
+      isDegraded: () => gitHubActionsDegraded(),
+      activeRepos: () => registry.activeRepos(),
+      claim: (owner, repo, req) => registry.claim(owner, repo, req),
+      log
+    }).catch((err) => log(`duty fallback tick failed: ${err instanceof Error ? err.message : String(err)}`));
+  }, dutyTickMs) : null;
   const server = createServer2(async (req, res) => {
     try {
       if (!req.method || !req.url) return sendJson2(res, 400, { error: "bad request" });
@@ -10393,6 +10462,7 @@ var poolServe = async (ctx) => {
   const shutdown = (signal) => {
     log(`${signal} \u2014 shutting down`);
     clearInterval(tick);
+    if (dutyTick) clearInterval(dutyTick);
     server.close(() => process.exit(0));
   };
   process.once("SIGINT", () => shutdown("SIGINT"));
@@ -11336,7 +11406,7 @@ 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 mode = b.mode === "interactive" ? "interactive" : "issue";
+  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);
@@ -11344,7 +11414,7 @@ function parseJob(body) {
       return { error: "issueNumber (positive integer) required for issue mode" };
     }
     job.issueNumber = issueNumber;
-  } else {
+  } 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;
@@ -11368,11 +11438,15 @@ async function defaultRunJob(job) {
   fs37.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 childEnv = {
     ...process.env,
     REPO: job.repo,
     REF: branch,
     GITHUB_TOKEN: job.githubToken,
+    // Scheduled mode drives the engine down the same path GitHub Actions' cron
+    // takes (runScheduledFanOut → due duties/goals). Bare `kody` routes on this.
+    ...scheduled ? { GITHUB_EVENT_NAME: "schedule" } : {},
     // GITHUB_REPOSITORY + GH_TOKEN are normally injected by GitHub Actions.
     // The engine's interactive mode needs GITHUB_REPOSITORY to persist
     // chat.ready / events to .kody/events via the Contents API (the durable
@@ -11382,7 +11456,7 @@ async function defaultRunJob(job) {
     GH_TOKEN: job.githubToken,
     // Issue mode bakes ISSUE_NUMBER → `kody run --issue N`. Interactive mode
     // leaves it empty and sets SESSION_ID so the engine boots a chat session.
-    ISSUE_NUMBER: interactive ? "" : String(job.issueNumber),
+    ISSUE_NUMBER: interactive || scheduled ? "" : String(job.issueNumber),
     ALL_SECRETS: allSecrets,
     SESSION_ID: job.sessionId ?? "",
     DASHBOARD_URL: job.dashboardUrl ?? "",
@@ -11420,11 +11494,10 @@ 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 runArgs = interactive ? [] : ["run", "--issue", String(job.issueNumber)];
-  process.stdout.write(
-    `[runner-serve] job ${job.jobId}: ${interactive ? `interactive session ${job.sessionId}` : `running issue #${job.issueNumber}`}
-`
-  );
+  const runArgs = interactive || scheduled ? [] : ["run", "--issue", String(job.issueNumber)];
+  const jobDesc = interactive ? `interactive session ${job.sessionId}` : scheduled ? "scheduled fan-out" : `running issue #${job.issueNumber}`;
+  process.stdout.write(`[runner-serve] job ${job.jobId}: ${jobDesc}
+`);
   const runCode = await run("kody", runArgs, workdir);
   process.stdout.write(`[runner-serve] job ${job.jobId}: finished (exit ${runCode})
 `);

package/package.json

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