@elnop/agent-hook 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# @elnop/agent-hook
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A Claude Code `PostToolUse` hook. After each `Edit` or `Write` by the agent:
+
+- an edited `.ts` or `.tsx` file goes through `oxlint --type-aware`, run from the folder of the nearest `oxlint.config.ts` or `.oxlintrc.json`, so a monorepo with a config per workspace works as is
+- a created file, or an edited Markdown file, runs `alint check` if the project has an `.alint.yml`
+- a created file inside one of the `--tree` folders runs `check-tree` on that folder (default: `src`)
+
+If one of them fails, the hook prints their output and exits with code 2: Claude Code sends it back to the agent, which fixes the problem before going on. The tools are run with `npx --no-install`, so they must be dependencies of the project.
+
+```sh
+npm install --save-dev @elnop/agent-hook
+```
+
+`.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [{ "type": "command", "command": "npx --no-install elnop-agent-hook --tree src", "timeout": 60 }]
+      }
+    ]
+  }
+}
+```
+
+Pass `--tree` once per source folder (`--tree web/src --tree server/src`). The project root is `$CLAUDE_PROJECT_DIR`, or `--root`.
+
+Without touching `.claude/settings.json`, the `elnop-checks` plugin from this repository runs the same hook in any project that has the package installed. See the [repository README](../../../README.md#claude-code-plugin).

package/dist/AgentHookTypes.d.ts

@@ -0,0 +1,10 @@
+export type HookCheck = {
+    label: string;
+    command: string;
+    args: string[];
+    cwd: string;
+};
+export type HookEdit = {
+    file: string;
+    created: boolean;
+};

package/dist/AgentHookTypes.js

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

package/dist/agentHook.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/agentHook.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { hookChecks } from './hookChecks.js';
+import { readHookEdit } from './readHookEdit.js';
+const { values } = parseArgs({ options: { tree: { type: 'string', multiple: true, default: ['src'] }, root: { type: 'string' } } });
+const root = resolve(values.root ?? process.env['CLAUDE_PROJECT_DIR'] ?? process.cwd());
+const edit = readHookEdit(JSON.parse(readFileSync(0, 'utf8')));
+const problems = [];
+const file = edit.file === '' ? '' : resolve(root, edit.file);
+for (const check of hookChecks(root, { ...edit, file }, values.tree)) {
+    const result = spawnSync('npx', ['--no-install', check.command, ...check.args], { cwd: check.cwd, encoding: 'utf8' });
+    if (result.status !== 0)
+        problems.push(`${check.label}:\n${result.stdout}${result.stderr}`);
+}
+if (problems.length > 0) {
+    process.stderr.write(`${problems.join('\n')}\nFix them before going on.\n`);
+    process.exitCode = 2;
+}

package/dist/hookChecks.d.ts

@@ -0,0 +1,2 @@
+import type { HookCheck, HookEdit } from './AgentHookTypes.ts';
+export declare function hookChecks(root: string, { file, created }: HookEdit, trees: string[]): HookCheck[];

package/dist/hookChecks.js

@@ -0,0 +1,35 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+const OXLINT_CONFIGS = ['oxlint.config.ts', '.oxlintrc.json'];
+function inside(root, path) {
+    const fromRoot = relative(root, path);
+    return !fromRoot.startsWith('..') && !fromRoot.split('/').includes('node_modules');
+}
+function oxlintFolder(root, file) {
+    for (let folder = dirname(file); inside(root, folder); folder = dirname(folder)) {
+        if (OXLINT_CONFIGS.some((config) => existsSync(join(folder, config))))
+            return folder;
+        if (folder === root)
+            break;
+    }
+    return root;
+}
+export function hookChecks(root, { file, created }, trees) {
+    if (file === '' || !inside(root, file))
+        return [];
+    const fromRoot = relative(root, file);
+    const checks = [];
+    if (/\.tsx?$/u.test(file)) {
+        const cwd = oxlintFolder(root, file);
+        checks.push({ label: `oxlint found problems in ${fromRoot}`, command: 'oxlint', args: ['--type-aware', relative(cwd, file)], cwd });
+    }
+    if ((created || file.endsWith('.md')) && existsSync(join(root, '.alint.yml'))) {
+        checks.push({ label: 'alint found problems in the repository layout or the docs', command: 'alint', args: ['check'], cwd: root });
+    }
+    if (created) {
+        for (const tree of trees.filter((folder) => fromRoot.startsWith(`${folder}/`))) {
+            checks.push({ label: `check-tree found problems in ${tree}`, command: 'check-tree', args: [tree], cwd: root });
+        }
+    }
+    return checks;
+}

package/dist/readHookEdit.d.ts

@@ -0,0 +1,2 @@
+import type { HookEdit } from './AgentHookTypes.ts';
+export declare function readHookEdit(input: unknown): HookEdit;

package/dist/readHookEdit.js

@@ -0,0 +1,7 @@
+function field(value, key) {
+    return typeof value === 'object' && value !== null ? Reflect.get(value, key) : undefined;
+}
+export function readHookEdit(input) {
+    const filePath = field(field(input, 'tool_input'), 'file_path');
+    return { file: typeof filePath === 'string' ? filePath : '', created: field(input, 'tool_name') === 'Write' };
+}

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@elnop/agent-hook",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Claude Code PostToolUse hook: lints each file the agent edits with oxlint, runs alint and check-tree when a file is created, and sends the errors back to the agent.",
+  "keywords": [
+    "claude-code",
+    "hook",
+    "oxlint",
+    "alint",
+    "agent"
+  ],
+  "homepage": "https://github.com/Elnop/elnop-tooling/tree/main/packages/tools/agent-hook#readme",
+  "bugs": "https://github.com/Elnop/elnop-tooling/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Elnop/elnop-tooling.git",
+    "directory": "packages/tools/agent-hook"
+  },
+  "license": "MIT",
+  "author": "elnop",
+  "type": "module",
+  "files": [
+    "dist",
+    "!dist/tsconfig.tsbuildinfo"
+  ],
+  "bin": {
+    "elnop-agent-hook": "./dist/agentHook.js"
+  },
+  "scripts": {
+    "test": "node --test '**/*.test.ts'"
+  }
+}