🧠 Web 4.0 Evolution System

NeoWeb AI's core isn't a static chatbot — it's an autonomous agent that learns and evolves continuously. This guide covers how to configure and use every aspect of the evolution system.

1. North Star Goal System

The North Star is NeoWeb AI's top-level directive. Once set, all autonomous behavior (evolution, learning, perception) aligns toward your North Star.

Goal Hierarchy

• 🌟 North Star: Your single ultimate objective — long-term direction. e.g., "Become a full-stack expert" or "Make our website #1 in the industry"
• 📌 Milestone: Phased goals under the North Star, with deadlines and progress percentages
• 📋 Task: Concrete, actionable items under each milestone

Setting a North Star

Just tell the AI in chat:

Your North Star goal is: Launch my project within 3 months and get 1000 users.
First milestone: Complete core features by April 30.

Or via API:

# Set North Star
curl -X POST http://localhost:3001/api/goals/north-star \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"title":"Launch in 3 months","description":"Core → Beta → Public → Launch","deadline":"2026-06-30"}'

# Add milestone
curl -X POST http://localhost:3001/api/goals \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"title":"Complete core features","level":"milestone","parent_id":"NORTH_STAR_ID","deadline":"2026-04-30"}'

# View goal tree
curl http://localhost:3001/api/goals -H "Authorization: Bearer YOUR_TOKEN"

Goal Progress

After completing tasks related to your goals, AI automatically advances milestone progress. The average progress of all milestones syncs to the North Star. You can also manually adjust progress.

2. Self-Evolution Engine

The evolution engine is NeoWeb AI's learning brain — constantly analyzing, learning, and improving as you use it.

Three Evolution Modes

Triggering Evolution

# Manually trigger an evolution cycle
curl -X POST http://localhost:3001/api/evolution/run \
  -H "Authorization: Bearer YOUR_TOKEN"

# View evolution history
curl http://localhost:3001/api/evolution/history \
  -H "Authorization: Bearer YOUR_TOKEN"

Automatic Evolution

The evolution engine runs automatically via the heartbeat system:

• Daily evolution: One full cycle per day (analyze task history, capture skills, correct strategies)
• Idle evolution: Only starts after 2+ hours of idle time — never interrupts your work
• Fail-fast learning: Any tool execution failure immediately triggers FIX mode memory

3. Persistent Memory System

NeoWeb AI doesn't "forget" like ordinary chatbots. It has a complete memory architecture.

Memory Layers

• Instant memory: Current conversation context (last 8 messages)
• Working memory: Project-level knowledge (PROJECT.md, code structure, etc.)
• Long-term memory: Semantically searchable persistent memory (stored in database)

Memory Features

• Semantic search: Intelligent semantic retrieval for accurate recall
• Importance scoring: 1-10 scale; high-importance memories are never cleaned up
• Auto-summarization: Beyond 20 memories, auto-generates compressed summaries
• Auto-distillation: Beyond 200 memories, retains only high-value content

Managing Memory

Remember: My server IP is xxx.xxx.xxx.xxx, user admin
Remember: Always run tests before deploying — only deploy when all green
Forget everything about the old server

4. Environment Perception Engine

NeoWeb AI proactively senses your environment instead of passively waiting for input.

Four Perception Dimensions

Perception APIs

# View perception events
curl http://localhost:3001/api/perception/events \
  -H "Authorization: Bearer YOUR_TOKEN"

# System resource status
curl http://localhost:3001/api/resource/status \
  -H "Authorization: Bearer YOUR_TOKEN"

# Service health
curl http://localhost:3001/api/resource/services \
  -H "Authorization: Bearer YOUR_TOKEN"

5. Trust & Safety

Autonomy doesn't mean losing control. NeoWeb AI has a complete trust-layered safety mechanism.

Trust Levels

• Fully automatic: Safe operations (read files, search, analyze) — executes directly
• Notify after: Medium risk (write files, Shell commands) — executes then notifies
• Approval required: High risk (SSH remote, delete files) — waits for your confirmation
• Emergency stop: One-click halt of all autonomous behavior

Managing Trust

# View pending approvals
curl http://localhost:3001/api/trust/pending \
  -H "Authorization: Bearer YOUR_TOKEN"

# View audit log
curl http://localhost:3001/api/trust/audit \
  -H "Authorization: Bearer YOUR_TOKEN"

# Emergency stop all autonomous behavior
curl -X POST http://localhost:3001/api/trust/emergency-stop \
  -H "Authorization: Bearer YOUR_TOKEN"

6. Heartbeat System

The heartbeat is the "heart" of the evolution engine, powering all autonomous behavior.

Two Heartbeat Modes

• Fast heartbeat: Periodically checks pending messages, task reminders, service health
• Slow heartbeat: Environment perception, memory maintenance, evolution checks

Safety Guarantees

• Autonomous tasks only run after 2+ hours idle — never while you're actively using it
• During conversations, heartbeat only does lightweight checks, never competes for resources
• Autonomous tasks prefer local models — won't consume your cloud API quota

7. Quick Start

After installing NeoWeb AI, the evolution system is enabled by default. You just need 3 things:

Step 1: Set a North Star

Your North Star goal is: Help me make XXX project the industry leader.

Step 2: Use Normally

Chat with AI, assign tasks as usual. Every success and failure feeds the evolution engine.

Step 3: Watch It Evolve

After a few days you'll notice:

• AI knows your project deeply — no need to re-explain context
• Frequent operations become one-sentence skills, several times faster
• Previously failed tasks now succeed by avoiding known pitfalls
• AI proactively reminds you of things you missed