devvami 1.4.2 → 1.5.1

package/src/types.js

@@ -332,6 +332,123 @@
  * @typedef {'macos'|'wsl2'|'linux'} Platform
  */
 
+// ──────────────────────────────────────────────────────────────────────────────
+// AI Config Sync TUI types
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * @typedef {'mcp'|'command'|'rule'|'skill'|'agent'} CategoryType
+ */
+
+/**
+ * @typedef {'vscode-copilot'|'claude-code'|'claude-desktop'|'opencode'|'gemini-cli'|'copilot-cli'|'cursor'|'windsurf'|'continue-dev'|'zed'|'amazon-q'} EnvironmentId
+ */
+
+/**
+ * @typedef {Object} MCPParams
+ * @property {'stdio'|'sse'|'streamable-http'} transport - MCP transport type
+ * @property {string} [command] - Command to execute (required for stdio transport)
+ * @property {string[]} [args] - Command arguments
+ * @property {Record<string, string>} [env] - Environment variables
+ * @property {string} [url] - Server URL (required for sse/streamable-http transport)
+ */
+
+/**
+ * @typedef {Object} CommandParams
+ * @property {string} content - Prompt/command text content (multi-line)
+ * @property {string} [description] - Short description of the command
+ */
+
+/**
+ * @typedef {Object} RuleParams
+ * @property {string} content - Rules/instructions content (multi-line Markdown)
+ * @property {string} [description] - Short description of the rule
+ */
+
+/**
+ * @typedef {Object} SkillParams
+ * @property {string} content - Skill definition content (multi-line)
+ * @property {string} [description] - Short description of the skill
+ */
+
+/**
+ * @typedef {Object} AgentParams
+ * @property {string} instructions - Agent instructions (multi-line)
+ * @property {string} [description] - Short description of the agent
+ */
+
+/**
+ * @typedef {Object} CategoryEntry
+ * @property {string} id - UUID v4, auto-generated
+ * @property {string} name - Unique within its type; used as filename/key when deploying
+ * @property {CategoryType} type - Category type
+ * @property {boolean} active - true = deployed to environments, false = removed but kept in store
+ * @property {EnvironmentId[]} environments - Target environments for deployment
+ * @property {MCPParams|CommandParams|RuleParams|SkillParams|AgentParams} params - Type-specific parameters
+ * @property {string} createdAt - ISO 8601 timestamp
+ * @property {string} updatedAt - ISO 8601 timestamp
+ */
+
+/**
+ * @typedef {Object} AIConfigStore
+ * @property {number} version - Schema version
+ * @property {CategoryEntry[]} entries - All managed configuration entries
+ */
+
+/**
+ * @typedef {Object} PathStatus
+ * @property {string} path - Absolute path
+ * @property {boolean} exists - Whether the path exists on disk
+ * @property {boolean} readable - Whether the file could be parsed (for JSON/TOML files)
+ */
+
+/**
+ * @typedef {Object} CategoryCounts
+ * @property {number} mcp
+ * @property {number} command
+ * @property {number} rule
+ * @property {number} skill
+ * @property {number} agent
+ */
+
+/**
+ * @typedef {Object} NativeEntry
+ * Runtime only — not persisted. Represents an item found in an environment's config
+ * file that is NOT managed by dvmi.
+ * @property {string} name - Entry name (extracted from config key or filename)
+ * @property {CategoryType} type - Category type
+ * @property {EnvironmentId} environmentId - Source environment
+ * @property {'project'|'global'} level - Whether from project-level or global-level config
+ * @property {string} sourcePath - Absolute path to the source config file
+ * @property {object} params - Normalized parameters (same structure as managed entry params)
+ */
+
+/**
+ * @typedef {Object} DriftInfo
+ * Runtime only — not persisted. Describes a managed entry whose deployed state
+ * diverges from dvmi's stored expected state.
+ * @property {string} entryId - ID of the managed CategoryEntry that drifted
+ * @property {EnvironmentId} environmentId - Environment where drift was detected
+ * @property {object} expected - What dvmi expects (from store)
+ * @property {object} actual - What was found in the file
+ */
+
+/**
+ * @typedef {Object} DetectedEnvironment
+ * @property {EnvironmentId} id - Environment identifier
+ * @property {string} name - Display name (e.g. "Claude Code")
+ * @property {boolean} detected - Whether any config files were found
+ * @property {PathStatus[]} projectPaths - Project-level paths and their existence status
+ * @property {PathStatus[]} globalPaths - Global-level paths and their existence status
+ * @property {string[]} unreadable - Paths that exist but failed to parse
+ * @property {CategoryType[]} supportedCategories - Category types this environment supports
+ * @property {CategoryCounts} counts - Per-category item counts from dvmi-managed entries
+ * @property {CategoryCounts} nativeCounts - Per-category native item counts (items in config files)
+ * @property {NativeEntry[]} nativeEntries - All native entries found for this environment
+ * @property {DriftInfo[]} driftedEntries - Managed entries that have drifted from expected state
+ * @property {'project'|'global'|'both'} scope - Where detection occurred
+ */
+
 /**
  * @typedef {Object} PlatformInfo
  * @property {Platform} platform

package/src/utils/aws-vault.js

@@ -1,5 +1,5 @@
-import { loadConfigSync } from '../services/config.js'
-import { execa } from 'execa'
+import {loadConfigSync} from '../services/config.js'
+import {execa} from 'execa'
 
 /**
  * Returns the aws-vault exec prefix to prepend to AWS CLI commands.
@@ -44,10 +44,7 @@ export function awsVaultPrefix(config = null) {
  * @returns {boolean}
  */
 export function hasAwsCredentialEnv() {
-  return Boolean(
-    process.env.AWS_ACCESS_KEY_ID ||
-      process.env.AWS_SESSION_TOKEN,
-  )
+  return Boolean(process.env.AWS_ACCESS_KEY_ID || process.env.AWS_SESSION_TOKEN)
 }
 
 /**
@@ -79,24 +76,14 @@ export async function reexecCurrentCommandWithAwsVault(config = null) {
   if (process.env.DVMI_AWS_VAULT_REEXEC === '1') return null
 
   try {
-    const child = await execa(
-      'aws-vault',
-      [
-        'exec',
-        profile,
-        '--',
-        process.execPath,
-        ...process.argv.slice(1),
-      ],
-      {
-        reject: false,
-        stdio: 'inherit',
-        env: {
-          ...process.env,
-          DVMI_AWS_VAULT_REEXEC: '1',
-        },
+    const child = await execa('aws-vault', ['exec', profile, '--', process.execPath, ...process.argv.slice(1)], {
+      reject: false,
+      stdio: 'inherit',
+      env: {
+        ...process.env,
+        DVMI_AWS_VAULT_REEXEC: '1',
       },
-    )
+    })
 
     return child.exitCode ?? 1
   } catch {
@@ -117,25 +104,15 @@ export async function reexecCurrentCommandWithAwsVaultProfile(profile, extraEnv
   if (!profile) return null
 
   try {
-    const child = await execa(
-      'aws-vault',
-      [
-        'exec',
-        profile,
-        '--',
-        process.execPath,
-        ...process.argv.slice(1),
-      ],
-      {
-        reject: false,
-        stdio: 'inherit',
-        env: {
-          ...process.env,
-          DVMI_AWS_VAULT_REEXEC: '1',
-          ...extraEnv,
-        },
+    const child = await execa('aws-vault', ['exec', profile, '--', process.execPath, ...process.argv.slice(1)], {
+      reject: false,
+      stdio: 'inherit',
+      env: {
+        ...process.env,
+        DVMI_AWS_VAULT_REEXEC: '1',
+        ...extraEnv,
       },
-    )
+    })
 
     return child.exitCode ?? 1
   } catch {

package/src/utils/banner.js

@@ -1,6 +1,6 @@
 import figlet from 'figlet'
 import chalk from 'chalk'
-import { BRAND_GRADIENT, animateGradientBanner, isColorEnabled } from './gradient.js'
+import {BRAND_GRADIENT, animateGradientBanner, isColorEnabled} from './gradient.js'
 
 // Brand colors
 export const ORANGE = '#FF6B2B'
@@ -24,13 +24,11 @@ function figletAsync(text, opts) {
  * @returns {Promise<void>}
  */
 export async function printBanner() {
-   const art = await figletAsync('DVMI', { font: 'ANSI Shadow' })
-   const artLines = art.split('\n').filter((l) => l.trim() !== '')
-   const width = Math.max(...artLines.map((l) => l.length)) + 4
+  const art = await figletAsync('DVMI', {font: 'ANSI Shadow'})
+  const artLines = art.split('\n').filter((l) => l.trim() !== '')
+  const width = Math.max(...artLines.map((l) => l.length)) + 4
 
-   const tagline = isColorEnabled
-     ? chalk.hex(BLUE).bold('  Devvami Developer CLI')
-     : '  Devvami Developer CLI'
+  const tagline = isColorEnabled ? chalk.hex(BLUE).bold('  Devvami Developer CLI') : '  Devvami Developer CLI'
 
   const separator = isColorEnabled
     ? chalk.hex(BLUE).dim('─'.repeat(Math.min(width, 60)))

package/src/utils/errors.js

@@ -2,14 +2,14 @@
  * Base CLI error with an actionable hint for the user.
  */
 export class DvmiError extends Error {
-   /**
-    * @param {string} message - Human-readable error message
-    * @param {string} hint - Actionable suggestion to resolve the error
-    * @param {number} [exitCode] - Process exit code (default: 1)
-    */
-   constructor(message, hint, exitCode = 1) {
-     super(message)
-     this.name = 'DvmiError'
+  /**
+   * @param {string} message - Human-readable error message
+   * @param {string} hint - Actionable suggestion to resolve the error
+   * @param {number} [exitCode] - Process exit code (default: 1)
+   */
+  constructor(message, hint, exitCode = 1) {
+    super(message)
+    this.name = 'DvmiError'
     /** @type {string} */
     this.hint = hint
     /** @type {number} */
@@ -21,43 +21,39 @@ export class DvmiError extends Error {
  * Validation error for invalid user input (exit code 2).
  */
 export class ValidationError extends DvmiError {
-   /**
-    * @param {string} message
-    * @param {string} hint
-    */
-   constructor(message, hint) {
-     super(message, hint, 2)
-     this.name = 'ValidationError'
-     // oclif reads this.oclif.exit to determine the process exit code
-     this.oclif = { exit: 2 }
-   }
- }
+  /**
+   * @param {string} message
+   * @param {string} hint
+   */
+  constructor(message, hint) {
+    super(message, hint, 2)
+    this.name = 'ValidationError'
+    // oclif reads this.oclif.exit to determine the process exit code
+    this.oclif = {exit: 2}
+  }
+}
 
- /**
-  * Auth error for missing or expired authentication.
-  */
- export class AuthError extends DvmiError {
-   /**
-    * @param {string} service - Service name (e.g. "GitHub", "AWS")
-    */
-   constructor(service) {
-     super(
-       `${service} authentication required`,
-       `Run \`dvmi auth login\` to authenticate`,
-       1,
-     )
-     this.name = 'AuthError'
-   }
- }
+/**
+ * Auth error for missing or expired authentication.
+ */
+export class AuthError extends DvmiError {
+  /**
+   * @param {string} service - Service name (e.g. "GitHub", "AWS")
+   */
+  constructor(service) {
+    super(`${service} authentication required`, `Run \`dvmi auth login\` to authenticate`, 1)
+    this.name = 'AuthError'
+  }
+}
 
- /**
-  * Format an error for display in the terminal.
-  * @param {Error} err
-  * @returns {string}
-  */
- export function formatError(err) {
-   if (err instanceof DvmiError) {
-     return `Error: ${err.message}\nHint: ${err.hint}`
-   }
-   return `Error: ${err.message}`
- }
+/**
+ * Format an error for display in the terminal.
+ * @param {Error} err
+ * @returns {string}
+ */
+export function formatError(err) {
+  if (err instanceof DvmiError) {
+    return `Error: ${err.message}\nHint: ${err.hint}`
+  }
+  return `Error: ${err.message}`
+}

package/src/utils/frontmatter.js

@@ -18,7 +18,7 @@ import yaml from 'js-yaml'
 export function parseFrontmatter(content) {
   const match = content.match(/^---\r?\n([\s\S]*?)---\r?\n?([\s\S]*)$/)
   if (!match) {
-    return { frontmatter: {}, body: content }
+    return {frontmatter: {}, body: content}
   }
   const rawYaml = match[1]
   const body = match[2] ?? ''
@@ -28,9 +28,9 @@ export function parseFrontmatter(content) {
       parsed && typeof parsed === 'object' && !Array.isArray(parsed)
         ? /** @type {Record<string, unknown>} */ (parsed)
         : {}
-    return { frontmatter, body }
+    return {frontmatter, body}
   } catch {
-    return { frontmatter: {}, body: content }
+    return {frontmatter: {}, body: content}
   }
 }
 
@@ -47,6 +47,6 @@ export function serializeFrontmatter(frontmatter, body) {
   if (!frontmatter || Object.keys(frontmatter).length === 0) {
     return body
   }
-  const yamlStr = yaml.dump(frontmatter, { lineWidth: -1 }).trimEnd()
+  const yamlStr = yaml.dump(frontmatter, {lineWidth: -1}).trimEnd()
   return `---\n${yamlStr}\n---\n${body}`
 }

package/src/utils/gradient.js

@@ -12,9 +12,9 @@ import readline from 'node:readline'
 
 /** @type {GradientStop[]} */
 export const BRAND_GRADIENT = [
-  [0,   212, 255],  // #00D4FF — ciano elettrico
-  [0,   100, 255],  // #0064FF — blu vivido
-  [100,   0, 220],  // #6400DC — indaco profondo
+  [0, 212, 255], // #00D4FF — ciano elettrico
+  [0, 100, 255], // #0064FF — blu vivido
+  [100, 0, 220], // #6400DC — indaco profondo
 ]
 
 // ──────────────────────────────────────────────────────────────────────────────
@@ -51,24 +51,26 @@ export function gradientText(text, stops, phase = 0) {
 
   const segments = stops.length - 1
 
-  return chars.map((char, i) => {
-    if (char === ' ') return char
+  return chars
+    .map((char, i) => {
+      if (char === ' ') return char
 
-    // Normalise t in [0, 1] with phase shift
-    const t = ((i / Math.max(len - 1, 1)) + phase) % 1
+      // Normalise t in [0, 1] with phase shift
+      const t = (i / Math.max(len - 1, 1) + phase) % 1
 
-    const seg = Math.min(Math.floor(t * segments), segments - 1)
-    const localT = t * segments - seg
+      const seg = Math.min(Math.floor(t * segments), segments - 1)
+      const localT = t * segments - seg
 
-    const [r1, g1, b1] = stops[seg]
-    const [r2, g2, b2] = stops[seg + 1]
+      const [r1, g1, b1] = stops[seg]
+      const [r2, g2, b2] = stops[seg + 1]
 
-    const r = Math.round(r1 + (r2 - r1) * localT)
-    const g = Math.round(g1 + (g2 - g1) * localT)
-    const b = Math.round(b1 + (b2 - b1) * localT)
+      const r = Math.round(r1 + (r2 - r1) * localT)
+      const g = Math.round(g1 + (g2 - g1) * localT)
+      const b = Math.round(b1 + (b2 - b1) * localT)
 
-    return chalk.rgb(r, g, b)(char)
-  }).join('')
+      return chalk.rgb(r, g, b)(char)
+    })
+    .join('')
 }
 
 // ──────────────────────────────────────────────────────────────────────────────

package/src/utils/open-browser.js

@@ -1,6 +1,6 @@
 import open from 'open'
-import { detectPlatform } from '../services/platform.js'
-import { exec } from '../services/shell.js'
+import {detectPlatform} from '../services/platform.js'
+import {exec} from '../services/shell.js'
 
 /**
  * Open a URL in the default browser, using the platform-appropriate command.
@@ -8,7 +8,7 @@ import { exec } from '../services/shell.js'
  * @returns {Promise<void>}
  */
 export async function openBrowser(url) {
-  const { platform, openCommand } = await detectPlatform()
+  const {platform, openCommand} = await detectPlatform()
 
   if (platform === 'macos') {
     await open(url)