kirukib
40771434d1
Establish the shared Admin/Mob/Ecom/B2B contract in-repo and wire Cursor rules, reminder scripts, and a soft pre-push hook so pushes keep the master (and Admin sheet pointers) current. Co-authored-by: Cursor <cursoragent@cursor.com>
127 lines
3.7 KiB
Bash
Executable File
127 lines
3.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Reminder + staleness check for docs/GISHEN-MASTER-SPEC.md
|
|
# Does NOT call LLMs. Safe to run from pre-push or manually.
|
|
set -euo pipefail
|
|
|
|
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
|
cd "$ROOT"
|
|
|
|
MASTER="docs/GISHEN-MASTER-SPEC.md"
|
|
ADMIN_SPEC="docs/admin-backend-spec.md"
|
|
|
|
RED=$'\033[1;31m'
|
|
YEL=$'\033[1;33m'
|
|
GRN=$'\033[1;32m'
|
|
BLD=$'\033[1m'
|
|
RST=$'\033[0m'
|
|
|
|
echo "${BLD}Gishen master spec reminder${RST}"
|
|
echo " Master: ${MASTER}"
|
|
echo
|
|
|
|
if [[ ! -f "$MASTER" ]]; then
|
|
echo "${RED}ERROR:${RST} Missing ${MASTER}"
|
|
echo " Create/update it before push. See docs/GISHEN-MASTER-SPEC.md Update rule."
|
|
exit 1
|
|
fi
|
|
|
|
echo "${BLD}Pre-push checklist${RST}"
|
|
echo " [ ] Changelog row if domain contract changed"
|
|
echo " [ ] Skim Mob / Ecom / B2B (and Dispatch if relevant) when folders exist"
|
|
echo " [ ] Sources stamp + Last reconciled bumped"
|
|
echo " [ ] ${ADMIN_SPEC} updated if Admin modules changed"
|
|
echo
|
|
|
|
mtime_of() {
|
|
stat -f %m "$1" 2>/dev/null || stat -c %Y "$1"
|
|
}
|
|
|
|
master_mtime=$(mtime_of "$MASTER")
|
|
stale=0
|
|
newest_src=""
|
|
newest_ts=$master_mtime
|
|
|
|
consider() {
|
|
local path="$1"
|
|
[[ -e "$path" ]] || return 0
|
|
local ts
|
|
ts=$(mtime_of "$path")
|
|
if (( ts > newest_ts )); then
|
|
newest_ts=$ts
|
|
newest_src="$path"
|
|
fi
|
|
if (( ts > master_mtime )); then
|
|
stale=1
|
|
fi
|
|
}
|
|
|
|
consider "$ADMIN_SPEC"
|
|
consider "package.json"
|
|
consider "README.md"
|
|
|
|
# Sample recent TypeScript under src (portable; avoid head -z)
|
|
if [[ -d src ]]; then
|
|
while IFS= read -r f; do
|
|
[[ -n "$f" ]] || continue
|
|
consider "$f"
|
|
done < <(find src -type f \( -name '*.ts' -o -name '*.tsx' \) 2>/dev/null | head -n 200)
|
|
fi
|
|
|
|
# Relative to upstream if available
|
|
RANGE=""
|
|
if git rev-parse --verify @{u} >/dev/null 2>&1; then
|
|
RANGE="@{u}..HEAD"
|
|
elif git rev-parse --verify origin/main >/dev/null 2>&1; then
|
|
RANGE="origin/main..HEAD"
|
|
elif git rev-parse --verify origin/master >/dev/null 2>&1; then
|
|
RANGE="origin/master..HEAD"
|
|
fi
|
|
|
|
changed_significant=0
|
|
master_in_range=0
|
|
if [[ -n "$RANGE" ]]; then
|
|
if git diff --name-only "$RANGE" 2>/dev/null | grep -E '^(src/|docs/admin-backend-spec\.md|package\.json)' >/dev/null; then
|
|
changed_significant=1
|
|
fi
|
|
if git diff --name-only "$RANGE" 2>/dev/null | grep -E '^docs/GISHEN-MASTER-SPEC\.md$' >/dev/null; then
|
|
master_in_range=1
|
|
fi
|
|
fi
|
|
|
|
# Working tree: uncommitted significant changes without master touch
|
|
if git status --porcelain 2>/dev/null | grep -E '^(A |M |M|A|\?\?) (src/|docs/admin-backend-spec\.md)' >/dev/null; then
|
|
if ! git status --porcelain 2>/dev/null | grep -E 'GISHEN-MASTER-SPEC\.md' >/dev/null; then
|
|
changed_significant=1
|
|
fi
|
|
fi
|
|
|
|
if (( stale == 1 )); then
|
|
echo "${YEL}WARN:${RST} ${MASTER} looks older than significant Admin sources."
|
|
echo " Newer example: ${newest_src:-unknown}"
|
|
echo " Refresh the master changelog + Sources stamp before push."
|
|
fi
|
|
|
|
if (( changed_significant == 1 && master_in_range == 0 )); then
|
|
echo "${YEL}WARN:${RST} Significant Admin changes in push range, but ${MASTER} not updated in that range."
|
|
echo " Agents/humans: update master per Update rule, then recommit."
|
|
fi
|
|
|
|
if (( stale == 0 && (changed_significant == 0 || master_in_range == 1) )); then
|
|
echo "${GRN}OK:${RST} No obvious master-spec staleness signals (still verify changelog if you changed domain contracts)."
|
|
fi
|
|
|
|
echo
|
|
echo "Sibling skim paths (read-only):"
|
|
echo " ../Gishen-Mob/docs/BACKEND_SPEC.md"
|
|
echo " ../Gishen-Ecom/docs/backend.md"
|
|
echo " ../Gishen-B2B/docs/backend/OVERVIEW.md"
|
|
echo " ../Gishen-Dispatch-Bot/docs/BACKEND_SPEC.md"
|
|
echo
|
|
|
|
if [[ "${GISHEN_MASTER_SPEC_STRICT:-0}" == "1" ]] && (( stale == 1 || (changed_significant == 1 && master_in_range == 0) )); then
|
|
echo "${RED}STRICT:${RST} GISHEN_MASTER_SPEC_STRICT=1 → exiting 1"
|
|
exit 1
|
|
fi
|
|
|
|
exit 0
|