@kody-ade/kody-engine 0.4.336 → 0.4.338

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.336",
+      version: "0.4.338",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -11403,7 +11403,7 @@ function formatCapabilityReference(data, profileName) {
     lines.push(`- Capability: \`${capabilitySlug}\`${capabilityTitle ? ` \u2014 *${capabilityTitle}*` : ""}`);
   }
   if (executableSlug) {
-    lines.push(`- Executable: \`${executableSlug}\``);
+    lines.push(`- Implementation: \`${executableSlug}\``);
   }
   const agentLine = agentSlug ? `\`${agentSlug}\`${agentTitle && agentTitle !== agentSlug ? ` \u2014 *${agentTitle}*` : ""}` : "";
   if (agentLine) {
@@ -15390,10 +15390,10 @@ function parseAgentFactoryBundle(raw) {
     modelCreatorContractsUsed: value.modelCreatorContractsUsed
   };
 }
-function buildAgentFactoryBranchName(issueNumber, title, now = Date.now()) {
+function buildStatePrBranchName(sourceLabel, issueNumber, title, now = Date.now()) {
   const slug2 = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48).replace(/-+$/g, "");
   const suffix = slug2 ? `-${slug2}` : "";
-  return `agent-factory/issue-${issueNumber}-${now.toString(36)}${suffix}`;
+  return `${sourceLabel}/issue-${issueNumber}-${now.toString(36)}${suffix}`;
 }
 function normalizeBundleFiles(ctx, bundle) {
   const seen = /* @__PURE__ */ new Set();
@@ -15449,6 +15449,13 @@ function requireString2(value, label) {
   }
   return value;
 }
+function creatorSourceLabel(ctx, profileName) {
+  const capability = typeof ctx.data.jobCapability === "string" ? ctx.data.jobCapability.trim() : "";
+  const implementation = typeof ctx.data.jobImplementation === "string" ? ctx.data.jobImplementation.trim() : "";
+  const executable = typeof ctx.data.jobExecutable === "string" ? ctx.data.jobExecutable.trim() : "";
+  const profile = typeof profileName === "string" ? profileName.trim() : "";
+  return capability || implementation || executable || profile || "agent-factory";
+}
 function ghJson(args, cwd, input) {
   const raw = gh(args, input === void 0 ? { cwd } : { cwd, input: JSON.stringify(input) });
   if (!raw) return {};
@@ -15460,10 +15467,10 @@ function ghJson(args, cwd, input) {
     );
   }
 }
-function renderPullRequestBody(ctx, bundle, files) {
+function renderPullRequestBody(ctx, bundle, files, sourceLabel) {
   const issueNumber = readIssueNumber(ctx);
   return [
-    "Agent factory generated a Kody agency model bundle for review.",
+    `${sourceLabel} generated Kody agency model changes for review.`,
     "",
     `Source issue: ${ctx.config.github.owner}/${ctx.config.github.repo}#${issueNumber}`,
     "",
@@ -15478,9 +15485,9 @@ function renderPullRequestBody(ctx, bundle, files) {
     "Generated definitions are inactive until this state-repo PR is reviewed and merged."
   ].join("\n");
 }
-function renderIssueComment(owner, repo, prUrl, bundle) {
+function renderIssueComment(owner, repo, prUrl, bundle, sourceLabel) {
   return [
-    `agent-factory opened a state-repo review PR: ${prUrl}`,
+    `${sourceLabel} opened a state-repo review PR: ${prUrl}`,
     "",
     `State repo: ${owner}/${repo}`,
     "",
@@ -15494,7 +15501,7 @@ var init_openAgentFactoryStatePr = __esm({
     "use strict";
     init_issue();
     init_stateRepo();
-    openAgentFactoryStatePr = async (ctx, _profile, agentResult) => {
+    openAgentFactoryStatePr = async (ctx, profile, agentResult) => {
       if (agentResult?.outcome !== "completed") {
         throw new Error(`openAgentFactoryStatePr: agent did not complete: ${agentResult?.error ?? "unknown failure"}`);
       }
@@ -15505,11 +15512,12 @@ var init_openAgentFactoryStatePr = __esm({
         throw new Error("openAgentFactoryStatePr: config.state.repo and config.state.path are required");
       }
       const issueNumber = readIssueNumber(ctx);
+      const sourceLabel = creatorSourceLabel(ctx, profile.name);
       const bundle = parseAgentFactoryBundle(String(ctx.data.prSummary ?? ""));
       const normalizedFiles = normalizeBundleFiles(ctx, bundle);
       const stateRepo = parseStateRepo(ctx.config);
       const baseBranch = "main";
-      const branch = buildAgentFactoryBranchName(issueNumber, bundle.title);
+      const branch = buildStatePrBranchName(sourceLabel, issueNumber, bundle.title);
       const baseRef = ghJson(
         ["api", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/ref/heads/${baseBranch}`],
         ctx.cwd
@@ -15548,7 +15556,7 @@ var init_openAgentFactoryStatePr = __esm({
         ["api", "--method", "POST", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/commits`, "--input", "-"],
         ctx.cwd,
         {
-          message: `agent-factory: ${bundle.title}`,
+          message: `${sourceLabel}: ${bundle.title}`,
           tree: treeSha,
           parents: [baseSha]
         }
@@ -15573,16 +15581,16 @@ var init_openAgentFactoryStatePr = __esm({
         ["api", "--method", "POST", `/repos/${stateRepo.owner}/${stateRepo.repo}/pulls`, "--input", "-"],
         ctx.cwd,
         {
-          title: `agent-factory: ${bundle.title}`,
+          title: `${sourceLabel}: ${bundle.title}`,
           head: branch,
           base: baseBranch,
-          body: renderPullRequestBody(ctx, bundle, normalizedFiles)
+          body: renderPullRequestBody(ctx, bundle, normalizedFiles, sourceLabel)
         }
       );
       const prUrl = requireString2(pr.html_url, "created pull request url");
       gh(["issue", "comment", String(issueNumber), "--body-file", "-"], {
         cwd: ctx.cwd,
-        input: renderIssueComment(stateRepo.owner, stateRepo.repo, prUrl, bundle)
+        input: renderIssueComment(stateRepo.owner, stateRepo.repo, prUrl, bundle, sourceLabel)
       });
       ctx.data.agentFactoryStatePr = {
         repo: `${stateRepo.owner}/${stateRepo.repo}`,
@@ -19145,7 +19153,7 @@ var init_writeAgentRunSummary = __esm({
     writeAgentRunSummary = async (ctx, profile) => {
       const summaryPath = process.env.GITHUB_STEP_SUMMARY;
       if (!summaryPath) return;
-      const executable = profile.name;
+      const implementation = profile.name;
       const issue = ctx.args.issue;
       const pr = ctx.args.pr;
       const target = issue ? `issue #${issue}` : pr ? `PR #${pr}` : "(unknown)";
@@ -19154,9 +19162,9 @@ var init_writeAgentRunSummary = __esm({
       const reason = ctx.output.reason;
       const status = exitCode === 0 ? "\u2705 success" : exitCode === 3 ? "\u23ED\uFE0F no-op" : "\u26A0\uFE0F failed";
       const lines = [];
-      lines.push(`## kody ${executable} \u2014 ${status}`);
+      lines.push(`## kody ${implementation} \u2014 ${status}`);
       lines.push("");
-      lines.push(`- **Executable:** \`${executable}\``);
+      lines.push(`- **Implementation:** \`${implementation}\``);
       lines.push(`- **Target:** ${target}`);
       if (prUrl) lines.push(`- **PR:** ${prUrl}`);
       lines.push(`- **Exit code:** ${exitCode}`);

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

@@ -65,6 +65,19 @@ Required files:
 
 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.
 
+The profile is part of the Capability contract. It must use the same slug as `model.slug` and must declare the current capability kind field:
+
+```json
+{
+  "slug": "<same slug as model.slug>",
+  "name": "Display Name",
+  "capabilityKind": "observe|act|verify"
+}
+```
+
+Do not put `kind: "observe"`, `kind: "act"`, or `kind: "verify"` in the profile. `kind` is not the capability kind field.
+Every generated file path must use exactly the same slug as `model.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
@@ -95,7 +108,7 @@ PR_SUMMARY:
   "files": [
     {
       "path": "capabilities/example/profile.json",
-      "content": "{\n  \"name\": \"example\"\n}\n"
+      "content": "{\n  \"slug\": \"example\",\n  \"name\": \"Example\",\n  \"capabilityKind\": \"observe\"\n}\n"
     },
     {
       "path": "capabilities/example/capability.md",

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

@@ -52,6 +52,27 @@ Prefer placing workflow steps on the public capability that owns the composed ac
 
 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.
 
+The workflow profile is stored as a capability profile because workflows are composed capability runs. The generated file path must use exactly the same slug as `model.slug`.
+
+Minimum profile shape:
+
+```json
+{
+  "slug": "<same slug as model.slug>",
+  "name": "Display Name",
+  "workflow": {
+    "steps": [
+      {
+        "capability": "capability-slug",
+        "reason": "why this step exists"
+      }
+    ]
+  }
+}
+```
+
+Do not place workflow files under `workflows/`. Do not use a different profile slug than `model.slug`.
+
 # Final Output Contract
 
 If the request is too ambiguous to produce one review-ready Workflow model, output one line:
@@ -80,7 +101,7 @@ PR_SUMMARY:
   "files": [
     {
       "path": "capabilities/example/profile.json",
-      "content": "{\n  \"workflow\": { \"steps\": [] }\n}\n"
+      "content": "{\n  \"slug\": \"example\",\n  \"name\": \"Example Workflow\",\n  \"workflow\": { \"steps\": [{ \"capability\": \"example-capability\", \"reason\": \"run the composed capability\" }] }\n}\n"
     }
   ]
 }

package/package.json

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