create-agentic-pdlc 2.2.1 → 2.4.0

package/templates/.github/workflows/agent-trigger.yml

@@ -17,13 +17,13 @@ jobs:
       pull-requests: write
       contents: read
     env:
-      PROJECT_PAT: ${{ secrets.PROJECT_PAT }}
+      PROJECT_TOKEN: ${{ secrets.PROJECT_TOKEN }}
       PROJECT_ID: "{{PROJECT_ID}}"
       STATUS_FIELD_ID: "{{STATUS_FIELD_ID}}"
       STATUS_DEVELOPMENT: "{{ID_DEVELOPMENT}}"
     steps:
-      - name: Update Labels
-        uses: actions/github-script@v7
+      - name: Update stage labels
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
@@ -41,23 +41,32 @@ jobs:
               console.log('Label stage:approval not found or could not be removed');
             }
 
-            const agentLabel = '{{IMPLEMENTATION_AGENT_LABEL}}';
-            const labelsToAdd = ['stage:development'];
-            if (!agentLabel.includes('{{')) labelsToAdd.push(agentLabel, 'agent:working');
-
             await github.rest.issues.addLabels({
               owner,
               repo,
               issue_number,
-              labels: labelsToAdd
+              labels: ['stage:development']
+            });
+
+      - name: Add agent label via PAT
+        if: ${{ env.PROJECT_TOKEN != '' && !contains('{{IMPLEMENTATION_AGENT_LABEL}}', '{{') }}
+        uses: actions/github-script@v8
+        with:
+          github-token: ${{ env.PROJECT_TOKEN }}
+          script: |
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.issue.number,
+              labels: ['{{IMPLEMENTATION_AGENT_LABEL}}']
             });
 
       - name: Move board card to Development
-        if: ${{ env.PROJECT_PAT != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
+        if: ${{ env.PROJECT_TOKEN != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
         continue-on-error: true
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
-          github-token: ${{ env.PROJECT_PAT }}
+          github-token: ${{ env.PROJECT_TOKEN }}
           script: |
             const nodeId = context.payload.issue.node_id;
             const number = context.payload.issue.number;
@@ -75,8 +84,8 @@ jobs:
             console.log(`Issue #${number} → Development`);
 
       - name: Comment on issue to trigger agent and prevent race conditions
-        if: ${{ !contains('{{IMPLEMENTATION_AGENT_LABEL}}', '{{') }}
-        uses: actions/github-script@v7
+        if: ${{ !contains('{{IMPLEMENTATION_AGENT_LABEL}}', '{{') && vars.JULES_ENABLED == 'true' }}
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
@@ -118,8 +127,8 @@ jobs:
       contents: read
     steps:
       - name: Comment on issue to trigger agent
-        if: ${{ !contains('{{IMPLEMENTATION_AGENT_LABEL}}', '{{') }}
-        uses: actions/github-script@v7
+        if: ${{ !contains('{{IMPLEMENTATION_AGENT_LABEL}}', '{{') && vars.JULES_ENABLED == 'true' }}
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |

package/{.agentic-pdlc/templates → templates}/.github/workflows/agentic-metrics.yml

@@ -9,15 +9,20 @@ permissions:
   contents: write
   issues: write
 
+env:
+  AGENTIC_PULSE_REVIEWERS: |
+    code_reviewer=gemini-code-assist[bot]
+    qa_agent=github-actions[bot]
+
 jobs:
   generate-pulse:
     name: Generate Weekly Agentic Pulse
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5.0.1
 
       - name: Collect Stage Residence Time
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
@@ -25,7 +30,7 @@ jobs:
             const { owner, repo } = context.repo;
             const since = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
             const STAGE_LABELS = new Set([
-              'stage:exploration', 'stage:brainstorming', 'stage:detailing',
+              'stage:brainstorming', 'stage:detailing',
               'stage:approval', 'stage:development', 'stage:testing'
             ]);
 
@@ -104,13 +109,26 @@ jobs:
           git push
 
       - name: Collect PR and Issue Insights
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
             const { owner, repo } = context.repo;
             const weekKey = process.env.WEEK_KEY;
 
+            // ── Preload stage:detailing times for stage correlation ──────────
+            const detailingByIssue = {};
+            const jsonlPath = `.agentic-pdlc/metrics/raw/${weekKey}.jsonl`;
+            if (fs.existsSync(jsonlPath)) {
+              const rawLines = fs.readFileSync(jsonlPath, 'utf8').trim().split('\n').filter(Boolean);
+              for (const line of rawLines) {
+                const r = JSON.parse(line);
+                if (r.stage === 'stage:detailing') {
+                  detailingByIssue[r.issueNumber] = round1((detailingByIssue[r.issueNumber] || 0) + r.durationDays);
+                }
+              }
+            }
+
             // ── Helper ──────────────────────────────────────────────────────
             function daysSince(isoStr) {
               return (Date.now() - new Date(isoStr).getTime()) / 864e5;
@@ -138,6 +156,22 @@ jobs:
             // ── Signal collection ───────────────────────────────────────────
             const signals = [];
 
+            // ── Review actor map (from AGENTIC_PULSE_REVIEWERS env var) ─────
+            const actorMap = {}; // login → role
+            const reviewersEnv = (process.env.AGENTIC_PULSE_REVIEWERS || '').trim();
+            if (reviewersEnv) {
+              for (const line of reviewersEnv.split('\n')) {
+                const eq = line.indexOf('=');
+                if (eq < 0) continue;
+                const role = line.slice(0, eq).trim();
+                const logins = line.slice(eq + 1).trim();
+                for (const login of logins.split(',').map(l => l.trim()).filter(Boolean)) {
+                  actorMap[login] = role;
+                }
+              }
+            }
+            const taxonomyEnabled = Object.keys(actorMap).length > 0;
+
             // 1. Orphan issues: open >14 days with no linked PR
             const closeRe = /(?:closes?|fixes?|resolves?)\s+#(\d+)/gi;
             const openIssues = await github.paginate(github.rest.issues.listForRepo, {
@@ -223,29 +257,68 @@ jobs:
               }
             }
 
-            // 3. Rework rate: commits per PR — single push session = first-shot
+            // 3. Rework rate with actor taxonomy (if AGENTIC_PULSE_REVIEWERS configured)
             const weekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
             const weekMerged = recentPRs.filter(pr => pr.merged_at && new Date(pr.merged_at) > weekAgo);
 
             if (weekMerged.length > 0) {
               let firstShots = 0;
+              const reworkByRole = {};
+              const reworkDetails = []; // { pr_number, issue_number } for stage correlation
+              const issueRe = /(?:closes?|fixes?|resolves?)\s+#(\d+)/i;
+
               for (const pr of weekMerged.slice(0, 10)) {
                 try {
                   const commits = await github.rest.pulls.listCommits({
                     owner, repo, pull_number: pr.number, per_page: 100
                   });
-                  const times = commits.data.map(c => new Date(c.commit.committer.date).getTime()).sort();
+                  const times = commits.data
+                    .map(c => new Date(c.commit.committer.date).getTime())
+                    .sort((a, b) => a - b);
+
                   let sessions = 1;
                   for (let i = 1; i < times.length; i++) {
                     if (times[i] - times[i-1] > 10 * 60 * 1000) sessions++;
                   }
-                  if (sessions === 1) firstShots++;
+
+                  if (sessions === 1) { firstShots++; continue; }
+
+                  if (!taxonomyEnabled) continue;
+
+                  let reviewTriggered = false;
+                  try {
+                    const reviews = await github.rest.pulls.listReviews({
+                      owner, repo, pull_number: pr.number, per_page: 100
+                    });
+                    const attributedRoles = new Set();
+                    for (const review of reviews.data) {
+                      if (!review.user) continue;
+                      const role = actorMap[review.user.login];
+                      if (!role || review.state === 'APPROVED' || attributedRoles.has(role)) continue;
+                      const reviewTime = new Date(review.submitted_at).getTime();
+                      if (times.some(t => t > reviewTime)) {
+                        reworkByRole[role] = (reworkByRole[role] || 0) + 1;
+                        reviewTriggered = true;
+                        attributedRoles.add(role);
+                        if (!reworkDetails.some(d => d.pr_number === pr.number)) {
+                          const m = issueRe.exec(pr.body || '');
+                          if (m) reworkDetails.push({ pr_number: pr.number, issue_number: parseInt(m[1]) });
+                        }
+                      }
+                    }
+                  } catch(e) { /* reviews not accessible — skip taxonomy for this PR */ }
+
+                  if (!reviewTriggered) {
+                    reworkByRole.self_correction = (reworkByRole.self_correction || 0) + 1;
+                  }
+
                 } catch (e) { /* skip if commits not accessible */ }
               }
+
               const total = Math.min(weekMerged.length, 10);
               const pct = Math.round(firstShots / total * 100);
+              const reworkCount = total - firstShots;
 
-              // Detect if repo uses an agent label (jules, sweep, codex, etc.)
               const agentLabels = new Set(['jules', 'sweep', 'codex', 'copilot']);
               const usesAgent = weekMerged.some(pr =>
                 (pr.labels || []).some(l => agentLabels.has(l.name.toLowerCase()))
@@ -253,27 +326,78 @@ jobs:
               const subject = usesAgent ? 'Agent first-shot rate' : 'PRs sem rework';
               const verb = usesAgent ? 'acertaram de primeira' : 'foram mergeados sem rework';
 
-              if (pct >= 80) {
-                signals.push({
-                  level: 'green',
-                  emoji: '🟢',
-                  title: `**${subject}: ${pct}%**`,
-                  body: `${firstShots} de ${total} PRs ${verb} esta semana. ✅`
-                });
-              } else if (pct < 50) {
+              if (taxonomyEnabled && reworkCount > 0) {
+                const lines = [];
+                for (const [role, count] of Object.entries(reworkByRole).sort((a, b) => b[1] - a[1])) {
+                  const s = count > 1 ? 's' : '';
+                  if (role === 'code_reviewer')        lines.push(`   ↳ Code reviewer: **${count} PR${s}** → revisar DoD em stage:development`);
+                  else if (role === 'qa_agent')        lines.push(`   ↳ QA Agent: **${count} PR${s}** → spec com lacunas funcionais em stage:detailing`);
+                  else if (role === 'self_correction') lines.push(`   ↳ Self-correction: **${count} PR${s}** (causa não determinada automaticamente)`);
+                  else                                 lines.push(`   ↳ ${role}: **${count} PR${s}**`);
+                }
+
+                const reviewerRework = reworkByRole.code_reviewer || 0;
+                const level = reviewerRework >= Math.ceil(reworkCount * 0.8) ? 'red'
+                            : (reviewerRework >= Math.ceil(reworkCount * 0.5) || (reworkByRole.qa_agent || 0) > 0) ? 'yellow'
+                            : 'neutral';
+                const emoji = level === 'red' ? '🔴' : level === 'yellow' ? '🟡' : '🔵';
+
                 signals.push({
-                  level: 'yellow',
-                  emoji: '🟡',
-                  title: `**${subject}: ${pct}% — rework alto**`,
-                  body: `Apenas ${firstShots} de ${total} PRs sem commits extras.\n→ Specs incompletas ou mudanças de requisito durante implementação.`
+                  level,
+                  emoji,
+                  title: `**Rework: ${100 - pct}%** — ${reworkCount} de ${total} PRs tiveram commits extras`,
+                  body: lines.join('\n')
                 });
+
+                // ── Stage correlation ────────────────────────────────────────
+                if (reworkDetails.length > 0 && Object.keys(detailingByIssue).length > 0) {
+                  const reworkIssueNums = new Set(reworkDetails.map(d => d.issue_number));
+
+                  const reworkGroup = reworkDetails
+                    .map(d => detailingByIssue[d.issue_number])
+                    .filter(t => t !== undefined);
+
+                  const cleanGroup = weekMerged.slice(0, 10)
+                    .map(pr => { const m = issueRe.exec(pr.body || ''); return m ? parseInt(m[1]) : null; })
+                    .filter(n => n !== null && !reworkIssueNums.has(n))
+                    .map(n => detailingByIssue[n])
+                    .filter(t => t !== undefined);
+
+                  if (reworkGroup.length >= 3 && cleanGroup.length >= 3) {
+                    const avgRework = round1(reworkGroup.reduce((a, b) => a + b, 0) / reworkGroup.length);
+                    const avgClean  = round1(cleanGroup.reduce((a, b) => a + b, 0) / cleanGroup.length);
+                    if (avgRework < avgClean * 0.75) {
+                      signals.push({
+                        level: 'neutral',
+                        emoji: '💡',
+                        title: `**Stage correlation:** PRs com reviewer rework tiveram Detailing médio de ${avgRework}d vs ${avgClean}d (N=${reworkGroup.length} vs ${cleanGroup.length})`,
+                        body: '→ Specs rápidas correlacionam com mais rework de review'
+                      });
+                    }
+                  }
+                }
+
               } else {
-                signals.push({
-                  level: 'neutral',
-                  emoji: '🔵',
-                  title: `**${subject}: ${pct}%**`,
-                  body: `${firstShots} de ${total} PRs sem rework commits.`
-                });
+                // Taxonomy disabled or no rework — existing signal unchanged
+                if (pct >= 80) {
+                  signals.push({
+                    level: 'green', emoji: '🟢',
+                    title: `**${subject}: ${pct}%**`,
+                    body: `${firstShots} de ${total} PRs ${verb} esta semana. ✅`
+                  });
+                } else if (pct < 50) {
+                  signals.push({
+                    level: 'yellow', emoji: '🟡',
+                    title: `**${subject}: ${pct}% — rework alto**`,
+                    body: `Apenas ${firstShots} de ${total} PRs sem commits extras.\n→ Specs incompletas ou mudanças de requisito durante implementação.`
+                  });
+                } else {
+                  signals.push({
+                    level: 'neutral', emoji: '🔵',
+                    title: `**${subject}: ${pct}%**`,
+                    body: `${firstShots} de ${total} PRs sem rework commits.`
+                  });
+                }
               }
             }
 
@@ -292,12 +416,10 @@ jobs:
 
             // ── Stage Residence Time section (conditional) ──────────────────
             let stageSection = '';
-            const jsonlPath = `.agentic-pdlc/metrics/raw/${weekKey}.jsonl`;
             if (fs.existsSync(jsonlPath)) {
               const records = fs.readFileSync(jsonlPath, 'utf8').trim().split('\n').filter(Boolean).map(JSON.parse);
               if (records.length > 0) {
                 const STAGES = [
-                  ['stage:exploration',   'Exploration'],
                   ['stage:brainstorming', 'Brainstorming'],
                   ['stage:detailing',     'Detailing'],
                   ['stage:approval',      'Approval'],
@@ -374,7 +496,7 @@ jobs:
             console.log(`Built pulse issue for ${weekKey} — ${signals.length} signals, ${reds} red, ${yellows} yellow`);
 
       - name: Create Weekly Pulse Issue
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const { owner, repo } = context.repo;
@@ -394,19 +516,27 @@ jobs:
               console.log(`Created label ${LABEL}`);
             }
 
-            // Close previous pulse issues
+            // Close previous pulse issues; upsert if same week already exists
             const prev = await github.rest.issues.listForRepo({
               owner, repo, labels: LABEL, state: 'open', per_page: 20
             });
+            let existingIssue = null;
             for (const issue of prev.data) {
-              if (issue.title !== title) {
+              if (issue.title === title) {
+                existingIssue = issue;
+                console.log(`Found existing pulse for ${title}: #${issue.number} — will update body`);
+              } else {
                 await github.rest.issues.update({ owner, repo, issue_number: issue.number, state: 'closed' });
                 console.log(`Closed previous pulse: #${issue.number}`);
               }
             }
 
-            // Create new pulse issue
-            const created = await github.rest.issues.create({
-              owner, repo, title, body, labels: [LABEL]
-            });
-            console.log(`✅ Created pulse issue: #${created.data.number} — ${title}`);
+            if (existingIssue) {
+              await github.rest.issues.update({ owner, repo, issue_number: existingIssue.number, body });
+              console.log(`✅ Updated pulse issue: #${existingIssue.number} — ${title}`);
+            } else {
+              const created = await github.rest.issues.create({
+                owner, repo, title, body, labels: [LABEL]
+              });
+              console.log(`✅ Created pulse issue: #${created.data.number} — ${title}`);
+            }

package/templates/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     name: Run tests and linters
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5.0.1
 
       - name: Setup environment
         run: echo "Replace this with your language/toolchain setup (e.g., actions/setup-node)"
@@ -38,3 +38,17 @@ jobs:
         if: ${{ !contains('{{TEST_COMMAND}}', '{{') }}
         run: |
           {{TEST_COMMAND}}
+
+  ci-status:
+    name: Sentinel / CI
+    needs: [validate]
+    if: always()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check validate result
+        run: |
+          result="${{ needs.validate.result }}"
+          if [[ "$result" != "success" && "$result" != "skipped" ]]; then
+            echo "CI failed: validate=$result"
+            exit 1
+          fi

package/templates/.github/workflows/pdlc-health-check.yml

@@ -8,7 +8,6 @@ on:
 env:
   PROJECT_ID: "{{PROJECT_ID}}"
   STATUS_FIELD_ID: "{{STATUS_FIELD_ID}}"
-  STATUS_EXPLORATION: "{{ID_EXPLORATION}}"
   STATUS_BRAINSTORMING: "{{ID_BRAINSTORMING}}"
   STATUS_DETAILING: "{{ID_DETAILING}}"
   STATUS_APPROVAL: "{{ID_APPROVAL}}"
@@ -28,14 +27,13 @@ jobs:
     steps:
       - name: Validate Board Configuration
         if: ${{ env.PROJECT_TOKEN != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ env.PROJECT_TOKEN }}
           script: |
             const projectId = process.env.PROJECT_ID;
             const statusFieldId = process.env.STATUS_FIELD_ID;
             const envVars = {
-              'STATUS_EXPLORATION': process.env.STATUS_EXPLORATION,
               'STATUS_BRAINSTORMING': process.env.STATUS_BRAINSTORMING,
               'STATUS_DETAILING': process.env.STATUS_DETAILING,
               'STATUS_APPROVAL': process.env.STATUS_APPROVAL,

package/templates/.github/workflows/pdlc-stage-gate.yml

@@ -37,12 +37,12 @@ jobs:
 
           for NUM in $ISSUE_NUMS; do
             LABELS=$(gh issue view "$NUM" --repo "$REPO" --json labels --jq '[.labels[].name] | join(" ")' 2>/dev/null || echo "")
-            if echo "$LABELS" | grep -qw "stage:approval" || echo "$LABELS" | grep -qw "spec:approved" || echo "$LABELS" | grep -qw "stage:development"; then
+            if echo "$LABELS" | grep -qw "stage:approval" || echo "$LABELS" | grep -qw "spec:approved" || echo "$LABELS" | grep -qw "stage:development" || echo "$LABELS" | grep -qw "stage:testing" || echo "$LABELS" | grep -qw "human-approved"; then
               echo "✅ Issue #$NUM approved"
             else
               STAGE=$(echo "$LABELS" | tr ' ' '\n' | grep "^stage:" | head -1 || echo "none")
               echo "❌ Issue #$NUM missing approval (current: $STAGE)"
-              echo "   Required: stage:approval OR spec:approved OR stage:development label on the issue."
+              echo "   Required: stage:approval OR spec:approved OR stage:development OR stage:testing OR human-approved label on the issue."
               echo "   Emergency bypass: add 'hotfix' label to this PR."
               exit 1
             fi