@taliesinb/mash 0.0.0-stage → 0.1.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/LICENSE +21 -0
- package/README.md +275 -2
- package/bin/mash.ts +253 -0
- package/dist/bin/mash.d.ts +39 -0
- package/dist/bin/mash.d.ts.map +1 -0
- package/dist/bin/mash.js +281 -0
- package/dist/bin/mash.js.map +1 -0
- package/dist/src/analysis/analyze.d.ts +97 -0
- package/dist/src/analysis/analyze.d.ts.map +1 -0
- package/dist/src/analysis/analyze.js +1406 -0
- package/dist/src/analysis/analyze.js.map +1 -0
- package/dist/src/analysis/fs.d.ts +39 -0
- package/dist/src/analysis/fs.d.ts.map +1 -0
- package/dist/src/analysis/fs.js +117 -0
- package/dist/src/analysis/fs.js.map +1 -0
- package/dist/src/analysis/outputs.d.ts +16 -0
- package/dist/src/analysis/outputs.d.ts.map +1 -0
- package/dist/src/analysis/outputs.js +277 -0
- package/dist/src/analysis/outputs.js.map +1 -0
- package/dist/src/analysis/value.d.ts +76 -0
- package/dist/src/analysis/value.d.ts.map +1 -0
- package/dist/src/analysis/value.js +248 -0
- package/dist/src/analysis/value.js.map +1 -0
- package/dist/src/behaviors/defs/core.d.ts +15 -0
- package/dist/src/behaviors/defs/core.d.ts.map +1 -0
- package/dist/src/behaviors/defs/core.js +1084 -0
- package/dist/src/behaviors/defs/core.js.map +1 -0
- package/dist/src/behaviors/defs/devtools.d.ts +9 -0
- package/dist/src/behaviors/defs/devtools.d.ts.map +1 -0
- package/dist/src/behaviors/defs/devtools.js +432 -0
- package/dist/src/behaviors/defs/devtools.js.map +1 -0
- package/dist/src/behaviors/defs/macos.d.ts +12 -0
- package/dist/src/behaviors/defs/macos.d.ts.map +1 -0
- package/dist/src/behaviors/defs/macos.js +454 -0
- package/dist/src/behaviors/defs/macos.js.map +1 -0
- package/dist/src/behaviors/defs/tools.d.ts +9 -0
- package/dist/src/behaviors/defs/tools.d.ts.map +1 -0
- package/dist/src/behaviors/defs/tools.js +639 -0
- package/dist/src/behaviors/defs/tools.js.map +1 -0
- package/dist/src/behaviors/dsl.d.ts +95 -0
- package/dist/src/behaviors/dsl.d.ts.map +1 -0
- package/dist/src/behaviors/dsl.js +267 -0
- package/dist/src/behaviors/dsl.js.map +1 -0
- package/dist/src/behaviors/index.d.ts +12 -0
- package/dist/src/behaviors/index.d.ts.map +1 -0
- package/dist/src/behaviors/index.js +18 -0
- package/dist/src/behaviors/index.js.map +1 -0
- package/dist/src/behaviors/registry.d.ts +45 -0
- package/dist/src/behaviors/registry.d.ts.map +1 -0
- package/dist/src/behaviors/registry.js +266 -0
- package/dist/src/behaviors/registry.js.map +1 -0
- package/dist/src/behaviors/roles.d.ts +29 -0
- package/dist/src/behaviors/roles.d.ts.map +1 -0
- package/dist/src/behaviors/roles.js +198 -0
- package/dist/src/behaviors/roles.js.map +1 -0
- package/dist/src/behaviors/types.d.ts +120 -0
- package/dist/src/behaviors/types.d.ts.map +1 -0
- package/dist/src/behaviors/types.js +12 -0
- package/dist/src/behaviors/types.js.map +1 -0
- package/dist/src/index.d.ts +27 -0
- package/dist/src/index.d.ts.map +1 -0
- package/dist/src/index.js +24 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/integrations/deepsea.d.ts +121 -0
- package/dist/src/integrations/deepsea.d.ts.map +1 -0
- package/dist/src/integrations/deepsea.js +199 -0
- package/dist/src/integrations/deepsea.js.map +1 -0
- package/dist/src/machine.d.ts +139 -0
- package/dist/src/machine.d.ts.map +1 -0
- package/dist/src/machine.js +400 -0
- package/dist/src/machine.js.map +1 -0
- package/dist/src/parser/ast.d.ts +369 -0
- package/dist/src/parser/ast.d.ts.map +1 -0
- package/dist/src/parser/ast.js +17 -0
- package/dist/src/parser/ast.js.map +1 -0
- package/dist/src/parser/parser.d.ts +48 -0
- package/dist/src/parser/parser.d.ts.map +1 -0
- package/dist/src/parser/parser.js +1950 -0
- package/dist/src/parser/parser.js.map +1 -0
- package/dist/src/policy/effects.d.ts +86 -0
- package/dist/src/policy/effects.d.ts.map +1 -0
- package/dist/src/policy/effects.js +53 -0
- package/dist/src/policy/effects.js.map +1 -0
- package/dist/src/policy/policy.d.ts +130 -0
- package/dist/src/policy/policy.d.ts.map +1 -0
- package/dist/src/policy/policy.js +532 -0
- package/dist/src/policy/policy.js.map +1 -0
- package/dist/src/printer/doc.d.ts +151 -0
- package/dist/src/printer/doc.d.ts.map +1 -0
- package/dist/src/printer/doc.js +409 -0
- package/dist/src/printer/doc.js.map +1 -0
- package/dist/src/printer/highlight.d.ts +53 -0
- package/dist/src/printer/highlight.d.ts.map +1 -0
- package/dist/src/printer/highlight.js +339 -0
- package/dist/src/printer/highlight.js.map +1 -0
- package/dist/src/printer/html.d.ts +72 -0
- package/dist/src/printer/html.d.ts.map +1 -0
- package/dist/src/printer/html.js +423 -0
- package/dist/src/printer/html.js.map +1 -0
- package/dist/src/printer/print.d.ts +63 -0
- package/dist/src/printer/print.d.ts.map +1 -0
- package/dist/src/printer/print.js +484 -0
- package/dist/src/printer/print.js.map +1 -0
- package/dist/src/printer/summary.d.ts +50 -0
- package/dist/src/printer/summary.d.ts.map +1 -0
- package/dist/src/printer/summary.js +621 -0
- package/dist/src/printer/summary.js.map +1 -0
- package/dist/src/trace/events.d.ts +183 -0
- package/dist/src/trace/events.d.ts.map +1 -0
- package/dist/src/trace/events.js +9 -0
- package/dist/src/trace/events.js.map +1 -0
- package/dist/src/trace/progress.d.ts +58 -0
- package/dist/src/trace/progress.d.ts.map +1 -0
- package/dist/src/trace/progress.js +83 -0
- package/dist/src/trace/progress.js.map +1 -0
- package/dist/src/vm/arith.d.ts +29 -0
- package/dist/src/vm/arith.d.ts.map +1 -0
- package/dist/src/vm/arith.js +258 -0
- package/dist/src/vm/arith.js.map +1 -0
- package/dist/src/vm/builtins.d.ts +31 -0
- package/dist/src/vm/builtins.d.ts.map +1 -0
- package/dist/src/vm/builtins.js +1773 -0
- package/dist/src/vm/builtins.js.map +1 -0
- package/dist/src/vm/emulate.d.ts +75 -0
- package/dist/src/vm/emulate.d.ts.map +1 -0
- package/dist/src/vm/emulate.js +380 -0
- package/dist/src/vm/emulate.js.map +1 -0
- package/dist/src/vm/expand.d.ts +68 -0
- package/dist/src/vm/expand.d.ts.map +1 -0
- package/dist/src/vm/expand.js +744 -0
- package/dist/src/vm/expand.js.map +1 -0
- package/dist/src/vm/external.d.ts +34 -0
- package/dist/src/vm/external.d.ts.map +1 -0
- package/dist/src/vm/external.js +228 -0
- package/dist/src/vm/external.js.map +1 -0
- package/dist/src/vm/fifo.d.ts +66 -0
- package/dist/src/vm/fifo.d.ts.map +1 -0
- package/dist/src/vm/fifo.js +232 -0
- package/dist/src/vm/fifo.js.map +1 -0
- package/dist/src/vm/interp.d.ts +209 -0
- package/dist/src/vm/interp.d.ts.map +1 -0
- package/dist/src/vm/interp.js +1641 -0
- package/dist/src/vm/interp.js.map +1 -0
- package/dist/src/vm/io.d.ts +180 -0
- package/dist/src/vm/io.d.ts.map +1 -0
- package/dist/src/vm/io.js +502 -0
- package/dist/src/vm/io.js.map +1 -0
- package/dist/src/vm/pattern.d.ts +46 -0
- package/dist/src/vm/pattern.d.ts.map +1 -0
- package/dist/src/vm/pattern.js +498 -0
- package/dist/src/vm/pattern.js.map +1 -0
- package/dist/src/vm/proc.d.ts +94 -0
- package/dist/src/vm/proc.d.ts.map +1 -0
- package/dist/src/vm/proc.js +130 -0
- package/dist/src/vm/proc.js.map +1 -0
- package/dist/src/vm/state.d.ts +104 -0
- package/dist/src/vm/state.d.ts.map +1 -0
- package/dist/src/vm/state.js +233 -0
- package/dist/src/vm/state.js.map +1 -0
- package/dist/src/vm/test.d.ts +11 -0
- package/dist/src/vm/test.d.ts.map +1 -0
- package/dist/src/vm/test.js +277 -0
- package/dist/src/vm/test.js.map +1 -0
- package/package.json +63 -4
- package/src/analysis/analyze.ts +1395 -0
- package/src/analysis/fs.ts +121 -0
- package/src/analysis/outputs.ts +242 -0
- package/src/analysis/value.ts +264 -0
- package/src/behaviors/defs/core.ts +970 -0
- package/src/behaviors/defs/devtools.ts +400 -0
- package/src/behaviors/defs/macos.ts +426 -0
- package/src/behaviors/defs/tools.ts +596 -0
- package/src/behaviors/dsl.ts +293 -0
- package/src/behaviors/index.ts +19 -0
- package/src/behaviors/registry.ts +261 -0
- package/src/behaviors/roles.ts +187 -0
- package/src/behaviors/types.ts +127 -0
- package/src/index.ts +27 -0
- package/src/integrations/deepsea.ts +259 -0
- package/src/machine.ts +483 -0
- package/src/parser/ast.ts +472 -0
- package/src/parser/parser.ts +1826 -0
- package/src/policy/effects.ts +102 -0
- package/src/policy/policy.ts +578 -0
- package/src/printer/doc.ts +454 -0
- package/src/printer/highlight.ts +283 -0
- package/src/printer/html.ts +441 -0
- package/src/printer/print.ts +528 -0
- package/src/printer/summary.ts +601 -0
- package/src/trace/events.ts +102 -0
- package/src/trace/progress.ts +119 -0
- package/src/vm/arith.ts +236 -0
- package/src/vm/builtins.ts +1590 -0
- package/src/vm/emulate.ts +337 -0
- package/src/vm/expand.ts +721 -0
- package/src/vm/external.ts +265 -0
- package/src/vm/fifo.ts +226 -0
- package/src/vm/interp.ts +1623 -0
- package/src/vm/io.ts +570 -0
- package/src/vm/pattern.ts +477 -0
- package/src/vm/proc.ts +147 -0
- package/src/vm/state.ts +267 -0
- package/src/vm/test.ts +253 -0
package/dist/bin/mash.js
ADDED
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* mash CLI.
|
|
4
|
+
*
|
|
5
|
+
* mash run [options] (-c SCRIPT | FILE) [ARGS...] pre-flight, then run under the policy
|
|
6
|
+
* mash analyze [options] (-c SCRIPT | FILE) static analysis report
|
|
7
|
+
* mash parse (-c SCRIPT | FILE) AST as JSON
|
|
8
|
+
* mash fmt [fmt options] (-c SCRIPT | FILE) pretty-print as equivalent bash
|
|
9
|
+
*
|
|
10
|
+
* Options:
|
|
11
|
+
* --mode MODE read-only | workspace-write (default) | danger-full-access
|
|
12
|
+
* --root DIR workspace root (default: cwd)
|
|
13
|
+
* --allow DIR extra writable root (repeatable)
|
|
14
|
+
* --no-temp temp dirs are not writable
|
|
15
|
+
* --no-network deny network access
|
|
16
|
+
* --allow-host HOST allow network access only to HOST (repeatable; *.example.com for subdomains)
|
|
17
|
+
* --deny-credentials deny reading credential stores (~/.ssh, ~/.aws, ~/.config/gh, keychains, ...)
|
|
18
|
+
* --deny CMD deny a command by name (repeatable)
|
|
19
|
+
* --deny-unknown deny commands whose effects cannot be shown safe
|
|
20
|
+
* --abort-on-deny abort the run at the first denial
|
|
21
|
+
* --no-preflight skip the static pre-flight check
|
|
22
|
+
* --dry-run do not execute external commands; show predicted effects
|
|
23
|
+
* --trace human-readable trace on stderr
|
|
24
|
+
* --trace-json FILE JSONL trace events to FILE
|
|
25
|
+
* --data include stream data in traces
|
|
26
|
+
* --json machine-readable analyze output
|
|
27
|
+
*
|
|
28
|
+
* fmt options (docs/pretty-printer.md):
|
|
29
|
+
* -w, --width N line width (80)
|
|
30
|
+
* --indent N indentation step (2)
|
|
31
|
+
* --operators trailing|leading
|
|
32
|
+
* --assignments auto|always|inline
|
|
33
|
+
* --compounds auto|expanded
|
|
34
|
+
* --statements continuation|newline|preserve
|
|
35
|
+
* --format-substitutions reformat multi-line $(…) bodies
|
|
36
|
+
* --check exit 1 if the input is not already formatted
|
|
37
|
+
*/
|
|
38
|
+
import * as fs from 'node:fs';
|
|
39
|
+
import * as path from 'node:path';
|
|
40
|
+
import { Machine, describe, describeEffect, format } from "../src/index.js";
|
|
41
|
+
function usage(code = 2) {
|
|
42
|
+
const text = fs.readFileSync(new URL(import.meta.url), 'utf8').split('*/')[0].replace(/^#!.*\n\/\*\*?/, '').replace(/^ \* ?/gm, '');
|
|
43
|
+
process.stderr.write(text.trim() + '\n');
|
|
44
|
+
process.exit(code);
|
|
45
|
+
}
|
|
46
|
+
function parseCli(argv) {
|
|
47
|
+
const o = {
|
|
48
|
+
cmd: argv[0] ?? '', args: [], mode: 'workspace-write', root: process.cwd(), allow: [], temp: true, network: true, hosts: [], credentials: false, deny: [],
|
|
49
|
+
denyUnknown: false, abortOnDeny: false, preflight: true, dryRun: false, trace: false, data: false, json: false,
|
|
50
|
+
fmt: {}, check: false,
|
|
51
|
+
};
|
|
52
|
+
if (!['run', 'analyze', 'parse', 'fmt'].includes(o.cmd))
|
|
53
|
+
usage();
|
|
54
|
+
let i = 1;
|
|
55
|
+
for (; i < argv.length; i++) {
|
|
56
|
+
const a = argv[i];
|
|
57
|
+
const val = () => {
|
|
58
|
+
const v = argv[++i];
|
|
59
|
+
if (v === undefined)
|
|
60
|
+
usage();
|
|
61
|
+
return v;
|
|
62
|
+
};
|
|
63
|
+
switch (a) {
|
|
64
|
+
case '-c':
|
|
65
|
+
o.script = val();
|
|
66
|
+
i++;
|
|
67
|
+
o.args = argv.slice(i);
|
|
68
|
+
return o;
|
|
69
|
+
case '--mode':
|
|
70
|
+
o.mode = val();
|
|
71
|
+
break;
|
|
72
|
+
case '--root':
|
|
73
|
+
o.root = path.resolve(val());
|
|
74
|
+
break;
|
|
75
|
+
case '--allow':
|
|
76
|
+
o.allow.push(path.resolve(val()));
|
|
77
|
+
break;
|
|
78
|
+
case '--no-temp':
|
|
79
|
+
o.temp = false;
|
|
80
|
+
break;
|
|
81
|
+
case '--no-network':
|
|
82
|
+
o.network = false;
|
|
83
|
+
break;
|
|
84
|
+
case '--allow-host':
|
|
85
|
+
o.hosts.push(val());
|
|
86
|
+
break;
|
|
87
|
+
case '--deny-credentials':
|
|
88
|
+
o.credentials = true;
|
|
89
|
+
break;
|
|
90
|
+
case '--deny':
|
|
91
|
+
o.deny.push(val());
|
|
92
|
+
break;
|
|
93
|
+
case '--deny-unknown':
|
|
94
|
+
o.denyUnknown = true;
|
|
95
|
+
break;
|
|
96
|
+
case '--abort-on-deny':
|
|
97
|
+
o.abortOnDeny = true;
|
|
98
|
+
break;
|
|
99
|
+
case '--no-preflight':
|
|
100
|
+
o.preflight = false;
|
|
101
|
+
break;
|
|
102
|
+
case '--dry-run':
|
|
103
|
+
o.dryRun = true;
|
|
104
|
+
break;
|
|
105
|
+
case '--trace':
|
|
106
|
+
o.trace = true;
|
|
107
|
+
break;
|
|
108
|
+
case '--trace-json':
|
|
109
|
+
o.traceJson = val();
|
|
110
|
+
break;
|
|
111
|
+
case '--data':
|
|
112
|
+
o.data = true;
|
|
113
|
+
break;
|
|
114
|
+
case '--json':
|
|
115
|
+
o.json = true;
|
|
116
|
+
break;
|
|
117
|
+
case '-w':
|
|
118
|
+
case '--width':
|
|
119
|
+
o.fmt.width = Number(val());
|
|
120
|
+
break;
|
|
121
|
+
case '--indent':
|
|
122
|
+
o.fmt.indent = Number(val());
|
|
123
|
+
break;
|
|
124
|
+
case '--operators':
|
|
125
|
+
o.fmt.operators = val();
|
|
126
|
+
break;
|
|
127
|
+
case '--assignments':
|
|
128
|
+
o.fmt.assignments = val();
|
|
129
|
+
break;
|
|
130
|
+
case '--compounds':
|
|
131
|
+
o.fmt.compounds = val();
|
|
132
|
+
break;
|
|
133
|
+
case '--statements':
|
|
134
|
+
o.fmt.statements = val();
|
|
135
|
+
break;
|
|
136
|
+
case '--format-substitutions':
|
|
137
|
+
o.fmt.formatSubstitutions = true;
|
|
138
|
+
break;
|
|
139
|
+
case '--check':
|
|
140
|
+
o.check = true;
|
|
141
|
+
break;
|
|
142
|
+
case '-h':
|
|
143
|
+
case '--help': usage(0);
|
|
144
|
+
default:
|
|
145
|
+
if (a.startsWith('-'))
|
|
146
|
+
usage();
|
|
147
|
+
o.file = a;
|
|
148
|
+
o.args = argv.slice(i + 1);
|
|
149
|
+
return o;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
return o;
|
|
153
|
+
}
|
|
154
|
+
const o = parseCli(process.argv.slice(2));
|
|
155
|
+
const source = o.script ?? (o.file ? fs.readFileSync(o.file, 'utf8') : fs.readFileSync(0, 'utf8'));
|
|
156
|
+
const policy = {
|
|
157
|
+
mode: o.mode,
|
|
158
|
+
workspaceRoot: o.root,
|
|
159
|
+
additionalWritableRoots: o.allow,
|
|
160
|
+
writableTemp: o.temp,
|
|
161
|
+
network: !o.network ? 'deny' : o.hosts.length > 0 ? { allow: o.hosts } : 'allow',
|
|
162
|
+
readDenyCredentials: o.credentials,
|
|
163
|
+
deniedCommands: o.deny,
|
|
164
|
+
};
|
|
165
|
+
const isTty = process.stderr.isTTY;
|
|
166
|
+
const c = (code, s) => (isTty ? `\x1b[${code}m${s}\x1b[0m` : s);
|
|
167
|
+
const machine = new Machine({
|
|
168
|
+
cwd: process.cwd(),
|
|
169
|
+
policy,
|
|
170
|
+
denyUnknown: o.denyUnknown,
|
|
171
|
+
abortOnDeny: o.abortOnDeny,
|
|
172
|
+
dryRun: o.dryRun,
|
|
173
|
+
traceData: o.data,
|
|
174
|
+
arg0: o.file ?? 'mash',
|
|
175
|
+
stdin: process.stdin.isTTY ? undefined : process.stdin,
|
|
176
|
+
stdout: (chunk) => new Promise((r) => (process.stdout.write(chunk) ? r() : process.stdout.once('drain', r))),
|
|
177
|
+
stderr: (chunk) => void process.stderr.write(chunk),
|
|
178
|
+
hooks: o.dryRun
|
|
179
|
+
? { beforeCommand: (ctx) => void process.stderr.write(c('36', `[dry-run] ${ctx.argv.join(' ')}`) + (ctx.effects.length ? c('2', ` → ${ctx.effects.map(describeEffect).join(', ')}`) : '') + '\n') }
|
|
180
|
+
: undefined,
|
|
181
|
+
});
|
|
182
|
+
if (o.cmd === 'fmt') {
|
|
183
|
+
const { text } = format(source, o.fmt);
|
|
184
|
+
if (o.check) {
|
|
185
|
+
const same = text === source.replace(/\n$/, '');
|
|
186
|
+
if (!same)
|
|
187
|
+
process.stderr.write('mash fmt: not formatted\n');
|
|
188
|
+
process.exit(same ? 0 : 1);
|
|
189
|
+
}
|
|
190
|
+
process.stdout.write(text + '\n');
|
|
191
|
+
process.exit(0);
|
|
192
|
+
}
|
|
193
|
+
if (o.cmd === 'parse') {
|
|
194
|
+
const ast = machine.parse(source);
|
|
195
|
+
process.stdout.write(JSON.stringify(ast, null, 2) + '\n');
|
|
196
|
+
process.exit(0);
|
|
197
|
+
}
|
|
198
|
+
const script = machine.parse(source, o.file ?? '-c');
|
|
199
|
+
const report = machine.analyze(script);
|
|
200
|
+
function printReport() {
|
|
201
|
+
if (o.json) {
|
|
202
|
+
process.stdout.write(JSON.stringify(report, (k, v) => (typeof v === 'bigint' ? String(v) : v), 2) + '\n');
|
|
203
|
+
return;
|
|
204
|
+
}
|
|
205
|
+
const out = (s) => void process.stdout.write(s + '\n');
|
|
206
|
+
out(c('1', `verdict: ${report.verdict}`));
|
|
207
|
+
for (const r of report.reasons)
|
|
208
|
+
out(c('31', ` ✗ ${r}`));
|
|
209
|
+
out(c('1', '\ncommands:'));
|
|
210
|
+
for (const cmd of report.commands) {
|
|
211
|
+
const flags = [cmd.reach, cmd.context.loop ? 'loop' : '', cmd.context.pipeline ? 'pipe' : '', cmd.context.cmdsubst ? '$()' : '', cmd.context.function ? `fn:${cmd.context.function}` : ''].filter(Boolean).join(',');
|
|
212
|
+
const mark = cmd.verdict === 'deny' ? c('31', '✗') : cmd.verdict === 'unknown' ? c('33', '?') : c('32', '✓');
|
|
213
|
+
out(` ${mark} L${cmd.line} ${c('2', `[${flags}]`)} ${cmd.display}${cmd.complete ? '' : c('33', ' (effects incomplete)')}`);
|
|
214
|
+
for (const f of cmd.findings) {
|
|
215
|
+
if (f.verdict === 'allow' && f.effect.kind !== 'write' && f.effect.kind !== 'delete')
|
|
216
|
+
continue;
|
|
217
|
+
out(` ${f.verdict === 'deny' ? c('31', 'deny') : f.verdict === 'unknown' ? c('33', 'unknown') : c('32', 'allow')} ${describeEffect(f.effect)}${f.verdict !== 'allow' ? c('2', ` — ${f.reason}`) : ''}`);
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
if (report.variables.length) {
|
|
221
|
+
out(c('1', '\nvariables:'));
|
|
222
|
+
for (const v of report.variables)
|
|
223
|
+
out(` ${v.name}: ${c('36', v.type)} = ${v.value}`);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
if (o.cmd === 'analyze') {
|
|
227
|
+
printReport();
|
|
228
|
+
process.exit(report.verdict === 'reject' ? 1 : 0);
|
|
229
|
+
}
|
|
230
|
+
// run
|
|
231
|
+
if (o.preflight && report.verdict === 'reject') {
|
|
232
|
+
process.stderr.write(c('31', 'mash: refusing to run: the snippet would definitely violate the sandbox policy\n'));
|
|
233
|
+
for (const r of report.reasons)
|
|
234
|
+
process.stderr.write(c('31', ` ✗ ${r}\n`));
|
|
235
|
+
process.exit(126);
|
|
236
|
+
}
|
|
237
|
+
const traceFile = o.traceJson ? fs.openSync(o.traceJson, 'w') : undefined;
|
|
238
|
+
const depthOf = new Map();
|
|
239
|
+
machine.on((e) => {
|
|
240
|
+
if (traceFile !== undefined) {
|
|
241
|
+
fs.writeSync(traceFile, JSON.stringify(e, (k, v) => (v instanceof Uint8Array ? new TextDecoder().decode(v) : v)) + '\n');
|
|
242
|
+
}
|
|
243
|
+
if (!o.trace)
|
|
244
|
+
return;
|
|
245
|
+
const ind = (pid) => ' '.repeat(depthOf.get(pid) ?? 0);
|
|
246
|
+
const w = (s) => void process.stderr.write(s + '\n');
|
|
247
|
+
switch (e.type) {
|
|
248
|
+
case 'subshell:start':
|
|
249
|
+
depthOf.set(e.pid, (depthOf.get(e.parentPid) ?? 0) + 1);
|
|
250
|
+
w(c('2', `${ind(e.parentPid)}┌ ${e.reason} pid ${e.pid}`));
|
|
251
|
+
break;
|
|
252
|
+
case 'subshell:end':
|
|
253
|
+
w(c('2', `${ind(e.pid).slice(2)}└ pid ${e.pid} exit ${e.status}`));
|
|
254
|
+
break;
|
|
255
|
+
case 'command:start':
|
|
256
|
+
w(`${ind(e.pid)}${c('36', '$')} ${e.argv.join(' ')}${e.kind === 'external' ? '' : c('2', ` (${e.kind})`)}`);
|
|
257
|
+
break;
|
|
258
|
+
case 'command:end':
|
|
259
|
+
if (e.status !== 0)
|
|
260
|
+
w(c('33', ` ↳ exit ${e.status} (${e.durationMs}ms)`));
|
|
261
|
+
break;
|
|
262
|
+
case 'command:denied':
|
|
263
|
+
w(c('31', `⛔ ${e.argv.join(' ')}: ${e.reason}`));
|
|
264
|
+
break;
|
|
265
|
+
case 'loop:iteration':
|
|
266
|
+
w(c('35', `${ind(e.pid)}↻ iteration ${e.iteration}${e.variable ? ` ${e.variable}=${e.value}` : ''}`));
|
|
267
|
+
break;
|
|
268
|
+
case 'data':
|
|
269
|
+
if (e.channel.kind !== 'host')
|
|
270
|
+
w(c('2', ` ⇢ ${e.channel.label}: ${JSON.stringify(new TextDecoder().decode(e.bytes).slice(0, 80))}`));
|
|
271
|
+
break;
|
|
272
|
+
default:
|
|
273
|
+
break;
|
|
274
|
+
}
|
|
275
|
+
});
|
|
276
|
+
const result = await machine.run(script, { args: o.args });
|
|
277
|
+
if (traceFile !== undefined)
|
|
278
|
+
fs.closeSync(traceFile);
|
|
279
|
+
process.exitCode = result.status;
|
|
280
|
+
void describe;
|
|
281
|
+
//# sourceMappingURL=mash.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mash.js","sourceRoot":"","sources":["../../bin/mash.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Static analysis by abstract interpretation.
|
|
3
|
+
*
|
|
4
|
+
* Walks the AST with an abstract environment (variables → {@link AValue}s,
|
|
5
|
+
* abstract cwd, positional parameters), expands every simple command's words
|
|
6
|
+
* abstractly, applies the same behavior definitions the VM uses at runtime,
|
|
7
|
+
* and checks the predicted effects against the policy.
|
|
8
|
+
*
|
|
9
|
+
* Each command site gets a reachability: `must` when it runs on every
|
|
10
|
+
* execution that does not terminate earlier (not under a condition, loop body
|
|
11
|
+
* that may not run, `&&`/`||`, case arm, or uncalled function), else `may`.
|
|
12
|
+
* The report's verdict is `reject` when some `must` site has a definite
|
|
13
|
+
* policy violation — the snippet would certainly violate the policy if it
|
|
14
|
+
* gets that far — and `check-at-runtime` when violations are only possible.
|
|
15
|
+
*/
|
|
16
|
+
import type * as A from '../parser/ast.ts';
|
|
17
|
+
import type { BehaviorRegistry } from '../behaviors/registry.ts';
|
|
18
|
+
import type { Effect } from '../policy/effects.ts';
|
|
19
|
+
import { type Via } from '../policy/effects.ts';
|
|
20
|
+
import { type Policy, type PolicyFinding, type Verdict } from '../policy/policy.ts';
|
|
21
|
+
import { type AValue, type HoleType } from './value.ts';
|
|
22
|
+
export interface AnalyzeOptions {
|
|
23
|
+
cwd: AValue;
|
|
24
|
+
/** Concrete initial environment. */
|
|
25
|
+
env: Record<string, string>;
|
|
26
|
+
/** Abstract environment lookup (nested analysis of `bash -c`). Overrides `env`. */
|
|
27
|
+
envValues?: (name: string) => AValue | undefined;
|
|
28
|
+
policy: Policy;
|
|
29
|
+
behaviors: BehaviorRegistry;
|
|
30
|
+
positional?: AValue[];
|
|
31
|
+
/** Nested analysis (bash -c, eval): suppress uncalled-function reporting. */
|
|
32
|
+
nested?: boolean;
|
|
33
|
+
/** Reject definite violations reached on these paths (default: must and happy). */
|
|
34
|
+
rejectOn?: Reach[];
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* `must`: runs on every execution that does not terminate earlier.
|
|
38
|
+
* `happy`: runs if every preceding command succeeds (`a && b`, `cd x && cmd`).
|
|
39
|
+
* `may`: runs only under some condition (if/case arms, `||`, loop bodies that may not run).
|
|
40
|
+
*/
|
|
41
|
+
export type Reach = 'must' | 'happy' | 'may';
|
|
42
|
+
export interface CommandSite {
|
|
43
|
+
nodeId: number;
|
|
44
|
+
span: A.Span;
|
|
45
|
+
line: number;
|
|
46
|
+
text: string;
|
|
47
|
+
/** Abstractly expanded argv. */
|
|
48
|
+
argv: AValue[];
|
|
49
|
+
/** Human-readable argv (unknowns shown as ⟨origin⟩). */
|
|
50
|
+
display: string;
|
|
51
|
+
kind: 'builtin' | 'function' | 'external' | 'not-found' | 'unknown' | 'assignment';
|
|
52
|
+
reach: Reach;
|
|
53
|
+
context: {
|
|
54
|
+
loop: boolean;
|
|
55
|
+
subshell: boolean;
|
|
56
|
+
cmdsubst: boolean;
|
|
57
|
+
pipeline: boolean;
|
|
58
|
+
background: boolean;
|
|
59
|
+
function?: string;
|
|
60
|
+
};
|
|
61
|
+
cwd: AValue;
|
|
62
|
+
effects: Effect[];
|
|
63
|
+
/** The behavior definition fully determined the effects. */
|
|
64
|
+
complete: boolean;
|
|
65
|
+
findings: PolicyFinding[];
|
|
66
|
+
verdict: Verdict;
|
|
67
|
+
}
|
|
68
|
+
export interface VariableInfo {
|
|
69
|
+
name: string;
|
|
70
|
+
value: string;
|
|
71
|
+
type: HoleType | 'literal' | 'mixed' | 'array';
|
|
72
|
+
}
|
|
73
|
+
export interface Violation {
|
|
74
|
+
nodeId: number;
|
|
75
|
+
line: number;
|
|
76
|
+
text: string;
|
|
77
|
+
reach: Reach;
|
|
78
|
+
verdict: 'deny' | 'unknown';
|
|
79
|
+
reason: string;
|
|
80
|
+
/** The effect, with its provenance (`… (via \`rm x\` (s.sh:3))`) for nested commands. */
|
|
81
|
+
effect: string;
|
|
82
|
+
/** For effects of nested code (`bash -c`, scripts, `eval`, `source`): the inner commands, outermost first. */
|
|
83
|
+
via?: Via[];
|
|
84
|
+
}
|
|
85
|
+
export interface AnalysisReport {
|
|
86
|
+
commands: CommandSite[];
|
|
87
|
+
variables: VariableInfo[];
|
|
88
|
+
functions: string[];
|
|
89
|
+
violations: Violation[];
|
|
90
|
+
/** `reject`: a definite violation on a must-reach path. */
|
|
91
|
+
verdict: 'allow' | 'check-at-runtime' | 'reject';
|
|
92
|
+
reasons: string[];
|
|
93
|
+
}
|
|
94
|
+
export declare function analyzeScript(script: A.Script, source: string, opts: AnalyzeOptions): AnalysisReport;
|
|
95
|
+
/** Parse and analyze in one step. */
|
|
96
|
+
export declare function analyzeSource(source: string, opts: AnalyzeOptions): AnalysisReport;
|
|
97
|
+
//# sourceMappingURL=analyze.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/analysis/analyze.ts"],"names":[],"mappings":"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"}
|