@kody-ade/kody-engine 0.4.245 → 0.4.246

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.246",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative agentAction profiles.",
       license: "MIT",
       type: "module",
@@ -5958,6 +5958,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 +5988,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 +6589,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 +6747,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 +6916,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({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.245",
+  "version": "0.4.246",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative agentAction profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,26 +12,6 @@
     "templates",
     "kody.config.schema.json"
   ],
-  "scripts": {
-    "kody:run": "tsx bin/kody.ts",
-    "serve": "tsx bin/kody.ts serve",
-    "serve:vscode": "tsx bin/kody.ts serve vscode",
-    "serve:claude": "tsx bin/kody.ts serve claude",
-    "build": "tsup && node scripts/copy-assets.cjs",
-    "check:modularity": "tsx scripts/check-script-modularity.ts",
-    "pretest": "pnpm check:modularity",
-    "test": "vitest run tests/unit tests/int --coverage",
-    "posttest": "tsx scripts/check-coverage-floor.ts",
-    "test:smoke": "vitest run tests/smoke --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write",
-    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner",
-    "prepublishOnly": "pnpm typecheck && vitest run tests/unit tests/int --no-coverage && pnpm build"
-  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -55,5 +35,24 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
+  "scripts": {
+    "kody:run": "tsx bin/kody.ts",
+    "serve": "tsx bin/kody.ts serve",
+    "serve:vscode": "tsx bin/kody.ts serve vscode",
+    "serve:claude": "tsx bin/kody.ts serve claude",
+    "build": "tsup && node scripts/copy-assets.cjs",
+    "check:modularity": "tsx scripts/check-script-modularity.ts",
+    "pretest": "pnpm check:modularity",
+    "test": "vitest run tests/unit tests/int --coverage",
+    "posttest": "tsx scripts/check-coverage-floor.ts",
+    "test:smoke": "vitest run tests/smoke --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
+  }
+}