@kody-ade/kody-engine 0.4.205 → 0.4.206

package/dist/executables/types.ts

@@ -42,6 +42,14 @@ export interface Profile {
    * executables differently by category.
    */
   role: "primitive" | "orchestrator" | "container" | "watch" | "utility"
+  /**
+   * A duty is the WHY/WHEN layer: it references an executable (the HOW) by name
+   * rather than embedding it. When set, the loader resolves that executable's
+   * full profile (claudeCode/scripts/prompt/agents) and overlays this duty's
+   * name + staff (WHO) + every (WHEN) + mentions. Absent → this profile IS an
+   * executable (defines its own how). executable = how, staff = who, duty = why.
+   */
+  executable?: string
   /**
    * Execution model — orthogonal to `role`.
    * `oneshot` (default): single invocation on demand.
@@ -429,3 +437,43 @@ export type PostflightScript = (
 
 /** A registered script may be either phase; registry looks it up by name. */
 export type AnyScript = PreflightScript | PostflightScript
+
+// ────────────────────────────────────────────────────────────────────────────
+// Job — the unified execution unit (Phase 1 of the job-model migration).
+//
+// A Job is the single thing the engine executes, regardless of how it was
+// triggered. It REFERENCES the reusable nouns — `executable` (how), `persona`
+// (who), `duty` (why, by slug) — and OWNS its `schedule` (when). Two flavors:
+//   - "instant"   — run once now (an `@kody <verb>` comment or a manual dispatch)
+//   - "scheduled" — fired on `schedule` (cron) by the tick path
+//
+// Fields are optional-heavy on purpose: a comment-minted instant job carries
+// `executable` + inline `why`; a cron-minted scheduled job carries `duty` +
+// `schedule` + `persona`. `runJob` (src/job.ts) lowers a Job onto the existing
+// executor; nothing mints Jobs yet — this is an additive seam.
+// ────────────────────────────────────────────────────────────────────────────
+
+export type JobFlavor = "instant" | "scheduled"
+
+export interface Job {
+  /** How: executable (profile) name to run. 0–1; omitted when intent is
+   *  agent-only with no specific verb. */
+  executable?: string
+  /** Why (referenced): a duty slug whose intent drives the run. */
+  duty?: string
+  /** Why (inline): free-text intent, e.g. an `@kody` comment body. Untrusted —
+   *  fenced where it enters a prompt, not here. */
+  why?: string
+  /** Who: a staff persona slug. */
+  persona?: string
+  /** When: cron expression. Set for scheduled jobs, absent for instant. */
+  schedule?: string
+  /** The issue/PR number this job acts on, when applicable. */
+  target?: number
+  /** Args passed through to the executable (mirrors DispatchResult.cliArgs). */
+  cliArgs: Record<string, unknown>
+  /** Run once now ("instant") or on the schedule ("scheduled"). */
+  flavor: JobFlavor
+  /** Manual force-run (bypass cadence) for a scheduled job. */
+  force?: boolean
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.205",
+  "version": "0.4.206",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",

package/dist/executables/brain-serve/profile.json

@@ -1,28 +0,0 @@
-{
-  "name": "brain-serve",
-  "role": "utility",
-  "describe": "Long-lived HTTP server that wraps the Kody chat loop and speaks the Brain SSE protocol. Listens on $PORT (default 8080); auth via $BRAIN_API_KEY. Pairs with the Kody-Dashboard /api/kody/chat/brain proxy. Usage: `kody brain-serve` (runs until SIGINT/SIGTERM).",
-  "inputs": [],
-  "claudeCode": {
-    "model": "inherit",
-    "permissionMode": "acceptEdits",
-    "maxTurns": null,
-    "systemPromptAppend": null,
-    "tools": [],
-    "hooks": [],
-    "skills": [],
-    "commands": [],
-    "subagents": [],
-    "plugins": [],
-    "mcpServers": []
-  },
-  "cliTools": [],
-  "scripts": {
-    "preflight": [
-      {
-        "script": "brainServe"
-      }
-    ],
-    "postflight": []
-  }
-}

package/dist/executables/pool-serve/profile.json

@@ -1,28 +0,0 @@
-{
-  "name": "pool-serve",
-  "role": "utility",
-  "describe": "Always-on warm-pool owner, co-located on the kody-litellm machine. Supervises the LiteLLM proxy and serves the pool API the dashboard calls to claim a pre-booted, frozen runner. Listens on $POOL_API_PORT (default 4100); auth via $POOL_API_KEY (derived from $KODY_MASTER_KEY). Usage: `kody pool-serve`.",
-  "inputs": [],
-  "claudeCode": {
-    "model": "inherit",
-    "permissionMode": "acceptEdits",
-    "maxTurns": null,
-    "systemPromptAppend": null,
-    "tools": [],
-    "hooks": [],
-    "skills": [],
-    "commands": [],
-    "subagents": [],
-    "plugins": [],
-    "mcpServers": []
-  },
-  "cliTools": [],
-  "scripts": {
-    "preflight": [
-      {
-        "script": "poolServe"
-      }
-    ],
-    "postflight": []
-  }
-}

package/dist/executables/runner-serve/profile.json

@@ -1,28 +0,0 @@
-{
-  "name": "runner-serve",
-  "role": "utility",
-  "describe": "Idle HTTP server for a warm-pool one-shot runner. Boots with no issue, listens on $PORT (default 8080), and on an authed POST /run (X-Api-Key/Bearer $RUNNER_API_KEY) clones the repo and runs `kody run --issue N`, then exits so Fly auto_destroy reclaims the machine. Usage: `kody runner-serve`.",
-  "inputs": [],
-  "claudeCode": {
-    "model": "inherit",
-    "permissionMode": "acceptEdits",
-    "maxTurns": null,
-    "systemPromptAppend": null,
-    "tools": [],
-    "hooks": [],
-    "skills": [],
-    "commands": [],
-    "subagents": [],
-    "plugins": [],
-    "mcpServers": []
-  },
-  "cliTools": [],
-  "scripts": {
-    "preflight": [
-      {
-        "script": "runnerServe"
-      }
-    ],
-    "postflight": []
-  }
-}

package/dist/executables/serve/profile.json

@@ -1,28 +0,0 @@
-{
-  "name": "serve",
-  "role": "utility",
-  "describe": "Start a LiteLLM proxy and optionally launch an editor pointed at it. Usage: `kody serve` (proxy only), `kody serve vscode`, `kody serve claude`. Long-lived — Ctrl+C to stop.",
-  "inputs": [],
-  "claudeCode": {
-    "model": "inherit",
-    "permissionMode": "acceptEdits",
-    "maxTurns": null,
-    "systemPromptAppend": null,
-    "tools": [],
-    "hooks": [],
-    "skills": [],
-    "commands": [],
-    "subagents": [],
-    "plugins": [],
-    "mcpServers": []
-  },
-  "cliTools": [],
-  "scripts": {
-    "preflight": [
-      {
-        "script": "serveFlow"
-      }
-    ],
-    "postflight": []
-  }
-}