@cregis-dev/cckit 0.6.6 → 0.6.8

package/src/utils/compare-versions.js

@@ -1,106 +1,106 @@
-/**
- * Version comparison utilities for detecting configuration changes.
- *
- * Compares installed versions (from manifest) with registry versions
- * to determine which components need updating.
- */
-
-import { loadRegistry } from '../core/registry.js'
-
-/**
- * Component map: stepId -> version key in registry.versions
- */
-const COMPONENT_MAP = {
-  'configure-user': 'userSettings',
-  'enable-plugins': 'plugins',
-  'install-rules': 'rules',
-  'install-skills': 'skills',
-  'install-bmad': 'bmad',
-  'install-mcp': 'mcp',
-}
-
-/**
- * Compare installed versions against registry versions.
- *
- * @param {object} manifest - Installed manifest with config.versions
- * @param {object} registry - Current registry with versions
- * @returns {object} - { needsUpdate: boolean, components: { [stepId]: { current, latest, needsUpdate } } }
- */
-export function compareVersions(manifest, registry) {
-  const installedVersions = manifest.cckit?.config?.versions || {}
-  const latestVersions = registry.versions || {}
-
-  const components = {}
-  let needsUpdate = false
-
-  // Compare each component
-  for (const [stepId, versionKey] of Object.entries(COMPONENT_MAP)) {
-    const current = installedVersions[versionKey]
-    const latest = latestVersions[versionKey]
-
-    // If either version is missing, consider it needs update
-    const componentNeedsUpdate = !current || !latest || current !== latest
-
-    components[stepId] = {
-      versionKey,
-      current: current || 'none',
-      latest: latest || 'none',
-      needsUpdate: componentNeedsUpdate,
-    }
-
-    if (componentNeedsUpdate) {
-      needsUpdate = true
-    }
-  }
-
-  return { needsUpdate, components }
-}
-
-/**
- * Check if specific component needs update.
- *
- * @param {object} manifest - Installed manifest
- * @param {object} registry - Current registry
- * @param {string} stepId - Step ID to check
- * @returns {boolean}
- */
-export function needsComponentUpdate(manifest, registry, stepId) {
-  const versionKey = COMPONENT_MAP[stepId]
-  if (!versionKey) return false
-
-  const current = manifest.cckit?.config?.versions?.[versionKey]
-  const latest = registry.versions?.[versionKey]
-
-  return !current || !latest || current !== latest
-}
-
-/**
- * Get version info for a specific component.
- *
- * @param {object} registry - Current registry
- * @returns {object} - { plugins, rules, skills, bmad, mcp, userSettings }
- */
-export function getRegistryVersions(registry) {
-  return registry.versions || {}
-}
-
-/**
- * Load registry and compare versions (async).
- *
- * @param {string} targetDir - Project directory
- * @returns {Promise<{ needsUpdate: boolean, components: object }>}
- */
-export async function checkForUpdates(targetDir) {
-  const { readManifest } = await import('../utils/manifest.js')
-  const registry = await loadRegistry()
-
-  let manifest
-  try {
-    manifest = await readManifest(targetDir)
-  } catch {
-    // Not installed yet
-    return { needsUpdate: true, components: {}, notInstalled: true }
-  }
-
-  return compareVersions(manifest, registry)
-}
+/**
+ * Version comparison utilities for detecting configuration changes.
+ *
+ * Compares installed versions (from manifest) with registry versions
+ * to determine which components need updating.
+ */
+
+import { loadRegistry } from '../core/registry.js'
+
+/**
+ * Component map: stepId -> version key in registry.versions
+ */
+const COMPONENT_MAP = {
+  'configure-user': 'userSettings',
+  'enable-plugins': 'plugins',
+  'install-rules': 'rules',
+  'install-skills': 'skills',
+  'install-bmad': 'bmad',
+  'install-mcp': 'mcp',
+}
+
+/**
+ * Compare installed versions against registry versions.
+ *
+ * @param {object} manifest - Installed manifest with config.versions
+ * @param {object} registry - Current registry with versions
+ * @returns {object} - { needsUpdate: boolean, components: { [stepId]: { current, latest, needsUpdate } } }
+ */
+export function compareVersions(manifest, registry) {
+  const installedVersions = manifest.cckit?.config?.versions || {}
+  const latestVersions = registry.versions || {}
+
+  const components = {}
+  let needsUpdate = false
+
+  // Compare each component
+  for (const [stepId, versionKey] of Object.entries(COMPONENT_MAP)) {
+    const current = installedVersions[versionKey]
+    const latest = latestVersions[versionKey]
+
+    // If either version is missing, consider it needs update
+    const componentNeedsUpdate = !current || !latest || current !== latest
+
+    components[stepId] = {
+      versionKey,
+      current: current || 'none',
+      latest: latest || 'none',
+      needsUpdate: componentNeedsUpdate,
+    }
+
+    if (componentNeedsUpdate) {
+      needsUpdate = true
+    }
+  }
+
+  return { needsUpdate, components }
+}
+
+/**
+ * Check if specific component needs update.
+ *
+ * @param {object} manifest - Installed manifest
+ * @param {object} registry - Current registry
+ * @param {string} stepId - Step ID to check
+ * @returns {boolean}
+ */
+export function needsComponentUpdate(manifest, registry, stepId) {
+  const versionKey = COMPONENT_MAP[stepId]
+  if (!versionKey) return false
+
+  const current = manifest.cckit?.config?.versions?.[versionKey]
+  const latest = registry.versions?.[versionKey]
+
+  return !current || !latest || current !== latest
+}
+
+/**
+ * Get version info for a specific component.
+ *
+ * @param {object} registry - Current registry
+ * @returns {object} - { plugins, rules, skills, bmad, mcp, userSettings }
+ */
+export function getRegistryVersions(registry) {
+  return registry.versions || {}
+}
+
+/**
+ * Load registry and compare versions (async).
+ *
+ * @param {string} targetDir - Project directory
+ * @returns {Promise<{ needsUpdate: boolean, components: object }>}
+ */
+export async function checkForUpdates(targetDir) {
+  const { readManifest } = await import('../utils/manifest.js')
+  const registry = await loadRegistry()
+
+  let manifest
+  try {
+    manifest = await readManifest(targetDir)
+  } catch {
+    // Not installed yet
+    return { needsUpdate: true, components: {}, notInstalled: true }
+  }
+
+  return compareVersions(manifest, registry)
+}

package/src/utils/fs.js

@@ -1,33 +1,33 @@
-import fse from 'fs-extra'
-import path from 'node:path'
-import crypto from 'node:crypto'
-import { glob } from 'glob'
-
-/**
- * Compute SHA256 hash of a file.
- *
- * @param {string} filePath - Absolute path to file
- * @returns {Promise<string>} Hash in format "sha256:<hex>"
- */
-export async function computeFileHash(filePath) {
-  const content = await fse.readFile(filePath)
-  const hash = crypto.createHash('sha256').update(content).digest('hex')
-  return `sha256:${hash}`
-}
-
-/**
- * List all files in a directory recursively.
- *
- * @param {string} dir - Directory to scan
- * @returns {Promise<string[]>} Relative file paths
- */
-export async function listFiles(dir) {
-  const pattern = '**/*'
-  const files = await glob(pattern, {
-    cwd: dir,
-    nodir: true,
-    dot: true,
-    ignore: ['**/.git/**'],
-  })
-  return files
-}
+import fse from 'fs-extra'
+import path from 'node:path'
+import crypto from 'node:crypto'
+import { glob } from 'glob'
+
+/**
+ * Compute SHA256 hash of a file.
+ *
+ * @param {string} filePath - Absolute path to file
+ * @returns {Promise<string>} Hash in format "sha256:<hex>"
+ */
+export async function computeFileHash(filePath) {
+  const content = await fse.readFile(filePath)
+  const hash = crypto.createHash('sha256').update(content).digest('hex')
+  return `sha256:${hash}`
+}
+
+/**
+ * List all files in a directory recursively.
+ *
+ * @param {string} dir - Directory to scan
+ * @returns {Promise<string[]>} Relative file paths
+ */
+export async function listFiles(dir) {
+  const pattern = '**/*'
+  const files = await glob(pattern, {
+    cwd: dir,
+    nodir: true,
+    dot: true,
+    ignore: ['**/.git/**'],
+  })
+  return files
+}

package/src/utils/logger.js

@@ -1,16 +1,16 @@
-import chalk from 'chalk'
-
-export function createLogger(options = {}) {
-  const { write = (msg) => console.log(msg), debug: debugEnabled = false } = options
-
-  return {
-    info: (msg) => write(msg),
-    success: (msg) => write(chalk.green(`  \u2713 ${msg}`)),
-    error: (msg) => write(chalk.red(`  \u2717 ${msg}`)),
-    warn: (msg) => write(chalk.yellow(`  \u26A0 ${msg}`)),
-    debug: (msg) => { if (debugEnabled) write(chalk.gray(`  [debug] ${msg}`)) },
-    step: (current, total, msg) => write(chalk.blue(`  [${current}/${total}] ${msg}`)),
-    banner: (msg) => write(chalk.bold.green(`\n${msg}\n`)),
-    newline: () => write('')
-  }
-}
+import chalk from 'chalk'
+
+export function createLogger(options = {}) {
+  const { write = (msg) => console.log(msg), debug: debugEnabled = false } = options
+
+  return {
+    info: (msg) => write(msg),
+    success: (msg) => write(chalk.green(`  \u2713 ${msg}`)),
+    error: (msg) => write(chalk.red(`  \u2717 ${msg}`)),
+    warn: (msg) => write(chalk.yellow(`  \u26A0 ${msg}`)),
+    debug: (msg) => { if (debugEnabled) write(chalk.gray(`  [debug] ${msg}`)) },
+    step: (current, total, msg) => write(chalk.blue(`  [${current}/${total}] ${msg}`)),
+    banner: (msg) => write(chalk.bold.green(`\n${msg}\n`)),
+    newline: () => write('')
+  }
+}

package/src/utils/manifest.js

@@ -1,101 +1,101 @@
-/**
- * Manifest utilities — read/write the cckit installation manifest.
- *
- * Manifest lives at `_bmad/_config/manifest.yaml` and tracks:
- * - Installation config (user preferences)
- * - Step execution results
- * - File registry (SHA256 hashes for tracked files)
- */
-
-import path from 'node:path'
-import fse from 'fs-extra'
-import YAML from 'yaml'
-
-export const MANIFEST_REL = path.join('_bmad', '_config', 'manifest.yaml')
-
-/**
- * Read and parse the manifest from a project directory.
- *
- * @param {string} dir - Project root directory
- * @returns {Promise<object>} Parsed manifest object
- * @throws {Error} If manifest does not exist
- */
-export async function readManifest(dir) {
-  const manifestPath = path.join(path.resolve(dir), MANIFEST_REL)
-  try {
-    const content = await fse.readFile(manifestPath, 'utf8')
-    return YAML.parse(content)
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      throw new Error('cckit is not installed. Run `cckit init` first.')
-    }
-    throw err
-  }
-}
-
-/**
- * Write manifest to a project directory.
- *
- * @param {string} dir - Project root directory
- * @param {object} manifest - Manifest data to write
- * @returns {Promise<void>}
- */
-export async function writeManifest(dir, manifest) {
-  const manifestPath = path.join(path.resolve(dir), MANIFEST_REL)
-  await fse.ensureDir(path.dirname(manifestPath))
-  await fse.writeFile(manifestPath, YAML.stringify(manifest), 'utf8')
-}
-
-/**
- * Serialize step results for manifest storage.
- *
- * @param {Array<import('../core/orchestrator.js').StepResult>} steps
- * @returns {Array<object>}
- */
-export function serializeSteps(steps) {
-  return steps.map(s => ({
-    stepId: s.stepId,
-    success: s.success,
-    skipped: s.skipped || false,
-    ...(s.details ? { details: s.details } : {}),
-    ...(s.error ? { error: s.error } : {}),
-  }))
-}
-
-/**
- * Build a new manifest from orchestration results.
- *
- * @param {object} params
- * @param {object} params.config - Merged config
- * @param {import('../core/orchestrator.js').RunReport} params.report - Orchestration report
- * @param {string} params.version - cckit version
- * @param {object} [params.versions] - Component versions from registry
- * @returns {object} Manifest object
- */
-export function buildManifest({ config, report, version, versions = {} }) {
-  return {
-    cckit: {
-      version,
-      installedAt: new Date().toISOString(),
-      config: {
-        user_name: config.user_name,
-        communication_language: config.communication_language,
-        document_output_language: config.document_output_language,
-        languages: config.languages,
-        versions,
-      },
-      steps: serializeSteps(report.steps),
-      fileRegistry: report.fileRegistry,
-    }
-  }
-}
-
-/**
- * Check if a manifest uses the legacy v1 format (modules-based).
- *
- * @param {object} manifest - Parsed manifest
- * @returns {boolean}
- */
-export function isLegacyManifest(manifest) {
-  return !!(manifest.cckit?.modules) && !manifest.cckit?.steps
-}
+/**
+ * Manifest utilities — read/write the cckit installation manifest.
+ *
+ * Manifest lives at `_bmad/_config/manifest.yaml` and tracks:
+ * - Installation config (user preferences)
+ * - Step execution results
+ * - File registry (SHA256 hashes for tracked files)
+ */
+
+import path from 'node:path'
+import fse from 'fs-extra'
+import YAML from 'yaml'
+
+export const MANIFEST_REL = path.join('_bmad', '_config', 'manifest.yaml')
+
+/**
+ * Read and parse the manifest from a project directory.
+ *
+ * @param {string} dir - Project root directory
+ * @returns {Promise<object>} Parsed manifest object
+ * @throws {Error} If manifest does not exist
+ */
+export async function readManifest(dir) {
+  const manifestPath = path.join(path.resolve(dir), MANIFEST_REL)
+  try {
+    const content = await fse.readFile(manifestPath, 'utf8')
+    return YAML.parse(content)
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      throw new Error('cckit is not installed. Run `cckit init` first.')
+    }
+    throw err
+  }
+}
+
+/**
+ * Write manifest to a project directory.
+ *
+ * @param {string} dir - Project root directory
+ * @param {object} manifest - Manifest data to write
+ * @returns {Promise<void>}
+ */
+export async function writeManifest(dir, manifest) {
+  const manifestPath = path.join(path.resolve(dir), MANIFEST_REL)
+  await fse.ensureDir(path.dirname(manifestPath))
+  await fse.writeFile(manifestPath, YAML.stringify(manifest), 'utf8')
+}
+
+/**
+ * Serialize step results for manifest storage.
+ *
+ * @param {Array<import('../core/orchestrator.js').StepResult>} steps
+ * @returns {Array<object>}
+ */
+export function serializeSteps(steps) {
+  return steps.map(s => ({
+    stepId: s.stepId,
+    success: s.success,
+    skipped: s.skipped || false,
+    ...(s.details ? { details: s.details } : {}),
+    ...(s.error ? { error: s.error } : {}),
+  }))
+}
+
+/**
+ * Build a new manifest from orchestration results.
+ *
+ * @param {object} params
+ * @param {object} params.config - Merged config
+ * @param {import('../core/orchestrator.js').RunReport} params.report - Orchestration report
+ * @param {string} params.version - cckit version
+ * @param {object} [params.versions] - Component versions from registry
+ * @returns {object} Manifest object
+ */
+export function buildManifest({ config, report, version, versions = {} }) {
+  return {
+    cckit: {
+      version,
+      installedAt: new Date().toISOString(),
+      config: {
+        user_name: config.user_name,
+        communication_language: config.communication_language,
+        document_output_language: config.document_output_language,
+        languages: config.languages,
+        versions,
+      },
+      steps: serializeSteps(report.steps),
+      fileRegistry: report.fileRegistry,
+    }
+  }
+}
+
+/**
+ * Check if a manifest uses the legacy v1 format (modules-based).
+ *
+ * @param {object} manifest - Parsed manifest
+ * @returns {boolean}
+ */
+export function isLegacyManifest(manifest) {
+  return !!(manifest.cckit?.modules) && !manifest.cckit?.steps
+}

package/src/utils/prompt.js

@@ -1,41 +1,41 @@
-/**
- * Readline utility for interactive prompts.
- */
-
-import { createInterface } from 'node:readline'
-
-/**
- * Prompt user for input via readline.
- * Returns empty string if user presses Enter without typing.
- *
- * @param {string} question - Prompt text
- * @param {object} [_deps] - Injectable dependencies for testing
- * @param {object} [_deps.rl] - Mock readline interface
- * @returns {Promise<string>} User input (trimmed)
- */
-export function askQuestion(question, _deps = {}) {
-  const { rl: mockRl } = _deps
-
-  // If mock is provided, use it directly
-  if (mockRl) {
-    return new Promise((resolve) => {
-      mockRl.question(question, (answer) => {
-        mockRl.close()
-        resolve((answer == null ? '' : String(answer)).trim())
-      })
-    })
-  }
-
-  // Default: use real readline
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  })
-
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close()
-      resolve((answer == null ? '' : String(answer)).trim())
-    })
-  })
-}
+/**
+ * Readline utility for interactive prompts.
+ */
+
+import { createInterface } from 'node:readline'
+
+/**
+ * Prompt user for input via readline.
+ * Returns empty string if user presses Enter without typing.
+ *
+ * @param {string} question - Prompt text
+ * @param {object} [_deps] - Injectable dependencies for testing
+ * @param {object} [_deps.rl] - Mock readline interface
+ * @returns {Promise<string>} User input (trimmed)
+ */
+export function askQuestion(question, _deps = {}) {
+  const { rl: mockRl } = _deps
+
+  // If mock is provided, use it directly
+  if (mockRl) {
+    return new Promise((resolve) => {
+      mockRl.question(question, (answer) => {
+        mockRl.close()
+        resolve((answer == null ? '' : String(answer)).trim())
+      })
+    })
+  }
+
+  // Default: use real readline
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  })
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close()
+      resolve((answer == null ? '' : String(answer)).trim())
+    })
+  })
+}