@kody-ade/kody-engine 0.4.446 → 0.4.448

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.446",
+      version: "0.4.448",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1795,11 +1795,11 @@ function parseWorkflowTransitions(value) {
   const transitions = rawTransitions.map((raw) => {
     if (typeof raw === "string") {
       const to2 = raw.trim();
-      return isSafeStepId(to2) ? { to: to2 } : null;
+      return to2 === "$end" || isSafeStepId(to2) ? { to: to2 } : null;
     }
     if (!isPlainObject(raw)) return null;
     const to = stringField(raw.to);
-    if (!to || !isSafeStepId(to)) return null;
+    if (!to || to !== "$end" && !isSafeStepId(to)) return null;
     const maxIterations = typeof raw.maxIterations === "number" && Number.isInteger(raw.maxIterations) && raw.maxIterations > 0 ? raw.maxIterations : void 0;
     return {
       to,
@@ -1862,11 +1862,11 @@ function definitionsRoot(cwd = process.cwd()) {
   const override = process.env.KODY_DEFINITIONS_ROOT?.trim();
   const overrideCwd = process.env.KODY_DEFINITIONS_ROOT_CWD?.trim();
   if (override && overrideCwd && path6.resolve(cwd) === path6.resolve(overrideCwd)) {
-    return path6.resolve(override);
+    return storeCatalogRoot(path6.resolve(override));
   }
   const hydrated = path6.join(cwd, ".kody-engine", "definitions");
   if (fs5.existsSync(hydrated)) return hydrated;
-  return override ? path6.resolve(override) : hydrated;
+  return override ? storeCatalogRoot(path6.resolve(override)) : hydrated;
 }
 function hasExplicitDefinitionsRoot(cwd = process.cwd(), env = process.env) {
   const root = env.KODY_DEFINITIONS_ROOT?.trim();
@@ -1874,13 +1874,36 @@ function hasExplicitDefinitionsRoot(cwd = process.cwd(), env = process.env) {
   return Boolean(root && rootCwd && path6.resolve(cwd) === path6.resolve(rootCwd));
 }
 function capabilitiesRoot(cwd = process.cwd()) {
-  return path6.join(definitionsRoot(cwd), "capabilities");
+  return storeAssetRoot(cwd, "capabilities") ?? path6.join(definitionsRoot(cwd), "capabilities");
 }
 function implementationsRoot(cwd = process.cwd()) {
   return path6.join(definitionsRoot(cwd), "implementations");
 }
 function agentsRoot(cwd = process.cwd()) {
-  return path6.join(definitionsRoot(cwd), "agents");
+  return storeAssetRoot(cwd, "agent") ?? path6.join(definitionsRoot(cwd), "agents");
+}
+function storeCatalogRoot(root) {
+  const manifest = readStoreManifest(root);
+  const roots = ["capabilities", "workflows", "loops"].map((kind) => manifest?.assetRoots?.[kind]).filter((value) => typeof value === "string" && Boolean(value.trim())).map((value) => path6.dirname(value));
+  return roots.length === 3 && new Set(roots).size === 1 ? path6.join(root, roots[0]) : root;
+}
+function storeAssetRoot(cwd, kind) {
+  const override = process.env.KODY_DEFINITIONS_ROOT?.trim();
+  if (!override) return null;
+  const overrideCwd = process.env.KODY_DEFINITIONS_ROOT_CWD?.trim();
+  if (overrideCwd && path6.resolve(cwd) !== path6.resolve(overrideCwd)) return null;
+  const root = path6.resolve(override);
+  const configured = readStoreManifest(root)?.assetRoots?.[kind];
+  return typeof configured === "string" && configured.trim() ? path6.join(root, configured) : null;
+}
+function readStoreManifest(root) {
+  const file = path6.join(root, "kody-store.json");
+  if (!fs5.existsSync(file)) return null;
+  try {
+    return JSON.parse(fs5.readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
 }
 var init_definition_paths = __esm({
   "src/definition-paths.ts"() {
@@ -8959,10 +8982,13 @@ function validateWorkflow(value, options = {}) {
         }
       }
       const target = text(raw.to);
-      if (!target || !SAFE_STEP_ID.test(target)) {
+      if (!target || target !== "$end" && !SAFE_STEP_ID.test(target)) {
         issue(issues, "invalid_transition_target", `${base}.to`, "workflow connection must name a valid target step");
         return;
       }
+      if (target === "$end") {
+        return;
+      }
       if (!seen.has(target)) {
         issue(
           issues,
@@ -13898,6 +13924,9 @@ var init_loopDefinitions = __esm({
 
 // src/scripts/dispatchSimpleLoops.ts
 import { randomUUID as randomUUID2 } from "crypto";
+function loopDispatchSlot(loop, now, force, nonce) {
+  return force ? `manual:${now.toISOString()}:${nonce}` : dueSlot(loop, now);
+}
 function dueSlot(loop, now) {
   if (!loop.enabled || loop.trigger.type !== "schedule") return null;
   const match = /^(\d+)([mhd])$/.exec(loop.trigger.every);
@@ -13951,18 +13980,25 @@ var init_dispatchSimpleLoops = __esm({
       const tenantId2 = repositoryTenant2(ctx.config);
       if (!tenantId2) throw new Error("Repository identity is required for Loop dispatch");
       const now = /* @__PURE__ */ new Date();
-      const due = listLoopDefinitions(ctx.cwd).filter((loop) => dueSlot(loop, now) !== null);
+      const force = ctx.data.jobForce === true;
+      const due = listLoopDefinitions(ctx.cwd).filter(
+        (loop) => loop.enabled && loop.trigger.type === "schedule" && (force || dueSlot(loop, now) !== null)
+      );
       const backend = createStateBackendFromEnv();
       const results = [];
       for (const loop of due) {
-        const slot = dueSlot(loop, now);
+        const slot = loopDispatchSlot(loop, now, force, randomUUID2());
         if (!slot) continue;
         const reservationId = `reservation-${randomUUID2()}`;
         const idempotencyKey = `${loop.id}:${slot}`;
         const claimed = await backend.reserveAgencyDispatch(tenantId2, {
           idempotencyKey,
           loopId: loop.id,
-          decision: { kind: "fire", reason: "local Loop schedule is due", scheduledAt: slot },
+          decision: {
+            kind: "fire",
+            reason: force ? "manual Loop run requested" : "local Loop schedule is due",
+            scheduledAt: slot
+          },
           leaseUntil: new Date(now.getTime() + 6 * 60 * 60 * 1e3).toISOString(),
           reservationId,
           correlationId: `corr-${randomUUID2()}`,
@@ -22687,6 +22723,13 @@ async function runGraphCapabilityWorkflow(parent, workflow, capability, base, ch
       const key = `${step.id}->${transition.to}`;
       state.transitionCounts[key] = (state.transitionCounts[key] ?? 0) + 1;
     }
+    if (transition.to === "$end") {
+      state.status = "done";
+      delete state.currentStepId;
+      delete state.blocker;
+      await checkpoint?.(state);
+      return withWorkflowBoundaryEval(capability, { ...result, workflowState: state });
+    }
     state.currentStepId = transition.to;
     state.status = "running";
     delete state.blocker;
@@ -22862,7 +22905,7 @@ function valueMatches(actual, expected) {
 }
 function workflowStepTargetNumber(step, parent, chainData) {
   if (step.target === "pr") return workflowPrNumber(chainData) ?? workflowTargetFactNumber(step, chainData);
-  if (step.target === "issue") return workflowIssueNumber(parent);
+  if (step.target === "issue") return workflowIssueNumber(parent) ?? workflowTargetFactNumber(step, chainData);
   return typeof parent.target === "number" ? parent.target : targetFromCliArgs(parent.cliArgs);
 }
 function workflowResumeStartIndex(steps, evidence) {
@@ -22940,6 +22983,7 @@ function mintScheduledJob(input) {
     agent: input.agent,
     cliArgs: input.cliArgs ?? {},
     flavor: "scheduled",
+    force: input.force === true,
     saveReport: input.saveReport === true
   };
 }
@@ -25614,7 +25658,8 @@ async function runScheduledFanOut(cwd, args, opts) {
           action: match.action,
           capability: match.capability,
           implementation: match.implementation,
-          cliArgs: match.cliArgs
+          cliArgs: match.cliArgs,
+          force: opts.force
         }),
         {
           cwd,

package/package.json

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