@gethmy/mcp 2.5.0 → 2.5.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -20
- package/dist/cli.js +1396 -32545
- package/dist/index.js +970 -28746
- package/dist/lib/api-client.js +11 -0
- package/package.json +3 -2
- package/src/api-client.ts +51 -0
- package/src/server.ts +66 -2
- package/src/skills.ts +67 -485
- package/src/tui/setup.ts +57 -40
- package/dist/http.js +0 -1959
- package/dist/remote.js +0 -32328
- package/dist/server.js +0 -31967
- package/src/__tests__/auto-session.test.ts +0 -912
- package/src/__tests__/graph-expansion.test.ts +0 -285
- package/src/__tests__/integration-memory-crud.test.ts +0 -948
- package/src/__tests__/integration-memory-system.test.ts +0 -321
- package/src/__tests__/mcp-integration.test.ts +0 -141
- package/src/__tests__/memory-floor.test.ts +0 -126
- package/src/__tests__/memory-park.test.ts +0 -213
- package/src/__tests__/memory-session.test.ts +0 -77
- package/src/__tests__/prompt-builder.test.ts +0 -739
- package/src/__tests__/remote-routing.test.ts +0 -285
- package/src/__tests__/skills.test.ts +0 -111
- package/src/__tests__/tool-dispatch.test.ts +0 -260
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
|
|
|
5
5
|
|
|
6
6
|
## Features
|
|
7
7
|
|
|
8
|
-
- **
|
|
8
|
+
- **56 MCP Tools** for full board control, knowledge graph, and workflow plans
|
|
9
9
|
- **Knowledge Graph Memory** - persistent memory with entity types, tiers, scopes, and typed relations
|
|
10
10
|
- **Active Learning** - auto-extracts lessons, solutions, and error patterns from completed work sessions
|
|
11
11
|
- **Context Assembly** - token-budget-aware memory injection into AI prompts
|
|
@@ -95,7 +95,7 @@ If you prefer to configure manually (e.g., in Claude.ai's UI):
|
|
|
95
95
|
1. Get an API key from [Harmony](https://gethmy.com/user/keys)
|
|
96
96
|
2. In Claude.ai, add a remote MCP server with URL `https://mcp.gethmy.com/mcp`
|
|
97
97
|
3. Set the Authorization header to `Bearer hmy_your_key_here`
|
|
98
|
-
4. All
|
|
98
|
+
4. All 56 Harmony tools become available in your conversation
|
|
99
99
|
|
|
100
100
|
**Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
|
|
101
101
|
|
|
@@ -316,23 +316,6 @@ Store and retrieve persistent knowledge across sessions. Memories have types, ti
|
|
|
316
316
|
- `harmony_resolve_links` - Batch-scan for `[[wiki-links]]` and auto-create relations
|
|
317
317
|
- `harmony_sync` - Bidirectional sync between local markdown files (`~/.harmony/memory/`) and remote database (directions: `pull`, `push`, `full`)
|
|
318
318
|
|
|
319
|
-
### Memory Lifecycle
|
|
320
|
-
|
|
321
|
-
- `harmony_promote_memory` - Promote entity tier: `draft` → `episode` or `episode` → `reference`
|
|
322
|
-
- `harmony_prune_draft` - Remove stale draft memories (dry-run mode by default)
|
|
323
|
-
- `harmony_consolidate_memories` - Cluster similar draft/episode memories and merge into reference entities (dry-run by default)
|
|
324
|
-
- `harmony_backfill_embeddings` - Generate vector embeddings for entities missing them
|
|
325
|
-
- `harmony_backfill_relations` - Retroactively create semantic relations across existing entities
|
|
326
|
-
- `harmony_cleanup_memories` - Bulk cleanup helper: flag stale drafts, dedupe boilerplate, trim low-value entries
|
|
327
|
-
- `harmony_audit_memories` - Surface low-confidence or low-quality memories for human review
|
|
328
|
-
- `harmony_purge_memories` - Hard-delete archived or flagged memories (dry-run by default)
|
|
329
|
-
|
|
330
|
-
### Context Debugging
|
|
331
|
-
|
|
332
|
-
- `harmony_get_context_manifest` - Debug what memories were loaded/excluded in a prompt assembly
|
|
333
|
-
- `harmony_debug_context` - Explain why a specific memory was or wasn't included (relevance score breakdown)
|
|
334
|
-
- `harmony_export_memory_graph` - Export knowledge graph as DOT format for Graphviz visualization
|
|
335
|
-
|
|
336
319
|
### GSD Workflow Plans
|
|
337
320
|
|
|
338
321
|
Create and manage project plans with a phased workflow: **plan** → **execute** → **verify** → **done**.
|
|
@@ -526,7 +509,7 @@ Three test files pin the contract every MCP client depends on. They are mandator
|
|
|
526
509
|
|
|
527
510
|
| File | What it pins |
|
|
528
511
|
|---|---|
|
|
529
|
-
| `src/__tests__/skills.test.ts` | `buildSkillFile`
|
|
512
|
+
| `src/__tests__/skills.test.ts` | `buildSkillFile` renderer contract: version-marker injection, body trimming, version-parse edge cases. Fed by `FetchedSkill` fixtures (DB-backed via `/v1/skills` post-#162 Phase 0). |
|
|
530
513
|
| `src/__tests__/tool-dispatch.test.ts` | `TOOLS` registry shape, name uniqueness + `harmony_*` namespace, `inputSchema` validity, handler routing via `registerHandlers`, tool ↔ skill namespace boundary. |
|
|
531
514
|
| `src/__tests__/mcp-integration.test.ts` | End-to-end `Client ↔ Server` round-trip over `InMemoryTransport` — `listTools`, `callTool`, `listResources`, `readResource`, plus error paths. |
|
|
532
515
|
|