devvami 1.2.0 → 1.4.0

package/src/help.js

@@ -58,14 +58,17 @@ const CATEGORIES = [
   {
     title: 'Tasks (ClickUp)',
     cmds: [
-      { id: 'tasks:list',  hint: '[--status] [--search]' },
-      { id: 'tasks:today', hint: '' },
+      { id: 'tasks:list',     hint: '[--status] [--search]' },
+      { id: 'tasks:today',    hint: '' },
+      { id: 'tasks:assigned', hint: '[--status] [--search]' },
     ],
   },
   {
     title: 'Cloud & Costi',
     cmds: [
-      { id: 'costs:get', hint: '[--period] [--profile]' },
+      { id: 'costs:get',   hint: '[SERVICE] [--period] [--group-by] [--tag-key]' },
+      { id: 'costs:trend', hint: '[--group-by] [--tag-key] [--line]' },
+      { id: 'logs',        hint: '[--group] [--filter] [--since] [--limit] [--region]' },
     ],
   },
   {
@@ -84,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: [
@@ -91,30 +103,12 @@ const CATEGORIES = [
       { id: 'doctor',     hint: '' },
       { id: 'auth:login', hint: '' },
       { id: 'whoami',     hint: '' },
+      { id: 'welcome',    hint: '' },
       { id: 'upgrade',    hint: '' },
     ],
   },
 ]
 
-// ─── Example commands shown at bottom of root help ──────────────────────────
-const EXAMPLES = [
-   { cmd: 'dvmi prompts list',                                    note: 'Sfoglia prompt AI dal tuo repository' },
-   { cmd: 'dvmi prompts list --filter refactor',                  note: 'Filtra prompt per parola chiave' },
-   { cmd: 'dvmi prompts download coding/refactor-prompt.md',      note: 'Scarica un prompt localmente' },
-   { cmd: 'dvmi prompts browse skills --query refactor',          note: 'Cerca skill su skills.sh' },
-   { cmd: 'dvmi prompts browse awesome --category agents',        note: 'Sfoglia awesome-copilot agents' },
-   { cmd: 'dvmi prompts run coding/refactor-prompt.md --tool opencode', note: 'Esegui un prompt con opencode' },
-   { cmd: 'dvmi docs read',                                       note: 'Leggi il README del repo corrente' },
-   { 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' },
-   { 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' },
- ]
-
 // ─── Help class ─────────────────────────────────────────────────────────────
 
 /**
@@ -134,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))
    }
 
   /**
@@ -164,14 +171,46 @@ export default class CustomHelp extends Help {
 
   // ─── Private helpers ──────────────────────────────────────────────────────
 
-  /**
-   * Build the full categorized root help layout.
-   * @returns {string}
-   */
-  #buildRootLayout() {
+   /**
+    * Build the full categorized root help layout.
+    * @param {{ hasUpdate: boolean, current: string, latest: string|null }|null} [versionInfo]
+    * @returns {string}
+    */
+  #buildRootLayout(versionInfo = null) {
     /** @type {Map<string, import('@oclif/core').Command.Cached>} */
     const cmdMap = new Map(this.config.commands.map((c) => [c.id, c]))
 
+    /** @type {Array<{cmd: string, note: string}>} */
+    const EXAMPLES = [
+      { cmd: 'dvmi prompts list',                                     note: 'Sfoglia prompt AI dal tuo repository' },
+      { cmd: 'dvmi prompts list --filter refactor',                   note: 'Filtra prompt per parola chiave' },
+      { cmd: 'dvmi prompts download coding/refactor-prompt.md',       note: 'Scarica un prompt localmente' },
+      { cmd: 'dvmi prompts browse skills --query refactor',           note: 'Cerca skill su skills.sh' },
+      { cmd: 'dvmi prompts browse awesome --category agents',         note: 'Sfoglia awesome-copilot agents' },
+      { cmd: 'dvmi prompts run coding/refactor-prompt.md --tool opencode', note: 'Esegui un prompt con opencode' },
+      { cmd: 'dvmi docs read',                                        note: 'Leggi il README del repo corrente' },
+      { 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 tasks today',                                      note: 'Task in lavorazione oggi' },
+      { cmd: 'dvmi costs get --period mtd',                           note: 'Costi AWS mese corrente per servizio' },
+      { cmd: 'dvmi costs get --group-by tag --tag-key env',           note: 'Costi raggruppati per tag env' },
+      { cmd: 'dvmi costs trend --line',                               note: 'Trend costi 2 mesi (grafico lineare)' },
+      { cmd: 'dvmi costs get --json',                                 note: 'Costi AWS in formato JSON' },
+      { cmd: 'dvmi logs',                                             note: 'Sfoglia log CloudWatch in modo interattivo' },
+      { cmd: 'dvmi logs --group /aws/lambda/my-fn --since 24h',       note: 'Log Lambda ultimi 24h' },
+      { 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' },
+    ]
+
     const lines = []
 
      // ── Usage ──────────────────────────────────────────────────────────────
@@ -236,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') +

package/src/services/aws-costs.js

@@ -1,6 +1,6 @@
 import { CostExplorerClient, GetCostAndUsageCommand } from '@aws-sdk/client-cost-explorer'
 
-/** @import { AWSCostEntry } from '../types.js' */
+/** @import { AWSCostEntry, CostGroupMode, CostTrendSeries } from '../types.js' */
 
 /**
  * Get the date range for a cost period.
@@ -28,14 +28,62 @@ function getPeriodDates(period) {
   return { start: fmt(start), end: fmt(now) }
 }
 
+/**
+ * Get the rolling 2-month date range for trend queries.
+ * @returns {{ start: string, end: string }}
+ */
+export function getTwoMonthPeriod() {
+  const now = new Date()
+  const fmt = (d) => d.toISOString().split('T')[0]
+  const start = new Date(now.getFullYear(), now.getMonth() - 2, 1)
+  return { start: fmt(start), end: fmt(now) }
+}
+
+/**
+ * Strip the "tagkey$" prefix from an AWS tag group key response.
+ * AWS returns tag values as "<tagKey>$<value>" — strip the prefix.
+ * An empty stripped value is displayed as "(untagged)".
+ * @param {string} rawKey - Raw key from AWS response (e.g. "env$prod" or "env$")
+ * @returns {string}
+ */
+function stripTagPrefix(rawKey) {
+  const dollarIdx = rawKey.indexOf('$')
+  if (dollarIdx === -1) return rawKey
+  const stripped = rawKey.slice(dollarIdx + 1)
+  return stripped === '' ? '(untagged)' : stripped
+}
+
+/**
+ * Build the GroupBy array for Cost Explorer based on the grouping mode.
+ * AWS limits GroupBy to max 2 entries.
+ * @param {CostGroupMode} groupBy
+ * @param {string} [tagKey]
+ * @returns {Array<{Type: string, Key: string}>}
+ */
+function buildGroupBy(groupBy, tagKey) {
+  if (groupBy === 'service') {
+    return [{ Type: 'DIMENSION', Key: 'SERVICE' }]
+  }
+  if (groupBy === 'tag') {
+    return [{ Type: 'TAG', Key: tagKey ?? '' }]
+  }
+  // both
+  return [
+    { Type: 'DIMENSION', Key: 'SERVICE' },
+    { Type: 'TAG', Key: tagKey ?? '' },
+  ]
+}
+
 /**
  * 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]
+ * @param {CostGroupMode} [groupBy]
+ * @param {string} [tagKey]
  * @returns {Promise<{ entries: AWSCostEntry[], period: { start: string, end: string } }>}
  */
-export async function getServiceCosts(serviceName, tags, period = 'last-month') {
+export async function getServiceCosts(serviceName, tags, period = 'last-month', groupBy = 'service', tagKey) {
   // Cost Explorer always uses us-east-1
   const client = new CostExplorerClient({ region: 'us-east-1' })
   const { start, end } = getPeriodDates(period)
@@ -56,7 +104,7 @@ export async function getServiceCosts(serviceName, tags, period = 'last-month')
     Granularity: 'MONTHLY',
     Metrics: ['UnblendedCost'],
     Filter: filter,
-    GroupBy: [{ Type: 'DIMENSION', Key: 'SERVICE' }],
+    GroupBy: buildGroupBy(groupBy, tagKey),
   })
 
   const result = await client.send(command)
@@ -66,15 +114,91 @@ export async function getServiceCosts(serviceName, tags, period = 'last-month')
     for (const group of timeResult.Groups ?? []) {
       const amount = Number(group.Metrics?.UnblendedCost?.Amount ?? 0)
       if (amount > 0) {
-        entries.push({
-          serviceName: group.Keys?.[0] ?? 'Unknown',
+        const keys = group.Keys ?? []
+        /** @type {AWSCostEntry} */
+        const entry = {
+          serviceName: groupBy === 'tag' ? stripTagPrefix(keys[0] ?? '') : (keys[0] ?? 'Unknown'),
           amount,
           unit: group.Metrics?.UnblendedCost?.Unit ?? 'USD',
           period: { start, end },
-        })
+        }
+        if (groupBy === 'both') {
+          entry.tagValue = stripTagPrefix(keys[1] ?? '')
+        } else if (groupBy === 'tag') {
+          entry.tagValue = entry.serviceName
+        }
+        entries.push(entry)
       }
     }
   }
 
   return { entries, period: { start, end } }
 }
+
+/**
+ * Query AWS Cost Explorer for daily costs over the last 2 months, grouped by the given mode.
+ * Handles NextPageToken pagination internally.
+ * @param {CostGroupMode} groupBy
+ * @param {string} [tagKey]
+ * @returns {Promise<CostTrendSeries[]>}
+ */
+export async function getTrendCosts(groupBy = 'service', tagKey) {
+  const client = new CostExplorerClient({ region: 'us-east-1' })
+  const { start, end } = getTwoMonthPeriod()
+
+  /** @type {Map<string, Map<string, number>>} seriesName → date → amount */
+  const seriesMap = new Map()
+
+  let nextPageToken = undefined
+  do {
+    const command = new GetCostAndUsageCommand({
+      TimePeriod: { Start: start, End: end },
+      Granularity: 'DAILY',
+      Metrics: ['UnblendedCost'],
+      GroupBy: buildGroupBy(groupBy, tagKey),
+      ...(nextPageToken ? { NextPageToken: nextPageToken } : {}),
+    })
+
+    const result = await client.send(command)
+    nextPageToken = result.NextPageToken
+
+    for (const timeResult of result.ResultsByTime ?? []) {
+      const date = timeResult.TimePeriod?.Start ?? ''
+      for (const group of timeResult.Groups ?? []) {
+        const amount = Number(group.Metrics?.UnblendedCost?.Amount ?? 0)
+        const keys = group.Keys ?? []
+
+        let seriesName
+        if (groupBy === 'service') {
+          seriesName = keys[0] ?? 'Unknown'
+        } else if (groupBy === 'tag') {
+          seriesName = stripTagPrefix(keys[0] ?? '')
+        } else {
+          // both: "ServiceName / tagValue"
+          const svc = keys[0] ?? 'Unknown'
+          const tag = stripTagPrefix(keys[1] ?? '')
+          seriesName = `${svc} / ${tag}`
+        }
+
+        if (!seriesMap.has(seriesName)) {
+          seriesMap.set(seriesName, new Map())
+        }
+        const dateMap = seriesMap.get(seriesName)
+        dateMap.set(date, (dateMap.get(date) ?? 0) + amount)
+      }
+    }
+  } while (nextPageToken)
+
+  /** @type {CostTrendSeries[]} */
+  const series = []
+  for (const [name, dateMap] of seriesMap) {
+    const points = Array.from(dateMap.entries())
+      .sort(([a], [b]) => a.localeCompare(b))
+      .map(([date, amount]) => ({ date, amount }))
+    if (points.some((p) => p.amount > 0)) {
+      series.push({ name, points })
+    }
+  }
+
+  return series
+}

package/src/services/cloudwatch-logs.js

@@ -0,0 +1,92 @@
+import {
+  CloudWatchLogsClient,
+  paginateDescribeLogGroups,
+  FilterLogEventsCommand,
+} from '@aws-sdk/client-cloudwatch-logs'
+
+/** @import { LogGroup, LogEvent, LogFilterResult } from '../types.js' */
+
+/**
+ * Convert a human-readable "since" string to epoch millisecond timestamps.
+ * @param {'1h'|'24h'|'7d'} since
+ * @returns {{ startTime: number, endTime: number }}
+ */
+export function sinceToEpochMs(since) {
+  const now = Date.now()
+  const MS = {
+    '1h': 60 * 60 * 1000,
+    '24h': 24 * 60 * 60 * 1000,
+    '7d': 7 * 24 * 60 * 60 * 1000,
+  }
+  const offset = MS[since]
+  if (!offset) throw new Error(`Invalid since value: ${since}. Must be one of: 1h, 24h, 7d`)
+  return { startTime: now - offset, endTime: now }
+}
+
+/**
+ * List all CloudWatch log groups in the given region using pagination.
+ * @param {string} [region] - AWS region (defaults to 'eu-west-1')
+ * @returns {Promise<LogGroup[]>}
+ */
+export async function listLogGroups(region = 'eu-west-1') {
+  const client = new CloudWatchLogsClient({ region })
+  /** @type {LogGroup[]} */
+  const groups = []
+
+  const paginator = paginateDescribeLogGroups({ client }, {})
+  for await (const page of paginator) {
+    for (const lg of page.logGroups ?? []) {
+      groups.push({
+        name: lg.logGroupName ?? '',
+        storedBytes: lg.storedBytes,
+        retentionDays: lg.retentionInDays,
+        creationTime: lg.creationTime ? new Date(lg.creationTime).toISOString() : undefined,
+      })
+    }
+  }
+
+  return groups
+}
+
+/**
+ * Filter log events from a CloudWatch log group.
+ * @param {string} logGroupName
+ * @param {string} filterPattern - CloudWatch filter pattern ('' = all events)
+ * @param {number} startTime - Epoch milliseconds
+ * @param {number} endTime - Epoch milliseconds
+ * @param {number} limit - Max events to return (1–10000)
+ * @param {string} [region] - AWS region (defaults to 'eu-west-1')
+ * @returns {Promise<LogFilterResult>}
+ */
+export async function filterLogEvents(logGroupName, filterPattern, startTime, endTime, limit, region = 'eu-west-1') {
+  const client = new CloudWatchLogsClient({ region })
+
+  const command = new FilterLogEventsCommand({
+    logGroupName,
+    filterPattern: filterPattern || undefined,
+    startTime,
+    endTime,
+    limit,
+  })
+
+  const result = await client.send(command)
+
+  /** @type {LogEvent[]} */
+  const events = (result.events ?? []).map((e) => ({
+    eventId: e.eventId ?? '',
+    logStreamName: e.logStreamName ?? '',
+    timestamp: e.timestamp ?? 0,
+    message: e.message ?? '',
+  }))
+
+  const truncated = events.length >= limit || Boolean(result.nextToken)
+
+  return {
+    events,
+    truncated,
+    logGroupName,
+    startTime,
+    endTime,
+    filterPattern: filterPattern ?? '',
+  }
+}

package/src/services/config.js

@@ -1,5 +1,5 @@
 import { readFile, writeFile, mkdir, chmod } from 'node:fs/promises'
-import { existsSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 
@@ -58,3 +58,19 @@ export async function saveConfig(config, configPath = CONFIG_PATH) {
 export function configExists(configPath = CONFIG_PATH) {
   return existsSync(configPath)
 }
+
+/**
+ * Load CLI config synchronously. Intended for use in static getters where async is unavailable.
+ * Returns defaults if file doesn't exist or cannot be parsed.
+ * @param {string} [configPath] - Override config path (used in tests)
+ * @returns {CLIConfig}
+ */
+export function loadConfigSync(configPath = process.env.DVMI_CONFIG_PATH ?? CONFIG_PATH) {
+  if (!existsSync(configPath)) return { ...DEFAULTS }
+  try {
+    const raw = readFileSync(configPath, 'utf8')
+    return { ...DEFAULTS, ...JSON.parse(raw) }
+  } catch {
+    return { ...DEFAULTS }
+  }
+}