@imisbahk/hive 0.1.0

package/.rocket/ARCHITECTURE.md

@@ -0,0 +1,7 @@
+# Architecture
+
+This file is auto-generated by GENIE and summarizes key module dependencies.
+
+## Most Referenced Internal Modules
+
+## Dependency Edges (Sample)

package/.rocket/README.md

@@ -0,0 +1,31 @@
+# GENIE Workspace Overview
+
+Workspace directory: `/Volumes/Misbah/Development/hive/.rocket`
+Indexed 23 files, 278 symbols, and 0 dependency edges.
+Last index run: 36 ms (1 changed, 0 deleted).
+Primary languages: typescript (21), json (2).
+Detected approximately 0 UI component files (.tsx/.jsx).
+Detected 0 API route-like files (path includes /api/).
+Firebase signal: 0 files reference 'firebase'.
+
+## Quick Samples
+- `package.json`
+- `src/agent/agent.ts`
+- `src/agent/index.ts`
+- `src/cli/commands/chat.ts`
+- `src/cli/commands/config.ts`
+- `src/cli/commands/init.ts`
+- `src/cli/helpers/providerPrompts.ts`
+- `src/cli/index.ts`
+- `src/providers/anthropic.ts`
+- `src/providers/api-key.ts`
+- `src/providers/base.ts`
+- `src/providers/google.ts`
+- `src/providers/groq.ts`
+- `src/providers/index.ts`
+- `src/providers/mistral.ts`
+- `src/providers/ollama.ts`
+- `src/providers/openai-compatible.ts`
+- `src/providers/openai.ts`
+- `src/providers/openrouter.ts`
+- `src/providers/together.ts`

package/.rocket/SYMBOLS.md

@@ -0,0 +1,282 @@
+# Symbols
+
+Auto-generated symbol reference (truncated for readability).
+
+- `class` `AnthropicProvider` in `src/providers/anthropic.ts`:21:8
+- `class` `GoogleProvider` in `src/providers/google.ts`:7:8
+- `class` `GroqProvider` in `src/providers/groq.ts`:7:8
+- `class` `HiveAgent` in `src/agent/agent.ts`:36:8
+- `class` `MistralProvider` in `src/providers/mistral.ts`:7:8
+- `class` `OllamaProvider` in `src/providers/ollama.ts`:7:8
+- `class` `OpenAICompatibleProvider` in `src/providers/openai-compatible.ts`:19:8
+- `class` `OpenAIProvider` in `src/providers/openai.ts`:7:8
+- `class` `OpenRouterProvider` in `src/providers/openrouter.ts`:7:8
+- `class` `ProviderConfigurationError` in `src/providers/base.ts`:35:8
+- `class` `ProviderRequestError` in `src/providers/base.ts`:42:8
+- `class` `TogetherProvider` in `src/providers/together.ts`:7:8
+- `function` `apiKeyEnvVar` in `src/cli/commands/config.ts`:247:1
+- `function` `appendMessage` in `src/storage/db.ts`:421:8
+- `function` `assertNever` in `src/cli/commands/config.ts`:280:1
+- `function` `assertNever` in `src/providers/index.ts`:63:1
+- `function` `buildDefaultPersona` in `src/agent/agent.ts`:147:8
+- `function` `closeHiveDatabase` in `src/storage/db.ts`:85:8
+- `function` `configureDatabase` in `src/storage/db.ts`:89:1
+- `function` `createAnthropicProvider` in `src/providers/anthropic.ts`:98:8
+- `function` `createConversation` in `src/storage/db.ts`:362:8
+- `function` `createGoogleProvider` in `src/providers/google.ts`:18:8
+- `function` `createGroqProvider` in `src/providers/groq.ts`:18:8
+- `function` `createMistralProvider` in `src/providers/mistral.ts`:18:8
+- `function` `createOllamaProvider` in `src/providers/ollama.ts`:19:8
+- `function` `createOpenAIProvider` in `src/providers/openai.ts`:18:8
+- `function` `createOpenRouterProvider` in `src/providers/openrouter.ts`:18:8
+- `function` `createProvider` in `src/providers/index.ts`:15:8
+- `function` `createTogetherProvider` in `src/providers/together.ts`:18:8
+- `function` `ensureAgentProfileColumns` in `src/storage/db.ts`:137:1
+- `function` `ensureInteractiveTerminal` in `src/cli/commands/config.ts`:231:1
+- `function` `ensureMigrationTable` in `src/storage/db.ts`:95:1
+- `function` `ensureOk` in `src/providers/base.ts`:223:1
+- `function` `fetchOllamaModels` in `src/cli/helpers/providerPrompts.ts`:140:1
+- `function` `formatError` in `src/cli/commands/chat.ts`:163:1
+- `function` `getConversationById` in `src/storage/db.ts`:385:8
+- `function` `getDefaultModelForProvider` in `src/providers/index.ts`:40:8
+- `function` `getHiveDatabasePath` in `src/storage/db.ts`:70:8
+- `function` `getHiveHomeDir` in `src/storage/db.ts`:66:8
+- `function` `getKeyStatus` in `src/cli/commands/config.ts`:242:1
+- `function` `getLatestConversationForAgent` in `src/storage/db.ts`:402:8
+- `function` `getMetaValue` in `src/storage/db.ts`:156:8
+- `function` `getPrimaryAgent` in `src/storage/db.ts`:184:8
+- `function` `isHiveInitialized` in `src/storage/db.ts`:176:8
+- `function` `listMessages` in `src/storage/db.ts`:456:8
+- `function` `normalizeProviderName` in `src/providers/base.ts`:61:8
+- `function` `nowIso` in `src/storage/db.ts`:152:1
+- `function` `openHiveDatabase` in `src/storage/db.ts`:74:8
+- `function` `parseJson` in `src/providers/anthropic.ts`:140:1
+- `function` `parseJson` in `src/providers/base.ts`:199:1
+- `function` `parseSseData` in `src/providers/base.ts`:185:1
+- `function` `parseTemperature` in `src/cli/commands/chat.ts`:150:1
+- `function` `pickAnthropicDelta` in `src/providers/anthropic.ts`:115:1
+- `function` `pickErrorMessage` in `src/providers/base.ts`:207:1
+- `function` `printCurrentProviderAndModel` in `src/cli/commands/config.ts`:237:1
+- `function` `promptForModel` in `src/cli/helpers/providerPrompts.ts`:68:8
+- `function` `promptForProvider` in `src/cli/helpers/providerPrompts.ts`:49:8
+- `function` `registerChatCommand` in `src/cli/commands/chat.ts`:29:8
+- `function` `registerConfigCommand` in `src/cli/commands/config.ts`:23:8
+- `function` `requiredField` in `src/cli/commands/config.ts`:270:1
+- `function` `requiredField` in `src/cli/helpers/providerPrompts.ts`:184:1
+- `function` `resolveProviderApiKey` in `src/providers/api-key.ts`:7:8
+- `function` `runChatCommand` in `src/cli/commands/chat.ts`:43:8
+- `function` `runConfigKeyCommand` in `src/cli/commands/config.ts`:165:8
+- `function` `runConfigModelCommand` in `src/cli/commands/config.ts`:124:8
+- `function` `runConfigProviderCommand` in `src/cli/commands/config.ts`:57:8
+- `function` `runConfigShowCommand` in `src/cli/commands/config.ts`:209:8
+- `function` `runMigrations` in `src/storage/db.ts`:105:8
+- `function` `setMetaValue` in `src/storage/db.ts`:164:8
+- `function` `streamReply` in `src/cli/commands/chat.ts`:116:1
+- `function` `toAnthropicMessages` in `src/providers/anthropic.ts`:103:1
+- `function` `updatePrimaryAgentConfiguration` in `src/storage/db.ts`:338:1
+- `function` `updatePrimaryAgentModel` in `src/storage/db.ts`:326:8
+- `function` `updatePrimaryAgentProviderAndModel` in `src/storage/db.ts`:314:8
+- `function` `upsertPrimaryAgent` in `src/storage/db.ts`:211:8
+- `interface` `AgentChatOptions` in `src/agent/agent.ts`:16:8
+- `interface` `AgentRecord` in `src/storage/schema.ts`:87:8
+- `interface` `AnthropicMessage` in `src/providers/anthropic.ts`:16:1
+- `interface` `AppendMessageInput` in `src/storage/db.ts`:44:8
+- `interface` `ChatCommandOptions` in `src/cli/commands/chat.ts`:15:1
+- `interface` `ConversationRecord` in `src/storage/schema.ts`:102:8
+- `interface` `CreateConversationInput` in `src/storage/db.ts`:39:8
+- `interface` `MessageRecord` in `src/storage/schema.ts`:110:8
+- `interface` `MetaRecord` in `src/storage/schema.ts`:81:8
+- `interface` `OllamaTagsResponse` in `src/cli/helpers/providerPrompts.ts`:32:1
+- `interface` `OpenAICompatibleProviderConfig` in `src/providers/openai-compatible.ts`:9:8
+- `interface` `OpenAICompatibleStreamInput` in `src/providers/base.ts`:49:8
+- `interface` `PromptForModelOptions` in `src/cli/helpers/providerPrompts.ts`:44:1
+- `interface` `PromptForProviderOptions` in `src/cli/helpers/providerPrompts.ts`:39:1
+- `interface` `Provider` in `src/providers/base.ts`:29:8
+- `interface` `ProviderMessage` in `src/providers/base.ts`:17:8
+- `interface` `RunChatOptions` in `src/cli/commands/chat.ts`:23:1
+- `interface` `SchemaMigration` in `src/storage/schema.ts`:5:8
+- `interface` `StreamChatRequest` in `src/providers/base.ts`:22:8
+- `interface` `UpdatePrimaryAgentProviderModelInput` in `src/storage/db.ts`:50:8
+- `interface` `UpsertAgentInput` in `src/storage/db.ts`:27:8
+- `method` `chat` in `src/agent/agent.ts`:66:3
+- `method` `constructor` in `src/providers/openai-compatible.ts`:29:3
+- `method` `constructor` in `src/agent/agent.ts`:39:3
+- `method` `constructor` in `src/providers/anthropic.ts`:27:3
+- `method` `constructor` in `src/providers/base.ts`:36:3
+- `method` `constructor` in `src/providers/base.ts`:43:3
+- `method` `constructor` in `src/providers/google.ts`:8:3
+- `method` `constructor` in `src/providers/groq.ts`:8:3
+- `method` `constructor` in `src/providers/mistral.ts`:8:3
+- `method` `constructor` in `src/providers/ollama.ts`:8:3
+- `method` `constructor` in `src/providers/openai.ts`:8:3
+- `method` `constructor` in `src/providers/openrouter.ts`:8:3
+- `method` `constructor` in `src/providers/together.ts`:8:3
+- `method` `getProfile` in `src/agent/agent.ts`:55:3
+- `method` `load` in `src/agent/agent.ts`:45:3
+- `method` `resolveConversation` in `src/agent/agent.ts`:123:3
+- `method` `startConversation` in `src/agent/agent.ts`:59:3
+- `method` `streamChat` in `src/providers/openai-compatible.ts`:39:3
+- `method` `streamChat` in `src/providers/anthropic.ts`:32:3
+- `type` `AgentStreamEvent` in `src/agent/agent.ts`:24:8
+- `type` `HiveDatabase` in `src/storage/db.ts`:18:8
+- `type` `HostedProviderName` in `src/cli/helpers/providerPrompts.ts`:6:1
+- `type` `MessageRole` in `src/storage/schema.ts`:3:8
+- `type` `ProviderMessageRole` in `src/providers/base.ts`:15:8
+- `type` `ProviderName` in `src/providers/base.ts`:14:8
+- `variable` `activeConversationId` in `src/cli/commands/chat.ts`:124:3
+- `variable` `agent` in `src/agent/agent.ts`:46:5
+- `variable` `agent` in `src/cli/commands/chat.ts`:55:5
+- `variable` `agent` in `src/cli/commands/config.ts`:64:5
+- `variable` `agent` in `src/cli/commands/config.ts`:131:5
+- `variable` `agent` in `src/cli/commands/config.ts`:172:5
+- `variable` `agent` in `src/cli/commands/config.ts`:213:5
+- `variable` `AGENT_PROFILE_COLUMNS` in `src/storage/db.ts`:58:1
+- `variable` `answer` in `src/cli/commands/config.ts`:86:7
+- `variable` `answer` in `src/cli/commands/config.ts`:184:5
+- `variable` `answer` in `src/cli/helpers/providerPrompts.ts`:52:3
+- `variable` `answer` in `src/cli/helpers/providerPrompts.ts`:83:7
+- `variable` `answer` in `src/cli/helpers/providerPrompts.ts`:106:5
+- `variable` `answer` in `src/cli/helpers/providerPrompts.ts`:124:3
+- `variable` `ANTHROPIC_API_URL` in `src/providers/anthropic.ts`:13:1
+- `variable` `apiKey` in `src/cli/commands/config.ts`:84:5
+- `variable` `apiKey` in `src/cli/commands/config.ts`:243:3
+- `variable` `apiKey` in `src/providers/anthropic.ts`:99:3
+- `variable` `apiKey` in `src/providers/google.ts`:19:3
+- `variable` `apiKey` in `src/providers/groq.ts`:19:3
+- `variable` `apiKey` in `src/providers/mistral.ts`:19:3
+- `variable` `apiKey` in `src/providers/ollama.ts`:20:3
+- `variable` `apiKey` in `src/providers/openai.ts`:19:3
+- `variable` `apiKey` in `src/providers/openrouter.ts`:19:3
+- `variable` `apiKey` in `src/providers/together.ts`:19:3
+- `variable` `appliedRows` in `src/storage/db.ts`:108:3
+- `variable` `appliedVersions` in `src/storage/db.ts`:111:3
+- `variable` `applyMigration` in `src/storage/db.ts`:118:5
+- `variable` `assistantText` in `src/agent/agent.ts`:100:5
+- `variable` `body` in `src/providers/base.ts`:90:3
+- `variable` `bodyText` in `src/providers/anthropic.ts`:64:7
+- `variable` `bodyText` in `src/providers/base.ts`:228:3
+- `variable` `buffer` in `src/providers/base.ts`:154:3
+- `variable` `configCommand` in `src/cli/commands/config.ts`:24:3
+- `variable` `contentBlock` in `src/providers/anthropic.ts`:117:5
+- `variable` `controller` in `src/cli/helpers/providerPrompts.ts`:141:3
+- `variable` `conversation` in `src/agent/agent.ts`:75:5
+- `variable` `conversationId` in `src/cli/commands/chat.ts`:57:5
+- `variable` `CURRENT_SCHEMA_VERSION` in `src/storage/schema.ts`:11:8
+- `variable` `currentModel` in `src/cli/commands/config.ts`:72:5
+- `variable` `currentModel` in `src/cli/commands/config.ts`:139:5
+- `variable` `currentProvider` in `src/cli/commands/config.ts`:71:5
+- `variable` `data` in `src/providers/base.ts`:164:7
+- `variable` `db` in `src/cli/commands/chat.ts`:45:3
+- `variable` `db` in `src/cli/commands/config.ts`:59:3
+- `variable` `db` in `src/cli/commands/config.ts`:126:3
+- `variable` `db` in `src/cli/commands/config.ts`:167:3
+- `variable` `db` in `src/cli/commands/config.ts`:210:3
+- `variable` `db` in `src/storage/db.ts`:77:3
+- `variable` `DEFAULT_ANTHROPIC_MODEL` in `src/providers/anthropic.ts`:14:1
+- `variable` `DEFAULT_GOOGLE_BASE_URL` in `src/providers/google.ts`:4:1
+- `variable` `DEFAULT_GOOGLE_MODEL` in `src/providers/google.ts`:5:1
+- `variable` `DEFAULT_GROQ_BASE_URL` in `src/providers/groq.ts`:4:1
+- `variable` `DEFAULT_GROQ_MODEL` in `src/providers/groq.ts`:5:1
+- `variable` `DEFAULT_MISTRAL_BASE_URL` in `src/providers/mistral.ts`:4:1
+- `variable` `DEFAULT_MISTRAL_MODEL` in `src/providers/mistral.ts`:5:1
+- `variable` `DEFAULT_OLLAMA_BASE_URL` in `src/providers/ollama.ts`:4:1
+- `variable` `DEFAULT_OLLAMA_MODEL` in `src/providers/ollama.ts`:5:1
+- `variable` `DEFAULT_OPENAI_BASE_URL` in `src/providers/openai.ts`:4:1
+- `variable` `DEFAULT_OPENAI_MODEL` in `src/providers/openai.ts`:5:1
+- `variable` `DEFAULT_OPENROUTER_BASE_URL` in `src/providers/openrouter.ts`:4:1
+- `variable` `DEFAULT_OPENROUTER_MODEL` in `src/providers/openrouter.ts`:5:1
+- `variable` `DEFAULT_TOGETHER_BASE_URL` in `src/providers/together.ts`:4:1
+- `variable` `DEFAULT_TOGETHER_MODEL` in `src/providers/together.ts`:5:1
+- `variable` `defaultModel` in `src/cli/helpers/providerPrompts.ts`:119:3
+- `variable` `defaultSelection` in `src/cli/helpers/providerPrompts.ts`:78:7
+- `variable` `delta` in `src/providers/anthropic.ts`:124:5
+- `variable` `delta` in `src/providers/anthropic.ts`:131:5
+- `variable` `delta` in `src/providers/base.ts`:134:5
+- `variable` `details` in `src/providers/base.ts`:229:3
+- `variable` `endpoint` in `src/providers/base.ts`:79:3
+- `variable` `error` in `src/providers/anthropic.ts`:81:9
+- `variable` `errorMessage` in `src/providers/base.ts`:123:5
+- `variable` `eventBoundary` in `src/providers/base.ts`:159:5
+- `variable` `existing` in `src/storage/db.ts`:215:3
+- `variable` `existing` in `src/storage/db.ts`:318:3
+- `variable` `existing` in `src/storage/db.ts`:330:3
+- `variable` `existingColumns` in `src/storage/db.ts`:141:3
+- `variable` `existingConversation` in `src/agent/agent.ts`:134:5
+- `variable` `fallbackMessage` in `src/cli/helpers/providerPrompts.ts`:101:5
+- `variable` `filtered` in `src/providers/anthropic.ts`:104:3
+- `variable` `firstChoice` in `src/providers/base.ts`:133:5
+- `variable` `headers` in `src/providers/base.ts`:81:3
+- `variable` `history` in `src/agent/agent.ts`:83:5
+- `variable` `HIVE_DB_FILENAME` in `src/storage/db.ts`:56:8
+- `variable` `HIVE_DIRECTORY_NAME` in `src/storage/db.ts`:55:8
+- `variable` `id` in `src/storage/db.ts`:264:3
+- `variable` `id` in `src/storage/db.ts`:366:3
+- `variable` `id` in `src/storage/db.ts`:425:3
+- `variable` `initialSchemaSql` in `src/storage/schema.ts`:13:1
+- `variable` `KEYCHAIN_SERVICE` in `src/cli/commands/config.ts`:21:1
+- `variable` `KEYCHAIN_SERVICE` in `src/providers/api-key.ts`:5:1
+- `variable` `keychainValue` in `src/providers/api-key.ts`:11:3
+- `variable` `keyStatus` in `src/cli/commands/config.ts`:220:5
+- `variable` `lines` in `src/providers/base.ts`:186:3
+- `variable` `maybeChoices` in `src/providers/base.ts`:128:5
+- `variable` `maybeError` in `src/providers/base.ts`:208:3
+- `variable` `message` in `src/providers/anthropic.ts`:82:9
+- `variable` `message` in `src/providers/base.ts`:214:5
+- `variable` `MESSAGE_ROLES` in `src/storage/schema.ts`:1:8
+- `variable` `messages` in `src/providers/anthropic.ts`:44:5
+- `variable` `MIGRATIONS` in `src/storage/schema.ts`:62:8
+- `variable` `model` in `src/cli/commands/config.ts`:80:5
+- `variable` `model` in `src/cli/commands/config.ts`:144:5
+- `variable` `MODEL_CHOICES_BY_PROVIDER` in `src/cli/helpers/providerPrompts.ts`:10:1
+- `variable` `modelChoices` in `src/cli/helpers/providerPrompts.ts`:118:3
+- `variable` `normalized` in `src/providers/base.ts`:66:3
+- `variable` `OLLAMA_TAGS_URL` in `src/cli/helpers/providerPrompts.ts`:8:1
+- `variable` `ollamaModels` in `src/cli/helpers/providerPrompts.ts`:75:5
+- `variable` `parsed` in `src/cli/commands/chat.ts`:155:3
+- `variable` `payload` in `src/cli/helpers/providerPrompts.ts`:155:5
+- `variable` `payload` in `src/providers/anthropic.ts`:75:7
+- `variable` `payload` in `src/providers/base.ts`:118:5
+- `variable` `profile` in `src/cli/commands/chat.ts`:48:5
+- `variable` `program` in `src/cli/index.ts`:12:1
+- `variable` `prompt` in `src/cli/commands/chat.ts`:85:9
+- `variable` `promptMessage` in `src/cli/helpers/providerPrompts.ts`:72:3
+- `variable` `provider` in `src/cli/commands/chat.ts`:54:5
+- `variable` `provider` in `src/cli/commands/config.ts`:77:5
+- `variable` `provider` in `src/cli/commands/config.ts`:138:5
+- `variable` `provider` in `src/cli/commands/config.ts`:179:5
+- `variable` `provider` in `src/cli/commands/config.ts`:219:5
+- `variable` `providerRequest` in `src/agent/agent.ts`:84:5
+- `variable` `rawEvent` in `src/providers/base.ts`:161:7
+- `variable` `remaining` in `src/providers/base.ts`:173:3
+- `variable` `resolvedName` in `src/providers/index.ts`:16:3
+- `variable` `resolvedProvider` in `src/agent/agent.ts`:51:5
+- `variable` `response` in `src/cli/helpers/providerPrompts.ts`:147:5
+- `variable` `response` in `src/providers/anthropic.ts`:46:5
+- `variable` `response` in `src/providers/base.ts`:105:3
+- `variable` `rl` in `src/cli/commands/chat.ts`:75:5
+- `variable` `row` in `src/storage/db.ts`:157:3
+- `variable` `row` in `src/storage/db.ts`:177:3
+- `variable` `row` in `src/storage/db.ts`:185:3
+- `variable` `row` in `src/storage/db.ts`:389:3
+- `variable` `row` in `src/storage/db.ts`:406:3
+- `variable` `runOptions` in `src/cli/commands/chat.ts`:58:5
+- `variable` `savedMessage` in `src/agent/agent.ts`:110:5
+- `variable` `spinner` in `src/cli/commands/config.ts`:58:3
+- `variable` `spinner` in `src/cli/commands/config.ts`:125:3
+- `variable` `spinner` in `src/cli/commands/config.ts`:166:3
+- `variable` `start` in `src/providers/base.ts`:180:8
+- `variable` `SUPPORTED_PROVIDER_NAMES` in `src/providers/base.ts`:3:8
+- `variable` `system` in `src/providers/anthropic.ts`:39:5
+- `variable` `tableInfo` in `src/storage/db.ts`:138:3
+- `variable` `temperature` in `src/cli/commands/chat.ts`:44:3
+- `variable` `text` in `src/providers/anthropic.ts`:90:7
+- `variable` `text` in `src/providers/base.ts`:136:5
+- `variable` `timeout` in `src/cli/helpers/providerPrompts.ts`:142:3
+- `variable` `timestamp` in `src/storage/db.ts`:216:3
+- `variable` `timestamp` in `src/storage/db.ts`:344:3
+- `variable` `timestamp` in `src/storage/db.ts`:367:3
+- `variable` `timestamp` in `src/storage/db.ts`:426:3
+- `variable` `trimmed` in `src/agent/agent.ts`:70:5
+- `variable` `updatedAgent` in `src/cli/commands/config.ts`:101:5
+- `variable` `updatedAgent` in `src/cli/commands/config.ts`:150:5
+- `variable` `writeMessage` in `src/storage/db.ts`:428:3

package/.rocket/config.json

@@ -0,0 +1,18 @@
+{
+  "cache": "cache",
+  "db": "index.db",
+  "enableWarmup": true,
+  "ignorePatterns": [
+    "node_modules/**",
+    "*.test.*",
+    "*.spec.*",
+    "*.d.ts",
+    "dist/**",
+    "build/**"
+  ],
+  "indexInterval": 300000,
+  "maxConcurrency": 6,
+  "maxFileSize": 1048576,
+  "version": 1,
+  "workspace": ".rocket"
+}

package/001-local-first-storage.md

@@ -0,0 +1,43 @@
+# ADR 001 — Local-First SQLite Storage
+
+**Status:** Accepted  
+**Date:** 2025
+
+---
+
+## Decision
+
+All agent data — persona, episodic memory, knowledge graph, task history, audit logs — is stored locally in SQLite. Nothing is sent to a remote database. Nothing requires a cloud account.
+
+---
+
+## Why
+
+The Hive's core promise is that your agent is yours. Completely. That promise breaks the moment user data touches an external server we control.
+
+SQLite is:
+- Fast enough for everything we need
+- Zero dependency — ships as a single file
+- Battle-tested at massive scale
+- Already used by Genie (consistency)
+- Trivially encryptable at rest
+
+---
+
+## What We Rejected
+
+**Postgres/MySQL** — requires a running server, adds ops complexity, external dependency. Rejected.
+
+**Cloud databases (Supabase, Firebase, etc.)** — violates local-first principle entirely. Rejected.
+
+**File-based JSON storage** — no query capability, no transactions, breaks under concurrent access. Rejected.
+
+---
+
+## Consequences
+
+- User data never leaves the machine by default
+- Air gap mode works trivially — nothing to disconnect
+- Backup is just copying a file
+- We need to handle SQLite migrations carefully as schema evolves
+- Multi-device sync is a future problem we defer intentionally

package/003-memory-architechture.md

@@ -0,0 +1,71 @@
+# ADR 003 — 3-Layer Memory Architecture
+
+**Status:** Accepted  
+**Date:** 2025
+
+---
+
+## Decision
+
+Agent memory is split into three distinct layers, each with a different lifecycle and purpose:
+
+1. **Core Persona** — compressed personality snapshot
+2. **Episodic Memory** — recent events as semantic embeddings
+3. **Knowledge Graph** — permanent hard facts
+
+---
+
+## Why
+
+A naive approach — appending every conversation to a growing context — fails in two ways: it hits token limits fast, and it treats a 3-year-old interaction the same as a conversation from this morning.
+
+Human memory doesn't work that way. Some things are permanent (your name, your profession). Some things are recent and contextually relevant (what you worked on this week). Some things define who you are at a level that doesn't need raw recall — just influences behavior.
+
+---
+
+## Layer Details
+
+### Core Persona
+- Rebuilt nightly by a compression process
+- Takes all interactions from the day, extracts what matters, rewrites the persona
+- Never grows — stays at a fixed token budget
+- Influences the system prompt on every conversation
+
+### Episodic Memory
+- Recent interactions stored as vector embeddings (sqlite-vec)
+- Semantically searchable — retrieved by relevance, not recency alone
+- Rolling window — old episodes decay and are absorbed into persona
+- Answers "what happened recently that's relevant to this conversation"
+
+### Knowledge Graph
+- Permanent hard facts — name, DOB, profession, relationships, preferences
+- Written explicitly (by user or extracted with high confidence)
+- Never expires, never decays
+- Tiny footprint — just structured facts
+
+---
+
+## Context Window Assembly
+
+On every agent invocation, context is assembled dynamically:
+
+```
+system prompt
+  + core persona (always)
+  + relevant knowledge graph facts (filtered by relevance)
+  + relevant episodic memories (top-k by embedding similarity)
+  + conversation history (recent turns)
+  + current task context
+```
+
+Total context stays within budget. Always. No bloat.
+
+---
+
+## What We Rejected
+
+**Single growing context file** — hits token limits, no prioritization, expensive. Rejected.
+
+**External vector database** — adds dependency, breaks local-first. Rejected (sqlite-vec instead).
+
+**No memory** — stateless agent is just a chatbot. Not what we're building. Rejected.

package/CONTRIBUTING.md

@@ -0,0 +1,149 @@
+# Contributing to The Hive
+
+First — thanks for being here early. This thing is going to be something.
+
+---
+
+## Project Structure
+
+```
+hive/
+├── src/
+│   ├── cli/                  # CLI entry point and command definitions
+│   │   ├── index.ts          # main entry, commander setup
+│   │   └── commands/         # one file per command
+│   │       ├── init.ts       # hive init
+│   │       ├── chat.ts       # hive chat
+│   │       ├── code.ts       # hive code
+│   │       ├── task.ts       # hive task
+│   │       ├── config.ts     # hive config
+|   |       ├── memory.ts     # hive memory
+│   │       ├── agents.ts     # hive agents
+│   │       ├── status.ts     # hive status
+│   │       ├── ui.ts         # hive ui
+│   │       └── nuke.ts       # hive nuke
+│   │
+│   ├── agent/                # agent core
+│   │   ├── agent.ts          # main agent class
+│   │   ├── persona.ts        # persona compression and management
+│   │   ├── memory/           # memory architecture
+│   │   │   ├── core.ts       # core persona layer
+│   │   │   ├── episodic.ts   # episodic memory + embeddings
+│   │   │   └── knowledge.ts  # knowledge graph
+│   │   └── loop.ts           # perceive → plan → act → verify → learn
+│   │
+│   ├── providers/            # AI provider integrations
+│   │   ├── base.ts           # provider interface
+│   │   ├── openai.ts
+│   │   ├── anthropic.ts
+│   │   ├── ollama.ts
+│   │   ├── groq.ts
+│   │   ├── mistral.ts
+│   │   └── ...
+|   |   
+│   ├── storage/              # local storage layer
+│   │   ├── db.ts             # SQLite setup and migrations
+│   │   ├── keychain.ts       # OS keychain integration
+│   │   └── schema.ts         # database schema definitions
+│   │
+│   ├── daemon/               # background daemon
+│   │   ├── daemon.ts         # main daemon process
+│   │   ├── scheduler.ts      # task scheduling
+│   │   └── service.ts        # OS service registration
+│   │
+│   ├── integrations/         # third party integrations
+│   │   ├── base.ts           # integration interface
+│   │   ├── gmail.ts
+│   │   ├── calendar.ts
+│   │   ├── notion.ts
+│   │   ├── slack.ts
+│   │   └── ...
+│   │
+│   ├── mesh/                 # p2p network layer (v0.8)
+│   │   ├── node.ts           # libp2p node
+│   │   ├── identity.ts       # keypair + HIVE-ID
+│   │   ├── dht.ts            # kademlia DHT
+│   │   └── gossip.ts         # gossipsub messaging
+│   │
+│   ├── browser/              # playwright automation
+│   │   └── browser.ts
+│   │
+│   └── utils/                # shared utilities
+│       ├── logger.ts
+│       ├── crypto.ts
+│       └── constants.ts
+│
+├── scripts/                  # build and install scripts
+│   ├── install.sh            # curl install script
+│   └── build.mjs
+│
+├── .hive-schema/             # DB migration files
+├── package.json
+├── tsconfig.json
+├── .gitignore
+└── README.md
+```
+
+---
+
+## Dev Setup
+
+```bash
+git clone https://github.com/imisbahk/hive
+cd hive
+npm install
+npm run dev        # watch mode
+npm run build      # production build
+npm link           # use `hive` command globally
+```
+
+---
+
+## CLI Commands
+
+- `hive init` — initialize local Hive state (`~/.hive`), create the primary agent profile, and store provider config.
+- `hive chat` — start an interactive chat session with your primary agent.
+- `hive config` — update provider/model/API key settings after initialization.
+- `hive status` — print current Hive status (agent, owner, provider/model, API key set/not set, database path + size, prompts file count, initialized date).
+- `hive nuke` — permanently delete `~/.hive` and remove stored `hive` keychain entries after typing `nuke` to confirm.
+
+---
+
+## Principles
+
+**Every command is deliberate.** Nothing is exposed that shouldn't be. Nothing hidden that matters. If a command exists it does exactly one thing and does it precisely.
+
+**The network is invisible.** Users never manage the mesh. They never post to it, never configure it, never see it unless they want to. It just works underneath.
+
+**The agent grows.** Nothing resets. Nothing is thrown away unless the user explicitly asks. Every interaction makes it more accurate.
+
+**Local first. Always.** Nothing leaves the machine without explicit user action. The AI provider is the only external call, and the user chose it.
+
+**Fail loudly, recover silently.** Errors surface clearly. Recovery happens automatically where possible. Nothing should leave the user stuck.
+
+---
+
+## Versioning
+
+We follow semantic versioning. Pre-v1 everything is considered unstable API.
+
+- `v0.x` — core platform building blocks
+- `v1.0` — stable, public, production
+
+---
+
+## Commit Style
+
+```
+feat: add episodic memory compression
+fix: provider connection timeout handling
+chore: update dependencies
+docs: expand mesh architecture section
+refactor: split agent core into separate modules
+```
+
+---
+
+## Questions
+
+Open an issue. Or just ship it and we'll figure it out together.

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Misbah Khursheed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.