codex-configurator 0.2.2 → 0.2.4

package/src/configHelp.js

@@ -2,7 +2,12 @@ import {
   getConfigFeatureDefinition,
   getConfigFeatureDefinitionOrFallback,
 } from './configFeatures.js';
-import { getReferenceOptionForPath } from './configReference.js';
+import {
+  getReferenceOptionForPath,
+  getReferenceCustomIdPlaceholder,
+  getReferenceDescendantOptions,
+  getReferenceTableDefinitions,
+} from './configReference.js';
 
 const CONFIG_VALUE_OPTIONS = {
   model: [
@@ -16,12 +21,6 @@ const CONFIG_VALUE_OPTIONS = {
 };
 
 const CONFIG_PATH_EXPLANATIONS = [
-  {
-    path: ['tools', 'web_search'],
-    short: 'Deprecated legacy web search flag.',
-    usage: 'Use the top-level web_search setting instead.',
-    deprecation: 'tools.web_search is deprecated; use the top-level web_search setting instead.',
-  },
   {
     path: ['projects', '*', 'trust_level'],
     short: 'Controls how much trust this project gets for command execution.',
@@ -54,6 +53,24 @@ const CONFIG_OPTION_EXPLANATIONS = {
     untrusted: 'Limits risky actions and prompts more often.',
   },
 };
+const SECTION_PURPOSE_OVERRIDES = {
+  agents: 'Named agent definitions and per-agent configuration file references.',
+  apps: 'Per-app enablement rules and tool-level approval controls.',
+  features: 'Feature flags for optional and experimental Codex behavior.',
+  feedback: 'Feedback submission settings for Codex surfaces.',
+  history: 'Session history retention policy and on-disk size limits.',
+  mcp_servers: 'MCP server definitions, transport settings, and authentication configuration.',
+  model_providers: 'Model provider definitions, API endpoints, and credential settings.',
+  notice: 'Visibility toggles for startup and migration notices.',
+  otel: 'OpenTelemetry exporter configuration for telemetry and traces.',
+  profiles: 'Named profile overrides you can select per session.',
+  projects: 'Project/worktree trust settings scoped by filesystem path.',
+  sandbox_workspace_write: 'Workspace-write sandbox behavior, writable roots, and network access rules.',
+  shell_environment_policy: 'Shell environment inheritance and variable override policy.',
+  skills: 'Skill discovery and loading controls.',
+  tools: 'Tool-related configuration, including legacy compatibility flags.',
+  tui: 'Terminal UI behavior, notifications, and presentation settings.',
+};
 
 const makePathSegments = (segments, key) => {
   const normalizedSegments = Array.isArray(segments)
@@ -78,6 +95,73 @@ const getContextEntry = (segments, key, candidates) => {
 
 const getReferenceEntry = (segments, key) => getReferenceOptionForPath(makePathSegments(segments, key));
 
+const formatPlaceholderLabel = (placeholder) => {
+  const cleaned = String(placeholder || '')
+    .replace(/^</, '')
+    .replace(/>$/, '');
+
+  return cleaned || 'id';
+};
+
+const toFirstSentence = (text) => {
+  const normalized = String(text || '').replace(/\s+/g, ' ').trim();
+  if (!normalized) {
+    return '';
+  }
+
+  const periodIndex = normalized.indexOf('. ');
+  if (periodIndex < 0) {
+    return normalized;
+  }
+
+  return normalized.slice(0, periodIndex + 1);
+};
+
+const getSectionPurposeDescription = (descendantOptions) => {
+  for (const option of descendantOptions) {
+    const firstSentence = toFirstSentence(option?.description);
+    if (firstSentence) {
+      return firstSentence;
+    }
+  }
+
+  return '';
+};
+
+const buildInferredSectionHelp = (segments, key) => {
+  const sectionPath = makePathSegments(segments, key);
+  const childDefinitions = getReferenceTableDefinitions(sectionPath);
+  const descendantOptions = getReferenceDescendantOptions(sectionPath);
+  const customPlaceholder = getReferenceCustomIdPlaceholder(sectionPath);
+  const parentCustomPlaceholder = getReferenceCustomIdPlaceholder(sectionPath.slice(0, -1));
+
+  if (childDefinitions.length === 0 && descendantOptions.length === 0 && !customPlaceholder) {
+    return null;
+  }
+
+  const rootOverride = sectionPath.length === 1
+    ? SECTION_PURPOSE_OVERRIDES[sectionPath[0]]
+    : null;
+  const customLabel = customPlaceholder ? formatPlaceholderLabel(customPlaceholder) : '';
+  const bestPurposeDescription = getSectionPurposeDescription(descendantOptions);
+  const dynamicEntryLabel = parentCustomPlaceholder
+    ? formatPlaceholderLabel(parentCustomPlaceholder)
+    : '';
+  const short = rootOverride
+    || (dynamicEntryLabel
+      ? `Configuration for this ${dynamicEntryLabel} entry.`
+      : '')
+    || bestPurposeDescription
+    || (customLabel
+      ? `Section for custom ${customLabel} entries.`
+      : 'Section with related settings.');
+
+  return {
+    short,
+    usage: null,
+  };
+};
+
 const getReferenceUsage = (entry) => {
   if (entry.deprecated) {
     return 'This option is deprecated in the official configuration reference.';
@@ -92,7 +176,7 @@ const getReferenceUsage = (entry) => {
   }
 
   if (entry.type === 'table') {
-    return 'This section groups related settings.';
+    return 'Press Enter to open this section and edit nested settings.';
   }
 
   if (entry.type.startsWith('array<')) {
@@ -144,6 +228,11 @@ export const getConfigHelp = (segments, key) => {
     return referenceHelp;
   }
 
+  const inferredSectionHelp = buildInferredSectionHelp(segments, key);
+  if (inferredSectionHelp) {
+    return inferredSectionHelp;
+  }
+
   return null;
 };
 

package/src/configParser.js

@@ -409,8 +409,7 @@ const formatRowLabel = (key, kind, value) =>
       : `${key} = ${previewValue(value)}`;
 
 const isPathDeprecated = (pathSegments, key) =>
-  Boolean(getReferenceOptionForPath([...pathSegments, String(key)])?.deprecated) ||
-  isToolsWebSearchDeprecated(pathSegments, key);
+  Boolean(getReferenceOptionForPath([...pathSegments, String(key)])?.deprecated);
 
 const sortRowsAlphabetically = (rows) =>
   [...rows].sort((left, right) => String(left.key).localeCompare(String(right.key)));
@@ -523,9 +522,6 @@ const buildRootRows = (node) => buildDefinedRows(node, getReferenceRootDefinitio
 const getTableDefinitions = (pathSegments) =>
   Array.isArray(pathSegments) ? getReferenceTableDefinitions(pathSegments) : [];
 
-const isToolsWebSearchDeprecated = (pathSegments, key) =>
-  pathSegments[pathSegments.length - 1] === 'tools' && key === 'web_search';
-
 export const getNodeAtPath = (root, segments) => {
   let current = root;
 

package/src/configReference.js

@@ -5,7 +5,6 @@ const CONFIG_REFERENCE_DATA = require('./reference/config-reference.json');
 
 const DOCUMENT_ID = 'config.toml';
 const PLACEHOLDER_SEGMENT = /^<[^>]+>$/;
-const NON_DEPRECATED_KEYS = new Set(['approval_policy']);
 const KIND_PRIORITY = {
   value: 1,
   array: 2,
@@ -93,7 +92,7 @@ const referenceOptions = Array.isArray(configDocument?.options)
           ? option.enum_values.map((value) => String(value))
           : [],
         description: String(option?.description || ''),
-        deprecated: option?.deprecated === true && !NON_DEPRECATED_KEYS.has(key),
+        deprecated: option?.deprecated === true,
       };
     })
   : [];
@@ -218,3 +217,15 @@ export const getReferenceCustomIdPlaceholder = (pathSegments = []) => {
   const [firstMatch] = [...placeholders];
   return firstMatch || null;
 };
+
+export const getReferenceDescendantOptions = (pathSegments = []) => {
+  const normalizedPath = normalizeSegments(pathSegments);
+
+  return referenceOptions
+    .filter(
+      (option) =>
+        pathPrefixMatches(option.keyPath, normalizedPath) &&
+        option.keyPath.length > normalizedPath.length
+    )
+    .sort((left, right) => left.keyPath.length - right.keyPath.length || left.key.localeCompare(right.key));
+};

package/src/constants.js

@@ -1,4 +1,5 @@
-export const CONTROL_HINT = '↑/↓ move • PgUp/PgDn page • Home/End jump • Enter: open section or edit • Del: unset value • ←/Backspace: back • r: reload • q: quit';
+export const CONTROL_HINT = '↑/↓ move • PgUp/PgDn page • Home/End jump • Enter: open section or edit • /: filter • Del: unset value • ←/Backspace: back • r: reload • q: quit';
 export const EDIT_CONTROL_HINT = '↑/↓ choose • PgUp/PgDn page • Home/End jump • Enter: save • Esc/Backspace/←: cancel • Del: delete char (text input) • r: reload • q: quit';
+export const FILTER_CONTROL_HINT = 'Type filter • Enter/Esc: done • Del/Backspace: delete • Ctrl+U: clear';
 export const BRAND = 'CODEX CONFIGURATOR';
 export const CONFIG_TAGS = ['Node.js', 'React', 'Ink', 'TOML'];

package/src/fuzzySearch.js

@@ -0,0 +1,39 @@
+const normalizeText = (value) => String(value || '').toLowerCase();
+
+export const isFuzzyMatch = (query, text) => {
+  const normalizedQuery = normalizeText(query).trim();
+  if (!normalizedQuery) {
+    return true;
+  }
+
+  const normalizedText = normalizeText(text);
+  let queryIndex = 0;
+
+  for (let textIndex = 0; textIndex < normalizedText.length; textIndex += 1) {
+    if (normalizedText[textIndex] === normalizedQuery[queryIndex]) {
+      queryIndex += 1;
+      if (queryIndex >= normalizedQuery.length) {
+        return true;
+      }
+    }
+  }
+
+  return false;
+};
+
+const rowSearchableTexts = (row) => [
+  row?.label,
+  row?.key,
+  row?.preview,
+];
+
+export const filterRowsByQuery = (rows, query) => {
+  const normalizedQuery = String(query || '').trim();
+  if (!normalizedQuery) {
+    return rows;
+  }
+
+  return rows.filter((row) =>
+    rowSearchableTexts(row).some((value) => isFuzzyMatch(normalizedQuery, value))
+  );
+};