@cregis-dev/cckit 0.6.5 → 0.6.7

package/src/commands/init.js

@@ -1,161 +1,174 @@
-/**
- * init command — orchestrate installation of all components.
- *
- * Flow: load registry → merge config → build steps → orchestrate → write manifest
- */
-
-import path from 'node:path'
-import fse from 'fs-extra'
-import { loadRegistry, resolvePlugins, resolveModelId } from '../core/registry.js'
-import { mergeConfig, DEFAULT_API_URL } from '../core/config.js'
-import { orchestrate } from '../core/orchestrator.js'
-import { MANIFEST_REL, buildManifest, writeManifest } from '../utils/manifest.js'
-import { createLogger } from '../utils/logger.js'
-import { enablePlugins } from '../steps/enable-plugins.js'
-import { installBmad } from '../steps/install-bmad.js'
-import { installRules } from '../steps/install-rules.js'
-import { installSkills } from '../steps/install-skills.js'
-import { installMcp } from '../steps/install-mcp.js'
-import { configureUser } from '../steps/configure-user.js'
-
-const SCAFFOLD_DIRS = [
-  '_bmad-output/planning-artifacts',
-  '_bmad-output/implementation-artifacts',
-  '_bmad-output/test-artifacts',
-  'docs'
-]
-
-const VERSION = '0.5.0'
-
-/**
- * Run the init command.
- *
- * @param {object} opts - Commander options
- * @param {object} [_deps] - Injectable dependencies for testing
- * @returns {Promise<import('../core/orchestrator.js').RunReport>}
- */
-export async function runInit(opts = {}, _deps = {}) {
-  const targetDir = path.resolve(opts.dir || process.cwd())
-  const logger = _deps.logger || createLogger({ debug: opts.debug })
-
-  // Guard: already installed
-  const manifestPath = path.join(targetDir, MANIFEST_REL)
-  if (await fse.pathExists(manifestPath)) {
-    throw new Error(
-      `cckit is already installed in this project. ` +
-      `Found existing manifest at ${MANIFEST_REL}. ` +
-      `Use "cckit update" to modify your installation.`
-    )
-  }
-
-  logger.banner('cckit init')
-
-  // Load registry and merge config
-  const registry = _deps.registry || await loadRegistry()
-  const config = mergeConfig(opts)
-  logger.debug(`Config: ${JSON.stringify(config, null, 2)}`)
-
-  // Resolve plugins
-  const plugins = resolvePlugins(registry, config)
-
-  // Resolve model ID
-  const userSettings = registry.userSettings || {}
-  const modelId = resolveModelId(userSettings, config.model)
-
-  // Build step list
-  const steps = [
-    {
-      id: 'configure-user',
-      fn: _deps.configureUser || configureUser,
-      opts: {
-        apiUrl: config.apiUrl || userSettings.apiUrl || DEFAULT_API_URL,
-        apiKey: config.apiKey,
-        forceApiKey: config.forceApiKey,
-        model: config.model,    // CLI alias (e.g. 'kimi'), used for prompting
-        modelId,                // Resolved ID (e.g. 'Kimi-K2.5'), used for env vars
-        modelEnvKeys: userSettings.modelEnvKeys || [],
-        yes: opts.yes,
-        skip: false,
-      },
-    },
-    {
-      id: 'enable-plugins',
-      fn: _deps.enablePlugins || enablePlugins,
-      opts: {
-        targetDir,
-        plugins,
-        skip: config.plugins === 'none',
-      },
-    },
-    {
-      id: 'install-bmad',
-      fn: _deps.installBmad || installBmad,
-      opts: {
-        targetDir,
-        bmadConfig: registry.bmad,
-        // Only pass explicit CLI overrides (not defaults) to avoid overwriting registry defaults
-        config: {
-          communication_language: opts.communicationLanguage || undefined,
-          document_output_language: opts.docLanguage || undefined,
-        },
-        skip: config.excludeGroups.includes('bmad'),
-      },
-    },
-    {
-      id: 'install-rules',
-      fn: _deps.installRules || installRules,
-      opts: {
-        targetDir,
-        rulesConfig: registry.rules,
-        skip: config.excludeGroups.includes('ecc'),
-      },
-    },
-    {
-      id: 'install-skills',
-      fn: _deps.installSkills || installSkills,
-      opts: {
-        targetDir,
-        skills: registry.skills || [],
-        skip: config.skipSkills || false,
-      },
-    },
-    {
-      id: 'install-mcp',
-      fn: _deps.installMcp || installMcp,
-      opts: {
-        targetDir,
-        mcpConfig: registry.mcp,
-        skip: config.excludeGroups.includes('mcp'),
-      },
-    },
-  ]
-
-  // Orchestrate
-  const report = await orchestrate(steps, logger)
-
-  // Scaffold directories
-  await Promise.all(SCAFFOLD_DIRS.map(dir => {
-    logger.debug(`Creating scaffold: ${dir}`)
-    return fse.ensureDir(path.join(targetDir, dir))
-  }))
-
-  // Write manifest
-  const manifest = buildManifest({ config, report, version: VERSION })
-  await writeManifest(targetDir, manifest)
-  logger.success(`Manifest written to ${MANIFEST_REL}`)
-
-  // Summary
-  logger.newline()
-  logger.banner('Init complete!')
-
-  const successCount = report.steps.filter(s => s.success && !s.skipped).length
-  const skipCount = report.steps.filter(s => s.skipped).length
-  const failCount = report.steps.filter(s => !s.success && !s.skipped).length
-
-  logger.info(`  Successful: ${successCount} steps`)
-  if (skipCount > 0) logger.info(`  Skipped:    ${skipCount} steps`)
-  if (failCount > 0) logger.warn(`Failed:     ${failCount} steps`)
-  logger.newline()
-
-  return report
-}
+/**
+ * init command — orchestrate installation of all components.
+ *
+ * Flow: load registry → merge config → build steps → orchestrate → write manifest
+ */
+
+import path from 'node:path'
+import fse from 'fs-extra'
+import { loadRegistry, resolvePlugins, resolveModelId } from '../core/registry.js'
+import { mergeConfig, DEFAULT_API_URL } from '../core/config.js'
+import { orchestrate } from '../core/orchestrator.js'
+import { MANIFEST_REL, buildManifest, writeManifest } from '../utils/manifest.js'
+import { createLogger } from '../utils/logger.js'
+import { enablePlugins } from '../steps/enable-plugins.js'
+import { addPlugin } from '../steps/add-plugin.js'
+import { installBmad } from '../steps/install-bmad.js'
+import { installRules } from '../steps/install-rules.js'
+import { installSkills } from '../steps/install-skills.js'
+import { installMcp } from '../steps/install-mcp.js'
+import { configureUser } from '../steps/configure-user.js'
+
+const SCAFFOLD_DIRS = [
+  '_bmad-output/planning-artifacts',
+  '_bmad-output/implementation-artifacts',
+  '_bmad-output/test-artifacts',
+  'docs'
+]
+
+const VERSION = '0.5.0'
+
+/**
+ * Run the init command.
+ *
+ * @param {object} opts - Commander options
+ * @param {object} [_deps] - Injectable dependencies for testing
+ * @returns {Promise<import('../core/orchestrator.js').RunReport>}
+ */
+export async function runInit(opts = {}, _deps = {}) {
+  const targetDir = path.resolve(opts.dir || process.cwd())
+  const logger = _deps.logger || createLogger({ debug: opts.debug })
+
+  // Guard: already installed
+  const manifestPath = path.join(targetDir, MANIFEST_REL)
+  if (await fse.pathExists(manifestPath)) {
+    throw new Error(
+      `cckit is already installed in this project. ` +
+      `Found existing manifest at ${MANIFEST_REL}. ` +
+      `Use "cckit update" to modify your installation.`
+    )
+  }
+
+  logger.banner('cckit init')
+
+  // Load registry and merge config
+  const registry = _deps.registry || await loadRegistry()
+  const config = mergeConfig(opts)
+  const versions = registry.versions || {}
+  logger.debug(`Config: ${JSON.stringify(config, null, 2)}`)
+  logger.debug(`Versions: ${JSON.stringify(versions, null, 2)}`)
+
+  // Resolve plugins
+  const plugins = resolvePlugins(registry, config)
+
+  // Resolve model ID
+  const userSettings = registry.userSettings || {}
+  const modelId = resolveModelId(userSettings, config.model)
+
+  // Build step list
+  const steps = [
+    {
+      id: 'configure-user',
+      fn: _deps.configureUser || configureUser,
+      opts: {
+        apiUrl: config.apiUrl || userSettings.apiUrl || DEFAULT_API_URL,
+        apiKey: config.apiKey,
+        forceApiKey: config.forceApiKey,
+        model: config.model,    // CLI alias (e.g. 'kimi'), used for prompting
+        modelId,                // Resolved ID (e.g. 'Kimi-K2.5'), used for env vars
+        modelEnvKeys: userSettings.modelEnvKeys || [],
+        yes: opts.yes,
+        skip: false,
+      },
+    },
+    {
+      id: 'enable-plugins',
+      fn: _deps.enablePlugins || enablePlugins,
+      opts: {
+        targetDir,
+        plugins,
+        skip: config.plugins === 'none',
+      },
+    },
+    // Test: CLI-based plugin installation for project-scoped plugins
+    {
+      id: 'add-plugin',
+      fn: _deps.addPlugin || addPlugin,
+      opts: {
+        targetDir,
+        plugins,
+        skip: config.plugins === 'none' || !config.cliPlugins,
+      },
+    },
+    {
+      id: 'install-bmad',
+      fn: _deps.installBmad || installBmad,
+      opts: {
+        targetDir,
+        bmadConfig: registry.bmad,
+        // Only pass explicit CLI overrides (not defaults) to avoid overwriting registry defaults
+        config: {
+          communication_language: opts.communicationLanguage || undefined,
+          document_output_language: opts.docLanguage || undefined,
+        },
+        skip: config.excludeGroups.includes('bmad'),
+      },
+    },
+    {
+      id: 'install-rules',
+      fn: _deps.installRules || installRules,
+      opts: {
+        targetDir,
+        rulesConfig: registry.rules,
+        skip: config.excludeGroups.includes('ecc'),
+      },
+    },
+    {
+      id: 'install-skills',
+      fn: _deps.installSkills || installSkills,
+      opts: {
+        targetDir,
+        skills: registry.skills || [],
+        skip: config.skipSkills || false,
+      },
+    },
+    {
+      id: 'install-mcp',
+      fn: _deps.installMcp || installMcp,
+      opts: {
+        targetDir,
+        mcpConfig: registry.mcp,
+        skip: config.excludeGroups.includes('mcp'),
+      },
+    },
+  ]
+
+  // Orchestrate
+  const report = await orchestrate(steps, logger)
+
+  // Scaffold directories
+  await Promise.all(SCAFFOLD_DIRS.map(dir => {
+    logger.debug(`Creating scaffold: ${dir}`)
+    return fse.ensureDir(path.join(targetDir, dir))
+  }))
+
+  // Write manifest
+  const manifest = buildManifest({ config, report, version: VERSION, versions })
+  await writeManifest(targetDir, manifest)
+  logger.success(`Manifest written to ${MANIFEST_REL}`)
+
+  // Summary
+  logger.newline()
+  logger.banner('Init complete!')
+
+  const successCount = report.steps.filter(s => s.success && !s.skipped).length
+  const skipCount = report.steps.filter(s => s.skipped).length
+  const failCount = report.steps.filter(s => !s.success && !s.skipped).length
+
+  logger.info(`  Successful: ${successCount} steps`)
+  if (skipCount > 0) logger.info(`  Skipped:    ${skipCount} steps`)
+  if (failCount > 0) logger.warn(`Failed:     ${failCount} steps`)
+  logger.newline()
+
+  return report
+}

package/src/commands/status.js

@@ -1,85 +1,125 @@
-/**
- * status command — display installation state from manifest.
- */
-
-import path from 'node:path'
-import chalk from 'chalk'
-import { readManifest, isLegacyManifest } from '../utils/manifest.js'
-
-/**
- * @param {object} opts
- * @param {string} [opts.dir] - Target directory
- * @returns {Promise<object>}
- */
-export async function runStatus(opts = {}) {
-  const targetDir = path.resolve(opts.dir || process.cwd())
-
-  let manifest
-  try {
-    manifest = await readManifest(targetDir)
-  } catch {
-    const msg = 'cckit is not installed in this directory. Run `cckit init` first.'
-    console.log(`\n  ${chalk.yellow('!')} ${msg}\n`)
-    return { installed: false, output: msg }
-  }
-
-  // Legacy manifest check
-  if (isLegacyManifest(manifest)) {
-    const msg = 'Legacy manifest detected (v1). Please run `cckit init` to reinstall with the new format.'
-    console.log(`\n  ${chalk.yellow('!')} ${msg}\n`)
-    return { installed: true, legacy: true, output: msg }
-  }
-
-  const lines = []
-  lines.push('')
-  lines.push(chalk.bold('cckit installation status'))
-  lines.push('')
-
-  // Step results
-  const steps = manifest.cckit?.steps || []
-  const header = `${'Step'.padEnd(20)} ${'Status'.padEnd(12)} ${'Details'.padEnd(40)}`
-  lines.push(header)
-  lines.push('-'.repeat(72))
-
-  for (const step of steps) {
-    const status = step.skipped
-      ? chalk.gray('skipped')
-      : step.success
-        ? chalk.green('ok')
-        : chalk.red('failed')
-
-    let detail = ''
-    if (step.skipped) {
-      detail = '-'
-    } else if (step.error) {
-      detail = chalk.red(step.error.slice(0, 38))
-    } else if (step.details) {
-      const d = step.details
-      if (d.enabledKeys) detail = `${d.enabledKeys.length} plugins`
-      else if (d.outputDirs) detail = d.outputDirs.join(', ')
-      else if (d.files) detail = `${d.files} files -> ${d.target}`
-      else if (d.results) {
-        const ok = d.results.filter(r => r.success).length
-        detail = `${ok}/${d.results.length} skills`
-      } else if (d.target) detail = d.target
-    }
-
-    lines.push(`${(step.stepId || '-').padEnd(20)} ${status.padEnd(21)} ${detail}`)
-  }
-
-  lines.push('')
-  lines.push(`Directory:     ${targetDir}`)
-  lines.push(`Install date:  ${manifest.cckit?.installedAt || '-'}`)
-  lines.push(`cckit version: ${manifest.cckit?.version || '-'}`)
-
-  if (manifest.cckit?.lastUpdated) {
-    lines.push(`Last updated:  ${manifest.cckit.lastUpdated}`)
-  }
-
-  lines.push('')
-
-  const output = lines.join('\n')
-  console.log(output)
-
-  return { installed: true, cckit: manifest.cckit, output }
-}
+/**
+ * status command — display installation state from manifest.
+ */
+
+import path from 'node:path'
+import chalk from 'chalk'
+import { readManifest, isLegacyManifest } from '../utils/manifest.js'
+import { compareVersions } from '../utils/compare-versions.js'
+import { loadRegistry } from '../core/registry.js'
+
+/**
+ * @param {object} opts
+ * @param {string} [opts.dir] - Target directory
+ * @returns {Promise<object>}
+ */
+export async function runStatus(opts = {}) {
+  const targetDir = path.resolve(opts.dir || process.cwd())
+
+  let manifest
+  try {
+    manifest = await readManifest(targetDir)
+  } catch {
+    const msg = 'cckit is not installed in this directory. Run `cckit init` first.'
+    console.log(`\n  ${chalk.yellow('!')} ${msg}\n`)
+    return { installed: false, output: msg }
+  }
+
+  // Legacy manifest check
+  if (isLegacyManifest(manifest)) {
+    const msg = 'Legacy manifest detected (v1). Please run `cckit init` to reinstall with the new format.'
+    console.log(`\n  ${chalk.yellow('!')} ${msg}\n`)
+    return { installed: true, legacy: true, output: msg }
+  }
+
+  // Load registry and compare versions
+  let registry
+  let needsUpdate = false
+  let components = {}
+  try {
+    registry = await loadRegistry()
+    const result = compareVersions(manifest, registry)
+    needsUpdate = result.needsUpdate
+    components = result.components
+  } catch {
+    // Registry load failed - skip version check
+  }
+
+  const lines = []
+  lines.push('')
+  lines.push(chalk.bold('cckit installation status'))
+  lines.push('')
+
+  // Component versions
+  const installedVersions = manifest.cckit?.config?.versions || {}
+  const versionHeader = `${'Component'.padEnd(22)} ${'Installed'.padEnd(12)} ${'Latest'.padEnd(12)} ${'Status'.padEnd(24)}`
+  lines.push(chalk.bold(versionHeader))
+  lines.push('-'.repeat(70))
+
+  for (const [stepId, info] of Object.entries(components)) {
+    const current = installedVersions[info.versionKey] || 'none'
+    const latest = info.latest
+    const hasUpdate = current !== latest
+
+    const versionStatus = hasUpdate
+      ? chalk.yellow(`update (${current} -> ${latest})`)
+      : chalk.green('up to date')
+
+    lines.push(`${stepId.padEnd(22)} ${current.padEnd(12)} ${latest.padEnd(12)} ${versionStatus}`)
+  }
+
+  if (needsUpdate) {
+    lines.push('')
+    lines.push(chalk.yellow('  Updates available. Run "cckit update" to update.'))
+  }
+
+  lines.push('')
+  lines.push(chalk.bold('Step Results:'))
+  const header = `${'Step'.padEnd(20)} ${'Status'.padEnd(12)} ${'Details'.padEnd(40)}`
+  lines.push(header)
+  lines.push('-'.repeat(72))
+
+  // Step results
+  const steps = manifest.cckit?.steps || []
+  for (const step of steps) {
+    const status = step.skipped
+      ? chalk.gray('skipped')
+      : step.success
+        ? chalk.green('ok')
+        : chalk.red('failed')
+
+    let detail = ''
+    if (step.skipped) {
+      detail = '-'
+    } else if (step.error) {
+      detail = chalk.red(step.error.slice(0, 38))
+    } else if (step.details) {
+      const d = step.details
+      if (d.enabledKeys) detail = `${d.enabledKeys.length} plugins`
+      else if (d.outputDirs) detail = d.outputDirs.join(', ')
+      else if (d.files) detail = `${d.files} files -> ${d.target}`
+      else if (d.results) {
+        const ok = d.results.filter(r => r.success).length
+        detail = `${ok}/${d.results.length} skills`
+      } else if (d.target) detail = d.target
+    }
+
+    lines.push(`${(step.stepId || '-').padEnd(20)} ${status.padEnd(21)} ${detail}`)
+  }
+
+  lines.push('')
+  lines.push(`Directory:     ${targetDir}`)
+  lines.push(`Install date:  ${manifest.cckit?.installedAt || '-'}`)
+  lines.push(`cckit version: ${manifest.cckit?.version || '-'}`)
+
+  if (manifest.cckit?.lastUpdated) {
+    lines.push(`Last updated:  ${manifest.cckit.lastUpdated}`)
+  }
+
+  lines.push('')
+
+  const output = lines.join('\n')
+  console.log(output)
+
+  return { installed: true, cckit: manifest.cckit, output, needsUpdate, components }
+}