@xfe-repo/cli 2.0.7 → 2.0.8

package/dist/completion-core.js

@@ -0,0 +1,201 @@
+/**
+ * @xfe-repo/cli - 补全核心（与 UI / shell 协议解耦）
+ *
+ * 集中维护：命令目录条目类型、查询/输入解析、option/value 建议计算、
+ * 已用 flag 过滤、命令寻址、prefilled 提取、模糊匹配。
+ *
+ * 调用方：
+ * - TUI Commands 组件复用全部能力（含模糊匹配 / 二级菜单 / 已用 flag 过滤）
+ * - shell / 其他入口可按需复用 catalog 与 option 建议部分，不依赖 UI
+ */
+import { parseCommandFlagTokens, splitCommandName, splitFlagTokens } from './command.js';
+// ─── Public API ─────────────────────────────────────────────
+/** 解析 query 是否进入二级菜单模式 */
+export function parseQuery(query, options) {
+    if (!query)
+        return { activeGroup: null, subQuery: '', topQuery: '' };
+    const spaceIndex = query.indexOf(' ');
+    if (spaceIndex > 0) {
+        const groupPart = query.slice(0, spaceIndex);
+        const subQuery = query.slice(spaceIndex + 1).trim();
+        const group = options.find((o) => o.type === 'group' && o.name.toLowerCase() === groupPart);
+        if (group)
+            return { activeGroup: group, subQuery, topQuery: '' };
+    }
+    const exactGroup = options.find((o) => o.type === 'group' && o.name.toLowerCase() === query);
+    if (exactGroup)
+        return { activeGroup: exactGroup, subQuery: '', topQuery: '' };
+    return { activeGroup: null, subQuery: '', topQuery: query };
+}
+/** 顶级查询过滤 + 评分排序 */
+export function filterTopLevel(options, query) {
+    return options
+        .filter((item) => fuzzyMatch(item.name, query))
+        .sort((a, b) => matchScore(a.name, query) - matchScore(b.name, query));
+}
+/** 二级子命令过滤：同时尝试匹配完整名和 action 名 */
+export function filterSubCommands(options, query) {
+    return options
+        .filter((opt) => {
+        const action = splitCommandName(opt.name).action;
+        return fuzzyMatch(action, query) || fuzzyMatch(opt.name, query);
+    })
+        .sort((a, b) => {
+        const aAction = splitCommandName(a.name).action;
+        const bAction = splitCommandName(b.name).action;
+        return matchScore(aAction, query) - matchScore(bAction, query);
+    });
+}
+/**
+ * 识别 `<cmd> [--k=v ...] [--partial]` 形式的输入，返回 extras 模式
+ *
+ * 末尾 `--key=` 进入 value 模式；`--key` / `--` / 空 进入 name 模式
+ */
+export function parseExtrasMode(rawQuery, options) {
+    const split = splitCommandAndFlags(rawQuery, options);
+    if (!split || !split.command.options?.length)
+        return null;
+    const { command, flagTokens, endsWithSpace } = split;
+    if (flagTokens.length === 0 && !endsWithSpace)
+        return null;
+    const newFlag = endsWithSpace || flagTokens.length === 0;
+    const usedNames = collectUsedNames(newFlag ? flagTokens : flagTokens.slice(0, -1));
+    if (newFlag)
+        return { kind: 'name', command, partial: '', usedNames };
+    const last = flagTokens[flagTokens.length - 1];
+    if (!last.startsWith('--'))
+        return null;
+    const eqIdx = last.indexOf('=');
+    if (eqIdx >= 0) {
+        const rawKey = last.slice(2, eqIdx);
+        const partial = last.slice(eqIdx + 1);
+        const opt = command.options?.find((o) => o.name.toLowerCase() === rawKey.toLowerCase());
+        if (!opt?.enumValues?.length)
+            return null;
+        return { kind: 'value', command, key: opt.name, partial, values: opt.enumValues };
+    }
+    return { kind: 'name', command, partial: last.slice(2), usedNames };
+}
+/** extras 模式建议项（option 名或枚举值） */
+export function buildExtrasSuggestions(mode) {
+    if (mode.kind === 'value') {
+        const partial = mode.partial.toLowerCase();
+        return mode.values
+            .filter((v) => !partial || v.toLowerCase().startsWith(partial))
+            .map((v) => ({ name: v, description: '', type: 'value' }));
+    }
+    const partial = mode.partial.toLowerCase();
+    return (mode.command.options ?? [])
+        .filter((o) => !mode.usedNames.has(o.name.toLowerCase()))
+        .filter((o) => !partial || o.name.toLowerCase().startsWith(partial))
+        .map((o) => ({ name: o.name, description: o.description, type: 'option' }));
+}
+/** extras 模式 Tab 补全：替换末尾未完成 token，或在末尾空格后追加新 flag */
+export function applyExtrasCompletion(input, mode, selected) {
+    const lastSpace = input.lastIndexOf(' ');
+    const prefix = input.slice(0, lastSpace + 1);
+    if (mode.kind === 'value')
+        return `${prefix}--${mode.key}=${selected} `;
+    const isBoolean = mode.command.options?.find((o) => o.name === selected)?.isBoolean === true;
+    return `${prefix}${isBoolean ? `--${selected} ` : `--${selected}=`}`;
+}
+/** 输入包含 flag 时尝试解析对应命令；不依赖命令是否声明 options，仅用于建议回显 */
+export function resolveMatchedCommandWithFlags(rawQuery, options) {
+    const split = splitFlagTokens(rawQuery);
+    if (!split || split.flagTokens.length === 0)
+        return null;
+    if (split.cmdTokens.length === 0 || split.cmdTokens.length > 2)
+        return null;
+    return resolveCommand(split.cmdTokens.join(' '), options);
+}
+/** Enter 提交时把 `/cmd --k1=v1 --k2 v2` 解析为命令 + prefilled */
+export function extractCommandAndPrefilled(input, options) {
+    const raw = input.startsWith('/') ? input.slice(1) : '';
+    const split = splitCommandAndFlags(raw, options);
+    if (!split || split.flagTokens.length === 0)
+        return { command: null, prefilled: {} };
+    return {
+        command: split.command,
+        prefilled: parseCommandFlagTokens(split.flagTokens, split.command.options),
+    };
+}
+/** 判断输入是否已经包含 `--flag` token */
+export function hasFlagToken(input) {
+    const raw = input.startsWith('/') ? input.slice(1) : input;
+    const split = splitFlagTokens(raw);
+    return !!split && split.flagTokens.length > 0;
+}
+// ─── Helpers ────────────────────────────────────────────────
+/**
+ * 把 `<cmd...> [--flag ...]` 查询拆分为命令 + flag tokens
+ *
+ * 在 splitFlagTokens 基础上叠加目录解析，限制命令 tokens ≤ 2（顶级命令 或 group+action）
+ */
+function splitCommandAndFlags(rawQuery, options) {
+    const split = splitFlagTokens(rawQuery);
+    if (!split || split.cmdTokens.length === 0 || split.cmdTokens.length > 2)
+        return null;
+    const command = resolveCommand(split.cmdTokens.join(' '), options);
+    if (!command)
+        return null;
+    return { command, flagTokens: split.flagTokens, endsWithSpace: split.endsWithSpace };
+}
+/** 通过 `<name>` 或 `<group> <action>` 解析命令 */
+function resolveCommand(cmdPart, options) {
+    const parts = cmdPart.trim().split(/\s+/);
+    if (parts.length === 1)
+        return findCommandByName(options, parts[0]);
+    if (parts.length !== 2)
+        return null;
+    const [groupName, action] = parts;
+    const group = options.find((o) => o.type === 'group' && o.name.toLowerCase() === groupName.toLowerCase());
+    if (!group?.children)
+        return null;
+    return group.children.find((c) => splitCommandName(c.name).action.toLowerCase() === action.toLowerCase()) ?? null;
+}
+function findCommandByName(options, name) {
+    const target = name.toLowerCase();
+    for (const opt of options) {
+        if (opt.type === 'group') {
+            const found = opt.children?.find((c) => c.name.toLowerCase() === target || splitCommandName(c.name).action.toLowerCase() === target);
+            if (found)
+                return found;
+            continue;
+        }
+        if (opt.name.toLowerCase() === target)
+            return opt;
+    }
+    return null;
+}
+function collectUsedNames(flagTokens) {
+    const used = new Set();
+    for (const t of flagTokens) {
+        if (!t.startsWith('--'))
+            continue;
+        const eq = t.indexOf('=');
+        const name = (eq >= 0 ? t.slice(2, eq) : t.slice(2)).toLowerCase();
+        if (name)
+            used.add(name);
+    }
+    return used;
+}
+function matchScore(text, query) {
+    const lower = text.toLowerCase();
+    if (lower.startsWith(query))
+        return 0;
+    if (lower.includes(query))
+        return 1;
+    return 2;
+}
+function fuzzyMatch(text, query) {
+    const lower = text.toLowerCase();
+    if (lower.includes(query))
+        return true;
+    let qi = 0;
+    for (let i = 0; i < lower.length && qi < query.length; i++) {
+        if (lower[i] === query[qi])
+            qi++;
+    }
+    return qi === query.length;
+}
+//# sourceMappingURL=completion-core.js.map

package/dist/completion.d.ts

@@ -5,9 +5,15 @@
  * 通过 Commander.js 适配器集成，支持 zsh / bash / fish
  * install / uninstall 需手动检测 shell 类型并读写配置文件
  */
+import tab from '@bomb.sh/tab/commander';
 import type { Command } from 'commander';
-/** 将 @bomb.sh/tab 补全能力注册到 Commander program（原地修改，包装 program.parse）*/
-export declare function initTabCompletion(program: Command): void;
+/**
+ * 将 @bomb.sh/tab 补全能力注册到 Commander program（原地修改，包装 program.parse）
+ *
+ * 返回 RootCommand，可通过 `result.commands.get(name)?.options.get(key)?.handler = ...`
+ * 注册 option 值补全。
+ */
+export declare function initTabCompletion(program: Command): ReturnType<typeof tab>;
 /** 安装 shell 自动补全到当前 shell 配置文件 */
 export declare function installShellCompletion(): void;
 /** 卸载 shell 自动补全（从配置文件中删除相关行） */

package/dist/completion.js

@@ -44,9 +44,14 @@ function getShellConfig(shell) {
 // ============================================================
 // 公开 API
 // ============================================================
-/** 将 @bomb.sh/tab 补全能力注册到 Commander program（原地修改，包装 program.parse）*/
+/**
+ * 将 @bomb.sh/tab 补全能力注册到 Commander program（原地修改，包装 program.parse）
+ *
+ * 返回 RootCommand，可通过 `result.commands.get(name)?.options.get(key)?.handler = ...`
+ * 注册 option 值补全。
+ */
 export function initTabCompletion(program) {
-    tab(program);
+    return tab(program);
 }
 /** 安装 shell 自动补全到当前 shell 配置文件 */
 export function installShellCompletion() {

package/dist/components/Commands.d.ts

@@ -5,29 +5,24 @@
  * 编辑器使用自定义 Editor 支持多行编辑和完整终端快捷键
  * 通过 useKeymap 注册建议导航和 Tab 补全，避免快捷键冲突
  *
- * 支持二级菜单：
- * - 带 `:` 的命令自动折叠为 group 项（如 `aiRules ▸`）
- * - 输入 `/groupName` 精确匹配后展开二级命令列表
- * - 输入 `/groupName action` 过滤二级命令
+ * 补全核心逻辑（query 解析、extras 模式、命令寻址、prefilled 提取）
+ * 已下沉至 completion/core.ts，本文件只保留状态/快捷键/渲染
  */
-export interface CommandItem {
-    readonly name: string;
-    readonly description: string;
-    readonly disabled?: boolean;
-    readonly type?: 'command' | 'group' | 'back';
-    readonly children?: CommandItem[];
-}
+import type { CommandOptionMeta } from '../completion/command.js';
+import type { CommandCatalogItem } from '../completion/core.js';
+export type { CommandOptionMeta };
+/** 兼容别名：原 CommandItem 现统一为 completion/core 中的 CommandCatalogItem */
+export type CommandItem = CommandCatalogItem;
 interface CommandPaletteProps {
     readonly commandOptions: CommandItem[];
     readonly isActive: boolean;
     /** 建议列表最大显示行数（根据终端高度动态计算） */
     readonly maxSuggestions?: number;
-    readonly onSelect: (name: string) => void;
+    readonly onSelect: (name: string, prefilled?: Record<string, string>) => void;
     readonly onUserInput: (input: string) => void;
     readonly onExit: () => void;
     /** 当 Tab 无法补全时（无建议），通知父组件切换面板 */
     readonly onTabFallthrough?: () => void;
 }
 export declare const Commands: import("react").NamedExoticComponent<CommandPaletteProps>;
-export {};
 //# sourceMappingURL=Commands.d.ts.map

package/dist/components/Commands.js

@@ -6,19 +6,18 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * 编辑器使用自定义 Editor 支持多行编辑和完整终端快捷键
  * 通过 useKeymap 注册建议导航和 Tab 补全，避免快捷键冲突
  *
- * 支持二级菜单：
- * - 带 `:` 的命令自动折叠为 group 项（如 `aiRules ▸`）
- * - 输入 `/groupName` 精确匹配后展开二级命令列表
- * - 输入 `/groupName action` 过滤二级命令
+ * 补全核心逻辑（query 解析、extras 模式、命令寻址、prefilled 提取）
+ * 已下沉至 completion/core.ts，本文件只保留状态/快捷键/渲染
  */
 import { useState, useMemo, useEffect, useCallback, useRef, memo } from 'react';
 import { Box, Text } from 'ink';
+import { splitCommandName } from '../completion/command.js';
+import { applyExtrasCompletion, buildCompletionState, buildSuggestions, extractCommandAndPrefilled, hasFlagToken, } from '../completion/core.js';
 import { useKeymap, KeymapLayer } from '../hooks/use-keymap.js';
 import { Editor } from './Editor.js';
 import { computeWindow } from './Prompts/OptionList.js';
 const SUGGESTION_PAGE_SIZE = 10;
 const EXIT_COMMAND = 'exit';
-const BACK_COMMAND = '__back__';
 // ─── Component ──────────────────────────────────────────────
 export const Commands = memo(function Commands({ commandOptions, isActive, maxSuggestions, onSelect, onUserInput, onExit, onTabFallthrough, }) {
     const pageSize = maxSuggestions ? Math.min(SUGGESTION_PAGE_SIZE, maxSuggestions) : SUGGESTION_PAGE_SIZE;
@@ -26,34 +25,21 @@ export const Commands = memo(function Commands({ commandOptions, isActive, maxSu
     const [suggestIndex, setSuggestIndex] = useState(0);
     const [resetKey, setResetKey] = useState(0);
     const showSuggestions = commandInput.startsWith('/');
-    const query = showSuggestions ? commandInput.slice(1).toLowerCase() : '';
-    // 解析 query 用于二级菜单：`groupName subQuery` 或 `topLevelQuery`
-    const { activeGroup, subQuery, topQuery } = useMemo(() => parseQuery(query, commandOptions), [query, commandOptions]);
-    const suggestions = useMemo(() => {
-        if (!showSuggestions)
-            return [];
-        // 二级模式：展示 group 的子命令
-        if (activeGroup) {
-            const children = activeGroup.children ?? [];
-            const backItem = { name: BACK_COMMAND, description: '返回上级', type: 'back' };
-            if (!subQuery)
-                return [backItem, ...children];
-            const filtered = filterAndSort(children, subQuery);
-            return [backItem, ...filtered];
-        }
-        if (!topQuery)
-            return commandOptions;
-        return filterTopLevel(commandOptions, topQuery);
-    }, [showSuggestions, activeGroup, subQuery, topQuery, commandOptions]);
+    const rawQuery = showSuggestions ? commandInput.slice(1) : '';
+    const completionState = useMemo(() => buildCompletionState(rawQuery, commandOptions), [rawQuery, commandOptions]);
+    const { activeGroup, extrasMode } = completionState;
+    const suggestions = useMemo(() => (showSuggestions ? buildSuggestions(completionState, commandOptions) : []), [showSuggestions, completionState, commandOptions]);
     // 查询变化时重置选中索引
     useEffect(() => {
-        // 二级模式下默认选中第二项（跳过「返回」）
+        if (extrasMode) {
+            setSuggestIndex(0);
+            return;
+        }
         setSuggestIndex(activeGroup && suggestions.length > 1 ? 1 : 0);
-    }, [showSuggestions, query]);
+    }, [showSuggestions, rawQuery, completionState.mode]);
     // ref 供 keymap handler 使用，避免陈旧闭包
-    const stateRef = useRef({ suggestions, suggestIndex, showSuggestions, activeGroup });
-    stateRef.current = { suggestions, suggestIndex, showSuggestions, activeGroup };
-    // ── 重置输入的辅助函数 ──
+    const stateRef = useRef({ suggestions, suggestIndex, showSuggestions, completionState, commandInput, commandOptions });
+    stateRef.current = { suggestions, suggestIndex, showSuggestions, completionState, commandInput, commandOptions };
     const resetInput = useCallback((value) => {
         setCommandInput(value);
         setResetKey((p) => p + 1);
@@ -63,7 +49,14 @@ export const Commands = memo(function Commands({ commandOptions, isActive, maxSu
         setCommandInput(value);
     }, []);
     const handleSubmit = useCallback((_value) => {
-        const { suggestions: sug, suggestIndex: idx, showSuggestions: show, activeGroup: group } = stateRef.current;
+        const { suggestions: sug, suggestIndex: idx, showSuggestions: show, commandInput: input, commandOptions: opts } = stateRef.current;
+        // 包含 flag 的输入：只要能解析出命令就直接执行，携带 prefilled
+        const { command, prefilled } = extractCommandAndPrefilled(input, opts);
+        if (command) {
+            resetInput('');
+            onSelect(command.name, prefilled);
+            return;
+        }
         if (show && sug.length > 0) {
             const selected = sug[idx];
             if (!selected)
@@ -119,11 +112,19 @@ export const Commands = memo(function Commands({ commandOptions, isActive, maxSu
     useKeymap({
         key: 'tab',
         handler: () => {
-            const { suggestions: sug, suggestIndex: idx, showSuggestions: show, activeGroup: group } = stateRef.current;
+            const { suggestions: sug, suggestIndex: idx, showSuggestions: show, completionState: state, commandInput: input } = stateRef.current;
+            const { activeGroup: group, extrasMode: extras } = state;
             if (show && sug.length > 0) {
                 const selected = sug[idx];
                 if (!selected)
                     return;
+                if (extras) {
+                    resetInput(applyExtrasCompletion(input, extras, selected.name));
+                    return;
+                }
+                // 已带 flag 的输入回退到「展示匹配命令」状态：Tab 不应清空已输入参数
+                if (hasFlagToken(input))
+                    return;
                 if (selected.type === 'back') {
                     resetInput('/');
                     return;
@@ -133,7 +134,7 @@ export const Commands = memo(function Commands({ commandOptions, isActive, maxSu
                     return;
                 }
                 if (group) {
-                    const action = selected.name.includes(':') ? selected.name.split(':').pop() : selected.name;
+                    const action = selected.name.includes(':') ? splitCommandName(selected.name).action : selected.name;
                     resetInput(`/${group.name} ${action}`);
                     return;
                 }
@@ -171,7 +172,7 @@ function SuggestionList({ suggestions, selectedIndex, pageSize }) {
                     return _jsx(BackItem, { isFocused: isFocused }, "__back__");
                 if (item.type === 'group')
                     return _jsx(GroupItem, { item: item, isFocused: isFocused }, item.name);
-                return _jsx(SuggestionItem, { item: item, isFocused: isFocused }, item.name);
+                return _jsx(SuggestionItem, { item: item, isFocused: isFocused, displayName: formatSuggestionName(item) }, item.name);
             }), startIndex + windowSize < totalItems && _jsxs(Text, { dimColor: true, children: [" \u2193 \u8FD8\u6709 ", totalItems - startIndex - windowSize, " \u9879"] })] }));
 }
 function BackItem({ isFocused }) {
@@ -180,8 +181,12 @@ function BackItem({ isFocused }) {
 function GroupItem({ item, isFocused }) {
     return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isFocused ? 'cyan' : undefined, children: isFocused ? '❯' : ' ' }), _jsxs(Text, { color: isFocused ? 'cyan' : undefined, bold: isFocused, children: [item.name, " \u25B8"] }), _jsx(Text, { dimColor: true, children: item.description })] }));
 }
-function SuggestionItem({ item, isFocused }) {
-    return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isFocused ? 'cyan' : undefined, children: isFocused ? '❯' : ' ' }), _jsx(Text, { color: item.disabled ? undefined : isFocused ? 'cyan' : undefined, bold: isFocused && !item.disabled, dimColor: item.disabled, children: item.name }), _jsx(Text, { dimColor: true, children: item.description })] }));
+function SuggestionItem({ item, isFocused, displayName }) {
+    return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isFocused ? 'cyan' : undefined, children: isFocused ? '❯' : ' ' }), _jsx(Text, { color: item.disabled ? undefined : isFocused ? 'cyan' : undefined, bold: isFocused && !item.disabled, dimColor: item.disabled, children: displayName }), _jsx(Text, { dimColor: true, children: item.description })] }));
+}
+/** option 候选项加 `--` 前缀，与子命令区分 */
+function formatSuggestionName(item) {
+    return item.type === 'option' ? `--${item.name}` : item.name;
 }
 function HintBar({ showSuggestions, isSubMenu }) {
     const hint = !showSuggestions
@@ -191,58 +196,4 @@ function HintBar({ showSuggestions, isSubMenu }) {
             : '↑↓ 导航  Tab 补全  Enter 执行';
     return (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: hint }) }));
 }
-// ─── Helpers ────────────────────────────────────────────────
-/** 解析 query，判断是否进入二级菜单模式 */
-function parseQuery(query, options) {
-    if (!query)
-        return { activeGroup: null, subQuery: '', topQuery: '' };
-    const spaceIndex = query.indexOf(' ');
-    if (spaceIndex > 0) {
-        const groupPart = query.slice(0, spaceIndex);
-        const subQuery = query.slice(spaceIndex + 1).trim();
-        const group = options.find((o) => o.type === 'group' && o.name.toLowerCase() === groupPart);
-        if (group)
-            return { activeGroup: group, subQuery, topQuery: '' };
-    }
-    // 精确匹配 group（无空格时也检查）
-    const exactGroup = options.find((o) => o.type === 'group' && o.name.toLowerCase() === query);
-    if (exactGroup)
-        return { activeGroup: exactGroup, subQuery: '', topQuery: '' };
-    return { activeGroup: null, subQuery: '', topQuery: query };
-}
-function filterTopLevel(options, query) {
-    return options.filter((item) => fuzzyMatch(item.name, query)).sort((a, b) => matchScore(a.name, query) - matchScore(b.name, query));
-}
-function filterAndSort(options, query) {
-    return options
-        .filter((opt) => {
-        // 匹配子命令时，同时尝试匹配完整名和去掉前缀的 action 名
-        const action = opt.name.includes(':') ? opt.name.split(':').pop() : opt.name;
-        return fuzzyMatch(action, query) || fuzzyMatch(opt.name, query);
-    })
-        .sort((a, b) => {
-        const aAction = a.name.includes(':') ? a.name.split(':').pop() : a.name;
-        const bAction = b.name.includes(':') ? b.name.split(':').pop() : b.name;
-        return matchScore(aAction, query) - matchScore(bAction, query);
-    });
-}
-function matchScore(text, query) {
-    const lower = text.toLowerCase();
-    if (lower.startsWith(query))
-        return 0;
-    if (lower.includes(query))
-        return 1;
-    return 2;
-}
-function fuzzyMatch(text, query) {
-    const lower = text.toLowerCase();
-    if (lower.includes(query))
-        return true;
-    let qi = 0;
-    for (let i = 0; i < lower.length && qi < query.length; i++) {
-        if (lower[i] === query[qi])
-            qi++;
-    }
-    return qi === query.length;
-}
 //# sourceMappingURL=Commands.js.map

package/dist/hooks/use-session-manager.d.ts

@@ -33,7 +33,7 @@ export interface SessionManager {
     readonly activeSessions: [string, RunSession][];
     readonly runningSessions: [string, RunSession][];
     readonly runningScriptNames: Set<string>;
-    startSession(name: string): string;
+    startSession(name: string, prefilled?: Record<string, string>): string;
     startInputSession(input: string): string;
     suspendSession(sessionId: string): void;
     resumeSession(sessionId: string): void;

package/dist/hooks/use-session-manager.js

@@ -44,13 +44,14 @@ export function useSessionManager({ runner, directScriptName, onExit, onLeaveSes
         }
     }, [snapshot, directScriptName, onExit, coreManager]);
     // ── 操作方法 ──
-    const startSession = useCallback((name) => {
+    const startSession = useCallback((name, prefilled) => {
         const sessionId = coreManager.createSession({
             commandName: name,
             source: 'cli',
             createLogger: () => new InkLogger(),
             createPrompt: () => new InkPrompt(),
             createSpinner: () => new InkSpinner(),
+            prefilled,
         });
         focusedRef.current = { id: sessionId };
         onFocusSession(sessionId);

package/dist/index.d.ts

@@ -19,4 +19,5 @@ export { PromptView } from './views/PromptView.js';
 export { App } from './app.js';
 export { launch } from './launcher.js';
 export type { LaunchOptions } from './launcher.js';
+export * from './completion';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -20,4 +20,7 @@ export { PromptView } from './views/PromptView.js';
 // 应用
 export { App } from './app.js';
 export { launch } from './launcher.js';
+// 命令工具
+// 补全域
+export * from './completion';
 //# sourceMappingURL=index.js.map

package/dist/views/MenuView.d.ts

@@ -15,7 +15,7 @@ interface MenuViewProps {
     readonly badges: StatusBadge[];
     readonly storeSnapshot: PluginStoreSnapshot;
     readonly toast: InkToast;
-    readonly onSelect: (commandName: string) => void;
+    readonly onSelect: (commandName: string, prefilled?: Record<string, string>) => void;
     readonly onFocusSession: (sessionId: string) => void;
     readonly onExit: () => void;
     readonly onUserInput: (input: string) => void;

package/dist/views/MenuView.js

@@ -9,6 +9,7 @@ import { useState, useMemo, useEffect, useCallback, memo } from 'react';
 import { Box, Text, useWindowSize } from 'ink';
 import Link from 'ink-link';
 import { resolveBadgeProp } from '@xfe-repo/cli-core';
+import { buildCommandCatalog } from '../completion/catalog.js';
 import { useKeymap, KeymapLayer } from '../hooks/use-keymap.js';
 import { useElapsedTime } from '../hooks/use-elapsed-time.js';
 import { useToast } from '../hooks/use-adapters.js';
@@ -41,7 +42,7 @@ export const MenuView = memo(function MenuView({ projectName, commandsWithSource
         if (!hasActiveSessions)
             setFocusArea('commands');
     }, [hasActiveSessions]);
-    const commandOptions = useMemo(() => buildCommandOptions(commandsWithSource, runningCommandNames), [commandsWithSource, runningCommandNames]);
+    const commandOptions = useMemo(() => buildCommandCatalog(commandsWithSource, { runningCommandNames }), [commandsWithSource, runningCommandNames]);
     const headerBadges = useMemo(() => badges.filter((b) => matchSlot(b, 'header')), [badges]);
     const footerBadges = useMemo(() => badges.filter((b) => matchSlot(b, 'footer')), [badges]);
     const toasts = useToast(toast);
@@ -91,61 +92,6 @@ export const MenuView = memo(function MenuView({ projectName, commandsWithSource
                         }) })), toasts.length > 0 && (_jsx(Box, { flexDirection: "column", alignItems: "flex-end", children: toasts.map((t) => (_jsx(Toast, { message: t.message, level: t.level }, t.id))) }))] })] }));
 });
 // ─── Helpers ────────────────────────────────────────────────
-function buildCommandOptions(commandsWithSource, runningCommandNames) {
-    // 按插件来源分组
-    const sourceGroups = new Map();
-    for (const entry of commandsWithSource) {
-        const group = sourceGroups.get(entry.source) ?? [];
-        group.push(entry);
-        sourceGroups.set(entry.source, group);
-    }
-    const options = [];
-    // 保持插件注册顺序（Map 插入序 = commandEntries 中首次出现的 source 顺序）
-    for (const [source] of sourceGroups) {
-        const entries = sourceGroups.get(source);
-        // 检查是否所有命令都是同一 namespace:action 格式
-        const namespacePrefix = detectNamespace(entries);
-        if (namespacePrefix) {
-            // 折叠为 group 项
-            const children = entries.map((e) => toCommandItem(e, runningCommandNames));
-            options.push({
-                name: namespacePrefix,
-                description: `${children.length} 个命令`,
-                type: 'group',
-                children,
-            });
-        }
-        else {
-            entries.forEach((entry) => options.push(toCommandItem(entry, runningCommandNames)));
-        }
-    }
-    options.push({ name: 'exit', description: '退出 CLI' });
-    return options;
-}
-/** 检测一组命令是否共享同一个 namespace 前缀 */
-function detectNamespace(entries) {
-    if (entries.length < 2)
-        return null;
-    const prefixes = entries.map((e) => {
-        const idx = e.command.name.indexOf(':');
-        return idx > 0 ? e.command.name.slice(0, idx) : null;
-    });
-    const first = prefixes[0];
-    if (!first)
-        return null;
-    if (prefixes.every((p) => p === first))
-        return first;
-    return null;
-}
-function toCommandItem(entry, runningCommandNames) {
-    const { name, simpleDescription } = entry.command;
-    const isRunning = runningCommandNames.has(name);
-    return {
-        name,
-        description: isRunning ? `(运行中) ${simpleDescription}` : simpleDescription,
-        disabled: isRunning,
-    };
-}
 /** 判断 badge 是否匹配目标 slot（兼容单个或数组） */
 function matchSlot(badge, target) {
     return Array.isArray(badge.slot) ? badge.slot.includes(target) : badge.slot === target;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfe-repo/cli",
-  "version": "2.0.7",
+  "version": "2.0.8",
   "description": "XFE CLI - Ink-based terminal UI for project scaffolding",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,8 +17,8 @@
     "ink-link": "^5.0.0",
     "react": "^19.1.0",
     "zod": "^4.3.6",
-    "@xfe-repo/cli-core": "2.0.3",
-    "@xfe-repo/cli-presets": "2.0.3"
+    "@xfe-repo/cli-core": "2.0.4",
+    "@xfe-repo/cli-presets": "2.0.4"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

package/dist/components/LogPanel.d.ts

@@ -1,19 +0,0 @@
-/**
- * @xfe-repo/cli - 日志面板组件
- *
- * 滚动日志面板，展示带颜色的日志条目
- */
-import type { LogEntry } from '../adapters/ink-adapter.js';
-interface LogPanelProps {
-    entries: LogEntry[];
-    /** 最大显示行数 */
-    maxLines?: number;
-}
-/**
- * LogPanel - 滚动日志面板
- *
- * 显示最近的日志条目，自动滚动到底部
- */
-export declare const LogPanel: import("react").NamedExoticComponent<LogPanelProps>;
-export {};
-//# sourceMappingURL=LogPanel.d.ts.map