@gethmy/mcp 2.5.4 → 2.5.5

package/README.md

@@ -6,9 +6,8 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
 ## Features
 
 - **56 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
+- **4 Global Skills** — `/hmy`, `/hmy-plan`, `/hmy-cleanup`, `/hmy-standup`, served from the DB-backed [skill hub](../../docs/skills.md) with auto-update and admin-managed versioning
+- **Knowledge Graph Memory** — Phase 1 surface: hybrid retrieval (vector + lexical + RRF), session-scoped working memory, activity feed. See [docs/memory.md](../../docs/memory.md)
 - **GSD Workflow Plans** - plan/execute/verify/done lifecycle with auto card creation
 - **Card Linking** - create relationships between cards (blocks, relates_to, duplicates, is_part_of)
 - **Prompt Builder** - generate AI-ready prompts from cards with context
@@ -16,7 +15,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
 - **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
+- **Multi-Agent Support** - works with Claude Code, Codex, Cursor, Claude.ai
 - **Smart Setup** - one command configures everything
 - **API Key Authentication** - no database credentials required
 
@@ -155,6 +154,10 @@ npx @gethmy/mcp serve              # Start MCP server
 
 ## Skills
 
+Four global skills ship with the MCP server and are installed automatically by `npx @gethmy/mcp setup`. They live in the `skill_resource` Postgres table, are fetched via `GET /v1/skills/<name>`, and render-time composed with a shared auto-update preamble.
+
+For the full skill hub architecture (storage, versioning, auto-update, admin management), see [docs/skills.md](../../docs/skills.md).
+
 ### `/hmy` — Card Workflow
 
 When you start working on a card (e.g., `/hmy #42`):
@@ -191,6 +194,18 @@ A single command for both creating and executing plans. It auto-detects intent b
 3. Offers options: create single card, create multiple cards, analyze only, or skip
 4. Creates cards and advances the plan phase
 
+### `/hmy-cleanup` — Board Audit
+
+Scans the board for stale cards — long-idle, missing owners, or stuck in review — and proposes cleanup actions. Read-only by default; opt-in to apply suggestions.
+
+### `/hmy-standup` — Daily Summary
+
+Generates a structured standup summary: what shipped, what's in progress, what's blocked, and where agents need input. Pulls from card activity, plan progress, and the memory activity feed.
+
+### Auto-Update
+
+Every skill ships with an `hmy-update-check` preamble that fires on invocation. It compares local versions against `/v1/skills/version` and prompts (or silently auto-installs, if `~/.hmy/config.yaml` has `auto_upgrade: true`). Snooze levels: 24h / 48h / 7d.
+
 ## Available Tools
 
 ### Card Operations

package/dist/cli.js

@@ -1321,11 +1321,6 @@ class HarmonyApiClient {
   async fetchSkill(name) {
     return this.request("GET", `/skills/${encodeURIComponent(name)}`);
   }
-  async recordSkillInvocation(name) {
-    try {
-      await this.request("POST", "/skills/telemetry", { name });
-    } catch {}
-  }
   async listWorkspaces() {
     return this.request("GET", "/workspaces");
   }
@@ -3667,7 +3662,6 @@ function registerHandlers(server, deps) {
         throw new Error(`Cannot read skill "${name}": Harmony MCP server is not configured. Run \`hmy-mcp setup\`.`);
       }
       const client3 = deps.getClient();
-      client3.recordSkillInvocation(name);
       const fetched = await client3.fetchSkill(name);
       return {
         contents: [

package/dist/index.js

@@ -1317,11 +1317,6 @@ class HarmonyApiClient {
   async fetchSkill(name) {
     return this.request("GET", `/skills/${encodeURIComponent(name)}`);
   }
-  async recordSkillInvocation(name) {
-    try {
-      await this.request("POST", "/skills/telemetry", { name });
-    } catch {}
-  }
   async listWorkspaces() {
     return this.request("GET", "/workspaces");
   }
@@ -3663,7 +3658,6 @@ function registerHandlers(server, deps) {
         throw new Error(`Cannot read skill "${name}": Harmony MCP server is not configured. Run \`hmy-mcp setup\`.`);
       }
       const client3 = deps.getClient();
-      client3.recordSkillInvocation(name);
       const fetched = await client3.fetchSkill(name);
       return {
         contents: [

package/dist/lib/api-client.js

@@ -924,11 +924,6 @@ class HarmonyApiClient {
   async fetchSkill(name) {
     return this.request("GET", `/skills/${encodeURIComponent(name)}`);
   }
-  async recordSkillInvocation(name) {
-    try {
-      await this.request("POST", "/skills/telemetry", { name });
-    } catch {}
-  }
   async listWorkspaces() {
     return this.request("GET", "/workspaces");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/mcp",
-  "version": "2.5.4",
+  "version": "2.5.5",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "publishConfig": {
     "access": "public"

package/src/api-client.ts

@@ -358,27 +358,6 @@ export class HarmonyApiClient {
     return this.request("GET", `/skills/${encodeURIComponent(name)}`);
   }
 
-  /**
-   * POST /v1/skills/telemetry — fire-and-forget activation signal.
-   * Called from the ReadResourceRequest handler when an agent reads
-   * a harmony://skills/<name> resource. Increments invocation_count +
-   * sets last_used = now() on the matching skill_resource row.
-   *
-   * Best-effort: returns void; never throws. If the endpoint doesn't
-   * exist yet (pre-Phase-2 backend), or the network is flaky, the
-   * activation is dropped silently. The skill content read itself
-   * is NOT gated on this call succeeding.
-   */
-  async recordSkillInvocation(name: string): Promise<void> {
-    try {
-      await this.request("POST", "/skills/telemetry", { name });
-    } catch {
-      // Fire-and-forget: any failure (404 if endpoint not deployed yet,
-      // 401 if API key rotated, network timeout) is swallowed so the
-      // caller can proceed with serving content.
-    }
-  }
-
   // ============ WORKSPACE OPERATIONS ============
 
   async listWorkspaces(): Promise<{ workspaces: unknown[] }> {

package/src/server.ts

@@ -1533,9 +1533,7 @@ export const RESOURCES = [
 /**
  * Build the dynamic resource list. Skill resources (harmony://skills/<name>)
  * are derived at request time from /v1/skills/version so the list always
- * matches what the agent will get on read. Phase 1 of card #162 — the
- * ReadResourceRequest on harmony://skills/<name> is the activation signal
- * for skill telemetry.
+ * matches what the agent will get on read.
  *
  * Offline / unauthenticated → returns just the static RESOURCES. Agents
  * that can't reach the API still see the context resource and any error
@@ -1716,11 +1714,7 @@ export function registerHandlers(server: Server, deps: ToolDeps): void {
       };
     }
 
-    // harmony://skills/<name> — Phase 1 of card #162. This read IS the
-    // activation event: agent matched the skill's description, harness
-    // calls ReadResource, we fire fire-and-forget telemetry before
-    // returning the body. recordSkillInvocation() swallows all errors
-    // so a telemetry outage never blocks skill delivery.
+    // harmony://skills/<name> — serve the rendered SKILL.md.
     const SKILL_URI_RE = /^harmony:\/\/skills\/([a-z0-9][a-z0-9-]*[a-z0-9])$/;
     const skillMatch = uri.match(SKILL_URI_RE);
     if (skillMatch) {
@@ -1731,10 +1725,6 @@ export function registerHandlers(server: Server, deps: ToolDeps): void {
         );
       }
       const client = deps.getClient();
-      // Fire-and-forget BEFORE awaiting the content fetch so a slow
-      // telemetry endpoint never delays skill delivery. The promise
-      // is intentionally dropped (caught inside recordSkillInvocation).
-      void client.recordSkillInvocation(name);
       const fetched = await client.fetchSkill(name);
       return {
         contents: [