carthagent 1.0.7 → 1.1.0-beta.1

package/plugins/carthagent/tests/session-preferences.test.mjs

@@ -0,0 +1,41 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { setSessionAutoCompaction } from "../src/ui/session-preferences.mjs";
+
+test("autocompact persists explicit, idempotent session preferences without replacing neighbor metadata", async () => {
+  let current = { "ctg.autoCompaction": false, "ctg.raw": true, "user.flag": "keep" };
+  const updates = [];
+  const client = {
+    async get(input, options) {
+      assert.equal(input.sessionID, "s1");
+      assert.equal(options.location.directory, "/project");
+      assert.ok(options.signal instanceof AbortSignal);
+      return { metadata: current };
+    },
+    async update(input, options) {
+      assert.equal(input.sessionID, "s1");
+      assert.equal(options.location.directory, "/project");
+      current = input.metadata;
+      updates.push(input.metadata);
+    },
+  };
+  const location = { directory: "/project" };
+  assert.equal(await setSessionAutoCompaction(client, "s1", location, "off"), false);
+  assert.equal(updates.length, 0, "repeating off must not write");
+  assert.equal(await setSessionAutoCompaction(client, "s1", location, "on"), true);
+  assert.deepEqual(current, { "ctg.raw": true, "user.flag": "keep" });
+  assert.equal(await setSessionAutoCompaction(client, "s1", location, "toggle"), false);
+  assert.deepEqual(current, { "ctg.autoCompaction": false, "ctg.raw": true, "user.flag": "keep" });
+  assert.equal(await setSessionAutoCompaction(client, "s1", location, "toggle"), true);
+  assert.equal(updates.length, 3);
+});
+
+test("invalid autocompact arguments fail before reading or mutating session state", async () => {
+  let calls = 0;
+  const client = {
+    async get() { calls++; throw new Error("must not read"); },
+    async update() { calls++; throw new Error("must not update"); },
+  };
+  await assert.rejects(setSessionAutoCompaction(client, "s1", { directory: "/project" }, "sometimes"), /Usage: \/autocompact \[on\|off\]/);
+  assert.equal(calls, 0);
+});

package/plugins/carthagent/tests/voyages-navigation.test.tsx

@@ -0,0 +1,269 @@
+/** @jsxImportSource @opentui/solid */
+import { expect, test } from "bun:test";
+import { testRender } from "@opentui/solid";
+import { ScrollBoxRenderable, SelectRenderable, type Renderable } from "@opentui/core";
+import { createSignal } from "solid-js";
+import { PluginContextProvider } from "@opencode/plugin/tui";
+import type { Context } from "@opencode/plugin/tui/context";
+import { parseThemeDocument, resolveThemeDocument } from "@opencode/theme/tui";
+import theme from "../themes/carthage.json";
+import { Voyages } from "../src/voyages-rpc.js";
+import { VoyagesNavigation } from "../src/ui/voyages-navigation.js";
+
+const profile = { profile: { name: "Test captain", shipName: "Test vessel", coins: 10, level: 2, totalXp: 150 } };
+const slate = { slate: { day: "2026-10-30", endsAt: "2026-10-31T00:00:00Z", items: [
+  { id: "quest-one", definition: { title: "Protect a boundary" }, status: "open" },
+  { id: "quest-two", definition: { title: "Review a change" }, status: "assessed_complete" },
+] }, records: [{ request: { evidence: "must not appear in navigation", consent: true } }] };
+
+async function fixture({ width = 30, height = 36, authenticated = true } = {}) {
+  const [active, setActive] = createSignal(true);
+  const [focused, setFocused] = createSignal(false);
+  const [compact, setCompact] = createSignal(false);
+  const [mode, setMode] = createSignal("base");
+  const [sessionID, setSessionID] = createSignal<string | undefined>("coding-session");
+  const routes: unknown[] = [], calls: string[] = [], selected: string[] = [];
+  const responses: Promise<unknown>[] = [];
+  let responseGate: Promise<void> | undefined;
+  let listener: ((event: { details: { type: string } }) => void) | undefined;
+  let listening = true;
+  const context = {
+    theme: resolveThemeDocument(parseThemeDocument(theme), "dark"),
+    location: { directory: "/test-project" },
+    data: {
+      session: { get: () => ({ location: { directory: "/test-project" } }) },
+      location: { default: () => ({ directory: "/test-project" }) },
+      listen: (next: typeof listener) => { listener = next; return () => { listening = false; }; },
+    },
+    client: { rpc: (definition: unknown) => ({ snapshot: () => {
+      calls.push(definition === Voyages ? "profile" : "daily");
+      const response = authenticated ? (responseGate ?? Promise.resolve()).then(() => definition === Voyages ? profile : slate) : Promise.reject({ type: "voyagesError", data: { code: "authentication_required" } });
+      responses.push(response);
+      return response;
+    } }) },
+    keymap: { mode: { current: mode }, dispatch: (id: string) => { calls.push(id); } },
+    ui: {
+      router: { navigate: (route: unknown) => routes.push(route) },
+      navigation: { current: () => "voyages", select: (name: string) => { selected.push(name); return true; } },
+    },
+  } as unknown as Context;
+  const app = await testRender(() => <PluginContextProvider value={context}>
+    <box width={width} height={height} visible={active()}>
+      <VoyagesNavigation width={width} active={active()} compact={compact()} focused={focused()} sessionID={sessionID()} focus={() => { if (mode() !== "base") return; setFocused(true); setMode("navigation"); }} blur={() => { setFocused(false); if (mode() === "navigation") setMode("base"); }} />
+    </box>
+  </PluginContextProvider>, { width, height, kittyKeyboard: true });
+  const settle = async () => { await Promise.allSettled(responses); await app.renderOnce(); };
+  await settle();
+  return {
+    app, calls, routes, selected, mode, setMode, setActive, setFocused, setCompact, setSessionID, settle,
+    focus: async () => { setFocused(true); setMode("navigation"); await app.renderOnce(); },
+    event: (type: string) => listener?.({ details: { type } }),
+    delay: (promise: Promise<void> | undefined) => { responseGate = promise; },
+    listening: () => listening,
+    list: () => app.renderer.currentFocusedRenderable as SelectRenderable,
+    scroll: () => {
+      const find = (node: Renderable): ScrollBoxRenderable | undefined => node instanceof ScrollBoxRenderable ? node : node.getChildren().map(find).find(Boolean);
+      return find(app.renderer.root)!;
+    },
+  };
+}
+
+test.each([30, 18])("real Voyages navigator renders account and assignment summaries at width %i", async (width) => {
+  const f = await fixture({ width });
+  try {
+    const frame = f.app.captureCharFrame();
+    expect(frame).toContain("Test captain");
+    expect(frame).toContain("10 coins");
+    expect(frame).toContain("Daily coding");
+    expect(frame).not.toContain("must not appear");
+    expect(f.calls).toEqual(["profile", "daily"]);
+    expect(f.routes).toHaveLength(0);
+  } finally { f.app.renderer.destroy(); }
+  expect(f.listening()).toBe(false);
+});
+
+test("rail focus owns arrows/Enter; palette or modal mode cannot trigger a route", async () => {
+  const f = await fixture();
+  try {
+    expect(f.app.renderer.currentFocusedRenderable).not.toBeInstanceOf(SelectRenderable);
+    await f.focus();
+    expect(f.list()).toBeInstanceOf(SelectRenderable);
+    f.app.mockInput.pressArrow("down");
+    await f.app.renderOnce();
+    expect(f.list().getSelectedOption()?.value).toBe("quest:quest-one");
+    for (const mode of ["modal", "palette", "base"]) {
+      f.setMode(mode);
+      await f.app.renderOnce();
+      f.app.mockInput.pressEnter();
+      await f.app.renderOnce();
+      expect(f.routes).toHaveLength(0);
+    }
+    f.setMode("navigation");
+    await f.app.renderOnce();
+    f.app.mockInput.pressEnter();
+    await f.app.renderOnce();
+    expect(f.routes).toEqual([{ type: "plugin", name: "daily-quests", data: { sessionID: "coding-session", questID: "quest-one" } }]);
+    expect(f.mode()).toBe("base");
+    expect(f.calls).toEqual(["profile", "daily"]);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test("Projects/Voyages toggles retain selection and do not route, submit or purchase", async () => {
+  const f = await fixture();
+  try {
+    await f.focus();
+    f.app.mockInput.pressArrow("down");
+    await f.app.renderOnce();
+    expect(f.list().getSelectedOption()?.value).toBe("quest:quest-one");
+    f.setActive(false);
+    await f.settle();
+    expect(f.app.captureCharFrame()).not.toContain("Test captain");
+    f.setActive(true);
+    await f.settle();
+    expect(f.list().getSelectedOption()?.value).toBe("quest:quest-one");
+    expect(f.routes).toHaveLength(0);
+    expect(f.calls).toEqual(["profile", "daily", "profile", "daily"]);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test("compact mode uses the same mounted selection and keyboard behavior", async () => {
+  const f = await fixture();
+  try {
+    await f.focus();
+    f.app.mockInput.pressArrow("down");
+    await f.app.renderOnce();
+    const list = f.list();
+    f.setCompact(true);
+    f.app.resize(5, 36);
+    await f.app.renderOnce();
+    expect(f.list()).toBe(list);
+    expect(f.list().getSelectedOption()?.value).toBe("quest:quest-one");
+    expect(f.app.captureCharFrame()).not.toContain("Test captain");
+    f.app.mockInput.pressEnter();
+    await f.app.renderOnce();
+    expect(f.routes).toEqual([{ type: "plugin", name: "daily-quests", data: { sessionID: "coding-session", questID: "quest-one" } }]);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test("switching modes preserves the Voyages scroll position at a short terminal height", async () => {
+  const f = await fixture({ height: 12 });
+  try {
+    const scroll = f.scroll();
+    scroll.scrollBy(5);
+    await f.app.renderOnce();
+    const before = scroll.scrollTop;
+    expect(before).toBeGreaterThan(0);
+    f.setActive(false);
+    await f.settle();
+    f.setActive(true);
+    await f.settle();
+    expect(f.scroll()).toBe(scroll);
+    expect(scroll.scrollTop).toBe(before);
+    expect(f.routes).toHaveLength(0);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test("slow summary reads preserve scrolled position after an intervening loading layout", async () => {
+  const f = await fixture({ height: 12 });
+  try {
+    const scroll = f.scroll();
+    scroll.scrollTo(100);
+    await f.app.renderOnce();
+    const before = scroll.scrollTop;
+    expect(before).toBeGreaterThan(0);
+    f.setActive(false);
+    await f.app.renderOnce();
+    const gate = Promise.withResolvers<void>();
+    f.delay(gate.promise);
+    f.setActive(true);
+    await f.app.renderOnce();
+    expect(f.app.captureCharFrame()).not.toContain("Test captain");
+    expect(f.calls).toEqual(["profile", "daily", "profile", "daily"]);
+    gate.resolve();
+    await f.settle();
+    await f.app.renderOnce();
+    expect(scroll.scrollTop).toBe(before);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test("short terminal keyboard navigation keeps the highlighted action on screen", async () => {
+  const f = await fixture({ height: 12 });
+  try {
+    await f.focus();
+    for (let index = 0; index < 7; index++) {
+      f.app.mockInput.pressArrow("down");
+      await f.app.renderOnce();
+    }
+    expect(f.list().getSelectedOption()?.value).toBe("back");
+    expect(f.app.captureCharFrame()).toContain("Return to coding");
+    expect(f.list().height).toBeLessThanOrEqual(f.scroll().viewport.height);
+    expect(f.routes).toHaveLength(0);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test("mouse press focuses the rail and release opens the clicked row without acting through a modal", async () => {
+  const f = await fixture();
+  try {
+    const row = f.app.captureCharFrame().split("\n").findIndex((line) => line.includes("Daily coding quests"));
+    expect(row).toBeGreaterThanOrEqual(0);
+    for (const mode of ["modal", "palette"]) {
+      f.setMode(mode);
+      await f.app.renderOnce();
+      await f.app.mockMouse.click(5, row);
+      await f.app.renderOnce();
+      expect(f.mode()).toBe(mode);
+      expect(f.routes).toHaveLength(0);
+    }
+    f.setMode("base");
+    f.app.renderer.clearSelection();
+    await f.app.renderOnce();
+    await f.app.mockMouse.pressDown(5, row);
+    await f.app.renderOnce();
+    expect(f.mode()).toBe("navigation");
+    expect(f.app.renderer.currentFocusedRenderable).toBeInstanceOf(SelectRenderable);
+    expect(f.routes).toHaveLength(0);
+    await f.app.mockMouse.release(5, row);
+    await f.app.renderOnce();
+    expect(f.routes).toEqual([{ type: "plugin", name: "daily-quests", data: { sessionID: "coding-session" } }]);
+    expect(f.mode()).toBe("base");
+    const questRow = f.app.captureCharFrame().split("\n").findIndex((line) => line.includes("Review a change"));
+    expect(questRow).toBeGreaterThanOrEqual(0);
+    await f.app.mockMouse.click(5, questRow);
+    await f.app.renderOnce();
+    expect(f.routes).toEqual([
+      { type: "plugin", name: "daily-quests", data: { sessionID: "coding-session" } },
+      { type: "plugin", name: "daily-quests", data: { sessionID: "coding-session", questID: "quest-two" } },
+    ]);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test("signed-out account and invalidation hide protected summaries, reset stale selection, and stay read-only", async () => {
+  const f = await fixture({ authenticated: false });
+  try {
+    expect(f.app.captureCharFrame()).toContain("authentication_required");
+    expect(f.app.captureCharFrame()).not.toContain("Test captain");
+    await f.focus();
+    f.app.mockInput.pressArrow("down");
+    await f.app.renderOnce();
+    f.event("credential.updated");
+    await f.settle();
+    expect(f.list().getSelectedOption()?.value).toBe("daily");
+    expect(f.routes).toHaveLength(0);
+    expect(f.calls).toEqual(["profile", "daily", "profile", "daily"]);
+  } finally { f.app.renderer.destroy(); }
+});
+
+test.each(["coding-session", undefined])("return to coding explicitly navigates to the selected session or Home (%s)", async (sessionID) => {
+  const f = await fixture();
+  try {
+    f.setSessionID(sessionID);
+    await f.focus();
+    const list = f.list();
+    const index = list.options.findIndex((option) => option.value === "back");
+    list.setSelectedIndex(index);
+    f.app.mockInput.pressEnter();
+    await f.app.renderOnce();
+    expect(f.selected).toEqual(["projects"]);
+    expect(f.routes).toEqual([sessionID ? { type: "session", sessionID } : { type: "home" }]);
+  } finally { f.app.renderer.destroy(); }
+});

package/plugins/carthagent/themes/carthage.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://opencode.ai/theme.json",
+  "base": {
+    "categorical": ["accent", "purple", "cyan", "green", "blue"],
+    "text": {
+      "base": "$hue.neutral.100",
+      "muted": "$hue.neutral.300",
+      "faint": "$hue.neutral.400",
+      "action": {
+        "primary": { "base": "$hue.purple.400", "$hovered": "$hue.purple.300", "$pressed": "$hue.purple.500" },
+        "secondary": { "base": "$hue.neutral.200", "$hovered": "$hue.yellow.400" },
+        "destructive": { "base": "$hue.red.300", "$hovered": "$hue.red.200" }
+      },
+      "formfield": { "base": "$hue.neutral.100", "$focused": "$hue.yellow.400" },
+      "feedback": {
+        "info": { "base": "$hue.cyan.300", "muted": "$hue.cyan.500" },
+        "success": { "base": "$hue.green.300", "muted": "$hue.green.500" },
+        "warning": { "base": "$hue.yellow.300", "muted": "$hue.yellow.500" },
+        "error": { "base": "$hue.red.300", "muted": "$hue.red.500" }
+      }
+    },
+    "background": {
+      "base": "$hue.neutral.900",
+      "raised": { "base": "$hue.neutral.800", "high": "$hue.neutral.700", "max": "$hue.neutral.600" },
+      "action": {
+        "primary": { "base": "$hue.yellow.400", "$hovered": "$hue.yellow.300", "$pressed": "$hue.yellow.500" },
+        "secondary": { "base": "$hue.neutral.800", "$hovered": "$hue.neutral.700" },
+        "destructive": { "base": "$hue.red.700", "$hovered": "$hue.red.600" }
+      },
+      "formfield": { "base": "$hue.neutral.900", "$focused": "$hue.neutral.800" },
+      "feedback": {
+        "info": { "base": "$hue.blue.800" }, "success": { "base": "$hue.green.800" },
+        "warning": { "base": "$hue.orange.800" }, "error": { "base": "$hue.red.800" }
+      }
+    },
+    "border": { "base": "$hue.neutral.600" },
+    "scrollbar": { "base": "$hue.neutral.600" },
+    "diff": {
+      "text": { "added": "$hue.green.300", "removed": "$hue.red.300", "context": "$hue.neutral.300", "hunkHeader": "$hue.cyan.300" },
+      "background": { "added": "$hue.green.800", "removed": "$hue.red.800", "context": "$hue.neutral.800" },
+      "highlight": { "added": "$hue.green.700", "removed": "$hue.red.700" },
+      "lineNumber": { "text": "$hue.neutral.400", "background": { "added": "$hue.green.900", "removed": "$hue.red.900" } }
+    },
+    "syntax": {
+      "comment": "$hue.neutral.400", "keyword": "$hue.purple.300", "function": "$hue.yellow.300", "variable": "$hue.neutral.100",
+      "string": "$hue.green.300", "number": "$hue.orange.300", "type": "$hue.cyan.300", "operator": "$hue.purple.300", "punctuation": "$hue.neutral.300"
+    },
+    "markdown": {
+      "text": "$hue.neutral.100", "heading": "$hue.yellow.300", "link": "$hue.cyan.300", "linkText": "$hue.cyan.300", "code": "$hue.green.300",
+      "blockQuote": "$hue.neutral.300", "emphasis": "$hue.orange.300", "strong": "$hue.yellow.300", "horizontalRule": "$hue.neutral.500",
+      "listItem": "$hue.yellow.400", "listEnumeration": "$hue.yellow.400", "image": "$hue.purple.300", "imageText": "$hue.neutral.300", "codeBlock": "$hue.neutral.100"
+    }
+  },
+  "dark": {
+    "hue": {
+      "gray": { "100": "#f4eef5", "200": "#d8cbdc", "300": "#c0b3ca", "400": "#9a8ca6", "500": "#705e7a", "600": "#49364f", "700": "#35243d", "800": "#271733", "900": "#160e20" },
+      "red": { "100": "#f6d4dd", "200": "#e8a9ba", "300": "#d58ca2", "400": "#b8758d", "500": "#9c5a73", "600": "#713e55", "700": "#512a40", "800": "#351a2d", "900": "#21101d" },
+      "orange": { "100": "#ffead3", "200": "#f8d8b3", "300": "#eec28b", "400": "#d5af66", "500": "#ad8b50", "600": "#80673e", "700": "#5d4a32", "800": "#3b2e28", "900": "#241c21" },
+      "yellow": { "100": "#fff4d8", "200": "#f5dca9", "300": "#e6c480", "400": "#d5af66", "500": "#b18c4e", "600": "#84683d", "700": "#604a30", "800": "#3e3026", "900": "#251d20" },
+      "green": { "100": "#d9f2df", "200": "#b1e2bd", "300": "#83c996", "400": "#62ad78", "500": "#46885e", "600": "#35684a", "700": "#284d39", "800": "#1e382b", "900": "#17251e" },
+      "cyan": { "100": "#d5f2f3", "200": "#a9e0e2", "300": "#83c8ce", "400": "#62aab5", "500": "#4a8997", "600": "#396874", "700": "#2c4c58", "800": "#203640", "900": "#17242b" },
+      "blue": { "100": "#dce9fb", "200": "#b9d0f0", "300": "#91b2df", "400": "#7193c6", "500": "#5876a4", "600": "#445b7e", "700": "#34445d", "800": "#263342", "900": "#1a222d" },
+      "purple": { "100": "#f0e2f5", "200": "#ddc0e7", "300": "#c99bd7", "400": "#ad7abe", "500": "#895f99", "600": "#694878", "700": "#4d365b", "800": "#352440", "900": "#211629" },
+      "accent": "$hue.yellow", "interactive": "$hue.yellow", "neutral": "$hue.gray"
+    }
+  }
+}

package/plugins/carthagent/tui.ts

@@ -1 +1,26 @@
-export { default } from './src/bootstrap';
+import { Plugin } from '@opencode/plugin/tui';
+import diagnostics from './src/bootstrap';
+import workspace from './src/tui';
+
+export default Plugin.define({
+  id: 'carthagent.tui',
+  async setup(context) {
+    const cleanups: Plugin.Cleanup[] = [];
+    const dispose = async () => {
+      const results = await Promise.allSettled(cleanups.splice(0).reverse().map((cleanup) => Promise.resolve().then(cleanup)));
+      const failures = results.filter((result): result is PromiseRejectedResult => result.status === 'rejected');
+      if (failures.length) throw new AggregateError(failures.map((result) => result.reason), 'Carthagent terminal cleanup failed');
+    };
+    try {
+      for (const definition of [diagnostics, workspace]) {
+        const cleanup = await definition.setup(context);
+        if (cleanup) cleanups.push(cleanup);
+      }
+      return dispose;
+    } catch (error) {
+      try { await dispose(); }
+      catch (cleanupError) { throw new AggregateError([error, cleanupError], 'Carthagent terminal setup failed'); }
+      throw error;
+    }
+  },
+});

package/script/ctg/build-owned-runtime.sh

@@ -0,0 +1,166 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Reproducible native build for CTG's separately named OpenCode v2.0.32 runtime.
+# Run from a clean checkout of the locked source revision with Bun 1.4.2.
+ROOT="$(git rev-parse --show-toplevel)"
+EXPECTED_SOURCE="843a6c514e606b436a7fe713422ace0a93ad3d61"
+EXPECTED_LOCK="9d78379cd264584a495440a217b9d2ecab524c9a56f7f8b4b5bed3926daa330d"
+EXPECTED_PATCH="ec4bb182308ed8b311513aad5c9c7d57dcd0db103f0882f3dc3517d535b4c975"
+TARGET="${1:-opencode-linux-x64}"
+HOST_PLATFORM="$(node -p 'process.platform')"
+HOST_ARCH="$(node -p 'process.arch')"
+
+cd "$ROOT"
+if command -v sha256sum >/dev/null 2>&1; then
+  HASH_COMMAND=(sha256sum)
+elif command -v shasum >/dev/null 2>&1; then
+  HASH_COMMAND=(shasum -a 256)
+else
+  echo "Need sha256sum or shasum to verify pinned inputs" >&2
+  exit 1
+fi
+if [[ "$(git rev-parse HEAD)" != "$EXPECTED_SOURCE" ]]; then
+  echo "Expected pristine OpenCode source $EXPECTED_SOURCE; got $(git rev-parse HEAD)" >&2
+  exit 1
+fi
+# Reject staged edits and every tracked worktree edit other than a bun.lock
+# line-ending conversion before restoring anything. On Windows, validate that
+# normalizing CRLF to LF exactly reproduces the committed blob; this keeps
+# checkout conversion distinct from user edits and fails closed on content
+# changes. The blob itself must still match the pinned lock hash.
+if ! git diff --cached --quiet HEAD --; then
+  echo "Refusing to build with staged source changes" >&2
+  exit 1
+fi
+expected_inputs=(
+  "docs/patches/opencode-v2.0.32-session-ui-combined-v5.patch"
+  "script/ctg/build-owned-runtime.sh"
+)
+actual_status="$(git status --porcelain --untracked-files=all)"
+unexpected=""
+while IFS= read -r entry; do
+  [[ -z "$entry" ]] && continue
+  path="${entry:3}"
+  allowed=false
+  for input in "${expected_inputs[@]}"; do
+    [[ "$path" == "$input" ]] && allowed=true
+  done
+  if [[ "$allowed" != true && "$path" != "bun.lock" ]]; then
+    unexpected+="${entry}"$'\n'
+  fi
+done <<< "$actual_status"
+if [[ -n "$unexpected" ]]; then
+  echo "Expected pristine tracked source and only the two reviewed CTG build inputs as untracked files" >&2
+  git status --short >&2
+  exit 1
+fi
+if ! git diff --quiet HEAD -- . ':(exclude)bun.lock'; then
+  echo "Refusing to build with modified tracked source files" >&2
+  git status --short >&2
+  exit 1
+fi
+node - "$EXPECTED_LOCK" <<'NODE'
+const { createHash } = require("node:crypto")
+const { execFileSync } = require("node:child_process")
+const { readFileSync } = require("node:fs")
+const expectedHash = process.argv[2]
+const committed = execFileSync("git", ["show", "HEAD:bun.lock"])
+const current = readFileSync("bun.lock")
+const normalized = Buffer.from(current.toString("utf8").replace(/\r\n/g, "\n"))
+const hash = createHash("sha256").update(committed).digest("hex")
+if (hash !== expectedHash || !normalized.equals(committed)) {
+  console.error("Refusing to restore bun.lock: tracked content differs from the pinned blob")
+  process.exit(1)
+}
+NODE
+# Only after the fail-closed pristine check, restore Windows checkout line
+# endings with conversion disabled so Bun sees the exact committed bytes.
+git -c core.autocrlf=false checkout-index --force -- bun.lock
+if [[ "$("${HASH_COMMAND[@]}" bun.lock | awk '{print $1}')" != "$EXPECTED_LOCK" ]]; then
+  echo "Pinned bun.lock checksum mismatch" >&2
+  exit 1
+fi
+if [[ "$(bun --version)" != "1.4.2" ]]; then
+  echo "Expected Bun 1.4.2; got $(bun --version)" >&2
+  exit 1
+fi
+
+patch_file="$ROOT/docs/patches/opencode-v2.0.32-session-ui-combined-v5.patch"
+actual_patch="$("${HASH_COMMAND[@]}" "$patch_file" | awk '{print $1}')"
+if [[ "$actual_patch" != "$EXPECTED_PATCH" ]]; then
+  echo "Patch checksum mismatch: $actual_patch" >&2
+  exit 1
+fi
+git apply --check "$patch_file"
+git apply "$patch_file"
+
+echo "source=$(git rev-parse HEAD)"
+echo "patch_sha256=$actual_patch"
+echo "license=$(grep -m1 '"license"' packages/cli/package.json | cut -d '"' -f4)"
+
+bun install --frozen-lockfile
+bun run --cwd packages/core typecheck
+bun run --cwd packages/server typecheck
+bun run --cwd packages/plugin typecheck
+bun run --cwd packages/client typecheck
+bun run --cwd packages/tui typecheck
+bun test --cwd packages/core test/session-compaction.test.ts
+bun test --cwd packages/core test/shell-retention.test.ts
+bun test --cwd packages/server test/shell-provenance.test.ts
+bun test --cwd packages/tui test/plugin-source.test.ts
+bun test --cwd packages/tui test/clear-session.test.tsx
+bun test --cwd packages/tui --timeout 30000 test/navigation-rail.test.tsx --rerun-each 10
+bun test --cwd packages/tui --timeout 30000 test/component/seascape-render.test.tsx --rerun-each 10
+bun test --cwd packages/tui --timeout 30000 test/app-lifecycle.test.tsx test/session-panel.test.tsx
+bun test --cwd packages/tui test/util/renderer.test.ts
+bun test --cwd packages/tui test/component/plan-view.test.tsx test/component/transcript-scrollbox.test.ts test/component/seascape.test.ts test/component/session-tabs-rail.test.tsx test/component/session-tabs-marquee.test.ts test/component/session-tabs-mouse.test.tsx test/context/session-tabs-model.test.ts test/ui/layout.test.ts
+bun test --cwd packages/tui --timeout 60000 test/glyphs.test.ts test/plugin-keymap.test.tsx test/plugin-theme.test.tsx test/plugin-theme-provider.test.tsx
+
+cd packages/cli
+# A CTG build is intentionally detached from upstream updater channels and
+# receives an explicit non-upstream identity; it must never masquerade as 2.0.32.
+if [[ "$TARGET" == opencode-windows-* ]]; then
+  BUILD_OS=win32
+  MANIFEST_PLATFORM="windows-${TARGET#opencode-windows-}"
+  BINARY=opencode.exe
+elif [[ "$TARGET" == opencode-darwin-* ]]; then
+  BUILD_OS=darwin
+  MANIFEST_PLATFORM="darwin-${TARGET#opencode-darwin-}"
+  BINARY=opencode
+else
+  BUILD_OS=linux
+  MANIFEST_PLATFORM="linux-${TARGET#opencode-linux-}"
+  BINARY=opencode
+fi
+BUILD_ARCH="$(sed -E 's/^opencode-(linux|darwin|windows)-([^-]+).*$/\2/' <<< "$TARGET")"
+if [[ "$BUILD_OS" != "$HOST_PLATFORM" || "$BUILD_ARCH" != "$HOST_ARCH" ]]; then
+  echo "Cross-compiling target $TARGET is not supported by this recipe; run on matching native CI (host $HOST_PLATFORM-$HOST_ARCH)" >&2
+  exit 1
+fi
+OPENCODE_VERSION=0.0.0-ctg.2.0.32 OPENCODE_CHANNEL=ctg.2.0.32 \
+  bun run script/build.ts --single --target="$TARGET" --skip-web-ui --outdir="$ROOT/packages/cli/dist-ctg"
+
+cd "$ROOT"
+artifact="${TARGET#opencode-}"
+binary="$ROOT/packages/cli/dist-ctg/cli-$artifact/bin/$BINARY"
+test -x "$binary"
+"$binary" --version
+cp "$ROOT/LICENSE" "$ROOT/packages/cli/dist-ctg/LICENSE"
+relative_binary="cli-$artifact/bin/$BINARY"
+cd "$ROOT/packages/cli/dist-ctg"
+"${HASH_COMMAND[@]}" "$relative_binary" | tee SHA256SUMS
+cat > ctg-runtime.json <<EOF
+{
+  "owner": "Carthagent",
+  "sourceRepository": "https://github.com/anomalyco/opencode",
+  "sourceRevision": "$EXPECTED_SOURCE",
+  "lockSha256": "$EXPECTED_LOCK",
+  "patchSha256": "$EXPECTED_PATCH",
+  "compatibilityVersion": "2.0.32",
+  "runtimeVersion": "0.0.0-ctg.2.0.32",
+  "channel": "ctg.2.0.32",
+  "platform": "$MANIFEST_PLATFORM",
+  "webUI": false
+}
+EOF

package/tests/budget-engine.test.mjs

@@ -6,8 +6,9 @@ import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, rmSync } from 'nod
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { buildEngineArgs } from '../lib/engine.mjs';
 
-for (const mode of ['tools', 'seconds', 'repairs']) test(`actual engine stops ${mode}, restores budget and accepts explicit reset offline`, { timeout: 120000 }, async t => {
+for (const mode of ['tools', 'seconds', 'repairs']) test(`legacy engine boundary stops ${mode}, restores budget and accepts explicit reset offline`, { timeout: 120000 }, async t => {
   const cwd = mkdtempSync(join(tmpdir(), 'budget café '));
   t.after(() => rmSync(cwd, { recursive: true, force: true }));
   let calls = 0;
@@ -36,7 +37,7 @@ for (const mode of ['tools', 'seconds', 'repairs']) test(`actual engine stops ${
   writeFileSync(join(agent, 'models.json'), JSON.stringify({ providers: { localtest: { baseUrl: `http://127.0.0.1:${server.address().port}/v1`, api: 'openai-completions', apiKey: 'dummy', models: [{ id: 'fixture', contextWindow: 128000, maxTokens: 1024 }] } } }));
   writeFileSync(join(cwd, 'input.txt'), 'café ✓');
   const session = join(cwd, 'session.jsonl');
-  const cli = fileURLToPath(new URL('../bin/ctg.mjs', import.meta.url));
+  const cli = fileURLToPath(new URL('../vendor/agent/cli.js', import.meta.url));
   let beforeRestore = -1;
   let forcedKill = false;
   async function run(prompt, secondsLimit = mode === 'seconds' ? '5' : '10000', expectBudgetStop = false) {
@@ -44,7 +45,7 @@ for (const mode of ['tools', 'seconds', 'repairs']) test(`actual engine stops ${
     let priorEntryCount = 0;
     try { priorEntryCount = readFileSync(session, 'utf8').split('\n').filter(Boolean).length; } catch { /* Initial session has not been created yet. */ }
     let budgetStoppedAt = null;
-    const child = spawn(process.execPath, [cli, '-p', '--no-guide', '--provider', 'localtest', '--model', 'fixture', '--session', session, '--max-tools', mode === 'tools' ? '1' : '0', '--max-seconds', secondsLimit, '--max-repairs', mode === 'repairs' ? '1' : '0', prompt], { cwd, env: { ...process.env, PI_OFFLINE: '1', CARTHAGENT_CODING_AGENT_DIR: agent, PI_CODING_AGENT_DIR: agent } });
+    const child = spawn(process.execPath, [cli, '--offline', '-p', ...buildEngineArgs({ isolate: true, provider: 'localtest', model: 'fixture', session, maxTools: mode === 'tools' ? '1' : '0', maxSeconds: secondsLimit, maxRepairs: mode === 'repairs' ? '1' : '0' }), prompt], { cwd, env: { ...process.env, PI_OFFLINE: '1', CARTHAGENT_CODING_AGENT_DIR: agent, PI_CODING_AGENT_DIR: agent } });
     child.stdin.end();
     let output = ''; child.stdout.on('data', d => output += d); child.stderr.on('data', d => output += d);
     let timer;