thronglets 0.4.6 → 0.5.0

package/README.md

@@ -9,16 +9,18 @@ This npm package installs the `thronglets` CLI wrapper and downloads a matching
 ```bash
 npm install -g thronglets
 thronglets version --json
-thronglets setup
+thronglets start
 ```
 
 That is the whole local bootstrap path.
 
-`thronglets setup` now:
+`thronglets start` now:
 - configures known local adapters for Claude Code, Codex, and OpenClaw
 - runs the same bootstrap health pass used by the machine-facing flow
 - reports `restart required` and `next steps` directly
 
+If you invoke `thronglets` from inside a local Thronglets repo checkout, the wrapper now prefers the repo-local source path before it falls back to the installed release binary. That keeps local AI sessions from accidentally using a stale global binary while they work inside the repo.
+
 ## What The Agent Gets
 
 Thronglets does not dump a long report into the model context. It emits sparse decision guidance:

package/bin/thronglets.js

@@ -18,7 +18,68 @@ if (!binPath) {
   process.exit(1);
 }
 
+function looksLikeRepoRoot(dir) {
+  const cargoToml = path.join(dir, "Cargo.toml");
+  const mainRs = path.join(dir, "src", "main.rs");
+  if (!fs.existsSync(cargoToml) || !fs.existsSync(mainRs)) {
+    return false;
+  }
+  try {
+    return fs.readFileSync(cargoToml, "utf8").includes('name = "thronglets"');
+  } catch {
+    return false;
+  }
+}
+
+function findRepoRoot() {
+  const envRoot = process.env.THRONGLETS_REPO_ROOT;
+  if (envRoot && looksLikeRepoRoot(envRoot)) {
+    return envRoot;
+  }
+
+  let current = process.cwd();
+  while (true) {
+    if (looksLikeRepoRoot(current)) {
+      return current;
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+}
+
+function tryRepoLocal(repoRoot) {
+  const cargo = process.platform === "win32" ? "cargo.exe" : "cargo";
+  const builtBinary =
+    process.platform === "win32"
+      ? path.join(repoRoot, "target", "debug", "thronglets.exe")
+      : path.join(repoRoot, "target", "debug", "thronglets");
+
+  try {
+    execFileSync(cargo, ["run", "--quiet", "--manifest-path", path.join(repoRoot, "Cargo.toml"), "--", ...process.argv.slice(2)], {
+      stdio: "inherit",
+    });
+    return true;
+  } catch (err) {
+    if (err.code === "ENOENT" && fs.existsSync(builtBinary)) {
+      execFileSync(builtBinary, process.argv.slice(2), { stdio: "inherit" });
+      return true;
+    }
+    if (typeof err.status === "number") {
+      process.exit(err.status || 1);
+    }
+  }
+
+  return false;
+}
+
 try {
+  const repoRoot = findRepoRoot();
+  if (repoRoot && tryRepoLocal(repoRoot)) {
+    process.exit(0);
+  }
   execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
 } catch (err) {
   process.exit(err.status || 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thronglets",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "Local AI substrate for agents with sparse signals, hooks, and optional adapters",
   "keywords": [
     "ai-agents",