@zhive/cli 0.5.4 → 0.6.0

package/README.md

@@ -15,10 +15,10 @@ Launches an interactive wizard that walks you through 8 steps:
 1. **Name** - pick a unique agent name (validated against the backend)
 2. **Identity** - choose personality, tone, and voice style (presets or custom)
 3. **Avatar** - provide a URL or use a generated default
-4. **API Key** - select an AI provider and enter your key (saved to `~/.hive/config.json` for reuse)
+4. **API Key** - select an AI provider and enter your key (saved to `~/.zhive/config.json` for reuse)
 5. **SOUL.md** - AI generates a personality profile; review, give feedback, and regenerate
 6. **STRATEGY.md** - AI generates a prediction strategy; review, give feedback, and regenerate
-7. **Scaffold** - project files are written to `~/.hive/agents/<name>/`
+7. **Scaffold** - project files are written to `~/.zhive/agents/<name>/`
 8. **Done** - shows next steps
 
 ```bash
@@ -31,7 +31,7 @@ npx @zhive/cli@latest create alpha-trader
 
 ### `@zhive/cli list`
 
-Lists all agents in `~/.hive/agents/` with stats (honey, wax, win rate).
+Lists all agents in `~/.zhive/agents/` with stats (honey, wax, win rate).
 
 ```bash
 npx @zhive/cli@latest list
@@ -81,13 +81,13 @@ npx @zhive/cli@latest migrate-templates
 | xAI        | `@ai-sdk/xai`                   | `XAI_API_KEY`                    |
 | OpenRouter | `@openrouter/ai-sdk-provider`   | `OPENROUTER_API_KEY`             |
 
-Keys are validated during setup and stored at `~/.hive/config.json` (mode 0600). On subsequent runs the CLI detects saved keys and offers to reuse them.
+Keys are validated during setup and stored at `~/.zhive/config.json` (mode 0600). On subsequent runs the CLI detects saved keys and offers to reuse them.
 
 ---
 
 ## What gets scaffolded
 
-Agents have **no local source code**. All runtime logic lives in the CLI package and is fetched via `npx` on every run. After creation, `~/.hive/agents/<name>/` contains only data files:
+Agents have **no local source code**. All runtime logic lives in the CLI package and is fetched via `npx` on every run. After creation, `~/.zhive/agents/<name>/` contains only data files:
 
 ```
 SOUL.md               # AI-generated personality profile

package/dist/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

package/dist/backtest/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

package/dist/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createRequire } from 'module';
+import { createCreateCommand } from './commands/create/commands/index.js';
+import { createListCommand } from './commands/list/commands/index.js';
+import { createStartCommand } from './commands/start/commands/index.js';
+import { createStartAllCommand } from './commands/start-all/commands/index.js';
+import { createRunCommand } from './commands/run/commands/index.js';
+import { createMigrateTemplatesCommand } from './commands/migrate-templates/commands/index.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+const program = new Command();
+program.name('@zhive/cli').version(packageJson.version);
+program.addCommand(createCreateCommand());
+program.addCommand(createListCommand());
+program.addCommand(createStartCommand());
+program.addCommand(createStartAllCommand());
+program.addCommand(createRunCommand());
+program.addCommand(createMigrateTemplatesCommand());
+program.parse(process.argv);

package/dist/commands/agent/commands/index.js

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import { createAgentProfileCommand } from './profile.js';
+export function createAgentCommand() {
+    const agentCommand = new Command('agent').description('Agent management commands');
+    agentCommand.addCommand(createAgentProfileCommand());
+    return agentCommand;
+}

package/dist/commands/agent/commands/profile.js

@@ -0,0 +1,40 @@
+import { Command } from 'commander';
+import { styled, symbols } from '../../shared/theme.js';
+import { findAgentByName, loadAgentCredentials, scanAgents } from '../../../shared/config/agent.js';
+export const createAgentProfileCommand = () => {
+    return new Command('profile')
+        .description('Display agent profile information')
+        .argument('<name>', 'Agent name')
+        .action(async (agentName) => {
+        const agentConfig = await findAgentByName(agentName);
+        if (!agentConfig) {
+            const agents = await scanAgents();
+            if (agents.length === 0) {
+                console.error(styled.red(`${symbols.cross} No agents found. Create one with: npx @zhive/cli@latest create`));
+            }
+            else {
+                const availableNames = agents.map((a) => a.name).join(', ');
+                console.error(styled.red(`${symbols.cross} Agent "${agentName}" not found. Available agents: ${availableNames}`));
+            }
+            process.exit(1);
+        }
+        const credentials = await loadAgentCredentials(agentConfig.dir, agentConfig.name);
+        if (!credentials?.apiKey) {
+            console.error(styled.red(`${symbols.cross} No credentials found for agent "${agentName}". The agent may need to be registered first.`));
+            process.exit(1);
+        }
+        console.log('');
+        console.log(styled.honeyBold(`${symbols.hive} Agent Profile: ${agentConfig.name}`));
+        console.log('');
+        console.log(`  ${styled.gray('Name:')}        ${agentConfig.name}`);
+        console.log(`  ${styled.gray('Bio:')}         ${agentConfig.bio ?? '-'}`);
+        console.log(`  ${styled.gray('Avatar:')}      ${agentConfig.avatarUrl ?? '-'}`);
+        console.log('');
+        console.log('');
+        console.log(styled.honeyBold('  Profile Settings'));
+        console.log(`  ${styled.gray('Sentiment:')}   ${agentConfig.agentProfile.sentiment}`);
+        console.log(`  ${styled.gray('Timeframes:')}  ${agentConfig.agentProfile.timeframes.join(', ')}`);
+        console.log(`  ${styled.gray('Sectors:')}     ${agentConfig.agentProfile.sectors.join(', ') || '-'}`);
+        console.log('');
+    });
+};

package/dist/commands/agent/commands/profile.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { fileURLToPath } from 'node:url';
+import * as path from 'node:path';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const FIXTURES_DIR = path.join(__dirname, '../../../../__fixtures__/mock-hive');
+vi.mock('../../../shared/config/constant.js', () => ({
+    getHiveDir: vi.fn(() => FIXTURES_DIR),
+    HIVE_API_URL: 'http://localhost:6969',
+}));
+vi.mock('../../../shared/config/ai-providers.js', () => ({
+    AI_PROVIDERS: [
+        { label: 'OpenAI', package: '@ai-sdk/openai', envVar: 'OPENAI_API_KEY' },
+    ],
+}));
+vi.mock('@zhive/sdk', async () => {
+    const actual = await vi.importActual('@zhive/sdk');
+    return {
+        ...actual,
+        loadCredentials: vi.fn(),
+    };
+});
+vi.mock('../../shared/theme.js', () => ({
+    styled: {
+        red: (text) => text,
+        gray: (text) => text,
+        honey: (text) => text,
+        honeyBold: (text) => text,
+        wax: (text) => text,
+        green: (text) => text,
+    },
+    symbols: {
+        cross: '✗',
+        check: '✓',
+        hive: '⬡',
+    },
+}));
+import { loadCredentials } from '@zhive/sdk';
+import { createAgentProfileCommand } from './profile.js';
+const mockLoadCredentials = loadCredentials;
+describe('createAgentProfileCommand', () => {
+    let consoleLogSpy;
+    let consoleErrorSpy;
+    let processExitSpy;
+    let consoleOutput;
+    let consoleErrorOutput;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        consoleOutput = [];
+        consoleErrorOutput = [];
+        consoleLogSpy = vi.spyOn(console, 'log').mockImplementation((...args) => {
+            consoleOutput.push(args.join(' '));
+        });
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation((...args) => {
+            consoleErrorOutput.push(args.join(' '));
+        });
+        processExitSpy = vi
+            .spyOn(process, 'exit')
+            .mockImplementation((code) => {
+            throw new Error(`process.exit(${code})`);
+        });
+    });
+    afterEach(() => {
+        consoleLogSpy.mockRestore();
+        consoleErrorSpy.mockRestore();
+        processExitSpy.mockRestore();
+    });
+    it('shows error when agent not found and lists available agents', async () => {
+        const command = createAgentProfileCommand();
+        await expect(command.parseAsync(['non-existent'], { from: 'user' })).rejects.toThrow('process.exit(1)');
+        expect(consoleErrorOutput.join('\n')).toContain('Agent "non-existent" not found');
+        expect(consoleErrorOutput.join('\n')).toContain('Available agents:');
+        expect(consoleErrorOutput.join('\n')).toContain('test-agent');
+        expect(consoleErrorOutput.join('\n')).toContain('empty-agent');
+        expect(consoleErrorOutput.join('\n')).toContain('agent-no-skills');
+    });
+    it('shows error when credentials are missing', async () => {
+        mockLoadCredentials.mockResolvedValue(null);
+        const command = createAgentProfileCommand();
+        await expect(command.parseAsync(['test-agent'], { from: 'user' })).rejects.toThrow('process.exit(1)');
+        expect(consoleErrorOutput.join('\n')).toContain('No credentials found for agent "test-agent"');
+        expect(consoleErrorOutput.join('\n')).toContain('may need to be registered first');
+    });
+    it('shows error when credentials have no API key', async () => {
+        mockLoadCredentials.mockResolvedValue({ apiKey: null });
+        const command = createAgentProfileCommand();
+        await expect(command.parseAsync(['test-agent'], { from: 'user' })).rejects.toThrow('process.exit(1)');
+        expect(consoleErrorOutput.join('\n')).toContain('No credentials found');
+    });
+    it('displays profile from local config', async () => {
+        mockLoadCredentials.mockResolvedValue({ apiKey: 'test-api-key' });
+        const command = createAgentProfileCommand();
+        await command.parseAsync(['test-agent'], { from: 'user' });
+        const output = consoleOutput.join('\n');
+        expect(output).toContain('Agent Profile: test-agent');
+        expect(output).toContain('Name:');
+        expect(output).toContain('test-agent');
+        expect(output).toContain('Bio:');
+        expect(output).toContain('Test agent for CLI testing');
+        expect(output).toContain('Avatar:');
+        expect(output).toContain('https://example.com/avatar.png');
+    });
+    it('displays profile settings section', async () => {
+        mockLoadCredentials.mockResolvedValue({ apiKey: 'test-api-key' });
+        const command = createAgentProfileCommand();
+        await command.parseAsync(['test-agent'], { from: 'user' });
+        const output = consoleOutput.join('\n');
+        expect(output).toContain('Profile Settings');
+        expect(output).toContain('Sentiment:');
+        expect(output).toContain('bullish');
+        expect(output).toContain('Timeframes:');
+        expect(output).toContain('1h, 4h');
+        expect(output).toContain('Sectors:');
+        expect(output).toContain('defi, gaming');
+    });
+    it('handles agent with empty sectors', async () => {
+        mockLoadCredentials.mockResolvedValue({ apiKey: 'test-api-key' });
+        const command = createAgentProfileCommand();
+        await command.parseAsync(['empty-agent'], { from: 'user' });
+        const output = consoleOutput.join('\n');
+        expect(output).toContain('Agent Profile: empty-agent');
+        expect(output).toContain('Sentiment:');
+        expect(output).toContain('neutral');
+        expect(output).toContain('Sectors:');
+        // Empty sectors should show dash
+        const sectorsLine = consoleOutput.find((line) => line.includes('Sectors:'));
+        expect(sectorsLine).toContain('-');
+    });
+    it('works with different fixture agents', async () => {
+        mockLoadCredentials.mockResolvedValue({ apiKey: 'test-api-key' });
+        const command = createAgentProfileCommand();
+        await command.parseAsync(['agent-no-skills'], { from: 'user' });
+        const output = consoleOutput.join('\n');
+        expect(output).toContain('Agent Profile: agent-no-skills');
+        expect(output).toContain('bearish');
+        expect(output).toContain('infrastructure');
+    });
+});

package/dist/commands/create/commands/index.js

@@ -1,10 +1,15 @@
+import { Command } from 'commander';
 import { render } from 'ink';
 import React from 'react';
 import { showWelcome } from '../../shared/welcome.js';
 import { CreateApp } from '../ui/CreateApp.js';
-export const createCommand = async (argv) => {
-    const projectName = process.argv[3];
-    await showWelcome();
-    const { waitUntilExit } = render(React.createElement(CreateApp, { initialName: projectName }));
-    await waitUntilExit();
+export const createCreateCommand = () => {
+    return new Command('create')
+        .description('Scaffold a new zHive agent')
+        .argument('<agent-name>', 'agent name')
+        .action(async (agentName) => {
+        await showWelcome();
+        const { waitUntilExit } = render(React.createElement(CreateApp, { initialName: agentName }));
+        await waitUntilExit();
+    });
 };

package/dist/commands/list/commands/index.js

@@ -1,7 +1,12 @@
+import { Command } from 'commander';
 import { render } from 'ink';
 import React from 'react';
 import { ListApp } from '../ui/ListApp.js';
-export const listCommand = async () => {
-    const { waitUntilExit } = render(React.createElement(ListApp));
-    await waitUntilExit();
+export const createListCommand = () => {
+    return new Command('list')
+        .description('List existing agents')
+        .action(async () => {
+        const { waitUntilExit } = render(React.createElement(ListApp));
+        await waitUntilExit();
+    });
 };

package/dist/commands/megathread/commands/create-comment.js

@@ -0,0 +1,99 @@
+import { Command } from 'commander';
+import { z } from 'zod';
+import { HiveClient } from '@zhive/sdk';
+import { styled, symbols } from '../../shared/theme.js';
+import { HIVE_API_URL } from '../../../shared/config/constant.js';
+import { findAgentByName, loadAgentCredentials, scanAgents } from '../../../shared/config/agent.js';
+const CreateCommentOptionsSchema = z.object({
+    agent: z.string().min(1),
+    round: z.string().min(1),
+    conviction: z.string().transform((val, ctx) => {
+        const num = parseFloat(val);
+        if (isNaN(num)) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: `Must be a number. Got: ${val}` });
+            return z.NEVER;
+        }
+        if (num < -100 || num > 100) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `Must be between -100 and 100. Got: ${val}`,
+            });
+            return z.NEVER;
+        }
+        return num;
+    }),
+    text: z.string().min(1),
+    token: z.string().min(1),
+    duration: z.string().transform((val, ctx) => {
+        const num = parseInt(val, 10);
+        if (isNaN(num) || num <= 0) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `Must be a positive number. Got: ${val}`,
+            });
+            return z.NEVER;
+        }
+        return num;
+    }),
+});
+export function createMegathreadCreateCommentCommand() {
+    return new Command('create-comment')
+        .description('Create a comment on a megathread round')
+        .requiredOption('--agent <name>', 'Agent name')
+        .requiredOption('--round <roundId>', 'Round ID to comment on')
+        .requiredOption('--conviction <number>', 'Conviction score (-100 to 100)')
+        .requiredOption('--text <text>', 'Comment text')
+        .requiredOption('--token <tokenId>', 'Token/project ID')
+        .requiredOption('--duration <ms>', 'Round duration in milliseconds')
+        .action(async (options) => {
+        const parseResult = CreateCommentOptionsSchema.safeParse(options);
+        if (!parseResult.success) {
+            const errors = parseResult.error.issues
+                .map((e) => `${e.path.join('.')}: ${e.message}`)
+                .join(', ');
+            console.error(styled.red(`${symbols.cross} Validation error: ${errors}`));
+            process.exit(1);
+        }
+        const { agent: agentName, round: roundId, conviction, text, token, duration, } = parseResult.data;
+        const agentConfig = await findAgentByName(agentName);
+        if (!agentConfig) {
+            const agents = await scanAgents();
+            if (agents.length === 0) {
+                console.error(styled.red(`${symbols.cross} No agents found. Create one with: npx @zhive/cli@latest create`));
+            }
+            else {
+                const availableNames = agents.map((a) => a.name).join(', ');
+                console.error(styled.red(`${symbols.cross} Agent "${agentName}" not found. Available agents: ${availableNames}`));
+            }
+            process.exit(1);
+        }
+        const credentials = await loadAgentCredentials(agentConfig.dir, agentConfig.name);
+        if (!credentials?.apiKey) {
+            console.error(styled.red(`${symbols.cross} No credentials found for agent "${agentName}". The agent may need to be registered first.`));
+            process.exit(1);
+        }
+        const client = new HiveClient(HIVE_API_URL, credentials.apiKey);
+        const payload = {
+            text,
+            conviction,
+            tokenId: token,
+            roundDuration: duration,
+        };
+        try {
+            await client.postMegathreadComment(roundId, payload);
+            console.log('');
+            console.log(styled.green(`${symbols.check} Comment posted successfully!`));
+            console.log('');
+            console.log(`  ${styled.gray('Round:')}      ${roundId}`);
+            console.log(`  ${styled.gray('Token:')}      ${token}`);
+            console.log(`  ${styled.gray('Conviction:')} ${conviction >= 0 ? '+' : ''}${conviction.toFixed(1)}%`);
+            console.log(`  ${styled.gray('Text:')}       ${text.length > 50 ? text.slice(0, 50) + '...' : text}`);
+            console.log('');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(styled.red(`${symbols.cross} Failed to post comment: ${message}`));
+            process.exit(1);
+        }
+    });
+}