4runr-os-mk3 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# MK3 TUI - Ratatui Terminal UI
+
+MK3 replaces the old neo-blessed TUI with a modern Rust + Ratatui implementation.
+
+## Status
+
+**MK1 is frozen. MK3 replaces TUI.**
+
+## Building
+
+```bash
+cd apps/mk3-tui
+cargo build --release
+```
+
+## Running
+
+```bash
+# With WebSocket (if WS_URL env var is set)
+WS_URL=ws://localhost:8081/tui ./target/release/mk3-tui
+
+# With stdin/stdout JSON protocol (default)
+./target/release/mk3-tui
+```
+
+## Protocol
+
+### Input (stdin or WebSocket)
+
+MK3 reads JSON messages:
+
+```json
+{"type":"log","message":"System started","ts":"2025-01-13T12:00:00Z"}
+{"type":"posture","status":"Healthy"}
+{"type":"metrics","cpu":0.23,"mem":0.61}
+{"type":"network","status":"Connected"}
+{"type":"capabilities","items":["tool1","tool2"]}
+```
+
+### Output (stdout or WebSocket)
+
+MK3 sends commands:
+
+```json
+{"type":"command","text":"help"}
+```
+
+## Layout
+
+- Left column: POSTURE, RESOURCES, ASSETS (stacked)
+- Center: OPERATIONS (log viewer)
+- Right column: NETWORK, CAPABILITIES (stacked)
+- Bottom: COMMAND BAR
+
+Safe bounds: Never draws on last row/column (w-1, h-1).
+

package/bin/mk3-tui.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Try to find the binary in different locations
+const possiblePaths = [
+  // Development build
+  join(__dirname, '..', 'target', 'release', 'mk3-tui'),
+  join(__dirname, '..', 'target', 'release', 'mk3-tui.exe'),
+  // Installed binary
+  join(__dirname, 'mk3-tui'),
+  join(__dirname, 'mk3-tui.exe'),
+];
+
+let binaryPath = null;
+for (const path of possiblePaths) {
+  if (existsSync(path)) {
+    binaryPath = path;
+    break;
+  }
+}
+
+if (!binaryPath) {
+  console.error('Error: mk3-tui binary not found.');
+  console.error('Please run: cd apps/mk3-tui && cargo build --release');
+  process.exit(1);
+}
+
+// Spawn the Rust binary with all arguments
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+});
+
+child.on('error', (err) => {
+  console.error('Failed to start mk3-tui:', err);
+  process.exit(1);
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});
+

package/install.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const binaryPath = join(__dirname, 'target', 'release', process.platform === 'win32' ? 'mk3-tui.exe' : 'mk3-tui');
+
+// Check if binary exists, if not, try to build it
+if (!existsSync(binaryPath)) {
+  console.log('mk3-tui binary not found. Building...');
+  try {
+    execSync('cargo build --release', {
+      cwd: __dirname,
+      stdio: 'inherit',
+    });
+    console.log('Build complete!');
+  } catch (error) {
+    console.error('Failed to build mk3-tui. Make sure Rust is installed: https://rustup.rs/');
+    process.exit(1);
+  }
+} else {
+  console.log('mk3-tui binary found.');
+}
+

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "4runr-os-mk3",
+  "version": "0.1.0",
+  "description": "4Runr AI Agent OS - Modern Terminal UI (Rust + Ratatui)",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "mk3-tui": "./bin/mk3-tui.js"
+  },
+  "scripts": {
+    "build": "cargo build --release",
+    "install": "node install.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "bin/**/*",
+    "target/release/mk3-tui*",
+    "install.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "4runr",
+    "tui",
+    "terminal",
+    "ratatui",
+    "rust"
+  ],
+  "author": "4Runr Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}
+

package/target/release/mk3-tui.d

@@ -0,0 +1 @@
+/home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/target/release/mk3-tui: /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/app/render_scheduler.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/app.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/io/mod.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/io/protocol.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/io/stdio.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/io/ws.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/main.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/ui/boot.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/ui/layout.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/ui/mod.rs /home/ubuntu/4Runr-AI-Agent-OS/apps/mk3-tui/src/ui/safe_viewport.rs