@litfamily/litopencode 1.0.35 → 1.0.37

package/CHANGELOG.md

@@ -5,6 +5,16 @@ are tracked separately from this product history.
 
 ## Unreleased
 
+## 1.0.37 - 2026-11-01
+
+- `lit-typographic-motion` films can now carry real keyed footage, such as a reaction clip or a spinning-cat loop shot on a green screen. Key it outside the renderer into 8-bit RGBA PNG frames, put them in `stage/clips/<folder>/` and list them in `stage/clips/clips.json` (`id`, `dir`, `count`, `fps`). The page loads `/lit/clips.js`, registers a clip once with `LitStage.clip({ parent, id, box })` and shows it from `render(t)`; the frame is picked from film time, so a cue is plain arithmetic and the determinism replay holds. A declared clip is checked against its bytes (12 clips, 360 frames each and 1500 in all, 40 MB each and 128 MB in all, 720 px on the long side, up to 30 fps, real transparency) and is exempt from the flipbook rule; any frame sequence you did not declare is still refused with exit 17. A cover takes no clips. The flash audit and the text checks run on the final pixels, and the report lists each clip. `LitStage.clip.circle`, `wipe` and `iris` keep working.
+- On OpenCode 2 the lit HUD is as complete as on OpenCode 1. The status card (discipline, workflow map, bar, live step, skill chips, lanes in parallel, context use and branch) now sits under every session, the stage chip appears beside the ignition line under the prompt, and the home screen shows the last goal. Until now only the ignition line and the sidebar panel were drawn there. The card reads OpenCode 2's own tool names, so a `skill` call (`id`) lights its chip and `subagent` calls show as lanes.
+- OpenCode 2 also gets pop-ups for the workflow stage moving, a discipline switching and a lane starting or finishing, next to the plan, goal, blocker and completion pop-ups it already had. The restart notice, the `lit adhd` suggestion and the opt-in finish alert (`notify` in the plugin options) work there too.
+
+## 1.0.36 - 2026-10-31
+
+- On OpenCode 2.2 and later, `lit loop`, `litwork` and `/start-work` set OpenCode's native `/goal` for you. The goal carries your task plus what done means here (tests pass, a real-surface check ran, temporary files are cleaned up, the ledger is closed), and each change prints one `LitOpenCode goal:` line. LitOpenCode manages only goals it created: it resumes one that a server restart paused, clears one after OpenCode's verdict and the ledger both say done, and reports a goal you made as left alone without touching it. When OpenCode says the goal is met but the ledger is open, you get a conflict line and no done. Planning, research, review and bare `lit` never set a goal. OpenCode 1 and older OpenCode 2 builds have no `/goal`, so the ledger carries the work and `native-goal-unavailable` is recorded once.
+
 ## 1.0.35 - 2026-10-31
 
 - `lit adhd` counts the other lanes before it offers to resume this session's own work. A session that had started herdr lanes (or sat beside other running sessions) was still told to continue its paused discipline with `go` while they worked; now the box says to wait for them, arms nothing and ends with "Do not type `go` until they finish." A pending approval is still offered, and without lanes the paused discipline is offered as before.

package/README-Ko-KR.md

@@ -1,13 +1,13 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 일곱 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 일곱 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 # LitOpenCode
 
 **LitOpenCode는 OpenCode용 워크플로 플러그인입니다. 프롬프트에 `lit`만 붙이면 계획하고, 만들고, 확인하고, 기록까지 남겨서 다음 세션이 어디서 멈췄는지 바로 압니다.**
 
 <p align="center">
-<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/readme/badge-version.svg" alt="1.0.35" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/readme/badge-version.svg" alt="1.0.37" /></a>
 <a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="월간 npm 다운로드 수" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
 <a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub 스타" /></a>
 </p>
 
@@ -57,9 +57,9 @@ npm uninstall -g @litfamily/litopencode
 ## 더 보기
 
 - [GitHub의 사용 안내](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide-Ko-KR.md): 설치 옵션, 자동 인수인계, 문제 해결, 제거
-- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/reference.md)
-- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/privacy.md)
-- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/LICENSE) · [상표 정책](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/TRADEMARK.md) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/reference.md)
+- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/privacy.md)
+- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/LICENSE) · [상표 정책](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/TRADEMARK.md) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/readme/JetBrainsMono-OFL.txt)
 
 <details>
 <summary>ASCII 로고 복사</summary>

package/README.md

@@ -1,13 +1,13 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 # LitOpenCode
 
 **LitOpenCode is a workflow plugin for OpenCode. Add `lit` to a prompt and the work gets planned, built, checked and written down, so the next session knows where you stopped.**
 
 <p align="center">
-<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/readme/badge-version.svg" alt="1.0.35" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/readme/badge-version.svg" alt="1.0.37" /></a>
 <a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="npm downloads per month" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 <a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub stars" /></a>
 </p>
 
@@ -57,9 +57,9 @@ npm uninstall -g @litfamily/litopencode
 ## More
 
 - [Guide on GitHub](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide.md): install options, automatic handoff, troubleshooting and removal.
-- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/reference.md)
-- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/privacy.md)
-- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/LICENSE) · [Trademark policy](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/TRADEMARK.md) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.35/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/reference.md)
+- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/privacy.md)
+- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/LICENSE) · [Trademark policy](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/TRADEMARK.md) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.37/docs/assets/readme/JetBrainsMono-OFL.txt)
 
 <details>
 <summary>Copy ASCII logo</summary>

package/dist/activation-primary-prompts.js

@@ -80,9 +80,13 @@ Checkpoint as you go so progress is durable and incremental — never batch it t
 
 # OpenCode goal handoff
 
-OpenCode does not expose a native goal primitive in the verified plugin or CLI surface.
-Use LitOpenCode-owned durable goal state under .litopencode/litgoal/lit-loop instead of
-claiming a host-native /goal integration. If a request refers to a Codex-native goal,
+OpenCode 2.2 and later has a native /goal. On such a host LitOpenCode sets, resumes and clears
+one for lit-loop, start-work and litwork by itself and prints a "LitOpenCode goal:" line for each
+change. Do not type /goal yourself, and never touch a goal the user made. OpenCode 1 and older
+OpenCode 2 hosts have none; the work then runs on the ledger alone (native-goal-unavailable).
+The durable ledger under .litopencode/litgoal/lit-loop is the evidence record on every host:
+a goal counts as done only when OpenCode's verdict and the ledger both say so, so never
+report done while the ledger is open. If a request refers to a Codex-native goal,
 translate it into LitOpenCode's durable ledger semantics and make that adaptation
 explicit before execution.
 

package/dist/activation.js

@@ -12,6 +12,8 @@ import { typedPromptReply } from "./adhd-next.js";
 import { decideReentry, recordActivation } from "./activation-reentry.js";
 import { startTypedWork, typedStartArgument } from "./start-work-typed.js";
 import { micro, supportsMarkGlyphs } from "./lit-mark.js";
+import { recordNativeGoalUnavailable } from "./native-goal-ledger.js";
+import { nativeGoalRoute } from "./v2/native-goal.js";
 // Prompt modules preserve minimum-first, single-task or few-task planning, avoidable custom code review,
 // and external-source safety; this module only coordinates their unchanged activation surfaces.
 export { litHandoffPromptInjection, scientificVisualizationPromptInjection } from "./activation-managed-prompts.js";
@@ -228,6 +230,9 @@ export function createChatMessageActivationHook(projectRoot, options = {}) {
             return;
         }
         await options.onSkillActivation?.(input.sessionID, mode, appendedLit);
+        const goalRoute = nativeGoalRoute(mode, triggerText ?? "");
+        if (goalRoute !== undefined)
+            await recordNativeGoalUnavailable(projectRoot, input.sessionID, goalRoute, "opencode-1");
         if (mode === "lit-scientific-visualization") {
             options.onScientificVisualizationActivation?.(input.sessionID);
         }

package/dist/commands.js

@@ -9,8 +9,18 @@ import { writeNext } from "./adhd-next.js";
 import { autoHandoffSettingText } from "./auto-handoff.js";
 import { formatResolvedPlanNotice, formatSavedPlanNotice, parsePlanSaveArgument, persistApprovedPlan, PlanScopeError, resolveLatestDurablePlan } from "./durable-plan.js";
 import { isWorkflowFamilyMode, workflowFamilyCommandDefinitions } from "./workflow-families.js";
+import { recordNativeGoalUnavailable } from "./native-goal-ledger.js";
+import { nativeGoalRoute } from "./v2/native-goal.js";
 import { captureKnowledgeEvent, inspectKnowledge, queryKnowledge, recoverKnowledge, reviewKnowledgeRecord } from "./knowledge.js";
 export { litActivationBanner, startWorkPromptInjection } from "./activation.js";
+/**
+ * The four loop commands share one prompt, and an installed alias file hands the host exactly that text,
+ * so the prompt alone cannot say which command was typed. A last line names it; the plugin reads it to tell
+ * `/lit-loop` and `/litwork` (which set a native goal) from bare `/lit` (which does not).
+ */
+function loopCommandText(id) {
+    return `${litLoopPromptInjection}\nCommand route: "${id}"`;
+}
 export const litOpenCodeCommands = Object.freeze([
     ...workflowFamilyCommandDefinitions,
     {
@@ -35,7 +45,7 @@ export const litOpenCodeCommands = Object.freeze([
         title: "LitOpenCode",
         description: "Activate the LitOpenCode model probe line and durable goal loop.",
         banner: activationBanner("lit"),
-        activationText: litLoopPromptInjection
+        activationText: loopCommandText("lit")
     },
     {
         id: "lit-loop",
@@ -43,7 +53,7 @@ export const litOpenCodeCommands = Object.freeze([
         title: "LitOpenCode Lit Loop",
         description: "Activate the full LitOpenCode durable lit-loop prompt.",
         banner: activationBanner("lit-loop"),
-        activationText: litLoopPromptInjection
+        activationText: loopCommandText("lit-loop")
     },
     {
         id: "litwork",
@@ -51,7 +61,7 @@ export const litOpenCodeCommands = Object.freeze([
         title: "LitOpenCode Work Loop",
         description: "Resume a LitOpenCode work loop with durable ledger-backed progress.",
         banner: activationBanner("litwork"),
-        activationText: litLoopPromptInjection
+        activationText: loopCommandText("litwork")
     },
     {
         id: "lit-work",
@@ -59,7 +69,7 @@ export const litOpenCodeCommands = Object.freeze([
         title: "LitOpenCode Work Loop",
         description: "Hyphenated alias for /litwork.",
         banner: activationBanner("lit-work"),
-        activationText: litLoopPromptInjection
+        activationText: loopCommandText("lit-work")
     },
     {
         id: "start-work",
@@ -664,6 +674,9 @@ export function createCommandActivationHook(projectRoot, options = {}) {
             }
         });
         await options.onSkillActivation?.(input.sessionID, command.id);
+        const goalRoute = nativeGoalRoute(command.id, "");
+        if (goalRoute !== undefined)
+            await recordNativeGoalUnavailable(projectRoot, input.sessionID, goalRoute, "opencode-1");
         if (command.id === "lit-scientific-visualization") {
             options.onScientificVisualizationActivation?.(input.sessionID);
         }

package/dist/native-goal-ledger.d.ts

@@ -0,0 +1,43 @@
+export type NativeGoalLedgerEvent = {
+    readonly type: "native-goal.created";
+    readonly goalID: string;
+} | {
+    readonly type: "native-goal.resumed";
+    readonly goalID: string;
+} | {
+    readonly type: "native-goal.cleared";
+    readonly goalID: string;
+} | {
+    readonly type: "native-goal.left-alone";
+    readonly goalID: string;
+    readonly status: string;
+} | {
+    readonly type: "native-goal.conflict";
+    readonly goalID: string;
+    readonly reason: string;
+} | {
+    readonly type: "native-goal.failed";
+    readonly step: string;
+    readonly detail: string;
+} | {
+    readonly type: "native-goal.unavailable";
+    readonly host: string;
+};
+export type NativeGoalOwnership = {
+    readonly goalID: string | undefined;
+    readonly resumes: number;
+    readonly createdAt: string | undefined;
+};
+export declare function recordNativeGoal(projectRoot: string, sessionID: string, route: string | undefined, event: NativeGoalLedgerEvent): Promise<boolean>;
+/** The goal id LitOpenCode created for this session and has not cleared, with its resume count. */
+export declare function nativeGoalOwnership(projectRoot: string, sessionID: string): Promise<NativeGoalOwnership>;
+/** OpenCode 1 and older OpenCode 2 hosts have no `/goal`: say so once per session and route. */
+export declare function recordNativeGoalUnavailable(projectRoot: string, sessionID: string, route: string, host: string): Promise<void>;
+/**
+ * True when the evidence ledger holds a goal for this session that is complete and was last written after
+ * the native goal was created. A session's first ledger goal stays complete for good, so an older one must
+ * not close a later native goal.
+ */
+export declare function ledgerGoalDone(projectRoot: string, sessionID: string, since?: string): Promise<boolean>;
+/** Whether the ledger already holds an event of this type for the session (used to say a thing once). */
+export declare function nativeGoalRecorded(projectRoot: string, sessionID: string, type: NativeGoalLedgerEvent["type"], route?: string): Promise<boolean>;

package/dist/native-goal-ledger.js

@@ -0,0 +1,74 @@
+// The native-goal records in LitOpenCode's own ledger (`.litopencode/litgoal`). OpenCode's goal has no
+// owner field, so the ledger is where LitOpenCode remembers which goal id it created, how often it
+// resumed it, and that a host had no `/goal`. Every write is best-effort: a ledger failure never blocks
+// the work, and a read failure reads as "owns nothing", which only makes LitOpenCode do less.
+import { createLitGoalOperations, readEvidenceLedger } from "./ledger.js";
+export async function recordNativeGoal(projectRoot, sessionID, route, event) {
+    try {
+        const operations = createLitGoalOperations(projectRoot);
+        await operations.init();
+        await operations.append({ ...event, sessionID, ...(route === undefined ? {} : { route }), timestamp: new Date().toISOString() });
+        return true;
+    }
+    catch { // no-excuse-ok: catch -- a ledger failure must never block the user's work.
+        return false;
+    }
+}
+/** The goal id LitOpenCode created for this session and has not cleared, with its resume count. */
+export async function nativeGoalOwnership(projectRoot, sessionID) {
+    let goalID;
+    let createdAt;
+    let resumes = 0;
+    try {
+        for (const event of await createLitGoalOperations(projectRoot).read()) {
+            if (event["sessionID"] !== sessionID || typeof event["goalID"] !== "string")
+                continue;
+            if (event.type === "native-goal.created") {
+                goalID = event["goalID"];
+                createdAt = typeof event["timestamp"] === "string" ? event["timestamp"] : undefined;
+                resumes = 0;
+            }
+            else if (event.type === "native-goal.cleared" && event["goalID"] === goalID) {
+                goalID = undefined;
+                createdAt = undefined;
+            }
+            else if (event.type === "native-goal.resumed" && event["goalID"] === goalID) {
+                resumes += 1;
+            }
+        }
+    }
+    catch { // no-excuse-ok: catch -- an unreadable ledger reads as "owns nothing", so LitOpenCode touches nothing.
+        return { goalID: undefined, resumes: 0, createdAt: undefined };
+    }
+    return { goalID, resumes, createdAt };
+}
+/** OpenCode 1 and older OpenCode 2 hosts have no `/goal`: say so once per session and route. */
+export async function recordNativeGoalUnavailable(projectRoot, sessionID, route, host) {
+    if (await nativeGoalRecorded(projectRoot, sessionID, "native-goal.unavailable", route))
+        return;
+    await recordNativeGoal(projectRoot, sessionID, route, { type: "native-goal.unavailable", host });
+}
+/**
+ * True when the evidence ledger holds a goal for this session that is complete and was last written after
+ * the native goal was created. A session's first ledger goal stays complete for good, so an older one must
+ * not close a later native goal.
+ */
+export async function ledgerGoalDone(projectRoot, sessionID, since) {
+    try {
+        const state = await readEvidenceLedger(projectRoot);
+        const floor = since === undefined ? Number.NaN : Date.parse(since);
+        return state.goals.some((goal) => goal.sessionId === sessionID && goal.status === "complete" && (Number.isNaN(floor) || Date.parse(goal.updatedAt) >= floor));
+    }
+    catch { // no-excuse-ok: catch -- an unreadable evidence ledger is not done.
+        return false;
+    }
+}
+/** Whether the ledger already holds an event of this type for the session (used to say a thing once). */
+export async function nativeGoalRecorded(projectRoot, sessionID, type, route) {
+    try {
+        return (await createLitGoalOperations(projectRoot).read()).some((event) => event.type === type && event["sessionID"] === sessionID && (route === undefined || event["route"] === route));
+    }
+    catch { // no-excuse-ok: catch -- an unreadable ledger cannot prove the record exists.
+        return false;
+    }
+}

package/dist/tui/mission-skills.js

@@ -25,7 +25,9 @@ export function readSkillUse(part, at) {
         const input = isRecord(state.input) ? state.input : {};
         const start = isRecord(state.time) && typeof state.time.start === "number" ? state.time.start : at;
         if (part.tool === "skill") {
-            return typeof input.name === "string" && ownSkills.has(input.name) ? { name: input.name, at: start } : undefined;
+            // OpenCode 1's skill tool takes `name`; OpenCode 2's takes `id`.
+            const skill = typeof input.name === "string" ? input.name : typeof input.id === "string" ? input.id : undefined;
+            return skill !== undefined && ownSkills.has(skill) ? { name: skill, at: start } : undefined;
         }
         const name = ownTools[part.tool];
         if (name === undefined || input.action === "status")

package/dist/tui/mission-source-v2.d.ts

@@ -15,16 +15,39 @@ type V2Message = {
     readonly content?: ReadonlyArray<{
         readonly type: string;
         readonly name?: string;
+        readonly text?: string;
         readonly state?: {
             readonly status?: string;
+            readonly input?: unknown;
+            readonly metadata?: unknown;
         };
         readonly time?: {
             readonly created?: number;
             readonly ran?: number;
+            readonly completed?: number;
         };
     }>;
 };
+type V2Model = {
+    readonly providerID: string;
+    readonly modelID: string;
+    readonly limit?: {
+        readonly context?: number;
+    };
+};
 export type MissionDataV2 = {
+    readonly location?: {
+        readonly vcs?: {
+            info(): {
+                readonly branch?: {
+                    readonly current?: string;
+                };
+            } | undefined;
+        };
+        readonly model?: {
+            list(): ReadonlyArray<V2Model> | undefined;
+        };
+    };
     readonly session: {
         status(sessionID: string): "idle" | "running";
         readonly message: {

package/dist/tui/mission-source-v2.js

@@ -5,11 +5,23 @@ function isMessage(value) {
 export function sessionMessagesV2(data, sessionID) {
     return (data.session.message.list(sessionID) ?? []).filter(isMessage).filter((message) => message.type === "user" || message.type === "assistant");
 }
+/** The provider table the context figure reads: each model's context window, from the host's model list. */
+function providersV2(data) {
+    const byProvider = new Map();
+    for (const model of data.location?.model?.list() ?? []) {
+        const models = byProvider.get(model.providerID) ?? {};
+        models[model.modelID] = { limit: { context: model.limit?.context } };
+        byProvider.set(model.providerID, models);
+    }
+    return [...byProvider].map(([id, models]) => ({ id, models }));
+}
 export function missionStateFromV2(data, directory) {
     const index = new Map();
+    const branch = data.location?.vcs?.info()?.branch?.current?.trim();
     return {
         path: directory === undefined ? {} : { directory },
-        provider: [],
+        ...(branch === undefined || branch === "" ? {} : { vcs: { branch } }),
+        provider: providersV2(data),
         session: {
             messages(sessionID) {
                 return sessionMessagesV2(data, sessionID).map((message) => {
@@ -35,9 +47,22 @@ export function missionStateFromV2(data, directory) {
                 return [];
             if (message.type === "user")
                 return message.metadata === undefined ? [] : [{ metadata: message.metadata }];
-            return (message.content ?? [])
-                .filter((item) => item.type === "tool" && typeof item.name === "string")
-                .map((item) => ({ type: "tool", tool: item.name, state: { status: item.state?.status, time: { start: item.time?.ran ?? item.time?.created } } }));
+            return (message.content ?? []).flatMap((item) => {
+                if (item.type === "text" && typeof item.text === "string")
+                    return [{ type: "text", text: item.text }];
+                if (item.type !== "tool" || typeof item.name !== "string")
+                    return [];
+                return [{
+                        type: "tool",
+                        tool: item.name,
+                        state: {
+                            status: item.state?.status,
+                            input: item.state?.input,
+                            metadata: item.state?.metadata,
+                            time: { start: item.time?.ran ?? item.time?.created, ...(item.time?.completed === undefined ? {} : { end: item.time.completed }) }
+                        }
+                    }];
+            });
         }
     };
 }

package/dist/tui/mission-source.d.ts

@@ -52,6 +52,7 @@ export type MissionStateSource = {
         readonly tool?: unknown;
         readonly state?: unknown;
         readonly metadata?: unknown;
+        readonly text?: unknown;
     }>;
 };
 /** The same root the server plugin uses: the worktree unless it is the filesystem root, else the directory. */

package/dist/tui/mission-source.js

@@ -330,7 +330,8 @@ function taskSources(state, sessionID, now) {
     const assistants = state.session.messages(sessionID).filter((message) => message.role === "assistant").slice(-recentAssistantMessages);
     for (const message of assistants) {
         for (const part of state.part(message.id)) {
-            if (part.type !== "tool" || part.tool !== "task" || !isRecord(part.state))
+            // OpenCode 1 delegates through `task`, OpenCode 2 through `subagent`.
+            if (part.type !== "tool" || (part.tool !== "task" && part.tool !== "subagent") || !isRecord(part.state))
                 continue;
             const toolState = part.state;
             const status = toolState.status;
@@ -348,7 +349,7 @@ function taskSources(state, sessionID, now) {
                 children.add(child);
             const todos = child === undefined ? [] : state.session.todo(child).filter((todo) => todo.status !== "cancelled");
             const done = todos.filter((todo) => todo.status === "completed").length;
-            const name = typeof input.description === "string" && input.description.trim() !== "" ? input.description.trim() : typeof input.subagent_type === "string" ? input.subagent_type : "subagent";
+            const name = typeof input.description === "string" && input.description.trim() !== "" ? input.description.trim() : typeof input.subagent_type === "string" ? input.subagent_type : typeof input.agent === "string" ? input.agent : "subagent";
             // A running task last moved when its own session did; its start time alone would read a long, busy run as idle.
             const moved = child === undefined ? undefined : lastActivity(state, child);
             sources.push({

package/dist/v2/commands.d.ts

@@ -36,6 +36,7 @@ export declare function pluginOwnedCommandIds(roots: readonly string[]): readonl
 export type CommandMark = {
     readonly command: string;
     readonly banner: string;
+    readonly work?: string;
 };
 export declare function createV2Commands(roots: readonly string[], session: CommandSessionLike): {
     definitions: CommandDefinitionLike[];

package/dist/v2/commands.js

@@ -29,8 +29,8 @@ export function createV2Commands(roots, session) {
         async execute(input) {
             const nonce = randomUUID();
             const mark = { command: command.id, banner: command.banner };
-            pending.set(input.sessionID, { nonce, mark });
             const argumentsText = input.prompt.text.trim();
+            pending.set(input.sessionID, { nonce, mark, work: argumentsText });
             if (command.agent !== undefined)
                 await session.switchAgent({ sessionID: input.sessionID, agent: command.agent });
             await session.prompt({
@@ -52,7 +52,7 @@ export function createV2Commands(roots, session) {
         if (expected === undefined || marker.nonce !== expected.nonce)
             return undefined;
         pending.delete(sessionID);
-        return expected.mark;
+        return { ...expected.mark, work: expected.work };
     }
     return {
         definitions,

package/dist/v2/context.d.ts

@@ -3,6 +3,7 @@ import type { AgentEditorLike, ModelEditorLike, PermissionEvaluationLike, Sessio
 import type { CommandEditorLike, CommandSessionLike } from "./commands.ts";
 import type { EventDomainLike, EventModelLike, EventSessionLike } from "./events.ts";
 import type { ToolAfterEvent, ToolBeforeEvent } from "./hooks.ts";
+import type { NativeGoalHostLike } from "./native-goal-runtime.ts";
 import type { ContextEvent, PromptEvent } from "./session-hooks.ts";
 import type { ToolEditorLike } from "./tools.ts";
 export type Registration = {
@@ -28,6 +29,9 @@ type SessionHook = {
     (name: "prompt", callback: Callback<PromptEvent>): Promise<Registration>;
     (name: "context", callback: Callback<ContextEvent>): Promise<Registration>;
     (name: "compaction", callback: Callback<ContextEvent>): Promise<Registration>;
+    (name: "experimental.idle", callback: Callback<{
+        readonly sessionID: string;
+    }>): Promise<Registration>;
 };
 export type SessionDomainLike = {
     readonly get: (input: {
@@ -49,7 +53,8 @@ export type ServerContextLike = {
     readonly command: {
         readonly transform: Transform<CommandEditorLike>;
     };
-    readonly session: SessionDomainLike & SessionModelDomainLike & CommandSessionLike & EventSessionLike & {
+    readonly rpc?: NativeGoalHostLike["rpc"];
+    readonly session: SessionDomainLike & SessionModelDomainLike & CommandSessionLike & EventSessionLike & NativeGoalHostLike["session"] & {
         readonly hook: SessionHook;
     };
     readonly event: EventDomainLike;

package/dist/v2/native-goal-runtime.d.ts

@@ -0,0 +1,74 @@
+import { type NativeGoalRoute } from "./native-goal.ts";
+/** The `opencode.goal` RPC contract as JSON Schema, so the package needs no runtime import of the host's schema library. */
+declare const goalDefinition: Readonly<{
+    id: "opencode.goal";
+    methods: Readonly<{
+        get: Readonly<{
+            input: Readonly<{
+                type: "object";
+                properties: Readonly<{
+                    sessionID: Readonly<{
+                        type: "string";
+                    }>;
+                }>;
+                required: readonly string[];
+            }>;
+            output: Readonly<{}>;
+        }>;
+    }>;
+    events: Readonly<{
+        changed: Readonly<{
+            schema: Readonly<{
+                type: "object";
+                properties: Readonly<{
+                    sessionID: Readonly<{
+                        type: "string";
+                    }>;
+                }>;
+                required: readonly string[];
+            }>;
+        }>;
+    }>;
+}>;
+export type GoalRpcClientLike = {
+    readonly get: (input: {
+        readonly sessionID: string;
+    }) => Promise<unknown>;
+};
+export type NativeGoalHostLike = {
+    /** `context.rpc`; absent on a host that has no RPC domain. */
+    readonly rpc?: (definition: typeof goalDefinition) => GoalRpcClientLike;
+    readonly session: {
+        readonly command: (input: {
+            readonly sessionID: string;
+            readonly name: string;
+            readonly text: string;
+            readonly delivery?: "steer" | "queue";
+        }) => Promise<unknown>;
+        readonly synthetic: (input: {
+            readonly sessionID: string;
+            readonly text: string;
+            readonly description?: string;
+            readonly metadata?: Readonly<Record<string, string>>;
+            readonly resume?: boolean;
+        }) => Promise<unknown>;
+    };
+};
+/** A prompt the host expanded from an installed command alias file arrives as the command body, unmarked. */
+export declare function aliasGoalRoute(input: string): {
+    readonly route: NativeGoalRoute;
+    readonly work: string;
+} | undefined;
+export declare function createNativeGoal(options: {
+    readonly projectRoot: string;
+    readonly host: NativeGoalHostLike;
+}): {
+    /** Starts the goal step for a qualifying activation without holding up the user's prompt. */
+    activate(sessionID: string, route: NativeGoalRoute, work: string): Promise<void>;
+    /** The session finished its model work: clear a finished owned goal or report a conflict. */
+    idle(sessionID: string): Promise<void>;
+    /** Resolves when every started goal step has finished. */
+    settled(): Promise<void>;
+};
+export type NativeGoal = ReturnType<typeof createNativeGoal>;
+export {};