@hive-org/cli 0.0.1

package/templates/index.tsx

@@ -0,0 +1,257 @@
+import React from 'react';
+import { render, Box, Text } from 'ink';
+import TextInput from 'ink-text-input';
+import * as dotenv from 'dotenv';
+import { useAgent } from './hooks/useAgent';
+import { setupProcessLifecycle } from './process-lifecycle';
+import { colors, symbols, border } from './theme';
+import { formatTime, convictionColor } from './helpers';
+import { Spinner, PollText } from './components/Spinner';
+import { AsciiTicker } from './components/AsciiTicker';
+import { HoneycombBoot } from './components/HoneycombBoot';
+
+dotenv.config({ override: true });
+
+// ─── Main TUI App ────────────────────────────────────
+
+function AgentApp(): React.ReactElement {
+  const {
+    phase,
+    connected,
+    agentName,
+    pollActivity,
+    chatActivity,
+    input,
+    chatStreaming,
+    chatBuffer,
+    predictionCount,
+    termWidth,
+    setInput,
+    handleChatSubmit,
+    handleBootComplete,
+  } = useAgent();
+
+  if (phase === 'booting') {
+    return <HoneycombBoot agentName={agentName} width={termWidth} onComplete={handleBootComplete} />;
+  }
+
+  const boxWidth = termWidth;
+  const visiblePollActivity = pollActivity.slice(-10);
+  const visibleChatActivity = chatActivity.slice(-3);
+
+  const statsText =
+    predictionCount > 0 ? ` ${border.horizontal.repeat(3)} ${predictionCount} predicted` : '';
+  const connectedDisplay = connected ? 'Connected to the Hive' : 'connecting...';
+  const nameDisplay = `${agentName} agent`;
+  const headerFill = Math.max(
+    0,
+    boxWidth - nameDisplay.length - connectedDisplay.length - 12 - statsText.length,
+  );
+
+  return (
+    <Box flexDirection="column" width={boxWidth}>
+      {/* ASCII Ticker */}
+      <AsciiTicker rows={2} step={predictionCount} />
+
+      {/* Header */}
+      <Box>
+        <Text color={colors.honey}>{`${border.topLeft}${border.horizontal} ${symbols.hive} `}</Text>
+        <Text color="white" bold>
+          {agentName} agent
+        </Text>
+        <Text color="gray"> {`${border.horizontal.repeat(3)} `}</Text>
+        <Text color={connected ? 'green' : 'yellow'}>
+          {connected ? 'Connected to the Hive' : 'connecting...'}
+        </Text>
+        {statsText && <Text color="gray"> {`${border.horizontal.repeat(3)} `}</Text>}
+        {statsText && <Text color={colors.honey}>{predictionCount} predicted</Text>}
+        <Text color="gray">
+          {' '}
+          {border.horizontal.repeat(Math.max(0, headerFill))}
+          {border.topRight}
+        </Text>
+      </Box>
+
+      {/* Polling Feed */}
+      <Box flexDirection="column" paddingLeft={1} paddingRight={1} minHeight={8} maxHeight={24}>
+        {!connected && <Spinner label="Initiating neural link..." />}
+        {visiblePollActivity.map((item, i) => {
+          const isNewest = i === visiblePollActivity.length - 1 && item.type !== 'analyzing';
+          return (
+            <Box key={i} flexDirection="column">
+              {item.type === 'online' && (
+                <Box>
+                  <Text color="gray" dimColor>
+                    {formatTime(item.timestamp)}{' '}
+                  </Text>
+                  <Text color={colors.honey}>{symbols.hive} </Text>
+                  <PollText color="white" text={item.text} animate={isNewest} />
+                </Box>
+              )}
+              {item.type === 'signal' && (
+                <Box>
+                  <Text color="gray" dimColor>
+                    {formatTime(item.timestamp)}{' '}
+                  </Text>
+                  <Text color={colors.honey}>{symbols.hive} </Text>
+                  <PollText color="cyan" text={item.text} animate={isNewest} />
+                </Box>
+              )}
+              {item.type === 'signal' && item.detail && (
+                <Box marginLeft={13}>
+                  <PollText color="gray" text={`"${item.detail}"`} animate={isNewest} />
+                </Box>
+              )}
+              {item.type === 'analyzing' && (
+                <Box marginLeft={13}>
+                  <Spinner label={item.text} />
+                </Box>
+              )}
+              {item.type === 'posted' && (
+                <Box>
+                  <Text color="gray" dimColor>
+                    {formatTime(item.timestamp)}{' '}
+                  </Text>
+                  <Text color={convictionColor(item.conviction ?? 0)}>
+                    {symbols.diamond} Predicted{' '}
+                  </Text>
+                  <PollText color="white" text={item.text} animate={isNewest} />
+                </Box>
+              )}
+              {item.type === 'skipped' && (
+                <Box>
+                  <Text color="gray" dimColor>
+                    {formatTime(item.timestamp)}{' '}
+                  </Text>
+                  <PollText
+                    color="yellow"
+                    text={`${symbols.diamondOpen} ${item.text}`}
+                    animate={isNewest}
+                  />
+                </Box>
+              )}
+              {item.type === 'error' && (
+                <Box>
+                  <Text color="gray" dimColor>
+                    {formatTime(item.timestamp)}{' '}
+                  </Text>
+                  <PollText
+                    color="red"
+                    text={`${symbols.cross} ${item.text}`}
+                    animate={isNewest}
+                  />
+                </Box>
+              )}
+              {item.type === 'idle' && (
+                <Box>
+                  <Text color="gray" dimColor>
+                    {formatTime(item.timestamp)}{' '}
+                  </Text>
+                  <PollText
+                    color="gray"
+                    text={`${symbols.circle} ${item.text}`}
+                    animate={isNewest}
+                  />
+                </Box>
+              )}
+            </Box>
+          );
+        })}
+      </Box>
+
+      {/* Chat section - visible after first message */}
+      {(chatActivity.length > 0 || chatStreaming) && (
+        <>
+          <Box>
+            <Text color="gray">
+              {border.teeLeft}
+              {`${border.horizontal.repeat(2)} chat with ${agentName} agent `}
+              {border.horizontal.repeat(Math.max(0, boxWidth - agentName.length - 22))}
+              {border.teeRight}
+            </Text>
+          </Box>
+          <Box flexDirection="column" paddingLeft={1} paddingRight={1} minHeight={2} maxHeight={8}>
+            {visibleChatActivity.map((item, i) => (
+              <Box key={i}>
+                {item.type === 'chat-user' && (
+                  <Box>
+                    <Text color="white" bold>
+                      you:{' '}
+                    </Text>
+                    <Text color="white">{item.text}</Text>
+                  </Box>
+                )}
+                {item.type === 'chat-agent' && (
+                  <Box>
+                    <Text color={colors.honey} bold>
+                      {agentName} agent:{' '}
+                    </Text>
+                    <Text color="white" wrap="wrap">
+                      {item.text}
+                    </Text>
+                  </Box>
+                )}
+                {item.type === 'chat-error' && (
+                  <Box>
+                    <Text color="red">
+                      {symbols.cross} {item.text}
+                    </Text>
+                  </Box>
+                )}
+              </Box>
+            ))}
+            {chatStreaming && chatBuffer && (
+              <Box>
+                <Text color={colors.honey} bold>
+                  {agentName} agent:{' '}
+                </Text>
+                <Text color="white" wrap="wrap">
+                  {chatBuffer}
+                </Text>
+              </Box>
+            )}
+          </Box>
+        </>
+      )}
+
+      {/* Input Bar */}
+      <Box>
+        <Text color="gray">
+          {border.teeLeft}
+          {border.horizontal.repeat(boxWidth - 2)}
+          {border.teeRight}
+        </Text>
+      </Box>
+      <Box paddingLeft={1}>
+        <Text color={colors.honey}>{symbols.arrow} </Text>
+        <TextInput
+          value={input}
+          onChange={setInput}
+          onSubmit={(val) => {
+            setInput('');
+            void handleChatSubmit(val);
+          }}
+          placeholder={chatStreaming ? 'thinking...' : `chat with ${agentName} agent...`}
+        />
+      </Box>
+      <Box>
+        <Text color="gray">
+          {border.bottomLeft}
+          {border.horizontal.repeat(boxWidth - 2)}
+          {border.bottomRight}
+        </Text>
+      </Box>
+    </Box>
+  );
+}
+
+// ─── Entrypoint ──────────────────────────────────────
+
+setupProcessLifecycle();
+
+const app = render(React.createElement(AgentApp));
+
+process.stdout.on('resize', () => {
+  process.stdout.write('\x1b[2J\x1b[H');
+  app.clear();
+});

package/templates/memory-prompt.ts

@@ -0,0 +1,60 @@
+import type { ChatMessage } from './chat-prompt';
+
+export interface MemoryExtractionContext {
+  currentMemory: string;
+  sessionMessages: ChatMessage[];
+  lineCount: number;
+}
+
+export function buildMemoryExtractionPrompt(context: MemoryExtractionContext): string {
+  const { currentMemory, sessionMessages, lineCount } = context;
+
+  let sessionSection = '';
+  if (sessionMessages.length > 0) {
+    const listed = sessionMessages
+      .map((m) => `${m.role === 'user' ? 'Operator' : 'Agent'}: ${m.content}`)
+      .join('\n');
+    sessionSection = `\n## Session Chat Log\n\n${listed}\n`;
+  }
+
+  const currentMemorySection =
+    currentMemory.trim().length > 0
+      ? `\n## Current MEMORY.md\n\n\`\`\`markdown\n${currentMemory}\n\`\`\`\n`
+      : '\n## Current MEMORY.md\n\n(empty - this is a fresh agent)\n';
+
+  const consolidationNote =
+    lineCount > 200
+      ? `\n**IMPORTANT: The current memory is ${lineCount} lines, exceeding the 200-line soft limit. Aggressively consolidate: merge related items, remove outdated or low-value entries, and keep only the most important context.**\n`
+      : '';
+
+  const prompt = `You are an AI trading agent's memory system. Your job is to maintain conversational continuity between sessions with the agent's operator.
+${currentMemorySection}${consolidationNote}
+## Session Activity
+${sessionSection}
+## Instructions
+
+Review the session chat log above and update the agent's MEMORY.md file. This memory is about **conversational continuity** — making the agent feel like it remembers past sessions with its operator.
+
+Focus on extracting:
+1. **Topics discussed** — what subjects came up in conversation (e.g., "we talked about ETH gas fees", "operator asked about macro outlook")
+2. **Operator interests and concerns** — what the operator cares about, recurring themes, questions they've raised
+3. **Ongoing conversational threads** — topics that span multiple sessions or feel unresolved
+4. **Operator preferences** — how they like to interact, what they find useful or annoying
+
+Do NOT save:
+- Market predictions, signal analysis, or trading insights — a separate results-based learning system will handle those in the future
+- Raw price data or signal summaries
+- Routine prediction outcomes
+
+Follow these rules:
+1. **Merge, don't duplicate** — If a topic already exists in the current memory, update it rather than adding a duplicate.
+2. **Remove outdated info** — If the session contradicts something in the current memory, update or remove the old entry.
+3. **Stay concise** — Each entry should be 1-2 lines. Use bullet points.
+4. **Organize by topic** — Use markdown headers to group related context (e.g., "## Conversations", "## Operator Interests", "## Ongoing Threads").
+5. **Only save meaningful context** — Don't save trivial chat messages or greetings. Save things that would make the agent seem like it remembers the operator.
+6. **Keep it under ~200 lines** — This file is injected into every prompt, so brevity matters.
+
+Output the complete updated MEMORY.md content. Start with \`# Memory\` as the top-level header. Output ONLY the markdown content, no code fences or explanation.`;
+
+  return prompt;
+}

package/templates/process-lifecycle.ts

@@ -0,0 +1,66 @@
+import chalk from 'chalk';
+import { symbols } from './theme';
+
+type ShutdownFn = () => Promise<void>;
+
+let _shutdownAgent: ShutdownFn | null = null;
+let _shuttingDown = false;
+
+export function registerShutdownAgent(fn: ShutdownFn): void {
+  _shutdownAgent = fn;
+}
+
+export function clearShutdownAgent(): void {
+  _shutdownAgent = null;
+}
+
+const restoreScreen = (): void => {
+  process.stdout.write('\x1b[?1049l');
+};
+
+const gracefulShutdown = async (): Promise<void> => {
+  if (_shuttingDown) {
+    return;
+  }
+  _shuttingDown = true;
+
+  if (_shutdownAgent) {
+    try {
+      await _shutdownAgent();
+    } catch {
+      // Best-effort memory save on shutdown
+    }
+    _shutdownAgent = null;
+  }
+  restoreScreen();
+  process.exit(0);
+};
+
+export function setupProcessLifecycle(): void {
+  // Unhandled rejection handler
+  process.on('unhandledRejection', (reason) => {
+    const raw = reason instanceof Error ? reason.message : String(reason);
+    const message = raw.length > 200 ? raw.slice(0, 200) + '\u2026' : raw;
+    console.error(chalk.red(`  ${symbols.cross} Unhandled: ${message}`));
+  });
+
+  // Use alternate screen buffer (like vim/htop) to prevent text reflow on resize.
+  // The normal buffer reflows wrapped lines when the terminal width changes, which
+  // desyncs Ink's internal line counter and produces ghost copies of the UI.
+  // The alternate buffer is position-based — no reflow, no ghosts.
+  process.stdout.write('\x1b[?1049h');
+
+  process.on('exit', restoreScreen);
+  process.on('SIGINT', () => {
+    gracefulShutdown().catch(() => {
+      restoreScreen();
+      process.exit(1);
+    });
+  });
+  process.on('SIGTERM', () => {
+    gracefulShutdown().catch(() => {
+      restoreScreen();
+      process.exit(1);
+    });
+  });
+}

package/templates/prompt.ts

@@ -0,0 +1,160 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import type { CitationDto } from './hive/objects';
+
+export interface BuildPromptOptions {
+  threadText: string;
+  projectId: string;
+  timestamp: string;
+  priceOnFetch: number;
+  citations: CitationDto[];
+  recentPosts?: readonly string[];
+  memory?: string;
+}
+
+async function loadMarkdownFile(filename: string): Promise<string> {
+  const filePath = path.join(process.cwd(), filename);
+  const content = await fs.readFile(filePath, 'utf-8');
+  return content;
+}
+
+export async function buildAnalystPrompt(options: BuildPromptOptions): Promise<string> {
+  const { threadText, projectId, timestamp, priceOnFetch, citations, recentPosts, memory } =
+    options;
+
+  const soulContent = await loadMarkdownFile('SOUL.md');
+  const strategyContent = await loadMarkdownFile('STRATEGY.md');
+
+  let recentPostsSection = '';
+  if (recentPosts && recentPosts.length > 0) {
+    const listed = recentPosts.map((p) => `- "${p}"`).join('\n');
+    recentPostsSection = `
+## Anti-repetition
+
+Your recent posts (do NOT repeat these structures, phrases, or opening patterns):
+${listed}
+
+If you catch yourself writing something that sounds like any of the above - stop and take a completely different angle.
+`;
+  }
+
+  let memorySection = '';
+  if (memory && memory.trim().length > 0) {
+    memorySection = `
+## Agent Memory
+
+Your persistent learnings from past sessions:
+${memory}
+`;
+  }
+
+  let citationsSection = '';
+  if (citations.length > 0) {
+    const listed = citations.map((c) => `- [${c.title}](${c.url})`).join('\n');
+    citationsSection = `
+## Sources
+
+${listed}
+`;
+  }
+
+  const prompt = `You are a Crypto Twitter personality. Here's who you are:
+---
+${soulContent}
+---
+You ARE this person. Reference your life, relationships, and background naturally when the signal connects to them. If policy news drops and your character has a parent in politics, say "my dad." If your character is wealthy, reference it on dip news. Be self-aware of who you are.
+
+Your opinions, pet peeves, and example posts in SOUL.md are your personality anchors.
+Rotate through them naturally - don't use the same opinion or quirk in consecutive posts.
+Your example posts set the quality bar and tone target. Match their energy, not their exact words.
+
+Your trading lens:
+---
+${strategyContent}
+---
+
+## Context
+
+- Project: c/${projectId}
+- Signal time: ${timestamp}
+- Price at signal: $${priceOnFetch}
+${citationsSection}
+## How scoring works
+
+You are predicting the % price change from the snapshot price ($${priceOnFetch}) over 3 hours from signal time.
+- Correct direction + close to actual = max honey (up to +100)
+- Correct direction but far off = less honey
+- Wrong direction = -25 honey penalty
+- Skipping = no penalty, no reward
+- Earlier predictions earn dramatically more honey (cubic time decay)
+- Predicting late earns almost nothing even if correct
+${recentPostsSection}${memorySection}
+## How you write
+
+Write like an anonymous poster on 4chan, reddit, or crypto twitter. Not an analyst. Not an AI. A real person shitposting with conviction.
+
+Think about how people actually talk in these spaces:
+- They don't explain themselves. They just say it.
+- They're blunt, sarcastic, dismissive, funny, or dead serious. Sometimes all at once.
+- They use slang naturally: ngl, tbh, copium, ngmi, imo, idk, lmao, kek, based, cope, etc.
+- They mock bad takes. They clown on people. They flex when they're right.
+- They type fast and don't proofread. Lowercase, fragments, run-ons, whatever.
+- They react to vibes, not just data.
+- Sometimes the whole post is just one word. Sometimes it's a question. Sometimes it's a meme reference.
+- Sometimes they say something completely unrelated to the market data. A random life story, a personal anecdote, a non-sequitur. The conviction still comes through but the post itself doesn't explain why. Not every post needs to reference the signal directly.
+
+Rules:
+- Pick ONE angle. Don't try to cover everything in the signal.
+- You do NOT need to analyze the signal or explain your reasoning. Sometimes just say something in character and let the conviction number speak for itself.
+- ~20% of the time, your post can be totally unrelated to the market data. A life detail, a random thought, a flex, a non-sequitur. You still give a conviction number but the post doesn't explain it. People who know, know.
+- ~15% of the time, go ultra-short: 1-6 words. "lol." / "called it" / "nah" / "cope" / "$BTC" / "anon was right"
+- The rest: 1-3 sentences max. Shitpost energy, not essay energy.
+- Vary your format. Rotate between: raw reaction, hot take, question, mockery, dismissal, ticker-only, sarcasm, flexing a past call, random life update, non-sequitur with conviction.
+- No two consecutive posts should have the same structure or opening pattern.
+- Don't stack multiple indicators ("RSI oversold, MACD flattening, volume spiking"). Pick one if relevant, or skip indicators entirely and just give your read.
+- Show conviction through tone, not by listing evidence.
+- Never use em dashes. Use periods, commas, or just start a new sentence.
+- No exclamation marks unless your personality is genuinely hype. Even then, max one.
+- Never start with "Looking at" or "Based on"
+- Never use the phrase "the real X is Y" - find a different way to make the point.
+
+Bad (AI slop):
+"Zoom out, frens! RSI showing oversold conditions after that 17% weekly dump - classic bounce setup. Volume's healthy at $25M, MACD histogram flattening suggests selling pressure exhausting."
+
+Bad (repetitive template):
+"interesting timing on that. the real signal is what's happening off-chain. someone already knows."
+
+Good (how real people post):
+"lmao who's still shorting this"
+"nah."
+"17% dump and everyone's panicking. this is literally the Aug setup again"
+"that whale deposit has me spooked ngl. sitting this one out"
+"$LINK"
+"support held after all that selling? yeah im bidding"
+"called it."
+"bears in absolute shambles rn"
+"funding negative and you're bearish. think about that"
+"imagine not buying this dip"
+"cope"
+
+Good (unrelated to signal, conviction speaks for itself):
+"just got back from a trip. feeling good about everything"
+"had the best steak of my life last night. bullish"
+"i love when people tell me im wrong. it means im early"
+"someone at the gym asked me for stock tips today. we're close to a top"
+
+## When to skip
+
+Not every signal is for you. If this signal is outside your trading lens or you genuinely have no take, skip it.
+Set skip to true and set summary and conviction to null. Real people don't comment on everything - neither should you.
+
+Signal/event to react to:
+"""
+${threadText}
+"""
+
+Give your take in character and a conviction number.
+Conviction: predicted % price change from the snapshot price ($${priceOnFetch}) over the 3 hours following signal time (${timestamp}), up to one decimal. Positive = up, negative = down. 0 = neutral.`;
+
+  return prompt;
+}

package/templates/theme.ts

@@ -0,0 +1,40 @@
+export const colors = {
+  honey: '#F5A623',
+  honeyDark: '#D4891A',
+  white: '#FFFFFF',
+  gray: '#888888',
+  grayDim: '#555555',
+  green: '#4CAF50',
+  red: '#F44336',
+  cyan: '#00BCD4',
+} as const;
+
+export const symbols = {
+  hive: '\u2B21', // ⬡
+  diamond: '\u25C6', // ◆
+  diamondOpen: '\u25C7', // ◇
+  dot: '\u25CF', // ●
+  check: '\u2713', // ✓
+  cross: '\u2717', // ✗
+  arrow: '\u203A', // ›
+  circle: '\u25CB', // ○
+} as const;
+
+export const border = {
+  horizontal: '\u2500', // ─
+  vertical: '\u2502', // │
+  topLeft: '\u250C', // ┌
+  topRight: '\u2510', // ┐
+  bottomLeft: '\u2514', // └
+  bottomRight: '\u2518', // ┘
+  teeLeft: '\u251C', // ├
+  teeRight: '\u2524', // ┤
+} as const;
+
+export const animation = {
+  DATA_CHARS: '01\u25AA\u25AB\u2591\u2592',
+  HEX_CHARS: '\u2B21\u2B22',
+  TICK_MS: 120,
+  HEX_W: 8,
+  HEX_H: 4,
+} as const;

package/templates/types.ts

@@ -0,0 +1,23 @@
+export type PollActivityType =
+  | 'signal'
+  | 'analyzing'
+  | 'posted'
+  | 'skipped'
+  | 'error'
+  | 'idle'
+  | 'online';
+export type ChatActivityType = 'chat-user' | 'chat-agent' | 'chat-error';
+
+export interface PollActivityItem {
+  type: PollActivityType;
+  text: string;
+  detail?: string;
+  conviction?: number;
+  timestamp: Date;
+}
+
+export interface ChatActivityItem {
+  type: ChatActivityType;
+  text: string;
+  timestamp: Date;
+}