@bradygaster/squad-cli 0.8.5 → 0.8.17-preview

package/templates/scribe-charter.md

@@ -22,7 +22,7 @@
 
 After every substantial work session:
 
-1. **Log the session** to `.squad/log/{timestamp}-{topic}.md`:
+1. **Log the session** to `.squad/log/{timestamp}-{topic}.md` (use filename-safe timestamps — replace colons with hyphens, e.g., `2026-02-23T20-16-27Z` not `2026-02-23T20:16:27Z`, for Windows compatibility):
    - Who worked
    - What was done
    - Decisions made

package/templates/squad.agent.md

@@ -717,8 +717,8 @@ prompt: |
   SPAWN MANIFEST: {spawn_manifest}
 
   Tasks (in order):
-  1. ORCHESTRATION LOG: Write .squad/orchestration-log/{timestamp}-{agent}.md per agent. Use ISO 8601 UTC timestamp.
-  2. SESSION LOG: Write .squad/log/{timestamp}-{topic}.md. Brief. Use ISO 8601 UTC timestamp.
+  1. ORCHESTRATION LOG: Write .squad/orchestration-log/{timestamp}-{agent}.md per agent. Use filename-safe ISO 8601 UTC timestamp (replace colons with hyphens, e.g., `2026-02-23T20-16-27Z` not `2026-02-23T20:16:27Z`).
+  2. SESSION LOG: Write .squad/log/{timestamp}-{topic}.md. Brief. Use filename-safe ISO 8601 UTC timestamp (replace colons with hyphens, e.g., `2026-02-23T20-16-27Z`).
   3. DECISION INBOX: Merge .squad/decisions/inbox/ → decisions.md, delete inbox files. Deduplicate.
   4. CROSS-AGENT: Append team updates to affected agents' history.md.
   5. DECISIONS ARCHIVE: If decisions.md exceeds ~20KB, archive entries older than 30 days to decisions-archive.md.
@@ -951,7 +951,7 @@ Ralph is a built-in squad member whose job is keeping tabs on work. **Ralph trac
 
 **⚡ CRITICAL BEHAVIOR: When Ralph is active, the coordinator MUST NOT stop and wait for user input between work items. Ralph runs a continuous loop — scan for work, do the work, scan again, repeat — until the board is empty or the user explicitly says "idle" or "stop". This is not optional. If work exists, keep going. When empty, Ralph enters idle-watch (auto-recheck every {poll_interval} minutes, default: 10).**
 
-**Between checks:** Ralph's in-session loop runs while work exists. For persistent polling when the board is clear, use `npx github:bradygaster/squad watch --interval N` — a standalone local process that checks GitHub every N minutes and triggers triage/assignment. See [Watch Mode](#watch-mode-squad-watch).
+**Between checks:** Ralph's in-session loop runs while work exists. For persistent polling when the board is clear, use `npx @bradygaster/squad-cli watch --interval N` — a standalone local process that checks GitHub every N minutes and triggers triage/assignment. See [Watch Mode](#watch-mode-squad-watch).
 
 **On-demand reference:** Read `.squad/templates/ralph-reference.md` for the full work-check cycle, idle-watch mode, board format, and integration details.
 
@@ -1001,7 +1001,7 @@ gh pr list --state open --draft --json number,title,author,labels,checks --limit
 | **Review feedback** | PR has `CHANGES_REQUESTED` review | Route feedback to PR author agent to address |
 | **CI failures** | PR checks failing | Notify assigned agent to fix, or create a fix issue |
 | **Approved PRs** | PR approved, CI green, ready to merge | Merge and close related issue |
-| **No work found** | All clear | Report: "📋 Board is clear. Ralph is idling." Suggest `npx github:bradygaster/squad watch` for persistent polling. |
+| **No work found** | All clear | Report: "📋 Board is clear. Ralph is idling." Suggest `npx @bradygaster/squad-cli watch` for persistent polling. |
 
 **Step 3 — Act on highest-priority item:**
 - Process one category at a time, highest priority first (untriaged > assigned > CI failures > review feedback > approved PRs)
@@ -1027,9 +1027,9 @@ After every 3-5 rounds, pause and report before continuing:
 Ralph's in-session loop processes work while it exists, then idles. For **persistent polling** between sessions or when you're away from the keyboard, use the `squad watch` CLI command:
 
 ```bash
-npx github:bradygaster/squad watch                    # polls every 10 minutes (default)
-npx github:bradygaster/squad watch --interval 5       # polls every 5 minutes
-npx github:bradygaster/squad watch --interval 30      # polls every 30 minutes
+npx @bradygaster/squad-cli watch                    # polls every 10 minutes (default)
+npx @bradygaster/squad-cli watch --interval 5       # polls every 5 minutes
+npx @bradygaster/squad-cli watch --interval 30      # polls every 30 minutes
 ```
 
 This runs as a standalone local process (not inside Copilot) that:
@@ -1043,7 +1043,7 @@ This runs as a standalone local process (not inside Copilot) that:
 | Layer | When | How |
 |-------|------|-----|
 | **In-session** | You're at the keyboard | "Ralph, go" — active loop while work exists |
-| **Local watchdog** | You're away but machine is on | `npx github:bradygaster/squad watch --interval 10` |
+| **Local watchdog** | You're away but machine is on | `npx @bradygaster/squad-cli watch --interval 10` |
 | **Cloud heartbeat** | Fully unattended | `squad-heartbeat.yml` GitHub Actions cron |
 
 ### Ralph State
@@ -1079,9 +1079,9 @@ After the coordinator's step 6 ("Immediately assess: Does anything trigger follo
 3. Follow-up work assessed → more agents if needed
 4. Ralph scans GitHub again (Step 1) → IMMEDIATELY, no pause
 5. More work found → repeat from step 2
-6. No more work → "📋 Board is clear. Ralph is idling." (suggest `npx github:bradygaster/squad watch` for persistent polling)
+6. No more work → "📋 Board is clear. Ralph is idling." (suggest `npx @bradygaster/squad-cli watch` for persistent polling)
 
-**Ralph does NOT ask "should I continue?" — Ralph KEEPS GOING.** Only stops on explicit "idle"/"stop" or session end. A clear board → idle-watch, not full stop. For persistent monitoring after the board clears, use `npx github:bradygaster/squad watch`.
+**Ralph does NOT ask "should I continue?" — Ralph KEEPS GOING.** Only stops on explicit "idle"/"stop" or session end. A clear board → idle-watch, not full stop. For persistent monitoring after the board clears, use `npx @bradygaster/squad-cli watch`.
 
 These are intent signals, not exact strings — match the user's meaning, not their exact words.
 

package/templates/workflows/squad-heartbeat.yml

@@ -1,4 +1,10 @@
 name: Squad Heartbeat (Ralph)
+# ⚠️ SYNC: This workflow is maintained in 4 locations. Changes must be applied to all:
+#   - templates/workflows/squad-heartbeat.yml (source template)
+#   - packages/squad-cli/templates/workflows/squad-heartbeat.yml (CLI package)
+#   - .squad-templates/workflows/squad-heartbeat.yml (installed template)
+#   - .github/workflows/squad-heartbeat.yml (active workflow)
+# Run 'squad upgrade' to sync installed copies from source templates.
 
 on:
   schedule:
@@ -25,225 +31,75 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Ralph — Check for squad work
+      - name: Check triage script
+        id: check-script
+        run: |
+          if [ -f ".squad-templates/ralph-triage.js" ]; then
+            echo "has_script=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_script=false" >> $GITHUB_OUTPUT
+            echo "⚠️ ralph-triage.js not found — run 'squad upgrade' to install"
+          fi
+
+      - name: Ralph — Smart triage
+        if: steps.check-script.outputs.has_script == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          node .squad-templates/ralph-triage.js \
+            --squad-dir .squad \
+            --output triage-results.json
+
+      - name: Ralph — Apply triage decisions
+        if: steps.check-script.outputs.has_script == 'true' && hashFiles('triage-results.json') != ''
         uses: actions/github-script@v7
         with:
           script: |
             const fs = require('fs');
-
-            // Read team roster — check .squad/ first, fall back to .ai-team/
-            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 — Ralph has nothing to monitor');
+            const path = 'triage-results.json';
+            if (!fs.existsSync(path)) {
+              core.info('No triage results — board is clear');
               return;
             }
-
-            const content = fs.readFileSync(teamFile, 'utf8');
-
-            // Check if Ralph is on the roster
-            if (!content.includes('Ralph') || !content.includes('🔄')) {
-              core.info('Ralph not on roster — heartbeat disabled');
+            
+            const results = JSON.parse(fs.readFileSync(path, 'utf8'));
+            if (results.length === 0) {
+              core.info('📋 Board is clear — Ralph found no untriaged issues');
               return;
             }
-
-            // Parse members from roster
-            const lines = content.split('\n');
-            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 && !['Scribe', 'Ralph'].includes(cells[0])) {
-                  members.push({
-                    name: cells[0],
-                    role: cells[1],
-                    label: `squad:${cells[0].toLowerCase()}`
-                  });
-                }
-              }
-            }
-
-            if (members.length === 0) {
-              core.info('No squad members found — nothing to monitor');
-              return;
-            }
-
-            // 1. Find untriaged issues (labeled "squad" but no "squad:{member}" label)
-            const { data: squadIssues } = await github.rest.issues.listForRepo({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              labels: 'squad',
-              state: 'open',
-              per_page: 20
-            });
-
-            const memberLabels = members.map(m => m.label);
-            const untriaged = squadIssues.filter(issue => {
-              const issueLabels = issue.labels.map(l => l.name);
-              return !memberLabels.some(ml => issueLabels.includes(ml));
-            });
-
-            // 2. Find assigned but unstarted issues (has squad:{member} label, no assignee)
-            const unstarted = [];
-            for (const member of members) {
+            
+            for (const decision of results) {
               try {
-                const { data: memberIssues } = await github.rest.issues.listForRepo({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  labels: member.label,
-                  state: 'open',
-                  per_page: 10
-                });
-                for (const issue of memberIssues) {
-                  if (!issue.assignees || issue.assignees.length === 0) {
-                    unstarted.push({ issue, member });
-                  }
-                }
-              } catch (e) {
-                // Label may not exist yet
-              }
-            }
-
-            // 3. Find squad issues missing triage verdict (no go:* label)
-            const missingVerdict = squadIssues.filter(issue => {
-              const labels = issue.labels.map(l => l.name);
-              return !labels.some(l => l.startsWith('go:'));
-            });
-
-            // 4. Find go:yes issues missing release target
-            const goYesIssues = squadIssues.filter(issue => {
-              const labels = issue.labels.map(l => l.name);
-              return labels.includes('go:yes') && !labels.some(l => l.startsWith('release:'));
-            });
-
-            // 4b. Find issues missing type: label
-            const missingType = squadIssues.filter(issue => {
-              const labels = issue.labels.map(l => l.name);
-              return !labels.some(l => l.startsWith('type:'));
-            });
-
-            // 5. Find open PRs that need attention
-            const { data: openPRs } = await github.rest.pulls.list({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              state: 'open',
-              per_page: 20
-            });
-
-            const squadPRs = openPRs.filter(pr =>
-              pr.labels.some(l => l.name.startsWith('squad'))
-            );
-
-            // Build status summary
-            const summary = [];
-            if (untriaged.length > 0) {
-              summary.push(`🔴 **${untriaged.length} untriaged issue(s)** need triage`);
-            }
-            if (unstarted.length > 0) {
-              summary.push(`🟡 **${unstarted.length} assigned issue(s)** have no assignee`);
-            }
-            if (missingVerdict.length > 0) {
-              summary.push(`⚪ **${missingVerdict.length} issue(s)** missing triage verdict (no \`go:\` label)`);
-            }
-            if (goYesIssues.length > 0) {
-              summary.push(`⚪ **${goYesIssues.length} approved issue(s)** missing release target (no \`release:\` label)`);
-            }
-            if (missingType.length > 0) {
-              summary.push(`⚪ **${missingType.length} issue(s)** missing \`type:\` label`);
-            }
-            if (squadPRs.length > 0) {
-              const drafts = squadPRs.filter(pr => pr.draft).length;
-              const ready = squadPRs.length - drafts;
-              if (drafts > 0) summary.push(`🟡 **${drafts} draft PR(s)** in progress`);
-              if (ready > 0) summary.push(`🟢 **${ready} PR(s)** open for review/merge`);
-            }
-
-            if (summary.length === 0) {
-              core.info('📋 Board is clear — Ralph found no pending work');
-              return;
-            }
-
-            core.info(`🔄 Ralph found work:\n${summary.join('\n')}`);
-
-            // Auto-triage untriaged issues
-            for (const issue of untriaged) {
-              const issueText = `${issue.title}\n${issue.body || ''}`.toLowerCase();
-              let assignedMember = null;
-              let reason = '';
-
-              // Simple keyword-based routing
-              for (const member of members) {
-                const role = member.role.toLowerCase();
-                if ((role.includes('frontend') || role.includes('ui')) &&
-                    (issueText.includes('ui') || issueText.includes('frontend') ||
-                     issueText.includes('css') || issueText.includes('component'))) {
-                  assignedMember = member;
-                  reason = 'Matches frontend/UI domain';
-                  break;
-                }
-                if ((role.includes('backend') || role.includes('api') || role.includes('server')) &&
-                    (issueText.includes('api') || issueText.includes('backend') ||
-                     issueText.includes('database') || issueText.includes('endpoint'))) {
-                  assignedMember = member;
-                  reason = 'Matches backend/API domain';
-                  break;
-                }
-                if ((role.includes('test') || role.includes('qa')) &&
-                    (issueText.includes('test') || issueText.includes('bug') ||
-                     issueText.includes('fix') || issueText.includes('regression'))) {
-                  assignedMember = member;
-                  reason = 'Matches testing/QA domain';
-                  break;
-                }
-              }
-
-              // Default to Lead
-              if (!assignedMember) {
-                const lead = members.find(m =>
-                  m.role.toLowerCase().includes('lead') ||
-                  m.role.toLowerCase().includes('architect')
-                );
-                if (lead) {
-                  assignedMember = lead;
-                  reason = 'No domain match — routed to Lead';
-                }
-              }
-
-              if (assignedMember) {
-                // Add member label
                 await github.rest.issues.addLabels({
                   owner: context.repo.owner,
                   repo: context.repo.repo,
-                  issue_number: issue.number,
-                  labels: [assignedMember.label]
+                  issue_number: decision.issueNumber,
+                  labels: [decision.label]
                 });
-
-                // Post triage comment
+                
                 await github.rest.issues.createComment({
                   owner: context.repo.owner,
                   repo: context.repo.repo,
-                  issue_number: issue.number,
+                  issue_number: decision.issueNumber,
                   body: [
-                    `### 🔄 Ralph — Auto-Triage`,
+                    '### 🔄 Ralph — Auto-Triage',
                     '',
-                    `**Assigned to:** ${assignedMember.name} (${assignedMember.role})`,
-                    `**Reason:** ${reason}`,
+                    `**Assigned to:** ${decision.assignTo}`,
+                    `**Reason:** ${decision.reason}`,
+                    `**Source:** ${decision.source}`,
                     '',
-                    `> Ralph auto-triaged this issue via the squad heartbeat. To reassign, swap the \`squad:*\` label.`
+                    '> Ralph auto-triaged this issue using routing rules.',
+                    '> To reassign, swap the `squad:*` label.'
                   ].join('\n')
                 });
-
-                core.info(`Auto-triaged #${issue.number} → ${assignedMember.name}`);
+                
+                core.info(`Triaged #${decision.issueNumber} → ${decision.assignTo} (${decision.source})`);
+              } catch (e) {
+                core.warning(`Failed to triage #${decision.issueNumber}: ${e.message}`);
               }
             }
+            
+            core.info(`🔄 Ralph triaged ${results.length} issue(s)`);
 
       # Copilot auto-assign step (uses PAT if available)
       - name: Ralph — Assign @copilot issues

package/templates/workflows/squad-insider-release.yml

@@ -50,7 +50,7 @@ jobs:
         run: |
           gh release create "${{ steps.version.outputs.insider_tag }}" \
             --title "${{ steps.version.outputs.insider_tag }}" \
-            --notes "This is an insider/development build of Squad. Install with:\`\`\`bash\nnpx github:bradygaster/squad#${{ steps.version.outputs.insider_tag }}\n\`\`\`\n\n**Note:** Insider builds may be unstable and are intended for early adopters and testing only." \
+            --notes "This is an insider/development build of Squad. Install with:\`\`\`bash\nnpm install -g @bradygaster/squad-cli@${{ steps.version.outputs.insider_tag }}\n\`\`\`\n\n**Note:** Insider builds may be unstable and are intended for early adopters and testing only." \
             --prerelease
 
       - name: Verify release