flowproof 0.0.1 → 0.6.1

package/README.md

@@ -1,10 +1,21 @@
 # flowproof
 
-AI-native E2E testing for the apps Selenium can't reach.
+Run your AI agent once, keep the recording, and assert against it from then
+on. flowproof captures the run at the model boundary - every request and
+every tool-call decision - and serves it back on later runs, so replay makes
+**zero LLM calls**. You assert which tools were called, with which arguments,
+in which order, and which were not. The same engine drives web, desktop and
+Citrix.
 
-FlowProof is an open-source, AI-native end-to-end testing framework for
-enterprise Windows apps (SAP GUI, Oracle, Citrix, legacy desktop). AI authors
-and heals tests; a deterministic engine replays them in CI.
+This package ships the `flowproof` CLI as platform-native binaries
+(linux-x64, darwin-x64/arm64, win32-x64) — no Python required:
 
-**This is a placeholder release** reserving the package name. Follow
-development at [github.com/automators-com/flowproof](https://github.com/automators-com/flowproof).
+```bash
+npx flowproof --version
+npx flowproof record my.flow.yaml
+npx flowproof run specs/
+```
+
+The Python SDK (`pip install flowproof`) remains the primary SDK and
+adds the programmatic API and MCP server. Docs and source:
+[github.com/automators-com/flowproof](https://github.com/automators-com/flowproof)

package/bin/flowproof.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// Thin launcher: the real `flowproof` CLI is a platform-native Rust binary
+// shipped in a per-platform optional dependency; this resolves the right
+// one and passes everything through untouched.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+// Scoped names: the unscoped ones tripped npm's spam heuristic for new
+// packages and could not be published at all. Keep these in step with
+// package.json's optionalDependencies - test/launcher.test.js fails if they
+// drift, because a mismatch here is an "unsupported platform" error for a
+// platform that is actually supported.
+const PLATFORM_PACKAGES = {
+  "linux-x64": "@automators/flowproof-cli-linux-x64",
+  "darwin-x64": "@automators/flowproof-cli-darwin-x64",
+  "darwin-arm64": "@automators/flowproof-cli-darwin-arm64",
+  "win32-x64": "@automators/flowproof-cli-win32-x64",
+};
+
+function binaryPath() {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = PLATFORM_PACKAGES[key];
+  if (!pkg) {
+    console.error(
+      `flowproof: no prebuilt binary for ${key}.\n` +
+        `Supported: ${Object.keys(PLATFORM_PACKAGES).join(", ")}.\n` +
+        `On other platforms, install via pip instead: pip install flowproof`
+    );
+    process.exit(2);
+  }
+  const file = process.platform === "win32" ? "flowproof.exe" : "flowproof";
+  try {
+    return path.join(path.dirname(require.resolve(`${pkg}/package.json`)), file);
+  } catch {
+    console.error(
+      `flowproof: platform package ${pkg} is not installed.\n` +
+        `Your package manager may have skipped optional dependencies — ` +
+        `reinstall without --no-optional (or use: pip install flowproof).`
+    );
+    process.exit(2);
+  }
+}
+
+const result = spawnSync(binaryPath(), process.argv.slice(2), {
+  stdio: "inherit",
+});
+if (result.error) {
+  console.error(`flowproof: failed to start the native binary: ${result.error.message}`);
+  process.exit(2);
+}
+process.exit(result.status === null ? 2 : result.status);

package/index.js

@@ -1,13 +1,6 @@
-/**
- * FlowProof — AI-native E2E testing for the apps Selenium can't reach.
- *
- * Open-source AI-native E2E testing framework for enterprise Windows apps
- * (SAP GUI, Oracle, Citrix, legacy desktop). AI authors and heals tests;
- * a deterministic engine replays them in CI.
- *
- * This is a placeholder release. See https://github.com/automators-com/flowproof
- */
-
-module.exports = {
-  version: "0.0.1",
-};
+// CLI-only distribution: the `flowproof` command (bin/flowproof.js) runs a
+// platform-native binary from the optional dependencies. For a
+// programmatic API use the Python SDK — `pip install flowproof` — which is
+// the primary SDK.
+"use strict";
+module.exports = {};

package/package.json

@@ -1,23 +1,37 @@
 {
   "name": "flowproof",
-  "version": "0.0.1",
-  "description": "AI-native E2E testing for the apps Selenium can't reach. Placeholder release — see github.com/automators-com/flowproof",
-  "main": "index.js",
+  "version": "0.6.1",
+  "description": "Deterministic tests for AI agents: record a run once, replay it with zero LLM calls. Assert which tools an agent called, with which arguments, in which order.",
+  "bin": {
+    "flowproof": "bin/flowproof.js"
+  },
   "files": [
+    "bin/flowproof.js",
     "index.js"
   ],
+  "main": "index.js",
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@automators/flowproof-cli-linux-x64": "0.6.1",
+    "@automators/flowproof-cli-darwin-x64": "0.6.1",
+    "@automators/flowproof-cli-darwin-arm64": "0.6.1",
+    "@automators/flowproof-cli-win32-x64": "0.6.1"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/automators-com/flowproof.git"
   },
   "homepage": "https://github.com/automators-com/flowproof",
   "keywords": [
-    "e2e",
+    "test-automation",
     "testing",
+    "automation",
+    "ai-agents",
     "sap-gui",
     "citrix",
-    "windows",
-    "automation"
+    "windows"
   ],
   "author": "Automators <hello@automators.com>",
   "license": "Apache-2.0"