@devrik-tools/claude-gates 0.4.0 → 0.7.0

package/registry.json

@@ -293,6 +293,27 @@
             }
           ]
         },
+        {
+          "id": "brief-approved",
+          "configKey": "requireApprovedBriefBeforeImplementing",
+          "default": true,
+          "event": "PreToolUse",
+          "tools": ["delegation"],
+          "description": "Denies implementing a cited feature whose brief has no recorded user approval (status: approved + approval_quote frontmatter).",
+          "script": "gates/brief-approved/index.mjs",
+          "params": [
+            {
+              "name": "catalogLocations",
+              "type": "string[]",
+              "description": "Paths searched for the feature catalog."
+            },
+            {
+              "name": "exemptSubagents",
+              "type": "string[]",
+              "description": "Subagent types exempt from the approval requirement."
+            }
+          ]
+        },
         {
           "id": "implementation-pipeline",
           "configKey": "requireImplementationPipeline",
@@ -563,6 +584,115 @@
               "description": "Milliseconds allowed for the lint run before it counts as a failure."
             }
           ]
+        },
+        {
+          "id": "staged-lint",
+          "configKey": "blockCommitWithStagedLintErrors",
+          "default": false,
+          "event": "PreToolUse",
+          "tools": ["shell"],
+          "description": "Denies a git commit when the STAGED files fail lint — lints only what you staged, not the whole repo, so your change can't add new lint debt while pre-existing debt in untouched files never blocks you. Autodetects eslint; escape hatch [skip-lint].",
+          "script": "gates/staged-lint/index.mjs",
+          "params": [
+            {
+              "name": "lintCommand",
+              "type": "string",
+              "description": "Command to run; staged paths are appended. Default: autodetect npx eslint when an eslint config exists."
+            },
+            {
+              "name": "lintExtensions",
+              "type": "string[]",
+              "description": "Staged file extensions that get linted. Replaces the built-in list."
+            },
+            {
+              "name": "lintTimeoutMs",
+              "type": "number",
+              "description": "Milliseconds allowed for the lint run before it counts as a failure."
+            },
+            {
+              "name": "escapeHatch",
+              "type": "string",
+              "description": "Substring in the commit command that skips the check once. Default [skip-lint]."
+            }
+          ]
+        },
+        {
+          "id": "atomic-commit",
+          "configKey": "blockNonAtomicCommits",
+          "default": false,
+          "event": "PreToolUse",
+          "tools": ["shell"],
+          "description": "Denies a git commit that is not atomic: one mixing more than N distinct natures of change (code/tests/deps/config...) or staging more reviewable files than a commit should carry. Docs/assets/generated files are not counted. Escape hatch [wip] for one deliberately broad commit.",
+          "script": "gates/atomic-commit/index.mjs",
+          "params": [
+            {
+              "name": "maxFiles",
+              "type": "number",
+              "description": "Max counted (reviewable) files in one commit. Default 12."
+            },
+            {
+              "name": "maxNatures",
+              "type": "number",
+              "description": "Max distinct counted natures of change in one commit. Default 2."
+            },
+            {
+              "name": "escapeHatch",
+              "type": "string",
+              "description": "Substring in the commit command that allows one deliberately broad commit. Default [wip]."
+            },
+            {
+              "name": "natures",
+              "type": "string[]",
+              "description": "Classification table ({name, source, counts}) mapping a path to a nature. Replaces the built-in list."
+            }
+          ]
+        },
+        {
+          "id": "no-coauthor",
+          "configKey": "blockCoauthorTrailers",
+          "default": true,
+          "event": "PreToolUse",
+          "tools": ["shell", "delegation"],
+          "description": "Denies a git commit whose message carries an AI/agent attribution trailer (Co-Authored-By, Generated with, session trailer). Escape hatch marker allows one legitimate co-author.",
+          "script": "gates/no-coauthor/index.mjs",
+          "params": [
+            {
+              "name": "attributionPatterns",
+              "type": "string[]",
+              "description": "Regex sources of attribution trailers/phrases to deny. Replaces the built-in list."
+            },
+            {
+              "name": "escapeHatch",
+              "type": "string",
+              "description": "Substring in the command that allows one commit to keep a co-author. Default [allow-coauthor]."
+            }
+          ]
+        },
+        {
+          "id": "no-lint-suppression",
+          "configKey": "blockLintSuppression",
+          "default": true,
+          "event": "PreToolUse",
+          "tools": ["write"],
+          "description": "Denies a write that silences the linter/type-checker (inline disable directive, or a config rule set off) instead of fixing the code. Escape hatch marker on the same line allows a documented false positive.",
+          "script": "gates/no-lint-suppression/index.mjs",
+          "params": [
+            {
+              "name": "suppressionPatterns",
+              "type": "string[]",
+              "description": "Regex sources marking an inline suppression directive. Replaces the built-in list."
+            },
+            {
+              "name": "watchedConfigFiles",
+              "type": "string[]",
+              "description": "Config file basenames whose edits are scanned for rule-weakening. Replaces the built-in list."
+            },
+            {
+              "name": "escapeHatch",
+              "type": "string",
+              "description": "Substring on the same line as a suppression that allows it (a documented false positive). Default lint-ok:."
+            }
+          ]
         }
       ]
     },
@@ -577,13 +707,28 @@
           "default": false,
           "event": "PreToolUse",
           "tools": ["write", "delegation"],
-          "description": "Consults the project tool map; blocks building a tool absent from it without an audit.",
+          "description": "Before building a tool/helper (by folder, name pattern, or extension), requires evidence the wheel was checked: an audit phrase, the tool's name already in the map (structural match), or a matching installed dependency. Covers helpers beyond scripts/hooks/tools/gates and Spanish build-intent.",
           "script": "gates/reuse-before-build/index.mjs",
           "params": [
             {
               "name": "toolMapFile",
               "type": "string",
               "description": "Path to the per-project tool map (default .ai/tool-map.json)."
+            },
+            {
+              "name": "toolFolders",
+              "type": "string[]",
+              "description": "Folder names marking a file as a tool/helper. Replaces the built-in list (scripts, hooks, tools, gates, lib, utils, helpers, composables, components, services...)."
+            },
+            {
+              "name": "toolNamePatterns",
+              "type": "string[]",
+              "description": "Regex sources; a new file whose basename matches any is treated as a helper regardless of folder (useX, XHelper, XUtil, XService...)."
+            },
+            {
+              "name": "toolExtensions",
+              "type": "string[]",
+              "description": "File extensions considered code that can reinvent a wheel."
             }
           ]
         },
@@ -698,6 +843,52 @@
           "tools": [],
           "description": "Warns when a registered hook is missing or a script is orphaned.",
           "script": "wiring-check.mjs"
+        },
+        {
+          "id": "capability-map",
+          "configKey": "injectCapabilityMap",
+          "default": true,
+          "event": "UserPromptSubmit",
+          "tools": [],
+          "description": "Injects the current catalog of the project's AI capabilities (skills, agents/subagents, commands) as compact context on every message, grouped by kind, read fresh from disk. Also persists it to .ai/capability-map.json like the tool map. Autosynced: it lists the directories, never a hardcoded copy. Never blocks.",
+          "script": "gates/capability-map/index.mjs",
+          "params": [
+            {
+              "name": "kinds",
+              "type": "string[]",
+              "description": "Which capability kinds to include: skills, agents, commands. Drop one to stop scanning it."
+            },
+            {
+              "name": "maxClauseChars",
+              "type": "number",
+              "description": "Hard cap on each entry's one-line blurb length. Default 90."
+            },
+            {
+              "name": "extraSkillsDirs",
+              "type": "string[]",
+              "description": "Extra skill roots (relative or absolute) scanned in addition to ~/.claude/skills and <project>/.claude/skills."
+            },
+            {
+              "name": "extraAgentsDirs",
+              "type": "string[]",
+              "description": "Extra agent roots scanned in addition to ~/.claude/agents and <project>/.claude/agents."
+            },
+            {
+              "name": "extraCommandsDirs",
+              "type": "string[]",
+              "description": "Extra command roots scanned in addition to ~/.claude/commands and <project>/.claude/commands."
+            },
+            {
+              "name": "persist",
+              "type": "boolean",
+              "description": "Whether to write the persisted map file. Default true."
+            },
+            {
+              "name": "mapFile",
+              "type": "string",
+              "description": "Path to the persisted capability map, relative to project root. Default .ai/capability-map.json."
+            }
+          ]
         }
       ]
     },