@taliesinb/mash 0.0.0-stage → 0.1.1

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.
Files changed (208) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +275 -2
  3. package/bin/mash.ts +253 -0
  4. package/dist/bin/mash.d.ts +39 -0
  5. package/dist/bin/mash.d.ts.map +1 -0
  6. package/dist/bin/mash.js +281 -0
  7. package/dist/bin/mash.js.map +1 -0
  8. package/dist/src/analysis/analyze.d.ts +97 -0
  9. package/dist/src/analysis/analyze.d.ts.map +1 -0
  10. package/dist/src/analysis/analyze.js +1406 -0
  11. package/dist/src/analysis/analyze.js.map +1 -0
  12. package/dist/src/analysis/fs.d.ts +39 -0
  13. package/dist/src/analysis/fs.d.ts.map +1 -0
  14. package/dist/src/analysis/fs.js +117 -0
  15. package/dist/src/analysis/fs.js.map +1 -0
  16. package/dist/src/analysis/outputs.d.ts +16 -0
  17. package/dist/src/analysis/outputs.d.ts.map +1 -0
  18. package/dist/src/analysis/outputs.js +277 -0
  19. package/dist/src/analysis/outputs.js.map +1 -0
  20. package/dist/src/analysis/value.d.ts +76 -0
  21. package/dist/src/analysis/value.d.ts.map +1 -0
  22. package/dist/src/analysis/value.js +248 -0
  23. package/dist/src/analysis/value.js.map +1 -0
  24. package/dist/src/behaviors/defs/core.d.ts +15 -0
  25. package/dist/src/behaviors/defs/core.d.ts.map +1 -0
  26. package/dist/src/behaviors/defs/core.js +1084 -0
  27. package/dist/src/behaviors/defs/core.js.map +1 -0
  28. package/dist/src/behaviors/defs/devtools.d.ts +9 -0
  29. package/dist/src/behaviors/defs/devtools.d.ts.map +1 -0
  30. package/dist/src/behaviors/defs/devtools.js +432 -0
  31. package/dist/src/behaviors/defs/devtools.js.map +1 -0
  32. package/dist/src/behaviors/defs/macos.d.ts +12 -0
  33. package/dist/src/behaviors/defs/macos.d.ts.map +1 -0
  34. package/dist/src/behaviors/defs/macos.js +454 -0
  35. package/dist/src/behaviors/defs/macos.js.map +1 -0
  36. package/dist/src/behaviors/defs/tools.d.ts +9 -0
  37. package/dist/src/behaviors/defs/tools.d.ts.map +1 -0
  38. package/dist/src/behaviors/defs/tools.js +639 -0
  39. package/dist/src/behaviors/defs/tools.js.map +1 -0
  40. package/dist/src/behaviors/dsl.d.ts +95 -0
  41. package/dist/src/behaviors/dsl.d.ts.map +1 -0
  42. package/dist/src/behaviors/dsl.js +267 -0
  43. package/dist/src/behaviors/dsl.js.map +1 -0
  44. package/dist/src/behaviors/index.d.ts +12 -0
  45. package/dist/src/behaviors/index.d.ts.map +1 -0
  46. package/dist/src/behaviors/index.js +18 -0
  47. package/dist/src/behaviors/index.js.map +1 -0
  48. package/dist/src/behaviors/registry.d.ts +45 -0
  49. package/dist/src/behaviors/registry.d.ts.map +1 -0
  50. package/dist/src/behaviors/registry.js +266 -0
  51. package/dist/src/behaviors/registry.js.map +1 -0
  52. package/dist/src/behaviors/roles.d.ts +29 -0
  53. package/dist/src/behaviors/roles.d.ts.map +1 -0
  54. package/dist/src/behaviors/roles.js +198 -0
  55. package/dist/src/behaviors/roles.js.map +1 -0
  56. package/dist/src/behaviors/types.d.ts +120 -0
  57. package/dist/src/behaviors/types.d.ts.map +1 -0
  58. package/dist/src/behaviors/types.js +12 -0
  59. package/dist/src/behaviors/types.js.map +1 -0
  60. package/dist/src/index.d.ts +27 -0
  61. package/dist/src/index.d.ts.map +1 -0
  62. package/dist/src/index.js +24 -0
  63. package/dist/src/index.js.map +1 -0
  64. package/dist/src/integrations/deepsea.d.ts +121 -0
  65. package/dist/src/integrations/deepsea.d.ts.map +1 -0
  66. package/dist/src/integrations/deepsea.js +199 -0
  67. package/dist/src/integrations/deepsea.js.map +1 -0
  68. package/dist/src/machine.d.ts +139 -0
  69. package/dist/src/machine.d.ts.map +1 -0
  70. package/dist/src/machine.js +400 -0
  71. package/dist/src/machine.js.map +1 -0
  72. package/dist/src/parser/ast.d.ts +369 -0
  73. package/dist/src/parser/ast.d.ts.map +1 -0
  74. package/dist/src/parser/ast.js +17 -0
  75. package/dist/src/parser/ast.js.map +1 -0
  76. package/dist/src/parser/parser.d.ts +48 -0
  77. package/dist/src/parser/parser.d.ts.map +1 -0
  78. package/dist/src/parser/parser.js +1950 -0
  79. package/dist/src/parser/parser.js.map +1 -0
  80. package/dist/src/policy/effects.d.ts +86 -0
  81. package/dist/src/policy/effects.d.ts.map +1 -0
  82. package/dist/src/policy/effects.js +53 -0
  83. package/dist/src/policy/effects.js.map +1 -0
  84. package/dist/src/policy/policy.d.ts +130 -0
  85. package/dist/src/policy/policy.d.ts.map +1 -0
  86. package/dist/src/policy/policy.js +532 -0
  87. package/dist/src/policy/policy.js.map +1 -0
  88. package/dist/src/printer/doc.d.ts +151 -0
  89. package/dist/src/printer/doc.d.ts.map +1 -0
  90. package/dist/src/printer/doc.js +409 -0
  91. package/dist/src/printer/doc.js.map +1 -0
  92. package/dist/src/printer/highlight.d.ts +53 -0
  93. package/dist/src/printer/highlight.d.ts.map +1 -0
  94. package/dist/src/printer/highlight.js +339 -0
  95. package/dist/src/printer/highlight.js.map +1 -0
  96. package/dist/src/printer/html.d.ts +78 -0
  97. package/dist/src/printer/html.d.ts.map +1 -0
  98. package/dist/src/printer/html.js +426 -0
  99. package/dist/src/printer/html.js.map +1 -0
  100. package/dist/src/printer/index.d.ts +11 -0
  101. package/dist/src/printer/index.d.ts.map +1 -0
  102. package/dist/src/printer/index.js +11 -0
  103. package/dist/src/printer/index.js.map +1 -0
  104. package/dist/src/printer/print.d.ts +63 -0
  105. package/dist/src/printer/print.d.ts.map +1 -0
  106. package/dist/src/printer/print.js +484 -0
  107. package/dist/src/printer/print.js.map +1 -0
  108. package/dist/src/printer/summary.d.ts +57 -0
  109. package/dist/src/printer/summary.d.ts.map +1 -0
  110. package/dist/src/printer/summary.js +633 -0
  111. package/dist/src/printer/summary.js.map +1 -0
  112. package/dist/src/trace/events.d.ts +183 -0
  113. package/dist/src/trace/events.d.ts.map +1 -0
  114. package/dist/src/trace/events.js +9 -0
  115. package/dist/src/trace/events.js.map +1 -0
  116. package/dist/src/trace/progress.d.ts +58 -0
  117. package/dist/src/trace/progress.d.ts.map +1 -0
  118. package/dist/src/trace/progress.js +83 -0
  119. package/dist/src/trace/progress.js.map +1 -0
  120. package/dist/src/vm/arith.d.ts +29 -0
  121. package/dist/src/vm/arith.d.ts.map +1 -0
  122. package/dist/src/vm/arith.js +258 -0
  123. package/dist/src/vm/arith.js.map +1 -0
  124. package/dist/src/vm/builtins.d.ts +31 -0
  125. package/dist/src/vm/builtins.d.ts.map +1 -0
  126. package/dist/src/vm/builtins.js +1773 -0
  127. package/dist/src/vm/builtins.js.map +1 -0
  128. package/dist/src/vm/emulate.d.ts +75 -0
  129. package/dist/src/vm/emulate.d.ts.map +1 -0
  130. package/dist/src/vm/emulate.js +380 -0
  131. package/dist/src/vm/emulate.js.map +1 -0
  132. package/dist/src/vm/expand.d.ts +68 -0
  133. package/dist/src/vm/expand.d.ts.map +1 -0
  134. package/dist/src/vm/expand.js +744 -0
  135. package/dist/src/vm/expand.js.map +1 -0
  136. package/dist/src/vm/external.d.ts +34 -0
  137. package/dist/src/vm/external.d.ts.map +1 -0
  138. package/dist/src/vm/external.js +228 -0
  139. package/dist/src/vm/external.js.map +1 -0
  140. package/dist/src/vm/fifo.d.ts +66 -0
  141. package/dist/src/vm/fifo.d.ts.map +1 -0
  142. package/dist/src/vm/fifo.js +232 -0
  143. package/dist/src/vm/fifo.js.map +1 -0
  144. package/dist/src/vm/interp.d.ts +209 -0
  145. package/dist/src/vm/interp.d.ts.map +1 -0
  146. package/dist/src/vm/interp.js +1641 -0
  147. package/dist/src/vm/interp.js.map +1 -0
  148. package/dist/src/vm/io.d.ts +180 -0
  149. package/dist/src/vm/io.d.ts.map +1 -0
  150. package/dist/src/vm/io.js +502 -0
  151. package/dist/src/vm/io.js.map +1 -0
  152. package/dist/src/vm/pattern.d.ts +46 -0
  153. package/dist/src/vm/pattern.d.ts.map +1 -0
  154. package/dist/src/vm/pattern.js +498 -0
  155. package/dist/src/vm/pattern.js.map +1 -0
  156. package/dist/src/vm/proc.d.ts +94 -0
  157. package/dist/src/vm/proc.d.ts.map +1 -0
  158. package/dist/src/vm/proc.js +130 -0
  159. package/dist/src/vm/proc.js.map +1 -0
  160. package/dist/src/vm/state.d.ts +104 -0
  161. package/dist/src/vm/state.d.ts.map +1 -0
  162. package/dist/src/vm/state.js +233 -0
  163. package/dist/src/vm/state.js.map +1 -0
  164. package/dist/src/vm/test.d.ts +11 -0
  165. package/dist/src/vm/test.d.ts.map +1 -0
  166. package/dist/src/vm/test.js +277 -0
  167. package/dist/src/vm/test.js.map +1 -0
  168. package/package.json +67 -4
  169. package/src/analysis/analyze.ts +1395 -0
  170. package/src/analysis/fs.ts +121 -0
  171. package/src/analysis/outputs.ts +242 -0
  172. package/src/analysis/value.ts +264 -0
  173. package/src/behaviors/defs/core.ts +970 -0
  174. package/src/behaviors/defs/devtools.ts +400 -0
  175. package/src/behaviors/defs/macos.ts +426 -0
  176. package/src/behaviors/defs/tools.ts +596 -0
  177. package/src/behaviors/dsl.ts +293 -0
  178. package/src/behaviors/index.ts +19 -0
  179. package/src/behaviors/registry.ts +261 -0
  180. package/src/behaviors/roles.ts +187 -0
  181. package/src/behaviors/types.ts +127 -0
  182. package/src/index.ts +27 -0
  183. package/src/integrations/deepsea.ts +259 -0
  184. package/src/machine.ts +483 -0
  185. package/src/parser/ast.ts +472 -0
  186. package/src/parser/parser.ts +1826 -0
  187. package/src/policy/effects.ts +102 -0
  188. package/src/policy/policy.ts +578 -0
  189. package/src/printer/doc.ts +454 -0
  190. package/src/printer/highlight.ts +283 -0
  191. package/src/printer/html.ts +451 -0
  192. package/src/printer/index.ts +11 -0
  193. package/src/printer/print.ts +528 -0
  194. package/src/printer/summary.ts +621 -0
  195. package/src/trace/events.ts +102 -0
  196. package/src/trace/progress.ts +119 -0
  197. package/src/vm/arith.ts +236 -0
  198. package/src/vm/builtins.ts +1590 -0
  199. package/src/vm/emulate.ts +337 -0
  200. package/src/vm/expand.ts +721 -0
  201. package/src/vm/external.ts +265 -0
  202. package/src/vm/fifo.ts +226 -0
  203. package/src/vm/interp.ts +1623 -0
  204. package/src/vm/io.ts +570 -0
  205. package/src/vm/pattern.ts +477 -0
  206. package/src/vm/proc.ts +147 -0
  207. package/src/vm/state.ts +267 -0
  208. package/src/vm/test.ts +253 -0
@@ -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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"}