trackfw 7.6.0 → 8.0.0-rc2

package/src/commands/help.js

@@ -1,358 +0,0 @@
-'use strict'
-const { Command } = require('commander')
-
-const configDocs = {
-  adr_dirs: {
-    type: 'list of strings',
-    default: '["docs/adr"]',
-    description: 'Diretórios onde os ADRs são armazenados.',
-    example: 'adr_dirs:\n  - docs/adr\n  - docs/adr/zeus',
-    impact: 'Todos os diretórios listados são varridos na validação de ADRs.'
-  },
-  req_dir: {
-    type: 'string',
-    default: '"docs/req"',
-    description: 'Diretório onde as REQs são armazenadas.',
-    example: 'req_dir: docs/requisicoes',
-    impact: 'Altera onde o trackfw busca e cria arquivos de REQ.'
-  },
-  roadmap_dir: {
-    type: 'string',
-    default: '"docs/roadmaps"',
-    description: 'Diretório raiz dos roadmaps.',
-    example: 'roadmap_dir: docs/roadmaps',
-    impact: 'Subtrees backlog/, wip/, blocked/, done/, abandoned/ são relativos a este diretório.'
-  },
-  roadmap_namespacing: {
-    type: 'flat|by_agent',
-    default: '"flat"',
-    description: 'Estratégia de namespacing dos roadmaps.',
-    example: 'roadmap_namespacing: by_agent',
-    impact: 'Com by_agent, roadmaps ficam em subpastas por agente (ex: wip/apolo/RM-001.md).'
-  },
-  agents: {
-    type: 'list of strings',
-    default: '[]',
-    description: 'Lista de agentes ativos no projeto.',
-    example: 'agents:\n  - apolo\n  - afrodite',
-    impact: 'Agentes listados têm suas subpastas criadas automaticamente em roadmap_dir.'
-  },
-  governance_mode: {
-    type: 'string',
-    default: '""',
-    description: 'Modo de governança (strict, lenient).',
-    example: 'governance_mode: strict',
-    impact: 'strict bloqueia commits/merges com violations; lenient emite apenas avisos.'
-  },
-  lenient_until: {
-    type: 'date (YYYY-MM-DD)',
-    default: '""',
-    description: 'Data até quando o modo lenient está ativo.',
-    example: 'lenient_until: 2026-12-31',
-    impact: 'Após a data, o modo volta automaticamente para strict.'
-  },
-  wip_limit: {
-    type: 'integer',
-    default: '1',
-    description: 'Limite de itens WIP simultâneos.',
-    example: 'wip_limit: 3',
-    impact: 'Aumentar reduz a frequência de bloqueio.'
-  },
-  wip_by_squad: {
-    type: 'boolean',
-    default: 'false',
-    description: 'Aplicar limite WIP por squad individualmente.',
-    example: 'wip_by_squad: true',
-    impact: 'Cada squad tem seu próprio contador de WIP em vez de um limite global.'
-  },
-  require_req_in_commit: {
-    type: 'boolean',
-    default: 'false',
-    description: 'Exigir referência de REQ em mensagens de commit.',
-    example: 'require_req_in_commit: true',
-    impact: 'Commits sem menção a uma REQ são rejeitados pelo hook de pre-commit.'
-  },
-  'link_fields.req': {
-    type: 'list of strings',
-    default: '["REQ:"]',
-    description: 'Marcadores que identificam link a REQ.',
-    example: 'link_fields:\n  req:\n    - "REQ:"\n    - "Requisito:"',
-    impact: 'Qualquer marcador listado é aceito para detectar vínculo com REQ.'
-  },
-  'link_fields.adr': {
-    type: 'list of strings',
-    default: '["ADR:"]',
-    description: 'Marcadores que identificam link a ADR.',
-    example: 'link_fields:\n  adr:\n    - "ADR:"\n    - "Decision:"',
-    impact: 'Qualquer marcador listado é aceito para detectar vínculo com ADR.'
-  },
-  'link_fields.roadmap': {
-    type: 'list of strings',
-    default: '["Roadmap:"]',
-    description: 'Marcadores que identificam link a Roadmap.',
-    example: 'link_fields:\n  roadmap:\n    - "Roadmap:"',
-    impact: 'Qualquer marcador listado é aceito para detectar vínculo com Roadmap.'
-  },
-  acceptance_markers: {
-    type: 'list of strings',
-    default: '["## Acceptance Criteria", "## Critérios de Aceite"]',
-    description: 'Marcadores de critério de aceite.',
-    example: 'acceptance_markers:\n  - "## Acceptance Criteria"\n  - "## AC"',
-    impact: 'Roadmaps WIP sem nenhum desses marcadores disparam a regra wip_acceptance.'
-  },
-  'rules.wip_has_req': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: WIP sem REQ linkada.',
-    example: 'rules:\n  wip_has_req: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.wip_acceptance': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: WIP sem critérios de aceite.',
-    example: 'rules:\n  wip_acceptance: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.wip_limit': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: excesso de itens WIP.',
-    example: 'rules:\n  wip_limit: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.stale_wip': {
-    type: 'off|warning|error',
-    default: '"warning"',
-    description: 'Severidade: WIP sem atualização recente.',
-    example: 'rules:\n  stale_wip: error',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.adr_orphan': {
-    type: 'off|warning|error',
-    default: '"warning"',
-    description: 'Severidade: ADR sem REQ vinculada.',
-    example: 'rules:\n  adr_orphan: error',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.ref_targets_exist': {
-    type: 'off|warning|error',
-    default: '"warning"',
-    description: 'Severidade: referências com destino inexistente.',
-    example: 'rules:\n  ref_targets_exist: error',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.folder_status': {
-    type: 'off|warning|error',
-    default: '"warning"',
-    description: 'Severidade: coerência entre pasta e status do arquivo.',
-    example: 'rules:\n  folder_status: error',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.filename_uniqueness': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: nomes de arquivo duplicados.',
-    example: 'rules:\n  filename_uniqueness: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.blocked_by_draft_adr': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: REQ bloqueada por ADR em rascunho.',
-    example: 'rules:\n  blocked_by_draft_adr: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  trace_id_field: {
-    type: 'string',
-    default: '""',
-    description: 'Campo de frontmatter usado como trace ID para verificação bidirecional REQ↔Roadmap. Vazio desativa a verificação.',
-    example: 'trace_id_field: req_id',
-    impact: 'Quando configurado, ativa as regras traceid_* que garantem que toda REQ tem Roadmap correspondente e vice-versa.'
-  },
-  'rules.traceid_orphan_roadmap': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: Roadmap com trace ID sem REQ correspondente.',
-    example: 'rules:\n  traceid_orphan_roadmap: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.traceid_orphan_req': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: REQ com trace ID sem Roadmap correspondente.',
-    example: 'rules:\n  traceid_orphan_req: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.traceid_state_mismatch': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: REQ e Roadmap com mesmo trace ID em estados diferentes (ex: REQ em done, Roadmap em wip).',
-    example: 'rules:\n  traceid_state_mismatch: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.traceid_duplicate_req': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: mesmo trace ID aparece em mais de uma REQ.',
-    example: 'rules:\n  traceid_duplicate_req: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  },
-  'rules.traceid_duplicate_roadmap': {
-    type: 'off|warning|error',
-    default: '"error"',
-    description: 'Severidade: mesmo trace ID aparece em mais de um Roadmap.',
-    example: 'rules:\n  traceid_duplicate_roadmap: warning',
-    impact: 'error bloqueia; warning apenas reporta; off desativa a regra.'
-  }
-}
-
-/**
- * Retorna string com a listagem tabular de todas as keys configuráveis.
- * @returns {string}
- */
-function listKeys() {
-  const COL_KEY = 28
-  const COL_DEFAULT = 36
-  const header = 'KEY'.padEnd(COL_KEY) + 'DEFAULT'.padEnd(COL_DEFAULT) + 'DESCRIÇÃO'
-  const sep = '─'.repeat(COL_KEY + COL_DEFAULT + 40)
-  const lines = [header, sep]
-  for (const [key, doc] of Object.entries(configDocs)) {
-    lines.push(
-      key.padEnd(COL_KEY) +
-      doc.default.padEnd(COL_DEFAULT) +
-      doc.description
-    )
-  }
-  return lines.join('\n')
-}
-
-/**
- * Retorna string com a documentação detalhada de uma key.
- * Retorna null se a key não existir.
- * @param {string} key
- * @returns {string|null}
- */
-function describeKey(key) {
-  const doc = configDocs[key]
-  if (!doc) return null
-  return [
-    key,
-    `  Type:    ${doc.type}`,
-    `  Default: ${doc.default}`,
-    `  Desc:    ${doc.description}`,
-    `  Example:`,
-    ...doc.example.split('\n').map(l => `    ${l}`),
-    `  Impact:  ${doc.impact}`
-  ].join('\n')
-}
-
-/**
- * Retorna a listagem de comandos disponíveis a partir do programa raiz.
- * @param {import('commander').Command} root
- * @returns {string}
- */
-function listCommands(root) {
-  const visible = root.commands.filter((sub) => !sub._hidden)
-  const nameWidth = Math.max(...visible.map((sub) => sub.name().length)) + 2
-  const lines = ['Comandos disponíveis:']
-  for (const sub of visible) {
-    lines.push(`  ${sub.name().padEnd(nameWidth)}${sub.description()}`)
-  }
-  return lines.join('\n')
-}
-
-/**
- * Distância de edição (Levenshtein) entre duas strings.
- * @param {string} a
- * @param {string} b
- * @returns {number}
- */
-function levenshtein(a, b) {
-  const la = a.length
-  const lb = b.length
-  let prev = new Array(lb + 1)
-  let curr = new Array(lb + 1)
-  for (let j = 0; j <= lb; j++) prev[j] = j
-  for (let i = 1; i <= la; i++) {
-    curr[0] = i
-    for (let j = 1; j <= lb; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1
-      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost)
-    }
-    const tmp = prev
-    prev = curr
-    curr = tmp
-  }
-  return prev[lb]
-}
-
-/**
- * Retorna o comando ou chave de configuração conhecida mais próxima de
- * topic (distância de edição <= 3), ou null se nenhuma for próxima o
- * suficiente.
- * @param {string} topic
- * @param {import('commander').Command} root
- * @returns {string|null}
- */
-function suggestTopic(topic, root) {
-  const threshold = 3
-  const candidates = [
-    ...root.commands.filter((sub) => !sub._hidden).map((sub) => sub.name()),
-    ...Object.keys(configDocs)
-  ]
-  let best = null
-  let bestDist = threshold + 1
-  for (const candidate of candidates) {
-    const dist = levenshtein(topic, candidate)
-    if (dist < bestDist) {
-      bestDist = dist
-      best = candidate
-    }
-  }
-  return bestDist <= threshold ? best : null
-}
-
-const cmd = new Command('help')
-cmd.description('Exibe ajuda de comandos e documentação das chaves de configuração do trackfw.yaml')
-cmd.argument('[topic]', 'comando ou chave de configuração para detalhar')
-cmd.action(function (topic, options, thisCommand) {
-  const self = thisCommand || this
-  const root = self.parent || self
-
-  if (!topic) {
-    console.log(listCommands(root))
-    console.log()
-    console.log(listKeys())
-    return
-  }
-
-  // 1) comando conhecido → ajuda do comando.
-  const sub = root.commands.find((c) => c.name() === topic)
-  if (sub) {
-    console.log(sub.helpInformation().trimEnd())
-    return
-  }
-
-  // 2) chave de configuração conhecida → documentação da chave.
-  const output = describeKey(topic)
-  if (output) {
-    console.log(output)
-    return
-  }
-
-  // 3) assunto desconhecido → erro com sugestão útil.
-  let msg = `assunto desconhecido: ${topic}`
-  const suggestion = suggestTopic(topic, root)
-  if (suggestion) {
-    msg += `\nVocê quis dizer: ${suggestion}?`
-  }
-  console.error(msg)
-  process.exitCode = 1
-})
-
-module.exports = cmd
-module.exports.listKeys = listKeys
-module.exports.describeKey = describeKey
-module.exports.listCommands = listCommands
-module.exports.suggestTopic = suggestTopic

package/src/commands/identity-wizard.js

@@ -1,258 +0,0 @@
-'use strict'
-
-const fs = require('node:fs')
-const path = require('node:path')
-
-const identityStore = require('../identity')
-const { t } = require('../i18n')
-
-// identityFileExists reporta se ~/.trackfw/identity.json já existe, sem
-// depender de identityStore.load (que retorna config vazia para "ausente").
-// Espelha internal/commands/init.go:identityFileExists.
-function identityFileExists(home) {
-  return fs.existsSync(path.join(home, '.trackfw', 'identity.json'))
-}
-
-// resolveIdentityPreset traduz o valor da flag --identity-preset para uma
-// Config a persistir. "none" e "neutral" significam "não gravar nada" — o
-// chamador não deve criar ~/.trackfw/identity.json para esses valores. Um
-// valor desconhecido é sempre um erro, listando os valores aceitos. Espelha
-// internal/commands/init.go:resolveIdentityPreset.
-function resolveIdentityPreset(value) {
-  if (value === 'none' || value === 'neutral') return { cfg: null, shouldSave: false }
-  let cfg
-  try {
-    cfg = identityStore.preset(value)
-  } catch {
-    const valid = ['none', 'neutral', ...identityStore.presetNames()]
-    throw new Error(`identity-preset invalido "${value}" (validos: ${valid.join(', ')})`)
-  }
-  return { cfg, shouldSave: true }
-}
-
-// applyIdentityPresetFlag resolve e persiste --identity-preset para
-// `agents install|update|uninstall`, reusando resolveIdentityPreset para que
-// ambos os comandos aceitem exatamente os mesmos nomes de preset e rejeitem
-// valores inválidos com o mesmo formato de erro. Espelha
-// internal/commands/integrations_flags.go:applyIdentityPresetFlag.
-function applyIdentityPresetFlag(home, presetValue, operation) {
-  const { cfg, shouldSave } = resolveIdentityPreset(presetValue)
-  if (!shouldSave) return
-  try {
-    identityStore.validate(cfg, identityStore.knownAgentIds())
-  } catch (err) {
-    throw new Error(`${operation}: identidade invalida: ${err.message}`)
-  }
-  try {
-    identityStore.save(home, cfg)
-  } catch (err) {
-    throw new Error(`${operation}: falha ao gravar identidade: ${err.message}`)
-  }
-}
-
-// shouldPromptIdentity decide se `trackfw agents install` (e as operações
-// update/uninstall, que compartilham o mesmo fluxo) deve mostrar o wizard
-// interativo de identidade. Todas as condições devem valer simultaneamente
-// (ADR D2):
-//
-//  1. kind é "agents" — skills não têm identidade e nunca devem perguntar.
-//  2. stdin é um TTY — nunca bloquear uma execução não-interativa.
-//  3. ou não há identidade configurada ainda, ou o usuário pediu
-//     explicitamente para reconfigurá-la via --identity.
-//
-// Com uma identidade já configurada e sem a flag --identity, o wizard NÃO
-// deve reaparecer — um wizard que aparece a cada install vira incentivo a
-// automatizar o "pular", o que esvazia a feature. Espelha
-// internal/commands/identity_wizard.go:shouldPromptIdentity.
-function shouldPromptIdentity(kind, isTTY, identityExists, forceFlag) {
-  if (kind !== 'agents') return false
-  if (!isTTY) return false
-  return !identityExists || Boolean(forceFlag)
-}
-
-// identityPresetOptions é a lista fixa de presets temáticos de identidade
-// oferecidos pelo wizard, compartilhada literalmente entre init e agents
-// install para que nenhum consumidor divirja do outro. Espelha
-// internal/commands/identity_wizard.go:identityPresetOptions.
-function identityPresetOptions() {
-  return [
-    { name: 'Panteão grego (Zeus, Apolo, Afrodite...)', value: 'greek' },
-    { name: 'Mitologia nórdica (Odin, Thor, Freya...)', value: 'norse' },
-    { name: 'Pioneiros da computação (Turing, Codd, Knuth...)', value: 'pioneers' },
-    { name: 'Harry Potter (Dumbledore, Snape, Luna...)', value: 'potter' },
-    { name: 'Game of Thrones (Tyrion, Jon, Arya...)', value: 'thrones' },
-    { name: 'Senhor dos Anéis (Gandalf, Aragorn, Arwen...)', value: 'tolkien' },
-    { name: 'Star Wars (Yoda, Leia, Vader...)', value: 'starwars' },
-    { name: 'Chaves (Girafales, Madruga, Chiquinha...)', value: 'chaves' },
-    { name: 'Turma da Mônica (Franjinha, Cebolinha, Mônica...)', value: 'turma' },
-    { name: 'Panteão egípcio (Thoth, Ísis, Anúbis...)', value: 'egyptian' },
-    { name: 'Personalizar um a um', value: 'custom' },
-    { name: 'Nomes neutros (padrão)', value: 'neutral' },
-  ]
-}
-
-// catalogAgentItem busca o item "agents" do catálogo pelo id. Todo id vindo
-// de identity.knownAgentIds() deve existir no catálogo embedado — se não
-// existir, é erro de programação: falha alto em vez de rotular
-// silenciosamente errado. Espelha o panic em
-// internal/commands/identity_wizard.go:buildCustomIdentityGroup.
-function catalogAgentItem(catalog, id) {
-  const found = (catalog.agents || []).find(entry => entry.id === id)
-  if (!found) {
-    throw new Error(`identity wizard: agent id "${id}" from identity.knownAgentIds() has no entry in the agents catalog`)
-  }
-  return found
-}
-
-// buildIdentityConfig constrói a Config em memória para o caminho escolhido
-// no wizard, sem tocar em disco. Espelha
-// internal/commands/identity_wizard.go:buildIdentityConfig.
-function buildIdentityConfig(identitySelect, knownAgentIds, customDisplayNames, userNickname) {
-  let cfg
-  if (identitySelect === 'custom') {
-    const agents = {}
-    knownAgentIds.forEach((id, index) => {
-      let slug
-      try {
-        slug = identityStore.slugify(customDisplayNames[index])
-      } catch (err) {
-        throw new Error(`identidade customizada invalida para "${id}": ${err.message}`)
-      }
-      agents[id] = { display_name: customDisplayNames[index], slug }
-    })
-    cfg = { agents }
-  } else {
-    cfg = identityStore.preset(identitySelect)
-  }
-  cfg.user_nickname = userNickname
-  return cfg
-}
-
-// promptCustomNames pede um nome de exibição para cada agente conhecido,
-// rotulado com a especialidade do catálogo (Item.name + Item.description) —
-// nunca com o id técnico cru (ADR D4). Espelha
-// internal/commands/identity_wizard.go:buildCustomIdentityGroup.
-async function promptCustomNames(catalog, knownAgentIds, prompts) {
-  const { input } = prompts
-  const helperText = t('init.prompt.identityCustomName')
-  const customDisplayNames = []
-  for (const id of knownAgentIds) {
-    const item = catalogAgentItem(catalog, id)
-    const label = `${item.name} — ${item.description}`
-    // eslint-disable-next-line no-await-in-loop
-    const value = await input({
-      message: `${label}\n  ${helperText}`,
-      validate: candidate => {
-        let slug
-        try {
-          slug = identityStore.slugify(candidate)
-        } catch (err) {
-          return err.message
-        }
-        for (let index = 0; index < customDisplayNames.length; index += 1) {
-          let otherSlug
-          try {
-            otherSlug = identityStore.slugify(customDisplayNames[index])
-          } catch {
-            continue
-          }
-          if (otherSlug === slug) return `slug "${slug}" duplicado com o agente "${knownAgentIds[index]}"`
-        }
-        return true
-      },
-    })
-    customDisplayNames.push(value)
-  }
-  return customDisplayNames
-}
-
-// confirmIdentitySelection exibe o mapeamento especialidade → nome de
-// exibição (ADR D3) e pede confirmação. O mapeamento é impresso com
-// console.log simples (não por um campo de prompt) para que o alinhamento
-// de colunas siga exatamente o exemplo do ADR. Espelha
-// internal/commands/identity_wizard.go:confirmIdentitySelection.
-async function confirmIdentitySelection(catalog, knownAgentIds, cfg, prompts) {
-  const { confirm } = prompts
-  const nicknameLabel = t('identity.wizard.nicknameRowLabel')
-  let labelWidth = nicknameLabel.length
-  const labels = knownAgentIds.map(id => {
-    const item = catalogAgentItem(catalog, id)
-    if (item.description.length > labelWidth) labelWidth = item.description.length
-    return item.description
-  })
-
-  console.log()
-  console.log(t('identity.wizard.confirmHeader'))
-  knownAgentIds.forEach((id, index) => {
-    const agent = cfg.agents[id]
-    console.log(`  ${labels[index].padEnd(labelWidth)}   →  ${agent.display_name}`)
-  })
-  if (cfg.user_nickname) {
-    console.log(`  ${nicknameLabel.padEnd(labelWidth)}   ${cfg.user_nickname}`)
-  }
-  console.log()
-
-  return confirm({ message: t('identity.wizard.confirmQuestion') })
-}
-
-// runIdentityWizard é o único wizard interativo de identidade, consumido
-// tanto por `trackfw init` quanto por `trackfw agents install`
-// (ADR-2026-07-25-wizard-unificado-de-identidade-no-agents-install, D1).
-//
-// Mostra, em ordem: seleção de preset/custom, nomes livres em texto (só no
-// modo custom), o apelido do usuário e uma tela de confirmação (D3, D6). Se
-// o usuário recusar a confirmação, o wizard volta à seleção de preset sem
-// persistir nada — nunca retorna tendo gravado uma config parcial ou
-// recusada em disco.
-//
-// Retorna [cfg, persisted]. "neutral" (ou deixar o select vazio) é o
-// caminho "não gravar nada" e retorna [{}, false].
-async function runIdentityWizard(catalog, home, prompts = require('@inquirer/prompts')) {
-  const { select, input } = prompts
-  const knownAgentIds = identityStore.knownAgentIds()
-
-  const titleIdentityPreset = t('init.prompt.identityPreset')
-  const titleIdentityNickname = t('init.prompt.identityNickname')
-
-  for (;;) {
-    const identitySelect = await select({
-      message: titleIdentityPreset,
-      choices: identityPresetOptions(),
-    })
-
-    if (identitySelect === '' || identitySelect === 'neutral') {
-      return [{}, false]
-    }
-
-    let customDisplayNames = []
-    if (identitySelect === 'custom') {
-      customDisplayNames = await promptCustomNames(catalog, knownAgentIds, prompts)
-    }
-
-    const userNickname = await input({ message: titleIdentityNickname, default: '' })
-
-    const cfg = buildIdentityConfig(identitySelect, knownAgentIds, customDisplayNames, userNickname)
-    identityStore.validate(cfg, knownAgentIds)
-
-    // eslint-disable-next-line no-await-in-loop
-    const confirmed = await confirmIdentitySelection(catalog, knownAgentIds, cfg, prompts)
-    if (!confirmed) {
-      // D3: recusar volta à seleção de preset sem persistir absolutamente nada.
-      continue
-    }
-
-    identityStore.save(home, cfg)
-    return [cfg, true]
-  }
-}
-
-module.exports = {
-  identityFileExists,
-  resolveIdentityPreset,
-  applyIdentityPresetFlag,
-  shouldPromptIdentity,
-  identityPresetOptions,
-  buildIdentityConfig,
-  confirmIdentitySelection,
-  runIdentityWizard,
-}

package/src/commands/index.js

@@ -1,68 +0,0 @@
-'use strict'
-
-const { Command } = require('commander')
-const { version } = require('../../package.json')
-const { formatUnknownCommandError } = require('../lib/unknown-command')
-
-function createProgram() {
-  const program = new Command()
-  program
-    .name('trackfw')
-    .description('trackfw — governed software delivery framework\nADR → REQ → ROADMAP → kanban')
-    .version(`trackfw ${version}`)
-  // enablePositionalOptions: garante que uma flag de subcomando (ex.: o
-  // "changelog --version <x.y.z>") não seja capturada pela flag global
-  // "--version" do root — sem isto, commander casa "--version" contra o
-  // primeiro registro conhecido em toda a árvore de comandos.
-  program.enablePositionalOptions()
-
-  // Comando desconhecido — mensagem canônica compartilhada pelos 3 CLIs
-  // (ADR-2026-08-15-remocao-do-subsistema-de-plugins-em-vez-de-gate-de-binario-
-  // de-terceiro.md D3). Registrar um listener 'command:*' intercepta ANTES do
-  // commander chamar seu próprio Command.unknownCommand() — evita reformatar
-  // uma mensagem já impressa por ele (o padrão que causava dupla-impressão no
-  // Go, ver internal/commands/root.go) e evita depender do texto/threshold
-  // próprio de commander.suggestSimilar, que diverge de cobra/argparse.
-  program.on('command:*', (operands) => {
-    const typed = operands[0]
-    const candidates = program.commands.map((cmd) => cmd.name())
-    process.stderr.write(formatUnknownCommandError(typed, candidates, program.name()) + '\n')
-    process.exit(1)
-  })
-
-  program.addCommand(require('./init'))
-  program.addCommand(require('./adr'))
-  program.addCommand(require('./req'))
-  program.addCommand(require('./roadmap'))
-  program.addCommand(require('./validate'))
-  program.addCommand(require('./status'))
-  program.addCommand(require('./changelog'))
-  program.addCommand(require('./log'))
-  program.addCommand(require('./discover'))
-  program.addCommand(require('./update'))
-  program.addCommand(require('./metrics'))
-  program.addCommand(require('./sync'))
-  program.addCommand(require('./context'))
-  program.addCommand(require('./baseline'))
-  program.addCommand(require('./help'))
-  program.addCommand(require('./configure'))
-  program.addCommand(require('./version'))
-  program.addCommand(require('./agents'))
-  program.addCommand(require('./skills'))
-  program.addCommand(require('./note'))
-  program.addCommand(require('./ship'))
-  program.addCommand(require('./release'))
-  program.addCommand(require('./barrier'))
-  program.addCommand(require('./branch'))
-  program.addCommand(require('./commit'))
-  program.addCommand(require('./push'))
-  program.addCommand(require('./doctor'))
-  program.addCommand(require('./audit-surface'))
-
-  const { createServeCommand } = require('./serve')
-  program.addCommand(createServeCommand())
-
-  return program
-}
-
-module.exports = { createProgram }