@efficient-erp/cli 0.0.0 → 1.140.1

package/LICENSE

@@ -0,0 +1,10 @@
+Copyright (c) 2026 Efficient Pty Ltd. All rights reserved.
+
+This software and its documentation are proprietary to Efficient Pty Ltd and
+are confidential. No licence is granted to use, copy, modify, merge, publish,
+distribute, sublicense or sell this software, in whole or in part, except
+under a written agreement with Efficient Pty Ltd.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

package/README.md

@@ -1,5 +1,26 @@
 # @efficient-erp/cli
 
-Placeholder that claims the name. The first efficient-cli release published by CI replaces it; install `@efficient-erp/cli`.
+`efficient`, the command-line client for the EFFICIENT ERP API: everything the
+web portals can do, over plain HTTP, for AI agents and for people who prefer a
+terminal. Every request goes through the same permission-checked, audit-logged
+API the portals use, as the user who signed in.
 
-Copyright (c) 2026 Efficient Pty Ltd. All rights reserved.
+```bash
+npm install -g @efficient-erp/cli
+efficient profile add work --url https://<your-tenant-host> --default
+efficient login --email you@company.com
+efficient guide
+```
+
+Prebuilt for macOS on Apple silicon, Linux x64 (glibc 2.34 or newer) and
+Windows x64. npm installs only the binary for your machine. There is no npm
+build for Intel Macs.
+
+To let an MCP host with no shell (Claude Desktop, Cursor chat) drive it:
+
+```json
+{ "mcpServers": { "efficient": { "command": "npx", "args": ["-y", "@efficient-erp/cli", "mcp"] } } }
+```
+
+Copyright (c) 2026 Efficient Pty Ltd. All rights reserved. Use requires an
+EFFICIENT account and is subject to your agreement with Efficient Pty Ltd.

package/bin/efficient.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+'use strict';
+
+// The `efficient` command npm puts on PATH. The CLI itself is a native binary
+// in a per-platform package, @efficient-erp/cli-<platform>-<arch>; npm installs
+// only the one whose `os`/`cpu` match this machine, and this file runs it with
+// the same arguments, stdio and exit status. Built by npm/pack.mjs.
+
+const { spawnSync } = require('node:child_process');
+const { accessSync, chmodSync, constants } = require('node:fs');
+const { dirname, join } = require('node:path');
+
+const platformPackage = `@efficient-erp/cli-${process.platform}-${process.arch}`;
+const exe = process.platform === 'win32' ? 'efficient.exe' : 'efficient';
+
+let binary;
+try {
+  binary = join(dirname(require.resolve(`${platformPackage}/package.json`)), 'bin', exe);
+} catch {
+  const supported = Object.keys(require('../package.json').optionalDependencies || {})
+    .map((name) => name.replace('@efficient-erp/cli-', ''))
+    .join(', ');
+  console.error(`efficient: no binary for ${process.platform}-${process.arch} (${platformPackage} is not installed).`);
+  console.error(`Built for: ${supported}. On one of those, reinstall without --omit=optional / --no-optional.`);
+  process.exit(1);
+}
+
+// npm keeps the executable bit, but an unpacker that drops it would leave a
+// binary that fails with EACCES. Put it back rather than fail.
+if (process.platform !== 'win32') {
+  try {
+    accessSync(binary, constants.X_OK);
+  } catch {
+    try { chmodSync(binary, 0o755); } catch { /* the spawn below reports it */ }
+  }
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: 'inherit', windowsHide: false });
+if (result.error) {
+  console.error(`efficient: could not run ${binary}: ${result.error.message}`);
+  process.exit(1);
+}
+if (result.signal) process.kill(process.pid, result.signal);
+process.exit(result.status ?? 1);

package/package.json

@@ -1,11 +1,27 @@
 {
   "name": "@efficient-erp/cli",
-  "version": "0.0.0",
-  "description": "efficient: the command-line client for the EFFICIENT ERP API. Name placeholder; the first release replaces it.",
+  "version": "1.140.1",
+  "description": "efficient: the command-line client for the EFFICIENT ERP API",
   "license": "UNLICENSED",
   "author": "Efficient Pty Ltd",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Efficient-Pty-Ltd/efficient-cli.git"
+  },
+  "bin": {
+    "efficient": "bin/efficient.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@efficient-erp/cli-darwin-arm64": "1.140.1",
+    "@efficient-erp/cli-linux-x64": "1.140.1",
+    "@efficient-erp/cli-win32-x64": "1.140.1"
   }
-}
+}