Distillation

Date: Sep 8, 2026

• 🔴 [enforced-workflow] (02:34) User required PTY consumers to follow the completion signal from the future <pty_exited> message: “Never poll with sleep and pty_read.” This instruction appears in /home/byk/.local/share/opencode-v2-pilot/config/opencode/plugins/pty.ts at line 235.
• 🔴 [enforced-workflow] (02:34) User required type checking with bun typecheck from package directories such as packages/core, never by running tsc directly; tests likewise cannot run from the repository root because of the do-not-run-tests-from-root guard.
• 🔴 [enforced-architecture] (02:34) User required runtime dependencies to flow from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; sdk composes Client, Core, and Server.
• 🔴 [enforced-style] (02:34) User required never aliasing imports, including forms such as import { foo as bar } from "..." and resolve as pathResolve.
• 🔴 [enforced-style] (02:34) User required never using type-position import("...") references such as Schema.declare<import("@opencode/plugin/effect/plugin").Plugin["effect"]>. An aliased type import such as import type { Plugin as PluginDefinition } from "..." is permitted only as a last resort when two imported names genuinely collide.
• 🔴 [enforced-style] (02:34) User required never using star imports (import * as Foo or import type * as Foo); namespace-style values must use the module’s own named exported namespace, e.g. import { Project } from "@opencode/core/project" and Project.ID.
• 🔴 (02:34) User’s repository /home/byk/Code/opencode-v2-pilot uses v2 as its default branch; new branches/worktrees default to v2 or origin/v2, pull requests default to target v2, and diffs should use v2/origin/v2 because local main may not exist.
• 🔴 [enforced-workflow] (02:34) User’s repository does not use Changesets; .changeset files must not be added.
• 🔴 [enforced-workflow] (02:34) After changing public Protocol or Server HttpApi, the required workflow is to run bun run generate from packages/client; generated client files must not be edited directly.
• 🔴 [enforced-style] (02:34) User’s branch names must contain at most three hyphen-separated words and must not use slashes or type prefixes such as feat/ or fix/; examples are session-recovery, fix-scroll-state, and regenerate-sdk.
• 🔴 [enforced-style] (02:34) User requires conventional commit-style commit messages and PR titles in the form type(scope): summary; valid types are feat, fix, docs, chore, refactor, and test, with optional scopes such as core, opencode, tui, app, desktop, sdk, or plugin.
• 🔴 (02:34) The plugin package has Effect and Promise versions. Every Effect-version domain must extend its corresponding Effect API client interface from @opencode/client/effect/api, must not redefine existing interface functions, and may add only functions meaningful in the plugin context.
• 🟡 (02:34) Review investigation enumerated Promise plugin API files including /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/session.ts, /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/adapter.ts, /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/plugin.ts, /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/shell.ts, and /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/types.ts, alongside corresponding Effect implementations under /home/byk/Code/opencode-v2-pilot/packages/plugin/src/effect/.
• 🟡 (02:34) Review investigation found the Promise adapter maps SessionEndpoints["session.synthetic"] to host.session.synthetic in /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/adapter.ts:575.
• 🟡 (02:34) Review investigation found session.synthetic server handling in /home/byk/Code/opencode-v2-pilot/packages/server/src/handlers/session.ts:380-383, its HTTP endpoint in /home/byk/Code/opencode-v2-pilot/packages/protocol/src/groups/session.ts:398-414 (POST /api/session/:sessionID/synthetic, identifier v2.session.synthetic), and the generated Promise type in /home/byk/Code/opencode-v2-pilot/packages/client/src/promise/generated/types.ts:718.
• 🟡 (02:34) Review investigation found Promise-client coverage for client.session.synthetic(...) in /home/byk/Code/opencode-v2-pilot/packages/client/test/promise.test.ts:865, plus extensive core coverage in /home/byk/Code/opencode-v2-pilot/packages/core/test/session-prompt.test.ts, /home/byk/Code/opencode-v2-pilot/packages/core/test/session-owned.test.ts, /home/byk/Code/opencode-v2-pilot/packages/core/test/session-runner.test.ts, /home/byk/Code/opencode-v2-pilot/packages/core/test/session-move.test.ts, and /home/byk/Code/opencode-v2-pilot/packages/core/test/session-execution.test.ts.