@luisarg/memory-mcp 0.1.0 → 0.1.1

package/cordis.patch.yml

@@ -3,6 +3,8 @@
 # defaults resuelven bajo el home del harness (cwd-independent):
 #   $DSH_HOME/memory-vault-server y $DSH_HOME/memory-vault (~/.dsh por defecto)
 - insert:
+    - id: memory-mcp-bootstrap
+      name: '@luisarg/memory-mcp'
     - id: memory-mcp
       name: '@deepseek-ai/dsh-mcp-client'
       config:

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { Context } from "@deepseek-ai/cordis";
 declare const name = "memory-mcp";
 interface Config {
   memoryPath: string;
+  serverDir: string;
 }
 declare const Config: Schema<Config>;
 declare function apply(ctx: Context, config: Config): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;cAMa,IAAA;UAEI,MAAA;EAFJ,UAAI,EAAA,MAAA;AAEjB;AAIa,cAAA,MAAe,EAAP,MAAA,CAAO,MAAD,CAAA;AAcX,iBAAA,KAAA,CAAW,GAAiB,EAAjB,OAAuB,EAAA,MAAA,EAAN,MAAM,CAAA,EAAA,IAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;cAOa,IAAA;UAEI,MAAA;EAFJ,UAAI,EAAA,MAAA;EAEA,SAAM,EAAA,MAAA;AAKvB;AA6BgB,cA7BH,MA6Bc,EA7BN,MA6BuB,CA7BhB,MA6BsB,CAAA;iBAAlC,KAAA,MAAW,iBAAiB"}

package/dist/index.js

@@ -1,24 +1,41 @@
-import { existsSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync } from "node:fs";
 import { homedir } from "node:os";
-import { isAbsolute, join } from "node:path";
+import { dirname, isAbsolute, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import Schema from "@deepseek-ai/schemastery";
 
 //#region src/index.ts
 const name = "memory-mcp";
-const Config = Schema.object({ memoryPath: Schema.string().default(process.env.DSH_MEMORY_PATH ?? "") });
-/**
-* Resolve the harness home the same way the harness does (`$DSH_HOME`, or
-* `~/.dsh`). Paths must never depend on the launch cwd: DSH does not chdir.
-*/
-function resolveMemoryPath(value) {
+const Config = Schema.object({
+	memoryPath: Schema.string().default(process.env.DSH_MEMORY_PATH ?? ""),
+	serverDir: Schema.string().default(process.env.DSH_MEMORY_SERVER_DIR ?? "")
+});
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+/** Harness home, resolved like the harness itself ($DSH_HOME, or ~/.dsh). */
+function dshHome() {
+	const env = process.env.DSH_HOME?.trim();
+	return env && env.length > 0 ? env : join(homedir(), ".dsh");
+}
+/** Absolute paths stay; empty/relative values resolve under the harness home. */
+function resolveUnderHome(value, segment) {
 	const v = value.trim();
-	if (v.length === 0) return join(process.env.DSH_HOME?.trim() || join(homedir(), ".dsh"), "memory-vault");
-	return isAbsolute(v) ? v : join(process.env.DSH_HOME?.trim() || join(homedir(), ".dsh"), v);
+	if (v.length === 0) return join(dshHome(), segment);
+	return isAbsolute(v) ? v : join(dshHome(), v);
+}
+/** Copy the bundled dir into `target` when `key` is missing there. */
+function ensure(target, bundled, key) {
+	if (existsSync(join(target, key))) return false;
+	if (!existsSync(bundled)) return false;
+	mkdirSync(target, { recursive: true });
+	cpSync(bundled, target, { recursive: true });
+	return true;
 }
 function apply(ctx, config) {
-	const memoryPath = resolveMemoryPath(config.memoryPath);
-	if (!existsSync(memoryPath)) console.warn(`[memory-mcp] vault not found at ${memoryPath} — it will be created on first use.`);
-	console.log(`[memory-mcp] MEMORY_PATH=${memoryPath}`);
+	const serverDir = resolveUnderHome(config.serverDir, "memory-vault-server");
+	const memoryPath = resolveUnderHome(config.memoryPath, "memory-vault");
+	if (ensure(serverDir, join(packageRoot, "server"), "server.py")) console.log(`[memory-mcp] installed memory-vault-server -> ${serverDir}`);
+	if (ensure(memoryPath, join(packageRoot, "vault"), "type-registry.yaml")) console.log(`[memory-mcp] installed vault starter -> ${memoryPath}`);
+	if (!existsSync(join(serverDir, "server.py"))) console.warn(`[memory-mcp] memory-vault-server not found at ${serverDir} and not bundled — set DSH_MEMORY_SERVER_DIR (or run \`node scripts/bundle-assets.mjs\` in a checkout)`);
 }
 
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Config: Schema<Config>"],"sources":["../src/index.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { isAbsolute, join } from 'node:path'\nimport type { Context } from '@deepseek-ai/cordis'\nimport Schema from '@deepseek-ai/schemastery'\n\nexport const name = 'memory-mcp'\n\nexport interface Config {\n  memoryPath: string\n}\n\nexport const Config: Schema<Config> = Schema.object({\n  memoryPath: Schema.string().default(process.env.DSH_MEMORY_PATH ?? ''),\n})\n\n/**\n * Resolve the harness home the same way the harness does (`$DSH_HOME`, or\n * `~/.dsh`). Paths must never depend on the launch cwd: DSH does not chdir.\n */\nfunction resolveMemoryPath(value: string): string {\n  const v = value.trim()\n  if (v.length === 0) return join((process.env.DSH_HOME?.trim() || join(homedir(), '.dsh')), 'memory-vault')\n  return isAbsolute(v) ? v : join(process.env.DSH_HOME?.trim() || join(homedir(), '.dsh'), v)\n}\n\nexport function apply(ctx: Context, config: Config) {\n  // This plugin is a placeholder; actual MCP wiring is via cordis.patch.yml\n  // dsh-mcp-client row. This module allows Config validation and logs.\n  const memoryPath = resolveMemoryPath(config.memoryPath)\n  if (!existsSync(memoryPath)) {\n    console.warn(`[memory-mcp] vault not found at ${memoryPath} — it will be created on first use.`)\n  }\n  console.log(`[memory-mcp] MEMORY_PATH=${memoryPath}`)\n}\n"],"mappings":";;;;;;AAMA,MAAa,OAAO;AAMpB,MAAaA,SAAyB,OAAO,OAAO,EAClD,YAAY,OAAO,QAAQ,CAAC,QAAQ,QAAQ,IAAI,mBAAmB,GAAG,EACvE,CAAC;;;;;AAMF,SAAS,kBAAkB,OAAuB;CAChD,MAAM,IAAI,MAAM,MAAM;AACtB,KAAI,EAAE,WAAW,EAAG,QAAO,KAAM,QAAQ,IAAI,UAAU,MAAM,IAAI,KAAK,SAAS,EAAE,OAAO,EAAG,eAAe;AAC1G,QAAO,WAAW,EAAE,GAAG,IAAI,KAAK,QAAQ,IAAI,UAAU,MAAM,IAAI,KAAK,SAAS,EAAE,OAAO,EAAE,EAAE;;AAG7F,SAAgB,MAAM,KAAc,QAAgB;CAGlD,MAAM,aAAa,kBAAkB,OAAO,WAAW;AACvD,KAAI,CAAC,WAAW,WAAW,CACzB,SAAQ,KAAK,mCAAmC,WAAW,qCAAqC;AAElG,SAAQ,IAAI,4BAA4B,aAAa"}
+{"version":3,"file":"index.js","names":["Config: Schema<Config>"],"sources":["../src/index.ts"],"sourcesContent":["import { cpSync, existsSync, mkdirSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { dirname, isAbsolute, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { Context } from '@deepseek-ai/cordis'\nimport Schema from '@deepseek-ai/schemastery'\n\nexport const name = 'memory-mcp'\n\nexport interface Config {\n  memoryPath: string\n  serverDir: string\n}\n\nexport const Config: Schema<Config> = Schema.object({\n  memoryPath: Schema.string().default(process.env.DSH_MEMORY_PATH ?? ''),\n  serverDir: Schema.string().default(process.env.DSH_MEMORY_SERVER_DIR ?? ''),\n})\n\nconst packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))\n\n/** Harness home, resolved like the harness itself ($DSH_HOME, or ~/.dsh). */\nfunction dshHome(): string {\n  const env = process.env.DSH_HOME?.trim()\n  return env && env.length > 0 ? env : join(homedir(), '.dsh')\n}\n\n/** Absolute paths stay; empty/relative values resolve under the harness home. */\nfunction resolveUnderHome(value: string, segment: string): string {\n  const v = value.trim()\n  if (v.length === 0) return join(dshHome(), segment)\n  return isAbsolute(v) ? v : join(dshHome(), v)\n}\n\n/** Copy the bundled dir into `target` when `key` is missing there. */\nfunction ensure(target: string, bundled: string, key: string): boolean {\n  if (existsSync(join(target, key))) return false\n  if (!existsSync(bundled)) return false\n  mkdirSync(target, { recursive: true })\n  cpSync(bundled, target, { recursive: true })\n  return true\n}\n\nexport function apply(ctx: Context, config: Config) {\n  const serverDir = resolveUnderHome(config.serverDir, 'memory-vault-server')\n  const memoryPath = resolveUnderHome(config.memoryPath, 'memory-vault')\n\n  // Self-contained install: first boot copies the bundled server and vault\n  // starter under the harness home when they are missing. Env-overridden\n  // paths are respected (never overwritten, never copied over).\n  if (ensure(serverDir, join(packageRoot, 'server'), 'server.py')) {\n    console.log(`[memory-mcp] installed memory-vault-server -> ${serverDir}`)\n  }\n  if (ensure(memoryPath, join(packageRoot, 'vault'), 'type-registry.yaml')) {\n    console.log(`[memory-mcp] installed vault starter -> ${memoryPath}`)\n  }\n  if (!existsSync(join(serverDir, 'server.py'))) {\n    console.warn(\n      `[memory-mcp] memory-vault-server not found at ${serverDir} and not bundled — ` +\n      'set DSH_MEMORY_SERVER_DIR (or run `node scripts/bundle-assets.mjs` in a checkout)',\n    )\n  }\n}\n"],"mappings":";;;;;;;AAOA,MAAa,OAAO;AAOpB,MAAaA,SAAyB,OAAO,OAAO;CAClD,YAAY,OAAO,QAAQ,CAAC,QAAQ,QAAQ,IAAI,mBAAmB,GAAG;CACtE,WAAW,OAAO,QAAQ,CAAC,QAAQ,QAAQ,IAAI,yBAAyB,GAAG;CAC5E,CAAC;AAEF,MAAM,cAAc,QAAQ,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,CAAC;;AAGpE,SAAS,UAAkB;CACzB,MAAM,MAAM,QAAQ,IAAI,UAAU,MAAM;AACxC,QAAO,OAAO,IAAI,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,OAAO;;;AAI9D,SAAS,iBAAiB,OAAe,SAAyB;CAChE,MAAM,IAAI,MAAM,MAAM;AACtB,KAAI,EAAE,WAAW,EAAG,QAAO,KAAK,SAAS,EAAE,QAAQ;AACnD,QAAO,WAAW,EAAE,GAAG,IAAI,KAAK,SAAS,EAAE,EAAE;;;AAI/C,SAAS,OAAO,QAAgB,SAAiB,KAAsB;AACrE,KAAI,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAE,QAAO;AAC1C,KAAI,CAAC,WAAW,QAAQ,CAAE,QAAO;AACjC,WAAU,QAAQ,EAAE,WAAW,MAAM,CAAC;AACtC,QAAO,SAAS,QAAQ,EAAE,WAAW,MAAM,CAAC;AAC5C,QAAO;;AAGT,SAAgB,MAAM,KAAc,QAAgB;CAClD,MAAM,YAAY,iBAAiB,OAAO,WAAW,sBAAsB;CAC3E,MAAM,aAAa,iBAAiB,OAAO,YAAY,eAAe;AAKtE,KAAI,OAAO,WAAW,KAAK,aAAa,SAAS,EAAE,YAAY,CAC7D,SAAQ,IAAI,iDAAiD,YAAY;AAE3E,KAAI,OAAO,YAAY,KAAK,aAAa,QAAQ,EAAE,qBAAqB,CACtE,SAAQ,IAAI,2CAA2C,aAAa;AAEtE,KAAI,CAAC,WAAW,KAAK,WAAW,YAAY,CAAC,CAC3C,SAAQ,KACN,iDAAiD,UAAU,wGAE5D"}

package/package.json

@@ -1,18 +1,43 @@
 {
   "name": "@luisarg/memory-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "DSH MCP client for the memory vault",
-  "repository": { "type": "git", "url": "git+https://github.com/Luisarg03/dsh-memory-vault.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Luisarg03/dsh-memory-vault.git"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "exports": { ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" } },
-  "files": ["dist/", "cordis.patch.yml"],
-  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } },
-  "scripts": { "build": "tsdown", "dev": "tsdown --watch", "test": "vitest run --passWithNoTests", "prepare": "tsdown" },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "cordis.patch.yml",
+    "server/",
+    "vault/"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run --passWithNoTests",
+    "prepare": "tsdown && node ../../scripts/bundle-assets.mjs"
+  },
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/schemastery": "3.18.1"
   },
-  "devDependencies": { "typescript": "^5.9.2", "tsdown": "^0.15.6" }
+  "devDependencies": {
+    "typescript": "^5.9.2",
+    "tsdown": "^0.15.6"
+  }
 }

package/server/__init__.py

@@ -0,0 +1 @@
+"""Memory store: SQLite + OKF Markdown for the DSH memory vault."""

package/server/cli.py

@@ -0,0 +1,27 @@
+"""Memory server CLI helpers (memory path resolution + storage validation)."""
+
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+
+def get_memory_path() -> Path:
+    """Return MEMORY_PATH from env, or default to `<project>/memory-vault/`."""
+    env = os.environ.get("MEMORY_PATH")
+    if env:
+        return Path(env)
+    return Path(__file__).resolve().parent.parent / "memory-vault"
+
+
+def validate_storage_path(path: str) -> None:
+    """Exit 1 with a clear message if `path` is missing or not a directory."""
+    p = Path(path)
+    if not p.exists():
+        print(f"ERROR: Memory storage path does not exist: {path}", file=sys.stderr)
+        print(f"  Run: mkdir -p {path}", file=sys.stderr)
+        sys.exit(1)
+    if not p.is_dir():
+        print(f"ERROR: Memory storage path is not a directory: {path}", file=sys.stderr)
+        sys.exit(1)

package/server/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "dsh-memory-vault-server"
+version = "0.1.0"
+description = "MCP server (SQLite FTS5 + markdown OKF) for dsh-memory-vault"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp>=1.2.0",
+    "PyYAML>=6.0",
+]
+
+# Virtual project: uv installs dependencies and runs scripts without
+# packaging this directory itself (no build backend needed).
+[tool.uv]
+package = false

package/server/registry.py

@@ -0,0 +1,141 @@
+"""Type registry loader — reads memory/type-registry.yaml and provides
+derived maps for store, server, and digest_session modules.
+"""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from pathlib import Path
+from typing import Any
+
+
+class RegistryValidationError(Exception):
+    """Raised when the type registry fails validation."""
+
+
+_REQUIRED_KEYS = ("name", "directory", "singular", "tool", "template", "extraction_hint")
+_RESERVED_DIRECTORIES = {"index.md", "log.md", ".obsidian"}
+
+
+def _validate_registry(types: list[dict[str, Any]]) -> None:
+    """Validate a parsed registry. Raises RegistryValidationError on failure."""
+    # Required keys
+    for t in types:
+        for key in _REQUIRED_KEYS:
+            if key not in t:
+                raise RegistryValidationError(
+                    f"missing required key {key!r} in type {t.get('name', '<unnamed>')}"
+                )
+
+    # Duplicate name
+    seen_names: set[str] = set()
+    for t in types:
+        n: str = t["name"]
+        if n in seen_names:
+            raise RegistryValidationError(f"duplicate name: {n!r}")
+        seen_names.add(n)
+
+    # Duplicate directory across project-attached types
+    seen_project_dirs: set[str] = set()
+    for t in types:
+        if t.get("project_attached", True) is True:
+            d: str = t["directory"]
+            if d in seen_project_dirs:
+                raise RegistryValidationError(
+                    f"duplicate directory for project-attached types: {d!r}"
+                )
+            seen_project_dirs.add(d)
+
+    # Reserved directory collision
+    for t in types:
+        d = t.get("directory", "")
+        if d in _RESERVED_DIRECTORIES:
+            raise RegistryValidationError(
+                f"directory {d!r} collides with reserved path"
+            )
+
+    # Empty extraction_hint on project-attached types
+    for t in types:
+        if t.get("project_attached", True) is True:
+            hint = t.get("extraction_hint")
+            if hint is None or (isinstance(hint, str) and hint == ""):
+                raise RegistryValidationError(
+                    f"empty extraction_hint on project-attached type {t.get('name')!r}"
+                )
+
+
+@lru_cache(maxsize=1)
+def load_type_registry(bundle_root: Path) -> list[dict[str, Any]]:
+    """Load and validate the type registry from bundle_root/type-registry.yaml.
+
+    Returns the list of type dicts. Raises RegistryValidationError on
+    validation failure. Uses @lru_cache so the file is read only once.
+    """
+    import yaml  # lazy import: only needed when loading the registry
+
+    registry_path = bundle_root / "type-registry.yaml"
+    if not registry_path.is_file():
+        raise RegistryValidationError(
+            f"registry file not found: {registry_path}"
+        )
+
+    raw = registry_path.read_text(encoding="utf-8")
+    try:
+        data = yaml.safe_load(raw)
+    except yaml.YAMLError as exc:
+        raise RegistryValidationError(f"YAML parse error: {exc}") from exc
+
+    if not isinstance(data, dict) or "types" not in data:
+        raise RegistryValidationError(
+            "registry must contain a top-level 'types' key"
+        )
+
+    types = data["types"]
+    if not isinstance(types, list) or len(types) == 0:
+        raise RegistryValidationError("'types' must be a non-empty list")
+
+    _validate_registry(types)
+    return types
+
+
+def build_type_maps(
+    types: list[dict[str, Any]],
+) -> dict[str, Any]:
+    """Derive the standard maps from a registry type list.
+
+    Returns a dict with keys:
+        valid_types: set of singular names
+        type_dir_map: singular -> directory
+        type_label_map: directory -> name (label)
+        dir_to_singular: directory -> singular
+        type_order: list of directory names in registry order (project-attached only)
+        extraction_types: list of dicts for types with non-null extraction_hint
+    """
+    valid_types: set[str] = set()
+    type_dir_map: dict[str, str] = {}
+    type_label_map: dict[str, str] = {}
+    dir_to_singular: dict[str, str] = {}
+    type_order: list[str] = []
+    extraction_types: list[dict[str, Any]] = []
+
+    for t in types:
+        singular = t["singular"]
+        directory = t["directory"]
+        name = t["name"]
+        valid_types.add(singular)
+        type_dir_map[singular] = directory
+        type_label_map[directory] = name
+        dir_to_singular[directory] = singular
+        if t.get("project_attached", True):
+            type_order.append(directory)
+        if t.get("extraction_hint") is not None:
+            extraction_types.append(t)
+
+    return {
+        "valid_types": valid_types,
+        "type_dir_map": type_dir_map,
+        "type_label_map": type_label_map,
+        "dir_to_singular": dir_to_singular,
+        "type_order": type_order,
+        "extraction_types": extraction_types,
+    }