@codyswann/lisa 4.8.0 → 4.8.2

package/plugins/lisa-nestjs/hooks/block-migration-edits.sh

@@ -8,23 +8,96 @@
 # break the schema/migration contract.
 # Reference: https://docs.claude.com/en/docs/claude-code/hooks
 # Exit code 2 blocks the tool call and surfaces stderr to Claude.
+#
+# WHAT A REFUSAL HOOK OWES THAT AN ON-EDIT HOOK DOES NOT. The five PostToolUse
+# scripts may bail out when they cannot run: the write has already happened and
+# a skipped lint is a missed report. This one decides whether the write happens
+# at all, so a bail-out is a PERMIT — it lets through exactly the edit it exists
+# to stop, while reporting success. Every exit below is therefore one of three
+# things and never a fourth: out of scope (nothing to judge), judged by the
+# project's declared task, or judged by the built-in. "Could not judge" refuses.
 
 JSON_INPUT=$(cat)
 
+# Project rule (host rules, .agents/rules/): never parse JSON in shell with
+# grep/sed/cut/awk — always use jq.
+#
+# FAIL CLOSED, reversed from the `exit 0` this shipped with. Without jq the
+# payload cannot be read at all, so the hook cannot tell a migration edit from
+# any other write — and it said so on stderr while permitting the edit anyway,
+# which is a guard announcing that it did not check and then waving the write
+# through. The refusal is unscoped for the same reason: with no parse there is
+# no path to scope it to.
 if ! command -v jq >/dev/null 2>&1; then
-  echo "⚠ block-migration-edits: jq not available, allowing edit" >&2
-  exit 0
+  cat >&2 <<'MSG'
+❌ Blocked: block-migration-edits cannot inspect this write.
+
+`jq` is not installed, so the tool payload cannot be parsed — this hook cannot
+tell whether the write targets a TypeORM migration. It refuses rather than
+permitting an edit it was unable to check.
+
+Install jq (`brew install jq`, `apt-get install jq`), or declare the
+`migration-provenance` gate at `pre-tool` in .lisa.config.json to have your own
+check decide instead.
+MSG
+  exit 2
 fi
 
-FILE_PATH=$(echo "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
+FILE_PATH=$(printf '%s' "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
 
 if [ -z "$FILE_PATH" ]; then
   exit 0
 fi
 
+# Scope. Outside a migration path this hook does nothing at all, so there is
+# nothing here for a declaration to take over — the same reason the sibling
+# on-edit hook filters by file type and source directory BEFORE it consults.
 case "$FILE_PATH" in
-  */migrations/*.ts|*/migrations/*.js)
-    cat >&2 <<EOF
+  */migrations/*.ts | */migrations/*.js) ;;
+  *) exit 0 ;;
+esac
+
+# Where this script lives, resolved BEFORE any `cd`. `$0` is the path the
+# harness invoked, and the façade helper ships beside it.
+LISA_HOOK_DIR="$(cd "$(dirname "$0")" 2>/dev/null && pwd)"
+
+# ---------------------------------------------------------------------------
+# Gate façade. The project's declaration decides BEFORE the built-in refuses.
+# Full contract, and why an undeclared project sees no change at all, in
+# lisa-edit-gate.sh beside this file.
+#
+# THE WORKING DIRECTORY IS PART OF THE WIRING HERE, which is why this hook was
+# left out of the change that wired the five on-edit ones. Those hooks already
+# `cd "$CLAUDE_PROJECT_DIR"` to run a tool against the tree; this one acts on
+# the payload and never establishes a directory at all. The helper resolves
+# .lisa.config.json and the gate registry RELATIVE to the current directory, so
+# without the `cd` it would read whatever directory the harness happened to
+# launch in and report "nothing declared" for a project that had declared.
+#
+# The `cd` is safe for the built-in below because the built-in reads only the
+# path out of the payload — nothing it does depends on the working directory.
+# That is what keeps an undeclared project on exactly the command, and exactly
+# the exit status, it had before.
+#
+# ONE PROPERTY, so there is no all-or-nothing question here: this hook proves
+# `migration-provenance` and nothing else.
+# ---------------------------------------------------------------------------
+if [ -n "${CLAUDE_PROJECT_DIR:-}" ] &&
+  [ -f "$LISA_HOOK_DIR/lisa-edit-gate.sh" ] &&
+  cd "$CLAUDE_PROJECT_DIR" 2>/dev/null; then
+  # shellcheck source=/dev/null
+  . "$LISA_HOOK_DIR/lisa-edit-gate.sh"
+  if LISA_GATE_COMMANDS="$(lisa_edit_gate_tasks pre-tool migration-provenance)"; then
+    # The declared task's own exit status decides the write: non-zero refuses,
+    # exactly as the built-in's outright refusal does. A project that declares
+    # this gate is saying its own check knows which migrations came from the
+    # model, which is the judgement the built-in makes by refusing them all.
+    lisa_edit_gate_run "$FILE_PATH" "$LISA_GATE_COMMANDS"
+    exit $?
+  fi
+fi
+
+cat >&2 <<EOF
 ❌ Blocked: Direct edits to TypeORM migration files are not allowed.
 
 File: $FILE_PATH
@@ -53,8 +126,4 @@ If you believe this edit is an out-of-band migration:
 Do NOT silently hand-write a migration. See the nestjs-rules skill
 for the full rationale.
 EOF
-    exit 2
-    ;;
-esac
-
-exit 0
+exit 2

package/plugins/lisa-nestjs-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs-copilot/hooks/block-migration-edits.sh

@@ -8,23 +8,96 @@
 # break the schema/migration contract.
 # Reference: https://docs.claude.com/en/docs/claude-code/hooks
 # Exit code 2 blocks the tool call and surfaces stderr to Claude.
+#
+# WHAT A REFUSAL HOOK OWES THAT AN ON-EDIT HOOK DOES NOT. The five PostToolUse
+# scripts may bail out when they cannot run: the write has already happened and
+# a skipped lint is a missed report. This one decides whether the write happens
+# at all, so a bail-out is a PERMIT — it lets through exactly the edit it exists
+# to stop, while reporting success. Every exit below is therefore one of three
+# things and never a fourth: out of scope (nothing to judge), judged by the
+# project's declared task, or judged by the built-in. "Could not judge" refuses.
 
 JSON_INPUT=$(cat)
 
+# Project rule (host rules, .agents/rules/): never parse JSON in shell with
+# grep/sed/cut/awk — always use jq.
+#
+# FAIL CLOSED, reversed from the `exit 0` this shipped with. Without jq the
+# payload cannot be read at all, so the hook cannot tell a migration edit from
+# any other write — and it said so on stderr while permitting the edit anyway,
+# which is a guard announcing that it did not check and then waving the write
+# through. The refusal is unscoped for the same reason: with no parse there is
+# no path to scope it to.
 if ! command -v jq >/dev/null 2>&1; then
-  echo "⚠ block-migration-edits: jq not available, allowing edit" >&2
-  exit 0
+  cat >&2 <<'MSG'
+❌ Blocked: block-migration-edits cannot inspect this write.
+
+`jq` is not installed, so the tool payload cannot be parsed — this hook cannot
+tell whether the write targets a TypeORM migration. It refuses rather than
+permitting an edit it was unable to check.
+
+Install jq (`brew install jq`, `apt-get install jq`), or declare the
+`migration-provenance` gate at `pre-tool` in .lisa.config.json to have your own
+check decide instead.
+MSG
+  exit 2
 fi
 
-FILE_PATH=$(echo "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
+FILE_PATH=$(printf '%s' "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
 
 if [ -z "$FILE_PATH" ]; then
   exit 0
 fi
 
+# Scope. Outside a migration path this hook does nothing at all, so there is
+# nothing here for a declaration to take over — the same reason the sibling
+# on-edit hook filters by file type and source directory BEFORE it consults.
 case "$FILE_PATH" in
-  */migrations/*.ts|*/migrations/*.js)
-    cat >&2 <<EOF
+  */migrations/*.ts | */migrations/*.js) ;;
+  *) exit 0 ;;
+esac
+
+# Where this script lives, resolved BEFORE any `cd`. `$0` is the path the
+# harness invoked, and the façade helper ships beside it.
+LISA_HOOK_DIR="$(cd "$(dirname "$0")" 2>/dev/null && pwd)"
+
+# ---------------------------------------------------------------------------
+# Gate façade. The project's declaration decides BEFORE the built-in refuses.
+# Full contract, and why an undeclared project sees no change at all, in
+# lisa-edit-gate.sh beside this file.
+#
+# THE WORKING DIRECTORY IS PART OF THE WIRING HERE, which is why this hook was
+# left out of the change that wired the five on-edit ones. Those hooks already
+# `cd "$CLAUDE_PROJECT_DIR"` to run a tool against the tree; this one acts on
+# the payload and never establishes a directory at all. The helper resolves
+# .lisa.config.json and the gate registry RELATIVE to the current directory, so
+# without the `cd` it would read whatever directory the harness happened to
+# launch in and report "nothing declared" for a project that had declared.
+#
+# The `cd` is safe for the built-in below because the built-in reads only the
+# path out of the payload — nothing it does depends on the working directory.
+# That is what keeps an undeclared project on exactly the command, and exactly
+# the exit status, it had before.
+#
+# ONE PROPERTY, so there is no all-or-nothing question here: this hook proves
+# `migration-provenance` and nothing else.
+# ---------------------------------------------------------------------------
+if [ -n "${CLAUDE_PROJECT_DIR:-}" ] &&
+  [ -f "$LISA_HOOK_DIR/lisa-edit-gate.sh" ] &&
+  cd "$CLAUDE_PROJECT_DIR" 2>/dev/null; then
+  # shellcheck source=/dev/null
+  . "$LISA_HOOK_DIR/lisa-edit-gate.sh"
+  if LISA_GATE_COMMANDS="$(lisa_edit_gate_tasks pre-tool migration-provenance)"; then
+    # The declared task's own exit status decides the write: non-zero refuses,
+    # exactly as the built-in's outright refusal does. A project that declares
+    # this gate is saying its own check knows which migrations came from the
+    # model, which is the judgement the built-in makes by refusing them all.
+    lisa_edit_gate_run "$FILE_PATH" "$LISA_GATE_COMMANDS"
+    exit $?
+  fi
+fi
+
+cat >&2 <<EOF
 ❌ Blocked: Direct edits to TypeORM migration files are not allowed.
 
 File: $FILE_PATH
@@ -53,8 +126,4 @@ If you believe this edit is an out-of-band migration:
 Do NOT silently hand-write a migration. See the nestjs-rules skill
 for the full rationale.
 EOF
-    exit 2
-    ;;
-esac
-
-exit 0
+exit 2

package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs-cursor/hooks/block-migration-edits.sh

@@ -8,23 +8,96 @@
 # break the schema/migration contract.
 # Reference: https://docs.claude.com/en/docs/claude-code/hooks
 # Exit code 2 blocks the tool call and surfaces stderr to Claude.
+#
+# WHAT A REFUSAL HOOK OWES THAT AN ON-EDIT HOOK DOES NOT. The five PostToolUse
+# scripts may bail out when they cannot run: the write has already happened and
+# a skipped lint is a missed report. This one decides whether the write happens
+# at all, so a bail-out is a PERMIT — it lets through exactly the edit it exists
+# to stop, while reporting success. Every exit below is therefore one of three
+# things and never a fourth: out of scope (nothing to judge), judged by the
+# project's declared task, or judged by the built-in. "Could not judge" refuses.
 
 JSON_INPUT=$(cat)
 
+# Project rule (host rules, .agents/rules/): never parse JSON in shell with
+# grep/sed/cut/awk — always use jq.
+#
+# FAIL CLOSED, reversed from the `exit 0` this shipped with. Without jq the
+# payload cannot be read at all, so the hook cannot tell a migration edit from
+# any other write — and it said so on stderr while permitting the edit anyway,
+# which is a guard announcing that it did not check and then waving the write
+# through. The refusal is unscoped for the same reason: with no parse there is
+# no path to scope it to.
 if ! command -v jq >/dev/null 2>&1; then
-  echo "⚠ block-migration-edits: jq not available, allowing edit" >&2
-  exit 0
+  cat >&2 <<'MSG'
+❌ Blocked: block-migration-edits cannot inspect this write.
+
+`jq` is not installed, so the tool payload cannot be parsed — this hook cannot
+tell whether the write targets a TypeORM migration. It refuses rather than
+permitting an edit it was unable to check.
+
+Install jq (`brew install jq`, `apt-get install jq`), or declare the
+`migration-provenance` gate at `pre-tool` in .lisa.config.json to have your own
+check decide instead.
+MSG
+  exit 2
 fi
 
-FILE_PATH=$(echo "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
+FILE_PATH=$(printf '%s' "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
 
 if [ -z "$FILE_PATH" ]; then
   exit 0
 fi
 
+# Scope. Outside a migration path this hook does nothing at all, so there is
+# nothing here for a declaration to take over — the same reason the sibling
+# on-edit hook filters by file type and source directory BEFORE it consults.
 case "$FILE_PATH" in
-  */migrations/*.ts|*/migrations/*.js)
-    cat >&2 <<EOF
+  */migrations/*.ts | */migrations/*.js) ;;
+  *) exit 0 ;;
+esac
+
+# Where this script lives, resolved BEFORE any `cd`. `$0` is the path the
+# harness invoked, and the façade helper ships beside it.
+LISA_HOOK_DIR="$(cd "$(dirname "$0")" 2>/dev/null && pwd)"
+
+# ---------------------------------------------------------------------------
+# Gate façade. The project's declaration decides BEFORE the built-in refuses.
+# Full contract, and why an undeclared project sees no change at all, in
+# lisa-edit-gate.sh beside this file.
+#
+# THE WORKING DIRECTORY IS PART OF THE WIRING HERE, which is why this hook was
+# left out of the change that wired the five on-edit ones. Those hooks already
+# `cd "$CLAUDE_PROJECT_DIR"` to run a tool against the tree; this one acts on
+# the payload and never establishes a directory at all. The helper resolves
+# .lisa.config.json and the gate registry RELATIVE to the current directory, so
+# without the `cd` it would read whatever directory the harness happened to
+# launch in and report "nothing declared" for a project that had declared.
+#
+# The `cd` is safe for the built-in below because the built-in reads only the
+# path out of the payload — nothing it does depends on the working directory.
+# That is what keeps an undeclared project on exactly the command, and exactly
+# the exit status, it had before.
+#
+# ONE PROPERTY, so there is no all-or-nothing question here: this hook proves
+# `migration-provenance` and nothing else.
+# ---------------------------------------------------------------------------
+if [ -n "${CLAUDE_PROJECT_DIR:-}" ] &&
+  [ -f "$LISA_HOOK_DIR/lisa-edit-gate.sh" ] &&
+  cd "$CLAUDE_PROJECT_DIR" 2>/dev/null; then
+  # shellcheck source=/dev/null
+  . "$LISA_HOOK_DIR/lisa-edit-gate.sh"
+  if LISA_GATE_COMMANDS="$(lisa_edit_gate_tasks pre-tool migration-provenance)"; then
+    # The declared task's own exit status decides the write: non-zero refuses,
+    # exactly as the built-in's outright refusal does. A project that declares
+    # this gate is saying its own check knows which migrations came from the
+    # model, which is the judgement the built-in makes by refusing them all.
+    lisa_edit_gate_run "$FILE_PATH" "$LISA_GATE_COMMANDS"
+    exit $?
+  fi
+fi
+
+cat >&2 <<EOF
 ❌ Blocked: Direct edits to TypeORM migration files are not allowed.
 
 File: $FILE_PATH
@@ -53,8 +126,4 @@ If you believe this edit is an out-of-band migration:
 Do NOT silently hand-write a migration. See the nestjs-rules skill
 for the full rationale.
 EOF
-    exit 2
-    ;;
-esac
-
-exit 0
+exit 2

package/plugins/lisa-openclaw/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, across Claude and Codex.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-phaser/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-phaser/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-phaser-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Ruby on Rails-specific skills and hooks for RuboCop and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "TypeScript-specific hooks for formatting, linting, and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/hooks/block-suppress-directives.sh

@@ -13,13 +13,42 @@
 # and identifiers that merely mention these tokens are not flagged.
 # Exit code 2 blocks the tool call and surfaces stderr to Claude.
 # Reference: https://docs.claude.com/en/docs/claude-code/hooks
+#
+# WHAT A REFUSAL HOOK OWES THAT AN ON-EDIT HOOK DOES NOT. The five PostToolUse
+# scripts may bail out when they cannot run: the write has already happened and
+# a skipped lint is a missed report. This one decides whether the write happens
+# at all, so a bail-out is a PERMIT — it lets through exactly the text it exists
+# to stop, while reporting success. Every exit below is therefore one of three
+# things and never a fourth: out of scope (nothing to judge), judged by the
+# project's declared task, or judged by the built-in. "Could not judge" refuses.
 
 JSON_INPUT=$(cat)
 
 # Project rule (host rules, .agents/rules/): never parse JSON in shell with
-# grep/sed/cut/awk — always use jq. Fail open without jq so we never hard-block
-# the agent on missing tooling.
-command -v jq >/dev/null 2>&1 || exit 0
+# grep/sed/cut/awk — always use jq.
+#
+# FAIL CLOSED, reversed from the `exit 0` this shipped with. Without jq the
+# payload cannot be read at all: not the path, not the file type, not the new
+# text. Permitting there is the one branch that let a suppression through while
+# the hook reported success, and it could not even say which write it had waved
+# past. The refusal is deliberately unscoped for the same reason — with no
+# parse there is no file type to scope it to. This is the same shape the
+# sibling on-edit hook already ships for a missing `oxlint`: fail loudly rather
+# than silently skip.
+if ! command -v jq >/dev/null 2>&1; then
+  cat >&2 <<'MSG'
+❌ Blocked: block-suppress-directives cannot inspect this write.
+
+`jq` is not installed, so the tool payload cannot be parsed — this hook cannot
+tell whether the write adds an error-suppression directive. It refuses rather
+than permitting an edit it was unable to check.
+
+Install jq (`brew install jq`, `apt-get install jq`), or declare the
+`suppression-residue` gate at `pre-tool` in .lisa.config.json to have your own
+check decide instead.
+MSG
+  exit 2
+fi
 
 FILE_PATH=$(printf '%s' "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
 [ -n "$FILE_PATH" ] || exit 0
@@ -31,6 +60,45 @@ case "${FILE_PATH##*.}" in
   *) exit 0 ;;
 esac
 
+# Where this script lives, resolved BEFORE any `cd`. `$0` is the path the
+# harness invoked, and the façade helper ships beside it.
+LISA_HOOK_DIR="$(cd "$(dirname "$0")" 2>/dev/null && pwd)"
+
+# ---------------------------------------------------------------------------
+# Gate façade. The project's declaration decides BEFORE the built-in judges
+# anything. Full contract, and why an undeclared project sees no change at all,
+# in lisa-edit-gate.sh beside this file.
+#
+# THE WORKING DIRECTORY IS PART OF THE WIRING HERE, which is why this hook was
+# left out of the change that wired the five on-edit ones. Those hooks already
+# `cd "$CLAUDE_PROJECT_DIR"` to run a tool against the tree; this one acts on
+# the payload and never establishes a directory at all. The helper resolves
+# .lisa.config.json and the gate registry RELATIVE to the current directory, so
+# without the `cd` it would read whatever directory the harness happened to
+# launch in and report "nothing declared" for a project that had declared.
+#
+# The `cd` is safe for the built-in below because the built-in reads only the
+# payload and the absolute path inside it — nothing it does depends on the
+# working directory. That is what keeps an undeclared project on exactly the
+# command, and exactly the exit status, it had before.
+#
+# ONE PROPERTY, so there is no all-or-nothing question here: this hook proves
+# `suppression-residue` and nothing else.
+# ---------------------------------------------------------------------------
+if [ -n "${CLAUDE_PROJECT_DIR:-}" ] &&
+  [ -f "$LISA_HOOK_DIR/lisa-edit-gate.sh" ] &&
+  cd "$CLAUDE_PROJECT_DIR" 2>/dev/null; then
+  # shellcheck source=/dev/null
+  . "$LISA_HOOK_DIR/lisa-edit-gate.sh"
+  if LISA_GATE_COMMANDS="$(lisa_edit_gate_tasks pre-tool suppression-residue)"; then
+    # The declared task's own exit status decides the write: non-zero refuses,
+    # exactly as the built-in's match does. `lisa_edit_gate_run` exits 2 on the
+    # first failure, which is this surface's refusal status.
+    lisa_edit_gate_run "$FILE_PATH" "$LISA_GATE_COMMANDS"
+    exit $?
+  fi
+fi
+
 # Resolve the new text per tool shape:
 #   Write     -> tool_input.content
 #   MultiEdit -> tool_input.edits[].new_string

package/plugins/lisa-typescript-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
   "author": {
     "name": "Cody Swann"