duhem 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# duhem
+
+The command-line interface for [Duhem](https://github.com/onsager-ai/duhem) —
+a holistic verification platform for AI-delivered software.
+
+## Install
+
+```bash
+npm install -g duhem
+# or run without installing
+npx duhem --help
+```
+
+This package is a thin launcher. The real binary ships per-platform via an
+optional dependency (`@duhem/cli-<os>-<arch>`); npm installs only the one
+matching your machine. Prebuilt targets: linux-x64, linux-arm64, darwin-x64,
+darwin-arm64, windows-x64.
+
+Prebuilt binaries are also attached to each
+[GitHub Release](https://github.com/onsager-ai/duhem/releases).
+
+## Usage
+
+```bash
+duhem init        # scaffold a Verification Definition
+duhem validate    # validate VDs / manifest against the schema
+duhem run         # run a verification and emit a verdict
+duhem dashboard   # serve / export the run dashboard
+duhem --version
+```
+
+See the [project README](https://github.com/onsager-ai/duhem#readme) for the
+full documentation.
+
+## License
+
+Apache-2.0

package/bin.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+/**
+ * bin.js — entry point for the `duhem` CLI installed from npm.
+ *
+ * The npm `duhem` package is a thin JS launcher. The actual Rust binary
+ * ships in a per-platform optional dependency (`@duhem/cli-<os>-<arch>`);
+ * npm installs only the one matching the host at install time. This
+ * launcher resolves that package, locates the binary inside it, and execs
+ * it with all CLI arguments forwarded and the exit code preserved.
+ *
+ * Architecture: rust-npm-publish skill (optionalDependencies platform
+ * packages, same pattern as esbuild / swc / turbo).
+ */
+
+const { execFileSync } = require('node:child_process');
+const { join } = require('node:path');
+
+// Map Node's `${process.platform}-${process.arch}` to the platform package.
+// NOTE: `process.platform` is `win32` (not `windows`); the package name uses
+// `windows`. Keep this table in sync with npm/platforms/* and the
+// optionalDependencies in npm/duhem/package.json.
+const PLATFORM_PACKAGES = {
+  'linux-x64': '@duhem/cli-linux-x64',
+  'linux-arm64': '@duhem/cli-linux-arm64',
+  'darwin-x64': '@duhem/cli-darwin-x64',
+  'darwin-arm64': '@duhem/cli-darwin-arm64',
+  'win32-x64': '@duhem/cli-windows-x64',
+};
+
+function resolveBinary() {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = PLATFORM_PACKAGES[key];
+
+  if (!pkg) {
+    const supported = Object.keys(PLATFORM_PACKAGES)
+      .map((k) => `  - ${k}`)
+      .join('\n');
+    console.error(
+      `duhem: unsupported platform "${key}".\n\n` +
+        `Prebuilt binaries are published for:\n${supported}\n\n` +
+        'Build from source instead: https://github.com/onsager-ai/duhem',
+    );
+    process.exit(1);
+  }
+
+  try {
+    // require.resolve the platform package's manifest, then read `main`
+    // to find the binary file shipped alongside it.
+    const manifestPath = require.resolve(`${pkg}/package.json`);
+    const manifest = require(`${pkg}/package.json`);
+    return join(manifestPath, '..', manifest.main);
+  } catch {
+    console.error(
+      `duhem: the platform package "${pkg}" for ${key} is not installed.\n\n` +
+        'This usually means the optional dependency was skipped at install\n' +
+        'time (e.g. --no-optional, --omit=optional, or an offline mirror).\n\n' +
+        'Try reinstalling:\n  npm install -g duhem\n\n' +
+        'or install the platform package directly:\n' +
+        `  npm install ${pkg}`,
+    );
+    process.exit(1);
+  }
+}
+
+const binary = resolveBinary();
+
+try {
+  execFileSync(binary, process.argv.slice(2), { stdio: 'inherit' });
+} catch (error) {
+  // execFileSync throws on a non-zero exit — forward the child's exit code.
+  if (error && typeof error.status === 'number') {
+    process.exit(error.status);
+  }
+  // No status (e.g. binary missing exec bit, ENOENT) — surface and fail.
+  console.error(`duhem: failed to execute ${binary}: ${error && error.message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "duhem",
+  "version": "0.1.0",
+  "description": "Holistic verification platform for AI-delivered software — the `duhem` CLI.",
+  "license": "Apache-2.0",
+  "bin": {
+    "duhem": "bin.js"
+  },
+  "files": [
+    "bin.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "duhem",
+    "verification",
+    "acceptance-criteria",
+    "ai",
+    "testing",
+    "cli"
+  ],
+  "homepage": "https://github.com/onsager-ai/duhem#readme",
+  "bugs": {
+    "url": "https://github.com/onsager-ai/duhem/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/onsager-ai/duhem.git"
+  },
+  "optionalDependencies": {
+    "@duhem/cli-linux-x64": "0.1.0",
+    "@duhem/cli-linux-arm64": "0.1.0",
+    "@duhem/cli-darwin-x64": "0.1.0",
+    "@duhem/cli-darwin-arm64": "0.1.0",
+    "@duhem/cli-windows-x64": "0.1.0"
+  }
+}