@kody-ade/kody-engine 0.4.120 → 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.120",
+  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",
@@ -900,7 +900,8 @@ var package_default = {
     build: "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 --no-coverage",
+    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",
@@ -917,6 +918,7 @@ var package_default = {
   devDependencies: {
     "@biomejs/biome": "^2.4.12",
     "@types/node": "^22.5.4",
+    "@vitest/coverage-v8": "^4.1.4",
     tsup: "^8.5.1",
     tsx: "^4.21.0",
     typescript: "~5.7.0",
@@ -4727,6 +4729,13 @@ async function defaultRunJob(job) {
     REPO: job.repo,
     REF: branch,
     GITHUB_TOKEN: job.githubToken,
+    // GITHUB_REPOSITORY + GH_TOKEN are normally injected by GitHub Actions.
+    // The engine's interactive mode needs GITHUB_REPOSITORY to persist
+    // chat.ready / events to .kody/events via the Contents API (the durable
+    // signal the dashboard polls for readiness) — without it commitTurn bails
+    // and the session never appears "ready". GH_TOKEN auths the `gh` CLI.
+    GITHUB_REPOSITORY: job.repo,
+    GH_TOKEN: job.githubToken,
     // Issue mode bakes ISSUE_NUMBER → `kody run --issue N`. Interactive mode
     // leaves it empty and sets SESSION_ID so the engine boots a chat session.
     ISSUE_NUMBER: interactive ? "" : String(job.issueNumber),
@@ -4986,6 +4995,19 @@ var PoolManager = class {
       total: this.free.length + this.booting + this.claimsInFlight
     };
   }
+  /**
+   * Resize the warm target at runtime (per-repo, sourced from the repo's vault
+   * POOL_MIN). Raising it warms up immediately via refill; lowering it just
+   * stops topping up — surplus machines drain as they're claimed/auto-destroyed,
+   * never force-killed. No-op when unchanged or given a bad value.
+   */
+  setMin(min) {
+    if (!Number.isInteger(min) || min < 0) return;
+    if (min === this.deps.config.min) return;
+    this.deps.config.min = min;
+    this.log(`min set to ${min}`);
+    void this.refill();
+  }
   /**
    * Adopt existing pooled machines on owner (re)start: suspended ones become
    * free; anything else is left to finish/auto-destroy. Then refill to `min`.
@@ -5222,6 +5244,14 @@ async function readRepoSecrets(opts) {
 }
 
 // src/pool/registry.ts
+var POOL_MIN_VAULT_KEY = "POOL_MIN";
+var POOL_MIN_MAX = 10;
+function parsePoolMin(raw, dflt) {
+  if (raw == null || raw.trim() === "") return dflt;
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n < 0) return dflt;
+  return Math.min(n, POOL_MIN_MAX);
+}
 var PoolRegistry = class {
   constructor(cfg) {
     this.cfg = cfg;
@@ -5234,10 +5264,21 @@ var PoolRegistry = class {
       repo,
       name: "FLY_API_TOKEN"
     }));
+    this.resolvePoolMin = cfg.resolvePoolMin ?? (async (owner, repo) => parsePoolMin(
+      await readRepoSecret({
+        githubToken: cfg.githubToken,
+        masterKey: cfg.masterKey,
+        owner,
+        repo,
+        name: POOL_MIN_VAULT_KEY
+      }),
+      cfg.base.min
+    ));
   }
   cfg;
   pools = /* @__PURE__ */ new Map();
   resolveFlyToken;
+  resolvePoolMin;
   log;
   key(owner, repo) {
     return `${owner}/${repo}`.toLowerCase();
@@ -5258,10 +5299,16 @@ var PoolRegistry = class {
       this.log(`registry: ${repoTag} has no FLY_API_TOKEN \u2014 no pool`);
       return null;
     }
+    let min = this.cfg.base.min;
+    try {
+      min = await this.resolvePoolMin(owner, repo);
+    } catch (err) {
+      this.log(`registry: pool-min read failed for ${repoTag}, using default ${min}: ${err instanceof Error ? err.message : String(err)}`);
+    }
     const fly = new FlyClient({ token: flyToken, app: this.cfg.base.app });
     const pm = new PoolManager({
       fly,
-      config: { ...this.cfg.base, repoTag },
+      config: { ...this.cfg.base, repoTag, min },
       log: (m) => this.log(`[${repoTag}] ${m}`)
     });
     this.pools.set(repoTag, pm);
@@ -5279,7 +5326,10 @@ var PoolRegistry = class {
         owner,
         repo
       });
-      allSecrets = Object.fromEntries(Object.entries(vault).filter(([k]) => k !== "FLY_API_TOKEN"));
+      pm.setMin(parsePoolMin(vault[POOL_MIN_VAULT_KEY], this.cfg.base.min));
+      allSecrets = Object.fromEntries(
+        Object.entries(vault).filter(([k]) => k !== "FLY_API_TOKEN" && k !== POOL_MIN_VAULT_KEY)
+      );
     } catch (err) {
       this.log(`[${this.key(owner, repo)}] vault secrets read failed: ${err instanceof Error ? err.message : String(err)}`);
     }
@@ -5303,9 +5353,17 @@ var PoolRegistry = class {
   status(owner, repo) {
     return this.pools.get(this.key(owner, repo))?.status() ?? null;
   }
-  /** Resync every active repo pool (periodic self-heal). */
+  /** Resync every active repo pool (periodic self-heal). Also re-reads each
+   * repo's POOL_MIN from its vault so a dashboard resize warms up/drains within
+   * one tick — no owner restart needed. */
   async resyncAll() {
     for (const [repoTag, pm] of this.pools) {
+      const [owner, repo] = repoTag.split("/");
+      try {
+        pm.setMin(await this.resolvePoolMin(owner, repo));
+      } catch (err) {
+        this.log(`[${repoTag}] pool-min refresh: ${err instanceof Error ? err.message : String(err)}`);
+      }
       await pm.resync().catch((err) => this.log(`[${repoTag}] resync: ${err instanceof Error ? err.message : String(err)}`));
     }
   }
@@ -7394,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;
@@ -7755,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 });
@@ -7782,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);
@@ -8327,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)) {
@@ -8336,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(
@@ -8983,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 {
@@ -9000,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: {
@@ -9127,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);
@@ -9404,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) {
@@ -9417,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");
@@ -9468,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");
@@ -10932,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();
@@ -11966,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.120",
+  "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",
@@ -12,6 +12,24 @@
     "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",
+    "build": "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",
+    "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",
+    "prepublishOnly": "pnpm build"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -20,6 +38,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.12",
     "@types/node": "^22.5.4",
+    "@vitest/coverage-v8": "^4.1.4",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "~5.7.0",
@@ -33,21 +52,5 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "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",
-    "build": "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 --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"
-  }
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
+}