KeiSeiKit-1.0/hooks/numeric-claims-guard.sh
KeiSei84 742822a499 feat: opt-in hook packs + stack profiles + public-prep repoint (#44)
Mirror of keigit main — Phase 2 (abae256c) + public-prep repoint (518d95df).

Phase 2: safety on by default, discipline packs opt-in; stack profiles
(minimal/web/ml/systems/mobile) pull packs + agent sets; SSoT in
_primitives/hook-packs.toml; filter+prune via lib-hooks.sh; re-runnable
via `kei configure`; 8 hooks gated via _lib/gate.sh.

Public-prep: .gitmodules + README clone + plugin homepage + web-install.sh
repointed to github.com/KeiSeiLab. ADR in DECISIONS.md 2026-05-25.
2026-05-26 13:26:09 +07:00

77 lines
3 KiB
Bash

#!/usr/bin/env bash
# Runtime gate (hooks-control skill / KEI_DISABLED_HOOKS / KEI_HOOK_PROFILE).
_KEI_LIB="$(dirname "$0")/_lib/gate.sh"; if [ -r "$_KEI_LIB" ]; then . "$_KEI_LIB"; kei_hook_gate "numeric-claims-guard" || exit 0; fi
# RULE 0.18 — Numeric claim enforcement — block Edit/Write of numeric claims
# without evidence marker. Bypass: RULE_017_BYPASS=1 prefix (kept for compat).
#
# Reads tool-call JSON on stdin (Claude Code hook protocol).
set -euo pipefail
# Bypass check
if [[ "${RULE_017_BYPASS:-0}" = "1" ]]; then
exit 0
fi
# Read the tool input from stdin
INPUT="$(cat)"
# Extract the new content (Edit: new_string, Write: content)
NEW_CONTENT="$(printf '%s' "$INPUT" | jq -r '.tool_input.new_string // .tool_input.content // empty' 2>/dev/null)"
if [[ -z "$NEW_CONTENT" ]]; then
exit 0
fi
# Patterns that indicate a numeric claim
# - "~N min/hour/day/week"
# - "N MB/GB/LOC/tests/crates/atomars"
# - "~$N", "$N/mo", "$N.NN", "$NN" (money needs decimal / unit / tilde / 2+ digits
# so shell positionals $1..$9 are NOT flagged)
# - "Nm Ns", "займёт N", "should take N"
NUMERIC_PATTERN='(~\s*[0-9]+(\.[0-9]+)?\s*(min|minute|hour|hr|day|week|month|sec|second|MB|GB|KB|LOC|line|test|crate|atomar|%|µs|ms|ns|TPS|req/s)|[0-9]+m\s*[0-9]+s|\$[0-9]+\.[0-9]+|\$[0-9]+/(mo|hr|day|run)|\$[0-9]{2,}|~\s*\$[0-9]+|should take|will take|takes about|займёт|за ~|estimated at|ETA[: ]|approximately\s+[0-9])'
# Markers that satisfy the rule
EVIDENCE_PATTERN='\[(REAL|FROM-JOURNAL|ESTIMATE-HTC)[: ]'
# Check if numeric pattern present
if ! echo "$NEW_CONTENT" | grep -iqE "$NUMERIC_PATTERN"; then
exit 0
fi
# Numeric pattern present — check for evidence marker
if echo "$NEW_CONTENT" | grep -qE "$EVIDENCE_PATTERN"; then
exit 0
fi
# Violation
MATCHED="$(echo "$NEW_CONTENT" | grep -iEo "$NUMERIC_PATTERN" | head -3 | tr '\n' '; ')"
cat >&2 <<EOF
════════════════════════════════════════════════════════════════
RULE 0.18 — Numeric claim without evidence marker.
════════════════════════════════════════════════════════════════
Found in Edit/Write content:
$MATCHED
Required: append ONE of these markers in the same paragraph:
[REAL: <file:line | commit | timestamp>]
[FROM-JOURNAL: ~/.claude/memory/time-metrics/<file>.jsonl#<id>]
[ESTIMATE-HTC: <one-sentence reason this can't be measured yet>]
Or write the actual measurement to a JSONL journal first:
echo '{"kind":"task","name":"...","duration_s":...}' \\
>> ~/.claude/memory/time-metrics/tasks.jsonl
Then cite that line.
Bypass (visible, per-call):
RULE_017_BYPASS=1 <command>
See: ~/.claude/rules/numeric-claims-evidence.md
════════════════════════════════════════════════════════════════
EOF
exit 2