@kody-ade/kody-engine 0.4.212-live.0 → 0.4.212

package/dist/bin/kody.js

@@ -1542,7 +1542,7 @@ var init_loadCoverageRules = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.212-live.0",
+  version: "0.4.212",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -2517,9 +2517,26 @@ function listBuiltinJobs(root = getBuiltinJobsRoot()) {
   if (!fs6.existsSync(root) || !fs6.statSync(root).isDirectory()) return [];
   const out = [];
   for (const ent of fs6.readdirSync(root, { withFileTypes: true })) {
-    if (!ent.isFile() || !ent.name.endsWith(".md")) continue;
-    const slug = ent.name.slice(0, -3);
-    out.push({ slug, filePath: path6.join(root, ent.name) });
+    if (ent.name.startsWith("_") || ent.name.startsWith(".")) continue;
+    const full = path6.join(root, ent.name);
+    if (ent.isDirectory()) {
+      const profilePath = path6.join(full, "profile.json");
+      const promptPath = path6.join(full, "prompt.md");
+      if (!fs6.existsSync(profilePath) || !fs6.statSync(profilePath).isFile()) continue;
+      if (!fs6.existsSync(promptPath) || !fs6.statSync(promptPath).isFile()) continue;
+      out.push({ slug: ent.name, dir: full, profilePath, promptPath });
+      continue;
+    }
+    if (ent.isFile() && ent.name.endsWith(".md")) {
+      const slug = ent.name.slice(0, -3);
+      out.push({
+        slug,
+        dir: full,
+        profilePath: "",
+        promptPath: "",
+        filePath: full
+      });
+    }
   }
   out.sort((a, b) => a.slug.localeCompare(b.slug));
   return out;
@@ -9792,14 +9809,30 @@ function performInit(cwd, force) {
     const jobsDir = path27.join(cwd, ".kody", "duties");
     fs30.mkdirSync(jobsDir, { recursive: true });
     for (const job of builtinJobs) {
-      const rel = path27.join(".kody", "duties", `${job.slug}.md`);
-      const target = path27.join(cwd, rel);
-      if (fs30.existsSync(target) && !force) {
-        skipped.push(rel);
+      if (job.filePath && !job.profilePath) {
+        const rel = path27.join(".kody", "duties", `${job.slug}.md`);
+        const target = path27.join(cwd, rel);
+        if (fs30.existsSync(target) && !force) {
+          skipped.push(rel);
+          continue;
+        }
+        fs30.writeFileSync(target, fs30.readFileSync(job.filePath, "utf-8"));
+        wrote.push(rel);
+        continue;
+      }
+      const targetDir = path27.join(jobsDir, job.slug);
+      const relProfile = path27.join(".kody", "duties", job.slug, "profile.json");
+      const relPrompt = path27.join(".kody", "duties", job.slug, "prompt.md");
+      if (fs30.existsSync(targetDir) && fs30.existsSync(path27.join(targetDir, "profile.json")) && !force) {
+        skipped.push(relProfile);
+        skipped.push(relPrompt);
         continue;
       }
-      fs30.writeFileSync(target, fs30.readFileSync(job.filePath, "utf-8"));
-      wrote.push(rel);
+      fs30.mkdirSync(targetDir, { recursive: true });
+      fs30.writeFileSync(path27.join(targetDir, "profile.json"), fs30.readFileSync(job.profilePath, "utf-8"));
+      fs30.writeFileSync(path27.join(targetDir, "prompt.md"), fs30.readFileSync(job.promptPath, "utf-8"));
+      wrote.push(relProfile);
+      wrote.push(relPrompt);
     }
   }
   const staffDir = path27.join(cwd, ".kody", "staff");

package/dist/jobs/watch-stale-prs/profile.json

@@ -0,0 +1,46 @@
+{
+  "name": "watch-stale-prs",
+  "role": "primitive",
+  "describe": "Weekly digest of open PRs that haven't been touched in a while. Writes a markdown report at .kody/reports/watch-stale-prs.md (surfaced by the dashboard's /reports page).",
+  "kind": "oneshot",
+  "staff": "kody",
+  "every": "7d",
+  "inputs": [],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": 100,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "enableSubmitTool": true,
+    "tools": ["Bash", "Read", "mcp__kody-submit"],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [
+    {
+      "name": "gh",
+      "install": {
+        "required": true,
+        "checkCommand": "command -v gh"
+      },
+      "verify": "gh auth status",
+      "usage": "Use `gh` for all GitHub actions: `gh pr list --state open --limit 100 --json number,title,url,updatedAt,author` to enumerate candidate PRs, `gh api -X GET /repos/{owner}/{repo}/contents/.kody/reports/watch-stale-prs.md` to fetch the existing file's `sha` for an update, `gh api -X PUT /repos/{owner}/{repo}/contents/.kody/reports/watch-stale-prs.md` to write the report (base64-encoded `content`, `message`, and `sha` when updating). NEVER edit files in the working tree.",
+      "allowedUses": ["pr", "api"]
+    }
+  ],
+  "scripts": {
+    "preflight": [
+      { "script": "loadDutyState" },
+      { "script": "composePrompt" }
+    ],
+    "postflight": [
+      { "script": "parseJobStateFromAgentResult", "with": { "fenceLabel": "kody-job-next-state" } },
+      { "script": "writeJobStateFile" }
+    ]
+  }
+}

package/dist/jobs/watch-stale-prs/prompt.md

@@ -0,0 +1,95 @@
+{{dutyReference}}
+
+You are **{{staffTitle}}** (staff `{{staffSlug}}`), running the **watch-stale-prs** duty — a weekly digest of open PRs that haven't been touched in a while. You do **not** touch code, do **not** commit, and do **not** edit files. You coordinate by inspecting GitHub state via `gh` and writing a single report file at `.kody/reports/{{dutySlug}}.md`.
+
+## Who you are — staff persona (authoritative identity)
+
+The duty assigns you, staff **`{{staffSlug}}`**, as its executor. This persona defines *who* runs the duty: your authority, doctrine, voice, and hard limits. Where the persona's restrictions are stricter than the duty body, **the persona wins** — a duty can never grant you authority your staff persona withholds.
+
+{{workerPersona}}
+
+## The duty
+
+Slug **`{{dutySlug}}`** — *{{dutyTitle}}*, assigned to staff **`{{staffSlug}}`**, running on executable **`{{executableSlug}}`**. Cadence is enforced by the engine via the `every: 7d` profile field — this duty only fires once per 7 days regardless of how often `duty-scheduler` wakes. No prose cadence guard needed.
+
+**Addressing the operator.** When the duty tells you to @-mention the operator, the exact handle(s) to use are: {{mentions}}. Copy that string **verbatim** — never invent, abbreviate, guess, or retype a GitHub username. If the line above is blank, the duty declared no operator; post without a mention.
+
+### What "stale" means
+
+Find every open PR untouched for **≥ 7 days** and write a report listing them, sorted by staleness (oldest first). When there are no stale PRs, write a short "all clear" report so operators know the check ran.
+
+A PR is stale if:
+
+- `state` is `OPEN`, AND
+- `updatedAt` is more than 7 days before now.
+
+Use `gh pr list --state open --limit 100 --json number,title,url,updatedAt,author` to enumerate. Filter and sort client-side; do not call `gh` once per PR.
+
+### Report shape
+
+Write to `.kody/reports/watch-stale-prs.md`. Overwrite each run.
+
+When stale PRs exist:
+
+```markdown
+# Stale PRs — <ISO date>
+
+🟡 <N> PR(s) untouched for > 7 days.
+
+| # | Title | Author | Days stale | Updated |
+|---|-------|--------|------------|---------|
+| [#123](url) | <title> | @user | 14 | 2026-04-25 |
+| ... | | | | |
+```
+
+When none:
+
+```markdown
+# Stale PRs — <ISO date>
+
+🟢 No open PRs untouched for more than 7 days.
+```
+
+Truncate to the 50 oldest if the list is longer; append a final line
+`> … and N more not shown`.
+
+## Allowed Commands
+
+- `gh pr list --state open --limit 100 --json number,title,url,updatedAt,author`
+- `gh api -X GET /repos/{owner}/{repo}/contents/.kody/reports/watch-stale-prs.md`
+  — only to fetch the existing file's `sha` for an update.
+- `gh api -X PUT /repos/{owner}/{repo}/contents/.kody/reports/watch-stale-prs.md`
+  — to write the report (base64-encoded `content`, `message`, and `sha`
+  when updating). This is the **only** permitted write path for this job.
+
+## Restrictions
+
+- Never edit, create, or delete any other file in the working tree.
+- Never `git commit`, `git push`, or open a PR.
+- Never post comments on PRs or issues; the report file is the only
+  output channel.
+- Never call `gh` per-PR — one `pr list` is enough.
+
+## State
+
+`cursor`: always `"idle"` — this job has no phases; each fire is a
+one-shot report write.
+
+`data`:
+
+- `lastStaleCount` (number) — how many stale PRs were in the most recent
+  report. Diagnostic only; the engine ignores it.
+
+(Engine-managed fields like `lastFiredAt` live under `data` automatically;
+do not write or rely on them from the prompt.)
+
+`done`: always `false` — this job is evergreen.
+
+## What to do on this tick
+
+1. **Check `done`.** If the prior state has `done: true`, emit the same state back unchanged and exit without any action.
+2. **Enumerate stale PRs** with `gh pr list`.
+3. **Write the report** to `.kody/reports/{{dutySlug}}.md` via `gh api -X PUT`.
+4. **Submit the new state** by calling the `submit_state` tool with `cursor: "idle"`, the `lastStaleCount` in `data`, and `done: false`.
+
+The duty cadence (`every: 7d`) is enforced by the engine — do not re-arm it from the prompt.

package/package.json

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

package/dist/jobs/watch-stale-prs.md

@@ -1,90 +0,0 @@
----
-every: 7d
-staff: kody
----
-
-# watch-stale-prs
-
-> Weekly digest of open PRs that haven't been touched in a while. Writes a
-> markdown report at `.kody/reports/watch-stale-prs.md` (surfaced by the
-> dashboard's `/reports` page).
->
-> Cadence is enforced by the engine via the `every: 7d` frontmatter — this
-> file only fires once per 7 days regardless of how often `duty-scheduler`
-> wakes. No prose cadence guard needed.
-
-## Job
-
-Find every open PR untouched for **≥ 7 days** and write a report listing
-them, sorted by staleness (oldest first). When there are no stale PRs,
-write a short "all clear" report so operators know the check ran.
-
-### What "stale" means
-
-A PR is stale if:
-
-- `state` is `OPEN`, AND
-- `updatedAt` is more than 7 days before now.
-
-Use `gh pr list --state open --limit 100 --json number,title,url,updatedAt,author`
-to enumerate. Filter and sort client-side; do not call `gh` once per PR.
-
-### Report shape
-
-Write to `.kody/reports/watch-stale-prs.md`. Overwrite each run.
-
-When stale PRs exist:
-
-```markdown
-# Stale PRs — <ISO date>
-
-🟡 <N> PR(s) untouched for > 7 days.
-
-| # | Title | Author | Days stale | Updated |
-|---|-------|--------|------------|---------|
-| [#123](url) | <title> | @user | 14 | 2026-04-25 |
-| ... | | | | |
-```
-
-When none:
-
-```markdown
-# Stale PRs — <ISO date>
-
-🟢 No open PRs untouched for more than 7 days.
-```
-
-Truncate to the 50 oldest if the list is longer; append a final line
-`> … and N more not shown`.
-
-## Allowed Commands
-
-- `gh pr list --state open --limit 100 --json number,title,url,updatedAt,author`
-- `gh api -X GET /repos/{owner}/{repo}/contents/.kody/reports/watch-stale-prs.md`
-  — only to fetch the existing file's `sha` for an update.
-- `gh api -X PUT /repos/{owner}/{repo}/contents/.kody/reports/watch-stale-prs.md`
-  — to write the report (base64-encoded `content`, `message`, and `sha`
-  when updating). This is the **only** permitted write path for this job.
-
-## Restrictions
-
-- Never edit, create, or delete any other file in the working tree.
-- Never `git commit`, `git push`, or open a PR.
-- Never post comments on PRs or issues; the report file is the only
-  output channel.
-- Never call `gh` per-PR — one `pr list` is enough.
-
-## State
-
-`cursor`: always `"idle"` — this job has no phases; each fire is a
-one-shot report write.
-
-`data`:
-
-- `lastStaleCount` (number) — how many stale PRs were in the most recent
-  report. Diagnostic only; the engine ignores it.
-
-(Engine-managed fields like `lastFiredAt` live under `data` automatically;
-do not write or rely on them from the prompt.)
-
-`done`: always `false` — this job is evergreen.