@kody-ade/kody-engine 0.1.7 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aharon Yair Cohen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,76 +1,43 @@
 # @kody-ade/kody-engine
 
-Multi-agent CI/CD pipeline engine that converts GitHub issues into pull requests.
+`kody2` — autonomous development engine. A single-session Claude Code agent behind a generic executor and declarative JSON executable profiles.
 
-## Quick Start
+## Architecture
 
-```bash
-# Initialize Kody in your repo
-npx @kody-ade/kody-engine init
+```
+┌─────────────────────────────────────────────┐
+│ Consumer repo workflow (.github/kody2.yml)  │  triggers on @kody2 comments
+└─────────────────────────────────────────────┘
+                    ↓
+┌─────────────────────────────────────────────┐
+│ kody2 CLI (@kody-ade/kody-engine)           │
+│   bin/kody2.ts — parses argv                │
+│   src/executor.ts — runs one profile        │
+│   src/executables/build/profile.json        │
+│   src/scripts/*.ts — named hook catalog     │
+└─────────────────────────────────────────────┘
 ```
 
-This sets up:
-
-- `.github/workflows/kody.yml` — GitHub Actions workflow
-- `.opencode/` — Agent prompt definitions
-- `kody.config.json` — Pipeline configuration
+`run`/`fix`/`fix-ci`/`resolve` are four modes of the same `build` executable, selected by `args.mode` via `runWhen` on preflight script entries. Executor knows nothing about any specific mode.
 
-## Setup
+## Install in a consumer repo
 
-1. Run `npx @kody-ade/kody-engine init` in your repo
-2. Edit `kody.config.json` with your repo details
-3. Add LLM API keys as GitHub repo secrets (e.g., `MINIMAX_API_KEY`)
-4. Commit and push the workflow file
-5. Comment `@kody` on any issue to run the pipeline
+1. Copy `templates/kody2.yml` to `.github/workflows/kody2.yml`.
+2. Add `agent.model` to `kody.config.json` (see `kody.config.schema.json`).
+3. Secrets on the repo:
+   - At least one model key (e.g. `MINIMAX_API_KEY`, `ANTHROPIC_API_KEY`)
+   - Optional `KODY_TOKEN` PAT if you want kody2's pushes to trigger downstream CI
 
 ## Commands
 
-```bash
-# Initialize in target repo
-kody-engine init [--force] [--workflow-only]
-
-# Run pipeline (used by CI workflow)
-kody-engine run
-
-# CI helper commands
-kody-engine parse-safety
-kody-engine parse-inputs
-kody-engine checkout-branch
-```
-
-## Usage on GitHub Issues
-
 ```
-@kody                     # Full pipeline (spec + implementation)
-@kody spec                # Analyze and spec only
-@kody impl                # Implementation only
-@kody rerun --from build  # Resume from stage
-@kody approve             # Approve paused gate
+kody2 run     --issue <N>                  # implement an issue
+kody2 fix     --pr    <N> [--feedback ...]  # apply PR review feedback
+kody2 fix-ci  --pr    <N> [--run-id <ID>]   # fix failing CI
+kody2 resolve --pr    <N>                   # merge default branch in, resolve conflicts
+kody2 ci      --issue <N>                   # CI preflight + run
 ```
 
-## Configuration
-
-`kody.config.json`:
-
-```json
-{
-  "quality": {
-    "typecheck": "pnpm tsc --noEmit",
-    "lint": "pnpm lint",
-    "testUnit": "pnpm test:unit"
-  },
-  "git": { "defaultBranch": "dev" },
-  "github": { "owner": "your-org", "repo": "your-repo" }
-}
-```
-
-## Required Secrets
-
-| Secret            | Purpose                                                                   |
-| ----------------- | ------------------------------------------------------------------------- |
-| `MINIMAX_API_KEY` | LLM provider (or `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`) |
-| `GH_PAT`          | Optional: cross-repo operations                                           |
-
-## License
+## Profiles
 
-MIT
+A profile is declarative JSON + an adjacent prompt. See `src/executables/build/profile.json`. Adding a new role = new profile + new prompt + registering any new scripts under `src/scripts/`. No executor changes.