@kody-ade/kody-engine-lite 0.1.66 → 0.1.68

package/dist/bin/cli.js

@@ -679,6 +679,45 @@ function submitPRReview(prNumber, body, event) {
     logger.warn(`  Failed to submit PR review: ${err}`);
   }
 }
+function getCIFailureLogs(runId, maxLength = 8e3) {
+  try {
+    const logsOutput = gh([
+      "run",
+      "view",
+      String(runId),
+      "--log-failed"
+    ]);
+    if (!logsOutput) return null;
+    const truncated = logsOutput.slice(-maxLength);
+    const prefix = logsOutput.length > maxLength ? "...(earlier output truncated)\n" : "";
+    return `${prefix}${truncated}`;
+  } catch (err) {
+    logger.warn(`  Failed to get CI failure logs for run ${runId}: ${err}`);
+    return null;
+  }
+}
+function getLatestFailedRunForBranch(branch) {
+  try {
+    const output = gh([
+      "run",
+      "list",
+      "--branch",
+      branch,
+      "--status",
+      "failure",
+      "--limit",
+      "1",
+      "--json",
+      "databaseId",
+      "--jq",
+      ".[0].databaseId"
+    ]);
+    return output.trim() || null;
+  } catch (err) {
+    logger.warn(`  Failed to get latest failed run for branch ${branch}: ${err}`);
+    return null;
+  }
+}
 function getLatestKodyReviewComment(prNumber) {
   try {
     const output = gh([
@@ -3203,13 +3242,14 @@ function parseArgs() {
   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 fix-ci [--pr-number <n>] [--ci-run-id <id>] [--cwd <path>] [--issue-number <n>] [--feedback "<text>"]
   kody review [--pr-number <n>] [--issue-number <n>] [--cwd <path>] [--local]
   kody status --task-id <id> [--cwd <path>]
   kody --help`);
     process.exit(0);
   }
   const command2 = args2[0];
-  if (!["run", "rerun", "fix", "status", "review"].includes(command2)) {
+  if (!["run", "rerun", "fix", "fix-ci", "status", "review"].includes(command2)) {
     console.error(`Unknown command: ${command2}`);
     process.exit(1);
   }
@@ -3227,7 +3267,8 @@ function parseArgs() {
     prNumber: prStr ? parseInt(prStr, 10) : void 0,
     feedback: getArg(args2, "--feedback") ?? process.env.FEEDBACK,
     local: localFlag || !isCI2 && !hasFlag(args2, "--no-local"),
-    complexity: getArg(args2, "--complexity") ?? process.env.COMPLEXITY
+    complexity: getArg(args2, "--complexity") ?? process.env.COMPLEXITY,
+    ciRunId: getArg(args2, "--ci-run-id") ?? process.env.CI_RUN_ID
   };
 }
 var isCI2;
@@ -3463,7 +3504,7 @@ async function main() {
     setGhCwd(projectDir);
     logger.info(`Working directory: ${projectDir}`);
   }
-  const isPRFix = input.command === "fix" && !!input.prNumber;
+  const isPRFix = (input.command === "fix" || input.command === "fix-ci") && !!input.prNumber;
   if (input.issueNumber && input.command !== "review" && !isPRFix) {
     const taskAction = resolveForIssue(input.issueNumber, projectDir);
     logger.info(`Task action: ${taskAction.action}`);
@@ -3497,7 +3538,7 @@ async function main() {
   let taskId = input.taskId;
   if (!taskId) {
     if (isPRFix) {
-      taskId = `fix-pr-${input.prNumber}-${generateTaskId()}`;
+      taskId = `${input.command === "fix-ci" ? "fixci" : "fix"}-pr-${input.prNumber}-${generateTaskId()}`;
     } else if (input.issueNumber) {
       taskId = `${input.issueNumber}-${generateTaskId()}`;
     } else if (input.command === "run" && input.task) {
@@ -3615,9 +3656,40 @@ ${issue.body ?? ""}`;
     console.error("No task.md found. Provide --task, --issue-number, or ensure .kody/tasks/<id>/task.md exists.");
     process.exit(1);
   }
-  if (input.command === "fix" && !input.fromStage) {
+  if ((input.command === "fix" || input.command === "fix-ci") && !input.fromStage) {
     input.fromStage = "build";
   }
+  if (input.command === "fix-ci" && input.prNumber) {
+    let ciRunId = input.ciRunId;
+    if (!ciRunId && input.feedback) {
+      const match = input.feedback.match(/Run ID:\s*(\d+)/);
+      ciRunId = match?.[1];
+    }
+    if (!ciRunId) {
+      const prDetails = getPRDetails(input.prNumber);
+      if (prDetails) {
+        ciRunId = getLatestFailedRunForBranch(prDetails.headBranch) ?? void 0;
+      }
+    }
+    if (ciRunId) {
+      const ciLogs = getCIFailureLogs(ciRunId);
+      if (ciLogs) {
+        logger.info(`  Found CI failure logs for run ${ciRunId}, injecting as feedback`);
+        const ciContext = `## CI Failure Logs (run ${ciRunId})
+
+The CI pipeline failed. Fix the code to make CI pass.
+
+\`\`\`
+${ciLogs}
+\`\`\``;
+        input.feedback = input.feedback ? `${ciContext}
+
+## Additional context
+
+${input.feedback}` : ciContext;
+      }
+    }
+  }
   if (input.command === "fix" && input.prNumber) {
     const reviewComment = getLatestKodyReviewComment(input.prNumber);
     if (reviewComment) {
@@ -3667,7 +3739,7 @@ ${input.feedback}` : reviewContext;
     projectDir,
     runners,
     input: {
-      mode: input.command === "rerun" || input.command === "fix" ? "rerun" : "full",
+      mode: input.command === "rerun" || input.command === "fix" || input.command === "fix-ci" ? "rerun" : "full",
       fromStage: input.fromStage,
       dryRun: input.dryRun,
       issueNumber: input.issueNumber,
@@ -4201,7 +4273,7 @@ function ghComment(issueNumber, body, cwd) {
   } catch {
   }
 }
-function bootstrapCommand() {
+function bootstrapCommand(opts = { force: false }) {
   const cwd = process.cwd();
   const issueNumber = parseInt(process.env.ISSUE_NUMBER ?? "", 10) || 0;
   console.log(`
@@ -4275,6 +4347,23 @@ ${existingFiles.join(", ")}
   fs22.mkdirSync(memoryDir, { recursive: true });
   const archPath = path21.join(memoryDir, "architecture.md");
   const conventionsPath = path21.join(memoryDir, "conventions.md");
+  const existingArch = fs22.existsSync(archPath) ? fs22.readFileSync(archPath, "utf-8") : "";
+  const existingConv = fs22.existsSync(conventionsPath) ? fs22.readFileSync(conventionsPath, "utf-8") : "";
+  const hasExisting = !!(existingArch || existingConv);
+  const extendInstruction = hasExisting && !opts.force ? `
+## Existing Documentation (EXTEND, do not replace)
+You are UPDATING existing documentation. Follow these rules strictly:
+- PRESERVE all existing sections and content that are still accurate
+- REMOVE only lines that reference files, patterns, or dependencies that no longer exist in the project
+- APPEND new sections or lines for newly discovered patterns, files, or conventions
+- Do NOT rewrite sections that are still correct \u2014 keep them verbatim
+
+### Existing architecture.md:
+${existingArch}
+
+### Existing conventions.md:
+${existingConv}
+` : "";
   const memoryPrompt = `You are analyzing a project to generate documentation for an autonomous SDLC pipeline.
 
 Given this project context, output ONLY a JSON object with EXACTLY this structure:
@@ -4294,7 +4383,7 @@ Rules for conventions (markdown string):
 - Extract actual patterns from the project
 - If CLAUDE.md exists, reference it
 - Keep under 30 lines
-
+${extendInstruction}
 Output ONLY valid JSON. No markdown fences. No explanation.
 
 ${repoContext}`;
@@ -4352,11 +4441,16 @@ ${detected.join("\n")}
       console.log(`  \u2717 ${stage}.md \u2014 template not found in engine`);
       continue;
     }
+    const stepOutputPath = path21.join(stepsDir, `${stage}.md`);
+    if (fs22.existsSync(stepOutputPath) && !opts.force) {
+      console.log(`  \u25CB ${stage}.md \u2014 already exists (use --force to regenerate)`);
+      continue;
+    }
     const defaultPrompt = fs22.readFileSync(templatePath, "utf-8");
     const contextPlaceholder = "{{TASK_CONTEXT}}";
     const placeholderIdx = defaultPrompt.indexOf(contextPlaceholder);
     if (placeholderIdx === -1) {
-      fs22.copyFileSync(templatePath, path21.join(stepsDir, `${stage}.md`));
+      fs22.copyFileSync(templatePath, stepOutputPath);
       stepCount++;
       console.log(`  \u2713 ${stage}.md`);
       continue;
@@ -4413,12 +4507,12 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
       let cleaned = output.replace(/^```(?:markdown|md)?\s*\n?/, "").replace(/\n?```\s*$/, "");
       cleaned = cleaned.replace(/\n*\{\{TASK_CONTEXT\}\}\s*$/, "").trimEnd();
       const finalPrompt = cleaned + "\n\n" + afterPlaceholder;
-      fs22.writeFileSync(path21.join(stepsDir, `${stage}.md`), finalPrompt);
+      fs22.writeFileSync(stepOutputPath, finalPrompt);
       stepCount++;
       console.log(`  \u2713 ${stage}.md`);
     } catch {
       console.log(`  \u26A0 ${stage}.md \u2014 customization failed, using default template`);
-      fs22.copyFileSync(templatePath, path21.join(stepsDir, `${stage}.md`));
+      fs22.copyFileSync(templatePath, stepOutputPath);
       stepCount++;
     }
   }
@@ -4685,8 +4779,26 @@ function installSkillsForProject(cwd) {
     console.log("  \u25CB No skills to install (no frontend framework detected)");
     return [];
   }
+  let installedSkills = {};
+  const lockPath = path21.join(cwd, "skills-lock.json");
+  if (fs22.existsSync(lockPath)) {
+    try {
+      const lock = JSON.parse(fs22.readFileSync(lockPath, "utf-8"));
+      installedSkills = lock.skills ?? {};
+    } catch {
+    }
+  }
   const installedPaths = [];
   for (const skill of skills) {
+    const skillName = skill.package.split("@").pop() ?? "";
+    if (skillName in installedSkills) {
+      console.log(`  \u25CB ${skill.label} \u2014 already installed`);
+      const agentPath = `.agents/skills/${skillName}`;
+      const claudePath = `.claude/skills/${skillName}`;
+      if (fs22.existsSync(path21.join(cwd, agentPath))) installedPaths.push(agentPath);
+      if (fs22.existsSync(path21.join(cwd, claudePath))) installedPaths.push(claudePath);
+      continue;
+    }
     try {
       console.log(`  Installing: ${skill.label} (${skill.package})`);
       execFileSync11("npx", ["skills", "add", skill.package, "--yes"], {
@@ -4695,9 +4807,9 @@ function installSkillsForProject(cwd) {
         timeout: 6e4,
         stdio: ["pipe", "pipe", "pipe"]
       });
-      const skillName = skill.package.split("@").pop() ?? "";
-      const agentPath = `.agents/skills/${skillName}`;
-      const claudePath = `.claude/skills/${skillName}`;
+      const skillName2 = skill.package.split("@").pop() ?? "";
+      const agentPath = `.agents/skills/${skillName2}`;
+      const claudePath = `.claude/skills/${skillName2}`;
       if (fs22.existsSync(path21.join(cwd, agentPath))) installedPaths.push(agentPath);
       if (fs22.existsSync(path21.join(cwd, claudePath))) installedPaths.push(claudePath);
       console.log(`  \u2713 ${skill.label}`);
@@ -4712,7 +4824,7 @@ var command = args[0];
 if (command === "init") {
   initCommand({ force: args.includes("--force") });
 } else if (command === "bootstrap") {
-  bootstrapCommand();
+  bootstrapCommand({ force: args.includes("--force") });
 } else if (command === "version" || command === "--version" || command === "-v") {
   console.log(getVersion());
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine-lite",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "description": "Autonomous SDLC pipeline: Kody orchestration + Claude Code + LiteLLM",
   "license": "MIT",
   "type": "module",
@@ -13,6 +13,13 @@
     "templates",
     "kody.config.schema.json"
   ],
+  "scripts": {
+    "kody": "tsx src/entry.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
   "dependencies": {
     "dotenv": "^16.4.7"
   },
@@ -25,11 +32,5 @@
   },
   "engines": {
     "node": ">=22"
-  },
-  "scripts": {
-    "kody": "tsx src/entry.ts",
-    "build": "tsup",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/templates/kody.yml

@@ -28,12 +28,16 @@ on:
   pull_request_review:
     types: [submitted]
 
+  workflow_run:
+    workflows: ["CI"]
+    types: [completed]
+
   push:
     branches: [main, dev]
     paths: ["src/**", "kody.config.json", "package.json"]
 
 concurrency:
-  group: kody-${{ github.event.inputs.task_id || github.event.issue.number || github.event.pull_request.number || github.sha }}
+  group: kody-${{ github.event.inputs.task_id || github.event.issue.number || github.event.pull_request.number || github.event.workflow_run.id || github.sha }}
   cancel-in-progress: false
 
 permissions:
@@ -56,6 +60,7 @@ jobs:
       issue_number: ${{ steps.parse.outputs.issue_number }}
       pr_number: ${{ steps.parse.outputs.pr_number }}
       feedback: ${{ steps.parse.outputs.feedback }}
+      ci_run_id: ${{ steps.parse.outputs.ci_run_id }}
       valid: ${{ steps.parse.outputs.valid }}
     steps:
       - uses: actions/setup-node@v4
@@ -109,7 +114,7 @@ jobs:
 
           # Validate mode
           case "$MODE" in
-            full|rerun|fix|status|approve|review|bootstrap) ;;
+            full|rerun|fix|fix-ci|status|approve|review|bootstrap) ;;
             *)
               # If first arg isn't a mode, it might be a task-id or nothing
               if [ -n "$MODE" ] && [ "$MODE" != "" ]; then
@@ -139,6 +144,15 @@ jobs:
             # Leave TASK_ID empty — entry.ts finds latest task for issue
           fi
 
+          # fix-ci: extract body as feedback + CI run ID
+          if [ "$MODE" = "fix-ci" ]; then
+            FIX_CI_BODY=$(echo "$BODY" | sed -n '/\(@kody\|\/kody\)\s*fix-ci/,$p' | tail -n +2)
+            if [ -n "$FIX_CI_BODY" ]; then
+              FEEDBACK="$FIX_CI_BODY"
+            fi
+            CI_RUN_ID=$(echo "$FIX_CI_BODY" | grep -oP 'Run ID:\s*\K\d+' || echo "")
+          fi
+
           # Bootstrap mode: set task-id and skip normal pipeline
           if [ "$MODE" = "bootstrap" ]; then
             TASK_ID="bootstrap-$(date +%y%m%d-%H%M%S)"
@@ -170,6 +184,7 @@ jobs:
             echo "$FEEDBACK"
             echo "KODY_EOF"
           } >> $GITHUB_OUTPUT
+          echo "ci_run_id=${CI_RUN_ID:-}" >> $GITHUB_OUTPUT
           echo "valid=true" >> $GITHUB_OUTPUT
 
   # ─── Orchestrate ─────────────────────────────────────────────────────────────
@@ -198,7 +213,7 @@ jobs:
           token: ${{ steps.app-token.outputs.token || secrets.GITHUB_TOKEN }}
 
       - name: Checkout PR branch (for fix/rerun/review on PRs)
-        if: github.event.issue.pull_request && (needs.parse.outputs.mode == 'fix' || needs.parse.outputs.mode == 'rerun' || needs.parse.outputs.mode == 'review')
+        if: github.event.issue.pull_request && (needs.parse.outputs.mode == 'fix' || needs.parse.outputs.mode == 'fix-ci' || needs.parse.outputs.mode == 'rerun' || needs.parse.outputs.mode == 'review')
         env:
           GH_TOKEN: ${{ steps.app-token.outputs.token || secrets.GITHUB_TOKEN }}
         run: |
@@ -243,6 +258,7 @@ jobs:
           ISSUE_NUMBER: ${{ github.event.inputs.issue_number || needs.parse.outputs.issue_number }}
           PR_NUMBER: ${{ needs.parse.outputs.pr_number }}
           FEEDBACK: ${{ github.event.inputs.feedback || needs.parse.outputs.feedback }}
+          CI_RUN_ID: ${{ needs.parse.outputs.ci_run_id }}
           DRY_RUN: ${{ github.event.inputs.dry_run || 'false' }}
           RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
         run: |
@@ -253,6 +269,7 @@ jobs:
             CMD="run"
             [ "$MODE" = "rerun" ] && CMD="rerun"
             [ "$MODE" = "fix" ] && CMD="fix"
+            [ "$MODE" = "fix-ci" ] && CMD="fix-ci"
             [ "$MODE" = "review" ] && CMD="review"
             ARGS="--issue-number $ISSUE_NUMBER"
             [ -n "$TASK_ID" ] && ARGS="$ARGS --task-id $TASK_ID"
@@ -338,6 +355,68 @@ jobs:
               });
             }
 
+  # ─── Fix-CI Auto-trigger (workflow_run trigger) ─────────────────────────────
+  fix-ci-trigger:
+    if: >-
+      github.event_name == 'workflow_run' &&
+      github.event.workflow_run.conclusion == 'failure' &&
+      github.event.workflow_run.event == 'pull_request' &&
+      github.event.workflow_run.pull_requests[0]
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - name: Check loop guard and post fix-ci comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = context.payload.workflow_run.pull_requests[0];
+            const prNumber = pr.number;
+
+            // Check recent comments for existing fix-ci attempt (last 24h)
+            const comments = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+              per_page: 30,
+            });
+
+            const oneDayAgo = new Date(Date.now() - 24 * 60 * 60 * 1000);
+            const recentFixCi = comments.data.filter(
+              (c) => c.body.includes('@kody fix-ci') && new Date(c.created_at) > oneDayAgo
+            );
+
+            if (recentFixCi.length >= 1) {
+              core.info('Loop guard: @kody fix-ci already commented in last 24h, skipping');
+              return;
+            }
+
+            // Check if last commit was from a bot (kody's previous fix attempt)
+            const commits = await github.rest.pulls.listCommits({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: prNumber,
+              per_page: 1,
+            });
+            const lastAuthor = commits.data[commits.data.length - 1]?.commit?.author?.name;
+            if (lastAuthor === 'github-actions[bot]' || lastAuthor === 'kody[bot]') {
+              core.info('Loop guard: last commit from bot, skipping');
+              return;
+            }
+
+            // Post fix-ci comment
+            const runId = context.payload.workflow_run.id;
+            const runUrl = `${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+              body: `@kody fix-ci\nCI failed: [View logs](${runUrl})\nRun ID: ${runId}`,
+            });
+            core.info(`Posted @kody fix-ci on PR #${prNumber} for run ${runId}`);
+
   # ─── Smoke Test (push trigger) ──────────────────────────────────────────────
   smoke-test:
     if: github.event_name == 'push'