@hunterzhu/pulse-cli 0.1.0 → 0.1.1

package/dist/bin.js

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
 import { createInterface } from 'node:readline';
 import { access, chmod, mkdir, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { dirname } from 'node:path';
 import { createLocalHost } from '@hunterzhu/pulse-server';
-import { expandHome, loadPulseConfig } from './config.js';
+import { defaultPulseConfig, defaultPulseConfigPath, ensurePulseUserConfig, expandHome, loadPulseConfig } from './config.js';
 const version = '0.1.0';
 const help = `Pulse ${version}
 
@@ -32,7 +31,7 @@ Options:
   --no-color                disable terminal styling
   --help, -h                show this help
   --version, -v             show the version
-  setup --force              write a user config template
+  setup --force              write a user config template (also created on first run)
 `;
 function parse(argv) {
     const options = {};
@@ -79,8 +78,9 @@ function parse(argv) {
     return { command, positionals, options };
 }
 function option(options, key) { const value = options[key]; return typeof value === 'string' ? value : undefined; }
-async function hostOptions(parsed) { const requestedCwd = expandHome(option(parsed.options, 'cwd')); const config = (await loadPulseConfig(requestedCwd ?? process.cwd(), expandHome(option(parsed.options, 'config')), parsed.options['trust-workspace'] === true)).value; const providerName = option(parsed.options, 'provider') ?? process.env.PULSE_PROVIDER ?? config.provider?.provider; const model = option(parsed.options, 'model') ?? process.env.PULSE_MODEL ?? config.provider?.model; const baseURL = option(parsed.options, 'base-url') ?? process.env.PULSE_BASE_URL ?? config.provider?.baseURL; const apiKeyEnv = config.provider?.apiKeyEnv ?? (providerName === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY'); const apiKey = process.env[apiKeyEnv]; const provider = providerName ? { provider: providerName, ...(model === undefined ? {} : { defaultModel: model }), ...(baseURL === undefined ? {} : { baseURL }), ...(apiKey === undefined ? {} : { apiKey }) } : undefined; 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 approvalMode = parsed.options['read-only'] === true ? 'read-only' : parsed.options['auto-approve'] === true || process.env.PULSE_AUTO_APPROVE === '1' ? 'auto' : config.approvalMode; const allowNetwork = parsed.options['allow-network'] === true || process.env.PULSE_ALLOW_NETWORK === '1' ? true : config.allowNetwork; return { ...(cwd === undefined ? {} : { cwd }), ...(dataDir === undefined ? {} : { dataDir }), ...(provider === undefined ? {} : { provider }), ...(mockResponse === undefined ? {} : { mockResponse }), ...(approvalMode === undefined ? {} : { approvalMode }), ...(allowNetwork === undefined ? {} : { allowNetwork }) }; }
-async function setupConfig(force, explicitPath) { const path = explicitPath ?? process.env.PULSE_CONFIG ?? join(homedir(), '.pulse', 'config.json'); try {
+async function hostOptions(parsed) { const requestedCwd = expandHome(option(parsed.options, 'cwd')); const explicitConfig = expandHome(option(parsed.options, 'config')); 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 providerName = option(parsed.options, 'provider') ?? process.env.PULSE_PROVIDER ?? config.provider?.provider; const model = option(parsed.options, 'model') ?? process.env.PULSE_MODEL ?? config.provider?.model; const baseURL = option(parsed.options, 'base-url') ?? process.env.PULSE_BASE_URL ?? config.provider?.baseURL; const apiKeyEnv = config.provider?.apiKeyEnv ?? (providerName === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY'); const apiKey = process.env[apiKeyEnv]; const provider = providerName ? { provider: providerName, ...(model === undefined ? {} : { defaultModel: model }), ...(baseURL === undefined ? {} : { baseURL }), ...(apiKey === undefined ? {} : { apiKey }) } : undefined; 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 approvalMode = parsed.options['read-only'] === true ? 'read-only' : parsed.options['auto-approve'] === true || process.env.PULSE_AUTO_APPROVE === '1' ? 'auto' : config.approvalMode; const allowNetwork = parsed.options['allow-network'] === true || process.env.PULSE_ALLOW_NETWORK === '1' ? true : config.allowNetwork; return { ...(cwd === undefined ? {} : { cwd }), ...(dataDir === undefined ? {} : { dataDir }), ...(provider === undefined ? {} : { provider }), ...(mockResponse === undefined ? {} : { mockResponse }), ...(approvalMode === undefined ? {} : { approvalMode }), ...(allowNetwork === undefined ? {} : { allowNetwork }) }; }
+async function setupConfig(force, explicitPath) { const path = explicitPath ?? process.env.PULSE_CONFIG ?? defaultPulseConfigPath(); try {
     await access(path);
     if (!force)
         throw new Error(`CONFIG_EXISTS:${path}`);
@@ -88,7 +88,7 @@ async function setupConfig(force, explicitPath) { const path = explicitPath ?? p
 catch (error) {
     if (error.code !== 'ENOENT' && error instanceof Error && error.message.startsWith('CONFIG_EXISTS:'))
         throw error;
-} await mkdir(join(path, '..'), { recursive: true }); await writeFile(path, `${JSON.stringify({ provider: { provider: 'mock', model: 'mock', apiKeyEnv: 'OPENAI_API_KEY' }, approvalMode: 'ask', allowNetwork: false }, null, 2)}\n`, { mode: 0o600 }); await chmod(path, 0o600); process.stdout.write(`Wrote ${path}\n`); }
+} await mkdir(dirname(path), { recursive: true }); await writeFile(path, `${JSON.stringify(defaultPulseConfig, null, 2)}\n`, { mode: 0o600 }); await chmod(path, 0o600); process.stdout.write(`Wrote ${path}\n`); }
 function writeEvent(event, format) { if (format === 'jsonl') {
     process.stdout.write(`${JSON.stringify(event)}\n`);
     return;

package/dist/config.d.ts

@@ -10,6 +10,10 @@ export interface PulseCliConfig {
     approvalMode?: 'read-only' | 'ask' | 'auto';
     allowNetwork?: boolean;
 }
+export declare const defaultPulseConfig: PulseCliConfig;
+export declare function defaultPulseConfigPath(): string;
+/** Create the user config on first run without replacing an existing file. */
+export declare function ensurePulseUserConfig(path?: string): Promise<void>;
 export declare function expandHome(path: string | undefined): string | undefined;
 /** Workspace files must not escalate approval, network, or provider credentials. */
 export declare function sanitizeWorkspaceConfig(value: PulseCliConfig): PulseCliConfig;

package/dist/config.js

@@ -1,6 +1,35 @@
-import { readFile } from 'node:fs/promises';
+import { access, chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
+export const defaultPulseConfig = {
+    provider: { provider: 'mock', model: 'mock', apiKeyEnv: 'OPENAI_API_KEY' },
+    approvalMode: 'ask',
+    allowNetwork: false,
+};
+export function defaultPulseConfigPath() {
+    return join(homedir(), '.pulse', 'config.json');
+}
+/** Create the user config on first run without replacing an existing file. */
+export async function ensurePulseUserConfig(path = defaultPulseConfigPath()) {
+    await mkdir(dirname(path), { recursive: true });
+    try {
+        await access(path);
+        return;
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    try {
+        await writeFile(path, `${JSON.stringify(defaultPulseConfig, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
+    }
+    catch (error) {
+        // Another process may have initialized the config between access and write.
+        if (error.code !== 'EEXIST')
+            throw error;
+    }
+    await chmod(path, 0o600);
+}
 export function expandHome(path) {
     if (path === undefined)
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/zhuhengtan/Pulse"
@@ -19,6 +19,6 @@
     "build": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@hunterzhu/pulse-server": "0.1.0"
+    "@hunterzhu/pulse-server": "0.1.1"
   }
 }