threadnote 1.1.1 → 1.1.2

package/dist/mcp_server.cjs

@@ -36134,7 +36134,13 @@ function recallSnippet(value) {
   const oneLine = value.replace(/\s+/g, " ").trim();
   return oneLine.length > 180 ? `${oneLine.slice(0, 180)}\u2026` : oneLine;
 }
-function parseRecallHits(output) {
+function isArchivedMemoryUri(uri) {
+  const documentUri = uri.replace(/#.*$/, "");
+  return /^viking:\/\/user\/[^/]+\/memories\/(?:durable|handoffs|incidents|preferences|smoke)\/archived(?:\/|$)/.test(
+    documentUri
+  );
+}
+function parseRecallHits(output, options = {}) {
   const start = output.search(/^\{/m);
   if (start < 0) {
     return [];
@@ -36155,6 +36161,9 @@ function parseRecallHits(output) {
         if (!isJsonObject(item) || typeof item.uri !== "string" || isSummarySidecarUri(item.uri)) {
           continue;
         }
+        if (options.includeArchived !== true && isArchivedMemoryUri(item.uri)) {
+          continue;
+        }
         hits.push({
           contextType: typeof item.context_type === "string" ? item.context_type : "result",
           score: typeof item.score === "number" ? item.score : 0,
@@ -38417,7 +38426,7 @@ function registerSearchTool(server, config2, name, description) {
         uri: external_exports.string().optional().describe("Optional viking:// subtree to search"),
         callerCwd: external_exports.string().optional().describe("Optional absolute caller workspace path used to resolve this/current branch queries"),
         nodeLimit: external_exports.number().int().positive().max(100).optional().describe("Maximum result count"),
-        includeArchived: external_exports.boolean().optional().describe("Include archived memories in exact memory/resource matches"),
+        includeArchived: external_exports.boolean().optional().describe("Include archived memories in recall results"),
         threshold: external_exports.number().min(0).max(1).optional().describe(
           "Minimum relevance score 0-1 (default 0.5); lower it (toward 0) to broaden when a recall comes back empty"
         )
@@ -38473,14 +38482,20 @@ async function runRecallTool(config2, params) {
   const limitArgs = params.nodeLimit ? ["--node-limit", String(params.nodeLimit)] : [];
   const threshold = params.threshold ?? RECALL_SCORE_THRESHOLD;
   const pinnedArgs = params.pinnedUri ? ["--uri", params.pinnedUri] : [];
-  const base = await recallSearchHits(config2, ["search", query, ...pinnedArgs, ...limitArgs], threshold);
+  const base = await recallSearchHits(
+    config2,
+    ["search", query, ...pinnedArgs, ...limitArgs],
+    threshold,
+    params.includeArchived
+  );
   const passes = [base.hits];
   const seededUri = project ? trimTrailingSlash(project.uri) : void 0;
   if (seededUri?.startsWith("viking://") && seededUri !== params.pinnedUri) {
     const seeded = await recallSearchHits(
       config2,
       ["search", params.query, "--uri", seededUri, ...limitArgs],
-      threshold
+      threshold,
+      params.includeArchived
     );
     passes.push(seeded.hits);
   }
@@ -38514,7 +38529,7 @@ async function runRecallTool(config2, params) {
   const onlyErrorNote = !base.ok && !semanticSection && sections.length === 1;
   return { content: [{ type: "text", text: sections.join("\n\n") }], isError: onlyErrorNote || void 0 };
 }
-async function recallSearchHits(config2, searchArgs, threshold) {
+async function recallSearchHits(config2, searchArgs, threshold, includeArchived) {
   let result = await runOpenVikingTool(config2, [
     ...searchArgs,
     "--threshold",
@@ -38532,7 +38547,7 @@ async function recallSearchHits(config2, searchArgs, threshold) {
   if (result.isError === true) {
     return { errorText: text.trim(), hits: [], ok: false };
   }
-  return { errorText: "", hits: parseRecallHits(text), ok: true };
+  return { errorText: "", hits: parseRecallHits(text, { includeArchived }), ok: true };
 }
 async function recallHygieneHintsSection(config2, recallText) {
   const uris = activePersonalMemoryUrisFromText(recallText, config2.user);

package/dist/threadnote.cjs

@@ -3473,6 +3473,7 @@ var {
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 1933;
 var DEFAULT_OPENVIKING_VERSION = "0.3.24";
+var OPENVIKING_TOOL_PYTHON = "3.12";
 var DEFAULT_ACCOUNT = "local";
 var DEFAULT_AGENT_ID = "threadnote";
 var OPENVIKING_PACKAGE_NAME = "openviking[local-embed]";
@@ -4315,7 +4316,13 @@ function recallSnippet(value) {
   const oneLine = value.replace(/\s+/g, " ").trim();
   return oneLine.length > 180 ? `${oneLine.slice(0, 180)}\u2026` : oneLine;
 }
-function parseRecallHits(output2) {
+function isArchivedMemoryUri(uri) {
+  const documentUri = uri.replace(/#.*$/, "");
+  return /^viking:\/\/user\/[^/]+\/memories\/(?:durable|handoffs|incidents|preferences|smoke)\/archived(?:\/|$)/.test(
+    documentUri
+  );
+}
+function parseRecallHits(output2, options = {}) {
   const start = output2.search(/^\{/m);
   if (start < 0) {
     return [];
@@ -4336,6 +4343,9 @@ function parseRecallHits(output2) {
         if (!isJsonObject(item) || typeof item.uri !== "string" || isSummarySidecarUri(item.uri)) {
           continue;
         }
+        if (options.includeArchived !== true && isArchivedMemoryUri(item.uri)) {
+          continue;
+        }
         hits.push({
           contextType: typeof item.context_type === "string" ? item.context_type : "result",
           score: typeof item.score === "number" ? item.score : 0,
@@ -9960,14 +9970,17 @@ async function runRecall(config, options) {
   if (inferredUri) {
     console.log(`Recall scope: ${inferredUri}`);
   }
-  const passes = [await recallSearchHits(config, ov, searchArgs(inferredUri), { dryRun })];
+  const includeArchived = options.includeArchived === true;
+  const passes = [
+    await recallSearchHits(config, ov, searchArgs(inferredUri), { dryRun, includeArchived })
+  ];
   if (options.project && project) {
     const projectMemoryUri = `viking://user/${uriSegment(config.user)}/memories/durable/projects/${uriSegment(project.name)}`;
-    passes.push(await recallSearchHits(config, ov, searchArgs(projectMemoryUri), { dryRun }));
+    passes.push(await recallSearchHits(config, ov, searchArgs(projectMemoryUri), { dryRun, includeArchived }));
   }
   const seededUri = project ? trimTrailingSlash(project.uri) : void 0;
   if (seededUri?.startsWith("viking://") && seededUri !== inferredUri && !options.uri && options.inferScope !== false) {
-    passes.push(await recallSearchHits(config, ov, searchArgs(seededUri), { dryRun }));
+    passes.push(await recallSearchHits(config, ov, searchArgs(seededUri), { dryRun, includeArchived }));
   }
   const recallOutputs = [];
   const semanticSection = formatRecallHits(mergeRecallHits(passes), nodeLimit ?? 12);
@@ -9978,7 +9991,7 @@ ${semanticSection}`);
   }
   const exactOutput = await printExactMemoryMatches(config, ov, query, {
     dryRun,
-    includeArchived: options.includeArchived === true,
+    includeArchived,
     project
   });
   if (exactOutput) {
@@ -10002,7 +10015,7 @@ async function recallSearchHits(config, ov, args, options) {
     console.log(`WARN recall search failed: ${result.stderr.trim() || result.stdout.trim() || "ov search error"}`);
     return [];
   }
-  return parseRecallHits(result.stdout);
+  return parseRecallHits(result.stdout, { includeArchived: options.includeArchived });
 }
 function stripAdvancedSearchFlags(args) {
   const stripped = [];
@@ -12442,6 +12455,14 @@ async function runInstall(config, options) {
     serverInstallRan = true;
   }
   const resolvedServerPath = serverInstallRan ? await findOpenVikingServer() : serverPath;
+  if (serverInstallRan && !resolvedServerPath && !dryRun) {
+    const message = `OpenViking install ran but ${OPENVIKING_SERVER_COMMAND} was not found on PATH, in the uv tool bin dir, or ~/.local/bin. Re-run \`threadnote install --force\` (it streams the full build), then \`threadnote doctor\`.`;
+    if (options.requireServerBinary === false) {
+      console.warn(`WARN ${message}`);
+    } else {
+      throw new Error(message);
+    }
+  }
   if (resolvedServerPath && !dryRun) {
     await maybePrintOpenVikingPathHint(resolvedServerPath);
   }
@@ -12478,6 +12499,7 @@ async function runRepair(config, options) {
     packageManager: options.packageManager,
     printNextSteps: false,
     repairInvalidConfigs: true,
+    requireServerBinary: false,
     start: false
   });
   await repairManifest(config, dryRun);
@@ -12832,7 +12854,11 @@ async function openVikingServerCheck() {
   const name = OPENVIKING_SERVER_COMMAND;
   const executable = await findOpenVikingServer();
   if (!executable) {
-    return { name, status: "fail", detail: "missing; install will fetch it via uv or pipx" };
+    return {
+      name,
+      status: "fail",
+      detail: "missing; run `threadnote install` to fetch it via uv or pipx (local-embed may compile from source on first install)"
+    };
   }
   const result = await runCommand(executable, ["--help"], { allowFailure: true });
   const onPath = await findExecutable([OPENVIKING_SERVER_COMMAND]);
@@ -13066,7 +13092,36 @@ async function runInstallCommands(config, preferred, force, dryRun) {
   }
   const installCommands = await getInstallCommands(config, manager, force);
   for (const installCommand of installCommands) {
-    await maybeRun(dryRun, installCommand.executable, installCommand.args);
+    if (dryRun) {
+      await maybeRun(true, installCommand.executable, installCommand.args);
+      continue;
+    }
+    console.log(`Running: ${formatShellCommand(installCommand.executable, installCommand.args)}`);
+    const exitCode = await runInteractive(installCommand.executable, installCommand.args);
+    if (exitCode !== 0) {
+      printOpenVikingInstallFailureHelp(installCommand);
+      throw new Error(`${formatShellCommand(installCommand.executable, installCommand.args)} exited with ${exitCode}.`);
+    }
+  }
+}
+function printOpenVikingInstallFailureHelp(failedCommand) {
+  console.error("");
+  console.error("OpenViking install did not complete.");
+  console.error(
+    "openviking[local-embed] includes llama-cpp-python, which compiles from source when no prebuilt wheel matches your Python/platform \u2014 that build can run 10-20 minutes and is memory-heavy, so it may be killed by the OS (out of memory) or look stuck."
+  );
+  console.error("Re-run it directly to see full output without any wrapper timeout:");
+  console.error(`  ${formatShellCommand(failedCommand.executable, failedCommand.args)}`);
+  console.error("Cap memory use during the compile with: CMAKE_BUILD_PARALLEL_LEVEL=2 <command above>");
+  if (failedCommand.executable === "uv") {
+    if (failedCommand.args.includes("--python")) {
+      console.error(
+        "If uv could not fetch a managed CPython (offline or restricted network), drop the version pin and retry: THREADNOTE_OPENVIKING_PYTHON= threadnote install --force"
+      );
+    }
+    console.error("If it was killed mid-build, clear the partial install first, then retry:");
+    console.error("  uv cache clean");
+    console.error('  rm -rf "$(uv tool dir)/openviking"');
   }
 }
 async function offerToInstallUv() {
@@ -13147,12 +13202,33 @@ async function getPythonSystemCertificatesInstallCommand(serverPath) {
   }
   return { executable: pythonPath, args: ["-m", "pip", "install", PYTHON_SYSTEM_CERTS_PACKAGE] };
 }
+function localEmbedWheelIndexUrl() {
+  const override = process.env.THREADNOTE_LLAMA_WHEEL_INDEX;
+  if (override !== void 0) {
+    return override.trim() === "" ? void 0 : override.trim();
+  }
+  const base = "https://abetlen.github.io/llama-cpp-python/whl";
+  return (0, import_node_os6.platform)() === "darwin" ? `${base}/metal` : `${base}/cpu`;
+}
+function openVikingToolPython() {
+  const override = process.env.THREADNOTE_OPENVIKING_PYTHON;
+  if (override !== void 0) {
+    return override.trim() === "" ? void 0 : override.trim();
+  }
+  return OPENVIKING_TOOL_PYTHON;
+}
 async function getInstallCommands(config, preferred, force) {
   const packageSpec = `${OPENVIKING_PACKAGE_NAME}==${config.openVikingVersion}`;
+  const wheelIndex = localEmbedWheelIndexUrl();
   const manager = preferred ?? await detectPackageManager();
   if (manager === "pipx") {
+    const installArgs = force ? ["install", "--force"] : ["install"];
+    if (wheelIndex) {
+      installArgs.push("--pip-args", `--extra-index-url ${wheelIndex}`);
+    }
+    installArgs.push(packageSpec);
     return [
-      { executable: "pipx", args: force ? ["install", "--force", packageSpec] : ["install", packageSpec] },
+      { executable: "pipx", args: installArgs },
       {
         executable: "pipx",
         args: force ? ["inject", "--force", "openviking", PYTHON_SYSTEM_CERTS_PACKAGE] : ["inject", "openviking", PYTHON_SYSTEM_CERTS_PACKAGE]
@@ -13160,7 +13236,16 @@ async function getInstallCommands(config, preferred, force) {
     ];
   }
   if (manager === "uv") {
-    const uvArgs = ["tool", "install", "--native-tls", "--with", PYTHON_SYSTEM_CERTS_PACKAGE];
+    const toolPython = openVikingToolPython();
+    const uvArgs = [
+      "tool",
+      "install",
+      "--native-tls",
+      ...toolPython ? ["--python", toolPython] : [],
+      "--with",
+      PYTHON_SYSTEM_CERTS_PACKAGE,
+      ...wheelIndex ? ["--extra-index-url", wheelIndex] : []
+    ];
     return [
       {
         executable: "uv",
@@ -13172,6 +13257,9 @@ async function getInstallCommands(config, preferred, force) {
   if (force) {
     pipArgs.push("--upgrade", "--force-reinstall");
   }
+  if (wheelIndex) {
+    pipArgs.push("--extra-index-url", wheelIndex);
+  }
   pipArgs.push(PYTHON_SYSTEM_CERTS_PACKAGE);
   pipArgs.push(packageSpec);
   return [{ executable: "python3", args: pipArgs }];
@@ -14690,7 +14778,7 @@ async function main() {
   program2.command("migrate-lifecycle").description("Move clear legacy handoff memories into lifecycle-aware archive paths").option("--apply", "Perform the migration; without this, prints a dry run").option("--dry-run", "Print migration actions without writing or removing memories").option("--limit <count>", "Maximum number of legacy handoffs to migrate").action(async (options) => {
     await runMigrateLifecycle(getRuntimeConfig(program2), options);
   });
-  program2.command("recall").description("Search shared OpenViking context").requiredOption("--query <query>", "Search query").option("--dry-run", "Print ov command without searching").option("--include-archived", "Include archived memories in exact memory/resource matches").option("-n, --node-limit <count>", "Maximum number of search results").option("--no-infer-scope", "Disable query-based scope inference").option("--project <name>", "Prioritize a project: add a scoped pass over its memories alongside the global search").option("--threshold <score>", "Minimum relevance score 0-1 (default 0.45); lower to broaden when recall is empty").option("--uri <uri>", "Restrict search to a viking:// URI").action(async (options) => {
+  program2.command("recall").description("Search shared OpenViking context").requiredOption("--query <query>", "Search query").option("--dry-run", "Print ov command without searching").option("--include-archived", "Include archived memories in recall results").option("-n, --node-limit <count>", "Maximum number of search results").option("--no-infer-scope", "Disable query-based scope inference").option("--project <name>", "Prioritize a project: add a scoped pass over its memories alongside the global search").option("--threshold <score>", "Minimum relevance score 0-1 (default 0.45); lower to broaden when recall is empty").option("--uri <uri>", "Restrict search to a viking:// URI").action(async (options) => {
     await runRecall(getRuntimeConfig(program2), options);
   });
   program2.command("compact").description("Plan or apply scoped memory hygiene for active personal memories").requiredOption("--project <name>", "Project/repo namespace to inspect").option("--apply", "Apply the compact plan; without this, prints a dry run").option("--dry-run", "Print the compact plan without changing anything").option("--kind <kind>", "durable, handoff, or incident", parseCompactKind).option("--topic <name>", "Stable topic name to inspect").action(async (options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "threadnote",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "type": "commonjs",
   "main": "dist/threadnote.cjs",
   "description": "Shared local context and handoffs for development agents",