devvami 1.0.0 → 1.1.0

package/oclif.manifest.json

@@ -1024,6 +1024,270 @@
         "status.js"
       ]
     },
+    "prompts:browse": {
+      "aliases": [],
+      "args": {
+        "source": {
+          "description": "Source to browse: skills | awesome",
+          "name": "source",
+          "options": [
+            "skills",
+            "awesome"
+          ],
+          "required": true
+        }
+      },
+      "description": "Browse prompts and skills from external sources (skills.sh, awesome-copilot)",
+      "examples": [
+        "<%= config.bin %> prompts browse skills --query refactor",
+        "<%= config.bin %> prompts browse skills --query testing --json",
+        "<%= config.bin %> prompts browse awesome",
+        "<%= config.bin %> prompts browse awesome --category agents",
+        "<%= config.bin %> prompts browse awesome --category instructions --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "query": {
+          "char": "q",
+          "description": "Search query (only applies to skills source)",
+          "name": "query",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "category": {
+          "char": "c",
+          "description": "awesome-copilot category (agents, instructions, skills, plugins, hooks, workflows)",
+          "name": "category",
+          "default": "instructions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "prompts:browse",
+      "pluginAlias": "devvami",
+      "pluginName": "devvami",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "src",
+        "commands",
+        "prompts",
+        "browse.js"
+      ]
+    },
+    "prompts:download": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Relative path of the prompt in the repository (e.g. coding/refactor-prompt.md)",
+          "name": "path",
+          "required": false
+        }
+      },
+      "description": "Download a prompt from your personal repository to .prompts/",
+      "examples": [
+        "<%= config.bin %> prompts download",
+        "<%= config.bin %> prompts download coding/refactor-prompt.md",
+        "<%= config.bin %> prompts download coding/refactor-prompt.md --overwrite",
+        "<%= config.bin %> prompts download --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "overwrite": {
+          "description": "Overwrite existing local file without prompting",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "prompts:download",
+      "pluginAlias": "devvami",
+      "pluginName": "devvami",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "src",
+        "commands",
+        "prompts",
+        "download.js"
+      ]
+    },
+    "prompts:install-speckit": {
+      "aliases": [],
+      "args": {},
+      "description": "Install spec-kit (specify-cli) and run `specify init` to set up Spec-Driven Development",
+      "examples": [
+        "<%= config.bin %> prompts install-speckit",
+        "<%= config.bin %> prompts install-speckit --ai opencode",
+        "<%= config.bin %> prompts install-speckit --force",
+        "<%= config.bin %> prompts install-speckit --reinstall"
+      ],
+      "flags": {
+        "ai": {
+          "description": "AI agent to pass to `specify init --ai` (defaults to the aiTool set in `dvmi init`)",
+          "name": "ai",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "opencode",
+            "copilot",
+            "claude",
+            "gemini",
+            "cursor-agent",
+            "codex",
+            "windsurf",
+            "kiro-cli",
+            "amp"
+          ],
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Pass --force to `specify init` (safe to run in a non-empty directory)",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "reinstall": {
+          "description": "Reinstall specify-cli even if it is already installed",
+          "name": "reinstall",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "prompts:install-speckit",
+      "pluginAlias": "devvami",
+      "pluginName": "devvami",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "src",
+        "commands",
+        "prompts",
+        "install-speckit.js"
+      ]
+    },
+    "prompts:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List prompts from your personal prompt repository",
+      "examples": [
+        "<%= config.bin %> prompts list",
+        "<%= config.bin %> prompts list --filter refactor",
+        "<%= config.bin %> prompts list --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "filter": {
+          "char": "f",
+          "description": "Filter prompts by title, category, description, or tag (case-insensitive)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "prompts:list",
+      "pluginAlias": "devvami",
+      "pluginName": "devvami",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "src",
+        "commands",
+        "prompts",
+        "list.js"
+      ]
+    },
+    "prompts:run": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Relative path of the local prompt (e.g. coding/refactor-prompt.md)",
+          "name": "path",
+          "required": false
+        }
+      },
+      "description": "Execute a local prompt with a configured AI tool",
+      "examples": [
+        "<%= config.bin %> prompts run",
+        "<%= config.bin %> prompts run coding/refactor-prompt.md",
+        "<%= config.bin %> prompts run coding/refactor-prompt.md --tool opencode",
+        "<%= config.bin %> prompts run coding/refactor-prompt.md --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "tool": {
+          "char": "t",
+          "description": "AI tool to use (opencode, copilot)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "opencode",
+            "copilot"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "prompts:run",
+      "pluginAlias": "devvami",
+      "pluginName": "devvami",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "src",
+        "commands",
+        "prompts",
+        "run.js"
+      ]
+    },
     "repo:list": {
       "aliases": [],
       "args": {},
@@ -1234,5 +1498,5 @@
       ]
     }
   },
-  "version": "1.0.0"
+  "version": "1.1.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "devvami",
   "description": "DevEx CLI for developers and teams — manage repos, PRs, pipelines, tasks, and costs from the terminal",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "author": "",
   "type": "module",
   "bin": {
@@ -76,6 +76,9 @@
       },
       "docs": {
         "description": "📖 Repository documentation"
+      },
+      "prompts": {
+        "description": "🔮 AI prompt hub — browse, download, and run prompts"
       }
     }
   },

package/src/commands/init.js

@@ -9,6 +9,8 @@ import { exec, which } from '../services/shell.js'
 import { configExists, loadConfig, saveConfig, CONFIG_PATH } from '../services/config.js'
 import { oauthFlow, storeToken, validateToken, getTeams } from '../services/clickup.js'
 
+import { SUPPORTED_TOOLS } from '../services/prompts.js'
+
 export default class Init extends Command {
   static description = 'Setup completo ambiente di sviluppo locale'
 
@@ -207,7 +209,34 @@ export default class Init extends Command {
       }
     }
 
-     // 6. Shell completions
+     // 6. AI tool selection
+     if (isDryRun) {
+       steps.push({ name: 'ai-tool', status: 'would configure' })
+     } else if (isJson) {
+       config = await loadConfig()
+       steps.push({
+         name: 'ai-tool',
+         status: config.aiTool ? 'configured' : 'not_configured',
+         aiTool: config.aiTool,
+       })
+     } else {
+       const aiToolChoices = Object.keys(SUPPORTED_TOOLS).map((t) => ({ name: t, value: t }))
+       aiToolChoices.push({ name: 'none / skip', value: '' })
+       const aiTool = await select({
+         message: 'Select your preferred AI tool for `dvmi prompts run`:',
+         choices: aiToolChoices,
+       })
+       if (aiTool) {
+         config = { ...config, aiTool }
+         await saveConfig(config)
+         this.log(chalk.green(`✓ AI tool set to: ${aiTool}`))
+         steps.push({ name: 'ai-tool', status: 'configured', aiTool })
+       } else {
+         steps.push({ name: 'ai-tool', status: 'skipped' })
+       }
+     }
+
+     // 7. Shell completions
      steps.push({ name: 'shell-completions', status: 'ok', action: 'install via: dvmi autocomplete' })
 
     const result = { steps, configPath: CONFIG_PATH }

package/src/commands/prompts/browse.js

@@ -0,0 +1,164 @@
+import { Command, Args, Flags } from '@oclif/core'
+import ora from 'ora'
+import chalk from 'chalk'
+import { select } from '@inquirer/prompts'
+import { searchSkills } from '../../services/skills-sh.js'
+import { fetchAwesomeEntries, AWESOME_CATEGORIES } from '../../services/awesome-copilot.js'
+import { formatSkillTable, formatAwesomeTable } from '../../formatters/prompts.js'
+import { DvmiError } from '../../utils/errors.js'
+
+/** @import { Skill, AwesomeEntry } from '../../types.js' */
+
+const VALID_SOURCES = ['skills', 'awesome']
+
+export default class PromptsBrowse extends Command {
+  static description = 'Browse prompts and skills from external sources (skills.sh, awesome-copilot)'
+
+  static examples = [
+    '<%= config.bin %> prompts browse skills --query refactor',
+    '<%= config.bin %> prompts browse skills --query testing --json',
+    '<%= config.bin %> prompts browse awesome',
+    '<%= config.bin %> prompts browse awesome --category agents',
+    '<%= config.bin %> prompts browse awesome --category instructions --json',
+  ]
+
+  static enableJsonFlag = true
+
+  static args = {
+    source: Args.string({
+      description: `Source to browse: ${VALID_SOURCES.join(' | ')}`,
+      required: true,
+      options: VALID_SOURCES,
+    }),
+  }
+
+  static flags = {
+    query: Flags.string({
+      char: 'q',
+      description: 'Search query (only applies to skills source)',
+    }),
+    category: Flags.string({
+      char: 'c',
+      description: `awesome-copilot category (${AWESOME_CATEGORIES.join(', ')})`,
+      default: 'instructions',
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(PromptsBrowse)
+    const isJson = flags.json
+    const source = args.source
+
+    if (!VALID_SOURCES.includes(source)) {
+      this.error(`Invalid source: "${source}". Must be one of: ${VALID_SOURCES.join(', ')}`, {
+        exit: 1,
+        suggestions: VALID_SOURCES.map((s) => `dvmi prompts browse ${s}`),
+      })
+    }
+
+    const spinner = isJson
+      ? null
+      : ora({
+          spinner: 'arc',
+          color: false,
+          text: chalk.hex('#FF6B2B')(
+            source === 'skills' ? 'Searching skills.sh...' : `Fetching awesome-copilot (${flags.category})...`,
+          ),
+        }).start()
+
+    if (source === 'skills') {
+      if (!flags.query || flags.query.length < 2) {
+        this.error('skills.sh requires a search query (min 2 characters)', {
+          exit: 1,
+          suggestions: ['dvmi prompts browse skills --query refactor'],
+        })
+      }
+
+      /** @type {Skill[]} */
+      let skills
+      try {
+        skills = await searchSkills(flags.query ?? '', 50)
+      } catch (err) {
+        spinner?.fail()
+        if (err instanceof DvmiError) {
+          this.error(err.message, { exit: err.exitCode, suggestions: [err.hint] })
+        }
+        throw err
+      }
+
+      spinner?.stop()
+
+      if (isJson) {
+        return { skills, total: skills.length }
+      }
+
+      this.log(
+        chalk.bold('\nSkills') +
+          (flags.query ? chalk.dim(`  —  query: "${flags.query}"`) : '') +
+          chalk.dim(`  (${skills.length})\n`),
+      )
+      this.log(formatSkillTable(skills))
+
+      return { skills, total: skills.length }
+    }
+
+    // source === 'awesome'
+    const category = flags.category
+
+    if (!AWESOME_CATEGORIES.includes(category)) {
+      this.error(`Invalid category: "${category}". Valid: ${AWESOME_CATEGORIES.join(', ')}`, {
+        exit: 1,
+      })
+    }
+
+    /** @type {AwesomeEntry[]} */
+    let entries
+    try {
+      entries = await fetchAwesomeEntries(category)
+    } catch (err) {
+      spinner?.fail()
+      if (err instanceof DvmiError) {
+        this.error(err.message, { exit: err.exitCode, suggestions: [err.hint] })
+      }
+      throw err
+    }
+
+    spinner?.stop()
+
+    if (isJson) {
+      return { entries, total: entries.length, category }
+    }
+
+    this.log(
+      chalk.bold('\nAwesome Copilot') +
+        chalk.dim(`  —  category: `) +
+        chalk.hex('#4A9EFF')(category) +
+        chalk.dim(`  (${entries.length})\n`),
+    )
+    this.log(formatAwesomeTable(entries, category))
+    this.log('')
+
+    if (entries.length > 0) {
+      try {
+        const choices = entries.map((e) => ({ name: `${e.name}  ${chalk.dim(e.url)}`, value: e }))
+        choices.push({ name: chalk.dim('← Exit'), value: /** @type {AwesomeEntry} */ (null) })
+
+        const selected = await select({
+          message: 'Select an entry to view its URL (or Exit):',
+          choices,
+        })
+
+        if (selected) {
+          this.log(`\n${chalk.bold(selected.name)}\n${chalk.hex('#4A9EFF')(selected.url)}\n`)
+          if (selected.description) {
+            this.log(chalk.white(selected.description) + '\n')
+          }
+        }
+      } catch {
+        // User pressed Ctrl+C — exit gracefully
+      }
+    }
+
+    return { entries, total: entries.length, category }
+  }
+}

package/src/commands/prompts/download.js

@@ -0,0 +1,154 @@
+import { Command, Args, Flags } from '@oclif/core'
+import ora from 'ora'
+import chalk from 'chalk'
+import { select, confirm } from '@inquirer/prompts'
+import { join } from 'node:path'
+import { listPrompts, downloadPrompt } from '../../services/prompts.js'
+import { loadConfig } from '../../services/config.js'
+import { DvmiError } from '../../utils/errors.js'
+
+/** @import { Prompt } from '../../types.js' */
+
+const DEFAULT_PROMPTS_DIR = '.prompts'
+
+export default class PromptsDownload extends Command {
+  static description = 'Download a prompt from your personal repository to .prompts/'
+
+  static examples = [
+    '<%= config.bin %> prompts download',
+    '<%= config.bin %> prompts download coding/refactor-prompt.md',
+    '<%= config.bin %> prompts download coding/refactor-prompt.md --overwrite',
+    '<%= config.bin %> prompts download --json',
+  ]
+
+  static enableJsonFlag = true
+
+  static args = {
+    path: Args.string({
+      description: 'Relative path of the prompt in the repository (e.g. coding/refactor-prompt.md)',
+      required: false,
+    }),
+  }
+
+  static flags = {
+    overwrite: Flags.boolean({
+      description: 'Overwrite existing local file without prompting',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(PromptsDownload)
+    const isJson = flags.json
+
+    // Determine local prompts directory from config or default to cwd/.prompts
+    let config = {}
+    try {
+      config = await loadConfig()
+    } catch {
+      /* use defaults */
+    }
+    const localDir =
+      process.env.DVMI_PROMPTS_DIR ?? config.promptsDir ?? join(process.cwd(), DEFAULT_PROMPTS_DIR)
+
+    // Resolve path interactively if not provided (only in interactive mode)
+    let relativePath = args.path
+    if (!relativePath) {
+      if (isJson) {
+        this.error('Prompt path is required in --json mode', {
+          exit: 1,
+          suggestions: ['Run `dvmi prompts download <path> --json`'],
+        })
+      }
+
+      const spinner = ora({
+        spinner: 'arc',
+        color: false,
+        text: chalk.hex('#FF6B2B')('Fetching prompts...'),
+      }).start()
+
+      /** @type {Prompt[]} */
+      let prompts
+      try {
+        prompts = await listPrompts()
+      } catch (err) {
+        spinner.fail()
+        if (err instanceof DvmiError) {
+          this.error(err.message, { exit: err.exitCode, suggestions: [err.hint] })
+        }
+        throw err
+      }
+      spinner.stop()
+
+      if (prompts.length === 0) {
+        this.log(chalk.yellow('No prompts found in the repository.'))
+        return { downloaded: [], skipped: [] }
+      }
+
+      const choices = prompts.map((p) => ({
+        name: `${p.path}  ${chalk.dim(p.title)}`,
+        value: p.path,
+      }))
+      relativePath = await select({ message: 'Select a prompt to download:', choices })
+    }
+
+    // Attempt download (skips automatically if file exists and --overwrite not set)
+    const spinner = isJson
+      ? null
+      : ora({
+          spinner: 'arc',
+          color: false,
+          text: chalk.hex('#FF6B2B')(`Downloading ${relativePath}...`),
+        }).start()
+
+    let result
+    try {
+      result = await downloadPrompt(relativePath, localDir, { overwrite: flags.overwrite })
+    } catch (err) {
+      spinner?.fail()
+      if (err instanceof DvmiError) {
+        this.error(err.message, { exit: err.exitCode, suggestions: [err.hint] })
+      }
+      throw err
+    }
+
+    spinner?.stop()
+
+    // Conflict: file exists and user didn't pass --overwrite → ask interactively
+    if (result.skipped && !flags.overwrite && !isJson) {
+      const shouldOverwrite = await confirm({
+        message: chalk.yellow(`File already exists at ${result.path}. Overwrite?`),
+        default: false,
+      })
+      if (shouldOverwrite) {
+        try {
+          result = await downloadPrompt(relativePath, localDir, { overwrite: true })
+        } catch (err) {
+          if (err instanceof DvmiError) {
+            this.error(err.message, { exit: err.exitCode, suggestions: [err.hint] })
+          }
+          throw err
+        }
+      }
+    }
+
+    if (isJson) {
+      return {
+        downloaded: result.skipped ? [] : [result.path],
+        skipped: result.skipped ? [result.path] : [],
+      }
+    }
+
+    if (result.skipped) {
+      this.log(chalk.dim(`Skipped (already exists): ${result.path}`))
+      this.log(chalk.dim('  Run with --overwrite to replace it.'))
+    } else {
+      this.log(chalk.green(`✓ Downloaded: ${result.path}`))
+    }
+
+    return {
+      downloaded: result.skipped ? [] : [result.path],
+      skipped: result.skipped ? [result.path] : [],
+    }
+  }
+}