start-vibing 4.3.1 → 4.3.3

package/template/.claude/skills/super-design/scripts/write-state.sh

@@ -1,13 +1,40 @@
 #!/usr/bin/env bash
-# Usage: write-state.sh [<target>]        (reads JSON body from stdin)
+# Usage: write-state.sh [<app_path>] [<explicit_target>]
+#        (reads JSON body from stdin)
 #
 # Atomic state writer: accepts JSON on stdin, writes to <target>.tmp,
 # validates with jq, then renames in place. Referenced from
 # docs/compass_artifact §11 ("Write-then-rename (atomic)") and SKILL.md
 # Step 4 ("Atomic write .audit-state.json").
+#
+# Monorepo support (artifact §11 line 902): first positional arg is the
+# app root (e.g. `apps/web`). Target state path is derived as
+# `<app_path>/docs/super-design/.audit-state.json`. For single-app
+# repos pass "." or omit (default behavior preserved).
+# Back-compat: if the first arg already ends in `.audit-state.json`, it
+# is treated as an explicit target path (legacy one-arg call sites).
 set -euo pipefail
 
-TARGET="${1:-docs/super-design/.audit-state.json}"
+APP_PATH="${1:-.}"
+EXPLICIT="${2:-}"
+
+if [ -n "$EXPLICIT" ]; then
+  TARGET="$EXPLICIT"
+else
+  case "$APP_PATH" in
+    *.audit-state.json)
+      # Legacy single-arg call: treat $APP_PATH as the full target path.
+      TARGET="$APP_PATH"
+      ;;
+    .|"")
+      TARGET="docs/super-design/.audit-state.json"
+      ;;
+    *)
+      TARGET="${APP_PATH%/}/docs/super-design/.audit-state.json"
+      ;;
+  esac
+fi
+
 TMP="${TARGET}.tmp"
 
 mkdir -p "$(dirname "$TARGET")"

package/template/.claude/skills/super-design/templates/audit-state.schema.json

@@ -1,57 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "super-design/audit-state.schema.json",
-  "type": "object",
-  "required": ["schema_version","skill_version","last_audit_at","git_sha_at_audit","theory_doc_sha","tools","pages_audited","findings_counts"],
-  "properties": {
-    "schema_version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
-    "skill_version": { "type": "string" },
-    "last_audit_at": { "type": "string", "format": "date-time" },
-    "git_sha_at_audit": { "type": "string", "pattern": "^[0-9a-f]{7,64}$" },
-    "git_branch": { "type": "string" },
-    "is_shallow_clone": { "type": "boolean" },
-    "theory_doc_sha": { "type": "string" },
-    "market_analysis_sha": { "type": "string" },
-    "tools": { "type": "object", "additionalProperties": { "type": "string" } },
-    "framework": {
-      "type": "object",
-      "properties": {
-        "name": { "type": "string" },
-        "router": { "type": "string" },
-        "version": { "type": "string" }
-      }
-    },
-    "route_map": { "type": "array", "items": { "type": "string" } },
-    "pages_audited": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["url","last_audited"],
-        "properties": {
-          "url": { "type": "string" },
-          "route_file": { "type": "string" },
-          "html_hash": { "type": "string" },
-          "dom_structure_hash": { "type": "string" },
-          "viewport_hashes": { "type": "object" },
-          "last_audited": { "type": "string", "format": "date-time" },
-          "findings_ids": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "components": { "type": "object", "additionalProperties": { "type": "string" } },
-    "token_hash": { "type": "string" },
-    "import_graph_sha": { "type": "string" },
-    "findings_counts": {
-      "type": "object",
-      "required": ["blockers","high","medium","nitpicks"],
-      "properties": {
-        "blockers": { "type": "integer" },
-        "high": { "type": "integer" },
-        "medium": { "type": "integer" },
-        "nitpicks": { "type": "integer" }
-      }
-    },
-    "research_at": { "type": "string", "format": "date-time" },
-    "ignored_paths": { "type": "array", "items": { "type": "string" } }
-  }
-}