oxe-cc 1.2.1 → 1.4.0

package/vscode-extension/src/shared/contextLoader.js

@@ -1,137 +1,137 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-/**
- * Tenta parsear JSON do stdout do oxe-cc (pula linhas de banner antes do `{`).
- * @param {string} stdout
- * @returns {object | null}
- */
-function parseJsonFromOutput(stdout) {
-  if (!stdout) return null;
-  const text = String(stdout).trim();
-  const jsonStart = text.indexOf('{');
-  if (jsonStart === -1) return null;
-  try {
-    return JSON.parse(text.slice(jsonStart));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Tenta resolver o context pack via oxe-cc CLI.
- * Primeiro tenta o binário local em node_modules, depois npx global.
- * @param {string} projectRoot
- * @param {string} workflow
- * @returns {object | null}
- */
-function resolveViaOxeCc(projectRoot, workflow) {
-  const localBin = path.join(projectRoot, 'node_modules', 'oxe-cc', 'bin', 'oxe-cc.js');
-  const args = ['context', 'inspect', '--workflow', workflow, '--json', '--dir', projectRoot];
-  const env = { ...process.env, OXE_NO_BANNER: '1' };
-  const opts = { cwd: projectRoot, encoding: 'utf8', timeout: 12000, env };
-
-  // Tentativa 1 — binário local
-  if (fs.existsSync(localBin)) {
-    const r = spawnSync(process.execPath, [localBin, ...args], opts);
-    if (r.status === 0) {
-      const pack = parseJsonFromOutput(r.stdout);
-      if (pack) return pack;
-    }
-  }
-
-  // Tentativa 2 — npx (global ou cache)
-  const npxCmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';
-  const r = spawnSync(npxCmd, ['oxe-cc', ...args], opts);
-  if (r.status === 0) {
-    return parseJsonFromOutput(r.stdout);
-  }
-
-  return null;
-}
-
-/**
- * Carrega o context pack para um workflow. Tenta disco primeiro, depois CLI.
- * @param {string} projectRoot
- * @param {string} workflow
- * @returns {object | null}
- */
-function loadContextPack(projectRoot, workflow) {
-  // Tentativa 1 — ler pack já materializado em disco
-  const packPath = path.join(projectRoot, '.oxe', 'context', 'packs', `${workflow}.json`);
-  if (fs.existsSync(packPath)) {
-    try {
-      const data = JSON.parse(fs.readFileSync(packPath, 'utf8'));
-      if (data && data.workflow) return data;
-    } catch {
-      // arquivo corrompido → tenta CLI
-    }
-  }
-
-  // Tentativa 2 — resolver on-demand via oxe-cc
-  return resolveViaOxeCc(projectRoot, workflow);
-}
-
-/**
- * Formata os artefatos selecionados do pack em markdown legível.
- * Usa semantic_summary quando disponível, cai para summary.
- * @param {object | null} pack
- * @returns {string}
- */
-function formatArtifacts(pack) {
-  if (!pack || !Array.isArray(pack.selected_artifacts)) return '';
-
-  const artifacts = pack.selected_artifacts
-    .filter((a) => a.exists && (a.semantic_summary || a.summary))
-    .map((a) => {
-      const content = (a.semantic_summary || a.summary || '').trim();
-      if (!content) return null;
-      const label = a.alias.replace(/_/g, ' ');
-      const flags = [
-        a.using_fallback ? '[fallback]' : '',
-        a.required ? '[obrigatório]' : '',
-      ].filter(Boolean).join(' ');
-      return `### ${label}${flags ? ' ' + flags : ''}\n${content}`;
-    })
-    .filter(Boolean);
-
-  return artifacts.length > 0 ? artifacts.join('\n\n') : '';
-}
-
-/**
- * Formata hipóteses pendentes do pack para o system prompt.
- * @param {object | null} pack
- * @returns {string}
- */
-function formatHypotheses(pack) {
-  if (!pack || !Array.isArray(pack.hypotheses)) return '';
-  const pending = pack.hypotheses.filter((h) => h.status === 'pending');
-  if (pending.length === 0) return '';
-  const lines = pending.map((h) =>
-    `- **[${h.id}]** ${h.condition}${h.checkpoint ? ` *(checkpoint: ${h.checkpoint})*` : ''}`
-  );
-  return `## Hipóteses críticas pendentes\n\n${lines.join('\n')}`;
-}
-
-/**
- * Formata gaps críticos do pack.
- * @param {object | null} pack
- * @returns {string}
- */
-function formatGaps(pack) {
-  if (!pack || !Array.isArray(pack.gaps)) return '';
-  const critical = pack.gaps.filter((g) => g.severity === 'critical');
-  if (critical.length === 0) return '';
-  const lines = critical.map((g) => `- \`${g.alias}\`: ${g.reason}`);
-  return `## Artefatos críticos ausentes\n\n${lines.join('\n')}`;
-}
-
-module.exports = {
-  loadContextPack,
-  formatArtifacts,
-  formatHypotheses,
-  formatGaps,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+/**
+ * Tenta parsear JSON do stdout do oxe-cc (pula linhas de banner antes do `{`).
+ * @param {string} stdout
+ * @returns {object | null}
+ */
+function parseJsonFromOutput(stdout) {
+  if (!stdout) return null;
+  const text = String(stdout).trim();
+  const jsonStart = text.indexOf('{');
+  if (jsonStart === -1) return null;
+  try {
+    return JSON.parse(text.slice(jsonStart));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Tenta resolver o context pack via oxe-cc CLI.
+ * Primeiro tenta o binário local em node_modules, depois npx global.
+ * @param {string} projectRoot
+ * @param {string} workflow
+ * @returns {object | null}
+ */
+function resolveViaOxeCc(projectRoot, workflow) {
+  const localBin = path.join(projectRoot, 'node_modules', 'oxe-cc', 'bin', 'oxe-cc.js');
+  const args = ['context', 'inspect', '--workflow', workflow, '--json', '--dir', projectRoot];
+  const env = { ...process.env, OXE_NO_BANNER: '1' };
+  const opts = { cwd: projectRoot, encoding: 'utf8', timeout: 12000, env };
+
+  // Tentativa 1 — binário local
+  if (fs.existsSync(localBin)) {
+    const r = spawnSync(process.execPath, [localBin, ...args], opts);
+    if (r.status === 0) {
+      const pack = parseJsonFromOutput(r.stdout);
+      if (pack) return pack;
+    }
+  }
+
+  // Tentativa 2 — npx (global ou cache)
+  const npxCmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+  const r = spawnSync(npxCmd, ['oxe-cc', ...args], opts);
+  if (r.status === 0) {
+    return parseJsonFromOutput(r.stdout);
+  }
+
+  return null;
+}
+
+/**
+ * Carrega o context pack para um workflow. Tenta disco primeiro, depois CLI.
+ * @param {string} projectRoot
+ * @param {string} workflow
+ * @returns {object | null}
+ */
+function loadContextPack(projectRoot, workflow) {
+  // Tentativa 1 — ler pack já materializado em disco
+  const packPath = path.join(projectRoot, '.oxe', 'context', 'packs', `${workflow}.json`);
+  if (fs.existsSync(packPath)) {
+    try {
+      const data = JSON.parse(fs.readFileSync(packPath, 'utf8'));
+      if (data && data.workflow) return data;
+    } catch {
+      // arquivo corrompido → tenta CLI
+    }
+  }
+
+  // Tentativa 2 — resolver on-demand via oxe-cc
+  return resolveViaOxeCc(projectRoot, workflow);
+}
+
+/**
+ * Formata os artefatos selecionados do pack em markdown legível.
+ * Usa semantic_summary quando disponível, cai para summary.
+ * @param {object | null} pack
+ * @returns {string}
+ */
+function formatArtifacts(pack) {
+  if (!pack || !Array.isArray(pack.selected_artifacts)) return '';
+
+  const artifacts = pack.selected_artifacts
+    .filter((a) => a.exists && (a.semantic_summary || a.summary))
+    .map((a) => {
+      const content = (a.semantic_summary || a.summary || '').trim();
+      if (!content) return null;
+      const label = a.alias.replace(/_/g, ' ');
+      const flags = [
+        a.using_fallback ? '[fallback]' : '',
+        a.required ? '[obrigatório]' : '',
+      ].filter(Boolean).join(' ');
+      return `### ${label}${flags ? ' ' + flags : ''}\n${content}`;
+    })
+    .filter(Boolean);
+
+  return artifacts.length > 0 ? artifacts.join('\n\n') : '';
+}
+
+/**
+ * Formata hipóteses pendentes do pack para o system prompt.
+ * @param {object | null} pack
+ * @returns {string}
+ */
+function formatHypotheses(pack) {
+  if (!pack || !Array.isArray(pack.hypotheses)) return '';
+  const pending = pack.hypotheses.filter((h) => h.status === 'pending');
+  if (pending.length === 0) return '';
+  const lines = pending.map((h) =>
+    `- **[${h.id}]** ${h.condition}${h.checkpoint ? ` *(checkpoint: ${h.checkpoint})*` : ''}`
+  );
+  return `## Hipóteses críticas pendentes\n\n${lines.join('\n')}`;
+}
+
+/**
+ * Formata gaps críticos do pack.
+ * @param {object | null} pack
+ * @returns {string}
+ */
+function formatGaps(pack) {
+  if (!pack || !Array.isArray(pack.gaps)) return '';
+  const critical = pack.gaps.filter((g) => g.severity === 'critical');
+  if (critical.length === 0) return '';
+  const lines = critical.map((g) => `- \`${g.alias}\`: ${g.reason}`);
+  return `## Artefatos críticos ausentes\n\n${lines.join('\n')}`;
+}
+
+module.exports = {
+  loadContextPack,
+  formatArtifacts,
+  formatHypotheses,
+  formatGaps,
+};

package/vscode-extension/src/shared/contractBuilder.js

@@ -1,159 +1,159 @@
-'use strict';
-
-/** Instruções específicas por reasoning_mode */
-const MODE_INSTRUCTIONS = {
-  discovery: [
-    'Explore o repositório e os artefatos antes de perguntar.',
-    'Separe fatos confirmados, inferências e lacunas.',
-    'Pergunte apenas ambiguidades que mudem a decisão ou o artefato final.',
-  ],
-  planning: [
-    'Produza plano decision-complete — feche interfaces, validação, riscos, rollback e assumptions.',
-    'Não deixe decisões importantes abertas para quem implementar depois.',
-    'Explicite confiança e condição objetiva para replanejar.',
-  ],
-  execution: [
-    'Faça reconhecimento curto antes de editar ou executar mutações.',
-    'Trabalhe no menor write set viável e valide após cada fatia relevante.',
-    'Pare e explicite o bloqueio quando houver hipótese crítica não verificada.',
-  ],
-  review: [
-    'Apresente findings primeiro, ordenados por severidade e evidência.',
-    'Separe bug, risco, regressão e lacuna de teste.',
-    'Se não houver findings, declare isso explicitamente e liste riscos residuais.',
-  ],
-  status: [
-    'Responda com leitura curta e orientada a decisão.',
-    'Dê uma recomendação única e justifique o motivo.',
-    'Explicite a confiança quando o estado estiver incompleto ou ambíguo.',
-  ],
-};
-
-/** Instruções por sub-comando */
-const COMMAND_INSTRUCTIONS = {
-  replan: 'Sub-comando **replan**: leia LESSONS.md e lessons-metrics.json antes de replanejar. Registre o motivo do replanejamento e as lições aplicadas.',
-  agents: 'Sub-comando **agents**: identifique 2–4 domínios distintos no PLAN.md e gere um blueprint multi-agente em formato plan-agents.json.',
-  discuss: 'Sub-comando **discuss**: abra uma discussão estruturada. Pergunte sobre contexto, alternativas e trade-offs antes de gerar a spec.',
-  wave: 'Sub-comando **wave**: o usuário indicou uma onda específica. Concentre o reconhecimento e a execução nessa onda apenas.',
-  task: 'Sub-comando **task**: o usuário indicou uma tarefa específica (ex: T3). Execute apenas essa tarefa com reconhecimento mínimo.',
-  audit: 'Sub-comando **audit**: modo auditor adversarial. Avalie SPEC.md + VERIFY.md sem consultar PLAN.md nem EXECUTION-RUNTIME.md. Objetivo: falsificar, não confirmar.',
-};
-
-/**
- * Formata o vetor de confiança do pack para o system prompt.
- * @param {object | null} pack
- * @returns {string}
- */
-function formatConfidenceVector(pack) {
-  const artifacts = pack?.selected_artifacts || [];
-  const planArtifact = artifacts.find((a) => a.alias === 'plan' && a.exists);
-  if (!planArtifact || !planArtifact.semantic_summary) return '';
-
-  // Verificar se o semantic_summary contém dados de confiança
-  if (!planArtifact.semantic_summary.includes('Confiança') &&
-      !planArtifact.semantic_summary.includes('confidence')) return '';
-
-  return '';  // O semantic_summary já inclui isso via extraction_intent=planning_input
-}
-
-/**
- * Constrói o system prompt completo para um agente OXE.
- *
- * @param {string} workflow - slug do workflow (ex: 'plan', 'execute')
- * @param {object | null} pack - context pack carregado
- * @param {string} stateText - conteúdo do STATE.md (truncado)
- * @param {string | undefined} command - sub-comando invocado (ex: 'replan')
- * @param {{ phase: string | null, session: string | null, nextStep: string | null }} stateInfo
- * @param {string} artifactsText - artefatos formatados pelo contextLoader
- * @param {string} hypothesesText - hipóteses formatadas
- * @param {string} gapsText - gaps formatados
- * @returns {string}
- */
-function build(workflow, pack, stateText, command, stateInfo, artifactsText, hypothesesText, gapsText) {
-  const contract = pack?.contract || {};
-  const mode = contract.reasoning_mode || 'status';
-  const guidance = Array.isArray(contract.guidance) && contract.guidance.length > 0
-    ? contract.guidance
-    : (MODE_INSTRUCTIONS[mode] || MODE_INSTRUCTIONS.status);
-
-  const modeInstructions = MODE_INSTRUCTIONS[mode] || MODE_INSTRUCTIONS.status;
-  const commandInstruction = command && COMMAND_INSTRUCTIONS[command]
-    ? `\n\n**${COMMAND_INSTRUCTIONS[command]}**`
-    : '';
-
-  // Resumo do estado do projeto
-  const stateSection = stateText
-    ? `## Estado atual do projeto\n\n${stateText}`
-    : '';
-
-  // Info de contexto rápido
-  const contextInfo = [
-    stateInfo.phase ? `- **Fase:** ${stateInfo.phase}` : '',
-    stateInfo.session ? `- **Sessão ativa:** ${stateInfo.session}` : '',
-    stateInfo.nextStep ? `- **Próximo passo sugerido:** ${stateInfo.nextStep}` : '',
-  ].filter(Boolean).join('\n');
-
-  // Qualidade do contexto
-  let qualityNote = '';
-  if (pack) {
-    const quality = pack.context_quality;
-    if (quality && quality.status === 'critical') {
-      qualityNote = `\n> ⚠️ **Contexto crítico** (score: ${quality.score}/100) — artefatos obrigatórios ausentes. Declare fallback para leitura direta se necessário.`;
-    } else if (pack.fallback_required) {
-      qualityNote = '\n> ℹ️ **Contexto com fallback** — alguns artefatos foram resolvidos por caminhos alternativos.';
-    }
-    if (pack.freshness && pack.freshness.stale) {
-      qualityNote += `\n> 🕐 **Pack desatualizado** (${pack.freshness.reason}) — considere regenerar com \`oxe-cc context build --workflow ${workflow}\`.`;
-    }
-  }
-
-  const parts = [
-    `Você é o agente **OXE ${workflow}**, especializado na fase de ${mode} do framework OXE (Orchestrated eXperience Engineering).`,
-    '',
-    '## Contrato de raciocínio',
-    `- **Modo:** ${mode}`,
-    `- **Política de perguntas:** ${contract.question_policy || 'none'}`,
-    `- **Saída esperada:** ${contract.output_contract || 'routing'}`,
-    `- **Perfil de ferramentas:** ${contract.tool_profile || 'read_heavy'}`,
-    `- **Política de confiança:** ${contract.confidence_policy || 'explicit'}`,
-    '',
-    '## Diretrizes de raciocínio',
-    ...guidance.map((g) => `- ${g}`),
-    '',
-  ];
-
-  if (contextInfo) {
-    parts.push('## Contexto rápido', contextInfo, '');
-  }
-
-  if (stateSection) {
-    parts.push(stateSection, '');
-  }
-
-  if (artifactsText) {
-    parts.push('## Artefatos do projeto', artifactsText, '');
-  }
-
-  if (hypothesesText) {
-    parts.push(hypothesesText, '');
-  }
-
-  if (gapsText) {
-    parts.push(gapsText, '');
-  }
-
-  if (qualityNote) {
-    parts.push(qualityNote.trim(), '');
-  }
-
-  parts.push(
-    '## Instrução geral',
-    'Responda **em português**. Use evidência explícita dos artefatos acima — não invente estado. ' +
-    modeInstructions.join(' ') +
-    commandInstruction
-  );
-
-  return parts.join('\n').trim();
-}
-
-module.exports = { build };
+'use strict';
+
+/** Instruções específicas por reasoning_mode */
+const MODE_INSTRUCTIONS = {
+  discovery: [
+    'Explore o repositório e os artefatos antes de perguntar.',
+    'Separe fatos confirmados, inferências e lacunas.',
+    'Pergunte apenas ambiguidades que mudem a decisão ou o artefato final.',
+  ],
+  planning: [
+    'Produza plano decision-complete — feche interfaces, validação, riscos, rollback e assumptions.',
+    'Não deixe decisões importantes abertas para quem implementar depois.',
+    'Explicite confiança e condição objetiva para replanejar.',
+  ],
+  execution: [
+    'Faça reconhecimento curto antes de editar ou executar mutações.',
+    'Trabalhe no menor write set viável e valide após cada fatia relevante.',
+    'Pare e explicite o bloqueio quando houver hipótese crítica não verificada.',
+  ],
+  review: [
+    'Apresente findings primeiro, ordenados por severidade e evidência.',
+    'Separe bug, risco, regressão e lacuna de teste.',
+    'Se não houver findings, declare isso explicitamente e liste riscos residuais.',
+  ],
+  status: [
+    'Responda com leitura curta e orientada a decisão.',
+    'Dê uma recomendação única e justifique o motivo.',
+    'Explicite a confiança quando o estado estiver incompleto ou ambíguo.',
+  ],
+};
+
+/** Instruções por sub-comando */
+const COMMAND_INSTRUCTIONS = {
+  replan: 'Sub-comando **replan**: leia LESSONS.md e lessons-metrics.json antes de replanejar. Registre o motivo do replanejamento e as lições aplicadas.',
+  agents: 'Sub-comando **agents**: identifique 2–4 domínios distintos no PLAN.md e gere um blueprint multi-agente em formato plan-agents.json.',
+  discuss: 'Sub-comando **discuss**: abra uma discussão estruturada. Pergunte sobre contexto, alternativas e trade-offs antes de gerar a spec.',
+  wave: 'Sub-comando **wave**: o usuário indicou uma onda específica. Concentre o reconhecimento e a execução nessa onda apenas.',
+  task: 'Sub-comando **task**: o usuário indicou uma tarefa específica (ex: T3). Execute apenas essa tarefa com reconhecimento mínimo.',
+  audit: 'Sub-comando **audit**: modo auditor adversarial. Avalie SPEC.md + VERIFY.md sem consultar PLAN.md nem EXECUTION-RUNTIME.md. Objetivo: falsificar, não confirmar.',
+};
+
+/**
+ * Formata o vetor de confiança do pack para o system prompt.
+ * @param {object | null} pack
+ * @returns {string}
+ */
+function formatConfidenceVector(pack) {
+  const artifacts = pack?.selected_artifacts || [];
+  const planArtifact = artifacts.find((a) => a.alias === 'plan' && a.exists);
+  if (!planArtifact || !planArtifact.semantic_summary) return '';
+
+  // Verificar se o semantic_summary contém dados de confiança
+  if (!planArtifact.semantic_summary.includes('Confiança') &&
+      !planArtifact.semantic_summary.includes('confidence')) return '';
+
+  return '';  // O semantic_summary já inclui isso via extraction_intent=planning_input
+}
+
+/**
+ * Constrói o system prompt completo para um agente OXE.
+ *
+ * @param {string} workflow - slug do workflow (ex: 'plan', 'execute')
+ * @param {object | null} pack - context pack carregado
+ * @param {string} stateText - conteúdo do STATE.md (truncado)
+ * @param {string | undefined} command - sub-comando invocado (ex: 'replan')
+ * @param {{ phase: string | null, session: string | null, nextStep: string | null }} stateInfo
+ * @param {string} artifactsText - artefatos formatados pelo contextLoader
+ * @param {string} hypothesesText - hipóteses formatadas
+ * @param {string} gapsText - gaps formatados
+ * @returns {string}
+ */
+function build(workflow, pack, stateText, command, stateInfo, artifactsText, hypothesesText, gapsText) {
+  const contract = pack?.contract || {};
+  const mode = contract.reasoning_mode || 'status';
+  const guidance = Array.isArray(contract.guidance) && contract.guidance.length > 0
+    ? contract.guidance
+    : (MODE_INSTRUCTIONS[mode] || MODE_INSTRUCTIONS.status);
+
+  const modeInstructions = MODE_INSTRUCTIONS[mode] || MODE_INSTRUCTIONS.status;
+  const commandInstruction = command && COMMAND_INSTRUCTIONS[command]
+    ? `\n\n**${COMMAND_INSTRUCTIONS[command]}**`
+    : '';
+
+  // Resumo do estado do projeto
+  const stateSection = stateText
+    ? `## Estado atual do projeto\n\n${stateText}`
+    : '';
+
+  // Info de contexto rápido
+  const contextInfo = [
+    stateInfo.phase ? `- **Fase:** ${stateInfo.phase}` : '',
+    stateInfo.session ? `- **Sessão ativa:** ${stateInfo.session}` : '',
+    stateInfo.nextStep ? `- **Próximo passo sugerido:** ${stateInfo.nextStep}` : '',
+  ].filter(Boolean).join('\n');
+
+  // Qualidade do contexto
+  let qualityNote = '';
+  if (pack) {
+    const quality = pack.context_quality;
+    if (quality && quality.status === 'critical') {
+      qualityNote = `\n> ⚠️ **Contexto crítico** (score: ${quality.score}/100) — artefatos obrigatórios ausentes. Declare fallback para leitura direta se necessário.`;
+    } else if (pack.fallback_required) {
+      qualityNote = '\n> ℹ️ **Contexto com fallback** — alguns artefatos foram resolvidos por caminhos alternativos.';
+    }
+    if (pack.freshness && pack.freshness.stale) {
+      qualityNote += `\n> 🕐 **Pack desatualizado** (${pack.freshness.reason}) — considere regenerar com \`oxe-cc context build --workflow ${workflow}\`.`;
+    }
+  }
+
+  const parts = [
+    `Você é o agente **OXE ${workflow}**, especializado na fase de ${mode} do framework OXE (Orchestrated eXperience Engineering).`,
+    '',
+    '## Contrato de raciocínio',
+    `- **Modo:** ${mode}`,
+    `- **Política de perguntas:** ${contract.question_policy || 'none'}`,
+    `- **Saída esperada:** ${contract.output_contract || 'routing'}`,
+    `- **Perfil de ferramentas:** ${contract.tool_profile || 'read_heavy'}`,
+    `- **Política de confiança:** ${contract.confidence_policy || 'explicit'}`,
+    '',
+    '## Diretrizes de raciocínio',
+    ...guidance.map((g) => `- ${g}`),
+    '',
+  ];
+
+  if (contextInfo) {
+    parts.push('## Contexto rápido', contextInfo, '');
+  }
+
+  if (stateSection) {
+    parts.push(stateSection, '');
+  }
+
+  if (artifactsText) {
+    parts.push('## Artefatos do projeto', artifactsText, '');
+  }
+
+  if (hypothesesText) {
+    parts.push(hypothesesText, '');
+  }
+
+  if (gapsText) {
+    parts.push(gapsText, '');
+  }
+
+  if (qualityNote) {
+    parts.push(qualityNote.trim(), '');
+  }
+
+  parts.push(
+    '## Instrução geral',
+    'Responda **em português**. Use evidência explícita dos artefatos acima — não invente estado. ' +
+    modeInstructions.join(' ') +
+    commandInstruction
+  );
+
+  return parts.join('\n').trim();
+}
+
+module.exports = { build };