@cairnkeep/cli 1.1.0 → 1.1.2

package/schemas/cairnkeep-overlay.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/cairnkeep/cairnkeep/main/schemas/cairnkeep-overlay.schema.json",
+  "title": "Cairnkeep distribution profile",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "name", "version", "core", "policy", "bootstrap"],
+  "properties": {
+    "schemaVersion": {"const": 1},
+    "id": {"type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$"},
+    "name": {"type": "string", "minLength": 1, "maxLength": 120},
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$"
+    },
+    "core": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package", "version"],
+      "properties": {
+        "package": {"const": "@cairnkeep/cli"},
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$"
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["memory", "rag", "gitProvider"],
+      "properties": {
+        "memory": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["transport", "storage"],
+          "properties": {
+            "transport": {"enum": ["stdio", "http"]},
+            "storage": {"enum": ["local", "remote"]},
+            "baseDir": {"type": "string", "minLength": 1},
+            "endpoint": {"type": "string", "format": "uri"}
+          },
+          "allOf": [
+            {
+              "if": {"properties": {"storage": {"const": "local"}}},
+              "then": {"required": ["baseDir"]}
+            },
+            {
+              "if": {"properties": {"storage": {"const": "remote"}}},
+              "then": {"required": ["endpoint"]}
+            }
+          ]
+        },
+        "rag": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode"],
+          "properties": {
+            "mode": {"enum": ["disabled", "local", "remote"]},
+            "baseUrl": {"type": "string", "format": "uri"}
+          },
+          "if": {"properties": {"mode": {"enum": ["local", "remote"]}}},
+          "then": {"required": ["baseUrl"]}
+        },
+        "gitProvider": {"type": "string", "minLength": 1}
+      }
+    },
+    "bootstrap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["defaultMode", "launcher", "profileLock"],
+      "properties": {
+        "defaultMode": {"enum": ["tracked", "untracked"]},
+        "launcher": {"type": "string", "minLength": 1},
+        "profileLock": {"type": "string", "minLength": 1}
+      }
+    }
+  }
+}

package/scripts/probe-memory-server.mjs

@@ -1,13 +1,21 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
 
-const serverPath = process.argv[2];
-if (!serverPath) {
-  console.error("usage: probe-memory-server.mjs PATH_TO_SERVER");
+const probeArgs = process.argv.slice(2);
+if (probeArgs.length === 0) {
+  console.error("usage: probe-memory-server.mjs PATH_TO_SERVER | --command COMMAND [ARGS...]");
   process.exit(2);
 }
 
-const child = spawn(process.execPath, [serverPath], {
+const commandMode = probeArgs[0] === "--command";
+const command = commandMode ? probeArgs[1] : process.execPath;
+const commandArgs = commandMode ? probeArgs.slice(2) : [probeArgs[0]];
+if (!command) {
+  console.error("probe-memory-server.mjs: --command requires a command");
+  process.exit(2);
+}
+
+const child = spawn(command, commandArgs, {
   env: process.env,
   stdio: ["pipe", "pipe", "pipe"],
 });
@@ -29,7 +37,11 @@ const response = new Promise((resolve, reject) => {
       if (!line.trim()) continue;
       try {
         const message = JSON.parse(line);
-        if (message.id === 1 && message.result?.serverInfo?.name === "cairn-memory") {
+        if (
+          message.id === 1 &&
+          message.result?.serverInfo?.name === "cairn-memory" &&
+          message.result?.capabilities?.tools
+        ) {
           resolve();
           return;
         }

package/scripts/smoke-mcp-boot.sh

@@ -5,35 +5,28 @@
 # transport works. This is the core product path, and nothing else tests it
 # after packaging/installation.
 #
-# Prefers `cairn memory-server` (a global install), else falls back to node on
-# the repo's dist build — so it works both post-install and from a clone.
+# Prefers `cairn memory-server` (a global install), else falls back to the
+# repository build. The Node probe owns the timeout so this works on macOS,
+# which does not ship GNU `timeout`.
 set -uo pipefail
 
 ROOT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
 
 if command -v cairn >/dev/null 2>&1; then
-  server=(cairn memory-server)
+  probe=(node "$ROOT_DIR/scripts/probe-memory-server.mjs" --command cairn memory-server)
 elif [[ -f "$ROOT_DIR/mcp-memory-server/dist/index.js" ]]; then
-  server=(node "$ROOT_DIR/mcp-memory-server/dist/index.js")
+  probe=(node "$ROOT_DIR/scripts/probe-memory-server.mjs" "$ROOT_DIR/mcp-memory-server/dist/index.js")
 else
   echo "smoke-mcp-boot: FAIL (no cairn on PATH and no dist build to run)"
   exit 1
 fi
 
-req='{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"ci","version":"0"}}}'
-
 tmp=$(mktemp -d)
 trap 'rm -rf "$tmp"' EXIT
 
-# HOME points at a throwaway dir so the server's default store (~/.cairnkeep)
-# lands there; `head -1` closes stdin after the first reply, so the server sees
-# EOF and exits cleanly.
-out=$(printf '%s\n' "$req" | HOME="$tmp" timeout 15 "${server[@]}" 2>/dev/null | head -1)
-
-if grep -q '"result"' <<<"$out" && grep -q '"tools"' <<<"$out"; then
+if HOME="$tmp" "${probe[@]}"; then
   echo "smoke-mcp-boot: OK (server booted, initialize returned tools capability)"
   exit 0
 fi
 echo "smoke-mcp-boot: FAIL (no valid initialize response)"
-echo "  got: ${out:0:200}"
 exit 1

package/scripts/test-overlay-schema.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+
+node --input-type=module - "$ROOT" <<'NODE'
+import fs from "node:fs";
+import path from "node:path";
+
+const root = process.argv[2];
+const schema = JSON.parse(fs.readFileSync(path.join(root, "schemas/cairnkeep-overlay.schema.json"), "utf8"));
+const example = JSON.parse(fs.readFileSync(path.join(root, "examples/overlay-distribution/cairnkeep.overlay.json"), "utf8"));
+
+if (schema.$schema !== "https://json-schema.org/draft/2020-12/schema") throw new Error("unexpected schema draft");
+if (schema.properties.schemaVersion.const !== 1) throw new Error("unexpected schema version");
+for (const field of schema.required) {
+  if (!(field in example)) throw new Error(`example missing required field: ${field}`);
+}
+if (example.core.package !== "@cairnkeep/cli") throw new Error("example must consume the public core");
+if (example.policy.memory.storage !== "local") throw new Error("example must remain local-first");
+if (example.policy.memory.transport !== "stdio") throw new Error("example must remain local-first");
+NODE
+
+pack_manifest=$(mktemp)
+trap 'rm -f "$pack_manifest"' EXIT
+npm --prefix "$ROOT" pack --dry-run --json --ignore-scripts > "$pack_manifest"
+node --input-type=module - "$pack_manifest" <<'NODE'
+import fs from "node:fs";
+
+const manifest = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
+const files = new Set(manifest[0].files.map((item) => item.path));
+for (const required of [
+  "schemas/cairnkeep-overlay.schema.json",
+  "examples/overlay-distribution/cairnkeep.overlay.json",
+  "docs/overlay-distributions.md",
+]) {
+  if (!files.has(required)) throw new Error(`npm package missing ${required}`);
+}
+NODE
+
+echo "overlay schema checks passed"

package/scripts/test-package-install.sh

@@ -29,4 +29,8 @@ bootstrap_output=$(cairn bootstrap "$tmp/project")
 
 (cd "$tmp/project" && cairn doctor) >/dev/null || fail "installed package failed cairn doctor"
 
+installed_root="$tmp/prefix/lib/node_modules/@cairnkeep/cli"
+[[ -f "$installed_root/examples/anythingllm/sync_to_anythingllm.py" ]] || \
+  fail "npm tarball omitted the default AnythingLLM sync script"
+
 echo "PASS: npm tarball installs a self-contained CLI and MCP server"

package/templates/env.example.template

@@ -27,3 +27,9 @@
 # Optional: comma-separated allowed Host headers for DNS-rebinding protection
 # (default: the bind host + localhost on the chosen port).
 # CAIRN_MEMORY_HTTP_ALLOWED_HOSTS=
+#
+# Optional document-RAG sync. API credentials and endpoint may be local or remote.
+# ANYTHINGLLM_BASE_URL=http://localhost:3001
+# ANYTHINGLLM_API_KEY=
+# CAIRN_ANYTHINGLLM_PROJECTS_FILE=~/.config/cairnkeep/anythingllm-projects.json
+# CAIRN_ANYTHINGLLM_STATE_FILE=~/.local/state/cairnkeep/anythingllm-sync.json