@kody-ade/kody-engine 0.4.121 → 0.4.122

package/dist/bin/kody.js

@@ -880,7 +880,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.121",
+  version: "0.4.122",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -901,6 +901,7 @@ var package_default = {
     "check:modularity": "tsx scripts/check-script-modularity.ts",
     pretest: "pnpm check:modularity",
     test: "vitest run tests/unit tests/int --coverage",
+    "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",
@@ -7451,8 +7452,8 @@ function parseFlatYaml(text) {
       const lower = value.toLowerCase();
       if (lower === "true") out.disabled = true;
       else if (lower === "false") out.disabled = false;
-    } else if (key === "worker" && value.length > 0) {
-      out.worker = value;
+    } else if (key === "staff" && value.length > 0) {
+      out.staff = value;
     }
   }
   return out;
@@ -7812,7 +7813,7 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
   if (!targetExecutable) {
     throw new Error("dispatchJobFileTicks: `with.targetExecutable` is required");
   }
-  const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
+  const jobsDir = String(args?.jobsDir ?? ".kody/duties");
   const scriptedExecutable = String(args?.scriptedExecutable ?? "job-tick-scripted");
   const slugArg = String(args?.slugArg ?? "job");
   const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
@@ -7839,12 +7840,12 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
         results.push({ slug, exitCode: 0, skipped: true, reason: "disabled" });
         continue;
       }
-      if (!frontmatter.worker || frontmatter.worker.trim().length === 0) {
+      if (!frontmatter.staff || frontmatter.staff.trim().length === 0) {
         process.stderr.write(
-          `[jobs] \u23ED  skip ${slug}: no worker assigned (add 'worker: <slug>' frontmatter)
+          `[jobs] \u23ED  skip ${slug}: no staff assigned (add 'staff: <slug>' frontmatter)
 `
         );
-        results.push({ slug, exitCode: 0, skipped: true, reason: "no worker assigned" });
+        results.push({ slug, exitCode: 0, skipped: true, reason: "no staff assigned" });
         continue;
       }
       const decision = await decideShouldFire(frontmatter.every, slug, backend, now);
@@ -8384,6 +8385,7 @@ var finalizeGoal = async (ctx) => {
 `);
     }
   }
+  const leafIssues = new Set(prIssueNumbers(leaf));
   const openIssues = (goal.childTasks ?? []).filter((t) => t.state === "OPEN");
   for (const t of openIssues) {
     if (uncarriedIssues.has(t.number)) {
@@ -8393,6 +8395,18 @@ var finalizeGoal = async (ctx) => {
       );
       continue;
     }
+    if (leafIssues.has(t.number)) {
+      process.stdout.write(
+        `[goal-tick] leaving leaf task issue #${t.number} OPEN as the review anchor for deliverable PR #${leaf.number}
+`
+      );
+      commentOnIssue(
+        t.number,
+        `_Goal \`${goal.id}\` finalized \u2014 this task's PR #${leaf.number} (open against \`${goal.defaultBranch}\`) is the goal's single deliverable and carries every task's changes. This issue stays open as the review anchor; merge PR #${leaf.number} to ship._`,
+        ctx.cwd
+      );
+      continue;
+    }
     process.stdout.write(`[goal-tick] closing task issue #${t.number} (goal finalized \u2014 carried by PR #${leaf.number})
 `);
     const closed = closeIssue(
@@ -9040,6 +9054,13 @@ function qualityCommandsFor(pm) {
     testUnit: `${pm} test`
   };
 }
+function schemaUrlFromPkg() {
+  const fallback = "https://raw.githubusercontent.com/aharonyaircohen/kody-engine/main/kody.config.schema.json";
+  const repoUrl = package_default.repository?.url;
+  const m = repoUrl?.match(/github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?$/) ?? null;
+  if (!m) return fallback;
+  return `https://raw.githubusercontent.com/${m[1]}/${m[2]}/main/kody.config.schema.json`;
+}
 function detectOwnerRepo(cwd) {
   let url;
   try {
@@ -9057,7 +9078,7 @@ function detectOwnerRepo(cwd) {
 }
 function makeConfig(pm, ownerRepo, defaultBranch2) {
   return {
-    $schema: "https://raw.githubusercontent.com/aharonyaircohen/kody-engine/main/kody.config.schema.json",
+    $schema: schemaUrlFromPkg(),
     quality: qualityCommandsFor(pm),
     git: { defaultBranch: defaultBranch2 },
     github: {
@@ -9184,10 +9205,10 @@ function performInit(cwd, force) {
   }
   const builtinJobs = listBuiltinJobs();
   if (builtinJobs.length > 0) {
-    const jobsDir = path29.join(cwd, ".kody", "jobs");
+    const jobsDir = path29.join(cwd, ".kody", "duties");
     fs31.mkdirSync(jobsDir, { recursive: true });
     for (const job of builtinJobs) {
-      const rel = path29.join(".kody", "jobs", `${job.slug}.md`);
+      const rel = path29.join(".kody", "duties", `${job.slug}.md`);
       const target = path29.join(cwd, rel);
       if (fs31.existsSync(target) && !force) {
         skipped.push(rel);
@@ -9461,8 +9482,8 @@ var loadIssueStateComment = async (ctx, _profile, args) => {
 import * as fs33 from "fs";
 import * as path31 from "path";
 var loadJobFromFile = async (ctx, _profile, args) => {
-  const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
-  const workersDir = String(args?.workersDir ?? ".kody/workers");
+  const jobsDir = String(args?.jobsDir ?? ".kody/duties");
+  const workersDir = String(args?.workersDir ?? ".kody/staff");
   const slugArg = String(args?.slugArg ?? "job");
   const slug = String(ctx.args[slugArg] ?? "").trim();
   if (!slug) {
@@ -9474,14 +9495,14 @@ var loadJobFromFile = async (ctx, _profile, args) => {
   }
   const raw = fs33.readFileSync(absPath, "utf-8");
   const { title, body } = parseJobFile(raw, slug);
-  const workerSlug = (splitFrontmatter2(raw).frontmatter.worker ?? "").trim();
+  const workerSlug = (splitFrontmatter2(raw).frontmatter.staff ?? "").trim();
   let workerTitle = "";
   let workerPersona = "";
   if (workerSlug) {
     const workerPath = path31.join(ctx.cwd, workersDir, `${workerSlug}.md`);
     if (!fs33.existsSync(workerPath)) {
       throw new Error(
-        `loadJobFromFile: job '${slug}' declares worker '${workerSlug}' but ${workerPath} does not exist`
+        `loadJobFromFile: duty '${slug}' declares staff '${workerSlug}' but ${workerPath} does not exist`
       );
     }
     const workerRaw = fs33.readFileSync(workerPath, "utf-8");
@@ -9525,7 +9546,7 @@ function humanizeSlug(slug) {
 import * as fs34 from "fs";
 import * as path32 from "path";
 var loadWorkerAdhoc = async (ctx, _profile, args) => {
-  const workersDir = String(args?.workersDir ?? ".kody/workers");
+  const workersDir = String(args?.workersDir ?? ".kody/staff");
   const workerSlug = String(ctx.args.worker ?? "").trim();
   if (!workerSlug) {
     throw new Error("loadWorkerAdhoc: ctx.args.worker must be a non-empty slug");
@@ -10989,7 +11010,7 @@ import * as fs37 from "fs";
 import * as path35 from "path";
 var runTickScript = async (ctx, _profile, args) => {
   ctx.skipAgent = true;
-  const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
+  const jobsDir = String(args?.jobsDir ?? ".kody/duties");
   const slugArg = String(args?.slugArg ?? "job");
   const fenceLabel = String(args?.fenceLabel ?? "kody-job-next-state");
   const slug = String(ctx.args[slugArg] ?? "").trim();
@@ -12023,7 +12044,7 @@ var writeJobStateFile = async (ctx, _profile, _agentResult, args) => {
       lastFiredAt: (/* @__PURE__ */ new Date()).toISOString()
     }
   };
-  const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
+  const jobsDir = String(args?.jobsDir ?? ".kody/duties");
   const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
   await backend.save(loaded, stamped);
 };

package/dist/executables/job-scheduler/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "job-scheduler",
   "role": "watch",
-  "describe": "Scheduled: for every job file under .kody/jobs/, invoke job-tick once. No agent on the scheduler itself.",
+  "describe": "Scheduled: for every duty file under .kody/duties/, invoke job-tick once. No agent on the scheduler itself.",
   "kind": "scheduled",
   "schedule": "*/5 * * * *",
   "inputs": [],
@@ -38,7 +38,7 @@
       {
         "script": "dispatchJobFileTicks",
         "with": {
-          "jobsDir": ".kody/jobs",
+          "jobsDir": ".kody/duties",
           "targetExecutable": "job-tick",
           "slugArg": "job"
         }

package/dist/executables/job-tick/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "job-tick",
   "role": "primitive",
-  "describe": "One classifier tick for one job file: read intent + state, decide and execute via gh, emit next state.",
+  "describe": "One classifier tick for one duty file: read intent + state, decide and execute via gh, emit next state.",
   "kind": "oneshot",
   "inputs": [
     {
@@ -9,7 +9,7 @@
       "flag": "--job",
       "type": "string",
       "required": true,
-      "describe": "Job slug — basename (without .md) of the file under .kody/jobs/."
+      "describe": "Duty slug — basename (without .md) of the file under .kody/duties/."
     },
     {
       "name": "force",
@@ -51,7 +51,7 @@
       {
         "script": "loadJobFromFile",
         "with": {
-          "jobsDir": ".kody/jobs",
+          "jobsDir": ".kody/duties",
           "slugArg": "job"
         }
       },

package/dist/executables/job-tick-scripted/profile.json

@@ -9,7 +9,7 @@
       "flag": "--job",
       "type": "string",
       "required": true,
-      "describe": "Job slug — basename (without .md) of the file under .kody/jobs/."
+      "describe": "Duty slug — basename (without .md) of the file under .kody/duties/."
     },
     {
       "name": "force",
@@ -51,7 +51,7 @@
       {
         "script": "runTickScript",
         "with": {
-          "jobsDir": ".kody/jobs",
+          "jobsDir": ".kody/duties",
           "slugArg": "job",
           "fenceLabel": "kody-job-next-state"
         }
@@ -61,7 +61,7 @@
       {
         "script": "writeJobStateFile",
         "with": {
-          "jobsDir": ".kody/jobs"
+          "jobsDir": ".kody/duties"
         }
       }
     ]

package/dist/executables/worker-ask/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "worker-ask",
   "role": "primitive",
-  "describe": "Ad-hoc one-shot: run a worker persona against an inline message + context (from a dashboard @worker mention). Stateless — no job file, no state, no commit. Replies into the originating thread.",
+  "describe": "Ad-hoc one-shot: run a staff persona against an inline message + context (from a dashboard @staff mention). Stateless — no duty file, no state, no commit. Replies into the originating thread.",
   "kind": "oneshot",
   "inputs": [
     {
@@ -9,7 +9,7 @@
       "flag": "--worker",
       "type": "string",
       "required": true,
-      "describe": "Worker slug — basename (without .md) of the persona file under .kody/workers/."
+      "describe": "Staff slug — basename (without .md) of the persona file under .kody/staff/."
     },
     {
       "name": "thread",
@@ -58,7 +58,7 @@
       {
         "script": "loadWorkerAdhoc",
         "with": {
-          "workersDir": ".kody/workers"
+          "workersDir": ".kody/staff"
         }
       },
       {

package/kody.config.schema.json

@@ -393,7 +393,7 @@
     },
     "jobs": {
       "type": "object",
-      "description": "File-based job configuration. Jobs are long-running scheduled executables defined under .kody/jobs/<slug>.md.",
+      "description": "File-based job configuration. Jobs are long-running scheduled executables defined under .kody/duties/<slug>.md.",
       "properties": {
         "stateBackend": {
           "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.121",
+  "version": "0.4.122",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -21,6 +21,7 @@
     "check:modularity": "tsx scripts/check-script-modularity.ts",
     "pretest": "pnpm check:modularity",
     "test": "vitest run tests/unit tests/int --coverage",
+    "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",