wyrm-mcp 5.2.2 → 5.3.0

package/dist/version-check.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Version check — quietly polls the npm registry once per day to see if a
+ * newer wyrm-mcp is available, caches the result in the Wyrm database, and
+ * exposes it to both the MCP startup banner and the AI (via the
+ * `wyrm_check_update` tool).
+ *
+ * Design notes:
+ * - Cache TTL: 24 h. We don't want to ping registry every MCP server start
+ *   (which can be per-session-restart for some clients).
+ * - Cache lives in a single-row `update_check` table so it survives restarts.
+ * - Network errors are non-fatal — we just log debug and keep going.
+ * - `fetch` is the Node 22+ global; no extra deps.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import type Database from 'better-sqlite3';
+export interface UpdateStatus {
+    current: string;
+    latest: string | null;
+    updateAvailable: boolean;
+    checkedAt: string;
+    source: 'cache' | 'live' | 'offline';
+}
+/**
+ * Returns the current update status. By default uses the cache when fresh.
+ * Pass `force: true` to bypass the cache (used by `wyrm_check_update`).
+ */
+export declare function getUpdateStatus(db: Database.Database, current: string, opts?: {
+    force?: boolean;
+}): Promise<UpdateStatus>;
+/**
+ * Startup banner — log a single line to stderr if a newer version is out.
+ * Stderr (not stdout) so it never pollutes the MCP stdio protocol.
+ */
+export declare function emitStartupVersionBanner(db: Database.Database, current: string): Promise<void>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../src/version-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAO3C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACtC;AAwED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/version-check.js

@@ -0,0 +1,145 @@
+/**
+ * Version check — quietly polls the npm registry once per day to see if a
+ * newer wyrm-mcp is available, caches the result in the Wyrm database, and
+ * exposes it to both the MCP startup banner and the AI (via the
+ * `wyrm_check_update` tool).
+ *
+ * Design notes:
+ * - Cache TTL: 24 h. We don't want to ping registry every MCP server start
+ *   (which can be per-session-restart for some clients).
+ * - Cache lives in a single-row `update_check` table so it survives restarts.
+ * - Network errors are non-fatal — we just log debug and keep going.
+ * - `fetch` is the Node 22+ global; no extra deps.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import { logger } from './logger.js';
+const REGISTRY_URL = 'https://registry.npmjs.org/wyrm-mcp/latest';
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const FETCH_TIMEOUT_MS = 10_000; // generous for mobile / slow networks; startup is async anyway
+function ensureSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS update_check (
+      id INTEGER PRIMARY KEY CHECK (id = 1),
+      checked_at TEXT NOT NULL,
+      latest_version TEXT,
+      check_succeeded INTEGER NOT NULL DEFAULT 0
+    );
+  `);
+}
+function readCache(db) {
+    ensureSchema(db);
+    const row = db
+        .prepare('SELECT checked_at, latest_version, check_succeeded FROM update_check WHERE id = 1')
+        .get();
+    if (!row)
+        return null;
+    return {
+        checkedAt: new Date(row.checked_at).getTime(),
+        latest: row.latest_version,
+        ok: row.check_succeeded === 1,
+    };
+}
+function writeCache(db, latest, ok) {
+    ensureSchema(db);
+    db.prepare(`
+    INSERT INTO update_check (id, checked_at, latest_version, check_succeeded)
+    VALUES (1, ?, ?, ?)
+    ON CONFLICT(id) DO UPDATE SET
+      checked_at = excluded.checked_at,
+      latest_version = excluded.latest_version,
+      check_succeeded = excluded.check_succeeded
+  `).run(new Date().toISOString(), latest, ok ? 1 : 0);
+}
+/**
+ * Semver comparison — only handles the standard X.Y.Z (no prerelease tags).
+ * Returns: -1 if a<b, 0 if a==b, +1 if a>b. Anything unparseable returns 0.
+ */
+function semverCompare(a, b) {
+    const parse = (s) => s.split('.').map((p) => parseInt(p, 10));
+    const [a1, a2, a3] = parse(a);
+    const [b1, b2, b3] = parse(b);
+    if ([a1, a2, a3, b1, b2, b3].some((n) => Number.isNaN(n)))
+        return 0;
+    if (a1 !== b1)
+        return a1 < b1 ? -1 : 1;
+    if (a2 !== b2)
+        return a2 < b2 ? -1 : 1;
+    if (a3 !== b3)
+        return a3 < b3 ? -1 : 1;
+    return 0;
+}
+async function fetchLatestFromRegistry() {
+    if (typeof fetch !== 'function')
+        return null; // very old Node
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const res = await fetch(REGISTRY_URL, {
+            headers: { Accept: 'application/json' },
+            signal: controller.signal,
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return typeof data.version === 'string' ? data.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Returns the current update status. By default uses the cache when fresh.
+ * Pass `force: true` to bypass the cache (used by `wyrm_check_update`).
+ */
+export async function getUpdateStatus(db, current, opts = {}) {
+    ensureSchema(db);
+    const force = opts.force === true;
+    // Use cache if fresh and not forced.
+    if (!force) {
+        const cached = readCache(db);
+        if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+            const latest = cached.latest;
+            return {
+                current,
+                latest,
+                updateAvailable: latest != null && semverCompare(current, latest) < 0,
+                checkedAt: new Date(cached.checkedAt).toISOString(),
+                source: 'cache',
+            };
+        }
+    }
+    const latest = await fetchLatestFromRegistry();
+    const ok = latest !== null;
+    writeCache(db, latest, ok);
+    if (!ok) {
+        logger.debug('version-check: registry fetch failed (offline or rate-limited)');
+    }
+    return {
+        current,
+        latest,
+        updateAvailable: latest != null && semverCompare(current, latest) < 0,
+        checkedAt: new Date().toISOString(),
+        source: ok ? 'live' : 'offline',
+    };
+}
+/**
+ * Startup banner — log a single line to stderr if a newer version is out.
+ * Stderr (not stdout) so it never pollutes the MCP stdio protocol.
+ */
+export async function emitStartupVersionBanner(db, current) {
+    try {
+        const status = await getUpdateStatus(db, current);
+        if (status.updateAvailable) {
+            process.stderr.write(`🐉 wyrm-mcp ${status.latest} is available (you have ${current}). Run "wyrm_self_update" from your AI client, or "npm install -g wyrm-mcp@latest" manually.\n`);
+        }
+    }
+    catch {
+        // Never crash startup on a version check.
+    }
+}
+//# sourceMappingURL=version-check.js.map

package/dist/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../src/version-check.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wyrm-mcp",
-  "version": "5.2.2",
+  "version": "5.3.0",
   "description": "🐉 Wyrm - Persistent AI Memory System with encryption, full-text search, and infinite storage",
   "type": "module",
   "main": "dist/index.js",
@@ -14,11 +14,13 @@
   "files": [
     "dist",
     "scripts/preinstall.cjs",
+    "scripts/postinstall.cjs",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "preinstall": "node scripts/preinstall.cjs",
+    "postinstall": "node scripts/postinstall.cjs",
     "build": "tsc && chmod +x dist/*.js",
     "start": "node dist/index.js",
     "http": "node dist/http-server.js",

package/scripts/postinstall.cjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/**
+ * Postinstall pitch.
+ *
+ * Prints what Wyrm uniquely offers — once per install lifetime, then a short
+ * "upgraded to X" line on each subsequent install. A marker file under
+ * `~/.wyrm/.first-install-shown` tracks whether the long pitch has been
+ * displayed.
+ *
+ * Set WYRM_SKIP_POSTINSTALL=1 to silence entirely.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+if (process.env.WYRM_SKIP_POSTINSTALL) process.exit(0);
+
+const home = os.homedir();
+const wyrmDir = path.join(home, '.wyrm');
+const marker = path.join(wyrmDir, '.first-install-shown');
+
+let version = 'unknown';
+try {
+  version = JSON.parse(
+    fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'),
+  ).version;
+} catch { /* fall through */ }
+
+function shortBanner() {
+  process.stdout.write(`\n🐉 wyrm-mcp upgraded to ${version}. Run \`wyrm_check_update\` from your AI any time.\n\n`);
+}
+
+function firstInstallPitch() {
+  const lines = [
+    '',
+    '🐉 ─────────────────────────────────────────────────────────────────',
+    `   Wyrm ${version}  ·  Persistent AI Memory System  ·  Ghost Protocol`,
+    '─────────────────────────────────────────────────────────────────────',
+    '',
+    'You just installed something that is NOT just AI memory.',
+    '',
+    'What Wyrm gives you that other memory tools don\'t:',
+    '',
+    '  ⛔  Counter-pattern memory — failed approaches are recorded and',
+    '      BLOCKED next time. Other tools learn only from success.',
+    '',
+    '  🧱  Ground truths — validated project facts, versioned, with',
+    '      cascade-invalidation when an upstream truth changes.',
+    '',
+    '  🧭  Reasoning scaffolds — saved checklists that surface',
+    '      automatically when a task description matches.',
+    '',
+    '  🧬  Lossless session rehydration — wyrm_session_rehydrate produces',
+    '      a complete briefing a fresh AI ingests to inherit prior state.',
+    '',
+    '  🕸️  Knowledge graph — entity / relationship graph with',
+    '      neighborhood traversal and shortest-path queries.',
+    '',
+    '  🎯  OODA agent loop — set persistent goals, the wyrm-loop daemon',
+    '      runs Observe→Orient→Decide→Act until success criteria are met.',
+    '',
+    '  🛰️  Outbound MCP client — Wyrm calls OTHER MCP servers (GitHub,',
+    '      Slack, Linear) as tools. Composes your whole stack.',
+    '',
+    '  🔬  Hybrid semantic search — FTS5 + vector candidates via',
+    '      Reciprocal Rank Fusion. Auto-detects Ollama; OpenAI optional.',
+    '',
+    '  👥  Multi-agent presence + work-stealing across Claude/Copilot/Cursor.',
+    '',
+    '  🌐  Federated team sync — per-row is_shared flag, conflict-as-quest',
+    '      semantics. PII never leaves the box unless explicitly shared.',
+    '',
+    '  🛡️  Hash-chained audit log (Ed25519 signable) for SOC2/HIPAA.',
+    '',
+    '  💰  Hour ledger + invoice generation from session content.',
+    '',
+    'Next steps:',
+    '',
+    '  1. Connect Wyrm to your AI client:    wyrm-setup',
+    '  2. (Optional) Enable semantic search: ollama pull nomic-embed-text',
+    '  3. From your AI, call wyrm_capabilities to see all 114 tools.',
+    '',
+    'Docs:           https://github.com/ghosts-lk/Wyrm',
+    'Troubleshoot:   https://github.com/ghosts-lk/Wyrm/blob/main/TROUBLESHOOTING.md',
+    '',
+    'Silence this banner on future installs: WYRM_SKIP_POSTINSTALL=1',
+    '─────────────────────────────────────────────────────────────────────',
+    '',
+  ];
+  process.stdout.write(lines.join('\n'));
+}
+
+try {
+  if (!fs.existsSync(wyrmDir)) fs.mkdirSync(wyrmDir, { recursive: true });
+
+  if (fs.existsSync(marker)) {
+    shortBanner();
+  } else {
+    firstInstallPitch();
+    fs.writeFileSync(marker, `${new Date().toISOString()}\nversion: ${version}\n`);
+  }
+} catch {
+  // Never fail an install on a banner.
+}