@thiagodiogo/pscode 2.0.0 → 2.1.0

package/dist/core/templates/workflows/trello-draft.js

@@ -9,200 +9,200 @@ export function getTrelloDraftSkillTemplate() {
     };
 }
 function getTrelloDraftInstructions() {
-    return `Capture uma ideia ou conceito bruto diretamente no Backlog do Trello.
-
-**Input**: Texto após \`/ps:draft\` é a descrição da ideia (pode ser bem rascunho — palavras soltas, fragmentos, intuições vagas).
-Se omitido, perguntar ao usuário.
-
-Este comando é intencionalmente sem atrito. Diferente de \`/ps:task\`, faz estruturação mínima — o objetivo é velocidade de captura, não clareza.
-
----
-
-## Step 1 — Read Trello config
-
-Use the **Read tool** (NOT a shell command) to read \`pscode/trello.yaml\` from the current working directory.
-The Read tool is cross-platform and works on Windows, macOS, and Linux — never use \`cat\` or shell commands to read this file.
-If the Read tool returns an error (file not found), treat it as "NO_TRELLO_CONFIG".
-
-**If file not found:**
-> ⚠️ Trello não está configurado neste projeto.
-> Execute \`/ps:trello-setup\` para configurar a integração antes de usar este comando.
-
-Stop here if no config.
-
-Parse the YAML and extract:
-- \`boardId\`
-- \`lists.backlog.id\` → the list where the card will be created
-- \`lists.backlog.name\` → for display purposes
-- \`labels\` → \`{ enabled: bool, items?: { bug, implementacao, melhoria, debito-tecnico } }\`
-
-**If \`lists.backlog\` is not configured:**
-> ⚠️ Estágio "backlog" não está configurado em \`pscode/trello.yaml\`.
->
-> Execute \`/ps:trello-setup\` para configurar a integração.
-
-Stop here if backlog list is missing.
-
----
-
-## Step 2 — Collect the idea
-
-If the user provided text, use it as-is.
-
-If nothing was provided, use **AskUserQuestion** to ask:
-> "Qual ideia você quer registrar? (pode ser bem rascunho mesmo)"
-
----
-
-## Step 3 — Minimal structuring
-
-Apply only light formatting. Do NOT over-engineer — this is a draft.
-
-Produce:
-
-**a. \`title\`** — The idea in up to ~80 chars, starting with a noun or verb.
-  - Keep the user's original wording as much as possible
-  - **No emojis** in the title
-
-**b. \`context\`** (optional, 1–2 sentences max) — Only add if there's obvious project context to attach.
-  If the idea is self-contained or opaque, leave blank.
-
----
-
-## Step 4 — Detect label (if labels enabled)
-
-**Only run this step if \`labels.enabled = true\` and \`labels.items\` is present in config.**
-
-Analyze the idea text and title to determine which label best fits.
-Use these classification rules:
-
-| Label           | Quando usar                                                                 |
-|-----------------|-----------------------------------------------------------------------------|
-| 🐛 BUG          | Menciona erro, falha, bug, quebrado, não funciona, comportamento errado      |
-| ⚙️ IMPLEMENTAÇÃO | Nova feature, adicionar, criar, implementar algo que não existe ainda        |
-| ✨ MELHORIA      | Melhorar, otimizar, refinar, aprimorar algo que já existe                   |
-| 💳 DÉBITO TÉCNICO | Refatorar, limpar, reorganizar, remover código legado, dívida técnica       |
-
-**Decision logic:**
-
-1. If the idea clearly matches one label with high confidence (>80%) → use it silently, without asking.
-2. If the idea is ambiguous or could fit 2+ labels → use **AskUserQuestion** to ask:
-   > "Que tipo de card é esse?"
-   > - 🐛 BUG — Erro ou comportamento incorreto
-   > - ⚙️ IMPLEMENTAÇÃO — Nova funcionalidade
-   > - ✨ MELHORIA — Aperfeiçoamento de algo existente
-   > - 💳 DÉBITO TÉCNICO — Refatoração e limpeza de código
-   > - Sem label — Não categorizar
-
-3. If the label key chosen is not in \`labels.items\` (user may have configured a subset), skip labeling.
-
-Save the resolved label as \`chosenLabel\` (or \`null\` if no label applies or user chose "Sem label").
-
----
-
-## Step 5 — Assemble the card description
-
-**No emojis anywhere in the description.**
-
-If context is present:
-\`\`\`
-<context>
-
----
-Ideia original: "<raw input verbatim>"
-
-Proximo passo: /ps:propose para refinar e gerar os artefatos da change.
-\`\`\`
-
-If no context:
-\`\`\`
-Ideia original: "<raw input verbatim>"
-
-Proximo passo: /ps:propose para refinar e gerar os artefatos da change.
-\`\`\`
-
----
-
-## Step 6 — Create the card
-
-\`\`\`tool
-mcp__claude_ai_Trello_Custom__create_card
-  list_id: "<lists.backlog.id>"
-  name: "<title>"
-  desc: "<assembled description>"
-\`\`\`
-
-**Do NOT assign any member.**
-
-Save the returned card \`id\` as \`cardId\` and \`url\` as \`cardUrl\`.
-
----
-
-## Step 7 — Add next-step comment
-
-Add a comment to the card with the command to take this task to the next stage,
-formatted in Markdown so it is easy to copy and paste.
-
-\`\`\`tool
-mcp__claude_ai_Trello_Custom__add_comment
-  card_id: "<cardId>"
-  text: |
-    ## Próximo passo
-
-    Para refinar e gerar os artefatos da change, rode:
-
-    \`\`\`
-    /ps:propose
-    \`\`\`
-\`\`\`
-
-If this call fails, log the error and continue — the comment is auxiliary, never blocking.
-
----
-
-## Step 8 — Apply label (if resolved)
-
-**Only if \`chosenLabel\` is not null:**
-
-\`\`\`tool
-mcp__claude_ai_Trello_Custom__add_label_to_card
-  card_id: "<cardId>"
-  label_id: "<chosenLabel.id>"
-\`\`\`
-
-If this call fails, log the error and continue — label is auxiliary, never blocking.
-
----
-
-## Step 9 — Show summary
-
-\`\`\`
-## Ideia registrada ✓
-
-**Título:** <title>
-**Lista:** <lists.backlog.name>
-**Label:** <chosenLabel emoji + name> (ou "sem label" se não aplicada)
-**Card:** <cardUrl>
-
-Comando da próxima etapa adicionado nos comentários do card.
-Sem responsável atribuído.
-Quando quiser refinar: \`/ps:explore\` ou \`/ps:task\`
-Quando quiser propor diretamente: \`/ps:propose\`
-\`\`\`
-
----
-
-## Guardrails
-
-- **Mínima intervenção** — o valor deste comando é a velocidade de captura; não refinar demais
-- **Preservar o texto original** verbatim na descrição
-- **Nunca atribuir membro** — cards de draft são sempre sem dono
-- **Nunca criar change** (\`pscode new change\`) — este comando é apenas Trello
-- **Se MCP falhar**, exibir o conteúdo no chat para registro manual
-- **Título em português** por padrão, mas se o usuário escreveu em inglês, manter em inglês
-- **Labels são opcionais** — se \`labels.enabled = false\` ou o call MCP falhar, continuar sem label
-- **Comentário com o comando da próxima etapa é auxiliar** — se o MCP falhar ao comentar, não bloquear a criação do card
-- **Perguntar sobre label apenas quando ambíguo** — para ideias claras, classificar silenciosamente
+    return `Capture uma ideia ou conceito bruto diretamente no Backlog do Trello.
+
+**Input**: Texto após \`/ps:draft\` é a descrição da ideia (pode ser bem rascunho — palavras soltas, fragmentos, intuições vagas).
+Se omitido, perguntar ao usuário.
+
+Este comando é intencionalmente sem atrito. Diferente de \`/ps:task\`, faz estruturação mínima — o objetivo é velocidade de captura, não clareza.
+
+---
+
+## Step 1 — Read Trello config
+
+Use the **Read tool** (NOT a shell command) to read \`pscode/trello.yaml\` from the current working directory.
+The Read tool is cross-platform and works on Windows, macOS, and Linux — never use \`cat\` or shell commands to read this file.
+If the Read tool returns an error (file not found), treat it as "NO_TRELLO_CONFIG".
+
+**If file not found:**
+> ⚠️ Trello não está configurado neste projeto.
+> Execute \`/ps:trello-setup\` para configurar a integração antes de usar este comando.
+
+Stop here if no config.
+
+Parse the YAML and extract:
+- \`boardId\`
+- \`lists.backlog.id\` → the list where the card will be created
+- \`lists.backlog.name\` → for display purposes
+- \`labels\` → \`{ enabled: bool, items?: { bug, implementacao, melhoria, debito-tecnico } }\`
+
+**If \`lists.backlog\` is not configured:**
+> ⚠️ Estágio "backlog" não está configurado em \`pscode/trello.yaml\`.
+>
+> Execute \`/ps:trello-setup\` para configurar a integração.
+
+Stop here if backlog list is missing.
+
+---
+
+## Step 2 — Collect the idea
+
+If the user provided text, use it as-is.
+
+If nothing was provided, use **AskUserQuestion** to ask:
+> "Qual ideia você quer registrar? (pode ser bem rascunho mesmo)"
+
+---
+
+## Step 3 — Minimal structuring
+
+Apply only light formatting. Do NOT over-engineer — this is a draft.
+
+Produce:
+
+**a. \`title\`** — The idea in up to ~80 chars, starting with a noun or verb.
+  - Keep the user's original wording as much as possible
+  - **No emojis** in the title
+
+**b. \`context\`** (optional, 1–2 sentences max) — Only add if there's obvious project context to attach.
+  If the idea is self-contained or opaque, leave blank.
+
+---
+
+## Step 4 — Detect label (if labels enabled)
+
+**Only run this step if \`labels.enabled = true\` and \`labels.items\` is present in config.**
+
+Analyze the idea text and title to determine which label best fits.
+Use these classification rules:
+
+| Label           | Quando usar                                                                 |
+|-----------------|-----------------------------------------------------------------------------|
+| 🐛 BUG          | Menciona erro, falha, bug, quebrado, não funciona, comportamento errado      |
+| ⚙️ IMPLEMENTAÇÃO | Nova feature, adicionar, criar, implementar algo que não existe ainda        |
+| ✨ MELHORIA      | Melhorar, otimizar, refinar, aprimorar algo que já existe                   |
+| 💳 DÉBITO TÉCNICO | Refatorar, limpar, reorganizar, remover código legado, dívida técnica       |
+
+**Decision logic:**
+
+1. If the idea clearly matches one label with high confidence (>80%) → use it silently, without asking.
+2. If the idea is ambiguous or could fit 2+ labels → use **AskUserQuestion** to ask:
+   > "Que tipo de card é esse?"
+   > - 🐛 BUG — Erro ou comportamento incorreto
+   > - ⚙️ IMPLEMENTAÇÃO — Nova funcionalidade
+   > - ✨ MELHORIA — Aperfeiçoamento de algo existente
+   > - 💳 DÉBITO TÉCNICO — Refatoração e limpeza de código
+   > - Sem label — Não categorizar
+
+3. If the label key chosen is not in \`labels.items\` (user may have configured a subset), skip labeling.
+
+Save the resolved label as \`chosenLabel\` (or \`null\` if no label applies or user chose "Sem label").
+
+---
+
+## Step 5 — Assemble the card description
+
+**No emojis anywhere in the description.**
+
+If context is present:
+\`\`\`
+<context>
+
+---
+Ideia original: "<raw input verbatim>"
+
+Proximo passo: /ps:propose para refinar e gerar os artefatos da change.
+\`\`\`
+
+If no context:
+\`\`\`
+Ideia original: "<raw input verbatim>"
+
+Proximo passo: /ps:propose para refinar e gerar os artefatos da change.
+\`\`\`
+
+---
+
+## Step 6 — Create the card
+
+\`\`\`tool
+mcp__claude_ai_Trello_Custom__create_card
+  list_id: "<lists.backlog.id>"
+  name: "<title>"
+  desc: "<assembled description>"
+\`\`\`
+
+**Do NOT assign any member.**
+
+Save the returned card \`id\` as \`cardId\` and \`url\` as \`cardUrl\`.
+
+---
+
+## Step 7 — Add next-step comment
+
+Add a comment to the card with the command to take this task to the next stage,
+formatted in Markdown so it is easy to copy and paste.
+
+\`\`\`tool
+mcp__claude_ai_Trello_Custom__add_comment
+  card_id: "<cardId>"
+  text: |
+    ## Próximo passo
+
+    Para refinar e gerar os artefatos da change, rode:
+
+    \`\`\`
+    /ps:propose
+    \`\`\`
+\`\`\`
+
+If this call fails, log the error and continue — the comment is auxiliary, never blocking.
+
+---
+
+## Step 8 — Apply label (if resolved)
+
+**Only if \`chosenLabel\` is not null:**
+
+\`\`\`tool
+mcp__claude_ai_Trello_Custom__add_label_to_card
+  card_id: "<cardId>"
+  label_id: "<chosenLabel.id>"
+\`\`\`
+
+If this call fails, log the error and continue — label is auxiliary, never blocking.
+
+---
+
+## Step 9 — Show summary
+
+\`\`\`
+## Ideia registrada ✓
+
+**Título:** <title>
+**Lista:** <lists.backlog.name>
+**Label:** <chosenLabel emoji + name> (ou "sem label" se não aplicada)
+**Card:** <cardUrl>
+
+Comando da próxima etapa adicionado nos comentários do card.
+Sem responsável atribuído.
+Quando quiser refinar: \`/ps:explore\` ou \`/ps:task\`
+Quando quiser propor diretamente: \`/ps:propose\`
+\`\`\`
+
+---
+
+## Guardrails
+
+- **Mínima intervenção** — o valor deste comando é a velocidade de captura; não refinar demais
+- **Preservar o texto original** verbatim na descrição
+- **Nunca atribuir membro** — cards de draft são sempre sem dono
+- **Nunca criar change** (\`pscode new change\`) — este comando é apenas Trello
+- **Se MCP falhar**, exibir o conteúdo no chat para registro manual
+- **Título em português** por padrão, mas se o usuário escreveu em inglês, manter em inglês
+- **Labels são opcionais** — se \`labels.enabled = false\` ou o call MCP falhar, continuar sem label
+- **Comentário com o comando da próxima etapa é auxiliar** — se o MCP falhar ao comentar, não bloquear a criação do card
+- **Perguntar sobre label apenas quando ambíguo** — para ideias claras, classificar silenciosamente
 `;
 }
 export function getTrelloDraftCommandTemplate() {

package/dist/core/templates/workflows/trello-next-step-comment.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Trello Next-Step Comment Utility
+ *
+ * Builds and posts a Trello comment at the end of each workflow step,
+ * showing the exact command (with card title pre-filled) to advance
+ * to the next stage.
+ *
+ * Usage: import buildNextStepComment and call it with the current stage
+ * and card title. Post the result via mcp__claude_ai_Trello_Custom__add_comment.
+ */
+export type WorkflowStage = 'draft' | 'explore' | 'propose' | 'apply';
+/**
+ * Returns the markdown text for the next-step comment.
+ * Paste this into mcp__claude_ai_Trello_Custom__add_comment as `text`.
+ */
+export declare function buildNextStepComment(stage: WorkflowStage, cardTitle: string): string;
+/**
+ * Returns the instruction block to be embedded inside a workflow template.
+ * Tells the AI agent how and when to post the next-step comment.
+ *
+ * @param stage   The current workflow stage (determines which command appears)
+ * @param titleVar The template variable name that holds the card title at runtime
+ *                 (e.g. "<title>", "<cardTitle>"). Default: "<title>"
+ */
+export declare function getNextStepCommentInstructionBlock(stage: WorkflowStage, titleVar?: string): string;
+//# sourceMappingURL=trello-next-step-comment.d.ts.map

package/dist/core/templates/workflows/trello-next-step-comment.js

@@ -0,0 +1,58 @@
+/**
+ * Trello Next-Step Comment Utility
+ *
+ * Builds and posts a Trello comment at the end of each workflow step,
+ * showing the exact command (with card title pre-filled) to advance
+ * to the next stage.
+ *
+ * Usage: import buildNextStepComment and call it with the current stage
+ * and card title. Post the result via mcp__claude_ai_Trello_Custom__add_comment.
+ */
+const NEXT_STEP = {
+    draft: { command: 'ps:propose', label: 'Refinar e gerar os artefatos da change' },
+    explore: { command: 'ps:propose', label: 'Propor a change com todos os artefatos' },
+    propose: { command: 'ps:apply', label: 'Implementar as tasks da change' },
+    apply: { command: 'ps:complete', label: 'Finalizar e sincronizar a change' },
+};
+/**
+ * Returns the markdown text for the next-step comment.
+ * Paste this into mcp__claude_ai_Trello_Custom__add_comment as `text`.
+ */
+export function buildNextStepComment(stage, cardTitle) {
+    const next = NEXT_STEP[stage];
+    const escapedTitle = cardTitle.replace(/"/g, '\\"');
+    return `**Avançar etapa:** ${next.label}
+
+\`\`\`
+/${next.command} "${escapedTitle}"
+\`\`\``;
+}
+/**
+ * Returns the instruction block to be embedded inside a workflow template.
+ * Tells the AI agent how and when to post the next-step comment.
+ *
+ * @param stage   The current workflow stage (determines which command appears)
+ * @param titleVar The template variable name that holds the card title at runtime
+ *                 (e.g. "<title>", "<cardTitle>"). Default: "<title>"
+ */
+export function getNextStepCommentInstructionBlock(stage, titleVar = '<title>') {
+    const next = NEXT_STEP[stage];
+    const escapedTitleVar = titleVar.replace(/"/g, '\\"');
+    return `## Step — Add next-step comment
+
+Post a comment on the card so the team always has the ready-to-paste command for the next stage.
+
+\`\`\`tool
+mcp__claude_ai_Trello_Custom__add_comment
+  card_id: "<cardId>"
+  text: |
+    **Avançar etapa:** ${next.label}
+
+    \`\`\`
+    /${next.command} "${escapedTitleVar}"
+    \`\`\`
+\`\`\`
+
+If this call fails, log the error and continue — the comment is auxiliary, never blocking.`;
+}
+//# sourceMappingURL=trello-next-step-comment.js.map