devvami 1.0.0

package/src/help.js

@@ -0,0 +1,312 @@
+import { Help } from '@oclif/core'
+import chalk from 'chalk'
+import { isColorEnabled } from './utils/gradient.js'
+import { printBanner } from './utils/banner.js'
+
+// ─── Brand palette (flat — no gradient on help rows) ────────────────────────
+const ORANGE       = '#FF6B2B'
+const LIGHT_ORANGE = '#FF9A5C'
+const DIM_BLUE     = '#4A9EFF'
+const DIM_GRAY     = '#888888'
+
+// Strip ANSI escape codes
+const ANSI_RE = /\x1B\[[0-?]*[ -/]*[@-~]/g
+/**
+ * @param {string} s
+ * @returns {string}
+ */
+const strip = (s) => s.replace(ANSI_RE, '')
+
+// ─── Category definitions ────────────────────────────────────────────────────
+
+/** @typedef {{ id: string, hint?: string }} CmdEntry */
+/** @typedef {{ title: string, cmds: CmdEntry[] }} Category */
+
+/** @type {Category[]} */
+const CATEGORIES = [
+  {
+    title: 'GitHub & Documentazione',
+    cmds: [
+      { id: 'repo:list',       hint: '[--language] [--search]' },
+      { id: 'docs:read',       hint: '[FILE] [--repo] [--raw] [--render]' },
+      { id: 'docs:list',       hint: '[--repo] [--search]' },
+      { id: 'docs:search',     hint: '<TERM> [--repo]' },
+      { id: 'docs:projects',   hint: '[--search]' },
+      { id: 'create:repo',     hint: '[TEMPLATE] [--list] [--name]' },
+      { id: 'search',          hint: '<QUERY>' },
+      { id: 'open',            hint: '<TARGET>' },
+    ],
+  },
+  {
+    title: 'Pull Request',
+    cmds: [
+      { id: 'pr:create',  hint: '' },
+      { id: 'pr:status',  hint: '' },
+      { id: 'pr:detail',  hint: '<PR_NUMBER> --repo <owner/repo>' },
+      { id: 'pr:review',  hint: '' },
+    ],
+  },
+  {
+    title: 'Pipeline & DevOps',
+    cmds: [
+      { id: 'pipeline:status', hint: '[--repo] [--branch]' },
+      { id: 'pipeline:rerun',  hint: '<RUN_ID> --repo <repo>' },
+      { id: 'pipeline:logs',   hint: '<RUN_ID> --repo <repo>' },
+      { id: 'changelog',       hint: '' },
+    ],
+  },
+  {
+    title: 'Tasks (ClickUp)',
+    cmds: [
+      { id: 'tasks:list',  hint: '[--status] [--search]' },
+      { id: 'tasks:today', hint: '' },
+    ],
+  },
+  {
+    title: 'Cloud & Costi',
+    cmds: [
+      { id: 'costs:get', hint: '[--period] [--profile]' },
+    ],
+  },
+  {
+    title: 'Setup & Ambiente',
+    cmds: [
+      { id: 'init',       hint: '[--dry-run]' },
+      { id: 'doctor',     hint: '' },
+      { id: 'auth:login', hint: '' },
+      { id: 'whoami',     hint: '' },
+      { id: 'upgrade',    hint: '' },
+    ],
+  },
+]
+
+// ─── Example commands shown at bottom of root help ──────────────────────────
+const EXAMPLES = [
+   { cmd: 'dvmi docs read',                    note: 'Leggi il README del repo corrente' },
+   { cmd: 'dvmi docs read openapi.yaml',       note: 'Tabella endpoints OpenAPI nel terminale' },
+   { cmd: 'dvmi docs search "authentication"', note: 'Cerca nei docs del repo corrente' },
+   { cmd: 'dvmi repo list --search "api"',     note: 'Filtra repository per nome' },
+   { cmd: 'dvmi pr status',                    note: 'PR aperte e review in attesa' },
+   { cmd: 'dvmi pipeline status',              note: 'Ultimi workflow CI/CD' },
+   { cmd: 'dvmi tasks list --search "bug"',    note: 'Cerca task ClickUp' },
+   { cmd: 'dvmi costs get --json',             note: 'Costi AWS in formato JSON' },
+ ]
+
+// ─── Help class ─────────────────────────────────────────────────────────────
+
+/**
+ * Custom help class.
+ * - showRootHelp: logo SNTG animato + layout comandi raggruppati per categoria
+ * - formatTopic / formatCommand: colorizza flag, descrizioni e esempi
+ * - Gradient solo sul logo; tutto il resto usa colori flat chalk
+ */
+export default class CustomHelp extends Help {
+
+   /**
+    * Root help override: banner animato → layout categorizzato.
+    * Override di showRootHelp() (async) per evitare che formatRoot() (sync)
+    * debba attendere la Promise del banner.
+    * @returns {Promise<void>}
+    */
+   async showRootHelp() {
+     // Animated logo — identical to `dvmi init` (no-ops in CI/non-TTY)
+     await printBanner()
+     this.log(this.#buildRootLayout())
+   }
+
+  /**
+   * @param {import('@oclif/core').Interfaces.Topic[]} topics
+   * @returns {string}
+   */
+  formatTopics(topics) {
+    return this.#flatColorizeTopics(super.formatTopics(topics))
+  }
+
+  /**
+   * @param {import('@oclif/core').Interfaces.Topic} topic
+   * @param {import('@oclif/core').Command.Class[]} commands
+   * @returns {string}
+   */
+  formatTopic(topic, commands) {
+    return this.#colorizeRows(super.formatTopic(topic, commands))
+  }
+
+  /**
+   * @param {import('@oclif/core').Command.Class} command
+   * @returns {string}
+   */
+  formatCommand(command) {
+    return this.#colorizeRows(super.formatCommand(command))
+  }
+
+  // ─── Private helpers ──────────────────────────────────────────────────────
+
+  /**
+   * Build the full categorized root help layout.
+   * @returns {string}
+   */
+  #buildRootLayout() {
+    /** @type {Map<string, import('@oclif/core').Command.Cached>} */
+    const cmdMap = new Map(this.config.commands.map((c) => [c.id, c]))
+
+    const lines = []
+
+     // ── Usage ──────────────────────────────────────────────────────────────
+     lines.push(this.#sectionHeader('USAGE'))
+     lines.push(
+       '  ' + (isColorEnabled ? chalk.hex(ORANGE).bold('dvmi') : 'dvmi') +
+       chalk.dim(' <COMANDO> [FLAGS]\n'),
+     )
+
+    // ── Comandi per categoria ──────────────────────────────────────────────
+    lines.push(this.#sectionHeader('COMMANDS'))
+
+    for (const cat of CATEGORIES) {
+      lines.push(
+        '  ' + (isColorEnabled ? chalk.hex(ORANGE).bold(cat.title) : cat.title),
+      )
+
+      for (const entry of cat.cmds) {
+        const cmd = cmdMap.get(entry.id)
+        if (!cmd) continue
+
+        const displayId = entry.id.replaceAll(':', ' ')
+        const hint = entry.hint || ''
+        const desc = cmd.summary ?? (typeof cmd.description === 'string'
+          ? cmd.description.split('\n')[0]
+          : '')
+
+        // Left column (name + flags hint), right-padded to align descriptions
+        const rawLeft = '    ' + displayId + (hint ? ' ' + hint : '')
+        const pad = ' '.repeat(Math.max(2, 50 - rawLeft.length))
+
+        const leftPart = isColorEnabled
+          ? '    ' + chalk.hex(LIGHT_ORANGE).bold(displayId) +
+            (hint ? ' ' + chalk.dim(hint) : '')
+          : rawLeft
+
+        lines.push(leftPart + pad + chalk.dim(desc))
+      }
+
+      lines.push('')
+    }
+
+    // ── Flag globali ───────────────────────────────────────────────────────
+    lines.push(this.#sectionHeader('GLOBAL FLAGS'))
+    lines.push(this.#flagLine('-h, --help',    'Mostra aiuto per un comando'))
+    lines.push(this.#flagLine('    --json',    'Output in formato JSON strutturato'))
+    lines.push(this.#flagLine('-v, --version', 'Versione installata'))
+    lines.push('')
+
+    // ── Esempi ─────────────────────────────────────────────────────────────
+    lines.push(this.#sectionHeader('EXAMPLES'))
+
+    const maxCmdLen = Math.max(...EXAMPLES.map((e) => e.cmd.length))
+    for (const ex of EXAMPLES) {
+      const pad = ' '.repeat(maxCmdLen - ex.cmd.length + 4)
+       const sub = ex.cmd.replace(/^dvmi /, '')
+       const formatted = isColorEnabled
+         ? chalk.dim('$') + ' ' + chalk.hex(ORANGE).bold('dvmi') + ' ' +
+           chalk.white(sub) + pad + chalk.hex(DIM_GRAY)(ex.note)
+         : '$ ' + ex.cmd + pad + ex.note
+      lines.push('  ' + formatted)
+    }
+
+     lines.push('')
+     lines.push(
+       '  ' + chalk.dim('Approfondisci:') + ' ' +
+       chalk.hex(DIM_BLUE)('dvmi <COMANDO> --help') +
+       chalk.dim('  ·  ') +
+       chalk.hex(DIM_BLUE)('dvmi <TOPIC> --help') + '\n',
+     )
+
+    return lines.join('\n')
+  }
+
+  /**
+   * @param {string} title
+   * @returns {string}
+   */
+  #sectionHeader(title) {
+    return isColorEnabled ? chalk.hex(ORANGE).bold(title) : title
+  }
+
+  /**
+   * @param {string} flagStr
+   * @param {string} desc
+   * @returns {string}
+   */
+  #flagLine(flagStr, desc) {
+    const pad = ' '.repeat(Math.max(2, 18 - flagStr.length))
+    return isColorEnabled
+      ? '  ' + chalk.hex(DIM_BLUE).bold(flagStr) + pad + chalk.dim(desc)
+      : '  ' + flagStr + pad + desc
+  }
+
+  /**
+   * Colorize topic list with flat orange names (no gradient).
+   * @param {string} text
+   * @returns {string}
+   */
+  #flatColorizeTopics(text) {
+    return text
+      .split('\n')
+      .map((line) => {
+        const plain = strip(line)
+        if (!plain.trim()) return line
+
+        const rowMatch = plain.match(/^(  )([a-z][\w-]*)(\s{2,})(.+)$/)
+        if (rowMatch) {
+          const [, indent, name, spaces, desc] = rowMatch
+          return indent + chalk.hex(LIGHT_ORANGE).bold(name) + spaces + chalk.white(desc)
+        }
+
+        const subMatch = plain.match(/^(    )([a-z][\w -]*)(\s{2,})(.*)$/)
+        if (subMatch) {
+          const [, indent, name, spaces, desc] = subMatch
+          return indent + chalk.hex(LIGHT_ORANGE)(name) + spaces + chalk.dim(desc)
+        }
+
+        return line
+      })
+      .join('\n')
+  }
+
+  /**
+   * Colorize flag rows and command rows in individual command help pages.
+   * @param {string} text
+   * @returns {string}
+   */
+  #colorizeRows(text) {
+    return text
+      .split('\n')
+      .map((line) => {
+        const plain = strip(line)
+        if (!plain.trim()) return line
+
+         // Example lines: "$ dvmi …"
+         if (plain.includes('$ dvmi') || plain.trim().startsWith('$ dvmi')) {
+           return plain.replace(/\$ (dvmi\S*)/g, (_, cmd) =>
+             '$ ' + chalk.hex(ORANGE).bold(cmd),
+           )
+         }
+
+        // Flag rows: "--flag  desc" or "-f, --flag  desc"
+        const flagMatch = plain.match(/^(\s{2,})((?:-\w,\s*)?--[\w-]+)(\s+)(.*)$/)
+        if (flagMatch) {
+          const [, indent, flags, spaces, desc] = flagMatch
+          return indent + chalk.hex(DIM_BLUE).bold(flags) + spaces + chalk.dim(desc)
+        }
+
+        // Command/topic rows: "  name   description"
+        const rowMatch = plain.match(/^(  )([a-z][\w:-]*)(\s{2,})(.+)$/)
+        if (rowMatch) {
+          const [, indent, name, spaces, desc] = rowMatch
+          return indent + chalk.hex(LIGHT_ORANGE).bold(name) + spaces + chalk.white(desc)
+        }
+
+        return line
+      })
+      .join('\n')
+  }
+}

package/src/hooks/init.js

@@ -0,0 +1,9 @@
+/**
+ * Pre-command hook: trigger non-blocking version check.
+ */
+export const init = async () => {
+  // Fire-and-forget version check — result used by postrun hook
+  import('../services/version-check.js')
+    .then(({ checkForUpdate }) => checkForUpdate())
+    .catch(() => null) // never block command execution
+}

package/src/hooks/postrun.js

@@ -0,0 +1,18 @@
+import chalk from 'chalk'
+
+/**
+ * Post-command hook: display update notification if a newer version is available.
+ */
+export const postrun = async () => {
+  try {
+    const { checkForUpdate } = await import('../services/version-check.js')
+    const { hasUpdate, current, latest } = await checkForUpdate()
+     if (hasUpdate && latest) {
+       process.stderr.write(
+         chalk.dim(`\nUpdate available: ${current} → ${chalk.green(latest)}. Run \`dvmi upgrade\`\n`),
+       )
+     }
+  } catch {
+    // Never interrupt user flow
+  }
+}

package/src/index.js

@@ -0,0 +1 @@
+export { run } from '@oclif/core'

package/src/services/auth.js

@@ -0,0 +1,83 @@
+import { exec } from './shell.js'
+import { loadConfig } from './config.js'
+
+/**
+ * @typedef {Object} AuthStatus
+ * @property {boolean} authenticated
+ * @property {string} [username]
+ * @property {string} [account]
+ * @property {string} [role]
+ * @property {string} [error]
+ */
+
+/**
+ * Check GitHub authentication status.
+ * @returns {Promise<AuthStatus>}
+ */
+export async function checkGitHubAuth() {
+  const result = await exec('gh', ['auth', 'status'])
+  if (result.exitCode !== 0) {
+    return { authenticated: false, error: result.stderr }
+  }
+  // Extract username from output like "Logged in to github.com as username"
+  const match = result.stderr.match(/Logged in to .+ as (\S+)/)
+  return { authenticated: true, username: match?.[1] ?? 'unknown' }
+}
+
+/**
+ * Log in to GitHub via SSO (opens browser).
+ * @returns {Promise<AuthStatus>}
+ */
+export async function loginGitHub() {
+  const result = await exec('gh', ['auth', 'login', '--web'])
+  if (result.exitCode !== 0) {
+    return { authenticated: false, error: result.stderr }
+  }
+  return checkGitHubAuth()
+}
+
+/**
+ * Check AWS authentication via aws-vault.
+ * @returns {Promise<AuthStatus>}
+ */
+export async function checkAWSAuth() {
+  const config = await loadConfig()
+  if (!config.awsProfile) return { authenticated: false, error: 'No AWS profile configured' }
+
+  const result = await exec('aws-vault', [
+    'exec',
+    config.awsProfile,
+    '--',
+    'aws',
+    'sts',
+    'get-caller-identity',
+    '--output',
+    'json',
+  ])
+  if (result.exitCode !== 0) {
+    return { authenticated: false, error: result.stderr || 'Session expired' }
+  }
+  try {
+    const identity = JSON.parse(result.stdout)
+    return {
+      authenticated: true,
+      account: identity.Account,
+      role: identity.Arn?.split('/').at(-1),
+    }
+  } catch {
+    return { authenticated: false, error: 'Could not parse AWS identity' }
+  }
+}
+
+/**
+ * Log in to AWS via aws-vault.
+ * @param {string} profile - aws-vault profile name
+ * @returns {Promise<AuthStatus>}
+ */
+export async function loginAWS(profile) {
+  const result = await exec('aws-vault', ['login', profile])
+  if (result.exitCode !== 0) {
+    return { authenticated: false, error: result.stderr }
+  }
+  return checkAWSAuth()
+}

package/src/services/aws-costs.js

@@ -0,0 +1,80 @@
+import { CostExplorerClient, GetCostAndUsageCommand } from '@aws-sdk/client-cost-explorer'
+
+/** @import { AWSCostEntry } from '../types.js' */
+
+/**
+ * Get the date range for a cost period.
+ * @param {'last-month'|'last-week'|'mtd'} period
+ * @returns {{ start: string, end: string }}
+ */
+function getPeriodDates(period) {
+  const now = new Date()
+  const fmt = (d) => d.toISOString().split('T')[0]
+
+  if (period === 'last-month') {
+    const start = new Date(now.getFullYear(), now.getMonth() - 1, 1)
+    const end = new Date(now.getFullYear(), now.getMonth(), 1)
+    return { start: fmt(start), end: fmt(end) }
+  }
+  if (period === 'last-week') {
+    const end = new Date(now)
+    end.setDate(now.getDate() - now.getDay())
+    const start = new Date(end)
+    start.setDate(end.getDate() - 7)
+    return { start: fmt(start), end: fmt(end) }
+  }
+  // mtd
+  const start = new Date(now.getFullYear(), now.getMonth(), 1)
+  return { start: fmt(start), end: fmt(now) }
+}
+
+/**
+ * Query AWS Cost Explorer for costs filtered by project tags.
+ * @param {string} serviceName - Tag value for filtering
+ * @param {Record<string, string>} tags - Project tags (key-value pairs)
+ * @param {'last-month'|'last-week'|'mtd'} [period]
+ * @returns {Promise<{ entries: AWSCostEntry[], period: { start: string, end: string } }>}
+ */
+export async function getServiceCosts(serviceName, tags, period = 'last-month') {
+  // Cost Explorer always uses us-east-1
+  const client = new CostExplorerClient({ region: 'us-east-1' })
+  const { start, end } = getPeriodDates(period)
+
+  // Build tag filter from project tags
+  const tagEntries = Object.entries(tags)
+  const filter =
+    tagEntries.length === 1
+      ? { Tags: { Key: tagEntries[0][0], Values: [tagEntries[0][1]] } }
+      : {
+          And: tagEntries.map(([k, v]) => ({
+            Tags: { Key: k, Values: [v] },
+          })),
+        }
+
+  const command = new GetCostAndUsageCommand({
+    TimePeriod: { Start: start, End: end },
+    Granularity: 'MONTHLY',
+    Metrics: ['UnblendedCost'],
+    Filter: filter,
+    GroupBy: [{ Type: 'DIMENSION', Key: 'SERVICE' }],
+  })
+
+  const result = await client.send(command)
+  const entries = []
+
+  for (const timeResult of result.ResultsByTime ?? []) {
+    for (const group of timeResult.Groups ?? []) {
+      const amount = Number(group.Metrics?.UnblendedCost?.Amount ?? 0)
+      if (amount > 0) {
+        entries.push({
+          serviceName: group.Keys?.[0] ?? 'Unknown',
+          amount,
+          unit: group.Metrics?.UnblendedCost?.Unit ?? 'USD',
+          period: { start, end },
+        })
+      }
+    }
+  }
+
+  return { entries, period: { start, end } }
+}