Distillation

Date: Sep 16, 2026

• 🔴 (15:14) User directive: tests must use a temporary SQLite database via packages/core/test/setup.ts; never use the production database at ~/.local/share/lore/lore.db.
• 🔴 (15:14) User directive: never manually bump package versions or edit CHANGELOG.md; Sentry Craft handles both automatically through GitHub Actions.
• 🔴 (15:14) User’s release workflow uses gh workflow run release.yml -f version=auto for conventional-commit-derived semver, or gh workflow run release.yml -f version=0.23.0 for an explicit version.
• 🟡 (15:14) Release workflow sequence documented in AGENTS.md: 1. scripts/bump-version.sh updates all package.json versions; 2. changelog is generated from conventional commits; 3. a release/X.Y.Z branch is created and pushed; 4. CI tests and builds npm tarballs, standalone binaries, and delta patches; 5. Craft opens a “publish” issue and the Publish workflow runs once labeled accepted; 6. publishing uses npm OIDC trusted publishing and creates a GitHub Release with binaries and patches. .craft.yml defines targets for 4 npm workspaces, the legacy opencode-lore alias, and the GitHub Release binaries.
• 🟡 (15:14) normalizeCodexResponsesEvent() in packages/gateway/src/stream/openai-responses.ts:1751-1789 validates and mutates an independent ResponsesAccState; callers that also accumulate events must use a separate state because Codex normalization binds omitted indices and may seed done-only items. It defaults maxSparseIndex to DEFAULT_MAX_SSE_FRAMES, rejects repeated function-call argument events after done, calls applyResponsesEvent(), tracks text/refusal/argument completion, binds effective tool identity for added tool_use items, and clears active/unbound item tracking when an output item is done.
• 🟡 (15:14) validateCodexResponsesEvent() in packages/gateway/src/stream/openai-responses.ts:1626-1743 rejects mismatched parsed.type; unsafe, negative, or out-of-bound output_index/content_index; negative or unsafe sequence_number; non-string item_id; malformed response lifecycle payloads; response id/model mismatches; invalid response.created statuses other than in_progress or queued; and response.in_progress statuses other than in_progress.
• 🟡 (15:14) Existing regression coverage in packages/gateway/test/openai-responses-recall-aware-stream.test.ts:1187 includes the test named retains a sparse principal Codex function call resolved by the limit-crossing done event.