@kody-ade/kody-engine 0.4.204 → 0.4.206-next.0

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/dist/scripts/preview-build-templates/default-Dockerfile.preview.dev

@@ -0,0 +1,43 @@
+# syntax=docker/dockerfile:1.7
+#
+# Bundled default Dockerfile.preview — DEV-MODE variant.
+#
+# Previews run `next dev`, NOT `next build` + `next start`. This skips
+# the 5–10 min webpack production compile entirely. Trade-offs:
+#   - First request to each route lags 2–5s (compile-on-demand)
+#   - Subsequent requests are fast
+#   - Memory hungry at runtime (webpack alive)
+# For PR previews this is the right trade — reviewers click a handful
+# of pages, never need prod optimizations. Production stays on Vercel.
+#
+# When BASE_IMAGE is set, deps are inherited from the per-repo base
+# image; the install layer just verifies the lockfile.
+
+ARG BASE_IMAGE=node:22-alpine
+
+FROM ${BASE_IMAGE}
+WORKDIR /app
+
+RUN corepack enable 2>/dev/null || true
+
+COPY package.json pnpm-lock.yaml* package-lock.json* yarn.lock* ./
+RUN --mount=type=cache,id=kp-pnpm-store,target=/root/.local/share/pnpm/store \
+    --mount=type=cache,id=kp-npm-cache,target=/root/.npm \
+    if [ -f pnpm-lock.yaml ]; then pnpm install --frozen-lockfile --ignore-scripts; \
+    elif [ -f package-lock.json ]; then npm ci --ignore-scripts; \
+    elif [ -f yarn.lock ]; then yarn install --frozen-lockfile --ignore-scripts; \
+    else npm install --ignore-scripts; fi
+
+# Overwrite source files with the PR's version. node_modules and any
+# prior .next directory from the base image are preserved as warm
+# caches for the dev server's first compile.
+COPY . ./
+RUN mkdir -p public
+
+ENV NEXT_TELEMETRY_DISABLED=1
+ENV NODE_ENV=development
+ENV PORT=8080
+ENV HOSTNAME=0.0.0.0
+
+EXPOSE 8080
+CMD ["sh", "-c", "if [ -f pnpm-lock.yaml ]; then pnpm exec next dev -H 0.0.0.0 -p 8080; else npx next dev -H 0.0.0.0 -p 8080; fi"]

package/dist/scripts/preview-build-templates/default-Dockerfile.preview.prod

@@ -0,0 +1,40 @@
+# syntax=docker/dockerfile:1.7
+#
+# Bundled default Dockerfile.preview — PROD-MODE variant.
+#
+# Runs `next build` + `next start` — same shape as Vercel. Slower
+# first build (~5–10 min webpack) but instant per-page response.
+# Pick this mode for repos where reviewers test production-only
+# behaviour (SSG, static optimization, edge runtime parity).
+
+ARG BASE_IMAGE=node:22-alpine
+
+FROM ${BASE_IMAGE}
+WORKDIR /app
+
+RUN corepack enable 2>/dev/null || true
+
+COPY package.json pnpm-lock.yaml* package-lock.json* yarn.lock* ./
+RUN --mount=type=cache,id=kp-pnpm-store,target=/root/.local/share/pnpm/store \
+    --mount=type=cache,id=kp-npm-cache,target=/root/.npm \
+    if [ -f pnpm-lock.yaml ]; then pnpm install --frozen-lockfile --ignore-scripts; \
+    elif [ -f package-lock.json ]; then npm ci --ignore-scripts; \
+    elif [ -f yarn.lock ]; then yarn install --frozen-lockfile --ignore-scripts; \
+    else npm install --ignore-scripts; fi
+
+COPY . ./
+RUN mkdir -p public
+
+ENV NEXT_TELEMETRY_DISABLED=1
+ENV NODE_ENV=production
+ENV PORT=8080
+ENV HOSTNAME=0.0.0.0
+ENV NODE_OPTIONS="--max-old-space-size=7168"
+
+RUN --mount=type=cache,id=kp-next-cache,target=/app/.next/cache \
+    if [ -f pnpm-lock.yaml ]; then pnpm exec next build; \
+    else npx next build; \
+    fi
+
+EXPOSE 8080
+CMD ["sh", "-c", "if [ -f pnpm-lock.yaml ]; then pnpm exec next start -H 0.0.0.0 -p 8080; else npx next start -H 0.0.0.0 -p 8080; fi"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.204",
+  "version": "0.4.206-next.0",
   "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": []
-  }
-}