trackfw 1.0.4 → 2.0.0

package/src/commands/plugins.js

@@ -3,6 +3,7 @@ const { Command } = require('commander')
 const os = require('os')
 const path = require('path')
 const fs = require('fs')
+const { t } = require('../i18n')
 
 function pluginsDir() {
   return path.join(os.homedir(), '.trackfw', 'plugins')
@@ -40,7 +41,7 @@ async function installPlugin(repo) {
     : `https://github.com/${base}/releases/download/${tag}/${assetName}`
 
   const res = await fetch(url)
-  if (!res.ok) throw new Error(`download failed: HTTP ${res.status} for ${url}`)
+  if (!res.ok) throw new Error(t('errors.downloadFailed', { status: res.status, url }))
 
   const dir = pluginsDir()
   fs.mkdirSync(dir, { recursive: true })
@@ -49,32 +50,32 @@ async function installPlugin(repo) {
 
 function removePlugin(name) {
   const filePath = path.join(pluginsDir(), name)
-  if (!fs.existsSync(filePath)) throw new Error(`plugin "${name}" not found`)
+  if (!fs.existsSync(filePath)) throw new Error(t('errors.pluginNotFound', { name }))
   fs.unlinkSync(filePath)
 }
 
 const cmd = new Command('plugins')
-cmd.description('Manage trackfw plugins')
+cmd.description(t('plugins.description'))
 
 cmd.command('list')
-  .description('List installed plugins')
+  .description(t('plugins.list.description'))
   .action(() => {
     const plugins = listPlugins()
     if (plugins.length === 0) {
-      console.log('No plugins installed. Use `trackfw plugins add <user/repo>` to install one.')
+      console.log(t('plugins.list.empty'))
       return
     }
     plugins.forEach(p => console.log(p))
   })
 
 cmd.command('add <repo>')
-  .description('Install a plugin from GitHub Releases (user/repo or user/repo@tag)')
+  .description(t('plugins.add.description'))
   .action(async (repo) => {
     try {
-      console.log(`Installing plugin from ${repo}...`)
+      console.log(t('plugins.add.installing', { repo }))
       await installPlugin(repo)
       const name = repo.split('@')[0].split('/').pop()
-      console.log(`Plugin "${name}" installed successfully.`)
+      console.log(t('plugins.add.success', { name }))
     } catch (err) {
       console.error(`Error: ${err.message}`)
       process.exit(1)
@@ -82,11 +83,11 @@ cmd.command('add <repo>')
   })
 
 cmd.command('remove <name>')
-  .description('Remove an installed plugin')
+  .description(t('plugins.remove.description'))
   .action((name) => {
     try {
       removePlugin(name)
-      console.log(`Plugin "${name}" removed.`)
+      console.log(t('plugins.remove.success', { name }))
     } catch (err) {
       console.error(`Error: ${err.message}`)
       process.exit(1)

package/src/commands/req.js

@@ -1,12 +1,13 @@
 'use strict'
 const { Command } = require('commander')
 const { listREQs } = require('../generators/req')
+const { t } = require('../i18n')
 
 const cmd = new Command('req')
-cmd.description('Manage Requirements')
+cmd.description(t('req.description'))
 
 cmd.command('new <title>')
-  .description('Create a new REQ')
+  .description(t('req.new.description'))
   .action(async (title) => {
     const { input, select } = require('@inquirer/prompts')
     const generators = require('../generators/req')
@@ -16,14 +17,14 @@ cmd.command('new <title>')
 
     if (process.stdin.isTTY) {
       // Form 1 — título + motivação
-      content.title = await input({ message: 'Project requirement', default: title })
-      content.motivation = await input({ message: 'Motivation (why is this needed?)', default: '' })
+      content.title = await input({ message: t('req.new.prompt.title'), default: title })
+      content.motivation = await input({ message: t('req.new.prompt.motivation'), default: '' })
 
       // Detectar domínios com base em título + motivação
       const probes = generators.detectDomains(content.title + ' ' + content.motivation)
 
       // Form 2 — critérios de aceite
-      content.criteria = await input({ message: 'Acceptance Criteria (one per line)', default: '- [ ]\n- [ ]' })
+      content.criteria = await input({ message: t('req.new.prompt.criteria'), default: '- [ ]\n- [ ]' })
 
       // Perguntas dinâmicas por probe
       const generatedADRs = []
@@ -42,7 +43,7 @@ cmd.command('new <title>')
               const basename = await adrGenerators.newADRDraft(answer)
               if (basename) generatedADRs.push(basename)
             } catch (e) {
-              console.warn(`warning: could not create ADR draft for ${answer}: ${e.message}`)
+              console.warn(t('req.new.adrWarning', { slug: answer, message: e.message }))
             }
           }
         }
@@ -54,16 +55,16 @@ cmd.command('new <title>')
     await generators.newREQ(content)
 
     if (content.dependsOnADRs.length > 0) {
-      console.log('\nADR drafts created:')
+      console.log(`\n${t('req.new.adrDraftsCreated')}`)
       content.dependsOnADRs.forEach(adr => console.log(`  -> ${adr}`))
-      console.log('\nResolve these ADRs (set Status: Accepted) before creating a roadmap.')
+      console.log(`\n${t('req.new.resolveADRs')}`)
     }
   })
 
 cmd.command('list')
-  .description('List all REQs in docs/req/')
+  .description(t('req.list.description'))
   .action(async () => {
-    listREQs('docs/req')
+    listREQs(require('../config').load().reqDir)
   })
 
 module.exports = cmd

package/src/commands/roadmap.js

@@ -1,12 +1,13 @@
 'use strict'
 const { Command } = require('commander')
 const { listRoadmaps, showRoadmap, moveRoadmap, newRoadmap } = require('../generators/roadmap')
+const { t } = require('../i18n')
 
 const cmd = new Command('roadmap')
-cmd.description('Manage Roadmaps')
+cmd.description(t('roadmap.description'))
 
 cmd.command('new')
-  .description('Create a new roadmap from a REQ')
+  .description(t('roadmap.new.description'))
   .option('-t, --title <title>', 'Roadmap title')
   .option('-r, --req <path>', 'Path to the linked REQ')
   .action(async (opts) => {
@@ -16,19 +17,19 @@ cmd.command('new')
   })
 
 cmd.command('list')
-  .description('List all roadmaps grouped by state')
+  .description(t('roadmap.list.description'))
   .action(async () => {
     listRoadmaps()
   })
 
 cmd.command('show <name>')
-  .description('Show a roadmap by name (partial match)')
+  .description(t('roadmap.show.description'))
   .action(async (name) => {
     showRoadmap(name)
   })
 
 cmd.command('move <name> <state>')
-  .description('Move a roadmap between states (backlog|wip|blocked|done|abandoned)')
+  .description(t('roadmap.move.description'))
   .action(async (name, state) => {
     moveRoadmap(name, state)
   })

package/src/commands/status.js

@@ -1,9 +1,10 @@
 'use strict'
 const { Command } = require('commander')
 const { getStatus } = require('../validator')
+const { t } = require('../i18n')
 
 const cmd = new Command('status')
-cmd.description('Show project governance status')
+cmd.description(t('status.description'))
 cmd.action(async () => {
   console.log(await getStatus())
 })

package/src/commands/validate.js

@@ -1,24 +1,25 @@
 'use strict'
 const { Command } = require('commander')
 const { validate } = require('../validator')
+const { t } = require('../i18n')
 
 const cmd = new Command('validate')
-cmd.description('Validate governance rules')
+cmd.description(t('validate.description'))
 cmd.action(async () => {
   const { violations, warnings } = await validate()
 
   if (violations.length === 0 && warnings.length === 0) {
-    console.log('✓ No violations found.')
+    console.log(t('validate.ok'))
     return
   }
 
   if (violations.length > 0) {
-    console.log(`\n✗ Violations (${violations.length}):`)
+    console.log(`\n${t('validate.violations', { count: violations.length })}`)
     violations.forEach(v => console.log(`  • ${v}`))
   }
 
   if (warnings.length > 0) {
-    console.log(`\n⚠ Warnings (${warnings.length}):`)
+    console.log(`\n${t('validate.warnings', { count: warnings.length })}`)
     warnings.forEach(w => console.log(`  • ${w}`))
   }
 

package/src/config/index.js

@@ -0,0 +1,92 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function defaults() {
+  return {
+    adrDirs: ['docs/adr'],
+    reqDir: 'docs/req',
+    roadmapDir: 'docs/roadmaps',
+    roadmapNamespacing: 'flat',
+    agents: [],
+    governanceMode: '',
+    lenientUntil: '',
+    wipLimit: 1,
+    wipBySquad: false,
+    requireReqInCommit: false,
+  };
+}
+
+let _instance = null;
+
+function load(cwd) {
+  if (_instance) return _instance;
+  _instance = defaults();
+  const yamlPath = path.join(cwd || process.cwd(), 'trackfw.yaml');
+  if (!fs.existsSync(yamlPath)) return _instance;
+  const content = fs.readFileSync(yamlPath, 'utf8');
+  parse(content, _instance);
+  return _instance;
+}
+
+function reset() {
+  _instance = null;
+}
+
+function parse(content, cfg) {
+  const lines = content.split('\n');
+  let inAdrDirs = false;
+  let inAgents = false;
+  let adrDirs = [];
+  let agents = [];
+
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+
+    if (inAdrDirs) {
+      if (line.startsWith('- ')) {
+        adrDirs.push(line.slice(2).trim());
+        continue;
+      }
+      inAdrDirs = false;
+      if (adrDirs.length) cfg.adrDirs = adrDirs;
+    }
+    if (inAgents) {
+      if (line.startsWith('- ')) {
+        agents.push(line.slice(2).trim());
+        continue;
+      }
+      inAgents = false;
+      if (agents.length) cfg.agents = agents;
+    }
+
+    const colonIdx = line.indexOf(':');
+    if (colonIdx < 0) continue;
+    const key = line.slice(0, colonIdx).trim();
+    const val = line.slice(colonIdx + 1).trim();
+    if (!key) continue;
+
+    switch (key) {
+      case 'adr_dirs': inAdrDirs = true; adrDirs = []; break;
+      case 'req_dir': cfg.reqDir = val; break;
+      case 'roadmap_dir': cfg.roadmapDir = val; break;
+      case 'roadmap_namespacing': cfg.roadmapNamespacing = val; break;
+      case 'agents': inAgents = true; agents = []; break;
+      case 'governance_mode': cfg.governanceMode = val; break;
+      case 'lenient_until': cfg.lenientUntil = val; break;
+      case 'wip_limit': { const n = parseInt(val, 10); if (n > 0) cfg.wipLimit = n; break; }
+      case 'wip_by_squad': cfg.wipBySquad = val === 'true'; break;
+      case 'require_req_in_commit': cfg.requireReqInCommit = val === 'true'; break;
+    }
+  }
+
+  // flush pending lists at EOF
+  if (inAdrDirs && adrDirs.length) cfg.adrDirs = adrDirs;
+  if (inAgents && agents.length) cfg.agents = agents;
+}
+
+const NAMESPACING_FLAT = 'flat'
+const NAMESPACING_BY_AGENT = 'by_agent'
+
+module.exports = { load, reset, defaults, NAMESPACING_FLAT, NAMESPACING_BY_AGENT };

package/src/generators/adr.js

@@ -40,11 +40,12 @@ function today() {
  * @returns {Promise<void>}
  */
 async function newADR(content) {
-  fs.mkdirSync('docs/adr', { recursive: true })
+  const adrDir = require('../config').load().adrDirs[0]
+  fs.mkdirSync(adrDir, { recursive: true })
 
   const slug = toSlug(content.title)
   const date = today()
-  const filename = `docs/adr/ADR-${date}-${slug}.md`
+  const filename = `${adrDir}/ADR-${date}-${slug}.md`
 
   const contextSection = content.context || '<!-- What is the situation that motivates this decision? -->'
   const decisionSection = content.decision || '<!-- What was decided? -->'
@@ -129,10 +130,10 @@ function parseADRStatus(filepath) {
  * @returns {Promise<string>} basename do arquivo criado
  */
 async function newADRDraft(slug) {
-  fs.mkdirSync('docs/adr', { recursive: true })
+  const adrDir = require('../config').load().adrDirs[0]
+  fs.mkdirSync(adrDir, { recursive: true })
 
   // Verificar idempotência: buscar arquivo existente com o mesmo slug
-  const adrDir = 'docs/adr'
   const existing = fs.existsSync(adrDir)
     ? fs.readdirSync(adrDir).find((f) => f.match(new RegExp(`^ADR-.*-${slug}\\.md$`)))
     : null
@@ -144,7 +145,7 @@ async function newADRDraft(slug) {
 
   const date = today()
   const filename = `ADR-${date}-${slug}.md`
-  const filepath = path.join('docs/adr', filename)
+  const filepath = path.join(adrDir, filename)
   const title = slugToTitle(slug)
 
   const body = `# ADR: ${title}

package/src/generators/init.js

@@ -29,6 +29,7 @@ async function scaffold(cfg) {
   generateCIWorkflow(cfg)
   generateGitHooks(cfg)
   generateClaudeMD(cfg)
+  if (cfg.backend === 'java') generatePomXml(cfg)
   generateClaudeCommands()
 }
 
@@ -43,9 +44,17 @@ function writeTrackfwConfig(cfg) {
 
 frontend: ${cfg.frontend || ''}
 backend: ${cfg.backend || ''}
+backend_framework: ${cfg.backendFramework || ''}
 pkg_manager: ${cfg.pkgManager || ''}
 hooks: ${cfg.hooks || ''}
 ci: ${cfg.ci || ''}
+
+# governance paths (edit to match your project structure)
+adr_dirs:
+  - docs/adr
+req_dir: docs/req
+roadmap_dir: docs/roadmaps
+roadmap_namespacing: flat
 `
   fs.writeFileSync('trackfw.yaml', content, 'utf8')
   console.log('  ✓ trackfw.yaml')
@@ -193,6 +202,63 @@ function generateLefthookHook() {
   console.log('  ✓ lefthook.yml')
 }
 
+// ---------------------------------------------------------------------------
+// pom.xml (Java / Spring Boot)
+// ---------------------------------------------------------------------------
+
+function generatePomXml(cfg) {
+  const slug = cfg.projectName
+    ? cfg.projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '')
+    : 'my-app'
+  const name = cfg.projectName || 'My App'
+  const content = `<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-parent</artifactId>
+    <version>3.3.0</version>
+    <relativePath/>
+  </parent>
+  <groupId>com.example</groupId>
+  <artifactId>${slug}</artifactId>
+  <version>0.0.1-SNAPSHOT</version>
+  <name>${name}</name>
+  <description>${name} — generated by trackfw</description>
+  <properties>
+    <java.version>21</java.version>
+  </properties>
+  <dependencies>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-actuator</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-test</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-maven-plugin</artifactId>
+      </plugin>
+    </plugins>
+  </build>
+</project>
+`
+  fs.writeFileSync('pom.xml', content, 'utf8')
+  console.log('  ✓ pom.xml')
+}
+
 // ---------------------------------------------------------------------------
 // CLAUDE.md
 // ---------------------------------------------------------------------------

package/src/generators/req.js

@@ -69,11 +69,12 @@ function toSlug(s) {
  * @returns {Promise<void>}
  */
 async function newREQ(content) {
-  fs.mkdirSync('docs/req', { recursive: true })
+  const reqDir = require('../config').load().reqDir
+  fs.mkdirSync(reqDir, { recursive: true })
 
   const slug = toSlug(content.title)
   const date = new Date().toISOString().slice(0, 10)
-  const filename = `docs/req/REQ-${date}-${slug}.md`
+  const filename = `${reqDir}/REQ-${date}-${slug}.md`
 
   const motivationSection = content.motivation || '<!-- Why is this requirement needed? What problem does it solve? -->'
   const criteriaSection = content.criteria || '- [ ]\n- [ ]'