@cregis-dev/cckit 0.6.5 → 0.6.7

package/src/commands/update.js

@@ -1,151 +1,192 @@
-/**
- * update command — re-run orchestration to update installed components.
- *
- * Default behavior: apply mode (re-run all steps).
- * --dry-run: show current manifest state only.
- * --no-apply: check-only, update lastUpdated timestamp.
- */
-
-import path from 'node:path'
-import fse from 'fs-extra'
-import { loadRegistry, resolvePlugins, resolveModelId } from '../core/registry.js'
-import { DEFAULT_API_URL } from '../core/config.js'
-import { orchestrate } from '../core/orchestrator.js'
-import { readManifest, writeManifest, isLegacyManifest, serializeSteps } 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'
-
-/**
- * @param {object} opts
- * @param {string} [opts.dir] - Target directory
- * @param {boolean} [opts.dryRun] - Preview only
- * @param {boolean} [opts.apply] - Apply updates (default: true)
- * @param {boolean} [opts.force] - Force overwrite
- * @param {boolean} [opts.debug] - Debug output
- * @param {object} [_deps] - Injectable dependencies
- * @returns {Promise<object>}
- */
-export async function runUpdate(opts = {}, _deps = {}) {
-  const logger = _deps.logger || createLogger({ debug: opts.debug })
-  const targetDir = path.resolve(opts.dir || process.cwd())
-
-  const manifest = await readManifest(targetDir)
-
-  if (isLegacyManifest(manifest)) {
-    throw new Error(
-      'Legacy manifest detected (v1 module-based format). ' +
-      'Please run `cckit init` to reinstall with the new orchestration format.'
-    )
-  }
-
-  logger.banner('cckit update')
-
-  // Show current step status
-  const steps = manifest.cckit?.steps || []
-  for (const step of steps) {
-    const status = step.skipped ? 'skipped' : step.success ? 'ok' : 'FAILED'
-    logger.info(`  ${step.stepId}: ${status}`)
-  }
-
-  if (opts.dryRun) {
-    logger.info('\n  (dry run - no changes made)')
-    return { dryRun: true, steps }
-  }
-
-  if (opts.apply === false) {
-    // Check-only: update timestamp
-    manifest.cckit.lastUpdated = new Date().toISOString()
-    await writeManifest(targetDir, manifest)
-    logger.success('Check complete.')
-    return { checked: true, steps }
-  }
-
-  // Apply mode: re-run orchestrator
-  const registry = _deps.registry || await loadRegistry()
-  const config = manifest.cckit?.config || {}
-  const plugins = resolvePlugins(registry, { plugins: config.plugins || 'default' })
-
-  // Resolve model for user settings
-  const userSettings = registry.userSettings || {}
-  const modelId = resolveModelId(userSettings, opts.model || config.model)
-
-  const stepSpecs = [
-    {
-      id: 'configure-user',
-      fn: _deps.configureUser || configureUser,
-      opts: {
-        apiUrl: opts.apiUrl || config.apiUrl || userSettings.apiUrl || DEFAULT_API_URL,
-        apiKey: opts.apiKey,
-        forceApiKey: opts.forceApiKey,
-        modelId,
-        modelEnvKeys: userSettings.modelEnvKeys || [],
-        yes: true, // update mode is non-interactive by default
-        skip: false,
-      },
-    },
-    {
-      id: 'enable-plugins',
-      fn: _deps.enablePlugins || enablePlugins,
-      opts: { targetDir, plugins, skip: false },
-    },
-    {
-      id: 'install-bmad',
-      fn: _deps.installBmad || installBmad,
-      opts: {
-        targetDir,
-        bmadConfig: registry.bmad,
-        // Pass saved config values only if they differ from BMAD defaults (Chinese)
-        config: {
-          communication_language: config.communication_language !== 'Chinese' ? config.communication_language : undefined,
-          document_output_language: config.document_output_language !== 'Chinese' ? config.document_output_language : undefined,
-        },
-        skip: false,
-      },
-    },
-    {
-      id: 'install-rules',
-      fn: _deps.installRules || installRules,
-      opts: {
-        targetDir,
-        rulesConfig: registry.rules,
-        skip: false,
-        forceRefresh: true,
-      },
-    },
-    {
-      id: 'install-skills',
-      fn: _deps.installSkills || installSkills,
-      opts: { targetDir, skills: registry.skills || [], skip: false },
-    },
-    {
-      id: 'install-mcp',
-      fn: _deps.installMcp || installMcp,
-      opts: {
-        targetDir,
-        mcpConfig: registry.mcp,
-        skip: false,
-        forceOverwrite: opts.force || false,
-      },
-    },
-  ]
-
-  const report = await orchestrate(stepSpecs, logger)
-
-  // Update manifest
-  manifest.cckit.steps = serializeSteps(report.steps)
-  manifest.cckit.fileRegistry = {
-    ...(manifest.cckit.fileRegistry || {}),
-    ...report.fileRegistry,
-  }
-  manifest.cckit.lastUpdated = new Date().toISOString()
-
-  await writeManifest(targetDir, manifest)
-  logger.success('Update complete.')
-
-  return { applied: true, report }
-}
+/**
+ * update command — re-run orchestration to update installed components.
+ *
+ * Default behavior: apply mode (re-run all steps).
+ * --dry-run: show current manifest state only.
+ * --no-apply: check-only, update lastUpdated timestamp.
+ */
+
+import path from 'node:path'
+import chalk from 'chalk'
+import { loadRegistry, resolvePlugins, resolveModelId } from '../core/registry.js'
+import { DEFAULT_API_URL } from '../core/config.js'
+import { orchestrate } from '../core/orchestrator.js'
+import { readManifest, writeManifest, isLegacyManifest, serializeSteps } from '../utils/manifest.js'
+import { compareVersions } from '../utils/compare-versions.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'
+
+/**
+ * @param {object} opts
+ * @param {string} [opts.dir] - Target directory
+ * @param {boolean} [opts.dryRun] - Preview only
+ * @param {boolean} [opts.apply] - Apply updates (default: true)
+ * @param {boolean} [opts.force] - Force overwrite
+ * @param {boolean} [opts.debug] - Debug output
+ * @param {object} [_deps] - Injectable dependencies
+ * @returns {Promise<object>}
+ */
+export async function runUpdate(opts = {}, _deps = {}) {
+  const logger = _deps.logger || createLogger({ debug: opts.debug })
+  const targetDir = path.resolve(opts.dir || process.cwd())
+  const registry = _deps.registry || await loadRegistry()
+
+  const manifest = await readManifest(targetDir)
+
+  if (isLegacyManifest(manifest)) {
+    throw new Error(
+      'Legacy manifest detected (v1 module-based format). ' +
+      'Please run `cckit init` to reinstall with the new orchestration format.'
+    )
+  }
+
+  logger.banner('cckit update')
+
+  // Compare versions
+  const { needsUpdate, components } = compareVersions(manifest, registry)
+
+  // Show current step status with version info
+  const steps = manifest.cckit?.steps || []
+  const installedVersions = manifest.cckit?.config?.versions || {}
+
+  logger.info('')
+  logger.info(chalk.bold('Component Versions:'))
+  logger.info('')
+
+  for (const [stepId, info] of Object.entries(components)) {
+    const current = installedVersions[info.versionKey] || 'none'
+    const latest = info.latest
+    const needsUpdate = current !== latest
+
+    const status = needsUpdate
+      ? chalk.yellow(`update available (${current} -> ${latest})`)
+      : chalk.green('up to date')
+
+    logger.info(`  ${stepId}: ${status}`)
+  }
+
+  if (needsUpdate) {
+    logger.info('')
+    logger.info(chalk.yellow('  Some components have updates available.'))
+    logger.info(chalk.gray('  Run "cckit update" to apply updates.'))
+  }
+
+  if (opts.dryRun) {
+    logger.info('\n  (dry run - no changes made)')
+    return { dryRun: true, steps, needsUpdate, components }
+  }
+
+  if (opts.apply === false) {
+    // Check-only: update timestamp
+    manifest.cckit.lastUpdated = new Date().toISOString()
+    await writeManifest(targetDir, manifest)
+    logger.success('Check complete.')
+    return { checked: true, steps, needsUpdate, components }
+  }
+
+  // Show step status
+  logger.info('')
+  logger.info(chalk.bold('Step Status:'))
+  for (const step of steps) {
+    const status = step.skipped ? 'skipped' : step.success ? 'ok' : 'FAILED'
+    logger.info(`  ${step.stepId}: ${status}`)
+  }
+
+  if (!needsUpdate) {
+    logger.info('')
+    logger.success('All components are up to date. No update needed.')
+    return { applied: false, reason: 'already_up_to_date', needsUpdate: false }
+  }
+
+  // Apply mode: re-run orchestrator
+  const config = manifest.cckit?.config || {}
+  const plugins = resolvePlugins(registry, { plugins: config.plugins || 'default' })
+
+  // Resolve model for user settings
+  const userSettings = registry.userSettings || {}
+  const modelId = resolveModelId(userSettings, opts.model || config.model)
+
+  const stepSpecs = [
+    {
+      id: 'configure-user',
+      fn: _deps.configureUser || configureUser,
+      opts: {
+        apiUrl: opts.apiUrl || config.apiUrl || userSettings.apiUrl || DEFAULT_API_URL,
+        apiKey: opts.apiKey,
+        forceApiKey: opts.forceApiKey,
+        modelId,
+        modelEnvKeys: userSettings.modelEnvKeys || [],
+        yes: true, // update mode is non-interactive by default
+        skip: false,
+      },
+    },
+    {
+      id: 'enable-plugins',
+      fn: _deps.enablePlugins || enablePlugins,
+      opts: { targetDir, plugins, skip: false },
+    },
+    {
+      id: 'install-bmad',
+      fn: _deps.installBmad || installBmad,
+      opts: {
+        targetDir,
+        bmadConfig: registry.bmad,
+        // Pass saved config values only if they differ from BMAD defaults (Chinese)
+        config: {
+          communication_language: config.communication_language !== 'Chinese' ? config.communication_language : undefined,
+          document_output_language: config.document_output_language !== 'Chinese' ? config.document_output_language : undefined,
+        },
+        skip: false,
+      },
+    },
+    {
+      id: 'install-rules',
+      fn: _deps.installRules || installRules,
+      opts: {
+        targetDir,
+        rulesConfig: registry.rules,
+        skip: false,
+        forceRefresh: true,
+      },
+    },
+    {
+      id: 'install-skills',
+      fn: _deps.installSkills || installSkills,
+      opts: { targetDir, skills: registry.skills || [], skip: false },
+    },
+    {
+      id: 'install-mcp',
+      fn: _deps.installMcp || installMcp,
+      opts: {
+        targetDir,
+        mcpConfig: registry.mcp,
+        skip: false,
+        forceOverwrite: opts.force || false,
+      },
+    },
+  ]
+
+  const report = await orchestrate(stepSpecs, logger)
+
+  // Update manifest with new versions
+  manifest.cckit.config.versions = {
+    ...(manifest.cckit.config.versions || {}),
+    ...registry.versions,
+  }
+  manifest.cckit.steps = serializeSteps(report.steps)
+  manifest.cckit.fileRegistry = {
+    ...(manifest.cckit.fileRegistry || {}),
+    ...report.fileRegistry,
+  }
+  manifest.cckit.lastUpdated = new Date().toISOString()
+
+  await writeManifest(targetDir, manifest)
+  logger.success('Update complete.')
+
+  return { applied: true, report }
+}

package/src/core/config.js

@@ -1,74 +1,82 @@
-const LANG_MAP = {
-  ts: 'typescript', typescript: 'typescript',
-  py: 'python', python: 'python',
-  go: 'golang', golang: 'golang'
-}
-
-export const VERSION = '0.5.0'
-
-export const DEFAULT_API_URL = 'https://gateway.cregis.ai'
-
-export const DEFAULT_CONFIG = {
-  user_name: 'User',
-  communication_language: 'Chinese',
-  document_output_language: 'Chinese',
-  languages: ['typescript', 'python', 'golang'],
-  plugins: 'default',
-  excludeGroups: []
-}
-
-/**
- * Merge CLI flags into a config object, falling back to DEFAULT_CONFIG.
- *
- * Supported flags:
- *   userName              - Override user_name
- *   communicationLanguage - Override communication_language
- *   docLanguage           - Override document_output_language
- *   lang                  - Comma-separated language aliases (ts,py,go)
- *   bmad                  - Set to false to add "bmad" to excludeGroups
- *   ecc                   - Set to false to add "ecc" to excludeGroups
- *   mcp                   - Set to false to add "mcp" to excludeGroups
- *   plugins               - "default", "none", or comma-separated plugin IDs
- *   skills                - Set to false to skip skill installation
- *
- * @param {object} [flags={}] - CLI flags parsed by commander
- * @returns {object} Merged config
- */
-export function mergeConfig(flags = {}) {
-  const config = { ...DEFAULT_CONFIG, excludeGroups: [] }
-
-  if (flags.userName) config.user_name = flags.userName
-  if (flags.communicationLanguage) config.communication_language = flags.communicationLanguage
-  if (flags.docLanguage) config.document_output_language = flags.docLanguage
-
-  if (flags.lang) {
-    config.languages = flags.lang
-      .split(',')
-      .map(l => LANG_MAP[l.trim().toLowerCase()])
-      .filter(Boolean)
-  }
-
-  if (flags.bmad === false) config.excludeGroups.push('bmad')
-  if (flags.ecc === false) config.excludeGroups.push('ecc')
-  if (flags.mcp === false) config.excludeGroups.push('mcp')
-
-  if (flags.plugins === false) {
-    config.plugins = 'none'
-  } else if (typeof flags.plugins === 'string') {
-    config.plugins = flags.plugins === 'default' || flags.plugins === 'none'
-      ? flags.plugins
-      : flags.plugins.split(',').map(p => p.trim())
-  }
-
-  if (flags.skills === false) {
-    config.skipSkills = true
-  }
-
-  // User-level settings
-  if (flags.apiUrl) config.apiUrl = flags.apiUrl
-  if (flags.apiKey) config.apiKey = flags.apiKey
-  if (flags.forceApiKey) config.forceApiKey = true
-  if (flags.model) config.model = flags.model
-
-  return config
-}
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'node:path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const pkg = JSON.parse(readFileSync(resolve(__dirname, '../../package.json'), 'utf-8'))
+
+const LANG_MAP = {
+  ts: 'typescript', typescript: 'typescript',
+  py: 'python', python: 'python',
+  go: 'golang', golang: 'golang'
+}
+
+export const VERSION = pkg.version
+
+export const DEFAULT_API_URL = 'https://gateway.cregis.ai'
+
+export const DEFAULT_CONFIG = {
+  user_name: 'User',
+  communication_language: 'Chinese',
+  document_output_language: 'Chinese',
+  languages: ['typescript', 'python', 'golang'],
+  plugins: 'default',
+  cliPlugins: true,  // Use Claude CLI for project-scoped plugins
+  excludeGroups: []
+}
+
+/**
+ * Merge CLI flags into a config object, falling back to DEFAULT_CONFIG.
+ *
+ * Supported flags:
+ *   userName              - Override user_name
+ *   communicationLanguage - Override communication_language
+ *   docLanguage           - Override document_output_language
+ *   lang                  - Comma-separated language aliases (ts,py,go)
+ *   bmad                  - Set to false to add "bmad" to excludeGroups
+ *   ecc                   - Set to false to add "ecc" to excludeGroups
+ *   mcp                   - Set to false to add "mcp" to excludeGroups
+ *   plugins               - "default", "none", or comma-separated plugin IDs
+ *   skills                - Set to false to skip skill installation
+ *
+ * @param {object} [flags={}] - CLI flags parsed by commander
+ * @returns {object} Merged config
+ */
+export function mergeConfig(flags = {}) {
+  const config = { ...DEFAULT_CONFIG, excludeGroups: [] }
+
+  if (flags.userName) config.user_name = flags.userName
+  if (flags.communicationLanguage) config.communication_language = flags.communicationLanguage
+  if (flags.docLanguage) config.document_output_language = flags.docLanguage
+
+  if (flags.lang) {
+    config.languages = flags.lang
+      .split(',')
+      .map(l => LANG_MAP[l.trim().toLowerCase()])
+      .filter(Boolean)
+  }
+
+  if (flags.bmad === false) config.excludeGroups.push('bmad')
+  if (flags.ecc === false) config.excludeGroups.push('ecc')
+  if (flags.mcp === false) config.excludeGroups.push('mcp')
+
+  if (flags.plugins === false) {
+    config.plugins = 'none'
+  } else if (typeof flags.plugins === 'string') {
+    config.plugins = flags.plugins === 'default' || flags.plugins === 'none'
+      ? flags.plugins
+      : flags.plugins.split(',').map(p => p.trim())
+  }
+
+  if (flags.skills === false) {
+    config.skipSkills = true
+  }
+
+  // User-level settings
+  if (flags.apiUrl) config.apiUrl = flags.apiUrl
+  if (flags.apiKey) config.apiKey = flags.apiKey
+  if (flags.forceApiKey) config.forceApiKey = true
+  if (flags.model) config.model = flags.model
+
+  return config
+}