@kody-ade/kody-engine-lite 0.1.59 → 0.1.61

package/README.md

@@ -138,23 +138,19 @@ Comment on any GitHub issue:
 
 ### Switch to a different model (optional)
 
-Add `litellm-config.yaml` to route all tiers through MiniMax (or any LLM):
-
-```yaml
-# litellm-config.yaml
-model_list:
-  - model_name: claude-haiku-4-5-20251001
-    litellm_params:
-      model: minimax/MiniMax-M2.7-highspeed
-      api_key: os.environ/MINIMAX_API_KEY
-```
+Set the `provider` field in `kody.config.json` — Kody auto-generates the LiteLLM config, starts the proxy, and routes all stages through your provider:
 
 ```json
-// kody.config.json — add litellmUrl
-{ "agent": { "litellmUrl": "http://localhost:4000" } }
+// kody.config.json — use MiniMax (or any LLM)
+{ "agent": { "provider": "minimax" } }
+```
+
+Add the provider's API key to `.env`:
+```
+MINIMAX_API_KEY=your-key-here
 ```
 
-Kody auto-starts the proxy and loads API keys from `.env`. [Full LiteLLM guide →](docs/LITELLM.md)
+That's it. Kody auto-starts the LiteLLM proxy and loads API keys from `.env`. For advanced routing (different models per tier, custom config), add a `litellm-config.yaml`. [Full LiteLLM guide →](docs/LITELLM.md)
 
 ## Commands
 
@@ -167,16 +163,18 @@ Kody auto-starts the proxy and loads API keys from `.env`. [Full LiteLLM guide
 | `@kody fix` | Re-run from build stage. Write feedback in the comment body — it gets injected into the build prompt |
 | `@kody rerun` | Resume from the failed or paused stage |
 | `@kody rerun --from <stage>` | Resume from a specific stage |
+| `@kody bootstrap` | Regenerate project memory and step files |
 
 ### CLI
 
 ```bash
+kody-engine-lite init [--force]          # Setup repo: workflow, config, memory, step files
+kody-engine-lite bootstrap               # Regenerate memory + step files (runs in GH Actions)
 kody-engine-lite run --issue-number 42 --local --cwd ./project
 kody-engine-lite run --task "Add retry utility" --local
 kody-engine-lite fix --issue-number 42 --feedback "Use middleware pattern"
 kody-engine-lite rerun --issue-number 42 --from verify
 kody-engine-lite status --task-id 42-260327-102254
-kody-engine-lite init [--force]
 ```
 
 ## Key Features

package/dist/bin/cli.js

@@ -114,17 +114,15 @@ function createRunners(config) {
   if (config.agent.runners && Object.keys(config.agent.runners).length > 0) {
     const runners = {};
     for (const [name, runnerConfig] of Object.entries(config.agent.runners)) {
-      const factory2 = RUNNER_FACTORIES[runnerConfig.type];
-      if (factory2) {
-        runners[name] = factory2();
+      const factory = RUNNER_FACTORIES[runnerConfig.type];
+      if (factory) {
+        runners[name] = factory();
       }
     }
     return runners;
   }
-  const runnerType = config.agent.runner ?? "claude-code";
-  const factory = RUNNER_FACTORIES[runnerType];
   const defaultName = config.agent.defaultRunner ?? "claude";
-  return { [defaultName]: factory ? factory() : createClaudeCodeRunner() };
+  return { [defaultName]: createClaudeCodeRunner() };
 }
 var SIGKILL_GRACE_MS, STDERR_TAIL_CHARS, RUNNER_FACTORIES;
 var init_agent_runner = __esm({
@@ -253,12 +251,10 @@ var init_logger = __esm({
 import * as fs from "fs";
 import * as path from "path";
 function needsLitellmProxy(config) {
-  if (config.agent.litellmUrl) return true;
-  if (config.agent.provider && config.agent.provider !== "anthropic") return true;
-  return false;
+  return !!(config.agent.provider && config.agent.provider !== "anthropic");
 }
-function getLitellmUrl(config) {
-  return config.agent.litellmUrl ?? LITELLM_DEFAULT_URL;
+function getLitellmUrl() {
+  return LITELLM_DEFAULT_URL;
 }
 function providerApiKeyEnvVar(provider) {
   return `${provider.toUpperCase()}_API_KEY`;
@@ -277,7 +273,6 @@ function getProjectConfig() {
         quality: { ...DEFAULT_CONFIG.quality, ...raw.quality },
         git: { ...DEFAULT_CONFIG.git, ...raw.git },
         github: { ...DEFAULT_CONFIG.github, ...raw.github },
-        paths: { ...DEFAULT_CONFIG.paths, ...raw.paths },
         agent: { ...DEFAULT_CONFIG.agent, ...raw.agent },
         contextTiers: raw.contextTiers ? { ...DEFAULT_CONFIG.contextTiers, ...raw.contextTiers } : DEFAULT_CONFIG.contextTiers
       };
@@ -300,7 +295,6 @@ var init_config = __esm({
         typecheck: "pnpm -s tsc --noEmit",
         lint: "pnpm -s lint",
         lintFix: "pnpm lint:fix",
-        format: "pnpm -s format:check",
         formatFix: "pnpm format:fix",
         testUnit: "pnpm -s test"
       },
@@ -311,12 +305,7 @@ var init_config = __esm({
         owner: "",
         repo: ""
       },
-      paths: {
-        taskDir: ".kody/tasks"
-      },
       agent: {
-        runner: "claude-code",
-        defaultRunner: "claude",
         modelMap: { cheap: "haiku", mid: "sonnet", strong: "opus" }
       },
       contextTiers: {
@@ -1238,8 +1227,8 @@ ${prompt}` : prompt;
 }
 function resolveModel(modelTier, stageName) {
   const config = getProjectConfig();
-  if (config.agent.usePerStageRouting && stageName) {
-    return stageName;
+  if (config.agent.provider && config.agent.provider !== "anthropic") {
+    return DEFAULT_MODEL_MAP[modelTier] ?? "sonnet";
   }
   const mapped = config.agent.modelMap[modelTier];
   if (mapped) return mapped;
@@ -1369,7 +1358,7 @@ async function executeAgentStage(ctx, def) {
   logger.info(`  runner=${runnerName} model=${model} timeout=${def.timeout / 1e3}s`);
   const extraEnv = {};
   if (needsLitellmProxy(config)) {
-    extraEnv.ANTHROPIC_BASE_URL = getLitellmUrl(config);
+    extraEnv.ANTHROPIC_BASE_URL = getLitellmUrl();
   }
   const sessions = ctx.sessions ?? {};
   const sessionInfo = getSessionInfo(def.name, sessions);
@@ -1748,8 +1737,8 @@ async function executeVerifyWithAutofix(ctx, def) {
       const defaultRunner = getRunnerForStage(ctx, "taskify");
       const diagConfig = getProjectConfig();
       const diagEnv = {};
-      if (diagConfig.agent.litellmUrl) {
-        diagEnv.ANTHROPIC_BASE_URL = diagConfig.agent.litellmUrl;
+      if (needsLitellmProxy(diagConfig)) {
+        diagEnv.ANTHROPIC_BASE_URL = getLitellmUrl();
       }
       const diagnosis = await diagnoseFailure(
         "verify",
@@ -2534,8 +2523,8 @@ ${previousText}
     const model = resolveModel("cheap");
     const config = getProjectConfig();
     const extraEnv = {};
-    if (config.agent.litellmUrl) {
-      extraEnv.ANTHROPIC_BASE_URL = config.agent.litellmUrl;
+    if (needsLitellmProxy(config)) {
+      extraEnv.ANTHROPIC_BASE_URL = getLitellmUrl();
     }
     const result = await runner.run("retrospective", prompt, model, 3e4, "", {
       cwd: ctx.projectDir,
@@ -3271,7 +3260,7 @@ import * as fs21 from "fs";
 import * as path20 from "path";
 async function ensureLitellmProxy(config, projectDir) {
   if (!needsLitellmProxy(config)) return null;
-  const litellmUrl = getLitellmUrl(config);
+  const litellmUrl = getLitellmUrl();
   const proxyRunning = await checkLitellmHealth(litellmUrl);
   let litellmProcess = null;
   if (!proxyRunning) {
@@ -3767,16 +3756,13 @@ function buildConfig(cwd, basic) {
       typecheck: find("typecheck", "type-check") || (pkg.devDependencies?.typescript ? `${basic.pm} tsc --noEmit` : ""),
       lint: find("lint"),
       lintFix: find("lint:fix", "lint-fix"),
-      format: find("format:check"),
       formatFix: find("format", "format:fix"),
       testUnit: find("test:unit", "test", "test:ci")
     },
     git: { defaultBranch: basic.defaultBranch },
     github: { owner: basic.owner, repo: basic.repo },
-    paths: { taskDir: ".kody/tasks" },
     agent: {
-      runner: "claude-code",
-      defaultRunner: "claude",
+      provider: "anthropic",
       modelMap: { cheap: "haiku", mid: "sonnet", strong: "opus" }
     }
   };
@@ -3855,55 +3841,8 @@ function initCommand(opts) {
         console.log(`  \u2717 ${c.name} \u2014 ${c.fix}`);
       }
     }
-    const labels = [
-      { name: "kody:planning", color: "c5def5", description: "Kody is analyzing and planning" },
-      { name: "kody:building", color: "0e8a16", description: "Kody is building code" },
-      { name: "kody:review", color: "fbca04", description: "Kody is reviewing code" },
-      { name: "kody:done", color: "0e8a16", description: "Kody completed successfully" },
-      { name: "kody:failed", color: "d93f0b", description: "Kody pipeline failed" },
-      { name: "kody:waiting", color: "fef2c0", description: "Kody is waiting for answers" },
-      { name: "kody:low", color: "bfdadc", description: "Low complexity \u2014 skip plan/review" },
-      { name: "kody:medium", color: "c5def5", description: "Medium complexity \u2014 skip review-fix" },
-      { name: "kody:high", color: "d4c5f9", description: "High complexity \u2014 full pipeline" },
-      { name: "kody:feature", color: "0e8a16", description: "New feature" },
-      { name: "kody:bugfix", color: "d93f0b", description: "Bug fix" },
-      { name: "kody:refactor", color: "fbca04", description: "Code refactoring" },
-      { name: "kody:docs", color: "0075ca", description: "Documentation" },
-      { name: "kody:chore", color: "e4e669", description: "Maintenance task" }
-    ];
     console.log("\n\u2500\u2500 Labels \u2500\u2500");
-    for (const label of labels) {
-      try {
-        execFileSync11("gh", [
-          "label",
-          "create",
-          label.name,
-          "--repo",
-          repoSlug,
-          "--color",
-          label.color,
-          "--description",
-          label.description,
-          "--force"
-        ], {
-          encoding: "utf-8",
-          timeout: 1e4,
-          stdio: ["pipe", "pipe", "pipe"]
-        });
-        console.log(`  \u2713 ${label.name}`);
-      } catch {
-        try {
-          execFileSync11("gh", ["label", "list", "--repo", repoSlug, "--search", label.name], {
-            encoding: "utf-8",
-            timeout: 1e4,
-            stdio: ["pipe", "pipe", "pipe"]
-          });
-          console.log(`  \u25CB ${label.name} (exists)`);
-        } catch {
-          console.log(`  \u2717 ${label.name} \u2014 failed to create`);
-        }
-      }
-    }
+    console.log("  \u25CB Labels will be created automatically during bootstrap");
   }
   console.log("\n\u2500\u2500 Config \u2500\u2500");
   if (fs22.existsSync(configDest)) {
@@ -4292,6 +4231,76 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
     }
   }
   console.log(`  \u2713 Generated ${stepCount} step files in .kody/steps/`);
+  console.log("\n\u2500\u2500 Labels \u2500\u2500");
+  try {
+    let repoSlug = "";
+    try {
+      const configPath = path21.join(cwd, "kody.config.json");
+      if (fs22.existsSync(configPath)) {
+        const config = JSON.parse(fs22.readFileSync(configPath, "utf-8"));
+        if (config.github?.owner && config.github?.repo) {
+          repoSlug = `${config.github.owner}/${config.github.repo}`;
+        }
+      }
+    } catch {
+    }
+    if (repoSlug) {
+      const labels = [
+        { name: "kody:planning", color: "c5def5", description: "Kody is analyzing and planning" },
+        { name: "kody:building", color: "0e8a16", description: "Kody is building code" },
+        { name: "kody:review", color: "fbca04", description: "Kody is reviewing code" },
+        { name: "kody:done", color: "0e8a16", description: "Kody completed successfully" },
+        { name: "kody:failed", color: "d93f0b", description: "Kody pipeline failed" },
+        { name: "kody:waiting", color: "fef2c0", description: "Kody is waiting for answers" },
+        { name: "kody:low", color: "bfdadc", description: "Low complexity \u2014 skip plan/review" },
+        { name: "kody:medium", color: "c5def5", description: "Medium complexity \u2014 skip review-fix" },
+        { name: "kody:high", color: "d4c5f9", description: "High complexity \u2014 full pipeline" },
+        { name: "kody:feature", color: "0e8a16", description: "New feature" },
+        { name: "kody:bugfix", color: "d93f0b", description: "Bug fix" },
+        { name: "kody:refactor", color: "fbca04", description: "Code refactoring" },
+        { name: "kody:docs", color: "0075ca", description: "Documentation" },
+        { name: "kody:chore", color: "e4e669", description: "Maintenance task" }
+      ];
+      for (const label of labels) {
+        try {
+          execFileSync11("gh", [
+            "label",
+            "create",
+            label.name,
+            "--repo",
+            repoSlug,
+            "--color",
+            label.color,
+            "--description",
+            label.description,
+            "--force"
+          ], {
+            cwd,
+            encoding: "utf-8",
+            timeout: 1e4,
+            stdio: ["pipe", "pipe", "pipe"]
+          });
+          console.log(`  \u2713 ${label.name}`);
+        } catch {
+          try {
+            execFileSync11("gh", ["label", "list", "--repo", repoSlug, "--search", label.name], {
+              cwd,
+              encoding: "utf-8",
+              timeout: 1e4,
+              stdio: ["pipe", "pipe", "pipe"]
+            });
+            console.log(`  \u25CB ${label.name} (exists)`);
+          } catch {
+            console.log(`  \u2717 ${label.name} \u2014 failed to create`);
+          }
+        }
+      }
+    } else {
+      console.log("  \u25CB Skipped \u2014 could not determine repo from kody.config.json");
+    }
+  } catch {
+    console.log("  \u25CB Label creation skipped");
+  }
   console.log("\n\u2500\u2500 Git \u2500\u2500");
   const filesToCommit = [
     ".kody/memory/architecture.md",

package/kody.config.schema.json

@@ -23,11 +23,6 @@
           "description": "Auto-fix lint command, run when verify fails (e.g., 'pnpm lint:fix')",
           "default": ""
         },
-        "format": {
-          "type": "string",
-          "description": "Format check command (e.g., 'pnpm format:check'). Empty to skip.",
-          "default": ""
-        },
         "formatFix": {
           "type": "string",
           "description": "Auto-fix format command, run when verify fails (e.g., 'pnpm format')",
@@ -49,14 +44,6 @@
           "type": "string",
           "description": "Default branch for PR base and branch syncing (e.g., 'main', 'dev')",
           "default": "dev"
-        },
-        "userEmail": {
-          "type": "string",
-          "description": "Git user email for CI commits (optional, defaults to github-actions bot)"
-        },
-        "userName": {
-          "type": "string",
-          "description": "Git user name for CI commits (optional, defaults to github-actions bot)"
         }
       },
       "additionalProperties": false
@@ -76,50 +63,27 @@
       },
       "additionalProperties": false
     },
-    "paths": {
-      "type": "object",
-      "description": "File path configuration",
-      "properties": {
-        "taskDir": {
-          "type": "string",
-          "description": "Directory for pipeline artifacts and state (committed to branch)",
-          "default": ".kody/tasks"
-        }
-      },
-      "additionalProperties": false
-    },
     "agent": {
       "type": "object",
       "description": "Agent execution configuration",
       "properties": {
-        "runner": {
-          "type": "string",
-          "description": "Agent runner type",
-          "enum": ["claude-code"],
-          "default": "claude-code"
-        },
-        "defaultRunner": {
-          "type": "string",
-          "description": "Name of the default runner to use",
-          "default": "claude"
-        },
         "modelMap": {
           "type": "object",
-          "description": "Maps model tiers to actual model names. Use LiteLLM aliases when litellmUrl is set.",
+          "description": "Maps model tiers to actual model names. When provider is set, values should be the provider's model names.",
           "properties": {
             "cheap": {
               "type": "string",
-              "description": "Fast/cheap model for taskify stage (e.g., 'haiku' or LiteLLM alias)",
+              "description": "Fast/cheap model for taskify stage (e.g., 'haiku' or provider model name)",
               "default": "haiku"
             },
             "mid": {
               "type": "string",
-              "description": "Mid-tier model for build, review-fix, autofix (e.g., 'sonnet' or LiteLLM alias)",
+              "description": "Mid-tier model for build, review-fix, autofix (e.g., 'sonnet' or provider model name)",
               "default": "sonnet"
             },
             "strong": {
               "type": "string",
-              "description": "Strongest model for plan, review — deep reasoning (e.g., 'opus' or LiteLLM alias)",
+              "description": "Strongest model for plan, review — deep reasoning (e.g., 'opus' or provider model name)",
               "default": "opus"
             }
           },
@@ -130,15 +94,10 @@
           "description": "LLM provider name. When set (and not 'anthropic'), engine auto-starts LiteLLM proxy and routes model calls to this provider. modelMap values should be the provider's model names.",
           "examples": ["anthropic", "minimax", "openai", "google"]
         },
-        "litellmUrl": {
+        "defaultRunner": {
           "type": "string",
-          "description": "(Deprecated) Use 'provider' instead. LiteLLM proxy URL for manual setup.",
-          "examples": ["http://localhost:4000"]
-        },
-        "usePerStageRouting": {
-          "type": "boolean",
-          "description": "When true, uses stage name as the LiteLLM model alias instead of modelMap tier",
-          "default": false
+          "description": "Name of the default runner when multiple runners are configured (advanced)",
+          "default": "claude"
         },
         "runners": {
           "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine-lite",
-  "version": "0.1.59",
+  "version": "0.1.61",
   "description": "Autonomous SDLC pipeline: Kody orchestration + Claude Code + LiteLLM",
   "license": "MIT",
   "type": "module",