praxis-agent 0.20.16 → 0.20.20

package/README.md

@@ -88,7 +88,9 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
 
 ## What Praxis provides
 
-- **Local agent runtime** — Claude-style responsive TUI with a shared-command
+- **Local agent runtime** — Claude-style responsive TUI with a fixed fullscreen
+  viewport, non-shrinking composer/status area, and complete bounded welcome
+  surface, plus a shared-command
   slash palette, tabbed help and shortcut surfaces, searchable resume picker,
   restored active-branch conversation history, streaming and expandable
   thinking, grouped multi-file reads, globally expandable tool results,

package/dist/application/scheduled-prompt-manager.d.ts

@@ -38,6 +38,7 @@ export declare class ScheduledPromptManager {
     private readonly sessionTasks;
     private readonly dueAt;
     private readonly dueQueue;
+    private readonly pendingConfirmations;
     private readonly dynamicWakeups;
     private readonly dynamicLoopStates;
     private readonly durableIds;
@@ -54,6 +55,9 @@ export declare class ScheduledPromptManager {
     create(input: CreateScheduledPromptInput): Promise<ListedScheduledPrompt>;
     list(): Promise<ListedScheduledPrompt[]>;
     delete(id: string): Promise<boolean>;
+    pendingScheduledPrompts(): ScheduledPrompt[];
+    approveScheduledPrompt(id: string): boolean;
+    declineScheduledPrompt(id: string): boolean;
     scheduleWakeup(input: {
         delaySeconds: number;
         prompt: string;

package/dist/application/scheduled-prompt-manager.js

@@ -97,6 +97,7 @@ export class ScheduledPromptManager {
     sessionTasks = new Map();
     dueAt = new Map();
     dueQueue = [];
+    pendingConfirmations = new Map();
     dynamicWakeups = new Map();
     dynamicLoopStates = new Map();
     durableIds = new Set();
@@ -181,10 +182,29 @@ export class ScheduledPromptManager {
     async delete(id) {
         await this.initialize();
         const removed = await this.removeTask(id);
-        if (removed) {
+        const declined = this.pendingConfirmations.delete(id);
+        if (removed || declined) {
             this.dueAt.delete(id);
             this.notifyChange();
         }
+        return removed || declined;
+    }
+    pendingScheduledPrompts() {
+        return [...this.pendingConfirmations.values()];
+    }
+    approveScheduledPrompt(id) {
+        const pending = this.pendingConfirmations.get(id);
+        if (!pending)
+            return false;
+        this.pendingConfirmations.delete(id);
+        this.dueQueue.push(pending);
+        this.notifyChange();
+        return true;
+    }
+    declineScheduledPrompt(id) {
+        const removed = this.pendingConfirmations.delete(id);
+        if (removed)
+            this.notifyChange();
         return removed;
     }
     scheduleWakeup(input) {
@@ -278,6 +298,7 @@ export class ScheduledPromptManager {
         this.sessionTasks.clear();
         this.dueAt.clear();
         this.durableIds.clear();
+        this.pendingConfirmations.clear();
         this.dueQueue.length = 0;
         this.notifyChange();
     }
@@ -316,7 +337,15 @@ export class ScheduledPromptManager {
                 if (this.closed)
                     return;
                 this.durableIds.delete(task.id);
-                this.dueQueue.push({ id: task.id, prompt: task.prompt });
+                if (task.recurring) {
+                    this.dueQueue.push({ id: task.id, prompt: task.prompt });
+                }
+                else {
+                    this.pendingConfirmations.set(task.id, {
+                        id: task.id,
+                        prompt: task.prompt,
+                    });
+                }
             }
         }
     }

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

@@ -13,6 +13,7 @@ import type { ClaudeHookRunner } from '../hooks/claude-hooks.js';
 import { type TranscriptParseIssue } from '../persistence/claude-transcript-store.js';
 import type { ClaudeCostStateStore } from '../persistence/claude-cost-state-store.js';
 import { type AgentPermissionMode } from './subagent-service.js';
+import { type ScheduledPrompt } from './scheduled-prompt-manager.js';
 import { type WorkflowTaskSnapshot } from './workflow-manager.js';
 import type { WorkspaceContext } from './session-worktree.js';
 import { type ClaudeSessionCostSnapshot } from './session-cost-tracker.js';
@@ -157,6 +158,7 @@ export declare class ClaudeSessionService {
     private readonly backgroundTasks;
     private readonly worktreeManager;
     private readonly sessionCwds;
+    private readonly discoveredProjectRoots;
     private readonly sessionPermissionUpdates;
     private readonly hostedSubagents;
     private readonly hostedSubagentsByRegistry;
@@ -169,7 +171,9 @@ export declare class ClaudeSessionService {
     private closeCostSavePromise;
     private runtimeCwd;
     constructor(options: ClaudeSessionServiceOptions);
-    nextScheduledPrompt(signal?: AbortSignal): Promise<import("./scheduled-prompt-manager.js").ScheduledPrompt | null>;
+    nextScheduledPrompt(signal?: AbortSignal): Promise<ScheduledPrompt | null>;
+    private nextScheduledPromptForManager;
+    private confirmPendingScheduledPrompt;
     workflows(): readonly WorkflowTaskSnapshot[];
     mcpInspect(): Promise<readonly ClaudeMcpServerStatus[]>;
     mcpReconnect(name: string): Promise<void>;
@@ -231,6 +235,7 @@ export declare class ClaudeSessionService {
     private activeCwd;
     private restoreWorktree;
     private paths;
+    private discoverProjectRoot;
     private appendCdCommand;
     private appendAgentColorUsage;
     private appendSystemLocalCommand;

package/dist/application/session-service.js

@@ -1,10 +1,10 @@
 import { randomUUID } from 'node:crypto';
 import { appendFile, copyFile, link, lstat, mkdir, readdir, realpath, stat, unlink, } from 'node:fs/promises';
 import { homedir } from 'node:os';
-import { basename, extname, isAbsolute, join, relative } from 'node:path';
+import { basename, extname, isAbsolute, join, relative, resolve, } from 'node:path';
 import { AGENT_COLOR_DEFAULT, agentColorMessage, getClaudeEffectiveAgentColor, } from '../compatibility/claude/agent-color.js';
 import { createClaudeCompactEntries, formatClaudeCompactSummary, getCumulativeDroppedTokens, } from '../compatibility/claude/compaction.js';
-import { isClaudeSessionId, resolveClaudePaths, resolveClaudeScheduledTaskFile, } from '../compatibility/claude/paths.js';
+import { discoverClaudeProjectRoot, isClaudeSessionId, resolveClaudePaths, resolveClaudeScheduledTaskFile, } from '../compatibility/claude/paths.js';
 import { downloadClaudeFileResources, } from '../compatibility/claude/file-resources.js';
 import { createClaudeNativeFork } from '../compatibility/claude/fork.js';
 import { selectClaudeActiveTranscript, selectClaudeTranscriptAtMessage, } from '../compatibility/claude/history.js';
@@ -24,7 +24,7 @@ import { ClaudeTranscriptStore, } from '../persistence/claude-transcript-store.j
 import { InMemoryTranscriptStore } from '../persistence/in-memory-transcript-store.js';
 import { ModelCompactor } from './model-compactor.js';
 import { agentMemoryPrompt, ClaudeSubagentExecutor, StructuredOutputRegistry, } from './subagent-service.js';
-import { ScheduledPromptManager } from './scheduled-prompt-manager.js';
+import { ScheduledPromptManager, } from './scheduled-prompt-manager.js';
 import { ClaudeScheduledToolRegistry } from '../tools/claude-scheduled-tools.js';
 import { ClaudeTaskToolRegistry } from '../tools/claude-task-tools.js';
 import { ClaudeWorkflowToolRegistry } from '../tools/claude-workflow-tools.js';
@@ -312,6 +312,7 @@ export class ClaudeSessionService {
     backgroundTasks;
     worktreeManager;
     sessionCwds = new Map();
+    discoveredProjectRoots = new Map();
     sessionPermissionUpdates = new Map();
     hostedSubagents = new Set();
     hostedSubagentsByRegistry = new WeakMap();
@@ -359,7 +360,53 @@ export class ClaudeSessionService {
         }
     }
     nextScheduledPrompt(signal) {
-        return this.scheduledPrompts?.next(signal) ?? Promise.resolve(null);
+        const manager = this.scheduledPrompts;
+        if (!manager)
+            return Promise.resolve(null);
+        return this.nextScheduledPromptForManager(manager, signal);
+    }
+    async nextScheduledPromptForManager(manager, signal) {
+        // Scan durable tasks so a missed one-shot surfaces as a pending
+        // confirmation instead of silently entering the normal due drain.
+        await manager.list();
+        const pending = manager.pendingScheduledPrompts()[0];
+        if (!pending)
+            return manager.next(signal);
+        const askUser = this.options.interactiveTools?.callbacks.askUser;
+        if (!askUser)
+            return manager.next(signal);
+        const approved = await this.confirmPendingScheduledPrompt(manager, pending, askUser, signal);
+        if (!approved)
+            return null;
+        // Consume the approved prompt from the scheduler due queue exactly once.
+        return manager.next(signal);
+    }
+    async confirmPendingScheduledPrompt(manager, pending, askUser, signal) {
+        const question = {
+            header: 'Missed scheduled prompt',
+            question: pending.prompt,
+            options: [
+                {
+                    label: 'Run now',
+                    description: 'Run this scheduled prompt that was missed while Praxis was not running.',
+                },
+                {
+                    label: 'Skip',
+                    description: 'Decline this scheduled prompt and discard it.',
+                },
+            ],
+            multiSelect: false,
+        };
+        const result = await askUser([question], signal);
+        const decision = result?.answers[question.question];
+        if (decision === 'Run now') {
+            return manager.approveScheduledPrompt(pending.id);
+        }
+        if (decision === 'Skip') {
+            manager.declineScheduledPrompt(pending.id);
+            return false;
+        }
+        return false;
     }
     workflows() {
         return this.workflowManager?.list() ?? [];
@@ -817,23 +864,31 @@ export class ClaudeSessionService {
         return validSessionName(metrics.text);
     }
     async sessions() {
-        const paths = this.paths(randomUUID());
+        const discoveredRoot = await discoverClaudeProjectRoot({
+            configRoot: this.options.configRoot,
+            cwd: this.activeCwd(),
+        });
+        const projectRoot = discoveredRoot ?? this.paths(randomUUID()).projectRoot;
         let names;
         try {
-            names = await readdir(paths.projectRoot);
+            names = await readdir(projectRoot);
         }
         catch (error) {
             if (error.code === 'ENOENT')
                 return [];
             throw error;
         }
-        const summaries = await Promise.all(names
+        const sessionIds = names
             .filter((name) => extname(name) === '.jsonl')
-            .map(async (name) => {
-            const sessionId = basename(name, '.jsonl');
-            if (!isClaudeSessionId(sessionId))
-                return null;
-            const sessionFile = join(paths.projectRoot, name);
+            .map((name) => basename(name, '.jsonl'))
+            .filter((sessionId) => isClaudeSessionId(sessionId));
+        if (discoveredRoot !== undefined) {
+            for (const sessionId of sessionIds) {
+                this.discoveredProjectRoots.set(sessionId, projectRoot);
+            }
+        }
+        const summaries = await Promise.all(sessionIds.map(async (sessionId) => {
+            const sessionFile = join(projectRoot, `${sessionId}.jsonl`);
             try {
                 const metadata = await lstat(sessionFile);
                 if (!metadata.isFile())
@@ -872,6 +927,7 @@ export class ClaudeSessionService {
     }
     async inspect(sessionId) {
         this.assertSessionPersistence();
+        await this.discoverProjectRoot(sessionId);
         const paths = this.paths(sessionId);
         let metadata;
         try {
@@ -912,6 +968,7 @@ export class ClaudeSessionService {
     }
     async export(sessionId) {
         this.assertSessionPersistence();
+        await this.discoverProjectRoot(sessionId);
         try {
             return await this.store(sessionId).exportReadOnly();
         }
@@ -923,6 +980,7 @@ export class ClaudeSessionService {
         }
     }
     async transcript(sessionId, resumeSessionAt) {
+        await this.discoverProjectRoot(sessionId);
         try {
             const recovery = await this.store(sessionId).loadReadOnly();
             if (recovery.entries.length === 0) {
@@ -1048,6 +1106,9 @@ export class ClaudeSessionService {
                 if (relocated.status === 'conflict') {
                     throw new Error(`Claude transcript relocation conflict: ${relocated.reason}`);
                 }
+                // The transcript moved to the exact root for the new cwd; any
+                // previously discovered alternate-hash root is now stale.
+                this.discoveredProjectRoots.delete(sessionId);
             }
             else {
                 await this.appendCdCommand(sessionId, cwd);
@@ -1664,6 +1725,9 @@ export class ClaudeSessionService {
             this.options.workspace?.setCwd(pinnedCwd);
         }
         this.runtimeCwd = pinnedCwd;
+        if (requireExisting) {
+            await this.discoverProjectRoot(sessionId);
+        }
         const sessionPaths = this.paths(sessionId);
         const toolResultDirectory = join(sessionPaths.projectRoot, sessionId, 'tool-results');
         const store = this.turnStore(sessionId);
@@ -3091,11 +3155,31 @@ export class ClaudeSessionService {
         this.worktreeManager.restore(state);
     }
     paths(sessionId) {
-        return resolveClaudePaths({
+        const exact = resolveClaudePaths({
             configDir: this.options.configRoot,
             cwd: this.sessionCwds.get(sessionId) ?? this.activeCwd(),
             sessionId,
         });
+        const discovered = this.discoveredProjectRoots.get(sessionId);
+        if (discovered === undefined)
+            return exact;
+        return {
+            ...exact,
+            projectRoot: discovered,
+            sessionFile: resolve(discovered, `${sessionId}.jsonl`),
+        };
+    }
+    async discoverProjectRoot(sessionId) {
+        if (this.discoveredProjectRoots.has(sessionId))
+            return;
+        const discovered = await discoverClaudeProjectRoot({
+            configRoot: this.options.configRoot,
+            cwd: this.sessionCwds.get(sessionId) ?? this.activeCwd(),
+            sessionId,
+        });
+        if (discovered !== undefined) {
+            this.discoveredProjectRoots.set(sessionId, discovered);
+        }
     }
     async appendCdCommand(sessionId, cwd) {
         const result = await this.store(sessionId).withLease(async (lease) => {

package/dist/cli/interactive.js

@@ -11,7 +11,7 @@ import { permissionRuleValueToString } from '../permissions/permission-updates.j
 import { AgentRunCancelledError } from '../core/runtime.js';
 import { claudePermissionActionKey, claudePermissionRuleMatches, } from '../permissions/claude-permission-resolver.js';
 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 { CommandPalette, BtwPanel, Composer, DiffDashboard, DialogFrame, ExternalEditorWait, HelpMenu, HookDashboard, ListDashboard, MemoryDashboard, MentionPicker, ModelMenu, PermissionDashboard, SelectionMenu, SessionPicker, ThemePicker, CustomThemeEditor, Transcript, WelcomePanel, useTerminalRows, 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';
@@ -264,6 +264,7 @@ const HIDDEN_TUI_SLASH_COMMANDS = new Set([
 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 rows = useTerminalRows();
     const keybindingsRoot = useMemo(() => resolve(keybindingsConfigRoot ??
         process.env.CLAUDE_CONFIG_DIR ??
         resolve(homedir(), '.claude')), [keybindingsConfigRoot]);
@@ -320,6 +321,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const [themeSettings, setThemeSettings] = useState(initialThemeSettings ?? DEFAULT_TUI_THEME_SETTINGS);
     const [runtimeSettings, setRuntimeSettings] = useState(suppliedRuntimeSettings ??
         projectRuntimeSettings({ settings: {}, state: {} }));
+    const fixedViewport = runtimeSettings.tui === 'fullscreen' && rows !== undefined;
     const runtimeSettingsRef = useRef(runtimeSettings);
     runtimeSettingsRef.current = runtimeSettings;
     runtimeGitignoreRef.current = runtimeSettings.gitignore;
@@ -5626,7 +5628,9 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         }
         editComposer();
     });
-    return (_jsx(TuiThemeProvider, { settings: themeSettings, children: _jsx(Box, { flexDirection: "column", children: selectingSession ? (_jsx(SessionPicker, { sessions: filteredPickerChoices, selectedIndex: selectedIndex, screenReader: axScreenReader, query: sessionSearch })) : (_jsxs(_Fragment, { children: [!axScreenReader && history.length === 0 && !sessionId ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width, showTips: runtimeSettings.tips })) : null, sessionId ? (_jsxs(Text, { dimColor: true, children: ["Session ", sessionId.slice(0, 8)] })) : null, _jsx(Transcript, { items: history, activeText: activeText, activeThinking: activeThinking, thinkingExpanded: thinkingExpanded, detailedTranscript: thinkingExpanded || runtimeSettings.verbose, screenReader: axScreenReader }), externalEditorRequest !== null ||
+    return (_jsx(TuiThemeProvider, { settings: themeSettings, children: _jsx(Box, { flexDirection: "column", ...(!fixedViewport
+                ? {}
+                : { height: rows, overflowY: 'hidden' }), children: selectingSession ? (_jsx(SessionPicker, { sessions: filteredPickerChoices, selectedIndex: selectedIndex, screenReader: axScreenReader, query: sessionSearch })) : (_jsxs(_Fragment, { children: [!axScreenReader && history.length === 0 && !sessionId ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width, showTips: runtimeSettings.tips })) : null, sessionId ? (_jsxs(Text, { dimColor: true, children: ["Session ", sessionId.slice(0, 8)] })) : null, _jsx(Transcript, { items: history, activeText: activeText, activeThinking: activeThinking, thinkingExpanded: thinkingExpanded, detailedTranscript: thinkingExpanded || runtimeSettings.verbose, screenReader: axScreenReader }), externalEditorRequest !== null ||
                         keybindingsEditing ||
                         memoryEditorRequest !== null ? (_jsx(ExternalEditorWait, { screenReader: axScreenReader })) : permission ? (permission.kind === 'tool' && toolPermissionModel ? (_jsx(ToolPermissionDialog, { model: toolPermissionModel, selection: permissionSelection, feedbackMode: permissionFeedbackMode, feedback: input, ruleEditor: permissionRuleEditor, screenReader: axScreenReader })) : (_jsxs(DialogFrame, { title: `Retry interrupted ${permission.call.name}?`, screenReader: axScreenReader, children: [_jsx(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: _jsx(Text, { bold: true, children: describeTool(permission.call, sensitiveValues) }) }), _jsx(Text, { children: "Do you want to proceed?" }), _jsxs(Text, { inverse: !axScreenReader && permissionSelection === 0, children: [selectionPrefix(permissionSelection === 0, axScreenReader), "1. Yes"] }), _jsxs(Text, { inverse: !axScreenReader && permissionSelection === 1, children: [selectionPrefix(permissionSelection === 1, axScreenReader), "2. No"] }), permissionFeedbackMode ? (_jsxs(Text, { children: ["\u203A", ' ', input ||
                                         (permissionSelection === 0
@@ -5762,7 +5766,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                                     sessionName,
                                     usage?.inputTokens,
                                     usage?.outputTokens,
-                                ].join(':'), ...(settingSources === undefined ? {} : { settingSources }) })] }))] })) }) }));
+                                ].join(':'), width: width, ...(settingSources === undefined ? {} : { settingSources }) })] }))] })) }) }));
 }
 export async function runInteractive(options) {
     const controller = new AbortController();

package/dist/cli/tui/claude-style.d.ts

@@ -71,6 +71,7 @@ export interface TuiBtwEntry {
     error?: string;
 }
 export declare function useTerminalWidth(override?: number): number;
+export declare function useTerminalRows(override?: number): number | undefined;
 export declare function WelcomePanel({ display, width, showTips, }: {
     display: TuiDisplayMetadata;
     width: number;

package/dist/cli/tui/claude-style.js

@@ -22,6 +22,23 @@ export function useTerminalWidth(override) {
     }, [override, stdout]);
     return Math.max(32, width);
 }
+export function useTerminalRows(override) {
+    const { stdout } = useStdout();
+    const initialRows = override ?? (stdout.isTTY ? stdout.rows : undefined);
+    const [rows, setRows] = useState(initialRows);
+    useEffect(() => {
+        if (override !== undefined) {
+            setRows(override);
+            return;
+        }
+        const resize = () => setRows(stdout.rows);
+        stdout.on('resize', resize);
+        return () => {
+            stdout.off('resize', resize);
+        };
+    }, [override, stdout]);
+    return rows === undefined ? undefined : Math.max(12, rows);
+}
 function compactPath(cwd) {
     const home = process.env.HOME;
     return home && cwd.startsWith(`${home}/`)
@@ -44,6 +61,45 @@ function permissionLabel(mode) {
             return 'permissions default';
     }
 }
+function compactPermissionLabel(mode) {
+    switch (mode) {
+        case 'acceptEdits':
+            return 'accept edits';
+        case 'bypassPermissions':
+            return 'bypass';
+        case 'dontAsk':
+            return 'dont ask';
+        case 'plan':
+            return 'plan';
+        case 'auto':
+            return 'auto';
+        default:
+            return 'default';
+    }
+}
+// Width-prioritized composer footer left text. The footer is one deliberate,
+// non-wrapping line: mode and the busy/effort state always win, while
+// shortcuts/agents/thinking hints are dropped or shortened as width shrinks.
+function composerFooterLeft(width, busy, hasThinking, thinkingExpanded, mode, compactMode, includeHints = true) {
+    const cancelOrShortcut = busy ? 'esc to interrupt' : '? for shortcuts';
+    if (!includeHints) {
+        if (busy)
+            return `${width >= 60 ? mode : compactMode} · ${cancelOrShortcut}`;
+        return width >= 60 ? mode : compactMode;
+    }
+    if (width >= 60) {
+        let text = `${mode} · ${cancelOrShortcut}`;
+        if (width >= 80)
+            text += ' · ← for agents';
+        if (width >= 100 && hasThinking) {
+            text += ` · ctrl+o ${thinkingExpanded ? 'collapse' : 'expand'}`;
+        }
+        return text;
+    }
+    if (busy)
+        return `${compactMode} · ${cancelOrShortcut}`;
+    return width >= 40 ? mode : compactMode;
+}
 function selectionPrefix(selected, screenReader) {
     if (selected)
         return screenReader ? 'Selected: ' : '  ❯ ';
@@ -54,7 +110,7 @@ export function WelcomePanel({ display, width, showTips, }) {
     if (!showTips)
         return null;
     const panelWidth = Math.min(100, Math.max(32, width));
-    const wide = panelWidth >= 68;
+    const wide = panelWidth >= 72;
     const brand = 'Praxis';
     const model = display.model ?? 'provider default';
     const effort = display.effort ? ` · ${display.effort} effort` : '';
@@ -63,9 +119,11 @@ export function WelcomePanel({ display, width, showTips, }) {
     //   ╭───Praxis Code vX.Y.Z ───...───╮
     // Fixed prefix/suffix = "╭───"(4) + "Praxis"(6) + " Code vX.Y.Z "(8 + version)
     // + "╮"(1), so the fill keeps the row exactly at panelWidth.
-    const fill = Math.max(1, panelWidth - display.version.length - 19);
-    const identity = `Welcome to ${brand} · ${model}${effort} · ${cwd}`;
-    return (_jsxs(Box, { flexDirection: "column", width: panelWidth, children: [_jsxs(Text, { color: palette.muted, children: ['╭───', _jsx(Text, { color: palette.brand, bold: true, children: brand }), ` Code v${display.version} `, _jsx(Text, { dimColor: true, children: '─'.repeat(fill) }), '╮'] }), wide ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: identity }), _jsx(Text, { children: "/init to create CLAUDE.md \u00B7 /config to open settings" })] })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["Welcome to ", brand] }), _jsxs(Text, { children: [model, effort] }), _jsx(Text, { children: cwd }), _jsx(Text, { children: "/init to create CLAUDE.md" }), _jsx(Text, { children: "/config to open settings" })] }))] }));
+    const title = `${brand} Code v${display.version}`;
+    const fill = Math.max(1, panelWidth - title.length - 6);
+    const leftWidth = Math.max(12, Math.floor((panelWidth - 4) / 2));
+    const rightWidth = Math.max(12, panelWidth - leftWidth - 4);
+    return (_jsxs(Box, { flexDirection: "column", width: panelWidth, children: [_jsxs(Text, { color: palette.muted, children: ['╭───', _jsx(Text, { color: palette.brand, bold: true, children: brand }), ` Code v${display.version} `, _jsx(Text, { dimColor: true, children: '─'.repeat(fill) }), '╮'] }), _jsxs(Box, { borderStyle: "round", borderColor: palette.muted, borderTop: false, flexDirection: wide ? 'row' : 'column', width: panelWidth, paddingX: 1, children: [_jsxs(Box, { alignItems: wide ? 'center' : undefined, flexDirection: "column", width: wide ? leftWidth : '100%', children: [_jsx(Text, { children: " " }), _jsxs(Text, { bold: true, children: ["Welcome to ", brand] }), _jsx(Text, { children: " " }), _jsx(Text, { color: palette.brand, bold: true, children: "\u2590\u259B\u2588\u2588\u2588\u259C\u258C" }), _jsx(Text, { color: palette.brand, children: "\u259D\u259C\u2588\u2588\u2588\u2588\u2588\u259B\u2598" }), _jsx(Text, { color: palette.brand, children: " \u2598\u2598 \u259D\u259D" }), _jsx(Text, { children: " " }), _jsxs(Text, { wrap: "truncate-end", children: [model, effort] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd })] }), _jsxs(Box, { flexDirection: "column", width: wide ? rightWidth : '100%', marginTop: wide ? 0 : 1, children: [_jsx(Text, { bold: true, children: "Get started" }), _jsx(Text, { wrap: "truncate-end", children: "/init to create CLAUDE.md" }), _jsx(Text, { wrap: "truncate-end", children: "/config to open settings" }), _jsx(Text, { dimColor: true, children: " " }), _jsx(Text, { bold: true, children: "Shared with Claude Code" }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Sessions \u00B7 memory \u00B7 skills" })] })] })] }));
 }
 const INLINE_SEGMENT_CACHE_MAX = 4096;
 const inlineSegmentCache = new Map();
@@ -866,7 +924,12 @@ export function Composer({ input, cursor, busy, clipboardBusy = false, status, d
                         : `Prompt: ${input}` }));
     const line = '─'.repeat(Math.max(12, Math.min(100, width)));
     const separatorColor = sessionColor === undefined ? undefined : palette.sessionColors[sessionColor];
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [usage ? (_jsxs(Text, { dimColor: true, children: ["Context \u00B7 ", usage.inputTokens + usage.outputTokens, " tokens", display.contextWindowTokens
+    const footerWidth = Math.min(100, width);
+    const footerMode = `⏵⏵ ${permissionLabel(display.permissionMode)}`;
+    const footerCompactMode = `⏵⏵ ${compactPermissionLabel(display.permissionMode)}`;
+    const footerLeft = composerFooterLeft(footerWidth, busy, hasThinking, thinkingExpanded, footerMode, footerCompactMode);
+    const footerMessageLeft = composerFooterLeft(footerWidth, busy, hasThinking, thinkingExpanded, footerMode, footerCompactMode, false);
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, flexShrink: 0, children: [usage ? (_jsxs(Text, { dimColor: true, children: ["Context \u00B7 ", usage.inputTokens + usage.outputTokens, " tokens", display.contextWindowTokens
                         ? ` / ${display.contextWindowTokens} (${Math.min(100, Math.round(((usage.inputTokens + usage.outputTokens) /
                             display.contextWindowTokens) *
                             100))}%)`
@@ -878,9 +941,7 @@ export function Composer({ input, cursor, busy, clipboardBusy = false, status, d
                             ? 'Enter a shell command'
                             : 'Try "review this project"' }))] })), _jsx(Text, { ...(separatorColor === undefined
                     ? { dimColor: true }
-                    : { color: separatorColor }), children: line }), shortcutsVisible ? (_jsx(ShortcutHelp, { width: width })) : (_jsxs(Box, { width: Math.min(100, width), children: [_jsx(Text, { dimColor: true, children: shellMode ? ('! for bash mode') : (_jsxs(_Fragment, { children: ["\u23F5\u23F5 ", permissionLabel(display.permissionMode), " \u00B7", ' ', busy ? 'esc to interrupt' : '? for shortcuts', " \u00B7 \u2190 for agents", hasThinking
-                                    ? ` · ctrl+o ${thinkingExpanded ? 'collapse' : 'expand'}`
-                                    : ''] })) }), _jsx(Box, { flexGrow: 1 }), footerMessage ? (footerMessage.isError ? (_jsx(Text, { color: palette.error, children: footerMessage.text })) : (_jsx(Text, { dimColor: true, children: footerMessage.text }))) : prStatus ? (_jsx(Text, { dimColor: true, children: prStatus })) : turnDuration ? (_jsxs(Text, { dimColor: true, children: ["Cooked for ", turnDuration] })) : display.effort ? (_jsxs(Text, { children: [_jsxs(Text, { color: palette.accent, children: ["\u25CF ", display.effort] }), _jsxs(Text, { dimColor: true, children: [' ', "\u00B7 ", editorMode === 'vim' ? 'vim' : '/effort'] })] })) : null] }))] }));
+                    : { color: separatorColor }), children: line }), shortcutsVisible ? (_jsx(ShortcutHelp, { width: width })) : (_jsx(Box, { width: footerWidth, children: _jsx(Text, { wrap: "truncate", children: shellMode ? (_jsx(Text, { dimColor: true, children: "! for bash mode" })) : footerMessage ? (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: [footerMessageLeft, " \u00B7 "] }), footerMessage.isError ? (_jsx(Text, { color: palette.error, children: footerMessage.text })) : (_jsx(Text, { dimColor: true, children: footerMessage.text }))] })) : prStatus ? (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: [footerLeft, " \u00B7 "] }), _jsx(Text, { dimColor: true, children: prStatus })] })) : turnDuration ? (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: [footerLeft, " \u00B7 "] }), _jsxs(Text, { dimColor: true, children: ["Cooked for ", turnDuration] })] })) : display.effort ? (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: footerLeft }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsxs(Text, { color: palette.accent, children: ["\u25CF ", display.effort] }), footerWidth >= 100 ? (_jsxs(Text, { dimColor: true, children: [' ', "\u00B7 ", editorMode === 'vim' ? 'vim' : '/effort'] })) : null] })) : (_jsx(Text, { dimColor: true, children: footerLeft })) }) }))] }));
 }
 export function DialogFrame({ title, children, screenReader, }) {
     const palette = useTuiPalette();

package/dist/cli/tui/status-line.d.ts

@@ -61,6 +61,7 @@ export declare function executeClaudeStatusLine(setting: ClaudeStatusLineSetting
     cwd: string;
     signal?: AbortSignal;
     timeoutMs?: number;
+    columns?: number;
 }): Promise<string | undefined>;
 export declare function createClaudeStatusLineInput(options: {
     configRoot: string;
@@ -78,11 +79,12 @@ export declare function createClaudeStatusLineInput(options: {
     contextWindowTokens?: number;
     vimMode?: 'INSERT' | 'NORMAL';
 }): ClaudeStatusLineInput;
-export declare function StatusLine({ configRoot, cwd, input, refreshKey, settingSources, }: {
+export declare function StatusLine({ configRoot, cwd, input, refreshKey, width, settingSources, }: {
     configRoot: string;
     cwd: string;
     input: ClaudeStatusLineInput;
     refreshKey: string;
+    width?: number;
     settingSources?: readonly ClaudeResourceScope[];
 }): import("react").JSX.Element | null;
 //# sourceMappingURL=status-line.d.ts.map

package/dist/cli/tui/status-line.js

@@ -49,10 +49,16 @@ export async function executeClaudeStatusLine(setting, input, options = {
         };
         let child;
         try {
+            const env = { ...process.env };
+            if (options.columns !== undefined &&
+                Number.isFinite(options.columns) &&
+                options.columns > 0) {
+                env.COLUMNS = String(Math.trunc(options.columns));
+            }
             child = spawn(commandShell(), commandShellArguments(setting.command), {
                 cwd: options.cwd,
                 detached: process.platform !== 'win32',
-                env: process.env,
+                env,
                 stdio: ['pipe', 'pipe', 'ignore'],
             });
         }
@@ -169,7 +175,7 @@ export function createClaudeStatusLineInput(options) {
         ...(options.vimMode ? { vim: { mode: options.vimMode } } : {}),
     };
 }
-export function StatusLine({ configRoot, cwd, input, refreshKey, settingSources, }) {
+export function StatusLine({ configRoot, cwd, input, refreshKey, width, settingSources, }) {
     const [text, setText] = useState();
     const [padding, setPadding] = useState(0);
     const timer = useRef(undefined);
@@ -193,7 +199,11 @@ export function StatusLine({ configRoot, cwd, input, refreshKey, settingSources,
                 setText(undefined);
                 return;
             }
-            const result = await executeClaudeStatusLine(loaded.setting, latestInput.current, { cwd, signal: current.signal });
+            const result = await executeClaudeStatusLine(loaded.setting, latestInput.current, {
+                cwd,
+                signal: current.signal,
+                ...(width === undefined ? {} : { columns: width }),
+            });
             if (!current.signal.aborted)
                 setText(result);
         }
@@ -201,7 +211,7 @@ export function StatusLine({ configRoot, cwd, input, refreshKey, settingSources,
             if (!current.signal.aborted)
                 setText(undefined);
         }
-    }, [configRoot, cwd, settingSources]);
+    }, [configRoot, cwd, settingSources, width]);
     const schedule = useCallback(() => {
         if (timer.current)
             clearTimeout(timer.current);
@@ -229,6 +239,6 @@ export function StatusLine({ configRoot, cwd, input, refreshKey, settingSources,
     }, [configRoot, cwd, schedule]);
     if (!text)
         return null;
-    return (_jsx(Box, { paddingX: padding, children: _jsx(Text, { dimColor: true, wrap: "truncate", children: text }) }));
+    return (_jsx(Box, { paddingX: padding, flexShrink: 0, children: _jsx(Text, { dimColor: true, wrap: "truncate", children: text }) }));
 }
 //# sourceMappingURL=status-line.js.map

package/dist/compatibility/claude/paths.d.ts

@@ -12,6 +12,21 @@ export interface ClaudePaths {
     praxisRoot: string;
 }
 export declare function sanitizeClaudeProjectPath(path: string): string;
+export interface DiscoverClaudeProjectRootOptions {
+    configRoot: string;
+    cwd: string;
+    sessionId?: string;
+}
+/**
+ * Locates the Claude project directory for a cwd, preferring the exact
+ * sanitized hash path and falling back to a long-path truncated-prefix
+ * candidate when Claude used a different runtime hash. When a sessionId is
+ * supplied, the exact directory only matches if it contains the requested
+ * regular session file; an existing exact directory without that file still
+ * falls through to the long-path prefix scan. Candidate selection is
+ * directory-prefix based and never uses mtime; ambiguous prefixes are rejected.
+ */
+export declare function discoverClaudeProjectRoot({ configRoot, cwd, sessionId, }: DiscoverClaudeProjectRootOptions): Promise<string | undefined>;
 export declare function resolveClaudeScheduledTaskFile(cwd: string): string;
 export declare function resolveClaudePaths({ cwd, sessionId, configDir, }: ResolveClaudePathsOptions): ClaudePaths;
 //# sourceMappingURL=paths.d.ts.map

package/dist/compatibility/claude/paths.js

@@ -1,5 +1,6 @@
+import { lstat, readdir } from 'node:fs/promises';
 import { homedir } from 'node:os';
-import { resolve } from 'node:path';
+import { extname, resolve } from 'node:path';
 import { getDataOwnership } from './ownership.js';
 const MAX_SANITIZED_LENGTH = 200;
 const SESSION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -21,6 +22,105 @@ export function sanitizeClaudeProjectPath(path) {
     }
     return `${sanitized.slice(0, MAX_SANITIZED_LENGTH)}-${stablePathHash(path).toString(36)}`;
 }
+async function isDirectory(path) {
+    try {
+        return (await lstat(path)).isDirectory();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function isRegularFile(path) {
+    try {
+        return (await lstat(path)).isFile();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function hasClaudeSessionTranscript(directory) {
+    let names;
+    try {
+        names = await readdir(directory);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+    for (const name of names) {
+        if (extname(name) !== '.jsonl')
+            continue;
+        if (!isClaudeSessionId(name.slice(0, -'.jsonl'.length)))
+            continue;
+        if (await isRegularFile(resolve(directory, name)))
+            return true;
+    }
+    return false;
+}
+/**
+ * Locates the Claude project directory for a cwd, preferring the exact
+ * sanitized hash path and falling back to a long-path truncated-prefix
+ * candidate when Claude used a different runtime hash. When a sessionId is
+ * supplied, the exact directory only matches if it contains the requested
+ * regular session file; an existing exact directory without that file still
+ * falls through to the long-path prefix scan. Candidate selection is
+ * directory-prefix based and never uses mtime; ambiguous prefixes are rejected.
+ */
+export async function discoverClaudeProjectRoot({ configRoot, cwd, sessionId, }) {
+    if (sessionId !== undefined && !isClaudeSessionId(sessionId)) {
+        return undefined;
+    }
+    const sanitized = sanitizeClaudeProjectPath(cwd);
+    const exactProjectRoot = resolve(configRoot, 'projects', sanitized);
+    if (sessionId !== undefined) {
+        // A sessionId targets a concrete transcript; an existing exact directory
+        // only matches when it actually holds the requested session file. Praxis
+        // may have created an empty exact directory before the transcript landed
+        // in an alternate long-path prefix directory, so fall through to the
+        // prefix scan instead of returning the empty exact directory.
+        if (await isRegularFile(resolve(exactProjectRoot, `${sessionId}.jsonl`))) {
+            return exactProjectRoot;
+        }
+    }
+    else if (await isDirectory(exactProjectRoot)) {
+        return exactProjectRoot;
+    }
+    if (sanitized.length <= MAX_SANITIZED_LENGTH)
+        return undefined;
+    const prefix = sanitized.slice(0, MAX_SANITIZED_LENGTH);
+    let names;
+    try {
+        names = await readdir(resolve(configRoot, 'projects'));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    const candidates = [];
+    for (const name of names) {
+        if (!name.startsWith(`${prefix}-`))
+            continue;
+        const candidate = resolve(configRoot, 'projects', name);
+        if (!(await isDirectory(candidate)))
+            continue;
+        if (sessionId !== undefined) {
+            if (await isRegularFile(resolve(candidate, `${sessionId}.jsonl`))) {
+                candidates.push(candidate);
+            }
+            continue;
+        }
+        if (await hasClaudeSessionTranscript(candidate)) {
+            candidates.push(candidate);
+        }
+    }
+    return candidates.length === 1 ? candidates[0] : undefined;
+}
 export function resolveClaudeScheduledTaskFile(cwd) {
     const policy = getDataOwnership('scheduled-prompts');
     if (policy.plane !== 'shared' ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "praxis-agent",
-  "version": "0.20.16",
+  "version": "0.20.20",
   "description": "Local-first, single-user general agent for the command line.",
   "license": "MIT",
   "author": "wuqisen",