@hunterzhu/pulse-cli 0.4.1 → 0.4.2

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';
@@ -60,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
@@ -123,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;
@@ -169,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;
@@ -186,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)
@@ -213,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 {
@@ -227,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'
@@ -291,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() } : {}),
@@ -307,6 +372,10 @@ export async function hostOptions(parsed) {
         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) }),
@@ -345,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/release-highlights.generated.js

@@ -1,5 +1,27 @@
 // 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 的能力，减少无关指令进入任务上下文。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "A local-first AI task assistant for coding, research, and file workflows.",
   "license": "PolyForm-Noncommercial-1.0.0",
   "keywords": [
@@ -36,7 +36,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@hunterzhu/pulse-server": "0.4.1",
+    "@hunterzhu/pulse-server": "0.4.2",
     "chalk": "^5.4.1",
     "highlight.js": "^11.10.0",
     "ink": "^7.1.1",