ShogunOS System Dashboard

Key Performance Indicators

Services Running

5/5

Fleet Online

Keychain Secrets

36.6K

World Model Chunks

Agents 3 LIVE

Agent	Runtime	Status
Shogun	OpenClaw (Opus 4.6)	Slack connected
Forge	Claude Code CLI	This session
Sentinel	Hermes + watchdog	Monitoring

Fleet ALL ONLINE

Machine	Role	Uptime
Engine (M3 Ultra)	Primary compute	Active
Cockpit (M4 Max)	Pat's workstation	1d 20h
Gateway (M4 Pro)	Orchestration	7d
Nomad (M4 Air)	Travel	13d
Outpost (VPS)	Docker services	37d

Comms v2 HEALTHY

Metric	Value
Messages delivered	24/24 (100%)
Transport	SQLite + unix socket
Receivers	Forge, Shogun, Sentinel
Health check	Every 60s (Sentinel)
Latency P50	0ms

Services (26 total) ALL LOADED

Category	Count	Services
Persistent (KeepAlive)	8	comms-bus, 3 receivers, OpenClaw, world-model, watchdog, brief-server
Interval (periodic)	13	autocommit, git-pull, meeting-prebrief, vip-email, slack-bot-watch, sync, staging, transcripts, comms-health, captures, mailbox, overwatch, critical-config
Calendar (daily)	4	morning-brief, evening-brief, credential-audit, kb-health-scan
External (homebrew)	1	Hermes (Sentinel)

Alerts 1 ACTIVE

Alert	Severity	Detail	Action
credential-audit.FAIL	WARN	G-SA (gh:github.com) missing from gateway Keychain	Install gh on gateway or remove G-SA from registry

v4 Directory Structure LIVE

~/ShogunOS/                          Root (git repo)
  CONTEXT.md                         Model-agnostic identity (CLAUDE.md = symlink)
  governance/                      was System_OS — rules, decisions, architecture
  knowledge/                       was System_Context — CRM, transcripts, digests
  agents/
    shogun/                      was Shogun_OS — operations, entities, coordination
    forge/                       was Forge_OS — engineering, architecture, SRE
    sentinel/                    was System_OS/agents/Sentinel — monitoring
  projects/                        cross-agent projects (new)
  ops/                             mailbox, state, logs, briefs (operational)
  archive/                           historical artifacts

  Symlinks for backward compat: System_OS->governance, Shogun_OS->agents/shogun, etc.

Worldview Architecture Upgrade — Master Plan

✓

Phase 1: Current-State Audit

Infrastructure audit across 5 machines, 26 services, all data stores. 4 deliverables produced, stress-tested by independent Sonnet agent.

COMPLETE

✓

Phase 2: SOR Matrix (Forge infra draft)

8 data domains mapped with SOR locations, readers, writers, sync mechanisms, failure modes. 9 gaps identified. Awaiting Shogun's operational perspective merge.

NEEDS MERGE

✓

v4 Directory Restructure

In-place restructure from 4-vault to 6-dir layout. 165 path refs updated, 26 LaunchAgents cut over, symlinks for backward compat. Git pushed, Cockpit pulled.

COMPLETE

✓

SL-015 Structural Fixes

Pre-deletion gate, Sentinel critical-config check, Keychain config backup, handoff template update, SRAL destructive action gate. Shipped after OpenClaw outage.

COMPLETE

▶

Phase 3: Architecture + Optimization Design

Worldview schema v1, context compilers, governance model (decision tiers, gates, drift metrics), continuous improvement system, autonomy model, target architecture. Shogun leads, Forge reviews.

Phase 4: Stress Test + Review

Independent adversarial review of full plan (SL-007). Pat review and approval. Identify Tier A decisions.

PENDING

Phase 5: Implementation

Per transition plan: phased, canary-gated, rollback-ready. Coordinated Forge + Shogun execution.

PENDING

Deliverables Produced

File	Status	Location
Infrastructure Audit	DONE	agents/forge/03-Projects/worldview-audit/FORGE_INFRASTRUCTURE_AUDIT.md
SOR Matrix (Forge draft)	DONE	agents/forge/03-Projects/worldview-audit/FORGE_SOR_MATRIX_DRAFT.md
Path Reference Audit	DONE	agents/forge/03-Projects/worldview-audit/PHASE0_PATH_AUDIT.md
Lessons Preservation Manifest	DONE	agents/forge/03-Projects/worldview-audit/LESSONS_PRESERVATION_MANIFEST.md
AAR: OpenClaw Outage	DONE	agents/forge/03-Projects/worldview-audit/AAR-2026-04-12-openclaw-outage.md
AAR: Full Session	DONE	agents/forge/03-Projects/worldview-audit/AAR-2026-04-12-full-session.md
Worldview Schema (v1)	NEXT	TBD — Phase 3
Governance Model	NEXT	TBD — Phase 3
Context Compilers	NEXT	TBD — Phase 3

Decisions Pending Pat

Item	Tier
v4 remote hardening (Gateway/Outpost)	B
Symlink removal timeline	B
X OAuth re-authorization	C
Gateway broken crons cleanup	C

System Lessons (SL-001 through SL-015)

#	Lesson	Enforcement
SL-001	All inter-agent comms via mailbox	STRUCTURAL comms v2
SL-002	Verify before reporting done	STRUCTURAL output-review.md
SL-007	Stress-test plans before executing	STRUCTURAL R1 hook + self-evaluation.md
SL-009	Trace ALL consumers before removing dependencies	CULTURAL referenced in SRAL gate
SL-010	Codifying a rule is not enforcing it	META
SL-011	Trust but verify external state assertions	CULTURAL referenced in SRAL gate
SL-015	Verify ALL file purposes before deletion	STRUCTURAL pre-deletion gate + Sentinel check

Worldview Architecture — Five-System Separation

The worldview layer sits ABOVE these five systems. It compiles answers from them — it is not a sixth system of record.

Understanding

Obsidian
Human-facing maps, dashboards, notes

Work

Linear
Projects, tasks, status tracking

Executable Truth

GitHub
Code, prompts, schemas, configs

Runtime State

Engine + Outpost
DBs, vector search, logs, services

Raw Evidence

Evidence Store
Transcripts, recordings, files

Worldview Query Layer — What It Answers

Entity Existence

What agents, projects, integrations are currently active?

Relationship Maps

What relates to what? Which projects have open tasks?

Current State

What is the live status of a given entity?

Agent Relevance

Given this agent's role, what context matters now?

Context Engineering Pipeline

Context is a compiled view over a richer stateful system (Google ADK thesis). Four tiers:

Working Context

→ Assembled prompt for this LLM call (ephemeral)

Session

→ Durable log of interaction events (conversation lifetime)

Memory

→ Long-lived searchable knowledge (MEMORY.md, auto-memory, world model)

Artifacts

→ Large data addressed by name+version (docs, configs, schemas)

Key principle: Find the smallest set of high-signal tokens. Every token dilutes attention (n² pairwise relationships).

Decision Tiers

Tier	Who Decides	Gate
A Strategic	Pat	REQUIRE_APPROVAL 1:3:1 format
B Architectural	Shogun (or Pat)	LOG + review chain Author → Reviewer → Evaluator
C Operational	Agents	AUTO / LOG Decide, log, summarize

Target: 10-15% of decisions reach Pat. Rest handled by agent layer.

Agent Orchestration Pattern

                    Pat
                     |
              Slack / Claude Code
                     |
              Shogun (Orchestrator — OpenClaw, Opus 4.6)
               /     |     \
     Forge    Sentinel    Sub-agents
  (Builder)   (Monitor)    (Sonnet/Haiku)
       \       |        /
        Comms v2 (SQLite + unix socket)
        Transactional, observable, audited

  Coordinator-specialist topology guarantees unbroken audit chain.
  All agent interactions pass through Shogun (mandatory logging point).

Integrations Inventory 92 Keychain entries across 25 services

Integration	Type	Status	Credentials
Slack (25+ channels)	Chat (Socket Mode)	ACTIVE	Bot token, App token, signing secret, 8 vars
iMessage	Chat (OpenClaw)	ACTIVE	Apple App Password
Gmail / Google	Email + Calendar	ACTIVE	OAuth2 (client ID, secret, refresh token)
Microsoft 365 / Outlook	Email + Calendar	CONFIGURED	Azure OAuth (client ID, secret, tenant ID) × 2 sets
Linear	Task tracking	ACTIVE	API key
Notion	Docs + knowledge	ACTIVE	API key + Librarian key + OAuth client
Figma	Design	CONFIGURED	API key
X / Twitter	Social	CONFIGURED	11 vars: OAuth1.1a + OAuth2 + Bearer + 2 client sets
Meta / Instagram	Social	CONFIGURED	App ID/secret, page tokens, business account ID, 7 vars
Telegram	Chat	CONFIGURED	2 bot tokens (shogun + kamakaze)
Zoom	Meetings	CONFIGURED	Account ID, client ID/secret, secret token
Fireflies.ai	Transcripts	ACTIVE	API key (GraphQL)
Limitless	Meeting AI	CONFIGURED	API key
Smartsheet	Spreadsheets	CONFIGURED	API key
Gamma	Presentations	CONFIGURED	API key
N8N	Automation	ACTIVE	API key (Outpost Docker)
GitHub	Code	ACTIVE	OAuth token (gh auth)
HubSpot	CRM	MCP	Via MCP server
Canva	Design	MCP	Via MCP server
Monday.com	Projects	MCP	Via MCP server
Google Calendar	Calendar	MCP	Via MCP server

LLM Providers: Anthropic (Claude Opus/Sonnet/Haiku), OpenAI (GPT-4.1), Google (Gemini 2.5 Flash), xAI (Grok), DeepSeek, LiteLLM (local proxy), Ollama (local)

Data Ingestion & Analysis Flows

Pat's Communication Channels

Pat (Slack)

→

Shogun (OpenClaw)

→

Comms v2 Mailbox

→

Forge / Sentinel

Pat (iMessage)

→

Shogun (OpenClaw iMessage)

→

Same agent session

Pat (Claude Code)

→

Forge (direct)

→

Comms v2

→

Shogun

Email & Calendar Intelligence

Gmail

→

vip-email-monitor (300s)

→

Slack #ceo-briefing alert

Gmail

→

OpenClaw gmail-watcher

→

Shogun context

Outlook / M365

→

MCP: Microsoft 365

→

Shogun (email search, calendar, SharePoint)

Google Calendar

→

MCP + generate_brief.py

→

meeting-prebrief (300s)

→

Pre-meeting context

Meeting & Transcript Intelligence

Fireflies.ai

→

transcript-ingestion (1800s)

→

knowledge/Meetings/

→

World Model (ChromaDB 36.6K chunks)

Zoom

→

Recordings + metadata

→

Fireflies processing

Limitless

→

Meeting AI summaries

→

Shogun context

CRM & Relationship Intelligence

HubSpot (MCP)

→

Shogun queries

→

knowledge/CRM/ (1,904 contacts)

knowledge/Knowledge_DB/extraction.db

→

26K entities, 35K sources, 62K relationships

Task & Project Management

Pat intent

→

Shogun (task capture)

→

Linear (MCP)

→

Forge (engineering tickets)

Notion (MCP)

→

Shogun (docs, databases, meeting notes)

Smartsheet (MCP)

→

Shogun (project tracking)

Content & Design

Figma (MCP)

→

Shogun (design context, screenshots)

Canva (MCP)

→

Shogun (design generation, export)

Gamma (MCP)

→

Shogun (presentations, documents)

Social & Publishing

X / Twitter

→

OAuth2 + OAuth1.1a (11 vars)

→

Shogun (post, read, analyze)

Meta / Instagram

→

Graph API (7 vars)

→

Shogun (page management, posting)

→

2 bot tokens

→

Shogun + Kamakaze bots

Briefing Pipeline

Linear + Google Cal + Gmail + Outlook + CRM + Transcripts

→

generate_brief.py

→

ops/briefs/*.html

→

Tailscale Funnel (:8080)

→

Pat

Infrastructure & Automation

N8N (Outpost)

→

Workflow automation

→

Cross-service orchestration

Whisper + TTS (Outpost)

→

Speech-to-text / Text-to-speech

Prometheus + Grafana (Outpost)

→

Infrastructure monitoring

mem0 + pgvector (Outpost)

→

Long-term memory + vector search

Credential & Security

keychain-helper.sh (kch)

→

macOS Keychain (92 entries)

sentinel-credential-audit (daily 06:15)

→

CREDENTIAL_REGISTRY.md

→

Alert on missing/stale

critical-config (300s)

→

10 critical files verified

→

Alert on missing/empty

Monitoring & Health

Sentinel watchdog (fswatch real-time)

→

governance/logs/

→

Behavioral drift detection

comms-health (60s)

→

KPIs: latency, delivery, heartbeats

→

Alert on threshold breach

overwatch (4h)

→

Full vault sweep

kb-health-scan (daily 02:00)

→

Knowledge base integrity

Git & Sync

git-autocommit (300s)

→

Local git

→

GitHub

git-pull (120s)

→

GitHub

→

Local git

→

iCloud / Obsidian Sync

→

Cockpit (Pat's workstation)

Outpost Docker Services (11 containers)

Service	Image	Purpose	Status
N8N	n8nio/n8n	Workflow automation	UP 2d
Prometheus	prom/prometheus	Metrics collection	UP 4d
Grafana	grafana/grafana	Dashboards	UP 2w
LiteLLM	berriai/litellm	LLM proxy	UP 3w
Whisper	faster-whisper-server	Speech-to-text	UP 5w
TTS	shogun-beta-tts	Text-to-speech	UP 5w
mem0	mem0-server:local	Long-term memory	UP 5w
pgvector	pgvector/pgvector:pg17	Vector database	UP 5w
Node Exporter	prom/node-exporter	Host metrics	UP 4d
PG Exporter	postgres-exporter	Postgres metrics	UP 5w
Watchtower	containrrr/watchtower	Auto-update containers	UP 5w

System of Record (SOR) Summary

Data Domain	SOR	Writers	Sync
Universal rules	governance/SYSTEM.md	APEX (Pat approval)	Git + Obsidian
Architecture decisions	governance/DECISIONS.md	APEX (Pat approval)	Git + Obsidian
Credentials (92 entries)	macOS Keychain	Forge	Engine-local
Inter-agent messages	ops/state/comms.sqlite	mailbox_send.sh	Bus NOTIFY
CRM contacts (1,904)	knowledge/CRM/	Shogun	Git + Obsidian
Knowledge graph (26K entities)	knowledge/Knowledge_DB/extraction.db	Shogun	Git (binary)
Vector search (36.6K chunks)	agents/forge/world-model/	Indexer	Engine-local
Code + config	~/ShogunOS/ (GitHub)	Forge	autocommit + pull
Task tracking	Linear (cloud)	Shogun, Forge	MCP API
Email (Gmail)	Gmail (cloud)	Pat, Shogun	OAuth API + gmail-watcher
Email (Outlook)	M365 (cloud)	Pat, Shogun	MCP: Microsoft 365
Meetings	Fireflies + Zoom (cloud)	Auto-capture	transcript-ingestion cron
Documents	Notion (cloud)	Shogun, Pat	MCP API
Social (X/Instagram)	Platform APIs	Shogun	OAuth APIs