@mobiman/vector 1.1.0

package/core/bin/lib/commands.d.cts

@@ -0,0 +1,23 @@
+export declare function cmdGenerateSlug(text: string | undefined, raw: boolean): void;
+export declare function cmdCurrentTimestamp(format: string | undefined, raw: boolean): void;
+export declare function cmdListTodos(cwd: string, area: string | undefined, raw: boolean): void;
+export declare function cmdVerifyPathExists(cwd: string, targetPath: string | undefined, raw: boolean): void;
+export declare function cmdHistoryDigest(cwd: string, raw: boolean): void;
+export declare function cmdResolveModel(cwd: string, agentType: string | undefined, raw: boolean): void;
+export declare function cmdCommit(cwd: string, message: string | undefined, files: string[] | undefined, raw: boolean, amend: boolean | undefined): void;
+export declare function cmdSummaryExtract(cwd: string, summaryPath: string | undefined, fields: string[] | undefined, raw: boolean): void;
+interface WebsearchOptions {
+    limit?: number;
+    freshness?: string;
+}
+export declare function cmdWebsearch(query: string | undefined, options: WebsearchOptions, raw: boolean): Promise<void>;
+export declare function cmdProgressRender(cwd: string, format: string | undefined, raw: boolean): void;
+export declare function cmdTodoComplete(cwd: string, filename: string | undefined, raw: boolean): void;
+interface ScaffoldOptions {
+    phase?: string;
+    name?: string;
+}
+export declare function cmdScaffold(cwd: string, type: string, options: ScaffoldOptions, raw: boolean): void;
+export declare function cmdStats(cwd: string, format: string | undefined, raw: boolean): void;
+export {};
+//# sourceMappingURL=commands.d.cts.map

package/core/bin/lib/commands.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.cts","sourceRoot":"","sources":["commands.cts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAY5E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAkBlF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAmCtF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAgBnG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6GhE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAc9F;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CA8C/I;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAsDhI;AAED,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DpH;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAiE7F;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAyB7F;AAED,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAyDnG;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6JpF"}

package/core/bin/lib/config.cjs

@@ -0,0 +1,281 @@
+"use strict";
+/**
+ * Config — Planning config CRUD operations
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureConfigFile = ensureConfigFile;
+exports.cmdConfigEnsureSection = cmdConfigEnsureSection;
+exports.setConfigValue = setConfigValue;
+exports.cmdConfigSet = cmdConfigSet;
+exports.cmdConfigGet = cmdConfigGet;
+exports.cmdConfigSetModelProfile = cmdConfigSetModelProfile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const core_cjs_1 = require("./core.cjs");
+const model_profiles_cjs_1 = require("./model-profiles.cjs");
+const VALID_CONFIG_KEYS = new Set([
+    'mode', 'granularity', 'parallelization', 'commit_docs', 'model_profile',
+    'search_gitignored', 'brave_search',
+    'workflow.research', 'workflow.plan_check', 'workflow.verifier',
+    'workflow.nyquist_validation', 'workflow.ui_phase', 'workflow.ui_safety_gate',
+    'workflow._auto_chain_active',
+    'git.branching_strategy', 'git.phase_branch_template', 'git.milestone_branch_template',
+    'planning.commit_docs', 'planning.search_gitignored',
+]);
+const CONFIG_KEY_SUGGESTIONS = {
+    'workflow.nyquist_validation_enabled': 'workflow.nyquist_validation',
+    'agents.nyquist_validation_enabled': 'workflow.nyquist_validation',
+    'nyquist.validation_enabled': 'workflow.nyquist_validation',
+};
+function validateKnownConfigKeyPath(keyPath) {
+    const suggested = CONFIG_KEY_SUGGESTIONS[keyPath];
+    if (suggested) {
+        (0, core_cjs_1.error)(`Unknown config key: ${keyPath}. Did you mean ${suggested}?`);
+    }
+}
+/**
+ * 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 configPath = path_1.default.join(cwd, '.planning', 'config.json');
+    const planningDir = path_1.default.join(cwd, '.planning');
+    // Ensure .planning directory exists
+    try {
+        if (!fs_1.default.existsSync(planningDir)) {
+            fs_1.default.mkdirSync(planningDir, { recursive: true });
+        }
+    }
+    catch (err) {
+        (0, core_cjs_1.error)('Failed to create .planning directory: ' + err.message);
+    }
+    // Check if config already exists
+    if (fs_1.default.existsSync(configPath)) {
+        return { created: false, reason: 'already_exists' };
+    }
+    // Detect Brave Search API key availability
+    const homedir = os_1.default.homedir();
+    const braveKeyFile = path_1.default.join(homedir, '.vector', 'brave_api_key');
+    const hasBraveSearch = !!(process.env.BRAVE_API_KEY || fs_1.default.existsSync(braveKeyFile));
+    // Load user-level defaults from ~/.vector/defaults.json if available
+    const globalDefaultsPath = path_1.default.join(homedir, '.vector', 'defaults.json');
+    let userDefaults = {};
+    try {
+        if (fs_1.default.existsSync(globalDefaultsPath)) {
+            userDefaults = JSON.parse(fs_1.default.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_1.default.writeFileSync(globalDefaultsPath, JSON.stringify(userDefaults, null, 2), 'utf-8');
+                }
+                catch { }
+            }
+        }
+    }
+    catch (_err) {
+        // Ignore malformed global defaults, fall back to hardcoded
+    }
+    // Create default config (user-level defaults override hardcoded defaults)
+    const hardcoded = {
+        model_profile: 'balanced',
+        commit_docs: true,
+        search_gitignored: false,
+        branching_strategy: 'none',
+        phase_branch_template: 'vector/phase-{phase}-{slug}',
+        milestone_branch_template: 'vector/{milestone}-{slug}',
+        workflow: {
+            research: true,
+            plan_check: true,
+            verifier: true,
+            nyquist_validation: true,
+        },
+        parallelization: true,
+        brave_search: hasBraveSearch,
+    };
+    const defaults = {
+        ...hardcoded,
+        ...userDefaults,
+        workflow: { ...hardcoded.workflow, ...(userDefaults.workflow || {}) },
+    };
+    try {
+        fs_1.default.writeFileSync(configPath, JSON.stringify(defaults, null, 2), 'utf-8');
+        return { created: true, path: '.planning/config.json' };
+    }
+    catch (err) {
+        (0, core_cjs_1.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) {
+        (0, core_cjs_1.output)(ensureConfigFileResult, raw, 'created');
+    }
+    else {
+        (0, core_cjs_1.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_1.default.join(cwd, '.planning', 'config.json');
+    // Load existing config or start with empty object
+    let config = {};
+    try {
+        if (fs_1.default.existsSync(configPath)) {
+            config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
+        }
+    }
+    catch (err) {
+        (0, core_cjs_1.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_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        return { updated: true, key: keyPath, value: parsedValue, previousValue };
+    }
+    catch (err) {
+        (0, core_cjs_1.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) {
+        (0, core_cjs_1.error)('Usage: config-set <key.path> <value>');
+    }
+    validateKnownConfigKeyPath(keyPath);
+    if (!VALID_CONFIG_KEYS.has(keyPath)) {
+        (0, core_cjs_1.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 (value !== undefined && !isNaN(Number(value)) && value !== '')
+        parsedValue = Number(value);
+    const setConfigValueResult = setConfigValue(cwd, keyPath, parsedValue);
+    (0, core_cjs_1.output)(setConfigValueResult, raw, `${keyPath}=${parsedValue}`);
+}
+function cmdConfigGet(cwd, keyPath, raw) {
+    const configPath = path_1.default.join(cwd, '.planning', 'config.json');
+    if (!keyPath) {
+        (0, core_cjs_1.error)('Usage: config-get <key.path>');
+    }
+    let config = {};
+    try {
+        if (fs_1.default.existsSync(configPath)) {
+            config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
+        }
+        else {
+            (0, core_cjs_1.error)('No config.json found at ' + configPath);
+        }
+    }
+    catch (err) {
+        if (err.message.startsWith('No config.json'))
+            throw err;
+        (0, core_cjs_1.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') {
+            (0, core_cjs_1.error)(`Key not found: ${keyPath}`);
+        }
+        current = current[key];
+    }
+    if (current === undefined) {
+        (0, core_cjs_1.error)(`Key not found: ${keyPath}`);
+    }
+    (0, core_cjs_1.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) {
+        (0, core_cjs_1.error)(`Usage: config-set-model-profile <${model_profiles_cjs_1.VALID_PROFILES.join('|')}>`);
+    }
+    const normalizedProfile = profile.toLowerCase().trim();
+    if (!model_profiles_cjs_1.VALID_PROFILES.includes(normalizedProfile)) {
+        (0, core_cjs_1.error)(`Invalid profile '${profile}'. Valid profiles: ${model_profiles_cjs_1.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);
+    const previousProfile = previousValue || 'balanced';
+    // Build result value / message and return
+    const agentToModelMap = (0, model_profiles_cjs_1.getAgentToModelMapForProfile)(normalizedProfile);
+    const result = {
+        updated: true,
+        profile: normalizedProfile,
+        previousProfile,
+        agentToModelMap,
+    };
+    const rawValue = getCmdConfigSetModelProfileResultMessage(normalizedProfile, previousProfile, agentToModelMap);
+    (0, core_cjs_1.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 = (0, model_profiles_cjs_1.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');
+}
+//# sourceMappingURL=config.cjs.map

package/core/bin/lib/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.cjs","sourceRoot":"","sources":["config.cts"],"names":[],"mappings":"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"}

package/core/bin/lib/config.cts

@@ -0,0 +1,301 @@
+/**
+ * Config — Planning config CRUD operations
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { output, error } from './core.cjs';
+import {
+  VALID_PROFILES,
+  getAgentToModelMapForProfile,
+  formatAgentToModelMapAsTable,
+} from './model-profiles.cjs';
+
+const VALID_CONFIG_KEYS = new Set([
+  'mode', 'granularity', 'parallelization', 'commit_docs', 'model_profile',
+  'search_gitignored', 'brave_search',
+  'workflow.research', 'workflow.plan_check', 'workflow.verifier',
+  'workflow.nyquist_validation', 'workflow.ui_phase', 'workflow.ui_safety_gate',
+  'workflow._auto_chain_active',
+  'git.branching_strategy', 'git.phase_branch_template', 'git.milestone_branch_template',
+  'planning.commit_docs', 'planning.search_gitignored',
+]);
+
+const CONFIG_KEY_SUGGESTIONS: Record<string, string> = {
+  'workflow.nyquist_validation_enabled': 'workflow.nyquist_validation',
+  'agents.nyquist_validation_enabled': 'workflow.nyquist_validation',
+  'nyquist.validation_enabled': 'workflow.nyquist_validation',
+};
+
+function validateKnownConfigKeyPath(keyPath: string): void {
+  const suggested = CONFIG_KEY_SUGGESTIONS[keyPath];
+  if (suggested) {
+    error(`Unknown config key: ${keyPath}. Did you mean ${suggested}?`);
+  }
+}
+
+/**
+ * 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.
+ */
+export function ensureConfigFile(cwd: string): { created: boolean; reason?: string; path?: string } {
+  const configPath = path.join(cwd, '.planning', 'config.json');
+  const planningDir = path.join(cwd, '.planning');
+
+  // Ensure .planning directory exists
+  try {
+    if (!fs.existsSync(planningDir)) {
+      fs.mkdirSync(planningDir, { recursive: true });
+    }
+  } catch (err) {
+    error('Failed to create .planning directory: ' + (err as Error).message);
+  }
+
+  // Check if config already exists
+  if (fs.existsSync(configPath)) {
+    return { created: false, reason: 'already_exists' };
+  }
+
+  // Detect Brave Search API key availability
+  const homedir = os.homedir();
+  const braveKeyFile = path.join(homedir, '.vector', 'brave_api_key');
+  const hasBraveSearch = !!(process.env.BRAVE_API_KEY || fs.existsSync(braveKeyFile));
+
+  // Load user-level defaults from ~/.vector/defaults.json if available
+  const globalDefaultsPath = path.join(homedir, '.vector', 'defaults.json');
+  let userDefaults: Record<string, unknown> = {};
+  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: Record<string, string> = { quick: 'coarse', standard: 'standard', comprehensive: 'fine' };
+        userDefaults.granularity = depthToGranularity[userDefaults.depth as string] || userDefaults.depth;
+        delete userDefaults.depth;
+        try {
+          fs.writeFileSync(globalDefaultsPath, JSON.stringify(userDefaults, null, 2), 'utf-8');
+        } catch {}
+      }
+    }
+  } catch (_err) {
+    // Ignore malformed global defaults, fall back to hardcoded
+  }
+
+  // Create default config (user-level defaults override hardcoded defaults)
+  const hardcoded = {
+    model_profile: 'balanced',
+    commit_docs: true,
+    search_gitignored: false,
+    branching_strategy: 'none',
+    phase_branch_template: 'vector/phase-{phase}-{slug}',
+    milestone_branch_template: 'vector/{milestone}-{slug}',
+    workflow: {
+      research: true,
+      plan_check: true,
+      verifier: true,
+      nyquist_validation: true,
+    },
+    parallelization: true,
+    brave_search: hasBraveSearch,
+  };
+  const defaults = {
+    ...hardcoded,
+    ...userDefaults,
+    workflow: { ...hardcoded.workflow, ...((userDefaults.workflow as Record<string, unknown>) || {}) },
+  };
+
+  try {
+    fs.writeFileSync(configPath, JSON.stringify(defaults, null, 2), 'utf-8');
+    return { created: true, path: '.planning/config.json' };
+  } catch (err) {
+    error('Failed to create config.json: ' + (err as Error).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.
+ */
+export function cmdConfigEnsureSection(cwd: string, raw: boolean): void {
+  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.
+ */
+export function setConfigValue(cwd: string, keyPath: string, parsedValue: unknown): { updated: boolean; key: string; value: unknown; previousValue: unknown } {
+  const configPath = path.join(cwd, '.planning', 'config.json');
+
+  // Load existing config or start with empty object
+  let config: Record<string, unknown> = {};
+  try {
+    if (fs.existsSync(configPath)) {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    }
+  } catch (err) {
+    error('Failed to read config.json: ' + (err as Error).message);
+  }
+
+  // Set nested value using dot notation (e.g., "workflow.research")
+  const keys = keyPath.split('.');
+  let current: Record<string, unknown> = 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] as Record<string, unknown>;
+  }
+  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 as Error).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.
+ */
+export function cmdConfigSet(cwd: string, keyPath: string | undefined, value: string | undefined, raw: boolean): void {
+  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: unknown = value;
+  if (value === 'true') parsedValue = true;
+  else if (value === 'false') parsedValue = false;
+  else if (value !== undefined && !isNaN(Number(value)) && value !== '') parsedValue = Number(value);
+
+  const setConfigValueResult = setConfigValue(cwd, keyPath!, parsedValue);
+  output(setConfigValueResult, raw, `${keyPath}=${parsedValue}`);
+}
+
+export function cmdConfigGet(cwd: string, keyPath: string | undefined, raw: boolean): void {
+  const configPath = path.join(cwd, '.planning', 'config.json');
+
+  if (!keyPath) {
+    error('Usage: config-get <key.path>');
+  }
+
+  let config: Record<string, unknown> = {};
+  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 as Error).message.startsWith('No config.json')) throw err;
+    error('Failed to read config.json: ' + (err as Error).message);
+  }
+
+  // Traverse dot-notation path (e.g., "workflow.auto_advance")
+  const keys = keyPath!.split('.');
+  let current: unknown = config;
+  for (const key of keys) {
+    if (current === undefined || current === null || typeof current !== 'object') {
+      error(`Key not found: ${keyPath}`);
+    }
+    current = (current as Record<string, unknown>)[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.
+ */
+export function cmdConfigSetModelProfile(cwd: string, profile: string | undefined, raw: boolean): void {
+  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);
+  const previousProfile = (previousValue as string) || '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: string,
+  previousProfile: string,
+  agentToModelMap: Record<string, string>
+): string {
+  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');
+}

package/core/bin/lib/config.d.cts

@@ -0,0 +1,50 @@
+/**
+ * Config — Planning config CRUD operations
+ */
+/**
+ * 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.
+ */
+export declare function ensureConfigFile(cwd: string): {
+    created: boolean;
+    reason?: string;
+    path?: string;
+};
+/**
+ * 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.
+ */
+export declare function cmdConfigEnsureSection(cwd: string, raw: boolean): void;
+/**
+ * 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.
+ */
+export declare function setConfigValue(cwd: string, keyPath: string, parsedValue: unknown): {
+    updated: boolean;
+    key: string;
+    value: unknown;
+    previousValue: unknown;
+};
+/**
+ * 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.
+ */
+export declare function cmdConfigSet(cwd: string, keyPath: string | undefined, value: string | undefined, raw: boolean): void;
+export declare function cmdConfigGet(cwd: string, keyPath: string | undefined, raw: boolean): void;
+/**
+ * Command to set the model profile in the config file.
+ *
+ * Note that this exits the process (via `output()`) even in the happy path.
+ */
+export declare function cmdConfigSetModelProfile(cwd: string, profile: string | undefined, raw: boolean): void;
+//# sourceMappingURL=config.d.cts.map