syntaxai/tdd.md · main · cli.md

cli.md 514 lines · 14361 bytes raw · source

Ja, hier is een concreet voorstel voor een sterkere Linux-native SAMA v2 verifier. Doel van de Linux-first versie

Een zo licht mogelijk, betrouwbaar en inspecteerbaar verificatiesysteem dat voornamelijk uit shell commands bestaat, met zo min mogelijk externe dependencies. Voorgestelde structuur: sama CLI tool

sama check # Alle checks draaien sama check sorted sama check law sama check atomic sama doctor # Systeem + project diagnose sama graph # Toon import graph

Implementatie per Conformance Check

Hier is hoe elke check Linux-native kan worden geïmplementeerd: Check Linux Commando’s / Tools Uitleg

Sorted find . -name ".ts" -o -name ".go" | sort + regex op prefix Check of alle bestanden een geldige prefix hebben en of de sortering klopt met laag-volgorde
Architecture `grep -E ’^(a0_ b1_
Modeled (tests) find . -name ".ts" ! -name ".test.ts" | while read f; do test "$f.test.ts" ... Sibling testfile check
Modeled (boundary) `grep -E ’JSON.parse new URL
Atomic find . -name "*.ts" -exec wc -l {} + | awk '$1 > 700' Lijntelling + waarschuwing
The Law (Imports) grep -E 'from ["'''].*..' + tsort of eigen graph script Bouw een directed graph en check op cycles + richting
Consistency Combineer prefix extractie + import analyse Check of verklaarde laag overeenkomt met geïmporteerde lagen Voorbeeld: Basis sama check script

#!/usr/bin/env bash

sama-check.sh

PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd) cd "$PROJECT_ROOT"

echo "=== SAMA v2 Linux Verifier ==="

fail=0

Check 1: Sorted

echo -n "1. Sorted... " if find src -name "*.ts" | grep -vE '^[a-d][0-3]_' > /dev/null; then echo "FAIL (ongeldige prefix)" fail=1 else echo "OK" fi

Check 5: Atomic

echo -n "5. Atomic... " if find src -name "*.ts" -exec wc -l {} + | awk '$1 > 700' | grep . > /dev/null; then echo "FAIL (te grote files)" fail=1 else echo "OK" fi

Check 6: The Law (simpele versie)

echo -n "6. The Law... " if grep -rE 'from "'''+[a-d][0-3]' src | grep -E '^[a-d][0-1]' > /dev/null; then echo "FAIL (import omhoog)" fail=1 else echo "OK" fi

if [ $fail -eq 0 ]; then echo "✅ Alle checks geslaagd" else echo "❌ Er zijn fouten" exit 1 fi

Aanbevolen tools (minimal dependencies)

Core: bash, grep, find, awk, sed, wc, sort

Performance: ripgrep (rg) als optie

Graph analyse: graphviz (dot) + eigen parser of tsort

Taal-specifiek: jq voor JSON-config, yq voor YAML

Voordelen van deze aanpak

Zeer lichtgewicht (draait op bijna elke Linux server/CI)

Volledig inspecteerbaar (je kan elk commando los draaien)

AI-agents kunnen dit veel makkelijker genereren en debuggen

Sneller dan een zware TypeScript/Bun verifier

Past perfect bij Unix-filosofie

Wil je dat ik een volledig uitgewerkt script maak voor alle 7 checks? Of wil je een versie voor een specifieke taal (bijv. TypeScript, Go, Python)?

Bas van Cuilenburg [email protected] Mon, May 25, 10:26 PM (7 hours ago) to me

✅ Hier is de nog verder uitgebreide versie met sama graph functionaliteit. Volledige sama script (Linux-native + Graph support)

#!/usr/bin/env bash

=============================================

SAMA v2 Linux Verifier + Graph Tool

Unix-native • Verbeterde versie

=============================================

set -euo pipefail

PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd) cd "$PROJECT_ROOT"

MAX_LINES=700 SUPPORTED_EXTENSIONS=".ts$|.js$|.go$|.py$"

RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' NC='\033[0m'

fail=0

print_header() { echo "=== SAMA v2 Linux Verifier ===" echo "Project : $PROJECT_ROOT" echo "Max lines : $MAX_LINES" echo "=====================================" }

==================== CHECKS ====================

check_sorted() { local bad=$(find src -type f -regextype posix-extended -regex ".*($SUPPORTED_EXTENSIONS)" | grep -vE '^[a-d][0-3]_' | head -10) if [ -n "$bad" ]; then echo -e "${RED}Bestanden zonder prefix:${NC}" echo "$bad" return 1 fi return 0 }

check_modeled_tests() { local missing=() while IFS= read -r file; do local ext="${file##.}" local testfile="${file%.}.test.${ext}" [[ ! -f "$testfile" ]] && missing+=("$file") done < <(find src -regextype posix-extended -regex ".*($SUPPORTED_EXTENSIONS)" | grep -E '^[b-c][0-3]_')

if [ ${#missing[@]} -gt 0 ]; then
    echo -e "${RED}Missende tests:${NC}"
    printf '   %s\n' "${missing[@]}"
    return 1
fi
return 0

}

check_boundary() { local bad=$(grep -rE 'JSON.parse|new URL|URLSearchParams|qs.parse' --include=".ts" --include=".js" src 2>/dev/null | grep -E '^[a-b][0-1]_' || true) if [ -n "$bad" ]; then echo -e "${RED}Boundary violations:${NC}" echo "$bad" | head -8 return 1 fi return 0 }

check_atomic() { local big=$(find src -regextype posix-extended -regex ".*($SUPPORTED_EXTENSIONS)" -exec wc -l {} + 2>/dev/null | awk "$1 > $MAX_LINES" || true) if [ -n "$big" ]; then echo -e "${RED}Te grote bestanden:${NC}" echo "$big" return 1 fi return 0 }

check_the_law() { local bad=$(grep -rE 'from "'''+[a-d][0-3]' src 2>/dev/null | grep -E '^[a-d][0-1]' || true) if [ -n "$bad" ]; then echo -e "${RED}The Law overtredingen:${NC}" echo "$bad" | head -6 return 1 fi return 0 }

==================== GRAPH ====================

sama_graph() { echo -e "${BLUE}Generating SAMA dependency graph...${NC}"

local graph_file="/tmp/sama_graph.dot"

cat > "$graph_file" << EOF

digraph SAMA { rankdir=TB; node [shape=box, fontname="monospace"]; edge [arrowsize=0.6]; EOF

# Simpele import detectie
grep -rE 'from ["'\''](\./|\.\./)' src 2>/dev/null | head -50 | while read -r line; do
    file=$(echo "$line" | cut -d: -f1)
    import=$(echo "$line" | grep -oE 'from ["'\''][^"'\'']+')
    if [[ -n "$file" && -n "$import" ]]; then
        echo "    \"$file\" -> \"$import\";" >> "$graph_file"
    fi
done

echo "}" >> "$graph_file"

if command -v dot >/dev/null 2>&1; then
    dot -Tpng "$graph_file" -o sama_graph.png
    echo -e "${GREEN}✅ Graph gegenereerd: sama_graph.png${NC}"
else
    echo -e "${YELLOW}Waarschuwing: Graphviz (dot) niet geïnstalleerd.${NC}"
    echo "Installeer met: sudo apt install graphviz"
fi

}

==================== MAIN ====================

print_header

case "${1:-}" in graph) sama_graph ;; check) case "${2:-}" in sorted) check_sorted ;; tests) check_modeled_tests ;; boundary) check_boundary ;; atomic) check_atomic ;; law) check_the_law ;; *) echo "Beschikbare checks: sorted, tests, boundary, atomic, law" ;; esac ;; *) # Alle checks draaien echo "Running all checks..." check_sorted && echo -e "${GREEN}1. Sorted ...................... PASS${NC}" || { echo -e "${RED}1. Sorted ...................... FAIL${NC}"; fail=1; } check_modeled_tests && echo -e "${GREEN}3. Modeled (tests) ............. PASS${NC}" || { echo -e "${RED}3. Modeled (tests) ............. FAIL${NC}"; fail=1; } check_boundary && echo -e "${GREEN}4. Modeled (boundary) .......... PASS${NC}" || { echo -e "${RED}4. Modeled (boundary) .......... FAIL${NC}"; fail=1; } check_atomic && echo -e "${GREEN}5. Atomic ...................... PASS${NC}" || { echo -e "${RED}5. Atomic ...................... FAIL${NC}"; fail=1; } check_the_law && echo -e "${GREEN}6. The Law ..................... PASS${NC}" || { echo -e "${RED}6. The Law ..................... FAIL${NC}"; fail=1; } ;; esac

echo "=====================================" if [ $fail -eq 0 ]; then echo -e "${GREEN}✅ SAMA v2 Compliant${NC}" else echo -e "${RED}❌ SAMA v2 issues found${NC}" exit 1 fi

Gebruik:

sama # Alle checks sama check law # Alleen The Law sama graph # Genereert dependency graph (sama_graph.png)

Wil je nog verder gaan? Bijvoorbeeld:

Ondersteuning voor Go of Python verbeteren?

Een sama doctor commando toevoegen?

Het script nog simpeler/moderner maken met fd + rg?

Laat het weten!

Met vriendelijke groet / Mit freundlichen Grüßen / Kind regards, ______________________________

Bas van Cuilenburg

Bas van Cuilenburg [email protected] Mon, May 25, 10:30 PM (7 hours ago) to me

✅ Hier is de volledige, 100% SAMA v2 compliant versie van de Linux Verifier. Projectstructuur (SAMA v2 compliant)

sama-cli/ ├── sama # Hoofd executable (wrapper) ├── src/ │ ├── a0_main.sh # Layer 3 - Entry │ ├── b1_checks.sh # Layer 1 - Core │ ├── b2_graph.sh # Layer 2 - Adapter │ ├── c1_utils.sh # Layer 1 - Core │ └── c2_constants.sh # Layer 0 - Pure └── tests/ ├── b1_checks.test.sh └── c1_utils.test.sh

src/c2_constants.sh (Layer 0 - Pure)

#!/usr/bin/env bash

c2_constants.sh

MAX_LINES=700 SUPPORTED_EXTENSIONS=".ts$|.js$|.go$|.py$|.sh$"

RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' NC='\033[0m'

src/c1_utils.sh (Layer 1 - Core)

#!/usr/bin/env bash

c1_utils.sh

print_header() { echo "=== SAMA v2 Linux Verifier ===" echo "Project : $(pwd)" echo "Max lines : $MAX_LINES" echo "=====================================" }

run_check() { local name="$1" local func="$2" echo -n "$name " printf "%-28s" "........................" if $func; then echo -e "${GREEN}PASS${NC}" return 0 else echo -e "${RED}FAIL${NC}" return 1 fi }

src/b1_checks.sh (Layer 1 - Core)

#!/usr/bin/env bash

b1_checks.sh

source "src/c2_constants.sh"

if [ ${#missing[@]} -gt 0 ]; then
    echo -e "${RED}Missende testbestanden:${NC}"
    printf '   %s\n' "${missing[@]}"
    return 1
fi
return 0

}

check_boundary() { local bad=$(grep -rE 'JSON.parse|new URL|URLSearchParams|qs.parse' --include=".ts" --include=".js" src 2>/dev/null | grep -E '^[a-b][0-1]_' || true) if [ -n "$bad" ]; then echo -e "${RED}Boundary violations (parsing buiten Layer 2):${NC}" echo "$bad" | head -8 return 1 fi return 0 }

check_atomic() { local big=$(find src -regextype posix-extended -regex ".*($SUPPORTED_EXTENSIONS)" -exec wc -l {} + 2>/dev/null | awk "$1 > $MAX_LINES" || true) if [ -n "$big" ]; then echo -e "${RED}Bestanden groter dan ${MAX_LINES} regels:${NC}" echo "$big" return 1 fi return 0 }

check_the_law() { local bad=$(grep -rE 'from "'''+[a-d][0-3]' src 2>/dev/null | grep -E '^[a-d][0-1]' || true) if [ -n "$bad" ]; then echo -e "${RED}The Law overtredingen (import omhoog):${NC}" echo "$bad" | head -6 return 1 fi return 0 }

src/b2_graph.sh (Layer 2 - Adapter)

#!/usr/bin/env bash

b2_graph.sh

sama_graph() { echo -e "${BLUE}Generating SAMA dependency graph...${NC}"

local graph_file="/tmp/sama_graph.dot"

cat > "$graph_file" << EOF

digraph SAMA { rankdir=TB; node [shape=box, fontname="monospace"]; edge [arrowsize=0.6]; EOF

grep -rE 'source |from ["'\'']' src 2>/dev/null | head -40 | while read -r line; do
    file=$(echo "$line" | cut -d: -f1)
    import=$(echo "$line" | grep -oE '(source |from ["'\''])[^"'\'' ]+' | sed 's/.* //')
    if [[ -n "$file" && -n "$import" ]]; then
        echo "    \"$file\" -> \"$import\";" >> "$graph_file"
    fi
done

echo "}" >> "$graph_file"

if command -v dot >/dev/null 2>&1; then
    dot -Tpng "$graph_file" -o sama_graph.png
    echo -e "${GREEN}✅ Graph gegenereerd → sama_graph.png${NC}"
else
    echo -e "${YELLOW}Graphviz niet gevonden. Installeer met: sudo apt install graphviz${NC}"
fi

}

src/a0_main.sh (Layer 3 - Entry)

#!/usr/bin/env bash

a0_main.sh

source "src/c2_constants.sh" source "src/c1_utils.sh" source "src/b1_checks.sh" source "src/b2_graph.sh"

fail=0

print_header

echo "=====================================" if [ $fail -eq 0 ]; then echo -e "${GREEN}✅ SAMA v2 Compliant — Alles in orde!${NC}" else echo -e "${RED}❌ SAMA v2 — Er zijn overtredingen${NC}" exit 1 fi

Hoofd executable: sama (in root)

#!/usr/bin/env bash

sama

cd "$(dirname "$0")" exec bash src/a0_main.sh "$@"

Installatie commando’s

Maak alle files executable

chmod +x sama src/*.sh

Test het

./sama ./sama graph

Wil je dat ik ook de testbestanden (*.test.sh) toevoeg, of een sama doctor commando?

Met vriendelijke groet / Mit freundlichen Grüßen / Kind regards, ______________________________