@cregis-dev/cckit 0.2.0 → 0.4.0

package/src/core/plugin-installer.js

@@ -10,6 +10,21 @@ import fse from 'fs-extra'
 import { listFiles, copyWithInterpolation, interpolate } from '../utils/fs.js'
 import { convertAgentForTrae, convertCommandForTrae } from '../adapters/trae-adapter.js'
 
+// ─── Claude Code Base Settings ──────────────────────────────────────────────
+
+/**
+ * Default environment overrides written to `.claude/settings.json`.
+ * These disable telemetry, error reporting, and the /bug command.
+ */
+const CLAUDE_CODE_ENV_DEFAULTS = {
+  DISABLE_BUG_COMMAND: '1',
+  DISABLE_ERROR_REPORTING: '1',
+  DISABLE_TELEMETRY: '1',
+  MCP_TIMEOUT: '60000',
+  MAX_THINKING_TOKENS: '31999',
+  CLAUDE_CODE_MAX_OUTPUT_TOKENS: '64000',
+}
+
 // ─── Plugin Resolution ──────────────────────────────────────────────────────
 
 /**
@@ -58,7 +73,12 @@ export function resolvePlugins(registry, pluginIds, templateBase, logger) {
 // ─── Claude Code Installation ───────────────────────────────────────────────
 
 /**
- * Install plugins for Claude Code by writing enabledPlugins to settings.json.
+ * Install plugins for Claude Code by writing enabledPlugins and
+ * extraKnownMarketplaces (for non-built-in marketplaces) to settings.json.
+ *
+ * Plugins with a `marketplaceSource` field in their registry definition will
+ * have their marketplace source added to `extraKnownMarketplaces`, enabling
+ * Claude Code to auto-prompt users for marketplace trust and plugin installation.
  *
  * @param {Array<{ id: string, def: object }>} plugins - Resolved plugins
  * @param {string} targetDir - Project root directory
@@ -82,24 +102,48 @@ export async function installForClaudeCode(plugins, targetDir, logger) {
   }
 
   const newPlugins = {}
+  const newMarketplaces = {}
+
   for (const { id, def } of plugins) {
     const key = `${id}@${def.marketplace}`
     newPlugins[key] = true
+
+    // Collect non-built-in marketplace sources (dedupe by marketplace name)
+    if (def.marketplaceSource && !newMarketplaces[def.marketplace]) {
+      newMarketplaces[def.marketplace] = { source: { ...def.marketplaceSource } }
+    }
   }
 
   const merged = {
     ...existing,
+    env: {
+      ...(existing.env || {}),
+      ...CLAUDE_CODE_ENV_DEFAULTS,
+    },
     enabledPlugins: {
       ...(existing.enabledPlugins || {}),
       ...newPlugins,
     },
   }
 
+  const enabledKeys = Object.keys(newPlugins)
+  const marketplaceNames = Object.keys(newMarketplaces)
+
+  // Only write extraKnownMarketplaces when there are non-built-in marketplaces
+  if (marketplaceNames.length > 0) {
+    merged.extraKnownMarketplaces = {
+      ...(existing.extraKnownMarketplaces || {}),
+      ...newMarketplaces,
+    }
+  }
+
   await fse.ensureDir(path.dirname(settingsPath))
   await fse.writeFile(settingsPath, JSON.stringify(merged, null, 2) + '\n', 'utf8')
 
-  const enabledKeys = Object.keys(newPlugins)
   logger.debug(`Claude Code: enabled ${enabledKeys.length} plugins in settings.json`)
+  if (marketplaceNames.length > 0) {
+    logger.debug(`Claude Code: registered ${marketplaceNames.length} extra marketplace(s): ${marketplaceNames.join(', ')}`)
+  }
   return enabledKeys
 }
 
@@ -206,32 +250,29 @@ export async function installForTrae(plugins, targetDir, variables, logger) {
 export async function installPlugins({ plugins, targetDir, ides, variables, logger }) {
   const result = { claudeCode: [], trae: { files: 0, details: [] }, installed: [] }
 
-  // Filter plugins whose template directories exist
-  const available = []
-  const missing = []
-  for (const p of plugins) {
-    if (await fse.pathExists(p.templateDir)) {
-      available.push(p)
-    } else {
-      logger.warn(`Plugin "${p.id}" template not found at ${p.templateDir}, skipping`)
-      missing.push(p.id)
-    }
-  }
-
-  if (available.length === 0) {
-    logger.debug('No plugin templates available, skipping plugin installation')
-    return result
-  }
-
+  // Claude Code: write settings.json (env defaults + plugin IDs + marketplace sources)
   if (ides.includes('claude-code')) {
-    result.claudeCode = await installForClaudeCode(available, targetDir, logger)
+    result.claudeCode = await installForClaudeCode(plugins, targetDir, logger)
   }
 
-  if (ides.includes('trae')) {
-    result.trae = await installForTrae(available, targetDir, variables, logger)
+  // Trae: extract content from plugins that have templates
+  if (ides.includes('trae') && plugins.length > 0) {
+    const available = []
+    for (const p of plugins) {
+      if (await fse.pathExists(p.templateDir)) {
+        available.push(p)
+      } else {
+        logger.warn(`Plugin "${p.id}" template not found at ${p.templateDir}, skipping Trae extraction`)
+      }
+    }
+
+    if (available.length > 0) {
+      result.trae = await installForTrae(available, targetDir, variables, logger)
+    }
   }
 
-  result.installed = available.map(p => p.id)
+  // Track all plugins as installed (settings.json counts even without templates)
+  result.installed = plugins.map(p => p.id)
   return result
 }
 

package/src/utils/fs.js

@@ -45,6 +45,11 @@ export async function computeFileHash(filePath) {
 
 export async function listFiles(dir) {
   const pattern = '**/*'
-  const files = await glob(pattern, { cwd: dir, nodir: true, dot: true })
+  const files = await glob(pattern, {
+    cwd: dir,
+    nodir: true,
+    dot: true,
+    ignore: ['**/.git/**'],
+  })
   return files
 }

package/templates/bmad/_config/bmad-help.csv

@@ -16,7 +16,7 @@ bmm,4-implementation,Sprint Status,SS,20,_bmad/bmm/workflows/4-implementation/sp
 bmm,4-implementation,Create Story,CS,30,_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml,bmad-bmm-create-story,true,sm,bmad:story preparation:agent:sm,Bob,🏃 Scrum Master,Create Mode,"Story cycle start: Prepare first found story in the sprint plan that is next, or if the command is run with a specific epic and story designation with context. Once complete, then VS then DS then CR then back to DS if needed or next CS or ER",implementation_artifacts,story
 bmm,4-implementation,Validate Story,VS,35,_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml,bmad-bmm-create-story,false,sm,bmad:story preparation:agent:sm,Bob,🏃 Scrum Master,Validate Mode,Validates story readiness and completeness before development work begins,implementation_artifacts,story validation report
 bmm,4-implementation,Dev Story,DS,40,_bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml,bmad-bmm-dev-story,true,dev,bmad:all precision.:agent:dev,Amelia,💻 Developer Agent,Create Mode,Story cycle: Execute story implementation tasks and tests then CR then back to DS if fixes needed,,
-bmm,4-implementation,QA Automation Test,QA,45,_bmad/bmm/workflows/qa/automate/workflow.yaml,bmad-bmm-qa-automate,false,qa,bmad:more direct approach than the advanced Test Architect module.:agent:qa,Quinn,🧪 QA Engineer,Create Mode,Generate automated API and E2E tests for implemented code using the project's existing test framework (detects existing well known in use test frameworks). Use after implementation to add test coverage. NOT for code review or story validation - use CR for that.,implementation_artifacts,test suite
+bmm,4-implementation,QA Automation Test,QA,45,_bmad/bmm/workflows/qa-generate-e2e-tests/workflow.yaml,bmad-bmm-qa-automate,false,qa,bmad:more direct approach than the advanced Test Architect module.:agent:qa,Quinn,🧪 QA Engineer,Create Mode,Generate automated API and E2E tests for implemented code using the project's existing test framework (detects existing well known in use test frameworks). Use after implementation to add test coverage. NOT for code review or story validation - use CR for that.,implementation_artifacts,test suite
 bmm,4-implementation,Code Review,CR,50,_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml,bmad-bmm-code-review,false,dev,bmad:all precision.:agent:dev,Amelia,💻 Developer Agent,Create Mode,Story cycle: If issues back to DS if approved then next CS or ER if epic complete,,
 bmm,4-implementation,Retrospective,ER,60,_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml,bmad-bmm-retrospective,false,sm,bmad:story preparation:agent:sm,Bob,🏃 Scrum Master,Create Mode,Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC,implementation_artifacts,retrospective
 bmm,anytime,Document Project,DP,,_bmad/bmm/workflows/document-project/workflow.yaml,bmad-bmm-document-project,false,analyst,bmad:competitive analysis:agent:analyst,Mary,📊 Business Analyst,Create Mode,Analyze an existing project to produce useful documentation,project-knowledge,*
@@ -37,6 +37,7 @@ core,anytime,Shard Document,SD,,_bmad/core/tasks/shard-doc.xml,bmad-shard-doc,fa
 core,anytime,Editorial Review - Prose,EP,,_bmad/core/tasks/editorial-review-prose.xml,bmad-editorial-review-prose,false,,,,,,"Review prose for clarity, tone, and communication issues. Use after drafting to polish written content.",report located with target document,three-column markdown table with suggested fixes
 core,anytime,Editorial Review - Structure,ES,,_bmad/core/tasks/editorial-review-structure.xml,bmad-editorial-review-structure,false,,,,,,"Propose cuts, reorganization, and simplification while preserving comprehension. Use when doc produced from multiple subprocesses or needs structural improvement.",report located with target document,
 core,anytime,Adversarial Review (General),AR,,_bmad/core/tasks/review-adversarial-general.xml,bmad-review-adversarial-general,false,,,,,,"Review content critically to find issues and weaknesses. Use for quality assurance or before finalizing deliverables. Code Review in other modules run this automatically, but its useful also for document reviews",,
+core,anytime,Edge Case Hunter Review,ECH,,_bmad/core/tasks/review-edge-case-hunter.xml,bmad-review-edge-case-hunter,false,,,,,,"Walk every branching path and boundary condition in code, report only unhandled edge cases. Use alongside adversarial review for orthogonal coverage - method-driven not attitude-driven.",,
 tea,0-learning,Teach Me Testing,TMT,10,_bmad/tea/workflows/testarch/teach-me-testing/workflow.md,bmad-tea-teach-me-testing,false,tea,bmad:backend services:agent:tea,Murat,🧪 Master Test Architect and Quality Advisor,Create Mode,Teach testing fundamentals through 7 sessions (TEA Academy),test_artifacts,progress file|session notes|certificate
 tea,3-solutioning,Test Design,TD,10,_bmad/tea/workflows/testarch/test-design/workflow.yaml,bmad-tea-testarch-test-design,false,tea,bmad:backend services:agent:tea,Murat,🧪 Master Test Architect and Quality Advisor,Create Mode,Risk-based test planning,test_artifacts,test design document
 tea,3-solutioning,Test Framework,TF,20,_bmad/tea/workflows/testarch/framework/workflow.yaml,bmad-tea-testarch-framework,false,tea,bmad:backend services:agent:tea,Murat,🧪 Master Test Architect and Quality Advisor,Create Mode,Initialize production-ready test framework,test_artifacts,framework scaffold