zam-core 0.14.0 → 0.15.0

package/dist/cli/commands/mcp.js

@@ -2140,6 +2140,15 @@ async function listTokens(db, options) {
     )`);
     params.push(options.knowledgeContext);
   }
+  if (options?.sourceLinkBases) {
+    const clauses = options.sourceLinkBases.map(
+      () => `(source_link = ? OR source_link LIKE ? || '#%' ESCAPE '\\')`
+    );
+    whereClauses.push(clauses.length ? `(${clauses.join(" OR ")})` : "0 = 1");
+    for (const base of options.sourceLinkBases) {
+      params.push(base, escapeLike(base));
+    }
+  }
   const orderBy = options?.domain || options?.domainPrefix ? "ORDER BY bloom_level, slug" : "ORDER BY bloom_level, domain, slug";
   const sql = `SELECT * FROM tokens WHERE ${whereClauses.join(" AND ")} ${orderBy}`;
   const tokens = await db.prepare(sql).all(...params);
@@ -9231,6 +9240,7 @@ var init_bundle = __esm({
 var io_exports = {};
 __export(io_exports, {
   DEFAULT_BUNDLE_DIR: () => DEFAULT_BUNDLE_DIR,
+  collectSourceLinkBases: () => collectSourceLinkBases,
   findRepoRoot: () => findRepoRoot,
   loadBundle: () => loadBundle,
   resolveArticlePath: () => resolveArticlePath,
@@ -9259,6 +9269,12 @@ function resolveBundleDirFromRoots(rootUris, fallback) {
   }
   return dirs.find((dir) => existsSync13(dir)) ?? dirs[0] ?? fallback;
 }
+function collectSourceLinkBases(dir) {
+  const bundle = loadBundle(dir);
+  return bundle.catalog.map(
+    (entry) => entry.resource ?? resolveArticlePath(dir, entry.file)
+  );
+}
 function resolveArticlePath(dir, file) {
   if (file.includes("/") || file.includes("\\") || file.includes("..")) {
     throw new Error(`invalid article file name: ${file}`);
@@ -9375,10 +9391,67 @@ var init_io = __esm({
   }
 });
 
+// src/cli/okf-focus.ts
+var okf_focus_exports = {};
+__export(okf_focus_exports, {
+  getOkfFocusPath: () => getOkfFocusPath,
+  readOkfFocus: () => readOkfFocus,
+  writeOkfFocus: () => writeOkfFocus
+});
+import { mkdir as mkdir2, readFile as readFile2, rename as rename2, writeFile as writeFile2 } from "fs/promises";
+import { homedir as homedir16 } from "os";
+import { dirname as dirname12, join as join25 } from "path";
+function getOkfFocusPath(home = homedir16()) {
+  return join25(home, ".zam", "okf-focus.json");
+}
+function resolvePath(explicit) {
+  return explicit ?? process.env.ZAM_OKF_FOCUS_PATH ?? getOkfFocusPath();
+}
+async function writeOkfFocus(file, bundleDir, opts = {}) {
+  if (file.includes("/") || file.includes("\\") || !file.endsWith(".md")) {
+    throw new Error(`invalid article file name: ${file}`);
+  }
+  const path = resolvePath(opts.path);
+  const focus = {
+    version: 1,
+    file,
+    ...bundleDir ? { bundleDir } : {},
+    updatedAt: (opts.now?.() ?? /* @__PURE__ */ new Date()).toISOString()
+  };
+  await mkdir2(dirname12(path), { recursive: true });
+  const tmp = `${path}.tmp`;
+  await writeFile2(tmp, `${JSON.stringify(focus, null, 2)}
+`, "utf8");
+  await rename2(tmp, path);
+  return focus;
+}
+async function readOkfFocus(opts = {}) {
+  try {
+    const raw = await readFile2(resolvePath(opts.path), "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== 1 || typeof parsed.file !== "string" || typeof parsed.updatedAt !== "string") {
+      return null;
+    }
+    return {
+      version: 1,
+      file: parsed.file,
+      ...typeof parsed.bundleDir === "string" ? { bundleDir: parsed.bundleDir } : {},
+      updatedAt: parsed.updatedAt
+    };
+  } catch {
+    return null;
+  }
+}
+var init_okf_focus = __esm({
+  "src/cli/okf-focus.ts"() {
+    "use strict";
+  }
+});
+
 // src/cli/commands/mcp.ts
 init_kernel();
 import { existsSync as existsSync22, readFileSync as readFileSync19 } from "fs";
-import { dirname as dirname12, join as join25 } from "path";
+import { basename as basename6, dirname as dirname13, join as join26 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 import {
   RESOURCE_MIME_TYPE,
@@ -12178,7 +12251,7 @@ async function readWebLink(url) {
         redirect: "manual",
         signal: controller.signal,
         headers: {
-          "User-Agent": "ZAM-Content-Studio/0.14.0"
+          "User-Agent": "ZAM-Content-Studio/0.15.0"
         }
       });
       if (res.status >= 300 && res.status < 400) {
@@ -32323,7 +32396,12 @@ bridgeCommand.command("list-tokens").description(
 ).option("--domain <domain>", "Filter by exact domain").option(
   "--domain-prefix <prefix>",
   "Filter by domain prefix (e.g. company-team) \u2014 uses / separator for hierarchy"
-).option("--knowledge-context <context>", "Filter by knowledge context").action(async (opts) => {
+).option("--knowledge-context <context>", "Filter by knowledge context").option(
+  "--source-link-base <base>",
+  "Filter by source-link base (exact or '<base>#<anchor>', as written by OKF imports); repeatable",
+  (value, previous) => [...previous, value],
+  []
+).action(async (opts) => {
   await withDb2(async (db) => {
     const userId = opts.user ? await resolveUser(opts, db, { json: true }) : void 0;
     const listOpts = {};
@@ -32331,6 +32409,8 @@ bridgeCommand.command("list-tokens").description(
     if (opts.domainPrefix) listOpts.domainPrefix = opts.domainPrefix;
     if (opts.knowledgeContext)
       listOpts.knowledgeContext = opts.knowledgeContext;
+    if (opts.sourceLinkBase.length)
+      listOpts.sourceLinkBases = opts.sourceLinkBase;
     const tokens = await listTokens(
       db,
       Object.keys(listOpts).length ? listOpts : void 0
@@ -34143,10 +34223,10 @@ async function publishUiIntent(app, input = {}, opts = {}) {
 }
 
 // src/cli/commands/mcp.ts
-var __dirname = dirname12(fileURLToPath7(import.meta.url));
-var pkgPath = join25(__dirname, "..", "..", "package.json");
+var __dirname = dirname13(fileURLToPath7(import.meta.url));
+var pkgPath = join26(__dirname, "..", "..", "package.json");
 if (!existsSync22(pkgPath)) {
-  pkgPath = join25(__dirname, "..", "..", "..", "package.json");
+  pkgPath = join26(__dirname, "..", "..", "..", "package.json");
 }
 var pkg = JSON.parse(readFileSync19(pkgPath, "utf-8"));
 var STUDIO_RESOURCE_URI = "ui://zam/studio";
@@ -34176,9 +34256,9 @@ var STUDIO_BRIDGE_ALLOWED_COMMANDS = /* @__PURE__ */ new Set([
 function loadPanelHtml(fileName, placeholderTitle) {
   const candidates = [
     // dist/cli/commands/mcp.js → dist/ui/
-    join25(__dirname, "..", "..", "ui", fileName),
+    join26(__dirname, "..", "..", "ui", fileName),
     // src/cli/commands/mcp.ts via tsx → <repo>/dist/ui/
-    join25(__dirname, "..", "..", "..", "dist", "ui", fileName)
+    join26(__dirname, "..", "..", "..", "dist", "ui", fileName)
   ];
   for (const candidate of candidates) {
     if (existsSync22(candidate)) {
@@ -34747,7 +34827,7 @@ function createMcpServer(db) {
     "zam_show_graph",
     {
       title: "Open ZAM knowledge graph",
-      description: "Open the ZAM 2D knowledge-graph card, centered on a token's direct prerequisites and dependents. Pass `focus` (a token slug) when the conversation already names one; otherwise the card shows a hint to supply one.",
+      description: "Open the ZAM 2D knowledge-graph card, centered on a token's direct prerequisites and dependents. Pass `focus` (a token slug) when the conversation already names one; without it the card offers scope selectors and defaults to tokens anchored in the current repo's OKF knowledge base.",
       inputSchema: {
         focus: z.string().optional().describe("Token slug to center the graph on"),
         user: z.string().optional().describe("User ID")
@@ -34769,6 +34849,16 @@ function createMcpServer(db) {
         { clientSamplingCapable: getClientSamplingCapable() }
       );
       const userId = opening.context.user.currentId ?? null;
+      let repoScope;
+      try {
+        const { collectSourceLinkBases: collectSourceLinkBases2, findRepoRoot: findRepoRoot2 } = await Promise.resolve().then(() => (init_io(), io_exports));
+        const bundleDir = await resolveOkfBundleDir();
+        const bases = collectSourceLinkBases2(bundleDir);
+        if (bases.length > 0) {
+          repoScope = { label: basename6(findRepoRoot2(bundleDir)), bases };
+        }
+      } catch {
+      }
       await publishUiIntent("graph", { user, focus });
       return {
         graph: "zam",
@@ -34776,6 +34866,7 @@ function createMcpServer(db) {
         version: pkg.version,
         user: userId,
         companionContext: opening.context,
+        ...repoScope ? { repoScope } : {},
         ...opening.degraded ? { companionContextDegraded: true } : {}
       };
     })
@@ -34988,7 +35079,7 @@ function createMcpServer(db) {
         if (params.include_log) {
           const { readFileSync: readFileSync20 } = await import("fs");
           try {
-            log = readFileSync20(join25(bundle.dir, "log.md"), "utf8");
+            log = readFileSync20(join26(bundle.dir, "log.md"), "utf8");
           } catch {
             log = "";
           }
@@ -35104,6 +35195,52 @@ function createMcpServer(db) {
       }
     )
   );
+  registerAppTool(
+    server,
+    "zam_okf_focus",
+    {
+      description: "App-only: record which OKF article the visualizer panel currently shows, so chat agents can resolve 'the currently focused article'. Not intended for direct model use.",
+      inputSchema: {
+        file: z.string().describe("Article file name inside the bundle (kebab-case .md)"),
+        bundle_dir: z.string().optional().describe("Absolute bundle directory the panel is browsing")
+      },
+      annotations: {
+        ...commonAnnotations,
+        destructiveHint: false,
+        idempotentHint: true
+      },
+      _meta: {
+        ui: { visibility: ["app"] }
+      }
+    },
+    wrapHandler(async (params) => {
+      const { writeOkfFocus: writeOkfFocus2 } = await Promise.resolve().then(() => (init_okf_focus(), okf_focus_exports));
+      const focus = await writeOkfFocus2(params.file, params.bundle_dir);
+      return { recorded: { file: focus.file, updatedAt: focus.updatedAt } };
+    })
+  );
+  server.registerTool(
+    "zam_okf_focused",
+    {
+      description: "The OKF article currently focused in the user's visualizer panel \u2014 resolve requests like 'import this okf', 'import the currently focused article', or 'the open article'. Returns {focused: {file, bundle_dir?, updatedAt} | null}; check updatedAt and confirm the article by name with the user if it looks stale. To import, read the article (zam_okf_read) and follow the zam_okf_import contract.",
+      inputSchema: {},
+      annotations: {
+        ...commonAnnotations,
+        readOnlyHint: true
+      }
+    },
+    wrapHandler(async () => {
+      const { readOkfFocus: readOkfFocus2 } = await Promise.resolve().then(() => (init_okf_focus(), okf_focus_exports));
+      const focus = await readOkfFocus2();
+      return {
+        focused: focus ? {
+          file: focus.file,
+          ...focus.bundleDir ? { bundle_dir: focus.bundleDir } : {},
+          updatedAt: focus.updatedAt
+        } : null
+      };
+    })
+  );
   server.registerTool(
     "zam_okf_read_citation",
     {
@@ -35172,13 +35309,13 @@ function createMcpServer(db) {
         problems = bundle.problems;
         const { readFileSync: readFileSync20 } = await import("fs");
         try {
-          log = readFileSync20(join25(bundle.dir, "log.md"), "utf8");
+          log = readFileSync20(join26(bundle.dir, "log.md"), "utf8");
         } catch {
           log = "";
         }
         try {
           const { parseFrontmatter: parseFrontmatter2 } = await Promise.resolve().then(() => (init_bundle(), bundle_exports));
-          const indexRaw = readFileSync20(join25(bundle.dir, "index.md"), "utf8");
+          const indexRaw = readFileSync20(join26(bundle.dir, "index.md"), "utf8");
           const { fields } = parseFrontmatter2(indexRaw);
           okfVersion = typeof fields.okf_version === "string" ? fields.okf_version : null;
         } catch {