# Log

Append-only operations log for this pi-brain instance.
- 2026-07-27: Drafted PRD — Embed pi-brain as default pi behaviour (wiki/brain/prds/embed-pi-brain-default-behaviour.md)
- 2026-07-27: Accepted ADR — Embed pi-brain as default pi behaviour (wiki/brain/adrs/embed-pi-brain-default-behaviour.md)
- 2026-07-27: Accepted bet — Embed pi-brain as default pi behaviour (wiki/brain/bets/embed-pi-brain-default-behaviour.md)
- 2026-07-27: Implemented all phases of "Embed pi-brain as default pi behaviour" — package-resolved resources, global install tiers, ungated weave, compaction harvest, loop-participation prototypes, docs, tests, and v0.3.0 structural split.
- 2026-07-27: Accepted ADR and implemented tool-wrapper policy — pi-brain overrides of basic pi tools must wrap, not replace, the base tool (wiki/brain/adrs/adr-pi-tool-wrapper-override.md, extensions/pi-brain/tool-wrapper.ts).
- 2026-07-27: Groomed inbox — removed 52 resolved/duplicate/noise items, kept auto-ingest batch for tending. Archived delivered bet to wiki/brain/_archive/bets/embed-pi-brain-default-behaviour.md (superseded by record).
- 2026-07-27: Fixed runtime error in extensions/pi-brain/hooks.ts: added missing imports countInboxItems (./utils.ts) and getPackageRoot (./resources.ts). Extension now loads and briefing fires.
- 2026-07-27: Decision recorded — aborted pi-brain → pi-mind rebrand; keep pi-brain name and use scoped npm package @misabegovic/pi-brain.
- 2026-07-27: Tended inbox — auto-ingest batch for sources/doc/2026-07-27--pi-brain-embed-plan-md.md was already synthesized into the Embed pi-brain default behaviour record; batch cleared and inbox emptied.
- 2026-07-27: Accepted ADR and implemented live status widget refresh — brain status widget re-renders after state-changing brain tools or direct edits to inbox/auto-ingest state files (wiki/brain/adrs/adr-live-status-widget-refresh.md, wiki/brain/records/live-status-widget-refresh.md, extensions/pi-brain/hooks.ts).
- 2026-07-27: Released pi-brain v0.3.0 — git tag, GitHub release, and npm package `@misabegovic/pi-brain@0.3.0` published. Record: wiki/brain/records/version-0-3-0.md.
- 2026-07-27: Shaped extension cleanup — PRD, ADR, and bet for removing duplicate prompt/theme registration and dead code (wiki/brain/prds/extension-cleanup-resource-conflicts.md, wiki/brain/adrs/extension-cleanup-resource-conflicts.md, wiki/brain/bets/extension-cleanup-resource-conflicts.md).
- 2026-07-27: Implemented extension cleanup — removed duplicate prompt/theme paths from resources_discover, relocated template-update helpers to extensions/pi-brain/template-update.ts, removed dead imports/variables, fixed brain_update and /brain:dump-prompt runtime references, and recorded delivery in wiki/brain/records/extension-cleanup-resource-conflicts.md.
- 2026-07-27: Added workflow constraints — even with LOCAL_FIRST=true, remote promotion must go through a pull request unless branch protection prevents it or the user explicitly overrides in the same turn; and no local commit/push/merge may happen without explicit user approval (wiki/brain/constraints/remote-promotion-requires-pr.md, wiki/brain/constraints/explicit-approval-for-commits.md).
- 2026-07-27: capture: User clarified workflow rule: even with LOCAL_FIRST=true, promoting local commits to remote must go through a pull request unless branch protection prevents it or the user explicitly overrides.
- 2026-07-27: Prepared pi-brain v0.3.1 release — bumped `package.json` to `0.3.1`, updated `template_version` defaults, added release record `wiki/brain/records/version-0-3-1.md`.
- 2026-07-27: Shaped PRD — Tap pi's full extension surface for pi-brain (wiki/brain/prds/tap-pi-extension-surface.md), covering compaction harvest, context injection, tool-result enrichment, entry renderers, shortcuts/flags, event bus, and session shutdown.
- 2026-07-27: Gathered context for extension-surface PRD — ingested Pi extension, TUI, and keybinding docs; deep-dived existing `extensions/pi-brain/hooks.ts` to confirm compaction harvest, context injection, and tool-result refresh are already partially implemented; updated PRD confidence to medium.
- 2026-07-27: Accepted ADR — Tap pi's full extension surface for pi-brain (wiki/brain/adrs/tap-pi-extension-surface.md), choosing phased all-seven approach with feature flags.
- 2026-07-27: Accepted bet — Tap pi's full extension surface for pi-brain (wiki/brain/bets/tap-pi-extension-surface.md), committing to seven phased, flag-gated extension hooks.
- 2026-07-27: Implemented Phase 1 — hardened compaction harvest with scoring heuristic, review queue, config flags (`harvest_compaction_max_items`, `harvest_compaction_min_score`), and lightweight logging in `extensions/pi-brain/compaction-harvest.ts`.
- 2026-07-27: Implemented Phases 2-7 of extension-surface bet — context injection (`extensions/pi-brain/context-injection.ts`), tool-result enrichment (`extensions/pi-brain/tool-result-enrichment.ts`), entry renderers (`extensions/pi-brain/entry-renderers.ts`), shortcuts/flags (`extensions/pi-brain/shortcuts.ts`), event bus (`extensions/pi-brain/events.ts`), and session shutdown cleanup (`extensions/pi-brain/session-shutdown.ts`). All gated by `brain.config.yml` flags.
- 2026-07-27: Tended inbox — synthesized auto-ingest batch (web source + Pi TUI docs) into the extension-surface PRD/ADR/bet and Phase 1 implementation; cleared batch.
- 2026-07-27: Workflow lesson logged: `gh pr create --body "...\n..."` renders literal `\n` in GitHub; use `gh api` with JSON-encoded body for real line breaks.
- 2026-07-27: Accepted ADR — Local-first brain self-maintenance workflow (wiki/brain/adrs/local-first-brain-self-maintenance.md) and updated the `explicit-approval-for-commits` constraint to exempt brain self-maintenance when LOCAL_FIRST=true.
- 2026-07-27: Merged PR #8 — Tap pi's full extension surface for pi-brain; created record wiki/brain/records/tap-pi-extension-surface.md.
- 2026-07-27: Prepared pi-brain v0.3.2 release — bumped `package.json` to `0.3.2`, updated `template_version` defaults, added release record `wiki/brain/records/version-0-3-2.md`.
- 2026-07-27: Released pi-brain v0.3.2 — git tag, GitHub release, and npm package `@misabegovic/pi-brain@0.3.2` published. Record: wiki/brain/records/version-0-3-2.md.
- 2026-07-28: capture: User asserts pi-brain's north star should be spec-driven/intent-driven development with code regenerable from specs, cit
- 2026-07-28: capture: Epic expansion: regenerative-intent now also includes (a) agents maintaining/updating intent in collaboration with human
- 2026-07-29: Merged PR #12 — regenerative-intent epic: all nine bets (autonomous refinement protocol, multi-agent collaboration, structured intent/build, diff/drift detection, agent-maintained intent, autonomous colleague mode, background tasks, sync-code reconciliation, multi-agent RFC collaboration). Records created for all nine bets.
- 2026-07-29: Merged PR #13 — refinement follow-up: fixed link graph (0 dead links, 0 orphans), corrected generated page links in index/org pages, added TypeScript dev tooling (tsc --noEmit, tests), fetched aicoding.leaflet.pub source, archived resolved inbox items, deleted demo artifacts, created archived demo RFC.
- 2026-07-29: Merged PR #14 — autonomous refinement protocol output: 4 suggestions (epic acceptance, command docs, CI, RFC fate).
- 2026-07-29: Merged PR #15 — autonomous refinement protocol output: 4 suggestions (README, log, .env.example, setup skill).
- 2026-07-29: Merged PR #16 — autonomous refinement protocol output: 4 suggestions (queue grooming, org state narrative, constraints review, setup skill).
- 2026-07-29: Merged PR #17 — autonomous refinement protocol output: 4 meta-suggestions about queue grooming.
- 2026-07-29: Merged PR #18 — autonomous refinement protocol output: 3 meta-suggestions about queue grooming.
- 2026-07-29: capture: Decision: No further releases beyond v0.3.3. Any additional work the agent suggests and the user approves will land in t
- 2026-08-01: capture: Shape an ADR for enola-guided skills: integrate optional enola intelligence into brain-shape, brain-investigate, brain-r
- 2026-08-03: capture: v0.4.0 release prepared and tagged; GitHub release created. npm publish requires OTP — waiting for user to provide one-t