@mcptoolshop/claude-synergy 1.1.0 → 1.2.0

package/dist/embed-OCOZWLXF.js

@@ -0,0 +1,10 @@
+import {
+  embedAll,
+  initVecSchema,
+  makeEmbeddingProvider
+} from "./chunk-CEIOLMDT.js";
+export {
+  embedAll,
+  initVecSchema,
+  makeEmbeddingProvider
+};

package/dist/fetch-XS3IETWW.js

@@ -0,0 +1,11 @@
+import {
+  fetchAll,
+  listFetchTargets,
+  seedMarkersFromDb
+} from "./chunk-X25ZTSCJ.js";
+import "./chunk-MZLFGICO.js";
+export {
+  fetchAll,
+  listFetchTargets,
+  seedMarkersFromDb
+};

package/dist/{ingest-Z45YH7OX.js → ingest-D23NTE25.js}

@@ -1,7 +1,8 @@
 import {
   ingestAll,
   ingestSynergies
-} from "./chunk-HZEQG3WT.js";
+} from "./chunk-KFAQPOGV.js";
+import "./chunk-MZLFGICO.js";
 export {
   ingestAll,
   ingestSynergies

package/dist/mcp-server.js

@@ -4,15 +4,18 @@ import {
   compareVersions,
   entityFrequency,
   getChangesSince,
+  getSyncStatus,
   getSynergy,
   hybridSearch,
   listProducts,
   listSynergies,
   lookupEntity,
-  openDb,
   recentReleases,
   searchChanges
-} from "./chunk-H3466JDH.js";
+} from "./chunk-MTW6UZBF.js";
+import {
+  openDb
+} from "./chunk-CEIOLMDT.js";
 
 // src/mcp-server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -34,6 +37,7 @@ var { version: PKG_VERSION } = _require("../package.json");
 var SYNERGY_NAME_RE = /^[a-z0-9_-]+$/i;
 var DB_PATH = process.env.CLAUDE_SYNERGY_DB ?? process.argv[2] ?? join(process.cwd(), "data", "claude-synergy.db");
 var SYNERGIES_DIR = process.env.CLAUDE_SYNERGY_SYNERGIES_DIR ?? resolveSynergiesDir();
+var PRODUCTS_ROOT = process.env.CLAUDE_SYNERGY_PRODUCTS_ROOT ?? join(dirname(DB_PATH), "..", "products");
 function resolveSynergiesDir() {
   const dbDir = dirname(DB_PATH);
   const candidates = [
@@ -195,6 +199,32 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         required: ["product", "from_version", "to_version"]
       }
+    },
+    {
+      name: "sync_status",
+      description: "Per-product sync freshness. Returns one row per product with last-fetched timestamp, hours since last fetch, and ingested release count. Use BEFORE trusting latest_releases / search results to know if the corpus is stale, and BEFORE calling sync_now to know what needs refreshing.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          product: { type: "string", description: "Limit to one product" },
+          stale_only: { type: "boolean", description: "Only return products older than stale_hours (or never fetched)", default: false },
+          stale_hours: { type: "number", description: "Threshold for stale_only (default 24)", default: 24 }
+        }
+      }
+    },
+    {
+      name: "sync_now",
+      description: "Refresh the corpus by running fetch \u2192 ingest \u2192 embed (mirrors `hk sync`). Pass dry_run=true to enumerate what would be fetched without writes. By default runs the full pipeline so new releases are immediately queryable via search/lookup_entity. Concurrency: rejected with InvalidParams if another sync_now is already in flight. Does NOT commit to git \u2014 caller decides.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          product: { type: "string", description: "Limit to one product" },
+          dry_run: { type: "boolean", description: "Enumerate targets and report what would be fetched, no writes", default: false },
+          include_ingest: { type: "boolean", description: "Run ingest step after fetch (default true)", default: true },
+          include_embed: { type: "boolean", description: "Run embed step after ingest (requires Ollama; default true)", default: true },
+          timeout_ms: { type: "number", description: "Hard timeout for the entire sync (default 300000 = 5 min, max 600000)", default: 3e5 }
+        }
+      }
     }
   ]
 }));
@@ -243,6 +273,14 @@ function optInt(rec, field, tool, min = 1, max = 1e4) {
   }
   return v;
 }
+function optBool(rec, field, tool) {
+  const v = rec[field];
+  if (v === void 0 || v === null) return void 0;
+  if (typeof v !== "boolean") {
+    throw new McpError(ErrorCode.InvalidParams, `${tool}: ${field} must be a boolean`);
+  }
+  return v;
+}
 function optEnum(rec, field, allowed, tool) {
   const v = rec[field];
   if (v === void 0 || v === null) return void 0;
@@ -431,6 +469,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           ]
         };
       }
+      case "sync_status": {
+        const r = asRecord(args ?? {}, "sync_status");
+        return {
+          content: [
+            {
+              type: "text",
+              text: handleSyncStatus({
+                product: optString(r, "product", "sync_status"),
+                staleOnly: optBool(r, "stale_only", "sync_status"),
+                staleHours: optInt(r, "stale_hours", "sync_status", 1, 1e5)
+              })
+            }
+          ]
+        };
+      }
+      case "sync_now": {
+        const r = asRecord(args ?? {}, "sync_now");
+        const text = await handleSyncNow({
+          product: optString(r, "product", "sync_now"),
+          dryRun: optBool(r, "dry_run", "sync_now"),
+          includeIngest: optBool(r, "include_ingest", "sync_now"),
+          includeEmbed: optBool(r, "include_embed", "sync_now"),
+          timeoutMs: optInt(r, "timeout_ms", "sync_now", 1e3, 6e5)
+        });
+        return { content: [{ type: "text", text }] };
+      }
       default:
         throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
     }
@@ -701,6 +765,114 @@ function handleSearchBreakingChanges(args) {
   lines.push(`${results.length} breaking change${results.length === 1 ? "" : "s"}`);
   return lines.join("\n");
 }
+function formatHours(h) {
+  if (h == null) return "never";
+  if (h < 1) return `${Math.round(h * 60)}m`;
+  if (h < 48) return `${h.toFixed(1)}h`;
+  return `${Math.round(h / 24)}d`;
+}
+function handleSyncStatus(args) {
+  const rows = getSyncStatus(db, {
+    product: args.product,
+    staleOnly: args.staleOnly,
+    staleHours: args.staleHours
+  });
+  if (rows.length === 0) {
+    return args.staleOnly ? `(no stale products \u2014 threshold ${args.staleHours ?? 24}h)` : "(no products in DB \u2014 run `hk ingest` first)";
+  }
+  const lines = [
+    "Product                              Strategy        Last fetch  Hours  Ingested  Latest release",
+    "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+  ];
+  for (const r of rows) {
+    const product = (r.product ?? "").padEnd(36);
+    const strategy = (r.fetch_strategy ?? "\u2014").padEnd(14);
+    const lastFetch = r.last_fetch_attempt ? r.last_fetch_attempt.split("T")[0] : "never     ";
+    const hours = formatHours(r.hours_since_fetch).padStart(5);
+    const ingested = String(r.releases_ingested).padStart(8);
+    const latest = r.last_release_at ? r.last_release_at.split("T")[0] : "\u2014";
+    lines.push(`${product} ${strategy} ${lastFetch}  ${hours}  ${ingested}  ${latest}`);
+  }
+  lines.push("");
+  lines.push(`${rows.length} product${rows.length === 1 ? "" : "s"}`);
+  return lines.join("\n");
+}
+var syncInProgress = false;
+async function handleSyncNow(args) {
+  if (syncInProgress) {
+    throw new McpError(
+      ErrorCode.InvalidParams,
+      "sync_now: another sync is already in progress \u2014 retry after it completes (or call sync_status to see progress)"
+    );
+  }
+  const dryRun = args.dryRun ?? false;
+  const includeIngest = args.includeIngest ?? true;
+  const includeEmbed = args.includeEmbed ?? true;
+  const timeoutMs = args.timeoutMs ?? 3e5;
+  const { fetchAll, listFetchTargets } = await import("./fetch-XS3IETWW.js");
+  if (dryRun) {
+    const targets = args.product ? listFetchTargets().filter((t) => t.product === args.product) : listFetchTargets();
+    if (targets.length === 0) {
+      throw new McpError(ErrorCode.InvalidParams, `sync_now: unknown product: ${args.product}`);
+    }
+    const lines = [`(dry_run \u2014 would fetch ${targets.length} product${targets.length === 1 ? "" : "s"})`, ""];
+    for (const t of targets) {
+      const marker = db.prepare(`SELECT version FROM markers WHERE product = ? AND name = 'last_fetched_release_at'`).get(t.product);
+      const since = marker?.version ?? "2026-01-01 (no marker)";
+      lines.push(`  ${t.product.padEnd(36)} ${t.strategy.padEnd(14)} since ${since}`);
+    }
+    return lines.join("\n");
+  }
+  syncInProgress = true;
+  const t0 = Date.now();
+  try {
+    const fetchStats = await fetchAll(db, PRODUCTS_ROOT, {
+      product: args.product,
+      timeoutMs
+    });
+    const fetched = fetchStats.summary;
+    let ingestSummary = "";
+    if (includeIngest) {
+      const { ingestAll } = await import("./ingest-D23NTE25.js");
+      const ingestStats = ingestAll(db, PRODUCTS_ROOT);
+      ingestSummary = `ingested: +${ingestStats.releasesAdded} releases, +${ingestStats.changesAdded} changes, +${ingestStats.entitiesAdded} entities`;
+    }
+    let embedSummary = "";
+    let embedError = "";
+    if (includeEmbed) {
+      try {
+        const { embedAll } = await import("./embed-OCOZWLXF.js");
+        const embedStats = await embedAll(db, {
+          contextProviderName: "structured",
+          embeddingProviderName: "ollama"
+        });
+        embedSummary = `embedded: +${embedStats.chunksCreated} chunks via ${embedStats.contextProvider} + ${embedStats.embeddingProvider}`;
+      } catch (e) {
+        embedError = `embed skipped: ${e.message ?? String(e)}`;
+      }
+    }
+    const elapsedMs = Date.now() - t0;
+    const lines = [
+      `sync_now complete in ${(elapsedMs / 1e3).toFixed(1)}s`,
+      "",
+      `fetched: ${fetched.succeeded}/${fetched.total} products ok, ${fetched.failed} failed, ${fetched.skipped} skipped, +${fetched.newChanges} new releases`
+    ];
+    if (fetched.errors.length > 0) {
+      lines.push("");
+      lines.push("fetch errors:");
+      for (const e of fetched.errors.slice(0, 10)) {
+        lines.push(`  ${e.product}: ${e.error}`);
+      }
+      if (fetched.errors.length > 10) lines.push(`  \u2026 ${fetched.errors.length - 10} more`);
+    }
+    if (ingestSummary) lines.push(ingestSummary);
+    if (embedSummary) lines.push(embedSummary);
+    if (embedError) lines.push(embedError);
+    return lines.join("\n");
+  } finally {
+    syncInProgress = false;
+  }
+}
 function handleCompareVersions(args) {
   let results;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcptoolshop/claude-synergy",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Local mirror of Anthropic product changelogs + curated cross-product synergies. So the LLM agent inside the harness knows what the harness can do.",
   "type": "module",
   "exports": {