v1.25.6

Summary

• Added a definitive English multi-page codebase guide for maintainers and contributors.
• Updated supported-agent documentation for Kilo Code, Kimi Code, Kiro IDE, Cursor, and OpenCode/Kilo overlay behavior.
• Synced Engram repository artifacts while ignoring local runtime state.
• Extended E2E CI timeouts to tolerate slow Linux package mirrors.

Details

• New guide landing page: docs/CODEBASE-GUIDE.md
• New focused guide pages under docs/codebase/
• Public docs now align supported-agent counts, names, paths, detection behavior, and readonly flags with source assets.
• .engram/engram.db and .engram/cloud.json are ignored as local runtime state.

v1.25.5

Summary

• Fixes chained PR guidance so child PRs target the immediate parent branch instead of the tracker branch.
• Updates SDD chain planning language so review diffs stay focused and child PRs never target main directly.
• Refreshes E2E skill bundle expectations for the expanded foundation skill set.
• Adds bounded E2E timeouts so Docker-based CI cannot hang indefinitely without diagnostics.

Verification

• go test -count=1 ./internal/components
• Full local Docker E2E: 466 passed, 0 failed, across Ubuntu/Arch/Fedora.
• GitHub CI run 25330209903: Unit Tests and E2E Tests passed.

v1.25.4

Summary

• Registers 4 missing skills (chained-pr, cognitive-doc-design, comment-writer, work-unit-commits) in the Go skill registry, catalog, and embedded assets so they are installed by the TUI skill picker and automated installation.

Details

• These skills were added in v1.25.0 but only existed in skills/ (public docs). They were missing from the Go build, so gentle-ai install and the TUI skill picker could not find or install them.
• Added skill ID constants, catalog entries, preset registration, and embedded SKILL.md assets for all 4 skills.
• Updated asset count test and golden fixtures.

Upgrade

brew upgrade gentle-ai

v1.25.3

Summary

• Adds Engram v1.15.3 prompt capture guidance to Gentle AI protocols and docs.
• Marks automated SDD and skill-registry artifacts with explicit capture_prompt: false.
• Preserves human/proactive memory saves on Engram's default best-effort prompt capture path.
• Adds compatibility guidance for older Engram MCP schemas that do not expose capture_prompt.

Details

• mem_save protocol docs now explain best-effort prompt capture, mem_save_prompt feeding SessionActivity, dedupe behavior, and the no-prompt-context fallback.
• SDD artifacts such as proposal/spec/design/tasks/apply-progress/verify/archive/init/testing-capabilities/onboarding/state now explicitly disable prompt capture when supported.
• Skill registry output is treated as an automated artifact and avoids prompt capture when supported.
• Older Engram schemas should omit the optional capture_prompt field rather than failing.
• Golden fixtures were regenerated for updated embedded assets.

Upgrade

brew upgrade gentle-ai

v1.25.2

Summary

• Improved chained-pr skill with interactive chain strategy selection so teams choose their own PR workflow instead of following a rigid decision tree.

Details

• When work exceeds the 400-line review budget, the agent now asks the user to choose between Stacked PRs to main (fast iteration, startup-friendly) or Feature Branch Chain with tracker (rollback control, coordinated releases).
• Added tradeoff comparison table so the team can make an informed decision based on their priorities.
• chain_strategy is now cached in the SDD session alongside delivery_strategy — once chosen, it persists for the entire session.
• Updated sdd-orchestrator, sdd-tasks, and sdd-apply to pass and enforce the cached chain strategy through the full pipeline.

Upgrade

brew upgrade gentle-ai

v1.25.1

Summary

• Fixes OpenCode sync migrations for gentle-orchestrator after upgrading to v1.25.0.
• Removes the revoked OpenCode gentleman agent during sync.
• Keeps upgrade backup diagnostics out of normal progress output.
• Adds repo-local Engram project-name locking for this repository.

Details

• Preserved OpenCode orchestrator prompts now migrate known legacy sdd-orchestrator references to gentle-orchestrator.
• Sync removes the revoked gentleman agent while preserving valid named profile agents such as sdd-orchestrator-cheap.
• Upgrade backup output no longer floods the terminal with backup: excluding directory ... diagnostics during normal TUI/update flows.
• .engram/config.json locks this repository's Engram project name to gentle-ai.

Upgrade

brew upgrade gentle-ai

v1.25.0

Summary

• Added the sustainable review workflow for SDD changes, including delivery strategy planning and review workload forecasting.
• Renamed the canonical OpenCode SDD conductor to gentle-orchestrator while preserving legacy sdd-orchestrator migration support.
• Updated chained PR, contribution, and documentation guidance to keep reviews smaller, clearer, and easier to merge safely.

Details

• Adds PR size-budget policy with maintainer-applied size:exception handling for aggregate or tracker PRs.
• Adds SDD Delivery Strategy and Review Workload Guard guidance so substantial changes can be planned as single PRs, chained PRs, or phased delivery.
• Updates OpenCode overlays, commands, model picker UI, docs, and golden fixtures for the gentle-orchestrator naming.
• Keeps compatibility for existing installations using legacy sdd-orchestrator configuration.
• Stabilizes E2E coverage by using a deterministic local Engram shim unless live Engram download testing is explicitly enabled.

Upgrade

brew upgrade gentle-ai

v1.24.3

Summary

• Fixed OpenCode community plugin update detection and upgrade behavior across all plugin layers.

Details

• Gentle AI now detects OpenCode plugins from node_modules, ~/.config/opencode/package.json, and ~/.config/opencode/tui.json.
• Plugins registered only in tui.json now show as registered and pending materialization instead of not installed.
• gentle-ai update tools now updates plugin npm dependencies from ~/.config/opencode, updates @opencode-ai/plugin, and clears only the matching OpenCode package cache under ~/.cache/opencode/packages/<plugin>@latest.
• Restart or reload OpenCode after upgrading plugins so the TUI picks up the refreshed cache.

v1.24.2

Summary

• Fixed OpenCode community plugin upgrades so registered plugins no longer stay skipped when an update is available.

Details

• Initial plugin setup remains declarative through ~/.config/opencode/tui.json.
• Upgrade tools now update registered or materialized OpenCode plugin packages from ~/.config/opencode using bun or npm when available.
• npm fallback runs non-interactively with --no-audit --no-fund and does not use sudo.

v1.24.1

Summary

• Fixed stale Engram Homebrew paths in OpenCode and MCP configs.
• Added GH_TOKEN fallback for GitHub release checks to reduce rate-limit failures.

Details

• Gentle AI now migrates persisted Engram commands like /opt/homebrew/Cellar/engram/<version>/bin/engram to stable paths such as /opt/homebrew/bin/engram, /usr/local/bin/engram, or engram.
• This prevents OpenCode from failing with ENOENT after brew upgrade engram removes the old Cellar version.
• Update checks now read tokens in this order: GITHUB_TOKEN, GH_TOKEN, then gh auth token.