mindforge-cc 9.0.0 → 10.0.0

package/.agent/bin/lib/config.cjs

@@ -1,421 +0,0 @@
-/**
- * Config — Planning config CRUD operations
- */
-
-const fs = require('fs');
-const path = require('path');
-const { output, error, planningRoot } = require('./core.cjs');
-const {
-  VALID_PROFILES,
-  getAgentToModelMapForProfile,
-  formatAgentToModelMapAsTable,
-} = require('./model-profiles.cjs');
-
-const VALID_CONFIG_KEYS = new Set([
-  'mode', 'granularity', 'parallelization', 'commit_docs', 'model_profile',
-  'search_gitignored', 'brave_search', 'firecrawl', 'exa_search',
-  'workflow.research', 'workflow.plan_check', 'workflow.verifier',
-  'workflow.nyquist_validation', 'workflow.ui_phase', 'workflow.ui_safety_gate',
-  'workflow.auto_advance', 'workflow.node_repair', 'workflow.node_repair_budget',
-  'workflow.text_mode',
-  'workflow.research_before_questions',
-  'workflow.discuss_mode',
-  'workflow.skip_discuss',
-  'workflow._auto_chain_active',
-  'git.branching_strategy', 'git.phase_branch_template', 'git.milestone_branch_template', 'git.quick_branch_template',
-  'planning.commit_docs', 'planning.search_gitignored',
-  'hooks.context_warnings',
-]);
-
-const CONFIG_KEY_SUGGESTIONS = {
-  'workflow.nyquist_validation_enabled': 'workflow.nyquist_validation',
-  'agents.nyquist_validation_enabled': 'workflow.nyquist_validation',
-  'nyquist.validation_enabled': 'workflow.nyquist_validation',
-  'hooks.research_questions': 'workflow.research_before_questions',
-  'workflow.research_questions': 'workflow.research_before_questions',
-};
-
-function validateKnownConfigKeyPath(keyPath) {
-  const suggested = CONFIG_KEY_SUGGESTIONS[keyPath];
-  if (suggested) {
-    error(`Unknown config key: ${keyPath}. Did you mean ${suggested}?`);
-  }
-}
-
-/**
- * Build a fully-materialized config object for a new project.
- *
- * Merges (increasing priority):
- *   1. Hardcoded defaults — every key that loadConfig() resolves, plus mode/granularity
- *   2. User-level defaults from ~/.mindforge/defaults.json (if present)
- *   3. userChoices — the settings the user explicitly selected during /mindforge-new-project
- *
- * Uses the canonical `git` namespace for branching keys (consistent with VALID_CONFIG_KEYS
- * and the settings workflow). loadConfig() handles both flat and nested formats, so this
- * is backward-compatible with existing projects that have flat keys.
- *
- * Returns a plain object — does NOT write any files.
- */
-function buildNewProjectConfig(userChoices) {
-  const choices = userChoices || {};
-  const homedir = require('os').homedir();
-
-  // Detect API key availability
-  const braveKeyFile = path.join(homedir, '.mindforge', 'brave_api_key');
-  const hasBraveSearch = !!(process.env.BRAVE_API_KEY || fs.existsSync(braveKeyFile));
-  const firecrawlKeyFile = path.join(homedir, '.mindforge', 'firecrawl_api_key');
-  const hasFirecrawl = !!(process.env.FIRECRAWL_API_KEY || fs.existsSync(firecrawlKeyFile));
-  const exaKeyFile = path.join(homedir, '.mindforge', 'exa_api_key');
-  const hasExaSearch = !!(process.env.EXA_API_KEY || fs.existsSync(exaKeyFile));
-
-  // Load user-level defaults from ~/.mindforge/defaults.json if available
-  const globalDefaultsPath = path.join(homedir, '.mindforge', 'defaults.json');
-  let userDefaults = {};
-  try {
-    if (fs.existsSync(globalDefaultsPath)) {
-      userDefaults = JSON.parse(fs.readFileSync(globalDefaultsPath, 'utf-8'));
-      // Migrate deprecated "depth" key to "granularity"
-      if ('depth' in userDefaults && !('granularity' in userDefaults)) {
-        const depthToGranularity = { quick: 'coarse', standard: 'standard', comprehensive: 'fine' };
-        userDefaults.granularity = depthToGranularity[userDefaults.depth] || userDefaults.depth;
-        delete userDefaults.depth;
-        try {
-          fs.writeFileSync(globalDefaultsPath, JSON.stringify(userDefaults, null, 2), 'utf-8');
-        } catch { /* intentionally empty */ }
-      }
-    }
-  } catch {
-    // Ignore malformed global defaults
-  }
-
-  const hardcoded = {
-    model_profile: 'balanced',
-    commit_docs: true,
-    parallelization: true,
-    search_gitignored: false,
-    brave_search: hasBraveSearch,
-    firecrawl: hasFirecrawl,
-    exa_search: hasExaSearch,
-    git: {
-      branching_strategy: 'none',
-      phase_branch_template: 'mindforge/phase-{phase}-{slug}',
-      milestone_branch_template: 'mindforge/{milestone}-{slug}',
-      quick_branch_template: null,
-    },
-    workflow: {
-      research: true,
-      plan_check: true,
-      verifier: true,
-      nyquist_validation: true,
-      auto_advance: false,
-      node_repair: true,
-      node_repair_budget: 2,
-      ui_phase: true,
-      ui_safety_gate: true,
-      text_mode: false,
-      research_before_questions: false,
-      discuss_mode: 'discuss',
-      skip_discuss: false,
-    },
-    hooks: {
-      context_warnings: true,
-    },
-  };
-
-  // Three-level deep merge: hardcoded <- userDefaults <- choices
-  return {
-    ...hardcoded,
-    ...userDefaults,
-    ...choices,
-    git: {
-      ...hardcoded.git,
-      ...(userDefaults.git || {}),
-      ...(choices.git || {}),
-    },
-    workflow: {
-      ...hardcoded.workflow,
-      ...(userDefaults.workflow || {}),
-      ...(choices.workflow || {}),
-    },
-    hooks: {
-      ...hardcoded.hooks,
-      ...(userDefaults.hooks || {}),
-      ...(choices.hooks || {}),
-    },
-  };
-}
-
-/**
- * Command: create a fully-materialized .planning/config.json for a new project.
- *
- * Accepts user-chosen settings as a JSON string (the keys the user explicitly
- * configured during /mindforge-new-project). All remaining keys are filled from
- * hardcoded defaults and optional ~/.mindforge/defaults.json.
- *
- * Idempotent: if config.json already exists, returns { created: false }.
- */
-function cmdConfigNewProject(cwd, choicesJson, raw) {
-  const planningBase = planningRoot(cwd);
-  const configPath = path.join(planningBase, 'config.json');
-
-  // Idempotent: don't overwrite existing config
-  if (fs.existsSync(configPath)) {
-    output({ created: false, reason: 'already_exists' }, raw, 'exists');
-    return;
-  }
-
-  // Parse user choices
-  let userChoices = {};
-  if (choicesJson && choicesJson.trim() !== '') {
-    try {
-      userChoices = JSON.parse(choicesJson);
-    } catch (err) {
-      error('Invalid JSON for config-new-project: ' + err.message);
-    }
-  }
-
-  // Ensure .planning directory exists
-  try {
-    if (!fs.existsSync(planningBase)) {
-      fs.mkdirSync(planningBase, { recursive: true });
-    }
-  } catch (err) {
-    error('Failed to create .planning directory: ' + err.message);
-  }
-
-  const config = buildNewProjectConfig(userChoices);
-
-  try {
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
-    output({ created: true, path: '.planning/config.json' }, raw, 'created');
-  } catch (err) {
-    error('Failed to write config.json: ' + err.message);
-  }
-}
-
-/**
- * Ensures the config file exists (creates it if needed).
- *
- * Does not call `output()`, so can be used as one step in a command without triggering `exit(0)` in
- * the happy path. But note that `error()` will still `exit(1)` out of the process.
- */
-function ensureConfigFile(cwd) {
-  const planningBase = planningRoot(cwd);
-  const configPath = path.join(planningBase, 'config.json');
-
-  // Ensure .planning directory exists
-  try {
-    if (!fs.existsSync(planningBase)) {
-      fs.mkdirSync(planningBase, { recursive: true });
-    }
-  } catch (err) {
-    error('Failed to create .planning directory: ' + err.message);
-  }
-
-  // Check if config already exists
-  if (fs.existsSync(configPath)) {
-    return { created: false, reason: 'already_exists' };
-  }
-
-  const config = buildNewProjectConfig({});
-
-  try {
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
-    return { created: true, path: '.planning/config.json' };
-  } catch (err) {
-    error('Failed to create config.json: ' + err.message);
-  }
-}
-
-/**
- * Command to ensure the config file exists (creates it if needed).
- *
- * Note that this exits the process (via `output()`) even in the happy path; use
- * `ensureConfigFile()` directly if you need to avoid this.
- */
-function cmdConfigEnsureSection(cwd, raw) {
-  const ensureConfigFileResult = ensureConfigFile(cwd);
-  if (ensureConfigFileResult.created) {
-    output(ensureConfigFileResult, raw, 'created');
-  } else {
-    output(ensureConfigFileResult, raw, 'exists');
-  }
-}
-
-/**
- * Sets a value in the config file, allowing nested values via dot notation (e.g.,
- * "workflow.research").
- *
- * Does not call `output()`, so can be used as one step in a command without triggering `exit(0)` in
- * the happy path. But note that `error()` will still `exit(1)` out of the process.
- */
-function setConfigValue(cwd, keyPath, parsedValue) {
-  const configPath = path.join(planningRoot(cwd), 'config.json');
-
-  // Load existing config or start with empty object
-  let config = {};
-  try {
-    if (fs.existsSync(configPath)) {
-      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    }
-  } catch (err) {
-    error('Failed to read config.json: ' + err.message);
-  }
-
-  // Set nested value using dot notation (e.g., "workflow.research")
-  const keys = keyPath.split('.');
-  let current = config;
-  for (let i = 0; i < keys.length - 1; i++) {
-    const key = keys[i];
-    if (current[key] === undefined || typeof current[key] !== 'object') {
-      current[key] = {};
-    }
-    current = current[key];
-  }
-  const previousValue = current[keys[keys.length - 1]]; // Capture previous value before overwriting
-  current[keys[keys.length - 1]] = parsedValue;
-
-  // Write back
-  try {
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
-    return { updated: true, key: keyPath, value: parsedValue, previousValue };
-  } catch (err) {
-    error('Failed to write config.json: ' + err.message);
-  }
-}
-
-/**
- * Command to set a value in the config file, allowing nested values via dot notation (e.g.,
- * "workflow.research").
- *
- * Note that this exits the process (via `output()`) even in the happy path; use `setConfigValue()`
- * directly if you need to avoid this.
- */
-function cmdConfigSet(cwd, keyPath, value, raw) {
-  if (!keyPath) {
-    error('Usage: config-set <key.path> <value>');
-  }
-
-  validateKnownConfigKeyPath(keyPath);
-
-  if (!VALID_CONFIG_KEYS.has(keyPath)) {
-    error(`Unknown config key: "${keyPath}". Valid keys: ${[...VALID_CONFIG_KEYS].sort().join(', ')}`);
-  }
-
-  // Parse value (handle booleans and numbers)
-  let parsedValue = value;
-  if (value === 'true') parsedValue = true;
-  else if (value === 'false') parsedValue = false;
-  else if (!isNaN(value) && value !== '') parsedValue = Number(value);
-
-  const setConfigValueResult = setConfigValue(cwd, keyPath, parsedValue);
-  output(setConfigValueResult, raw, `${keyPath}=${parsedValue}`);
-}
-
-function cmdConfigGet(cwd, keyPath, raw) {
-  const configPath = path.join(planningRoot(cwd), 'config.json');
-
-  if (!keyPath) {
-    error('Usage: config-get <key.path>');
-  }
-
-  let config = {};
-  try {
-    if (fs.existsSync(configPath)) {
-      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    } else {
-      error('No config.json found at ' + configPath);
-    }
-  } catch (err) {
-    if (err.message.startsWith('No config.json')) throw err;
-    error('Failed to read config.json: ' + err.message);
-  }
-
-  // Traverse dot-notation path (e.g., "workflow.auto_advance")
-  const keys = keyPath.split('.');
-  let current = config;
-  for (const key of keys) {
-    if (current === undefined || current === null || typeof current !== 'object') {
-      error(`Key not found: ${keyPath}`);
-    }
-    current = current[key];
-  }
-
-  if (current === undefined) {
-    error(`Key not found: ${keyPath}`);
-  }
-
-  output(current, raw, String(current));
-}
-
-/**
- * Command to set the model profile in the config file.
- *
- * Note that this exits the process (via `output()`) even in the happy path.
- */
-function cmdConfigSetModelProfile(cwd, profile, raw) {
-  if (!profile) {
-    error(`Usage: config-set-model-profile <${VALID_PROFILES.join('|')}>`);
-  }
-
-  const normalizedProfile = profile.toLowerCase().trim();
-  if (!VALID_PROFILES.includes(normalizedProfile)) {
-    error(`Invalid profile '${profile}'. Valid profiles: ${VALID_PROFILES.join(', ')}`);
-  }
-
-  // Ensure config exists (create if needed)
-  ensureConfigFile(cwd);
-
-  // Set the model profile in the config
-  const { previousValue } = setConfigValue(cwd, 'model_profile', normalizedProfile, raw);
-  const previousProfile = previousValue || 'balanced';
-
-  // Build result value / message and return
-  const agentToModelMap = getAgentToModelMapForProfile(normalizedProfile);
-  const result = {
-    updated: true,
-    profile: normalizedProfile,
-    previousProfile,
-    agentToModelMap,
-  };
-  const rawValue = getCmdConfigSetModelProfileResultMessage(
-    normalizedProfile,
-    previousProfile,
-    agentToModelMap
-  );
-  output(result, raw, rawValue);
-}
-
-/**
- * Returns the message to display for the result of the `config-set-model-profile` command when
- * displaying raw output.
- */
-function getCmdConfigSetModelProfileResultMessage(
-  normalizedProfile,
-  previousProfile,
-  agentToModelMap
-) {
-  const agentToModelTable = formatAgentToModelMapAsTable(agentToModelMap);
-  const didChange = previousProfile !== normalizedProfile;
-  const paragraphs = didChange
-    ? [
-        `✓ Model profile set to: ${normalizedProfile} (was: ${previousProfile})`,
-        'Agents will now use:',
-        agentToModelTable,
-        'Next spawned agents will use the new profile.',
-      ]
-    : [
-        `✓ Model profile is already set to: ${normalizedProfile}`,
-        'Agents are using:',
-        agentToModelTable,
-      ];
-  return paragraphs.join('\n\n');
-}
-
-module.exports = {
-  cmdConfigEnsureSection,
-  cmdConfigSet,
-  cmdConfigGet,
-  cmdConfigSetModelProfile,
-  cmdConfigNewProject,
-};