planr 1.10.0-alpha.8 → 1.10.0-alpha.9

package/docs/ARCHITECTURE.md

@@ -117,10 +117,10 @@ The frozen product contract lives in `docs/contracts/EVAL_CONTRACT_V1.md` until
 
 Planr remains a single crate for V1 because:
 
-- there is one deployable binary and no separate service or reusable library boundary;
+- one crate owns the CLI and its optional companion executables;
 - the current behavior contract is tighter when CLI, MCP, HTTP, storage, and docs ship together;
 - module-level ownership gives the needed architecture separation without duplicating Cargo settings or release packaging;
-- npm, release, and external consumer tests assume one native binary named `planr`.
+- npm, release, and external consumer tests treat `planr` as the product entry point. They also package provider-specific companion executables when Planr ships them.
 
 A Cargo workspace was tried and reverted: it produced anemic crates whose only job was being a layer, plus re-export shims in the binary. A workspace should be introduced only after a concrete deployable, reuse, compilation, or team ownership boundary exists and package/release scripts are updated in the same change.
 

package/docs/RELEASE.md

@@ -202,6 +202,7 @@ cat dist/planr-*/SHA256SUMS
 The artifact contains:
 
 - `planr`
+- `planr-browser-harness-adapter`
 - `scripts/host-capability-experiment.mjs`
 - `scripts/host-capability-runtime/v1/schemas/*.schema.json`
 - `scripts/planr-host-capability-validator`
@@ -228,6 +229,8 @@ npm pack --dry-run
 The package must include:
 
 - `npm/bin/planr.js`
+- `npm/bin/planr-browser-harness-adapter.js`
+- `npm/bin/native-launcher.js`
 - `scripts/host-capability-experiment.mjs`
 - `scripts/host-capability-runtime/v1/schemas/*.schema.json`
 - `scripts/planr-host-capability-validator`
@@ -237,7 +240,7 @@ The package must include:
 - `README.md`
 - `LICENSE.md`
 
-`npm/native/` platform binaries exist only in the `npm-publish` CI job; the local dry-run does not include them.
+`npm/native/` platform binaries exist only in the `npm-publish` CI job. The published package includes `planr`, `planr-browser-harness-adapter`, and `planr-host-capability-validator` for each platform. The local dry-run does not include these binaries.
 
 ## Install Smoke
 

package/npm/bin/native-launcher.js

@@ -0,0 +1,67 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(here, "..", "..");
+
+function platformTarget() {
+  const osName = { darwin: "darwin", linux: "linux" }[os.platform()];
+  const arch = { arm64: "arm64", x64: "x86_64" }[os.arch()];
+  if (!osName || !arch) return null;
+  return `${osName}-${arch}`;
+}
+
+function repositoryBuildCandidates(binaryName) {
+  if (!fs.existsSync(path.join(packageRoot, "Cargo.toml"))) return [];
+  const metadata = spawnSync(
+    "cargo",
+    ["metadata", "--no-deps", "--format-version", "1"],
+    { cwd: packageRoot, encoding: "utf8" },
+  );
+  if (metadata.status !== 0) return [];
+  try {
+    const targetDirectory = JSON.parse(metadata.stdout).target_directory;
+    if (typeof targetDirectory !== "string" || targetDirectory.length === 0) return [];
+    return [
+      path.join(targetDirectory, "release", binaryName),
+      path.join(targetDirectory, "debug", binaryName),
+    ];
+  } catch {
+    return [];
+  }
+}
+
+export function runNative({ binaryName, overrideEnvironment, productName }) {
+  const target = platformTarget();
+  const packagedCandidates = [
+    process.env[overrideEnvironment],
+    target && path.join(here, "..", "native", target, binaryName),
+  ].filter(Boolean);
+  const binary = packagedCandidates.find(candidate => fs.existsSync(candidate))
+    ?? repositoryBuildCandidates(binaryName).find(candidate => fs.existsSync(candidate));
+
+  if (!binary) {
+    if (!target) {
+      console.error(`${productName} has no native binary for ${os.platform()}-${os.arch()}.`);
+      console.error("Supported platforms: darwin-arm64, darwin-x86_64, linux-x86_64, linux-arm64.");
+    } else {
+      console.error(`${productName} native binary was not found.`);
+      console.error(`Build it with: cargo build --release --bin ${binaryName}`);
+      console.error(`Or set ${overrideEnvironment}=/absolute/path/to/${binaryName}`);
+    }
+    process.exit(127);
+  }
+
+  const result = spawnSync(binary, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  process.exit(result.status ?? 0);
+}

package/npm/bin/planr-browser-harness-adapter.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { runNative } from "./native-launcher.js";
+
+runNative({
+  binaryName: "planr-browser-harness-adapter",
+  overrideEnvironment: "PLANR_BROWSER_HARNESS_ADAPTER_BIN",
+  productName: "Planr Browser Harness adapter",
+});

package/npm/bin/planr.js

@@ -1,78 +1,8 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { runNative } from "./native-launcher.js";
 
-const here = path.dirname(fileURLToPath(import.meta.url));
-const packageRoot = path.resolve(here, "..", "..");
-
-function platformTarget() {
-  const osName = { darwin: "darwin", linux: "linux" }[os.platform()];
-  const arch = { arm64: "arm64", x64: "x86_64" }[os.arch()];
-  if (!osName || !arch) {
-    return null;
-  }
-  return `${osName}-${arch}`;
-}
-
-const target = platformTarget();
-const packagedCandidates = [
-  process.env.PLANR_NATIVE_BIN,
-  // Published package: per-platform binaries bundled at release time.
-  target && path.join(here, "..", "native", target, "planr"),
-].filter(Boolean);
-
-function repositoryBuildCandidates() {
-  if (!fs.existsSync(path.join(packageRoot, "Cargo.toml"))) {
-    return [];
-  }
-  const metadata = spawnSync(
-    "cargo",
-    ["metadata", "--no-deps", "--format-version", "1"],
-    { cwd: packageRoot, encoding: "utf8" },
-  );
-  if (metadata.status !== 0) {
-    return [];
-  }
-  try {
-    const targetDirectory = JSON.parse(metadata.stdout).target_directory;
-    if (typeof targetDirectory !== "string" || targetDirectory.length === 0) {
-      return [];
-    }
-    return [
-      path.join(targetDirectory, "release", "planr"),
-      path.join(targetDirectory, "debug", "planr"),
-    ];
-  } catch {
-    return [];
-  }
-}
-
-const binary = packagedCandidates.find(candidate => fs.existsSync(candidate))
-  ?? repositoryBuildCandidates().find(candidate => fs.existsSync(candidate));
-
-if (!binary) {
-  if (!target) {
-    console.error(`Planr has no native binary for ${os.platform()}-${os.arch()}.`);
-    console.error("Supported platforms: darwin-arm64, darwin-x86_64, linux-x86_64, linux-arm64.");
-  } else {
-    console.error("Planr native binary was not found.");
-    console.error("Build it with: cargo build --release");
-    console.error("Or set PLANR_NATIVE_BIN=/absolute/path/to/planr");
-  }
-  process.exit(127);
-}
-
-const result = spawnSync(binary, process.argv.slice(2), {
-  stdio: "inherit",
-  env: process.env,
+runNative({
+  binaryName: "planr",
+  overrideEnvironment: "PLANR_NATIVE_BIN",
+  productName: "Planr",
 });
-
-if (result.error) {
-  console.error(result.error.message);
-  process.exit(1);
-}
-
-process.exit(result.status ?? 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planr",
-  "version": "1.10.0-alpha.8",
+  "version": "1.10.0-alpha.9",
   "description": "Local-first planning and execution coordination for coding agents.",
   "license": "MIT",
   "repository": {
@@ -9,10 +9,11 @@
   },
   "type": "module",
   "bin": {
-    "planr": "npm/bin/planr.js"
+    "planr": "npm/bin/planr.js",
+    "planr-browser-harness-adapter": "npm/bin/planr-browser-harness-adapter.js"
   },
   "files": [
-    "npm/bin/planr.js",
+    "npm/bin",
     "npm/native",
     "scripts/host-capability-experiment.mjs",
     "scripts/host-capability-runtime",

package/plugins/planr/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "planr",
   "description": "Skill-driven planning and execution loop for coding agents: one planr entry point, an autonomous planr-loop, and evidence-backed task graph skills powered by the planr CLI.",
-  "version": "1.10.0-alpha.8",
+  "version": "1.10.0-alpha.9",
   "author": {
     "name": "instructa"
   },

package/plugins/planr/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "planr",
-  "version": "1.10.0-alpha.8",
+  "version": "1.10.0-alpha.9",
   "description": "Skill-driven planning and execution loop for coding agents: one $planr entry point, an autonomous $planr-loop, and evidence-backed task graph skills powered by the planr CLI.",
   "author": {
     "name": "instructa",