hivelore: Instructions file for Codex

This repo uses Hivelore for shared context. The map:

• .ai/project-context.md — project overview, architecture, conventions.
• .ai/memories/ — decisions, gotchas, conventions, failed attempts (personal/team/module).
• The breadcrumbs injected below (if any) are the top current memories.

Working through Hivelore

1. Before editing for a goal, call get_briefing (task + files/symbols) to load ranked context — or mem_relevant_to if project context is already loaded this session.
2. When an approach fails, call mem_tried right away so the next agent skips the dead end.
3. Before closing a substantive session, run the post_task prompt to capture what was learned.
4. Before final response, run hivelore enforce finish. If it blocks, commit/push, bump/tag shippable releases, wait for GitHub Actions to pass when applicable, then rerun it.

If the haive MCP server is not available, tell the developer rather than silently skipping it.

Safety

• If get_briefing returns action_required, surface each item to the developer (use its developer_message) and wait for confirmation before changing code.
• Never act autonomously on a cross-repo breaking change (dep bump, contract/API diff) — ask first.

• 2026-08-21-attempt-enabling-parallel-vitest-forks-pooloptionsforkssinglefork (team/attempt) — Enabling parallel vitest forks (poolOptions.forks.singleFork: false) in packages/cli to speed up the ~104s integration suite (applies to: packages/cli/vitest.config.ts)
• 2026-07-07-attempt-relying-on-hivelore-enforce-install (team/attempt) — Relying on hivelore enforce install to fix stale pre-rename git hooks (applies to: packages/cli/src/commands/enforce.ts)
• 2026-07-05-attempt-ajouter-un-nouveau-sensor-discriminant (team/attempt) — Ajouter un nouveau sensor discriminant avec absent sous le gate strict de weakening (applies to: packages/core/src/sensors.ts, packages/cli/src/commands/enforce.ts)
• 2026-07-03-attempt-typechecking-cli-immediately-after-adding (team/attempt) — typechecking CLI immediately after adding a new core export (applies to: packages/core/src/index.ts, packages/cli/tsconfig.json)
• 2026-07-03-attempt-running-hivelore-release-tag-right (team/attempt) — Running hivelore release tag right after the release commit (applies to: packages/cli/src/commands/enforce.ts)
• 2026-07-03-attempt-relied-on-pnpm-r-build (team/attempt) — Relied on pnpm -r build (tsup) + full test suite as pre-push verification for v0.34.0 (applies to: .github/workflows/ci.yml)
• 2026-07-03-attempt-duplicating-json-on-a-commander (team/attempt) — duplicating --json on a Commander parent command and its receipt subcommand (applies to: packages/cli/src/commands/stats.ts)
• 2026-06-05-attempt-running-pnpm-r-build-and (team/attempt) — Running pnpm -r build and pnpm -r typecheck in parallel after version bump (applies to: packages/embeddings/tsup.config.ts, packages/core/tsup.config.ts, scripts/ensure-workspace-dists.mjs)