@kody-ade/kody-engine 0.4.331 → 0.4.333

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.331",
+      version: "0.4.333",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -18296,8 +18296,12 @@ function validateFilesForKind(kind, slug2, files, strictSingleModel, failures) {
     if (strictSingleModel) rejectOtherRoots(paths, [`capabilities/${slug2}/`], "capability", failures);
     const profile = parseJsonFile(files, `capabilities/${slug2}/profile.json`, failures);
     if (profile) {
+      const profileSlug = stringField6(profile.slug);
       const profileName = stringField6(profile.name);
-      if (profileName && profileName !== slug2) failures.push("capability profile name must match model.slug");
+      if (profileSlug && profileSlug !== slug2) failures.push("capability profile slug must match model.slug");
+      if (!profileSlug && profileName && profileName !== slug2) {
+        failures.push("capability profile name must match model.slug when slug is absent");
+      }
       if (profile.agent !== void 0)
         failures.push("capability profile must not set agent; agent wiring belongs outside capability creation");
       if (!["observe", "act", "verify"].includes(stringField6(profile.capabilityKind))) {
@@ -18312,13 +18316,17 @@ function validateFilesForKind(kind, slug2, files, strictSingleModel, failures) {
   if (kind === "agentLoop") {
     if (!paths.some((filePath) => filePath.endsWith("/state.json")))
       failures.push("agentLoop must produce a state.json file");
-    if (strictSingleModel) rejectOtherRoots(paths, ["goals/templates/", "loops/"], "agentLoop", failures);
+    if (strictSingleModel) rejectOtherRoots(paths, ["goals/", "loops/"], "agentLoop", failures);
   }
   if (kind === "workflow") {
     requirePath(paths, `capabilities/${slug2}/profile.json`, "workflow capability profile", failures);
     const profile = parseJsonFile(files, `capabilities/${slug2}/profile.json`, failures);
-    if (profile && (!profile.workflow || typeof profile.workflow !== "object")) {
-      failures.push("workflow profile must include workflow object");
+    if (profile) {
+      const hasWorkflowObject = Boolean(profile.workflow && typeof profile.workflow === "object");
+      const hasTopLevelSteps = Array.isArray(profile.steps) && profile.steps.length > 0;
+      if (!hasWorkflowObject && !hasTopLevelSteps) {
+        failures.push("workflow profile must include workflow object or top-level steps");
+      }
     }
   }
 }

package/dist/executables/agent-creator/prompt.md

@@ -12,6 +12,8 @@ Read and follow these docs before producing the model:
 
 - `docs/agents.md`
 
+These docs are contract references. If the consumer repo does not contain them or `Read` fails, continue from the model boundary below and still list the referenced doc paths in `model.docsUsed`.
+
 # Operator Request
 
 {{issue.body}}
@@ -45,6 +47,8 @@ Do not own:
 
 Create the smallest review-ready Agent model that satisfies the request.
 
+Do not call Bash, Write, Edit, mkdir, cat, tee, printf, python, node, git, gh, or any external command. Your only mutation channel is `PR_SUMMARY.files`; the deterministic postflight opens the state-repo review PR from that JSON.
+
 Use current storage names in file paths. Put the generated agent at:
 
 `agents/<slug>.md`

package/dist/executables/agent-factory/prompt.md

@@ -22,6 +22,8 @@ Design the smallest Kody model structure that satisfies the request. You may cre
 
 Treat each generated model as if it were produced by its model-specific creator. Do not let the factory invent mixed-responsibility files.
 
+The docs named in the creator contracts are contract references. If the consumer repo does not contain them or `Read` fails, continue from the table below and still list the referenced doc paths in each model's `docsUsed`.
+
 ## Model creator contracts
 
 Use these contracts when deciding whether a file belongs in the bundle:
@@ -36,6 +38,19 @@ Use these contracts when deciding whether a file belongs in the bundle:
 
 If one generated model needs information from another, reference the other model by slug. Do not copy that model's responsibility into the file.
 
+Use these exact model kinds and required file shapes:
+
+| Model kind | Required files |
+| --- | --- |
+| `agent` | `agents/<slug>.md` |
+| `goal` | `goals/templates/<slug>/state.json` |
+| `agentLoop` | a `state.json` under `goals/<slug>/` or `loops/<slug>/` |
+| `workflow` | `capabilities/<slug>/profile.json` containing a `workflow` object or top-level `steps` |
+| `capability` | `capabilities/<slug>/profile.json` and `capabilities/<slug>/capability.md` |
+
+Do not use `kind: "loop"`; the loop model kind is `agentLoop`.
+Do not use `agents/<slug>/identity.json`, `goals/<slug>/goal.json`, `workflows/<slug>/workflow.json`, or `executables/<slug>/...`.
+
 Capability files must be shaped by ability, kind, interface, and constraints. Do not include fields or prose that make the capability depend on who asked for it, which workflow calls it, which goal consumes it, which loop wakes it, or which agent may run it.
 
 Use the current Kody vocabulary:

package/dist/executables/capability-creator/prompt.md

@@ -14,6 +14,8 @@ Read and follow these docs before producing the model:
 - `docs/capability-kind-map.md`
 - `docs/executables.md`
 
+These docs are contract references. If the consumer repo does not contain them or `Read` fails, continue from the model boundary below and still list the referenced doc paths in `model.docsUsed`.
+
 # Operator Request
 
 {{issue.body}}
@@ -50,6 +52,8 @@ Those are wiring decisions outside this model.
 
 Create the smallest review-ready Capability model that satisfies the requested ability.
 
+Do not call Bash, Write, Edit, mkdir, cat, tee, printf, python, node, git, gh, or any external command. Your only mutation channel is `PR_SUMMARY.files`; the deterministic postflight opens the state-repo review PR from that JSON.
+
 Use current storage names in file paths. Put generated files under:
 
 `capabilities/<slug>/`
@@ -59,6 +63,8 @@ Required files:
 - `capabilities/<slug>/profile.json`
 - `capabilities/<slug>/capability.md`
 
+In `profile.json`, include `"slug": "<slug>"`. The `"name"` field may be a display name, but if `slug` is absent then `name` must equal the slug.
+
 Add colocated prompt/scripts only if the capability needs a new implementation. Reuse existing capabilities, implementation profiles, skills, or scripts when they fit.
 
 # Final Output Contract

package/dist/executables/goal-creator/prompt.md

@@ -14,6 +14,8 @@ Read and follow these docs before producing the model:
 - `docs/jobs-model.md`
 - `docs/capabilities.md`
 
+These docs are contract references. If the consumer repo does not contain them or `Read` fails, continue from the model boundary below and still list the referenced doc paths in `model.docsUsed`.
+
 # Operator Request
 
 {{issue.body}}
@@ -48,6 +50,8 @@ Do not own:
 
 Create the smallest review-ready managed Goal model that satisfies the requested outcome.
 
+Do not call Bash, Write, Edit, mkdir, cat, tee, printf, python, node, git, gh, or any external command. Your only mutation channel is `PR_SUMMARY.files`; the deterministic postflight opens the state-repo review PR from that JSON.
+
 Use current storage names in file paths. Put generated templates under:
 
 `goals/templates/<slug>/state.json`

package/dist/executables/loop-creator/prompt.md

@@ -14,6 +14,8 @@ Read and follow these docs before producing the model:
 - `docs/engine-company.md`
 - `docs/ledgers.md`
 
+These docs are contract references. If the consumer repo does not contain them or `Read` fails, continue from the model boundary below and still list the referenced doc paths in `model.docsUsed`.
+
 # Operator Request
 
 {{issue.body}}
@@ -45,6 +47,8 @@ Do not own:
 
 Create the smallest review-ready AgentLoop model that satisfies the requested wakeup behavior.
 
+Do not call Bash, Write, Edit, mkdir, cat, tee, printf, python, node, git, gh, or any external command. Your only mutation channel is `PR_SUMMARY.files`; the deterministic postflight opens the state-repo review PR from that JSON.
+
 Use current storage names in file paths. Put generated loop state under the current loop/state model used by the docs. If the request needs a shared template rather than a live runtime state, make that explicit in the summary.
 
 # Final Output Contract

package/dist/executables/workflow-creator/prompt.md

@@ -13,6 +13,8 @@ Read and follow these docs before producing the model:
 - `docs/jobs-model.md`
 - `docs/capabilities.md`
 
+These docs are contract references. If the consumer repo does not contain them or `Read` fails, continue from the model boundary below and still list the referenced doc paths in `model.docsUsed`.
+
 # Operator Request
 
 {{issue.body}}
@@ -44,8 +46,12 @@ Do not own:
 
 Create the smallest review-ready Workflow model that satisfies the requested ordered run behavior.
 
+Do not call Bash, Write, Edit, mkdir, cat, tee, printf, python, node, git, gh, or any external command. Your only mutation channel is `PR_SUMMARY.files`; the deterministic postflight opens the state-repo review PR from that JSON.
+
 Prefer placing workflow steps on the public capability that owns the composed action. Do not create a workflow when a single capability is enough.
 
+Put the workflow contract in `capabilities/<slug>/profile.json`. Prefer a `workflow` object with `steps`; top-level `steps` are only for existing profiles that already use that shape.
+
 # Final Output Contract
 
 If the request is too ambiguous to produce one review-ready Workflow model, output one line:

package/package.json

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