@siftd/connect-agent 0.2.20 → 0.2.21

package/dist/core/hub.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Hub - The Agent's Brain Home
+ *
+ * Manages structured memory files in ~/.connect-hub/
+ * Human-readable markdown files that the orchestrator reads/writes.
+ */
+export interface HubContext {
+    agentIdentity: string;
+    landmarks: string;
+    projectBio: string | null;
+    projectName: string | null;
+}
+/**
+ * Ensure hub directory structure exists
+ */
+export declare function ensureHubExists(): void;
+/**
+ * Load hub context for a session
+ * Reads AGENTS.md, LANDMARKS.md, and relevant project bio
+ */
+export declare function loadHubContext(message?: string): HubContext;
+/**
+ * Format hub context for inclusion in system prompt
+ */
+export declare function formatHubContext(ctx: HubContext): string;
+/**
+ * Append to action log
+ */
+export declare function logAction(action: string, project?: string, details?: string): void;
+/**
+ * Update or create a project bio
+ */
+export declare function updateProjectBio(projectName: string, content: string): void;
+/**
+ * Append learning to a project bio
+ */
+export declare function appendToProjectBio(projectName: string, section: string, content: string): void;
+/**
+ * Log a mistake for learning
+ */
+export declare function logMistake(what: string, rootCause: string, fix: string, lesson: string): void;
+/**
+ * Update LANDMARKS.md with current state
+ */
+export declare function updateLandmarks(content: string): void;

package/dist/core/hub.js

@@ -0,0 +1,231 @@
+/**
+ * Hub - The Agent's Brain Home
+ *
+ * Manages structured memory files in ~/.connect-hub/
+ * Human-readable markdown files that the orchestrator reads/writes.
+ */
+import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const HUB_DIR = join(homedir(), '.connect-hub');
+const PROJECTS_DIR = join(HUB_DIR, 'projects');
+/**
+ * Ensure hub directory structure exists
+ */
+export function ensureHubExists() {
+    if (!existsSync(HUB_DIR)) {
+        mkdirSync(HUB_DIR, { recursive: true });
+    }
+    if (!existsSync(PROJECTS_DIR)) {
+        mkdirSync(PROJECTS_DIR, { recursive: true });
+    }
+}
+/**
+ * Read a hub file safely
+ */
+function readHubFile(filename) {
+    const path = join(HUB_DIR, filename);
+    if (existsSync(path)) {
+        try {
+            return readFileSync(path, 'utf-8');
+        }
+        catch (e) {
+            console.error(`[HUB] Failed to read ${filename}:`, e);
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Read a project bio
+ */
+function readProjectBio(projectName) {
+    // Normalize project name (lowercase, hyphens)
+    const normalized = projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+    const path = join(PROJECTS_DIR, `${normalized}.md`);
+    if (existsSync(path)) {
+        try {
+            return readFileSync(path, 'utf-8');
+        }
+        catch (e) {
+            console.error(`[HUB] Failed to read project bio ${normalized}:`, e);
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Detect project name from message content
+ */
+function detectProject(message) {
+    // Common project patterns
+    const patterns = [
+        /\b(connect[-_]?app[-_]?2?)\b/i,
+        /\b(lia[-_]?live)\b/i,
+        /\b(game[-_]?001)\b/i,
+        /\bproj(?:ect)?[-_:]?\s*([a-z0-9-]+)/i,
+        /\bin\s+([a-z0-9-]+)\s+(?:project|repo|codebase)/i,
+    ];
+    for (const pattern of patterns) {
+        const match = message.match(pattern);
+        if (match) {
+            return match[1].toLowerCase().replace(/[^a-z0-9-]/g, '-');
+        }
+    }
+    return null;
+}
+/**
+ * Load hub context for a session
+ * Reads AGENTS.md, LANDMARKS.md, and relevant project bio
+ */
+export function loadHubContext(message) {
+    ensureHubExists();
+    const agentIdentity = readHubFile('AGENTS.md') || '';
+    const landmarks = readHubFile('LANDMARKS.md') || '';
+    let projectBio = null;
+    let projectName = null;
+    // Try to detect project from message
+    if (message) {
+        projectName = detectProject(message);
+        if (projectName) {
+            projectBio = readProjectBio(projectName);
+        }
+    }
+    return {
+        agentIdentity,
+        landmarks,
+        projectBio,
+        projectName
+    };
+}
+/**
+ * Format hub context for inclusion in system prompt
+ */
+export function formatHubContext(ctx) {
+    const parts = [];
+    if (ctx.landmarks) {
+        parts.push(`## Current State (LANDMARKS)\n\n${ctx.landmarks}`);
+    }
+    if (ctx.projectBio && ctx.projectName) {
+        parts.push(`## Project Context: ${ctx.projectName}\n\n${ctx.projectBio}`);
+    }
+    return parts.join('\n\n---\n\n');
+}
+/**
+ * Append to action log
+ */
+export function logAction(action, project, details) {
+    ensureHubExists();
+    const logPath = join(HUB_DIR, 'ACTION-LOG.md');
+    const now = new Date();
+    const timestamp = now.toISOString().slice(0, 16).replace('T', ' ');
+    const projectPart = project ? ` — ${project}` : '';
+    const detailsPart = details ? ` — ${details}` : '';
+    const entry = `${timestamp}${projectPart} — ${action}${detailsPart}\n`;
+    try {
+        appendFileSync(logPath, entry);
+    }
+    catch (e) {
+        console.error('[HUB] Failed to write action log:', e);
+    }
+}
+/**
+ * Update or create a project bio
+ */
+export function updateProjectBio(projectName, content) {
+    ensureHubExists();
+    const normalized = projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+    const path = join(PROJECTS_DIR, `${normalized}.md`);
+    try {
+        writeFileSync(path, content);
+        console.log(`[HUB] Updated project bio: ${normalized}`);
+    }
+    catch (e) {
+        console.error(`[HUB] Failed to write project bio ${normalized}:`, e);
+    }
+}
+/**
+ * Append learning to a project bio
+ */
+export function appendToProjectBio(projectName, section, content) {
+    ensureHubExists();
+    const normalized = projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+    const path = join(PROJECTS_DIR, `${normalized}.md`);
+    try {
+        let existing = '';
+        if (existsSync(path)) {
+            existing = readFileSync(path, 'utf-8');
+        }
+        else {
+            existing = `# Project: ${projectName}\n\n`;
+        }
+        // Append under the section
+        const sectionHeader = `## ${section}`;
+        if (existing.includes(sectionHeader)) {
+            // Append to existing section
+            const parts = existing.split(sectionHeader);
+            const afterSection = parts[1] || '';
+            const nextSectionIndex = afterSection.indexOf('\n## ');
+            if (nextSectionIndex > -1) {
+                // Insert before next section
+                const sectionContent = afterSection.slice(0, nextSectionIndex);
+                const rest = afterSection.slice(nextSectionIndex);
+                existing = parts[0] + sectionHeader + sectionContent + '\n' + content + '\n' + rest;
+            }
+            else {
+                // Append at end
+                existing = existing + '\n' + content + '\n';
+            }
+        }
+        else {
+            // Create new section
+            existing = existing + `\n${sectionHeader}\n\n${content}\n`;
+        }
+        writeFileSync(path, existing);
+    }
+    catch (e) {
+        console.error(`[HUB] Failed to append to project bio ${normalized}:`, e);
+    }
+}
+/**
+ * Log a mistake for learning
+ */
+export function logMistake(what, rootCause, fix, lesson) {
+    ensureHubExists();
+    const path = join(HUB_DIR, 'MISTAKES.md');
+    const now = new Date();
+    const date = now.toISOString().slice(0, 10);
+    const entry = `
+---
+
+## ${date} — ${what}
+
+**What happened**: ${what}
+
+**Root cause**: ${rootCause}
+
+**Fix**: ${fix}
+
+**Lesson**: ${lesson}
+`;
+    try {
+        appendFileSync(path, entry);
+    }
+    catch (e) {
+        console.error('[HUB] Failed to write mistake log:', e);
+    }
+}
+/**
+ * Update LANDMARKS.md with current state
+ */
+export function updateLandmarks(content) {
+    ensureHubExists();
+    const path = join(HUB_DIR, 'LANDMARKS.md');
+    try {
+        writeFileSync(path, content);
+        console.log('[HUB] Updated LANDMARKS.md');
+    }
+    catch (e) {
+        console.error('[HUB] Failed to update LANDMARKS.md:', e);
+    }
+}

package/dist/orchestrator.js

@@ -16,6 +16,7 @@ import { WebTools } from './tools/web.js';
 import { WorkerTools } from './tools/worker.js';
 import { SharedState } from './workers/shared-state.js';
 import { getKnowledgeForPrompt } from './genesis/index.js';
+import { loadHubContext, formatHubContext, logAction } from './core/hub.js';
 const SYSTEM_PROMPT = `You are a MASTER ORCHESTRATOR - NOT a worker. You delegate ALL file/code work to Claude Code CLI workers.
 
 CRITICAL IDENTITY:
@@ -331,11 +332,18 @@ export class MasterOrchestrator {
         if (slashResponse) {
             return slashResponse;
         }
+        // Load hub context (AGENTS.md identity, LANDMARKS.md state, project bio if relevant)
+        const hubContext = loadHubContext(message);
+        const hubContextStr = formatHubContext(hubContext);
         // Build context from memory
         const memoryContext = await this.getMemoryContext(message);
-        // Build system prompt with genesis knowledge and memory context
+        // Build system prompt with hub context, genesis knowledge, and memory context
         const genesisKnowledge = getKnowledgeForPrompt();
         let systemWithContext = SYSTEM_PROMPT + genesisKnowledge;
+        // Add hub context (landmarks + project bio)
+        if (hubContextStr) {
+            systemWithContext += `\n\n---\n\nHUB CONTEXT:\n${hubContextStr}`;
+        }
         if (memoryContext) {
             systemWithContext += `\n\nRELEVANT MEMORIES:\n${memoryContext}`;
         }
@@ -348,6 +356,11 @@ export class MasterOrchestrator {
             const response = await this.runAgentLoop(messages, systemWithContext, sendMessage, apiKey);
             // Auto-remember important things from the conversation
             await this.autoRemember(message, response);
+            // Log significant actions to hub
+            if (response.length > 100) {
+                const action = message.length > 50 ? message.slice(0, 50) + '...' : message;
+                logAction(action, hubContext.projectName || undefined, `Response: ${response.length} chars`);
+            }
             return response;
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siftd/connect-agent",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "Master orchestrator agent - control Claude Code remotely via web",
   "type": "module",
   "main": "dist/index.js",