@spec-wave/cli 0.5.3 → 0.5.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spec-wave/cli",
-  "version": "0.5.3",
+  "version": "0.5.7",
   "description": "Setup spec-driven GitHub workflow with Projects v2, labels, issue templates, and AI-powered Actions",
   "type": "module",
   "bin": {

package/src/commands/code-review.mjs

@@ -69,6 +69,7 @@ async function setCodeReview(token, project, etapaField, statusField, nodeId) {
 
 export async function codeReview({ prNumber }) {
   const token = await resolveToken();
+  const projectToken = process.env.PROJECT_TOKEN || token;
   const [envOwner, envRepo] = (process.env.GITHUB_REPOSITORY || '').split('/');
   const cfgPath = path.join(process.cwd(), CONFIG_FILE);
   let cfg = {};
@@ -110,8 +111,8 @@ export async function codeReview({ prNumber }) {
   }
 
   // Resolve campos uma vez, reutiliza em todas as Features.
-  const etapaField = await resolveField(token, project, 'Etapa').catch(() => null);
-  const statusField = await resolveField(token, project, 'Status').catch(() => null);
+  const etapaField = await resolveField(projectToken, project, 'Etapa').catch(() => null);
+  const statusField = await resolveField(projectToken, project, 'Status').catch(() => null);
 
   const seen = new Set();
   const updated = [];
@@ -121,7 +122,7 @@ export async function codeReview({ prNumber }) {
     if (!feature || seen.has(feature.number)) continue;
     seen.add(feature.number);
     try {
-      await setCodeReview(token, project, etapaField, statusField, feature.node_id);
+      await setCodeReview(projectToken, project, etapaField, statusField, feature.node_id);
       updated.push(`#${feature.number} ${feature.title}`);
       console.log(`Feature #${feature.number} → "${CODE_REVIEW_STAGE}" / Status "${TODO_STATUS}".`);
     } catch (err) {

package/src/commands/decompose.mjs

@@ -65,6 +65,9 @@ Regras:
 
 export async function decompose({ issueNumber }) {
   const token = await resolveToken();
+  // PROJECT_TOKEN deve ter scope "project" para atualizar GitHub Projects v2.
+  // Fallback para GITHUB_TOKEN (só funciona em repos pessoais sem org restrictions).
+  const projectToken = process.env.PROJECT_TOKEN || token;
   const [owner, repo] = (process.env.GITHUB_REPOSITORY || '').split('/');
 
   if (!owner || !repo) {
@@ -83,7 +86,7 @@ export async function decompose({ issueNumber }) {
   let statusField = null;
   if (project?.id && READY_STAGE) {
     try {
-      statusField = await resolveStatusField(token, project);
+      statusField = await resolveStatusField(projectToken, project);
     } catch (err) {
       console.warn(`Não foi possível resolver campo Status do board: ${err.message}`);
     }
@@ -144,7 +147,7 @@ export async function decompose({ issueNumber }) {
 
     // Move story para Ready no board.
     try {
-      await moveToStage(token, project, statusField, createdStory.nodeId, READY_STAGE);
+      await moveToStage(projectToken, project, statusField, createdStory.nodeId, READY_STAGE);
     } catch (err) {
       console.warn(`  Falha ao mover story #${createdStory.number} para "${READY_STAGE}": ${err.message}`);
     }
@@ -164,7 +167,7 @@ export async function decompose({ issueNumber }) {
 
       // Move task para Ready no board.
       try {
-        await moveToStage(token, project, statusField, createdTask.nodeId, READY_STAGE);
+        await moveToStage(projectToken, project, statusField, createdTask.nodeId, READY_STAGE);
       } catch (err) {
         console.warn(`    Falha ao mover task #${createdTask.number} para "${READY_STAGE}": ${err.message}`);
       }
@@ -173,7 +176,7 @@ export async function decompose({ issueNumber }) {
 
   // Move a própria Feature para Ready no board.
   try {
-    await moveToStage(token, project, statusField, featureNodeId, READY_STAGE);
+    await moveToStage(projectToken, project, statusField, featureNodeId, READY_STAGE);
     if (project?.id && statusField) console.log(`Feature movida para "${READY_STAGE}" no board.`);
   } catch (err) {
     console.warn(`Falha ao mover Feature para "${READY_STAGE}": ${err.message}`);

package/src/commands/generate-plan.mjs

@@ -85,7 +85,7 @@ export async function generatePlan({ issueNumber }) {
   await commentOnIssue(
     token, owner, repo, parseInt(issueNumber, 10),
     `📋 **plan.md gerado automaticamente!**\n\n` +
-    `📄 Arquivo: [\`${filePath}\`](${filePath})\n\n` +
+    `📄 Arquivo: [\`${filePath}\`](https://github.com/${owner}/${repo}/blob/main/${filePath})\n\n` +
     `Revise o plano e, quando estiver pronto, valide a Feature: mova o card para **✅ Ready** ou use:\n` +
     `\`\`\`\ngh issue edit ${issueNumber} --add-label "spec-wave:ready"\n\`\`\``
   );

package/src/commands/generate-spec.mjs

@@ -78,7 +78,7 @@ export async function generateSpec({ issueNumber }) {
   await commentOnIssue(
     token, owner, repo, parseInt(issueNumber, 10),
     `📋 **spec.md gerado automaticamente!**\n\n` +
-    `📄 Arquivo: [\`${filePath}\`](${filePath})\n\n` +
+    `📄 Arquivo: [\`${filePath}\`](https://github.com/${owner}/${repo}/blob/main/${filePath})\n\n` +
     `Revise a especificação e, quando estiver pronto, gere o plano técnico: mova o card para **📋 Plan** ou use:\n` +
     `\`\`\`\ngh issue edit ${issueNumber} --add-label "spec-wave:plan"\n\`\`\``
   );

package/src/commands/qa.mjs

@@ -64,6 +64,7 @@ async function setQA(token, project, etapaField, statusField, nodeId) {
 
 export async function qa({ prNumber }) {
   const token = await resolveToken();
+  const projectToken = process.env.PROJECT_TOKEN || token;
   const [envOwner, envRepo] = (process.env.GITHUB_REPOSITORY || '').split('/');
   const cfgPath = path.join(process.cwd(), CONFIG_FILE);
   let cfg = {};
@@ -103,8 +104,8 @@ export async function qa({ prNumber }) {
     return;
   }
 
-  const etapaField = await resolveField(token, project, 'Etapa').catch(() => null);
-  const statusField = await resolveField(token, project, 'Status').catch(() => null);
+  const etapaField = await resolveField(projectToken, project, 'Etapa').catch(() => null);
+  const statusField = await resolveField(projectToken, project, 'Status').catch(() => null);
 
   const seen = new Set();
   const updated = [];
@@ -114,7 +115,7 @@ export async function qa({ prNumber }) {
     if (!feature || seen.has(feature.number)) continue;
     seen.add(feature.number);
     try {
-      await setQA(token, project, etapaField, statusField, feature.node_id);
+      await setQA(projectToken, project, etapaField, statusField, feature.node_id);
       updated.push(`#${feature.number} ${feature.title}`);
       console.log(`Feature #${feature.number} → "${QA_STAGE}" / Status "${TODO_STATUS}".`);
     } catch (err) {

package/src/templates/workflows/code-review.yml

@@ -17,10 +17,11 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
 
       - name: Move Feature to Code Review
         run: npx @spec-wave/cli code-review --pr-number ${{ github.event.pull_request.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PROJECT_TOKEN: ${{ secrets.GH_PROJECT_TOKEN }}
           GITHUB_REPOSITORY: ${{ github.repository }}

package/src/templates/workflows/decompose.yml

@@ -19,12 +19,13 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
 
       - name: Decompose into Stories and Tasks
         run: npx @spec-wave/cli decompose --issue-number ${{ github.event.issue.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PROJECT_TOKEN: ${{ secrets.GH_PROJECT_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
           OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
           GITHUB_REPOSITORY: ${{ github.repository }}

package/src/templates/workflows/generate-plan.yml

@@ -21,7 +21,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
 
       - name: Generate plan.md
         run: npx @spec-wave/cli generate-plan --issue-number ${{ github.event.issue.number }}

package/src/templates/workflows/generate-spec.yml

@@ -21,7 +21,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
 
       - name: Generate spec.md
         run: npx @spec-wave/cli generate-spec --issue-number ${{ github.event.issue.number }}

package/src/templates/workflows/qa.yml

@@ -18,10 +18,11 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
 
       - name: Move Feature to QA
         run: npx @spec-wave/cli qa --pr-number ${{ github.event.pull_request.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PROJECT_TOKEN: ${{ secrets.GH_PROJECT_TOKEN }}
           GITHUB_REPOSITORY: ${{ github.repository }}

package/src/templates/workflows/validate.yml

@@ -12,13 +12,14 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       issues: write
+      contents: read
 
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
 
       - name: Validate spec and plan
         run: npx @spec-wave/cli validate --issue-number ${{ github.event.issue.number }}