@bradygaster/squad-sdk 0.9.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/README.md +296 -296
  2. package/dist/agents/history-shadow.js +30 -30
  3. package/dist/build/github-dist.js +42 -42
  4. package/dist/config/init.js +173 -173
  5. package/dist/sharing/consult.js +78 -78
  6. package/package.json +1 -1
  7. package/templates/casting/Futurama.json +9 -9
  8. package/templates/casting-history.json +4 -4
  9. package/templates/casting-policy.json +37 -37
  10. package/templates/casting-reference.md +104 -104
  11. package/templates/casting-registry.json +3 -3
  12. package/templates/ceremonies.md +41 -41
  13. package/templates/charter.md +53 -53
  14. package/templates/constraint-tracking.md +38 -38
  15. package/templates/cooperative-rate-limiting.md +229 -229
  16. package/templates/copilot-instructions.md +46 -46
  17. package/templates/history.md +10 -10
  18. package/templates/identity/now.md +9 -9
  19. package/templates/identity/wisdom.md +15 -15
  20. package/templates/issue-lifecycle.md +412 -412
  21. package/templates/keda-scaler.md +164 -164
  22. package/templates/machine-capabilities.md +74 -74
  23. package/templates/mcp-config.md +90 -90
  24. package/templates/multi-agent-format.md +28 -28
  25. package/templates/plugin-marketplace.md +49 -49
  26. package/templates/ralph-circuit-breaker.md +313 -313
  27. package/templates/raw-agent-output.md +37 -37
  28. package/templates/roster.md +60 -60
  29. package/templates/routing.md +39 -39
  30. package/templates/run-output.md +50 -50
  31. package/templates/schedule.json +19 -19
  32. package/templates/scribe-charter.md +119 -119
  33. package/templates/skill.md +24 -24
  34. package/templates/skills/agent-collaboration/SKILL.md +42 -42
  35. package/templates/skills/agent-conduct/SKILL.md +24 -24
  36. package/templates/skills/architectural-proposals/SKILL.md +151 -151
  37. package/templates/skills/ci-validation-gates/SKILL.md +84 -84
  38. package/templates/skills/cli-wiring/SKILL.md +47 -47
  39. package/templates/skills/client-compatibility/SKILL.md +89 -89
  40. package/templates/skills/cross-squad/SKILL.md +114 -114
  41. package/templates/skills/distributed-mesh/SKILL.md +287 -287
  42. package/templates/skills/distributed-mesh/mesh.json.example +30 -30
  43. package/templates/skills/distributed-mesh/sync-mesh.ps1 +111 -111
  44. package/templates/skills/distributed-mesh/sync-mesh.sh +104 -104
  45. package/templates/skills/docs-standards/SKILL.md +71 -71
  46. package/templates/skills/economy-mode/SKILL.md +114 -114
  47. package/templates/skills/external-comms/SKILL.md +329 -329
  48. package/templates/skills/gh-auth-isolation/SKILL.md +183 -183
  49. package/templates/skills/git-workflow/SKILL.md +204 -204
  50. package/templates/skills/github-multi-account/SKILL.md +95 -95
  51. package/templates/skills/history-hygiene/SKILL.md +36 -36
  52. package/templates/skills/humanizer/SKILL.md +105 -105
  53. package/templates/skills/init-mode/SKILL.md +102 -102
  54. package/templates/skills/model-selection/SKILL.md +117 -117
  55. package/templates/skills/nap/SKILL.md +24 -24
  56. package/templates/skills/personal-squad/SKILL.md +57 -57
  57. package/templates/skills/project-conventions/SKILL.md +56 -56
  58. package/templates/skills/release-process/SKILL.md +423 -423
  59. package/templates/skills/reskill/SKILL.md +92 -92
  60. package/templates/skills/reviewer-protocol/SKILL.md +79 -79
  61. package/templates/skills/secret-handling/SKILL.md +200 -200
  62. package/templates/skills/session-recovery/SKILL.md +155 -155
  63. package/templates/skills/squad-conventions/SKILL.md +69 -69
  64. package/templates/skills/test-discipline/SKILL.md +37 -37
  65. package/templates/skills/windows-compatibility/SKILL.md +74 -74
  66. package/templates/workflows/squad-ci.yml +24 -24
  67. package/templates/workflows/squad-docs.yml +54 -54
  68. package/templates/workflows/squad-heartbeat.yml +171 -171
  69. package/templates/workflows/squad-insider-release.yml +61 -61
  70. package/templates/workflows/squad-issue-assign.yml +161 -161
  71. package/templates/workflows/squad-label-enforce.yml +181 -181
  72. package/templates/workflows/squad-preview.yml +55 -55
  73. package/templates/workflows/squad-promote.yml +120 -120
  74. package/templates/workflows/squad-release.yml +77 -77
  75. package/templates/workflows/squad-triage.yml +260 -260
  76. package/templates/workflows/sync-squad-labels.yml +169 -169
@@ -1,169 +1,169 @@
1
- name: Sync Squad Labels
2
-
3
- on:
4
- push:
5
- paths:
6
- - '.squad/team.md'
7
- - '.ai-team/team.md'
8
- workflow_dispatch:
9
-
10
- permissions:
11
- issues: write
12
- contents: read
13
-
14
- jobs:
15
- sync-labels:
16
- runs-on: ubuntu-latest
17
- steps:
18
- - uses: actions/checkout@v4
19
-
20
- - name: Parse roster and sync labels
21
- uses: actions/github-script@v7
22
- with:
23
- script: |
24
- const fs = require('fs');
25
- let teamFile = '.squad/team.md';
26
- if (!fs.existsSync(teamFile)) {
27
- teamFile = '.ai-team/team.md';
28
- }
29
-
30
- if (!fs.existsSync(teamFile)) {
31
- core.info('No .squad/team.md or .ai-team/team.md found — skipping label sync');
32
- return;
33
- }
34
-
35
- const content = fs.readFileSync(teamFile, 'utf8');
36
- const lines = content.split('\n');
37
-
38
- // Parse the Members table for agent names
39
- const members = [];
40
- let inMembersTable = false;
41
- for (const line of lines) {
42
- if (line.match(/^##\s+(Members|Team Roster)/i)) {
43
- inMembersTable = true;
44
- continue;
45
- }
46
- if (inMembersTable && line.startsWith('## ')) {
47
- break;
48
- }
49
- if (inMembersTable && line.startsWith('|') && !line.includes('---') && !line.includes('Name')) {
50
- const cells = line.split('|').map(c => c.trim()).filter(Boolean);
51
- if (cells.length >= 2 && cells[0] !== 'Scribe') {
52
- members.push({
53
- name: cells[0],
54
- role: cells[1]
55
- });
56
- }
57
- }
58
- }
59
-
60
- core.info(`Found ${members.length} squad members: ${members.map(m => m.name).join(', ')}`);
61
-
62
- // Check if @copilot is on the team
63
- const hasCopilot = content.includes('🤖 Coding Agent');
64
-
65
- // Define label color palette for squad labels
66
- const SQUAD_COLOR = '9B8FCC';
67
- const MEMBER_COLOR = '9B8FCC';
68
- const COPILOT_COLOR = '10b981';
69
-
70
- // Define go: and release: labels (static)
71
- const GO_LABELS = [
72
- { name: 'go:yes', color: '0E8A16', description: 'Ready to implement' },
73
- { name: 'go:no', color: 'B60205', description: 'Not pursuing' },
74
- { name: 'go:needs-research', color: 'FBCA04', description: 'Needs investigation' }
75
- ];
76
-
77
- const RELEASE_LABELS = [
78
- { name: 'release:v0.4.0', color: '6B8EB5', description: 'Targeted for v0.4.0' },
79
- { name: 'release:v0.5.0', color: '6B8EB5', description: 'Targeted for v0.5.0' },
80
- { name: 'release:v0.6.0', color: '8B7DB5', description: 'Targeted for v0.6.0' },
81
- { name: 'release:v1.0.0', color: '8B7DB5', description: 'Targeted for v1.0.0' },
82
- { name: 'release:backlog', color: 'D4E5F7', description: 'Not yet targeted' }
83
- ];
84
-
85
- const TYPE_LABELS = [
86
- { name: 'type:feature', color: 'DDD1F2', description: 'New capability' },
87
- { name: 'type:bug', color: 'FF0422', description: 'Something broken' },
88
- { name: 'type:spike', color: 'F2DDD4', description: 'Research/investigation — produces a plan, not code' },
89
- { name: 'type:docs', color: 'D4E5F7', description: 'Documentation work' },
90
- { name: 'type:chore', color: 'D4E5F7', description: 'Maintenance, refactoring, cleanup' },
91
- { name: 'type:epic', color: 'CC4455', description: 'Parent issue that decomposes into sub-issues' }
92
- ];
93
-
94
- // High-signal labels — these MUST visually dominate all others
95
- const SIGNAL_LABELS = [
96
- { name: 'bug', color: 'FF0422', description: 'Something isn\'t working' },
97
- { name: 'feedback', color: '00E5FF', description: 'User feedback — high signal, needs attention' }
98
- ];
99
-
100
- const PRIORITY_LABELS = [
101
- { name: 'priority:p0', color: 'B60205', description: 'Blocking release' },
102
- { name: 'priority:p1', color: 'D93F0B', description: 'This sprint' },
103
- { name: 'priority:p2', color: 'FBCA04', description: 'Next sprint' }
104
- ];
105
-
106
- // Ensure the base "squad" triage label exists
107
- const labels = [
108
- { name: 'squad', color: SQUAD_COLOR, description: 'Squad triage inbox — Lead will assign to a member' }
109
- ];
110
-
111
- for (const member of members) {
112
- labels.push({
113
- name: `squad:${member.name.toLowerCase()}`,
114
- color: MEMBER_COLOR,
115
- description: `Assigned to ${member.name} (${member.role})`
116
- });
117
- }
118
-
119
- // Add @copilot label if coding agent is on the team
120
- if (hasCopilot) {
121
- labels.push({
122
- name: 'squad:copilot',
123
- color: COPILOT_COLOR,
124
- description: 'Assigned to @copilot (Coding Agent) for autonomous work'
125
- });
126
- }
127
-
128
- // Add go:, release:, type:, priority:, and high-signal labels
129
- labels.push(...GO_LABELS);
130
- labels.push(...RELEASE_LABELS);
131
- labels.push(...TYPE_LABELS);
132
- labels.push(...PRIORITY_LABELS);
133
- labels.push(...SIGNAL_LABELS);
134
-
135
- // Sync labels (create or update)
136
- for (const label of labels) {
137
- try {
138
- await github.rest.issues.getLabel({
139
- owner: context.repo.owner,
140
- repo: context.repo.repo,
141
- name: label.name
142
- });
143
- // Label exists — update it
144
- await github.rest.issues.updateLabel({
145
- owner: context.repo.owner,
146
- repo: context.repo.repo,
147
- name: label.name,
148
- color: label.color,
149
- description: label.description
150
- });
151
- core.info(`Updated label: ${label.name}`);
152
- } catch (err) {
153
- if (err.status === 404) {
154
- // Label doesn't exist — create it
155
- await github.rest.issues.createLabel({
156
- owner: context.repo.owner,
157
- repo: context.repo.repo,
158
- name: label.name,
159
- color: label.color,
160
- description: label.description
161
- });
162
- core.info(`Created label: ${label.name}`);
163
- } else {
164
- throw err;
165
- }
166
- }
167
- }
168
-
169
- core.info(`Label sync complete: ${labels.length} labels synced`);
1
+ name: Sync Squad Labels
2
+
3
+ on:
4
+ push:
5
+ paths:
6
+ - '.squad/team.md'
7
+ - '.ai-team/team.md'
8
+ workflow_dispatch:
9
+
10
+ permissions:
11
+ issues: write
12
+ contents: read
13
+
14
+ jobs:
15
+ sync-labels:
16
+ runs-on: ubuntu-latest
17
+ steps:
18
+ - uses: actions/checkout@v4
19
+
20
+ - name: Parse roster and sync labels
21
+ uses: actions/github-script@v7
22
+ with:
23
+ script: |
24
+ const fs = require('fs');
25
+ let teamFile = '.squad/team.md';
26
+ if (!fs.existsSync(teamFile)) {
27
+ teamFile = '.ai-team/team.md';
28
+ }
29
+
30
+ if (!fs.existsSync(teamFile)) {
31
+ core.info('No .squad/team.md or .ai-team/team.md found — skipping label sync');
32
+ return;
33
+ }
34
+
35
+ const content = fs.readFileSync(teamFile, 'utf8');
36
+ const lines = content.split('\n');
37
+
38
+ // Parse the Members table for agent names
39
+ const members = [];
40
+ let inMembersTable = false;
41
+ for (const line of lines) {
42
+ if (line.match(/^##\s+(Members|Team Roster)/i)) {
43
+ inMembersTable = true;
44
+ continue;
45
+ }
46
+ if (inMembersTable && line.startsWith('## ')) {
47
+ break;
48
+ }
49
+ if (inMembersTable && line.startsWith('|') && !line.includes('---') && !line.includes('Name')) {
50
+ const cells = line.split('|').map(c => c.trim()).filter(Boolean);
51
+ if (cells.length >= 2 && cells[0] !== 'Scribe') {
52
+ members.push({
53
+ name: cells[0],
54
+ role: cells[1]
55
+ });
56
+ }
57
+ }
58
+ }
59
+
60
+ core.info(`Found ${members.length} squad members: ${members.map(m => m.name).join(', ')}`);
61
+
62
+ // Check if @copilot is on the team
63
+ const hasCopilot = content.includes('🤖 Coding Agent');
64
+
65
+ // Define label color palette for squad labels
66
+ const SQUAD_COLOR = '9B8FCC';
67
+ const MEMBER_COLOR = '9B8FCC';
68
+ const COPILOT_COLOR = '10b981';
69
+
70
+ // Define go: and release: labels (static)
71
+ const GO_LABELS = [
72
+ { name: 'go:yes', color: '0E8A16', description: 'Ready to implement' },
73
+ { name: 'go:no', color: 'B60205', description: 'Not pursuing' },
74
+ { name: 'go:needs-research', color: 'FBCA04', description: 'Needs investigation' }
75
+ ];
76
+
77
+ const RELEASE_LABELS = [
78
+ { name: 'release:v0.4.0', color: '6B8EB5', description: 'Targeted for v0.4.0' },
79
+ { name: 'release:v0.5.0', color: '6B8EB5', description: 'Targeted for v0.5.0' },
80
+ { name: 'release:v0.6.0', color: '8B7DB5', description: 'Targeted for v0.6.0' },
81
+ { name: 'release:v1.0.0', color: '8B7DB5', description: 'Targeted for v1.0.0' },
82
+ { name: 'release:backlog', color: 'D4E5F7', description: 'Not yet targeted' }
83
+ ];
84
+
85
+ const TYPE_LABELS = [
86
+ { name: 'type:feature', color: 'DDD1F2', description: 'New capability' },
87
+ { name: 'type:bug', color: 'FF0422', description: 'Something broken' },
88
+ { name: 'type:spike', color: 'F2DDD4', description: 'Research/investigation — produces a plan, not code' },
89
+ { name: 'type:docs', color: 'D4E5F7', description: 'Documentation work' },
90
+ { name: 'type:chore', color: 'D4E5F7', description: 'Maintenance, refactoring, cleanup' },
91
+ { name: 'type:epic', color: 'CC4455', description: 'Parent issue that decomposes into sub-issues' }
92
+ ];
93
+
94
+ // High-signal labels — these MUST visually dominate all others
95
+ const SIGNAL_LABELS = [
96
+ { name: 'bug', color: 'FF0422', description: 'Something isn\'t working' },
97
+ { name: 'feedback', color: '00E5FF', description: 'User feedback — high signal, needs attention' }
98
+ ];
99
+
100
+ const PRIORITY_LABELS = [
101
+ { name: 'priority:p0', color: 'B60205', description: 'Blocking release' },
102
+ { name: 'priority:p1', color: 'D93F0B', description: 'This sprint' },
103
+ { name: 'priority:p2', color: 'FBCA04', description: 'Next sprint' }
104
+ ];
105
+
106
+ // Ensure the base "squad" triage label exists
107
+ const labels = [
108
+ { name: 'squad', color: SQUAD_COLOR, description: 'Squad triage inbox — Lead will assign to a member' }
109
+ ];
110
+
111
+ for (const member of members) {
112
+ labels.push({
113
+ name: `squad:${member.name.toLowerCase()}`,
114
+ color: MEMBER_COLOR,
115
+ description: `Assigned to ${member.name} (${member.role})`
116
+ });
117
+ }
118
+
119
+ // Add @copilot label if coding agent is on the team
120
+ if (hasCopilot) {
121
+ labels.push({
122
+ name: 'squad:copilot',
123
+ color: COPILOT_COLOR,
124
+ description: 'Assigned to @copilot (Coding Agent) for autonomous work'
125
+ });
126
+ }
127
+
128
+ // Add go:, release:, type:, priority:, and high-signal labels
129
+ labels.push(...GO_LABELS);
130
+ labels.push(...RELEASE_LABELS);
131
+ labels.push(...TYPE_LABELS);
132
+ labels.push(...PRIORITY_LABELS);
133
+ labels.push(...SIGNAL_LABELS);
134
+
135
+ // Sync labels (create or update)
136
+ for (const label of labels) {
137
+ try {
138
+ await github.rest.issues.getLabel({
139
+ owner: context.repo.owner,
140
+ repo: context.repo.repo,
141
+ name: label.name
142
+ });
143
+ // Label exists — update it
144
+ await github.rest.issues.updateLabel({
145
+ owner: context.repo.owner,
146
+ repo: context.repo.repo,
147
+ name: label.name,
148
+ color: label.color,
149
+ description: label.description
150
+ });
151
+ core.info(`Updated label: ${label.name}`);
152
+ } catch (err) {
153
+ if (err.status === 404) {
154
+ // Label doesn't exist — create it
155
+ await github.rest.issues.createLabel({
156
+ owner: context.repo.owner,
157
+ repo: context.repo.repo,
158
+ name: label.name,
159
+ color: label.color,
160
+ description: label.description
161
+ });
162
+ core.info(`Created label: ${label.name}`);
163
+ } else {
164
+ throw err;
165
+ }
166
+ }
167
+ }
168
+
169
+ core.info(`Label sync complete: ${labels.length} labels synced`);