threadnote 0.2.1 → 0.2.2

package/dist/threadnote.cjs

@@ -6294,16 +6294,20 @@ async function runInstall(config, options) {
   const serverPath = await findExecutable([OPENVIKING_SERVER_COMMAND]);
   if (serverPath) {
     console.log(`OpenViking server already installed: ${serverPath}`);
-    const repairReasons = [];
-    if (await hasLocalEmbeddingDependency(serverPath) === false) {
+    const localEmbeddingMissing = await hasLocalEmbeddingDependency(serverPath) === false;
+    const pythonSystemCertificatesMissing = await hasPythonSystemCertificatesPatch(serverPath) === false;
+    if (localEmbeddingMissing) {
+      const repairReasons = [];
       repairReasons.push("local embedding extra is missing");
-    }
-    if (await hasPythonSystemCertificatesPatch(serverPath) === false) {
-      repairReasons.push("Python system certificate bridge is missing");
-    }
-    if (repairReasons.length > 0) {
+      if (pythonSystemCertificatesMissing) {
+        repairReasons.push("Python system certificate bridge is missing");
+      }
       console.log(`OpenViking install needs repair: ${repairReasons.join("; ")}.`);
       await runInstallCommands(config, options.packageManager, true, options.dryRun === true);
+    } else if (pythonSystemCertificatesMissing) {
+      console.log("OpenViking install needs repair: Python system certificate bridge is missing.");
+      const installCommand = await getPythonSystemCertificatesInstallCommand(serverPath);
+      await maybeRun(options.dryRun === true, installCommand.executable, installCommand.args);
     }
   } else {
     await runInstallCommands(config, options.packageManager, false, options.dryRun === true);
@@ -6980,6 +6984,20 @@ async function runInstallCommands(config, preferred, force, dryRun) {
     await maybeRun(dryRun, installCommand.executable, installCommand.args);
   }
 }
+async function getPythonSystemCertificatesInstallCommand(serverPath) {
+  const pythonPath = await siblingPythonForExecutable(serverPath);
+  if (!pythonPath) {
+    throw new Error(`Could not find the OpenViking Python environment for ${serverPath}`);
+  }
+  const uvPath = await findExecutable(["uv"]);
+  if (uvPath) {
+    return {
+      executable: uvPath,
+      args: ["pip", "install", "--native-tls", "--python", pythonPath, PYTHON_SYSTEM_CERTS_PACKAGE]
+    };
+  }
+  return { executable: pythonPath, args: ["-m", "pip", "install", PYTHON_SYSTEM_CERTS_PACKAGE] };
+}
 async function getInstallCommands(config, preferred, force) {
   const packageSpec = `${OPENVIKING_PACKAGE_NAME}==${config.openVikingVersion}`;
   const manager = preferred ?? await detectPackageManager();

package/docs/troubleshooting.md

@@ -42,6 +42,14 @@ threadnote start
 Threadnote installs `pip-system-certs` into the OpenViking environment so Python `requests` can use certificates trusted
 by the operating system.
 
+If an older Threadnote release tries to reinstall all of OpenViking and fails while fetching packages such as `openai`,
+install the certificate bridge directly into the existing OpenViking environment:
+
+```bash
+uv pip install --native-tls --python "$(dirname "$(realpath "$(which openviking-server)")")/python" pip-system-certs
+threadnote start
+```
+
 ## Local Embedding Extra Missing
 
 The default OpenViking config uses the local embedding backend. If the server log says `llama-cpp-python` is missing,

package/package.json

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