@hunterzhu/pulse-cli 0.4.0 → 0.4.2

package/README.md

@@ -1,5 +1,9 @@
 # @hunterzhu/pulse-cli
 
+[简体中文](https://github.com/zhuhengtan/Pulse/blob/main/packages/cli/README.zh-CN.md)
+
+[Changelog](https://github.com/zhuhengtan/Pulse/blob/main/CHANGELOG.en.md)
+
 **A neural-signal like AI assistant for coding, research and file tasks.**
 
 Pulse runs in your project folder, keeps conversations on your machine, and can resume unfinished work. Requires Node.js 22+.
@@ -9,7 +13,7 @@ Pulse runs in your project folder, keeps conversations on your machine, and can
 Install the CLI globally so the `pulse` command is on your `PATH`:
 
 ```bash
-npm install -g @hunterzhu/pulse-cli
+npm install -g @hunterzhu/pulse-cli --foreground-scripts
 pulse --version
 ```
 
@@ -49,6 +53,10 @@ pulse --read-only
 
 See `pulse --help` for all options.
 
+## License
+
+This package is licensed under [PolyForm Noncommercial 1.0.0](./LICENSE). Commercial use requires separate permission. This is a source-available noncommercial license, not an OSI-approved open-source license.
+
 ## Links
 
 - [Full CLI configuration guide](https://github.com/zhuhengtan/Pulse/blob/main/docs/cli-config.md)

package/dist/bin.js

@@ -4,7 +4,7 @@ import { createRequire } from 'node:module';
 import { isAbsolute, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { createMcpCapabilityPack, createPdfCapabilityPack, createSkillCapabilityPack, createSpreadsheetCapabilityPack } from '@hunterzhu/pulse-server';
-import { ensurePulseUserConfig, expandHome, loadPulseConfig } from './config.js';
+import { defaultPulseConfig, ensurePulseUserConfig, expandHome, loadPulseConfig } from './config.js';
 import { runInteractive } from './commands/interactive.js';
 import { runOneShot } from './commands/run.js';
 import { runDoctor } from './commands/doctor.js';
@@ -16,6 +16,7 @@ import { runServiceCommand } from './commands/service.js';
 import { runTemplateCommand } from './commands/template.js';
 import { runMcpDoctor } from './commands/mcp.js';
 import { isSameModulePath } from './utils/is-main-module.js';
+import { formatVersionOutput, shouldUseColor } from './presentation.js';
 const packageManifest = createRequire(import.meta.url)('../package.json');
 export const version = packageManifest.version;
 process.stdout.on('error', (error) => {
@@ -59,6 +60,12 @@ Options:
   --system-prompt-file <path> load custom system instructions from file
   --mock-response <text>    deterministic response for local debugging
   --mock-task-assessment <json> deterministic verifier result for local debugging
+  --mock-stage-assessment <json> deterministic stage verifier results for local debugging
+  --mock-parallel-plan <json> deterministic task or read-only split plan for local debugging
+  --mock-tool-calls <json>  deterministic tool calls for local debugging
+  --mock-after-tool-response <text> deterministic response after tool execution
+  --task-controller         force the multi-stage task controller
+  --no-task-controller      keep a single ReAct loop
   --live                    doctor: make one real provider request
   --no-color                disable terminal styling
   --help, -h                show this help
@@ -122,17 +129,37 @@ export async function hostOptions(parsed) {
     if (explicitConfig === undefined && process.env.PULSE_CONFIG === undefined) {
         await ensurePulseUserConfig();
     }
-    const config = (await loadPulseConfig(requestedCwd ?? process.cwd(), explicitConfig, parsed.options['trust-workspace'] === true)).value;
-    const requestedModel = option(parsed.options, 'model') ?? process.env.PULSE_MODEL ?? config.activeModel;
+    const loaded = (await loadPulseConfig(requestedCwd ?? process.cwd(), explicitConfig, parsed.options['trust-workspace'] === true)).value;
+    // A missing user config still has to answer usage errors and list sessions.
+    const config = loaded.activeModel || loaded.models || loaded.providers ? loaded : { ...defaultPulseConfig, ...loaded };
+    const mockResponse = option(parsed.options, 'mock-response');
+    const mockTaskAssessment = option(parsed.options, 'mock-task-assessment');
+    const mockStageAssessment = option(parsed.options, 'mock-stage-assessment');
+    const mockToolCallsOption = option(parsed.options, 'mock-tool-calls');
+    const mockAfterToolResponse = option(parsed.options, 'mock-after-tool-response');
+    const mockParallelPlanOption = option(parsed.options, 'mock-parallel-plan');
+    const hasMockDemand = mockResponse !== undefined || mockTaskAssessment !== undefined || mockStageAssessment !== undefined || mockToolCallsOption !== undefined || mockAfterToolResponse !== undefined || mockParallelPlanOption !== undefined;
+    const cliModel = option(parsed.options, 'model');
+    const requestedModel = cliModel ?? (hasMockDemand ? 'mock' : process.env.PULSE_MODEL ?? config.activeModel);
+    const effectiveModels = { ...(config.models ?? {}) };
+    const effectiveProviders = { ...(config.providers ?? {}) };
+    if (requestedModel === 'mock' || (hasMockDemand && cliModel === undefined)) {
+        if (!effectiveModels.mock) {
+            effectiveModels.mock = { displayName: 'mock', provider: 'mock', modelCode: 'mock', maxContextTokens: 32_000, maxOutputTokens: 4_096, reasoningEffort: 'medium' };
+        }
+        if (!effectiveProviders.mock) {
+            effectiveProviders.mock = { provider: 'mock', name: 'Mock' };
+        }
+    }
     const configuredModelEntry = requestedModel === undefined
         ? undefined
-        : Object.entries(config.models ?? {}).find(([name, item]) => name === requestedModel || item.displayName === requestedModel);
+        : Object.entries(effectiveModels).find(([name, item]) => name === requestedModel || item.displayName === requestedModel);
     if (!configuredModelEntry)
         throw new Error(`UNKNOWN_MODEL_DISPLAY_NAME:${requestedModel ?? '(missing)'}`);
     const [, modelSelection] = configuredModelEntry;
     const activeModelName = modelSelection.displayName;
     const providerName = modelSelection.provider;
-    const profile = config.providers?.[providerName];
+    const profile = effectiveProviders[providerName];
     if (!profile)
         throw new Error(`MODEL_PROVIDER_NOT_FOUND:${providerName}`);
     const model = modelSelection.modelCode;
@@ -168,7 +195,7 @@ export async function hostOptions(parsed) {
         ...(configuredReasoningEffort === undefined ? {} : { reasoningEffort: configuredReasoningEffort }),
         ...(configuredToolChoice === undefined ? {} : { toolChoice: configuredToolChoice }),
     };
-    const providerProfiles = Object.fromEntries(Object.entries(config.providers ?? {}).flatMap(([name, item]) => {
+    const providerProfiles = Object.fromEntries(Object.entries(effectiveProviders).flatMap(([name, item]) => {
         if (!item.provider)
             throw new Error(`PROVIDER_PROTOCOL_REQUIRED:${name}`);
         const adapterProvider = item.provider;
@@ -185,8 +212,8 @@ export async function hostOptions(parsed) {
                 }]];
     }));
     const modelDisplayNames = new Set();
-    const providerModels = Object.fromEntries(Object.entries(config.models ?? {}).flatMap(([name, item]) => {
-        if (!config.providers?.[item.provider])
+    const providerModels = Object.fromEntries(Object.entries(effectiveModels).flatMap(([name, item]) => {
+        if (!effectiveProviders[item.provider])
             throw new Error(`MODEL_PROVIDER_NOT_FOUND:${item.provider}`);
         const displayName = item.displayName.trim();
         if (!displayName)
@@ -212,8 +239,6 @@ export async function hostOptions(parsed) {
     }
     const cwd = requestedCwd ?? expandHome(config.cwd);
     const dataDir = expandHome(option(parsed.options, 'data-dir') ?? process.env.PULSE_DATA_DIR ?? config.dataDir);
-    const mockResponse = option(parsed.options, 'mock-response');
-    const mockTaskAssessment = option(parsed.options, 'mock-task-assessment');
     let mockTaskAssessments;
     if (mockTaskAssessment !== undefined) {
         try {
@@ -226,6 +251,45 @@ export async function hostOptions(parsed) {
             throw new Error('INVALID_MOCK_TASK_ASSESSMENT: expected a non-empty JSON array of assessment objects');
         }
     }
+    else if (hasMockDemand) {
+        mockTaskAssessments = [{ status: 'accepted', criteria: [{ criterionId: 'criterion-1', status: 'passed', evidenceRefs: ['AUTO'], rationale: 'Accepted by mock verifier.' }] }];
+    }
+    let mockStageAssessments;
+    if (mockStageAssessment !== undefined) {
+        try {
+            const value = JSON.parse(mockStageAssessment);
+            if (!Array.isArray(value) || value.length === 0 || value.some((item) => !item || typeof item !== 'object' || Array.isArray(item)))
+                throw new Error('INVALID');
+            mockStageAssessments = value;
+        }
+        catch {
+            throw new Error('INVALID_MOCK_STAGE_ASSESSMENT: expected a non-empty JSON array of stage assessment objects');
+        }
+    }
+    let mockToolCalls;
+    if (mockToolCallsOption !== undefined) {
+        try {
+            const value = JSON.parse(mockToolCallsOption);
+            if (!Array.isArray(value) || value.some((item) => !item || typeof item !== 'object' || Array.isArray(item)))
+                throw new Error('INVALID');
+            mockToolCalls = value;
+        }
+        catch {
+            throw new Error('INVALID_MOCK_TOOL_CALLS: expected a JSON array of tool call objects');
+        }
+    }
+    let mockParallelPlan;
+    if (mockParallelPlanOption !== undefined) {
+        try {
+            const value = JSON.parse(mockParallelPlanOption);
+            if (!value || typeof value !== 'object')
+                throw new Error('INVALID');
+            mockParallelPlan = value;
+        }
+        catch {
+            throw new Error('INVALID_MOCK_PARALLEL_PLAN: expected a JSON object');
+        }
+    }
     const requestedApprovalMode = option(parsed.options, 'approval-mode') ?? process.env.PULSE_APPROVAL_MODE;
     const approvalMode = requestedApprovalMode === 'read-only' || parsed.options['read-only'] === true
         ? 'read-only'
@@ -290,7 +354,9 @@ export async function hostOptions(parsed) {
             }
         }
     }
+    const explicitTaskController = parsed.options['task-controller'] === true ? true : parsed.options['no-task-controller'] === true ? false : mockParallelPlanOption !== undefined ? true : undefined;
     return {
+        ...(explicitTaskController === undefined ? {} : { taskController: explicitTaskController }),
         ...(cwd === undefined ? {} : { cwd }),
         ...(dataDir === undefined ? {} : { dataDir }),
         ...(systemPrompt && systemPrompt.trim().length > 0 ? { systemPrompt: systemPrompt.trim() } : {}),
@@ -301,11 +367,15 @@ export async function hostOptions(parsed) {
         ...(taskRouting === undefined ? {} : { taskRouting }),
         capabilityPacks,
         enabledCapabilityPacks,
-        capabilityConfig: { skills: skillNames },
+        capabilityConfig: capabilitySettings.skills === undefined ? {} : { skills: skillNames },
         activeProviderCode: providerName,
         activeModel: activeModelName,
         ...(mockResponse === undefined ? {} : { mockResponse }),
         ...(mockTaskAssessments === undefined ? {} : { mockTaskAssessments }),
+        ...(mockStageAssessments === undefined ? {} : { mockStageAssessments }),
+        ...(mockToolCalls === undefined ? {} : { mockToolCalls }),
+        ...(mockAfterToolResponse === undefined ? {} : { mockAfterToolResponse }),
+        ...(mockParallelPlan === undefined ? {} : { mockParallelPlan }),
         ...(approvalMode === undefined ? {} : { approvalMode }),
         ...(configuredMaxTurns === undefined ? {} : { maxTurns: configuredMaxTurns }),
         ...(configuredAutoCompactPercent === undefined ? {} : { autoCompactPercent: Math.min(90, configuredAutoCompactPercent) }),
@@ -320,7 +390,9 @@ export async function main() {
         return 0;
     }
     if (parsed.options.version || parsed.options.v) {
-        process.stdout.write(`${version}\n`);
+        process.stdout.write(formatVersionOutput(version, {
+            color: parsed.options['no-color'] !== true && shouldUseColor(process.env, process.stdout.isTTY === true),
+        }));
         return 0;
     }
     if (parsed.command === 'setup') {
@@ -342,21 +414,60 @@ export async function main() {
         return runMcpDoctor(options, parsed.positionals.slice(1));
     if (parsed.command === 'template')
         return runTemplateCommand(options, parsed.positionals, option(parsed.options, 'format') ?? 'text', version);
+    async function readPipedStdin() {
+        if (process.stdin.isTTY)
+            return '';
+        return new Promise((resolve) => {
+            let data = '';
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(idle);
+                process.stdin.pause();
+                resolve(data.trim());
+            };
+            // An open stdin with no bytes must not block a command that already has a task.
+            const idle = setTimeout(finish, 250);
+            process.stdin.setEncoding('utf8');
+            process.stdin.on('data', (chunk) => {
+                data += chunk;
+                clearTimeout(idle);
+            });
+            process.stdin.on('end', finish);
+            process.stdin.on('error', finish);
+            if (process.stdin.readableEnded)
+                finish();
+        });
+    }
     if (parsed.command === 'run') {
-        const task = parsed.positionals.join(' ').trim();
+        let task = parsed.positionals.join(' ').trim();
+        if (!task && !process.stdin.isTTY) {
+            task = await readPipedStdin();
+        }
+        else if (task && !process.stdin.isTTY) {
+            const piped = await readPipedStdin();
+            if (piped)
+                task = `${task}\n\n${piped}`;
+        }
         if (!task)
             throw new Error('TASK_REQUIRED');
         return runOneShot(options, task, option(parsed.options, 'format') ?? 'text', version);
     }
     if (parsed.command === 'resume') {
         const id = parsed.positionals.shift();
-        const task = parsed.positionals.join(' ').trim();
+        let task = parsed.positionals.join(' ').trim();
+        if (!task && !process.stdin.isTTY) {
+            task = await readPipedStdin();
+        }
         if (!id)
             throw new Error('RESUME_REQUIRES_ID');
         return runResume(options, id, task || undefined, option(parsed.options, 'format') ?? 'text', version);
     }
     // 默认启动交互式 Ink 界面
-    return runInteractive(options, undefined, undefined, version, parsed.options.resume === true);
+    const initialTask = parsed.positionals.join(' ').trim() || undefined;
+    return runInteractive(options, undefined, initialTask, version, parsed.options.resume === true);
 }
 if (process.argv[1] && isSameModulePath(process.argv[1], fileURLToPath(import.meta.url))) {
     main()

package/dist/commands/interactive.js

@@ -3,6 +3,7 @@ import { render } from 'ink';
 import { App } from '../components/App.js';
 import { createLocalHost } from '@hunterzhu/pulse-server';
 import { closePendingHosts } from '../hooks/useHost.js';
+import { runOneShot } from './run.js';
 export async function findResumeConversation(options) {
     const host = createLocalHost(options);
     await host.init();
@@ -14,7 +15,14 @@ export async function findResumeConversation(options) {
         await host.close();
     }
 }
-export async function runInteractive(options, conversationId, initialTask, version = '0.1.4', resumeLatest = false) {
+export async function runInteractive(options, conversationId, initialTask, version = '0.4.1', resumeLatest = false) {
+    if (!process.stdin.isTTY) {
+        if (initialTask) {
+            return runOneShot(options, initialTask, 'text', version);
+        }
+        process.stderr.write('交互模式需要 TTY 终端。非交互执行请使用 "pulse run <task>"。\n');
+        return 1;
+    }
     const selectedConversationId = resumeLatest
         ? await findResumeConversation(options)
         : conversationId;

package/dist/commands/resume.js

@@ -20,8 +20,8 @@ function writeEvent(event, format) {
         process.stderr.write(`\n[错误] ${String(event.data ?? '')}\n`);
     }
 }
-export async function runResume(options, conversationId, task, format = 'text', version = '0.1.4') {
-    // 如果在交互式终端且没有指定 jsonl，启动交互式 Ink 界面直接继续会话
+export async function runResume(options, conversationId, task, format = 'text', version = '0.4.1') {
+    // 交互式终端进入 Ink 界面；jsonl 保持非交互输出
     if (process.stdout.isTTY && format !== 'jsonl') {
         return runInteractive(options, conversationId, task, version);
     }

package/dist/commands/run.js

@@ -1,5 +1,4 @@
 import { createLocalHost } from '@hunterzhu/pulse-server';
-import { runInteractive } from './interactive.js';
 import { bindRunSignals } from './signals.js';
 function writeEvent(event, format) {
     if (format === 'jsonl') {
@@ -20,11 +19,7 @@ function writeEvent(event, format) {
         process.stderr.write(`\n[错误] ${String(event.data ?? '')}\n`);
     }
 }
-export async function runOneShot(options, task, format = 'text', version = '0.1.4') {
-    // 如果在交互式终端且没有指定 jsonl，启动交互式 Ink 界面直接执行任务
-    if (process.stdout.isTTY && format !== 'jsonl') {
-        return runInteractive(options, undefined, task, version);
-    }
+export async function runOneShot(options, task, format = 'text', version = '0.4.1') {
     const host = createLocalHost(options);
     let activeRun;
     const unbindSignals = bindRunSignals(host, () => activeRun);
@@ -76,6 +71,10 @@ export async function runOneShot(options, task, format = 'text', version = '0.1.
             return 3;
         return outcome.status === 'succeeded' && (!taskOutcome || taskOutcome.status === 'accepted') ? 0 : 1;
     }
+    catch (error) {
+        process.stderr.write(`\n[错误] ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
     finally {
         unbindSignals();
         await host.close();

package/dist/components/App.js

@@ -18,11 +18,14 @@ import { useTokenStats } from '../hooks/useTokenStats.js';
 import { useSlashCommands } from '../hooks/useSlashCommands.js';
 import { copyToClipboard, isCopyShortcut } from '../utils/clipboard.js';
 import { emptyInputHistory, navigateInputHistory, rememberInput } from '../utils/inputHistory.js';
+import { skillSuggestions } from '../utils/slashCompletion.js';
 export function App({ hostOptions, conversationId: initialConversationId, initialTask, resumeOnStart = false, version, }) {
     const { exit } = useApp();
     const { stdout } = useStdout();
     const [terminalRows, setTerminalRows] = useState(stdout.rows || 24);
     useEffect(() => { const resize = () => setTerminalRows(stdout.rows || 24); stdout.on('resize', resize); return () => { stdout.off('resize', resize); }; }, [stdout]);
+    const [skillNames, setSkillNames] = useState([]);
+    const [skillError, setSkillError] = useState(null);
     const [mode, setMode] = useState('chat');
     const [mouseEnabled, setMouseEnabled] = useState(true);
     const [selectedText, setSelectedText] = useState('');
@@ -38,6 +41,11 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
     const startedTask = useRef(false);
     const startedResume = useRef(false);
     const { host, error: hostError, ready: hostReady } = useHost(hostOptions);
+    const refreshSkills = useCallback(() => {
+        if (host)
+            void host.listSkills().then(names => { setSkillNames(names); setSkillError(null); }, error => setSkillError(String(error)));
+    }, [host]);
+    useEffect(refreshSkills, [refreshSkills]);
     const { conversation, messages, addUserMessage, addAssistantMessage, clearMessages, switchConversation, newConversation, createConversation, error: conversationError, } = useConversation({ host, conversationId: initialConversationId });
     const { isRunning, error: runError, approvalRequest, askRequest, lanes, approvalSubmitting, sendMessage, resumeActive, approveAction, replyAsk, cancelRun, } = useRun({
         host,
@@ -127,7 +135,7 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
             await sendMessage(initialTask, target.id);
         })();
     }, [hostReady, conversation, initialTask, isRunning, addUserMessage, addAssistantMessage, createConversation, sendMessage]);
-    const { executeCommand, isSlashCommand } = useSlashCommands({
+    const { commands, executeCommand, isSlashCommand } = useSlashCommands({
         onMouse: (arg) => setMouseEnabled((current) => arg === 'off' ? false : arg === 'on' ? true : !current),
         onCopy: async () => {
             if (selectedText) {
@@ -455,6 +463,31 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
         if (isSlashCommand(text)) {
             const handled = await executeCommand(text);
             if (!handled) {
+                const token = text.split(/\s+/)[0].slice(1).replace(/^skill:/, '');
+                let currentSkills = skillNames;
+                try {
+                    if (host) {
+                        currentSkills = await host.listSkills();
+                        setSkillNames(currentSkills);
+                        setSkillError(null);
+                    }
+                }
+                catch (error) {
+                    setSkillError(String(error));
+                    return;
+                }
+                if (currentSkills.includes(token)) {
+                    if (isRunning) {
+                        addAssistantMessage({ id: `skill-busy-${Date.now()}`, role: 'system', text: '请等当前任务完成，或使用 /cancel 后再调用技能。', createdAt: new Date().toISOString() });
+                        return;
+                    }
+                    const target = conversation ?? await createConversation();
+                    if (!target)
+                        return;
+                    addUserMessage(text);
+                    await sendMessage(text, target.id);
+                    return;
+                }
                 addAssistantMessage({
                     id: `command-${Date.now()}`,
                     role: 'system',
@@ -470,7 +503,7 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
             addUserMessage(text);
             await sendMessage(text, target.id);
         }
-    }, [isSlashCommand, executeCommand, conversation, createConversation, addUserMessage, sendMessage]);
+    }, [isSlashCommand, executeCommand, conversation, createConversation, addUserMessage, sendMessage, skillNames, isRunning, addAssistantMessage, host]);
     useInput((input, key) => {
         if (isCopyShortcut(input, key)) {
             if (selectedText)
@@ -541,6 +574,6 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
                 }, onInput: () => {
                     setApprovalChoiceFocused(false);
                     setApprovalInputMode(true);
-                } })) : askRequest ? (_jsx(AskPrompt, { request: askRequest, disabled: approvalSubmitting, onReply: (value) => void replyAsk(askRequest.effectId, value) }, askRequest.effectId)) : (_jsx(Box, { marginTop: 1, children: _jsx(InputArea, { onSubmit: (txt) => void handleSubmit(txt), onRememberInput: rememberUserInput, onNavigateHistory: navigateUserInputHistory, disabled: approvalSubmitting, focus: !approvalSubmitting, placeholder: isRunning ? '运行中也可以输入；/cancel 可取消当前运行...' : '输入消息或 /help...' }) }))] }));
+                } })) : askRequest ? (_jsx(AskPrompt, { request: askRequest, disabled: approvalSubmitting, onReply: (value) => void replyAsk(askRequest.effectId, value) }, askRequest.effectId)) : (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [skillError && _jsxs(Text, { color: "red", children: ["\u6280\u80FD\u7D22\u5F15\u5931\u8D25\uFF1A", skillError] }), _jsx(InputArea, { suggestions: [...commands, ...skillSuggestions(skillNames, commands.flatMap(command => [command, ...(command.aliases ?? []).map(name => ({ name, description: command.description }))]))], onSearchSkills: refreshSkills, onSubmit: (txt) => void handleSubmit(txt), onRememberInput: rememberUserInput, onNavigateHistory: navigateUserInputHistory, disabled: approvalSubmitting, focus: !approvalSubmitting, placeholder: isRunning ? '运行中也可以输入；/cancel 可取消当前运行...' : '输入消息或 /help...' })] }))] }));
 }
 export default App;

package/dist/components/HelpView.js

@@ -38,6 +38,7 @@ const COMMANDS = [
             { name: '/model [name]', desc: '切换模型' },
             { name: '/thinking [level]', desc: '设置模型思考深度 (low/medium/high/off)' },
             { name: '/compact', desc: '手动压缩历史；默认在上下文 90% 时自动压缩' },
+            { name: '/skill:名称 任务', desc: '按需加载技能；输入 / 搜索，↑↓ 选择，Tab 补全' },
             { name: '/config', desc: '查看当前运行时配置' },
         ],
     },

package/dist/components/InputArea.d.ts

@@ -1,4 +1,7 @@
+import { type SlashSuggestion } from '../utils/slashCompletion.js';
 interface Props {
+    suggestions?: SlashSuggestion[];
+    onSearchSkills?: () => void;
     onSubmit: (text: string) => void;
     onRememberInput: (text: string) => void;
     onNavigateHistory: (direction: 'up' | 'down', currentValue: string) => string | undefined;
@@ -6,5 +9,5 @@ interface Props {
     focus?: boolean;
     placeholder?: string;
 }
-export declare function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus, placeholder }: Props): import("react").JSX.Element;
+export declare function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus, placeholder, suggestions, onSearchSkills }: Props): import("react").JSX.Element;
 export {};

package/dist/components/InputArea.js

@@ -2,15 +2,44 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text, useInput } from 'ink';
 import TextInput from './TextInput.js';
 import { useState } from 'react';
+import { searchSlashSuggestions } from '../utils/slashCompletion.js';
 import { theme } from '../theme.js';
-export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus = true, placeholder }) {
+export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus = true, placeholder, suggestions = [], onSearchSkills }) {
     const [value, setValue] = useState('');
+    const [completionRevision, setCompletionRevision] = useState(0);
+    const [selected, setSelected] = useState(0);
+    const [dismissed, setDismissed] = useState(false);
+    const matches = dismissed ? [] : searchSlashSuggestions(value, suggestions);
+    const chosen = Math.min(selected, Math.max(0, matches.length - 1));
+    const changeValue = (next) => {
+        if (next.startsWith('/') && !value.startsWith('/'))
+            onSearchSkills?.();
+        setSelected(0);
+        setDismissed(false);
+        setValue(next);
+    };
     const [accumulatedLines, setAccumulatedLines] = useState([]);
     useInput((input, key) => {
         if (disabled || !focus)
             return;
         if (key.ctrl || key.meta || key.pageUp || key.pageDown)
             return;
+        if (matches.length && !accumulatedLines.length) {
+            if (key.escape) {
+                setDismissed(true);
+                return;
+            }
+            if (key.upArrow || key.downArrow) {
+                setSelected(Math.max(0, Math.min(matches.length - 1, chosen + (key.upArrow ? -1 : 1))));
+                return;
+            }
+            if (key.tab) {
+                setValue(`${matches[chosen].name} `);
+                setCompletionRevision(revision => revision + 1);
+                setSelected(0);
+                return;
+            }
+        }
         if (key.return) {
             if (key.shift) {
                 setAccumulatedLines((current) => [...current, value]);
@@ -35,7 +64,7 @@ export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabl
     const restoreInput = (text) => {
         const lines = text.split('\n');
         setAccumulatedLines(lines.slice(0, -1));
-        setValue(lines.at(-1) ?? '');
+        changeValue(lines.at(-1) ?? '');
     };
     const handleSubmit = (text) => {
         if (text.endsWith('\\')) {
@@ -56,5 +85,5 @@ export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabl
     };
     const promptChar = accumulatedLines.length > 0 ? '…' : '›';
     const promptColor = disabled ? theme.dim : theme.primary;
-    return (_jsxs(Box, { flexDirection: "column", children: [accumulatedLines.map((line, idx) => (_jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), _jsx(Text, { children: line })] }, idx))), _jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), disabled ? (_jsx(Text, { color: theme.dim, children: placeholder || '处理中...' })) : (_jsx(TextInput, { focus: focus, value: value, onChange: setValue, placeholder: placeholder || '' }))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [matches.length > 0 && accumulatedLines.length === 0 && (_jsxs(Box, { flexDirection: "column", children: [matches.slice(Math.max(0, chosen - 5), Math.max(0, chosen - 5) + 6).map(item => (_jsxs(Text, { color: item === matches[chosen] ? theme.primary : theme.dim, children: [item === matches[chosen] ? '› ' : '  ', item.name, "  ", item.description] }, item.name))), _jsxs(Text, { dimColor: true, children: ["\u2191\u2193 \u9009\u62E9 \u00B7 Tab \u8865\u5168 \u00B7 \u8F93\u5165\u4EFB\u52A1\u540E Enter \u53D1\u9001 \u00B7 Esc \u6536\u8D77\uFF08", matches.length, " \u9879\uFF09"] })] })), accumulatedLines.map((line, idx) => (_jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), _jsx(Text, { children: line })] }, idx))), _jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), disabled ? (_jsx(Text, { color: theme.dim, children: placeholder || '处理中...' })) : (_jsx(TextInput, { focus: focus, value: value, onChange: changeValue, placeholder: placeholder || '' }, completionRevision))] })] }));
 }

package/dist/config.d.ts

@@ -47,7 +47,7 @@ export interface PulseCliMcpServer {
 export interface PulseCliCapabilities {
     /** IDs must be explicitly enabled; workspace config cannot enable host extensions. */
     enabled?: string[];
-    /** Names of host-installed skills to load as untrusted instructions. */
+    /** Optional discovery allow-list of skill directory names; omitted discovers all. Bodies load only on invocation. */
     skills?: string[];
     /** Additional absolute roots explicitly trusted by the user for installed skills. */
     trustedSkillRoots?: string[];

package/dist/presentation.d.ts

@@ -0,0 +1,11 @@
+export interface PresentationOptions {
+    color?: boolean;
+}
+export declare function shouldUseColor(env: NodeJS.ProcessEnv, isTTY: boolean): boolean;
+export declare function formatVersionOutput(version: string, options?: PresentationOptions): string;
+export interface InstallWelcomeOptions extends PresentationOptions {
+    version: string;
+    configPath?: string;
+    error?: string;
+}
+export declare function formatInstallWelcome(options: InstallWelcomeOptions): string;

package/dist/presentation.js

@@ -0,0 +1,64 @@
+import { releaseHighlights } from './release-highlights.generated.js';
+const bannerLines = [
+    '██████╗ ██╗   ██╗██╗     ███████╗███████╗',
+    '██╔══██╗██║   ██║██║     ██╔════╝██╔════╝',
+    '██████╔╝██║   ██║██║     ███████╗█████╗  ',
+    '██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝  ',
+    '██║     ╚██████╔╝███████╗███████║███████╗',
+    '╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝',
+];
+function paint(code, enabled, value) {
+    return enabled ? `\u001b[${code}m${value}\u001b[0m` : value;
+}
+export function shouldUseColor(env, isTTY) {
+    return env.NO_COLOR === undefined && env.FORCE_COLOR !== '0' && (isTTY || env.FORCE_COLOR !== undefined);
+}
+function banner(color) {
+    return bannerLines.map((line) => paint('36', color, line)).join('\n');
+}
+export function formatVersionOutput(version, options = {}) {
+    const color = options.color === true;
+    const highlights = releaseHighlights[version];
+    const lines = [
+        banner(color),
+        '',
+        `  ${paint('1', color, 'Pulse')} ${paint('2', color, `v${version}`)}`,
+        '',
+        `  ${paint('1', color, '本版本亮点 / What’s new in this version')}`,
+    ];
+    if (highlights?.length) {
+        for (const item of highlights)
+            lines.push(`  • ${item.zh}`, `    ${item.en}`);
+    }
+    else {
+        lines.push('  暂无此版本的更新亮点记录。', '  No release highlights are available for this version yet.');
+    }
+    lines.push('');
+    return `${lines.join('\n')}\n`;
+}
+export function formatInstallWelcome(options) {
+    const { color = false, version, configPath, error } = options;
+    const cyan = (value) => paint('36', color, value);
+    const dim = (value) => paint('2', color, value);
+    const lines = [
+        '',
+        banner(color),
+        '',
+        `  ${paint('1', color, 'Pulse')} v${version} — 面向编程、研究与文件工作的 AI 助手`,
+        `  ${paint('1', color, 'Pulse')} — an AI assistant for coding, research, and file tasks`,
+        '',
+        `  ${paint('1', color, '开始使用 / Get started:')}`,
+        `    ${cyan('cd project_dir')}`,
+        `    ${cyan('pulse')}`,
+        '',
+    ];
+    if (configPath) {
+        lines.push(`  ${dim('配置已就绪 / Configuration ready at:')}`, `    ${configPath}`);
+    }
+    else {
+        lines.push(`  ${dim('配置创建失败 / Configuration could not be created:')} ${error ?? 'Unknown error'}`);
+        lines.push(`  ${dim('稍后运行 "pulse setup" 创建配置。 / Run "pulse setup" later to create it.')}`);
+    }
+    lines.push('');
+    return `${lines.join('\n')}\n`;
+}

package/dist/release-highlights.generated.d.ts

@@ -0,0 +1,4 @@
+export declare const releaseHighlights: Record<string, Array<{
+    zh: string;
+    en: string;
+}>>;

package/dist/release-highlights.generated.js

@@ -0,0 +1,139 @@
+// Generated from CHANGELOG.md and CHANGELOG.en.md by scripts/release/sync-cli-highlights.mjs. Do not edit manually.
+export const releaseHighlights = {
+    "0.4.2": [
+        {
+            "zh": "阶段验收要求每条引用都有效；涉及文件、命令或测试的阶段必须有成功的工具证据，纯写作阶段仍可凭候选结果通过。",
+            "en": "Stage acceptance requires every cited reference to be valid. Stages that touch files, commands, or tests need successful tool evidence, while pure writing stages can still pass on the candidate result."
+        },
+        {
+            "zh": "DeepSeek 不再把未命名 JSON 当成文件写入或命令执行；回复后的附加文本保持为正文，损坏的 DSML 参数按截断处理。",
+            "en": "DeepSeek recovery no longer treats unnamed JSON as a file write or shell command. Trailing text stays text, and invalid DSML parameters are treated as truncation."
+        },
+        {
+            "zh": "暂存写入和提交会拒绝 `.pulse` 路径；列出不存在的目录会返回 ENOENT，已存在的空目录仍返回空列表。",
+            "en": "Staged writes and commits reject `.pulse` paths. Listing a missing directory returns ENOENT, while an existing empty directory still returns an empty list."
+        },
+        {
+            "zh": "命令拆分能识别引号；通过 `sh -c`、`bash -c` 等启动器执行的命令会被拒绝。",
+            "en": "Command splitting respects quotes. Commands launched through shells such as `sh -c` or `bash -c` are rejected."
+        },
+        {
+            "zh": "`pulse resume` 在终端重新进入交互界面；已有任务的非交互运行不再因空闲标准输入一直等待，显式 mock 参数可以覆盖 `PULSE_MODEL`。",
+            "en": "`pulse resume` returns to the interactive screen on a terminal. A non-interactive run that already has a task no longer waits on idle stdin, and explicit mock flags can override `PULSE_MODEL`."
+        }
+    ],
+    "0.4.1": [
+        {
+            "zh": "新增按需发现与调用 Skill 的能力，减少无关指令进入任务上下文。",
+            "en": "Added on-demand Skill discovery and invocation to keep unrelated instructions out of task context."
+        },
+        {
+            "zh": "美化安装欢迎界面和版本页，提供中英双语介绍及版本亮点。",
+            "en": "Polished the installation welcome screen and version page with bilingual product information and release highlights."
+        },
+        {
+            "zh": "提供中英文分离的更新日志和双语用户文档，并校验版本亮点来源。",
+            "en": "Added separate Chinese and English changelogs and bilingual user documentation, with validation for version highlights."
+        },
+        {
+            "zh": "为全部五个 npm 包采用 PolyForm Noncommercial 1.0.0，并随包提供许可证说明。",
+            "en": "Licensed all five npm packages under PolyForm Noncommercial 1.0.0 and included package-level license notices."
+        }
+    ],
+    "0.4.0": [
+        {
+            "zh": "默认使用异步并行 event loop，让模型请求、工具调用等副作用并发推进。",
+            "en": "Uses an asynchronous, parallel event loop by default so model requests, tool calls, and other effects can progress concurrently."
+        }
+    ],
+    "0.3.0": [
+        {
+            "zh": "增强 CLI 交互体验，支持内容选择与复制、推理用量归因、任务进度流式展示和可恢复会话。",
+            "en": "Improved CLI interaction with text selection and copying, reasoning-usage attribution, streamed task progress, and resumable sessions."
+        }
+    ],
+    "0.2.1": [
+        {
+            "zh": "增加安装后的欢迎界面，并完善跨平台本地与云端 CI 验证入口。",
+            "en": "Added the post-install welcome screen and improved the shared cross-platform local and cloud CI entry point."
+        }
+    ],
+    "0.2.0": [
+        {
+            "zh": "扩展 CLI 与 Host 能力，完善会话恢复、人机协作、工具调用和 Windows 沙箱及发布验证。",
+            "en": "Expanded CLI and Host capabilities with resumable sessions, human interaction, tool calls, and improved Windows sandbox and release validation."
+        }
+    ],
+    "0.1.11": [
+        {
+            "zh": "修复 Windows 下打包 CLI 入口加载问题，并改进跨平台安装与发布验证。",
+            "en": "Fixed loading the packaged CLI entry point on Windows and improved cross-platform installation and release validation."
+        }
+    ],
+    "0.1.10": [
+        {
+            "zh": "维护性版本发布；未单独记录用户可见更新。",
+            "en": "Maintenance release; no separate user-facing changes were recorded."
+        }
+    ],
+    "0.1.9": [
+        {
+            "zh": "维护性版本发布；未单独记录用户可见更新。",
+            "en": "Maintenance release; no separate user-facing changes were recorded."
+        }
+    ],
+    "0.1.8": [
+        {
+            "zh": "增加 npm 安装后的首次配置初始化流程。",
+            "en": "Added first-run configuration initialization after npm installation."
+        }
+    ],
+    "0.1.7": [
+        {
+            "zh": "增加完整屏幕 CLI 工作区、模型配置与会话交互能力。",
+            "en": "Added a full-screen CLI workspace, model configuration, and interactive session capabilities."
+        }
+    ],
+    "0.1.6": [
+        {
+            "zh": "增加人类输入仲裁和主动 CLI 交互，并强化上下文、持久化与流式工具调用。",
+            "en": "Added human-input arbitration and active CLI interaction, while strengthening context, persistence, and streamed tool calls."
+        }
+    ],
+    "0.1.5": [
+        {
+            "zh": "改进 Provider 工具名称兼容性。",
+            "en": "Improved compatibility of tool names across providers."
+        }
+    ],
+    "0.1.4": [
+        {
+            "zh": "修复 Provider 安全工具名称的适配问题。",
+            "en": "Fixed adapter handling for provider-safe tool names."
+        }
+    ],
+    "0.1.3": [
+        {
+            "zh": "完善 CLI 工具暴露、用户文件目录和 Provider 错误反馈。",
+            "en": "Improved CLI tool exposure, user-file locations, and provider error reporting."
+        }
+    ],
+    "0.1.2": [
+        {
+            "zh": "修复 CLI 显示已安装包版本的问题。",
+            "en": "Fixed CLI reporting of the installed package version."
+        }
+    ],
+    "0.1.1": [
+        {
+            "zh": "完善首次运行配置创建及基础 npm 工作区使用体验。",
+            "en": "Improved first-run configuration setup and basic npm workspace usage."
+        }
+    ],
+    "0.1.0": [
+        {
+            "zh": "建立 Pulse CLI 初始 npm 发布包和仓库发布元数据。",
+            "en": "Established the initial Pulse CLI npm package and repository release metadata."
+        }
+    ]
+};

package/dist/utils/slashCompletion.d.ts

@@ -0,0 +1,6 @@
+export interface SlashSuggestion {
+    name: string;
+    description: string;
+}
+export declare function skillSuggestions(names: readonly string[], commands: readonly SlashSuggestion[]): SlashSuggestion[];
+export declare function searchSlashSuggestions(value: string, items: readonly SlashSuggestion[]): SlashSuggestion[];

package/dist/utils/slashCompletion.js

@@ -0,0 +1,11 @@
+export function skillSuggestions(names, commands) {
+    const reserved = new Set(commands.map(item => item.name.toLowerCase()));
+    return names.map(name => ({ name: reserved.has(`/${name}`.toLowerCase()) ? `/skill:${name}` : `/${name}`, description: '技能 · 提交时加载' }));
+}
+export function searchSlashSuggestions(value, items) {
+    if (!/^\/\S*$/.test(value))
+        return [];
+    const query = value.slice(1).toLowerCase();
+    return items.filter(item => item.name.slice(1).toLowerCase().includes(query))
+        .sort((a, b) => Number(b.name.slice(1).toLowerCase().startsWith(query)) - Number(a.name.slice(1).toLowerCase().startsWith(query)) || a.name.localeCompare(b.name));
+}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@hunterzhu/pulse-cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "A local-first AI task assistant for coding, research, and file workflows.",
+  "license": "PolyForm-Noncommercial-1.0.0",
   "keywords": [
     "ai",
     "agent",
@@ -27,7 +28,7 @@
     "scripts"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "pnpm --dir ../.. changelog:sync && tsc -p tsconfig.json",
     "postinstall": "node ./scripts/postinstall.mjs"
   },
   "publishConfig": {
@@ -35,7 +36,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@hunterzhu/pulse-server": "0.4.0",
+    "@hunterzhu/pulse-server": "0.4.2",
     "chalk": "^5.4.1",
     "highlight.js": "^11.10.0",
     "ink": "^7.1.1",

package/scripts/postinstall.mjs

@@ -1,58 +1,15 @@
+import { createRequire } from 'node:module'
 import { ensurePulseUserConfig, defaultPulseConfigPath } from '../dist/config.js'
+import { formatInstallWelcome, shouldUseColor } from '../dist/presentation.js'
 
-// Install-time welcome screen. Colors stay off for piped or captured install
-// logs and can be forced with FORCE_COLOR for debugging.
-const colorEnabled =
-  process.env.NO_COLOR === undefined &&
-  process.env.FORCE_COLOR !== '0' &&
-  (process.stdout.isTTY === true || process.env.FORCE_COLOR !== undefined)
-
-const paint = (code) => (text) => (colorEnabled ? `\u001b[${code}m${text}\u001b[0m` : text)
-const cyan = paint('36')
-const bold = paint('1')
-const dim = paint('2')
-
-const banner = [
-  '██████╗ ██╗   ██╗██╗     ███████╗███████╗',
-  '██╔══██╗██║   ██║██║     ██╔════╝██╔════╝',
-  '██████╔╝██║   ██║██║     ███████╗█████╗  ',
-  '██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝  ',
-  '██║     ╚██████╔╝███████╗███████║███████╗',
-  '╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝',
-].map((line) => cyan(line)).join('\n')
-
-function printWelcome({ configPath, error } = {}) {
-  const lines = [
-    '',
-    banner,
-    '',
-    `  ${bold('Pulse')} - a neural-signal like AI assistant for coding, research and file tasks.`,
-    '',
-    `  ${dim('Get started:')}`,
-    `    ${cyan('cd project_dir')}`,
-    `    ${cyan('pulse')}`,
-    '',
-  ]
-
-  if (configPath) {
-    // Print the fully resolved absolute path on its own, uncolored line so it
-    // can be copied straight out of the terminal without ANSI escape codes.
-    lines.push(`  ${dim('Config ready at')}`)
-    lines.push(`    ${configPath}`)
-  } else {
-    lines.push(`  ${dim('Config not created:')} ${error}`)
-    lines.push(`  ${dim('Run "pulse setup" later to create it.')}`)
-  }
-
-  lines.push('')
-  console.log(lines.join('\n'))
-}
+const { version } = createRequire(import.meta.url)('../package.json')
+const color = shouldUseColor(process.env, process.stdout.isTTY === true)
 
 try {
   const configPath = defaultPulseConfigPath()
   await ensurePulseUserConfig(configPath)
-  printWelcome({ configPath })
+  process.stdout.write(formatInstallWelcome({ version, configPath, color }))
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error)
-  printWelcome({ error: message })
+  process.stdout.write(formatInstallWelcome({ version, error: message, color }))
 }