chore: merge upstream kilocode v7.4.18

.changeset/README.md

@@ -4,7 +4,7 @@ This directory contains changeset files used to track changes for the next relea
 
 ## Adding a changeset
 
-When making a user-facing change, run:
+When making a user-facing change, prefer one concise changeset per PR, grouping related changes when possible. Run:
 
 ```sh
 bunx changeset add

.dockerignore

@@ -0,0 +1,12 @@
+.git
+.opencode
+.sst
+.turbo
+.wrangler
+node_modules
+**/node_modules
+**/.output
+**/dist
+**/.turbo
+**/.vite
+**/coverage

.gitattributes

@@ -10,16 +10,32 @@ packages/kilo-ui/tests/**/*.png filter=lfs diff=lfs merge=lfs -text
 packages/kilo-vscode/tests/**/*.png filter=lfs diff=lfs merge=lfs -text
 packages/kilo-docs/public/img/screenshot-tests/**/*.png filter=lfs diff=lfs merge=lfs -text
 
-# Hide non-English localization files by default in GitHub PR diffs.
+# Hide most localization files by default in GitHub PR diffs. Show English as the source
+# language and German so reviewers can catch untranslated copy-pasted English strings.
 **/i18n/*.ts linguist-generated=true
+**/i18n/**/*.ts linguist-generated=true
 **/i18n/en.ts linguist-generated=false
 **/i18n/en*.ts linguist-generated=false
+**/i18n/**/en.ts linguist-generated=false
+**/i18n/**/en*.ts linguist-generated=false
+**/i18n/de.ts linguist-generated=false
+**/i18n/de*.ts linguist-generated=false
+**/i18n/**/de.ts linguist-generated=false
+**/i18n/**/de*.ts linguist-generated=false
 **/i18n/package-nls-en.ts linguist-generated=false
+**/i18n/package-nls-de.ts linguist-generated=false
 **/i18n/index.ts linguist-generated=false
+**/i18n/**/index.ts linguist-generated=false
 **/i18n/parity.test.ts linguist-generated=false
+**/i18n/**/parity.test.ts linguist-generated=false
 packages/kilo-i18n/src/*.ts linguist-generated=true
 packages/kilo-i18n/src/en.ts linguist-generated=false
+packages/kilo-i18n/src/de.ts linguist-generated=false
 
 # Auto-generated CLI reference docs
 packages/kilo-docs/markdoc/partials/cli-commands-table.md linguist-generated=true
 packages/kilo-docs/pages/code-with-ai/platforms/cli-reference.md linguist-generated=true
+
+# Upstream generated migration artifacts
+packages/core/migration/**/snapshot.json linguist-generated
+packages/core/src/database/migration.gen.ts linguist-generated

.github/CODEOWNERS

@@ -1,5 +1,3 @@
 # web + desktop packages
-packages/app/      @adamdotdevin
-packages/tauri/    @adamdotdevin
-packages/desktop/src-tauri/  @brendonovich
-packages/desktop/  @adamdotdevin
+packages/app/      @Hona @Brendonovich
+packages/desktop/  @Hona @Brendonovich

.github/actions/setup-bun/action.yml

@@ -33,7 +33,10 @@ runs:
       shell: bash
       run: echo "dir=$(bun pm cache)" >> "$GITHUB_OUTPUT"
 
+    # Restoring and extracting the ~1 GB cache took 2m23s on Windows, while a # kilocode_change
+    # fresh install took 1m27s. Keep Windows off this cache until that reverses. # kilocode_change
     - name: Restore Bun dependencies
+      if: runner.os != 'Windows' # kilocode_change
       id: bun-cache
       uses: actions/cache/restore@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
       with:
@@ -42,24 +45,66 @@ runs:
         restore-keys: |
           ${{ runner.os }}-bun-
 
+    # kilocode_change start
+    - name: Setup Node for native dependency builds
+      if: runner.os != 'Windows'
+      uses: actions/setup-node@v6
+      with:
+        node-version: "24"
+        package-manager-cache: false
+
+    - name: Configure node-gyp Node headers
+      if: runner.os != 'Windows'
+      id: node-gyp
+      run: |
+        node <<'NODE'
+        const fs = require("node:fs")
+        const path = require("node:path")
+
+        const exe = path.dirname(fs.realpathSync(process.execPath))
+        const dirs = [exe, path.dirname(exe)]
+        const root = dirs.find((dir) => fs.existsSync(path.join(dir, "include", "node", "node.h")))
+        if (!root) {
+          throw new Error(`Node headers not found under ${dirs.join(", ")}`)
+        }
+
+        fs.appendFileSync(process.env.GITHUB_OUTPUT, `nodedir=${root}\n`)
+        NODE
+      shell: bash
+    # kilocode_change end
+
     - name: Install setuptools for distutils compatibility
       run: python3 -m pip install setuptools || pip install setuptools || true
       shell: bash
 
     - name: Install dependencies
       run: |
+        # kilocode_change start
+        if [ "$RUNNER_OS" != "Windows" ]; then
+          export npm_config_nodedir="${{ steps.node-gyp.outputs.nodedir }}"
+        fi
+        # kilocode_change end
+
         # Workaround for patched peer variants
         # e.g. ./patches/ for standard-openapi
-        # https://github.com/oven-sh/bun/issues/28147
+        # https://github.com/oven-sh/bun/issues/28147 # kilocode_change
         if [ "$RUNNER_OS" = "Windows" ]; then
-          bun install --linker hoisted ${{ inputs.install-flags }}
+          # kilocode_change start
+          if ! bun install --frozen-lockfile --linker hoisted ${{ inputs.install-flags }}; then
+            echo "::warning::Bun install failed on Windows; retrying with conservative extraction"
+            sleep 5
+            BUN_FEATURE_FLAG_DISABLE_STREAMING_INSTALL=1 \
+              bun install --frozen-lockfile --linker hoisted --network-concurrency 16 ${{ inputs.install-flags }}
+          fi
+          # kilocode_change end
         else
-          bun install ${{ inputs.install-flags }}
+          bun install --frozen-lockfile ${{ inputs.install-flags }} # kilocode_change
         fi
       shell: bash
 
+    # Do not upload a Windows cache that Windows jobs intentionally never restore. # kilocode_change
     - name: Save Bun dependencies
-      if: steps.bun-cache.outputs.cache-hit != 'true' && github.event_name != 'pull_request' && github.event_name != 'pull_request_target'
+      if: runner.os != 'Windows' && steps.bun-cache.outputs.cache-hit != 'true' && github.event_name != 'pull_request' && github.event_name != 'pull_request_target' # kilocode_change
       uses: actions/cache/save@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
       with:
         path: ${{ steps.cache.outputs.dir }}

.github/actions/setup-linux-sandbox/action.yml

@@ -0,0 +1,21 @@
+# kilocode_change - new file
+name: "Setup Linux Sandbox"
+description: "Build the Linux bubblewrap helper"
+runs:
+  using: "composite"
+  steps:
+    - name: Setup Zig
+      run: |
+        curl --fail --location --retry 3 \
+          https://ziglang.org/download/0.14.0/zig-linux-x86_64-0.14.0.tar.xz \
+          --output "$RUNNER_TEMP/zig.tar.xz"
+        echo "473ec26806133cf4d1918caf1a410f8403a13d979726a9045b421b685031a982  $RUNNER_TEMP/zig.tar.xz" | sha256sum --check --status
+        tar -xJf "$RUNNER_TEMP/zig.tar.xz" -C "$RUNNER_TEMP"
+        echo "$RUNNER_TEMP/zig-linux-x86_64-0.14.0" >> "$GITHUB_PATH"
+      shell: bash
+
+    - name: Build bubblewrap helper
+      run: |
+        bun packages/opencode/script/kilocode/bubblewrap.ts --arch x64 --output "$RUNNER_TEMP/bwrap"
+        echo "KILO_BWRAP_PATH=$RUNNER_TEMP/bwrap" >> "$GITHUB_ENV"
+      shell: bash

.github/docs-sync/collect.mjs

@@ -0,0 +1,180 @@
+// kilocode_change - new file
+
+/**
+ * Collects PRs merged to the source repos since the watermark, applies a
+ * deterministic pre-filter, and writes docs-sync-out/digest.json for the LLM
+ * triage pass.
+ *
+ * Pre-filter drops (triage never sees these):
+ *   - PRs labeled auto-docs (this bot's own rolling PRs)
+ *   - chore/test/ci/build/docs/style/refactor conventional titles
+ *   - PRs touching only docs/non-product paths
+ *
+ * Revert PRs (conventional `revert(...):` and GitHub-native `Revert "..."` titles)
+ * are intercepted as signals, never added to the digest; affected digest entries
+ * gain `reverted_by` so triage/edit can skip them.
+ *
+ * Bot-authored PRs are kept: release/dependency bots ship user-facing
+ * changes too, and the label + docs-only guards above prevent loops.
+ */
+
+import fs from "node:fs"
+import { api, appendOutput, appendSummary, listPrFiles, searchIssues } from "./lib.mjs"
+import { revertTitleKind, parseRevertTargets, applyRevertAnnotations, unannotatedRevertSignals } from "./reverts.mjs"
+
+const SOURCE_REPOS = ["Kilo-Org/cloud", "Kilo-Org/kilocode"]
+const OUT_DIR = "docs-sync-out"
+const BODY_LIMIT = 2000
+const SLIM_BODY_LIMIT = 300
+const PATCH_LIMIT = 8000
+const FILE_LIMIT = 30
+// Revert PRs (conventional AND GitHub-native) are intercepted below BEFORE this filter; the "revert" alternative here is unreachable and kept only to minimize diff.
+const DROP_TITLE = /^(chore|test|ci|build|docs|style|refactor|revert)(\(.+\))?!?:/i
+const DOCS_ONLY_PATH = /^(packages\/kilo-docs\/|\.github\/docs-sync\/|docs-sync-out\/|docs\/|[^/]+\.md$)/
+
+function argSince() {
+  const i = process.argv.indexOf("--since")
+  const v = i >= 0 ? process.argv[i + 1] : null
+  if (!v || Number.isNaN(new Date(v).getTime())) {
+    throw new Error("usage: collect.mjs --since <ISO date>")
+  }
+  return new Date(v)
+}
+
+async function mergedPrs(fullRepo, since) {
+  const query = `repo:${fullRepo} is:pr is:merged merged:>=${since.toISOString()}`
+  return searchIssues(query)
+}
+
+const since = argSince()
+console.log(`collecting PRs merged since ${since.toISOString()}`)
+
+const digest = []
+const dropped = { label: 0, title: 0, docs_only: 0, fetch_error: 0, revert: 0 }
+const reverts = []
+
+for (const fullRepo of SOURCE_REPOS) {
+  const prs = await mergedPrs(fullRepo, since)
+  console.log(`${fullRepo}: ${prs.length} merged PRs in window`)
+
+  for (const item of prs) {
+    const author = item.user?.login ?? ""
+    if ((item.labels ?? []).some((l) => l.name === "auto-docs")) {
+      dropped.label++
+      continue
+    }
+    if (revertTitleKind(item.title ?? "")) {
+      try {
+        const pr = await api(`/repos/${fullRepo}/pulls/${item.number}`)
+        const targets = parseRevertTargets(pr.body ?? "", fullRepo)
+        reverts.push({ url: pr.html_url, merged_at: pr.merged_at, targets })
+        if (targets.length === 0) {
+          console.warn(`::warning::revert PR ${fullRepo}#${item.number} has no parseable targets`)
+        }
+        dropped.revert++
+      } catch (err) {
+        // One dead revert PR must not abort the run; its targets just go unannotated.
+        console.warn(`::warning::skipping revert ${fullRepo}#${item.number}: ${err.message}`)
+        dropped.fetch_error++
+      }
+      continue
+    }
+    if (DROP_TITLE.test(item.title ?? "")) {
+      dropped.title++
+      continue
+    }
+
+    const number = item.number
+    let pr
+    let files
+    try {
+      pr = await api(`/repos/${fullRepo}/pulls/${number}`)
+      files = await listPrFiles(fullRepo, number)
+    } catch (err) {
+      // Isolate per-PR failures: one dead PR must not abort the whole run.
+      console.warn(`::warning::skipping ${fullRepo}#${number}: ${err.message}`)
+      dropped.fetch_error++
+      continue
+    }
+    // listPrFiles caps at 300 files; a truncated list can't support the
+    // docs-only classification, so keep such PRs and record the true total.
+    const truncated = files.length >= 300
+    if (!truncated && files.length > 0 && files.every((f) => DOCS_ONLY_PATH.test(f.filename))) {
+      dropped.docs_only++
+      continue
+    }
+
+    let patch = ""
+    for (const f of files) {
+      if (!f.patch) continue
+      const chunk = `--- ${f.filename}\n${f.patch}\n`
+      if (patch.length + chunk.length > PATCH_LIMIT) {
+        patch += "\n... (diff truncated) ...\n"
+        break
+      }
+      patch += chunk
+    }
+
+    digest.push({
+      repo: fullRepo,
+      number,
+      title: pr.title,
+      url: pr.html_url,
+      author,
+      merged_at: pr.merged_at,
+      labels: (pr.labels ?? []).map((l) => l.name),
+      body: (pr.body ?? "").slice(0, BODY_LIMIT),
+      files: files.slice(0, FILE_LIMIT).map((f) => `${f.status} ${f.filename} (+${f.additions}/-${f.deletions})`),
+      files_total: pr.changed_files ?? files.length,
+      patch_excerpt: patch,
+    })
+  }
+}
+
+const applied = applyRevertAnnotations(digest, reverts)
+const unannotated = unannotatedRevertSignals(reverts, applied)
+
+digest.sort((a, b) => new Date(a.merged_at) - new Date(b.merged_at))
+
+fs.mkdirSync(OUT_DIR, { recursive: true })
+// Full digest (bodies + patch excerpts) is filtered down to docs-worthy PRs
+// for the edit pass; the slim digest keeps the triage pass context small.
+fs.writeFileSync(`${OUT_DIR}/digest-full.json`, JSON.stringify(digest, null, 2))
+const slim = digest.map(({ patch_excerpt, body, ...rest }) => ({
+  ...rest,
+  body: body.slice(0, SLIM_BODY_LIMIT),
+}))
+fs.writeFileSync(`${OUT_DIR}/digest.json`, JSON.stringify(slim, null, 2))
+
+console.log(`kept ${digest.length} PRs, dropped:`, dropped)
+appendOutput("count", digest.length)
+appendOutput("digest", `${OUT_DIR}/digest.json`)
+
+const summaryLines = [
+  "### docs-sync collect",
+  "",
+  `- window: since \`${since.toISOString()}\``,
+  `- kept: **${digest.length}** PRs`,
+  `- dropped: ${dropped.label} auto-docs, ${dropped.title} title filter, ${dropped.docs_only} docs-only, ${dropped.fetch_error} fetch errors, ${dropped.revert} reverts intercepted`,
+  "",
+  ...digest.map((d) => `- [${d.repo}#${d.number}](${d.url}) ${d.title}`),
+]
+if (applied.length > 0) {
+  summaryLines.push("", "**revert annotations:**", ...applied.map(([target, reverter]) => `- ${target} — reverted by ${reverter}`))
+}
+if (unannotated.missed.length > 0 || unannotated.unparsed.length > 0) {
+  summaryLines.push("", "**revert targets with no in-window annotation:**")
+  for (const m of unannotated.missed) {
+    summaryLines.push(`- ${m.url} — unannotated targets: ${m.targets.join(", ")}`)
+  }
+  for (const url of unannotated.unparsed) {
+    summaryLines.push(`- ${url} (no parseable targets)`)
+  }
+}
+if (unannotated.chains.length > 0) {
+  summaryLines.push("", "**revert chains (not annotated):**")
+  for (const c of unannotated.chains) {
+    summaryLines.push(`- ${c.url}${c.targets.length > 0 ? ` (targets: ${c.targets.join(", ")})` : ""}`)
+  }
+}
+appendSummary(summaryLines.join("\n"))

.github/docs-sync/edit-prompt.md

@@ -0,0 +1,27 @@
+You are the Kilo Code documentation bot. You update the public product documentation in `packages/kilo-docs` (a Markdoc/Next.js site served at kilo.ai/docs) so it reflects recently merged PRs. You are handling one batch of PRs; the batch files and your output file are named at the end of these instructions.
+
+Before writing anything:
+
+1. Read `packages/kilo-docs/AGENTS.md` and `packages/kilo-docs/STYLE_GUIDE.md` and follow them exactly: Markdoc custom tags, the `/docs` prefix in image paths, navigation files under `lib/nav/`, redirect rules, and the generated-screenshot policy.
+2. Read the attached batch files: the full-details file (PR title, body, file list, `patch_excerpt` diffs) and the triage file (docs-worthiness verdicts, target sections, priorities).
+3. Verify facts against the current source tree — for Kilo-Org/kilocode PRs. This checkout reflects current kilocode main: before documenting a command, flag, setting, default, or behavior from a kilocode PR, confirm it exists in the current source. Existence alone is not enough: defaults, whether an option is required or optional, and on-by-default behavior must also match the current tree — a symbol that still exists as opt-in does not justify documenting default-on behavior. When the merged diff and the current tree disagree, the current tree wins — the change may have been reverted or superseded; skip it and record why. For Kilo-Org/cloud PRs the source is not in this checkout: rely on the PR diff and body, and on the `reverted_by` field below. Reading any file in the checkout for verification is expected; the hard rule against touching anything outside `packages/kilo-docs/` applies to writing only.
+
+For each PR in the batch, in priority order, first decide whether it needs documentation at all — skipping is a first-class outcome. For each one that does:
+
+- Find the most relevant existing docs page(s) and make minimal, precise updates in the style of the surrounding content.
+- Create a new page only when no existing page fits; then add it to the matching nav file in `packages/kilo-docs/lib/nav/`.
+- Document only behavior that is actually present in the merged diff and still present in the product now (step 3 above: when they disagree, the current state wins). If the PR body or diff shows the feature is behind a flag or otherwise not user-visible yet, skip it and record why.
+- If a PR turns out not to need documentation, skip it and record why. Trust evidence over the triage verdict.
+- A batch PR with a `reverted_by` field was reverted by that PR; skip it unless there is clear evidence the change is present now — for kilocode PRs verify it in the current source tree (re-land); for cloud PRs require explicit re-land evidence in the entry itself.
+- Skipping is a normal outcome: a batch where every PR is skipped is a valid result. Never write docs just to have something to show.
+
+Hard rules:
+
+- Only create or modify files under `packages/kilo-docs/`. Never touch code, tests, config, images, or anything outside that directory.
+- Never remove or rename pages. Never document unreleased behavior. Never copy internal PR discussion into the docs; write user-facing documentation.
+- Do not run git commands and do not commit anything; automation handles git.
+- Keep the change small and precise. Do not rewrite sections that are already accurate.
+
+When finished, write the summary JSON file named in the batch specifics below: a JSON array with exactly one entry per batch PR, consumed by automation (this file is never committed). Use `action` values like `updated <path>`, `created <path>`, or `skipped`. Example:
+
+[{"pr": 123, "url": "https://github.com/Kilo-Org/kilocode/pull/123", "action": "updated pages/code-with-ai/platforms/cli.md", "reason": "documented --variant flag"}, {"pr": 124, "url": "https://github.com/Kilo-Org/kilocode/pull/124", "action": "skipped", "reason": "feature behind unreleased flag"}]