@kody-ade/kody-engine 0.4.280 → 0.4.282

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.280",
+      version: "0.4.282",
       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) {
@@ -6305,6 +6305,28 @@ var init_abortUnfinishedGitOps = __esm({
   }
 });
 
+// src/scripts/deliveryOutcome.ts
+function isRecord(input) {
+  return !!input && typeof input === "object" && !Array.isArray(input);
+}
+function setDeliveryNotRequired(data, reason) {
+  data.deliveryOutcome = { kind: "not_required", reason };
+}
+function readDeliveryOutcome(data) {
+  const raw = data.deliveryOutcome;
+  if (!isRecord(raw)) return null;
+  if (raw.kind !== "not_required" || typeof raw.reason !== "string" || raw.reason.length === 0) return null;
+  return { kind: "not_required", reason: raw.reason };
+}
+function isDeliveryNotRequired(data) {
+  return readDeliveryOutcome(data)?.kind === "not_required";
+}
+var init_deliveryOutcome = __esm({
+  "src/scripts/deliveryOutcome.ts"() {
+    "use strict";
+  }
+});
+
 // src/scripts/saveTaskState.ts
 function jobMetaFromData(data) {
   return {
@@ -6322,7 +6344,7 @@ function jobMetaFromData(data) {
 }
 function applyStandaloneTerminalState(state, ctx, profile) {
   if (profile.lifecycleConfig?.finalize !== true || state.flow?.issueNumber) return;
-  const delivered = ctx.output.exitCode === 0 && !!state.core.prUrl;
+  const delivered = ctx.output.exitCode === 0 && (!!state.core.prUrl || isDeliveryNotRequired(ctx.data));
   state.core.phase = delivered ? "shipped" : "failed";
   state.core.status = delivered ? "succeeded" : "failed";
   state.core.currentExecutable = null;
@@ -6344,6 +6366,7 @@ var init_saveTaskState = __esm({
   "src/scripts/saveTaskState.ts"() {
     "use strict";
     init_state();
+    init_deliveryOutcome();
     saveTaskState = async (ctx, profile) => {
       const target = ctx.data.commentTargetType;
       const number = ctx.data.commentTargetNumber;
@@ -6722,7 +6745,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];
@@ -6961,9 +6984,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;
 }
@@ -7061,24 +7084,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();
   }
 });
 
@@ -7133,10 +7359,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);
@@ -7238,7 +7463,6 @@ var init_targetLoopResolution = __esm({
   "src/goal/targetLoopResolution.ts"() {
     "use strict";
     init_companyStore();
-    init_stateRepo();
     init_stateStore();
   }
 });
@@ -7253,7 +7477,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) {
@@ -7283,11 +7507,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: {
@@ -8494,7 +8718,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",
@@ -8533,9 +8757,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")
   };
 }
@@ -8569,12 +8793,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;
 }
@@ -8606,15 +8830,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,
@@ -8622,21 +8846,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
   };
@@ -8672,20 +8896,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
     });
@@ -8694,21 +8916,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);
 }
@@ -8729,7 +8951,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) {
@@ -8746,6 +8968,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}$/;
   }
@@ -9092,7 +9315,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"),
@@ -9111,12 +9334,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"))}`,
@@ -9144,9 +9367,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";
@@ -9154,33 +9377,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;
 }
@@ -9203,11 +9426,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;
 }
@@ -9240,7 +9463,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";
@@ -11670,6 +11893,7 @@ var init_finalizeTerminal = __esm({
     init_issue();
     init_lifecycleLabels();
     init_state();
+    init_deliveryOutcome();
     DONE = {
       label: "kody:done",
       color: "0e8a16",
@@ -11690,7 +11914,7 @@ var init_finalizeTerminal = __esm({
       const cachedState = ctx.data.taskState;
       let state = cachedState;
       const prUrl = cachedState?.core.prUrl ?? ctx.output.prUrl ?? ctx.data.prResult?.url;
-      const delivered = ctx.output.exitCode === 0 && !!prUrl;
+      const delivered = ctx.output.exitCode === 0 && (!!prUrl || isDeliveryNotRequired(ctx.data));
       const spec = delivered ? DONE : FAILED;
       const phase = delivered ? "shipped" : "failed";
       const status = delivered ? "succeeded" : "failed";
@@ -14331,6 +14555,7 @@ var init_postIssueComment = __esm({
     "use strict";
     init_issue();
     init_lifecycleLabels();
+    init_deliveryOutcome();
     init_prOutcome();
     FAILED_LABEL_SPEC = {
       label: "kody:failed",
@@ -14347,7 +14572,14 @@ var init_postIssueComment = __esm({
       const prResult = readPrOutcome(ctx.data);
       if (!commitResult?.committed && !hasCommits) {
         const specific = computeFailureReason2(ctx);
-        const reason = specific.length > 0 ? specific : "no changes to commit";
+        if (specific.length === 0) {
+          const reason2 = "work already satisfied; no PR needed";
+          setDeliveryNotRequired(ctx.data, reason2);
+          postWith(targetType, targetNumber, `\u2139\uFE0F kody made no changes \u2014 ${reason2}`, ctx.cwd);
+          ctx.output.exitCode = 0;
+          return;
+        }
+        const reason = specific;
         const containerParent = process.env.KODY_CONTAINER_PARENT;
         if (containerParent) {
           postWith(
@@ -15472,12 +15704,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)
     }
   };
 }
@@ -19932,22 +20164,20 @@ init_gha();
 init_issue();
 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) {
+function isRecord2(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" };
+  if (!isRecord2(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") {
@@ -19970,14 +20200,14 @@ function parseRunRequest(input) {
       return { error: `${RUN_REQUEST_ENV} must be valid JSON` };
     }
   }
-  if (!isRecord(body)) return { error: "runRequest must be an object" };
+  if (!isRecord2(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)) {
+  if (body.input !== void 0 && !isRecord2(body.input)) {
     return { error: "runRequest.input must be an object when provided" };
   }
   return {
@@ -19996,6 +20226,8 @@ function readRunRequestFromEnv(env = process.env) {
 }
 
 // src/kody-cli.ts
+init_runtimePaths();
+init_stateWorkspace();
 var CI_HELP = `kody ci \u2014 minimal-YAML autonomous engineer (CI preflight + run)
 
 Usage:
@@ -20268,6 +20500,9 @@ ${tail}
   } catch {
   }
 }
+function shouldPostRunFailureTail(exitCode) {
+  return exitCode !== 0 && exitCode !== 1 && exitCode !== 2 && exitCode !== 3;
+}
 async function runCi(argv) {
   if (argv.includes("--help") || argv.includes("-h")) {
     process.stdout.write(CI_HELP);
@@ -20497,10 +20732,8 @@ ${CI_HELP}`);
 `);
     const buildOnly = dispatch2.executable === "preview-build";
     if (args.skipInstall || buildOnly) {
-      process.stdout.write(
-        `\u2192 kody: skipping dep install (${buildOnly ? "build-only executable" : "--skip-install"})
-`
-      );
+      process.stdout.write(`\u2192 kody: skipping dep install (${buildOnly ? "build-only executable" : "--skip-install"})
+`);
     } else {
       const code = installDeps(pm, cwd);
       if (code !== 0) {
@@ -20539,7 +20772,7 @@ ${CI_HELP}`);
       verbose: args.verbose,
       quiet: args.quiet
     });
-    if (result.exitCode !== 0 && result.exitCode !== 1 && result.exitCode !== 2) {
+    if (shouldPostRunFailureTail(result.exitCode)) {
       postFailureTail(issueNumber, cwd, result.reason || `exit ${result.exitCode}`);
     }
     return result.exitCode;
@@ -20599,11 +20832,9 @@ async function runScheduledFanOut(cwd, args, opts) {
   const config = loadConfig(cwd);
   const serial = process.env.KODY_SERIAL_WATCHES === "1";
   const runWatch = async (match) => {
-    process.stdout.write(
-      `
+    process.stdout.write(`
 \u2192 kody: running watch capability \`${match.capability}\` (${match.executable})
-`
-    );
+`);
     try {
       const result = await runJob(
         mintScheduledJob({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.280",
+  "version": "0.4.282",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,27 +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",
-    "clean:dist": "node scripts/clean-dist.cjs",
-    "build": "pnpm clean:dist && 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",
@@ -56,5 +35,25 @@
     "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",
+    "clean:dist": "node scripts/clean-dist.cjs",
+    "build": "pnpm clean:dist && 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"
+  }
+}