chore(json2sql): add misc, docs, CI workflow, dev tooling, tests

Automated batch commit.

Files changed:
  M .gitignore
   M README.md
   M package.json
  ?? .github/workflows/release-audit.yml
  ?? eslint.config.mjs
  ?? tests/smoke.test.js

Author: Senior Dev Rotation

.github/workflows/release-audit.yml

@@ -0,0 +1,64 @@
+name: release-audit
+
+on:
+  pull_request:
+    branches: [main, master]
+  push:
+    branches: [main, master]
+  workflow_dispatch:
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11  # v4.1.1 (pinned)
+        with:
+          path: target
+
+      - name: Check out the shared release-audit harness
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11  # v4.1.1 (pinned)
+        with:
+          repository: Coding-Dev-Tools/release-audit
+          path: harness
+          # Pin to a tag once a stable release is published; main is fine
+          # for now since the harness is small and self-contained.
+          ref: main
+
+      - name: Set up Python
+        uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c  # v5.0.0 (pinned)
+        with:
+          python-version: "3.11"
+
+      - name: Run the 8-angle release audit
+        working-directory: harness
+        env:
+          GITHUB_WORKSPACE: ${{ github.workspace }}
+        run: |
+          python audit.py "$GITHUB_WORKSPACE/target" --out-dir scorecard
+          python3 - <<'PY'
+          import json, os, pathlib
+          repo = pathlib.Path(os.environ["GITHUB_WORKSPACE"], "target").name
+          data = json.loads(pathlib.Path("scorecard", f"{repo}.json").read_text())
+          print("## Release Audit (8 angles)")
+          print()
+          print(f"**Overall grade: {data['overall_grade']}** ({data['angles_passing']}/{data['angles_total']} angles passing)")
+          print()
+          print("| Angle | Grade |")
+          print("|-------|-------|")
+          for a in data["angles"]:
+              print(f"| {a['angle']} | {a['grade']} |")
+          PY
+
+      - name: Fail on blockers
+        working-directory: harness
+        env:
+          GITHUB_WORKSPACE: ${{ github.workspace }}
+        run: |
+          python3 - <<'PY'
+          import json, os, pathlib, sys
+          repo = pathlib.Path(os.environ["GITHUB_WORKSPACE"], "target").name
+          data = json.loads(pathlib.Path("scorecard", f"{repo}.json").read_text())
+          if data["blockers"] > 0:
+              print(f"::error::{data['blockers']} release-blocker angle(s) — see audit output above")
+              sys.exit(1)
+          PY

.gitignore

@@ -72,3 +72,6 @@ Thumbs.db
 research/
 fixtures/generated/
 .ruff_cache/
+
+# Added by release-prep
+node_modules

README.md

@@ -130,3 +130,15 @@ json2sql is one of eleven CLI tools in the Revenue Holdings suite. One license c
 ## License
 
 MIT
+
+## Install
+
+```bash
+npm install
+```
+
+## Test
+
+```bash
+npm test  # runs: node --test tests/
+```

eslint.config.mjs

@@ -0,0 +1,21 @@
+import js from "@eslint/js";
+import globals from "globals";
+
+export default [
+  js.configs.recommended,
+  {
+    languageOptions: {
+      ecmaVersion: 2023,
+      sourceType: "commonjs",
+      globals: { ...globals.node },
+    },
+    rules: {
+      "no-unused-vars": "error",
+      "no-undef": "error",
+      "no-console": "warn",
+      "eqeqeq": "error",
+      "no-eval": "error",
+      "no-implied-eval": "error",
+    },
+  },
+];

package.json

@@ -41,5 +41,14 @@
   "preferGlobal": true,
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.js",
+    "lint": "eslint .",
+    "test:py": "pytest"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "eslint": "^9.0.0"
   }
 }

tests/smoke.test.js

@@ -0,0 +1,26 @@
+const test = require("node:test");
+const assert = require("node:assert");
+const { execFileSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+test("smoke: package main entry exists and parses", () => {
+  const pkg = require(path.join(__dirname, "..", "package.json"));
+  assert.ok(pkg.name, "package.json has a name");
+  const main = pkg.main || "index.js";
+  const cli = pkg.bin ? Object.values(pkg.bin)[0] : null;
+  const entry = cli || main;
+  if (fs.existsSync(path.join(__dirname, "..", entry))) {
+    assert.doesNotThrow(
+      () => execFileSync("node", ["--check", entry], { stdio: "ignore" }),
+      `${entry} must be valid JavaScript`
+    );
+  }
+});
+
+test("smoke: required repo files present", () => {
+  const root = path.join(__dirname, "..");
+  for (const f of ["package.json", "README.md", "LICENSE"]) {
+    assert.ok(fs.existsSync(path.join(root, f)), `${f} must exist`);
+  }
+});