Prepare v0.3.0 release

Bump version to 0.3.0. Resolve all clippy warnings, update README
tools/features/workflows tables to match codebase, rewrite stale
SCHEMA.md, and add 67 new tests covering feedback tools, overlay
management, offset pagination, and connect overlays.

Set up MCP registry publishing with MCPB bundles in the release
workflow and server.json template.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Oortonaut

.github/workflows/release.yml

@@ -20,15 +20,19 @@ jobs:
           - target: x86_64-unknown-linux-gnu
             os: ubuntu-latest
             archive: tar.gz
+            binary: task-graph-mcp
           - target: x86_64-apple-darwin
             os: macos-latest
             archive: tar.gz
+            binary: task-graph-mcp
           - target: aarch64-apple-darwin
             os: macos-latest
             archive: tar.gz
+            binary: task-graph-mcp
           - target: x86_64-pc-windows-msvc
             os: windows-latest
             archive: zip
+            binary: task-graph-mcp.exe
 
     steps:
       - uses: actions/checkout@v4
@@ -55,11 +59,109 @@ jobs:
           7z a ../../../task-graph-mcp-${{ matrix.target }}.zip task-graph-mcp.exe
           cd ../../..
 
+      - name: Extract version from tag
+        id: version
+        shell: bash
+        run: |
+          if [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+            echo "version=${GITHUB_REF#refs/tags/v}" >> "$GITHUB_OUTPUT"
+          else
+            echo "version=$(grep '^version' Cargo.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create MCPB bundle
+        shell: bash
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          TARGET="${{ matrix.target }}"
+          BINARY="${{ matrix.binary }}"
+
+          mkdir -p mcpb-staging
+          cp "target/${TARGET}/release/${BINARY}" mcpb-staging/
+
+          cat > mcpb-staging/manifest.json << EOF
+          {
+            "manifest_version": "0.3",
+            "name": "task-graph-mcp",
+            "version": "${VERSION}",
+            "description": "MCP server for agent task workflows with phases, prompts, gates, and multi-agent coordination",
+            "author": {
+              "name": "Oortonaut",
+              "url": "https://github.com/Oortonaut"
+            },
+            "license": "Apache-2.0",
+            "repository": "https://github.com/Oortonaut/task-graph-mcp",
+            "server": {
+              "type": "binary",
+              "entry_point": "${BINARY}",
+              "mcp_config": {
+                "command": "${BINARY}",
+                "args": [],
+                "env": {}
+              }
+            },
+            "tools": [
+              {"name": "connect", "description": "Register agent and join workflow"},
+              {"name": "create", "description": "Create a new task"},
+              {"name": "create_tree", "description": "Create a task hierarchy from YAML"},
+              {"name": "update", "description": "Update task state, description, or dependencies"},
+              {"name": "get", "description": "Get full task details"},
+              {"name": "list_tasks", "description": "List and filter tasks"},
+              {"name": "delete", "description": "Delete a task"},
+              {"name": "rename", "description": "Rename a task ID"},
+              {"name": "claim", "description": "Claim a ready task"},
+              {"name": "scan", "description": "Get task tree with agent context"},
+              {"name": "thinking", "description": "Record agent reasoning"},
+              {"name": "query", "description": "Run read-only SQL queries"},
+              {"name": "link", "description": "Add dependency between tasks"},
+              {"name": "unlink", "description": "Remove dependency between tasks"},
+              {"name": "mark_file", "description": "Lock a file for an agent"},
+              {"name": "unmark_file", "description": "Release a file lock"},
+              {"name": "list_marks", "description": "List active file locks"},
+              {"name": "check_gates", "description": "Evaluate workflow gate conditions"},
+              {"name": "list_workflows", "description": "List available workflows"},
+              {"name": "add_overlay", "description": "Add a dynamic workflow overlay"},
+              {"name": "remove_overlay", "description": "Remove a workflow overlay"},
+              {"name": "give_feedback", "description": "Record inter-agent feedback"},
+              {"name": "list_feedback", "description": "List recorded agent feedback"},
+              {"name": "list_skills", "description": "List available bundled skills"},
+              {"name": "get_skill", "description": "Get bundled skill content"},
+              {"name": "cleanup_stale", "description": "Evict stale workers"}
+            ],
+            "keywords": ["mcp", "agent-workflow", "multi-agent", "task-management", "coordination"]
+          }
+          EOF
+
+          cd mcpb-staging
+          if command -v zip &> /dev/null; then
+            zip -r "../task-graph-mcp-${TARGET}.mcpb" .
+          elif command -v 7z &> /dev/null; then
+            7z a -tzip "../task-graph-mcp-${TARGET}.mcpb" .
+          else
+            echo "No zip tool available" && exit 1
+          fi
+          cd ..
+
+          # Compute SHA-256
+          if command -v sha256sum &> /dev/null; then
+            SHA=$(sha256sum "task-graph-mcp-${TARGET}.mcpb" | awk '{print $1}')
+          elif command -v shasum &> /dev/null; then
+            SHA=$(shasum -a 256 "task-graph-mcp-${TARGET}.mcpb" | awk '{print $1}')
+          else
+            SHA=$(openssl dgst -sha256 "task-graph-mcp-${TARGET}.mcpb" | awk '{print $NF}')
+          fi
+          echo "sha256=${SHA}" >> "$GITHUB_OUTPUT"
+          echo "${TARGET}=${SHA}" > "mcpb-sha256-${TARGET}.txt"
+        id: mcpb
+
       - name: Upload artifact
         uses: actions/upload-artifact@v4
         with:
           name: task-graph-mcp-${{ matrix.target }}
-          path: task-graph-mcp-${{ matrix.target }}.${{ matrix.archive }}
+          path: |
+            task-graph-mcp-${{ matrix.target }}.${{ matrix.archive }}
+            task-graph-mcp-${{ matrix.target }}.mcpb
+            mcpb-sha256-${{ matrix.target }}.txt
 
   release:
     name: Create Release
@@ -68,6 +170,7 @@ jobs:
     if: startsWith(github.ref, 'refs/tags/')
     permissions:
       contents: write
+      id-token: write
 
     steps:
       - uses: actions/checkout@v4
@@ -77,11 +180,89 @@ jobs:
         with:
           path: artifacts
 
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/v}" >> "$GITHUB_OUTPUT"
+
+      - name: Generate server.json with SHA-256 hashes
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+
+          # Read SHA-256 hashes
+          SHA_LINUX=$(cat artifacts/task-graph-mcp-x86_64-unknown-linux-gnu/mcpb-sha256-x86_64-unknown-linux-gnu.txt | cut -d= -f2)
+          SHA_MACOS_X86=$(cat artifacts/task-graph-mcp-x86_64-apple-darwin/mcpb-sha256-x86_64-apple-darwin.txt | cut -d= -f2)
+          SHA_MACOS_ARM=$(cat artifacts/task-graph-mcp-aarch64-apple-darwin/mcpb-sha256-aarch64-apple-darwin.txt | cut -d= -f2)
+          SHA_WINDOWS=$(cat artifacts/task-graph-mcp-x86_64-pc-windows-msvc/mcpb-sha256-x86_64-pc-windows-msvc.txt | cut -d= -f2)
+
+          cat > server.json << EOF
+          {
+            "\$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+            "name": "io.github.Oortonaut/task-graph-mcp",
+            "description": "MCP server for agent task workflows with phases, prompts, gates, and multi-agent coordination",
+            "version": "${VERSION}",
+            "repository": {
+              "url": "https://github.com/Oortonaut/task-graph-mcp",
+              "source": "github"
+            },
+            "packages": [
+              {
+                "registryType": "mcpb",
+                "identifier": "https://github.com/Oortonaut/task-graph-mcp/releases/download/v${VERSION}/task-graph-mcp-x86_64-unknown-linux-gnu.mcpb",
+                "version": "${VERSION}",
+                "fileSha256": "${SHA_LINUX}",
+                "transport": { "type": "stdio" }
+              },
+              {
+                "registryType": "mcpb",
+                "identifier": "https://github.com/Oortonaut/task-graph-mcp/releases/download/v${VERSION}/task-graph-mcp-x86_64-apple-darwin.mcpb",
+                "version": "${VERSION}",
+                "fileSha256": "${SHA_MACOS_X86}",
+                "transport": { "type": "stdio" }
+              },
+              {
+                "registryType": "mcpb",
+                "identifier": "https://github.com/Oortonaut/task-graph-mcp/releases/download/v${VERSION}/task-graph-mcp-aarch64-apple-darwin.mcpb",
+                "version": "${VERSION}",
+                "fileSha256": "${SHA_MACOS_ARM}",
+                "transport": { "type": "stdio" }
+              },
+              {
+                "registryType": "mcpb",
+                "identifier": "https://github.com/Oortonaut/task-graph-mcp/releases/download/v${VERSION}/task-graph-mcp-x86_64-pc-windows-msvc.mcpb",
+                "version": "${VERSION}",
+                "fileSha256": "${SHA_WINDOWS}",
+                "transport": { "type": "stdio" }
+              }
+            ]
+          }
+          EOF
+
+          echo "Generated server.json:"
+          cat server.json
+
       - name: Upload release artifacts
         uses: softprops/action-gh-release@v2
         with:
           draft: false
           files: |
-            artifacts/**/*
+            artifacts/**/*.tar.gz
+            artifacts/**/*.zip
+            artifacts/**/*.mcpb
+            server.json
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install mcp-publisher
+        run: |
+          curl -fsSL https://registry.modelcontextprotocol.io/publisher/install.sh | sh || true
+          which mcp-publisher || echo "mcp-publisher not available, skipping registry publish"
+
+      - name: Publish to MCP Registry
+        if: success()
+        run: |
+          if command -v mcp-publisher &> /dev/null; then
+            mcp-publisher login github-oidc
+            mcp-publisher publish
+          else
+            echo "::warning::mcp-publisher not installed. Publish server.json manually after release."
+          fi

.gitignore

@@ -8,3 +8,4 @@ nul
 *.db-shm
 *.db-wal
 *.log
+.mcpregistry_*

CHANGELOG.md

@@ -5,6 +5,43 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.3.0] - 2026-01-31
+
+### Added
+
+- **Agent feedback tools**: `give_feedback` and `list_feedback` for inter-agent communication during workflows
+- **Dynamic overlay management**: `add_overlay` and `remove_overlay` tools for runtime workflow customization
+- **Worker overlays**: Agents can request overlays on `connect` for role-specific workflow behavior
+- **Troubleshooting overlay**: Pre-built overlay for debugging agent issues (`overlay-troubleshooting.yaml`)
+- **Git overlay**: Pre-built overlay for git-aware workflows (`overlay-git.yaml`)
+- **Offset pagination**: `offset` parameter for `list_tasks` with `has_more` metadata
+- **Skill frontmatter parsing**: Skill index listings now include `description` from SKILL.md frontmatter
+- **Kanban workflow**: New `workflow-kanban.yaml` topology for board-style task management
+- **Sprint workflow**: New `workflow-sprint.yaml` topology for time-boxed iteration planning
+- **MCP registry publishing**: MCPB bundle generation and `server.json` in release workflow
+- **Browser project template**: Template for coordination experiments
+- **Experiment and design documentation**: Distributed swarm, authorization, database backends, experiment framework
+
+### Changed
+
+- Basics skill rewritten to v2.0.0 with unified coordinator/worker guidance
+- Workflow role sections expanded across all topologies (solo, swarm, relay, hierarchical, push)
+- Agent feedback enabled in default project config
+- Overlay file changes detected by config watcher and hot-reloaded
+
+### Removed
+
+- `task-graph-coordinator` skill (merged into basics v2.0.0)
+- `task-graph-worker` skill (merged into basics v2.0.0)
+
+### Fixed
+
+- Flaky child ordering test (deterministic rowid tiebreaker)
+- Release notes preservation in CI workflow
+- Clippy warnings: `map_or` → `is_some_and`, `len() > 0` → `!is_empty()`, field reassignment, unnecessary deref
+
 ## [0.2.2] - 2026-01-29
 
 ### Added

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "task-graph-mcp"
-version = "0.2.2"
+version = "0.3.0"
 edition = "2024"
 description = "MCP server for agent task workflows with phases, prompts, gates, and multi-agent coordination"
 license = "Apache-2.0"

Cargo.toml

@@ -36,6 +36,8 @@ When you have AI agents working on complex tasks, things go wrong fast. Agents l
 | **Live Status** | Real-time "current thought" visible to other agents |
 | **Full-text Search** | FTS5-powered search across tasks and attachments |
 | **Attachments** | Inline content, file references, or media storage |
+| **Agent Feedback** | Inter-agent communication with categorized feedback (conditional on config) |
+| **Dynamic Overlays** | Runtime workflow customization via add/remove overlay tools |
 
 ## Quick Start
 
@@ -283,9 +285,12 @@ Environment variables:
 
 | Tool | Description |
 |------|-------------|
-| `connect(worker_id?, tags?, workflow?, force?, db_path?, media_dir?, log_dir?, config_path?)` | Register a worker. Optional `workflow` selects named workflow (solo, swarm, relay, hierarchical). Returns `worker_id` and active `paths`. |
+| `connect(worker_id?, tags?, workflow?, force?, db_path?, media_dir?, log_dir?, config_path?, overlays?: str[])` | Register a worker. Optional `workflow` selects named workflow (solo, swarm, relay, hierarchical). Returns `worker_id` and active `paths`. |
 | `disconnect(worker_id: worker_str, final_status?: status_str = "pending")` | Unregister worker and release all claims/locks. |
-| `list_workers(tags?: str[], file?: filename, task?: task_str, depth?: int)` | List connected workers with filters. |
+| `list_agents(tags?: str[], file?: filename, task?: task_str, depth?: int, stale_timeout?: int)` | List connected workers with filters. |
+| `cleanup_stale(worker_id: str, stale_timeout?: int)` | Evict stale workers and release their claims. |
+| `add_overlay(worker_id: str, overlay: str)` | Add a dynamic workflow overlay to a connected worker. |
+| `remove_overlay(worker_id: str, overlay: str)` | Remove a workflow overlay from a connected worker. |
 
 ### Task CRUD
 
@@ -294,7 +299,7 @@ Environment variables:
 | `create(description: str, id?: task_str, parent?: task_str, priority?: int = 5, points?: int, time_estimate_ms?: int, tags?: str[])` | Create a task. Priority 0-10 (higher = more important). |
 | `create_tree(tree, parent?, child_type?, sibling_type?)` | Create nested task tree. `child_type` (default: "contains") for parent→child deps, `sibling_type` for sibling deps. |
 | `get(task: task_str)` | Get task by ID with attachment metadata and counts. |
-| `list_tasks(status?: status_str[], ready?: bool, blocked?: bool, claimed?: bool, owner?: worker_str, parent?: task_str, worker_id?: worker_str, tags_any?: str[], tags_all?: str[], sort_by?: str, sort_order?: str, limit?: int)` | Query tasks with filters. Use `ready=true` for claimable tasks. |
+| `list_tasks(status?: status_str[], ready?: bool, blocked?: bool, claimed?: bool, owner?: worker_str, parent?: task_str, worker_id?: worker_str, tags_any?: str[], tags_all?: str[], sort_by?: str, sort_order?: str, limit?: int, offset?: int, recursive?: bool)` | Query tasks with filters. Use `ready=true` for claimable tasks. |
 | `update(worker_id: worker_str, task: task_str, status?: status_str, phase?: str, assignee?: worker_str, title?: str, description?: str, priority?: int, points?: int, tags?: str[], needed_tags?: str[], wanted_tags?: str[], time_estimate_ms?: int, reason?: str, force?: bool, attachments?: object[])` | Update task. Status/phase changes auto-manage ownership and trigger prompts. Include `attachments` to record commits/changelists. |
 | `delete(worker_id: worker_str, task: task_str, cascade?: bool, reason?: str, obliterate?: bool, force?: bool)` | Delete task. Soft delete by default; `obliterate=true` for permanent. |
 | `scan(task: task_str, before?: int, after?: int, above?: int, below?: int)` | Scan task graph in multiple directions. Depth: 0=none, N=levels, -1=all. |
@@ -326,6 +331,8 @@ Environment variables:
 | `project_history(from?: datetime_str, to?: datetime_str, states?: status_str[], limit?: int = 100)` | Project-wide history with date range filters. |
 | `log_metrics(worker_id: worker_str, task: task_str, cost_usd?: float, values?: int[8])` | Log metrics (aggregated). |
 | `get_metrics(task: task_str\|task_str[])` | Get metrics for task(s). |
+| `give_feedback(agent: str, target_agent?: str, category: str, sentiment: str, message: str, tool_name?: str, task_id?: str)` | Record feedback between agents (conditional on config). |
+| `list_feedback()` | List all recorded agent feedback. |
 
 ### File Coordination
 
@@ -352,6 +359,8 @@ Environment variables:
 | `query(sql: str, params?: str[], limit?: int = 100, format?: str)` | Execute read-only SQL. SELECT only. Requires permission. |
 | `get_schema(table?: str, include_sql?: bool)` | Get database schema. Returns table names, columns, types, and foreign keys. |
 | `list_workflows()` | List available workflow configurations (solo, swarm, relay, hierarchical, etc.). |
+| `list_skills()` | List available bundled skills with descriptions. |
+| `get_skill(name: str)` | Get full content of a bundled skill. |
 
 ## MCP Resources
 
@@ -507,6 +516,9 @@ Pre-built workflow topologies optimize for different coordination patterns:
 | `swarm` | Parallel generalists, pull-based | High throughput, independent tasks |
 | `relay` | Sequential specialists, handoffs | Complex tasks, domain expertise |
 | `hierarchical` | Lead/worker delegation | Large projects, team coordination |
+| `push` | Push-based task distribution topology | Centralized assignment, load balancing |
+| `kanban` | Board-style task management with WIP limits | Continuous flow, visual tracking |
+| `sprint` | Time-boxed iteration planning | Scrum teams, fixed cadence |
 
 Select a workflow on connect:
 
@@ -619,6 +631,8 @@ Worker B: mark_file("worker-b", "src/main.rs", "adding tests")
 | [WORKFLOW_TOPOLOGIES.md](docs/WORKFLOW_TOPOLOGIES.md) | Multi-agent workflow patterns (solo, swarm, relay, hierarchical) |
 | [EXPORT_IMPORT.md](docs/EXPORT_IMPORT.md) | Data export and import functionality |
 | [PROCESSES.md](docs/PROCESSES.md) | Release process, changelog maintenance |
+| [GATES.md](docs/GATES.md) | Workflow gate conditions and enforcement |
+| [METRICS.md](docs/METRICS.md) | Experiment metrics definitions and SQL examples |
 
 ## License