Distillation

Date: Sep 16, 2026

• 🔴 (15:57) User specified the invariant/test case: “never forwards response-side item_reference lifecycle events”.
• 🔴 (15:57) User specified the invariant/test case: “never executes recall from an incomplete principal”.
• 🟡 (15:57) vitest.config.ts lines 10–15 define top-level resolve.alias: "@loreai/core" → path.resolve(__dirname, "packages/core/src") and "@loreai/gateway" → path.resolve(__dirname, "packages/gateway/src"). Root cause documented in lines 5–9: placing aliases under test.resolve.alias does not work because Vite’s resolver is top-level; the previous placement silently resolved to the stale dist build and masked real test failures.
• 🟡 (15:57) vitest.config.ts test inclusion order is: 1. packages/core/test/**/*.test.ts, 2. packages/core/eval/**/*.test.ts, 3. packages/gateway/test/**/*.test.ts, 4. packages/opencode/test/**/*.test.ts, 5. packages/pi/test/**/*.test.ts. Fast, pure eval-suite unit tests run from packages/core/eval/**/*.test.ts; heavy end-to-end *.eval.ts tests run under vitest.evals.config.ts.
• 🟡 (15:57) vitest.config.ts uses setupFiles: ["./packages/core/test/setup.ts"] for DB isolation, environment: "node", pool: "forks", testTimeout: 300_000 (5 minutes per test), and hookTimeout: 300_000.
• 🟡 (15:57) vitest.config.ts test-isolation environment variables are NODE_ENV: "test", SENTRY_ENABLED: "0", and LORE_DEBUG: "0".
• 🟡 (15:57) vitest.config.ts coverage uses provider "v8" and reporters ["text", "json", "html", "lcov"]; lcov supports Codecov CI upload, while text/json/html are retained for local inspection.
• 🟡 (15:57) vitest.config.ts coverage exclusions are: **/*.test.ts, **/test/setup.ts, **/test/helpers/**, **/script/**, **/dist/**, packages/website/**, packages/pi/**, **/eval/**, **/*.eval.ts, *.config.ts, and scripts/**. The documented rationale for excluding non-tested/non-source packages is that only core, gateway, and opencode have tests, so website and pi should not reduce or pollute patch coverage.