Distillation

Date: Sep 8, 2026

• 🔴 [enforced-workflow] (03:35) User required running bun typecheck from package directories such as packages/core, never invoking tsc directly.
• 🔴 (03:35) User stated repository runtime dependency direction: Schema → Core and Protocol; Core and Protocol → Server. Client runtime code may depend on Schema and Protocol but never Core or Server; sdk composes Client, Core, and Server.
• 🔴 (03:35) User prohibited aliased imports, including import { foo as bar } from "..." and renamed imports such as resolve as pathResolve.
• 🔴 (03:35) User prohibited type-position import("...") references such as Schema.declare<import("@opencode/plugin/effect/plugin").Plugin["effect"]>. If two imports genuinely collide and no alternative exists, an aliased type import such as import type { Plugin as PluginDefinition } from "..." is permitted only as a last resort and remains strongly discouraged.
• 🔴 (03:35) User prohibited star imports, including import * as Foo from "..." and import type * as Foo from "...".
• 🔴 (03:35) User stated that namespace-style values should use the module’s named exported namespace, for example import { Project } from "@opencode/core/project" followed by Project.ID.
• 🔴 (03:35) User prefers dynamic imports for heavy modules needed only on selected code paths, especially startup-sensitive entrypoints; bindings should be destructured near the top of the narrowest applicable scope, branch-specific imports should remain inside their branch, and inline chains such as await import("./module").then((mod) => mod.value()) or (await import("./module")).value() should be avoided.
• 🟡 (03:35) Canonical PermissionAssertInput in /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/permission.ts contains required fields sessionID: Session.ID, action: string, and resources: ReadonlyArray<string>, plus optional save?: ReadonlyArray<string>, metadata?: Record<string, unknown>, source?: Permission.Source, and agent?: Agent.ID.
• 🟡 (03:35) PermissionDomain in /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/permission.ts is Pick<PermissionApi, "list" | "get" | "reply"> plus assert(input: PermissionAssertInput): Promise<void> and hook: Hooks<PermissionHooks>.
• 🔴 [enforced-workflow] (03:35) User stated that after changing the public Protocol or Server HttpApi, bun run generate must be run from packages/client; generated client files must not be edited directly.
• 🔴 (03:35) User stated this repository does not use Changesets and .changeset files must not be added.
• 🔴 (03:35) User stated the repository’s default branch is v2; new branches and worktrees should default to v2, or origin/v2 when the local v2 ref is unavailable, and pull requests should target v2 unless explicitly instructed otherwise. Diffs should use v2 or origin/v2 because a local main ref may not exist.