@kody-ade/kody-engine-lite 0.1.8 → 0.1.10

package/README.md

@@ -112,7 +112,7 @@ git push
 Then comment on any issue:
 
 ```
-@kody full my-task-id
+@kody
 ```
 
 ## CLI Usage
@@ -121,19 +121,25 @@ Then comment on any issue:
 
 ```bash
 # Run against current directory
-kody-engine-lite run --task-id my-task --task "Add a sum function to src/math.ts with tests"
+kody-engine-lite run --task "Add a sum function to src/math.ts with tests"
 
 # Run against a different project
-kody-engine-lite run --task-id my-task --task "Add feature X" --cwd /path/to/project
+kody-engine-lite run --task "Add feature X" --cwd /path/to/project
 
 # Run from a GitHub issue (fetches issue body as task)
-kody-engine-lite run --task-id my-task --issue-number 1 --cwd /path/to/project
+kody-engine-lite run --issue-number 1 --cwd /path/to/project
 
 # Dry run (no agent calls)
-kody-engine-lite run --task-id my-task --task "Test" --dry-run
+kody-engine-lite run --task "Test" --dry-run
 
-# Resume from a failed stage
-kody-engine-lite rerun --task-id my-task --from review
+# Resume from a failed/paused stage (auto-detects which stage)
+kody-engine-lite rerun --issue-number 1
+
+# Fix — rerun from build stage (skip taskify/plan)
+kody-engine-lite fix --issue-number 1
+
+# Fix with feedback
+kody-engine-lite fix --issue-number 1 --feedback "Use middleware pattern instead"
 
 # Check pipeline status
 kody-engine-lite status --task-id my-task
@@ -154,9 +160,11 @@ Comment on any issue:
 ```
 @kody                                     # Run full pipeline (auto-generates task-id)
 @kody full <task-id>                      # Run with specific task-id
-@kody rerun --from <stage>                # Resume latest task from stage
-@kody rerun <task-id> --from <stage>      # Resume specific task
-@kody approve                             # Approve + provide answers to Kody's questions
+@kody rerun                               # Resume latest task (auto-detects stage)
+@kody rerun --from <stage>                # Resume from specific stage
+@kody fix                                 # Re-build from build stage (skip taskify/plan)
+@kody fix --feedback "Use X instead of Y" # Fix with specific guidance
+@kody approve                             # Approve + provide answers to questions
 @kody status <task-id>                    # Check status
 ```
 
@@ -195,6 +203,15 @@ Kody resumes automatically from where it paused, with your answers injected as c
 | review-fix | sonnet | Applies known fixes from review findings |
 | ship | — | Pushes branch + creates PR + comments on issue |
 
+### Branch Syncing
+
+On every run/rerun/fix, Kody automatically:
+1. Checks out (or creates) the feature branch
+2. Pulls latest from the default branch and merges into the feature branch
+3. If there's a merge conflict, skips the sync and warns
+
+This ensures the feature branch is always up-to-date before building.
+
 ### Automatic Loops
 
 - **Verify + autofix**: If verify fails, runs lint-fix + format-fix + autofix agent, retries up to 2 times

package/dist/bin/cli.js

@@ -588,6 +588,27 @@ function ensureFeatureBranch(issueNumber, title, cwd) {
   logger.info(`  Created new branch: ${branchName}`);
   return branchName;
 }
+function syncWithDefault(cwd) {
+  const defaultBranch = getDefaultBranch(cwd);
+  const current = getCurrentBranch(cwd);
+  if (current === defaultBranch) return;
+  try {
+    git(["fetch", "origin", defaultBranch], { cwd, timeout: 3e4 });
+  } catch {
+    logger.warn("  Failed to fetch latest from origin");
+    return;
+  }
+  try {
+    git(["merge", `origin/${defaultBranch}`, "--no-edit"], { cwd, timeout: 3e4 });
+    logger.info(`  Synced with origin/${defaultBranch}`);
+  } catch {
+    try {
+      git(["merge", "--abort"], { cwd });
+    } catch {
+    }
+    logger.warn(`  Merge conflict with origin/${defaultBranch} \u2014 skipping sync`);
+  }
+}
 function commitAll(message, cwd) {
   const status = git(["status", "--porcelain"], { cwd });
   if (!status) {
@@ -1197,8 +1218,9 @@ async function runPipeline(ctx) {
       const taskMdPath = path4.join(ctx.taskDir, "task.md");
       const title = fs4.existsSync(taskMdPath) ? fs4.readFileSync(taskMdPath, "utf-8").split("\n")[0].slice(0, 50) : ctx.taskId;
       ensureFeatureBranch(ctx.input.issueNumber, title, ctx.projectDir);
+      syncWithDefault(ctx.projectDir);
     } catch (err) {
-      logger.warn(`  Failed to create feature branch: ${err}`);
+      logger.warn(`  Failed to create/sync feature branch: ${err}`);
     }
   }
   let complexity = ctx.input.complexity ?? "high";
@@ -1628,12 +1650,13 @@ function parseArgs() {
     console.log(`Usage:
   kody run    --task-id <id> [--task "<desc>"] [--cwd <path>] [--issue-number <n>] [--complexity low|medium|high] [--feedback "<text>"] [--local] [--dry-run]
   kody rerun  --task-id <id> --from <stage> [--cwd <path>] [--issue-number <n>]
+  kody fix    --task-id <id> [--cwd <path>] [--issue-number <n>] [--feedback "<text>"]
   kody status --task-id <id> [--cwd <path>]
   kody --help`);
     process.exit(0);
   }
   const command2 = args2[0];
-  if (!["run", "rerun", "status"].includes(command2)) {
+  if (!["run", "rerun", "fix", "status"].includes(command2)) {
     console.error(`Unknown command: ${command2}`);
     process.exit(1);
   }
@@ -1678,7 +1701,7 @@ async function main() {
   }
   let taskId = input.taskId;
   if (!taskId) {
-    if (input.command === "rerun" && input.issueNumber) {
+    if ((input.command === "rerun" || input.command === "fix") && input.issueNumber) {
       const found = findLatestTaskForIssue(input.issueNumber, projectDir);
       if (!found) {
         console.error(`No previous task found for issue #${input.issueNumber}`);
@@ -1724,6 +1747,9 @@ ${issue.body ?? ""}`;
       process.exit(1);
     }
   }
+  if (input.command === "fix" && !input.fromStage) {
+    input.fromStage = "build";
+  }
   if (input.command === "rerun" && !input.fromStage) {
     const statusPath = path5.join(taskDir, "status.json");
     if (fs6.existsSync(statusPath)) {
@@ -1781,7 +1807,7 @@ ${issue.body ?? ""}`;
     projectDir,
     runners,
     input: {
-      mode: input.command === "rerun" ? "rerun" : "full",
+      mode: input.command === "rerun" || input.command === "fix" ? "rerun" : "full",
       fromStage: input.fromStage,
       dryRun: input.dryRun,
       issueNumber: input.issueNumber,
@@ -1814,6 +1840,12 @@ Artifacts in ${taskDir}:`);
     console.log(`  ${f}`);
   }
   if (state.state === "failed") {
+    const isPaused = Object.values(state.stages).some(
+      (s) => typeof s === "object" && s !== null && "error" in s && typeof s.error === "string" && s.error.includes("paused")
+    );
+    if (isPaused) {
+      process.exit(0);
+    }
     if (ctx.input.issueNumber && !ctx.input.local) {
       const failedStage = Object.entries(state.stages).find(
         ([, s]) => s.state === "failed" || s.state === "timeout"
@@ -2192,6 +2224,7 @@ ${context}`;
     if (!config.agent.modelMap) {
       config.agent.modelMap = { cheap: "haiku", mid: "sonnet", strong: "opus" };
     }
+    validateQualityCommands(cwd, config, basic.pm);
     return {
       config,
       architecture: parsed.architecture ?? "",
@@ -2206,6 +2239,40 @@ ${context}`;
     };
   }
 }
+function validateQualityCommands(cwd, config, pm) {
+  let scripts = {};
+  try {
+    const pkg = JSON.parse(fs7.readFileSync(path6.join(cwd, "package.json"), "utf-8"));
+    scripts = pkg.scripts ?? {};
+  } catch {
+    return;
+  }
+  const quality = config.quality ?? {};
+  const overrides = [
+    { key: "typecheck", preferred: ["typecheck", "type-check"] },
+    { key: "lint", preferred: ["lint"] },
+    { key: "lintFix", preferred: ["lint:fix", "lint-fix"] },
+    { key: "format", preferred: ["format:check", "format-check", "prettier:check"] },
+    { key: "formatFix", preferred: ["format", "format:fix", "format-fix"] },
+    { key: "testUnit", preferred: ["test:unit", "test-unit", "test:ci"] }
+  ];
+  for (const { key, preferred } of overrides) {
+    const match = preferred.find((s) => scripts[s]);
+    if (match) {
+      const correct = `${pm} ${match}`;
+      if (quality[key] !== correct) {
+        quality[key] = correct;
+      }
+    }
+    if (quality[key]) {
+      const scriptName = quality[key].replace(`${pm} `, "");
+      if (scriptName && !scripts[scriptName] && !scriptName.includes(" ")) {
+        quality[key] = "";
+      }
+    }
+  }
+  config.quality = quality;
+}
 function buildFallbackConfig(cwd, basic) {
   const pkg = (() => {
     try {

package/package.json

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

package/templates/kody.yml

@@ -103,7 +103,7 @@ jobs:
 
           # Validate mode
           case "$MODE" in
-            full|rerun|status|approve) ;;
+            full|rerun|fix|status|approve) ;;
             *)
               # If first arg isn't a mode, it might be a task-id or nothing
               if [ -n "$MODE" ] && [ "$MODE" != "" ]; then
@@ -196,7 +196,15 @@ jobs:
           FEEDBACK: ${{ github.event.inputs.feedback || needs.parse.outputs.feedback }}
           DRY_RUN: ${{ github.event.inputs.dry_run || 'false' }}
           RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-        run: kody-engine-lite run --task-id "$TASK_ID" --issue-number "$ISSUE_NUMBER"
+        run: |
+          CMD="run"
+          [ "$MODE" = "rerun" ] && CMD="rerun"
+          [ "$MODE" = "fix" ] && CMD="fix"
+          ARGS="--task-id $TASK_ID --issue-number $ISSUE_NUMBER"
+          [ -n "$FROM_STAGE" ] && ARGS="$ARGS --from $FROM_STAGE"
+          [ -n "$FEEDBACK" ] && ARGS="$ARGS --feedback \"$FEEDBACK\""
+          [ "$DRY_RUN" = "true" ] && ARGS="$ARGS --dry-run"
+          kody-engine-lite $CMD $ARGS
 
       - name: Pipeline summary
         if: always()