| Category | Title |
|---|
| architecture |
Standard.site publication email service |
| decision |
Loops campaigns require manual Publish |
| gotcha |
Loops emailMessageContentRevisionId 409 guard |
| preference |
Absolute language for system behavior |
| gotcha |
GitHub stale CHANGES_REQUESTED: only new review or dismissa… |
| gotcha |
git stash pop without ref grabs another branch's stash |
| gotcha |
craft dependency-review: @vercel/client exact pins need pnp… |
| gotcha |
Dependabot alerts stay open right after merge — re-scan aut… |
| gotcha |
streamDecompressToFile fd lifecycle |
| gotcha |
API shared HTTP success predicate |
| gotcha |
formatApiResponseJson --fields envelope filtering |
| gotcha |
Cozette v1.30 MIT attribution |
| architecture |
normalizeIpaWithDsyms in-memory XCArchive |
| pattern |
ZIP head prev 32768 alignment |
| preference |
Enforce preview deployment lifecycle, fork safety, and clea… |
| decision |
CalVer publish issues suppress @mentions |
| preference |
Always targets the production environment for Cloudflare de… |
| preference |
Throw on unexpected values |
| preference |
Temporal observation timestamp placement |
| gotcha |
publish.yml canonical cwd state hash |
| decision |
Craft publish state never reads repo-local files |
| preference |
OpenCode running service isolation |
| architecture |
images.ts bounded image parser |
| gotcha |
WorkspaceSchema __proto__ Zod record loss |
| gotcha |
getsentry/craft:latest Publish image contract |
| gotcha |
accepted cleanup removeLabel recovery |
| gotcha |
Publish CI label gate avoids stale CI and auto-approve races |
| gotcha |
Craft workspace selection must be parsed before yargs build… |
| gotcha |
getWorkspaceGlobMatches brace expansion |
| preference |
Always enforce strict fail-closed publish-issue parsing |
| preference |
Schema Core Protocol layering |
| architecture |
ToolFailure leaf boundary |
| preference |
Parallel tool execution |
| preference |
agent-browser automation workflow |
| architecture |
Shell.Info opaque metadata |
| preference |
Return error expressions |
| preference |
Permission.Source tool context |
| gotcha |
PTY aggregate retention bounds |
| preference |
Effect testEffect and it.live |
| preference |
getsentry/publish CommonJS Vitest conventions |
| gotcha |
PTY deletion subscription |
| gotcha |
Promise permission failure tunnel |
| preference |
CI poller resolver edit gate |
| gotcha |
serveSession outputDone deadlock |
| gotcha |
copyInput hides disconnects |
| gotcha |
StopAndWait defer errors |
| architecture |
PTY supervisor MainPID authentication |
| gotcha |
StopAndWait closed signal loop |
| gotcha |
PTY per-unit resource limits |
| gotcha |
PTY plugin protocol limits |
| gotcha |
Go helper opens THP sysfs |
| architecture |
SessionExecution late placement |
| preference |
Step versus turn terminology |
| gotcha |
Go buildid reproducibility flag |
| gotcha |
systemd Unit/Service property split |
| gotcha |
openSupervisorTransport pendingOutput |
| gotcha |
connectedSocketFD _handle.fd |
| gotcha |
MainPID user-writable restart |
| architecture |
PTY systemd supervisor |
| preference |
Always analyze and understand configuration and testing pat… |
| preference |
Always follow documented plans and processes |
| gotcha |
discoverLocation root bypasses workspace discovery |
| preference |
Require rigorous read-only, evidence-based final reviews an… |
| gotcha |
PTY workdir approval TOCTOU |
| decision |
V2 script-backed PTY plugin |
| preference |
Fail-closed PTY supervisor changes and production cutover |
| architecture |
toolkit pre-rename subtree merge |
| gotcha |
GitHub issue body history |
| architecture |
OpenCode webfetch implementations, limits, and HTTP failures |
| preference |
Numeric exit codes via errors |
| preference |
buildRouteMap wrapper |
| preference |
Backend maintainer review noise |
| preference |
command Markdown formatter pipeline |
| gotcha |
endpoint project filter contracts |
| preference |
packages/cli JSDoc field contracts |
| gotcha |
ApiError status preservation |
| pattern |
@sentry/symbolic release verification |
| gotcha |
Governance artifact retention |
| gotcha |
control_event versus institutional change |
| preference |
Always enforce fail-closed verification of frozen provenance |
| gotcha |
V2 parent-session header |
| preference |
Lore hidden worker agents |
| architecture |
Native provider facade files |
| architecture |
Provider tools transport policy |
| gotcha |
Configured plugin watch lifetime |
| gotcha |
governance CLI output TOCTOU |
| gotcha |
CLI summary pair publication |
| gotcha |
MAX_ARCHIVE_MEMBERS boundary |
| gotcha |
coding_package summary null crash |
| pattern |
#1246 Toolkit staged cutover |
| gotcha |
streamDecompressToFile ETXTBSY |
| gotcha |
CLI pin-first immutable snapshots |
| preference |
Nightly channel and upgrade-source invariants |
| gotcha |
delta-upgrade CLI_VERSION mocks |
| preference |
Prefers graceful fallback over crashes |
| architecture |
OpenCode session timeline, loading, and reconnect behavior |
| architecture |
Nuum incremental distillation and evaluation lessons |
| pattern |
OpenCode worktree model, safe operations, UI state, and pro… |
| preference |
upgrade --offline curl-only contract |
| gotcha |
install cli@ prerelease flags |
| preference |
Perform adversarial, source-grounded validator audits |
| preference |
Frozen governance adjudication workflow |
| gotcha |
pr-risk apply-label fork 403 |
| architecture |
Worker retry, urgent background, and reset-drain policy |
| preference |
parseSlashSeparatedArg convention |
| architecture |
SQLite dual-driver architecture and WASM packaging |
| gotcha |
CommandDocumentation wrapper types |
| architecture |
artifact-9642983578.zip provenance anchor |
| preference |
Toolkit migration invariants |
| architecture |
@loreai/opencode server bundle |
| preference |
Lore V2 smoke isolation |
| preference |
Model-property-unit test hierarchy |
| architecture |
rawApiRequest statusText preservation |
| gotcha |
event/view parser order |
| preference |
Repository formatter authority |
| preference |
Enforce release workflow security invariants fail-closed |
| preference |
GitHub base-repository artifacts |
| gotcha |
GHCR 307 strips Authorization |
| gotcha |
UpgradeTransportError cache fallback |
| gotcha |
GitHub release Link reconstruction |
| architecture |
NormalizedGitHubReleases source brand |
| decision |
Source-neutral patch-cache keys |
| preference |
Async promise consumption |
| preference |
Failure-layer isolation |
| gotcha |
UPGRADE_SOURCES strict source affinity |
| gotcha |
Windows package-manager .cmd spawning |
| preference |
Stricli flag requiredness |
| decision |
reportCliError captures API 400 |
| gotcha |
listTags repeated GHCR cursor |
| gotcha |
GHCR OCI runtime validation |
| gotcha |
zlib.zstdCompress module guard |
| gotcha |
publish terminal reporting |
| gotcha |
Verify publish issue reconciliation |
| gotcha |
validatePinnedGitHubRelease canonical SemVer |
| gotcha |
versionExists npm terminal failures |
| gotcha |
Scan and grep concurrency, matching, and SEA worker contrac… |
| architecture |
symbolic-wasm ownership, DIF contracts, build, and publicat… |
| preference |
PR exact-head merge gate |
| gotcha |
Vitest TEST_TMP_DIR and SENTRY_CONFIG_DIR isolation |
| preference |
Create-command DRY_RUN_FLAG imports |
| preference |
buildListCommand injected flags |
| architecture |
prepareHeaders preserves SDK headers |
| gotcha |
currentLabeledEvent latest transition |
| architecture |
Authenticated fetch, redirects, retries, and response cachi… |
| architecture |
Delta upgrades, patching, tag selection, and channel constr… |
| architecture |
OpenCode contribution and vertical-tabs PR workflow |
| preference |
Lore nightly channel |
| gotcha |
Responses streaming JSON.parse parity |
| preference |
Gateway request decoding, failure sanitization, and cleanup |
| decision |
finalRecallRound native disabling |
| gotcha |
malformed_chain poison: transient HTTP failures must not cl… |
| preference |
restored messages never re-distill |
| architecture |
Responses private-to-public output_index projection |
| preference |
SessionPrompt restart prohibition |
| preference |
Never restart OpenCode services |
| architecture |
SystemContext ownership composition |
| preference |
Protected paths unwatched |
| architecture |
V2 package dependency direction |
| architecture |
Legacy V1 execution durability |
| preference |
SessionRetry 5xx policy |
| decision |
applyResponsesEvent final text authority |
| architecture |
Responses continuation lifecycle suppression |
| preference |
Cache warmups never create sessions |
| architecture |
SQLite initialization and connection-local sync capture |
| architecture |
Gateway request classification, compaction, and route order… |
| gotcha |
Sparse Codex provider failures |
| architecture |
scheduleStreamingPostResponse EOF ordering |
| gotcha |
/lore:curate JSONL parsing |
| gotcha |
completed() terminal output snapshot |
| architecture |
GatewayResponse usage optionality |
| gotcha |
sanitizeResponsesProviderFailureTerminal ordering |
| preference |
Always verify gateway changes with exhaustive, protocol-spe… |
| gotcha |
normalizeCodexResponsesEvent state |
| preference |
Effect background layer loops |
| preference |
Fail-safe, private telemetry and best-effort maintenance |
| decision |
Inter-turn gap tool continuations |
| preference |
Lore benchmark claim scope |
| architecture |
system[1] delta channel |
| architecture |
scope=all cross_project fusion |
| architecture |
Knowledge contradiction confidence |
| architecture |
Mastra timestamped observation logs |
| preference |
Adversarial lifecycle setup |
| gotcha |
Gateway request-stream sequencing, error delivery, and boun… |
| architecture |
Vector worker isolation, fallback, and graceful shutdown |
| gotcha |
SSEStreamLimitError classification |
| pattern |
OpenCode configuration, commands, skills, plugins, and mode… |
| gotcha |
AGENTS.md/.lore.md tracked status differs per branch, block… |
| gotcha |
Session recovery claim semantics |
| preference |
Restart resumes background agents |
| preference |
Confident autonomous continuation |
| architecture |
Responses ingress streaming and bounded parsing boundary |
| architecture |
OpenCode global events, durable settlement, and subscriber … |
| gotcha |
Token-budget and long-context accounting |
| architecture |
Lore closed-loop memory pipeline |
| architecture |
Embedding runtime safety, validation, compatibility, and ba… |
| preference |
OpenCode heap-snapshot isolation |
| architecture |
Sentry telemetry, tracing, and test-isolation invariants |
| architecture |
Gateway authentication, credentials, and fetch-interceptor … |
| pattern |
Promise plugin registration and follow-up scheduler |
| preference |
Production i18n, pluralization, and translation policy |
| architecture |
Prompt-delta, provenance, and structured recall replay inva… |
| architecture |
Conversation cache layout, anchoring, TTL, and LTM pin inva… |
| architecture |
node-sqlite3-wasm compatibility fallback |
| architecture |
Provider and client gateway translation invariants |
| gotcha |
Test database isolation and independently addressable knowl… |
| architecture |
Temporal embedding storage, startup, and scoped retrieval i… |
| gotcha |
opencode.service diagnostic cgroup contamination |
| preference |
LTM prompt-cache, pin, and meta-distillation stability |
| gotcha |
SessionContextEpoch.advance fencing |
| architecture |
Database schema, vec0, tracing, and conflict invariants |
| gotcha |
Persistent PTY listener, ownership, and exit-delivery invar… |
| gotcha |
Step.Recovered identity validation |
| preference |
SessionExecution fencing tests |
| preference |
OpenCode skill, configuration, project-state, SSE, and V8 d… |
| gotcha |
vitest.config.ts alias scope |
| preference |
Exact-candidate validation, adversarial review, and merge w… |
| preference |
Evidence-first investigation, implementation, and review |
| architecture |
Recall follow-up stream parity |
| gotcha |
Responses final text replacement |
| preference |
Recall continuation usability gate |
| architecture |
Recall persistence EOF gate |
| gotcha |
postResponseForTenant warmer endpoint trust |
| gotcha |
SessionRecovery reserved continuation |
| architecture |
Recall continuation replay and persistence transactions |
| architecture |
SessionV2 durable execution and monotonic state |
| architecture |
Temporal message identity, artifact exclusion, and user-pro… |
| gotcha |
session-recovery squashed migration |
| preference |
packages/opencode module shape |
| preference |
EffectBridge callback re-entry |
| gotcha |
Step.Ended v2 assertions |
| gotcha |
SessionExecution cancellation renewal loss |
| architecture |
SessionExecution vs Location scope |
| preference |
Effect-smol source and workflows |
| preference |
makeRuntime InstanceState ownership |
| preference |
Schema current V1 contracts |
| pattern |
opencode bun dev tmux |
| architecture |
OpenCode runtime, packaging, SQLite, and fetch boundaries |
| architecture |
Remote session and client-controlled project identity autho… |
| gotcha |
Responses failed projections and usage accounting |
| gotcha |
PLACEHOLDER_DEBUG_ID replacement |
| gotcha |
validNativeBinding ABI validation |
| preference |
Private recall state and complete Responses accumulation |
| gotcha |
Durable session execution, ownership, and recovery invarian… |
| architecture |
normalEmbed removable FIFO |
| gotcha |
Embedding execution, transaction, and privacy invariants |
| preference |
Embedding pool memory admission and OOM recovery |
| preference |
Evaluation launch, judging, and failure handling |
| preference |
Evidence-driven repository, testing, and review workflow |
| preference |
Always enforce session execution lease invariants with regr… |
| preference |
Production artifact and isolated recovery smoke validation |
| preference |
Correctness and security review passes |
| gotcha |
SessionRecovery redrive starvation |
| gotcha |
SessionInput admission, retry, and wake intent |
| gotcha |
SessionExecution activeClaims boundary races |
| architecture |
LocalProvider embedding capacity, batching, admission, and … |
| decision |
Startup synthetic continue recovery |
| preference |
SessionExecution lease fencing |