@kody-ade/kody-engine 0.4.622 → 0.4.624

package/README.md

@@ -109,6 +109,16 @@ fans out scheduled capabilities at runtime, so capability schedules never
 generate additional GitHub workflow files. Idempotent — pass `--force` to
 overwrite.
 
+Kody also discovers conventional package scripts (`typecheck`, `lint`,
+`test:unit` or `test`, and non-mutating format-check scripts). This means a
+repository that adds its application after Kody onboarding still receives a
+real verification gate. Explicit `quality` commands in `kody.config.json`
+always override discovery. See [Repository quality gates](docs/quality-gates.md).
+
+Lifecycle labels stay attached to both the task and its pull request. A green
+delivery is `kody:reviewing`; after that PR merges, Kody changes the PR and each
+linked closing issue to `kody:done`. See [Pull request lifecycle](docs/pull-request-lifecycle.md).
+
 Store model provider keys (for example `MINIMAX_API_KEY`) in the connected
 repository's Kody vault. GitHub Actions uses OIDC to request only the selected
 model key at runtime; user secrets are not copied into Actions. `KODY_TOKEN`

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.622",
+      version: "0.4.624",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       repository: {
@@ -183,6 +183,32 @@ var init_completionGuard = __esm({
 // src/config.ts
 import * as fs2 from "fs";
 import * as path3 from "path";
+function packageManagerFor(projectDir) {
+  if (fs2.existsSync(path3.join(projectDir, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs2.existsSync(path3.join(projectDir, "yarn.lock"))) return "yarn";
+  if (fs2.existsSync(path3.join(projectDir, "bun.lockb")) || fs2.existsSync(path3.join(projectDir, "bun.lock"))) return "bun";
+  return "npm";
+}
+function inferQualityCommands(projectDir) {
+  const empty = { typecheck: "", lint: "", format: "", testUnit: "" };
+  try {
+    const pkg = JSON.parse(fs2.readFileSync(path3.join(projectDir, "package.json"), "utf-8"));
+    const scripts = pkg.scripts ?? {};
+    const pm = packageManagerFor(projectDir);
+    const command = (names) => {
+      const name = names.find((candidate) => typeof scripts[candidate] === "string");
+      return name ? `${pm} run ${name}` : "";
+    };
+    return {
+      typecheck: command(["typecheck", "type-check", "check:types"]),
+      lint: command(["lint"]),
+      format: command(["format:check", "format-check", "prettier:check"]),
+      testUnit: command(["test:unit", "test"])
+    };
+  } catch {
+    return empty;
+  }
+}
 function parseReasoningEffort(raw) {
   if (!raw) return null;
   const v = raw.trim().toLowerCase();
@@ -285,6 +311,7 @@ function loadConfig(projectDir = process.cwd()) {
     throw new Error(`kody.config.json is invalid JSON: ${msg}`);
   }
   const quality = recordValue(raw.quality) ?? {};
+  const inferredQuality = inferQualityCommands(projectDir);
   const git5 = recordValue(raw.git) ?? {};
   const github = recordValue(raw.github) ?? {};
   const agent = recordValue(raw.agent) ?? {};
@@ -300,10 +327,10 @@ function loadConfig(projectDir = process.cwd()) {
   }
   return {
     quality: {
-      typecheck: typeof quality.typecheck === "string" ? quality.typecheck : "",
-      lint: typeof quality.lint === "string" ? quality.lint : "",
-      format: typeof quality.format === "string" ? quality.format : "",
-      testUnit: typeof quality.testUnit === "string" ? quality.testUnit : "",
+      typecheck: typeof quality.typecheck === "string" ? quality.typecheck : inferredQuality.typecheck,
+      lint: typeof quality.lint === "string" ? quality.lint : inferredQuality.lint,
+      format: typeof quality.format === "string" ? quality.format : inferredQuality.format,
+      testUnit: typeof quality.testUnit === "string" ? quality.testUnit : inferredQuality.testUnit,
       coverage: typeof quality.coverage === "string" ? quality.coverage : ""
     },
     git: {
@@ -15810,19 +15837,6 @@ var init_workflow_template = __esm({
 import { execFileSync as execFileSync14 } from "child_process";
 import * as fs40 from "fs";
 import * as path39 from "path";
-function detectPackageManager(cwd) {
-  if (fs40.existsSync(path39.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs40.existsSync(path39.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs40.existsSync(path39.join(cwd, "bun.lockb"))) return "bun";
-  return "npm";
-}
-function qualityCommandsFor(pm) {
-  return {
-    typecheck: `${pm} tsc --noEmit`,
-    lint: "",
-    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;
@@ -15845,10 +15859,10 @@ function detectOwnerRepo(cwd) {
   if (!m) return null;
   return { owner: m[1], repo: m[2] };
 }
-function makeConfig(pm, ownerRepo, defaultBranch) {
+function makeConfig(cwd, ownerRepo, defaultBranch) {
   return {
     $schema: schemaUrlFromPkg(),
-    quality: qualityCommandsFor(pm),
+    quality: inferQualityCommands(cwd),
     git: { defaultBranch },
     github: {
       owner: ownerRepo?.owner ?? "OWNER",
@@ -15882,14 +15896,13 @@ function defaultBranchFromGit(cwd) {
 function performInit(cwd, force) {
   const wrote = [];
   const skipped = [];
-  const pm = detectPackageManager(cwd);
   const ownerRepo = detectOwnerRepo(cwd);
   const defaultBranch = defaultBranchFromGit(cwd);
   const configPath = path39.join(cwd, "kody.config.json");
   if (fs40.existsSync(configPath) && !force) {
     skipped.push("kody.config.json");
   } else {
-    const cfg = makeConfig(pm, ownerRepo, defaultBranch);
+    const cfg = makeConfig(cwd, ownerRepo, defaultBranch);
     fs40.writeFileSync(configPath, `${JSON.stringify(cfg, null, 2)}
 `);
     wrote.push("kody.config.json");
@@ -15916,6 +15929,7 @@ var init_initFlow = __esm({
   "src/scripts/initFlow.ts"() {
     "use strict";
     init_package();
+    init_config();
     init_lifecycleLabels();
     init_workflow_template();
     initFlow = async (ctx) => {
@@ -26419,7 +26433,7 @@ async function hydrateDefinitionsFromEnv(cwd = process.cwd(), env = process.env)
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync24 } from "child_process";
-import * as fs56 from "fs";
+import * as fs57 from "fs";
 import * as path53 from "path";
 
 // src/app-auth.ts
@@ -26966,6 +26980,55 @@ function readRunRequestFromEnv(env = process.env) {
 // src/kody-cli.ts
 init_runtimePaths();
 init_stateWorkspace();
+
+// src/mergedPrLifecycle.ts
+init_lifecycleLabels();
+import * as fs56 from "fs";
+var DONE3 = {
+  label: "kody:done",
+  color: "0e8a16",
+  description: "kody: work complete"
+};
+function mergedKodyPullRequestTargets(event) {
+  if (!event || typeof event !== "object" || Array.isArray(event)) return null;
+  const root = event;
+  if (root.action !== "closed") return null;
+  const pr = root.pull_request;
+  if (!pr || typeof pr !== "object" || Array.isArray(pr)) return null;
+  const record2 = pr;
+  if (record2.merged !== true) return null;
+  const labels = Array.isArray(record2.labels) ? record2.labels : [];
+  const hasKodyLifecycleLabel = labels.some((label) => {
+    if (!label || typeof label !== "object" || Array.isArray(label)) return false;
+    const name = label.name;
+    return typeof name === "string" && name.startsWith("kody:");
+  });
+  if (!hasKodyLifecycleLabel) return null;
+  const prNumber = Number(record2.number ?? root.number ?? 0);
+  if (!Number.isInteger(prNumber) || prNumber <= 0) return null;
+  const body = typeof record2.body === "string" ? record2.body : "";
+  const issues = /* @__PURE__ */ new Set();
+  const closingReference = /\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s+#(\d+)\b/gi;
+  for (const match of body.matchAll(closingReference)) {
+    const issue2 = Number(match[1]);
+    if (Number.isInteger(issue2) && issue2 > 0 && issue2 !== prNumber) issues.add(issue2);
+  }
+  return { pr: prNumber, issues: [...issues] };
+}
+function finalizeMergedPullRequestEvent(event, cwd, writeLabel = setKodyLabel) {
+  const targets = mergedKodyPullRequestTargets(event);
+  if (!targets) return null;
+  writeLabel(targets.pr, DONE3, cwd);
+  for (const issue2 of targets.issues) writeLabel(issue2, DONE3, cwd);
+  return targets;
+}
+function readGitHubEvent(env = process.env) {
+  const eventPath = env.GITHUB_EVENT_PATH;
+  if (!eventPath || !fs56.existsSync(eventPath)) return null;
+  return JSON.parse(fs56.readFileSync(eventPath, "utf-8"));
+}
+
+// src/kody-cli.ts
 init_workflowDefinitions();
 var FAILED_DISPATCH_LABEL = {
   label: "kody:failed",
@@ -27172,10 +27235,10 @@ async function resolveAuthToken(env = process.env) {
   );
   return void 0;
 }
-function detectPackageManager2(cwd) {
-  if (fs56.existsSync(path53.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs56.existsSync(path53.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs56.existsSync(path53.join(cwd, "bun.lockb"))) return "bun";
+function detectPackageManager(cwd) {
+  if (fs57.existsSync(path53.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs57.existsSync(path53.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs57.existsSync(path53.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shouldChainScheduledWatch(match) {
@@ -27216,7 +27279,7 @@ function ensurePackageManagerInstalled(pm, cwd) {
   return shellOut("npm", ["install", "-g", spec], cwd);
 }
 function installDeps(pm, cwd) {
-  if (!fs56.existsSync(path53.join(cwd, "package.json"))) {
+  if (!fs57.existsSync(path53.join(cwd, "package.json"))) {
     process.stdout.write("\u2192 kody: no package.json found \u2014 skipping consumer dependency install\n");
     return 0;
   }
@@ -27282,8 +27345,8 @@ function postFailureTail(issueNumber, cwd, reason) {
   const logPath = lastRunLogPath(cwd);
   let tail = "";
   try {
-    if (fs56.existsSync(logPath)) {
-      const content = fs56.readFileSync(logPath, "utf-8");
+    if (fs57.existsSync(logPath)) {
+      const content = fs57.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -27330,6 +27393,24 @@ async function runCi(argv) {
   } catch (err) {
     earlyConfigError = err instanceof Error ? err : new Error(String(err));
   }
+  if (process.env.GITHUB_EVENT_NAME === "pull_request") {
+    try {
+      const finalized = finalizeMergedPullRequestEvent(readGitHubEvent(), cwd);
+      if (finalized) {
+        process.stdout.write(
+          `\u2192 kody: merged PR #${finalized.pr} finalized as done${finalized.issues.length > 0 ? ` (issues ${finalized.issues.map((n) => `#${n}`).join(", ")})` : ""}
+`
+        );
+        return 0;
+      }
+    } catch (err) {
+      process.stderr.write(
+        `[kody] failed to finalize merged PR lifecycle: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+      return 99;
+    }
+  }
   const dispatchCapabilitiesRoot = capabilitiesRoot(cwd);
   const autoFallback = !args.issueNumber ? autoDispatch({ config: earlyConfig, projectCapabilitiesRoot: dispatchCapabilitiesRoot }) : null;
   const eventName = process.env.GITHUB_EVENT_NAME;
@@ -27382,9 +27463,9 @@ async function runCi(argv) {
       forceRunCliArgs = { goal: envForceMessage };
     }
   }
-  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs56.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs57.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs56.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs57.readFileSync(dispatchEventPath, "utf-8"));
       const inputs = objectValue2(evt.inputs);
       const issueInput = parseInt(String(inputs?.issue_number ?? ""), 10);
       const sessionInput = String(inputs?.sessionId ?? "");
@@ -27472,7 +27553,7 @@ async function runCi(argv) {
       if (n > 0) process.stdout.write(`\u2192 kody: unpacked ${n} secret(s)
 `);
       await resolveAuthToken();
-      const pm = args.packageManager ?? detectPackageManager2(cwd);
+      const pm = args.packageManager ?? detectPackageManager(cwd);
       if (!args.skipInstall) {
         const code = installDeps(pm, cwd);
         if (code !== 0) {
@@ -27633,7 +27714,7 @@ ${CI_HELP}`);
 `);
     await resolveAuthToken();
     reactToTriggerComment(cwd);
-    const pm = args.packageManager ?? detectPackageManager2(cwd);
+    const pm = args.packageManager ?? detectPackageManager(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
     const buildOnly = dispatch2.implementation === "preview-build";
@@ -27714,7 +27795,7 @@ async function runScheduledFanOut(cwd, args, opts) {
     if (n > 0) process.stdout.write(`\u2192 kody: unpacked ${n} secret(s) from ALL_SECRETS
 `);
     await resolveAuthToken();
-    const pm = args.packageManager ?? detectPackageManager2(cwd);
+    const pm = args.packageManager ?? detectPackageManager(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
     if (!args.skipInstall) {
@@ -27800,7 +27881,7 @@ init_repoWorkspace();
 
 // src/scripts/brainTurnLog.ts
 init_runtimePaths();
-import * as fs57 from "fs";
+import * as fs58 from "fs";
 import * as path54 from "path";
 import posixPath4 from "path/posix";
 var live = /* @__PURE__ */ new Map();
@@ -27809,8 +27890,8 @@ function brainEventsFilePath(dir, chatId) {
 }
 function lastPersistedSeq(dir, chatId) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs57.existsSync(p)) return 0;
-  const lines = fs57.readFileSync(p, "utf-8").split("\n").filter(Boolean);
+  if (!fs58.existsSync(p)) return 0;
+  const lines = fs58.readFileSync(p, "utf-8").split("\n").filter(Boolean);
   if (lines.length === 0) return 0;
   try {
     return JSON.parse(lines[lines.length - 1]).seq || 0;
@@ -27820,9 +27901,9 @@ function lastPersistedSeq(dir, chatId) {
 }
 function readSince(dir, chatId, since) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs57.existsSync(p)) return [];
+  if (!fs58.existsSync(p)) return [];
   const out = [];
-  for (const line of fs57.readFileSync(p, "utf-8").split("\n")) {
+  for (const line of fs58.readFileSync(p, "utf-8").split("\n")) {
     if (!line) continue;
     try {
       const rec = JSON.parse(line);
@@ -27848,12 +27929,12 @@ function beginTurn(dir, chatId) {
   };
   live.set(chatId, state);
   const p = brainEventsFilePath(dir, chatId);
-  fs57.mkdirSync(path54.dirname(p), { recursive: true });
+  fs58.mkdirSync(path54.dirname(p), { recursive: true });
   return (event) => {
     state.seq += 1;
     const rec = { seq: state.seq, turn, ts: Date.now(), event };
     try {
-      fs57.appendFileSync(p, `${JSON.stringify(rec)}
+      fs58.appendFileSync(p, `${JSON.stringify(rec)}
 `);
     } catch (err) {
       process.stderr.write(
@@ -27892,7 +27973,7 @@ function endTurnIfUnterminated(dir, chatId, errMessage) {
     event: { type: "error", error: errMessage || "turn ended unexpectedly", chatId }
   };
   try {
-    fs57.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
+    fs58.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
 `);
   } catch {
   }
@@ -30556,7 +30637,7 @@ async function poolServe() {
 
 // src/servers/runner-serve.ts
 import { spawn as spawn10 } from "child_process";
-import * as fs58 from "fs";
+import * as fs59 from "fs";
 import { createServer as createServer6 } from "http";
 var DEFAULT_PORT2 = 8080;
 var DEFAULT_WORKDIR = "/workspace/repo";
@@ -30632,8 +30713,8 @@ async function defaultRunJob(job) {
   const workdir = process.env.RUNNER_WORKDIR ?? DEFAULT_WORKDIR;
   const branch = job.ref ?? "main";
   const authUrl = `https://x-access-token:${job.githubToken}@github.com/${job.repo}.git`;
-  fs58.rmSync(workdir, { recursive: true, force: true });
-  fs58.mkdirSync(workdir, { recursive: true });
+  fs59.rmSync(workdir, { recursive: true, force: true });
+  fs59.mkdirSync(workdir, { recursive: true });
   const allSecrets = typeof job.allSecrets === "string" ? job.allSecrets : JSON.stringify(job.allSecrets ?? {});
   const target = job.runRequest.target;
   const interactive = target.type === "chat";

package/kody.config.schema.json

@@ -11,7 +11,7 @@
     },
     "quality": {
       "type": "object",
-      "description": "Quality gate commands. Empty strings disable individual gates.",
+      "description": "Quality gate commands. Missing commands are inferred from conventional package.json scripts; explicit empty strings disable individual gates.",
       "additionalProperties": false,
       "properties": {
         "typecheck": { "type": "string", "default": "" },

package/package.json

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