KeiSeiKit-1.0/hooks/tomd-preread.sh
Parfii-bot d155afc554 fix(audit-m): tomd cache path-salt; bridges respects rollback; rollback rm-rf guard; placeholder URLs; research skill role-tag note; stack frontend-gap doc
- M1 (RULE 0.4): replace fabricated URLs 'https://example.invalid/PROJECT-D'
  and 'https://…/PROJECT-D' with plain text ('user's personal CLI predecessor').
- M2: tomd-preread cache key = basename + mtime + 8-char shasum of full path,
  so two files with the same basename+mtime at different paths no longer
  collide. Portable shasum shim; falls back to 'nohash' if shasum absent.
- M3: install.sh --with-bridges gated on ROLLED_BACK=0 so bridges are NOT
  emitted into $PWD after an ERR-trap rollback.
- M4: rollback() guards rm -rf "$orig" behind an existence check.
- M5: skills/research/SKILL.md front-matter note — role tags like
  'web-researcher' / 'meta-critic' are ad-hoc prompt labels for the generic
  kei-researcher subagent, NOT separate manifests. Prevents fruitless
  grep in _manifests/.
- M6: README adds a 'Frontend-stack coverage gap' callout listing the
  planned-but-not-shipped frameworks (React-Vite, Vue-Nuxt, SvelteKit,
  Astro, Angular, plain-web).
- M7: no-hand-edit-agents.sh documents at case block that the GENERATED
  marker is the SOLE source of truth — legacy unmarked .md files pass
  silently by design; re-run the assembler to adopt them.
2026-04-21 20:09:24 +08:00

55 lines
1.9 KiB
Bash
Executable file

#!/bin/sh
# PreToolUse(Read) — auto-convert non-native formats to markdown and redirect
# Claude to read the converted file instead of the opaque binary.
#
# Exit 0 = allow (passthrough). Exit 2 = block with stderr message (Claude
# reads the stderr text and switches to the converted path).
#
# Stdin: JSON with tool_input.file_path.
# Silent fall-through if jq is absent; otherwise `set -eu` would abort and
# Claude Code would refuse Read system-wide.
command -v jq >/dev/null 2>&1 || exit 0
set -eu
TOMD="$HOME/.claude/agents/_primitives/tomd.sh"
CACHE_DIR="${KEISEI_TOMD_CACHE:-/tmp/keisei-tomd-cache}"
FILE=$(jq -r '.tool_input.file_path // empty')
[ -n "$FILE" ] || exit 0
[ -f "$FILE" ] || exit 0
# Extension whitelist — only these formats trigger conversion.
EXT=$(printf '%s' "${FILE##*.}" | tr '[:upper:]' '[:lower:]')
case "$EXT" in
docx|doc|xlsx|pptx|csv) ;;
*) exit 0 ;;
esac
# tomd primitive must be installed; if absent, don't block the Read.
[ -x "$TOMD" ] || exit 0
mkdir -p "$CACHE_DIR"
# Cache key: basename + mtime + short path-hash. Path-hash disambiguates
# two files with the same basename+mtime at different paths (otherwise they
# would collide and Claude would silently read the wrong conversion).
# Portable stat for macOS + Linux; portable shasum shim.
BASENAME=$(basename "$FILE")
MTIME=$(stat -f %m "$FILE" 2>/dev/null || stat -c %Y "$FILE" 2>/dev/null || echo 0)
PATH_HASH=$(printf '%s' "$FILE" | shasum 2>/dev/null | cut -c1-8)
[ -n "$PATH_HASH" ] || PATH_HASH="nohash"
MD_FILE="$CACHE_DIR/${BASENAME%.*}-${MTIME}-${PATH_HASH}.md"
if [ ! -s "$MD_FILE" ]; then
"$TOMD" "$FILE" > "$MD_FILE" 2>/dev/null || true
fi
if [ -s "$MD_FILE" ]; then
echo "[tomd-preread] Auto-converted to markdown: $MD_FILE. Use Read on $MD_FILE instead of $FILE." >&2
exit 2
fi
# Conversion failed or produced empty output — degrade gracefully.
exit 0