@kody-ade/kody-engine 0.2.11 → 0.2.13

package/dist/executables/run/profile.json

@@ -0,0 +1,86 @@
+{
+  "name": "run",
+  "describe": "Implement a GitHub issue end-to-end: branch, code, commit, open PR.",
+  "inputs": [
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub issue number to implement."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": [
+      "Read",
+      "Write",
+      "Edit",
+      "Bash",
+      "Grep",
+      "Glob"
+    ],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "runFlow"
+      },
+      {
+        "script": "loadTaskState"
+      },
+      {
+        "script": "loadConventions"
+      },
+      {
+        "script": "loadCoverageRules"
+      },
+      {
+        "script": "composePrompt"
+      }
+    ],
+    "postflight": [
+      {
+        "script": "parseAgentResult"
+      },
+      {
+        "script": "verify"
+      },
+      {
+        "script": "checkCoverageWithRetry"
+      },
+      {
+        "script": "commitAndPush"
+      },
+      {
+        "script": "ensurePr"
+      },
+      {
+        "script": "postIssueComment"
+      },
+      {
+        "script": "writeRunSummary"
+      },
+      {
+        "script": "saveTaskState"
+      }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "RUN_COMPLETED",
+      "RUN_FAILED",
+      "AGENT_NOT_RUN"
+    ]
+  }
+}

package/dist/executables/types.ts

@@ -62,24 +62,26 @@ export interface ClaudeCodeSpec {
   systemPromptAppend: string | null
   /** SDK built-in tools this executable is allowed to use (capability pack). */
   tools: string[]
-  /** Claude Code hooks. `matcher` is a tool-name glob; `command` is a shell invocation. */
-  hooks: {
-    PreToolUse: HookEntry[]
-    PostToolUse: HookEntry[]
-    Stop: HookEntry[]
-  }
+  /**
+   * Names of bundled hook configs to load (from src/plugins/hooks/<name>.json).
+   * Each referenced file is a Claude Code hooks JSON ({ hooks: { PreToolUse: [...] } }).
+   * Merged into a synthetic plugin at runtime.
+   */
+  hooks: string[]
+  /** Names of bundled skills to load (from src/plugins/skills/<name>/SKILL.md). */
   skills: string[]
+  /** Names of bundled slash commands to load (from src/plugins/commands/<name>.md). */
   commands: string[]
+  /** Names of bundled subagents to load (from src/plugins/agents/<name>.md). */
   subagents: string[]
+  /**
+   * External plugin directory paths (absolute, or relative to the profile dir).
+   * Loaded as-is by the SDK via { type: 'local', path }.
+   */
   plugins: string[]
   mcpServers: McpServerSpec[]
 }
 
-export interface HookEntry {
-  matcher: string
-  command: string
-}
-
 export interface McpServerSpec {
   name: string
   command: string

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

@@ -1,31 +1,28 @@
 {
   "name": "watch-stale-prs",
   "describe": "Scheduled: list open PRs untouched for N days and report. No agent invocation.",
-
   "kind": "scheduled",
   "schedule": "0 8 * * MON",
-
   "inputs": [],
-
   "claudeCode": {
     "model": "inherit",
     "permissionMode": "default",
     "maxTurns": null,
     "systemPromptAppend": null,
     "tools": [],
-    "hooks": { "PreToolUse": [], "PostToolUse": [], "Stop": [] },
+    "hooks": [],
     "skills": [],
     "commands": [],
     "subagents": [],
     "plugins": [],
     "mcpServers": []
   },
-
   "cliTools": [],
-
   "scripts": {
     "preflight": [
-      { "script": "watchStalePrsFlow" }
+      {
+        "script": "watchStalePrsFlow"
+      }
     ],
     "postflight": []
   }

package/dist/plugins/commands/kody-live-probe.md

@@ -0,0 +1,9 @@
+---
+description: Internal Kody2 live-test slash command. Prints a confirmation token proving commands are loaded.
+---
+
+# /kody-live-probe
+
+Print the literal token `COMMAND_LOADED_OK` in your next message, followed by the current ISO timestamp on a new line.
+
+Do not perform any other action — this command is a no-op confirmation signal for Kody2 infrastructure validation.

package/dist/plugins/hooks/kody-live-trace.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "tool == \"Read\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "printf 'HOOK_FIRED_OK\\n' >> /tmp/kody-hook-signal.txt"
+          }
+        ],
+        "description": "Kody2 live-test hook — appends HOOK_FIRED_OK to /tmp/kody-hook-signal.txt on every Read tool use, so the agent can verify the hook fired."
+      }
+    ]
+  }
+}

package/dist/plugins/skills/kody-live-marker/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: kody-live-marker
+description: Internal Kody2 live-test skill. Activates when a prompt mentions "kody-live-marker" and provides a confirmation token.
+---
+
+# kody-live-marker
+
+This skill exists only to verify that Kody2's synthetic plugin wiring actually loads skills into the agent's session.
+
+## When to activate
+
+When the user's prompt contains the phrase "kody-live-marker" or explicitly asks whether the skill is loaded.
+
+## What to do
+
+Include the literal token `SKILL_LOADED_OK` somewhere in your final message. Include the skill's description verbatim: "Internal Kody2 live-test skill."
+
+Do not use this skill for anything else. It is a no-op confirmation signal for infrastructure validation.

package/dist/plugins/test-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "kody2-test-plugin",
+  "version": "1.0.0",
+  "description": "Kody2 internal live-test plugin. Ships a single skill that proves external-plugin loading works.",
+  "skills": ["./skills/"]
+}

package/dist/plugins/test-plugin/skills/kody-plugin-marker/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: kody-plugin-marker
+description: Kody2 external-plugin live-test skill. Activates when prompt mentions "kody-plugin-marker" and outputs a confirmation token.
+---
+
+# kody-plugin-marker
+
+This skill is bundled inside a standalone plugin directory (not copied into a synthetic plugin). Its purpose is to verify that Kody2's `plugins: string[]` profile field successfully loads an external plugin as-is.
+
+## When to activate
+
+When the user's prompt contains the phrase "kody-plugin-marker".
+
+## What to do
+
+Include the literal token `PLUGIN_LOADED_OK` somewhere in your final message.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "kody2 — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -34,7 +34,7 @@
   "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
   "scripts": {
     "kody2": "tsx bin/kody2.ts",
-    "build": "tsup && node -e \"require('fs').cpSync('src/executables', 'dist/executables', { recursive: true })\"",
+    "build": "tsup && node scripts/copy-assets.cjs",
     "test": "vitest run tests/unit tests/int --no-coverage",
     "test:e2e": "vitest run tests/e2e --no-coverage",
     "test:all": "vitest run tests --no-coverage",

package/dist/executables/build/profile.json

@@ -1,99 +0,0 @@
-{
-  "name": "build",
-  "describe": "Implement a GitHub issue or apply PR feedback end-to-end.",
-
-  "inputs": [
-    {
-      "name": "mode",
-      "flag": "--mode",
-      "type": "enum",
-      "values": ["run", "fix", "fix-ci", "resolve"],
-      "required": true,
-      "describe": "Which Build mode to run."
-    },
-    {
-      "name": "issue",
-      "flag": "--issue",
-      "type": "int",
-      "requiredWhen": { "mode": "run" },
-      "describe": "GitHub issue number to implement."
-    },
-    {
-      "name": "pr",
-      "flag": "--pr",
-      "type": "int",
-      "requiredWhen": { "mode": ["fix", "fix-ci", "resolve"] },
-      "describe": "GitHub PR number to operate on."
-    },
-    {
-      "name": "feedback",
-      "flag": "--feedback",
-      "type": "string",
-      "required": false,
-      "describe": "Inline override for fix mode. If absent, the executor reads the latest PR review comment."
-    },
-    {
-      "name": "runId",
-      "flag": "--run-id",
-      "type": "string",
-      "required": false,
-      "describe": "Specific failed workflow run ID for fix-ci. Defaults to latest failed run on the PR branch."
-    }
-  ],
-
-  "claudeCode": {
-    "model": "inherit",
-    "permissionMode": "acceptEdits",
-    "maxTurns": null,
-    "systemPromptAppend": null,
-    "tools": ["Read", "Write", "Edit", "Bash", "Grep", "Glob"],
-    "hooks": {
-      "PreToolUse": [],
-      "PostToolUse": [],
-      "Stop": []
-    },
-    "skills": [],
-    "commands": [],
-    "subagents": [],
-    "plugins": [],
-    "mcpServers": []
-  },
-
-  "cliTools": [],
-
-  "scripts": {
-    "preflight": [
-      { "script": "runFlow",     "runWhen": { "args.mode": "run" } },
-      { "script": "fixFlow",     "runWhen": { "args.mode": "fix" } },
-      { "script": "fixCiFlow",   "runWhen": { "args.mode": "fix-ci" } },
-      { "script": "resolveFlow", "runWhen": { "args.mode": "resolve" } },
-      { "script": "loadTaskState" },
-      { "script": "loadConventions" },
-      { "script": "loadCoverageRules" },
-      { "script": "composePrompt" }
-    ],
-    "postflight": [
-      { "script": "parseAgentResult" },
-      { "script": "verify",                 "runWhen": { "args.mode": ["run", "fix", "fix-ci"] } },
-      { "script": "checkCoverageWithRetry", "runWhen": { "args.mode": ["run", "fix", "fix-ci"] } },
-      { "script": "commitAndPush" },
-      { "script": "ensurePr" },
-      { "script": "postIssueComment" },
-      { "script": "writeRunSummary" },
-      { "script": "saveTaskState" }
-    ]
-  },
-  "output": {
-    "actionTypes": [
-      "RUN_COMPLETED",
-      "RUN_FAILED",
-      "FIX_COMPLETED",
-      "FIX_FAILED",
-      "FIX_CI_COMPLETED",
-      "FIX_CI_FAILED",
-      "RESOLVE_COMPLETED",
-      "RESOLVE_FAILED",
-      "AGENT_NOT_RUN"
-    ]
-  }
-}

package/dist/executables/orchestrator/prompts/orchestrator.md

@@ -1,56 +0,0 @@
-You are the **kody2 orchestrator** for issue #{{issue.number}} on {{repoOwner}}/{{repoName}}.
-
-Your job: drive a 2-step flow **plan → build** by posting `@kody2 <subcommand>` comments on the issue and watching the state-comment for completion signals. You do NOT edit files. You do NOT run git. You use `gh` (via Bash) only to post comments and read the state-comment.
-
----
-
-# Issue #{{issue.number}}: {{issue.title}}
-
-{{issue.body}}
-
-# Required flow (plan-then-build)
-
-1. **Kick off plan.** Post an issue comment with EXACTLY this body:
-   ```
-   @kody2 plan
-   ```
-   Use: `gh issue comment {{issue.number}} --body "@kody2 plan"` (in the cwd).
-2. **Wait for plan to complete.** Poll the issue's state-comment every ~30s. The state-comment is the one whose body starts with `<!-- kody2:state:v1:begin -->`. Fetch it with:
-   ```
-   gh api repos/{{repoOwner}}/{{repoName}}/issues/{{issue.number}}/comments --paginate --jq '.[] | select(.body | contains("kody2:state:v1:begin")) | .body'
-   ```
-   Parse the JSON block inside the sentinels. Look for `core.lastOutcome.type == "PLAN_COMPLETED"`.
-   If `core.lastOutcome.type == "PLAN_FAILED"` OR if 10 minutes pass without completion → abort with:
-   ```
-   FAILED: plan did not complete (<reason from state or "timeout">)
-   ```
-3. **Kick off build.** Post:
-   ```
-   @kody2 build
-   ```
-   Same `gh issue comment` command.
-4. **Wait for build to complete.** Same poll technique. Look for `core.lastOutcome.type == "RUN_COMPLETED"` (build's success marker) or `RUN_FAILED`. If `RUN_FAILED` or 30 minutes pass → abort with `FAILED: build did not complete (...)`.
-5. **Emit final summary.**
-
-# Required final output
-
-On success:
-
-```
-DONE
-COMMIT_MSG: chore(orchestrator): plan-then-build for #{{issue.number}}
-PR_SUMMARY:
-- Posted `@kody2 plan` and observed PLAN_COMPLETED.
-- Posted `@kody2 build` and observed RUN_COMPLETED.
-- Final PR: <prUrl from state>
-```
-
-On failure, a single line: `FAILED: <concrete reason>`.
-
-# Rules
-
-- NEVER edit files. Read-only flow.
-- NEVER run git. Only `gh` via Bash for comment posting and state polling.
-- Between polls, sleep ~30 seconds. Do NOT poll faster than once every 30 seconds.
-- Hard cap: 40 turns total across the whole flow. If you're approaching the cap, fail early with `FAILED: turn budget exhausted`.
-- If you post an `@kody2` comment and the state-comment does NOT update within the poll window, the child executable likely didn't run — check the GitHub Actions runs tab URL via `gh run list --limit 5 --json conclusion,status,url` to diagnose, then fail with a concrete reason.

package/dist/executables/plan/prompts/plan.md

@@ -1,42 +0,0 @@
-You are a senior engineer producing an **implementation plan** for the GitHub issue below. You will NOT write code. You will NOT run git or gh commands. You will NOT modify files. Your only outputs are:
-
-1. Use Read / Grep / Glob / Bash (read-only) to study the codebase as much as needed.
-2. Emit a final message with the plan wrapped in the required markers (see "Required output").
-
----
-
-# Repo
-- {{repoOwner}}/{{repoName}}, default branch: {{defaultBranch}}
-
-# Issue #{{issue.number}}: {{issue.title}}
-
-{{issue.body}}
-
-Recent comments (most recent first, truncated):
-{{issue.commentsFormatted}}
-
-{{conventionsBlock}}
-
----
-
-# Required output
-
-Your FINAL message must be exactly this shape (no extra text before or after):
-
-```
-DONE
-COMMIT_MSG: plan: <very short title>
-PR_SUMMARY:
-<A concrete implementation plan in markdown. Include:
- - Files to change (with paths), and the change in each.
- - New files to create, with their purpose and rough shape.
- - Any ambiguities that need the human to resolve first.
- - Verification checklist (typecheck / tests / lint expectations).
- Keep to ~60 lines or less. No filler. No marketing language.>
-```
-
-# Rules
-- Read-only. Do NOT modify any file.
-- Do NOT run git or gh commands.
-- No speculative scope — plan only what the issue asks for.
-- If the issue is ambiguous and you cannot make progress without input, output `FAILED: <what's unclear>` instead of a plan.