@kody-ade/kody-engine 0.4.245 → 0.4.247

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.245",
+      version: "0.4.247",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative agentAction profiles.",
       license: "MIT",
       type: "module",
@@ -146,7 +146,7 @@ var init_claudeBinary = __esm({
 // src/issue.ts
 import { execFileSync } from "child_process";
 function ghToken() {
-  return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
+  return process.env.GITHUB_TOKEN?.trim() || process.env.KODY_TOKEN?.trim() || process.env.GH_TOKEN?.trim() || process.env.GH_PAT?.trim();
 }
 function gh(args, options) {
   const token = ghToken();
@@ -658,6 +658,14 @@ function parseGoalActivations(raw) {
       const idPrefix = parseSlug(r.idPrefix, "company.activeGoals.idPrefix");
       if (idPrefix) entry.idPrefix = idPrefix;
     }
+    if (r.preferredRunTime !== void 0) {
+      const preferredRunTime = parsePreferredRunTime(r.preferredRunTime);
+      if (!preferredRunTime)
+        throw new Error(
+          `kody.config.json: company.activeGoals preferredRunTime must be { "time": "HH:MM", "timezone": "Area/Name" }`
+        );
+      entry.preferredRunTime = preferredRunTime;
+    }
     const facts = recordValue(r.facts);
     if (r.facts !== void 0 && !facts)
       throw new Error(`kody.config.json: company.activeGoals facts must be an object`);
@@ -666,6 +674,13 @@ function parseGoalActivations(raw) {
   }
   return out;
 }
+function parsePreferredRunTime(raw) {
+  const r = recordValue(raw);
+  if (!r) return null;
+  if (typeof r.time !== "string" || !/^([01]\d|2[0-3]):[0-5]\d$/.test(r.time.trim())) return null;
+  if (typeof r.timezone !== "string" || !r.timezone.trim()) return null;
+  return { time: r.time.trim(), timezone: r.timezone.trim() };
+}
 function parseSlugArray(raw, field) {
   if (!Array.isArray(raw)) throw new Error(`kody.config.json: ${field} must be an array of strings`);
   const out = [];
@@ -5958,6 +5973,20 @@ function asRoute(value) {
   }
   return route;
 }
+function asPreferredRunTime(value) {
+  const raw = asRecord(value);
+  if (!raw) return void 0;
+  if (typeof raw.time !== "string" || !/^([01]\d|2[0-3]):[0-5]\d$/.test(raw.time)) return void 0;
+  if (typeof raw.timezone !== "string" || raw.timezone.trim().length === 0) return void 0;
+  return { time: raw.time, timezone: raw.timezone };
+}
+function asLoopTarget(value) {
+  const raw = asRecord(value);
+  if (!raw) return void 0;
+  if (raw.type !== "goal" && raw.type !== "agentResponsibility") return void 0;
+  if (typeof raw.id !== "string" || raw.id.trim().length === 0) return void 0;
+  return { type: raw.type, id: raw.id };
+}
 function managedGoalFromState(state) {
   const extra = state.extra;
   const destination = asRecord(extra.destination);
@@ -5974,6 +6003,9 @@ function managedGoalFromState(state) {
     destination: { outcome: destination.outcome, evidence },
     agentResponsibilities,
     route,
+    schedule: typeof extra.schedule === "string" ? extra.schedule : void 0,
+    preferredRunTime: asPreferredRunTime(extra.preferredRunTime),
+    loopTarget: asLoopTarget(extra.loopTarget),
     stage: typeof extra.stage === "string" ? extra.stage : void 0,
     facts,
     blockers
@@ -6572,6 +6604,41 @@ import * as path25 from "path";
 function isAgentResponsibilityCadenceGoal(goal, extra) {
   return extra.scheduleMode === "agentLoop" || extra.scheduler === "agentLoop" || goal.type === "standing" && goal.agentResponsibilities.length > 0;
 }
+function isGoalTargetLoop(goal) {
+  return goal.type === "agentLoop" && goal.loopTarget?.type === "goal" && goal.loopTarget.id.trim().length > 0;
+}
+function planGoalTargetLoopSchedule(opts) {
+  const now = opts.now ?? /* @__PURE__ */ new Date();
+  const at = now.toISOString();
+  const targetId = opts.goal.loopTarget?.type === "goal" ? opts.goal.loopTarget.id.trim() : "";
+  if (!targetId) {
+    const reason = "goal target loop missing target goal";
+    return targetLoopDecision("blocked", reason, at);
+  }
+  const preferred = opts.goal.preferredRunTime;
+  if (preferred) {
+    const gate = preferredRunTimeGate(preferred, now, opts.previousScheduleState);
+    if (!gate.ok) return targetLoopDecision("idle", gate.reason, at);
+  }
+  return {
+    kind: "dispatch",
+    reason: `dispatch goal ${targetId}`,
+    dispatch: { action: "goal-manager", agentAction: "goal-manager", cliArgs: { goal: targetId } },
+    scheduleState: {
+      mode: "agentLoop",
+      lastGoalTickAt: at,
+      lastDecision: {
+        kind: "dispatch",
+        targetType: "goal",
+        targetId,
+        agentAction: "goal-manager",
+        reason: preferred ? `preferred time ${preferred.time} ${preferred.timezone}` : "ready target loop tick",
+        at
+      },
+      agentResponsibilities: {}
+    }
+  };
+}
 async function planGoalAgentResponsibilitySchedule(opts) {
   const jobsDir = opts.jobsDir ?? ".kody/agent-responsibilities";
   const jobsRoot = path25.join(opts.cwd, jobsDir);
@@ -6695,6 +6762,64 @@ function validIso(value) {
 function markAgentResponsibilitySelected(status, now) {
   return { ...status, lastFiredAt: now.toISOString() };
 }
+function targetLoopDecision(kind, reason, at) {
+  return {
+    kind,
+    reason,
+    scheduleState: {
+      mode: "agentLoop",
+      lastGoalTickAt: at,
+      lastDecision: { kind, reason, at },
+      agentResponsibilities: {}
+    }
+  };
+}
+function preferredRunTimeGate(preferred, now, previous) {
+  const current = zonedTimeParts(now, preferred.timezone);
+  if (!current) return { ok: false, reason: `invalid preferred timezone: ${preferred.timezone}` };
+  const preferredMinute = preferredTimeToMinute(preferred.time);
+  if (preferredMinute === null) return { ok: false, reason: `invalid preferred time: ${preferred.time}` };
+  const currentMinute = current.hour * 60 + current.minute;
+  if (currentMinute < preferredMinute) {
+    return { ok: false, reason: `waiting preferred time ${preferred.time} ${preferred.timezone}` };
+  }
+  const lastDispatchAt = previous?.lastDecision.kind === "dispatch" ? previous.lastDecision.at : void 0;
+  if (lastDispatchAt) {
+    const last = zonedTimeParts(new Date(lastDispatchAt), preferred.timezone);
+    if (last?.date === current.date) {
+      return { ok: false, reason: `already dispatched today at preferred time ${preferred.time} ${preferred.timezone}` };
+    }
+  }
+  return { ok: true };
+}
+function preferredTimeToMinute(value) {
+  const match = value.match(/^([01]\d|2[0-3]):([0-5]\d)$/);
+  if (!match) return null;
+  return Number(match[1]) * 60 + Number(match[2]);
+}
+function zonedTimeParts(date, timezone) {
+  try {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+      timeZone: timezone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      hourCycle: "h23"
+    }).formatToParts(date);
+    const get = (type) => parts.find((part) => part.type === type)?.value;
+    const year = get("year");
+    const month = get("month");
+    const day = get("day");
+    const hour = get("hour");
+    const minute = get("minute");
+    if (!year || !month || !day || !hour || !minute) return null;
+    return { date: `${year}-${month}-${day}`, hour: Number(hour), minute: Number(minute) };
+  } catch {
+    return null;
+  }
+}
 var init_goalAgentResponsibilityScheduling = __esm({
   "src/scripts/goalAgentResponsibilityScheduling.ts"() {
     "use strict";
@@ -6806,6 +6931,23 @@ var init_advanceManagedGoal = __esm({
         ctx.output.reason = reason;
         return;
       }
+      if (isGoalTargetLoop(managed)) {
+        const previousScheduleState = goal.raw.extra.scheduleState && typeof goal.raw.extra.scheduleState === "object" ? goal.raw.extra.scheduleState : void 0;
+        const decision2 = planGoalTargetLoopSchedule({ goal: managed, previousScheduleState });
+        restoreGoalIdFact();
+        goal.raw = writeManagedGoalToState({ ...goal.raw, state: goal.state }, managed);
+        goal.raw.extra.scheduleState = decision2.scheduleState;
+        ctx.data.managedGoalDecision = decision2;
+        if (decision2.kind === "dispatch" && decision2.dispatch) {
+          ctx.output.nextDispatch = {
+            action: decision2.dispatch.action,
+            agentAction: decision2.dispatch.agentAction,
+            cliArgs: decision2.dispatch.cliArgs
+          };
+        }
+        ctx.output.reason = decision2.reason;
+        return;
+      }
       if (isAgentResponsibilityCadenceGoal(managed, goal.raw.extra)) {
         const previousScheduleState = goal.raw.extra.scheduleState && typeof goal.raw.extra.scheduleState === "object" ? goal.raw.extra.scheduleState : void 0;
         const decision2 = await planGoalAgentResponsibilitySchedule({
@@ -17308,12 +17450,34 @@ function unpackAllSecrets(env = process.env) {
   }
   return count;
 }
+function recoverCheckoutToken(env = process.env, cwd = process.cwd()) {
+  if (env.GITHUB_TOKEN?.trim()) return env.GITHUB_TOKEN.trim();
+  let header = "";
+  try {
+    header = execFileSync25("git", ["config", "--local", "--get", "http.https://github.com/.extraheader"], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return void 0;
+  }
+  const match = /^AUTHORIZATION:\s+basic\s+(.+)$/i.exec(header);
+  if (!match) return void 0;
+  const decoded = Buffer.from(match[1], "base64").toString("utf-8");
+  const token = decoded.includes(":") ? decoded.slice(decoded.indexOf(":") + 1).trim() : decoded.trim();
+  if (!token) return void 0;
+  env.GITHUB_TOKEN = token;
+  process.stdout.write("\u2192 kody: GITHUB_TOKEN recovered from actions/checkout credentials\n");
+  return token;
+}
 async function resolveAuthToken(env = process.env) {
   const creds = readAppCreds(env);
   if (creds) {
     try {
       const minted = await mintAppInstallationToken(creds);
       env.GH_TOKEN = minted;
+      recoverCheckoutToken(env);
       process.stdout.write("\u2192 kody: GH_TOKEN minted from GitHub App (KODY_APP_ID/KODY_APP_PRIVATE_KEY)\n");
       return minted;
     } catch (err) {
@@ -17330,6 +17494,7 @@ async function resolveAuthToken(env = process.env) {
   const picked = sources.find(([, v]) => !!v);
   const token = picked?.[1];
   if (token && !env.GH_TOKEN) env.GH_TOKEN = token;
+  recoverCheckoutToken(env);
   if (token) {
     process.stdout.write(`\u2192 kody: GH_TOKEN sourced from env.${picked[0]}
 `);

package/package.json

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