# Changelog All notable changes to this project are documented in this file. ## [v0.26.0] β€” 2026-06-07 ### ✨ Features - Git workflow automation and steer/review hardening: auto feature branches from protected refs, scoped commits with `--only-path`, headless QA git finalize with `git-workflow.yaml`, hygiene fast-path steer, lite review preflight, inline repair, and ADR 0057 fast steer completion. ## [v0.25.0] β€” 2026-06-07 ### ✨ Features - Wire agent-native speed program: `parallel_probes` end-to-end, eligibility snapshot, plan FSM (`harness_plan_next_action`), synthesizer routing, auto-approve policy, per-phase spawn caps, review parallel default, 50% VCC auto-compact, ADR 0056. ### πŸ› Fixes - Headless QA E2E: seed planning-context for smoke auto-approve, finalize plan on `agent_end`, write smoke ISO for `/harness-auto`, and exit via `ctx.abort()` without kill-switch false failures. ## [v0.24.0] β€” 2026-06-06 ### ✨ Features - Cut harness workflow latency with phase-aware subagent timeouts, debate wall-clock caps, ccc index debounce, optional parallel review spawns, progress UI with stall detection, and PostHog phase telemetry. ## [v0.23.0] β€” 2026-05-28 ### ✨ Features - strengthen run context human gates ## [v0.22.2] β€” 2026-05-28 ### πŸ› Fixes - Harden harness plan/run/review/auto pipeline routing: reconcile run context from disk and handoffs, sync review-outcome from eval, fix harness-auto fresh runs (plan path, abort lock, kill-switch disarm), add harness-clear and expanded tests. ## [v0.22.1] β€” 2026-05-27 ### πŸ”§ Chores - update package metadata and sync harness assets ## [v0.22.0] β€” 2026-05-27 ### ✨ Features - OSS Sentrux structured repair without Pro or MCP ### πŸ“– Documentation - split repo docs by audience ### πŸ”§ Chores - apply pending harness and ask-user updates - remove obsolete PostHog plan latency dashboard doc ## [Unreleased] ### ✨ Features - **Harness lens:** Integrate selected pi-lens capabilities through a harness-owned extension, store lens state under `.pi/harness/.lens`, and route lens findings through harness PostHog telemetry instead of standalone lens health/telemetry surfaces. - **Graphify KB updater:** Productize conservative daily discovery/promotion with explicit repo/release taxonomy, allowlist source-class gates, operator review queue reporting, scheduler smoke validation, and safe Graphify refresh controls. ## [v0.21.0] β€” 2026-05-26 ### ✨ Features - **Harness:** Add ls-lint filename fitness (manifest, sync, steward agent, harness-verify) and plan-phase task clarification gate before execution. ### πŸ”§ Chores - Add `agents-policy.d.mts` and hash-anchored edit typecheck fixes so `npm run check:ts` passes on main. ## [v0.20.0] β€” 2026-05-26 ### ✨ Features - **Harness:** Add hash-anchored executor edit flow. ## [v0.19.1] β€” 2026-05-26 ### πŸ”§ Chores - Prepare web retrieval and harness updates for release. ## [v0.19.0] β€” 2026-05-24 ### ✨ Features - **Harness:** `agents.policy.yaml` as per-agent tool SSOT with manifest alignment; subprocess `subagent-governance` bundle and AGT `tool_allowed` enforcement. - **Harness:** Consolidate shared modules under `.pi/lib/` (moved from `.pi/extensions/lib/`); update imports, packaging, verify, and tests. - **Harness:** AGT-backed policy gate with subprocess governance bundle (extends v0.18.x AGT work). ### πŸ”§ Chores - Apply Biome organize-imports and format fixes across moved harness library files. - Commit pending harness architecture and context tooling updates. ## [v0.18.1] β€” 2026-05-24 ### πŸ”§ Chores - Ignore local project runtime config. - Fix harness review revise flow and widget UX. - Add harness project toggle controls. ## [v0.18.0] β€” 2026-05-23 ### ✨ Features - **Harness:** Agent-native plan/review workflows (ADR 0042–0044) β€” path-first `approve_plan` / `create_plan` / `submit_*`, lakes on execution plans, `parallel_probes` debate, `review-outcome.yaml` routing, `/harness-steer` repair loop, `merge_harness_yaml`, and `harness_synthesize_repair_brief`. - **Harness:** Practice map, planning-context and plan-synthesizer agents, PostHog bootstrap, graphify KB updater corpus, and Sentrux steward prompt. ### βœ… Tests - Add harness tool-payload, post-run routing, subprocess bootstrap, artifact gate, and topology tests; extend smoke plan fixture for parallel probes. ## [v0.17.0] β€” 2026-05-22 ### ✨ Features - **Model router:** Session-locked model SKU at start (initial prompt + system prompt); per-turn routing adjusts thinking tier only; subagents lock from agent `systemPrompt` complexity. - **Harness:** Thinking-only profile shape in generator/verify; plan review gate, debate eligibility, and smoke fixture updates. ### βœ… Tests - Add `harness-model-router-routing` and plan-debate eligibility coverage. ## [v0.16.0] β€” 2026-05-19 ### ✨ Features - add submit pipeline and planning/debate updates ### πŸ”§ Chores - refresh graph artifacts after harness updates ## [v0.15.0] β€” 2026-05-19 ### ✨ Features - **Live widget:** Single-row footer with current/next pipeline phase and plain-language status hints; removes inFlight, policy jargon, and flag rows. - **Plan phase:** Implementation researcher, selective debate lanes/eligibility, planning rubrics, ADR 0036, and smoke fixture updates. ### βœ… Tests - Add `harness-live-widget-status` and `plan-debate-eligibility` tests. ## [v0.14.0] β€” 2026-05-18 ### ✨ Features - **Plan debate (pi-messenger):** `harness_debate_open`, `harness_messenger_post`, lane auto-apply after subagent returns, consensus gates on `approve_plan`, and blocks on parent `review-round-r*.yaml` writes. - **Spawn budget:** remove harness subagent spawn cap (spawns always allowed). - **Skills:** symlink `.pi/skills/*` to `.agents/skills` (harness, ccc, scrapling-web, wiki-save). ### πŸ”§ Chores - Refresh planning agent prompts and `agents.manifest.json`; biome unused-import cleanup. ## [v0.13.1] β€” 2026-05-18 ### πŸ”§ Chores - Consolidate vendored `ccc` skill under `.agents/skills/ccc`; remove redundant `cocoindex-search`, `ck-search`, and duplicate Obsidian skills from the package. ## [v0.13.0] β€” 2026-05-18 ### ✨ Features - **CocoIndex Code:** replace `@beaconbay/ck-search` with offline `ccc` semantic search; `harness-cocoindex-bootstrap.sh`, pre-scout incremental index in `harness-subagents-bridge`, vendored `/skill:ccc`, `cocoindex-search` skill, and `ck-search` deprecation stub. ### πŸ”§ Chores - Harness excludes for `graphify-out/`, `vendor/`, `raw/`, etc. in `.cocoindex_code/settings.yml`; `.gitignore` tracks `.cocoindex_code/`. ## [v0.12.0] β€” 2026-05-18 ### ✨ Features - **Harness subagents:** vendor `pi-subagents`; spawn budget, precheck, and policy bridge. - **Router spawn auth:** forward concrete provider/model + API key to subprocesses using `--no-extensions` (fixes planning scout 401 with `router/auto`). - **Plan review gate:** debate orchestration, execution-plan schemas, `write_harness_yaml`, plan-phase smoke fixture (ADR 0035). ### πŸ”§ Chores - Stop tracking harness runtime and local graphify artifacts in git. ## [v0.11.0] β€” 2026-05-17 ### ✨ Features - **Harness Darwin plan pipeline:** decomposition and hypothesis agents with plan-adversary, scouts, and structured plan brief schemas (ADR 0034). - **Harness plan review:** `plan-review.md` for editor review; extension load guard. - **Cursor Pi experts:** cursor-pi domain expert agents. ### πŸ”„ CI/CD - **Biome:** ignore harness runtime JSON; format committed harness plan pipeline sources. ## [v0.10.1] β€” 2026-05-17 ### πŸ› Fixes - **Harness plan TUI:** agents widget stacks above harness-live; full-height bottom `approve_plan` overlay above the harness band; block duplicate parent `approve_plan` / plan `ask_user` after planner subagent approval. ## [v0.10.0] β€” 2026-05-17 ### ✨ Features - **Harness plan UX:** scrollable `approve_plan` overlay with `harness-plan-draft` parent transcript; planner-only `create_plan` persists canonical `plan-packet.json` after approval; blocks planner `write`/`edit` for plan files; syncs subagent approvals and dedupes duplicate plan-approval gates. ## [v0.9.1] β€” 2026-05-17 ### πŸ› Fixes - **npm package:** fix `harness-subagents` vendored import of `harness-run-context` (`../../../../lib`); broken installs failed with `Cannot find module '../../../lib/harness-run-context.js'`. ## [v0.9.0] β€” 2026-05-17 ### ✨ Features - **Harness plan UX:** Pi-native `harness-turn` routing on `input` (no expanded-prompt matching); subagent `ask_user` bridged to parent UI; plan-phase budget cap 80k with debounced exhaustion events; thin `harness-plan` orchestrator with `harness-plan-commit`; `harness-turn.schema.json` and tests. ## [v0.8.0] β€” 2026-05-17 ### ✨ Features - **Harness command orchestration:** slash prompts spawn `harness/*` agents with required `HarnessSpawnContext`; subagent tool policy; L4 review via isolated subagents (not session fork); ADR 0032. ### πŸ› Fixes - **Policy gate / harness-plan:** allow scoped writes to `plan-packet.json` in plan phase after `ask_user` approval; block project source edits until execute; promote `/harness-auto` to execute phase mid-turn after approved plan write. ### πŸ“– Documentation - **Harness plan workflow:** present full plan β†’ Approve via `ask_user` β†’ persist packet; `--quick` does not skip approval (ADR 0031). ### πŸ”§ Chores - **pi-coding-agent:** migrate peer/dev deps to `@earendil-works/pi-coding-agent` 0.74.1. ## [v0.7.0] β€” 2026-05-17 ### ✨ Features - **Harness run context:** track active run and canonical plan path in session; short slash commands without `--run` or `--plan`; project `active-run.json` for forked eval sessions; ADR 0031. - **System prompt extension:** load packaged `.pi/SYSTEM.md` by default with optional workspace `.pi/system.md` override. ### πŸ“– Documentation - **README and harness prompts:** manual workflow without run IDs; `harness-run-status`, `harness-new-run`, `harness-use-run` helpers. ### πŸ”§ Chores - **harness-setup:** remove Sentrux skill symlink step; rules bootstrap only. ## [v0.6.1] β€” 2026-05-17 ### πŸ› Fixes - **SearXNG bootstrap:** generate `SEARXNG_SECRET` and set `server.secret_key` so containers no longer crash on the default `ultrasecretkey` (SearXNG 2026.4+). - **Harness env template:** remove obsolete `PI_VCC_CONFIG_PATH`; add env-only VCC, PostHog MCP, Sentrux, and default `VAULT_WIKI_PATH` keys aligned with `/harness-setup`. ## [v0.6.0] β€” 2026-05-17 ### ✨ Features - **sentrux Pi skill:** CLI-first architectural quality workflows (`check`, `gate`, GUI) via `/skill:sentrux`; symlinked in `.pi/skills`. Pi does not load `.pi/mcp.json`. ### πŸ“– Documentation - **harness-setup / CONTRIBUTING:** document Sentrux skill instead of MCP config; update `harness-sentrux-setup` workflow. ### πŸ”§ Chores - Remove shipped `.pi/mcp.json` from package `files` list; refresh `graphify-out`. ## [v0.5.0] β€” 2026-05-17 ### ✨ Features - **web_search / web_fetch pi tools:** wrap `harness-web.py` with session injection and a bash guard so agents skip `UP_PKG` and scrapling import preflights. - **SearXNG search backend:** pluggable `HARNESS_WEB_SEARCH_ENGINE` (`ddg_html` | `searxng`) with Docker bootstrap via `harness-searxng-bootstrap.mjs`. - **harness-web status:** JSON config subcommand for setup and diagnostics. ### πŸ”§ Chores - Apply pre-commit format and refresh `graphify-out` after harness-web tools merge. ## [v0.4.1] β€” 2026-05-17 ### ✨ Features - **In-house VCC compaction:** vendored [pi-vcc](https://github.com/sting8k/pi-vcc) (inspired by [lllyasviel/VCC](https://github.com/lllyasviel/VCC)); removed `@sting8k/pi-vcc` npm dependency. Configuration is **env-only** (`HARNESS_VCC_COMPACTION`, `HARNESS_VCC_DEBUG`) β€” no `PI_VCC_CONFIG_PATH` or JSON config files. VCC overrides `/compact` and auto-compaction by default; set `HARNESS_VCC_COMPACTION=false` for Pi LLM compaction. Refresh upstream: `npm run vendor:sync-vcc`. - **Harness subagents:** vendored harness-subagents extension with Sentrux bootstrap agent and related harness wiring. - **Harness web:** replace Firecrawl with Scrapling-based `harness-web` CLI for search and fetch. ### πŸ”§ Chores - Format `.pi/settings.json` / `.pi/settings.example.json` and refresh `graphify-out` after VCC merge. ## [v0.3.1] β€” 2026-05-15 ### πŸ› Fixes - **External `/harness-setup`**: policy gate no longer forces **plan** phase because the setup doc mentions `harness-plan` (e.g. `gh label create "harness-plan"`). - **Harness specs in consumer repos**: copy `*.schema.json` and specs `README` from the package via `harness-seed-project-contracts.mjs` as part of setup (so `plan-packet.schema.json` exists before planning). - **Strict LLM gateways**: new `provider-payload-sanitize` extension removes disallowed top-level fields (`reasoning`, etc.) from `messages` before provider requests (avoids 400 β€œExtra inputs … reasoning” on some OpenAI-compatible APIs). ## [v0.3.0] β€” 2026-05-15 ### πŸ“¦ Release - First tag-driven npm / GitHub Packages publish since **v0.2.2**; intermediate history remains under **v0.2.3–v0.2.10** below. ### ✨ Features - Vendored [**pi-model-router**](https://github.com/yeliu84/pi-model-router) with harness gate and `npm run vendor:sync-router` - Sentrux **`rules.toml`** sync from `architecture.manifest.json` plus Phase 2 harness telemetry / governance scaffolding (see ADRs) - Document **`UP_PKG`** resolution and direct **`$UP_PKG/.pi/scripts/*`** invocation for external installs (no `harness:*` entries in consumer `package.json`) ### πŸ› Fixes - **`pi update`** / global installs: complete `koffi` tree; Node 22–compatible dependency graph - Harness-setup: Graphify bootstrap + CLI verification improvements (system deps, installers) ### πŸ”§ Chores - Drop external **`npm:@yeliu84/pi-model-router`** dependency; add **`THIRD_PARTY_NOTICES.md`** - Align publish **`files`** allowlist and **graphify-out** refresh ## [v0.2.10] β€” 2026-05-15 ### πŸ”§ Chores - Harness scripts must be invoked from `.pi/scripts/` (or `$UP_PKG/.pi/scripts/` for consumers); root `npm run harness:*` scripts removed so `pi install npm:ultimate-pi` works in external repos without mirroring npm script entries ### ✨ Features - Vendor [`yeliu84/pi-model-router`](https://github.com/yeliu84/pi-model-router) under `vendor/pi-model-router/` with a harness gate in `.pi/extensions/pi-model-router-harness.ts` (no `router/auto` until `.pi/model-router.json` exists after `/harness-setup`) - `npm run vendor:sync-router` to refresh upstream + apply import patches (see `vendor/pi-model-router/UPSTREAM_PIN.md`) ### πŸ”§ Chores - Remove `npm:@yeliu84/pi-model-router` from package dependencies; add `THIRD_PARTY_NOTICES.md` - `harness-sync-model-router.mjs` adjusts Pi defaults only (no package toggling) - `check:ts` uses ES2023; devDependency on `@earendil-works/pi-ai`, `pi-tui`, `pi-agent-core` for vendored typecheck ### πŸ› Fixes - Avoid npm package conflicts β€” router always comes from the bundled vendor tree ## [v0.2.8] β€” 2026-05-15 ### ✨ Features - Gate `pi-model-router`: shipped `.pi/settings.example.json` no longer lists `npm:@yeliu84/pi-model-router` until `/harness-setup` Step 3.5 creates `.pi/model-router.json` and runs `harness-sync-model-router.mjs` (adds the package, sets `router` / `auto` when project `defaultProvider` is unset, strips stale router entries when config is missing) ### πŸ› Fixes - Remove extension bootstrap that auto-wrote `.pi/model-router.json` on every start (router config is harness-owned only; avoids `router/auto` + built-in `gpt-5.4-pro` before setup) ## [v0.2.7] β€” 2026-05-15 ### πŸ› Fixes - Remove `bundledDependencies` so `pi update` / `npm install -g ultimate-pi` installs a complete `koffi` tree (fixes empty `node_modules/koffi` and postinstall failure) - Drop `context-mode` from package `dependencies` (install via `npm:context-mode` in project settings; avoids Node < 22.5 postinstall failure on global update) ## [v0.2.6] β€” 2026-05-15 ### πŸ”§ Chores - Align npm publish with pi package docs: explicit `files` allowlist (no dev runs, secrets, or local router config) - Fix `pi` manifest: drop missing `.pi/providers`, add `.pi/skills` - Ship `.pi/settings.example.json` instead of dev `.pi/settings.json` (removes `".."` local package from installs) - Document layout in `.pi/PACKAGING.md`; harness-setup seeds `.pi/agents` and resolves package root for npm installs ## [v0.2.5] β€” 2026-05-15 ### πŸ”§ Chores - Move harness CLI scripts to `.pi/scripts/` (aligned with pi package layout; no `pi.scripts` manifest field) - Point `npm run harness:*` and sentrux manifest at `.pi/scripts/` - Exclude repo-root `scripts/` from npm publish (dev-only graphify helpers stay in checkout) ## [v0.2.4] β€” 2026-05-15 ### πŸ› Fixes - Stop forcing `router/auto` on install (avoids defaulting to `gpt-5.4-pro` when no `.pi/model-router.json`) - Bootstrap `model-router.json` from detected providers when missing - Load banner and sentrux sync script from the npm package root, not the host project's cwd - Remove redundant `firecrawl setup skills` from harness-setup (skills ship with the package) ### πŸ“– Documentation - Add `.pi/model-router.example.json` and README note on opt-in model routing ## [v0.2.3] β€” 2026-05-15 ### ✨ Features - Sync `.sentrux/rules.toml` from `.pi/harness/sentrux/architecture.manifest.json` on harness setup and plan/merge - Add `sentrux-rules-sync` pi extension and `npm run harness:sentrux-sync` - Extend `harness:verify` to require rules.toml in sync with the manifest ### πŸ“– Documentation - ADR 0009 (Sentrux rules lifecycle) and README/harness-setup updates ## [v0.2.2] β€” 2026-05-15 ### πŸ”§ Chores - trim npm bundle and declare bundled deps - refresh generated artifacts ## [v0.2.1] β€” 2026-05-15 ### πŸ› Fixes - default to flow mode and soften budget gates ### πŸ”§ Chores - sync generated report and graph artifacts - refresh rebuild lock metadata - update install instructions and refresh graph artifacts ## [v0.2.0] β€” 2026-05-15 ### ✨ Features - update extension banner and custom header - add abort flow and safer live widget rendering - add orchestration stack and banner compatibility - router-aware custom footer with profile colors - gitignore model-router.json and generate dynamically from env - merge books & YT corpora, add merge scripts, up viz cap to 200K - add research papers and graphify knowledge graph outputs - add skill and rebuild knowledge graph - ingest Gleeson Musk first-principles prompts thread - add books corpus knowledge graph with cross-book linking - integrate ast-grep as primary code search tool - add sentrux architectural quality gate integration ### πŸ› Fixes - consolidate outputs into graphify-out/, prevent root duplication - add --ignore-scripts to npm publish in GitHub Packages workflow ### ♻️ Refactoring - migrate from Obsidian wiki to Graphify knowledge graph ### πŸ“– Documentation - add beginner-friendly harness user guide - label all 428 communities, regenerate report and HTML ### 🎨 Style - apply linter formatting (tab indent) ### πŸ”§ Chores - refresh generated graph artifacts - align graphify skill source to project-local path - include latest post-commit graph rebuild outputs - refresh generated graph and harness run artifacts - remove redundant internal code - refresh generated graph artifacts - remove rethink agent, add youtube video catalog - index NEA Γ— Namespace CI/CD / continuous compute YouTube talk - remove graphify-books-corpus aigleeson musk prompts markdown file - rename data/yt-vid to data/youtube-transcripts - align graphify outputs with data/books corpus paths - add data/ corpus: books (Git LFS) and yt-vid transcripts - add reusable YouTube transcript indexer (yt-dlp + Firecrawl CLI) - re-format includes array as multi-line - exclude graphify-books-out/ from lint/format - accept remote graphify-out artifacts, remove cache/ from tracking (gitignored) - add graphify-out/cache/ to .gitignore - update wiki docs - update wiki docs - update wiki docs - update wiki docs - update wiki docs - update wiki docs - update wiki docs - update wiki docs - update wiki docs - update wiki docs - fix biome ignore pattern: !graphify-out - ignore graphify-out from biome lint - update knowledge graph caches after background rebuild - remove wiki skills superseded by graphify - remove defuddle-cli and defuddle skill references (firecrawl covers same) ## [v0.1.7] β€” 2026-05-07 ### ✨ Features - add /release prompt for version bump and CI/CD publish - integrate pi-vcc for deterministic auto-compaction - replace pi-lean-ctx with context-mode - add soundboard extension, update settings and firecrawl env template ### πŸ”§ Chores - bump to 0.1.7, move vault AGENTS.md and .vault-meta under VAULT_WIKI_PATH