plenum 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.gitignore ADDED
@@ -0,0 +1,2 @@
1
+ /node_modules
2
+
package/CHANGELOG.md ADDED
@@ -0,0 +1,27 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ### Added
11
+ - Initial implementation of plenum CLI
12
+ - `connect` command for connection configuration management
13
+ - `introspect` command for database schema inspection
14
+ - `query` command for constrained query execution
15
+ - Support for PostgreSQL, MySQL, and SQLite databases
16
+ - Capability model with least-privilege execution
17
+ - JSON output format for all commands
18
+ - Configuration storage (local and global)
19
+
20
+ ## [0.1.0] - TBD
21
+
22
+ ### Added
23
+ - Initial release
24
+ - Core CLI framework and command structure
25
+ - Database engine trait definitions
26
+ - Configuration management system
27
+ - Capability enforcement model
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Plenum Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,356 @@
1
+ # Plenum
2
+
3
+ **Agent-first database control CLI with least-privilege execution**
4
+
5
+ Plenum is a lightweight, deterministic database control tool designed specifically for autonomous AI coding agents. It provides a constrained, safe execution surface for database operations with read-only defaults and explicit capability requirements.
6
+
7
+ > **This is not a human-oriented database client.** If you're looking for a tool with interactive shells, autocomplete, or pretty-printed output, Plenum is not for you.
8
+
9
+ ## What is Plenum?
10
+
11
+ Plenum enables AI agents to:
12
+ - **Introspect database schemas** safely and deterministically
13
+ - **Execute constrained SQL queries** with explicit permission requirements
14
+ - **Maintain least-privilege access** with read-only mode as default
15
+ - **Produce machine-parseable output** (JSON-only to stdout)
16
+
17
+ Plenum is exposed via a local MCP (Model Context Protocol) server, making it seamlessly integrable with AI agent frameworks.
18
+
19
+ ## Key Features
20
+
21
+ - **Agent-First Design**: JSON-only output, no interactive UX, deterministic behavior
22
+ - **Vendor-Specific SQL**: No query abstraction layer - PostgreSQL SQL ≠ MySQL SQL ≠ SQLite SQL
23
+ - **Explicit Capabilities**: Read-only by default, writes and DDL require explicit flags
24
+ - **Stateless Execution**: No persistent connections, no caching, no implicit state
25
+ - **Three Database Engines**: PostgreSQL, MySQL, and SQLite support (first-class, equally constrained)
26
+
27
+ ## Installation
28
+
29
+ ### From Source
30
+
31
+ ```bash
32
+ git clone https://github.com/yourusername/plenum.git
33
+ cd plenum
34
+ cargo build --release
35
+ ./target/release/plenum --help
36
+ ```
37
+
38
+ ### System Requirements
39
+
40
+ - Rust 1.70 or later
41
+ - Supported platforms: Linux, macOS, Windows
42
+
43
+ ## Usage
44
+
45
+ Plenum provides exactly three commands:
46
+
47
+ ### 1. `plenum connect` - Configure Database Connections
48
+
49
+ Manage database connection configurations (interactive or non-interactive):
50
+
51
+ ```bash
52
+ # Interactive connection picker
53
+ plenum connect
54
+
55
+ # Create new connection interactively
56
+ plenum connect --name prod --engine postgres --host db.example.com \
57
+ --port 5432 --user readonly --password secret --database myapp \
58
+ --save global
59
+
60
+ # Validate existing connection
61
+ plenum connect --name prod
62
+ ```
63
+
64
+ Connection configurations are stored:
65
+ - **Local**: `.plenum/config.json` (team-shareable)
66
+ - **Global**: `~/.config/plenum/connections.json` (per-user)
67
+
68
+ ### 2. `plenum introspect` - Schema Introspection
69
+
70
+ Inspect database schema and return structured JSON:
71
+
72
+ ```bash
73
+ # Introspect using named connection
74
+ plenum introspect --name prod
75
+
76
+ # Introspect with explicit parameters
77
+ plenum introspect --engine postgres --host localhost --port 5432 \
78
+ --user admin --password secret --database mydb
79
+
80
+ # Introspect specific schema
81
+ plenum introspect --name prod --schema public
82
+ ```
83
+
84
+ Returns JSON with:
85
+ - Tables
86
+ - Columns (name, type, nullable)
87
+ - Primary keys
88
+ - Foreign keys
89
+ - Indexes
90
+
91
+ ### 3. `plenum query` - Constrained Query Execution
92
+
93
+ Execute SQL queries with explicit capability requirements:
94
+
95
+ ```bash
96
+ # Read-only query (default, no flags needed)
97
+ plenum query --name prod --sql "SELECT * FROM users WHERE id = 1"
98
+
99
+ # Write query (requires --allow-write)
100
+ plenum query --name prod --sql "UPDATE users SET name = 'Alice' WHERE id = 1" \
101
+ --allow-write
102
+
103
+ # DDL query (requires --allow-ddl, which implies write)
104
+ plenum query --name prod --sql "CREATE TABLE test (id INT PRIMARY KEY)" \
105
+ --allow-ddl
106
+
107
+ # With row limit and timeout
108
+ plenum query --name prod --sql "SELECT * FROM large_table" \
109
+ --max-rows 1000 --timeout-ms 5000
110
+ ```
111
+
112
+ **Capability Hierarchy:**
113
+ - **Read-only** (default): SELECT queries only
114
+ - **Write** (`--allow-write`): INSERT, UPDATE, DELETE (but NOT DDL)
115
+ - **DDL** (`--allow-ddl`): CREATE, DROP, ALTER, TRUNCATE (includes write)
116
+
117
+ ## Output Format
118
+
119
+ All commands output structured JSON to stdout:
120
+
121
+ **Success:**
122
+ ```json
123
+ {
124
+ "ok": true,
125
+ "engine": "postgres",
126
+ "command": "query",
127
+ "data": { ... },
128
+ "meta": {
129
+ "execution_ms": 42,
130
+ "rows_returned": 10
131
+ }
132
+ }
133
+ ```
134
+
135
+ **Error:**
136
+ ```json
137
+ {
138
+ "ok": false,
139
+ "engine": "postgres",
140
+ "command": "query",
141
+ "error": {
142
+ "code": "CAPABILITY_VIOLATION",
143
+ "message": "DDL statements require --allow-ddl flag"
144
+ }
145
+ }
146
+ ```
147
+
148
+ ### Error Codes
149
+
150
+ Plenum returns stable, machine-parseable error codes. Agents should check the `error.code` field for programmatic error handling:
151
+
152
+ | Code | Description | When It Occurs |
153
+ |------|-------------|----------------|
154
+ | `CAPABILITY_VIOLATION` | Operation blocked by capability constraints | Attempting write/DDL operations without appropriate flags |
155
+ | `CONNECTION_FAILED` | Database connection failed | Invalid credentials, unreachable host, or database doesn't exist |
156
+ | `QUERY_FAILED` | Query execution failed | SQL syntax errors, missing tables/columns, constraint violations |
157
+ | `INVALID_INPUT` | Malformed input or missing parameters | Missing required flags, invalid engine type, etc. |
158
+ | `ENGINE_ERROR` | Engine-specific database error | Database-specific errors wrapped for consistency |
159
+ | `CONFIG_ERROR` | Configuration file or connection registry error | Missing config file, invalid JSON, connection name not found |
160
+
161
+ **Example error handling:**
162
+ ```json
163
+ {
164
+ "ok": false,
165
+ "engine": "postgres",
166
+ "command": "query",
167
+ "error": {
168
+ "code": "CAPABILITY_VIOLATION",
169
+ "message": "Write operations require --allow-write flag"
170
+ }
171
+ }
172
+ ```
173
+
174
+ Agents should:
175
+ 1. Check `ok` field first (true = success, false = error)
176
+ 2. Match on `error.code` for programmatic handling
177
+ 3. Use `error.message` for logging/debugging (agent-appropriate, no sensitive data)
178
+
179
+ ## MCP Integration
180
+
181
+ Plenum exposes functionality via MCP (Model Context Protocol) server:
182
+
183
+ ```bash
184
+ # Start MCP server (hidden command, for AI agent use)
185
+ plenum mcp
186
+ ```
187
+
188
+ Configure in your MCP client:
189
+ ```json
190
+ {
191
+ "mcpServers": {
192
+ "plenum": {
193
+ "command": "plenum",
194
+ "args": ["mcp"]
195
+ }
196
+ }
197
+ }
198
+ ```
199
+
200
+ Each CLI command maps to an MCP tool:
201
+ - `connect` → Validate and save database connections
202
+ - `introspect` → Retrieve schema information
203
+ - `query` → Execute constrained SQL queries
204
+
205
+ ## Architecture
206
+
207
+ Plenum is built around strict architectural principles:
208
+
209
+ ### Core Principles
210
+
211
+ 1. **No query language abstraction** - SQL remains vendor-specific
212
+ 2. **Agent-first, machine-only** - No interactive UX, JSON-only output
213
+ 3. **Explicit over implicit** - No inferred values, fail-fast on missing inputs
214
+ 4. **Least privilege** - Read-only default, explicit capability requirements
215
+ 5. **Determinism** - Identical inputs → identical outputs
216
+
217
+ ### Security Model
218
+
219
+ Plenum's security boundary is **capability-based access control**, not SQL validation.
220
+
221
+ **Plenum enforces:**
222
+ - ✅ Operation type restrictions (read-only, write, DDL)
223
+ - ✅ Row limits (`max_rows`) and query timeouts (`timeout_ms`)
224
+ - ✅ Pre-execution validation (no capability bypasses)
225
+ - ✅ Credential security (best-effort, no intentional logging)
226
+
227
+ **Plenum does NOT enforce:**
228
+ - ❌ SQL injection prevention (agent's responsibility)
229
+ - ❌ Query semantic correctness
230
+ - ❌ Business logic constraints
231
+ - ❌ Data access policies (row-level security, column masking)
232
+
233
+ **Critical**: Agents must sanitize all user inputs before constructing SQL. Plenum assumes SQL passed to it is safe and passes it verbatim to database drivers.
234
+
235
+ #### Credential Security
236
+
237
+ Credentials are stored as **plaintext JSON** in config files:
238
+ - Local: `.plenum/config.json` (team-shareable)
239
+ - Global: `~/.config/plenum/connections.json` (user-private)
240
+
241
+ **Recommendations:**
242
+ - Use `password_env` for production (environment variables)
243
+ - Secure config files with OS-level permissions (`chmod 600`)
244
+ - Avoid `--password` CLI flag (visible in process listings)
245
+
246
+ #### Security Reporting
247
+
248
+ For detailed security documentation, threat model, and vulnerability reporting, see **[SECURITY.md](SECURITY.md)**.
249
+
250
+ To report security vulnerabilities, create a GitHub issue with the `security` label.
251
+
252
+ ### Database Drivers
253
+
254
+ Plenum uses native, engine-specific drivers (NOT sqlx):
255
+ - **PostgreSQL**: `tokio-postgres`
256
+ - **MySQL**: `mysql_async`
257
+ - **SQLite**: `rusqlite`
258
+
259
+ This ensures maximum isolation between engines and preserves vendor-specific behavior.
260
+
261
+ ## Building from Source
262
+
263
+ ```bash
264
+ # Clone repository
265
+ git clone https://github.com/yourusername/plenum.git
266
+ cd plenum
267
+
268
+ # Build
269
+ cargo build --release
270
+
271
+ # Run tests
272
+ cargo test
273
+
274
+ # Check code quality
275
+ cargo fmt --check
276
+ cargo clippy --all-targets --all-features
277
+
278
+ # Install locally
279
+ cargo install --path .
280
+ ```
281
+
282
+ ## Development
283
+
284
+ See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.
285
+
286
+ ### Project Structure
287
+
288
+ ```
289
+ plenum/
290
+ ├── src/
291
+ │ ├── lib.rs # Library API for CLI and MCP
292
+ │ ├── main.rs # CLI entry point
293
+ │ ├── engine/ # Database engine implementations (Phase 3-5)
294
+ │ ├── capability/ # Capability validation (Phase 1.4)
295
+ │ ├── config/ # Configuration management (Phase 1.5)
296
+ │ ├── output/ # JSON output envelopes (Phase 1.2)
297
+ │ └── error/ # Error handling (Phase 1.3)
298
+ ├── CLAUDE.md # Core principles and architecture
299
+ ├── PROJECT_PLAN.md # Implementation roadmap
300
+ ├── RESEARCH.md # Design decisions and rationale
301
+ └── PROBLEMS.md # Resolved architectural issues
302
+ ```
303
+
304
+ ## Documentation
305
+
306
+ - [CLAUDE.md](CLAUDE.md) - Core principles and non-negotiable requirements
307
+ - [PROJECT_PLAN.md](PROJECT_PLAN.md) - Complete implementation roadmap
308
+ - [SECURITY.md](SECURITY.md) - Security model, threat analysis, and vulnerability reporting
309
+ - [RESEARCH.md](RESEARCH.md) - Design decisions, rationale, and research
310
+ - [PROBLEMS.md](PROBLEMS.md) - Architectural issues and resolutions
311
+ - [CONTRIBUTING.md](CONTRIBUTING.md) - Development guidelines
312
+
313
+ ## Roadmap
314
+
315
+ Plenum has completed **Phase 8: Security Audit**.
316
+
317
+ **Recent Accomplishments:**
318
+ - Phase 7: MCP Server implementation complete ✅
319
+ - Phase 8: Comprehensive security audit complete ✅
320
+ - Critical security fixes applied (password masking, path panic prevention)
321
+ - SECURITY.md documentation created
322
+
323
+ See [PROJECT_PLAN.md](PROJECT_PLAN.md) for the complete implementation roadmap:
324
+ - Phase 0: Project Foundation ✅
325
+ - Phase 1: Core Architecture ✅
326
+ - Phase 2: CLI Foundation ✅
327
+ - Phase 3: SQLite Engine ✅
328
+ - Phase 4: PostgreSQL Engine ✅
329
+ - Phase 5: MySQL Engine ✅
330
+ - Phase 6: Integration & Polish ✅
331
+ - Phase 7: MCP Server ✅
332
+ - Phase 8: Security Audit ✅
333
+ - Phase 9: Release Preparation ← **Next Phase**
334
+
335
+ ## Contributing
336
+
337
+ Contributions must adhere to Plenum's core principles. Before adding code, ask:
338
+
339
+ > **"Does this make autonomous agents safer, more deterministic, or more constrained?"**
340
+
341
+ If the answer is no, it does not belong in Plenum.
342
+
343
+ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
344
+
345
+ ## License
346
+
347
+ Licensed under either of:
348
+
349
+ - Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
350
+ - MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
351
+
352
+ at your option.
353
+
354
+ ## Acknowledgements
355
+
356
+ Plenum follows the architecture pattern established by [reflex-search](https://github.com/reflex-search/reflex) for MCP integration.
@@ -0,0 +1,212 @@
1
+ const { createWriteStream, existsSync, mkdirSync, mkdtemp } = require("fs");
2
+ const { join, sep } = require("path");
3
+ const { spawnSync } = require("child_process");
4
+ const { tmpdir } = require("os");
5
+
6
+ const axios = require("axios");
7
+ const rimraf = require("rimraf");
8
+ const tmpDir = tmpdir();
9
+
10
+ const error = (msg) => {
11
+ console.error(msg);
12
+ process.exit(1);
13
+ };
14
+
15
+ class Package {
16
+ constructor(platform, name, url, filename, zipExt, binaries) {
17
+ let errors = [];
18
+ if (typeof url !== "string") {
19
+ errors.push("url must be a string");
20
+ } else {
21
+ try {
22
+ new URL(url);
23
+ } catch (e) {
24
+ errors.push(e);
25
+ }
26
+ }
27
+ if (name && typeof name !== "string") {
28
+ errors.push("package name must be a string");
29
+ }
30
+ if (!name) {
31
+ errors.push("You must specify the name of your package");
32
+ }
33
+ if (binaries && typeof binaries !== "object") {
34
+ errors.push("binaries must be a string => string map");
35
+ }
36
+ if (!binaries) {
37
+ errors.push("You must specify the binaries in the package");
38
+ }
39
+
40
+ if (errors.length > 0) {
41
+ let errorMsg =
42
+ "One or more of the parameters you passed to the Binary constructor are invalid:\n";
43
+ errors.forEach((error) => {
44
+ errorMsg += error;
45
+ });
46
+ errorMsg +=
47
+ '\n\nCorrect usage: new Package("my-binary", "https://example.com/binary/download.tar.gz", {"my-binary": "my-binary"})';
48
+ error(errorMsg);
49
+ }
50
+
51
+ this.platform = platform;
52
+ this.url = url;
53
+ this.name = name;
54
+ this.filename = filename;
55
+ this.zipExt = zipExt;
56
+ this.installDirectory = join(__dirname, "node_modules", ".bin_real");
57
+ this.binaries = binaries;
58
+
59
+ if (!existsSync(this.installDirectory)) {
60
+ mkdirSync(this.installDirectory, { recursive: true });
61
+ }
62
+ }
63
+
64
+ exists() {
65
+ for (const binaryName in this.binaries) {
66
+ const binRelPath = this.binaries[binaryName];
67
+ const binPath = join(this.installDirectory, binRelPath);
68
+ if (!existsSync(binPath)) {
69
+ return false;
70
+ }
71
+ }
72
+ return true;
73
+ }
74
+
75
+ install(fetchOptions, suppressLogs = false) {
76
+ if (this.exists()) {
77
+ if (!suppressLogs) {
78
+ console.error(
79
+ `${this.name} is already installed, skipping installation.`,
80
+ );
81
+ }
82
+ return Promise.resolve();
83
+ }
84
+
85
+ if (existsSync(this.installDirectory)) {
86
+ rimraf.sync(this.installDirectory);
87
+ }
88
+
89
+ mkdirSync(this.installDirectory, { recursive: true });
90
+
91
+ if (!suppressLogs) {
92
+ console.error(`Downloading release from ${this.url}`);
93
+ }
94
+
95
+ return axios({ ...fetchOptions, url: this.url, responseType: "stream" })
96
+ .then((res) => {
97
+ return new Promise((resolve, reject) => {
98
+ mkdtemp(`${tmpDir}${sep}`, (err, directory) => {
99
+ let tempFile = join(directory, this.filename);
100
+ const sink = res.data.pipe(createWriteStream(tempFile));
101
+ sink.on("error", (err) => reject(err));
102
+ sink.on("close", () => {
103
+ if (/\.tar\.*/.test(this.zipExt)) {
104
+ const result = spawnSync("tar", [
105
+ "xf",
106
+ tempFile,
107
+ // The tarballs are stored with a leading directory
108
+ // component; we strip one component in the
109
+ // shell installers too.
110
+ "--strip-components",
111
+ "1",
112
+ "-C",
113
+ this.installDirectory,
114
+ ]);
115
+ if (result.status == 0) {
116
+ resolve();
117
+ } else if (result.error) {
118
+ reject(result.error);
119
+ } else {
120
+ reject(
121
+ new Error(
122
+ `An error occurred untarring the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
123
+ ),
124
+ );
125
+ }
126
+ } else if (this.zipExt == ".zip") {
127
+ let result;
128
+ if (this.platform.artifactName.includes("windows")) {
129
+ // Windows does not have "unzip" by default on many installations, instead
130
+ // we use Expand-Archive from powershell
131
+ result = spawnSync("powershell.exe", [
132
+ "-NoProfile",
133
+ "-NonInteractive",
134
+ "-Command",
135
+ `& {
136
+ param([string]$LiteralPath, [string]$DestinationPath)
137
+ Expand-Archive -LiteralPath $LiteralPath -DestinationPath $DestinationPath -Force
138
+ }`,
139
+ tempFile,
140
+ this.installDirectory,
141
+ ]);
142
+ } else {
143
+ result = spawnSync("unzip", [
144
+ "-q",
145
+ tempFile,
146
+ "-d",
147
+ this.installDirectory,
148
+ ]);
149
+ }
150
+
151
+ if (result.status == 0) {
152
+ resolve();
153
+ } else if (result.error) {
154
+ reject(result.error);
155
+ } else {
156
+ reject(
157
+ new Error(
158
+ `An error occurred unzipping the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
159
+ ),
160
+ );
161
+ }
162
+ } else {
163
+ reject(
164
+ new Error(`Unrecognized file extension: ${this.zipExt}`),
165
+ );
166
+ }
167
+ });
168
+ });
169
+ });
170
+ })
171
+ .then(() => {
172
+ if (!suppressLogs) {
173
+ console.error(`${this.name} has been installed!`);
174
+ }
175
+ })
176
+ .catch((e) => {
177
+ error(`Error fetching release: ${e.message}`);
178
+ });
179
+ }
180
+
181
+ run(binaryName, fetchOptions) {
182
+ const promise = !this.exists()
183
+ ? this.install(fetchOptions, true)
184
+ : Promise.resolve();
185
+
186
+ promise
187
+ .then(() => {
188
+ const [, , ...args] = process.argv;
189
+
190
+ const options = { cwd: process.cwd(), stdio: "inherit" };
191
+
192
+ const binRelPath = this.binaries[binaryName];
193
+ if (!binRelPath) {
194
+ error(`${binaryName} is not a known binary in ${this.name}`);
195
+ }
196
+ const binPath = join(this.installDirectory, binRelPath);
197
+ const result = spawnSync(binPath, args, options);
198
+
199
+ if (result.error) {
200
+ error(result.error);
201
+ }
202
+
203
+ process.exit(result.status);
204
+ })
205
+ .catch((e) => {
206
+ error(e.message);
207
+ process.exit(1);
208
+ });
209
+ }
210
+ }
211
+
212
+ module.exports.Package = Package;
package/binary.js ADDED
@@ -0,0 +1,126 @@
1
+ const { Package } = require("./binary-install");
2
+ const os = require("os");
3
+ const cTable = require("console.table");
4
+ const libc = require("detect-libc");
5
+ const { configureProxy } = require("axios-proxy-builder");
6
+
7
+ const error = (msg) => {
8
+ console.error(msg);
9
+ process.exit(1);
10
+ };
11
+
12
+ const {
13
+ name,
14
+ artifactDownloadUrl,
15
+ supportedPlatforms,
16
+ glibcMinimum,
17
+ } = require("./package.json");
18
+
19
+ const builderGlibcMajorVersion = glibcMinimum.major;
20
+ const builderGlibcMInorVersion = glibcMinimum.series;
21
+
22
+ const getPlatform = () => {
23
+ const rawOsType = os.type();
24
+ const rawArchitecture = os.arch();
25
+
26
+ // We want to use rust-style target triples as the canonical key
27
+ // for a platform, so translate the "os" library's concepts into rust ones
28
+ let osType = "";
29
+ switch (rawOsType) {
30
+ case "Windows_NT":
31
+ osType = "pc-windows-msvc";
32
+ break;
33
+ case "Darwin":
34
+ osType = "apple-darwin";
35
+ break;
36
+ case "Linux":
37
+ osType = "unknown-linux-gnu";
38
+ break;
39
+ }
40
+
41
+ let arch = "";
42
+ switch (rawArchitecture) {
43
+ case "x64":
44
+ arch = "x86_64";
45
+ break;
46
+ case "arm64":
47
+ arch = "aarch64";
48
+ break;
49
+ }
50
+
51
+ if (rawOsType === "Linux") {
52
+ if (libc.familySync() == "musl") {
53
+ osType = "unknown-linux-musl-dynamic";
54
+ } else if (libc.isNonGlibcLinuxSync()) {
55
+ console.warn(
56
+ "Your libc is neither glibc nor musl; trying static musl binary instead",
57
+ );
58
+ osType = "unknown-linux-musl-static";
59
+ } else {
60
+ let libcVersion = libc.versionSync();
61
+ let splitLibcVersion = libcVersion.split(".");
62
+ let libcMajorVersion = splitLibcVersion[0];
63
+ let libcMinorVersion = splitLibcVersion[1];
64
+ if (
65
+ libcMajorVersion != builderGlibcMajorVersion ||
66
+ libcMinorVersion < builderGlibcMInorVersion
67
+ ) {
68
+ // We can't run the glibc binaries, but we can run the static musl ones
69
+ // if they exist
70
+ console.warn(
71
+ "Your glibc isn't compatible; trying static musl binary instead",
72
+ );
73
+ osType = "unknown-linux-musl-static";
74
+ }
75
+ }
76
+ }
77
+
78
+ // Assume the above succeeded and build a target triple to look things up with.
79
+ // If any of it failed, this lookup will fail and we'll handle it like normal.
80
+ let targetTriple = `${arch}-${osType}`;
81
+ let platform = supportedPlatforms[targetTriple];
82
+
83
+ if (!platform) {
84
+ error(
85
+ `Platform with type "${rawOsType}" and architecture "${rawArchitecture}" is not supported by ${name}.\nYour system must be one of the following:\n\n${Object.keys(
86
+ supportedPlatforms,
87
+ ).join(",")}`,
88
+ );
89
+ }
90
+
91
+ return platform;
92
+ };
93
+
94
+ const getPackage = () => {
95
+ const platform = getPlatform();
96
+ const url = `${artifactDownloadUrl}/${platform.artifactName}`;
97
+ let filename = platform.artifactName;
98
+ let ext = platform.zipExt;
99
+ let binary = new Package(platform, name, url, filename, ext, platform.bins);
100
+
101
+ return binary;
102
+ };
103
+
104
+ const install = (suppressLogs) => {
105
+ if (!artifactDownloadUrl || artifactDownloadUrl.length === 0) {
106
+ console.warn("in demo mode, not installing binaries");
107
+ return;
108
+ }
109
+ const package = getPackage();
110
+ const proxy = configureProxy(package.url);
111
+
112
+ return package.install(proxy, suppressLogs);
113
+ };
114
+
115
+ const run = (binaryName) => {
116
+ const package = getPackage();
117
+ const proxy = configureProxy(package.url);
118
+
119
+ package.run(binaryName, proxy);
120
+ };
121
+
122
+ module.exports = {
123
+ install,
124
+ run,
125
+ getPackage,
126
+ };
package/install.js ADDED
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+
3
+ const { install } = require("./binary");
4
+ install(false);
@@ -0,0 +1,519 @@
1
+ {
2
+ "lockfileVersion": 3,
3
+ "name": "plenum",
4
+ "packages": {
5
+ "": {
6
+ "bin": {
7
+ "plenum": "run-plenum.js"
8
+ },
9
+ "dependencies": {
10
+ "axios": "^1.13.2",
11
+ "axios-proxy-builder": "^0.1.2",
12
+ "console.table": "^0.10.0",
13
+ "detect-libc": "^2.1.2",
14
+ "rimraf": "^6.1.2"
15
+ },
16
+ "devDependencies": {
17
+ "prettier": "^3.7.4"
18
+ },
19
+ "engines": {
20
+ "node": ">=14",
21
+ "npm": ">=6"
22
+ },
23
+ "hasInstallScript": true,
24
+ "license": "MIT OR Apache-2.0",
25
+ "name": "plenum",
26
+ "version": "0.2.0"
27
+ },
28
+ "node_modules/@isaacs/balanced-match": {
29
+ "engines": {
30
+ "node": "20 || >=22"
31
+ },
32
+ "integrity": "sha512-yzMTt9lEb8Gv7zRioUilSglI0c0smZ9k5D65677DLWLtWJaXIS3CqcGyUFByYKlnUj6TkjLVs54fBl6+TiGQDQ==",
33
+ "license": "MIT",
34
+ "resolved": "https://registry.npmjs.org/@isaacs/balanced-match/-/balanced-match-4.0.1.tgz",
35
+ "version": "4.0.1"
36
+ },
37
+ "node_modules/@isaacs/brace-expansion": {
38
+ "dependencies": {
39
+ "@isaacs/balanced-match": "^4.0.1"
40
+ },
41
+ "engines": {
42
+ "node": "20 || >=22"
43
+ },
44
+ "integrity": "sha512-ZT55BDLV0yv0RBm2czMiZ+SqCGO7AvmOM3G/w2xhVPH+te0aKgFjmBvGlL1dH+ql2tgGO3MVrbb3jCKyvpgnxA==",
45
+ "license": "MIT",
46
+ "resolved": "https://registry.npmjs.org/@isaacs/brace-expansion/-/brace-expansion-5.0.0.tgz",
47
+ "version": "5.0.0"
48
+ },
49
+ "node_modules/asynckit": {
50
+ "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
51
+ "license": "MIT",
52
+ "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
53
+ "version": "0.4.0"
54
+ },
55
+ "node_modules/axios": {
56
+ "dependencies": {
57
+ "follow-redirects": "^1.15.6",
58
+ "form-data": "^4.0.4",
59
+ "proxy-from-env": "^1.1.0"
60
+ },
61
+ "integrity": "sha512-VPk9ebNqPcy5lRGuSlKx752IlDatOjT9paPlm8A7yOuW2Fbvp4X3JznJtT4f0GzGLLiWE9W8onz51SqLYwzGaA==",
62
+ "license": "MIT",
63
+ "resolved": "https://registry.npmjs.org/axios/-/axios-1.13.2.tgz",
64
+ "version": "1.13.2"
65
+ },
66
+ "node_modules/axios-proxy-builder": {
67
+ "dependencies": {
68
+ "tunnel": "^0.0.6"
69
+ },
70
+ "integrity": "sha512-6uBVsBZzkB3tCC8iyx59mCjQckhB8+GQrI9Cop8eC7ybIsvs/KtnNgEBfRMSEa7GqK2VBGUzgjNYMdPIfotyPA==",
71
+ "license": "MIT",
72
+ "resolved": "https://registry.npmjs.org/axios-proxy-builder/-/axios-proxy-builder-0.1.2.tgz",
73
+ "version": "0.1.2"
74
+ },
75
+ "node_modules/call-bind-apply-helpers": {
76
+ "dependencies": {
77
+ "es-errors": "^1.3.0",
78
+ "function-bind": "^1.1.2"
79
+ },
80
+ "engines": {
81
+ "node": ">= 0.4"
82
+ },
83
+ "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
84
+ "license": "MIT",
85
+ "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
86
+ "version": "1.0.2"
87
+ },
88
+ "node_modules/clone": {
89
+ "engines": {
90
+ "node": ">=0.8"
91
+ },
92
+ "integrity": "sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg==",
93
+ "license": "MIT",
94
+ "optional": true,
95
+ "resolved": "https://registry.npmjs.org/clone/-/clone-1.0.4.tgz",
96
+ "version": "1.0.4"
97
+ },
98
+ "node_modules/combined-stream": {
99
+ "dependencies": {
100
+ "delayed-stream": "~1.0.0"
101
+ },
102
+ "engines": {
103
+ "node": ">= 0.8"
104
+ },
105
+ "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
106
+ "license": "MIT",
107
+ "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
108
+ "version": "1.0.8"
109
+ },
110
+ "node_modules/console.table": {
111
+ "dependencies": {
112
+ "easy-table": "1.1.0"
113
+ },
114
+ "engines": {
115
+ "node": "> 0.10"
116
+ },
117
+ "integrity": "sha512-dPyZofqggxuvSf7WXvNjuRfnsOk1YazkVP8FdxH4tcH2c37wc79/Yl6Bhr7Lsu00KMgy2ql/qCMuNu8xctZM8g==",
118
+ "license": "MIT",
119
+ "resolved": "https://registry.npmjs.org/console.table/-/console.table-0.10.0.tgz",
120
+ "version": "0.10.0"
121
+ },
122
+ "node_modules/defaults": {
123
+ "dependencies": {
124
+ "clone": "^1.0.2"
125
+ },
126
+ "funding": {
127
+ "url": "https://github.com/sponsors/sindresorhus"
128
+ },
129
+ "integrity": "sha512-eFuaLoy/Rxalv2kr+lqMlUnrDWV+3j4pljOIJgLIhI058IQfWJ7vXhyEIHu+HtC738klGALYxOKDO0bQP3tg8A==",
130
+ "license": "MIT",
131
+ "optional": true,
132
+ "resolved": "https://registry.npmjs.org/defaults/-/defaults-1.0.4.tgz",
133
+ "version": "1.0.4"
134
+ },
135
+ "node_modules/delayed-stream": {
136
+ "engines": {
137
+ "node": ">=0.4.0"
138
+ },
139
+ "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
140
+ "license": "MIT",
141
+ "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
142
+ "version": "1.0.0"
143
+ },
144
+ "node_modules/detect-libc": {
145
+ "engines": {
146
+ "node": ">=8"
147
+ },
148
+ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
149
+ "license": "Apache-2.0",
150
+ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
151
+ "version": "2.1.2"
152
+ },
153
+ "node_modules/dunder-proto": {
154
+ "dependencies": {
155
+ "call-bind-apply-helpers": "^1.0.1",
156
+ "es-errors": "^1.3.0",
157
+ "gopd": "^1.2.0"
158
+ },
159
+ "engines": {
160
+ "node": ">= 0.4"
161
+ },
162
+ "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
163
+ "license": "MIT",
164
+ "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
165
+ "version": "1.0.1"
166
+ },
167
+ "node_modules/easy-table": {
168
+ "integrity": "sha512-oq33hWOSSnl2Hoh00tZWaIPi1ievrD9aFG82/IgjlycAnW9hHx5PkJiXpxPsgEE+H7BsbVQXFVFST8TEXS6/pA==",
169
+ "license": "MIT",
170
+ "optionalDependencies": {
171
+ "wcwidth": ">=1.0.1"
172
+ },
173
+ "resolved": "https://registry.npmjs.org/easy-table/-/easy-table-1.1.0.tgz",
174
+ "version": "1.1.0"
175
+ },
176
+ "node_modules/es-define-property": {
177
+ "engines": {
178
+ "node": ">= 0.4"
179
+ },
180
+ "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
181
+ "license": "MIT",
182
+ "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
183
+ "version": "1.0.1"
184
+ },
185
+ "node_modules/es-errors": {
186
+ "engines": {
187
+ "node": ">= 0.4"
188
+ },
189
+ "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
190
+ "license": "MIT",
191
+ "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
192
+ "version": "1.3.0"
193
+ },
194
+ "node_modules/es-object-atoms": {
195
+ "dependencies": {
196
+ "es-errors": "^1.3.0"
197
+ },
198
+ "engines": {
199
+ "node": ">= 0.4"
200
+ },
201
+ "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
202
+ "license": "MIT",
203
+ "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
204
+ "version": "1.1.1"
205
+ },
206
+ "node_modules/es-set-tostringtag": {
207
+ "dependencies": {
208
+ "es-errors": "^1.3.0",
209
+ "get-intrinsic": "^1.2.6",
210
+ "has-tostringtag": "^1.0.2",
211
+ "hasown": "^2.0.2"
212
+ },
213
+ "engines": {
214
+ "node": ">= 0.4"
215
+ },
216
+ "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
217
+ "license": "MIT",
218
+ "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
219
+ "version": "2.1.0"
220
+ },
221
+ "node_modules/follow-redirects": {
222
+ "engines": {
223
+ "node": ">=4.0"
224
+ },
225
+ "funding": [
226
+ {
227
+ "type": "individual",
228
+ "url": "https://github.com/sponsors/RubenVerborgh"
229
+ }
230
+ ],
231
+ "integrity": "sha512-wWN62YITEaOpSK584EZXJafH1AGpO8RVgElfkuXbTOrPX4fIfOyEpW/CsiNd8JdYrAoOvafRTOEnvsO++qCqFA==",
232
+ "license": "MIT",
233
+ "peerDependenciesMeta": {
234
+ "debug": {
235
+ "optional": true
236
+ }
237
+ },
238
+ "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.6.tgz",
239
+ "version": "1.15.6"
240
+ },
241
+ "node_modules/form-data": {
242
+ "dependencies": {
243
+ "asynckit": "^0.4.0",
244
+ "combined-stream": "^1.0.8",
245
+ "es-set-tostringtag": "^2.1.0",
246
+ "hasown": "^2.0.2",
247
+ "mime-types": "^2.1.12"
248
+ },
249
+ "engines": {
250
+ "node": ">= 6"
251
+ },
252
+ "integrity": "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==",
253
+ "license": "MIT",
254
+ "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz",
255
+ "version": "4.0.4"
256
+ },
257
+ "node_modules/function-bind": {
258
+ "funding": {
259
+ "url": "https://github.com/sponsors/ljharb"
260
+ },
261
+ "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
262
+ "license": "MIT",
263
+ "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
264
+ "version": "1.1.2"
265
+ },
266
+ "node_modules/get-intrinsic": {
267
+ "dependencies": {
268
+ "call-bind-apply-helpers": "^1.0.2",
269
+ "es-define-property": "^1.0.1",
270
+ "es-errors": "^1.3.0",
271
+ "es-object-atoms": "^1.1.1",
272
+ "function-bind": "^1.1.2",
273
+ "get-proto": "^1.0.1",
274
+ "gopd": "^1.2.0",
275
+ "has-symbols": "^1.1.0",
276
+ "hasown": "^2.0.2",
277
+ "math-intrinsics": "^1.1.0"
278
+ },
279
+ "engines": {
280
+ "node": ">= 0.4"
281
+ },
282
+ "funding": {
283
+ "url": "https://github.com/sponsors/ljharb"
284
+ },
285
+ "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
286
+ "license": "MIT",
287
+ "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
288
+ "version": "1.3.0"
289
+ },
290
+ "node_modules/get-proto": {
291
+ "dependencies": {
292
+ "dunder-proto": "^1.0.1",
293
+ "es-object-atoms": "^1.0.0"
294
+ },
295
+ "engines": {
296
+ "node": ">= 0.4"
297
+ },
298
+ "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
299
+ "license": "MIT",
300
+ "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
301
+ "version": "1.0.1"
302
+ },
303
+ "node_modules/glob": {
304
+ "dependencies": {
305
+ "minimatch": "^10.1.1",
306
+ "minipass": "^7.1.2",
307
+ "path-scurry": "^2.0.0"
308
+ },
309
+ "engines": {
310
+ "node": "20 || >=22"
311
+ },
312
+ "funding": {
313
+ "url": "https://github.com/sponsors/isaacs"
314
+ },
315
+ "integrity": "sha512-tvZgpqk6fz4BaNZ66ZsRaZnbHvP/jG3uKJvAZOwEVUL4RTA5nJeeLYfyN9/VA8NX/V3IBG+hkeuGpKjvELkVhA==",
316
+ "license": "BlueOak-1.0.0",
317
+ "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.0.tgz",
318
+ "version": "13.0.0"
319
+ },
320
+ "node_modules/gopd": {
321
+ "engines": {
322
+ "node": ">= 0.4"
323
+ },
324
+ "funding": {
325
+ "url": "https://github.com/sponsors/ljharb"
326
+ },
327
+ "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
328
+ "license": "MIT",
329
+ "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
330
+ "version": "1.2.0"
331
+ },
332
+ "node_modules/has-symbols": {
333
+ "engines": {
334
+ "node": ">= 0.4"
335
+ },
336
+ "funding": {
337
+ "url": "https://github.com/sponsors/ljharb"
338
+ },
339
+ "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
340
+ "license": "MIT",
341
+ "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
342
+ "version": "1.1.0"
343
+ },
344
+ "node_modules/has-tostringtag": {
345
+ "dependencies": {
346
+ "has-symbols": "^1.0.3"
347
+ },
348
+ "engines": {
349
+ "node": ">= 0.4"
350
+ },
351
+ "funding": {
352
+ "url": "https://github.com/sponsors/ljharb"
353
+ },
354
+ "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
355
+ "license": "MIT",
356
+ "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
357
+ "version": "1.0.2"
358
+ },
359
+ "node_modules/hasown": {
360
+ "dependencies": {
361
+ "function-bind": "^1.1.2"
362
+ },
363
+ "engines": {
364
+ "node": ">= 0.4"
365
+ },
366
+ "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
367
+ "license": "MIT",
368
+ "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
369
+ "version": "2.0.2"
370
+ },
371
+ "node_modules/lru-cache": {
372
+ "engines": {
373
+ "node": "20 || >=22"
374
+ },
375
+ "integrity": "sha512-B5Y16Jr9LB9dHVkh6ZevG+vAbOsNOYCX+sXvFWFu7B3Iz5mijW3zdbMyhsh8ANd2mSWBYdJgnqi+mL7/LrOPYg==",
376
+ "license": "BlueOak-1.0.0",
377
+ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.4.tgz",
378
+ "version": "11.2.4"
379
+ },
380
+ "node_modules/math-intrinsics": {
381
+ "engines": {
382
+ "node": ">= 0.4"
383
+ },
384
+ "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
385
+ "license": "MIT",
386
+ "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
387
+ "version": "1.1.0"
388
+ },
389
+ "node_modules/mime-db": {
390
+ "engines": {
391
+ "node": ">= 0.6"
392
+ },
393
+ "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
394
+ "license": "MIT",
395
+ "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
396
+ "version": "1.52.0"
397
+ },
398
+ "node_modules/mime-types": {
399
+ "dependencies": {
400
+ "mime-db": "1.52.0"
401
+ },
402
+ "engines": {
403
+ "node": ">= 0.6"
404
+ },
405
+ "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
406
+ "license": "MIT",
407
+ "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
408
+ "version": "2.1.35"
409
+ },
410
+ "node_modules/minimatch": {
411
+ "dependencies": {
412
+ "@isaacs/brace-expansion": "^5.0.0"
413
+ },
414
+ "engines": {
415
+ "node": "20 || >=22"
416
+ },
417
+ "funding": {
418
+ "url": "https://github.com/sponsors/isaacs"
419
+ },
420
+ "integrity": "sha512-enIvLvRAFZYXJzkCYG5RKmPfrFArdLv+R+lbQ53BmIMLIry74bjKzX6iHAm8WYamJkhSSEabrWN5D97XnKObjQ==",
421
+ "license": "BlueOak-1.0.0",
422
+ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.1.1.tgz",
423
+ "version": "10.1.1"
424
+ },
425
+ "node_modules/minipass": {
426
+ "engines": {
427
+ "node": ">=16 || 14 >=14.17"
428
+ },
429
+ "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==",
430
+ "license": "ISC",
431
+ "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz",
432
+ "version": "7.1.2"
433
+ },
434
+ "node_modules/package-json-from-dist": {
435
+ "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
436
+ "license": "BlueOak-1.0.0",
437
+ "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
438
+ "version": "1.0.1"
439
+ },
440
+ "node_modules/path-scurry": {
441
+ "dependencies": {
442
+ "lru-cache": "^11.0.0",
443
+ "minipass": "^7.1.2"
444
+ },
445
+ "engines": {
446
+ "node": "20 || >=22"
447
+ },
448
+ "funding": {
449
+ "url": "https://github.com/sponsors/isaacs"
450
+ },
451
+ "integrity": "sha512-oWyT4gICAu+kaA7QWk/jvCHWarMKNs6pXOGWKDTr7cw4IGcUbW+PeTfbaQiLGheFRpjo6O9J0PmyMfQPjH71oA==",
452
+ "license": "BlueOak-1.0.0",
453
+ "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.1.tgz",
454
+ "version": "2.0.1"
455
+ },
456
+ "node_modules/prettier": {
457
+ "bin": {
458
+ "prettier": "bin/prettier.cjs"
459
+ },
460
+ "dev": true,
461
+ "engines": {
462
+ "node": ">=14"
463
+ },
464
+ "funding": {
465
+ "url": "https://github.com/prettier/prettier?sponsor=1"
466
+ },
467
+ "integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
468
+ "license": "MIT",
469
+ "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.4.tgz",
470
+ "version": "3.7.4"
471
+ },
472
+ "node_modules/proxy-from-env": {
473
+ "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==",
474
+ "license": "MIT",
475
+ "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz",
476
+ "version": "1.1.0"
477
+ },
478
+ "node_modules/rimraf": {
479
+ "bin": {
480
+ "rimraf": "dist/esm/bin.mjs"
481
+ },
482
+ "dependencies": {
483
+ "glob": "^13.0.0",
484
+ "package-json-from-dist": "^1.0.1"
485
+ },
486
+ "engines": {
487
+ "node": "20 || >=22"
488
+ },
489
+ "funding": {
490
+ "url": "https://github.com/sponsors/isaacs"
491
+ },
492
+ "integrity": "sha512-cFCkPslJv7BAXJsYlK1dZsbP8/ZNLkCAQ0bi1hf5EKX2QHegmDFEFA6QhuYJlk7UDdc+02JjO80YSOrWPpw06g==",
493
+ "license": "BlueOak-1.0.0",
494
+ "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-6.1.2.tgz",
495
+ "version": "6.1.2"
496
+ },
497
+ "node_modules/tunnel": {
498
+ "engines": {
499
+ "node": ">=0.6.11 <=0.7.0 || >=0.7.3"
500
+ },
501
+ "integrity": "sha512-1h/Lnq9yajKY2PEbBadPXj3VxsDDu844OnaAo52UVmIzIvwwtBPIuNvkjuzBlTWpfJyUbG3ez0KSBibQkj4ojg==",
502
+ "license": "MIT",
503
+ "resolved": "https://registry.npmjs.org/tunnel/-/tunnel-0.0.6.tgz",
504
+ "version": "0.0.6"
505
+ },
506
+ "node_modules/wcwidth": {
507
+ "dependencies": {
508
+ "defaults": "^1.0.3"
509
+ },
510
+ "integrity": "sha512-XHPEwS0q6TaxcvG85+8EYkbiCux2XtWG2mkc47Ng2A77BQu9+DqIOJldST4HgPkuea7dvKSj5VgX3P1d4rW8Tg==",
511
+ "license": "MIT",
512
+ "optional": true,
513
+ "resolved": "https://registry.npmjs.org/wcwidth/-/wcwidth-1.0.1.tgz",
514
+ "version": "1.0.1"
515
+ }
516
+ },
517
+ "requires": true,
518
+ "version": "0.2.0"
519
+ }
package/package.json ADDED
@@ -0,0 +1,100 @@
1
+ {
2
+ "artifactDownloadUrl": "https://github.com/reflex-search/plenum/releases/download/v0.2.0",
3
+ "author": "Plenum Contributors",
4
+ "bin": {
5
+ "plenum": "run-plenum.js"
6
+ },
7
+ "dependencies": {
8
+ "axios": "^1.13.2",
9
+ "axios-proxy-builder": "^0.1.2",
10
+ "console.table": "^0.10.0",
11
+ "detect-libc": "^2.1.2",
12
+ "rimraf": "^6.1.2"
13
+ },
14
+ "description": "Agent-first database control CLI with least-privilege execution",
15
+ "devDependencies": {
16
+ "prettier": "^3.7.4"
17
+ },
18
+ "engines": {
19
+ "node": ">=14",
20
+ "npm": ">=6"
21
+ },
22
+ "glibcMinimum": {
23
+ "major": 2,
24
+ "series": 35
25
+ },
26
+ "homepage": "https://github.com/reflex-search/plenum",
27
+ "keywords": [
28
+ "command-line-utilities",
29
+ "database",
30
+ "cli",
31
+ "mcp",
32
+ "agent",
33
+ "sql"
34
+ ],
35
+ "license": "MIT OR Apache-2.0",
36
+ "name": "plenum",
37
+ "preferUnplugged": true,
38
+ "repository": "https://github.com/reflex-search/plenum",
39
+ "scripts": {
40
+ "fmt": "prettier --write **/*.js",
41
+ "fmt:check": "prettier --check **/*.js",
42
+ "postinstall": "node ./install.js"
43
+ },
44
+ "supportedPlatforms": {
45
+ "aarch64-apple-darwin": {
46
+ "artifactName": "plenum-aarch64-apple-darwin.tar.xz",
47
+ "bins": {
48
+ "plenum": "plenum"
49
+ },
50
+ "zipExt": ".tar.xz"
51
+ },
52
+ "aarch64-pc-windows-msvc": {
53
+ "artifactName": "plenum-x86_64-pc-windows-msvc.zip",
54
+ "bins": {
55
+ "plenum": "plenum.exe"
56
+ },
57
+ "zipExt": ".zip"
58
+ },
59
+ "aarch64-unknown-linux-gnu": {
60
+ "artifactName": "plenum-aarch64-unknown-linux-gnu.tar.xz",
61
+ "bins": {
62
+ "plenum": "plenum"
63
+ },
64
+ "zipExt": ".tar.xz"
65
+ },
66
+ "x86_64-apple-darwin": {
67
+ "artifactName": "plenum-x86_64-apple-darwin.tar.xz",
68
+ "bins": {
69
+ "plenum": "plenum"
70
+ },
71
+ "zipExt": ".tar.xz"
72
+ },
73
+ "x86_64-pc-windows-gnu": {
74
+ "artifactName": "plenum-x86_64-pc-windows-msvc.zip",
75
+ "bins": {
76
+ "plenum": "plenum.exe"
77
+ },
78
+ "zipExt": ".zip"
79
+ },
80
+ "x86_64-pc-windows-msvc": {
81
+ "artifactName": "plenum-x86_64-pc-windows-msvc.zip",
82
+ "bins": {
83
+ "plenum": "plenum.exe"
84
+ },
85
+ "zipExt": ".zip"
86
+ },
87
+ "x86_64-unknown-linux-gnu": {
88
+ "artifactName": "plenum-x86_64-unknown-linux-gnu.tar.xz",
89
+ "bins": {
90
+ "plenum": "plenum"
91
+ },
92
+ "zipExt": ".tar.xz"
93
+ }
94
+ },
95
+ "version": "0.2.0",
96
+ "volta": {
97
+ "node": "18.14.1",
98
+ "npm": "9.5.0"
99
+ }
100
+ }
package/run-plenum.js ADDED
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+
3
+ const { run } = require("./binary");
4
+ run("plenum");