@kody-ade/kody-engine 0.4.281 → 0.4.283

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.281",
+      version: "0.4.283",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -724,10 +724,10 @@ function parseStateConfig(raw, github) {
   const pathRaw = typeof raw.statePath === "string" ? raw.statePath : nested.path;
   const stateRepo = typeof repoRaw === "string" && repoRaw.trim().length > 0 ? repoRaw.trim() : `https://github.com/${String(github.owner)}/kody-state`;
   parseStateRepoSlug(stateRepo);
-  const statePath2 = typeof pathRaw === "string" && pathRaw.trim().length > 0 ? pathRaw.trim() : String(github.repo);
+  const statePath = typeof pathRaw === "string" && pathRaw.trim().length > 0 ? pathRaw.trim() : String(github.repo);
   return {
     repo: stateRepo,
-    path: normalizeStatePath(statePath2)
+    path: normalizeStatePath(statePath)
   };
 }
 function parseAccessConfig(raw) {
@@ -6520,11 +6520,6 @@ function planManagedGoalTick(goal) {
     delete goal.facts.pendingEvidence;
     return { kind: "done" };
   }
-  const pending = goal.facts.pendingEvidence;
-  if (pending === missing) {
-    const stage = typeof goal.stage === "string" ? goal.stage : "waiting";
-    return { kind: "wait", evidence: missing, stage, reason: `waiting for evidence: ${missing}` };
-  }
   const step = goal.route.find((candidate) => candidate.evidence === missing);
   if (!step) {
     if (isSimpleGoal(goal) && missing === SIMPLE_GOAL_EVIDENCE) {
@@ -6745,7 +6740,7 @@ function goalRunLogPath(goalId, data) {
   return `logs/goals/${safePathSegment(goalId)}/runs/${startedAt}-${runId}.jsonl`;
 }
 function goalStateLogPath(goalId) {
-  return `goals/instances/${safePathSegment(goalId)}/state.json`;
+  return `todos/${safePathSegment(goalId)}.md`;
 }
 function goalRunLogSnapshot(goalId, goalState, goal) {
   const requiredEvidence = [...goal.destination.evidence];
@@ -6984,9 +6979,9 @@ function linkContext(stateRepo) {
   const server = process.env.GITHUB_SERVER_URL?.trim() || "https://github.com";
   if (runId && repository) links.workflowRun = `${server}/${repository}/actions/runs/${runId}`;
   const repo = stringValue(stateRepo?.repo);
-  const goalStatePath = stringValue(stateRepo?.goalStatePath);
+  const goalStatePath2 = stringValue(stateRepo?.goalStatePath);
   const logPath = stringValue(stateRepo?.logPath);
-  if (repo && goalStatePath) links.goalState = githubBlobUrl(repo, goalStatePath);
+  if (repo && goalStatePath2) links.goalState = githubBlobUrl(repo, goalStatePath2);
   if (repo && logPath) links.log = githubBlobUrl(repo, logPath);
   return Object.keys(links).length > 0 ? links : void 0;
 }
@@ -7084,24 +7079,227 @@ var init_runLog = __esm({
   }
 });
 
+// src/goal/managedTodoState.ts
+function parseTodoGoalState(goalId, filePath, raw) {
+  const frontmatter = parseFrontmatter(raw);
+  const description = raw.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, "").replace(itemsBlockRe(), "").trim();
+  const items = parseItems(raw);
+  const destination = recordField(frontmatter.destination);
+  const evidence = stringArray(destination.evidence).length > 0 ? stringArray(destination.evidence) : stringArray(frontmatter.evidence).length > 0 ? stringArray(frontmatter.evidence) : items.map((item) => stringField2(recordField(item.meta).evidence) || item.id).filter(Boolean);
+  const facts = {
+    ...recordField(frontmatter.facts),
+    ...Object.fromEntries(items.map((item) => [stringField2(recordField(item.meta).evidence) || item.id, item.completed]))
+  };
+  return parseGoalState(filePath, {
+    ...frontmatter,
+    id: goalId,
+    state: frontmatter.state ?? "active",
+    destination: {
+      ...destination,
+      outcome: description || stringField2(destination.outcome),
+      evidence
+    },
+    capabilities: stringArray(frontmatter.capabilities).length > 0 ? stringArray(frontmatter.capabilities) : items.map((item) => stringField2(recordField(item.meta).capability)).filter(Boolean),
+    route: Array.isArray(frontmatter.route) ? frontmatter.route : routeFromItems(items),
+    facts,
+    blockers: stringArray(frontmatter.blockers)
+  });
+}
+function isManagedTodoRaw(raw) {
+  return isManagedTodoFrontmatter(parseFrontmatter(raw));
+}
+function serializeTodoGoalState(goalId, state, previousRaw) {
+  const raw = JSON.parse(serializeGoalState(state));
+  const destination = recordField(raw.destination);
+  const outcome = stringField2(destination.outcome);
+  const evidence = stringArray(destination.evidence);
+  const route = Array.isArray(raw.route) ? raw.route : [];
+  const facts = recordField(raw.facts);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const createdAt = stringField2(raw.createdAt) || stringField2(raw.startedAt) || now;
+  const routeByEvidence = new Map(route.map((step) => [stringField2(step.evidence), step]));
+  const previousItems = new Map(parseItems(previousRaw ?? "").map((item) => [item.id, item]));
+  const items = evidence.length > 0 ? evidence.map((key) => itemFromEvidence(key, routeByEvidence.get(key), facts, createdAt, now, previousItems.get(key))) : stringArray(raw.capabilities).map(
+    (capability) => itemFromCapability(capability, createdAt, previousItems.get(capability))
+  );
+  delete raw.destination;
+  raw.id = goalId;
+  raw.title = goalId;
+  raw.createdAt = createdAt;
+  raw.managed = true;
+  raw.managedModel = raw.scheduleMode === "agentLoop" || raw.type === "agentLoop" ? "agentLoop" : "agentGoal";
+  raw.evidence = evidence;
+  return [
+    "---",
+    ...Object.entries(raw).filter(([, value]) => value !== void 0).map(([key, value]) => `${key}: ${serializeFrontmatterValue(value)}`),
+    "---",
+    "",
+    outcome,
+    "",
+    "<!-- kody-todo-items-json",
+    JSON.stringify(items, null, 2),
+    "-->",
+    ""
+  ].join("\n");
+}
+function isManagedTodoFrontmatter(frontmatter) {
+  return frontmatter.managed === true || frontmatter.managed === "true" || frontmatter.managedModel === "agentGoal" || frontmatter.managedModel === "agentLoop";
+}
+function itemFromEvidence(evidence, step, facts, createdAt, now, prior) {
+  const completed = facts[evidence] === true;
+  return {
+    id: evidence,
+    title: (prior?.title ?? stringField2(step?.stage)) || evidence,
+    body: prior?.body ?? "",
+    assignee: prior?.assignee ?? null,
+    completed,
+    createdAt: prior?.createdAt ?? createdAt,
+    completedAt: completed ? prior?.completedAt ?? now : null,
+    meta: {
+      ...prior?.meta ?? {},
+      evidence,
+      ...step ? {
+        stage: stringField2(step.stage),
+        capability: stringField2(step.capability),
+        ...step.args && typeof step.args === "object" ? { args: step.args } : {},
+        ...step.saveReport === true ? { saveReport: true } : {}
+      } : {}
+    }
+  };
+}
+function itemFromCapability(capability, createdAt, prior) {
+  return {
+    id: capability,
+    title: prior?.title ?? capability,
+    body: prior?.body ?? "",
+    assignee: prior?.assignee ?? null,
+    completed: prior?.completed ?? false,
+    createdAt: prior?.createdAt ?? createdAt,
+    completedAt: prior?.completedAt ?? null,
+    meta: { ...prior?.meta ?? {}, capability }
+  };
+}
+function routeFromItems(items) {
+  return items.flatMap((item) => {
+    const meta = recordField(item.meta);
+    const evidence = stringField2(meta.evidence) || item.id;
+    const stage = stringField2(meta.stage);
+    const capability = stringField2(meta.capability);
+    if (!evidence || !stage || !capability) return [];
+    return [{ evidence, stage, capability, ...meta.args ? { args: meta.args } : {}, ...meta.saveReport === true ? { saveReport: true } : {} }];
+  });
+}
+function parseFrontmatter(raw) {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(raw);
+  if (!match) return {};
+  const parsed = {};
+  for (const rawLine of (match[1] ?? "").split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    const colon = line.indexOf(":");
+    if (colon === -1) continue;
+    parsed[line.slice(0, colon).trim()] = parseFrontmatterValue(line.slice(colon + 1).trim());
+  }
+  return parsed;
+}
+function parseFrontmatterValue(raw) {
+  let value = raw;
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    value = value.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+  }
+  if (value === "true") return true;
+  if (value === "false") return false;
+  if (value === "null") return null;
+  if (value.startsWith("{") || value.startsWith("[") || /^-?\d+(\.\d+)?$/.test(value)) {
+    try {
+      return JSON.parse(value);
+    } catch {
+    }
+  }
+  return value;
+}
+function serializeFrontmatterValue(value) {
+  if (typeof value === "string") return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+  return `"${JSON.stringify(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function itemsBlockRe() {
+  return /<!--\s*kody-todo-items-json\s*\r?\n([\s\S]*?)\r?\n-->/;
+}
+function parseItems(raw) {
+  const match = itemsBlockRe().exec(raw);
+  if (!match) return [];
+  try {
+    const parsed = JSON.parse(match[1] ?? "[]");
+    return Array.isArray(parsed) ? parsed.filter((item) => item && typeof item === "object") : [];
+  } catch {
+    return [];
+  }
+}
+function recordField(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringField2(value) {
+  return typeof value === "string" ? value : "";
+}
+function stringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+var init_managedTodoState = __esm({
+  "src/goal/managedTodoState.ts"() {
+    "use strict";
+    init_state2();
+  }
+});
+
 // src/goal/stateStore.ts
-function statePath(goalId) {
+function goalStatePath(goalId) {
+  return `todos/${goalId}.md`;
+}
+function legacyGoalStatePath(goalId) {
   return `goals/instances/${goalId}/state.json`;
 }
 function fetchGoalState(config, goalId, cwd) {
-  const filePath = statePath(goalId);
+  const filePath = goalStatePath(goalId);
   const loaded = readStateText(config, cwd, filePath);
-  if (!loaded) return null;
-  return parseGoalState(loaded.path, JSON.parse(loaded.content));
+  if (loaded) {
+    if (!isManagedTodoRaw(loaded.content)) return null;
+    return parseTodoGoalState(goalId, loaded.path, loaded.content);
+  }
+  const legacyPath = legacyGoalStatePath(goalId);
+  const legacy = readStateText(config, cwd, legacyPath);
+  if (!legacy) return null;
+  return parseGoalState(legacy.path, JSON.parse(legacy.content));
 }
 function putGoalState(config, goalId, state, message = `chore(goals): update ${goalId}`, cwd) {
-  upsertStateText(config, cwd, statePath(goalId), serializeGoalState(state), message);
+  const previous = readStateText(config, cwd, goalStatePath(goalId));
+  if (previous && !isManagedTodoRaw(previous.content)) {
+    throw new Error(`Cannot overwrite regular todo list ${goalId} as managed goal`);
+  }
+  upsertStateText(config, cwd, goalStatePath(goalId), serializeTodoGoalState(goalId, state, previous?.content), message);
+}
+function listGoalStateIds(config, cwd) {
+  const ids = /* @__PURE__ */ new Set();
+  const todoFileIds = /* @__PURE__ */ new Set();
+  for (const entry of listStateDirectory(config, cwd, "todos")) {
+    if (entry.type !== "file" || !entry.name?.endsWith(".md")) continue;
+    const id = entry.name.slice(0, -3);
+    todoFileIds.add(id);
+    const loaded = readStateText(config, cwd, goalStatePath(id));
+    if (loaded && isManagedTodoRaw(loaded.content)) ids.add(id);
+  }
+  for (const entry of listStateDirectory(config, cwd, "goals/instances")) {
+    if (entry.type !== "dir" || !entry.name) continue;
+    if (todoFileIds.has(entry.name)) continue;
+    ids.add(entry.name);
+  }
+  return [...ids].sort();
 }
 var init_stateStore = __esm({
   "src/goal/stateStore.ts"() {
     "use strict";
     init_stateRepo();
     init_state2();
+    init_managedTodoState();
   }
 });
 
@@ -7156,10 +7354,9 @@ function hasExplicitStateRepo(config) {
   return !!state && typeof state.repo === "string" && state.repo.trim().length > 0 && typeof state.path === "string" && state.path.trim().length > 0;
 }
 function findActiveTargetInstance(config, cwd, loopGoalId, targetId) {
-  const entries = listStateDirectory(config, cwd, "goals/instances");
   const candidates = [];
-  for (const entry of entries) {
-    const id = typeof entry.name === "string" ? entry.name.trim() : "";
+  for (const entryId of listGoalStateIds(config, cwd)) {
+    const id = entryId.trim();
     if (!id || id === loopGoalId || id === targetId || !id.startsWith(`${targetId}-`)) continue;
     assertSafeGoalId(id, "goal instance");
     const state = fetchGoalState(config, id, cwd);
@@ -7261,7 +7458,6 @@ var init_targetLoopResolution = __esm({
   "src/goal/targetLoopResolution.ts"() {
     "use strict";
     init_companyStore();
-    init_stateRepo();
     init_stateStore();
   }
 });
@@ -7276,7 +7472,7 @@ function cloneRoute(route) {
     ...step.args ? { args: structuredClone(step.args) } : {}
   }));
 }
-function stringArray(value) {
+function stringArray2(value) {
   return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : null;
 }
 function routeArray(value) {
@@ -7306,11 +7502,11 @@ function expandManagedGoalState(state) {
   if (!definition) return state;
   const destination = state.extra.destination && typeof state.extra.destination === "object" && !Array.isArray(state.extra.destination) ? { ...state.extra.destination } : {};
   const outcome = typeof destination.outcome === "string" ? destination.outcome : "";
-  const evidence = stringArray(destination.evidence);
-  const capabilities = stringArray(state.extra.capabilities);
+  const evidence = stringArray2(destination.evidence);
+  const capabilities = stringArray2(state.extra.capabilities);
   const route = routeArray(state.extra.route);
   const facts = state.extra.facts && typeof state.extra.facts === "object" && !Array.isArray(state.extra.facts) ? { ...state.extra.facts } : {};
-  const blockers = stringArray(state.extra.blockers);
+  const blockers = stringArray2(state.extra.blockers);
   return {
     ...state,
     extra: {
@@ -8517,7 +8713,7 @@ function parseAction(value) {
 function parseCreateManagedGoal(input) {
   const route = Array.isArray(input.route) ? input.route.map(parseRouteStep) : [];
   if (route.length === 0) throw new Error("createManagedGoal requires route");
-  const evidence = stringArray2(input.evidence);
+  const evidence = stringArray3(input.evidence);
   if (evidence.length === 0) throw new Error("createManagedGoal requires evidence");
   return {
     kind: "createManagedGoal",
@@ -8556,9 +8752,9 @@ function parseUpdateIntentPortfolio(input) {
   return {
     kind: "updateIntentPortfolio",
     intentId: slug(input.intentId, "intentId"),
-    goals: stringArray2(input.goals).filter(isSlug),
-    loops: stringArray2(input.loops).filter(isSlug),
-    capabilities: stringArray2(input.capabilities).filter(isSlug),
+    goals: stringArray3(input.goals).filter(isSlug),
+    loops: stringArray3(input.loops).filter(isSlug),
+    capabilities: stringArray3(input.capabilities).filter(isSlug),
     reason: requiredString(input.reason, "reason")
   };
 }
@@ -8592,12 +8788,12 @@ function requiredString(value, field) {
   if (typeof value !== "string" || !value.trim()) throw new Error(`${field} is required`);
   return value.trim();
 }
-function stringArray2(value) {
+function stringArray3(value) {
   if (!Array.isArray(value)) return [];
   return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
 }
 function nonEmptyStringArray(value, field) {
-  const values = stringArray2(value);
+  const values = stringArray3(value);
   if (values.length === 0) throw new Error(`${field} must not be empty`);
   return values;
 }
@@ -8629,15 +8825,15 @@ function normalizeCompanyIntent(path50, raw) {
     throw new Error(`${path50}: intent must be JSON object`);
   }
   const input = raw;
-  const id = stringField2(input.id);
+  const id = stringField3(input.id);
   if (!id || !isCompanyIntentId(id)) throw new Error(`${path50}: invalid intent id`);
-  const createdAt = stringField2(input.createdAt) || nowIso();
-  const updatedAt = stringField2(input.updatedAt) || createdAt;
+  const createdAt = stringField3(input.createdAt) || nowIso();
+  const updatedAt = stringField3(input.updatedAt) || createdAt;
   return {
     version: 1,
     id,
     status: oneOf2(input.status, ["active", "paused", "archived"], "active"),
-    for: stringField2(input.for),
+    for: stringField3(input.for),
     priority: numberField(input.priority, 100),
     posture: oneOf2(
       input.posture,
@@ -8645,21 +8841,21 @@ function normalizeCompanyIntent(path50, raw) {
       "balanced"
     ),
     scope: {
-      repos: stringArray3(recordField(input.scope)?.repos),
-      areas: stringArray3(recordField(input.scope)?.areas)
+      repos: stringArray4(recordField2(input.scope)?.repos),
+      areas: stringArray4(recordField2(input.scope)?.areas)
     },
-    principles: stringArray3(input.principles),
-    metrics: stringArray3(input.metrics),
+    principles: stringArray4(input.principles),
+    metrics: stringArray4(input.metrics),
     policy: {
-      release: normalizeReleasePolicy(recordField(recordField(input.policy)?.release)),
-      automation: normalizeAutomationPolicy(recordField(recordField(input.policy)?.automation))
+      release: normalizeReleasePolicy(recordField2(recordField2(input.policy)?.release)),
+      automation: normalizeAutomationPolicy(recordField2(recordField2(input.policy)?.automation))
     },
     portfolio: {
-      goals: stringArray3(recordField(input.portfolio)?.goals).filter(isCompanyIntentId),
-      loops: stringArray3(recordField(input.portfolio)?.loops).filter(isCompanyIntentId),
-      capabilities: stringArray3(recordField(input.portfolio)?.capabilities).filter(isCompanyIntentId)
+      goals: stringArray4(recordField2(input.portfolio)?.goals).filter(isCompanyIntentId),
+      loops: stringArray4(recordField2(input.portfolio)?.loops).filter(isCompanyIntentId),
+      capabilities: stringArray4(recordField2(input.portfolio)?.capabilities).filter(isCompanyIntentId)
     },
-    manager: normalizeManager(recordField(input.manager)),
+    manager: normalizeManager(recordField2(input.manager)),
     createdAt,
     updatedAt
   };
@@ -8695,20 +8891,18 @@ function appendCompanyIntentDecision(config, cwd, intentId, entry) {
   appendStateLine(config, cwd, `intents/${intentId}/decisions.jsonl`, JSON.stringify(entry), `chore(intents): log ${intentId} decision`);
 }
 function listCompanyPortfolio(config, cwd) {
-  const entries = listStateDirectory(config, cwd, "goals/instances");
   const goals = [];
-  for (const entry of entries) {
-    if (entry.type !== "dir" || !entry.name || !isCompanyIntentId(entry.name)) continue;
-    const file = readStateText(config, cwd, `goals/instances/${entry.name}/state.json`);
-    if (!file) continue;
-    const state = parseGoalState(file.path, JSON.parse(file.content));
-    const destination = recordField(state.extra.destination);
+  for (const id of listGoalStateIds(config, cwd)) {
+    if (!isCompanyIntentId(id)) continue;
+    const state = fetchGoalState(config, id, cwd);
+    if (!state) continue;
+    const destination = recordField2(state.extra.destination);
     goals.push({
-      id: entry.name,
+      id,
       state: state.state,
-      type: stringField2(state.extra.type) || void 0,
-      outcome: stringField2(destination?.outcome) || void 0,
-      capabilities: stringArray3(state.extra.capabilities),
+      type: stringField3(state.extra.type) || void 0,
+      outcome: stringField3(destination?.outcome) || void 0,
+      capabilities: stringArray4(state.extra.capabilities),
       isLoop: state.extra.scheduleMode === "agentLoop" || state.extra.type === "agentLoop",
       updatedAt: state.updatedAt
     });
@@ -8717,21 +8911,21 @@ function listCompanyPortfolio(config, cwd) {
 }
 function writeCompanyGoalState(config, cwd, id, state, message) {
   assertIntentId(id);
-  upsertStateText(config, cwd, `goals/instances/${id}/state.json`, serializeGoalState(state), message);
+  putGoalState(config, id, state, message, cwd);
 }
 function assertIntentId(id) {
   if (!isCompanyIntentId(id)) throw new Error(`invalid intent/portfolio id: ${id}`);
 }
-function stringField2(value) {
+function stringField3(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function numberField(value, fallback) {
   return typeof value === "number" && Number.isFinite(value) ? value : fallback;
 }
-function recordField(value) {
+function recordField2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-function stringArray3(value) {
+function stringArray4(value) {
   if (!Array.isArray(value)) return [];
   return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
 }
@@ -8752,7 +8946,7 @@ function normalizeAutomationPolicy(raw) {
     authority: "full-auto",
     maxConcurrentGoals: Math.max(1, Math.floor(numberField(raw?.maxConcurrentGoals, 1))),
     maxDailyActions: Math.max(1, Math.floor(numberField(raw?.maxDailyActions, 6))),
-    requiresHumanFor: stringArray3(raw?.requiresHumanFor)
+    requiresHumanFor: stringArray4(raw?.requiresHumanFor)
   };
 }
 function normalizeManager(raw) {
@@ -8769,6 +8963,7 @@ var init_companyIntent = __esm({
   "src/companyIntent.ts"() {
     "use strict";
     init_state2();
+    init_stateStore();
     init_stateRepo();
     SLUG_RE2 = /^[a-z][a-z0-9-]{0,63}$/;
   }
@@ -9115,7 +9310,7 @@ function capabilityEvidenceOutput(evidence) {
 function goalReportBody(goalId, state, snapshot, latestEvent, evidenceItems) {
   const outputs = evidenceItems.map(capabilityEvidenceOutput);
   const latestOutput = outputs.at(-1);
-  const facts = recordField2(snapshot, "facts") ?? recordField2(state.extra, "facts") ?? {};
+  const facts = recordField3(snapshot, "facts") ?? recordField3(state.extra, "facts") ?? {};
   const blockers = uniqueStrings2([
     ...stringArrayField(snapshot, "blockers"),
     ...stringArrayField(latestEvent, "blockers"),
@@ -9134,12 +9329,12 @@ function goalReportBody(goalId, state, snapshot, latestEvent, evidenceItems) {
     "",
     "## Status",
     `- State: ${state.state}`,
-    `- Stage: ${stringField3(snapshot, "stage") ?? stringField3(state.extra, "stage") ?? "unknown"}`,
+    `- Stage: ${stringField4(snapshot, "stage") ?? stringField4(state.extra, "stage") ?? "unknown"}`,
     `- Next step: ${nextStepFromEvent(state, snapshot, latestOutput, latestEvent)}`,
     `- Updated: ${state.updatedAt ?? state.createdAt ?? state.startedAt ?? "unknown"}`,
     "",
     "## Decision",
-    `- Event: ${stringField3(latestEvent, "event") ?? "unknown"}`,
+    `- Event: ${stringField4(latestEvent, "event") ?? "unknown"}`,
     `- Reason: ${decisionReason(state, latestEvent, latestOutput, missingEvidence, blockers)}`,
     `- Required evidence: ${listOrNone(stringArrayField(snapshot, "requiredEvidence"))}`,
     `- Satisfied evidence: ${listOrNone(stringArrayField(snapshot, "satisfiedEvidence"))}`,
@@ -9167,9 +9362,9 @@ function capabilityEvidenceMarkdown(outputs) {
 function decisionReason(state, latestEvent, latestOutput, missingEvidence, blockers) {
   if (state.state === "done") return "destination evidence satisfied";
   if (blockers.length > 0) return blockers[0] ?? "blocked";
-  const eventReason = stringField3(latestEvent, "reason") ?? stringField3(recordField2(latestEvent, "decision"), "reason");
+  const eventReason = stringField4(latestEvent, "reason") ?? stringField4(recordField3(latestEvent, "decision"), "reason");
   if (eventReason) return eventReason;
-  const summary = stringField3(latestOutput, "summary");
+  const summary = stringField4(latestOutput, "summary");
   if (summary) return summary;
   if (missingEvidence.length > 0) return `waiting for ${missingEvidence[0]}`;
   return "waiting for more evidence";
@@ -9177,33 +9372,33 @@ function decisionReason(state, latestEvent, latestOutput, missingEvidence, block
 function evidenceOutputMarkdown(index, output) {
   return [
     `### Output ${index}`,
-    `- Status: ${stringField3(output, "status") ?? "unknown"}`,
-    `- Summary: ${stringField3(output, "summary") ?? "no summary"}`,
+    `- Status: ${stringField4(output, "status") ?? "unknown"}`,
+    `- Summary: ${stringField4(output, "summary") ?? "no summary"}`,
     `- Sources: ${listOrNone(stringArrayField(output, "sources"))}`,
-    `- Evidence values: ${inlineJson(recordField2(output, "evidence") ?? {})}`,
+    `- Evidence values: ${inlineJson(recordField3(output, "evidence") ?? {})}`,
     `- Missing evidence: ${listOrNone(stringArrayField(output, "missingEvidence"))}`,
     `- Blockers: ${listOrNone(stringArrayField(output, "blockers"))}`,
     ""
   ];
 }
 function dispatchContextMarkdown(latestEvent) {
-  const context = recordField2(latestEvent, "dispatchContext");
+  const context = recordField3(latestEvent, "dispatchContext");
   if (!context) return ["- none"];
-  const githubActor = stringField3(context, "githubActor");
-  const githubActorRole = stringField3(context, "githubActorRole");
-  const target = dispatchTargetLabel(recordField2(context, "target"));
+  const githubActor = stringField4(context, "githubActor");
+  const githubActorRole = stringField4(context, "githubActorRole");
+  const target = dispatchTargetLabel(recordField3(context, "target"));
   return [
-    `- Triggered by: ${stringField3(context, "triggeredBy") ?? "unknown"}`,
-    `- Mode: ${stringField3(context, "dispatchMode") ?? "unknown"}`,
+    `- Triggered by: ${stringField4(context, "triggeredBy") ?? "unknown"}`,
+    `- Mode: ${stringField4(context, "dispatchMode") ?? "unknown"}`,
     `- GitHub actor: ${githubActor ? `${githubActor}${githubActorRole ? ` (${githubActorRole})` : ""}` : "none"}`,
-    `- Decided by: ${stringField3(context, "decidedBy") ?? "unknown"}`,
-    `- Dispatched by: ${stringField3(context, "dispatchedBy") ?? "unknown"}`,
+    `- Decided by: ${stringField4(context, "decidedBy") ?? "unknown"}`,
+    `- Dispatched by: ${stringField4(context, "dispatchedBy") ?? "unknown"}`,
     `- Target: ${target ?? "none"}`
   ];
 }
 function dispatchTargetLabel(target) {
-  const type = stringField3(target, "type");
-  const id = stringField3(target, "id");
+  const type = stringField4(target, "type");
+  const id = stringField4(target, "id");
   if (type && id) return `${type} ${id}`;
   return id ?? type;
 }
@@ -9226,11 +9421,11 @@ function listOrNone(values) {
 function uniqueStrings2(values) {
   return [...new Set(values)].sort();
 }
-function stringField3(record2, key) {
+function stringField4(record2, key) {
   const value = record2?.[key];
   return typeof value === "string" && value.trim() ? value : void 0;
 }
-function recordField2(record2, key) {
+function recordField3(record2, key) {
   const value = record2?.[key];
   return value && typeof value === "object" && !Array.isArray(value) ? { ...value } : void 0;
 }
@@ -9263,7 +9458,7 @@ ${artifact.path ?? ""}`;
 }
 function nextStepFromEvent(state, goalAfter, capabilityOutput, latestEvent) {
   if (state.state === "done") return "done";
-  const decisionKind = stringField3(recordField2(latestEvent, "decision"), "kind") ?? stringField3(latestEvent, "status");
+  const decisionKind = stringField4(recordField3(latestEvent, "decision"), "kind") ?? stringField4(latestEvent, "status");
   if (decisionKind === "done") return "done";
   if (decisionKind === "dispatch") return "dispatch";
   if (decisionKind === "blocked" || decisionKind === "reject-evidence") return "block";
@@ -15504,12 +15699,12 @@ async function loadGithubStateConfig(opts) {
   const pathRaw = typeof raw.statePath === "string" ? raw.statePath : nestedState.path;
   const stateRepo = typeof repoRaw === "string" && repoRaw.trim().length > 0 ? repoRaw.trim() : `https://github.com/${github.owner}/kody-state`;
   parseStateRepoSlug(stateRepo);
-  const statePath2 = typeof pathRaw === "string" && pathRaw.trim().length > 0 ? pathRaw.trim() : github.repo;
+  const statePath = typeof pathRaw === "string" && pathRaw.trim().length > 0 ? pathRaw.trim() : github.repo;
   return {
     github,
     state: {
       repo: stateRepo,
-      path: normalizeStatePath(statePath2)
+      path: normalizeStatePath(statePath)
     }
   };
 }

package/package.json

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