prizmkit 1.1.99 → 1.1.101

package/bundled/templates/hooks/prizm-pre-commit.sh

@@ -1,108 +0,0 @@
-#!/bin/sh
-# prizm-pre-commit.sh — git pre-commit hook for .prizmkit/prizm-docs validation
-
-PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0
-
-# Only run in prizm projects
-[ -f "$PROJECT_ROOT/.prizmkit/prizm-docs/root.prizm" ] || exit 0
-
-VALIDATE_SCRIPT="$PROJECT_ROOT/.prizmkit/scripts/validate-prizm-docs.sh"
-[ -f "$VALIDATE_SCRIPT" ] || VALIDATE_SCRIPT="$PROJECT_ROOT/.prizmkit/dev-pipeline/scripts/validate-prizm-docs.sh"
-
-if [ -f "$VALIDATE_SCRIPT" ]; then
-    sh "$VALIDATE_SCRIPT" --staged
-    exit $?
-fi
-
-# Inline fallback: core checks for staged .prizm files
-FILES=$(git diff --cached --name-only 2>/dev/null | grep '\.prizm$')
-[ -z "$FILES" ] && exit 0
-
-ERRORS=0
-TEMP_FILES=""
-
-cleanup() {
-    # shellcheck disable=SC2086
-    [ -z "$TEMP_FILES" ] || rm -f $TEMP_FILES
-}
-trap cleanup EXIT HUP INT TERM
-
-for FILE in $FILES; do
-    git cat-file -e ":$FILE" 2>/dev/null || continue
-    CHECK_FILE=$(mktemp "${TMPDIR:-/tmp}/prizm-doc.XXXXXX") || exit 1
-    TEMP_FILES="$TEMP_FILES $CHECK_FILE"
-    git show ":$FILE" > "$CHECK_FILE" 2>/dev/null || continue
-
-    if grep -qE '^#{1,6} ' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains markdown headers (##). Use KEY: value format." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if grep -q '^```' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains code blocks. Use file_path:line_number reference." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    BASE_NAME=$(basename "$FILE" | tr '[:upper:]' '[:lower:]')
-    case "$BASE_NAME" in
-        changelog.prizm|changelog-archive.prizm|*changelog*.prizm)
-            echo "ERROR: $FILE is auxiliary history. Use git history instead of changelog .prizm files." >&2
-            ERRORS=$((ERRORS + 1))
-            ;;
-    esac
-    if grep -qiE '^[[:space:]]*[-*]?[[:space:]]*(CHANGELOG|CREATED([ _-]?(AT|ON|DATE))?|UPDATED([ _-]?(AT|ON|DATE))?|MODIFIED([ _-]?(AT|ON|DATE))?|LAST[ _-]?(UPDATED|MODIFIED)([ _-]?(AT|ON|DATE))?|DATE|TIMESTAMP):' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains auxiliary history metadata. Use durable KEY: value sections only; git tracks history." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if grep -qiE '(^|[^[:alnum:]_])([FBR]-[0-9]{3}|T-[0-9]{3})(-[A-Z])?([^[:alnum:]_]|$)' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*((bug|feature|refactor|task)[ _-]?id|(session|run|pipeline|workflow)([ _-]?id)?)([[:space:]]*(:|=)|[[:space:]]+)' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*(bug|feature|refactor|task|session|run|pipeline|workflow)([ _-](bug|feature|refactor|task|session|run|pipeline|workflow|id))+([[:space:]]*(:|=)|[[:space:]]+)' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains workflow metadata. Translate IDs, branch names, worktree paths, and pipeline artifacts into durable product/domain language." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if sed 's#\\#/#g' "$CHECK_FILE" | grep -qE '(^|[^[:alnum:]_.-])\.prizmkit/(specs|dev-pipeline)($|/|[^[:alnum:]_.-])'; then
-        echo "ERROR: $FILE contains PrizmKit artifact paths. Translate specs/dev-pipeline references into durable product/domain language." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if sed 's#\\#/#g' "$CHECK_FILE" | grep -qE '(^|[^[:alnum:]_./:-])(/Users/|/home/|/tmp/|/private/tmp/|/var/folders/|/workspace/|/workspaces/|/opt/|/srv/|/root/|/var/tmp/|/Volumes/|/mnt/[A-Za-z]/|[A-Za-z]:/)'; then
-        echo "ERROR: $FILE contains absolute worktree paths. Use repository-relative source paths only." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if grep -qE '^[[:space:]]*[-*]?[[:space:]]*(BRANCH|BRANCH_NAME|CURRENT_BRANCH|SOURCE_BRANCH|BASE_BRANCH|HEAD_BRANCH|GIT_BRANCH|TARGET_BRANCH)[[:space:]_-]*(:|=|[[:space:]])' "$CHECK_FILE" \
-        || grep -qE '^[[:space:]]*[-*]?[[:space:]]*[A-Z][A-Z0-9_]*_BRANCH[[:space:]_-]*(:|=|[[:space:]])[[:space:]]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)[[:space:]]*(#.*)?$' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*(branch[ _-]*name|current[ _-]*branch|source[ _-]*branch|base[ _-]*branch|head[ _-]*branch|git[ _-]*branch|target[ _-]*branch)[[:space:]_-]*(:|=|[[:space:]])' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*([[:alnum:]]+[ _-]+)+branch([[:space:]]*(:|=)|[[:space:]]+)[[:space:]]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)[[:space:]]*(#.*)?$' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*branch[[:space:]_-]*(:|=|[[:space:]])[[:space:]]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)[[:space:]]*(#.*)?$' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains branch names. Describe durable product/domain context instead." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    SIZE=$(wc -c < "$CHECK_FILE" | tr -d ' ')
-    case "$FILE" in
-        *root.prizm) LIMIT=4096 ;;
-        *)
-            DIR=$(dirname "$FILE")
-            if [ "$DIR" = ".prizmkit/prizm-docs" ]; then
-                LIMIT=3072
-            else
-                LIMIT=5120
-            fi
-            ;;
-    esac
-
-    if [ "$SIZE" -gt "$LIMIT" ]; then
-        echo "ERROR: $FILE exceeds size limit (${SIZE}B > ${LIMIT}B)." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-done
-
-if [ "$ERRORS" -gt 0 ]; then
-    echo "PrizmKit: $ERRORS format error(s) in .prizm files. Fix before committing." >&2
-    exit 1
-fi
-
-exit 0

package/bundled/templates/hooks/validate-prizm-docs.sh

@@ -1,139 +0,0 @@
-#!/bin/sh
-# validate-prizm-docs.sh — validate .prizm file format and size limits
-# Usage: validate-prizm-docs.sh [--all | --staged]
-
-MODE="${1:---staged}"
-ERRORS=0
-TEMP_FILES=""
-
-cleanup() {
-    # shellcheck disable=SC2086
-    [ -z "$TEMP_FILES" ] || rm -f $TEMP_FILES
-}
-trap cleanup EXIT HUP INT TERM
-
-# Not a prizm project — exit silently
-[ -f ".prizmkit/prizm-docs/root.prizm" ] || exit 0
-
-# Collect files to check
-if [ "$MODE" = "--all" ]; then
-    FILES=$(find .prizmkit/prizm-docs -name '*.prizm' 2>/dev/null)
-elif [ "$MODE" = "--staged" ]; then
-    FILES=$(git diff --cached --name-only 2>/dev/null | grep '\.prizm$')
-else
-    echo "Usage: validate-prizm-docs.sh [--all | --staged]" >&2
-    exit 1
-fi
-
-# Nothing to check — exit silently
-[ -z "$FILES" ] && exit 0
-
-for FILE in $FILES; do
-    CHECK_FILE="$FILE"
-    if [ "$MODE" = "--staged" ]; then
-        git cat-file -e ":$FILE" 2>/dev/null || continue
-        CHECK_FILE=$(mktemp "${TMPDIR:-/tmp}/prizm-doc.XXXXXX") || exit 1
-        TEMP_FILES="$TEMP_FILES $CHECK_FILE"
-        git show ":$FILE" > "$CHECK_FILE" 2>/dev/null || continue
-    else
-        [ -f "$FILE" ] || continue
-    fi
-
-    # Check markdown headers
-    if grep -qE '^#{1,6} ' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains markdown headers (##). Use KEY: value format." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check code blocks
-    if grep -q '^```' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains code blocks. Use file_path:line_number reference." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check auxiliary history fields and files
-    BASE_NAME=$(basename "$FILE" | tr '[:upper:]' '[:lower:]')
-    case "$BASE_NAME" in
-        changelog.prizm|changelog-archive.prizm|*changelog*.prizm)
-            echo "ERROR: $FILE is auxiliary history. Use git history instead of changelog .prizm files." >&2
-            ERRORS=$((ERRORS + 1))
-            ;;
-    esac
-    if grep -qiE '^[[:space:]]*[-*]?[[:space:]]*(CHANGELOG|CREATED([ _-]?(AT|ON|DATE))?|UPDATED([ _-]?(AT|ON|DATE))?|MODIFIED([ _-]?(AT|ON|DATE))?|LAST[ _-]?(UPDATED|MODIFIED)([ _-]?(AT|ON|DATE))?|DATE|TIMESTAMP):' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains auxiliary history metadata. Use durable KEY: value sections only; git tracks history." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check workflow metadata leakage
-    if grep -qiE '(^|[^[:alnum:]_])([FBR]-[0-9]{3}|T-[0-9]{3})(-[A-Z])?([^[:alnum:]_]|$)' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*((bug|feature|refactor|task)[ _-]?id|(session|run|pipeline|workflow)([ _-]?id)?)([[:space:]]*(:|=)|[[:space:]]+)' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*(bug|feature|refactor|task|session|run|pipeline|workflow)([ _-](bug|feature|refactor|task|session|run|pipeline|workflow|id))+([[:space:]]*(:|=)|[[:space:]]+)' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains workflow metadata. Translate IDs, branch names, worktree paths, and pipeline artifacts into durable product/domain language." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if sed 's#\\#/#g' "$CHECK_FILE" | grep -qE '(^|[^[:alnum:]_.-])\.prizmkit/(specs|dev-pipeline)($|/|[^[:alnum:]_.-])'; then
-        echo "ERROR: $FILE contains PrizmKit artifact paths. Translate specs/dev-pipeline references into durable product/domain language." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if sed 's#\\#/#g' "$CHECK_FILE" | grep -qE '(^|[^[:alnum:]_./:-])(/Users/|/home/|/tmp/|/private/tmp/|/var/folders/|/workspace/|/workspaces/|/opt/|/srv/|/root/|/var/tmp/|/Volumes/|/mnt/[A-Za-z]/|[A-Za-z]:/)'; then
-        echo "ERROR: $FILE contains absolute worktree paths. Use repository-relative source paths only." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    if grep -qE '^[[:space:]]*[-*]?[[:space:]]*(BRANCH|BRANCH_NAME|CURRENT_BRANCH|SOURCE_BRANCH|BASE_BRANCH|HEAD_BRANCH|GIT_BRANCH|TARGET_BRANCH)[[:space:]_-]*(:|=|[[:space:]])' "$CHECK_FILE" \
-        || grep -qE '^[[:space:]]*[-*]?[[:space:]]*[A-Z][A-Z0-9_]*_BRANCH[[:space:]_-]*(:|=|[[:space:]])[[:space:]]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)[[:space:]]*(#.*)?$' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*(branch[ _-]*name|current[ _-]*branch|source[ _-]*branch|base[ _-]*branch|head[ _-]*branch|git[ _-]*branch|target[ _-]*branch)[[:space:]_-]*(:|=|[[:space:]])' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*([[:alnum:]]+[ _-]+)+branch([[:space:]]*(:|=)|[[:space:]]+)[[:space:]]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)[[:space:]]*(#.*)?$' "$CHECK_FILE" \
-        || grep -qiE '^[[:space:]]*[-*]?[[:space:]]*branch[[:space:]_-]*(:|=|[[:space:]])[[:space:]]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)[[:space:]]*(#.*)?$' "$CHECK_FILE"; then
-        echo "ERROR: $FILE contains branch names. Describe durable product/domain context instead." >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Size limits — determine level by path depth
-    SIZE=$(wc -c < "$CHECK_FILE" | tr -d ' ')
-    case "$FILE" in
-        *root.prizm)
-            LIMIT=4096; LEVEL="L0"
-            HINT="Consolidate MODULE_INDEX, keep top-5 RULES."
-            ;;
-        *)
-            # L1 = direct child of .prizmkit/prizm-docs/, L2 = nested deeper
-            DIR=$(dirname "$FILE")
-            if [ "$DIR" = ".prizmkit/prizm-docs" ]; then
-                LIMIT=3072; LEVEL="L1"
-                HINT="Move implementation details to L2."
-            else
-                LIMIT=5120; LEVEL="L2"
-                HINT="Remove stale or trivially derivable entries."
-            fi
-            ;;
-    esac
-
-    if [ "$SIZE" -gt "$LIMIT" ]; then
-        echo "ERROR: $FILE exceeds $LEVEL limit (${SIZE}B > ${LIMIT}B). $HINT" >&2
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Required fields in root.prizm
-    case "$FILE" in
-        *root.prizm)
-            if ! grep -q 'PRIZM_VERSION:' "$CHECK_FILE"; then
-                echo "ERROR: $FILE missing required field PRIZM_VERSION:" >&2
-                ERRORS=$((ERRORS + 1))
-            fi
-            if ! grep -q 'MODULE_INDEX:' "$CHECK_FILE"; then
-                echo "ERROR: $FILE missing required field MODULE_INDEX:" >&2
-                ERRORS=$((ERRORS + 1))
-            fi
-            ;;
-    esac
-done
-
-if [ "$ERRORS" -gt 0 ]; then
-    echo "PrizmKit: $ERRORS format error(s) in .prizm files. Fix before committing." >&2
-    exit 1
-fi
-
-exit 0