@windyroad/architect 0.21.4-preview.1104 → 0.21.4-preview.1106

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windyroad/architect",
-  "version": "0.21.4-preview.1104",
+  "version": "0.21.4-preview.1106",
   "description": "Architecture decision enforcement for AI coding agents",
   "bin": {
     "windyroad-architect": "./bin/install.mjs"

package/scripts/generate-decisions-compendium.sh

@@ -112,19 +112,41 @@ trap cleanup_compendium EXIT
 
 # --- Field extractors ------------------------------------------------------
 
-# Read a frontmatter scalar field (single line `key: value`).
+# Read a frontmatter scalar or block-list field. Scalars are returned as-is;
+# block lists are compacted to the same `[item, item]` shape as inline lists.
 # Strips surrounding quotes and leading/trailing whitespace.
 get_frontmatter_field() {
     local file="$1" field="$2"
     awk -v f="$field" '
+        function emit_list(    i) {
+            if (!list_count || list_emitted) return
+            printf "["
+            for (i = 1; i <= list_count; i++) {
+                if (i > 1) printf ", "
+                printf "%s", list[i]
+            }
+            print "]"
+            list_emitted = 1
+        }
         /^---$/ { fm = !fm; if (!fm) exit; next }
+        in_list && /^  - / {
+            item = $0
+            sub(/^  - */, "", item)
+            list[++list_count] = item
+            next
+        }
+        in_list { emit_list(); exit }
         fm && $0 ~ "^"f":" {
             sub("^"f": *", "")
             gsub(/^["'"'"']|["'"'"']$/, "")
             sub(/^ +/, ""); sub(/ +$/, "")
-            print
-            exit
+            if (length($0)) {
+                print
+                exit
+            }
+            in_list = 1
         }
+        END { emit_list() }
     ' "$file"
 }
 
@@ -147,24 +169,32 @@ get_section() {
     ' "$file"
 }
 
-# Extract the "Chosen option:" line from the Decision Outcome section.
+# Extract the first "Chosen option:" paragraph from the Decision Outcome section.
 # Matches the common MADR shapes:
 #   Chosen option: **"X"**, because Y.
 #   Chosen option: X, because Y.
 #   Chosen: X.
 get_chosen() {
     get_section "$1" "Decision Outcome" \
-        | awk '/^Chosen/ { print; exit }' \
-        | head -1
+        | awk '
+            /^Chosen/ { in_chosen = 1 }
+            in_chosen && NF == 0 { exit }
+            in_chosen { print }
+        '
 }
 
 # Extract top-level bullet lines (`- ...`) from a section. Skips nested
-# `  - ...` sub-bullets to keep the compendium dense. Capped at N entries.
+# `  - ...` sub-bullets to keep the compendium dense. Capped at N entries;
+# a cap of 0 preserves every item.
 get_bullets() {
     local file="$1" section="$2" cap="${3:-5}"
     get_section "$file" "$section" \
-        | awk '/^- / { sub(/^- */, ""); print }' \
-        | head -"$cap"
+        | awk -v cap="$cap" '/^- / {
+            sub(/^- */, "")
+            print
+            count++
+            if (cap > 0 && count >= cap) exit
+        }'
 }
 
 # Compact-join bullets onto one line, truncating each to N chars + "...".
@@ -229,24 +259,35 @@ oneline() {
     tr '\n\r' '  ' | tr -s ' ' | sed 's/^ *//; s/ *$//'
 }
 
-# Truncate a string to N chars + ellipsis if longer. Avoids slicing inside
-# a markdown emphasis pair (e.g. `**text**`) — if the truncation would land
-# inside `**...**`, round back to before the opening pair.
+# Truncate a string to N chars + ellipsis if longer. Avoids slicing a `**`
+# marker in half and closes emphasis when truncation lands inside it.
 truncate_with_ellipsis() {
-    local s="$1" n="$2"
+    local s="$1" n="$2" truncated remainder pairs=0
     if [ "${#s}" -le "$n" ]; then
         printf '%s' "$s"
         return
     fi
-    printf '%s' "${s:0:n}..."
+    truncated="${s:0:n}"
+    if [[ "$truncated" == *\* && "${s:n:1}" == "*" ]]; then
+        truncated="${truncated%?}"
+    fi
+    remainder="$truncated"
+    while [[ "$remainder" == *"**"* ]]; do
+        remainder="${remainder#*"**"}"
+        pairs=$((pairs + 1))
+    done
+    if [ $((pairs % 2)) -ne 0 ]; then
+        truncated="${truncated}**"
+    fi
+    printf '%s' "${truncated}..."
 }
 
 # --- Per-ADR entry emitter -------------------------------------------------
 
 emit_entry() {
     local file="$1"
-    local id title status oversight superseded supersede_ticket
-    local chosen drivers confirmation related
+    local id title status oversight superseded superseded_by supersede_ticket
+    local chosen drivers confirmation related amends supplements
 
     id=$(basename "$file" | grep -oE '^[0-9]+')
     title=$(get_title "$file")
@@ -256,6 +297,9 @@ emit_entry() {
     esac
     oversight=$(get_frontmatter_field "$file" "human-oversight")
     superseded=$(get_frontmatter_field "$file" "supersedes")
+    superseded_by=$(get_frontmatter_field "$file" "superseded-by")
+    amends=$(get_frontmatter_field "$file" "amends")
+    supplements=$(get_frontmatter_field "$file" "supplements")
     # ADR-066 amendment (P316): when the oversight value is
     # `rejected-pending-supersede`, surface the tracking ticket parenthetically
     # so the compendium badge shows both the disposition AND the supersede in
@@ -264,17 +308,15 @@ emit_entry() {
 
     # Chosen-option line — truncate to a comfortable summary length.
     chosen=$(get_chosen "$file" | strip_links | oneline)
-    if ! chosen=$(printf '%s' "$chosen" \
-        | awk -v n=240 '{ if (length($0) > n) print substr($0,1,n) "..."; else print }' \
+    if ! chosen=$(truncate_with_ellipsis "$chosen" 240 \
         | iconv -f UTF-8 -t UTF-8 -c); then
         echo "generate-decisions-compendium: failed to truncate chosen text safely for $file" >&2
         return 1
     fi
 
-    # Confirmation: cap 5 bullets, ≤ 110 chars each, joined with "; " on one line.
-    # This is the routine-compliance scannable view; the full Confirmation list
-    # remains in the per-ADR body for deep-dive surfaces.
-    if ! confirmation=$(get_bullets "$file" "Confirmation" 5 | strip_links | compact_join_bullets 110); then
+    # Confirmation: preserve every top-level item, ≤ 110 chars each, joined
+    # with "; " on one line for the routine-compliance scannable view.
+    if ! confirmation=$(get_bullets "$file" "Confirmation" 0 | strip_links | compact_join_bullets 110); then
         return 1
     fi
 
@@ -304,6 +346,15 @@ emit_entry() {
             badges="${badges} | **Supersedes:** ${superseded}"
         fi
         echo "${badges}"
+        if [ -n "$superseded_by" ] && [ "$superseded_by" != "[]" ]; then
+            echo "**Superseded-by:** ${superseded_by}"
+        fi
+        if [ -n "$amends" ] && [ "$amends" != "[]" ]; then
+            echo "**Amends:** ${amends}"
+        fi
+        if [ -n "$supplements" ] && [ "$supplements" != "[]" ]; then
+            echo "**Supplements:** ${supplements}"
+        fi
         if [ -n "$chosen" ]; then
             echo "**Chosen:** ${chosen}"
         fi