@kody-ade/kody-engine 0.2.63 → 0.3.1

package/dist/executables/types.ts

@@ -8,7 +8,7 @@
  */
 
 import type { AgentResult } from "../agent.js"
-import type { Kody2Config } from "../config.js"
+import type { KodyConfig } from "../config.js"
 import type { Phase } from "../state.js"
 
 // ────────────────────────────────────────────────────────────────────────────
@@ -101,7 +101,7 @@ export interface InputSpec {
 }
 
 export interface ClaudeCodeSpec {
-  /** "inherit" → use Kody2Config.agent.model. Or a concrete "provider/model". */
+  /** "inherit" → use KodyConfig.agent.model. Or a concrete "provider/model". */
   model: string
   permissionMode: "default" | "acceptEdits" | "plan" | "bypassPermissions"
   /** null = unbounded. */
@@ -184,7 +184,7 @@ export interface Context {
   /** Project root. */
   cwd: string
   /** Loaded kody.config.json. */
-  config: Kody2Config
+  config: KodyConfig
   /** Stream-output verbosity. */
   verbose?: boolean
   quiet?: boolean

package/dist/executables/ui-review/profile.json

@@ -1,7 +1,7 @@
 {
   "name": "ui-review",
   "role": "primitive",
-  "describe": "UI/UX review of an open PR: browses the running preview with Playwright, compares behavior to diff intent, posts one structured review comment. Read-only on the repo (no commits); writes a throwaway Playwright spec under .kody2/.",
+  "describe": "UI/UX review of an open PR: browses the running preview with Playwright, compares behavior to diff intent, posts one structured review comment. Read-only on the repo (no commits); writes a throwaway Playwright spec under .kody/.",
   "kind": "oneshot",
   "inputs": [
     {
@@ -38,7 +38,13 @@
     "commands": [],
     "subagents": [],
     "plugins": [],
-    "mcpServers": []
+    "mcpServers": [
+      {
+        "name": "playwright",
+        "command": "npx",
+        "args": ["-y", "@playwright/mcp@latest"]
+      }
+    ]
   },
   "cliTools": [
     {
@@ -49,7 +55,7 @@
         "installCommand": "npx --yes playwright install --with-deps chromium"
       },
       "verify": "npx --no-install playwright --version",
-      "usage": "Use `npx playwright test <file>` to run a Playwright spec. Write ad-hoc specs under `.kody2/ui-review/*.spec.ts`. If `npx playwright test` errors with `Cannot find package '@playwright/test'`, install it once with `npm install -D @playwright/test` (or the repo's package-manager equivalent) before retrying — the `playwright` browser binaries are already set up by preflight, but the per-repo test framework may not be. Prefer `page.goto(process.env.UI_REVIEW_BASE_URL)` — the base URL is injected as `UI_REVIEW_BASE_URL` at run time. Capture screenshots with `await page.screenshot({ path: '.kody2/ui-review/<name>.png' })` and reference those paths in your final review.",
+      "usage": "Use `npx playwright test <file>` to run a Playwright spec. Write ad-hoc specs under `.kody/ui-review/*.spec.ts`. If `npx playwright test` errors with `Cannot find package '@playwright/test'`, install it once with `npm install -D @playwright/test` (or the repo's package-manager equivalent) before retrying — the `playwright` browser binaries are already set up by preflight, but the per-repo test framework may not be. Prefer `page.goto(process.env.UI_REVIEW_BASE_URL)` — the base URL is injected as `UI_REVIEW_BASE_URL` at run time. Capture screenshots with `await page.screenshot({ path: '.kody/ui-review/<name>.png' })` and reference those paths in your final review.",
       "allowedUses": [
         "test",
         "--version"
@@ -60,7 +66,7 @@
   "outputArtifacts": [],
   "scripts": {
     "preflight": [
-      { "script": "setLifecycleLabel", "with": { "label": "kody:reviewing", "color": "d93f0b", "description": "kody2: reviewing a PR" } },
+      { "script": "setLifecycleLabel", "with": { "label": "kody:reviewing", "color": "d93f0b", "description": "kody: reviewing a PR" } },
       { "script": "reviewFlow" },
       { "script": "loadTaskState" },
       { "script": "loadConventions" },

package/dist/executables/ui-review/prompt.md

@@ -1,6 +1,6 @@
 You are Kody, a senior UI/UX reviewer. Review PR #{{pr.number}} by reading the diff AND browsing the running app with Playwright. Post ONE structured review comment. Do NOT edit any tracked source files. Do NOT run any `git` or `gh` commands.
 
-You MAY write throwaway Playwright specs and screenshots under `.kody2/ui-review/` — that directory is ignored by the repo.
+You MAY write throwaway Playwright specs and screenshots under `.kody/ui-review/` — that directory is ignored by the repo.
 
 # PR #{{pr.number}}: {{pr.title}}
 
@@ -46,23 +46,23 @@ If the response is not 2xx or 3xx, the preview is unreachable. In that case, SKI
 
 2. **Plan the browse session.** For each UI-affecting change, pick 1–3 routes from the QA context that exercise it. If the change requires an authenticated role, grab credentials from the QA guide above. If no credentials are available for a role the change depends on, note that as a gap and browse only public pages.
 
-3. **Write a Playwright spec.** Create exactly one file at `.kody2/ui-review/browse.spec.ts`. Use `process.env.UI_REVIEW_BASE_URL` as the base URL. For each route you plan to check, write a test that:
+3. **Write a Playwright spec.** Create exactly one file at `.kody/ui-review/browse.spec.ts`. Use `process.env.UI_REVIEW_BASE_URL` as the base URL. For each route you plan to check, write a test that:
    - navigates there,
    - performs the minimum interaction to exercise the change (click, submit, fill),
-   - takes a screenshot at `.kody2/ui-review/<slug>.png`,
+   - takes a screenshot at `.kody/ui-review/<slug>.png`,
    - asserts at least one piece of visible content so the test fails loudly on a blank / error page.
 
-   Include a `playwright.config.ts` at `.kody2/ui-review/playwright.config.ts` only if you need custom config; otherwise rely on defaults (headless chromium).
+   Include a `playwright.config.ts` at `.kody/ui-review/playwright.config.ts` only if you need custom config; otherwise rely on defaults (headless chromium).
 
 4. **Run it.** Invoke:
 
    ```bash
-   UI_REVIEW_BASE_URL={{previewUrl}} npx playwright test .kody2/ui-review/browse.spec.ts --reporter=line
+   UI_REVIEW_BASE_URL={{previewUrl}} npx playwright test .kody/ui-review/browse.spec.ts --reporter=line
    ```
 
    Capture both stdout and exit code. If Playwright is not installed, the executor will have tried to install it in preflight — if it still fails, report the install error and fall back to a diff-only review.
 
-5. **Inspect screenshots.** Use the Read tool on each `.png` under `.kody2/ui-review/` so the visual state is in your context. Note anything that looks broken, empty, misaligned, or inconsistent with the diff's intent.
+5. **Inspect screenshots.** Use the Read tool on each `.png` under `.kody/ui-review/` so the visual state is in your context. Note anything that looks broken, empty, misaligned, or inconsistent with the diff's intent.
 
 6. **Write the review.** Your FINAL MESSAGE must be the markdown review comment — no preamble, no DONE / COMMIT_MSG markers. The entire final message is posted verbatim to the PR.
 
@@ -71,7 +71,7 @@ If the response is not 2xx or 3xx, the preview is unreachable. In that case, SKI
 ```
 ## Verdict: PASS | CONCERNS | FAIL
 
-_UI review by kody2 — browsed {{previewUrl}}_
+_UI review by kody — browsed {{previewUrl}}_
 
 ### Summary
 <2-3 sentences: what this PR changes in the UI, and whether the running app matches that intent>
@@ -95,7 +95,7 @@ _UI review by kody2 — browsed {{previewUrl}}_
 
 # Rules
 
-- No commits. No `git` / `gh` invocations. No edits to files outside `.kody2/ui-review/`.
+- No commits. No `git` / `gh` invocations. No edits to files outside `.kody/ui-review/`.
 - Verdict **FAIL** only for clear visual regressions, broken flows, or correctness/accessibility issues that block merge.
 - Verdict **CONCERNS** for clarity/polish/edge-case gaps that shouldn't block.
 - Verdict **PASS** when the PR's UI changes work as intended and nothing obvious is broken.

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

@@ -1,9 +1,9 @@
 ---
-description: Internal Kody2 live-test slash command. Prints a confirmation token proving commands are loaded.
+description: Internal Kody 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.
+Do not perform any other action — this command is a no-op confirmation signal for Kody infrastructure validation.

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

@@ -1,11 +1,11 @@
 ---
 name: kody-live-marker
-description: Internal Kody2 live-test skill. Activates when a prompt mentions "kody-live-marker" and provides a confirmation token.
+description: Internal Kody 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.
+This skill exists only to verify that Kody's synthetic plugin wiring actually loads skills into the agent's session.
 
 ## When to activate
 
@@ -13,6 +13,6 @@ When the user's prompt contains the phrase "kody-live-marker" or explicitly asks
 
 ## 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."
+Include the literal token `SKILL_LOADED_OK` somewhere in your final message. Include the skill's description verbatim: "Internal Kody 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

@@ -1,6 +1,6 @@
 {
-  "name": "kody2-test-plugin",
+  "name": "kody-test-plugin",
   "version": "1.0.0",
-  "description": "Kody2 internal live-test plugin. Ships a single skill that proves external-plugin loading works.",
+  "description": "Kody 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

@@ -1,11 +1,11 @@
 ---
 name: kody-plugin-marker
-description: Kody2 external-plugin live-test skill. Activates when prompt mentions "kody-plugin-marker" and outputs a confirmation token.
+description: Kody 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.
+This skill is bundled inside a standalone plugin directory (not copied into a synthetic plugin). Its purpose is to verify that Kody's `plugins: string[]` profile field successfully loads an external plugin as-is.
 
 ## When to activate
 

package/kody.config.schema.json

@@ -84,7 +84,7 @@
     },
     "issueContext": {
       "type": "object",
-      "description": "kody2: how many and how much of the issue's comments the agent sees in its prompt. Higher = more context but larger prompts. Defaults: 50 comments, 10000 bytes each.",
+      "description": "kody: how many and how much of the issue's comments the agent sees in its prompt. Higher = more context but larger prompts. Defaults: 50 comments, 10000 bytes each.",
       "properties": {
         "commentLimit": {
           "type": "integer",
@@ -103,7 +103,7 @@
     },
     "testRequirements": {
       "type": "array",
-      "description": "kody2 enforces that newly added files matching `pattern` ship with a sibling test file matching `requireSibling`. Misses fail the run; the agent gets one retry with the gap as feedback. Empty array or absent = no enforcement.",
+      "description": "kody enforces that newly added files matching `pattern` ship with a sibling test file matching `requireSibling`. Misses fail the run; the agent gets one retry with the gap as feedback. Empty array or absent = no enforcement.",
       "items": {
         "type": "object",
         "required": ["pattern", "requireSibling"],
@@ -127,7 +127,7 @@
         "model": {
           "type": "string",
           "pattern": "^[^/]+/.+$",
-          "description": "Single 'provider/model' string used by kody2 (single-session pipeline). Use 'claude/...' or 'anthropic/...' for direct Anthropic API; anything else routes through LiteLLM proxy.",
+          "description": "Single 'provider/model' string used by kody (single-session pipeline). Use 'claude/...' or 'anthropic/...' for direct Anthropic API; anything else routes through LiteLLM proxy.",
           "examples": ["claude/claude-sonnet-4-6", "minimax/MiniMax-M2.7-highspeed"]
         },
         "modelMap": {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.2.63",
-  "description": "kody2 — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
+  "version": "0.3.1",
+  "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "kody2": "dist/bin/kody2.js"
+    "kody": "dist/bin/kody.js"
   },
   "files": [
     "dist",
@@ -33,7 +33,7 @@
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
   "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
   "scripts": {
-    "kody2": "tsx bin/kody2.ts",
+    "kody": "tsx bin/kody.ts",
     "build": "tsup && node scripts/copy-assets.cjs",
     "test": "vitest run tests/unit tests/int --no-coverage",
     "test:e2e": "vitest run tests/e2e --no-coverage",

package/templates/{kody2.yml → kody.yml}

@@ -1,28 +1,28 @@
-# Drop this file at .github/workflows/kody2.yml in your repo.
+# Drop this file at .github/workflows/kody.yml in your repo.
 #
 # Two triggers, two modes:
-#   - issue_comment / workflow_dispatch with issue_number → `kody2 ci`
-#     (the @kody2 issue/PR automation flow)
-#   - workflow_dispatch with sessionId                    → `kody2 chat`
+#   - issue_comment / workflow_dispatch with issue_number → `kody ci`
+#     (the @kody issue/PR automation flow)
+#   - workflow_dispatch with sessionId                    → `kody chat`
 #     (dashboard-driven Gemini chat session)
 #
-# All orchestration lives in the kody2 npm package; future capabilities ship
+# All orchestration lives in the kody npm package; future capabilities ship
 # via `npm publish`, not by editing this file.
 #
 # Required repo secrets: at least one model provider key (e.g. MINIMAX_API_KEY,
-# ANTHROPIC_API_KEY). kody2 reads any *_API_KEY secret automatically via
+# ANTHROPIC_API_KEY). kody reads any *_API_KEY secret automatically via
 # toJSON(secrets) — no need to list them here.
 #
 # Recommended: KODY_TOKEN secret — a fine-grained PAT or GitHub App token
-# with `repo` + `read:org` + `workflow` scopes. Without it, kody2's
+# with `repo` + `read:org` + `workflow` scopes. Without it, kody's
 # commits/PR-creation still work via github.token, but three things degrade:
 #   1. PR body updates fail with "token lacks read:org scope" (cosmetic).
-#   2. Pushes from kody2 won't trigger downstream workflows.
+#   2. Pushes from kody won't trigger downstream workflows.
 #   3. Any commit that modifies `.github/workflows/*` is REJECTED by
 #      GitHub — the default GITHUB_TOKEN can't touch workflow files.
 # Set KODY_TOKEN in repo Settings → Secrets → Actions.
 
-name: kody2
+name: kody
 
 on:
   workflow_dispatch:
@@ -55,13 +55,13 @@ jobs:
     if: >-
       ${{ github.event_name == 'workflow_dispatch' ||
           (github.event_name == 'issue_comment' &&
-            contains(github.event.comment.body, '@kody2') &&
-            github.event.comment.user.login != 'kody2-bot' &&
+            contains(github.event.comment.body, '@kody') &&
+            github.event.comment.user.login != 'kody-bot' &&
             github.event.comment.user.type != 'Bot') }}
     runs-on: ubuntu-latest
     timeout-minutes: 360
     concurrency:
-      group: kody2-${{ inputs.sessionId || inputs.issue_number || github.event.issue.number || github.sha }}
+      group: kody-${{ inputs.sessionId || inputs.issue_number || github.event.issue.number || github.sha }}
       cancel-in-progress: false
     permissions:
       issues: write
@@ -78,13 +78,13 @@ jobs:
           node-version: 22
 
       - name: Write pip cache key for LiteLLM
-        run: echo "litellm[proxy]" > .kody2-pip-requirements.txt
+        run: echo "litellm[proxy]" > .kody-pip-requirements.txt
 
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
           cache: "pip"
-          cache-dependency-path: .kody2-pip-requirements.txt
+          cache-dependency-path: .kody-pip-requirements.txt
 
       - env:
           ALL_SECRETS:   ${{ toJSON(secrets) }}
@@ -94,7 +94,7 @@ jobs:
           DASHBOARD_URL: ${{ inputs.dashboardUrl }}
         run: |
           if [ -n "$SESSION_ID" ]; then
-            npx -y -p @kody-ade/kody-engine@latest kody2 chat
+            npx -y -p @kody-ade/kody-engine@latest kody chat
           else
-            npx -y -p @kody-ade/kody-engine@latest kody2 ci
+            npx -y -p @kody-ade/kody-engine@latest kody ci
           fi