spec-first-copilot 0.6.0-beta.3 → 0.6.0-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spec-first-copilot",
3
- "version": "0.6.0-beta.3",
3
+ "version": "0.6.0-beta.4",
4
4
  "description": "Spec-first workflow kit for GitHub Copilot — AI-driven development with specs, not guesswork",
5
5
  "bin": {
6
6
  "spec-first-copilot": "bin/cli.js"
@@ -8,6 +8,22 @@
8
8
 
9
9
  ---
10
10
 
11
+ ## 0.6.0-beta.4 (2026-04-13)
12
+
13
+ ### UX: `/sf-mcp confluence` self-contained pra usuário leigo
14
+
15
+ Perguntas do skill agora mostram EXATAMENTE onde achar cada informação inline,
16
+ sem depender de consulta externa ao SETUP.md:
17
+
18
+ - **URL do Confluence**: "abra no browser, copie URL base com /wiki"
19
+ - **API Token**: 4 sub-passos numerados (URL Atlassian, Create button, nome, copiar antes que suma)
20
+ - **Space Key**: mostra URL pattern `/wiki/spaces/XXX/` com seta + exemplos ("ST", "DEV", "PROJ")
21
+ - **Root Page ID**: 2 opções (A: Page ID com URL pattern `/pages/NNNN/`, B: título exato com aviso de match)
22
+
23
+ Qualquer modelo / usuário leigo consegue responder sem ficar travado.
24
+
25
+ ---
26
+
11
27
  ## 0.6.0-beta.3 (2026-04-13)
12
28
 
13
29
  ### Fix: `/sf-mcp confluence` idempotente com `root_page_id` como âncora
@@ -66,20 +66,37 @@ Depois rode /sf-mcp confluence novamente.
66
66
 
67
67
  #### 3.2 Se FALTA credenciais (`.mcp.json` ausente ou incompleto)
68
68
 
69
- Perguntar uma por uma:
69
+ Perguntar uma por uma. Pra cada item, mostrar ao user exatamente ONDE achar:
70
70
  ```
71
71
  Configurando acesso ao Confluence.
72
72
 
73
- 1. URL do Confluence (ex: https://sua-empresa.atlassian.net/wiki):
73
+ 1. URL do Confluence
74
+ Abra o Confluence no browser. A URL base é algo como:
75
+ https://sua-empresa.atlassian.net/wiki
76
+ Cole essa URL (com /wiki no final):
74
77
  >
75
78
 
76
- 2. Email da conta Atlassian:
79
+ 2. Email da conta Atlassian
80
+ É o email que você usa pra logar no Atlassian (não é o token).
77
81
  >
78
82
 
79
- 3. API Token (https://id.atlassian.com/manage-profile/security/api-tokens):
83
+ 3. API Token
84
+ Token é diferente de senha. Gere um novo:
85
+ a) Abra https://id.atlassian.com/manage-profile/security/api-tokens
86
+ b) Clique "Create API token"
87
+ c) Dê um nome (ex: "sfw-mcp")
88
+ d) Copie o token que aparece — ele só aparece UMA VEZ
89
+ Cole aqui:
80
90
  >
81
91
 
82
- 4. Space Key (letras na URL: /wiki/spaces/XX/...):
92
+ 4. Space Key
93
+ É o código CURTO do seu espaço Confluence (geralmente 2-4 letras maiúsculas).
94
+ Abra qualquer page do seu espaço. Na URL, você verá:
95
+ https://...atlassian.net/wiki/spaces/XXX/pages/...
96
+ ^^^
97
+ esse é o Space Key
98
+ Exemplos comuns: "ST", "DEV", "PROJ", "ENG"
99
+ Qual é o seu?:
83
100
  >
84
101
  ```
85
102
 
@@ -127,7 +144,22 @@ Se OK:
127
144
  Conexão OK.
128
145
 
129
146
  Qual é a page RAIZ do seu projeto no Confluence?
130
- Cole o Page ID (número na URL) ou o título exato:
147
+ (A page-mãe que contém TUDO do projeto geralmente tem Input e Output como filhas.)
148
+
149
+ Duas formas de informar:
150
+
151
+ A) Page ID (recomendado — mais confiável):
152
+ Abra a page raiz no Confluence. A URL mostra:
153
+ https://...atlassian.net/wiki/spaces/ST/pages/65708/Nome-da-Page
154
+ ^^^^^
155
+ esse número é o Page ID
156
+ Cole só o número (ex: 65708).
157
+
158
+ B) Título exato:
159
+ O título que aparece no topo da page. Tem que bater EXATAMENTE
160
+ (incluindo acentos e maiúsculas/minúsculas).
161
+
162
+ Page ID ou título:
131
163
  >
132
164
  ```
133
165