@origintrail-official/dkg-mcp 10.0.0 → 10.0.1

package/README.md

@@ -21,7 +21,7 @@ dkg mcp setup                                # one-shot: init + start + fund + r
 4. Detects each MCP-aware client by its config file and writes the canonical entry. **You confirm per detected client interactively** (`Register DKG MCP with <client>? [Y/n]`) unless `--yes` is passed; non-TTY invocations (CI, piped stdin) auto-confirm so scripts don't hang. The detection set is seven clients: **Cursor** (`~/.cursor/mcp.json`), **Claude Code** (`~/.claude.json`), **Claude Desktop** (per-platform — `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows, `$XDG_CONFIG_HOME/Claude/claude_desktop_config.json` (or `~/.config/Claude/...` when XDG_CONFIG_HOME is unset) on Linux), **Windsurf** (`~/.codeium/windsurf/mcp_config.json`), **VSCode + GitHub Copilot Chat** (per-platform Code user-settings dir + `mcp.json` — note this client uses the `servers.dkg` shape, not `mcpServers.dkg`), **Cline** (deep-nested under VSCode's per-extension globalStorage at `Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`), and **Codex CLI** (`~/.codex/config.toml` — TOML format, table key `mcp_servers.dkg`). The clients receive the same canonical entry, serialized into each client's native format
 5. Verifies the daemon is healthy
 
-Every step short-circuits when its work is already done, so re-running on a set-up box is safe. Step-skip flags: `--no-start`, `--no-fund`, `--no-verify`, `--dry-run` (preview only), `--force` (refresh every detected client config regardless of state), `--yes` (auto-confirm per-client registrations; default false — TTY mode prompts interactively, non-TTY auto-confirms; pass `--yes` in scripts for the safer scripted-environment posture). First-init overrides: `--port <n>`, `--name <s>`. The bundled flow re-uses the same primitives `dkg openclaw setup` does, so the two verbs stay byte-aligned on network defaults, daemon-readiness probes, faucet retry/back-off, and manual-curl fallback.
+Every step short-circuits when its work is already done, so re-running on a set-up box is safe. Step-skip flags: `--no-start`, `--no-fund`, `--no-verify`, `--dry-run` (preview only), `--force` (refresh every detected client config regardless of state), `--yes` (auto-confirm per-client registrations; default false — TTY mode prompts interactively, non-TTY auto-confirms; pass `--yes` in scripts for the safer scripted-environment posture). First-init overrides: `--port <n>`, `--name <s>`, `--network <name>` (`mainnet-gnosis` default \| `mainnet-base` \| `testnet`; persisted as `config.networkConfig`; applies to a FRESH node only — an existing node keeps its current network, switch with `dkg init --network`). The bundled flow re-uses the same primitives `dkg openclaw setup` does, so the two verbs stay byte-aligned on network defaults, daemon-readiness probes, faucet retry/back-off, and manual-curl fallback.
 
 The canonical entry written into each client's config (paths shown POSIX-style; Windows users see equivalent Windows-absolute paths):
 
@@ -287,7 +287,7 @@ Per-turn state is kept in `~/.cache/dkg-mcp/sessions/*.json`; safe to delete at
 - **`tools/list` is missing tools after `dkg mcp setup`** → the client's MCP config still points at a prior install. Re-run `dkg mcp setup --force` to refresh stale entries.
 - **Daemon unreachable** → `dkg status`; if it errors, `dkg logs` and `cat ~/.dkg/daemon.log`. Stale pid → `cat ~/.dkg/daemon.pid` and kill it, then `dkg start` again.
 - **Port 9200 already in use** → another node is running. `dkg stop` once, or override via `dkg init` and pick a different API port.
-- **WSL2: daemon dies when the terminal closes** → wrap in `tmux` or install as a systemd user service. See the [WSL2 section in JOIN_TESTNET.md](../../docs/setup/JOIN_TESTNET.md) for the systemd unit file.
+- **WSL2: daemon dies when the terminal closes** → wrap in `tmux` or install as a systemd user service. See the [WSL2 section in JOIN_TESTNET.md](../../docs/archive/internal/setup/JOIN_TESTNET.md) for the systemd unit file.
 - **WSL2: Windows-side MCP clients (Claude Desktop, Cursor, VSCode + Copilot, Cline, Windsurf)** → run `dkg mcp setup` from **PowerShell**, not from inside WSL. Setup invoked from WSL detects the Windows-side configs and writes entries into them, but the registered `command` is the Linux-side `node` binary path; Win32 clients can't spawn Linux executables, so the entries fail at MCP startup. For **Linux-side** clients (Linux Cursor, Linux Claude Code), run setup from inside WSL as normal. End-to-end Windows-side support from a WSL invocation is tracked separately (will use a `wsl.exe`-wrapper command form once shipped).
 
 ## Package layout

package/dist/manifest/schema.d.ts

@@ -78,12 +78,12 @@ export declare const TemplateEntitySchema: z.ZodObject<{
     text: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     uri: string;
-    encodingFormat: string;
     text: string;
+    encodingFormat: string;
 }, {
     uri: string;
-    encodingFormat: string;
     text: string;
+    encodingFormat: string;
 }>;
 export type TemplateEntity = z.infer<typeof TemplateEntitySchema>;
 /** The composed manifest, after dereferencing all template entities. */
@@ -103,12 +103,12 @@ export declare const ProjectManifestSchema: z.ZodObject<{
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }>>;
     cursorHooksTemplate: z.ZodOptional<z.ZodObject<{
         uri: z.ZodString;
@@ -116,12 +116,12 @@ export declare const ProjectManifestSchema: z.ZodObject<{
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }>>;
     claudeHooksTemplate: z.ZodOptional<z.ZodObject<{
         uri: z.ZodString;
@@ -129,12 +129,12 @@ export declare const ProjectManifestSchema: z.ZodObject<{
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }>>;
     configTemplate: z.ZodOptional<z.ZodObject<{
         uri: z.ZodString;
@@ -142,12 +142,12 @@ export declare const ProjectManifestSchema: z.ZodObject<{
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }>>;
     agentsMd: z.ZodOptional<z.ZodObject<{
         uri: z.ZodString;
@@ -155,18 +155,18 @@ export declare const ProjectManifestSchema: z.ZodObject<{
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }, {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
     uri: string;
     contextGraphId: string;
-    supportedTools: ("cursor" | "claude-code")[];
     network: "testnet" | "mainnet" | "devnet";
+    supportedTools: ("cursor" | "claude-code")[];
     title?: string | undefined;
     requiresMcpDkgVersion?: string | undefined;
     publishedBy?: string | undefined;
@@ -174,34 +174,34 @@ export declare const ProjectManifestSchema: z.ZodObject<{
     ontologyUri?: string | undefined;
     cursorRule?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     cursorHooksTemplate?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     claudeHooksTemplate?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     configTemplate?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     agentsMd?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
 }, {
     uri: string;
     contextGraphId: string;
-    supportedTools: ("cursor" | "claude-code")[];
     network: "testnet" | "mainnet" | "devnet";
+    supportedTools: ("cursor" | "claude-code")[];
     title?: string | undefined;
     requiresMcpDkgVersion?: string | undefined;
     publishedBy?: string | undefined;
@@ -209,28 +209,28 @@ export declare const ProjectManifestSchema: z.ZodObject<{
     ontologyUri?: string | undefined;
     cursorRule?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     cursorHooksTemplate?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     claudeHooksTemplate?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     configTemplate?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
     agentsMd?: {
         uri: string;
-        encodingFormat: string;
         text: string;
+        encodingFormat: string;
     } | undefined;
 }>;
 export type ProjectManifest = z.infer<typeof ProjectManifestSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@origintrail-official/dkg-mcp",
-  "version": "10.0.0",
+  "version": "10.0.1",
   "description": "MCP server that exposes the local DKG daemon (projects, sub-graphs, activity, chat) to Cursor, Claude Code, and any other MCP-aware coding assistant.",
   "type": "module",
   "main": "dist/index.js",

package/dist/tools/annotations.d.ts

@@ -1,33 +0,0 @@
-/**
- * Phase 7 — Agent-emitted graph annotations + project ontology.
- *
- * Two MCP tools:
- *
- *   - `dkg_get_ontology`     — fetches the project's ontology.ttl + agent
- *                              guide markdown so the agent has the
- *                              conventions in working context.
- *   - `dkg_annotate_turn`    — batch-emits structured triples ABOUT a
- *                              chat turn: topics, mentions, examines,
- *                              proposes, concludes, asks, plus sugared
- *                              writes for proposedDecisions /
- *                              proposedTasks / comments / vmPublishRequests.
- *
- * `dkg_annotate_turn` is the main "annotate every substantive turn"
- * surface. Its sister tool `dkg_get_ontology` keeps the agent honest
- * about which predicates and URI patterns the project uses.
- */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { DkgClient } from '../client.js';
-import type { DkgConfig } from '../config.js';
-export declare function normaliseSlug(input: string): string;
-/**
- * Wrap a bare string as a URI if it doesn't already look like one.
- *
- * Returns null when the label slugifies to empty (blank input, pure
- * punctuation, stopword-only) so the caller can skip the reference
- * instead of persisting a malformed `urn:dkg:concept:` URI in the
- * graph. See `normaliseSlug` for the slug rules.
- */
-export declare function toUri(maybeUri: string, defaultType?: string): string | null;
-export declare function registerAnnotationTools(server: McpServer, client: DkgClient, config: DkgConfig): void;
-//# sourceMappingURL=annotations.d.ts.map

package/dist/tools/annotations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/tools/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA8D9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWnD;AAeD;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,SAAY,GAAG,MAAM,GAAG,IAAI,CAY9E;AA4CD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CA6XN"}