Files
gstack/bin/gstack-runtime-pins.ts
garrytanandcapy-ai[bot] 660484ee99 security: isolate every gstack Bun entry point from the audited checkout's .env and bunfig.toml
Bun auto-loads .env, .env.local and .env.<NODE_ENV> from its cwd and runs a
cwd bunfig.toml preload before the program starts. gstack runs inside the repo
it audits, so a committed .env could steer state roots, the claude binary or
spend caps, and a bunfig preload ran arbitrary code in every bin and hook.

Every bun shebang, shell and skill caller, TypeScript spawn and compiled build
now disables both (--no-env-file --config=/dev/null, bunIsolationArgs(),
--no-compile-autoload-dotenv/bunfig), with a ratchet and hostile-fixture
regressions.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
2026-10-19 20:48:49 +00:00

38 lines
1.9 KiB
TypeScript
Executable File

#!/usr/bin/env -S bun --no-env-file --config=/dev/null
/**
* gstack-runtime-pins — the doctor's `project pins` row (lib/runtime-pins.ts).
*
* gstack-runtime-pins --project <dir> [--bun <v>] [--node <v>] [--platform linux|darwin|win32] [--json]
*
* Prints one PIN: line per declared pin (tool, constraint, exact|range,
* file:line, lane), PIN_SKIP: for pins it cannot evaluate, PIN_FAIL: per
* failing tool, then `PINS_VERDICT: pass|fail|none`. --json prints the report
* object instead. Exit 0 on pass or none, 1 on fail, 2 on usage.
*/
import * as fs from 'node:fs';
import { collectPins, evaluatePins, renderPinLines, type Running } from '../lib/runtime-pins';
const args = process.argv.slice(2);
let project = '';
let json = false;
let platform: NodeJS.Platform = process.platform;
const running: Running = {};
const usage = () => { console.error('usage: gstack-runtime-pins --project <dir> [--bun <v>] [--node <v>] [--platform linux|darwin|win32] [--json]'); process.exit(2); };
for (let i = 0; i < args.length; i++) {
const next = () => { if (i + 1 >= args.length) usage(); return args[++i]; };
switch (args[i]) {
case '--project': project = next(); break;
case '--bun': running.bun = next(); break;
case '--node': running.node = next(); break;
case '--platform': platform = next() as NodeJS.Platform; break;
case '--json': json = true; break;
case '-h': case '--help': console.log('usage: gstack-runtime-pins --project <dir> [--bun <v>] [--node <v>] [--platform linux|darwin|win32] [--json]'); process.exit(0);
default: usage();
}
}
if (!project || !fs.existsSync(project)) usage();
const report = evaluatePins(collectPins(project), running, platform);
if (json) console.log(JSON.stringify({ schema_version: 1, project, running, platform, ...report }));
else for (const line of renderPinLines(report, platform)) console.log(line);
process.exit(report.verdict === 'fail' ? 1 : 0);