devvami 1.4.2 → 1.5.1

package/src/formatters/ai-config.js

@@ -0,0 +1,215 @@
+import chalk from 'chalk'
+
+/** @import { DetectedEnvironment, CategoryEntry, NativeEntry } from '../types.js' */
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Pad a string to a fixed width, truncating with '…' if needed.
+ * @param {string} str
+ * @param {number} width
+ * @returns {string}
+ */
+function padCell(str, width) {
+  if (!str) str = ''
+  if (str.length > width) return str.slice(0, width - 1) + '…'
+  return str.padEnd(width)
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Environments table formatter
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Format a list of detected environments as a table string for display in the TUI.
+ * Columns: Environment (name), Status, Scope, MCPs, Commands, Skills, Agents
+ * @param {DetectedEnvironment[]} detectedEnvs
+ * @param {number} [termCols]
+ * @returns {string[]} Array of formatted lines (no ANSI clear/home)
+ */
+export function formatEnvironmentsTable(detectedEnvs, termCols = 120) {
+  const COL_ENV = 22
+  const COL_STATUS = 24
+  const COL_SCOPE = 8
+  const COL_COUNT = 9
+
+  const headerParts = [
+    chalk.bold.white(padCell('Environment', COL_ENV)),
+    chalk.bold.white(padCell('Status', COL_STATUS)),
+    chalk.bold.white(padCell('Scope', COL_SCOPE)),
+    chalk.bold.white(padCell('MCPs', COL_COUNT)),
+    chalk.bold.white(padCell('Commands', COL_COUNT)),
+    chalk.bold.white(padCell('Rules', COL_COUNT)),
+    chalk.bold.white(padCell('Skills', COL_COUNT)),
+    chalk.bold.white(padCell('Agents', COL_COUNT)),
+  ]
+
+  const dividerWidth = COL_ENV + COL_STATUS + COL_SCOPE + COL_COUNT * 5 + 7 * 2
+  const lines = []
+  lines.push(headerParts.join('  '))
+  lines.push(chalk.dim('─'.repeat(Math.min(termCols, dividerWidth))))
+
+  for (const env of detectedEnvs) {
+    const hasUnreadable = env.unreadable.length > 0
+    const statusText = hasUnreadable ? 'Detected (unreadable)' : 'Detected'
+    const statusStr = hasUnreadable
+      ? chalk.yellow(padCell(statusText, COL_STATUS))
+      : chalk.green(padCell(statusText, COL_STATUS))
+    const scopeStr = padCell(env.scope ?? 'project', COL_SCOPE)
+
+    const total = (/** @type {string} */ type) => (env.counts?.[type] ?? 0) + (env.nativeCounts?.[type] ?? 0)
+    const mcpStr = padCell(String(total('mcp')), COL_COUNT)
+    const cmdStr = padCell(String(total('command')), COL_COUNT)
+    const ruleStr = env.supportedCategories.includes('rule')
+      ? padCell(String(total('rule')), COL_COUNT)
+      : padCell('—', COL_COUNT)
+    const skillStr = env.supportedCategories.includes('skill')
+      ? padCell(String(total('skill')), COL_COUNT)
+      : padCell('—', COL_COUNT)
+    const agentStr = env.supportedCategories.includes('agent')
+      ? padCell(String(total('agent')), COL_COUNT)
+      : padCell('—', COL_COUNT)
+
+    lines.push([padCell(env.name, COL_ENV), statusStr, scopeStr, mcpStr, cmdStr, ruleStr, skillStr, agentStr].join('  '))
+  }
+
+  return lines
+}
+
+/** @type {Record<string, string>} */
+const ENV_SHORT_NAMES = {
+  'vscode-copilot': 'VSCode',
+  'claude-code': 'Claude',
+  'claude-desktop': 'Desktop',
+  opencode: 'OpenCode',
+  'gemini-cli': 'Gemini',
+  'copilot-cli': 'Copilot',
+  cursor: 'Cursor',
+  windsurf: 'Windsurf',
+  'continue-dev': 'Continue',
+  zed: 'Zed',
+  'amazon-q': 'Amazon Q',
+}
+
+/**
+ * Mask an environment variable value for display.
+ * Shows first 6 characters followed by ***.
+ * @param {string} value
+ * @returns {string}
+ */
+export function maskEnvVarValue(value) {
+  if (!value || value.length <= 6) return '***'
+  return value.slice(0, 6) + '***'
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Native entries table formatter
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Format native entries as a table for display in a category tab's Native section.
+ * @param {NativeEntry[]} entries
+ * @param {number} [termCols]
+ * @returns {string[]}
+ */
+export function formatNativeEntriesTable(entries, termCols = 120) {
+  const COL_NAME = 24
+  const COL_ENV = 16
+  const COL_LEVEL = 8
+  const COL_CONFIG = 36
+
+  const headerParts = [
+    chalk.bold.white(padCell('Name', COL_NAME)),
+    chalk.bold.white(padCell('Environment', COL_ENV)),
+    chalk.bold.white(padCell('Level', COL_LEVEL)),
+    chalk.bold.white(padCell('Config', COL_CONFIG)),
+  ]
+
+  const dividerWidth = COL_NAME + COL_ENV + COL_LEVEL + COL_CONFIG + 3 * 2
+  const lines = []
+  lines.push(headerParts.join('  '))
+  lines.push(chalk.dim('─'.repeat(Math.min(termCols, dividerWidth))))
+
+  for (const entry of entries) {
+    const envShort = ENV_SHORT_NAMES[entry.environmentId] ?? entry.environmentId
+    const levelStr = padCell(entry.level, COL_LEVEL)
+
+    // Build config summary
+    const params = /** @type {any} */ (entry.params ?? {})
+    let configSummary = ''
+    if (entry.type === 'mcp') {
+      if (params.command) {
+        const args = Array.isArray(params.args) ? params.args.slice(0, 2).join(' ') : ''
+        configSummary = [params.command, args].filter(Boolean).join(' ')
+      } else if (params.url) {
+        configSummary = params.url
+      }
+      // Mask env vars
+      if (params.env && Object.keys(params.env).length > 0) {
+        const maskedVars = Object.keys(params.env)
+          .map((k) => `${k}=${maskEnvVarValue(params.env[k])}`)
+          .join(', ')
+        configSummary = configSummary ? `${configSummary} [${maskedVars}]` : maskedVars
+      }
+    } else {
+      configSummary = params.description ?? params.content?.slice(0, 30) ?? ''
+    }
+
+    lines.push([
+      padCell(entry.name, COL_NAME),
+      padCell(envShort, COL_ENV),
+      levelStr,
+      padCell(configSummary, COL_CONFIG),
+    ].join('  '))
+  }
+
+  return lines
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Categories table formatter
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Format a list of category entries as a table string for display in the TUI.
+ * Columns: Name, Type, Status, Environments
+ * @param {CategoryEntry[]} entries
+ * @param {number} [termCols]
+ * @returns {string[]} Array of formatted lines (no ANSI clear/home)
+ */
+export function formatCategoriesTable(entries, termCols = 120) {
+  const COL_NAME = 24
+  const COL_TYPE = 9
+  const COL_STATUS = 10
+  const COL_ENVS = 36
+
+  const headerParts = [
+    chalk.bold.white(padCell('Name', COL_NAME)),
+    chalk.bold.white(padCell('Type', COL_TYPE)),
+    chalk.bold.white(padCell('Status', COL_STATUS)),
+    chalk.bold.white(padCell('Environments', COL_ENVS)),
+  ]
+
+  const dividerWidth = COL_NAME + COL_TYPE + COL_STATUS + COL_ENVS + 3 * 2
+  const lines = []
+  lines.push(headerParts.join('  '))
+  lines.push(chalk.dim('─'.repeat(Math.min(termCols, dividerWidth))))
+
+  for (const entry of entries) {
+    const statusStr = entry.active
+      ? (/** @type {any} */ (entry)).drifted
+        ? chalk.yellow(padCell('⚠ Drifted', COL_STATUS))
+        : chalk.green(padCell('Active', COL_STATUS))
+      : chalk.dim(padCell('Inactive', COL_STATUS))
+
+    const envNames = entry.environments.map((id) => ENV_SHORT_NAMES[id] ?? id).join(', ')
+
+    lines.push(
+      [padCell(entry.name, COL_NAME), padCell(entry.type, COL_TYPE), statusStr, padCell(envNames, COL_ENVS)].join('  '),
+    )
+  }
+
+  return lines
+}

package/src/formatters/charts.js

@@ -3,16 +3,7 @@ import chalk from 'chalk'
 /** @import { ChartSeries } from '../types.js' */
 
 // Colour palette for multi-series charts (cycles if more than 8 series)
-const PALETTE = [
-  chalk.cyan,
-  chalk.yellow,
-  chalk.green,
-  chalk.magenta,
-  chalk.blue,
-  chalk.red,
-  chalk.white,
-  chalk.gray,
-]
+const PALETTE = [chalk.cyan, chalk.yellow, chalk.green, chalk.magenta, chalk.blue, chalk.red, chalk.white, chalk.gray]
 
 /**
  * Get the terminal width, falling back to 80 columns.
@@ -54,9 +45,7 @@ export function barChart(series, options = {}) {
 
   // Combine all series into per-label totals for scaling
   const allLabels = series[0]?.labels ?? []
-  const totals = allLabels.map((_, i) =>
-    series.reduce((sum, s) => sum + (s.values[i] ?? 0), 0),
-  )
+  const totals = allLabels.map((_, i) => series.reduce((sum, s) => sum + (s.values[i] ?? 0), 0))
   const maxTotal = Math.max(...totals, 0)
 
   const lines = []
@@ -71,7 +60,7 @@ export function barChart(series, options = {}) {
 
   // Build chart column by column (one char per day)
   // We render it as a 2D grid: rows = height levels, cols = days
-  const grid = Array.from({ length: BAR_HEIGHT }, () => Array(allLabels.length).fill(' '))
+  const grid = Array.from({length: BAR_HEIGHT}, () => Array(allLabels.length).fill(' '))
 
   for (let col = 0; col < allLabels.length; col++) {
     const total = totals[col]
@@ -110,9 +99,7 @@ export function barChart(series, options = {}) {
 
   // X-axis date labels (sample every ~10 positions)
   const step = Math.max(1, Math.ceil(allLabels.length / Math.floor(chartWidth / 10)))
-  const xLabels = allLabels
-    .filter((_, i) => i % step === 0)
-    .map((l) => l.slice(5)) // "MM-DD"
+  const xLabels = allLabels.filter((_, i) => i % step === 0).map((l) => l.slice(5)) // "MM-DD"
   lines.push(' '.repeat(labelColWidth + 1) + xLabels.join('         '))
 
   // Legend for multi-series
@@ -156,9 +143,7 @@ export function lineChart(series, options = {}) {
   }
 
   // Build a 2D canvas: rows = chartHeight, cols = chartWidth
-  const canvas = Array.from({ length: chartHeight }, () =>
-    Array(chartWidth).fill(' '),
-  )
+  const canvas = Array.from({length: chartHeight}, () => Array(chartWidth).fill(' '))
 
   const step = Math.max(1, Math.ceil(allLabels.length / chartWidth))
 
@@ -186,9 +171,7 @@ export function lineChart(series, options = {}) {
 
   // X-axis date labels
   const xStep = Math.max(1, Math.ceil(allLabels.length / Math.floor(chartWidth / 10)))
-  const xLabels = allLabels
-    .filter((_, i) => i % xStep === 0)
-    .map((l) => l.slice(5))
+  const xLabels = allLabels.filter((_, i) => i % xStep === 0).map((l) => l.slice(5))
   lines.push(' '.repeat(labelColWidth + 1) + xLabels.join('         '))
 
   // Legend

package/src/formatters/cost.js

@@ -57,11 +57,5 @@ export function formatCostTable(entries, label, groupBy = 'service') {
     .map((e) => `  ${rowLabel(e, groupBy).padEnd(40)} ${formatCurrency(e.amount)}`)
     .join('\n')
   const divider = '─'.repeat(50)
-  return [
-    `Costs for: ${label}`,
-    divider,
-    rows,
-    divider,
-    `  ${'Total'.padEnd(40)} ${formatCurrency(total)}`,
-  ].join('\n')
+  return [`Costs for: ${label}`, divider, rows, divider, `  ${'Total'.padEnd(40)} ${formatCurrency(total)}`].join('\n')
 }

package/src/formatters/dotfiles.js

@@ -21,7 +21,9 @@ export function formatDotfilesSetup(result) {
     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')}`),
+    chalk.bold(
+      `  Status:      ${result.status === 'success' ? chalk.green('success') : result.status === 'skipped' ? chalk.dim('skipped') : chalk.red('failed')}`,
+    ),
   ]
 
   if (result.sourceDir) {
@@ -79,11 +81,41 @@ export function formatDotfilesSummary(summary) {
  */
 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('.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'
+  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'
 }
 
@@ -167,13 +199,7 @@ export function formatDotfilesStatus(result) {
  * @returns {string}
  */
 export function formatDotfilesAdd(result) {
-  const lines = [
-    '',
-    BORDER,
-    chalk.bold('  Dotfiles Add — Summary'),
-    BORDER,
-    '',
-  ]
+  const lines = ['', BORDER, chalk.bold('  Dotfiles Add — Summary'), BORDER, '']
 
   if (result.added.length > 0) {
     lines.push(chalk.bold(`  Added (${result.added.length}):`))
@@ -219,12 +245,13 @@ export function formatDotfilesAdd(result) {
  * @returns {string}
  */
 export function formatDotfilesSync(result) {
-  const actionLabel = {
-    push: 'Push',
-    pull: 'Pull',
-    'init-remote': 'Remote Setup',
-    skipped: 'Skipped',
-  }[result.action] ?? result.action
+  const actionLabel =
+    {
+      push: 'Push',
+      pull: 'Pull',
+      'init-remote': 'Remote Setup',
+      skipped: 'Skipped',
+    }[result.action] ?? result.action
 
   const lines = [
     '',
@@ -233,7 +260,9 @@ export function formatDotfilesSync(result) {
     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')}`),
+    chalk.white(
+      `  Status:  ${result.status === 'success' ? chalk.green('success') : result.status === 'skipped' ? chalk.dim('skipped') : chalk.red('failed')}`,
+    ),
   ]
 
   if (result.repo) {

package/src/formatters/markdown.js

@@ -1,6 +1,6 @@
-import { marked } from 'marked'
+import {marked} from 'marked'
 import chalk from 'chalk'
-import { deflate } from 'pako'
+import {deflate} from 'pako'
 
 // Custom terminal renderer — outputs ANSI-formatted text using chalk.
 // marked-terminal@7 is incompatible with all currently released versions of marked
@@ -30,7 +30,12 @@ const terminalRenderer = {
     return '\n' + lines.join('\n') + '\n\n'
   },
   blockquote(quote) {
-    return quote.split('\n').map((l) => chalk.dim('│ ') + chalk.italic(l)).join('\n') + '\n'
+    return (
+      quote
+        .split('\n')
+        .map((l) => chalk.dim('│ ') + chalk.italic(l))
+        .join('\n') + '\n'
+    )
   },
   link(href, _title, text) {
     return `${text} ${chalk.dim(`(${href})`)}`
@@ -61,7 +66,7 @@ const terminalRenderer = {
   },
 }
 
-marked.use({ renderer: terminalRenderer })
+marked.use({renderer: terminalRenderer})
 
 /**
  * Render a markdown string as ANSI-formatted terminal output.
@@ -95,14 +100,14 @@ export function extractMermaidBlocks(content) {
 export function toMermaidLiveUrl(diagramCode) {
   const state = JSON.stringify({
     code: diagramCode,
-    mermaid: JSON.stringify({ theme: 'default' }),
+    mermaid: JSON.stringify({theme: 'default'}),
     updateDiagram: true,
     grid: true,
     panZoom: true,
     rough: false,
   })
   const data = new TextEncoder().encode(state)
-  const compressed = deflate(data, { level: 9 })
+  const compressed = deflate(data, {level: 9})
   const encoded = Buffer.from(compressed).toString('base64url')
   return `https://mermaid.live/view#pako:${encoded}`
 }

package/src/formatters/openapi.js

@@ -1,4 +1,4 @@
-import { load } from 'js-yaml'
+import {load} from 'js-yaml'
 
 /** @import { APIEndpoint, AsyncChannel } from '../types.js' */
 
@@ -45,7 +45,7 @@ export function isAsyncApi(doc) {
 export function parseOpenApi(content) {
   const doc = parseYamlOrJson(content)
   if (!doc || !isOpenApi(doc)) {
-    return { endpoints: [], error: 'Not a valid OpenAPI/Swagger document' }
+    return {endpoints: [], error: 'Not a valid OpenAPI/Swagger document'}
   }
 
   /** @type {APIEndpoint[]} */
@@ -58,9 +58,7 @@ export function parseOpenApi(content) {
       if (!['get', 'post', 'put', 'patch', 'delete', 'head', 'options'].includes(method)) continue
       const operation = /** @type {Record<string, unknown>} */ (op)
       const rawParams = /** @type {Array<Record<string, unknown>>} */ (operation.parameters ?? [])
-      const parameters = rawParams
-        .map((p) => (p.required ? `${p.name}*` : String(p.name)))
-        .join(', ')
+      const parameters = rawParams.map((p) => (p.required ? `${p.name}*` : String(p.name))).join(', ')
       endpoints.push({
         method: method.toUpperCase(),
         path,
@@ -70,7 +68,7 @@ export function parseOpenApi(content) {
     }
   }
 
-  return { endpoints, error: null }
+  return {endpoints, error: null}
 }
 
 /**
@@ -81,7 +79,7 @@ export function parseOpenApi(content) {
 export function parseAsyncApi(content) {
   const doc = parseYamlOrJson(content)
   if (!doc || !isAsyncApi(doc)) {
-    return { channels: [], error: 'Not a valid AsyncAPI document' }
+    return {channels: [], error: 'Not a valid AsyncAPI document'}
   }
 
   /** @type {AsyncChannel[]} */
@@ -98,7 +96,7 @@ export function parseAsyncApi(content) {
         return String(ch.$ref ?? '').includes(channelName) || String(ch ?? '') === channelName
       })
       if (matchingOps.length === 0) {
-        channels.push({ channel: channelName, operation: '—', summary: '', message: '—' })
+        channels.push({channel: channelName, operation: '—', summary: '', message: '—'})
       }
       for (const op of matchingOps) {
         const msgTitle = resolveMessageTitle(op.messages)
@@ -129,7 +127,7 @@ export function parseAsyncApi(content) {
     }
   }
 
-  return { channels, error: null }
+  return {channels, error: null}
 }
 
 /**