create-agentic-pdlc 2.2.1 → 2.4.0

package/.agentic-pdlc/templates/.github/workflows/add-to-board.yml

@@ -1,38 +0,0 @@
-name: Add to Board on Open
-
-on:
-  issues:
-    types: [opened]
-
-env:
-  PROJECT_ID: "{{PROJECT_ID}}"
-  STATUS_FIELD_ID: "{{STATUS_FIELD_ID}}"
-  STATUS_IDEA: "{{ID_IDEA}}"
-
-jobs:
-  add-to-board:
-    name: Auto-add new issue to board
-    runs-on: ubuntu-latest
-    env:
-      PROJECT_PAT: ${{ secrets.PROJECT_PAT }}
-    steps:
-      - name: Add issue to project board
-        if: ${{ env.PROJECT_PAT != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ env.PROJECT_PAT }}
-          script: |
-            const nodeId = context.payload.issue.node_id;
-            const number = context.payload.issue.number;
-            const { addProjectV2ItemById: { item } } = await github.graphql(`
-              mutation($p: ID!, $c: ID!) {
-                addProjectV2ItemById(input: {projectId: $p, contentId: $c}) { item { id } }
-              }`, { p: process.env.PROJECT_ID, c: nodeId });
-            await github.graphql(`
-              mutation($p: ID!, $i: ID!, $f: ID!, $v: ProjectV2FieldValue!) {
-                updateProjectV2ItemFieldValue(input: {projectId: $p, itemId: $i, fieldId: $f, value: $v}) {
-                  projectV2Item { id }
-                }
-              }`, { p: process.env.PROJECT_ID, i: item.id, f: process.env.STATUS_FIELD_ID,
-                   v: { singleSelectOptionId: process.env.STATUS_IDEA } });
-            console.log(`Issue #${number} added to board → Idea`);

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

@@ -1,146 +0,0 @@
-name: Trigger Implementation Agent
-
-# Triggers when spec:approved is added to an issue (Gate 2)
-# or when an architecture-violation issue is modified (Sentinel flow)
-on:
-  issues:
-    types: [labeled]
-
-jobs:
-  trigger-implementation-agent:
-    name: Trigger {{IMPLEMENTATION_AGENT_NAME}} for implementation
-    # Runs only when spec:approved is added
-    if: github.event.label.name == 'spec:approved'
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      pull-requests: write
-      contents: read
-    env:
-      PROJECT_PAT: ${{ secrets.PROJECT_PAT }}
-      PROJECT_ID: "{{PROJECT_ID}}"
-      STATUS_FIELD_ID: "{{STATUS_FIELD_ID}}"
-      STATUS_DEVELOPMENT: "{{ID_DEVELOPMENT}}"
-    steps:
-      - name: Update Labels
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { owner, repo } = context.repo;
-            const issue_number = context.payload.issue.number;
-
-            try {
-              await github.rest.issues.removeLabel({
-                owner,
-                repo,
-                issue_number,
-                name: 'stage:approval'
-              });
-            } catch (error) {
-              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
-            });
-
-      - name: Move board card to Development
-        if: ${{ env.PROJECT_PAT != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-        continue-on-error: true
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ env.PROJECT_PAT }}
-          script: |
-            const nodeId = context.payload.issue.node_id;
-            const number = context.payload.issue.number;
-            const { addProjectV2ItemById: { item } } = await github.graphql(`
-              mutation($p: ID!, $c: ID!) {
-                addProjectV2ItemById(input: {projectId: $p, contentId: $c}) { item { id } }
-              }`, { p: process.env.PROJECT_ID, c: nodeId });
-            await github.graphql(`
-              mutation($p: ID!, $i: ID!, $f: ID!, $v: ProjectV2FieldValue!) {
-                updateProjectV2ItemFieldValue(input: {projectId: $p, itemId: $i, fieldId: $f, value: $v}) {
-                  projectV2Item { id }
-                }
-              }`, { p: process.env.PROJECT_ID, i: item.id, f: process.env.STATUS_FIELD_ID,
-                   v: { singleSelectOptionId: process.env.STATUS_DEVELOPMENT } });
-            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
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const issueNumber = context.payload.issue.number;
-            const issueTitle = context.payload.issue.title;
-
-            const body = [
-              `🤖 **Agentic PDLC Orchestrator:** I have dispatched the implementation agent. Please wait for the Pull Request and avoid making concurrent commits on this task to prevent race conditions.`,
-              '',
-              `{{AGENT_HANDLE}} The spec for this issue has been approved. Please implement it exactly as described in the body above.`,
-              '',
-              '**Mandatory steps before you begin:**',
-              '1. `git fetch origin && git checkout main && git pull` — always start from the current HEAD',
-              '2. Read `AGENTS.md` — mandatory rules for agents in this repository',
-              '3. Read `docs/pdlc.md` — Definition of Done and invariants reference',
-              '',
-              '**Rules:**',
-              '- Implement strictly what the Acceptance Criteria describes',
-              '- Run `{{TEST_COMMAND}}` before opening the Pull Request',
-              `- Include \`Closes #${issueNumber}\` in the PR body`,
-              '- Create a descriptive branch branching from `main`',
-            ].join('\n');
-
-            await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: issueNumber,
-              body,
-            });
-
-  trigger-agent-on-violation:
-    name: Trigger {{IMPLEMENTATION_AGENT_NAME}} for architecture violation
-    # Runs when architecture-violation is added (Sentinel flow)
-    if: github.event.label.name == 'architecture-violation'
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      pull-requests: write
-      contents: read
-    steps:
-      - name: Comment on issue to trigger agent
-        if: ${{ !contains('{{IMPLEMENTATION_AGENT_LABEL}}', '{{') }}
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const issueNumber = context.payload.issue.number;
-
-            const body = [
-              `{{AGENT_HANDLE}} Please fix the architecture violation described in this issue.`,
-              '',
-              '**Mandatory steps before you begin:**',
-              '1. `git fetch origin && git checkout main && git pull` — always start from the current HEAD',
-              '2. Read `AGENTS.md` — mandatory rules for agents in this repository',
-              '',
-              '**Rules:**',
-              '- Fix only what the violation points out — do not refactor unrelated code',
-              '- Run `{{TEST_COMMAND}}` before opening the Pull Request',
-              `- Include \`Closes #${issueNumber}\` in the PR body`,
-            ].join('\n');
-
-            await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: issueNumber,
-              body,
-            });

package/.agentic-pdlc/templates/.github/workflows/auto-approve.yml

@@ -1,16 +0,0 @@
-name: Auto Approve PRs
-on:
-  pull_request:
-    types: [opened, labeled, synchronize]
-
-permissions:
-  pull-requests: write
-
-jobs:
-  auto-approve:
-    runs-on: ubuntu-latest
-    if: contains(github.event.pull_request.labels.*.name, 'auto-approve')
-    steps:
-      - uses: hmarr/auto-approve-action@v4
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}

package/.agentic-pdlc/templates/.github/workflows/ci.yml

@@ -1,40 +0,0 @@
-name: Sentinel / CI
-
-on:
-  pull_request:
-    branches: [ main ]
-  push:
-    branches: [ main ]
-
-jobs:
-  validate:
-    name: Run tests and linters
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup environment
-        run: echo "Replace this with your language/toolchain setup (e.g., actions/setup-node)"
-        
-      - name: Install dependencies
-        run: echo "Replace this with your package manager install command"
-
-      - name: Run Linters
-        if: ${{ !contains('{{LINT_COMMAND}}', '{{') }}
-        run: |
-          {{LINT_COMMAND}}
-
-      - name: Typecheck
-        if: ${{ !contains('{{TYPECHECK_COMMAND}}', '{{') }}
-        run: |
-          {{TYPECHECK_COMMAND}}
-
-      - name: Build
-        if: ${{ !contains('{{BUILD_COMMAND}}', '{{') }}
-        run: |
-          {{BUILD_COMMAND}}
-
-      - name: Run Tests
-        if: ${{ !contains('{{TEST_COMMAND}}', '{{') }}
-        run: |
-          {{TEST_COMMAND}}

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

@@ -1,123 +0,0 @@
-name: PDLC Health Check (Drift Detection)
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: '0 8 * * 1' # Every Monday at 8am
-
-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}}"
-  STATUS_DEVELOPMENT: "{{ID_DEVELOPMENT}}"
-  STATUS_TESTING: "{{ID_TESTING}}"
-  STATUS_CODE_REVIEW_PR: "{{ID_CODE_REVIEW_PR}}"
-  STATUS_PRODUCTION: "{{ID_PRODUCTION}}"
-
-jobs:
-  check-drift:
-    name: Detect Project Board Drift
-    runs-on: ubuntu-latest
-    env:
-      PROJECT_TOKEN: ${{ secrets.PROJECT_TOKEN }}
-    permissions:
-      issues: write
-    steps:
-      - name: Validate Board Configuration
-        if: ${{ env.PROJECT_TOKEN != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-        uses: actions/github-script@v7
-        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,
-              'STATUS_DEVELOPMENT': process.env.STATUS_DEVELOPMENT,
-              'STATUS_TESTING': process.env.STATUS_TESTING,
-              'STATUS_CODE_REVIEW_PR': process.env.STATUS_CODE_REVIEW_PR,
-              'STATUS_PRODUCTION': process.env.STATUS_PRODUCTION
-            };
-
-            const query = `
-              query($projectId: ID!) {
-                node(id: $projectId) {
-                  ... on ProjectV2 {
-                    title
-                    fields(first: 20) {
-                      nodes {
-                        ... on ProjectV2SingleSelectField {
-                          id
-                          name
-                          options {
-                            id
-                            name
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            `;
-
-            let result;
-            try {
-              result = await github.graphql(query, { projectId });
-            } catch (error) {
-              console.log("❌ Error fetching project. Verify your PROJECT_ID.");
-              console.log(error);
-              return;
-            }
-
-            const project = result.node;
-            if (!project) {
-              console.log("❌ Project not found.");
-              return;
-            }
-
-            const statusField = project.fields.nodes.find(f => f.id === statusFieldId);
-            if (!statusField) {
-              console.log("❌ Status field not found.");
-              return;
-            }
-
-            const validOptions = statusField.options;
-            const validOptionIds = validOptions.map(o => o.id);
-
-            let hasDrift = false;
-            let missingVars = [];
-
-            for (const [varName, id] of Object.entries(envVars)) {
-              if (id && !id.startsWith('{{') && !validOptionIds.includes(id)) {
-                hasDrift = true;
-                missingVars.push(varName);
-              }
-            }
-
-            if (hasDrift) {
-              console.log("🚨 Drift detected! The following mapped columns no longer exist: " + missingVars.join(", "));
-              
-              let table = "| Column Name | New ID |\n|---|---|\n";
-              validOptions.forEach(opt => {
-                table += `| ${opt.name} | \`${opt.id}\` |\n`;
-              });
-
-              const body = `🚨 **Agentic PDLC Drift Detected**\n\nThe following columns mapped in your \`.github/workflows/project-automation.yml\` no longer exist in your project board:\n\n**${missingVars.join(", ")}**\n\n### How to fix it:\nHere is the list of current columns in your board with their valid IDs. Please update the \`env\` block in your \`.github/workflows/project-automation.yml\` and \`.github/workflows/pdlc-health-check.yml\`.\n\n${table}`;
-
-              await github.rest.issues.create({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                title: '🚨 Agentic PDLC Drift Detected in Project Board',
-                body: body,
-                labels: ['bug']
-              });
-            } else {
-              console.log("✅ No drift detected. Board configuration is healthy.");
-            }

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

@@ -1,51 +0,0 @@
-name: PDLC Stage Gate
-on:
-  pull_request:
-    types: [opened, synchronize, reopened, labeled, unlabeled]
-
-permissions:
-  pull-requests: read
-  issues: read
-
-jobs:
-  stage-gate:
-    name: PDLC Stage Gate
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check stage:approval
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          set -e
-          REPO="${{ github.repository }}"
-          PR_NUMBER="${{ github.event.pull_request.number }}"
-
-          PR_LABELS=$(gh pr view "$PR_NUMBER" --repo "$REPO" --json labels --jq '[.labels[].name] | join(" ")')
-          if echo "$PR_LABELS" | grep -qw "hotfix"; then
-            echo "✅ Hotfix label — stage gate bypassed."
-            exit 0
-          fi
-
-          PR_BODY=$(gh pr view "$PR_NUMBER" --repo "$REPO" --json body --jq '.body // ""')
-          ISSUE_NUMS=$(echo "$PR_BODY" | grep -oiE '(Closes?|Fixes?|Resolves?)\s+#([0-9]+)' | grep -oE '[0-9]+' || true)
-
-          if [ -z "$ISSUE_NUMS" ]; then
-            echo "❌ No linked issues in PR body."
-            echo "   Add 'Closes #N' to PR body, or add 'hotfix' label to PR for emergencies."
-            exit 1
-          fi
-
-          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
-              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 "   Emergency bypass: add 'hotfix' label to this PR."
-              exit 1
-            fi
-          done
-
-          echo "✅ All linked issues approved."