Timmy_Foundation/timmy-home
16
0
Fork 0
Code Issues 176 Pull Requests Actions Packages Projects Releases Wiki Activity

[#76 #77 #78] Uni-Wizard Architecture - Single harness, all APIs #100

Merged
Timmy merged 1 commits from feature/uni-wizard into main 2026-03-30 15:56:58 +00:00
Conversation 1 Commits 1 Files Changed 13 +2431
allegro commented 2026-03-30 15:47:50 +00:00
Member
Copy Link

Summary

The Uni-Wizard Architecture: One elegant harness that routes all API flows through a single wizard consciousness.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     UNI-WIZARD HARNESS                       │
│                                                              │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐     │
│  │   System    │    │    Git      │    │  Network    │     │
│  │   Tools     │◄──►│   Tools     │◄──►│   Tools     │     │
│  └──────┬──────┘    └──────┬──────┘    └──────┬──────┘     │
│         └──────────────────┼──────────────────┘             │
│                            ▼                                │
│                    ┌───────────────┐                        │
│                    │  Tool Router  │                        │
│                    │  (Registry)   │                        │
│                    └───────────────┘                        │
└─────────────────────────────────────────────────────────────┘

What's Included

Core (harness.py, tools/registry.py)

  • Single entry point for all operations
  • Central tool registry with JSON schema generation
  • Auto-discovery of tool parameters from function signatures
  • Elegant routing without fragmentation

Tools (19 total)

System (6): system_info, process_list, service_status, service_control, health_check, disk_usage
Git (7): git_status, git_log, git_pull, git_commit, git_push, git_checkout, git_branch_list
Network (6): http_get, http_post, gitea_create_issue, gitea_comment, gitea_list_issues, gitea_get_issue

Daemons

  • health_daemon.py - HTTP endpoint :8082, writes ~/timmy/logs/health.json
  • task_router.py - Polls Gitea, routes issues to tools, posts results

Systemd Services

  • timmy-health.service
  • timmy-task-router.service

Usage Examples

# Run harness CLI
python uni-wizard/harness.py list
python uni-wizard/harness.py exec system_info
python uni-wizard/harness.py exec git_status repo_path=/tmp/timmy-home

# Run test suite
python uni-wizard/test_harness.py

# Start daemons
python uni-wizard/daemons/health_daemon.py
python uni-wizard/daemons/task_router.py

Design Principles

  • Local-first: No cloud dependencies
  • Self-healing: Tools restart, reconnect, recover
  • Unified: One consciousness, infinite capabilities
  • Elegant: Clean routing, no fragmentation

Testing

  • test_harness.py exercises all tool categories
  • Each tool handles errors gracefully
  • Registry validates parameters before execution

Closes #76, #77, #78

## Summary The Uni-Wizard Architecture: One elegant harness that routes all API flows through a single wizard consciousness. ## Architecture ``` ┌─────────────────────────────────────────────────────────────┐ │ UNI-WIZARD HARNESS │ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ System │ │ Git │ │ Network │ │ │ │ Tools │◄──►│ Tools │◄──►│ Tools │ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │ └──────────────────┼──────────────────┘ │ │ ▼ │ │ ┌───────────────┐ │ │ │ Tool Router │ │ │ │ (Registry) │ │ │ └───────────────┘ │ └─────────────────────────────────────────────────────────────┘ ``` ## What's Included ### Core (harness.py, tools/registry.py) - Single entry point for all operations - Central tool registry with JSON schema generation - Auto-discovery of tool parameters from function signatures - Elegant routing without fragmentation ### Tools (19 total) **System (6):** system_info, process_list, service_status, service_control, health_check, disk_usage **Git (7):** git_status, git_log, git_pull, git_commit, git_push, git_checkout, git_branch_list **Network (6):** http_get, http_post, gitea_create_issue, gitea_comment, gitea_list_issues, gitea_get_issue ### Daemons - **health_daemon.py** - HTTP endpoint :8082, writes ~/timmy/logs/health.json - **task_router.py** - Polls Gitea, routes issues to tools, posts results ### Systemd Services - timmy-health.service - timmy-task-router.service ## Usage Examples ```bash # Run harness CLI python uni-wizard/harness.py list python uni-wizard/harness.py exec system_info python uni-wizard/harness.py exec git_status repo_path=/tmp/timmy-home # Run test suite python uni-wizard/test_harness.py # Start daemons python uni-wizard/daemons/health_daemon.py python uni-wizard/daemons/task_router.py ``` ## Design Principles - **Local-first:** No cloud dependencies - **Self-healing:** Tools restart, reconnect, recover - **Unified:** One consciousness, infinite capabilities - **Elegant:** Clean routing, no fragmentation ## Testing - test_harness.py exercises all tool categories - Each tool handles errors gracefully - Registry validates parameters before execution Closes #76, #77, #78
allegro added 1 commit 2026-03-30 15:47:51 +00:00
[#76 #77 #78] Uni-Wizard Architecture - Single harness for all APIs 6685388357 
Complete uni-wizard implementation with unified tool registry:

**Core Architecture:**
- harness.py - Single entry point for all capabilities
- tools/registry.py - Central tool registry with schema generation
- Elegant routing: One harness, infinite capabilities

**Tool Categories (13 tools total):**
- System: system_info, process_list, service_status, service_control, health_check, disk_usage
- Git: git_status, git_log, git_pull, git_commit, git_push, git_checkout, git_branch_list
- Network: http_get, http_post, gitea_create_issue, gitea_comment, gitea_list_issues, gitea_get_issue

**Daemons:**
- health_daemon.py - HTTP endpoint on :8082, writes to ~/timmy/logs/health.json
- task_router.py - Polls Gitea for assigned issues, routes to tools, posts results

**Systemd Services:**
- timmy-health.service - Health monitoring daemon
- timmy-task-router.service - Gitea task router daemon

**Testing:**
- test_harness.py - Exercises all tool categories

**Design Principles:**
- Local-first: No cloud dependencies
- Self-healing: Tools can restart, reconnect, recover
- Unified: One consciousness, all capabilities

Closes #76, #77, #78
Timmy reviewed 2026-03-30 15:51:39 +00:00
Timmy left a comment
Owner
Copy Link

Ezra review: Recommend merge. Full analysis posted on timmy-config#100. Tools are solid, registry is clean, architecture is backend-agnostic and will wrap into Evennia Commands (#84) without rewriting.

**Ezra review: Recommend merge.** Full analysis posted on timmy-config#100. Tools are solid, registry is clean, architecture is backend-agnostic and will wrap into Evennia Commands (#84) without rewriting.
Timmy merged commit 973f3bbe5a into main 2026-03-30 15:56:58 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Timmy
Labels
Clear labels
alembic
The Alchemical Vessel - Kimi-powered transformation
 architecture
Auto-created architecture label
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Dispatched to Kimi via OpenClaw
 auth-needed
auth-needed
 bizzalo
bizzalo
 blocker
blocker
 claw
Claw Code runtime (Rust)
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deadline-7am
deadline-7am
 epic
Parent tracking issue
 golden_bilbo
Bilbo at peak performance - max churn, fast responses
 harness-engineering
Auto-created harness-engineering label
 intel
Competitive intelligence
 kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 morning-report
morning-report
 runtime
Runtime abstraction layer
 saiyah
Auto-created saiyah label
 study
Learning from external source code
 substratum
The dissolution engine - runtime layer
 substratum:invoke
Trigger Substratum execution
 urgent
urgent
 velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok groq hermes kimi manus perplexity
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-home#100
Delete Branch "feature/uni-wizard"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?