@kody-ade/kody-engine 0.4.233 → 0.4.234

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.233",
+      version: "0.4.234",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -3121,6 +3121,7 @@ function loadProfile(profilePath) {
       action: typeof r.action === "string" && r.action.trim() ? r.action.trim() : void 0,
       executable: execRef,
       describe: typeof r.describe === "string" ? r.describe : base.describe,
+      capabilityKind: parseCapabilityKind(profilePath, r.capabilityKind) ?? base.capabilityKind,
       staff: typeof r.staff === "string" && r.staff.trim() ? r.staff.trim() : base.staff,
       every: typeof r.every === "string" && r.every.trim() ? r.every.trim() : void 0,
       dutyTools: parseStringArray(r.dutyTools ?? r.tools) ?? base.dutyTools,
@@ -3165,6 +3166,7 @@ function loadProfile(profilePath) {
     action: typeof r.action === "string" && r.action.trim() ? r.action.trim() : void 0,
     executable: void 0,
     describe: typeof r.describe === "string" ? r.describe : "",
+    capabilityKind: parseCapabilityKind(profilePath, r.capabilityKind),
     // Optional persona to run as. Empty/blank string → undefined (no persona).
     staff: typeof r.staff === "string" && r.staff.trim() ? r.staff.trim() : void 0,
     // Optional recurrence cadence (scheduled duty). Blank → undefined (on-demand).
@@ -3255,6 +3257,13 @@ function requireString(p, r, key) {
   }
   return v;
 }
+function parseCapabilityKind(p, raw) {
+  if (raw === void 0 || raw === null || raw === "") return void 0;
+  if (typeof raw !== "string" || !VALID_CAPABILITY_KINDS.has(raw)) {
+    throw new ProfileError(p, `"capabilityKind" must be one of: observe | act | verify`);
+  }
+  return raw;
+}
 function parseStringArray(raw) {
   if (!Array.isArray(raw)) return void 0;
   const values = raw.map((t) => String(t).trim()).filter(Boolean);
@@ -3331,6 +3340,17 @@ function parseCliTools(p, raw) {
   if (!Array.isArray(raw)) throw new ProfileError(p, `"cliTools" must be an array or absent`);
   const out = [];
   for (const [i, item] of raw.entries()) {
+    if (typeof item === "string" && item.trim()) {
+      const name = item.trim();
+      out.push({
+        name,
+        install: { required: false, checkCommand: `command -v ${name}` },
+        verify: `command -v ${name}`,
+        usage: "",
+        allowedUses: []
+      });
+      continue;
+    }
     if (!item || typeof item !== "object") {
       throw new ProfileError(p, `cliTools[${i}] must be an object`);
     }
@@ -3490,7 +3510,7 @@ function parseScriptList(p, key, raw) {
   }
   return out;
 }
-var VALID_INPUT_TYPES, VALID_PERMISSION_MODES, VALID_ROLES, VALID_CONTAINER_CHILD_TARGETS, VALID_PHASES, KNOWN_PROFILE_KEYS;
+var VALID_INPUT_TYPES, VALID_PERMISSION_MODES, VALID_ROLES, VALID_CONTAINER_CHILD_TARGETS, VALID_PHASES, VALID_CAPABILITY_KINDS, KNOWN_PROFILE_KEYS;
 var init_profile = __esm({
   "src/profile.ts"() {
     "use strict";
@@ -3506,6 +3526,7 @@ var init_profile = __esm({
     VALID_ROLES = /* @__PURE__ */ new Set(["primitive", "orchestrator", "container", "watch", "utility"]);
     VALID_CONTAINER_CHILD_TARGETS = /* @__PURE__ */ new Set(["issue", "pr"]);
     VALID_PHASES = /* @__PURE__ */ new Set(["research", "planning", "implementing", "reviewing", "shipped", "failed", "idle"]);
+    VALID_CAPABILITY_KINDS = /* @__PURE__ */ new Set(["observe", "act", "verify"]);
     KNOWN_PROFILE_KEYS = /* @__PURE__ */ new Set([
       "name",
       "action",
@@ -3515,6 +3536,7 @@ var init_profile = __esm({
       "dutyTools",
       "tools",
       "mentions",
+      "capabilityKind",
       "stage",
       "readsFrom",
       "writesTo",

package/dist/executables/types.ts

@@ -15,6 +15,8 @@ import type { Phase } from "../state.js"
 // Profile shape (mirrors the JSON on disk).
 // ────────────────────────────────────────────────────────────────────────────
 
+export type CapabilityKind = "observe" | "act" | "verify"
+
 export interface Profile {
   name: string
   /**
@@ -33,6 +35,11 @@ export interface Profile {
    */
   staff?: string
   describe: string
+  /**
+   * Author-facing capability promise for a duty/executable. This classifies the
+   * shape of result it should return; it does not change executor control flow.
+   */
+  capabilityKind?: CapabilityKind
   /**
    * Semantic role — what this executable IS, not when it runs.
    *   - primitive:    single-step agent executor (flow → agent → verify → commit → PR).
@@ -390,6 +397,58 @@ export interface OutputContract {
   }
 }
 
+export interface CapabilityAlert {
+  level?: "info" | "warning" | "error"
+  message: string
+}
+
+export interface CapabilitySuggestedAction {
+  action: string
+  args?: Record<string, unknown>
+  reason?: string
+}
+
+export interface CapabilityResourceRef {
+  type: string
+  id?: string | number
+  number?: number
+  url?: string
+  name?: string
+}
+
+export interface CapabilityEvidenceItem {
+  source?: string
+  message: string
+  url?: string
+}
+
+export interface ObserveResult {
+  kind: "observe"
+  facts?: Record<string, unknown>
+  alerts?: CapabilityAlert[]
+  suggestedActions?: CapabilitySuggestedAction[]
+  evidence?: Record<string, unknown>
+}
+
+export interface ActResult {
+  kind: "act"
+  status: "created" | "changed" | "triggered" | "skipped" | "failed"
+  changedResources?: CapabilityResourceRef[]
+  createdResources?: CapabilityResourceRef[]
+  actionResult?: Record<string, unknown>
+  evidence?: Record<string, unknown>
+}
+
+export interface VerifyResult {
+  kind: "verify"
+  passed: boolean
+  evidence?: CapabilityEvidenceItem[]
+  blockers?: string[]
+  facts?: Record<string, unknown>
+}
+
+export type CapabilityResult = ObserveResult | ActResult | VerifyResult
+
 // ────────────────────────────────────────────────────────────────────────────
 // Run-time context passed to every script.
 // ────────────────────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.233",
+  "version": "0.4.234",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,26 @@
     "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",
+    "posttest": "tsx scripts/check-coverage-floor.ts",
+    "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",
+    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -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 build"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -35,24 +55,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 --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:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write",
-    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
-  }
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
+}