lhumina_code/home
21
0
Fork 0
Code Issues 10 Pull requests Projects Releases Packages Wiki Activity Actions

Complete zinit → hero_proc migration + fix hero_proc_ui dashboard (#65) #65

New issue
Closed
opened 2026-03-20 12:45:20 +00:00 by mik-tf · 2 comments
mik-tf commented 2026-03-20 12:45:20 +00:00
Owner
Copy link

Problem

hero_proc_ui loads but shows empty data — "Actions 0, Services 0, Runs 0, Jobs 0", no memory/CPU/network graphs, no process list. It should show full system stats, all running services (39+), jobs, logs, and an embedded terminal.

Expected (working state)

  • System Stats: Memory usage, CPU %, Network RX/TX with live graphs
  • Processes: OS process count, hero_proc service count
  • Jobs: running/pending/failed/total counts
  • Tabs fully functional: Actions, Services, Runs, Jobs, Secrets, Schedules, Logs, Stats, Admin, Docs, Terminal
  • Terminal tab with embedded file manager

Current (broken)

  • All counters show 0
  • No graphs render
  • hero_proc_ui is not connecting to hero_proc_server socket

Also: Admin toolbar says "Zinit" instead of "Proc"

  • The admin dropup menu in Hero OS shell shows "Zinit" label
  • Needs rename in hero_os_app navigation config + WASM rebuild

Root cause

hero_proc_ui needs to connect to hero_proc_server.sock to get service/process/job data. The socket exists and hero_proc_server is running (39 services visible via hero_proc list), but hero_proc_ui is not finding it.

Fix approach

  1. Debug hero_proc_ui socket connection — find where it configures the hero_proc_server socket path
  2. Fix the connection so all tabs populate with real data
  3. Rename "Zinit" to "Proc" in hero_os_app navigation config
  4. Full WASM rebuild to pick up changes
  5. Verify: system stats, service list, jobs, terminal all work

Repos

  • hero_proc (crates/hero_proc_ui/) — socket connection fix
  • hero_os (crates/hero_os_app/) — toolbar label rename
  • hero_services — WASM rebuild + pack

Signed-off-by: mik-tf

## Problem hero_proc_ui loads but shows empty data — "Actions 0, Services 0, Runs 0, Jobs 0", no memory/CPU/network graphs, no process list. It should show full system stats, all running services (39+), jobs, logs, and an embedded terminal. ### Expected (working state) - System Stats: Memory usage, CPU %, Network RX/TX with live graphs - Processes: OS process count, hero_proc service count - Jobs: running/pending/failed/total counts - Tabs fully functional: Actions, Services, Runs, Jobs, Secrets, Schedules, Logs, Stats, Admin, Docs, Terminal - Terminal tab with embedded file manager ### Current (broken) - All counters show 0 - No graphs render - hero_proc_ui is not connecting to hero_proc_server socket ### Also: Admin toolbar says "Zinit" instead of "Proc" - The admin dropup menu in Hero OS shell shows "Zinit" label - Needs rename in hero_os_app navigation config + WASM rebuild ## Root cause hero_proc_ui needs to connect to hero_proc_server.sock to get service/process/job data. The socket exists and hero_proc_server is running (39 services visible via `hero_proc list`), but hero_proc_ui is not finding it. ## Fix approach 1. Debug hero_proc_ui socket connection — find where it configures the hero_proc_server socket path 2. Fix the connection so all tabs populate with real data 3. Rename "Zinit" to "Proc" in hero_os_app navigation config 4. Full WASM rebuild to pick up changes 5. Verify: system stats, service list, jobs, terminal all work ## Repos - hero_proc (crates/hero_proc_ui/) — socket connection fix - hero_os (crates/hero_os_app/) — toolbar label rename - hero_services — WASM rebuild + pack Signed-off-by: mik-tf
mik-tf changed title from Fix hero_proc_ui dashboard and rename Zinit→Proc in admin toolbar to Complete zinit → hero_proc migration + fix hero_proc_ui dashboard (#65) 2026-03-20 13:07:26 +00:00
mik-tf commented 2026-03-20 13:08:13 +00:00
Author
Owner
Copy link

Complete zinit → hero_proc Migration Plan

geomind_code/zinit is archived. lhumina_code/hero_proc is the full replacement. Every remaining zinit reference across all repos must become hero_proc (or proc for display names). This supersedes #58.

Root Cause of Empty Dashboard

hero_proc_ui is launched without HERO_PROC_UI_BASE_PATH=/hero_proc_ui. The reverse proxy strips the /hero_proc_ui prefix, but JavaScript sends requests to /rpc (the root) instead of /hero_proc_ui/rpc. One env var fix.

Phase 1 — Build Pipeline Repos (fixes #65 visible bugs)

These 3 repos produce the Docker image. Changes verified by make dist + make smoke.

hero_archipelagos (~66 changes)

  • Rename directory archipelagos/embed/zinit/ → archipelagos/embed/proc/
  • Rename crate hero_archipelagos_zinit → hero_archipelagos_proc
  • Rename struct ZinitApp → ProcApp, CSS classes, iframe IDs, URLs
  • Update src/lib.rs: custom element zinit-island → proc-island
  • Update system/service/ and system/services/: descriptions, zinit_service.rs module
  • Update workspace Cargo.toml member path
  • Update archipelagos store island entry (id + name)
  • Update server/src/main.rs iframe ID list

hero_os (~85 changes)

  • Feature flag island-zinit → island-proc (Cargo.toml, all #[cfg] attributes)
  • Dependency hero_archipelagos_zinit → hero_archipelagos_proc
  • Island ID "zinit" → "proc" in types.rs, config.toml, generated_profile.rs, registry.rs
  • Display name "Zinit" → "Proc" in types.rs
  • Import ZinitApp → ProcApp in island_content.rs
  • Fix island_frame.rs: "zinit" → "proc", URL → /hero_proc_ui/
  • Update Makefile help text (~10 lines)
  • Update all docs: lifecycle.md, makefile.md, README.md, AI guide, adding_external_services.md

hero_services (~106 changes)

  • entrypoint.sh: add HERO_PROC_UI_BASE_PATH=/hero_proc_ui, remove zinit_ui symlink
  • cargo-local-patches.toml: update crate name + path
  • services/hero_os.toml: feature island-zinit → island-proc
  • build-services.sh: remove zinit symlink logic
  • All smoke tests: zinit_ui → hero_proc_ui
  • service_data.rs: 10x "Zinit not connected" → "hero_proc not connected"
  • job_build_manager.rs, job_test_manager.rs: comments
  • profiles/tester.toml: section rename
  • CI workflows: remove git clone zinit steps (no longer needed)
  • All docs: service.md, ecosystem.md, architecture.md, deployment.md, books collections
  • preflight.sh: comment update

Phase 2 — Service Repos (compiled by make dist)

These repos are built by build-services.sh. Changes compile-verified.

hero_embedder (~127 changes)

  • Rename zinit_client.rs → proc_client.rs
  • Rename struct ZinitClient → ProcClient
  • Update module export in lib.rs
  • Update all usage sites

hero_osis (~8 changes)

  • Update import hero_embedder::zinit_client::ZinitClient → hero_embedder::proc_client::ProcClient
  • Update variable names in main.rs
  • Delete stale Cargo.lock zinit entries (regenerated on build)
  • Update README, runbook docs

hero_inspector (~37 changes)

  • routes.rs: rename zinit_names variables, update error messages and JSON keys
  • service.html template: rename JS variables, update UI labels, fix ZINIT_UI_BASE URL
  • scanner.rs: update type mapping
  • Makefile: zinit commands → hero_proc commands (~25 lines)
  • Docstrings in main.rs files

hero_books (~86 changes)

  • Docs: server.md Zinit references, README
  • Makefile if applicable

hero_foundry (~84 changes)

  • server_functions.rs: rename register_zinit_functions → register_hero_proc_functions
  • Rhai function names: forgeserver_zinit_enable → forgeserver_hero_proc_enable
  • Docs and comments

hero_redis (~27 changes)

  • Docs and comments only (zinit_sdk dep already removed)

hero_voice (~14 changes)

  • Docs and comments only

hero_aibroker (~29 changes)

  • Docs and comments only

hero_biz (~6 changes)

  • Docs and comments only

hero_indexer / hero_indexer_ui (~13 changes)

  • Docs and comments only

Phase 3 — Non-build Repos

Not compiled by make dist. Changes are mechanical renames.

hero_rpc (~25 changes)

  • Docstrings only across cli.rs, hero_server.rs, server.rs, scaffold.rs
  • Test comments in cli_lifecycle.rs

hero_compute (~163 changes)

  • README, docs (configuration.md, architecture.md, setup.md)
  • Any active code referencing ZINIT_SOCKET → HERO_PROC_SOCKET
  • Makefile targets

hero_lib (~172 changes)

  • Remove dead Rhai zinit function stubs (documented but unimplemented)
  • CI scripts: remove validate_zinit() checks
  • Installer templates: update zinit references
  • AI prompts: update RHAI_ALL_IN_ONE.md zinit section
  • mos/launcher/steps.rs: /sbin/zinit → /sbin/hero_proc_pid1
  • initramfs-init script: same binary path update

hero_skills (~524 changes)

  • Claude skill definitions: update all zinit references in SKILL.md files
  • Examples and documentation

Execution Plan

  1. Create development_mik branch in all affected repos
  2. Phase 1 + 2: make all changes, make dist (full WASM rebuild)
  3. make pack + make smoke to verify
  4. Phase 3: remaining repos (mechanical renames)
  5. Squash merge all repos to development
  6. Delete development_mik branches
  7. Close this issue

~900+ total changes across 18 repos.

Signed-off-by: mik-tf

## Complete zinit → hero_proc Migration Plan `geomind_code/zinit` is archived. `lhumina_code/hero_proc` is the full replacement. Every remaining `zinit` reference across all repos must become `hero_proc` (or `proc` for display names). This supersedes #58. ### Root Cause of Empty Dashboard `hero_proc_ui` is launched without `HERO_PROC_UI_BASE_PATH=/hero_proc_ui`. The reverse proxy strips the `/hero_proc_ui` prefix, but JavaScript sends requests to `/rpc` (the root) instead of `/hero_proc_ui/rpc`. One env var fix. --- ### Phase 1 — Build Pipeline Repos (fixes #65 visible bugs) These 3 repos produce the Docker image. Changes verified by `make dist` + `make smoke`. **hero_archipelagos** (~66 changes) - Rename directory `archipelagos/embed/zinit/` → `archipelagos/embed/proc/` - Rename crate `hero_archipelagos_zinit` → `hero_archipelagos_proc` - Rename struct `ZinitApp` → `ProcApp`, CSS classes, iframe IDs, URLs - Update `src/lib.rs`: custom element `zinit-island` → `proc-island` - Update `system/service/` and `system/services/`: descriptions, `zinit_service.rs` module - Update workspace Cargo.toml member path - Update archipelagos store island entry (id + name) - Update `server/src/main.rs` iframe ID list **hero_os** (~85 changes) - Feature flag `island-zinit` → `island-proc` (Cargo.toml, all `#[cfg]` attributes) - Dependency `hero_archipelagos_zinit` → `hero_archipelagos_proc` - Island ID `"zinit"` → `"proc"` in types.rs, config.toml, generated_profile.rs, registry.rs - Display name `"Zinit"` → `"Proc"` in types.rs - Import `ZinitApp` → `ProcApp` in island_content.rs - Fix island_frame.rs: `"zinit"` → `"proc"`, URL → `/hero_proc_ui/` - Update Makefile help text (~10 lines) - Update all docs: lifecycle.md, makefile.md, README.md, AI guide, adding_external_services.md **hero_services** (~106 changes) - `entrypoint.sh`: add `HERO_PROC_UI_BASE_PATH=/hero_proc_ui`, remove `zinit_ui` symlink - `cargo-local-patches.toml`: update crate name + path - `services/hero_os.toml`: feature `island-zinit` → `island-proc` - `build-services.sh`: remove zinit symlink logic - All smoke tests: `zinit_ui` → `hero_proc_ui` - `service_data.rs`: 10x `"Zinit not connected"` → `"hero_proc not connected"` - `job_build_manager.rs`, `job_test_manager.rs`: comments - `profiles/tester.toml`: section rename - CI workflows: remove `git clone zinit` steps (no longer needed) - All docs: service.md, ecosystem.md, architecture.md, deployment.md, books collections - `preflight.sh`: comment update --- ### Phase 2 — Service Repos (compiled by `make dist`) These repos are built by `build-services.sh`. Changes compile-verified. **hero_embedder** (~127 changes) - Rename `zinit_client.rs` → `proc_client.rs` - Rename struct `ZinitClient` → `ProcClient` - Update module export in `lib.rs` - Update all usage sites **hero_osis** (~8 changes) - Update import `hero_embedder::zinit_client::ZinitClient` → `hero_embedder::proc_client::ProcClient` - Update variable names in main.rs - Delete stale Cargo.lock zinit entries (regenerated on build) - Update README, runbook docs **hero_inspector** (~37 changes) - `routes.rs`: rename `zinit_names` variables, update error messages and JSON keys - `service.html` template: rename JS variables, update UI labels, fix `ZINIT_UI_BASE` URL - `scanner.rs`: update type mapping - Makefile: `zinit` commands → `hero_proc` commands (~25 lines) - Docstrings in main.rs files **hero_books** (~86 changes) - Docs: server.md Zinit references, README - Makefile if applicable **hero_foundry** (~84 changes) - `server_functions.rs`: rename `register_zinit_functions` → `register_hero_proc_functions` - Rhai function names: `forgeserver_zinit_enable` → `forgeserver_hero_proc_enable` - Docs and comments **hero_redis** (~27 changes) - Docs and comments only (zinit_sdk dep already removed) **hero_voice** (~14 changes) - Docs and comments only **hero_aibroker** (~29 changes) - Docs and comments only **hero_biz** (~6 changes) - Docs and comments only **hero_indexer** / **hero_indexer_ui** (~13 changes) - Docs and comments only --- ### Phase 3 — Non-build Repos Not compiled by `make dist`. Changes are mechanical renames. **hero_rpc** (~25 changes) - Docstrings only across cli.rs, hero_server.rs, server.rs, scaffold.rs - Test comments in cli_lifecycle.rs **hero_compute** (~163 changes) - README, docs (configuration.md, architecture.md, setup.md) - Any active code referencing `ZINIT_SOCKET` → `HERO_PROC_SOCKET` - Makefile targets **hero_lib** (~172 changes) - Remove dead Rhai zinit function stubs (documented but unimplemented) - CI scripts: remove `validate_zinit()` checks - Installer templates: update zinit references - AI prompts: update RHAI_ALL_IN_ONE.md zinit section - `mos/launcher/steps.rs`: `/sbin/zinit` → `/sbin/hero_proc_pid1` - initramfs-init script: same binary path update **hero_skills** (~524 changes) - Claude skill definitions: update all zinit references in SKILL.md files - Examples and documentation --- ### Execution Plan 1. Create `development_mik` branch in all affected repos 2. Phase 1 + 2: make all changes, `make dist` (full WASM rebuild) 3. `make pack` + `make smoke` to verify 4. Phase 3: remaining repos (mechanical renames) 5. Squash merge all repos to `development` 6. Delete `development_mik` branches 7. Close this issue ~900+ total changes across 18 repos. Signed-off-by: mik-tf
mik-tf commented 2026-03-20 14:34:20 +00:00
Author
Owner
Copy link

Done

Complete zinit → hero_proc migration landed on development across 16 repos:

hero_archipelagos, hero_os, hero_services, hero_embedder, hero_osis, hero_inspector, hero_books, hero_foundry, hero_redis, hero_voice, hero_aibroker, hero_biz, hero_indexer, hero_indexer_ui, hero_proxy, hero_rpc

What was fixed

  1. hero_proc_ui empty dashboard — HERO_PROC_UI_BASE_PATH=/hero_proc_ui now set in entrypoint.sh. JavaScript sends RPC calls to correct URL.
  2. Toolbar label — Island renamed from "Zinit" to "Proc" (crate hero_archipelagos_zinit → hero_archipelagos_proc, full WASM rebuild).
  3. hero_inspector build failure — hero_proc_sdk::lifecycle module didn't exist. Inlined the start/stop pattern (matching hero_embedder). Follow-up: #66.
  4. hero_os Cargo.toml — Removed duplicate [patch] and missing path entries that blocked compilation.
  5. Zero zinit references — All naming, docs, comments, error strings, test scripts, CI workflows updated.

Build verification

  • make dist: 19/19 services compiled (including full WASM rebuild)
  • make smoke: 51/57 passed (5 failures are pre-existing aibroker/shrimp issues → #67)
  • hero_proc_ui BASE_PATH: ✅
  • RPC returns live data: ✅
  • 22+ services visible: ✅

Remaining (Phase 3 — separate session)

  • hero_compute, hero_lib, hero_skills — not built by make dist, need separate prompt

Follow-up issues

  • #66 — Add hero_proc_sdk::lifecycle shared helpers
  • #67 — Fix hero_aibroker and hero_shrimp startup failures

Signed-off-by: mik-tf

## Done Complete zinit → hero_proc migration landed on `development` across 16 repos: hero_archipelagos, hero_os, hero_services, hero_embedder, hero_osis, hero_inspector, hero_books, hero_foundry, hero_redis, hero_voice, hero_aibroker, hero_biz, hero_indexer, hero_indexer_ui, hero_proxy, hero_rpc ### What was fixed 1. **hero_proc_ui empty dashboard** — `HERO_PROC_UI_BASE_PATH=/hero_proc_ui` now set in entrypoint.sh. JavaScript sends RPC calls to correct URL. 2. **Toolbar label** — Island renamed from "Zinit" to "Proc" (crate `hero_archipelagos_zinit` → `hero_archipelagos_proc`, full WASM rebuild). 3. **hero_inspector build failure** — `hero_proc_sdk::lifecycle` module didn't exist. Inlined the start/stop pattern (matching hero_embedder). Follow-up: #66. 4. **hero_os Cargo.toml** — Removed duplicate `[patch]` and missing path entries that blocked compilation. 5. **Zero zinit references** — All naming, docs, comments, error strings, test scripts, CI workflows updated. ### Build verification - `make dist`: 19/19 services compiled (including full WASM rebuild) - `make smoke`: 51/57 passed (5 failures are pre-existing aibroker/shrimp issues → #67) - hero_proc_ui BASE_PATH: ✅ - RPC returns live data: ✅ - 22+ services visible: ✅ ### Remaining (Phase 3 — separate session) - hero_compute, hero_lib, hero_skills — not built by `make dist`, need separate prompt ### Follow-up issues - #66 — Add `hero_proc_sdk::lifecycle` shared helpers - #67 — Fix hero_aibroker and hero_shrimp startup failures Signed-off-by: mik-tf
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
development
main
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lhumina_code/home#65
No description provided.