devvami 1.0.0

package/src/commands/pr/review.js

@@ -0,0 +1,51 @@
+import { Command } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import { listMyPRs } from '../../services/github.js'
+import { loadConfig } from '../../services/config.js'
+import { renderTable, colorStatus } from '../../formatters/table.js'
+
+export default class PRReview extends Command {
+  static description = 'Lista PR assegnate a te per la code review'
+
+  static examples = [
+    '<%= config.bin %> pr review',
+    '<%= config.bin %> pr review --json',
+  ]
+
+  static enableJsonFlag = true
+
+  async run() {
+    const { flags } = await this.parse(PRReview)
+    const isJson = flags.json
+    const config = await loadConfig()
+
+    if (!config.org) {
+      this.error("GitHub org non configurata. Esegui `dvmi init` per configurare l'ambiente.")
+    }
+
+    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Caricamento PR in review...') }).start()
+    const { reviewing } = await listMyPRs(config.org)
+    spinner?.stop()
+
+    if (isJson) return { reviewing }
+
+    if (reviewing.length === 0) {
+      this.log(chalk.dim('Nessuna PR assegnata per review.'))
+      return { reviewing }
+    }
+
+    this.log(chalk.bold(`\nPR ASSEGNATE PER REVIEW (${reviewing.length}):`))
+    this.log(
+      renderTable(reviewing, [
+        { header: '#', key: 'number', width: 6 },
+        { header: 'Titolo', key: 'title', width: 45 },
+        { header: 'Autore', key: 'author', width: 20 },
+        { header: 'Branch', key: 'headBranch', width: 30 },
+        { header: 'CI', key: 'ciStatus', width: 10, format: (v) => colorStatus(String(v)) },
+      ]),
+    )
+
+    return { reviewing }
+  }
+}

package/src/commands/pr/status.js

@@ -0,0 +1,70 @@
+import { Command, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import { listMyPRs } from '../../services/github.js'
+import { loadConfig } from '../../services/config.js'
+import { renderTable, colorStatus } from '../../formatters/table.js'
+
+export default class PRStatus extends Command {
+  static description = 'Stato delle tue PR aperte (come autore e come reviewer)'
+
+  static examples = [
+    '<%= config.bin %> pr status',
+    '<%= config.bin %> pr status --author',
+    '<%= config.bin %> pr status --json',
+  ]
+
+  static enableJsonFlag = true
+
+  static flags = {
+    author: Flags.boolean({ description: 'Solo PR dove sei autore', default: false }),
+    reviewer: Flags.boolean({ description: 'Solo PR dove sei reviewer', default: false }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(PRStatus)
+    const isJson = flags.json
+    const config = await loadConfig()
+
+    if (!config.org) {
+      this.error('GitHub org not configured. Run `dvmi init` to set up your environment.')
+    }
+
+    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching PRs...') }).start()
+    const { authored, reviewing } = await listMyPRs(config.org)
+    spinner?.stop()
+
+    const showAuthored = !flags.reviewer || flags.author
+    const showReviewing = !flags.author || flags.reviewer
+
+    if (isJson) {
+      return {
+        authored: showAuthored ? authored : [],
+        reviewing: showReviewing ? reviewing : [],
+      }
+    }
+
+    if (showAuthored && authored.length > 0) {
+      this.log(chalk.bold('\nYOUR PRS:'))
+      this.log(renderTable(authored, [
+        { header: 'Repo', key: 'headBranch', width: 30, format: (v) => String(v).split('/')[0] },
+        { header: 'Title', key: 'title', width: 40 },
+        { header: 'CI', key: 'ciStatus', width: 10, format: (v) => colorStatus(String(v)) },
+        { header: 'Review', key: 'reviewStatus', width: 20, format: (v) => colorStatus(String(v)) },
+      ]))
+    } else if (showAuthored) {
+      this.log(chalk.dim('No authored PRs found.'))
+    }
+
+    if (showReviewing && reviewing.length > 0) {
+      this.log(chalk.bold('\nREVIEW REQUESTED:'))
+      this.log(renderTable(reviewing, [
+        { header: 'Title', key: 'title', width: 40 },
+        { header: 'Author', key: 'author', width: 20 },
+        { header: 'CI', key: 'ciStatus', width: 10, format: (v) => colorStatus(String(v)) },
+      ]))
+    }
+
+    return { authored, reviewing }
+  }
+}

package/src/commands/repo/list.js

@@ -0,0 +1,113 @@
+import { Command, Flags } from '@oclif/core'
+import ora from 'ora'
+import chalk from 'chalk'
+import { listRepos } from '../../services/github.js'
+import { loadConfig } from '../../services/config.js'
+import { renderTable } from '../../formatters/table.js'
+
+/**
+ * @param {string} lang
+ * @returns {string}
+ */
+function langColor(lang) {
+  const map = {
+    javascript: chalk.yellow,
+    typescript: chalk.blue,
+    python:     chalk.green,
+    java:       chalk.red,
+    go:         chalk.cyan,
+    ruby:       chalk.magenta,
+    rust:       chalk.hex('#CE422B'),
+    kotlin:     chalk.hex('#7F52FF'),
+    swift:      chalk.hex('#F05138'),
+    php:        chalk.hex('#777BB4'),
+    shell:      chalk.greenBright,
+  }
+  const fn = map[lang.toLowerCase()]
+  return fn ? fn(lang) : chalk.dim(lang)
+}
+
+export default class RepoList extends Command {
+  static description = 'Lista repository dell\'organizzazione'
+
+  static examples = [
+    '<%= config.bin %> repo list',
+    '<%= config.bin %> repo list --language typescript',
+    '<%= config.bin %> repo list --search "lambda"',
+    '<%= config.bin %> repo list --topic microservice --search "api"',
+    '<%= config.bin %> repo list --json',
+  ]
+
+  static enableJsonFlag = true
+
+  static flags = {
+    language: Flags.string({ description: 'Filtra per linguaggio' }),
+    topic:    Flags.string({ description: 'Filtra per topic' }),
+    search:   Flags.string({ char: 's', description: 'Cerca in nome e descrizione (case-insensitive)' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(RepoList)
+    const isJson = flags.json
+    const config = await loadConfig()
+
+    if (!config.org) {
+      this.error('GitHub org not configured. Run `dvmi init` to set up your environment.')
+    }
+
+    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching repositories...') }).start()
+    const repos = await listRepos(config.org, {
+      language: flags.language,
+      topic: flags.topic,
+    })
+    spinner?.stop()
+
+    // Search filter (name + description)
+    const searchQuery = flags.search?.toLowerCase()
+    const filtered = searchQuery
+      ? repos.filter((r) =>
+          r.name.toLowerCase().includes(searchQuery) ||
+          r.description.toLowerCase().includes(searchQuery),
+        )
+      : repos
+
+    if (isJson) return { repositories: filtered, total: filtered.length }
+
+    if (repos.length === 0) {
+      this.log(chalk.yellow('No repositories found matching your filters.'))
+      return { repositories: [], total: 0 }
+    }
+
+    if (filtered.length === 0) {
+      this.log(chalk.dim(`No repositories matching "${flags.search}".`))
+      return { repositories: [], total: 0 }
+    }
+
+    // Build filter info line
+    const filterInfo = [
+      flags.language && chalk.dim(`language: ${chalk.white(flags.language)}`),
+      flags.topic    && chalk.dim(`topic: ${chalk.white(flags.topic)}`),
+      flags.search   && chalk.dim(`search: ${chalk.white(`"${flags.search}"`)}`),
+    ].filter(Boolean).join(chalk.dim('  ·  '))
+
+    this.log(
+      chalk.bold(`\nRepositories in ${config.org}`) +
+      (filterInfo ? chalk.dim('  —  ') + filterInfo : '') +
+      chalk.dim(`  (${filtered.length}${filtered.length < repos.length ? `/${repos.length}` : ''})`) +
+      '\n',
+    )
+
+    this.log(renderTable(filtered, [
+      { header: 'Name',        key: 'name',        width: 40 },
+      { header: 'Language',    key: 'language',     width: 14, format: (v) => v || '—', colorize: (v) => v === '—' ? chalk.dim(v) : langColor(v) },
+      { header: 'Last push',   key: 'pushedAt',     width: 12, format: (v) => {
+        const d = new Date(String(v))
+        return isNaN(d.getTime()) ? '—' : d.toLocaleDateString()
+      }},
+      { header: 'Description', key: 'description',  width: 60, format: (v) => String(v || '—') },
+    ]))
+
+    this.log('')
+    return { repositories: filtered, total: filtered.length }
+  }
+}

package/src/commands/search.js

@@ -0,0 +1,62 @@
+import { Command, Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import { searchCode } from '../services/github.js'
+import { loadConfig } from '../services/config.js'
+import { renderTable } from '../formatters/table.js'
+
+export default class Search extends Command {
+  static description = 'Cerca codice nei repository dell\'organizzazione'
+
+  static examples = [
+    '<%= config.bin %> search "getUserById"',
+    '<%= config.bin %> search "TODO" --language typescript',
+    '<%= config.bin %> search "config" --repo my-service --json',
+  ]
+
+  static enableJsonFlag = true
+
+  static args = {
+    term: Args.string({ description: 'Termine di ricerca', required: true }),
+  }
+
+  static flags = {
+    language: Flags.string({ description: 'Filtra per linguaggio' }),
+    repo: Flags.string({ description: 'Cerca in un repo specifico' }),
+    limit: Flags.integer({ description: 'Max risultati', default: 20 }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(Search)
+    const isJson = flags.json
+    const config = await loadConfig()
+
+    if (!config.org) {
+      this.error('GitHub org not configured. Run `dvmi init` to set up your environment.')
+    }
+
+    const spinner = isJson ? null : ora(`Searching for "${args.term}"...`).start()
+    const results = await searchCode(config.org, args.term, {
+      language: flags.language,
+      repo: flags.repo,
+      limit: flags.limit,
+    })
+    spinner?.stop()
+
+    if (isJson) return { results, total: results.length }
+
+    if (results.length === 0) {
+      this.log(chalk.yellow(`No results found for "${args.term}" in the organization.`))
+      return { results: [], total: 0 }
+    }
+
+    this.log(chalk.bold(`\n${results.length} result(s) for "${args.term}":\n`))
+    this.log(renderTable(results, [
+      { header: 'Repo', key: 'repo', width: 25 },
+      { header: 'File', key: 'file', width: 45 },
+      { header: 'Match', key: 'match' },
+    ]))
+
+    return { results, total: results.length }
+  }
+}

package/src/commands/tasks/assigned.js

@@ -0,0 +1,131 @@
+import { Command, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import { getTasks, getTasksByList, isAuthenticated } from '../../services/clickup.js'
+import { loadConfig } from '../../services/config.js'
+import { renderTable } from '../../formatters/table.js'
+
+export default class TasksAssigned extends Command {
+  static description = 'Task ClickUp assegnati a te (alias di tasks list)'
+
+  static examples = [
+    '<%= config.bin %> tasks assigned',
+    '<%= config.bin %> tasks assigned --status in_progress',
+    '<%= config.bin %> tasks assigned --search "bug fix"',
+    '<%= config.bin %> tasks assigned --list-id 12345',
+    '<%= config.bin %> tasks assigned --json',
+  ]
+
+  static enableJsonFlag = true
+
+  static flags = {
+    status: Flags.string({ description: 'Filtra per status (open, in_progress, done)' }),
+    search: Flags.string({
+      char: 's',
+      description: 'Cerca nel titolo del task (case-insensitive)',
+    }),
+    'list-id': Flags.string({
+      description: "ID della lista ClickUp (visibile nell'URL della lista)",
+    }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(TasksAssigned)
+    const isJson = flags.json
+    const config = await loadConfig()
+
+    // Check auth
+    if (!(await isAuthenticated())) {
+      this.error('ClickUp not authenticated. Run `dvmi init` to configure ClickUp.')
+    }
+
+    // Ensure team ID is configured
+    const teamId = config.clickup?.teamId
+    if (!teamId && !flags['list-id']) {
+      this.error('ClickUp team ID not configured. Run `dvmi init` to configure ClickUp.')
+    }
+
+    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching tasks...') }).start()
+
+    /** @param {number} count */
+    const onProgress = (count) => {
+      if (spinner) spinner.text = chalk.hex('#FF6B2B')(`Fetching tasks... (${count})`)
+    }
+
+    let tasks
+    if (flags['list-id']) {
+      tasks = await getTasksByList(flags['list-id'], { status: flags.status }, onProgress).catch((err) => {
+        spinner?.stop()
+        this.error(err.message)
+      })
+    } else {
+      tasks = await getTasks(/** @type {string} */ (teamId), { status: flags.status }, onProgress)
+    }
+    spinner?.stop()
+
+    // Apply search filter
+    const searchQuery = flags.search?.toLowerCase()
+    const filtered = searchQuery
+      ? tasks.filter((t) => t.name.toLowerCase().includes(searchQuery))
+      : tasks
+
+    if (isJson) return { tasks: filtered }
+
+    if (tasks.length === 0) {
+      this.log(chalk.dim('No tasks assigned to you.'))
+      return { tasks: [] }
+    }
+
+    if (filtered.length === 0) {
+      this.log(chalk.dim('No tasks matching filters.'))
+      return { tasks: [] }
+    }
+
+    // Priority label + color
+    const priorityLabel = (p) => ['', 'URGENT', 'HIGH', 'NORMAL', 'LOW'][p] ?? String(p)
+    const priorityColor = (label) => {
+      if (label === 'URGENT') return chalk.red.bold(label)
+      if (label === 'HIGH')   return chalk.yellow(label)
+      if (label === 'NORMAL') return chalk.white(label)
+      if (label === 'LOW')    return chalk.dim(label)
+      return label
+    }
+
+    // Status color
+    const statusColor = (status) => {
+      const s = status.toLowerCase()
+      if (s.includes('done') || s.includes('complet') || s.includes('closed')) return chalk.green(status)
+      if (s.includes('progress') || s.includes('active') || s.includes('open')) return chalk.cyan(status)
+      if (s.includes('block') || s.includes('review') || s.includes('wait'))  return chalk.yellow(status)
+      return chalk.dim(status)
+    }
+
+    // Summary header
+    const filterInfo = [
+      flags.status && chalk.dim(`status: ${chalk.white(flags.status)}`),
+      flags.search && chalk.dim(`search: ${chalk.white(`"${flags.search}"`)}`),
+      flags['list-id'] && chalk.dim(`list-id: ${chalk.white(flags['list-id'])}`),
+    ].filter(Boolean).join(chalk.dim('  ·  '))
+
+    this.log(
+      chalk.bold('\nYour assigned tasks') +
+      (filterInfo ? chalk.dim('  —  ') + filterInfo : '') +
+      chalk.dim(`  (${filtered.length}${filtered.length < tasks.length ? `/${tasks.length}` : ''})`) +
+      '\n',
+    )
+
+    this.log(renderTable(filtered, [
+      { header: 'ID',          key: 'id',         width: 10 },
+      { header: 'Link',        key: 'url',         width: 42, format: (v) => v ?? '—' },
+      { header: 'Priority',    key: 'priority',    width: 8,  format: (v) => priorityLabel(Number(v)), colorize: priorityColor },
+      { header: 'Status',      key: 'status',      width: 15, colorize: statusColor },
+      { header: 'Due',         key: 'dueDate',     width: 12, format: (v) => v ?? '—' },
+      { header: 'Lista',       key: 'listName',    width: 20, format: (v) => v ?? '—' },
+      { header: 'Cartella',    key: 'folderName',  width: 20, format: (v) => v ?? '—' },
+      { header: 'Description', key: 'name',        width: 55 },
+    ]))
+
+    this.log('')
+    return { tasks: filtered }
+  }
+}

package/src/commands/tasks/list.js

@@ -0,0 +1,133 @@
+import { Command, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import { getTasks, getTasksByList, isAuthenticated } from '../../services/clickup.js'
+import { loadConfig } from '../../services/config.js'
+import { renderTable } from '../../formatters/table.js'
+
+export default class TasksList extends Command {
+  static description = 'Task ClickUp assegnati a te'
+
+  static examples = [
+    '<%= config.bin %> tasks list',
+    '<%= config.bin %> tasks list --status in_progress',
+    '<%= config.bin %> tasks list --search "bug fix"',
+    '<%= config.bin %> tasks list --status open --search "login"',
+    '<%= config.bin %> tasks list --list-id 12345',
+    '<%= config.bin %> tasks list --list-id 12345 --status "in progress"',
+    '<%= config.bin %> tasks list --json',
+  ]
+
+  static enableJsonFlag = true
+
+  static flags = {
+    status: Flags.string({ description: 'Filtra per status (open, in_progress, done)' }),
+    search: Flags.string({
+      char: 's',
+      description: 'Cerca nel titolo del task (case-insensitive)',
+    }),
+    'list-id': Flags.string({
+      description: "ID della lista ClickUp (visibile nell'URL della lista)",
+    }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(TasksList)
+    const isJson = flags.json
+    const config = await loadConfig()
+
+    // Check auth
+    if (!(await isAuthenticated())) {
+      this.error('ClickUp not authenticated. Run `dvmi init` to configure ClickUp.')
+    }
+
+    // Ensure team ID is configured
+    const teamId = config.clickup?.teamId
+    if (!teamId && !flags['list-id']) {
+      this.error('ClickUp team ID not configured. Run `dvmi init` to configure ClickUp.')
+    }
+
+    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching tasks...') }).start()
+
+    /** @param {number} count */
+    const onProgress = (count) => {
+      if (spinner) spinner.text = chalk.hex('#FF6B2B')(`Fetching tasks... (${count})`)
+    }
+
+    let tasks
+    if (flags['list-id']) {
+      tasks = await getTasksByList(flags['list-id'], { status: flags.status }, onProgress).catch((err) => {
+        spinner?.stop()
+        this.error(err.message)
+      })
+    } else {
+      tasks = await getTasks(/** @type {string} */ (teamId), { status: flags.status }, onProgress)
+    }
+    spinner?.stop()
+
+    // Apply search filter
+    const searchQuery = flags.search?.toLowerCase()
+    const filtered = searchQuery
+      ? tasks.filter((t) => t.name.toLowerCase().includes(searchQuery))
+      : tasks
+
+    if (isJson) return { tasks: filtered }
+
+    if (tasks.length === 0) {
+      this.log(chalk.dim('No tasks assigned to you.'))
+      return { tasks: [] }
+    }
+
+    if (filtered.length === 0) {
+      this.log(chalk.dim(`No tasks matching filters.`))
+      return { tasks: [] }
+    }
+
+    // Priority label + color
+    const priorityLabel = (p) => ['', 'URGENT', 'HIGH', 'NORMAL', 'LOW'][p] ?? String(p)
+    const priorityColor = (label) => {
+      if (label === 'URGENT') return chalk.red.bold(label)
+      if (label === 'HIGH')   return chalk.yellow(label)
+      if (label === 'NORMAL') return chalk.white(label)
+      if (label === 'LOW')    return chalk.dim(label)
+      return label
+    }
+
+    // Status color
+    const statusColor = (status) => {
+      const s = status.toLowerCase()
+      if (s.includes('done') || s.includes('complet') || s.includes('closed')) return chalk.green(status)
+      if (s.includes('progress') || s.includes('active') || s.includes('open')) return chalk.cyan(status)
+      if (s.includes('block') || s.includes('review') || s.includes('wait'))  return chalk.yellow(status)
+      return chalk.dim(status)
+    }
+
+    // Summary header
+    const filterInfo = [
+      flags.status && chalk.dim(`status: ${chalk.white(flags.status)}`),
+      flags.search && chalk.dim(`search: ${chalk.white(`"${flags.search}"`)}`),
+      flags['list-id'] && chalk.dim(`list-id: ${chalk.white(flags['list-id'])}`),
+    ].filter(Boolean).join(chalk.dim('  ·  '))
+
+    this.log(
+      chalk.bold('\nYour tasks') +
+      (filterInfo ? chalk.dim('  —  ') + filterInfo : '') +
+      chalk.dim(`  (${filtered.length}${filtered.length < tasks.length ? `/${tasks.length}` : ''})`) +
+      '\n',
+    )
+
+    this.log(renderTable(filtered, [
+      { header: 'ID',          key: 'id',         width: 10 },
+      { header: 'Link',        key: 'url',         width: 42, format: (v) => v ?? '—' },
+      { header: 'Priority',    key: 'priority',    width: 8,  format: (v) => priorityLabel(Number(v)), colorize: priorityColor },
+      { header: 'Status',      key: 'status',      width: 15, colorize: statusColor },
+      { header: 'Due',         key: 'dueDate',     width: 12, format: (v) => v ?? '—' },
+      { header: 'Lista',       key: 'listName',    width: 20, format: (v) => v ?? '—' },
+      { header: 'Cartella',    key: 'folderName',  width: 20, format: (v) => v ?? '—' },
+      { header: 'Description', key: 'name',        width: 55 },
+    ]))
+
+    this.log('')
+    return { tasks: filtered }
+  }
+}

package/src/commands/tasks/today.js

@@ -0,0 +1,73 @@
+import { Command } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import { getTasksToday, isAuthenticated } from '../../services/clickup.js'
+import { loadConfig } from '../../services/config.js'
+import { renderTable } from '../../formatters/table.js'
+
+/**
+ * Return today's date as a local YYYY-MM-DD string.
+ * @returns {string}
+ */
+function localTodayString() {
+  const d = new Date()
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`
+}
+
+export default class TasksToday extends Command {
+  static description = 'Task in lavorazione oggi: data odierna nel range [startDate, dueDate]. Include task scaduti non conclusi.'
+
+  static examples = [
+    '<%= config.bin %> tasks today',
+    '<%= config.bin %> tasks today --json',
+  ]
+
+  static enableJsonFlag = true
+
+  async run() {
+    const { flags } = await this.parse(TasksToday)
+    const isJson = flags.json
+    const config = await loadConfig()
+
+    if (!(await isAuthenticated())) {
+      this.error('ClickUp not authenticated. Run `dvmi init` to configure ClickUp.')
+    }
+
+    const teamId = config.clickup?.teamId
+    if (!teamId) this.error('ClickUp team ID not configured. Run `dvmi init` to configure ClickUp.')
+
+    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching today\'s tasks...') }).start()
+    const tasks = await getTasksToday(teamId)
+    spinner?.stop()
+
+    if (isJson) return { tasks }
+
+    if (tasks.length === 0) {
+      this.log(chalk.dim('No tasks for today.'))
+      this.log(chalk.dim('Check `dvmi tasks list` for all assigned tasks.'))
+      return { tasks: [] }
+    }
+
+    const today = localTodayString()
+
+    this.log(chalk.bold('\nToday\'s tasks:\n'))
+    this.log(renderTable(tasks, [
+      { header: 'Title', key: 'name', width: 45 },
+      { header: 'Status', key: 'status', width: 15 },
+      {
+        header: 'Due',
+        key: 'dueDate',
+        width: 12,
+        format: (v) => v ?? '—',
+        colorize: (v) => {
+          if (!v) return chalk.dim('—')
+          if (v < today) return chalk.red.bold(v)
+          return v
+        },
+      },
+      { header: 'Link', key: 'url', format: (v) => v ?? '—' },
+    ]))
+
+    return { tasks }
+  }
+}

package/src/commands/upgrade.js

@@ -0,0 +1,52 @@
+import { Command } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import { checkForUpdate } from '../services/version-check.js'
+import { exec } from '../services/shell.js'
+
+export default class Upgrade extends Command {
+  static description = 'Aggiorna la CLI all\'ultima versione disponibile'
+
+  static examples = [
+    '<%= config.bin %> upgrade',
+    '<%= config.bin %> upgrade --json',
+  ]
+
+  static enableJsonFlag = true
+
+  async run() {
+    const { flags } = await this.parse(Upgrade)
+    const isJson = flags.json
+
+    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Checking for updates...') }).start()
+    const { hasUpdate, current, latest } = await checkForUpdate({ force: true })
+    spinner?.stop()
+
+    if (!hasUpdate) {
+      const msg = `You're already on the latest version (${current})`
+      if (isJson) return { currentVersion: current, latestVersion: latest, updated: false }
+      this.log(chalk.green('✓') + ' ' + msg)
+      return
+    }
+
+    if (!isJson) {
+      this.log(`Updating from ${chalk.yellow(current)} to ${chalk.green(latest)}`)
+    }
+
+     const updateSpinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Installing update...') }).start()
+     // Non passare --registry globale: verrebbe usato anche per le dipendenze.
+     // ~/.npmrc ha già devvami:registry per il solo scope corretto.
+     const result = await exec('npm', ['install', '-g', `devvami@${latest}`])
+    if (result.exitCode !== 0) {
+      updateSpinner?.fail('Update failed')
+      this.error(`Update failed: ${result.stderr}`)
+    }
+    updateSpinner?.succeed(`Updated to ${latest}`)
+
+    const response = { currentVersion: current, latestVersion: latest, updated: true }
+    if (isJson) return response
+
+    this.log(chalk.green('✓') + ` Successfully updated to ${latest}`)
+    return response
+  }
+}