feat(scaffold): strip apps/docs from scaffolded products; make docs checks template-only

apps/docs is boringstack's OWN docs site — a scaffolded product must not carry or
gate against it. Manifest declares strip:[apps/docs] for the full-stack archetype
(tsforge deletes it post-clone). stack-check.sh now skips the docs checks (data +
build:ci/og-image) when apps/docs is absent, so a product passes cleanly while the
template itself (which keeps apps/docs) still checks it fully.

Author: agjs

.tsforge/scaffold-manifest.json

@@ -255,7 +255,8 @@
       "healthUrls": [
         "http://localhost:7331/",
         "http://localhost:7330/swagger/json"
-      ]
+      ],
+      "strip": ["apps/docs"]
     },
     "astro": {
       "subPath": "apps/docs",

scripts/stack-check.sh

@@ -21,7 +21,15 @@ run_check() {
 
 require_dir "api" "$BORINGSTACK_API_DIR"
 require_dir "ui" "$BORINGSTACK_UI_DIR"
-require_dir "docs" "$BORINGSTACK_DOCS_DIR"
+
+# `docs` is TEMPLATE-ONLY. The boringstack repo ships apps/docs (its own docs site)
+# and checks it here; a product scaffolded FROM boringstack strips apps/docs (see
+# .tsforge/scaffold-manifest.json `strip`), so its docs checks are skipped rather
+# than hard-failing. Present ⇒ run them (the template); absent ⇒ this is a product.
+HAS_DOCS=0
+if [[ -d "$BORINGSTACK_DOCS_DIR" ]]; then
+  HAS_DOCS=1
+fi
 
 run_check "ACL drift" bash -c "cd \"$BORINGSTACK_API_DIR\" && bun run generate:acl-types:check"
 run_check "api lint-meta docs" bash -c "cd \"$BORINGSTACK_API_DIR\" && bun run check:lint-meta-docs"
@@ -36,12 +44,16 @@ fi
 run_check "ui lint-meta docs" bash -c "cd \"$BORINGSTACK_UI_DIR\" && bun run check:lint-meta-docs"
 run_check "ui scripts docs" bash -c "cd \"$BORINGSTACK_UI_DIR\" && bun run check:scripts-docs"
 
-run_check "docs data" bash -c "cd \"$BORINGSTACK_DOCS_DIR\" && BORINGSTACK_API_DIR=\"$BORINGSTACK_API_DIR\" BORINGSTACK_UI_DIR=\"$BORINGSTACK_UI_DIR\" bun run check:docs-data"
+if [[ "$HAS_DOCS" == "1" ]]; then
+  run_check "docs data" bash -c "cd \"$BORINGSTACK_DOCS_DIR\" && BORINGSTACK_API_DIR=\"$BORINGSTACK_API_DIR\" BORINGSTACK_UI_DIR=\"$BORINGSTACK_UI_DIR\" bun run check:docs-data"
+fi
 
 if [[ "$FULL" == "--full" ]]; then
   run_check "api validate" bash -c "cd \"$BORINGSTACK_API_DIR\" && bun run validate"
   run_check "ui validate" bash -c "cd \"$BORINGSTACK_UI_DIR\" && bun run validate"
-  run_check "docs build:ci" bash -c "cd \"$BORINGSTACK_DOCS_DIR\" && BORINGSTACK_API_DIR=\"$BORINGSTACK_API_DIR\" BORINGSTACK_UI_DIR=\"$BORINGSTACK_UI_DIR\" bun run build:ci"
+  if [[ "$HAS_DOCS" == "1" ]]; then
+    run_check "docs build:ci" bash -c "cd \"$BORINGSTACK_DOCS_DIR\" && BORINGSTACK_API_DIR=\"$BORINGSTACK_API_DIR\" BORINGSTACK_UI_DIR=\"$BORINGSTACK_UI_DIR\" bun run build:ci"
+  fi
 fi
 
 printf '\n'