chati-dev 2.0.4 → 2.0.6

package/src/config/mcp-configs.js

@@ -2,11 +2,13 @@
  * MCP Registry and Configuration
  * Defines available MCPs and their agent dependencies
  */
+
+export const DEFAULT_MCPS = ['context7', 'browser'];
+
 export const MCP_CONFIGS = {
   browser: {
     name: 'Browser (Playwright)',
     description: 'Web automation and testing',
-    defaultSelected: true,
     requiresEnv: [],
     claudeConfig: {
       command: 'npx',
@@ -16,104 +18,33 @@ export const MCP_CONFIGS = {
   context7: {
     name: 'Context7',
     description: 'Library documentation search',
-    defaultSelected: true,
     requiresEnv: [],
     claudeConfig: {
       command: 'npx',
       args: ['-y', '@context7/mcp'],
     },
   },
-  exa: {
-    name: 'Exa',
-    description: 'Advanced web search',
-    defaultSelected: true,
-    requiresEnv: ['EXA_API_KEY'],
-    claudeConfig: {
-      command: 'npx',
-      args: ['-y', '@exa/mcp'],
-      env: { EXA_API_KEY: '${EXA_API_KEY}' },
-    },
-  },
-  'desktop-commander': {
-    name: 'Desktop Commander',
-    description: 'File system access',
-    defaultSelected: false,
-    requiresEnv: [],
-    claudeConfig: {
-      command: 'npx',
-      args: ['-y', '@anthropic/desktop-commander-mcp'],
-    },
-  },
-  'sequential-thinking': {
-    name: 'Sequential Thinking',
-    description: 'Step-by-step reasoning',
-    defaultSelected: false,
-    requiresEnv: [],
-    claudeConfig: {
-      command: 'npx',
-      args: ['-y', '@anthropic/sequential-thinking-mcp'],
-    },
-  },
-  github: {
-    name: 'GitHub',
-    description: 'GitHub API integration',
-    defaultSelected: false,
-    requiresEnv: ['GITHUB_TOKEN'],
-    claudeConfig: {
-      command: 'npx',
-      args: ['-y', '@anthropic/github-mcp'],
-      env: { GITHUB_TOKEN: '${GITHUB_TOKEN}' },
-    },
-  },
 };
 
 /**
  * Agent-MCP dependency matrix
  */
 export const AGENT_MCP_DEPS = {
-  orchestrator:       { required: [],                    optional: ['git'] },
-  'greenfield-wu':    { required: [],                    optional: [] },
-  'brownfield-wu':    { required: ['git'],               optional: ['browser'] },
-  brief:              { required: [],                    optional: [] },
-  detail:             { required: [],                    optional: ['exa'] },
-  architect:          { required: ['context7'],          optional: ['exa', 'git'] },
-  ux:                 { required: [],                    optional: ['browser'] },
-  phases:             { required: [],                    optional: [] },
-  tasks:              { required: [],                    optional: [] },
-  'qa-planning':      { required: [],                    optional: [] },
-  dev:                { required: ['context7', 'git'],   optional: ['browser', 'coderabbit'] },
-  'qa-implementation':{ required: ['git'],               optional: ['browser', 'coderabbit'] },
-  devops:             { required: ['git', 'github'],     optional: [] },
+  orchestrator:        { required: [],            optional: [] },
+  'greenfield-wu':     { required: [],            optional: [] },
+  'brownfield-wu':     { required: [],            optional: ['browser'] },
+  brief:               { required: [],            optional: [] },
+  detail:              { required: [],            optional: [] },
+  architect:           { required: ['context7'],  optional: [] },
+  ux:                  { required: [],            optional: ['browser'] },
+  phases:              { required: [],            optional: [] },
+  tasks:               { required: [],            optional: [] },
+  'qa-planning':       { required: [],            optional: [] },
+  dev:                 { required: ['context7'],  optional: ['browser'] },
+  'qa-implementation': { required: [],            optional: ['browser'] },
+  devops:              { required: [],            optional: [] },
 };
 
-/**
- * Get list of MCPs for selection prompt
- */
-export function getMCPChoices() {
-  return Object.entries(MCP_CONFIGS).map(([key, config]) => ({
-    value: key,
-    label: config.name,
-    hint: config.description,
-    initialValue: config.defaultSelected,
-  }));
-}
-
-/**
- * Check MCP warnings for selected project type and MCPs
- */
-export function getMCPWarnings(projectType, selectedMCPs) {
-  const warnings = [];
-
-  if (projectType === 'brownfield' && !selectedMCPs.includes('git')) {
-    warnings.push({
-      level: 'critical',
-      message: "You selected Brownfield but did not enable 'git' MCP. The brownfield-wu agent requires git for codebase analysis.",
-    });
-  }
-
-  return warnings;
-}
-
 /**
  * Generate MCP config for Claude Code (.claude/mcp.json)
  */

package/src/context/engine.js

@@ -23,7 +23,7 @@ const LAYER_TIMEOUT_MS = 100;
  * @param {object} input
  * @param {string} input.domainsDir - Path to chati.dev/domains/
  * @param {number} input.remainingPercent - Context window remaining (0-100)
- * @param {string} [input.mode] - Current mode (clarity, build, deploy)
+ * @param {string} [input.mode] - Current mode (planning, build, deploy)
  * @param {string} [input.agent] - Active agent name
  * @param {string} [input.workflow] - Active workflow name
  * @param {string} [input.pipelinePosition] - Current pipeline step
@@ -43,7 +43,7 @@ export function runPrism(input) {
   // 2. Build context for layer processors
   const ctx = {
     domainsDir: input.domainsDir,
-    mode: input.mode || 'clarity',
+    mode: input.mode || 'planning',
     bracket: bracket.bracket,
     agent: input.agent || null,
     workflow: input.workflow || null,

package/src/context/layers/l1-global.js

@@ -2,7 +2,7 @@
  * L1 Global Layer — ALWAYS active.
  *
  * Loads global rules: coding standards, bracket-specific behavioral rules,
- * mode governance constraints (clarity/build/deploy).
+ * mode governance constraints (planning/build/deploy).
  */
 
 import { loadGlobalDomain, extractRules } from '../domain-loader.js';
@@ -11,14 +11,14 @@ import { loadGlobalDomain, extractRules } from '../domain-loader.js';
  * Process L1: load global rules + mode governance.
  * @param {object} ctx - Pipeline context
  * @param {string} ctx.domainsDir - Path to chati.dev/domains/
- * @param {string} ctx.mode - Current mode (clarity, build, deploy)
+ * @param {string} ctx.mode - Current mode (planning, build, deploy)
  * @param {string} ctx.bracket - Current bracket (FRESH, MODERATE, etc.)
  * @returns {{ layer: string, rules: Array, mode: string, modeRules: object }}
  */
 export function processL1(ctx) {
   const domain = loadGlobalDomain(ctx.domainsDir);
   const rules = extractRules(domain);
-  const mode = ctx.mode || 'clarity';
+  const mode = ctx.mode || 'planning';
 
   const modeRules = domain?.modes?.[mode] || {};
   const bracketRules = domain?.brackets?.[ctx.bracket] || {};

package/src/dashboard/layout.js

@@ -21,7 +21,7 @@ function formatScore(score, status) {
  */
 function formatState(state) {
   const stateMap = {
-    clarity: brand('CLARITY'),
+    planning: brand('PLANNING'),
     build: yellow('BUILD'),
     validate: bold('VALIDATE'),
     deploy: green('DEPLOY'),
@@ -73,12 +73,12 @@ export function buildProjectInfo(data) {
 }
 
 /**
- * Build CLARITY section with agent scores
+ * Build PLANNING section with agent scores
  */
-export function buildClaritySection(data) {
+export function buildPlanningSection(data) {
   const scores = data.agentScores || {};
 
-  const clarityAgents = [
+  const planningAgents = [
     ['WU', scores['greenfield-wu'] || scores['brownfield-wu'] || { status: 'pending', score: 0 }],
     ['Brief', scores['brief'] || { status: 'pending', score: 0 }],
     ['Detail', scores['detail'] || { status: 'pending', score: 0 }],
@@ -89,16 +89,16 @@ export function buildClaritySection(data) {
     ['QA-P', scores['qa-planning'] || { status: 'pending', score: 0 }],
   ];
 
-  const row1 = clarityAgents.slice(0, 4)
+  const row1 = planningAgents.slice(0, 4)
     .map(([name, info]) => `${dim(name.padEnd(8))} ${formatScore(info.score, info.status)}`)
     .join('  ');
 
-  const row2 = clarityAgents.slice(4)
+  const row2 = planningAgents.slice(4)
     .map(([name, info]) => `${dim(name.padEnd(8))} ${formatScore(info.score, info.status)}`)
     .join('  ');
 
   return [
-    brand('│') + `  ${brand('── CLARITY')} ${'─'.repeat(46)}` + brand('│'),
+    brand('│') + `  ${brand('── PLANNING')} ${'─'.repeat(46)}` + brand('│'),
     brand('│') + `  │ ${row1}` + ' '.repeat(5) + brand('│'),
     brand('│') + `  │ ${row2}` + ' '.repeat(5) + brand('│'),
     brand('│') + `  ${'─'.repeat(57)}` + brand('│'),

package/src/dashboard/renderer.js

@@ -2,7 +2,7 @@ import { readDashboardData } from './data-reader.js';
 import {
   buildHeader,
   buildProjectInfo,
-  buildClaritySection,
+  buildPlanningSection,
   buildBuildSection,
   buildValidateSection,
   buildIntelligenceSection,
@@ -25,7 +25,7 @@ export async function renderDashboard(targetDir) {
     ...buildHeader(data),
     ...buildProjectInfo(data),
     '',
-    ...buildClaritySection(data),
+    ...buildPlanningSection(data),
     '',
     ...buildBuildSection(data),
     '',

package/src/gates/g1-planning-complete.js

@@ -1,7 +1,7 @@
 /**
  * @fileoverview G1 — Planning Complete Gate
  *
- * Pre-BUILD gate that validates the CLARITY phase is fully completed.
+ * Pre-BUILD gate that validates the PLANNING phase is fully completed.
  * Checks that all required artifacts exist and QA-Planning has approved.
  */
 
@@ -31,7 +31,7 @@ export class PlanningCompleteGate extends GateBase {
   }
 
   /**
-   * Collect evidence by checking filesystem for CLARITY artifacts.
+   * Collect evidence by checking filesystem for PLANNING artifacts.
    *
    * @param {string} projectDir
    * @returns {object} Evidence about artifact presence, session state, and handoff
@@ -99,7 +99,7 @@ export class PlanningCompleteGate extends GateBase {
     const allCriteria = [
       ...REQUIRED_ARTIFACTS.map(a => `${a.label} exists`),
       'QA-Planning handoff with passing score',
-      'Session shows clarity completed',
+      'Session shows planning completed',
     ];
 
     const criteriaResults = [];
@@ -130,16 +130,16 @@ export class PlanningCompleteGate extends GateBase {
 
     // Check session state
     if (evidence.sessionState) {
-      const clarityAgents = ['brief', 'detail', 'architect', 'ux', 'phases', 'tasks', 'qa-planning'];
-      const completed = clarityAgents.filter(a =>
+      const planningAgents = ['brief', 'detail', 'architect', 'ux', 'phases', 'tasks', 'qa-planning'];
+      const completed = planningAgents.filter(a =>
         evidence.sessionState.completedAgents.includes(a)
       );
 
-      if (completed.length === clarityAgents.length) {
-        criteriaResults.push('Session shows clarity completed');
+      if (completed.length === planningAgents.length) {
+        criteriaResults.push('Session shows planning completed');
       } else {
-        const missing = clarityAgents.filter(a => !completed.includes(a));
-        warnings.push(`Incomplete clarity agents: ${missing.join(', ')}`);
+        const missing = planningAgents.filter(a => !completed.includes(a));
+        warnings.push(`Incomplete planning agents: ${missing.join(', ')}`);
       }
     }
 

package/src/installer/core.js

@@ -34,7 +34,7 @@ export async function installFramework(config) {
   // Copy framework structure
   const frameworkDirs = [
     'orchestrator',
-    'agents/clarity', 'agents/quality', 'agents/build', 'agents/deploy',
+    'agents/planning', 'agents/quality', 'agents/build', 'agents/deploy',
     'templates', 'workflows', 'quality-gates',
     'schemas', 'frameworks', 'intelligence', 'patterns',
     'hooks', 'domains', 'domains/agents', 'domains/workflows',
@@ -120,15 +120,15 @@ function copyFrameworkFiles(destDir) {
   const filesToCopy = [
     'constitution.md',
     'orchestrator/chati.md',
-    // CLARITY agents
-    'agents/clarity/greenfield-wu.md',
-    'agents/clarity/brownfield-wu.md',
-    'agents/clarity/brief.md',
-    'agents/clarity/detail.md',
-    'agents/clarity/architect.md',
-    'agents/clarity/ux.md',
-    'agents/clarity/phases.md',
-    'agents/clarity/tasks.md',
+    // PLANNING agents
+    'agents/planning/greenfield-wu.md',
+    'agents/planning/brownfield-wu.md',
+    'agents/planning/brief.md',
+    'agents/planning/detail.md',
+    'agents/planning/architect.md',
+    'agents/planning/ux.md',
+    'agents/planning/phases.md',
+    'agents/planning/tasks.md',
     // Quality agents
     'agents/quality/qa-planning.md',
     'agents/quality/qa-implementation.md',
@@ -297,7 +297,7 @@ Read it to understand routing, session management, and agent activation.
 Governance rules are in \`chati.dev/constitution.md\` (10 Articles).
 
 ## Agents
-- CLARITY: chati.dev/agents/clarity/ (8 agents)
+- PLANNING: chati.dev/agents/planning/ (8 agents)
 - Quality: chati.dev/agents/quality/ (2 agents)
 - BUILD: chati.dev/agents/build/ (1 agent)
 - DEPLOY: chati.dev/agents/deploy/ (1 agent)

package/src/installer/templates.js

@@ -10,7 +10,7 @@ export function generateSessionYaml(config) {
     project: {
       name: projectName,
       type: projectType,
-      state: 'clarity',
+      state: 'planning',
     },
     execution_mode: 'interactive',
     current_agent: '',

package/src/installer/validator.js

@@ -24,14 +24,14 @@ export async function validateInstallation(targetDir) {
   // Check all 13 agents (orchestrator + 12 specialized)
   const agentFiles = [
     'orchestrator/chati.md',
-    'agents/clarity/greenfield-wu.md',
-    'agents/clarity/brownfield-wu.md',
-    'agents/clarity/brief.md',
-    'agents/clarity/detail.md',
-    'agents/clarity/architect.md',
-    'agents/clarity/ux.md',
-    'agents/clarity/phases.md',
-    'agents/clarity/tasks.md',
+    'agents/planning/greenfield-wu.md',
+    'agents/planning/brownfield-wu.md',
+    'agents/planning/brief.md',
+    'agents/planning/detail.md',
+    'agents/planning/architect.md',
+    'agents/planning/ux.md',
+    'agents/planning/phases.md',
+    'agents/planning/tasks.md',
     'agents/quality/qa-planning.md',
     'agents/quality/qa-implementation.md',
     'agents/build/dev.md',

package/src/intelligence/registry-manager.js

@@ -140,10 +140,10 @@ export function runHealthCheck(targetDir) {
   // 4. Agent check
   const agentPaths = [
     'orchestrator/chati.md',
-    'agents/clarity/greenfield-wu.md', 'agents/clarity/brownfield-wu.md',
-    'agents/clarity/brief.md', 'agents/clarity/detail.md',
-    'agents/clarity/architect.md', 'agents/clarity/ux.md',
-    'agents/clarity/phases.md', 'agents/clarity/tasks.md',
+    'agents/planning/greenfield-wu.md', 'agents/planning/brownfield-wu.md',
+    'agents/planning/brief.md', 'agents/planning/detail.md',
+    'agents/planning/architect.md', 'agents/planning/ux.md',
+    'agents/planning/phases.md', 'agents/planning/tasks.md',
     'agents/quality/qa-planning.md', 'agents/quality/qa-implementation.md',
     'agents/build/dev.md', 'agents/deploy/devops.md',
   ];

package/src/memory/session-digest.js

@@ -19,7 +19,7 @@ export function buildSessionDigest(projectDir, sessionState) {
     timestamp,
     date: dateStr,
     project: sessionState.project || {},
-    mode: sessionState.mode || 'clarity',
+    mode: sessionState.mode || 'planning',
     pipeline: sessionState.pipeline || {},
     agents: {},
     summary: {},

package/src/orchestrator/agent-selector.js

@@ -9,15 +9,15 @@ import { INTENT_TYPES } from './intent-classifier.js';
  * The complete agent pipeline in execution order.
  */
 export const AGENT_PIPELINE = [
-  { name: 'greenfield-wu', phase: 'clarity', group: 'wu', parallel: false },
-  { name: 'brownfield-wu', phase: 'clarity', group: 'wu', parallel: false },
-  { name: 'brief', phase: 'clarity', group: 'clarity', parallel: false },
-  { name: 'detail', phase: 'clarity', group: 'clarity-parallel', parallel: true },
-  { name: 'architect', phase: 'clarity', group: 'clarity-parallel', parallel: true },
-  { name: 'ux', phase: 'clarity', group: 'clarity-parallel', parallel: true },
-  { name: 'phases', phase: 'clarity', group: 'clarity', parallel: false },
-  { name: 'tasks', phase: 'clarity', group: 'clarity', parallel: false },
-  { name: 'qa-planning', phase: 'clarity', group: 'quality', parallel: false },
+  { name: 'greenfield-wu', phase: 'planning', group: 'wu', parallel: false },
+  { name: 'brownfield-wu', phase: 'planning', group: 'wu', parallel: false },
+  { name: 'brief', phase: 'planning', group: 'planning', parallel: false },
+  { name: 'detail', phase: 'planning', group: 'planning-parallel', parallel: true },
+  { name: 'architect', phase: 'planning', group: 'planning-parallel', parallel: true },
+  { name: 'ux', phase: 'planning', group: 'planning-parallel', parallel: true },
+  { name: 'phases', phase: 'planning', group: 'planning', parallel: false },
+  { name: 'tasks', phase: 'planning', group: 'planning', parallel: false },
+  { name: 'qa-planning', phase: 'planning', group: 'quality', parallel: false },
   { name: 'dev', phase: 'build', group: 'build', parallel: false },
   { name: 'qa-implementation', phase: 'build', group: 'quality', parallel: false },
   { name: 'devops', phase: 'deploy', group: 'deploy', parallel: false },
@@ -58,7 +58,7 @@ function getAgentsByGroup(group) {
  *
  * @param {object} context
  * @param {string} context.intent - Classified intent
- * @param {string} context.mode - Current mode (clarity/build/deploy)
+ * @param {string} context.mode - Current mode (planning/build/deploy)
  * @param {string} [context.currentAgent] - Currently active agent
  * @param {string[]} [context.completedAgents] - Already completed agents
  * @param {boolean} [context.isGreenfield] - true for new projects, false for existing

package/src/orchestrator/intent-classifier.js

@@ -83,7 +83,7 @@ const WEIGHTS = {
  * Context boost multipliers based on current mode.
  */
 const MODE_CONTEXT_BOOST = {
-  clarity: {
+  planning: {
     [INTENT_TYPES.PLANNING]: 1.5,
     [INTENT_TYPES.IMPLEMENTATION]: 0.5,
   },
@@ -198,11 +198,11 @@ function buildReasoning(intent, keywords, context) {
  * Get intent-to-phase mapping.
  *
  * @param {string} intent
- * @returns {string} Target phase (clarity, build, deploy)
+ * @returns {string} Target phase (planning, build, deploy)
  */
 export function getIntentPhase(intent) {
   const phaseMap = {
-    [INTENT_TYPES.PLANNING]: 'clarity',
+    [INTENT_TYPES.PLANNING]: 'planning',
     [INTENT_TYPES.IMPLEMENTATION]: 'build',
     [INTENT_TYPES.REVIEW]: 'build',
     [INTENT_TYPES.DEPLOY]: 'deploy',
@@ -243,7 +243,7 @@ export function checkModeAlignment(intent, currentMode) {
   }
 
   // Check if mode change is allowed
-  const modeOrder = ['clarity', 'build', 'deploy'];
+  const modeOrder = ['planning', 'build', 'deploy'];
   const currentIndex = modeOrder.indexOf(currentMode);
   const targetIndex = modeOrder.indexOf(targetPhase);
 

package/src/orchestrator/pipeline-manager.js

@@ -8,7 +8,7 @@ import { AGENT_PIPELINE, getNextAgent } from './agent-selector.js';
 /**
  * Pipeline phases in order.
  */
-export const PIPELINE_PHASES = ['clarity', 'build', 'deploy'];
+export const PIPELINE_PHASES = ['planning', 'build', 'deploy'];
 
 /**
  * Agent status values.
@@ -35,7 +35,7 @@ const QA_IMPLEMENTATION_THRESHOLD = 90;
  * @returns {object} Pipeline state
  */
 export function initPipeline(options = {}) {
-  const { isGreenfield = true, mode = 'clarity' } = options;
+  const { isGreenfield = true, mode = 'planning' } = options;
 
   const agents = {};
   for (const agentDef of AGENT_PIPELINE) {
@@ -257,7 +257,7 @@ export function checkPhaseTransition(pipelineState) {
   const { phase, agents } = pipelineState;
 
   // Check based on current phase
-  if (phase === 'clarity') {
+  if (phase === 'planning') {
     // Need QA-Planning to be completed with score >= 95
     const qaPlanning = agents['qa-planning'];
     if (!qaPlanning) {

package/src/orchestrator/pipeline-state.js

@@ -44,7 +44,7 @@ export function loadPipelineState(projectDir) {
 
     // Extract pipeline-relevant fields
     const state = {
-      phase: session.mode || 'clarity',
+      phase: session.mode || 'planning',
       isGreenfield: session.project_type === 'greenfield',
       startedAt: session.started_at || null,
       completedAt: session.completed_at || null,

package/src/orchestrator/session-manager.js

@@ -16,7 +16,7 @@ const SESSION_FILE = '.chati/session.yaml';
  */
 const DEFAULT_SESSION = {
   version: '1.0',
-  mode: 'clarity',
+  mode: 'planning',
   language: 'en',
   project_type: 'greenfield',
   started_at: null,
@@ -65,7 +65,7 @@ export function initSession(projectDir, options = {}) {
 
   const session = {
     ...DEFAULT_SESSION,
-    mode: options.mode || 'clarity',
+    mode: options.mode || 'planning',
     language: options.language || 'en',
     project_type: options.isGreenfield === false ? 'brownfield' : 'greenfield',
     started_at: new Date().toISOString(),
@@ -383,7 +383,7 @@ export function validateSession(projectDir) {
   }
 
   // Validate mode
-  const validModes = ['clarity', 'build', 'validate', 'deploy', 'completed'];
+  const validModes = ['planning', 'build', 'validate', 'deploy', 'completed'];
   if (!validModes.includes(session.mode)) {
     return {
       exists: true,

package/src/tasks/executor.js

@@ -186,7 +186,7 @@ function sanitizeSessionState(state) {
   if (!state) return null;
 
   return {
-    mode: state.mode || 'clarity',
+    mode: state.mode || 'planning',
     current_agent: state.current_agent || null,
     pipeline_position: state.pipeline_position || null,
     completed_agents: state.completed_agents || [],

package/src/tasks/loader.js

@@ -59,7 +59,7 @@ export function parseTaskContent(content, source = 'unknown') {
         id: meta.id,
         agent: meta.agent,
         trigger: meta.trigger || 'orchestrator',
-        phase: meta.phase || 'clarity',
+        phase: meta.phase || 'planning',
         requires_input: meta.requires_input === true || meta.requires_input === 'true',
         parallelizable: meta.parallelizable === true || meta.parallelizable === 'true',
         outputs: parseArray(meta.outputs),