@the-sanjeevkumar/nova-agent 1.0.0 → 1.0.1

package/npm/nova.js

@@ -19,6 +19,14 @@ const APP_ROOT = resolve(__dirname, '..');
 const NOVA_HOME = process.env.NOVA_HOME || join(homedir(), '.nova');
 const VENV_DIR = join(NOVA_HOME, 'venv');
 const IS_WIN = platform() === 'win32';
+// Termux reports process.platform === 'android'; $PREFIX distinguishes it from
+// other Android Pythons. The Python floor below must match pyproject.toml:
+// every runtime dependency is pinned with `python_version >= '3.14'`, so a
+// venv built on older Python installs the package with no dependencies and
+// `nova` dies on the first import (seen on Termux, which ships 3.12/3.13).
+const IS_TERMUX = platform() === 'android' || (process.env.PREFIX || '').includes('com.termux');
+const MIN_PY_MAJOR = 3;
+const MIN_PY_MINOR = 14;
 
 const VERSION = readVersion();
 
@@ -30,6 +38,16 @@ function readVersion() {
   }
 }
 
+function pythonTooOldError() {
+  console.error(`Nova Agent requires Python ${MIN_PY_MAJOR}.${MIN_PY_MINOR} or newer.`);
+  if (IS_TERMUX) {
+    console.error('Termux: run `pkg update && pkg install python`, then re-run `nova`.');
+  } else {
+    console.error('Install Python from https://www.python.org/downloads/ and re-run `nova`.');
+  }
+  process.exit(1);
+}
+
 function findPython() {
   const candidates = IS_WIN ? ['python', 'python3', 'py'] : ['python3', 'python'];
   for (const c of candidates) {
@@ -39,11 +57,11 @@ function findPython() {
     const m = (r.stdout + r.stderr).match(/Python (\d+)\.(\d+)\.(\d+)/);
     if (!m) continue;
     const [major, minor] = [parseInt(m[1]), parseInt(m[2])];
-    if (major > 3 || (major === 3 && minor >= 11)) {
+    if (major > MIN_PY_MAJOR || (major === MIN_PY_MAJOR && minor >= MIN_PY_MINOR)) {
       return c === 'py' ? { cmd: 'py', prefix: ['-3'] } : { cmd: c, prefix: [] };
     }
   }
-  return null;
+  pythonTooOldError();
 }
 
 function venvPython() {
@@ -67,11 +85,17 @@ function markerPath() {
   return join(VENV_DIR, '.nova-version');
 }
 
-function needsProvision() {
+function provisionMarker(py) {
+  // Two lines: launcher VERSION, then the venv's Python major.minor. A marker
+  // without the Python line (pre-1.0.2 installs) forces re-provision, so venvs
+  // built under older Python are not silently reused.
+  return `${VERSION}\n${py ? `${py.major}.${py.minor}` : 'unknown'}\n`;
+}
+
+function needsProvision(py) {
   if (!existsSync(venvPython()) || !existsSync(venvNova())) return true;
   try {
-    const installed = readFileSync(markerPath(), 'utf8').trim();
-    return installed !== VERSION;
+    return readFileSync(markerPath(), 'utf8') !== provisionMarker(py);
   } catch {
     return true;
   }
@@ -79,11 +103,6 @@ function needsProvision() {
 
 function provision() {
   const py = findPython();
-  if (!py) {
-    console.error('Nova Agent requires Python 3.11 or newer.');
-    console.error('Install Python from https://www.python.org/downloads/ and re-run `nova`.');
-    process.exit(1);
-  }
 
   mkdirSync(NOVA_HOME, { recursive: true });
 
@@ -105,15 +124,18 @@ function provision() {
   const install = runSync(venvPython(), ['-m', 'pip', 'install', '--quiet', APP_ROOT]);
   if (install !== 0) {
     console.error('Nova Agent installation failed.');
+    console.error('pip printed the failure above. If you are on Termux, PyPI wheels for');
+    console.error('pydantic-core/psutil do not target Android/Bionic libc; use the Nova');
+    console.error('Termux deb package (or a PM wheelhouse) instead of the npm launcher.');
     process.exit(install);
   }
 
-  writeFileSync(markerPath(), VERSION + '\n');
+  writeFileSync(markerPath(), provisionMarker(py));
   console.log('✅ Nova Agent ready.\n');
 }
 
 function main() {
-  if (needsProvision()) {
+  if (needsProvision(findPython())) {
     provision();
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-sanjeevkumar/nova-agent",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Nova Agent - a universal AI agent you can run from any terminal. Installs a self-contained Python environment on first run.",
   "license": "MIT",
   "author": "Sanjeev Kumar",

package/pm/environments.py

@@ -139,12 +139,24 @@ def record_activation_inputs(stamps: Path, mtimes: dict[str, int], project_root:
     stamps.mkdir(parents=True, exist_ok=True)
     (stamps / ".project-root").write_text(str(Path(project_root).resolve()), encoding="utf-8")
     if test_environment:
-        (stamps / ".test-environment").touch()
-    for name, mtime in mtimes.items():
-        stamp = stamps / name
-        stamp.parent.mkdir(parents=True, exist_ok=True)
-        stamp.touch()
-        os.utime(stamp, ns=(mtime, mtime))
+        # The reader (scripts/_activation.sh::nova_activation_current) compares the
+        # file's CONTENT against the flag it composes (default "--test-environment").
+        # An empty touch() read as "" and falsified every post-sync activation check,
+        # so run-in-nova-env always reported "did not produce a current environment".
+        (stamps / ".test-environment").write_text("--test-environment\n", encoding="utf-8")
+    manifest = stamps / "inputs"
+    with open(manifest, "wb") as f:
+        # The same reader's mtime loop ports "<input=stamp>\0" pairs from this
+        # manifest and judges staleness pairwise (`-nt`/`-ot`); the per-input
+        # stamp files alone give it nothing to read, and the check then fails
+        # on the missing file (bash reports line 88: inputs: No such file).
+        for name, mtime in mtimes.items():
+            stamp = stamps / name
+            stamp.parent.mkdir(parents=True, exist_ok=True)
+            stamp.touch()
+            os.utime(stamp, ns=(mtime, mtime))
+            input_path = Path(project_root) / name
+            f.write(f"{input_path}={stamp}\0".encode())
 
 
 def _payload_manifest(root: Path) -> tuple[dict, Path] | None:

package/pyproject.toml

@@ -67,7 +67,15 @@ dependencies = [
   # arrangement dated to the package's uv exclude-newer quarantine, which
   # has long expired). PM's doc-extract extra repairs lean/broken installs
   # from this same dependency declaration.
-  "firecrawl-anydoc==0.2.4; python_version >= '3.14'",
+  # The `sys_platform != 'android'` clause (same shape as psutil's split
+  # and nemo-relay's wheel-target guard) keeps the Android/Bionic python
+  # out: PyPI ships no bionic wheels for anydoc, so a faithful marker-less
+  # pin sends the phone's pip into an sdist build that bricks the whole
+  # npm/curl setup run (#Termux: "failed to build firecrawl-anydoc").
+  # `tools/read_extract.py` degrades to the typed NeedsOcrError teaching
+  # error without it; the Termux deb wheelhouse builds natives itself and
+  # is unaffected by marker evaluation on the build container.
+  "firecrawl-anydoc==0.2.4; python_version >= '3.14' and sys_platform != 'android'",
   # Bumped from 2.12.5 to 2.13.4 to pull in pydantic-core 2.46.4.
   # pydantic-core 2.41.5 (pulled by 2.12.5) segfaults when the OpenAI SDK's
   # Responses API resource is exercised from a non-main thread, which is the
@@ -373,7 +381,7 @@ google-chat = [
 # Document extraction (read_file anydoc converter self-heal) — core already
 # bundles firecrawl-anydoc==0.2.4; the extra exists so a lean/broken install
 # can re-sync exactly the pin from core.
-doc-extract = ["firecrawl-anydoc==0.2.4"]
+doc-extract = ["firecrawl-anydoc==0.2.4; python_version >= '3.14' and sys_platform != 'android'"]
 # Office/PDF authoring libraries for skills/productivity/{docx,xlsx,powerpoint,pdf}.
 # Baked into the Docker image (Dockerfile `--extra documents`), whose sealed
 # venv has no pip and whose root fs resets on restart; ~25 MB there. Not in
@@ -611,6 +619,13 @@ matrix = "sys_platform == 'linux'"
 google-chat = "platform_machine != 'ARM64' or sys_platform != 'win32'"
 # Match the engine dependency markers so PM refuses an unsupported install.
 wake-openwakeword = "(platform_machine != 'ARM64' or sys_platform != 'win32') and (platform_machine != 'x86_64' or sys_platform != 'darwin')"
+# wake-openwakeword = "(platform_machine != 'ARM64' or sys_platform != 'win32') and (platform_machine != 'x86_64' or sys_platform != 'darwin')"
+# doc-extract: marker must equal its dependency marker — the gates contract
+# (tests/pm/test_extras.py::test_declared_extra_gates_match_dependency_selection)
+# compares gate vs dep-marker admission per platform, and ensure_import must
+# refuse cleanly on the bionic python instead of resolving the extra to an
+# empty set in a loop.
+doc-extract = "python_version >= '3.14' and sys_platform != 'android'"
 # faster-whisper's closure is prebuilt-only: ctranslate2 has no win_arm64 wheel and onnxruntime
 # none for darwin-x64. Its ANCHOR is faster_whisper, so an unsupported machine could install the
 # extra, rebuild the whole dependency environment and still fail the anchor on every retry.

package/uv.lock

@@ -3686,7 +3686,7 @@ dependencies = [
     { name = "cryptography" },
     { name = "fastapi" },
     { name = "fire" },
-    { name = "firecrawl-anydoc" },
+    { name = "firecrawl-anydoc", marker = "sys_platform != 'android'" },
     { name = "httptools" },
     { name = "httpx", extra = ["socks"] },
     { name = "jinja2" },
@@ -3782,7 +3782,7 @@ discord = [
     { name = "discord-py", extra = ["voice"] },
 ]
 doc-extract = [
-    { name = "firecrawl-anydoc" },
+    { name = "firecrawl-anydoc", marker = "sys_platform != 'android'" },
 ]
 documents = [
     { name = "openpyxl" },
@@ -4027,8 +4027,8 @@ requires-dist = [
     { name = "faster-whisper", marker = "(platform_machine != 'x86_64' and sys_platform == 'darwin' and extra == 'stt-whisper') or (platform_machine != 'ARM64' and sys_platform == 'win32' and extra == 'stt-whisper') or (sys_platform != 'android' and sys_platform != 'darwin' and sys_platform != 'win32' and extra == 'stt-whisper')", specifier = "==1.2.1" },
     { name = "faster-whisper", marker = "(platform_machine != 'x86_64' and sys_platform == 'darwin' and extra == 'voice') or (platform_machine != 'ARM64' and sys_platform == 'win32' and extra == 'voice') or (sys_platform != 'android' and sys_platform != 'darwin' and sys_platform != 'win32' and extra == 'voice')", specifier = "==1.2.1" },
     { name = "fire", marker = "python_full_version >= '3.14'", specifier = "==0.7.1" },
-    { name = "firecrawl-anydoc", marker = "python_full_version >= '3.14'", specifier = "==0.2.4" },
-    { name = "firecrawl-anydoc", marker = "extra == 'doc-extract'", specifier = "==0.2.4" },
+    { name = "firecrawl-anydoc", marker = "python_full_version >= '3.14' and sys_platform != 'android'", specifier = "==0.2.4" },
+    { name = "firecrawl-anydoc", marker = "python_full_version >= '3.14' and sys_platform != 'android' and extra == 'doc-extract'", specifier = "==0.2.4" },
     { name = "firecrawl-py", marker = "extra == 'firecrawl'", specifier = "==4.53.2" },
     { name = "google-api-python-client", marker = "extra == 'google'", specifier = "==2.201.0" },
     { name = "google-auth", marker = "extra == 'google'", specifier = "==2.62.0" },