@bradygaster/squad-sdk 0.8.20 → 0.8.21

package/templates/workflows/sync-squad-labels.yml

@@ -1,169 +1,169 @@
-name: Sync Squad Labels
-
-on:
-  push:
-    paths:
-      - '.squad/team.md'
-      - '.ai-team/team.md'
-  workflow_dispatch:
-
-permissions:
-  issues: write
-  contents: read
-
-jobs:
-  sync-labels:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Parse roster and sync labels
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const fs = require('fs');
-            let teamFile = '.squad/team.md';
-            if (!fs.existsSync(teamFile)) {
-              teamFile = '.ai-team/team.md';
-            }
-
-            if (!fs.existsSync(teamFile)) {
-              core.info('No .squad/team.md or .ai-team/team.md found — skipping label sync');
-              return;
-            }
-
-            const content = fs.readFileSync(teamFile, 'utf8');
-            const lines = content.split('\n');
-
-            // Parse the Members table for agent names
-            const members = [];
-            let inMembersTable = false;
-            for (const line of lines) {
-              if (line.match(/^##\s+(Members|Team Roster)/i)) {
-                inMembersTable = true;
-                continue;
-              }
-              if (inMembersTable && line.startsWith('## ')) {
-                break;
-              }
-              if (inMembersTable && line.startsWith('|') && !line.includes('---') && !line.includes('Name')) {
-                const cells = line.split('|').map(c => c.trim()).filter(Boolean);
-                if (cells.length >= 2 && cells[0] !== 'Scribe') {
-                  members.push({
-                    name: cells[0],
-                    role: cells[1]
-                  });
-                }
-              }
-            }
-
-            core.info(`Found ${members.length} squad members: ${members.map(m => m.name).join(', ')}`);
-
-            // Check if @copilot is on the team
-            const hasCopilot = content.includes('🤖 Coding Agent');
-
-            // Define label color palette for squad labels
-            const SQUAD_COLOR = '9B8FCC';
-            const MEMBER_COLOR = '9B8FCC';
-            const COPILOT_COLOR = '10b981';
-
-            // Define go: and release: labels (static)
-            const GO_LABELS = [
-              { name: 'go:yes', color: '0E8A16', description: 'Ready to implement' },
-              { name: 'go:no', color: 'B60205', description: 'Not pursuing' },
-              { name: 'go:needs-research', color: 'FBCA04', description: 'Needs investigation' }
-            ];
-
-            const RELEASE_LABELS = [
-              { name: 'release:v0.4.0', color: '6B8EB5', description: 'Targeted for v0.4.0' },
-              { name: 'release:v0.5.0', color: '6B8EB5', description: 'Targeted for v0.5.0' },
-              { name: 'release:v0.6.0', color: '8B7DB5', description: 'Targeted for v0.6.0' },
-              { name: 'release:v1.0.0', color: '8B7DB5', description: 'Targeted for v1.0.0' },
-              { name: 'release:backlog', color: 'D4E5F7', description: 'Not yet targeted' }
-            ];
-
-            const TYPE_LABELS = [
-              { name: 'type:feature', color: 'DDD1F2', description: 'New capability' },
-              { name: 'type:bug', color: 'FF0422', description: 'Something broken' },
-              { name: 'type:spike', color: 'F2DDD4', description: 'Research/investigation — produces a plan, not code' },
-              { name: 'type:docs', color: 'D4E5F7', description: 'Documentation work' },
-              { name: 'type:chore', color: 'D4E5F7', description: 'Maintenance, refactoring, cleanup' },
-              { name: 'type:epic', color: 'CC4455', description: 'Parent issue that decomposes into sub-issues' }
-            ];
-
-            // High-signal labels — these MUST visually dominate all others
-            const SIGNAL_LABELS = [
-              { name: 'bug', color: 'FF0422', description: 'Something isn\'t working' },
-              { name: 'feedback', color: '00E5FF', description: 'User feedback — high signal, needs attention' }
-            ];
-
-            const PRIORITY_LABELS = [
-              { name: 'priority:p0', color: 'B60205', description: 'Blocking release' },
-              { name: 'priority:p1', color: 'D93F0B', description: 'This sprint' },
-              { name: 'priority:p2', color: 'FBCA04', description: 'Next sprint' }
-            ];
-
-            // Ensure the base "squad" triage label exists
-            const labels = [
-              { name: 'squad', color: SQUAD_COLOR, description: 'Squad triage inbox — Lead will assign to a member' }
-            ];
-
-            for (const member of members) {
-              labels.push({
-                name: `squad:${member.name.toLowerCase()}`,
-                color: MEMBER_COLOR,
-                description: `Assigned to ${member.name} (${member.role})`
-              });
-            }
-
-            // Add @copilot label if coding agent is on the team
-            if (hasCopilot) {
-              labels.push({
-                name: 'squad:copilot',
-                color: COPILOT_COLOR,
-                description: 'Assigned to @copilot (Coding Agent) for autonomous work'
-              });
-            }
-
-            // Add go:, release:, type:, priority:, and high-signal labels
-            labels.push(...GO_LABELS);
-            labels.push(...RELEASE_LABELS);
-            labels.push(...TYPE_LABELS);
-            labels.push(...PRIORITY_LABELS);
-            labels.push(...SIGNAL_LABELS);
-
-            // Sync labels (create or update)
-            for (const label of labels) {
-              try {
-                await github.rest.issues.getLabel({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  name: label.name
-                });
-                // Label exists — update it
-                await github.rest.issues.updateLabel({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  name: label.name,
-                  color: label.color,
-                  description: label.description
-                });
-                core.info(`Updated label: ${label.name}`);
-              } catch (err) {
-                if (err.status === 404) {
-                  // Label doesn't exist — create it
-                  await github.rest.issues.createLabel({
-                    owner: context.repo.owner,
-                    repo: context.repo.repo,
-                    name: label.name,
-                    color: label.color,
-                    description: label.description
-                  });
-                  core.info(`Created label: ${label.name}`);
-                } else {
-                  throw err;
-                }
-              }
-            }
-
-            core.info(`Label sync complete: ${labels.length} labels synced`);
+name: Sync Squad Labels
+
+on:
+  push:
+    paths:
+      - '.squad/team.md'
+      - '.ai-team/team.md'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  sync-labels:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Parse roster and sync labels
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            let teamFile = '.squad/team.md';
+            if (!fs.existsSync(teamFile)) {
+              teamFile = '.ai-team/team.md';
+            }
+
+            if (!fs.existsSync(teamFile)) {
+              core.info('No .squad/team.md or .ai-team/team.md found — skipping label sync');
+              return;
+            }
+
+            const content = fs.readFileSync(teamFile, 'utf8');
+            const lines = content.split('\n');
+
+            // Parse the Members table for agent names
+            const members = [];
+            let inMembersTable = false;
+            for (const line of lines) {
+              if (line.match(/^##\s+(Members|Team Roster)/i)) {
+                inMembersTable = true;
+                continue;
+              }
+              if (inMembersTable && line.startsWith('## ')) {
+                break;
+              }
+              if (inMembersTable && line.startsWith('|') && !line.includes('---') && !line.includes('Name')) {
+                const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+                if (cells.length >= 2 && cells[0] !== 'Scribe') {
+                  members.push({
+                    name: cells[0],
+                    role: cells[1]
+                  });
+                }
+              }
+            }
+
+            core.info(`Found ${members.length} squad members: ${members.map(m => m.name).join(', ')}`);
+
+            // Check if @copilot is on the team
+            const hasCopilot = content.includes('🤖 Coding Agent');
+
+            // Define label color palette for squad labels
+            const SQUAD_COLOR = '9B8FCC';
+            const MEMBER_COLOR = '9B8FCC';
+            const COPILOT_COLOR = '10b981';
+
+            // Define go: and release: labels (static)
+            const GO_LABELS = [
+              { name: 'go:yes', color: '0E8A16', description: 'Ready to implement' },
+              { name: 'go:no', color: 'B60205', description: 'Not pursuing' },
+              { name: 'go:needs-research', color: 'FBCA04', description: 'Needs investigation' }
+            ];
+
+            const RELEASE_LABELS = [
+              { name: 'release:v0.4.0', color: '6B8EB5', description: 'Targeted for v0.4.0' },
+              { name: 'release:v0.5.0', color: '6B8EB5', description: 'Targeted for v0.5.0' },
+              { name: 'release:v0.6.0', color: '8B7DB5', description: 'Targeted for v0.6.0' },
+              { name: 'release:v1.0.0', color: '8B7DB5', description: 'Targeted for v1.0.0' },
+              { name: 'release:backlog', color: 'D4E5F7', description: 'Not yet targeted' }
+            ];
+
+            const TYPE_LABELS = [
+              { name: 'type:feature', color: 'DDD1F2', description: 'New capability' },
+              { name: 'type:bug', color: 'FF0422', description: 'Something broken' },
+              { name: 'type:spike', color: 'F2DDD4', description: 'Research/investigation — produces a plan, not code' },
+              { name: 'type:docs', color: 'D4E5F7', description: 'Documentation work' },
+              { name: 'type:chore', color: 'D4E5F7', description: 'Maintenance, refactoring, cleanup' },
+              { name: 'type:epic', color: 'CC4455', description: 'Parent issue that decomposes into sub-issues' }
+            ];
+
+            // High-signal labels — these MUST visually dominate all others
+            const SIGNAL_LABELS = [
+              { name: 'bug', color: 'FF0422', description: 'Something isn\'t working' },
+              { name: 'feedback', color: '00E5FF', description: 'User feedback — high signal, needs attention' }
+            ];
+
+            const PRIORITY_LABELS = [
+              { name: 'priority:p0', color: 'B60205', description: 'Blocking release' },
+              { name: 'priority:p1', color: 'D93F0B', description: 'This sprint' },
+              { name: 'priority:p2', color: 'FBCA04', description: 'Next sprint' }
+            ];
+
+            // Ensure the base "squad" triage label exists
+            const labels = [
+              { name: 'squad', color: SQUAD_COLOR, description: 'Squad triage inbox — Lead will assign to a member' }
+            ];
+
+            for (const member of members) {
+              labels.push({
+                name: `squad:${member.name.toLowerCase()}`,
+                color: MEMBER_COLOR,
+                description: `Assigned to ${member.name} (${member.role})`
+              });
+            }
+
+            // Add @copilot label if coding agent is on the team
+            if (hasCopilot) {
+              labels.push({
+                name: 'squad:copilot',
+                color: COPILOT_COLOR,
+                description: 'Assigned to @copilot (Coding Agent) for autonomous work'
+              });
+            }
+
+            // Add go:, release:, type:, priority:, and high-signal labels
+            labels.push(...GO_LABELS);
+            labels.push(...RELEASE_LABELS);
+            labels.push(...TYPE_LABELS);
+            labels.push(...PRIORITY_LABELS);
+            labels.push(...SIGNAL_LABELS);
+
+            // Sync labels (create or update)
+            for (const label of labels) {
+              try {
+                await github.rest.issues.getLabel({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  name: label.name
+                });
+                // Label exists — update it
+                await github.rest.issues.updateLabel({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  name: label.name,
+                  color: label.color,
+                  description: label.description
+                });
+                core.info(`Updated label: ${label.name}`);
+              } catch (err) {
+                if (err.status === 404) {
+                  // Label doesn't exist — create it
+                  await github.rest.issues.createLabel({
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    name: label.name,
+                    color: label.color,
+                    description: label.description
+                  });
+                  core.info(`Created label: ${label.name}`);
+                } else {
+                  throw err;
+                }
+              }
+            }
+
+            core.info(`Label sync complete: ${labels.length} labels synced`);

package/dist/runtime/event-bus-otel-bridge.d.ts

@@ -1,19 +0,0 @@
-/**
- * EventBus → OTel Span Bridge (Issue #304)
- *
- * Subscribes to EventBus events and creates OpenTelemetry spans for each.
- * Complements the existing otel-bridge.ts which handles TelemetryEvent
- * (dot-separated names like squad.init). This bridge handles runtime
- * SquadEvent types (colon-separated like session:created).
- *
- * @module runtime/event-bus-otel-bridge
- */
-import type { EventBus, UnsubscribeFn } from './event-bus.js';
-/**
- * Attach an OTel span bridge to an EventBus.
- * Every event emitted on the bus produces a corresponding OTel span.
- *
- * @returns Unsubscribe function to detach the bridge.
- */
-export declare function attachOTelBridge(bus: EventBus): UnsubscribeFn;
-//# sourceMappingURL=event-bus-otel-bridge.d.ts.map

package/dist/runtime/event-bus-otel-bridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-bus-otel-bridge.d.ts","sourceRoot":"","sources":["../../src/runtime/event-bus-otel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAc,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG1E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,CAuC7D"}

package/dist/runtime/event-bus-otel-bridge.js

@@ -1,61 +0,0 @@
-/**
- * EventBus → OTel Span Bridge (Issue #304)
- *
- * Subscribes to EventBus events and creates OpenTelemetry spans for each.
- * Complements the existing otel-bridge.ts which handles TelemetryEvent
- * (dot-separated names like squad.init). This bridge handles runtime
- * SquadEvent types (colon-separated like session:created).
- *
- * @module runtime/event-bus-otel-bridge
- */
-import { SpanStatusCode } from '@opentelemetry/api';
-import { getTracer } from './otel.js';
-import { isSquadEventOfType } from './event-payloads.js';
-/**
- * Attach an OTel span bridge to an EventBus.
- * Every event emitted on the bus produces a corresponding OTel span.
- *
- * @returns Unsubscribe function to detach the bridge.
- */
-export function attachOTelBridge(bus) {
-    return bus.subscribeAll((event) => {
-        const tracer = getTracer('squad-sdk');
-        const spanName = `squad.event.${event.type.replace(':', '.')}`;
-        const attrs = {
-            'squad.event.type': event.type,
-        };
-        if (event.sessionId)
-            attrs['squad.session.id'] = event.sessionId;
-        if (event.agentName)
-            attrs['squad.agent.name'] = event.agentName;
-        // Extract payload attributes for known event types
-        if (isSquadEventOfType(event, 'session:error')) {
-            attrs['squad.error'] = event.payload.error;
-            attrs['squad.error.agent'] = event.payload.agentName;
-        }
-        else if (isSquadEventOfType(event, 'session:tool_call')) {
-            attrs['squad.tool.name'] = event.payload.toolName;
-            if (event.payload.resultType) {
-                attrs['squad.tool.result'] = event.payload.resultType;
-            }
-        }
-        else if (isSquadEventOfType(event, 'coordinator:routing')) {
-            attrs['squad.routing.phase'] = event.payload.phase;
-        }
-        else if (isSquadEventOfType(event, 'agent:milestone')) {
-            attrs['squad.milestone.event'] = event.payload.event;
-            attrs['squad.milestone.agent'] = event.payload.agentName;
-        }
-        else if (isSquadEventOfType(event, 'pool:health')) {
-            attrs['squad.pool.active'] = event.payload.activeSessions;
-            attrs['squad.pool.available'] = event.payload.availableSlots;
-            attrs['squad.pool.queued'] = event.payload.queuedRequests;
-        }
-        const span = tracer.startSpan(spanName, { attributes: attrs });
-        if (event.type === 'session:error') {
-            span.setStatus({ code: SpanStatusCode.ERROR });
-        }
-        span.end();
-    });
-}
-//# sourceMappingURL=event-bus-otel-bridge.js.map

package/dist/runtime/event-bus-otel-bridge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-bus-otel-bridge.js","sourceRoot":"","sources":["../../src/runtime/event-bus-otel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAa;IAC5C,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC,KAAiB,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,eAAe,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAE/D,MAAM,KAAK,GAA8C;YACvD,kBAAkB,EAAE,KAAK,CAAC,IAAI;SAC/B,CAAC;QACF,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QACjE,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QAEjE,mDAAmD;QACnD,IAAI,kBAAkB,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC3C,KAAK,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACvD,CAAC;aAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAClD,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC7B,KAAK,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,qBAAqB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrD,CAAC;aAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,uBAAuB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrD,KAAK,CAAC,uBAAuB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAC3D,CAAC;aAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;YAC1D,KAAK,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;YAC7D,KAAK,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAE/D,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC"}

package/templates/workflows/squad-main-guard.yml

@@ -1,129 +0,0 @@
-name: Squad Protected Branch Guard
-
-on:
-  pull_request:
-    branches: [main, preview, insider]
-    types: [opened, synchronize, reopened]
-  push:
-    branches: [main, preview, insider]
-
-permissions:
-  contents: read
-  pull-requests: read
-
-jobs:
-  guard:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check for forbidden paths
-        uses: actions/github-script@v7
-        with:
-          script: |
-            // Fetch all files changed - handles both PR and push events
-            let files = [];
-            
-            if (context.eventName === 'pull_request') {
-              // PR event: use pulls.listFiles API
-              let page = 1;
-              while (true) {
-                const resp = await github.rest.pulls.listFiles({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  pull_number: context.payload.pull_request.number,
-                  per_page: 100,
-                  page
-                });
-                files.push(...resp.data);
-                if (resp.data.length < 100) break;
-                page++;
-              }
-            } else if (context.eventName === 'push') {
-              // Push event: compare against base branch
-              const base = context.payload.before;
-              const head = context.payload.after;
-              
-              // If this is not a force push and base exists, compare commits
-              if (base && base !== '0000000000000000000000000000000000000000') {
-                const comparison = await github.rest.repos.compareCommits({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  base,
-                  head
-                });
-                files = comparison.data.files || [];
-              } else {
-                // Force push or initial commit: list all files in the current tree
-                core.info('Force push detected or initial commit, checking tree state');
-                const { data: tree } = await github.rest.git.getTree({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  tree_sha: head,
-                  recursive: 'true'
-                });
-                files = tree.tree
-                  .filter(item => item.type === 'blob')
-                  .map(item => ({ filename: item.path, status: 'added' }));
-              }
-            }
-
-            // Check each file against forbidden path rules
-            // Allow removals — deleting forbidden files from protected branches is fine
-            const forbidden = files
-              .filter(f => f.status !== 'removed')
-              .map(f => f.filename)
-              .filter(f => {
-                // .ai-team/** and .squad/** — ALL team state files, zero exceptions
-                if (f === '.ai-team' || f.startsWith('.ai-team/') || f === '.squad' || f.startsWith('.squad/')) return true;
-                // .ai-team-templates/** — Squad's own templates, stay on dev
-                if (f === '.ai-team-templates' || f.startsWith('.ai-team-templates/')) return true;
-                // team-docs/** — ALL internal team docs, zero exceptions
-                if (f.startsWith('team-docs/')) return true;
-                // docs/proposals/** — internal design proposals, stay on dev
-                if (f.startsWith('docs/proposals/')) return true;
-                return false;
-              });
-
-            if (forbidden.length === 0) {
-              core.info('✅ No forbidden paths found in PR — all clear.');
-              return;
-            }
-
-            // Build a clear, actionable error message
-            const lines = [
-              '## 🚫 Forbidden files detected in PR to main',
-              '',
-              'The following files must NOT be merged into `main`.',
-              '`.ai-team/` and `.squad/` are runtime team state — they belong on dev branches only.',
-              '`.ai-team-templates/` is Squad\'s internal planning — it belongs on dev branches only.',
-              '`team-docs/` is internal team content — it belongs on dev branches only.',
-              '`docs/proposals/` is internal design proposals — it belongs on dev branches only.',
-              '',
-              '### Forbidden files found:',
-              '',
-              ...forbidden.map(f => `- \`${f}\``),
-              '',
-              '### How to fix:',
-              '',
-              '```bash',
-              '# Remove tracked .ai-team/ files (keeps local copies):',
-              'git rm --cached -r .ai-team/',
-              '',
-              '# Remove tracked .squad/ files (keeps local copies):',
-              'git rm --cached -r .squad/',
-              '',
-              '# Remove tracked team-docs/ files:',
-              'git rm --cached -r team-docs/',
-              '',
-              '# Commit the removal and push:',
-              'git commit -m "chore: remove forbidden paths from PR"',
-              'git push',
-              '```',
-              '',
-              '> ⚠️ `.ai-team/` and `.squad/` are committed on `dev` and feature branches by design.',
-              '> The guard workflow is the enforcement mechanism that keeps these files off `main` and `preview`.',
-              '> `git rm --cached` untracks them from this PR without deleting your local copies.',
-            ];
-
-            core.setFailed(lines.join('\n'));