praxis-agent 0.12.0 → 0.14.0

package/README.md

@@ -15,6 +15,11 @@ Anthropic/OpenAI-compatible model access. Praxis deliberately excludes
 accounts, organizations, billing, managed enterprise policy, remote control,
 IDE surfaces, and telemetry control planes.
 
+Claude Code 2.1.208 is the compatibility, architecture, and design baseline.
+Every single-user CLI capability remains required unless it falls inside an
+explicit exclusion above. A similar Praxis surface is not a substitute for the
+corresponding Claude command or runtime contract.
+
 ## Requirements
 
 - macOS or Linux
@@ -87,8 +92,11 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   `/rewind`, runtime `/cd`, transcript-free
   `/btw` side questions with background-Agent handoff, interactive
   `/background` terminal handoff, unified `/status`/`/config`/`/usage` settings
-  tabs, `/sandbox` mode/dependency/override/config controls, `/mcp`, `/memory` shared
-  instruction and auto-memory access, and live extension-reload controls,
+  tabs, `/sandbox` mode/dependency/override/config controls, local cached
+  `/release-notes`, Claude-compatible `/statusline` command execution and setup
+  agent, source-aligned `/init` project-instruction onboarding with its enhanced
+  skills/hooks flow, `/mcp`, `/memory` shared instruction and auto-memory
+  access, and live extension-reload controls,
   cursor/history composer, per-session model/effort/permission controls,
   context/status/skill/task dashboards, prompt stash and continuation shortcuts,
   filterable `@` file and agent references, composer undo, `Ctrl+G` external
@@ -177,8 +185,9 @@ for exact shared data, version boundaries, exclusions, and verification gates.
 
 Praxis targets one local OS user working across multiple repositories and
 sessions. It is CLI-only and provider-capability-aware. Organization, tenant,
-RBAC, billing, enterprise gateway, IDE, Chrome, Remote Control, Claude Desktop
-import, and hosted review-product surfaces are permanent non-goals.
+RBAC, subscription authentication and billing, enterprise gateway,
+IDE/Desktop/mobile clients, Remote Control, Claude Desktop import, and hosted
+review-product surfaces are permanent non-goals.
 
 ## Security and support
 

package/dist/application/subagent-service.d.ts

@@ -1,7 +1,7 @@
 import { type ClaudeSidechainPermissionMode } from '../compatibility/claude/sidechain.js';
 import { type ContextAssembler } from '../core/context.js';
 import { type ModelProvider, type ModelToolCall, type ModelToolDefinition, type ModelUsage, type PermissionResolver, type PermissionApproval, type PermissionDecision, type PermissionUpdate, type RuntimeEventSink, type ToolExecutionContext, type ToolExecutionResult, type ToolRegistry } from '../core/runtime.js';
-import type { ClaudeExtensionCatalog } from '../extensions/claude-extensions.js';
+import { type ClaudeExtensionCatalog } from '../extensions/claude-extensions.js';
 import type { ClaudeHookRunner } from '../hooks/claude-hooks.js';
 import { type BackgroundAgentSnapshot } from './background-agent-manager.js';
 export interface WorkflowAgentRunOptions {

package/dist/application/subagent-service.js

@@ -11,6 +11,7 @@ import { createClaudeHookAttachmentEntries, translateProviderEvents, } from '../
 import { injectFirstUserMessageContext, } from '../core/context.js';
 import { ContextBudget } from '../core/context-budget.js';
 import { AgentRuntime, } from '../core/runtime.js';
+import { BUILTIN_STATUSLINE_AGENT_PATH, } from '../extensions/claude-extensions.js';
 import { ClaudeHookToolCoordinator } from '../hooks/claude-hook-tools.js';
 import { ClaudeSidechainStore } from '../persistence/claude-sidechain-store.js';
 import { InMemorySidechainStore } from '../persistence/in-memory-sidechain-store.js';
@@ -79,6 +80,29 @@ export class StructuredOutputRegistry {
         });
     }
 }
+class RestrictedToolRegistry {
+    base;
+    allowed;
+    constructor(base, names) {
+        this.base = base;
+        this.allowed = new Set(names);
+    }
+    definitions() {
+        return this.base
+            .definitions()
+            .filter((definition) => this.allowed.has(definition.name));
+    }
+    prepare(call, context) {
+        if (!this.allowed.has(call.name))
+            throw new Error(`Tool ${call.name} is unavailable to this agent`);
+        return this.base.prepare(call, context);
+    }
+    execute(call, context) {
+        if (!this.allowed.has(call.name))
+            throw new Error(`Tool ${call.name} is unavailable to this agent`);
+        return this.base.execute(call, context);
+    }
+}
 function parseAgentInput(call) {
     const allowed = new Set([
         'description',
@@ -942,9 +966,16 @@ export class ClaudeSubagentExecutor {
             permission_mode: options.input.permissionMode ?? 'default',
         };
         const nestedTools = this.registry(String(options.root.sessionId), options.spawnDepth, () => options.promptId);
-        const agentTools = options.outputSchema
-            ? new StructuredOutputRegistry(structuredOnlyTools, options.outputSchema, options.structuredOutput)
+        const builtInStatusLineAgent = this.options.extensions?.agent(options.input.subagentType)?.path ===
+            BUILTIN_STATUSLINE_AGENT_PATH;
+        const scopedTools = builtInStatusLineAgent
+            ? new RestrictedToolRegistry(nestedTools, ['Read', 'Edit'])
             : nestedTools;
+        const agentTools = options.outputSchema
+            ? new StructuredOutputRegistry(builtInStatusLineAgent
+                ? new RestrictedToolRegistry(structuredOnlyTools, ['Read', 'Edit'])
+                : structuredOnlyTools, options.outputSchema, options.structuredOutput)
+            : scopedTools;
         const runtimeTools = this.options.hooks
             ? new ClaudeHookToolCoordinator({
                 tools: agentTools,

package/dist/cli/interactive.d.ts

@@ -175,8 +175,10 @@ interface InteractiveAppProps {
     runtimeSettingsTarget?: ConfigSettingsTarget;
     notificationWriter?: TuiNotificationWriter;
     elicitationUrlOpener?: (url: string) => void | Promise<void>;
+    releaseNotesLoader?: (configRoot: string) => Promise<string>;
+    settingSources?: readonly ClaudeResourceScope[];
 }
-export declare function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader, allowNewSession, resume, display, terminalWidth, slashCommands, agents, allowDangerouslySkipPermissions, additionalDirectories, diffLoader, fileLoader, externalEditor, keybindingsConfigRoot, keybindingsFile, keybindingsLoader, keybindingsEditor, memoryFilesLoader, memoryEditor, memoryFolderOpener, suspendProcess, clipboardReader, clipboardWriter, sideQuestionClipboardWriter, exportWriter, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver, workspaceDirectoryCompleter, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener, }: InteractiveAppProps): import("react").JSX.Element;
+export declare function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader, allowNewSession, resume, display, terminalWidth, slashCommands, agents, allowDangerouslySkipPermissions, additionalDirectories, diffLoader, fileLoader, externalEditor, keybindingsConfigRoot, keybindingsFile, keybindingsLoader, keybindingsEditor, memoryFilesLoader, memoryEditor, memoryFolderOpener, suspendProcess, clipboardReader, clipboardWriter, sideQuestionClipboardWriter, exportWriter, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver, workspaceDirectoryCompleter, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener, releaseNotesLoader, settingSources, }: InteractiveAppProps): import("react").JSX.Element;
 export declare function runInteractive(options: {
     factory: InteractiveServiceFactory;
     initialPrompt?: string;
@@ -192,6 +194,7 @@ export declare function runInteractive(options: {
     onBackground?: (request: InteractiveBackgroundRequest) => Promise<InteractiveBackgroundResult>;
     onBackgrounded?: (result: InteractiveBackgroundResult) => void;
     runtimeSettings?: PraxisRuntimeSettings;
+    settingSources?: readonly ClaudeResourceScope[];
 }): Promise<number>;
 export {};
 //# sourceMappingURL=interactive.d.ts.map

package/dist/cli/interactive.js

@@ -12,6 +12,8 @@ import { claudePermissionActionKey, claudePermissionRuleMatches, } from '../perm
 import { redactSensitiveText, sensitiveEnvironmentValues, } from '../platform/sensitive-data.js';
 import { CommandPalette, BtwPanel, Composer, DiffDashboard, DialogFrame, ExternalEditorWait, HelpMenu, HookDashboard, ListDashboard, MemoryDashboard, MentionPicker, ModelMenu, PermissionDashboard, SelectionMenu, SessionPicker, ThemePicker, CustomThemeEditor, Transcript, WelcomePanel, useTerminalWidth, } from './tui/claude-style.js';
 import { loadTuiMemoryFiles, openTuiMemoryFolder, } from './tui/memory-files.js';
+import { loadClaudeReleaseNotes } from './tui/release-notes.js';
+import { createClaudeStatusLineInput, StatusLine } from './tui/status-line.js';
 import { loadGitDiff, visiblePatchLines, } from './tui/git-diff.js';
 import { addTuiPermissionRule, loadTuiPermissionRules, removeTuiPermissionRule, } from './tui/permission-settings.js';
 import { createRecentlyDeniedStore, } from './tui/recently-denied.js';
@@ -245,7 +247,7 @@ const HIDDEN_TUI_SLASH_COMMANDS = new Set([
     'update',
     'usage',
 ]);
-export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], 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, }) {
+export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], 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, }) {
     const { exit, suspendTerminal, waitUntilRenderFlush } = useApp();
     const width = useTerminalWidth(terminalWidth);
     const keybindingsRoot = useMemo(() => resolve(keybindingsConfigRoot ??
@@ -299,6 +301,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const [selectedIndex, setSelectedIndex] = useState(0);
     const selectedIndexRef = useRef(0);
     const [sessionId, setSessionId] = useState(resume?.sessionId ?? null);
+    const statusLineSessionId = useRef(resume?.sessionId ?? randomUUID());
     const sessionIdRef = useRef(resume?.sessionId ?? null);
     sessionIdRef.current = sessionId;
     const [sessionName, setSessionName] = useState(null);
@@ -2265,10 +2268,14 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         setBusy(true);
         setTurnDuration(undefined);
         setCommandPaletteOpen(false);
-        setStatus('assembling-context');
+        const submittedCommandName = /^\/([^\s]+)/u.exec(prompt)?.[1]?.toLowerCase();
+        const commandProgressMessage = submittedCommandName
+            ? allSlashCommands.find((command) => command.name.toLowerCase() === submittedCommandName)?.progressMessage
+            : undefined;
+        setStatus(commandProgressMessage ?? 'assembling-context');
         setActiveText('');
         setActiveThinking('');
-        if (runtimeSettingsRef.current.tips) {
+        if (runtimeSettingsRef.current.tips && !commandProgressMessage) {
             setStatus(spinnerTip(runtimeSettingsRef.current) ?? 'assembling-context');
         }
         if (shellCommand === undefined)
@@ -4799,11 +4806,13 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                 updateMenu({ kind: 'help', tabIndex: 0, selectedIndex: 0 });
             }
             else if (prompt === '/new') {
+                statusLineSessionId.current = randomUUID();
                 setSessionId(null);
                 setPendingFork(false);
                 append({ kind: 'notice', text: 'Started a new session.' });
             }
             else if (prompt === '/clear') {
+                statusLineSessionId.current = randomUUID();
                 setSessionId(null);
                 setPendingFork(false);
                 setHistory([]);
@@ -5176,6 +5185,27 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             else if (prompt === '/status') {
                 openSettings('status');
             }
+            else if (prompt === '/release-notes') {
+                const loading = (async () => {
+                    setBusy(true);
+                    setStatus('loading release notes');
+                    try {
+                        append({
+                            kind: 'local-result',
+                            text: await releaseNotesLoader(keybindingsRoot),
+                        });
+                    }
+                    catch (error) {
+                        warn(error);
+                    }
+                    finally {
+                        setBusy(false);
+                        setStatus('ready');
+                    }
+                })();
+                onTurnChange?.(loading);
+                void loading.finally(() => onTurnChange?.(null));
+            }
             else if (prompt === '/config') {
                 openSettings('config');
             }
@@ -5395,7 +5425,39 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                                     ? { prStatus: `PR #${activeSessionSummary.prNumber}` }
                                     : {}), shortcutsVisible: shortcutsVisible, ...(editorFooterMessage === undefined
                                     ? {}
-                                    : { footerMessage: editorFooterMessage }) })] }))] })) }) }));
+                                    : { footerMessage: editorFooterMessage }) }), _jsx(StatusLine, { configRoot: keybindingsRoot, cwd: runtimeCwd, input: createClaudeStatusLineInput({
+                                    configRoot: keybindingsRoot,
+                                    cwd: runtimeCwd,
+                                    projectDir: display.cwd,
+                                    sessionId: sessionId ?? statusLineSessionId.current,
+                                    sessionName,
+                                    ...(runtimeDisplay.model === undefined
+                                        ? {}
+                                        : { model: runtimeDisplay.model }),
+                                    version: runtimeDisplay.version,
+                                    outputStyle: runtimeSettings.outputStyle,
+                                    permissionMode: runtimePreferences.permissionMode,
+                                    additionalDirectories: runtimePreferences.additionalDirectories,
+                                    ...(usage === undefined ? {} : { usage }),
+                                    ...(costUsd === undefined ? {} : { costUsd }),
+                                    ...(runtimeDisplay.contextWindowTokens === undefined
+                                        ? {}
+                                        : {
+                                            contextWindowTokens: runtimeDisplay.contextWindowTokens,
+                                        }),
+                                    ...(runtimeSettings.editor === 'vim'
+                                        ? { vimMode: vimInsertMode ? 'INSERT' : 'NORMAL' }
+                                        : {}),
+                                }), refreshKey: [
+                                    history.length,
+                                    runtimePreferences.permissionMode,
+                                    runtimeDisplay.model,
+                                    runtimeSettings.outputStyle,
+                                    vimInsertMode,
+                                    sessionName,
+                                    usage?.inputTokens,
+                                    usage?.outputTokens,
+                                ].join(':'), ...(settingSources === undefined ? {} : { settingSources }) })] }))] })) }) }));
 }
 export async function runInteractive(options) {
     const controller = new AbortController();
@@ -5484,7 +5546,9 @@ export async function runInteractive(options) {
         let cleanup = null;
         let backgrounded;
         rendererChange = null;
-        const instance = render(_jsx(InteractiveApp, { factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, runtimeSettings: currentRuntimeSettings, initialThemeSettings: initialThemeSettings, ...(initialThemeLoadError === undefined
+        const instance = render(_jsx(InteractiveApp, { factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, runtimeSettings: currentRuntimeSettings, ...(options.settingSources === undefined
+                ? {}
+                : { settingSources: options.settingSources }), initialThemeSettings: initialThemeSettings, ...(initialThemeLoadError === undefined
                 ? {}
                 : { initialThemeLoadError }), ...(currentInitialPrompt === undefined
                 ? {}

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

@@ -1,4 +1,4 @@
-export type ClaudeCommandDisposition = 'included' | 'excluded';
+export type ClaudeCommandDisposition = 'included' | 'deferred' | 'excluded';
 export type ClaudeCommandVisibility = 'visible' | 'hidden' | 'conditional';
 export interface ClaudeCommandInventoryEntry {
     name: string;
@@ -12,8 +12,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "advisor";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "Conditional advice mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "agents";
     readonly disposition: "included";
@@ -28,17 +29,18 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "chrome";
-    readonly disposition: "excluded";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "Chrome integration is outside the CLI-only product boundary.";
+    readonly reason: "The CLI-driven Chrome integration is required parity work and is not implemented yet.";
 }, {
     readonly name: "clear";
     readonly disposition: "included";
     readonly visibility: "visible";
 }, {
     readonly name: "color";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "visible";
+    readonly reason: "The dedicated /color contract is required; /theme is not a substitute.";
 }, {
     readonly name: "compact";
     readonly disposition: "included";
@@ -62,16 +64,18 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "cost";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "The dedicated /cost contract is required; /status is not a substitute.";
 }, {
     readonly name: "diff";
     readonly disposition: "included";
     readonly visibility: "visible";
 }, {
     readonly name: "doctor";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "Interactive /doctor is required; the top-level command is not a substitute.";
 }, {
     readonly name: "effort";
     readonly disposition: "included";
@@ -82,8 +86,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "fast";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "The /fast state flow is required; model and effort controls are not a substitute.";
 }, {
     readonly name: "files";
     readonly disposition: "excluded";
@@ -91,8 +96,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: "included";
+    readonly disposition: "deferred";
     readonly visibility: "hidden";
+    readonly reason: "The hidden heap-diagnostic contract is required parity work and is not implemented yet.";
 }, {
     readonly name: "help";
     readonly disposition: "included";
@@ -181,8 +187,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "stats";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "visible";
+    readonly reason: "Historical usage statistics are required parity work and are not implemented yet.";
 }, {
     readonly name: "status";
     readonly disposition: "included";
@@ -253,8 +260,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly reason: "The source command is the Claude subscription plan-usage panel.";
 }, {
     readonly name: "insights";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "visible";
+    readonly reason: "Retrospective insights are required parity work and are not implemented yet.";
 }, {
     readonly name: "vim";
     readonly disposition: "included";
@@ -270,20 +278,24 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "buddy";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "proactive";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "brief";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "assistant";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "remote-control";
     readonly disposition: "excluded";
@@ -296,16 +308,19 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly reason: "Remote Control is outside the local-only boundary.";
 }, {
     readonly name: "voice";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "Conditional voice input is required parity work and is not implemented yet.";
 }, {
     readonly name: "think-back";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "The conditional retrospective flow is required parity work and is not implemented yet.";
 }, {
     readonly name: "thinkback-play";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "hidden";
+    readonly reason: "The hidden retrospective playback flow is required parity work and is not implemented yet.";
 }, {
     readonly name: "permissions";
     readonly disposition: "included";
@@ -361,8 +376,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "torch";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This source-gated behavior is required conditional parity work and is not implemented yet.";
 }];
 export declare const CLAUDE_2_1_208_COMMAND_BY_NAME: ReadonlyMap<string, ClaudeCommandInventoryEntry>;
 //# sourceMappingURL=claude-command-inventory.d.ts.map

package/dist/cli/tui/claude-command-inventory.js

@@ -4,18 +4,28 @@
 // disappearing from the parity inventory.
 export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
     { name: 'add-dir', disposition: 'included', visibility: 'visible' },
-    { name: 'advisor', disposition: 'included', visibility: 'conditional' },
+    {
+        name: 'advisor',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'Conditional advice mode is required parity work and is not implemented yet.',
+    },
     { name: 'agents', disposition: 'included', visibility: 'visible' },
     { name: 'branch', disposition: 'included', visibility: 'visible' },
     { name: 'btw', disposition: 'included', visibility: 'visible' },
     {
         name: 'chrome',
-        disposition: 'excluded',
+        disposition: 'deferred',
         visibility: 'conditional',
-        reason: 'Chrome integration is outside the CLI-only product boundary.',
+        reason: 'The CLI-driven Chrome integration is required parity work and is not implemented yet.',
     },
     { name: 'clear', disposition: 'included', visibility: 'visible' },
-    { name: 'color', disposition: 'included', visibility: 'visible' },
+    {
+        name: 'color',
+        disposition: 'deferred',
+        visibility: 'visible',
+        reason: 'The dedicated /color contract is required; /theme is not a substitute.',
+    },
     { name: 'compact', disposition: 'included', visibility: 'visible' },
     { name: 'config', disposition: 'included', visibility: 'visible' },
     { name: 'copy', disposition: 'included', visibility: 'visible' },
@@ -26,19 +36,39 @@ export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
         reason: 'Desktop handoff/import is outside the CLI-only product boundary.',
     },
     { name: 'context', disposition: 'included', visibility: 'conditional' },
-    { name: 'cost', disposition: 'included', visibility: 'conditional' },
+    {
+        name: 'cost',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'The dedicated /cost contract is required; /status is not a substitute.',
+    },
     { name: 'diff', disposition: 'included', visibility: 'visible' },
-    { name: 'doctor', disposition: 'included', visibility: 'conditional' },
+    {
+        name: 'doctor',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'Interactive /doctor is required; the top-level command is not a substitute.',
+    },
     { name: 'effort', disposition: 'included', visibility: 'visible' },
     { name: 'exit', disposition: 'included', visibility: 'visible' },
-    { name: 'fast', disposition: 'included', visibility: 'conditional' },
+    {
+        name: 'fast',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'The /fast state flow is required; model and effort controls are not a substitute.',
+    },
     {
         name: 'files',
         disposition: 'excluded',
         visibility: 'conditional',
         reason: 'The source command is restricted to the internal Ant user type.',
     },
-    { name: 'heapdump', disposition: 'included', visibility: 'hidden' },
+    {
+        name: 'heapdump',
+        disposition: 'deferred',
+        visibility: 'hidden',
+        reason: 'The hidden heap-diagnostic contract is required parity work and is not implemented yet.',
+    },
     { name: 'help', disposition: 'included', visibility: 'visible' },
     {
         name: 'ide',
@@ -89,7 +119,12 @@ export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
         reason: 'Remote-session URLs and QR codes are outside the local-only boundary.',
     },
     { name: 'skills', disposition: 'included', visibility: 'visible' },
-    { name: 'stats', disposition: 'included', visibility: 'visible' },
+    {
+        name: 'stats',
+        disposition: 'deferred',
+        visibility: 'visible',
+        reason: 'Historical usage statistics are required parity work and are not implemented yet.',
+    },
     { name: 'status', disposition: 'included', visibility: 'visible' },
     { name: 'statusline', disposition: 'included', visibility: 'visible' },
     {
@@ -149,7 +184,12 @@ export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
         visibility: 'conditional',
         reason: 'The source command is the Claude subscription plan-usage panel.',
     },
-    { name: 'insights', disposition: 'included', visibility: 'visible' },
+    {
+        name: 'insights',
+        disposition: 'deferred',
+        visibility: 'visible',
+        reason: 'Retrospective insights are required parity work and are not implemented yet.',
+    },
     { name: 'vim', disposition: 'included', visibility: 'visible' },
     {
         name: 'web-setup',
@@ -158,10 +198,30 @@ export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
         reason: 'Remote setup is outside the local-only boundary.',
     },
     { name: 'fork', disposition: 'included', visibility: 'conditional' },
-    { name: 'buddy', disposition: 'included', visibility: 'conditional' },
-    { name: 'proactive', disposition: 'included', visibility: 'conditional' },
-    { name: 'brief', disposition: 'included', visibility: 'conditional' },
-    { name: 'assistant', disposition: 'included', visibility: 'conditional' },
+    {
+        name: 'buddy',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'This conditional source mode is required parity work and is not implemented yet.',
+    },
+    {
+        name: 'proactive',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'This conditional source mode is required parity work and is not implemented yet.',
+    },
+    {
+        name: 'brief',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'This conditional source mode is required parity work and is not implemented yet.',
+    },
+    {
+        name: 'assistant',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'This conditional source mode is required parity work and is not implemented yet.',
+    },
     {
         name: 'remote-control',
         disposition: 'excluded',
@@ -174,9 +234,24 @@ export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
         visibility: 'conditional',
         reason: 'Remote Control is outside the local-only boundary.',
     },
-    { name: 'voice', disposition: 'included', visibility: 'conditional' },
-    { name: 'think-back', disposition: 'included', visibility: 'conditional' },
-    { name: 'thinkback-play', disposition: 'included', visibility: 'hidden' },
+    {
+        name: 'voice',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'Conditional voice input is required parity work and is not implemented yet.',
+    },
+    {
+        name: 'think-back',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'The conditional retrospective flow is required parity work and is not implemented yet.',
+    },
+    {
+        name: 'thinkback-play',
+        disposition: 'deferred',
+        visibility: 'hidden',
+        reason: 'The hidden retrospective playback flow is required parity work and is not implemented yet.',
+    },
     { name: 'permissions', disposition: 'included', visibility: 'visible' },
     { name: 'plan', disposition: 'included', visibility: 'visible' },
     {
@@ -214,7 +289,12 @@ export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
     },
     { name: 'tasks', disposition: 'included', visibility: 'visible' },
     { name: 'workflows', disposition: 'included', visibility: 'conditional' },
-    { name: 'torch', disposition: 'included', visibility: 'conditional' },
+    {
+        name: 'torch',
+        disposition: 'deferred',
+        visibility: 'conditional',
+        reason: 'This source-gated behavior is required conditional parity work and is not implemented yet.',
+    },
 ];
 export const CLAUDE_2_1_208_COMMAND_BY_NAME = new Map(CLAUDE_2_1_208_COMMAND_INVENTORY.map((entry) => [entry.name, entry]));
 //# sourceMappingURL=claude-command-inventory.js.map

package/dist/cli/tui/release-notes.d.ts

@@ -0,0 +1,10 @@
+export declare const CLAUDE_CHANGELOG_URL = "https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md";
+export interface ReleaseNotesOptions {
+    configRoot: string;
+    fetcher?: typeof fetch;
+    timeoutMs?: number;
+}
+export declare function parseClaudeChangelog(content: string): readonly [version: string, notes: readonly string[]][];
+export declare function formatClaudeReleaseNotes(content: string): string | null;
+export declare function loadClaudeReleaseNotes({ configRoot, fetcher, timeoutMs, }: ReleaseNotesOptions): Promise<string>;
+//# sourceMappingURL=release-notes.d.ts.map