@bradygaster/squad-sdk 0.9.0 → 0.9.1

package/templates/skills/distributed-mesh/sync-mesh.ps1

@@ -1,111 +1,111 @@
-# sync-mesh.ps1 — Materialize remote squad state locally
-#
-# Reads mesh.json, fetches remote squads into local directories.
-# Run before agent reads. No daemon. No service. ~40 lines.
-#
-# Usage: .\sync-mesh.ps1 [path-to-mesh.json]
-#        .\sync-mesh.ps1 -Init [path-to-mesh.json]
-# Requires: git
-param(
-    [switch]$Init,
-    [string]$MeshJson = "mesh.json"
-)
-$ErrorActionPreference = "Stop"
-
-# Handle -Init mode
-if ($Init) {
-    if (-not (Test-Path $MeshJson)) {
-        Write-Host "❌ $MeshJson not found"
-        exit 1
-    }
-    
-    Write-Host "🚀 Initializing mesh state repository..."
-    $config = Get-Content $MeshJson -Raw | ConvertFrom-Json
-    $squads = $config.squads.PSObject.Properties.Name
-    
-    # Create squad directories with placeholder SUMMARY.md
-    foreach ($squad in $squads) {
-        if (-not (Test-Path $squad)) {
-            New-Item -ItemType Directory -Path $squad | Out-Null
-            Write-Host "  ✓ Created $squad/"
-        } else {
-            Write-Host "  • $squad/ exists (skipped)"
-        }
-        
-        $summaryPath = "$squad/SUMMARY.md"
-        if (-not (Test-Path $summaryPath)) {
-            "# $squad`n`n_No state published yet._" | Set-Content $summaryPath
-            Write-Host "  ✓ Created $summaryPath"
-        } else {
-            Write-Host "  • $summaryPath exists (skipped)"
-        }
-    }
-    
-    # Generate root README.md
-    if (-not (Test-Path "README.md")) {
-        $readme = @"
-# Squad Mesh State Repository
-
-This repository tracks published state from participating squads.
-
-## Participating Squads
-
-"@
-        foreach ($squad in $squads) {
-            $zone = $config.squads.$squad.zone
-            $readme += "- **$squad** (Zone: $zone)`n"
-        }
-        $readme += @"
-
-Each squad directory contains a ``SUMMARY.md`` with their latest published state.
-State is synchronized using ``sync-mesh.sh`` or ``sync-mesh.ps1``.
-"@
-        $readme | Set-Content "README.md"
-        Write-Host "  ✓ Created README.md"
-    } else {
-        Write-Host "  • README.md exists (skipped)"
-    }
-    
-    Write-Host ""
-    Write-Host "✅ Mesh state repository initialized"
-    exit 0
-}
-
-$config = Get-Content $MeshJson -Raw | ConvertFrom-Json
-
-# Zone 2: Remote-trusted — git clone/pull
-foreach ($entry in $config.squads.PSObject.Properties | Where-Object { $_.Value.zone -eq "remote-trusted" }) {
-    $squad  = $entry.Name
-    $source = $entry.Value.source
-    $ref    = if ($entry.Value.ref) { $entry.Value.ref } else { "main" }
-    $target = $entry.Value.sync_to
-
-    if (Test-Path "$target/.git") {
-        git -C $target pull --rebase --quiet 2>$null
-        if ($LASTEXITCODE -ne 0) { Write-Host "⚠ ${squad}: pull failed (using stale)" }
-    } else {
-        New-Item -ItemType Directory -Force -Path (Split-Path $target -Parent) | Out-Null
-        git clone --quiet --depth 1 --branch $ref $source $target 2>$null
-        if ($LASTEXITCODE -ne 0) { Write-Host "⚠ ${squad}: clone failed (unavailable)" }
-    }
-}
-
-# Zone 3: Remote-opaque — fetch published contracts
-foreach ($entry in $config.squads.PSObject.Properties | Where-Object { $_.Value.zone -eq "remote-opaque" }) {
-    $squad  = $entry.Name
-    $source = $entry.Value.source
-    $target = $entry.Value.sync_to
-    $auth   = $entry.Value.auth
-
-    New-Item -ItemType Directory -Force -Path $target | Out-Null
-    $params = @{ Uri = $source; OutFile = "$target/SUMMARY.md"; UseBasicParsing = $true }
-    if ($auth -eq "bearer") {
-        $tokenVar = ($squad.ToUpper() -replace '-', '_') + "_TOKEN"
-        $token = [Environment]::GetEnvironmentVariable($tokenVar)
-        if ($token) { $params.Headers = @{ Authorization = "Bearer $token" } }
-    }
-    try { Invoke-WebRequest @params -ErrorAction Stop }
-    catch { "# ${squad} — unavailable ($(Get-Date))" | Set-Content "$target/SUMMARY.md" }
-}
-
-Write-Host "✓ Mesh sync complete"
+# sync-mesh.ps1 — Materialize remote squad state locally
+#
+# Reads mesh.json, fetches remote squads into local directories.
+# Run before agent reads. No daemon. No service. ~40 lines.
+#
+# Usage: .\sync-mesh.ps1 [path-to-mesh.json]
+#        .\sync-mesh.ps1 -Init [path-to-mesh.json]
+# Requires: git
+param(
+    [switch]$Init,
+    [string]$MeshJson = "mesh.json"
+)
+$ErrorActionPreference = "Stop"
+
+# Handle -Init mode
+if ($Init) {
+    if (-not (Test-Path $MeshJson)) {
+        Write-Host "❌ $MeshJson not found"
+        exit 1
+    }
+    
+    Write-Host "🚀 Initializing mesh state repository..."
+    $config = Get-Content $MeshJson -Raw | ConvertFrom-Json
+    $squads = $config.squads.PSObject.Properties.Name
+    
+    # Create squad directories with placeholder SUMMARY.md
+    foreach ($squad in $squads) {
+        if (-not (Test-Path $squad)) {
+            New-Item -ItemType Directory -Path $squad | Out-Null
+            Write-Host "  ✓ Created $squad/"
+        } else {
+            Write-Host "  • $squad/ exists (skipped)"
+        }
+        
+        $summaryPath = "$squad/SUMMARY.md"
+        if (-not (Test-Path $summaryPath)) {
+            "# $squad`n`n_No state published yet._" | Set-Content $summaryPath
+            Write-Host "  ✓ Created $summaryPath"
+        } else {
+            Write-Host "  • $summaryPath exists (skipped)"
+        }
+    }
+    
+    # Generate root README.md
+    if (-not (Test-Path "README.md")) {
+        $readme = @"
+# Squad Mesh State Repository
+
+This repository tracks published state from participating squads.
+
+## Participating Squads
+
+"@
+        foreach ($squad in $squads) {
+            $zone = $config.squads.$squad.zone
+            $readme += "- **$squad** (Zone: $zone)`n"
+        }
+        $readme += @"
+
+Each squad directory contains a ``SUMMARY.md`` with their latest published state.
+State is synchronized using ``sync-mesh.sh`` or ``sync-mesh.ps1``.
+"@
+        $readme | Set-Content "README.md"
+        Write-Host "  ✓ Created README.md"
+    } else {
+        Write-Host "  • README.md exists (skipped)"
+    }
+    
+    Write-Host ""
+    Write-Host "✅ Mesh state repository initialized"
+    exit 0
+}
+
+$config = Get-Content $MeshJson -Raw | ConvertFrom-Json
+
+# Zone 2: Remote-trusted — git clone/pull
+foreach ($entry in $config.squads.PSObject.Properties | Where-Object { $_.Value.zone -eq "remote-trusted" }) {
+    $squad  = $entry.Name
+    $source = $entry.Value.source
+    $ref    = if ($entry.Value.ref) { $entry.Value.ref } else { "main" }
+    $target = $entry.Value.sync_to
+
+    if (Test-Path "$target/.git") {
+        git -C $target pull --rebase --quiet 2>$null
+        if ($LASTEXITCODE -ne 0) { Write-Host "⚠ ${squad}: pull failed (using stale)" }
+    } else {
+        New-Item -ItemType Directory -Force -Path (Split-Path $target -Parent) | Out-Null
+        git clone --quiet --depth 1 --branch $ref $source $target 2>$null
+        if ($LASTEXITCODE -ne 0) { Write-Host "⚠ ${squad}: clone failed (unavailable)" }
+    }
+}
+
+# Zone 3: Remote-opaque — fetch published contracts
+foreach ($entry in $config.squads.PSObject.Properties | Where-Object { $_.Value.zone -eq "remote-opaque" }) {
+    $squad  = $entry.Name
+    $source = $entry.Value.source
+    $target = $entry.Value.sync_to
+    $auth   = $entry.Value.auth
+
+    New-Item -ItemType Directory -Force -Path $target | Out-Null
+    $params = @{ Uri = $source; OutFile = "$target/SUMMARY.md"; UseBasicParsing = $true }
+    if ($auth -eq "bearer") {
+        $tokenVar = ($squad.ToUpper() -replace '-', '_') + "_TOKEN"
+        $token = [Environment]::GetEnvironmentVariable($tokenVar)
+        if ($token) { $params.Headers = @{ Authorization = "Bearer $token" } }
+    }
+    try { Invoke-WebRequest @params -ErrorAction Stop }
+    catch { "# ${squad} — unavailable ($(Get-Date))" | Set-Content "$target/SUMMARY.md" }
+}
+
+Write-Host "✓ Mesh sync complete"

package/templates/skills/distributed-mesh/sync-mesh.sh

@@ -1,104 +1,104 @@
-#!/bin/bash
-# sync-mesh.sh — Materialize remote squad state locally
-#
-# Reads mesh.json, fetches remote squads into local directories.
-# Run before agent reads. No daemon. No service. ~40 lines.
-#
-# Usage: ./sync-mesh.sh [path-to-mesh.json]
-#        ./sync-mesh.sh --init [path-to-mesh.json]
-# Requires: jq (https://github.com/jqlang/jq), git, curl
-
-set -euo pipefail
-
-# Handle --init mode
-if [ "${1:-}" = "--init" ]; then
-  MESH_JSON="${2:-mesh.json}"
-  
-  if [ ! -f "$MESH_JSON" ]; then
-    echo "❌ $MESH_JSON not found"
-    exit 1
-  fi
-  
-  echo "🚀 Initializing mesh state repository..."
-  squads=$(jq -r '.squads | keys[]' "$MESH_JSON")
-  
-  # Create squad directories with placeholder SUMMARY.md
-  for squad in $squads; do
-    if [ ! -d "$squad" ]; then
-      mkdir -p "$squad"
-      echo "  ✓ Created $squad/"
-    else
-      echo "  • $squad/ exists (skipped)"
-    fi
-    
-    if [ ! -f "$squad/SUMMARY.md" ]; then
-      echo -e "# $squad\n\n_No state published yet._" > "$squad/SUMMARY.md"
-      echo "  ✓ Created $squad/SUMMARY.md"
-    else
-      echo "  • $squad/SUMMARY.md exists (skipped)"
-    fi
-  done
-  
-  # Generate root README.md
-  if [ ! -f "README.md" ]; then
-    {
-      echo "# Squad Mesh State Repository"
-      echo ""
-      echo "This repository tracks published state from participating squads."
-      echo ""
-      echo "## Participating Squads"
-      echo ""
-      for squad in $squads; do
-        zone=$(jq -r ".squads.\"$squad\".zone" "$MESH_JSON")
-        echo "- **$squad** (Zone: $zone)"
-      done
-      echo ""
-      echo "Each squad directory contains a \`SUMMARY.md\` with their latest published state."
-      echo "State is synchronized using \`sync-mesh.sh\` or \`sync-mesh.ps1\`."
-    } > README.md
-    echo "  ✓ Created README.md"
-  else
-    echo "  • README.md exists (skipped)"
-  fi
-  
-  echo ""
-  echo "✅ Mesh state repository initialized"
-  exit 0
-fi
-
-MESH_JSON="${1:-mesh.json}"
-
-# Zone 2: Remote-trusted — git clone/pull
-for squad in $(jq -r '.squads | to_entries[] | select(.value.zone == "remote-trusted") | .key' "$MESH_JSON"); do
-  source=$(jq -r ".squads.\"$squad\".source" "$MESH_JSON")
-  ref=$(jq -r ".squads.\"$squad\".ref // \"main\"" "$MESH_JSON")
-  target=$(jq -r ".squads.\"$squad\".sync_to" "$MESH_JSON")
-
-  if [ -d "$target/.git" ]; then
-    git -C "$target" pull --rebase --quiet 2>/dev/null \
-      || echo "⚠ $squad: pull failed (using stale)"
-  else
-    mkdir -p "$(dirname "$target")"
-    git clone --quiet --depth 1 --branch "$ref" "$source" "$target" 2>/dev/null \
-      || echo "⚠ $squad: clone failed (unavailable)"
-  fi
-done
-
-# Zone 3: Remote-opaque — fetch published contracts
-for squad in $(jq -r '.squads | to_entries[] | select(.value.zone == "remote-opaque") | .key' "$MESH_JSON"); do
-  source=$(jq -r ".squads.\"$squad\".source" "$MESH_JSON")
-  target=$(jq -r ".squads.\"$squad\".sync_to" "$MESH_JSON")
-  auth=$(jq -r ".squads.\"$squad\".auth // \"\"" "$MESH_JSON")
-
-  mkdir -p "$target"
-  auth_flag=""
-  if [ "$auth" = "bearer" ]; then
-    token_var="$(echo "${squad}" | tr '[:lower:]-' '[:upper:]_')_TOKEN"
-    [ -n "${!token_var:-}" ] && auth_flag="--header \"Authorization: Bearer ${!token_var}\""
-  fi
-
-  eval curl --silent --fail $auth_flag "$source" -o "$target/SUMMARY.md" 2>/dev/null \
-    || echo "# ${squad} — unavailable ($(date))" > "$target/SUMMARY.md"
-done
-
-echo "✓ Mesh sync complete"
+#!/bin/bash
+# sync-mesh.sh — Materialize remote squad state locally
+#
+# Reads mesh.json, fetches remote squads into local directories.
+# Run before agent reads. No daemon. No service. ~40 lines.
+#
+# Usage: ./sync-mesh.sh [path-to-mesh.json]
+#        ./sync-mesh.sh --init [path-to-mesh.json]
+# Requires: jq (https://github.com/jqlang/jq), git, curl
+
+set -euo pipefail
+
+# Handle --init mode
+if [ "${1:-}" = "--init" ]; then
+  MESH_JSON="${2:-mesh.json}"
+  
+  if [ ! -f "$MESH_JSON" ]; then
+    echo "❌ $MESH_JSON not found"
+    exit 1
+  fi
+  
+  echo "🚀 Initializing mesh state repository..."
+  squads=$(jq -r '.squads | keys[]' "$MESH_JSON")
+  
+  # Create squad directories with placeholder SUMMARY.md
+  for squad in $squads; do
+    if [ ! -d "$squad" ]; then
+      mkdir -p "$squad"
+      echo "  ✓ Created $squad/"
+    else
+      echo "  • $squad/ exists (skipped)"
+    fi
+    
+    if [ ! -f "$squad/SUMMARY.md" ]; then
+      echo -e "# $squad\n\n_No state published yet._" > "$squad/SUMMARY.md"
+      echo "  ✓ Created $squad/SUMMARY.md"
+    else
+      echo "  • $squad/SUMMARY.md exists (skipped)"
+    fi
+  done
+  
+  # Generate root README.md
+  if [ ! -f "README.md" ]; then
+    {
+      echo "# Squad Mesh State Repository"
+      echo ""
+      echo "This repository tracks published state from participating squads."
+      echo ""
+      echo "## Participating Squads"
+      echo ""
+      for squad in $squads; do
+        zone=$(jq -r ".squads.\"$squad\".zone" "$MESH_JSON")
+        echo "- **$squad** (Zone: $zone)"
+      done
+      echo ""
+      echo "Each squad directory contains a \`SUMMARY.md\` with their latest published state."
+      echo "State is synchronized using \`sync-mesh.sh\` or \`sync-mesh.ps1\`."
+    } > README.md
+    echo "  ✓ Created README.md"
+  else
+    echo "  • README.md exists (skipped)"
+  fi
+  
+  echo ""
+  echo "✅ Mesh state repository initialized"
+  exit 0
+fi
+
+MESH_JSON="${1:-mesh.json}"
+
+# Zone 2: Remote-trusted — git clone/pull
+for squad in $(jq -r '.squads | to_entries[] | select(.value.zone == "remote-trusted") | .key' "$MESH_JSON"); do
+  source=$(jq -r ".squads.\"$squad\".source" "$MESH_JSON")
+  ref=$(jq -r ".squads.\"$squad\".ref // \"main\"" "$MESH_JSON")
+  target=$(jq -r ".squads.\"$squad\".sync_to" "$MESH_JSON")
+
+  if [ -d "$target/.git" ]; then
+    git -C "$target" pull --rebase --quiet 2>/dev/null \
+      || echo "⚠ $squad: pull failed (using stale)"
+  else
+    mkdir -p "$(dirname "$target")"
+    git clone --quiet --depth 1 --branch "$ref" "$source" "$target" 2>/dev/null \
+      || echo "⚠ $squad: clone failed (unavailable)"
+  fi
+done
+
+# Zone 3: Remote-opaque — fetch published contracts
+for squad in $(jq -r '.squads | to_entries[] | select(.value.zone == "remote-opaque") | .key' "$MESH_JSON"); do
+  source=$(jq -r ".squads.\"$squad\".source" "$MESH_JSON")
+  target=$(jq -r ".squads.\"$squad\".sync_to" "$MESH_JSON")
+  auth=$(jq -r ".squads.\"$squad\".auth // \"\"" "$MESH_JSON")
+
+  mkdir -p "$target"
+  auth_flag=""
+  if [ "$auth" = "bearer" ]; then
+    token_var="$(echo "${squad}" | tr '[:lower:]-' '[:upper:]_')_TOKEN"
+    [ -n "${!token_var:-}" ] && auth_flag="--header \"Authorization: Bearer ${!token_var}\""
+  fi
+
+  eval curl --silent --fail $auth_flag "$source" -o "$target/SUMMARY.md" 2>/dev/null \
+    || echo "# ${squad} — unavailable ($(date))" > "$target/SUMMARY.md"
+done
+
+echo "✓ Mesh sync complete"

package/templates/skills/docs-standards/SKILL.md

@@ -1,71 +1,71 @@
----
-name: "docs-standards"
-description: "Microsoft Style Guide + Squad-specific documentation patterns"
-domain: "documentation"
-confidence: "high"
-source: "earned (PAO charter, multiple doc PR reviews)"
----
-
-## Context
-
-Squad documentation follows the Microsoft Style Guide with Squad-specific conventions. Consistency across docs builds trust and improves discoverability.
-
-## Patterns
-
-### Microsoft Style Guide Rules
-- **Sentence-case headings:** "Getting started" not "Getting Started"
-- **Active voice:** "Run the command" not "The command should be run"
-- **Second person:** "You can configure..." not "Users can configure..."
-- **Present tense:** "The system routes..." not "The system will route..."
-- **No ampersands in prose:** "and" not "&" (except in code, brand names, or UI elements)
-
-### Squad Formatting Patterns
-- **Scannability first:** Paragraphs for narrative (3-4 sentences max), bullets for scannable lists, tables for structured data
-- **"Try this" prompts at top:** Start feature/scenario pages with practical prompts users can copy
-- **Experimental warnings:** Features in preview get callout at top
-- **Cross-references at bottom:** Related pages linked after main content
-
-### Structure
-- **Title (H1)** → **Warning/callout** → **Try this code** → **Overview** → **HR** → **Content (H2 sections)**
-
-### Test Sync Rule
-- **Always update test assertions:** When adding docs pages to `features/`, `scenarios/`, `guides/`, update corresponding `EXPECTED_*` arrays in `test/docs-build.test.ts` in the same commit
-
-## Examples
-
-✓ **Correct:**
-```markdown
-# Getting started with Squad
-
-> ⚠️ **Experimental:** This feature is in preview.
-
-Try this:
-\`\`\`bash
-squad init
-\`\`\`
-
-Squad helps you build AI teams...
-
----
-
-## Install Squad
-
-Run the following command...
-```
-
-✗ **Incorrect:**
-```markdown
-# Getting Started With Squad  // Title case
-
-Squad is a tool which will help users... // Third person, future tense
-
-You can install Squad with npm & configure it... // Ampersand in prose
-```
-
-## Anti-Patterns
-
-- Title-casing headings because "it looks nicer"
-- Writing in passive voice or third person
-- Long paragraphs of dense text (breaks scannability)
-- Adding doc pages without updating test assertions
-- Using ampersands outside code blocks
+---
+name: "docs-standards"
+description: "Microsoft Style Guide + Squad-specific documentation patterns"
+domain: "documentation"
+confidence: "high"
+source: "earned (PAO charter, multiple doc PR reviews)"
+---
+
+## Context
+
+Squad documentation follows the Microsoft Style Guide with Squad-specific conventions. Consistency across docs builds trust and improves discoverability.
+
+## Patterns
+
+### Microsoft Style Guide Rules
+- **Sentence-case headings:** "Getting started" not "Getting Started"
+- **Active voice:** "Run the command" not "The command should be run"
+- **Second person:** "You can configure..." not "Users can configure..."
+- **Present tense:** "The system routes..." not "The system will route..."
+- **No ampersands in prose:** "and" not "&" (except in code, brand names, or UI elements)
+
+### Squad Formatting Patterns
+- **Scannability first:** Paragraphs for narrative (3-4 sentences max), bullets for scannable lists, tables for structured data
+- **"Try this" prompts at top:** Start feature/scenario pages with practical prompts users can copy
+- **Experimental warnings:** Features in preview get callout at top
+- **Cross-references at bottom:** Related pages linked after main content
+
+### Structure
+- **Title (H1)** → **Warning/callout** → **Try this code** → **Overview** → **HR** → **Content (H2 sections)**
+
+### Test Sync Rule
+- **Always update test assertions:** When adding docs pages to `features/`, `scenarios/`, `guides/`, update corresponding `EXPECTED_*` arrays in `test/docs-build.test.ts` in the same commit
+
+## Examples
+
+✓ **Correct:**
+```markdown
+# Getting started with Squad
+
+> ⚠️ **Experimental:** This feature is in preview.
+
+Try this:
+\`\`\`bash
+squad init
+\`\`\`
+
+Squad helps you build AI teams...
+
+---
+
+## Install Squad
+
+Run the following command...
+```
+
+✗ **Incorrect:**
+```markdown
+# Getting Started With Squad  // Title case
+
+Squad is a tool which will help users... // Third person, future tense
+
+You can install Squad with npm & configure it... // Ampersand in prose
+```
+
+## Anti-Patterns
+
+- Title-casing headings because "it looks nicer"
+- Writing in passive voice or third person
+- Long paragraphs of dense text (breaks scannability)
+- Adding doc pages without updating test assertions
+- Using ampersands outside code blocks