harmony-mcp 1.13.3 → 1.14.1

package/README.md

@@ -5,7 +5,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor, Windsurf) to intera
 
 ## Features
 
-- **43+ MCP Tools** for full board control, knowledge graph, and workflow plans
+- **60+ MCP Tools** for full board control, knowledge graph, and workflow plans
 - **Knowledge Graph Memory** - persistent memory with entity types, tiers, scopes, and typed relations
 - **Active Learning** - auto-extracts lessons, solutions, and error patterns from completed work sessions
 - **Context Assembly** - token-budget-aware memory injection into AI prompts
@@ -13,6 +13,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor, Windsurf) to intera
 - **Card Linking** - create relationships between cards (blocks, relates_to, duplicates, is_part_of)
 - **Prompt Builder** - generate AI-ready prompts from cards with context
 - **Agent Session Tracking** - track work progress with timer badges
+- **Auto-Session Detection** - automatically starts/ends sessions when agents interact with cards
 - **Auto-Assignment** - automatically assign cards to you when starting agent sessions
 - **Memory Sync** - bidirectional sync between local markdown files and remote database
 - **Multi-Agent Support** - works with Claude Code, Codex, Cursor, Windsurf
@@ -89,7 +90,7 @@ If you prefer to configure manually (e.g., in Claude.ai's UI):
 1. Get an API key from [Harmony](https://gethmy.com/user/keys)
 2. In Claude.ai, add a remote MCP server with URL `https://mcp.gethmy.com/mcp`
 3. Set the Authorization header to `Bearer hmy_your_key_here`
-4. All 43+ Harmony tools become available in your conversation
+4. All 60+ Harmony tools become available in your conversation
 
 **Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
 
@@ -167,6 +168,8 @@ When you start working on a card (e.g., `/hmy #42`):
 - `harmony_create_card` - Create a new card
 - `harmony_update_card` - Update card properties
 - `harmony_move_card` - Move card to different column (auto-ends agent session on move to done/review)
+- `harmony_archive_card` - Archive a card (soft-delete, can be restored)
+- `harmony_unarchive_card` - Restore an archived card back to the board
 - `harmony_delete_card` - Delete a card
 - `harmony_assign_card` - Assign to team member
 - `harmony_search_cards` - Search by title/description
@@ -209,7 +212,7 @@ When you start working on a card (e.g., `/hmy #42`):
 
 - `harmony_list_workspaces` - List workspaces
 - `harmony_list_projects` - List projects
-- `harmony_get_board` - Get board state (supports pagination via `limit`/`offset`, `summary` mode, `columnId` filter)
+- `harmony_get_board` - Get board state (supports pagination via `limit`/`offset`, `summary` mode, `columnId` filter, `includeArchived`)
 - `harmony_get_workspace_members` - Get team members
 - `harmony_set_workspace_context` - Set active workspace
 - `harmony_set_project_context` - Set active project
@@ -226,6 +229,19 @@ When you start working on a card (e.g., `/hmy #42`):
 - `harmony_end_agent_session` - End session (completed/paused); triggers active learning extraction
 - `harmony_get_agent_session` - Get current session state
 
+### Auto-Session Detection
+
+Sessions are automatically started when agents call card-mutating tools without an explicit `harmony_start_agent_session`. This ensures work is always tracked, even when agents don't explicitly manage sessions.
+
+**Trigger tools:** `harmony_generate_prompt`, `harmony_update_card`, `harmony_move_card`, `harmony_create_subtask`, `harmony_toggle_subtask`, `harmony_add_label_to_card`, `harmony_remove_label_from_card`
+
+**Behavior:**
+- Auto-starts a session when any trigger tool is called on a card without an active session
+- Auto-ends after 10 minutes of inactivity
+- Switching to a different card auto-ends the previous auto-session
+- Explicitly started sessions (via `harmony_start_agent_session`) are never auto-ended
+- Auto-ended sessions trigger the full active learning pipeline
+
 ### Prompt Generation
 
 - `harmony_generate_prompt` - Generate an AI-ready prompt from a card with assembled memory context
@@ -256,7 +272,7 @@ Store and retrieve persistent knowledge across sessions. Memories have types, ti
 - `harmony_memory_search` - Full-text search across the knowledge base
 - `harmony_relate` - Create a typed relationship between two memory entities
 
-**Entity Types:** `agent`, `task`, `decision`, `context`, `pattern`, `error`, `solution`, `preference`, `relationship`, `commitment`, `lesson`, `project`, `handoff`
+**Entity Types:** `agent`, `task`, `decision`, `context`, `pattern`, `error`, `solution`, `preference`, `relationship`, `commitment`, `lesson`, `project`, `handoff`, `procedure`
 
 **Memory Tiers:** `draft` (working notes) → `episode` (session summaries) → `reference` (durable knowledge)
 
@@ -274,13 +290,9 @@ Store and retrieve persistent knowledge across sessions. Memories have types, ti
 
 - `harmony_promote_memory` - Promote entity tier: `draft` → `episode` or `episode` → `reference`
 - `harmony_prune_draft` - Remove stale draft memories (dry-run mode by default)
-
-### Active Learning & Review
-
-When an agent session ends, the system auto-extracts learnings: blockers produce `error` entities, completed sessions produce `lesson` entities, and bug fixes produce `solution` entities. Lower-confidence entries go into a review queue.
-
-- `harmony_review_learnings` - List pending auto-extracted memories awaiting review
-- `harmony_approve_learning` - Approve or reject a pending learning
+- `harmony_consolidate_memories` - Cluster similar draft/episode memories and merge into reference entities (dry-run by default)
+- `harmony_backfill_embeddings` - Generate vector embeddings for entities missing them
+- `harmony_backfill_relations` - Retroactively create semantic relations across existing entities
 
 ### Context Debugging
 
@@ -292,6 +304,7 @@ When an agent session ends, the system auto-extracts learnings: blockers produce
 
 Create and manage project plans with a phased workflow: **plan** → **execute** → **verify** → **done**.
 
+- `harmony_list_plans` - List plans in a project (filter by status or workflow phase)
 - `harmony_create_plan` - Create a new plan with embedded tasks
 - `harmony_get_plan` - Get plan by ID or card ID
 - `harmony_update_plan` - Update plan title, content, status, or phase
@@ -300,6 +313,15 @@ Create and manage project plans with a phased workflow: **plan** → **execute**
   - **execute → verify:** checks card completion status
   - **verify → done:** archives plan, creates memory entities
 
+### Onboarding & Account
+
+- `harmony_onboard` - Complete end-to-end onboarding: signup → workspace → project → API key
+- `harmony_signup` - Create a new user account
+- `harmony_create_workspace` - Create a new workspace
+- `harmony_create_project` - Create a new project with template columns (kanban, scrum, or simple)
+- `harmony_send_invitations` - Send workspace invitations to team members
+- `harmony_generate_api_key` - Generate an API key for the authenticated user
+
 ## Direct API Access
 
 You can also call the Harmony API directly from any HTTP client: