@sdd-method/sdd-cli 1.36.2 → 1.38.0

package/scripts/validate-app-docs.sh

@@ -34,6 +34,9 @@ log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
 log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
 log_fail() { echo -e "${RED}[FAIL]${NC} $1"; }
 log_pass() { echo -e "${GREEN}[PASS]${NC} $1"; }
+# R1: an empty population is "measured nothing", not a pass — the [N/A] tag
+# must start the line (no leading colour escape) so callers can detect it.
+log_na() { echo -e "[N/A] $1"; }
 log_section() {
     echo -e "\n${BLUE}═══════════════════════════════════════════════════════════${NC}"
     echo -e "${BLUE}  $1${NC}"
@@ -66,6 +69,14 @@ fi
 
 FAILURES=0
 
+# R1: the feature specs are the population this validator measures. With none,
+# the Group 1 file-presence checks are reported as [INFO] rather than [PASS] so
+# the run reads as "measured nothing", not as a pass.
+FEATURE_SPEC_COUNT="$( (find "$APP_ROOT/features" -type f -name "*.md" 2>/dev/null || true) | wc -l | tr -d ' ')"
+log_found() {
+    if [[ "$FEATURE_SPEC_COUNT" -gt 0 ]]; then log_pass "$1"; else log_info "$1"; fi
+}
+
 # ──────────────────────────────────────────────────────────────────────────────
 check_required_files() {
     log_section "Group 1: Required App Repo Files"
@@ -85,7 +96,7 @@ check_required_files() {
         log_fail "service-architecture.md not found (checked docs/service-architecture.md and service-architecture.md)"
         checks_failed=$((checks_failed + 1))
     else
-        log_pass "service-architecture.md found: ${service_arch#$APP_ROOT/}"
+        log_found "service-architecture.md found: ${service_arch#$APP_ROOT/}"
         checks_passed=$((checks_passed + 1))
     fi
 
@@ -103,13 +114,13 @@ check_required_files() {
         log_warn "feature-tree.md not found (checked docs/platform/, docs/, and repo root) — create when features are classified"
         # warn only; not a hard fail at exploration stage
     else
-        log_pass "feature-tree.md found: ${feature_tree#$APP_ROOT/}"
+        log_found "feature-tree.md found: ${feature_tree#$APP_ROOT/}"
         checks_passed=$((checks_passed + 1))
     fi
 
     # 1c. app-platform-dependencies.yaml
     if [[ -f "$APP_ROOT/app-platform-dependencies.yaml" ]]; then
-        log_pass "app-platform-dependencies.yaml found"
+        log_found "app-platform-dependencies.yaml found"
         checks_passed=$((checks_passed + 1))
     else
         log_fail "app-platform-dependencies.yaml not found in repo root"
@@ -173,7 +184,10 @@ main() {
 
     log_section "Summary"
 
-    if [[ "$FAILURES" -eq 0 ]]; then
+    if [[ "$FAILURES" -eq 0 && "$FEATURE_SPEC_COUNT" -eq 0 ]]; then
+        log_na "App documentation: required files present, but 0 feature specs found under features/ — nothing to check"
+        exit 0
+    elif [[ "$FAILURES" -eq 0 ]]; then
         log_pass "All app documentation checks passed."
         exit 0
     else