@kody-ade/kody-engine 0.4.477 → 0.4.479

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.477",
+      version: "0.4.479",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -447,6 +447,20 @@ function parseReleaseConfig(raw) {
   if (!raw || typeof raw !== "object") return void 0;
   const r = raw;
   const out = {};
+  if (r.version !== void 0) {
+    const version = recordValue(r.version);
+    const readCommand = typeof version?.readCommand === "string" ? version.readCommand.trim() : "";
+    const writeCommand = typeof version?.writeCommand === "string" ? version.writeCommand.trim() : "";
+    const files = Array.isArray(version?.files) ? version.files.filter(
+      (file) => typeof file === "string" && file.trim().length > 0
+    ).map((file) => file.trim()) : [];
+    if (!readCommand || !writeCommand || files.length === 0) {
+      throw new Error(
+        "kody.config.json: release.version requires readCommand, writeCommand, and files"
+      );
+    }
+    out.version = { readCommand, writeCommand, files: [...new Set(files)] };
+  }
   if (Array.isArray(r.versionFiles)) out.versionFiles = r.versionFiles.filter((f) => typeof f === "string");
   if (typeof r.publishCommand === "string") out.publishCommand = r.publishCommand;
   if (typeof r.notifyCommand === "string") out.notifyCommand = r.notifyCommand;
@@ -457,24 +471,36 @@ function parseReleaseConfig(raw) {
   if (typeof r.allowAdminMerge === "boolean") out.allowAdminMerge = r.allowAdminMerge;
   if (typeof r.releaseBranch === "string") out.releaseBranch = r.releaseBranch;
   if (typeof r.timeoutMs === "number" && r.timeoutMs > 0) out.timeoutMs = Math.floor(r.timeoutMs);
-  if (r.validation && typeof r.validation === "object") {
-    const validation = r.validation;
-    const workflow = typeof validation.workflow === "string" ? validation.workflow.trim() : "";
-    if (workflow) {
-      const inputs = validation.inputs && typeof validation.inputs === "object" ? Object.fromEntries(
-        Object.entries(
-          validation.inputs
-        ).filter(
-          (entry) => /^[a-z][a-z0-9_]*$/.test(entry[0]) && (typeof entry[1] === "string" || typeof entry[1] === "number" || typeof entry[1] === "boolean")
-        )
-      ) : void 0;
-      out.validation = {
-        workflow,
-        ...inputs && Object.keys(inputs).length > 0 ? { inputs } : {}
-      };
+  if (typeof r.productionDeployRequired === "boolean")
+    out.productionDeployRequired = r.productionDeployRequired;
+  out.validation = parseReleaseWorkflowRequest(r.validation, "validation");
+  out.deployment = parseReleaseWorkflowRequest(
+    r.deployment,
+    "deployment",
+    true
+  );
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function parseReleaseWorkflowRequest(raw, field, requiredWhenConfigured = false) {
+  if (raw === void 0) return void 0;
+  const request = recordValue(raw);
+  const workflow = typeof request?.workflow === "string" ? request.workflow.trim() : "";
+  if (!workflow) {
+    if (requiredWhenConfigured) {
+      throw new Error(`kody.config.json: release.${field}.workflow is required`);
     }
+    return void 0;
   }
-  return Object.keys(out).length > 0 ? out : void 0;
+  const rawInputs = recordValue(request?.inputs);
+  const inputs = rawInputs ? Object.fromEntries(
+    Object.entries(rawInputs).filter(
+      (entry) => /^[a-z][a-z0-9_]*$/.test(entry[0]) && (typeof entry[1] === "string" || typeof entry[1] === "number" || typeof entry[1] === "boolean")
+    )
+  ) : void 0;
+  return {
+    workflow,
+    ...inputs && Object.keys(inputs).length > 0 ? { inputs } : {}
+  };
 }
 function parseIssueContext(raw) {
   if (!raw || typeof raw !== "object") return void 0;
@@ -4241,6 +4267,56 @@ var init_agencyBoundaryEval = __esm({
   }
 });
 
+// src/scripts/capabilityExecutionEnvironment.ts
+function capabilityInputEnvironment(input) {
+  const environment = {
+    KODY_CAPABILITY_INPUT: JSON.stringify(input ?? null)
+  };
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    return environment;
+  }
+  for (const [name, value] of Object.entries(input)) {
+    if (value === void 0 || value === null) continue;
+    const key = environmentKey(name);
+    environment[`KODY_ARG_${key}`] = typeof value === "string" ? value : JSON.stringify(value);
+  }
+  return environment;
+}
+function capabilityConfigEnvironment(config) {
+  if (!config || typeof config !== "object" || Array.isArray(config)) return {};
+  return Object.fromEntries(
+    flattenConfig(config).map(([key, value]) => [
+      `KODY_CFG_${key}`,
+      value
+    ])
+  );
+}
+function flattenConfig(config, prefix = "") {
+  const entries = [];
+  for (const [name, value] of Object.entries(config)) {
+    if (value === null || value === void 0) continue;
+    const key = prefix ? `${prefix}_${environmentKey(name)}` : environmentKey(name);
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      entries.push([key, String(value)]);
+    } else if (Array.isArray(value)) {
+      entries.push([key, JSON.stringify(value)]);
+    } else if (typeof value === "object") {
+      entries.push(
+        ...flattenConfig(value, key)
+      );
+    }
+  }
+  return entries;
+}
+function environmentKey(name) {
+  return name.toUpperCase().replace(/[^A-Z0-9]+/g, "_");
+}
+var init_capabilityExecutionEnvironment = __esm({
+  "src/scripts/capabilityExecutionEnvironment.ts"() {
+    "use strict";
+  }
+});
+
 // src/agency/capability-contract-validation.ts
 import Ajv from "ajv";
 function validateCapabilityContractValue(boundary, schema, value) {
@@ -15533,18 +15609,6 @@ function scalar(value) {
   if (/^-?\d+$/.test(value)) return Number(value);
   return value;
 }
-function capabilityEnvironment(input) {
-  const environment = {
-    KODY_CAPABILITY_INPUT: JSON.stringify(input ?? null)
-  };
-  if (!input || typeof input !== "object" || Array.isArray(input)) return environment;
-  for (const [name, value] of Object.entries(input)) {
-    if (value === void 0 || value === null) continue;
-    const key = name.toUpperCase().replace(/[^A-Z0-9]+/g, "_");
-    environment[`KODY_ARG_${key}`] = typeof value === "string" ? value : JSON.stringify(value);
-  }
-  return environment;
-}
 function listFiles(root) {
   if (!fs43.existsSync(root)) return [];
   const files = [];
@@ -15566,6 +15630,7 @@ var init_loadSimpleCapability = __esm({
     init_capability_contract_validation();
     init_capabilityFolders();
     init_definition_paths();
+    init_capabilityExecutionEnvironment();
     loadSimpleCapability = async (ctx) => {
       const slug = typeof ctx.args.capability === "string" ? ctx.args.capability.trim() : "";
       if (!/^[a-z][a-z0-9-]*$/.test(slug)) {
@@ -15594,7 +15659,10 @@ var init_loadSimpleCapability = __esm({
       if (capability.config.outputSchema) {
         ctx.data.capabilityOutputSchema = capability.config.outputSchema;
       }
-      ctx.data.capabilityEnvironment = capabilityEnvironment(input);
+      ctx.data.capabilityEnvironment = {
+        ...capabilityInputEnvironment(input),
+        ...capabilityConfigEnvironment(ctx.config)
+      };
       ctx.data.prompt = [
         capability.rawBody.trim(),
         "",
@@ -19096,7 +19164,7 @@ var init_runSimpleCapabilityScript = __esm({
         ctx.output.reason = 'Script-backed Capability requires a regular "tools/run.sh" entrypoint';
         return;
       }
-      const capabilityEnvironment2 = isStringRecord(ctx.data.capabilityEnvironment) ? ctx.data.capabilityEnvironment : {};
+      const capabilityEnvironment = isStringRecord(ctx.data.capabilityEnvironment) ? ctx.data.capabilityEnvironment : {};
       const capabilitySecrets = declaredSecrets(ctx.data.capabilitySecretNames, process.env);
       const timeoutMs = typeof ctx.data.capabilityScriptTimeoutMs === "number" ? ctx.data.capabilityScriptTimeoutMs : DEFAULT_SCRIPT_TIMEOUT_MS;
       const result = spawnSync3("bash", [scriptPath], {
@@ -19104,7 +19172,7 @@ var init_runSimpleCapabilityScript = __esm({
         env: {
           ...buildTickChildEnv(process.env, false),
           ...capabilitySecrets,
-          ...capabilityEnvironment2
+          ...capabilityEnvironment
         },
         stdio: ["ignore", "pipe", "pipe"],
         encoding: "utf-8",
@@ -21597,13 +21665,8 @@ async function runShellEntry(entry, ctx, profile) {
     `kody-shell-output-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
   );
   const env = { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", KODY_OUTPUT: outputFile };
-  for (const [k, v] of Object.entries(ctx.args)) {
-    if (v === void 0 || v === null) continue;
-    env[`KODY_ARG_${envKey(k)}`] = String(v);
-  }
-  for (const [k, v] of flattenConfig(ctx.config)) {
-    env[`KODY_CFG_${k}`] = v;
-  }
+  Object.assign(env, capabilityInputEnvironment(ctx.args));
+  Object.assign(env, capabilityConfigEnvironment(ctx.config));
   const timeoutMs = resolveShellTimeoutMs(entry);
   const child = spawn8("bash", [shellPath, ...positional], {
     cwd: ctx.cwd,
@@ -21704,28 +21767,11 @@ async function runShellEntry(entry, ctx, profile) {
     }
   }
 }
-function envKey(name) {
-  return name.toUpperCase().replace(/-/g, "_");
-}
-function flattenConfig(obj, prefix = "") {
-  const out = [];
-  for (const [k, v] of Object.entries(obj)) {
-    if (v === null || v === void 0) continue;
-    const key = prefix ? `${prefix}_${envKey(k)}` : envKey(k);
-    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
-      out.push([key, String(v)]);
-    } else if (Array.isArray(v)) {
-      out.push([key, JSON.stringify(v)]);
-    } else if (typeof v === "object") {
-      out.push(...flattenConfig(v, key));
-    }
-  }
-  return out;
-}
 var MUTATING_POSTFLIGHTS, SHELL_MARKER_RE, TASK_ARTIFACT_WRITE_TOOLS, MAX_CHAIN_HOPS, DEFAULT_SHELL_TIMEOUT_MS, SIGKILL_GRACE_MS;
 var init_executor = __esm({
   "src/executor.ts"() {
     "use strict";
+    init_capabilityExecutionEnvironment();
     init_capability_contract_validation();
     init_agent();
     init_agents();

package/kody.config.schema.json

@@ -140,6 +140,21 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
+        "version": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["readCommand", "writeCommand", "files"],
+          "properties": {
+            "readCommand": { "type": "string", "minLength": 1 },
+            "writeCommand": { "type": "string", "minLength": 1 },
+            "files": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
         "versionFiles": {
           "type": "array",
           "items": { "type": "string" }
@@ -147,6 +162,9 @@
         "publishCommand": { "type": "string" },
         "notifyCommand": { "type": "string" },
         "e2eCommand": { "type": "string" },
+        "productionUrl": { "type": "string" },
+        "smokeCommand": { "type": "string" },
+        "productionDeployRequired": { "type": "boolean" },
         "draftRelease": { "type": "boolean" },
         "releaseBranch": { "type": "string" },
         "allowAdminMerge": { "type": "boolean" },
@@ -170,6 +188,26 @@
             }
           }
         },
+        "deployment": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["workflow"],
+          "properties": {
+            "workflow": {
+              "type": "string",
+              "minLength": 1
+            },
+            "inputs": {
+              "type": "object",
+              "propertyNames": {
+                "pattern": "^[a-z][a-z0-9_]*$"
+              },
+              "additionalProperties": {
+                "type": ["string", "number", "boolean"]
+              }
+            }
+          }
+        },
         "timeoutMs": {
           "type": "integer",
           "minimum": 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.477",
+  "version": "0.4.479",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,29 +12,6 @@
     "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",
-    "clean:dist": "node scripts/clean-dist.cjs",
-    "build": "pnpm clean:dist && 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",
-    "posttest": "tsx scripts/check-coverage-floor.ts",
-    "test:smoke": "vitest run tests/smoke --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write",
-    "verify:package": "node scripts/verify-package-tarball.cjs",
-    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner",
-    "prepublishOnly": "pnpm typecheck && vitest run tests/unit tests/int --no-coverage && pnpm test:runtime-services && pnpm build && pnpm verify:package"
-  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -61,5 +38,27 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
-}
+  "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",
+    "clean:dist": "node scripts/clean-dist.cjs",
+    "build": "pnpm clean:dist && 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",
+    "posttest": "tsx scripts/check-coverage-floor.ts",
+    "test:smoke": "vitest run tests/smoke --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "verify:package": "node scripts/verify-package-tarball.cjs",
+    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
+  }
+}