New interpreter (#1)

Author: cramforce

.gitignore

@@ -6,4 +6,7 @@ node_modules
 .env.*
 dist
 debug-*.ts
-test-*.ts
+test-*.ts
+profile-*.mjs
+*.cpuprofile
+bench-*.mjs

AGENTS.md

@@ -1,5 +1,13 @@
 # Agent instructions
 
+- use `pnpm dev:exec` for evaluating scripts using BashEnv during development
+
+```text
+Usage: pnpm dev:exec '<bash script>'
+       echo '<script>' | pnpm dev:exec
+       cat script.sh | pnpm dev:exec
+```
+
 - Install packages via pnpm rather than editing package.json directly
 - Bias towards making new test files that are roughly logically grouped rather than letting test files gets too large. Try to stay below 300 lines. Prefer making a new file when you want to add a `describe()`
 - Prefer asserting the full STDOUT/STDERR output rather than using to.contain or to.not.contain
@@ -11,6 +19,7 @@
 - Use `pnpm lint:fix`
 - Strongly prefer running a temporary comparison test or unit test over an ad-hoc script to figure out the behavior of some bash script or API.
 - The implementation should align with the real behavior of bash, not what is convenient for TS or TE tests.
-- Don't use `cat > test-direct.ts << 'SCRIPT'` style test scripts because they constantly require 1-off approval. Instead make comparison-tests and see what they output. event console.log is there is you remove later.
-  - using `npx tsx -e '…` is another good option for adhoc testing.
+- Don't use `cat > test-direct.ts << 'SCRIPT'` style test scripts because they constantly require 1-off approval.
+- Instead use `pnpm dev:exec ""`
 - Always make sure to build before using dist
+- Biome rules often have the same name as eslint rules (if you are lookinf for one)

biome.json

@@ -7,16 +7,19 @@
       "recommended": true,
       "correctness": {
         "noUnusedImports": "error",
-        "noUnusedVariables": "error"
+        "noUnusedVariables": "error",
+        "noUnusedPrivateClassMembers": "error"
       },
       "suspicious": {
         "noTemplateCurlyInString": "off",
         "noControlCharactersInRegex": "off",
         "noImplicitAnyLet": "error",
-        "noAssignInExpressions": "error"
+        "noAssignInExpressions": "error",
+        "noExplicitAny": "error"
       },
       "style": {
-        "noNonNullAssertion": "error"
+        "noNonNullAssertion": "error",
+        "useTemplate": "error"
       }
     }
   },

package.json

@@ -27,7 +27,8 @@
     "test:run": "vitest run",
     "test:unit": "vitest run --config vitest.unit.config.ts",
     "test:comparison": "vitest run --config vitest.comparison.config.ts",
-    "shell": "npx tsx src/cli/shell.ts"
+    "shell": "npx tsx src/cli/shell.ts",
+    "dev:exec": "npx tsx src/cli/exec.ts"
   },
   "keywords": [],
   "author": "",