hook-o-gnese 0.0.1

package/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026 [Your Name]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -0,0 +1,182 @@
+# hook-o-gnese
+
+> Score React component complexity from hook usage. Catch fat effects, scattered state, and coupled hooks before they ship.
+
+[![npm](https://img.shields.io/npm/v/hook-o-gnese.svg)](https://www.npmjs.com/package/hook-o-gnese)
+[![JSR](https://jsr.io/badges/hook-o-gnese)](https://jsr.io/hook-o-gnese)
+[![CI](https://github.com/rehoutm/spaghetti-hook-o-gnese/actions/workflows/ci.yml/badge.svg)](https://github.com/rehoutm/spaghetti-hook-o-gnese/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Most lint rules check syntax. **hook-o-gnese checks complexity.** It scores how dense your React hooks are — useEffect blocks bloated with branches and `setState` calls, components with too many `useState`s that should be a `useReducer`, effects that read and write the same state (loop bait), and custom hooks stacked too deep.
+
+```bash
+npx hook-o-gnese ./src
+```
+
+```
+src/components/Banner.tsx
+  1:1     warn   useEffect entropy 23.5 ≥ 10 (deps=4 branches=9 setStates=1 nested=0)  hook-o-gnese/no-fat-effects
+  1:1     error  useEffect reads + writes same state 'open' (loop risk)                hook-o-gnese/hook-coupling
+
+src/screens/Settings.tsx
+  1:1     warn   state scatter 8 ≥ 5 (useStates=3, correlated setters=10). Consider useReducer.  hook-o-gnese/state-scatter
+
+3 problems (1 error, 2 warnings) in 470 files, 415ms
+```
+
+## Why
+
+You've seen the file. 800 lines of component, fifteen `useState` calls, a `useEffect` whose dependency array reads like a phone book, and a comment that says `// TODO: refactor`. By the time anyone notices, it's already in production and nobody wants to touch it.
+
+`hook-o-gnese` is your early warning system. It measures the smells objectively, surfaces them in CI, and gives you concrete numbers to argue with in code review.
+
+## What it catches
+
+| Rule | Smell | Default |
+|---|---|---|
+| `no-fat-effects` | useEffect blocks dense with branches, setState calls, missing cleanup | warn at score ≥ 10 |
+| `state-scatter` | Components with too many `useState` calls (probably want `useReducer`) | warn at score ≥ 5 |
+| `hook-coupling` | useEffect that reads state it also writes (re-render loop bait) | error |
+| `custom-hook-depth` | Custom hooks calling custom hooks calling custom hooks (type-aware) | warn at depth ≥ 3 |
+
+Full scoring formulas in [docs/thresholds.md](docs/thresholds.md). Per-rule reference in [docs/rule-reference.md](docs/rule-reference.md).
+
+## Two ways to run
+
+### 1. Standalone CLI — recommended for most
+
+No linter setup required. Works in any project. Outputs stylish, JSON, SARIF (for GitHub code scanning), or GitHub Actions annotations.
+
+```bash
+npx hook-o-gnese ./src
+npx hook-o-gnese ./src --format=sarif > report.sarif
+npx hook-o-gnese ./src --type-aware  # enables custom-hook-depth
+```
+
+Add a `.hookogneserc.json` if you want to tune thresholds:
+
+```jsonc
+{
+  "rules": {
+    "hook-o-gnese/no-fat-effects": ["warn", { "threshold": 12 }],
+    "hook-o-gnese/state-scatter": "warn",
+    "hook-o-gnese/hook-coupling": "error",
+    "hook-o-gnese/custom-hook-depth": ["warn", { "maxDepth": 3 }]
+  },
+  "ignore": ["**/legacy/**"],
+  "typeAware": true
+}
+```
+
+Full CLI reference: [docs/cli.md](docs/cli.md).
+
+### 2. Oxlint plugin — if you're already on oxlint
+
+```bash
+npm install -D hook-o-gnese oxlint
+```
+
+```jsonc
+// .oxlintrc.json
+{
+  "jsPlugins": ["./node_modules/hook-o-gnese/dist/index.mjs"],
+  "rules": {
+    "hook-o-gnese/no-fat-effects": "warn",
+    "hook-o-gnese/state-scatter": "warn",
+    "hook-o-gnese/hook-coupling": "error",
+    "hook-o-gnese/custom-hook-depth": ["warn", { "maxDepth": 3 }]
+  }
+}
+```
+
+Or import the recommended preset, which bundles tsgolint type-aware rules (`no-floating-promises`, `no-misused-promises`):
+
+```ts
+import { recommended } from "hook-o-gnese";
+```
+
+## Output formats
+
+```bash
+# Human-readable (default)
+hook-o-gnese ./src
+
+# Machine-readable for tooling / agentic loops
+hook-o-gnese ./src --format=json
+
+# SARIF for GitHub code scanning
+hook-o-gnese ./src --format=sarif > report.sarif
+
+# GitHub Actions inline annotations
+hook-o-gnese ./src --format=github
+```
+
+## CI: GitHub Actions
+
+```yaml
+- name: Lint hook complexity
+  run: npx hook-o-gnese ./src --format=github
+```
+
+For PR-level code-scanning UI:
+
+```yaml
+- run: npx hook-o-gnese ./src --format=sarif > hook-o-gnese.sarif
+- uses: github/codeql-action/upload-sarif@v3
+  with:
+    sarif_file: hook-o-gnese.sarif
+```
+
+## Programmatic API
+
+```ts
+import { lintFile, lintFiles } from "hook-o-gnese/engine";
+
+const diagnostics = await lintFile("Component.tsx", source, {
+  rules: { "hook-o-gnese/no-fat-effects": { severity: "warn" } },
+  cwd: process.cwd(),
+  typeAware: false,
+});
+```
+
+## Performance
+
+Sequential per-file scan, but each file is cheap:
+
+| Path | Cold start | Per-file warm |
+|---|---|---|
+| Node CLI (`npx`) | ~80ms | ~3–5ms |
+| Standalone binary (`deno compile`) | ~30ms | ~3–5ms |
+| Type-aware rule (first run) | +50–150ms | TS Program load |
+
+Linear scan of ~200 files/sec on a single core. Rouvy companion app: 470 files in 415ms.
+
+## Standalone binary
+
+The CLI also ships as a single static binary built with `deno compile` — no Node, no Deno, no install required:
+
+```bash
+git clone https://github.com/rehoutm/spaghetti-hook-o-gnese
+cd hook-o-gnese
+deno task build:bin
+./bin/hook-o-gnese ./src
+```
+
+## Honest limitations
+
+- **`custom-hook-depth` uses the TypeScript Compiler API**, not tsgolint's Go backend. Oxlint's JS plugin API doesn't expose tsgolint type info to custom rules, so we lazily build a `ts.Program` for that one rule. ~50–150ms first-run cost, then cached.
+- **Sequential file scan.** Worker-thread parallelism is on the v1.5 list. Current per-file cost (~3–5ms) means linear scanning is fine through ~thousands of files.
+- **No daemon mode yet.** Each invocation is a fresh process. Also v1.5.
+
+## Compatibility
+
+- **Node:** ≥ 20.18
+- **Deno:** ≥ 2.x
+- **TypeScript:** ≥ 6.0 (peer)
+- **Oxlint:** ≥ 1.63 (peer, optional — only needed for plugin path)
+
+ESM only. No CJS build.
+
+## License
+
+MIT

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+import { n as lintFiles } from "./engine-DJFFKwTZ.mjs";
+import { parseArgs } from "node:util";
+import { readFile } from "node:fs/promises";
+import { globby } from "globby";
+//#region src/config.ts
+const DEFAULT_RULES = {
+	"hook-o-gnese/no-fat-effects": { severity: "warn" },
+	"hook-o-gnese/state-scatter": { severity: "warn" },
+	"hook-o-gnese/hook-coupling": { severity: "error" },
+	"hook-o-gnese/custom-hook-depth": {
+		severity: "warn",
+		options: { maxDepth: 3 }
+	}
+};
+const DEFAULT_IGNORE = [
+	"**/node_modules/**",
+	"**/dist/**",
+	"**/build/**",
+	"**/.next/**",
+	"**/.cache/**"
+];
+async function loadConfig(cwd, configPath, readTextFile) {
+	const candidates = configPath ? [configPath] : [`${cwd.replace(/\/$/, "")}/.hookogneserc.json`];
+	let fileCfg = {};
+	for (const c of candidates) try {
+		const text = await readTextFile(c);
+		fileCfg = JSON.parse(text);
+		break;
+	} catch {}
+	const rules = { ...DEFAULT_RULES };
+	if (fileCfg.rules) for (const [id, spec] of Object.entries(fileCfg.rules)) if (Array.isArray(spec)) rules[id] = {
+		severity: spec[0],
+		options: spec[1]
+	};
+	else rules[id] = { severity: spec };
+	return {
+		engine: {
+			rules,
+			cwd,
+			typeAware: fileCfg.typeAware ?? false
+		},
+		ignore: fileCfg.ignore ?? DEFAULT_IGNORE
+	};
+}
+function applyCliRuleOverrides(cfg, overrides) {
+	const rules = { ...cfg.rules };
+	for (const o of overrides) rules[o.id] = {
+		...rules[o.id] ?? { severity: "off" },
+		severity: o.severity
+	};
+	return {
+		...cfg,
+		rules
+	};
+}
+//#endregion
+//#region src/formatters/stylish.ts
+const stylish = ({ diagnostics, filesScanned, durationMs }) => {
+	if (diagnostics.length === 0) return `✓ no problems found (${filesScanned} files, ${durationMs}ms)\n`;
+	const byFile = /* @__PURE__ */ new Map();
+	for (const d of diagnostics) {
+		if (!byFile.has(d.file)) byFile.set(d.file, []);
+		byFile.get(d.file).push(d);
+	}
+	const lines = [];
+	for (const [file, ds] of byFile) {
+		lines.push(`\n${file}`);
+		for (const d of ds) {
+			const sev = d.severity === "error" ? "error" : "warn ";
+			const loc = `${d.line}:${d.column}`.padEnd(7);
+			lines.push(`  ${loc} ${sev}  ${d.message}  ${d.rule}`);
+		}
+	}
+	const errors = diagnostics.filter((d) => d.severity === "error").length;
+	const warnings = diagnostics.filter((d) => d.severity === "warn").length;
+	lines.push(`\n${diagnostics.length} problems (${errors} error${errors === 1 ? "" : "s"}, ${warnings} warning${warnings === 1 ? "" : "s"}) in ${filesScanned} files, ${durationMs}ms`);
+	return lines.join("\n") + "\n";
+};
+//#endregion
+//#region src/formatters/json.ts
+const json = (ctx) => JSON.stringify(ctx, null, 2);
+//#endregion
+//#region src/formatters/sarif.ts
+const sarif = ({ diagnostics }) => {
+	const ruleIds = [...new Set(diagnostics.map((d) => d.rule))];
+	return JSON.stringify({
+		version: "2.1.0",
+		$schema: "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/main/sarif-2.1/schema/sarif-schema-2.1.0.json",
+		runs: [{
+			tool: { driver: {
+				name: "hook-o-gnese",
+				informationUri: "https://github.com/rehoutm/spaghetti-hook-o-gnese",
+				rules: ruleIds.map((id) => ({ id }))
+			} },
+			results: diagnostics.map((d) => ({
+				ruleId: d.rule,
+				level: d.severity === "error" ? "error" : "warning",
+				message: { text: d.message },
+				locations: [{ physicalLocation: {
+					artifactLocation: { uri: d.file },
+					region: {
+						startLine: d.line,
+						startColumn: d.column,
+						endLine: d.endLine,
+						endColumn: d.endColumn
+					}
+				} }]
+			}))
+		}]
+	}, null, 2);
+};
+//#endregion
+//#region src/formatters/github.ts
+const github = ({ diagnostics }) => diagnostics.map((d) => {
+	const cmd = d.severity === "error" ? "::error" : "::warning";
+	const safe = d.message.replace(/\r?\n/g, " ").replace(/::/g, ":");
+	return `${cmd} file=${d.file},line=${d.line},col=${d.column},title=${d.rule}::${safe}`;
+}).join("\n") + "\n";
+//#endregion
+//#region src/cli-core.ts
+const FORMATTERS = {
+	stylish,
+	json,
+	sarif,
+	github
+};
+const HELP = `
+hook-o-gnese — score React hook complexity
+
+Usage:
+  hook-o-gnese [options] <paths...>
+
+Options:
+  --format=<fmt>          stylish (default) | json | sarif | github
+  --config=<path>         path to .hookogneserc.json
+  --type-aware            enable custom-hook-depth (slower, uses TS Compiler API)
+  --rule=<id>=<sev>       override rule severity (off|warn|error). Repeatable.
+  --help, -h              show this message
+
+Examples:
+  hook-o-gnese ./src
+  hook-o-gnese ./src --format=sarif > report.sarif
+  hook-o-gnese ./src --type-aware --rule=hook-o-gnese/state-scatter=error
+`.trim();
+async function runCli(opts, io) {
+	if (opts.paths.length === 0) {
+		io.writeStderr("Error: no paths provided. Use --help for usage.\n");
+		return 2;
+	}
+	const formatter = FORMATTERS[opts.format];
+	if (!formatter) {
+		io.writeStderr(`Error: unknown format '${opts.format}'\n`);
+		return 2;
+	}
+	const { engine, ignore } = await loadConfig(opts.cwd, opts.config, io.readTextFile);
+	if (opts.typeAware) engine.typeAware = true;
+	const finalEngine = applyCliRuleOverrides(engine, opts.ruleOverrides);
+	const files = await globby(opts.paths, {
+		ignore: [...DEFAULT_IGNORE, ...ignore],
+		expandDirectories: { extensions: [
+			"ts",
+			"tsx",
+			"js",
+			"jsx"
+		] },
+		absolute: false
+	});
+	if (files.length === 0) {
+		io.writeStderr("Error: no matching files found\n");
+		return 2;
+	}
+	const start = performance.now();
+	const diagnostics = await lintFiles(files, finalEngine, io.readTextFile);
+	const durationMs = Math.round(performance.now() - start);
+	io.writeStdout(formatter({
+		diagnostics,
+		filesScanned: files.length,
+		durationMs
+	}));
+	if (diagnostics.some((d) => d.severity === "error")) return 1;
+	return 0;
+}
+//#endregion
+//#region src/cli.node.ts
+const { values, positionals } = parseArgs({
+	args: process.argv.slice(2),
+	options: {
+		help: {
+			type: "boolean",
+			short: "h"
+		},
+		"type-aware": { type: "boolean" },
+		format: {
+			type: "string",
+			default: "stylish"
+		},
+		config: { type: "string" },
+		rule: {
+			type: "string",
+			multiple: true
+		}
+	},
+	allowPositionals: true
+});
+if (values.help) {
+	console.log(HELP);
+	process.exit(0);
+}
+const overrides = (values.rule ?? []).map((spec) => {
+	const [id, sev] = spec.split("=");
+	return {
+		id,
+		severity: sev
+	};
+});
+const code = await runCli({
+	paths: positionals,
+	format: values.format,
+	config: values.config,
+	typeAware: !!values["type-aware"],
+	ruleOverrides: overrides,
+	cwd: process.cwd()
+}, {
+	readTextFile: (p) => readFile(p, "utf-8"),
+	writeStdout: (s) => {
+		process.stdout.write(s);
+	},
+	writeStderr: (s) => {
+		process.stderr.write(s);
+	}
+});
+process.exit(code);
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["jsonFmt"],"sources":["../src/config.ts","../src/formatters/stylish.ts","../src/formatters/json.ts","../src/formatters/sarif.ts","../src/formatters/github.ts","../src/cli-core.ts","../src/cli.node.ts"],"sourcesContent":["import type { EngineConfig, Severity } from \"./engine.ts\";\n\nconst DEFAULT_RULES: Record<string, { severity: Severity; options?: unknown }> = {\n  \"hook-o-gnese/no-fat-effects\": { severity: \"warn\" },\n  \"hook-o-gnese/state-scatter\": { severity: \"warn\" },\n  \"hook-o-gnese/hook-coupling\": { severity: \"error\" },\n  \"hook-o-gnese/custom-hook-depth\": { severity: \"warn\", options: { maxDepth: 3 } },\n};\n\nexport const DEFAULT_IGNORE = [\n  \"**/node_modules/**\",\n  \"**/dist/**\",\n  \"**/build/**\",\n  \"**/.next/**\",\n  \"**/.cache/**\",\n];\n\ninterface FileConfig {\n  rules?: Record<string, Severity | [Severity, unknown]>;\n  ignore?: string[];\n  typeAware?: boolean;\n}\n\nexport type ReadTextFile = (path: string) => Promise<string>;\n\nexport async function loadConfig(\n  cwd: string,\n  configPath: string | undefined,\n  readTextFile: ReadTextFile,\n): Promise<{ engine: EngineConfig; ignore: string[] }> {\n  const candidates = configPath\n    ? [configPath]\n    : [`${cwd.replace(/\\/$/, \"\")}/.hookogneserc.json`];\n\n  let fileCfg: FileConfig = {};\n  for (const c of candidates) {\n    try {\n      const text = await readTextFile(c);\n      fileCfg = JSON.parse(text);\n      break;\n    } catch {\n      // not found — fine, use defaults\n    }\n  }\n\n  const rules: EngineConfig[\"rules\"] = { ...DEFAULT_RULES };\n  if (fileCfg.rules) {\n    for (const [id, spec] of Object.entries(fileCfg.rules)) {\n      if (Array.isArray(spec)) {\n        rules[id] = { severity: spec[0], options: spec[1] };\n      } else {\n        rules[id] = { severity: spec };\n      }\n    }\n  }\n\n  return {\n    engine: {\n      rules,\n      cwd,\n      typeAware: fileCfg.typeAware ?? false,\n    },\n    ignore: fileCfg.ignore ?? DEFAULT_IGNORE,\n  };\n}\n\nexport function applyCliRuleOverrides(\n  cfg: EngineConfig,\n  overrides: Array<{ id: string; severity: Severity }>,\n): EngineConfig {\n  const rules = { ...cfg.rules };\n  for (const o of overrides) {\n    rules[o.id] = { ...(rules[o.id] ?? { severity: \"off\" }), severity: o.severity };\n  }\n  return { ...cfg, rules };\n}\n","import type { Formatter } from \"./types.ts\";\n\nexport const stylish: Formatter = ({ diagnostics, filesScanned, durationMs }) => {\n  if (diagnostics.length === 0) {\n    return `✓ no problems found (${filesScanned} files, ${durationMs}ms)\\n`;\n  }\n  const byFile = new Map<string, typeof diagnostics>();\n  for (const d of diagnostics) {\n    if (!byFile.has(d.file)) byFile.set(d.file, []);\n    byFile.get(d.file)!.push(d);\n  }\n  const lines: string[] = [];\n  for (const [file, ds] of byFile) {\n    lines.push(`\\n${file}`);\n    for (const d of ds) {\n      const sev = d.severity === \"error\" ? \"error\" : \"warn \";\n      const loc = `${d.line}:${d.column}`.padEnd(7);\n      lines.push(`  ${loc} ${sev}  ${d.message}  ${d.rule}`);\n    }\n  }\n  const errors = diagnostics.filter((d) => d.severity === \"error\").length;\n  const warnings = diagnostics.filter((d) => d.severity === \"warn\").length;\n  lines.push(\n    `\\n${diagnostics.length} problems (${errors} error${errors === 1 ? \"\" : \"s\"}, ${warnings} warning${warnings === 1 ? \"\" : \"s\"}) in ${filesScanned} files, ${durationMs}ms`,\n  );\n  return lines.join(\"\\n\") + \"\\n\";\n};\n","import type { Formatter } from \"./types.ts\";\n\nexport const json: Formatter = (ctx) => JSON.stringify(ctx, null, 2);\n","import type { Formatter } from \"./types.ts\";\n\nexport const sarif: Formatter = ({ diagnostics }) => {\n  const ruleIds = [...new Set(diagnostics.map((d) => d.rule))];\n  return JSON.stringify(\n    {\n      version: \"2.1.0\",\n      $schema:\n        \"https://raw.githubusercontent.com/oasis-tcs/sarif-spec/main/sarif-2.1/schema/sarif-schema-2.1.0.json\",\n      runs: [{\n        tool: {\n          driver: {\n            name: \"hook-o-gnese\",\n            informationUri: \"https://github.com/rehoutm/spaghetti-hook-o-gnese\",\n            rules: ruleIds.map((id) => ({ id })),\n          },\n        },\n        results: diagnostics.map((d) => ({\n          ruleId: d.rule,\n          level: d.severity === \"error\" ? \"error\" : \"warning\",\n          message: { text: d.message },\n          locations: [{\n            physicalLocation: {\n              artifactLocation: { uri: d.file },\n              region: {\n                startLine: d.line,\n                startColumn: d.column,\n                endLine: d.endLine,\n                endColumn: d.endColumn,\n              },\n            },\n          }],\n        })),\n      }],\n    },\n    null,\n    2,\n  );\n};\n","import type { Formatter } from \"./types.ts\";\n\nexport const github: Formatter = ({ diagnostics }) =>\n  diagnostics.map((d) => {\n    const cmd = d.severity === \"error\" ? \"::error\" : \"::warning\";\n    const safe = d.message.replace(/\\r?\\n/g, \" \").replace(/::/g, \":\");\n    return `${cmd} file=${d.file},line=${d.line},col=${d.column},title=${d.rule}::${safe}`;\n  }).join(\"\\n\") + \"\\n\";\n","import { globby } from \"globby\";\nimport { lintFiles } from \"./engine.ts\";\nimport type { Severity } from \"./engine.ts\";\nimport { applyCliRuleOverrides, DEFAULT_IGNORE, loadConfig } from \"./config.ts\";\nimport { stylish } from \"./formatters/stylish.ts\";\nimport { json as jsonFmt } from \"./formatters/json.ts\";\nimport { sarif } from \"./formatters/sarif.ts\";\nimport { github } from \"./formatters/github.ts\";\nimport type { Formatter } from \"./formatters/types.ts\";\n\nconst FORMATTERS: Record<string, Formatter> = {\n  stylish,\n  json: jsonFmt,\n  sarif,\n  github,\n};\n\nexport const HELP = `\nhook-o-gnese — score React hook complexity\n\nUsage:\n  hook-o-gnese [options] <paths...>\n\nOptions:\n  --format=<fmt>          stylish (default) | json | sarif | github\n  --config=<path>         path to .hookogneserc.json\n  --type-aware            enable custom-hook-depth (slower, uses TS Compiler API)\n  --rule=<id>=<sev>       override rule severity (off|warn|error). Repeatable.\n  --help, -h              show this message\n\nExamples:\n  hook-o-gnese ./src\n  hook-o-gnese ./src --format=sarif > report.sarif\n  hook-o-gnese ./src --type-aware --rule=hook-o-gnese/state-scatter=error\n`.trim();\n\nexport interface CliOptions {\n  paths: string[];\n  format: string;\n  config?: string;\n  typeAware: boolean;\n  ruleOverrides: Array<{ id: string; severity: Severity }>;\n  cwd: string;\n}\n\nexport interface RuntimeIO {\n  readTextFile(path: string): Promise<string>;\n  writeStdout(s: string): void;\n  writeStderr(s: string): void;\n}\n\nexport async function runCli(opts: CliOptions, io: RuntimeIO): Promise<number> {\n  if (opts.paths.length === 0) {\n    io.writeStderr(\"Error: no paths provided. Use --help for usage.\\n\");\n    return 2;\n  }\n\n  const formatter = FORMATTERS[opts.format];\n  if (!formatter) {\n    io.writeStderr(`Error: unknown format '${opts.format}'\\n`);\n    return 2;\n  }\n\n  const { engine, ignore } = await loadConfig(opts.cwd, opts.config, io.readTextFile);\n  if (opts.typeAware) engine.typeAware = true;\n  const finalEngine = applyCliRuleOverrides(engine, opts.ruleOverrides);\n\n  const files = await globby(opts.paths, {\n    ignore: [...DEFAULT_IGNORE, ...ignore],\n    expandDirectories: { extensions: [\"ts\", \"tsx\", \"js\", \"jsx\"] },\n    absolute: false,\n  });\n\n  if (files.length === 0) {\n    io.writeStderr(\"Error: no matching files found\\n\");\n    return 2;\n  }\n\n  const start = performance.now();\n  const diagnostics = await lintFiles(files, finalEngine, io.readTextFile);\n  const durationMs = Math.round(performance.now() - start);\n\n  io.writeStdout(formatter({\n    diagnostics,\n    filesScanned: files.length,\n    durationMs,\n  }));\n\n  if (diagnostics.some((d) => d.severity === \"error\")) return 1;\n  return 0;\n}\n","#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { readFile } from \"node:fs/promises\";\nimport { HELP, runCli } from \"./cli-core.ts\";\nimport type { Severity } from \"./engine.ts\";\n\nconst { values, positionals } = parseArgs({\n  args: process.argv.slice(2),\n  options: {\n    help: { type: \"boolean\", short: \"h\" },\n    \"type-aware\": { type: \"boolean\" },\n    format: { type: \"string\", default: \"stylish\" },\n    config: { type: \"string\" },\n    rule: { type: \"string\", multiple: true },\n  },\n  allowPositionals: true,\n});\n\nif (values.help) {\n  console.log(HELP);\n  process.exit(0);\n}\n\nconst overrides = (values.rule ?? []).map((spec) => {\n  const [id, sev] = spec.split(\"=\");\n  return { id, severity: sev as Severity };\n});\n\nconst code = await runCli(\n  {\n    paths: positionals,\n    format: values.format as string,\n    config: values.config,\n    typeAware: !!values[\"type-aware\"],\n    ruleOverrides: overrides,\n    cwd: process.cwd(),\n  },\n  {\n    readTextFile: (p) => readFile(p, \"utf-8\"),\n    writeStdout: (s) => {\n      process.stdout.write(s);\n    },\n    writeStderr: (s) => {\n      process.stderr.write(s);\n    },\n  },\n);\nprocess.exit(code);\n"],"mappings":"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"}

package/dist/engine-DJFFKwTZ.mjs

@@ -0,0 +1,114 @@
+import { t as ALL_RULES } from "./registry-iRG6wil9.mjs";
+import { parseSync } from "oxc-parser";
+//#region src/engine.ts
+const TYPE_AWARE_RULES = new Set(["hook-o-gnese/custom-hook-depth"]);
+function ruleNamespace(id) {
+	return id.replace(/^hook-o-gnese\//, "");
+}
+function buildLineOffsets(source) {
+	const offsets = [0];
+	for (let i = 0; i < source.length; i++) if (source.charCodeAt(i) === 10) offsets.push(i + 1);
+	return offsets;
+}
+function offsetToLineCol(offset, lineOffsets) {
+	let lo = 0;
+	let hi = lineOffsets.length - 1;
+	while (lo < hi) {
+		const mid = lo + hi + 1 >>> 1;
+		if (lineOffsets[mid] <= offset) lo = mid;
+		else hi = mid - 1;
+	}
+	return {
+		line: lo + 1,
+		column: offset - lineOffsets[lo] + 1
+	};
+}
+function getLoc(node, lineOffsets) {
+	const startOffset = typeof node?.start === "number" ? node.start : void 0;
+	const endOffset = typeof node?.end === "number" ? node.end : void 0;
+	if (startOffset === void 0) return {
+		line: 1,
+		column: 1
+	};
+	const start = offsetToLineCol(startOffset, lineOffsets);
+	const end = endOffset !== void 0 ? offsetToLineCol(endOffset, lineOffsets) : void 0;
+	return {
+		line: start.line,
+		column: start.column,
+		endLine: end?.line,
+		endColumn: end?.column
+	};
+}
+function walkAST(node, handlers) {
+	if (!node || typeof node !== "object") return;
+	const enter = handlers[node.type];
+	if (enter) enter(node);
+	for (const key in node) {
+		const v = node[key];
+		if (Array.isArray(v)) for (const c of v) walkAST(c, handlers);
+		else if (v && typeof v === "object") walkAST(v, handlers);
+	}
+	const exit = handlers[`${node.type}:exit`];
+	if (exit) exit(node);
+}
+async function lintFile(filePath, source, config) {
+	const parsed = parseSync(filePath, source, {
+		lang: filePath.endsWith(".tsx") ? "tsx" : filePath.endsWith(".ts") ? "ts" : filePath.endsWith(".jsx") ? "jsx" : "js",
+		sourceType: "module"
+	});
+	const lineOffsets = buildLineOffsets(source);
+	if (parsed.errors?.length) return parsed.errors.map((e) => {
+		const offset = typeof e.labels?.[0]?.start === "number" ? e.labels[0].start : void 0;
+		const loc = offset !== void 0 ? offsetToLineCol(offset, lineOffsets) : {
+			line: 1,
+			column: 1
+		};
+		return {
+			file: filePath,
+			rule: "parse-error",
+			severity: "error",
+			message: e.message ?? "parse error",
+			line: loc.line,
+			column: loc.column
+		};
+	});
+	if (!(parsed.module?.staticImports ?? []).some((i) => (i.moduleRequest?.value ?? i.source?.value) === "react")) return [];
+	const out = [];
+	for (const [ruleId, ruleCfg] of Object.entries(config.rules)) {
+		if (ruleCfg.severity === "off") continue;
+		if (!config.typeAware && TYPE_AWARE_RULES.has(ruleId)) continue;
+		const rule = ALL_RULES[ruleNamespace(ruleId)];
+		if (!rule) continue;
+		const localDiags = [];
+		const context = {
+			options: ruleCfg.options ? [ruleCfg.options] : [],
+			filename: filePath,
+			cwd: config.cwd,
+			report(d) {
+				const loc = getLoc(d.node, lineOffsets);
+				const cfgSev = ruleCfg.severity;
+				const severity = d.severity === "error" ? "error" : cfgSev;
+				localDiags.push({
+					file: filePath,
+					rule: ruleId,
+					severity,
+					message: d.message,
+					...loc
+				});
+			}
+		};
+		const handlers = rule.create(context);
+		walkAST(parsed.program, handlers);
+		out.push(...localDiags);
+	}
+	return out;
+}
+async function lintFiles(filePaths, config, readTextFile) {
+	return (await Promise.all(filePaths.map(async (p) => {
+		return lintFile(p, await readTextFile(p), config);
+	}))).flat();
+}
+//#endregion
+export { lintFiles as n, lintFile as t };
+
+//# sourceMappingURL=engine-DJFFKwTZ.mjs.map

package/dist/engine-DJFFKwTZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-DJFFKwTZ.mjs","names":[],"sources":["../src/engine.ts"],"sourcesContent":["import { parseSync } from \"oxc-parser\";\nimport { ALL_RULES } from \"./rules/registry.ts\";\n\nexport type Severity = \"off\" | \"warn\" | \"error\";\n\nexport interface Diagnostic {\n  file: string;\n  rule: string;\n  severity: Exclude<Severity, \"off\">;\n  message: string;\n  line: number;\n  column: number;\n  endLine?: number;\n  endColumn?: number;\n}\n\nexport interface RuleConfig {\n  severity: Severity;\n  options?: unknown;\n}\n\nexport interface EngineConfig {\n  rules: Record<string, RuleConfig>;\n  cwd: string;\n  typeAware: boolean;\n}\n\nconst TYPE_AWARE_RULES = new Set([\"hook-o-gnese/custom-hook-depth\"]);\n\nfunction ruleNamespace(id: string): string {\n  return id.replace(/^hook-o-gnese\\//, \"\");\n}\n\nfunction buildLineOffsets(source: string): number[] {\n  const offsets = [0];\n  for (let i = 0; i < source.length; i++) {\n    if (source.charCodeAt(i) === 10) offsets.push(i + 1);\n  }\n  return offsets;\n}\n\nfunction offsetToLineCol(\n  offset: number,\n  lineOffsets: number[],\n): { line: number; column: number } {\n  let lo = 0;\n  let hi = lineOffsets.length - 1;\n  while (lo < hi) {\n    const mid = (lo + hi + 1) >>> 1;\n    if (lineOffsets[mid] <= offset) lo = mid;\n    else hi = mid - 1;\n  }\n  return { line: lo + 1, column: offset - lineOffsets[lo] + 1 };\n}\n\nfunction getLoc(\n  node: any,\n  lineOffsets: number[],\n): { line: number; column: number; endLine?: number; endColumn?: number } {\n  const startOffset = typeof node?.start === \"number\" ? node.start : undefined;\n  const endOffset = typeof node?.end === \"number\" ? node.end : undefined;\n  if (startOffset === undefined) {\n    return { line: 1, column: 1 };\n  }\n  const start = offsetToLineCol(startOffset, lineOffsets);\n  const end = endOffset !== undefined\n    ? offsetToLineCol(endOffset, lineOffsets)\n    : undefined;\n  return {\n    line: start.line,\n    column: start.column,\n    endLine: end?.line,\n    endColumn: end?.column,\n  };\n}\n\nfunction walkAST(node: any, handlers: Record<string, any>) {\n  if (!node || typeof node !== \"object\") return;\n  const enter = handlers[node.type];\n  if (enter) enter(node);\n  for (const key in node) {\n    const v = node[key];\n    if (Array.isArray(v)) {\n      for (const c of v) walkAST(c, handlers);\n    } else if (v && typeof v === \"object\") {\n      walkAST(v, handlers);\n    }\n  }\n  const exit = handlers[`${node.type}:exit`];\n  if (exit) exit(node);\n}\n\nexport async function lintFile(\n  filePath: string,\n  source: string,\n  config: EngineConfig,\n): Promise<Diagnostic[]> {\n  const lang = filePath.endsWith(\".tsx\")\n    ? \"tsx\"\n    : filePath.endsWith(\".ts\")\n    ? \"ts\"\n    : filePath.endsWith(\".jsx\")\n    ? \"jsx\"\n    : \"js\";\n\n  const parsed = parseSync(filePath, source, {\n    lang,\n    sourceType: \"module\",\n  });\n\n  const lineOffsets = buildLineOffsets(source);\n\n  if (parsed.errors?.length) {\n    return parsed.errors.map((e: any) => {\n      const offset = typeof e.labels?.[0]?.start === \"number\"\n        ? e.labels[0].start\n        : undefined;\n      const loc = offset !== undefined\n        ? offsetToLineCol(offset, lineOffsets)\n        : { line: 1, column: 1 };\n      return {\n        file: filePath,\n        rule: \"parse-error\",\n        severity: \"error\" as const,\n        message: e.message ?? \"parse error\",\n        line: loc.line,\n        column: loc.column,\n      };\n    });\n  }\n\n  // Bail early on non-React files\n  const imports = parsed.module?.staticImports ?? [];\n  const hasReact = imports.some((i: any) =>\n    (i.moduleRequest?.value ?? i.source?.value) === \"react\"\n  );\n  if (!hasReact) return [];\n\n  const out: Diagnostic[] = [];\n\n  for (const [ruleId, ruleCfg] of Object.entries(config.rules)) {\n    if (ruleCfg.severity === \"off\") continue;\n    if (!config.typeAware && TYPE_AWARE_RULES.has(ruleId)) continue;\n\n    const rule = (ALL_RULES as any)[ruleNamespace(ruleId)];\n    if (!rule) continue;\n\n    const localDiags: Diagnostic[] = [];\n    const context = {\n      options: ruleCfg.options ? [ruleCfg.options] : [],\n      filename: filePath,\n      cwd: config.cwd,\n      report(d: { message: string; node: any; severity?: \"warn\" | \"error\" }) {\n        const loc = getLoc(d.node, lineOffsets);\n        const cfgSev = ruleCfg.severity as \"warn\" | \"error\";\n        // Rule-emitted severity only escalates (warn → error); never downgrades.\n        const severity = d.severity === \"error\" ? \"error\" : cfgSev;\n        localDiags.push({\n          file: filePath,\n          rule: ruleId,\n          severity,\n          message: d.message,\n          ...loc,\n        });\n      },\n    };\n\n    const handlers = rule.create(context);\n    walkAST(parsed.program, handlers);\n    out.push(...localDiags);\n  }\n\n  return out;\n}\n\nexport type ReadTextFile = (path: string) => Promise<string>;\n\nexport async function lintFiles(\n  filePaths: string[],\n  config: EngineConfig,\n  readTextFile: ReadTextFile,\n): Promise<Diagnostic[]> {\n  const results = await Promise.all(\n    filePaths.map(async (p) => {\n      const src = await readTextFile(p);\n      return lintFile(p, src, config);\n    }),\n  );\n  return results.flat();\n}\n"],"mappings":"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"}

package/dist/engine.d.mts

@@ -0,0 +1,27 @@
+//#region src/engine.d.ts
+type Severity = "off" | "warn" | "error";
+interface Diagnostic {
+  file: string;
+  rule: string;
+  severity: Exclude<Severity, "off">;
+  message: string;
+  line: number;
+  column: number;
+  endLine?: number;
+  endColumn?: number;
+}
+interface RuleConfig {
+  severity: Severity;
+  options?: unknown;
+}
+interface EngineConfig {
+  rules: Record<string, RuleConfig>;
+  cwd: string;
+  typeAware: boolean;
+}
+declare function lintFile(filePath: string, source: string, config: EngineConfig): Promise<Diagnostic[]>;
+type ReadTextFile = (path: string) => Promise<string>;
+declare function lintFiles(filePaths: string[], config: EngineConfig, readTextFile: ReadTextFile): Promise<Diagnostic[]>;
+//#endregion
+export { Diagnostic, EngineConfig, ReadTextFile, RuleConfig, Severity, lintFile, lintFiles };
+//# sourceMappingURL=engine.d.mts.map

package/dist/engine.mjs

@@ -0,0 +1,2 @@
+import { n as lintFiles, t as lintFile } from "./engine-DJFFKwTZ.mjs";
+export { lintFile, lintFiles };