praxis-agent 0.16.0 → 0.17.0

package/dist/cli/interactive.js

@@ -4,6 +4,7 @@ import { existsSync } from 'node:fs';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { homedir, tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { Box, Text, render, useApp, useInput } from 'ink';
 import { permissionRuleValueToString } from '../permissions/permission-updates.js';
@@ -19,6 +20,8 @@ import { addTuiPermissionRule, loadTuiPermissionRules, removeTuiPermissionRule,
 import { createRecentlyDeniedStore, } from './tui/recently-denied.js';
 import { agentColorMessage, parseAgentColorInput, } from '../compatibility/claude/agent-color.js';
 import { filterTuiSlashCommands, mergeTuiSlashCommands, slashCommandQuery, } from './tui/slash-commands.js';
+import { runDoctor } from '../maintenance/doctor.js';
+import { canonicalClaudeCostModelName, } from './tui/cost-summary.js';
 import { createComposerEditor, deleteComposerBackward, deleteComposerForward, deleteComposerToEnd, deleteComposerToStart, deleteComposerWordBackward, insertComposerText, moveComposerCursor, moveComposerCursorByWord, } from './tui/composer-editor.js';
 import { applyMentionReference, fileReferenceAtCursor, filterTuiMentionEntries, loadTuiFileEntries, } from './tui/file-picker.js';
 import { editTuiPrompt, openTuiEditorFile, } from './tui/external-editor.js';
@@ -36,6 +39,7 @@ import { commitElicitationText, createTuiElicitationForm, elicitationFormIsValid
 import { openTuiUrl } from './tui/open-url.js';
 import { projectTuiToolPermission, ToolPermissionDialog, } from './tui/tool-permission.js';
 import { ConfigDashboard, projectConfigRows } from './tui/config-dashboard.js';
+import { DoctorDashboard } from './tui/doctor-dashboard.js';
 import { SandboxDashboard, tuiSandboxTabs } from './tui/sandbox-dashboard.js';
 import { createTuiSandboxStore, } from './tui/sandbox-settings.js';
 import { loadConfigSettings, saveConfigSetting, configSettingDefinition, resolveConfigSettingsLocation, } from './tui/config-settings.js';
@@ -93,6 +97,15 @@ const PERMISSION_OPTIONS = [
         description: 'Restrict changes to the plan file until approval.',
     },
 ];
+const ZERO_COST_SUMMARY = {
+    totalCostUsd: 0,
+    apiDurationMs: 0,
+    wallDurationMs: 0,
+    linesAdded: 0,
+    linesRemoved: 0,
+    hasUnknownModelCost: false,
+    modelUsage: [],
+};
 function selectionPrefix(selected, screenReader) {
     if (selected)
         return screenReader ? 'Selected: ' : '❯ ';
@@ -248,7 +261,7 @@ const HIDDEN_TUI_SLASH_COMMANDS = new Set([
     'update',
     'usage',
 ]);
-export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], initialSessionColor, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader = (configRoot, cwd) => loadTuiMemoryFiles({ configRoot, cwd }), memoryEditor = openTuiEditorFile, memoryFolderOpener = openTuiMemoryFolder, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener = openTuiUrl, releaseNotesLoader = (configRoot) => loadClaudeReleaseNotes({ configRoot }), settingSources, }) {
+export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], initialSessionColor, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, doctorLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader = (configRoot, cwd) => loadTuiMemoryFiles({ configRoot, cwd }), memoryEditor = openTuiEditorFile, memoryFolderOpener = openTuiMemoryFolder, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener = openTuiUrl, releaseNotesLoader = (configRoot) => loadClaudeReleaseNotes({ configRoot }), settingSources, }) {
     const { exit, suspendTerminal, waitUntilRenderFlush } = useApp();
     const width = useTerminalWidth(terminalWidth);
     const keybindingsRoot = useMemo(() => resolve(keybindingsConfigRoot ??
@@ -260,6 +273,25 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const runtimeCwdRef = useRef(display.cwd);
     const runtimeGitignoreRef = useRef(true);
     const loadDiffSnapshot = useMemo(() => diffLoader ?? (() => loadGitDiff(runtimeCwd)), [diffLoader, runtimeCwd]);
+    const loadDoctorReport = useMemo(() => doctorLoader ??
+        (() => {
+            const configuredRoot = process.env.CLAUDE_CONFIG_DIR || undefined;
+            const configRoot = resolve(configuredRoot ?? resolve(homedir(), '.claude'));
+            const claudeStatePath = configuredRoot
+                ? join(configRoot, '.claude.json')
+                : resolve(homedir(), '.claude.json');
+            return runDoctor({
+                version: display.version,
+                executablePath: resolve(process.argv[1] ??
+                    fileURLToPath(new URL('../cli.js', import.meta.url))),
+                nodeExecutablePath: process.execPath,
+                nodeVersion: process.version,
+                configRoot,
+                claudeStatePath,
+                cwd: runtimeCwd,
+                environment: process.env,
+            });
+        }), [doctorLoader, runtimeCwd, display.version]);
     const loadFiles = useMemo(() => fileLoader ??
         (() => loadTuiFileEntries(runtimeCwd, {
             respectGitignore: runtimeGitignoreRef.current,
@@ -355,6 +387,11 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const btwCopiedTimerRef = useRef(null);
     const [menu, setMenu] = useState(null);
     const menuRef = useRef(null);
+    const configOpenGenerationRef = useRef(0);
+    const configUsageRequestRef = useRef(0);
+    const configOperationRef = useRef(null);
+    const doctorMenuGenerationRef = useRef(0);
+    const doctorOperationRef = useRef(null);
     const [busy, setBusy] = useState(false);
     const taskEntriesRef = useRef([]);
     const mcpControllerRef = useRef(null);
@@ -924,6 +961,25 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         })();
     }, [processSuspendRequested]);
     const updateMenu = (next) => {
+        if (next === null && menuRef.current?.kind === 'config') {
+            configOpenGenerationRef.current += 1;
+            configUsageRequestRef.current += 1;
+            const closingConfigOperation = configOperationRef.current;
+            configOperationRef.current = null;
+            if (closingConfigOperation) {
+                setBusy(false);
+                onTurnChange?.(null);
+            }
+        }
+        if (next === null && menuRef.current?.kind === 'doctor') {
+            doctorMenuGenerationRef.current += 1;
+            const closingDoctorOperation = doctorOperationRef.current;
+            doctorOperationRef.current = null;
+            if (closingDoctorOperation) {
+                setBusy(false);
+                onTurnChange?.(null);
+            }
+        }
         menuRef.current = next;
         setMenu(next);
     };
@@ -1634,32 +1690,181 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             messageAge: position - 1,
         });
     };
+    const loadCostUsage = async (sessionId) => {
+        if (!sessionId)
+            return ZERO_COST_SUMMARY;
+        return withLocalCommands(async (commands) => {
+            if (!commands.costSnapshot) {
+                throw new Error('This interactive service cannot report session cost.');
+            }
+            const snapshot = await commands.costSnapshot(sessionId);
+            return {
+                totalCostUsd: snapshot.totalCostUsd,
+                apiDurationMs: snapshot.apiDurationMs,
+                wallDurationMs: snapshot.wallDurationMs,
+                linesAdded: snapshot.linesAdded,
+                linesRemoved: snapshot.linesRemoved,
+                hasUnknownModelCost: snapshot.hasUnknownModelCost,
+                modelUsage: Object.entries(snapshot.modelUsage).map(([model, usage]) => ({
+                    model,
+                    canonicalName: canonicalClaudeCostModelName(model),
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                    cacheReadInputTokens: usage.cacheReadInputTokens,
+                    cacheCreationInputTokens: usage.cacheCreationInputTokens,
+                    webSearchRequests: usage.webSearchRequests,
+                    costUsd: usage.costUsd,
+                })),
+            };
+        });
+    };
+    const loadConfigMenuUsage = (generation, sessionId) => {
+        const requestId = ++configUsageRequestRef.current;
+        const loading = (async () => {
+            setBusy(true);
+            try {
+                const usage = await loadCostUsage(sessionId);
+                const current = menuRef.current;
+                if (current?.kind === 'config' &&
+                    current.generation === generation &&
+                    current.tab === 'usage' &&
+                    sessionIdRef.current === sessionId &&
+                    configUsageRequestRef.current === requestId) {
+                    updateMenu({ ...current, usage });
+                }
+            }
+            catch (error) {
+                const current = menuRef.current;
+                if (current?.kind === 'config' &&
+                    current.generation === generation &&
+                    current.tab === 'usage' &&
+                    sessionIdRef.current === sessionId &&
+                    configUsageRequestRef.current === requestId) {
+                    warn(error);
+                }
+            }
+        })();
+        configOperationRef.current = loading;
+        onTurnChange?.(loading);
+        void loading.finally(() => {
+            if (configOperationRef.current === loading) {
+                configOperationRef.current = null;
+                setBusy(false);
+                onTurnChange?.(null);
+            }
+        });
+    };
     const openSettings = (tab) => {
+        const generation = ++configOpenGenerationRef.current;
+        const sessionId = sessionIdRef.current;
+        const requestId = tab === 'usage' ? ++configUsageRequestRef.current : 0;
         const initial = {
             kind: 'config',
+            generation,
             snapshot: { settings: {}, state: {} },
             tab,
             selectedIndex: 0,
             query: '',
             searchFocused: tab === 'config',
+            usage: ZERO_COST_SUMMARY,
         };
         updateMenu(initial);
         const loading = (async () => {
             setBusy(true);
             try {
-                const snapshot = await loadConfigSettings(configTarget);
-                if (menuRef.current?.kind === 'config')
-                    updateMenu({ ...menuRef.current, snapshot });
+                const [snapshot, usage] = await Promise.all([
+                    loadConfigSettings(configTarget),
+                    tab === 'usage'
+                        ? loadCostUsage(sessionId)
+                        : Promise.resolve(ZERO_COST_SUMMARY),
+                ]);
+                const current = menuRef.current;
+                if (current?.kind === 'config' && current.generation === generation) {
+                    const next = { ...current, snapshot };
+                    if (current.tab === 'usage' &&
+                        sessionIdRef.current === sessionId &&
+                        configUsageRequestRef.current === requestId) {
+                        next.usage = usage;
+                    }
+                    updateMenu(next);
+                }
             }
             catch (error) {
-                warn(error);
+                const current = menuRef.current;
+                if (tab === 'usage') {
+                    if (current?.kind === 'config' &&
+                        current.generation === generation &&
+                        current.tab === 'usage' &&
+                        sessionIdRef.current === sessionId &&
+                        configUsageRequestRef.current === requestId) {
+                        warn(error);
+                    }
+                }
+                else if (configOpenGenerationRef.current === generation) {
+                    warn(error);
+                }
             }
-            finally {
+        })();
+        configOperationRef.current = loading;
+        onTurnChange?.(loading);
+        void loading.finally(() => {
+            if (configOperationRef.current === loading) {
+                configOperationRef.current = null;
                 setBusy(false);
+                onTurnChange?.(null);
+            }
+        });
+    };
+    const openDoctor = () => {
+        const generation = ++doctorMenuGenerationRef.current;
+        updateMenu({
+            kind: 'doctor',
+            generation,
+            loading: true,
+            report: null,
+            error: null,
+        });
+        const loading = (async () => {
+            setBusy(true);
+            try {
+                const report = await loadDoctorReport();
+                const current = menuRef.current;
+                if (current?.kind === 'doctor' && current.generation === generation) {
+                    updateMenu({
+                        kind: 'doctor',
+                        generation,
+                        loading: false,
+                        report,
+                        error: null,
+                    });
+                }
+            }
+            catch (error) {
+                const current = menuRef.current;
+                if (current?.kind === 'doctor' && current.generation === generation) {
+                    updateMenu({
+                        kind: 'doctor',
+                        generation,
+                        loading: false,
+                        report: null,
+                        error: redactSensitiveText(error instanceof Error ? error.message : String(error), sensitiveValues),
+                    });
+                }
+            }
+            finally {
+                if (doctorMenuGenerationRef.current === generation)
+                    setBusy(false);
             }
         })();
+        doctorOperationRef.current = loading;
         onTurnChange?.(loading);
-        void loading.finally(() => onTurnChange?.(null));
+        void loading.finally(() => {
+            if (doctorOperationRef.current === loading) {
+                doctorOperationRef.current = null;
+                setBusy(false);
+                onTurnChange?.(null);
+            }
+        });
     };
     const exportConversation = (method) => {
         if (method === 'file') {
@@ -3316,6 +3521,8 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                     selectedIndex: 0,
                     searchFocused: tab === 'config',
                 });
+                if (tab === 'usage')
+                    loadConfigMenuUsage(earlyMenu.generation, sessionIdRef.current);
                 return;
             }
             if (earlyMenu.tab !== 'config')
@@ -4647,6 +4854,12 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                 }
                 return;
             }
+            if (activeMenu.kind === 'doctor') {
+                if (key.escape || value === '\u001B' || key.return) {
+                    updateMenu(null);
+                }
+                return;
+            }
             if (key.escape) {
                 updateMenu(null);
                 return;
@@ -5239,6 +5452,12 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                 onTurnChange?.(loading);
                 void loading.finally(() => onTurnChange?.(null));
             }
+            else if (prompt === '/cost') {
+                openSettings('usage');
+            }
+            else if (prompt === '/doctor') {
+                openDoctor();
+            }
             else if (prompt === '/status') {
                 openSettings('status');
             }
@@ -5446,14 +5665,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                             ...(statusProxy ? { proxy: statusProxy } : {}),
                             model: runtimeDisplay.model ?? 'default',
                             settingSources: statusSettingSources.split(', '),
-                        }, usage: {
-                            costUsd: costUsd ?? 0,
-                            apiDurationMs: 0,
-                            wallDurationMs: 0,
-                            linesAdded: 0,
-                            linesRemoved: 0,
-                            usage: usage ?? { inputTokens: 0, outputTokens: 0 },
-                        }, width: width, screenReader: axScreenReader })) : menu.kind === 'mcp' ? (_jsx(McpPanel, { model: menu.model, state: menu.state, width: width, screenReader: axScreenReader })) : menu.kind === 'tasks' ? (_jsx(TaskPanel, { tasks: menu.tasks, state: menu.state, width: width, screenReader: axScreenReader })) : menu.kind === 'memory' ? (_jsx(MemoryDashboard, { autoMemoryEnabled: menu.autoMemoryEnabled, entries: menu.entries, selectedIndex: menu.selectedIndex, openedIndex: menu.openedIndex, loading: menu.loading, width: width, screenReader: axScreenReader })) : menu.kind === 'hooks' ? (_jsx(HookDashboard, { configuration: menu.configuration, depth: menu.depth, eventIndex: menu.eventIndex, matcherIndex: menu.matcherIndex, hookIndex: menu.hookIndex, width: width, screenReader: axScreenReader })) : menu.kind === 'list' ? (_jsx(ListDashboard, { title: menu.title, rows: menu.rows, emptyText: menu.emptyText, selectedIndex: menu.selectedIndex, width: width, screenReader: axScreenReader })) : menu.kind === 'model' ? (_jsx(ModelMenu, { options: modelOptions, effort: runtimePreferences.effort, selectedIndex: menu.selectedIndex, width: width, screenReader: axScreenReader })) : menu.kind === 'effort' ? (_jsx(SelectionMenu, { title: "Select effort", description: "Controls how much reasoning effort the provider should use.", options: EFFORT_OPTIONS.map((option) => ({
+                        }, usage: menu.usage, width: width, screenReader: axScreenReader })) : menu.kind === 'doctor' ? (_jsx(DoctorDashboard, { loading: menu.loading, report: menu.report, error: menu.error, width: width, screenReader: axScreenReader })) : menu.kind === 'mcp' ? (_jsx(McpPanel, { model: menu.model, state: menu.state, width: width, screenReader: axScreenReader })) : menu.kind === 'tasks' ? (_jsx(TaskPanel, { tasks: menu.tasks, state: menu.state, width: width, screenReader: axScreenReader })) : menu.kind === 'memory' ? (_jsx(MemoryDashboard, { autoMemoryEnabled: menu.autoMemoryEnabled, entries: menu.entries, selectedIndex: menu.selectedIndex, openedIndex: menu.openedIndex, loading: menu.loading, width: width, screenReader: axScreenReader })) : menu.kind === 'hooks' ? (_jsx(HookDashboard, { configuration: menu.configuration, depth: menu.depth, eventIndex: menu.eventIndex, matcherIndex: menu.matcherIndex, hookIndex: menu.hookIndex, width: width, screenReader: axScreenReader })) : menu.kind === 'list' ? (_jsx(ListDashboard, { title: menu.title, rows: menu.rows, emptyText: menu.emptyText, selectedIndex: menu.selectedIndex, width: width, screenReader: axScreenReader })) : menu.kind === 'model' ? (_jsx(ModelMenu, { options: modelOptions, effort: runtimePreferences.effort, selectedIndex: menu.selectedIndex, width: width, screenReader: axScreenReader })) : menu.kind === 'effort' ? (_jsx(SelectionMenu, { title: "Select effort", description: "Controls how much reasoning effort the provider should use.", options: EFFORT_OPTIONS.map((option) => ({
                             label: option,
                             description: option === 'low'
                                 ? 'Fastest and least deliberative.'

package/dist/cli/protocol.d.ts

@@ -180,6 +180,7 @@ export interface CliRuntimeInfo {
     cwd: string;
     model: string;
     contextWindowTokens?: number;
+    maxOutputTokens?: number;
     tools: readonly string[];
     mcpServers: readonly {
         name: string;
@@ -203,6 +204,11 @@ export interface ProtocolResult {
     durationApiMs?: number;
     costUsd?: number;
     modelUsage?: Readonly<Record<string, ModelUsage>>;
+    /**
+     * Exact per-model cost in USD. When present, each model's costUSD is taken
+     * from this map instead of assigning the total cost to runtimeInfo.model.
+     */
+    modelCostUsd?: Readonly<Record<string, number>>;
 }
 export declare function createSuccessResult(result: ProtocolResult, info: CliRuntimeInfo, startedAt: number, modelTurns: number): Record<string, unknown>;
 export declare function createErrorResult(message: string, sessionId: string, startedAt: number, modelTurns: number): Record<string, unknown>;
@@ -213,6 +219,11 @@ export declare function createErrorResult(message: string, sessionId: string, st
  * the command.
  */
 export declare function matchHeadlessColorCommand(prompt: string): string | undefined;
+/**
+ * Returns true only for a trimmed exact `/cost` command. `/costs`, `/cost
+ * extra`, and any non-slash text are model prompts.
+ */
+export declare function isHeadlessCostCommand(prompt: string): boolean;
 export declare function parseCliInvocation(argv: readonly string[]): CliInvocation;
 export declare function readStreamJsonMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamJsonMessage>;
 export declare function readStreamUserMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamUserMessage>;

package/dist/cli/protocol.js

@@ -35,7 +35,15 @@ export function createSuccessResult(result, info, startedAt, modelTurns) {
                 outputTokens: modelUsage.outputTokens,
                 cacheReadInputTokens: modelUsage.cacheReadInputTokens ?? 0,
                 cacheCreationInputTokens: modelUsage.cacheCreationInputTokens ?? 0,
-                costUSD: model === info.model ? (result.costUsd ?? null) : null,
+                costUSD: result.modelCostUsd?.[model] ??
+                    (model === info.model ? (result.costUsd ?? null) : null),
+                ...(modelUsage.webSearchRequests === undefined
+                    ? {}
+                    : { webSearchRequests: modelUsage.webSearchRequests }),
+                contextWindow: modelUsage.contextWindow ??
+                    (model === info.model ? (info.contextWindowTokens ?? 0) : 0),
+                maxOutputTokens: modelUsage.maxOutputTokens ??
+                    (model === info.model ? (info.maxOutputTokens ?? 0) : 0),
             },
         ])),
         permission_denials: [],
@@ -92,6 +100,13 @@ export function matchHeadlessColorCommand(prompt) {
         return undefined;
     return match[1] ?? '';
 }
+/**
+ * Returns true only for a trimmed exact `/cost` command. `/costs`, `/cost
+ * extra`, and any non-slash text are model prompts.
+ */
+export function isHeadlessCostCommand(prompt) {
+    return prompt.trim() === '/cost';
+}
 const INPUT_FORMATS = ['text', 'stream-json'];
 const OUTPUT_FORMATS = ['text', 'json', 'stream-json'];
 const PERMISSION_MODES = [

package/dist/cli/tui/claude-command-inventory.d.ts

@@ -1,4 +1,4 @@
-export type ClaudeCommandDisposition = 'included' | 'deferred' | 'excluded';
+export type ClaudeCommandDisposition = 'included' | 'required' | 'deferred' | 'excluded';
 export type ClaudeCommandVisibility = 'visible' | 'hidden' | 'conditional';
 export interface ClaudeCommandInventoryEntry {
     name: string;
@@ -14,7 +14,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "advisor";
     readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "Conditional advice mode is required parity work and is not implemented yet.";
+    readonly reason: "Conditional advice mode is an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "agents";
     readonly disposition: "included";
@@ -29,9 +29,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "chrome";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "The CLI-driven Chrome integration is required parity work and is not implemented yet.";
+    readonly reason: "Claude-AI subscription-gated Chrome Beta; a future provider-neutral browser feature is separate from this command.";
 }, {
     readonly name: "clear";
     readonly disposition: "included";
@@ -63,16 +63,16 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "cost";
-    readonly disposition: "deferred";
+    readonly disposition: "included";
     readonly visibility: "conditional";
-    readonly reason: "The dedicated /cost contract is required; /status is not a substitute.";
+    readonly reason: "The dedicated /cost contract is included; /status is not a substitute.";
 }, {
     readonly name: "diff";
     readonly disposition: "included";
     readonly visibility: "visible";
 }, {
     readonly name: "doctor";
-    readonly disposition: "deferred";
+    readonly disposition: "required";
     readonly visibility: "conditional";
     readonly reason: "Interactive /doctor is required; the top-level command is not a substitute.";
 }, {
@@ -87,7 +87,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "fast";
     readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "The /fast state flow is required; model and effort controls are not a substitute.";
+    readonly reason: "The /fast state flow is an optional convenience; model and effort controls cover the core flow, so it is deferred without blocking developer-core closure.";
 }, {
     readonly name: "files";
     readonly disposition: "excluded";
@@ -95,9 +95,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly reason: "The source command is restricted to the internal Ant user type.";
 }, {
     readonly name: "heapdump";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "hidden";
-    readonly reason: "The hidden heap-diagnostic contract is required parity work and is not implemented yet.";
+    readonly reason: "Hidden V8 maintainer diagnostic that writes a heap dump to Desktop; not a developer-core command.";
 }, {
     readonly name: "help";
     readonly disposition: "included";
@@ -188,7 +188,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "stats";
     readonly disposition: "deferred";
     readonly visibility: "visible";
-    readonly reason: "Historical usage statistics are required parity work and are not implemented yet.";
+    readonly reason: "Historical usage statistics are an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "status";
     readonly disposition: "included";
@@ -261,7 +261,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "insights";
     readonly disposition: "deferred";
     readonly visibility: "visible";
-    readonly reason: "Retrospective insights are required parity work and are not implemented yet.";
+    readonly reason: "Retrospective insights are an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "vim";
     readonly disposition: "included";
@@ -277,24 +277,24 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "buddy";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "proactive";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "brief";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "assistant";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "remote-control";
     readonly disposition: "excluded";
@@ -309,17 +309,17 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "voice";
     readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "Conditional voice input is required parity work and is not implemented yet.";
+    readonly reason: "Conditional voice input is an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "think-back";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "The conditional retrospective flow is required parity work and is not implemented yet.";
+    readonly reason: "The 2025 year-in-review campaign surface; a marketing flow, not a stable developer-core command.";
 }, {
     readonly name: "thinkback-play";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "hidden";
-    readonly reason: "The hidden retrospective playback flow is required parity work and is not implemented yet.";
+    readonly reason: "Hidden animation for the 2025 year-in-review campaign; a marketing flow, not a stable developer-core command.";
 }, {
     readonly name: "permissions";
     readonly disposition: "included";
@@ -375,9 +375,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "torch";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This source-gated behavior is required conditional parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }];
 export declare const CLAUDE_2_1_208_COMMAND_BY_NAME: ReadonlyMap<string, ClaudeCommandInventoryEntry>;
 //# sourceMappingURL=claude-command-inventory.d.ts.map