create-agentic-pdlc 3.0.0 → 3.1.1

package/bin/cli.js

@@ -60,6 +60,7 @@ const i18n = {
   cursor_rules_written: t('✅ Default cursor rules written to .cursorrules', '✅ Regras padrão do cursor salvas em .cursorrules', '✅ Reglas por defecto de cursor guardadas en .cursorrules'),
   setup_done: t('🎉 All set! Continue the setup with your agent:', '🎉 Aqui tá pronto! Continue o setup com o seu agente:', '🎉 ¡Listo! Continúa el setup con tu agente:'),
   setup_done_hint: t('>>> Tell it to read and execute the .agentic-setup.md file!', '>>> Diga a ele para ler e executar o arquivo .agentic-setup.md!', '>>> Dile que lea y ejecute el archivo .agentic-setup.md!'),
+  upgrade_hint: t('💡 To add the full board + multi-agent automation later: npx create-agentic-pdlc --upgrade-to-agentic', '💡 Para adicionar o board completo + automação multi-agente mais tarde: npx create-agentic-pdlc --upgrade-to-agentic', '💡 Para agregar el tablero completo + automatización multi-agente más tarde: npx create-agentic-pdlc --upgrade-to-agentic'),
   update_title: t('agentic-pdlc — Agent Configuration Status', 'agentic-pdlc — Status de Configuração dos Agentes', 'agentic-pdlc — Estado de Configuración de Agentes'),
   update_no_context: t('❌ No .agentic-pdlc/cli-context.json found. Run npx create-agentic-pdlc first.', '❌ Arquivo .agentic-pdlc/cli-context.json não encontrado. Rode npx create-agentic-pdlc primeiro.', '❌ Archivo .agentic-pdlc/cli-context.json no encontrado. Ejecuta npx create-agentic-pdlc primero.'),
   update_all_ok: t('All agents configured!', 'Todos os agentes configurados!', '¡Todos los agentes configurados!'),
@@ -74,12 +75,36 @@ const i18n = {
   update_sentinel_ask: t("  Activate? CodeRabbit applies 'architecture-violation' label when violations are detected. (Y/n): ", "  Ativar? CodeRabbit aplica a label 'architecture-violation' quando detecta violações. (S/n): ", "  ¿Activar? CodeRabbit aplica la etiqueta 'architecture-violation' cuando detecta violaciones. (S/n): "),
   configuring_protection: t('[3/3] Configuring branch protection...', '[3/3] Configurando proteção de branch...', '[3/3] Configurando protección de rama...'),
   protection_ok: t('✅ Branch protection set — required checks: PDLC Stage Gate, QA Gate.', '✅ Proteção de branch configurada — checks obrigatórios: PDLC Stage Gate, QA Gate.', '✅ Protección de rama configurada — checks requeridos: PDLC Stage Gate, QA Gate.'),
-  protection_warn: t('⚠️  Branch protection could not be set automatically.\n     Set required checks manually: Settings → Branches → main → Required status checks.\n     Required: "PDLC Stage Gate" and "QA Gate"', '⚠️  Proteção de branch não pôde ser configurada automaticamente.\n     Configure manualmente: Settings → Branches → main → Required status checks.\n     Obrigatórios: "PDLC Stage Gate" e "QA Gate"', '⚠️  No se pudo configurar la protección de rama automáticamente.\n     Configúralo en: Settings → Branches → main → Required status checks.\n     Requeridos: "PDLC Stage Gate" y "QA Gate"'),
+  protection_warn: t(
+    '⚠️  Branch protection requires admin access — could not be set automatically.\n\n     What it does: prevents PRs from merging unless these CI checks pass:\n       • "PDLC Stage Gate" — blocks merge if the linked issue lacks spec:approved\n       • "QA Gate"         — blocks merge if automated QA checks failed\n\n     Without it: the workflow still runs, but PRs can be merged without approval.\n\n     To enable: Settings → Branches → main → Required status checks\n     Add: "PDLC Stage Gate" and "QA Gate"',
+    '⚠️  Proteção de branch requer acesso de admin — não pôde ser configurada automaticamente.\n\n     O que faz: impede que PRs sejam mergeados sem que esses checks de CI passem:\n       • "PDLC Stage Gate" — bloqueia merge se a issue não tiver spec:approved\n       • "QA Gate"         — bloqueia merge se os checks automáticos de QA falharem\n\n     Sem ela: o workflow continua funcionando, mas PRs podem ser mergeados sem aprovação.\n\n     Para ativar: Settings → Branches → main → Required status checks\n     Adicionar: "PDLC Stage Gate" e "QA Gate"',
+    '⚠️  La protección de rama requiere acceso de administrador — no se pudo configurar automáticamente.\n\n     Qué hace: impide que los PRs se fusionen sin que pasen estos checks de CI:\n       • "PDLC Stage Gate" — bloquea el merge si la issue no tiene spec:approved\n       • "QA Gate"         — bloquea el merge si los checks automáticos de QA fallaron\n\n     Sin ella: el flujo sigue funcionando, pero los PRs se pueden fusionar sin aprobación.\n\n     Para activar: Settings → Branches → main → Required status checks\n     Agregar: "PDLC Stage Gate" y "QA Gate"'
+  ),
   issue_templates_copied: t(
     '✅ Issue templates copied to .github/ISSUE_TEMPLATE/',
     '✅ Issue templates copiados para .github/ISSUE_TEMPLATE/',
     '✅ Issue templates copiados a .github/ISSUE_TEMPLATE/'
   ),
+  vars_project_id_ok: t(
+    '✅ vars.PROJECT_ID set as Actions Variable.',
+    '✅ vars.PROJECT_ID configurado como Variável do Actions.',
+    '✅ vars.PROJECT_ID configurado como Variable de Actions.'
+  ),
+  vars_project_id_warn: t(
+    '⚠️  Could not set vars.PROJECT_ID — token may lack variables:write scope.\n   Set manually: repo Settings → Secrets and variables → Variables → PROJECT_ID = ',
+    '⚠️  Não foi possível configurar vars.PROJECT_ID — o token pode não ter permissão variables:write.\n   Configure manualmente: repo Settings → Secrets and variables → Variables → PROJECT_ID = ',
+    '⚠️  No se pudo configurar vars.PROJECT_ID — el token puede no tener permiso variables:write.\n   Configura manualmente: repo Settings → Secrets and variables → Variables → PROJECT_ID = '
+  ),
+  gh_not_installed: t(
+    '\n⚠️  GitHub CLI (gh) is not installed. Skipping label creation.',
+    '\n⚠️  GitHub CLI (gh) não está instalado. Pulando criação de labels.',
+    '\n⚠️  GitHub CLI (gh) no está instalado. Omitiendo creación de etiquetas.'
+  ),
+  repo_context_missing: t(
+    '\n⚠️  Repository owner or name missing in cli-context.json. Automatic label creation will be skipped.',
+    '\n⚠️  Dono ou nome do repositório ausente em cli-context.json. Criação automática de labels será pulada.',
+    '\n⚠️  Propietario o nombre del repositorio faltante en cli-context.json. Se omitirá la creación automática de etiquetas.'
+  ),
 };
 
 const cyan = '\x1b[36m';
@@ -89,19 +114,23 @@ const yellow = '\x1b[33m';
 const red = '\x1b[31m';
 
 const PDLC_LABELS = [
-  { name: 'stage:exploration',      color: '9b59b6', description: 'Issue is being evaluated' },
   { name: 'stage:brainstorming',    color: 'e84393', description: 'Proposed approaches awaiting PM gate' },
   { name: 'stage:detailing',        color: '3498db', description: 'Technical spec is being written' },
   { name: 'stage:development',      color: 'e67e22', description: 'Agent is implementing the spec' },
-  { name: 'stage:testing',          color: '8e44ad', description: 'Agent is testing the implementation' },
   { name: 'spec:approved',          color: '0e8a16', description: 'Spec approved — agent can implement' },
   { name: 'pr:in-review',           color: 'e4e669', description: 'PR awaiting code review' },
   { name: 'pr:approved',            color: '0e8a16', description: 'PR approved, ready for merge' },
   { name: 'architecture-violation', color: 'd93f0b', description: 'Invariant violation detected by CI' },
-  { name: 'qa:approved',            color: '0e8a16', description: 'QA Agent approved the implementation' },
-  { name: 'qa:needs-work',          color: 'd93f0b', description: 'QA Agent found issues' },
-  { name: 'infra:qa-broken',        color: 'F97316', description: 'QA Agent failed to run — manual review required' },
-  { name: 'jules',                  color: '5319e7', description: 'Jules AI Agent' }
+];
+
+const JULES_LABELS = [
+  { name: 'jules', color: '5319e7', description: 'Jules AI Agent' },
+];
+
+const QA_LABELS = [
+  { name: 'qa:approved',    color: '0e8a16', description: 'QA Agent approved the implementation' },
+  { name: 'qa:needs-work',  color: 'd93f0b', description: 'QA Agent found issues' },
+  { name: 'infra:qa-broken',color: 'F97316', description: 'QA Agent failed to run — manual review required' },
 ];
 
 function buildBoardUrl(repoOwner, projectNumber, isOrg) {
@@ -282,6 +311,42 @@ function scaffoldLiteTemplates(sourceDir, targetDir) {
   }
 }
 
+function createLabelsForRepo(labels, repo) {
+  for (const label of labels) {
+    try {
+      execFileSync('gh', ['label', 'create', label.name, '--color', label.color, '--description', label.description, '--repo', repo, '--force'], { stdio: 'ignore' });
+    } catch (err) {
+      if (err.code === 'ENOENT') {
+        console.warn(i18n.gh_not_installed);
+        break;
+      }
+    }
+  }
+}
+
+function setActionsVariable(repo, name, value, execFn = execFileSync) {
+  try {
+    execFn('gh', [
+      'api', `repos/${repo}/actions/variables/${name}`,
+      '--method', 'PATCH',
+      '-f', `name=${name}`,
+      '-f', `value=${value}`
+    ], { stdio: ['ignore', 'pipe', 'pipe'] });
+  } catch (err) {
+    const msg = (err.stderr?.toString() || '') + (err.message || '');
+    if (msg.includes('404') || msg.includes('Not Found')) {
+      execFn('gh', [
+        'api', `repos/${repo}/actions/variables`,
+        '--method', 'POST',
+        '-f', `name=${name}`,
+        '-f', `value=${value}`
+      ], { stdio: ['ignore', 'pipe', 'pipe'] });
+    } else {
+      throw err;
+    }
+  }
+}
+
 function scaffoldFullTemplates(sourceDir, targetDir, projectId, statusFieldId, optionMap, repoOwner, repoName) {
   const destTemplates = path.join(targetDir, '.agentic-pdlc', 'templates');
   fs.mkdirSync(destTemplates, { recursive: true });
@@ -342,7 +407,6 @@ function scaffoldFullTemplates(sourceDir, targetDir, projectId, statusFieldId, o
   const paPath = path.join(destTemplates, '.github', 'workflows', 'project-automation.yml');
   if (fs.existsSync(paPath) && Object.keys(optionMap).length > 0) {
     let wfContent = fs.readFileSync(paPath, 'utf8');
-    if (projectId)     wfContent = wfContent.replace(/\{\{PROJECT_ID\}\}/g,      () => projectId);
     if (statusFieldId) wfContent = wfContent.replace(/\{\{STATUS_FIELD_ID\}\}/g, () => statusFieldId);
     wfContent = wfContent.replace(/\{\{ID_IDEA\}\}/g,                () => optionMap['💡 Idea - No move to Exploration directly'] || 'MISSING_ID');
     wfContent = wfContent.replace(/\{\{ID_EXPLORATION\}\}/g,         () => optionMap['🔍 Exploration']         || 'MISSING_ID');
@@ -536,21 +600,31 @@ async function runFullSetup() {
     }
   }
 
-  // Auto-provision PROJECT_PAT for personal repos
+  // Auto-provision PROJECT_TOKEN for personal repos
   let patAutoSet = false;
   if (projectId && !isOrg) {
     try {
       const tokenOut = execFileSync('gh', ['auth', 'token'], { stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8' }).trim();
       if (tokenOut) {
-        execFileSync('gh', ['secret', 'set', 'PROJECT_PAT', '--body', tokenOut, '--repo', repo], { stdio: ['ignore', 'pipe', 'pipe'] });
+        execFileSync('gh', ['secret', 'set', 'PROJECT_TOKEN', '--body', tokenOut, '--repo', repo], { stdio: ['ignore', 'pipe', 'pipe'] });
         patAutoSet = true;
-        console.log(`\n${green}✅ PROJECT_PAT secret set automatically (uses your gh OAuth token).${reset}`);
+        console.log(`\n${green}✅ PROJECT_TOKEN secret set automatically (uses your gh OAuth token).${reset}`);
       }
     } catch (err) {
-      console.log(`\n${yellow}⚠️  Could not auto-set PROJECT_PAT. Agent will guide manual setup.${reset}`);
+      console.log(`\n${yellow}⚠️  Could not auto-set PROJECT_TOKEN. Agent will guide manual setup.${reset}`);
     }
   } else if (projectId && isOrg) {
-    console.log(`\n${yellow}ℹ️  Org repo detected — PROJECT_PAT will require manual setup for security.${reset}`);
+    console.log(`\n${yellow}ℹ️  Org repo detected — PROJECT_TOKEN will require manual setup for security.${reset}`);
+  }
+
+  // Set PROJECT_ID as GitHub Actions Variable
+  if (projectId) {
+    try {
+      setActionsVariable(repo, 'PROJECT_ID', projectId);
+      console.log(`${green}${i18n.vars_project_id_ok}${reset}`);
+    } catch (_) {
+      console.log(`${yellow}${i18n.vars_project_id_warn}${projectId}${reset}`);
+    }
   }
 
   await setBranchProtection(repo, ['PDLC Stage Gate', 'QA Gate']);
@@ -710,6 +784,10 @@ async function runUpdate() {
     return;
   }
 
+  const repo = ctx.repoOwner && ctx.repoName ? `${ctx.repoOwner}/${ctx.repoName}` : null;
+  if (!repo) {
+    console.warn(`${yellow}${i18n.repo_context_missing}${reset}`);
+  }
   const paPath = path.join(targetDir, '.github', 'workflows', 'project-automation.yml');
   const atPath = path.join(targetDir, '.github', 'workflows', 'agent-trigger.yml');
   const results = [];
@@ -718,11 +796,14 @@ async function runUpdate() {
     console.log(`\n${cyan}${i18n.update_jules_header}${reset}`);
     const choice = (await askQuestion(i18n.update_jules_ask)).trim().toLowerCase();
     if (choice === 'a' || choice === '') {
+      if (repo) createLabelsForRepo(JULES_LABELS, repo);
       configureJules(atPath, '@google-labs-jules', 'jules');
       results.push(t('✅  Jules configured (@google-labs-jules)', '✅  Jules configurado (@google-labs-jules)', '✅  Jules configurado (@google-labs-jules)'));
     } else if (choice === 'b') {
       const handle = (await askQuestion(i18n.update_jules_ask_handle)).trim();
-      configureJules(atPath, handle, handle.replace('@', '').toLowerCase());
+      const labelName = handle.replace('@', '').toLowerCase();
+      if (repo) createLabelsForRepo([{ name: labelName, color: '5319e7', description: `${handle} AI Agent` }], repo);
+      configureJules(atPath, handle, labelName);
       results.push(t(`✅  Agent configured (${handle})`, `✅  Agente configurado (${handle})`, `✅  Agente configurado (${handle})`));
     } else {
       results.push(t('⏭  Jules — skipped', '⏭  Jules — pulado', '⏭  Jules — omitido'));
@@ -733,6 +814,7 @@ async function runUpdate() {
     console.log(`\n${cyan}${i18n.update_qa_header}${reset}`);
     const answer = (await askQuestion(i18n.update_qa_ask)).trim().toLowerCase();
     if (!['n', 'no', 'não', 'nao'].includes(answer)) {
+      if (repo) createLabelsForRepo(QA_LABELS, repo);
       activateQaAgent(paPath);
       results.push(t(
         '✅  QA Agent configured — Variant B activated (uses GITHUB_TOKEN, no extra secrets needed)',
@@ -790,7 +872,7 @@ function resolveMode(args) {
 }
 
 // Export for testing
-if (typeof module !== 'undefined') module.exports = { resolveMode };
+if (typeof module !== 'undefined') module.exports = { resolveMode, setActionsVariable, scaffoldLiteTemplates, scaffoldFullTemplates };
 
 // ─── runLiteSetup ─────────────────────────────────────────────────────────────
 
@@ -849,6 +931,7 @@ async function runLiteSetup() {
   });
 
   copyAdapterFiles(agent, sourceDir, targetDir);
+  console.log(`${cyan}${i18n.upgrade_hint}${reset}`);
 
   rl.close();
 }
@@ -988,20 +1071,30 @@ async function runUpgradeToAgentic() {
     }
   }
 
-  // Auto-provision PROJECT_PAT for personal repos
+  // Auto-provision PROJECT_TOKEN for personal repos
   let patAutoSet = false;
   if (projectId && !isOrg) {
     try {
       const tokenOut = execFileSync('gh', ['auth', 'token'],
         { stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8' }).trim();
       if (tokenOut) {
-        execFileSync('gh', ['secret', 'set', 'PROJECT_PAT', '--body', tokenOut, '--repo', repo],
+        execFileSync('gh', ['secret', 'set', 'PROJECT_TOKEN', '--body', tokenOut, '--repo', repo],
           { stdio: ['ignore', 'pipe', 'pipe'] });
         patAutoSet = true;
-        console.log(`\n${green}✅ PROJECT_PAT secret set automatically (uses your gh OAuth token).${reset}`);
+        console.log(`\n${green}✅ PROJECT_TOKEN secret set automatically (uses your gh OAuth token).${reset}`);
       }
     } catch (_) {
-      console.log(`\n${yellow}⚠️  Could not auto-set PROJECT_PAT. Agent will guide manual setup.${reset}`);
+      console.log(`\n${yellow}⚠️  Could not auto-set PROJECT_TOKEN. Agent will guide manual setup.${reset}`);
+    }
+  }
+
+  // Set PROJECT_ID as GitHub Actions Variable
+  if (projectId) {
+    try {
+      setActionsVariable(repo, 'PROJECT_ID', projectId);
+      console.log(`${green}${i18n.vars_project_id_ok}${reset}`);
+    } catch (_) {
+      console.log(`${yellow}${i18n.vars_project_id_warn}${projectId}${reset}`);
     }
   }
 

package/docs/superpowers/plans/2026-06-05-archive-card-on-issue-close.md

@@ -0,0 +1,105 @@
+# Archive Board Card on Issue Close Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Archive the GitHub Project board card when an issue is closed, preventing stale cards from accumulating in active columns.
+
+**Architecture:** Single new job appended to `project-automation.yml` template. Triggers on the already-present `issues: closed` event. Uses `addProjectV2ItemById` (idempotent) then `archiveProjectV2Item` — handles both issues closed without a PR and issues closed via PR merge safely.
+
+**Tech Stack:** GitHub Actions, `actions/github-script@v8`, GitHub GraphQL API (`addProjectV2ItemById`, `archiveProjectV2Item`).
+
+---
+
+## File Map
+
+| Action | Path | Responsibility |
+|---|---|---|
+| Modify | `templates/.github/workflows/project-automation.yml` | Add `move-card-on-issue-close` job at end of file |
+
+No unit tests — YAML workflow template; correctness verified by grep and manual inspection.
+
+---
+
+### Task 1: Add `move-card-on-issue-close` job
+
+**Files:**
+- Modify: `templates/.github/workflows/project-automation.yml` (append after `cleanup-labels-on-close`)
+
+- [ ] **Step 1: Verify the insertion point**
+
+Run:
+```bash
+tail -5 templates/.github/workflows/project-automation.yml
+```
+
+Expected: last line is `console.log(\`Issue #\${issue_number} labels cleaned up\`);` followed by closing braces. The file ends after `cleanup-labels-on-close`.
+
+- [ ] **Step 2: Append the new job**
+
+At the end of `templates/.github/workflows/project-automation.yml`, add:
+
+```yaml
+
+  move-card-on-issue-close:
+    name: Closed issue → Archive from board
+    if: github.event_name == 'issues' && github.event.action == 'closed'
+    runs-on: ubuntu-latest
+    env:
+      PROJECT_TOKEN: ${{ secrets.PROJECT_TOKEN }}
+    steps:
+      - name: Archive board card
+        if: ${{ env.PROJECT_TOKEN != '' && env.PROJECT_ID != '' }}
+        uses: actions/github-script@v8
+        with:
+          github-token: ${{ env.PROJECT_TOKEN }}
+          script: |
+            const nodeId = context.payload.issue.node_id;
+            let itemId;
+            try {
+              const added = await github.graphql(`
+                mutation($p: ID!, $c: ID!) {
+                  addProjectV2ItemById(input: {projectId: $p, contentId: $c}) { item { id } }
+                }`, { p: process.env.PROJECT_ID, c: nodeId });
+              itemId = added.addProjectV2ItemById.item.id;
+            } catch (e) {
+              console.log(`Could not add issue to project: ${e.message}`);
+              return;
+            }
+            await github.graphql(`
+              mutation($p: ID!, $i: ID!) {
+                archiveProjectV2Item(input: {projectId: $p, itemId: $i}) { item { id } }
+              }`, { p: process.env.PROJECT_ID, i: itemId });
+            console.log(`Issue #${context.payload.issue.number} archived from board`);
+```
+
+- [ ] **Step 3: Verify job was added and file is syntactically correct**
+
+Run:
+```bash
+grep -n "move-card-on-issue-close\|archiveProjectV2Item" templates/.github/workflows/project-automation.yml
+```
+
+Expected: two matches — the job name line and the mutation name.
+
+Run:
+```bash
+python3 -c "import yaml, sys; yaml.safe_load(open('templates/.github/workflows/project-automation.yml'))" 2>&1
+```
+
+Expected: no output (valid YAML).
+
+- [ ] **Step 4: Verify guard condition matches existing pattern**
+
+Run:
+```bash
+grep "PROJECT_TOKEN != ''" templates/.github/workflows/project-automation.yml
+```
+
+Expected: multiple lines including the new job — confirms guard is consistent with other jobs.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add templates/.github/workflows/project-automation.yml
+git commit -m "feat(templates): archive board card when issue is closed"
+```