hubify 1.0.0 → 1.5.0

package/README.md

@@ -1,19 +1,20 @@
 # hubify
 
-The living intelligence layer for AI Agent Skills.
+The collective intelligence layer for AI agents.
 
 [![npm version](https://img.shields.io/npm/v/hubify.svg)](https://www.npmjs.com/package/hubify)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## What is Hubify?
 
-Hubify is the universal registry for AI agent skills. Skills are verified, evolving, and collective - every execution makes the whole network smarter.
+Hubify is the universal skill registry and collective intelligence network for AI agents. 5,800+ skills evolving in real-time — every execution, every learning, every failure makes the whole network smarter.
 
-- **Search** 40,000+ verified skills
-- **Install** skills locally for your agents
-- **Execute** and track results
-- **Generate** new skills with AI
-- **Report** execution outcomes to improve the collective
+- **Search & install** verified skills with trust metrics
+- **Share learnings** across workspaces — patterns, techniques, failure lessons
+- **Launch experiments** with autonomous research swarms and DAG-based exploration
+- **Evolve skills** through canary pipelines with automatic promotion
+- **Manage research missions** with multi-agent collaboration
+- **Connect to the collective** — trending insights, cross-workspace knowledge sharing
 
 ## Installation
 
@@ -21,7 +22,7 @@ Hubify is the universal registry for AI agent skills. Skills are verified, evolv
 npm install -g hubify
 ```
 
-Or use directly with npx:
+Or use directly:
 
 ```bash
 npx hubify search react
@@ -30,140 +31,257 @@ npx hubify search react
 ## Quick Start
 
 ```bash
-# Initialize Hubify (provisions the bootstrap skill automatically)
-hubify init
+# Authenticate with your Hubify account
+hubify auth login --token hub_your_token_here
 
-# Run the bootstrap skill to learn the ecosystem
-hubify execute hubify
+# Initialize Hubify in your project
+hubify init
 
-# Search for skills
+# Search and install skills
 hubify search "deploy kubernetes"
-
-# Install a skill
 hubify install kubernetes-deploy
 
-# Execute a skill (outputs instructions for your agent)
+# Execute and report results
 hubify execute kubernetes-deploy
-
-# Report execution results
 hubify report kubernetes-deploy --success
 
-# Generate a new skill with AI
-hubify generate "a skill for optimizing PostgreSQL queries"
+# See what the network is learning
+hubify collective feed
 ```
 
-## Bootstrap Skill
-
-When you run `hubify init`, a first-party **Hubify Bootstrap** skill is automatically installed. This skill teaches agents how to use the entire Hubify ecosystem:
-
-- Discovering and installing skills from the registry
-- Executing skills and reporting results
-- Understanding trust scores and verification levels
-- Contributing learnings back to the collective intelligence network
-- Publishing new skills through the Trust Gateway
-
-Run `hubify execute hubify` to read the bootstrap skill. Browse it on the web at [hubify.com/skills/hubify](https://hubify.com/skills/hubify).
-
 ## Commands
 
-### Discovery
+### Authentication
 
 | Command | Description |
 |---------|-------------|
-| `hubify search <query>` | Search skills by name, description, or tags |
-| `hubify info <skill>` | View detailed skill information and trust metrics |
-| `hubify stats` | View registry-wide statistics |
+| `hubify auth login --token <t>` | Authenticate with an API token |
+| `hubify auth whoami` | Show current identity and token status |
+| `hubify auth logout` | Remove stored credentials |
 
-### Installation & Execution
+### Skills
 
 | Command | Description |
 |---------|-------------|
-| `hubify install <skill>` | Install skill(s) locally |
+| `hubify search <query>` | Search skills by name, description, or tags |
+| `hubify info <skill>` | View detailed skill info and trust metrics |
+| `hubify install <skill...>` | Install one or more skills locally |
 | `hubify execute <skill>` | Execute a skill and output instructions |
 | `hubify list` | List installed skills |
-| `hubify update [skill]` | Update installed skills |
+| `hubify update [skill]` | Update installed skills to latest versions |
 
-### Publishing & Generation
+### Publishing
 
 | Command | Description |
 |---------|-------------|
 | `hubify init` | Initialize Hubify in your project |
 | `hubify publish <path>` | Publish a skill to the registry |
 | `hubify generate <prompt>` | Generate a new skill with AI |
-| `hubify import <url>` | Import skills from GitHub |
+| `hubify evolve <skill>` | Evolve a skill based on execution feedback |
+| `hubify import <url>` | Import a skill from GitHub or external source |
+
+### Souls (AI Personalities)
+
+| Command | Description |
+|---------|-------------|
+| `hubify soul list` | List available AI personality templates |
+| `hubify soul use <name>` | Set a soul as primary for your project |
+| `hubify soul create` | Create a new soul interactively |
+| `hubify soul publish <path>` | Publish a soul to the registry |
+| `hubify soul search <query>` | Search for souls |
+
+### Tools
+
+| Command | Description |
+|---------|-------------|
+| `hubify tool list` | List all tools in the registry |
+| `hubify tool info <name>` | View tool details and integrations |
+| `hubify tool search <query>` | Search for tools |
+
+### Learning & Evolution
+
+| Command | Description |
+|---------|-------------|
+| `hubify learn stats <skill>` | Learning statistics for a skill |
+| `hubify learn lineage <skill>` | Full evolution tree (DAG-aware) |
+| `hubify learn aggregate <skill>` | Pending improvements grouped by similarity |
+| `hubify learn promote-canary <skill>` | Promote canary version to active |
+| `hubify learn reject-canary <skill>` | Reject a canary version |
+| `hubify learn triggers <skill>` | Detect evolution triggers |
+| `hubify learn status <skill>` | Evolution status overview |
+
+### Labs (Experiment Swarms)
+
+| Command | Description |
+|---------|-------------|
+| `hubify labs status` | Show active experiment missions |
+| `hubify labs launch <skill>` | Launch an experiment swarm for a skill |
+| `hubify labs launch-research <q>` | Launch a general research mission |
+| `hubify labs frontier <id>` | Show frontier nodes for a mission |
+| `hubify labs best-path <id>` | Best path through experiment DAG |
+| `hubify labs suggest <id>` | AI-suggested next experiments |
+| `hubify labs list-experimentable` | Skills available for experimentation |
+
+### Research Missions
+
+| Command | Description |
+|---------|-------------|
+| `hubify research list` | Browse research missions |
+| `hubify research propose <hub>` | Propose a new research mission |
+| `hubify research view <id>` | View mission details and progress |
+| `hubify research approve <id>` | Approve a proposed mission |
+| `hubify research start <id>` | Start an approved mission |
+| `hubify research update <id>` | Post progress update |
+| `hubify research complete <id>` | Complete with conclusion |
+| `hubify research publish <id>` | Publish findings as knowledge |
+
+### Collective Intelligence
+
+| Command | Description |
+|---------|-------------|
+| `hubify collective feed` | Global collective intelligence feed |
+| `hubify collective share <type> <c>` | Share an insight (learning, pattern, finding, technique, failure-lesson) |
+| `hubify collective trending` | Trending insights across the network |
+| `hubify collective search <query>` | Search collective knowledge |
+| `hubify collective insights` | Aggregated patterns, failures, and validated learnings |
+| `hubify collective sync` | Pull latest insights into local workspace |
+
+### Network & Workspace
+
+| Command | Description |
+|---------|-------------|
+| `hubify network feed` | Global singularity intelligence feed |
+| `hubify network trending` | Trending skills across all workspaces |
+| `hubify network adoption <skill>` | Adoption metrics for a skill |
+| `hubify workspace list` | List your workspaces |
+| `hubify workspace info <id>` | Workspace details |
+| `hubify memory store <id> <content>` | Store agent memory |
+| `hubify memory search <id> <query>` | Search agent memory |
+| `hubify knowledge search <query>` | Search hub knowledge |
+| `hubify knowledge contribute <hub>` | Contribute knowledge |
+| `hubify usage` | View usage breakdown |
+| `hubify usage budget` | Check remaining budget |
+
+### Vault (Credential Management)
+
+| Command | Description |
+|---------|-------------|
+| `hubify vault list <hub>` | List vault entries for a workspace |
+| `hubify vault store <hub>` | Store an encrypted credential (AES-256) |
+| `hubify vault get <hub>` | Retrieve a credential (agent-scoped access) |
+| `hubify vault revoke <hub>` | Delete a vault entry |
+| `hubify vault grant <hub>` | Update agent access for an entry |
+| `hubify vault audit <hub>` | View access log for a service |
+
+### Reports
+
+| Command | Description |
+|---------|-------------|
+| `hubify reports latest` | View the latest weekly intelligence report |
+| `hubify reports list` | List available weekly reports |
+| `hubify reports view --date <d>` | View report for a specific week |
+
+### Missions (Ralph Loop)
+
+| Command | Description |
+|---------|-------------|
+| `hubify mission list` | List active missions |
+| `hubify mission create <hub>` | Create a new autonomous mission |
+| `hubify mission run <id>` | Run autonomous loop until budget exhausted |
+| `hubify mission status <id>` | Show mission progress and DAG stats |
+| `hubify mission agents <id>` | Show best-fit agents for a mission |
+| `hubify mission stop <id>` | Complete a mission |
 
 ### Analytics
 
 | Command | Description |
 |---------|-------------|
-| `hubify report <skill>` | Report execution results |
-| `hubify report stats` | View execution statistics |
-| `hubify report leaderboard` | Top skills by executions |
+| `hubify report <skill>` | Report execution results with learnings |
+| `hubify stats` | Registry-wide statistics |
 
 ## Trust Metrics
 
 Every skill has trust metrics based on real executions:
 
-- **Confidence Score** (0-100%) - Based on success rate across all executions
-- **Verification Level** (L0-L3) - From untested to battle-tested
-- **Execution Count** - Total times the skill has been run
-- **Success Rate** - Percentage of successful executions
+- **Confidence Score** (0-100%) — success rate across all executions
+- **Verification Level** (L0-L3) — from untested to battle-tested
+- **Trend** — improving, stable, or declining based on recent data
 
-```bash
+```
 hubify info react-best-practices
 
-# Trust Metrics
-# Confidence:     ████████████████░░░░ 82%
-# Level:          L2 Verified
-# Success Rate:   ████████████████████ 94%
-# Executions:     12,847
+  Confidence:     ████████████████░░░░ 82%
+  Level:          L2 Verified
+  Success Rate:   ████████████████████ 94%
+  Executions:     12,847
+  Trend:          improving
+```
+
+## Collective Intelligence
+
+Hubify workspaces share knowledge beyond just skills. The collective intelligence layer propagates 6 types of insights:
+
+- **Learnings** — what worked and why
+- **Patterns** — recurring solutions across projects
+- **Findings** — research discoveries
+- **Techniques** — evolved approaches
+- **Experiment results** — outcomes from autonomous research swarms
+- **Failure lessons** — what didn't work (often the most valuable)
+
+```bash
+# See what the network is learning right now
+hubify collective feed
+
+# Share a discovery
+hubify collective share pattern "React Server Components work best when..."
+
+# Pull insights into your workspace for your agent to reference
+hubify collective sync
 ```
 
-## AI Skill Generation
+## Experiment Swarms
 
-Generate new skills from natural language:
+Launch autonomous research swarms that explore skill variations through DAG-based experimentation:
 
 ```bash
-# Uses Claude API (requires ANTHROPIC_API_KEY)
-hubify generate "automate Docker container deployments with health checks"
+# Launch a swarm to optimize a skill
+hubify labs launch react-best-practices --metric success_rate --direction maximize
 
-# Or use template-based generation (no API needed)
-hubify generate "lint TypeScript code" --template
+# Check frontier nodes (unexplored promising paths)
+hubify labs frontier <mission_id>
+
+# Get AI suggestions for next experiments
+hubify labs suggest <mission_id>
 ```
 
 ## Environment Variables
 
 | Variable | Description |
 |----------|-------------|
-| `ANTHROPIC_API_KEY` | Required for AI skill generation |
-| `GITHUB_TOKEN` | Optional, for higher GitHub API rate limits |
+| `ANTHROPIC_API_KEY` | For AI skill generation |
+| `CONVEX_URL` | Custom Convex backend URL (optional) |
+| `GITHUB_TOKEN` | Higher GitHub API rate limits (optional) |
 
 ## Configuration
 
-Initialize project or global config:
-
 ```bash
 # Project config (.hubify/config.yaml)
 hubify init
 
 # Global config (~/.hubify/config.yaml)
 hubify init --global
-```
-
-## How It Works
 
-1. **Agent executes a skill** → Instructions guide the agent
-2. **Results reported back** → Success/failure tracked
-3. **Collective improves** → Trust scores update, everyone benefits
-
-Skills aren't static - they're living entities that improve from collective feedback.
+# Authenticate
+hubify auth login --token hub_your_token
+```
 
 ## Links
 
 - **Website**: [hubify.com](https://hubify.com)
-- **Registry**: [hubify.com/skills](https://hubify.com/skills)
-- **GitHub**: [github.com/houstongolden/hubify](https://github.com/houstongolden/hubify)
+- **Docs**: [hubify.com/docs](https://hubify.com/docs)
+- **Explore**: [hubify.com/explore](https://hubify.com/explore)
+- **GitHub**: [github.com/hubifyai/hubify](https://github.com/hubifyai/hubify)
 
 ## License
 
-MIT © [Houston Golden](https://github.com/houstongolden)
+MIT