@kody-ade/kody-engine 0.4.218 → 0.4.220

package/dist/duties/fix/duty.md

@@ -0,0 +1,10 @@
+# Fix
+
+## Purpose
+
+Apply review feedback to an existing PR.
+
+## Instructions
+
+Use the `fix` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/fix/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "fix",
+  "action": "fix",
+  "executable": "fix",
+  "describe": "Apply review feedback to an existing PR."
+}

package/dist/duties/fix-ci/duty.md

@@ -0,0 +1,10 @@
+# Fix Ci
+
+## Purpose
+
+Fix a failing CI workflow on an existing PR.
+
+## Instructions
+
+Use the `fix-ci` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/fix-ci/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "fix-ci",
+  "action": "fix-ci",
+  "executable": "fix-ci",
+  "describe": "Fix a failing CI workflow on an existing PR."
+}

package/dist/duties/init/duty.md

@@ -0,0 +1,10 @@
+# Init
+
+## Purpose
+
+Install Kody engine files in a repo.
+
+## Instructions
+
+Use the `init` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/init/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "init",
+  "action": "init",
+  "executable": "init",
+  "describe": "Install Kody engine files in a repo."
+}

package/dist/duties/merge/duty.md

@@ -0,0 +1,10 @@
+# Merge
+
+## Purpose
+
+Self-gating squash merge of a PR.
+
+## Instructions
+
+Use the `merge` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/merge/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "merge",
+  "action": "merge",
+  "executable": "merge",
+  "describe": "Self-gating squash merge of a PR."
+}

package/dist/duties/preview-build/duty.md

@@ -0,0 +1,10 @@
+# Preview Build
+
+## Purpose
+
+Build and publish a per-PR preview.
+
+## Instructions
+
+Use the `preview-build` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/preview-build/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "preview-build",
+  "action": "preview-build",
+  "executable": "preview-build",
+  "describe": "Build and publish a per-PR preview."
+}

package/dist/duties/release/duty.md

@@ -0,0 +1,10 @@
+# Release
+
+## Purpose
+
+Run the release flow.
+
+## Instructions
+
+Use the `release` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/release/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "release",
+  "action": "release",
+  "executable": "release",
+  "describe": "Run the release flow."
+}

package/dist/duties/release-deploy/duty.md

@@ -0,0 +1,10 @@
+# Release Deploy
+
+## Purpose
+
+Deploy or promote a release.
+
+## Instructions
+
+Use the `release-deploy` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/release-deploy/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "release-deploy",
+  "action": "release-deploy",
+  "executable": "release-deploy",
+  "describe": "Deploy or promote a release."
+}

package/dist/duties/release-prepare/duty.md

@@ -0,0 +1,10 @@
+# Release Prepare
+
+## Purpose
+
+Prepare a release PR.
+
+## Instructions
+
+Use the `release-prepare` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/release-prepare/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "release-prepare",
+  "action": "release-prepare",
+  "executable": "release-prepare",
+  "describe": "Prepare a release PR."
+}

package/dist/duties/release-publish/duty.md

@@ -0,0 +1,10 @@
+# Release Publish
+
+## Purpose
+
+Publish a prepared release.
+
+## Instructions
+
+Use the `release-publish` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/release-publish/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "release-publish",
+  "action": "release-publish",
+  "executable": "release-publish",
+  "describe": "Publish a prepared release."
+}

package/dist/duties/resolve/duty.md

@@ -0,0 +1,10 @@
+# Resolve
+
+## Purpose
+
+Resolve merge conflicts on an existing PR.
+
+## Instructions
+
+Use the `resolve` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/resolve/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "resolve",
+  "action": "resolve",
+  "executable": "resolve",
+  "describe": "Resolve merge conflicts on an existing PR."
+}

package/dist/duties/revert/duty.md

@@ -0,0 +1,10 @@
+# Revert
+
+## Purpose
+
+Revert one or more commits on a PR branch.
+
+## Instructions
+
+Use the `revert` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/revert/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "revert",
+  "action": "revert",
+  "executable": "revert",
+  "describe": "Revert one or more commits on a PR branch."
+}

package/dist/duties/run/duty.md

@@ -0,0 +1,10 @@
+# Run
+
+## Purpose
+
+Implement a GitHub issue end-to-end.
+
+## Instructions
+
+Use the `run` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/run/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "run",
+  "action": "run",
+  "executable": "run",
+  "describe": "Implement a GitHub issue end-to-end."
+}

package/dist/duties/sync/duty.md

@@ -0,0 +1,10 @@
+# Sync
+
+## Purpose
+
+Merge the base branch into a PR branch.
+
+## Instructions
+
+Use the `sync` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/sync/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "sync",
+  "action": "sync",
+  "executable": "sync",
+  "describe": "Merge the base branch into a PR branch."
+}

package/dist/duties/worker-ask/duty.md

@@ -0,0 +1,10 @@
+# Worker Ask
+
+## Purpose
+
+Run a staff member once against an inline request.
+
+## Instructions
+
+Use the `worker-ask` executable for the implementation details.
+The duty owns the public action name and the reason this action exists; the executable owns the method.

package/dist/duties/worker-ask/profile.json

@@ -0,0 +1,6 @@
+{
+  "name": "worker-ask",
+  "action": "worker-ask",
+  "executable": "worker-ask",
+  "describe": "Run a staff member once against an inline request."
+}

package/dist/executables/duty-scheduler/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "duty-scheduler",
   "role": "watch",
-  "describe": "Scheduled: for every duty file under .kody/duties/, invoke duty-tick once. No agent on the scheduler itself.",
+  "describe": "Scheduled: for every duty folder under .kody/duties/, invoke duty-tick once. No agent on the scheduler itself.",
   "kind": "scheduled",
   "schedule": "*/5 * * * *",
   "inputs": [

package/dist/executables/duty-tick/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "duty-tick",
   "role": "primitive",
-  "describe": "One classifier tick for one duty file: read intent + state, decide and execute via gh, emit next state.",
+  "describe": "One classifier tick for one duty folder: read intent + state, decide and execute via gh, emit next state.",
   "kind": "oneshot",
   "inputs": [
     {
@@ -9,7 +9,7 @@
       "flag": "--duty",
       "type": "string",
       "required": true,
-      "describe": "Duty slug — basename (without .md) of the file under .kody/duties/."
+      "describe": "Duty slug — folder name under .kody/duties/."
     },
     {
       "name": "force",

package/dist/executables/duty-tick-scripted/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "duty-tick-scripted",
   "role": "utility",
-  "describe": "Deterministic duty tick: runs the slug's `tickScript:` (declared in duty frontmatter), parses next-state from its stdout, persists. No agent.",
+  "describe": "Deterministic duty tick: runs the slug's `tickScript:` (declared in the duty profile), parses next-state from its stdout, persists. No agent.",
   "kind": "oneshot",
   "inputs": [
     {
@@ -9,13 +9,13 @@
       "flag": "--duty",
       "type": "string",
       "required": true,
-      "describe": "Duty slug — basename (without .md) of the file under .kody/duties/."
+      "describe": "Duty slug — folder name under .kody/duties/."
     },
     {
       "name": "force",
       "flag": "--force",
       "type": "bool",
-      "describe": "Accepted for parity with `duty-tick`. Scripted ticks have no agent cadence guard to bypass — the dispatcher already gated on frontmatter `every:`. Forwarded to the script via env if it cares."
+      "describe": "Accepted for parity with `duty-tick`. Scripted ticks have no agent cadence guard to bypass — the dispatcher already gated on profile `every`. Forwarded to the script via env if it cares."
     }
   ],
   "claudeCode": {

package/dist/executables/types.ts

@@ -17,6 +17,12 @@ import type { Phase } from "../state.js"
 
 export interface Profile {
   name: string
+  /**
+   * Public action name owned by a duty. A user may type `@kody <action>`;
+   * dispatch resolves that action to the duty, then the duty selects the
+   * implementation executable. Absent → the duty slug/name is the action.
+   */
+  action?: string
   /**
    * Optional staff member this executable runs *as*. When set, the executor
    * loads `.kody/staff/<staff>.md` and injects that persona (authoritative
@@ -59,7 +65,7 @@ export interface Profile {
   kind: "oneshot" | "scheduled"
   /**
    * Recurrence cadence for a duty that runs on a timer (unified successor to a
-   * markdown duty's `every:` frontmatter). One of the ScheduleEvery values
+   * markdown duty's `every:` metadata). One of the ScheduleEvery values
    * ("15m".."7d" | "manual"). Present → the duty-scheduler fires a one-shot run
    * when due (no target). Absent → on-demand only (runs against an issue/PR).
    * This is what makes "scheduled" just a field on the one duty shape.
@@ -67,7 +73,7 @@ export interface Profile {
   every?: string
   /**
    * Locked-toolbox palette (unified successor to a markdown duty's `tools:`
-   * frontmatter). When non-empty, loadDutyState sets ctx.data.dutyTools so the
+   * metadata). When non-empty, loadDutyState sets ctx.data.dutyTools so the
    * executor spins up the in-process kody-duty MCP server and the agent runs
    * MCP-only (Bash/Read revoked unless also in claudeCode.tools). Absent →
    * normal SDK tools.
@@ -76,7 +82,7 @@ export interface Profile {
   /**
    * GitHub logins (no leading `@`) this duty's output should mention. Rendered
    * to `@a @b` and exposed to the prompt as {{mentions}} (and as the duty-MCP
-   * operator mention), mirroring a markdown duty's `mentions:` frontmatter.
+   * operator mention), mirroring a markdown duty's `mentions:` metadata.
    */
   mentions?: string[]
   /** Cron expression for scheduled profiles (e.g. "0 8 * * MON"). */
@@ -462,6 +468,8 @@ export type AnyScript = PreflightScript | PostflightScript
 export type JobFlavor = "instant" | "scheduled"
 
 export interface Job {
+  /** Public action the user/operator invoked. Mirrors the duty action. */
+  action?: string
   /** How: executable (profile) name to run. 0–1; omitted when intent is
    *  agent-only with no specific verb. */
   executable?: string

package/dist/executables/worker-ask/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "worker-ask",
   "role": "primitive",
-  "describe": "Ad-hoc one-shot: run a staff persona against an inline message + context (from a dashboard @staff mention). Stateless — no duty file, no state, no commit. Replies into the originating thread.",
+  "describe": "Ad-hoc one-shot: run a staff persona against an inline message + context (from a dashboard @staff mention). Stateless — no duty folder, no state, no commit. Replies into the originating thread.",
   "kind": "oneshot",
   "inputs": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.218",
+  "version": "0.4.220",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,26 +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",
-    "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",
@@ -55,5 +35,24 @@
     "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",
+    "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"
+  }
+}