@osovv/vv-opencode 1.7.0 → 2.0.0

package/dist/plugins/workflow/v2.d.ts

@@ -0,0 +1,58 @@
+import type { Plugin as V2Plugin } from "@opencode/plugin";
+import type { V2AdapterContext } from "../v2-runtime/setup.js";
+/**
+ * A v1-shaped client built on v2 domains. Session lookups map onto
+ * ctx.session, logging degrades to console, and the repair continuation
+ * prompt is unsupported under the v2 prompt shape and throws so the
+ * bounded continuation path fails closed exactly like a failed continuation.
+ */
+export declare function createWorkflowClientShim(adapter: V2AdapterContext): {
+    app: {
+        log: () => Promise<void>;
+    };
+    session: {
+        get: (input: {
+            path: {
+                id: string;
+            };
+        }) => Promise<{
+            data: import("@opencode/client").SessionInfo;
+        }>;
+        message: (input: {
+            path: {
+                id: string;
+                messageID: string;
+            };
+        }) => Promise<{
+            data: {
+                id?: string;
+            };
+            error?: undefined;
+        } | {
+            data: undefined;
+            error: {
+                name: string;
+            };
+        }>;
+        prompt: (_input: unknown) => Promise<never>;
+    };
+};
+/**
+ * Map v2 subagent launch arguments onto the v1 task shape the launch
+ * validation consumes: agent becomes subagent_type, the v2 resume sessionID
+ * becomes task_id, and background passes through. The v1 reader fields stay
+ * authoritative so every eligibility rule applies unchanged.
+ */
+export declare function adaptSubagentLaunchArgs(input: unknown): unknown;
+/**
+ * Bridge the workflow surface onto the v2 runtime.
+ *
+ * The v1 factory runs once with the shimmed client; its returned hook object
+ * is routed onto v2 domains: tools publish with their strict JSON Schema
+ * inputs, before and after guards run as v2 tool hooks with the launcher
+ * renamed from task to subagent, and the profile guidance appends through
+ * the session context hook. Protocol parsing stays fail-closed: envelope
+ * shapes the shared parser does not recognize reject the attempt, never
+ * accept it.
+ */
+export declare function setupWorkflowV2(adapter: V2AdapterContext): Promise<V2Plugin.Cleanup | void>;

package/dist/plugins/workflow/v2.js

@@ -0,0 +1,181 @@
+// FILE: src/plugins/workflow/v2.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Run the complete workflow enforcement surface on the OpenCode v2 runtime by bridging the v1 plugin factory's hooks and tools onto v2 domains.
+//   SCOPE: v2 setup only: instantiate the v1 factory once with a shimmed client, register its five tools with their strict JSON Schema inputs through the tool transform, route execute.before and execute.after through v2 tool hooks with subagent-launch argument adaptation (v2 names the launcher subagent with agent and sessionID fields), append the profile guidance through the session context hook, and keep every fail-closed guarantee of the shared protocol unchanged.
+//   DEPENDS: [@opencode/plugin, src/lib/config-layers.ts, src/plugins/workflow/index.ts, src/plugins/v2-runtime/setup.ts]
+//   LINKS: [M-PLUGIN-WORKFLOW, V-M-PLUGIN-WORKFLOW, M-WORKFLOW-PROTOCOL, M-PLUGIN-V2-RUNTIME]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   setupWorkflowV2 - Bridge the full workflow surface onto one OpenCode v2 plugin context.
+//   createWorkflowClientShim - v1-shaped client over v2 domains for the workflow authorization and repair surfaces.
+//   adaptSubagentLaunchArgs - Map v2 subagent tool arguments onto the v1 task launch shape.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [C-OPENCODE-V2-MIGRATION T-005 - Bridged the workflow enforcement surface onto v2 tool, session, and event domains.]
+// END_CHANGE_SUMMARY
+import { WorkflowPlugin } from "./index.js";
+// START_BLOCK_CREATE_WORKFLOW_CLIENT_SHIM
+/**
+ * A v1-shaped client built on v2 domains. Session lookups map onto
+ * ctx.session, logging degrades to console, and the repair continuation
+ * prompt is unsupported under the v2 prompt shape and throws so the
+ * bounded continuation path fails closed exactly like a failed continuation.
+ */
+export function createWorkflowClientShim(adapter) {
+    return {
+        app: {
+            log: async () => { },
+        },
+        session: {
+            get: async (input) => {
+                const data = await adapter.ctx.session.get({ sessionID: input.path.id });
+                return { data };
+            },
+            message: async (input) => {
+                try {
+                    const messages = await adapter.ctx.session.context({ sessionID: input.path.id });
+                    const hit = messages.find((message) => message.id === input.path.messageID);
+                    return hit ? { data: hit } : { data: undefined, error: { name: "NotFound" } };
+                }
+                catch {
+                    return { data: undefined, error: { name: "NotFound" } };
+                }
+            },
+            prompt: async (_input) => {
+                throw new Error("workflow continuation prompt is not available on the v2 runtime");
+            },
+        },
+    };
+}
+// END_BLOCK_CREATE_WORKFLOW_CLIENT_SHIM
+// START_BLOCK_ADAPT_SUBAGENT_LAUNCH_ARGS
+/**
+ * Map v2 subagent launch arguments onto the v1 task shape the launch
+ * validation consumes: agent becomes subagent_type, the v2 resume sessionID
+ * becomes task_id, and background passes through. The v1 reader fields stay
+ * authoritative so every eligibility rule applies unchanged.
+ */
+export function adaptSubagentLaunchArgs(input) {
+    if (!input || typeof input !== "object")
+        return input;
+    const record = input;
+    return {
+        ...record,
+        ...(typeof record.agent === "string" ? { subagent_type: record.agent } : {}),
+        ...(typeof record.sessionID === "string" ? { task_id: record.sessionID } : {}),
+    };
+}
+// END_BLOCK_ADAPT_SUBAGENT_LAUNCH_ARGS
+// START_BLOCK_SETUP_WORKFLOW_V2
+/**
+ * Bridge the workflow surface onto the v2 runtime.
+ *
+ * The v1 factory runs once with the shimmed client; its returned hook object
+ * is routed onto v2 domains: tools publish with their strict JSON Schema
+ * inputs, before and after guards run as v2 tool hooks with the launcher
+ * renamed from task to subagent, and the profile guidance appends through
+ * the session context hook. Protocol parsing stays fail-closed: envelope
+ * shapes the shared parser does not recognize reject the attempt, never
+ * accept it.
+ */
+export async function setupWorkflowV2(adapter) {
+    const directory = adapter.ctx.location.directory;
+    const hooks = (await WorkflowPlugin({
+        client: createWorkflowClientShim(adapter),
+        project: { id: directory, directory },
+        directory,
+        worktree: directory,
+        experimental_workspace: { register: () => { } },
+        serverUrl: new URL("http://127.0.0.1:1"),
+        $: {},
+    }));
+    if (!hooks)
+        return undefined;
+    const cleanups = [];
+    // Tools: publish each v1 tool entry with its contract JSON Schema input.
+    const toolEntries = (hooks.tool ?? {});
+    const { workflowToolContracts } = await import("./input-validation.js");
+    const toolRegistration = await adapter.ctx.tool.transform((editor) => {
+        for (const [name, entry] of Object.entries(toolEntries)) {
+            const contract = workflowToolContracts.find((item) => item.toolId === name);
+            editor.add({
+                name,
+                description: entry.description,
+                input: (contract?.inputJsonSchema ?? { type: "object" }),
+                execute: (async (input, context) => {
+                    const result = await entry.execute(input, {
+                        sessionID: context.sessionID,
+                        agent: context.agent,
+                        abort: context.signal,
+                    });
+                    return { content: typeof result === "string" ? result : JSON.stringify(result) };
+                }),
+            });
+        }
+    });
+    cleanups.push(() => toolRegistration.dispose());
+    // Owned validation plus task-launch tracking on execute.before.
+    const beforeHook = await adapter.ctx.tool.hook("execute.before", (event) => {
+        const tool = String(event.tool) === "subagent" ? "task" : String(event.tool);
+        const args = String(event.tool) === "subagent" ? adaptSubagentLaunchArgs(event.input) : event.input;
+        const before = hooks["tool.execute.before"];
+        if (!before)
+            return;
+        return before({ tool, sessionID: event.sessionID, callID: event.id, agent: event.agent }, { args });
+    });
+    cleanups.push(() => beforeHook.dispose());
+    // Delegated result tracking on execute.after.
+    const afterHook = await adapter.ctx.tool.hook("execute.after", (event) => {
+        if (event.status !== "completed")
+            return;
+        const tool = String(event.tool) === "subagent" ? "task" : String(event.tool);
+        const args = String(event.tool) === "subagent" ? adaptSubagentLaunchArgs(event.input) : event.input;
+        const result = event.result;
+        const output = typeof result.content === "string"
+            ? result.content
+            : Array.isArray(result.content)
+                ? result.content.map((part) => part.text ?? "").join("\n")
+                : "";
+        const after = hooks["tool.execute.after"];
+        if (!after)
+            return;
+        return after({ tool, sessionID: event.sessionID, callID: event.id, agent: event.agent, args }, { output, metadata: {} });
+    });
+    cleanups.push(() => afterHook.dispose());
+    // Profile guidance through the session context hook.
+    const chatMessage = hooks["chat.message"];
+    if (chatMessage) {
+        const contextHook = await adapter.ctx.session.hook("context", (event) => {
+            const message = {
+                agent: event.agent,
+                system: event.system
+                    .filter((part) => part.type === "text")
+                    .map((part) => part.text)
+                    .join("\n\n"),
+            };
+            const before = message.system;
+            const result = chatMessage({}, { message });
+            if (result instanceof Promise) {
+                return result.then(() => {
+                    if (typeof message.system === "string" && message.system !== before) {
+                        event.system.length = 0;
+                        event.system.push({ type: "text", text: message.system });
+                    }
+                });
+            }
+            return undefined;
+        });
+        cleanups.push(() => contextHook.dispose());
+    }
+    return async () => {
+        for (const dispose of cleanups.reverse())
+            await dispose();
+    };
+}
+// END_BLOCK_SETUP_WORKFLOW_V2
+//# sourceMappingURL=v2.js.map

package/dist/plugins/workflow/v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.js","sourceRoot":"","sources":["../../../src/plugins/workflow/v2.ts"],"names":[],"mappings":"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"}

package/dist/tui.d.ts

@@ -3,5 +3,6 @@ import { ContextTuiPlugin } from "./tui/context/plugin.js";
 export { ContextTuiPlugin };
 declare const plugin: TuiPluginModule & {
     id: string;
+    setup?: (context: unknown) => Promise<void> | void;
 };
 export default plugin;

package/dist/tui.js

@@ -1,21 +1,21 @@
 // FILE: src/tui.tsx
-// VERSION: 1.2.0
+// VERSION: 2.0.0
 // START_MODULE_CONTRACT
-//   PURPOSE: Publish the default @osovv/vv-opencode/tui module containing the managed context inspector, analytics indicator, branding footer, and peak-hours banner.
-//   SCOPE: Stable TUI package entrypoint and module identity only.
-//   DEPENDS: [@opencode-ai/plugin/tui, @opencode-ai/plugin, src/tui/context/plugin.ts, src/tui/analytics/indicator.tsx, src/tui/branding/footer.tsx, src/tui/peak-hours/banner.tsx]
+//   PURPOSE: Publish the dual-runtime TUI entrypoint: the full v1 context inspector, analytics indicator, branding footer, and peak-hours banner through tui(), and the v2 CLI plugin registration for /context through setup().
+//   SCOPE: Stable TUI package entrypoint and dual runtime identity only; feature registration stays in the focused modules.
+//   DEPENDS: [@opencode-ai/plugin/tui, @opencode/plugin/tui, src/tui/context/plugin.ts, src/tui/analytics/indicator.tsx, src/tui/branding/footer.tsx, src/tui/peak-hours/banner.tsx]
 //   LINKS: [M-PLUGIN-CONTEXT-TUI, M-TUI-ANALYTICS-INDICATOR, M-TUI-BRANDING-FOOTER, M-TUI-PEAK-HOURS-BANNER, V-M-PLUGIN-CONTEXT-TUI]
 //   ROLE: BARREL
 //   MAP_MODE: SUMMARY
 // END_MODULE_CONTRACT
 //
 // START_MODULE_MAP
-//   default - OpenCode TUI plugin module registering /context, the analytics indicator, the branding footer, and the peak-hours banner.
+//   default - Dual TUI entrypoint: v2 setup() registers the /context command, v1 tui() registers the full inspector, indicator, footer, and banner.
 //   ContextTuiPlugin - Named TUI plugin factory for direct consumers and tests.
 // END_MODULE_MAP
 //
 // START_CHANGE_SUMMARY
-//   LAST_CHANGE: [C-PLUGIN-PEAK-HOURS - Registered the app_bottom peak-hours banner alongside the indicator and footer.]
+//   LAST_CHANGE: [C-OPENCODE-V2-MIGRATION T-007 - Added the v2 CLI plugin setup registering /context beside the unchanged v1 TUI module.]
 // END_CHANGE_SUMMARY
 import { ContextTuiPlugin } from "./tui/context/plugin.js";
 import { registerAnalyticsIndicator } from "./tui/analytics/indicator.js";
@@ -46,6 +46,41 @@ const plugin = {
             // Fail-soft: banner unavailable for this session.
         }
     },
+    // START_BLOCK_V2_TUI_SETUP
+    // OpenCode v2 loads the same entrypoint through setup() with the CLI plugin
+    // context. The v2 surface registers the /context slash command; the full
+    // inspector components port onto the v2 dialog and router surfaces in a
+    // follow-up release and this command keeps the entry point honest.
+    async setup(context) {
+        const ctx = context;
+        try {
+            ctx.keymap.layer(() => ({
+                mode: "global",
+                commands: [
+                    {
+                        id: "vvoc.context",
+                        title: "vvoc context inspector",
+                        slash: { name: "context" },
+                        palette: true,
+                        run: async () => {
+                            const directory = ctx.data?.location?.default?.()?.directory ?? "unknown location";
+                            await ctx.ui.dialog.alert({
+                                title: "vvoc /context",
+                                message: `OpenCode v2 runtime (host ${ctx.app?.version ?? "unknown"}).\n` +
+                                    `Location: ${directory}\n` +
+                                    "The full v2 context inspector ships in the next vvoc release; " +
+                                    "server-side analytics, model roles, and guidance stay active.",
+                            });
+                        },
+                    },
+                ],
+            }));
+        }
+        catch {
+            // Fail-soft: the v2 TUI host may not expose keymap layers yet.
+        }
+    },
+    // END_BLOCK_V2_TUI_SETUP
 };
 // END_BLOCK_TUI_MODULE
 export default plugin;

package/dist/tui.js.map

@@ -1 +1 @@
-{"version":3,"file":"tui.js","sourceRoot":"","sources":["../src/tui.tsx"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,iBAAiB;AACjB,wBAAwB;AACxB,sKAAsK;AACtK,mEAAmE;AACnE,oLAAoL;AACpL,qIAAqI;AACrI,iBAAiB;AACjB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,wIAAwI;AACxI,gFAAgF;AAChF,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,yHAAyH;AACzH,qBAAqB;AAGrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,yBAAyB;AACzB,MAAM,MAAM,GAAqC;IAC/C,EAAE,EAAE,cAAc;IAClB,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAChC,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,0BAA0B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;QACD,IAAI,CAAC;YACH,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;CACF,CAAC;AACF,uBAAuB;AAEvB,eAAe,MAAM,CAAC"}
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../src/tui.tsx"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,iBAAiB;AACjB,wBAAwB;AACxB,iOAAiO;AACjO,4HAA4H;AAC5H,qLAAqL;AACrL,qIAAqI;AACrI,iBAAiB;AACjB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,oJAAoJ;AACpJ,gFAAgF;AAChF,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,0IAA0I;AAC1I,qBAAqB;AAGrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,yBAAyB;AACzB,MAAM,MAAM,GACV;IACE,EAAE,EAAE,cAAc;IAClB,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAChC,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,0BAA0B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;QACD,IAAI,CAAC;YACH,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IACD,2BAA2B;IAC3B,4EAA4E;IAC5E,yEAAyE;IACzE,wEAAwE;IACxE,mEAAmE;IACnE,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,GAAG,GAAG,OAaX,CAAC;QACF,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE;oBACR;wBACE,EAAE,EAAE,cAAc;wBAClB,KAAK,EAAE,wBAAwB;wBAC/B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;wBAC1B,OAAO,EAAE,IAAI;wBACb,GAAG,EAAE,KAAK,IAAI,EAAE;4BACd,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,IAAI,kBAAkB,CAAC;4BACnF,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;gCACxB,KAAK,EAAE,eAAe;gCACtB,OAAO,EACL,6BAA6B,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,SAAS,MAAM;oCAChE,aAAa,SAAS,IAAI;oCAC1B,gEAAgE;oCAChE,+DAA+D;6BAClE,CAAC,CAAC;wBACL,CAAC;qBACF;iBACF;aACF,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;IACH,CAAC;IACD,yBAAyB;CAC1B,CAAC;AACJ,uBAAuB;AAEvB,eAAe,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osovv/vv-opencode",
-  "version": "1.7.0",
+  "version": "2.0.0",
   "description": "An opinionated agentic development layer for OpenCode — spec-first when it matters, review-driven execution, portable model roles, safer tools, and long-run safety.",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,6 +34,8 @@
     "dist",
     "schemas",
     "templates",
+    "server.js",
+    "tui.js",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -42,6 +44,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./server": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./tui": {
       "types": "./dist/tui.d.ts",
       "import": "./dist/tui.js"
@@ -104,16 +110,18 @@
     "contracts:host": "bun scripts/check-tool-contracts-host.ts",
     "test": "bun test",
     "check": "bun run typecheck && bun run lint && bun run fmt:check && bun run grace:check && bun run contracts:check && bun test",
-    "pack:check": "bun run build && bun -e \"const root = await import('./dist/index.js'); if (!('GuardianPlugin' in root)) throw new Error('dist root export missing GuardianPlugin'); if (!('HashlineEditPlugin' in root)) throw new Error('dist root export missing HashlineEditPlugin'); if (!('ModelRolesPlugin' in root)) throw new Error('dist root export missing ModelRolesPlugin'); if (!('SystemContextInjectionPlugin' in root)) throw new Error('dist root export missing SystemContextInjectionPlugin'); if (!('WorkflowPlugin' in root)) throw new Error('dist root export missing WorkflowPlugin'); if (!('SecretsRedactionPlugin' in root)) throw new Error('dist root export missing SecretsRedactionPlugin'); if (!('WebToolsPlugin' in root)) throw new Error('dist root export missing WebToolsPlugin'); if (!('AnalyticsPlugin' in root)) throw new Error('dist root export missing AnalyticsPlugin'); if (!('PeakHoursPlugin' in root)) throw new Error('dist root export missing PeakHoursPlugin'); if (!('SpecGuardPlugin' in root)) throw new Error('dist root export missing SpecGuardPlugin'); const tui = await import('./dist/tui.js'); if (!tui.default || typeof tui.default.tui !== 'function') throw new Error('dist TUI export missing default tui module'); await import('./dist/plugins/guardian/index.js'); await import('./dist/plugins/hashline-edit/index.js'); await import('./dist/plugins/model-roles/index.js'); await import('./dist/plugins/system-context-injection/index.js'); await import('./dist/plugins/workflow/index.js'); await import('./dist/plugins/secrets-redaction/index.js'); await import('./dist/plugins/web-tools/index.js'); await import('./dist/plugins/analytics/index.js'); await import('./dist/plugins/peak-hours/index.js'); await import('./dist/plugins/spec-guard/index.js')\" && bun scripts/check-tool-contracts.ts --packed",
+    "pack:check": "bun run build && bun -e \"const root = await import('./dist/index.js'); const d = root.default; if (!d || d.id !== 'vvoc' || typeof d.setup !== 'function' || typeof d.server !== 'function') throw new Error('dist root export missing dual default entrypoint (id/setup/server)'); const pluginIds = ['vvoc.guardian','vvoc.hashline-edit','vvoc.model-roles','vvoc.system-context-injection','vvoc.workflow','vvoc.secrets-redaction','vvoc.web-tools','vvoc.tool-history-compaction','vvoc.analytics','vvoc.peak-hours','vvoc.spec-guard']; const subpaths = ['guardian','hashline-edit','model-roles','system-context-injection','workflow','secrets-redaction','web-tools','tool-history-compaction','analytics','peak-hours','spec-guard']; for (const s of subpaths) { const m = await import('./dist/plugins/' + s + '/index.js'); const e = m.default; if (!e || typeof e.id !== 'string' || typeof e.setup !== 'function' || typeof e.server !== 'function') throw new Error('dist subpath ' + s + ' missing dual default entrypoint'); if (!pluginIds.includes(e.id)) throw new Error('dist subpath ' + s + ' has unexpected id ' + e.id); } const tui = await import('./dist/tui.js'); if (!tui.default || typeof tui.default.tui !== 'function') throw new Error('dist TUI export missing default tui module')\" && bun scripts/check-tool-contracts.ts --packed",
     "tui:local": "bun scripts/tui-local.ts",
+    "e2e:v2": "bun scripts/e2e-v2.ts",
     "release:check": "bun scripts/release-check.ts",
     "release:bump": "bun scripts/release-bump.ts",
     "prepare": "lefthook install --force"
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@opencode-ai/plugin": "1.18.2",
-    "@opencode-ai/sdk": "1.18.2",
+    "@opencode-ai/plugin": "1.18.32",
+    "@opencode-ai/sdk": "1.18.32",
+    "@opencode/plugin": "2.0.18",
     "ajv": "^8.17.1",
     "citty": "0.2.2",
     "htmlparser2": "^12.0.0",
@@ -144,7 +152,7 @@
   },
   "engines": {
     "bun": ">=1.3.8",
-    "opencode": ">=1.18.2"
+    "opencode": ">=1.18.29"
   },
   "packageManager": "bun@1.3.8",
   "repository": {

package/schemas/vvoc/v3.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@1.7.0/schemas/vvoc/v3.json",
+  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@2.0.0/schemas/vvoc/v3.json",
   "title": "vvoc config",
   "description": "Canonical vvoc configuration document.",
   "type": "object",

package/server.js

@@ -0,0 +1,7 @@
+// FILE: server.js
+// VERSION: 1.0.0
+// OpenCode v2 resolves directory-scoped plugin targets through a literal
+// `server` module next to the package manifest before consulting the exports
+// map. This shim re-exports the dual-runtime default entrypoint so both the
+// file-path and npm-specifier loading styles reach the same plugin.
+export { default } from "./dist/index.js";

package/templates/skills/vv-execute/references/tool-contracts.md

@@ -2,7 +2,7 @@
 
 Generated from the pure tool catalog. Do not edit by hand; run `bun run contracts:generate`.
 
-- Package: `@osovv/vv-opencode@1.7.0`
+- Package: `@osovv/vv-opencode@2.0.0`
 - Tool contract revision: `1`
 - Reference path: `templates/skills/vv-execute/references/tool-contracts.md`
 - Current model-facing size: descriptions 8794 bytes, published input schemas 22572 bytes

package/tui.js

@@ -0,0 +1,7 @@
+// FILE: tui.js
+// VERSION: 1.0.0
+// OpenCode v2 resolves the CLI/TUI plugin entrypoint of directory-scoped
+// plugin targets through a literal `tui` module next to the package manifest.
+// This shim re-exports the dual-runtime default TUI entrypoint so the
+// file-path and npm-specifier loading styles stay equivalent.
+export { default } from "./dist/tui.js";