0.2.2

Highlights

• Improves PlanWeave's cross-agent execution flow with executor-aware claiming, feedback routing, run status, and clearer failure reporting.
• Adds stronger runtime observability for long-running executor work, including heartbeat records, tmux session details, and structured OpenCode errors.
• Ships a corrected desktop release path with x64 coverage as a first-class target: macOS universal, Windows x64, and Linux x64.
• Hardens project/source-root resolution so bound repositories open the intended PlanWeave project instead of silently deriving a new uninitialized one.

CLI / Runtime / MCP

• planweave paths and source-root project resolution now prefer the bound project for a repository, reducing accidental switches to newly derived project IDs.
• Claim and run-status flows expose effective executor information so coordinators can route work to the intended agent instead of guessing from manifest defaults.
• Feedback from review gates now routes back through the assigned executor for the affected work, including inherited executor cases.
• OpenCode executor failures are parsed more narrowly and reported with structured details instead of collapsing into vague UnknownError messages.
• Auto Run records now include executor heartbeat and tmux metadata so long-running, quiet executor processes are easier to distinguish from hangs.
• Runtime diagnostics now surface prompt, metadata, canvas, task runtime, and Auto Run I/O failures explicitly instead of hiding them behind fallback behavior.
• MCP checksum parsing has been hardened to avoid pathological regex backtracking.

Desktop

• Adds a guarded Desktop Release workflow that builds official installers in GitHub Actions instead of relying on the local machine architecture.
• Expected desktop coverage is macOS universal DMG/ZIP, Windows x64 NSIS/ZIP, and Linux x64 AppImage/DEB/tar.gz, plus matching updater metadata.
• Adds packaged startup verification for macOS, Windows, and Linux release jobs before artifacts are uploaded.
• Fixes macOS universal packaging for native electron-liquid-glass prebuilds.
• Improves project settings, sidebar behavior, file-sync visibility, diagnostics, and canvas controls in the desktop app.
• Refreshes external runtime state more reliably and keeps review-gated tasks in progress while review work is still pending.
• Keeps local desktop release scripts guarded so accidental local publish commands fail with an explicit message.

Reliability

• Adds workspace lint/typecheck coverage and builds workspace dependencies before typechecking.
• Stabilizes executor contract tests by isolating tmux-sensitive behavior from non-tmux adapter contracts.
• Adds focused desktop renderer, hook, Auto Run, diagnostics, terminal record, project sidebar, and package file-sync coverage.
• Improves results indexing and Auto Run ID allocation performance under larger project histories.
• Adds pre-commit checks to catch lint and boundary issues earlier.

Verification

• Local lint, full test suite, and workspace build have passed on the release commit.
• Local macOS packaged preflight and smoke checks have passed.
• GitHub CI and CodeQL checks have passed.
• Desktop Release dry run has passed for macOS universal, Windows x64, and Linux x64, including release artifact verification.

Notes

• Desktop packages are still unsigned. macOS Gatekeeper and Windows SmartScreen may warn that the publisher is unknown.

0.2.1

Highlights

• Desktop now surfaces executor preflight diagnostics before a run, making misconfigured commands and unavailable executor profiles easier to catch.
• Inspector panels can open run terminals directly, including attaching to available tmux-backed run sessions from a detected terminal app.
• Desktop UI settings now persist through PlanWeave Home, with migration for existing MCP tunnel and terminal preferences.
• Runtime graph editing now supports atomic task and block field updates, improving consistency across Desktop and MCP edits.

Desktop

• Added executor preflight state and UI coverage for agent and executor configuration workflows.
• Added terminal app detection, default terminal preference handling, and run terminal launch actions from task and block inspectors.
• Moved Desktop settings into a shared settings model backed by PlanWeave Home, covering appearance, language, notifications, sidebar layout, review, palette, agents, and auto-run control placement.
• Added package watcher refresh metrics and deduped repeated file change notifications.
• Improved search responsiveness by returning summary results before body hydration and exposing search performance diagnostics.
• Refactored workspace tab, graph, search, and auto-run controller boundaries to keep renderer state orchestration clearer.

CLI / Runtime / MCP

• Split CLI command output formatting into focused formatter modules for run, status, executor, and project graph output.
• Split plan graph command handling by task, block, dependency, review, and layout command responsibilities.
• Preserved reset reasons in run sessions and reset event summaries.
• Added atomic graph field edit APIs used by Desktop and MCP task/block updates.
• Hardened MCP OAuth store writes with private file and directory permissions.
• Removed a backtracking-prone checksum parsing regex from the tunnel-client downloader while keeping support for standard SHA256SUMS.txt formats.

Reliability

• Hardened Desktop projection caches so snapshot, search, and statistics reads replay diagnostics consistently.
• Made Desktop auto-run stop requests idempotent.
• Added package file refresh statistics, incremental refresh diagnostics, and safer file watcher change handling.
• Added search performance diagnostics for summary indexing and body hydration paths.

Verification

• pnpm check:versions
• pnpm -r build
• pnpm test
• pnpm --dir packages/desktop verify:packaged:mac
• pnpm --dir packages/desktop smoke:packaged:mac

0.2.0

PlanWeave 0.2.0

Highlights

• Added shared run-session history for CLI and Desktop Auto Run flows, including reset/run session records and latest session visibility.
• Added rerun session orchestration so runs can be resumed, inspected, and queried through runtime and CLI surfaces.
• Added Desktop Auto Run retrospectives and recovery actions for completed, paused, stopped, and blocked runs.

Desktop

• Added runtime reset actions and improved Auto Run controls, including session links, next actions, and record navigation.
• Improved desktop search results with match context for faster scanning.
• Hardened tunnel-client launch handling and packaged app smoke verification.
• Stabilized package watching so pending watchers are cancelled correctly.

CLI / Runtime / MCP

• Added CLI commands for run sessions and scoped Auto Run behavior.
• Added runtime repositories and APIs for run-session persistence, reset sessions, and session-aware execution.
• Improved prompt section scanning and path normalization performance and safety.
• Updated MCP tooling to reflect runtime package behavior in this release.

Reliability

• Bounded executor stdout/stderr output and terminates over-limit or timed-out executor sessions.
• Released terminal Auto Run state reliably after executor completion.
• Stabilized tmux-backed executor session lifecycle for fast-completing commands.
• Resolved dependency advisories and tightened GitHub workflow permissions.

Verification

• Ran pnpm -r build.
• Ran pnpm test; initial local full-suite runs exposed transient timing failures, then targeted reruns and the final full-suite run passed.
• Ran pnpm --dir packages/desktop verify:packaged:mac.
• Ran pnpm --dir packages/desktop smoke:packaged:mac.

0.1.9

0.1.9

Highlights

• Published coordinated 0.1.9 packages for runtime, CLI, MCP, Homebrew, and desktop installers.
• Added managed project/source-root handling so generated projects stay tied to their source roots.
• Unified default canvas workspace storage and added task canvas rename support.
• Added MCP support for canvas execution policy so agents can inspect and apply execution rules through the protocol package.

Desktop

• Improved source-build startup behavior so PlanWeave home is preserved correctly.
• Added file sync impact details in the UI.
• Kept the manual executor selectable and improved detected-agent/profile alignment.
• Added agent prompt copy scope controls.
• Ensured project graphs are materialized when opening desktop projects.
• Published macOS, Linux arm64, and Windows arm64 installers with updater metadata.

CLI / Runtime / MCP

• Added source-root-aware default project selection in the CLI.
• Improved incremental graph index refresh and dirty reference tracking.
• Published CLI and MCP with concrete runtime dependency versions instead of workspace protocol dependencies.
• Updated the MCP package version metadata for 0.1.9.

Reliability

• Improved desktop sync and auto-run event logs.
• Stabilized the desktop notifications smoke flow by waiting for the graph surface after task confirmation.
• Increased long CLI workflow test timeout to avoid full-suite timing failures under concurrent test load.

Verification

• pnpm check:versions
• pnpm -r build
• pnpm test
• pnpm --dir packages/desktop verify:packaged:mac
• pnpm --dir packages/desktop smoke:packaged:mac
• GitHub CI and Desktop Smoke passed on main
• npm registry metadata and temporary CLI install verified
• GitHub Release assets verified: macOS, Linux arm64, Windows arm64, and updater metadata

0.1.7

PlanWeave 0.1.7

Highlights

• Added unified PlanGraph command history for graph edits, including undo/redo across node movement, dependency changes, canvas selection, component changes, and prompt edits.
• Preserved graph viewport and local canvas position through autosave and graph refreshes, reducing disruptive view jumps while editing.
• Improved ReactFlow edge UX with reconnect-based edge removal and source-colored dependency edges for easier graph reading.
• Added per-canvas desktop projection caching for faster project refresh, search, todo, statistics, and graph projection workloads on large multi-canvas projects.
• Scoped Auto Run tmux stopping to the active run id, so stopping one run no longer kills unrelated active tmux sessions.
• Centralized high-risk MCP tool input schemas to reduce drift between advertised tool contracts and runtime parsing.
• Added staged/quarantined canvas workspace recovery and project doctor diagnostics for orphan, stale staging, stale quarantine, and missing workspace states.
• Raised package Node engine requirement to Node.js >=22.5 and moved release CI checks to Node 26 so node:sqlite is available.

Validation

• pnpm -r build
• pnpm test：105 test files, 627 tests passed
• pnpm --dir packages/desktop verify:packaged:mac
• pnpm --dir packages/desktop smoke:packaged:mac

0.1.6

Desktop 0.1.6 Notice

Highlights

• Added MCP plan-authoring tools and secure tunnel OAuth integration.
• Added desktop settings for MCP tunnel autostart and persistence.
• Improved desktop reliability around file watching, prompt refresh snapshots, and MCP context responses.
• Hardened MCP search_project path redaction for local filesystem paths while preserving URLs and ordinary routes.
• Added CLI project doctor checks and clearer handling for uninitialized workspaces.
• Improved runtime graph indexing and bounded review hook execution.
• Localized native desktop update feedback and repaired desktop glass surface chrome.

Release Channels

• Published @planweave-ai/runtime@0.1.4 to npm.
• Published @planweave-ai/cli@0.1.4 to npm, with the packed CLI depending on @planweave-ai/runtime@0.1.4.
• Updated the Homebrew formula to install the 0.1.4 CLI tarball and verify planweave --version against 0.1.4.
• Published desktop installers and updater metadata for v0.1.6, including latest-mac.yml, latest-linux-arm64.yml, and latest.yml.

Desktop

• Refreshed the desktop app icon source image and regenerated the macOS icon bundle.
• Published macOS arm64 DMG/ZIP, Linux arm64 AppImage/DEB/tar.gz, and Windows arm64 EXE/ZIP assets.

Documentation

• Clarified the ChatGPT Pro + MCP Tunnel planning workflow in the English and Chinese READMEs.
• Documented that opening Settings -> MCP Tunnel in the desktop app enables the MCP server path, without a separate local server startup step.

Verification

• pnpm -r build
• pnpm test
• npm registry verification for runtime and CLI 0.1.4
• Homebrew formula verification through the tap repository
• GitHub Release asset verification for v0.1.6
• GitHub Actions CI passed for both main and v0.1.6

Notes

• macOS code signing is still disabled in the current desktop builder configuration, so macOS users may see Gatekeeper warnings.

0.1.5

Desktop 0.1.5 Notice

Highlights

• Added MCP plan-authoring tools and secure tunnel OAuth integration.
• Added desktop settings for MCP tunnel autostart and persistence.
• Improved desktop reliability around file watching, prompt refresh snapshots, and MCP context responses.
• Hardened MCP search_project path redaction for local filesystem paths while preserving URLs and ordinary routes.
• Added CLI project doctor checks and clearer handling for uninitialized workspaces.
• Improved runtime graph indexing and bounded review hook execution.
• Localized native desktop update feedback and repaired desktop glass surface chrome.

Release Channels

• Published @planweave-ai/runtime@0.1.4 to npm.
• Published @planweave-ai/cli@0.1.4 to npm, with the packed CLI depending on @planweave-ai/runtime@0.1.4.
• Updated the Homebrew formula to install the 0.1.4 CLI tarball and verify planweave --version against 0.1.4.
• Published desktop installers and updater metadata for v0.1.5, including latest-mac.yml, latest-linux-arm64.yml, and latest.yml.

Desktop

• Refreshed the desktop app icon source image and regenerated the macOS icon bundle.
• Published macOS arm64 DMG/ZIP, Linux arm64 AppImage/DEB/tar.gz, and Windows arm64 EXE/ZIP assets.

Documentation

• Clarified the ChatGPT Pro + MCP Tunnel planning workflow in the English and Chinese READMEs.
• Documented that opening Settings -> MCP Tunnel in the desktop app enables the MCP server path, without a separate local server startup step.

Verification

• pnpm -r build
• pnpm test
• npm registry verification for runtime and CLI 0.1.4
• Homebrew formula verification through the tap repository
• GitHub Release asset verification for v0.1.5
• GitHub Actions CI passed for both main and v0.1.5

Notes

• macOS code signing is still disabled in the current desktop builder configuration, so macOS users may see Gatekeeper warnings.

0.1.4

Desktop 0.1.4 Notice

Desktop 0.1.4 has a packaged-app startup crash caused by a missing updater runtime dependency (ms). Install Desktop 0.1.5 manually instead. The npm runtime/CLI 0.1.4 packages remain valid.

Highlights

• Added MCP plan-authoring tools and secure tunnel OAuth integration.
• Added desktop settings for MCP tunnel autostart and persistence.
• Improved desktop reliability around file watching, prompt refresh snapshots, and MCP context responses.
• Hardened MCP search_project path redaction for local filesystem paths while preserving URLs and ordinary routes.
• Added CLI project doctor checks and clearer handling for uninitialized workspaces.
• Improved runtime graph indexing and bounded review hook execution.
• Localized native desktop update feedback and repaired desktop glass surface chrome.

Release Channels

• Published @planweave-ai/runtime@0.1.4 to npm.
• Published @planweave-ai/cli@0.1.4 to npm, with the packed CLI depending on @planweave-ai/runtime@0.1.4.
• Updated the Homebrew formula to install the 0.1.4 CLI tarball and verify planweave --version against 0.1.4.
• Published desktop installers and updater metadata for v0.1.4, including latest-mac.yml, latest-linux-arm64.yml, and latest.yml.

Desktop

• Refreshed the desktop app icon source image and regenerated the macOS icon bundle.
• Published macOS arm64 DMG/ZIP, Linux arm64 AppImage/DEB/tar.gz, and Windows arm64 EXE/ZIP assets.

Documentation

• Clarified the ChatGPT Pro + MCP Tunnel planning workflow in the English and Chinese READMEs.
• Documented that opening Settings -> MCP Tunnel in the desktop app enables the MCP server path, without a separate local server startup step.

Verification

• pnpm -r build
• pnpm test
• npm registry verification for runtime and CLI 0.1.4
• Homebrew formula verification through the tap repository
• GitHub Release asset verification for v0.1.4
• GitHub Actions CI passed for both main and v0.1.4

Notes

• macOS code signing is still disabled in the current desktop builder configuration, so macOS users may see Gatekeeper warnings.

0.1.2

Desktop

• Added app update checks with a native macOS Check for Updates menu item, settings entry, and update toast.
• Added manual update download flow using 开始下载更新 before install/restart.
• Renamed the native app menu/About label to PlanWeave.
• Added liquid glass window material support and packaged its runtime loader dependency.
• Redesigned the app shell and settings experience.
• Added resizable sidebars and improved first-run empty states.
• Improved Todo, Statistics, Search, Canvas Map, and notification workflows.
• Added live desktop subscriptions for Auto Run state changes.
• Fixed graph layout by task dependencies, current canvas reload after session updates, and stale review pipeline task state.
• Suppressed Finder reveal calls during desktop smoke tests.

Runtime and CLI

• Added Claude Code and Pi executor integrations.
• Cached desktop project projections for faster snapshot loading.
• Rehydrated persisted Auto Run state.
• Hardened Auto Run status handling and CI gates.
• Fixed quoted run-status next-command output.

Architecture and Packaging

• Split workspace renderer views and deepened desktop/runtime module boundaries.
• Consolidated runtime bridge adapters.
• Removed optional brand prefixes.
• Added desktop packaging scripts for macOS, Linux, and Windows.
• Added manifest test builder coverage.

0.1.1

v0.1.1

chore(release): bump npm package versions