devvami 1.3.0 → 1.4.0

package/src/formatters/dotfiles.js

@@ -0,0 +1,259 @@
+import chalk from 'chalk'
+
+/** @import { DotfilesSetupResult, DotfilesStatusResult, DotfilesAddResult, DotfilesSyncResult, DotfileEntry } from '../types.js' */
+
+const BORDER = chalk.dim('─'.repeat(60))
+
+// ---------------------------------------------------------------------------
+// formatDotfilesSetup (T020)
+// ---------------------------------------------------------------------------
+
+/**
+ * Format the output of `dvmi dotfiles setup` completion.
+ * @param {DotfilesSetupResult} result
+ * @returns {string}
+ */
+export function formatDotfilesSetup(result) {
+  const lines = [
+    '',
+    BORDER,
+    chalk.bold('  Dotfiles Setup — Summary'),
+    BORDER,
+    '',
+    chalk.bold(`  Platform:    ${chalk.cyan(result.platform)}`),
+    chalk.bold(`  Status:      ${result.status === 'success' ? chalk.green('success') : result.status === 'skipped' ? chalk.dim('skipped') : chalk.red('failed')}`),
+  ]
+
+  if (result.sourceDir) {
+    lines.push(chalk.white(`  Source dir:  ${chalk.cyan(result.sourceDir)}`))
+  }
+
+  if (result.publicKey) {
+    lines.push('')
+    lines.push(chalk.white(`  Age public key:`))
+    lines.push(chalk.cyan(`    ${result.publicKey}`))
+    lines.push('')
+    lines.push(chalk.yellow('  IMPORTANT: Back up your age key!'))
+    lines.push(chalk.dim(`    Key file: ~/.config/chezmoi/key.txt`))
+    lines.push(chalk.dim('    Without this key you cannot decrypt your dotfiles on a new machine.'))
+  }
+
+  if (result.status === 'success') {
+    lines.push('')
+    lines.push(chalk.bold.green('  Chezmoi configured with age encryption!'))
+    lines.push(chalk.dim('  Run `dvmi dotfiles add` to start tracking files'))
+  } else if (result.status === 'failed') {
+    lines.push('')
+    lines.push(chalk.bold.red('  Setup failed.'))
+    if (result.message) lines.push(chalk.dim(`  → ${result.message}`))
+  } else if (result.status === 'skipped') {
+    lines.push('')
+    if (result.message) lines.push(chalk.dim(`  ${result.message}`))
+  }
+
+  lines.push(BORDER)
+  return lines.join('\n')
+}
+
+// ---------------------------------------------------------------------------
+// formatDotfilesSummary (T012)
+// ---------------------------------------------------------------------------
+
+/**
+ * Format the file count summary line.
+ * @param {{ total: number, encrypted: number, plaintext: number }} summary
+ * @returns {string}
+ */
+export function formatDotfilesSummary(summary) {
+  return `${summary.total} total: ${summary.plaintext} plaintext, ${summary.encrypted} encrypted`
+}
+
+// ---------------------------------------------------------------------------
+// formatDotfilesStatus (T012 / T032)
+// ---------------------------------------------------------------------------
+
+/**
+ * Infer a display category from a file path.
+ * @param {string} filePath
+ * @returns {string}
+ */
+function inferCategory(filePath) {
+  const lower = filePath.toLowerCase()
+  if (lower.includes('.ssh') || lower.includes('.gnupg') || lower.includes('gpg') || lower.includes('secret') || lower.includes('credential') || lower.includes('token') || lower.includes('password')) return 'Security'
+  if (lower.includes('.gitconfig') || lower.includes('.gitignore') || lower.includes('.git')) return 'Git'
+  if (lower.includes('zshrc') || lower.includes('bashrc') || lower.includes('bash_profile') || lower.includes('zprofile') || lower.includes('fish')) return 'Shell'
+  if (lower.includes('vim') || lower.includes('nvim') || lower.includes('emacs') || lower.includes('vscode') || lower.includes('cursor')) return 'Editor'
+  if (lower.includes('brew') || lower.includes('npm') || lower.includes('yarn') || lower.includes('pip') || lower.includes('gem')) return 'Package'
+  return 'Other'
+}
+
+/**
+ * Format the full `dvmi dotfiles status` interactive output.
+ * @param {DotfilesStatusResult} result
+ * @returns {string}
+ */
+export function formatDotfilesStatus(result) {
+  const lines = [
+    '',
+    BORDER,
+    chalk.bold('  Dotfiles Status'),
+    BORDER,
+    '',
+    chalk.white(`  Platform:    ${chalk.cyan(result.platform)}`),
+  ]
+
+  if (result.sourceDir) {
+    lines.push(chalk.white(`  Source dir:  ${chalk.cyan(result.sourceDir)}`))
+  }
+
+  const encLabel = result.encryptionConfigured ? chalk.green('age (configured)') : chalk.dim('not configured')
+  lines.push(chalk.white(`  Encryption:  ${encLabel}`))
+
+  if (result.repo) {
+    lines.push(chalk.white(`  Remote:      ${chalk.cyan(result.repo)}`))
+  } else {
+    lines.push(chalk.white(`  Remote:      ${chalk.dim('not configured')}`))
+  }
+
+  if (!result.enabled) {
+    lines.push('')
+    lines.push(chalk.dim('  Dotfiles management not configured.'))
+    lines.push(chalk.dim('  Run `dvmi dotfiles setup` to get started.'))
+    lines.push(BORDER)
+    return lines.join('\n')
+  }
+
+  // Group files by category
+  /** @type {Record<string, DotfileEntry[]>} */
+  const grouped = {}
+  for (const file of result.files) {
+    const category = inferCategory(file.path)
+    if (!grouped[category]) grouped[category] = []
+    grouped[category].push(file)
+  }
+
+  const summaryLine = formatDotfilesSummary(result.summary)
+  lines.push('')
+  lines.push(chalk.bold(`  Managed Files (${summaryLine})`))
+  lines.push(BORDER)
+
+  for (const [category, files] of Object.entries(grouped)) {
+    const catLabel = category === 'Security' ? `  ${category} 🔒` : `  ${category}`
+    lines.push('')
+    lines.push(chalk.bold(catLabel))
+    for (const file of files) {
+      const encTag = file.encrypted ? chalk.dim('  encrypted') : ''
+      lines.push(`    ${file.path}${encTag}`)
+    }
+  }
+
+  if (result.files.length === 0) {
+    lines.push('')
+    lines.push(chalk.dim('  No files managed yet. Run `dvmi dotfiles add` to start tracking files.'))
+  }
+
+  lines.push('')
+  lines.push(BORDER)
+  return lines.join('\n')
+}
+
+// ---------------------------------------------------------------------------
+// formatDotfilesAdd (T027)
+// ---------------------------------------------------------------------------
+
+/**
+ * Format the output of `dvmi dotfiles add` completion.
+ * @param {DotfilesAddResult} result
+ * @returns {string}
+ */
+export function formatDotfilesAdd(result) {
+  const lines = [
+    '',
+    BORDER,
+    chalk.bold('  Dotfiles Add — Summary'),
+    BORDER,
+    '',
+  ]
+
+  if (result.added.length > 0) {
+    lines.push(chalk.bold(`  Added (${result.added.length}):`))
+    for (const item of result.added) {
+      const encTag = item.encrypted ? chalk.dim(' [encrypted]') : ''
+      lines.push(chalk.green(`    ✔ ${item.path}${encTag}`))
+    }
+    lines.push('')
+  }
+
+  if (result.skipped.length > 0) {
+    lines.push(chalk.bold(`  Skipped (${result.skipped.length}):`))
+    for (const item of result.skipped) {
+      lines.push(chalk.dim(`    ─ ${item.path}  ${item.reason}`))
+    }
+    lines.push('')
+  }
+
+  if (result.rejected.length > 0) {
+    lines.push(chalk.bold(`  Rejected (${result.rejected.length}):`))
+    for (const item of result.rejected) {
+      lines.push(chalk.red(`    ✗ ${item.path}  ${item.reason}`))
+    }
+    lines.push('')
+  }
+
+  if (result.added.length === 0 && result.skipped.length === 0 && result.rejected.length === 0) {
+    lines.push(chalk.dim('  No files processed.'))
+    lines.push('')
+  }
+
+  lines.push(BORDER)
+  return lines.join('\n')
+}
+
+// ---------------------------------------------------------------------------
+// formatDotfilesSync (T039 / T044)
+// ---------------------------------------------------------------------------
+
+/**
+ * Format the output of `dvmi dotfiles sync` completion.
+ * @param {DotfilesSyncResult} result
+ * @returns {string}
+ */
+export function formatDotfilesSync(result) {
+  const actionLabel = {
+    push: 'Push',
+    pull: 'Pull',
+    'init-remote': 'Remote Setup',
+    skipped: 'Skipped',
+  }[result.action] ?? result.action
+
+  const lines = [
+    '',
+    BORDER,
+    chalk.bold(`  Dotfiles Sync — ${actionLabel}`),
+    BORDER,
+    '',
+    chalk.white(`  Action:  ${chalk.cyan(actionLabel)}`),
+    chalk.white(`  Status:  ${result.status === 'success' ? chalk.green('success') : result.status === 'skipped' ? chalk.dim('skipped') : chalk.red('failed')}`),
+  ]
+
+  if (result.repo) {
+    lines.push(chalk.white(`  Remote:  ${chalk.cyan(result.repo)}`))
+  }
+
+  if (result.message) {
+    lines.push('')
+    lines.push(chalk.white(`  ${result.message}`))
+  }
+
+  if (result.conflicts && result.conflicts.length > 0) {
+    lines.push('')
+    lines.push(chalk.bold.red(`  Conflicts (${result.conflicts.length}):`))
+    for (const conflict of result.conflicts) {
+      lines.push(chalk.red(`    ✗ ${conflict}`))
+    }
+    lines.push(chalk.dim('  Resolve conflicts manually and run `chezmoi apply` to continue.'))
+  }
+
+  lines.push(BORDER)
+  return lines.join('\n')
+}

package/src/help.js

@@ -87,6 +87,15 @@ const CATEGORIES = [
       { id: 'security:setup', hint: '[--json]' },
     ],
   },
+  {
+    title: 'Dotfiles & Cifratura',
+    cmds: [
+      { id: 'dotfiles:setup',  hint: '[--json]' },
+      { id: 'dotfiles:add',    hint: '[FILES...] [--encrypt]' },
+      { id: 'dotfiles:status', hint: '[--json]' },
+      { id: 'dotfiles:sync',   hint: '[--push] [--pull] [--dry-run]' },
+    ],
+  },
   {
     title: 'Setup & Ambiente',
     cmds: [
@@ -119,7 +128,20 @@ export default class CustomHelp extends Help {
    async showRootHelp() {
      // Animated logo — identical to `dvmi init` (no-ops in CI/non-TTY)
      await printBanner()
-     this.log(this.#buildRootLayout())
+
+     // Version check: uses cached result (populated by init hook) — 800 ms timeout
+     let versionInfo = null
+     try {
+       const { checkForUpdate } = await import('./services/version-check.js')
+       versionInfo = await Promise.race([
+         checkForUpdate(),
+         new Promise((resolve) => setTimeout(() => resolve(null), 800)),
+       ])
+     } catch {
+       // never block help output
+     }
+
+     this.log(this.#buildRootLayout(versionInfo))
    }
 
   /**
@@ -151,9 +173,10 @@ export default class CustomHelp extends Help {
 
    /**
     * Build the full categorized root help layout.
+    * @param {{ hasUpdate: boolean, current: string, latest: string|null }|null} [versionInfo]
     * @returns {string}
     */
-  #buildRootLayout() {
+  #buildRootLayout(versionInfo = null) {
     /** @type {Map<string, import('@oclif/core').Command.Cached>} */
     const cmdMap = new Map(this.config.commands.map((c) => [c.id, c]))
 
@@ -181,6 +204,10 @@ export default class CustomHelp extends Help {
       { cmd: 'dvmi logs --group /aws/lambda/my-fn --filter "ERROR"',  note: 'Filtra eventi ERROR su un log group' },
       { cmd: 'dvmi security setup --json',                            note: 'Controlla lo stato degli strumenti di sicurezza' },
       { cmd: 'dvmi security setup',                                   note: 'Wizard interattivo: installa aws-vault e GCM' },
+      { cmd: 'dvmi dotfiles setup',                                   note: 'Configura chezmoi con cifratura age' },
+      { cmd: 'dvmi dotfiles add ~/.zshrc ~/.gitconfig',               note: 'Aggiungi dotfile a chezmoi' },
+      { cmd: 'dvmi dotfiles status --json',                           note: 'Stato dotfile gestiti (JSON)' },
+      { cmd: 'dvmi dotfiles sync --push',                             note: 'Push dotfile al repository remoto' },
       { cmd: 'dvmi welcome',                                          note: 'Dashboard missione dvmi con intro animata' },
     ]
 
@@ -248,6 +275,24 @@ export default class CustomHelp extends Help {
     }
 
      lines.push('')
+
+     // ── Versione + update notice ───────────────────────────────────────────
+     const current = versionInfo?.current ?? this.config.version
+     const versionStr = isColorEnabled
+       ? chalk.dim('version ') + chalk.hex(DIM_BLUE)(current)
+       : `version ${current}`
+
+     if (versionInfo?.hasUpdate && versionInfo.latest) {
+       const updateStr = isColorEnabled
+         ? chalk.yellow('update disponibile: ') +
+           chalk.dim(current) + chalk.yellow(' → ') + chalk.green(versionInfo.latest) +
+           chalk.dim('  (esegui ') + chalk.hex(LIGHT_ORANGE)('dvmi upgrade') + chalk.dim(')')
+         : `update disponibile: ${current} → ${versionInfo.latest}  (esegui dvmi upgrade)`
+       lines.push('  ' + versionStr + chalk.dim('  ·  ') + updateStr)
+     } else {
+       lines.push('  ' + versionStr)
+     }
+
      lines.push(
        '  ' + chalk.dim('Approfondisci:') + ' ' +
        chalk.hex(DIM_BLUE)('dvmi <COMANDO> --help') +