Template
Apply answers to questions-v1.md (Q1–Q5):
- Q4: Remove crush.json and hooks/ entirely. All enforcement is now portable
via git hooks (pre-commit/pre-push) + check-rules.sh + AGENTS.md prose.
Works under Crush, OpenWebUI, Hermes, or any agent framework.
- Q5: Remove docs/JOURNAL.md. Redmine is the system of record for work;
Discourse for docs. JOURNAL.md was a stopgap.
- Q3: Add mandatory Discourse pointer-header check to check-rules.sh. Any
non-exempt tracked .md without a Discourse URL FAILs. All projects, no
exceptions.
- Q2: Reference real CLI container invocation paths
(KNEL-AIMiddleware/{redmine,discourse}-cli/) in AGENTS.md instead of the
missing bin/ shortcuts.
- Q1: Note tea + docker login are preconfigured on TSYS workstations.
Also: make test default is now no-op pass so the template self-validates;
make validate now passes clean on the repo itself (17 PASS / 0 FAIL).
💘 Generated with Crush
Assisted-by: Crush via Crush <crush@charm.land>
45 lines
1.4 KiB
Bash
Executable File
45 lines
1.4 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# setup-hooks.sh — install this repo's git hooks.
|
|
#
|
|
# Mechanism: copy scripts/pre-commit and scripts/pre-push into .git/hooks/ and
|
|
# make them executable. This is the most portable pattern (works on any clone,
|
|
# no `git config core.hooksPath` mutation, survives config resets, idempotent).
|
|
#
|
|
# Run once after cloning: bash scripts/setup-hooks.sh
|
|
set -euo pipefail
|
|
|
|
HERE="$(cd "$(dirname "$0")" && pwd)"
|
|
# shellcheck disable=SC1091
|
|
source "$HERE/lib/common.sh"
|
|
REPO_ROOT="$(repo_root)"
|
|
cd "$REPO_ROOT"
|
|
|
|
[ -d .git ] || die "no .git directory here — run this from a git checkout"
|
|
|
|
HOOKS_DIR=".git/hooks"
|
|
HOOK_NAMES="pre-commit pre-push"
|
|
|
|
log_step "Installing git hooks"
|
|
for name in $HOOK_NAMES; do
|
|
src="scripts/$name"
|
|
dst="$HOOKS_DIR/$name"
|
|
[ -f "$src" ] || die "source hook not found: $src"
|
|
cp "$src" "$dst"
|
|
chmod +x "$dst"
|
|
log_ok "installed $dst"
|
|
done
|
|
|
|
cat <<EOF
|
|
|
|
Git hooks installed. The following now run automatically:
|
|
|
|
pre-commit fast rule audit (shellcheck, image pinning, container naming,
|
|
required files, doc freshness, Discourse pointers, WORKING.md
|
|
completion, hygiene).
|
|
Hot-path bypass for STATUS.md / WORKING.md.
|
|
pre-push full rule audit (includes make test) + clean-working-tree gate.
|
|
|
|
Bypass either with \`git commit --no-verify\` / \`git push --no-verify\`
|
|
(emergencies only).
|
|
EOF
|