chore(release): prepare release v0.7.0

.gitignore

@@ -89,4 +89,8 @@ UglyCatToysHeadOfMarketing/
 ShelfCycle/
 TEST/cmd/localforge/delegation-test.txt
 cmd/localforge/web/
-!.env.template
+!.env.template
+
+HEARTBEAT.md
+cmd/localforge/brain/
+api_config/

AGENTS.md

@@ -9,17 +9,18 @@ R6|update refs|on change,touches agents.md
 R7|propose refactor|module too big|>400 LOC per file
 R8|maintain patterns|existing,always
 R9|no XML tags|system prompts,tool descriptions|use [brackets] not <tags>
+R10|no Legacy implementations. Ask to the user before implementing any legacy/retrocompatible code
 
 docs/agents
 
 R1|framework,purpose,principles,packages|docs/agents/overview.md
 R1|deps,structure,imports|docs/agents/architecture.md
 R2|builder,config,env|docs/agents/configuration.md
+R2|brain plugin memory,dreaming|docs/agents/configuration.md#brain-plugin-yaml,src/plugins/README.md#brain-plugin,memorySpec.md
 R2|commands,build,test,lint|docs/agents/quickref.md
 R2|error handling,interfaces,conventions|docs/agents/patterns.md
 R2|formatting,naming,style|docs/agents/code-style.md
 R3|add tool,package,impl|docs/agents/how-to-tools.md
-R3|system agent,template|docs/agents/how-to-system-agents.md
 R3|plugin,hook,tool provider|docs/agents/how-to-plugins.md
 R4|boundaries,permissions,ask-before|docs/agents/safety.md
 R4|debug,common issues|docs/agents/troubleshooting.md

CHANGELOG.md

@@ -1,11 +1,39 @@
-## [Unreleased]
+## [0.7.0] - 2026-04-05
 
-## [0.6.2] - 2026-03-11
-- [25622c1](http://github.com/thinktwiceco/agent-forge/commit/25622c177acfe3f114e826f09966b7091eb9f889) - fix: flatten repository/procedures so remote lists gmail-login, fix manifest fetch path
-- [c9f6e20](http://github.com/thinktwiceco/agent-forge/commit/c9f6e20a68771a6943e8a211d9af26f26e730815) - refactor(builder): remove unused vectorDB and embeddingGen from knowledge agent
-- [236dc7f](http://github.com/thinktwiceco/agent-forge/commit/236dc7f061f84d2ad444c24a32e19322664d465f) - refactor(agents): move knowledge and reasoning prompts to markdown
-- [c793357](http://github.com/thinktwiceco/agent-forge/commit/c7933575eb39fb79fe52c3c37a7e9021fdca4da0) - refactor(plugins,tools): simplify knowledge graph, add multi-service API and Instagram
+Summary: working tree vs `HEAD` (v0.6.2) — ~192 files, large net deletion from removed plugins/subagent stack; new spawn, Telegram, heartbeat, and web automation pieces.
 
+### Breaking changes
+
+- Removed built-in **knowledge** plugin (`src/plugins/knowledge`) and dependent Localforge knowledge wiring; install template and examples drop `knowledge` and invalid postgres-without-URL blocks.
+- Removed YAML **`subagents`**, **`delegate`** tool, **`meta` get_subagents**, and **`expand`** subagent discovery; ephemeral work is **`spawn_subagent`** with an explicit parent tool subset (`src/tools/spawn`).
+- Removed markdown-loaded **system agents** implementation (`src/agents/system/*`, per-agent prompt files, `sub-agents-header.md`) and related constructors/tests; agent init, prompts, and handlers refactored.
+- **Postgres** tool: removed discrete schema/table/CRUD action files; single validated **`query`** path remains (read/write mode, table and schema allowlists).
+- Removed `cmd/localforge/SECURITY.md`.
+
+### Added
+
+- **`spawn_subagent`** tool: synchronous ephemeral subagent with configurable tools from the parent (`src/tools/spawn`).
+- **`telegram`** tool for Localforge (ngrok, webhook secret, register/health); Telegram **`/new_conversation`** and **`telegram_thread_map.json`** via `telegram_thread_store`; provider/webhook updates and tests.
+- **`heartbeat`** plugin and **`heartbeatack`**: interval synthetic inbox turns; executor and tests updated.
+- **Web** tool: fetch and snapshot-style actions, accessibility snapshot helpers (`ax_snapshot`), `network_idle.js`, `stealth_patch.js`; browser session and search/navigation updates.
+- **Procedures** plugin: **`adapt_skill`** (`adapt_skill.go` + tests); vault **`fill_secret_args`** tests; agent prompt-injection and prompts-builder tests; executor heartbeat test; Localforge Telegram command tests.
+
+### Changed
+
+- Agents: merged chat/subagent paths (`agentChat.go`, `agentSubagent.go` removed), executor, context manager, history, interfaces, builder, system handlers, mocks, and integration tests.
+- **Expand** / **meta** tools simplified; **api**, **fs**, **git**, **image**, **instagram**, **update** touch-ups; **queue** and **`src/utils.go`** adjustments.
+- **Core** / **persistence**: `agentContext`, tool hooks, JSON persistence.
+- **LLMs**: factory, models, OpenAI and tool-call tests.
+- **Localforge**: config, server, push and provider registry, static UI (HTML/CSS/JS).
+- **Plugins**: logger, procedures, scheduler, todo, vault; **`src/plugins/README.md`**.
+- **Scripts** (`install.sh`, `install-release.sh`), **`.gitignore`**, **`go.mod`** / **`go.sum`**.
+
+### Docs
+
+- Telegram threads and **`/new_conversation`** in [`docs/TOOLS.md`](docs/TOOLS.md#telegram-webhook-threads), [`README.md`](README.md), [`src/builder/README.md`](src/builder/README.md), [`cmd/localforge/config.example.yaml`](cmd/localforge/config.example.yaml).
+- Tools/plugins tables and Quick Start (`ChatStream(ctx, …)`); removed stale `PUT /api/config/subagents` and YAML `subagents`; webhook links to Telegram tool; [`docs/agents/how-to-system-agents.md`](docs/agents/how-to-system-agents.md) no longer claims YAML `spawn_subagent` for Localforge; [`research.md`](research.md), [`plan.telegram-tool.md`](plan.telegram-tool.md), and install template aligned with removals.
+- Brain / dreaming aligned with code ([`docs/agents/configuration.md`](docs/agents/configuration.md), [`src/plugins/README.md`](src/plugins/README.md), [`memorySpec.md`](memorySpec.md)); stale migration body removed from `memorySpec.md`.
+- Wider refresh: `docs/AGENT_BUILDER.md`, `docs/CONFIG.md`, `docs/DISCOVERABLE.md`, `docs/EXPAND_TOOL.md`, `docs/FILE_STRUCTURE.md`, `docs/INTERFACES.md`, `docs/LOGGER.md`, `docs/TOOLS.md`, `docs/agents/*`, [`AGENTS.md`](AGENTS.md).
 
 ## [0.6.0] - 2026-03-07
 - [3ed2764](http://github.com/thinktwiceco/agent-forge/commit/3ed276486c13872649373f751ec2302d87a4eef4) - feat(agents!): parallel tool execution, context truncation, ModelInfo