@ox0/guards 0.1.0

package/README.md

@@ -0,0 +1,24 @@
+# @ox0/guards
+
+`@ox0/guards` is a deterministic syntax-level guard runner for React and TypeScript projects.
+
+## Primary Usage
+
+Inside `ox0`:
+
+```bash
+pnpm run check:guards
+```
+
+Inside another project where this package is installed:
+
+```bash
+pnpm exec ox0-guards --project .
+```
+
+## LLM Notes
+
+- Treat this tool like a fast project-specific linter.
+- Rules should reuse the parsed AST for a file instead of reparsing.
+- Prefer high-signal syntax checks over broad heuristic rules.
+- Keep suppressions explicit and narrow.

package/bin/ox0-guards.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process"
+import { createRequire } from "node:module"
+import { dirname, join } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const require = createRequire(import.meta.url)
+const cliPath = fileURLToPath(new URL("../src/cli.ts", import.meta.url))
+const tsxDir = dirname(require.resolve("tsx/package.json"))
+const tsxPath = join(tsxDir, "dist/cli.mjs")
+const result = spawnSync(process.execPath, [tsxPath, cliPath, ...process.argv.slice(2)], {
+  stdio: "inherit",
+})
+
+if (typeof result.status === "number") {
+  process.exit(result.status)
+}
+
+if (result.error) {
+  throw result.error
+}