chati-dev 2.0.5 → 2.0.6

package/framework/workflows/brownfield-discovery.yaml

@@ -15,7 +15,7 @@ workflow:
 phases:
   - phase: 0
     name: Context Detection
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: context-detection
@@ -23,7 +23,7 @@ phases:
 
   - phase: 1
     name: Architecture Analysis
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: architecture-scout
@@ -31,7 +31,7 @@ phases:
 
   - phase: 2
     name: UX Analysis
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: ux-scout
@@ -39,7 +39,7 @@ phases:
 
   - phase: 3
     name: QA Analysis
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: qa-scout
@@ -47,7 +47,7 @@ phases:
 
   - phase: 4
     name: Integration Mapping
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: integration-mapping
@@ -55,7 +55,7 @@ phases:
 
   - phase: 5
     name: Technical Debt Assessment
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: tech-debt-assessment
@@ -63,7 +63,7 @@ phases:
 
   - phase: 6
     name: Synthesis
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: compile-report

package/framework/workflows/brownfield-fullstack.yaml

@@ -15,7 +15,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -26,7 +26,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -35,7 +35,7 @@ phases:
 
   - phase: 2
     name: Architecture Assessment
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: assess-architecture
@@ -47,7 +47,7 @@ phases:
 
   - phase: 3
     name: Product Specification
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: detail
         action: create-prd
@@ -61,7 +61,7 @@ phases:
 
   - phase: 4
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -73,7 +73,7 @@ phases:
 
   - phase: 5
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -99,7 +99,7 @@ phases:
         creates: [chati.dev/artifacts/8-Validation/deploy-report.md]
 
 transitions:
-  clarity_to_build:
+  planning_to_build:
     trigger: "qa-planning.score >= 95"
     type: automatic
     action: "Update project.state = build"
@@ -115,7 +115,7 @@ transitions:
     trigger: "devops.status == completed"
     type: automatic
     action: "Update project.state = completed"
-  backward_to_clarity:
+  backward_to_planning:
     trigger: "qa-implementation.issue_type in [spec, architecture]"
     type: backward
-    action: "Update project.state = clarity, route to responsible agent"
+    action: "Update project.state = planning, route to responsible agent"

package/framework/workflows/brownfield-service.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -24,7 +24,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -32,7 +32,7 @@ phases:
 
   - phase: 2
     name: Architecture & Specification
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: assess-architecture
@@ -45,7 +45,7 @@ phases:
 
   - phase: 3
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -56,7 +56,7 @@ phases:
 
   - phase: 4
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability

package/framework/workflows/brownfield-ui.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Deep Discovery
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brownfield-wu
         action: full-discovery
@@ -25,7 +25,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -33,7 +33,7 @@ phases:
 
   - phase: 2
     name: Architecture & Experience
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: assess-architecture
@@ -50,7 +50,7 @@ phases:
 
   - phase: 3
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -61,7 +61,7 @@ phases:
 
   - phase: 4
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability

package/framework/workflows/greenfield-fullstack.yaml

@@ -16,7 +16,7 @@ workflow:
 phases:
   - phase: 0
     name: Discovery
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: greenfield-wu
         action: operational-discovery
@@ -25,7 +25,7 @@ phases:
 
   - phase: 1
     name: Problem Definition
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: brief
         action: problem-extraction
@@ -34,7 +34,7 @@ phases:
 
   - phase: 2
     name: Product Specification
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: detail
         action: create-prd
@@ -44,7 +44,7 @@ phases:
 
   - phase: 3
     name: Technical Design
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: architect
         action: design-architecture
@@ -58,7 +58,7 @@ phases:
 
   - phase: 4
     name: Execution Planning
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: phases
         action: create-roadmap
@@ -72,7 +72,7 @@ phases:
 
   - phase: 5
     name: Planning Quality Gate
-    category: CLARITY
+    category: PLANNING
     sequence:
       - agent: qa-planning
         action: validate-traceability
@@ -103,7 +103,7 @@ phases:
         notes: "Git operations, deployment, documentation"
 
 transitions:
-  clarity_to_build:
+  planning_to_build:
     trigger: "qa-planning.score >= 95"
     type: automatic
     action: "Update project.state = build"
@@ -119,7 +119,7 @@ transitions:
     trigger: "devops.status == completed"
     type: automatic
     action: "Update project.state = completed"
-  backward_to_clarity:
+  backward_to_planning:
     trigger: "qa-implementation.issue_type in [spec, architecture]"
     type: backward
-    action: "Update project.state = clarity, route to responsible agent"
+    action: "Update project.state = planning, route to responsible agent"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chati-dev",
-  "version": "2.0.5",
-  "description": "AI-Powered Multi-Agent Orchestration System — 13 agents, 6 IDEs, 4 languages",
+  "version": "2.0.6",
+  "description": "AI-Powered Multi-Agent Orchestration System — Structured vibe coding for Full Stack Development",
   "type": "module",
   "bin": {
     "chati": "bin/chati.js",

package/scripts/bundle-framework.js

@@ -32,7 +32,7 @@ mkdirSync(DEST, { recursive: true });
 
 const dirs = [
   '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',

package/scripts/health-check.js

@@ -146,14 +146,14 @@ function checkAgents(frameworkDir) {
   const orchestratorDir = join(frameworkDir, 'orchestrator');
 
   const expectedAgents = {
-    'clarity/greenfield-wu.md': 'greenfield-wu',
-    'clarity/brownfield-wu.md': 'brownfield-wu',
-    'clarity/brief.md': 'brief',
-    'clarity/detail.md': 'detail',
-    'clarity/architect.md': 'architect',
-    'clarity/ux.md': 'ux',
-    'clarity/phases.md': 'phases',
-    'clarity/tasks.md': 'tasks',
+    'planning/greenfield-wu.md': 'greenfield-wu',
+    'planning/brownfield-wu.md': 'brownfield-wu',
+    'planning/brief.md': 'brief',
+    'planning/detail.md': 'detail',
+    'planning/architect.md': 'architect',
+    'planning/ux.md': 'ux',
+    'planning/phases.md': 'phases',
+    'planning/tasks.md': 'tasks',
     'quality/qa-planning.md': 'qa-planning',
     'quality/qa-implementation.md': 'qa-implementation',
     'build/dev.md': 'dev',

package/scripts/populate-entity-registry.js

@@ -161,7 +161,7 @@ function scanEntities(frameworkDir, relDir, category) {
 
     for (const entry of entries) {
       if (entry.isDirectory()) {
-        // Recurse into subdirectories (e.g., agents/clarity/, agents/build/)
+        // Recurse into subdirectories (e.g., agents/planning/, agents/build/)
         const subEntities = scanEntities(frameworkDir, join(relDir, entry.name), category);
         entities.push(...subEntities);
         continue;

package/scripts/validate-agents.js

@@ -19,7 +19,7 @@ import yaml from 'js-yaml';
  * Expected agents organized by category.
  */
 export const EXPECTED_AGENTS = {
-  clarity: ['greenfield-wu', 'brownfield-wu', 'brief', 'detail', 'architect', 'ux', 'phases', 'tasks'],
+  planning: ['greenfield-wu', 'brownfield-wu', 'brief', 'detail', 'architect', 'ux', 'phases', 'tasks'],
   quality: ['qa-planning', 'qa-implementation'],
   build: ['dev'],
   deploy: ['devops'],

package/scripts/validate-tasks.js

@@ -24,7 +24,7 @@ const REQUIRED_FIELDS = ['id', 'agent'];
 /**
  * Valid phase values.
  */
-const VALID_PHASES = ['clarity', 'build', 'deploy', 'validate', 'quality'];
+const VALID_PHASES = ['planning', 'build', 'deploy', 'validate', 'quality'];
 
 // ---------------------------------------------------------------------------
 // Internal Helpers

package/src/autonomy/autonomous-gate.js

@@ -16,7 +16,7 @@ export const GATE_RESULTS = {
 
 // Minimum passing scores per agent (conservative: 90 default)
 const GATE_THRESHOLDS = {
-  'qa-planning': 95,        // Highest — gates clarity→build transition
+  'qa-planning': 95,        // Highest — gates planning→build transition
   'qa-implementation': 90,  // Gates build→deploy transition
   'brief': 90,              // Requirements are critical
   'detail': 90,

package/src/autonomy/progress-reporter.js

@@ -35,7 +35,7 @@ export function buildProgressReport(pipelineState, options = {}) {
 
 /**
  * Format progress as a compact one-line status.
- * Example: "[CLARITY 3/8] brief ✅ → detail 🔄 (score: 92%)"
+ * Example: "[PLANNING 3/8] brief ✅ → detail 🔄 (score: 92%)"
  * @param {object} pipelineState
  * @returns {string}
  */
@@ -75,10 +75,10 @@ export function formatDetailedReport(pipelineState) {
   lines.push(`Stage: ${stage}`);
   lines.push('');
 
-  // CLARITY agents
-  lines.push('CLARITY:');
-  const clarityAgents = getStageAgents('CLARITY');
-  clarityAgents.forEach(agent => {
+  // PLANNING agents
+  lines.push('PLANNING:');
+  const planningAgents = getStageAgents('PLANNING');
+  planningAgents.forEach(agent => {
     const status = agentStatus[agent] || 'pending';
     const icon = getStatusIcon(status);
     const isActive = agent === pipelineState.current_agent;
@@ -146,7 +146,7 @@ export function calculateCompletion(pipelineState) {
  */
 function getStageAgents(stage) {
   const stages = {
-    CLARITY: [
+    PLANNING: [
       'greenfield-wu',
       'brownfield-wu',
       'brief',
@@ -170,7 +170,7 @@ function getStageAgents(stage) {
  */
 function getAllAgents() {
   return [
-    ...getStageAgents('CLARITY'),
+    ...getStageAgents('PLANNING'),
     ...getStageAgents('BUILD'),
     ...getStageAgents('DEPLOY'),
   ];
@@ -249,7 +249,7 @@ function countTotalAgents(_pipelineState) {
 /**
  * Get progress summary by stage.
  * @param {object} pipelineState
- * @returns {{ clarity: number, build: number, deploy: number }}
+ * @returns {{ planning: number, build: number, deploy: number }}
  */
 export function getStageProgress(pipelineState) {
   const agentStatus = pipelineState.agent_status || {};
@@ -261,7 +261,7 @@ export function getStageProgress(pipelineState) {
   };
 
   return {
-    clarity: getProgress('CLARITY'),
+    planning: getProgress('PLANNING'),
     build: getProgress('BUILD'),
     deploy: getProgress('DEPLOY'),
   };

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),
     '',