devvami 1.4.2 → 1.5.0

package/src/commands/create/repo.js

@@ -1,12 +1,12 @@
-import { Command, Args, Flags } from '@oclif/core'
+import {Command, Args, Flags} from '@oclif/core'
 import chalk from 'chalk'
 import ora from 'ora'
-import { input, confirm } from '@inquirer/prompts'
-import { listTemplates, createFromTemplate, setBranchProtection, enableDependabot } from '../../services/github.js'
-import { loadConfig } from '../../services/config.js'
-import { validateRepoName } from '../../validators/repo-name.js'
-import { renderTable } from '../../formatters/table.js'
-import { exec } from '../../services/shell.js'
+import {input, confirm} from '@inquirer/prompts'
+import {listTemplates, createFromTemplate, setBranchProtection, enableDependabot} from '../../services/github.js'
+import {loadConfig} from '../../services/config.js'
+import {validateRepoName} from '../../validators/repo-name.js'
+import {renderTable} from '../../formatters/table.js'
+import {exec} from '../../services/shell.js'
 
 /**
  * @param {string} lang
@@ -16,15 +16,15 @@ 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,
+    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)
@@ -43,21 +43,21 @@ export default class CreateRepo extends Command {
   static enableJsonFlag = true
 
   static args = {
-    template: Args.string({ description: 'Nome del template', required: false }),
+    template: Args.string({description: 'Nome del template', required: false}),
   }
 
   static flags = {
-    list:        Flags.boolean({ description: 'Lista template disponibili', default: false }),
-    search:      Flags.string({ char: 's', description: 'Cerca in nome e descrizione dei template (case-insensitive)' }),
-    name:        Flags.string({ description: 'Nome del nuovo repository' }),
-    description: Flags.string({ description: 'Descrizione del repository', default: '' }),
-    private:     Flags.boolean({ description: 'Repository privato (default)', default: true }),
-    public:      Flags.boolean({ description: 'Repository pubblico', default: false }),
-    'dry-run':   Flags.boolean({ description: 'Preview senza eseguire', default: false }),
+    list: Flags.boolean({description: 'Lista template disponibili', default: false}),
+    search: Flags.string({char: 's', description: 'Cerca in nome e descrizione dei template (case-insensitive)'}),
+    name: Flags.string({description: 'Nome del nuovo repository'}),
+    description: Flags.string({description: 'Descrizione del repository', default: ''}),
+    private: Flags.boolean({description: 'Repository privato (default)', default: true}),
+    public: Flags.boolean({description: 'Repository pubblico', default: false}),
+    'dry-run': Flags.boolean({description: 'Preview senza eseguire', default: false}),
   }
 
   async run() {
-    const { args, flags } = await this.parse(CreateRepo)
+    const {args, flags} = await this.parse(CreateRepo)
     const isJson = flags.json
     const isDryRun = flags['dry-run']
     const config = await loadConfig()
@@ -68,51 +68,58 @@ export default class CreateRepo extends Command {
 
     // --list mode
     if (flags.list || !args.template) {
-      const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching templates...') }).start()
+      const spinner = isJson
+        ? null
+        : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching templates...')}).start()
       const templates = await listTemplates(config.org)
       spinner?.stop()
 
       // Search filter
       const searchQuery = flags.search?.toLowerCase()
       const filtered = searchQuery
-        ? templates.filter((t) =>
-            t.name.toLowerCase().includes(searchQuery) ||
-            t.description.toLowerCase().includes(searchQuery),
+        ? templates.filter(
+            (t) => t.name.toLowerCase().includes(searchQuery) || t.description.toLowerCase().includes(searchQuery),
           )
         : templates
 
-      if (isJson) return { templates: filtered }
+      if (isJson) return {templates: filtered}
 
       if (templates.length === 0) {
         this.log(chalk.yellow('No templates found in the organization.'))
         this.log(chalk.dim('Templates are GitHub repos marked as "Template repository".'))
-        return { templates: [] }
+        return {templates: []}
       }
 
       if (filtered.length === 0) {
         this.log(chalk.dim(`No templates matching "${flags.search}".`))
-        return { templates: [] }
+        return {templates: []}
       }
 
-      const filterInfo = flags.search
-        ? chalk.dim('  —  search: ') + chalk.white(`"${flags.search}"`)
-        : ''
+      const filterInfo = flags.search ? chalk.dim('  —  search: ') + chalk.white(`"${flags.search}"`) : ''
 
       this.log(
         chalk.bold('\nAvailable templates') +
-        filterInfo +
-        chalk.dim(`  (${filtered.length}${filtered.length < templates.length ? `/${templates.length}` : ''})`) +
-        '\n',
+          filterInfo +
+          chalk.dim(`  (${filtered.length}${filtered.length < templates.length ? `/${templates.length}` : ''})`) +
+          '\n',
       )
 
-      this.log(renderTable(filtered, [
-        { header: 'Name',        key: 'name',        width: 35 },
-        { header: 'Language',    key: 'language',     width: 14, format: (v) => v || '—', colorize: (v) => v === '—' ? chalk.dim(v) : langColor(v) },
-        { header: 'Description', key: 'description',  width: 60, format: (v) => String(v || '—') },
-      ]))
+      this.log(
+        renderTable(filtered, [
+          {header: 'Name', key: 'name', width: 35},
+          {
+            header: 'Language',
+            key: 'language',
+            width: 14,
+            format: (v) => v || '—',
+            colorize: (v) => (v === '—' ? chalk.dim(v) : langColor(v)),
+          },
+          {header: 'Description', key: 'description', width: 60, format: (v) => String(v || '—')},
+        ]),
+      )
 
       this.log('')
-      return { templates: filtered }
+      return {templates: filtered}
     }
 
     // Create mode
@@ -126,7 +133,7 @@ export default class CreateRepo extends Command {
     // Get repo name
     let repoName = flags.name
     if (!repoName && !isJson) {
-      repoName = await input({ message: 'Repository name:' })
+      repoName = await input({message: 'Repository name:'})
     } else if (!repoName) {
       this.error('--name is required in non-interactive mode')
     }
@@ -142,13 +149,16 @@ export default class CreateRepo extends Command {
       const ok = await confirm({
         message: `Create ${isPrivate ? 'private' : 'public'} repo "${config.org}/${repoName}" from "${args.template}"?`,
       })
-      if (!ok) { this.log('Aborted.'); return }
+      if (!ok) {
+        this.log('Aborted.')
+        return
+      }
     }
 
     if (isDryRun) {
       const preview = {
-        repository: { name: repoName, org: config.org, template: args.template, private: isPrivate },
-        postScaffolding: { branchProtection: 'would configure', dependabot: 'would enable', codeowners: 'would create' },
+        repository: {name: repoName, org: config.org, template: args.template, private: isPrivate},
+        postScaffolding: {branchProtection: 'would configure', dependabot: 'would enable', codeowners: 'would create'},
       }
       if (isJson) return preview
       this.log(chalk.bold('\nDry run preview:'))
@@ -157,7 +167,9 @@ export default class CreateRepo extends Command {
     }
 
     // Create repo
-    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Creating repository...') }).start()
+    const spinner = isJson
+      ? null
+      : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Creating repository...')}).start()
     const repo = await createFromTemplate({
       templateOwner: config.org,
       templateRepo: args.template,
@@ -169,22 +181,28 @@ export default class CreateRepo extends Command {
     spinner?.succeed(`Repository created: ${repo.htmlUrl}`)
 
     // Post-scaffolding
-    const bpSpinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Configuring branch protection...') }).start()
+    const bpSpinner = isJson
+      ? null
+      : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Configuring branch protection...')}).start()
     await setBranchProtection(config.org, repoName).catch(() => null)
     bpSpinner?.succeed('Branch protection configured')
 
-    const depSpinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Enabling Dependabot...') }).start()
+    const depSpinner = isJson
+      ? null
+      : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Enabling Dependabot...')}).start()
     await enableDependabot(config.org, repoName).catch(() => null)
     depSpinner?.succeed('Dependabot enabled')
 
     // Clone
-    const cloneSpinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Cloning repository...') }).start()
+    const cloneSpinner = isJson
+      ? null
+      : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Cloning repository...')}).start()
     await exec('gh', ['repo', 'clone', `${config.org}/${repoName}`])
     cloneSpinner?.succeed(`Cloned to ./${repoName}`)
 
     const result = {
-      repository: { name: repoName, url: repo.htmlUrl, localPath: `./${repoName}` },
-      postScaffolding: { branchProtection: 'ok', dependabot: 'ok', codeowners: 'ok' },
+      repository: {name: repoName, url: repo.htmlUrl, localPath: `./${repoName}`},
+      postScaffolding: {branchProtection: 'ok', dependabot: 'ok', codeowners: 'ok'},
     }
 
     if (!isJson) {

package/src/commands/docs/list.js

@@ -1,17 +1,17 @@
-import { Command, Flags } from '@oclif/core'
+import {Command, Flags} from '@oclif/core'
 import chalk from 'chalk'
 import ora from 'ora'
-import { loadConfig } from '../../services/config.js'
-import { listDocs, detectCurrentRepo } from '../../services/docs.js'
-import { renderTable } from '../../formatters/table.js'
+import {loadConfig} from '../../services/config.js'
+import {listDocs, detectCurrentRepo} from '../../services/docs.js'
+import {renderTable} from '../../formatters/table.js'
 
 /**
  * @param {string} type
  * @returns {string}
  */
 function typeColor(type) {
-  if (type === 'readme')   return chalk.cyan(type)
-  if (type === 'swagger')  return chalk.yellow(type)
+  if (type === 'readme') return chalk.cyan(type)
+  if (type === 'swagger') return chalk.yellow(type)
   if (type === 'asyncapi') return chalk.green(type)
   return chalk.dim(type)
 }
@@ -38,12 +38,12 @@ export default class DocsList extends Command {
   static enableJsonFlag = true
 
   static flags = {
-    repo:   Flags.string({ char: 'r', description: 'Nome del repository (default: repo nella directory corrente)' }),
-    search: Flags.string({ char: 's', description: 'Filtra per nome o percorso (case-insensitive)' }),
+    repo: Flags.string({char: 'r', description: 'Nome del repository (default: repo nella directory corrente)'}),
+    search: Flags.string({char: 's', description: 'Filtra per nome o percorso (case-insensitive)'}),
   }
 
   async run() {
-    const { flags } = await this.parse(DocsList)
+    const {flags} = await this.parse(DocsList)
     const isJson = flags.json
     const config = await loadConfig()
 
@@ -55,13 +55,15 @@ export default class DocsList extends Command {
       repo = flags.repo
     } else {
       try {
-        ;({ owner, repo } = await detectCurrentRepo())
+        ;({owner, repo} = await detectCurrentRepo())
       } catch (err) {
         this.error(/** @type {Error} */ (err).message)
       }
     }
 
-    const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching documentation...') }).start()
+    const spinner = isJson
+      ? null
+      : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching documentation...')}).start()
     let entries
     try {
       entries = await listDocs(owner, repo)
@@ -77,34 +79,36 @@ export default class DocsList extends Command {
       ? entries.filter((e) => e.name.toLowerCase().includes(q) || e.path.toLowerCase().includes(q))
       : entries
 
-    if (isJson) return { repo, owner, entries: filtered, total: filtered.length }
+    if (isJson) return {repo, owner, entries: filtered, total: filtered.length}
 
     if (entries.length === 0) {
       this.log(chalk.dim(`No documentation found in ${owner}/${repo}.`))
-      return { repo, owner, entries: [], total: 0 }
+      return {repo, owner, entries: [], total: 0}
     }
 
     if (filtered.length === 0) {
       this.log(chalk.dim(`No documentation matching "${flags.search}" in ${owner}/${repo}.`))
-      return { repo, owner, entries: [], total: 0 }
+      return {repo, owner, entries: [], total: 0}
     }
 
-    const filterInfo = q ? chalk.dim(`  —  search: ${chalk.white(`"${flags.search}"`)}`): ''
+    const filterInfo = q ? chalk.dim(`  —  search: ${chalk.white(`"${flags.search}"`)}`) : ''
     this.log(
       chalk.bold(`\nDocumentation in ${owner}/${repo}`) +
-      filterInfo +
-      chalk.dim(`  (${filtered.length}${filtered.length < entries.length ? `/${entries.length}` : ''})`) +
-      '\n',
+        filterInfo +
+        chalk.dim(`  (${filtered.length}${filtered.length < entries.length ? `/${entries.length}` : ''})`) +
+        '\n',
     )
 
-    this.log(renderTable(filtered, [
-      { header: 'Type', key: 'type', width: 10, colorize: typeColor },
-      { header: 'Name', key: 'name', width: 30 },
-      { header: 'Path', key: 'path', width: 50 },
-      { header: 'Size', key: 'size', width: 8, format: (v) => formatSize(Number(v)) },
-    ]))
+    this.log(
+      renderTable(filtered, [
+        {header: 'Type', key: 'type', width: 10, colorize: typeColor},
+        {header: 'Name', key: 'name', width: 30},
+        {header: 'Path', key: 'path', width: 50},
+        {header: 'Size', key: 'size', width: 8, format: (v) => formatSize(Number(v))},
+      ]),
+    )
     this.log('')
 
-    return { repo, owner, entries: filtered, total: filtered.length }
+    return {repo, owner, entries: filtered, total: filtered.length}
   }
 }

package/src/commands/docs/projects.js

@@ -1,13 +1,13 @@
-import { Command, Flags } from '@oclif/core'
+import {Command, Flags} from '@oclif/core'
 import chalk from 'chalk'
 import ora from 'ora'
-import { loadConfig } from '../../services/config.js'
-import { listRepos } from '../../services/github.js'
-import { listProjectsDocs } from '../../services/docs.js'
-import { renderTable } from '../../formatters/table.js'
+import {loadConfig} from '../../services/config.js'
+import {listRepos} from '../../services/github.js'
+import {listProjectsDocs} from '../../services/docs.js'
+import {renderTable} from '../../formatters/table.js'
 
 export default class DocsProjects extends Command {
-  static description = 'Mostra la documentazione disponibile per ogni repository dell\'organizzazione'
+  static description = "Mostra la documentazione disponibile per ogni repository dell'organizzazione"
 
   static examples = [
     '<%= config.bin %> docs projects',
@@ -18,11 +18,11 @@ export default class DocsProjects extends Command {
   static enableJsonFlag = true
 
   static flags = {
-    search: Flags.string({ char: 's', description: 'Filtra per nome repository (case-insensitive)' }),
+    search: Flags.string({char: 's', description: 'Filtra per nome repository (case-insensitive)'}),
   }
 
   async run() {
-    const { flags } = await this.parse(DocsProjects)
+    const {flags} = await this.parse(DocsProjects)
     const isJson = flags.json
     const config = await loadConfig()
 
@@ -31,7 +31,9 @@ export default class DocsProjects extends Command {
     }
 
     // 1. Fetch all repos
-    const repoSpinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching repositories...') }).start()
+    const repoSpinner = isJson
+      ? null
+      : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Fetching repositories...')}).start()
     let repos
     try {
       repos = await listRepos(config.org)
@@ -43,7 +45,7 @@ export default class DocsProjects extends Command {
 
     if (repos.length === 0) {
       this.log(chalk.dim(`No repositories found in organization "${config.org}".`))
-      return { org: config.org, projects: [], total: 0 }
+      return {org: config.org, projects: [], total: 0}
     }
 
     // 2. Filter by search
@@ -52,11 +54,17 @@ export default class DocsProjects extends Command {
 
     if (filteredRepos.length === 0) {
       this.log(chalk.dim(`No repositories matching "${flags.search}" in ${config.org}.`))
-      return { org: config.org, projects: [], total: 0 }
+      return {org: config.org, projects: [], total: 0}
     }
 
     // 3. Scan each repo for docs
-    const scanSpinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')(`Scanning docs in ${filteredRepos.length} repositories...`) }).start()
+    const scanSpinner = isJson
+      ? null
+      : ora({
+          spinner: 'arc',
+          color: false,
+          text: chalk.hex('#FF6B2B')(`Scanning docs in ${filteredRepos.length} repositories...`),
+        }).start()
 
     const repoNames = filteredRepos.map((r) => r.name)
     let projects
@@ -68,25 +76,51 @@ export default class DocsProjects extends Command {
     }
     scanSpinner?.stop()
 
-    if (isJson) return { org: config.org, projects, total: projects.length }
+    if (isJson) return {org: config.org, projects, total: projects.length}
 
     const filterInfo = q ? chalk.dim(`  —  search: ${chalk.white(`"${flags.search}"`)}`) : ''
     this.log(
       chalk.bold(`\nDocumentation overview for ${config.org}`) +
-      filterInfo +
-      chalk.dim(`  (${projects.length}${projects.length < repos.length ? `/${repos.length}` : ''})`) +
-      '\n',
+        filterInfo +
+        chalk.dim(`  (${projects.length}${projects.length < repos.length ? `/${repos.length}` : ''})`) +
+        '\n',
     )
 
-    this.log(renderTable(projects, [
-      { header: 'Repository', key: 'repo',       width: 40 },
-      { header: 'README',     key: 'hasReadme',   width: 8,  format: (v) => v ? '✓' : '—', colorize: (v) => v === '✓' ? chalk.green(v) : chalk.dim(v) },
-      { header: 'Docs',       key: 'docsCount',   width: 6,  format: (v) => Number(v) > 0 ? String(v) : '—', colorize: (v) => v !== '—' ? chalk.cyan(v) : chalk.dim(v) },
-      { header: 'Swagger',    key: 'hasSwagger',  width: 9,  format: (v) => v ? '✓' : '—', colorize: (v) => v === '✓' ? chalk.yellow(v) : chalk.dim(v) },
-      { header: 'AsyncAPI',   key: 'hasAsyncApi', width: 10, format: (v) => v ? '✓' : '—', colorize: (v) => v === '✓' ? chalk.green(v) : chalk.dim(v) },
-    ]))
+    this.log(
+      renderTable(projects, [
+        {header: 'Repository', key: 'repo', width: 40},
+        {
+          header: 'README',
+          key: 'hasReadme',
+          width: 8,
+          format: (v) => (v ? '✓' : '—'),
+          colorize: (v) => (v === '✓' ? chalk.green(v) : chalk.dim(v)),
+        },
+        {
+          header: 'Docs',
+          key: 'docsCount',
+          width: 6,
+          format: (v) => (Number(v) > 0 ? String(v) : '—'),
+          colorize: (v) => (v !== '—' ? chalk.cyan(v) : chalk.dim(v)),
+        },
+        {
+          header: 'Swagger',
+          key: 'hasSwagger',
+          width: 9,
+          format: (v) => (v ? '✓' : '—'),
+          colorize: (v) => (v === '✓' ? chalk.yellow(v) : chalk.dim(v)),
+        },
+        {
+          header: 'AsyncAPI',
+          key: 'hasAsyncApi',
+          width: 10,
+          format: (v) => (v ? '✓' : '—'),
+          colorize: (v) => (v === '✓' ? chalk.green(v) : chalk.dim(v)),
+        },
+      ]),
+    )
     this.log('')
 
-    return { org: config.org, projects, total: projects.length }
+    return {org: config.org, projects, total: projects.length}
   }
 }

package/src/commands/docs/read.js

@@ -1,12 +1,12 @@
-import { Command, Args, Flags } from '@oclif/core'
+import {Command, Args, Flags} from '@oclif/core'
 import chalk from 'chalk'
 import ora from 'ora'
-import { loadConfig } from '../../services/config.js'
-import { listDocs, readFile, detectCurrentRepo, detectApiSpecType } from '../../services/docs.js'
-import { renderMarkdown, extractMermaidBlocks, toMermaidLiveUrl } from '../../formatters/markdown.js'
-import { parseOpenApi, parseAsyncApi } from '../../formatters/openapi.js'
-import { renderTable } from '../../formatters/table.js'
-import { openBrowser } from '../../utils/open-browser.js'
+import {loadConfig} from '../../services/config.js'
+import {listDocs, readFile, detectCurrentRepo, detectApiSpecType} from '../../services/docs.js'
+import {renderMarkdown, extractMermaidBlocks, toMermaidLiveUrl} from '../../formatters/markdown.js'
+import {parseOpenApi, parseAsyncApi} from '../../formatters/openapi.js'
+import {renderTable} from '../../formatters/table.js'
+import {openBrowser} from '../../utils/open-browser.js'
 
 /**
  * @param {string} method
@@ -52,17 +52,17 @@ export default class DocsRead extends Command {
   static enableJsonFlag = true
 
   static args = {
-    file: Args.string({ description: 'Percorso del file da leggere (default: README)', required: false }),
+    file: Args.string({description: 'Percorso del file da leggere (default: README)', required: false}),
   }
 
   static flags = {
-    repo:   Flags.string({ char: 'r', description: 'Nome del repository (default: repo nella directory corrente)' }),
-    raw:    Flags.boolean({ description: 'Mostra contenuto grezzo senza parsing speciale', default: false }),
-    render: Flags.boolean({ description: 'Apri i diagrammi Mermaid nel browser via mermaid.live', default: false }),
+    repo: Flags.string({char: 'r', description: 'Nome del repository (default: repo nella directory corrente)'}),
+    raw: Flags.boolean({description: 'Mostra contenuto grezzo senza parsing speciale', default: false}),
+    render: Flags.boolean({description: 'Apri i diagrammi Mermaid nel browser via mermaid.live', default: false}),
   }
 
   async run() {
-    const { args, flags } = await this.parse(DocsRead)
+    const {args, flags} = await this.parse(DocsRead)
     const isJson = flags.json
     const config = await loadConfig()
 
@@ -74,7 +74,7 @@ export default class DocsRead extends Command {
       repo = flags.repo
     } else {
       try {
-        ;({ owner, repo } = await detectCurrentRepo())
+        ;({owner, repo} = await detectCurrentRepo())
       } catch (err) {
         this.error(/** @type {Error} */ (err).message)
       }
@@ -83,7 +83,9 @@ export default class DocsRead extends Command {
     // Resolve file path
     let filePath = args.file
     if (!filePath) {
-      const spinner = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Looking for README...') }).start()
+      const spinner = isJson
+        ? null
+        : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')('Looking for README...')}).start()
       let entries
       try {
         entries = await listDocs(owner, repo)
@@ -95,24 +97,35 @@ export default class DocsRead extends Command {
       const readme = entries.find((e) => e.type === 'readme')
       if (!readme) {
         this.log(chalk.dim(`No README found in ${owner}/${repo}.`))
-        return { repo, owner, path: null, type: null, content: null, size: 0 }
+        return {repo, owner, path: null, type: null, content: null, size: 0}
       }
       filePath = readme.path
     }
 
     // Fetch content
-    const spinner2 = isJson ? null : ora({ spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')(`Reading ${filePath}...`) }).start()
-     let content
-     try {
-       content = await readFile(owner, repo, filePath)
-     } catch {
-       spinner2?.stop()
-       this.error(`File "${filePath}" not found in ${owner}/${repo}. Run \`dvmi docs list\` to see available documentation.`)
-     }
+    const spinner2 = isJson
+      ? null
+      : ora({spinner: 'arc', color: false, text: chalk.hex('#FF6B2B')(`Reading ${filePath}...`)}).start()
+    let content
+    try {
+      content = await readFile(owner, repo, filePath)
+    } catch {
+      spinner2?.stop()
+      this.error(
+        `File "${filePath}" not found in ${owner}/${repo}. Run \`dvmi docs list\` to see available documentation.`,
+      )
+    }
     spinner2?.stop()
 
     if (isJson) {
-      return { repo, owner, path: filePath, type: detectApiSpecType(filePath, content) ?? 'doc', content, size: content.length }
+      return {
+        repo,
+        owner,
+        path: filePath,
+        type: detectApiSpecType(filePath, content) ?? 'doc',
+        content,
+        size: content.length,
+      }
     }
 
     // Handle --render (Mermaid)
@@ -133,33 +146,37 @@ export default class DocsRead extends Command {
 
     // Render
     if (!flags.raw && specType === 'swagger') {
-      const { endpoints, error } = parseOpenApi(content)
+      const {endpoints, error} = parseOpenApi(content)
       if (error || endpoints.length === 0) {
         this.log(chalk.yellow(`⚠ Could not parse "${filePath}" as OpenAPI spec (showing raw content). ${error ?? ''}`))
         this.log(content)
       } else {
         this.log(chalk.bold(`\nAPI Endpoints — ${filePath}\n`))
-        this.log(renderTable(endpoints, [
-          { header: 'Method',     key: 'method',     width: 8,  colorize: methodColor },
-          { header: 'Path',       key: 'path',       width: 45 },
-          { header: 'Summary',    key: 'summary',    width: 40 },
-          { header: 'Parameters', key: 'parameters', width: 30, format: (v) => v || '—' },
-        ]))
+        this.log(
+          renderTable(endpoints, [
+            {header: 'Method', key: 'method', width: 8, colorize: methodColor},
+            {header: 'Path', key: 'path', width: 45},
+            {header: 'Summary', key: 'summary', width: 40},
+            {header: 'Parameters', key: 'parameters', width: 30, format: (v) => v || '—'},
+          ]),
+        )
         this.log('')
       }
     } else if (!flags.raw && specType === 'asyncapi') {
-      const { channels, error } = parseAsyncApi(content)
+      const {channels, error} = parseAsyncApi(content)
       if (error || channels.length === 0) {
         this.log(chalk.yellow(`⚠ Could not parse "${filePath}" as AsyncAPI spec (showing raw content). ${error ?? ''}`))
         this.log(content)
       } else {
         this.log(chalk.bold(`\nAsyncAPI Channels — ${filePath}\n`))
-        this.log(renderTable(channels, [
-          { header: 'Channel',   key: 'channel',   width: 35 },
-          { header: 'Operation', key: 'operation', width: 12, colorize: opColor },
-          { header: 'Summary',   key: 'summary',   width: 40 },
-          { header: 'Message',   key: 'message',   width: 25, format: (v) => v || '—' },
-        ]))
+        this.log(
+          renderTable(channels, [
+            {header: 'Channel', key: 'channel', width: 35},
+            {header: 'Operation', key: 'operation', width: 12, colorize: opColor},
+            {header: 'Summary', key: 'summary', width: 40},
+            {header: 'Message', key: 'message', width: 25, format: (v) => v || '—'},
+          ]),
+        )
         this.log('')
       }
     } else {
@@ -167,6 +184,6 @@ export default class DocsRead extends Command {
       this.log(renderMarkdown(content))
     }
 
-    return { repo, owner, path: filePath, type: specType ?? 'doc', content, size: content.length }
+    return {repo, owner, path: filePath, type: specType ?? 'doc', content, size: content.length}
   }
 }