Runbooks
Service runbooks — troubleshooting and recovery
BookStack Runbook
Runbook: BookStack Service Type: Wiki / Knowledge Base Container: bookstack (lscr.io/linuxserver/...
Mattermost Runbook
Status: DEPRECATED 2026-05-18 — mm.basicconsulting.no decommissioned per CEO answer #5. Replace w...
Planka Runbook
Runbook: Planka Service Type: Kanban Board / Project Management Container: planka (ghcr.io/planka...
Documenso Runbook
Runbook: Documenso Service Type: Document Signing Platform Container: documenso (documenso/docume...
Mission Control Dashboard Runbook
Runbook: Mission Control Dashboard Service Type: Task Management Web UI Runtime: Node.js (Express...
Email System Runbook
Email System Runbook Overview Centralized email system for ALAI/BasicAS. All outbound email goes ...
Remote pristup na Mac Studio
Remote pristup na Mac Studio Pregled Mac Studio (192.168.68.61) je dostupan na dva načina: Lokal...
Remote Access — VNC Studio via Cloudflare
Remote Access — VNC Studio via Cloudflare Prerequisites cloudflared installed on both Studio and...
Rad bez Claude Code — Emergency Mode
Rad bez Claude Code — Emergency Mode Ovaj dokument opisuje kako koristiti ALAI sistem kada Claud...
Baikal CalDAV Runbook
Service: Baikal CalDAV Label: Docker container baikal + LaunchAgent com.john.calendar-bridge Tier...
Infrastructure
Infrastructure runbooks: daemons, email, backups, monitoring
Email Agent Runbook
Email Agent Runbook Service: Email Agent Daemon Location: ~/system/daemons/email-agent.js Launch...
Runbook: LightRAG ingest LaunchAgent fix (MC #10286)
Overview This runbook documents the investigation and fix applied to three LightRAG-related Launc...
Runbook: LightRAG ingest LaunchAgent fix (MC #10286)
Overview This runbook documents the investigation and fix applied to three LightRAG-related Launc...
Runbook: LightRAG ingest LaunchAgent fix (MC #10286)
Overview This runbook documents the investigation and fix applied to three LightRAG-related Launc...
How We Work — Project Lifecycle
ALAI Canonical Lifecycle Path Author: Petter Graff | Date: 2026-04-15 Status: DRAFT — awaiting An...
ZAKON PLAN Linter
Runbook: ZAKON PLAN Linter Owner: Proveo File: ~/system/tools/zakon-plan-lint.sh Version: 1.0.0 L...
LightRAG Default-On in discover.js
Runbook: LightRAG Default-On in discover.js Owner: AgentForge File: ~/system/tools/discover.js Ve...
mc.js done — Auto-Writeback to HiveMind + LightRAG Outbox
Runbook: MC Done Auto-Writeback to HiveMind Owner: AgentForge File: ~/system/tools/mc.js (done co...
Blueprint Liveness Gate
Blueprint Liveness Gate Owner: CodeCraft Implemented: 2026-04-16 (System Evolution Phase 2, MC #8...
System Regression Suite (weekly)
System Regression Suite Owner: Angie Jones / Proveo Implemented: 2026-04-16 (System Evolution Pha...
System Evolution 2026-04-16 — Main Runbook
ALAI System Evolution — April 2026 Upgrade Date: 2026-04-16 Team Lead: Petter Graff Contributors:...
Hive Activation 2026-04-17 — Main Runbook
Hive Activation — 2026-04-17 Status: Phase 1–5 builders complete; Phase 6 validation in progress....
HiveMind Subscriptions
HiveMind Subscriptions Owner: CodeCraft Implemented: 2026-04-17 (Hive Activation Phase 1) Code: ~...
Library Auto-Push
Library Auto-Push Owner: FlowForge Implemented: 2026-04-17 (Hive Activation Phase 2 T4) Plist: ~/...
Skill Use Counter
Skill Use Counter Owner: CodeCraft Implemented: 2026-04-17 (Hive Activation Phase 3 T7 + T8) Hook...
Meta-Agent Loop
Meta-Agent Loop Owner: AgentForge Implemented: 2026-04-17 (Hive Activation Phase 5 T11) Script: ~...
discover.js Re-Index + LightRAG Fallback
discover.js — Re-Index + LightRAG Fallback Owner: AgentForge Implemented: 2026-04-17 (Hive Activa...
Tender Parking Protocol
Tender Parking Protocol Owner: John (ALAI Holding) Updated: 2026-04-17 Decision: Alem, 2026-04-17...
Email Address Validation (Pre-Send Gate)
Email Address Validation (pre-send gate) Owner: CodeCraft (tooling) Implemented: 2026-04-18 (afte...
LightRAG Backup (Azure-native + local safety net)
LightRAG Backup (Azure-native + local safety net) Domain note (2026-05-17): References to lightr...
Azure LightRAG Migration — Complete Runbook
Azure LightRAG Migration — Complete Runbook Domain note (2026-05-17): This doc was written when ...
Ollama Cloudflare Tunnel — Exposing Local Inference to Cloud
Ollama Cloudflare Tunnel — Exposing Local Inference to Cloud Domain note (2026-05-17): This doc ...
SENTINEL Reliability Sprint — System Overview
SENTINEL Reliability Sprint — System Overview Status: COMPLETE — 2026-04-19 Sprint Leader: Petter...
Incident Response Playbook
Incident Response Playbook Purpose: When an alert fires, what to do immediately. No research, no ...
Alert Routing — Channel Mapping & SLA
Alert Routing — Channel Mapping & SLA Purpose: Who gets what alert, on which channel, with what l...
ALAI Hosting Operations
ALAI Hosting Operations Runbook Owner: FlowForge (Kelsey Hightower) | Updated: 2026-04-20 | MC: #...
LightRAG Health Monitoring Runbook
LightRAG Health Monitoring Runbook Domain note (2026-05-17): References to lightrag.basicconsult...
GCP Auth Runbook — alai-cli-deployer SA (MC #9522)
GCP Auth Runbook (post-MC #9522) Status Active as of 2026-04-26. SA key created, activated, verif...
Azure Auth Runbook — alai-cli-deployer SP (MC #9524)
Azure Auth Runbook (post-MC #9524) Status Active as of 2026-04-26. SP created, authenticated, ver...
AWS Auth Runbook — alai-cli-deployer IAM key (MC #9523)
AWS Auth Runbook (post-MC #9523) Status Active as of 2026-04-27. IAM access key created, activate...
CF IP Access Rules — ALAI LAN Bypass
CF IP Access Rules — ALAI LAN Bypass Zone: alai.no Zone ID: 3dc40d9c37fee79c4281f7e86870c0b5 Last...
CF IP Access Rules — ALAI LAN Bypass
CF IP Access Rules — ALAI LAN Bypass Zone: alai.no Zone ID: 3dc40d9c37fee79c4281f7e86870c0b5 Acco...
archive.alai.no — Paperless-ngx Setup & Operations
archive.alai.no — Paperless-ngx Setup & Operations URL: https://archive.alai.no Backend: Paperles...
ALAI Contacts Inventory
ALAI Contacts Inventory Authoritative source: Paperless-ngx Correspondents na archive.alai.no/api...
MC Quality Trail — validator_agent + agent_output write semantics (Patch #10036)
SummaryPatch bundle MC #10036 (landed 2026-04-29) backfills two missing quality-trail columns in ...
pi-orchestrator: interactive_protection — skip_owners + grace window (Patch #10063)
Summary Symptom: John's H/M tasks added via mc.js add were being auto-paused by pi-orchestrator w...
MLX Router — Local Inference Gateway
MLX Router — Local Inference Gateway MLX Router — Local Inference Gateway ب...
active-thread-lock — 4th Anti-Drift Structural Layer
1. TL;DR active-thread-lock.sh is a PreToolUse hook that fires on every Task, Agent, WebSearch, a...
MC Grandfather Clause — Legacy Task Completion
MC Grandfather Clause — Legacy Task Completion Installed: 2026-05-03 17:30 UTC Implementation: /...
Atomic-write pattern for shared state files (POSIX os.replace)
Atomic-Write Pattern for Shared State Files (POSIX os.replace) 1. Why This Matters In a multi-s...
Spawn Gate Node-Side Parity (MC #10548)
Spawn Gate Node-Side Parity (MC #10548) Context — Why This Exists Problem: Pi-orchestrator spawn...
SQLite DB Backup — Pillar #9 LITE
Genesis: Pillar #9 LITE (CEO approved 2026-05-05, DR-only scope). Spec: ~/system/specs/agentic-os...
Telegram Bot Intent Classifier — comms-responder
Telegram Bot Intent Classifier — comms-responder MC: #99290, #99331 Status: Live Last depl...
SQLite DB Backup — Pillar #9 LITE
SQLite DB Backup — Pillar #9 LITE Purpose: Restore drill procedure for SQLite databases backed up...
TLDR Loop — Insight to Implementation Pipeline
TLDR Loop — Insight to Implementation Pipeline Overview The TLDR actionizer daemon closes the le...
IMAP → Paperless Archive Pipe (archive.alai.no)
IMAP → Paperless Archive Pipe (archive.alai.no) Overview This pipe automates archival of email a...
LightRAG Stabilization Runbook — 2026-05-08
GenesisOn 2026-05-08 at 14:00, Kelsey Hightower reported LightRAG returning 502 errors. By 19:05 ...
Migadu Email Infrastructure — Add Domain & Alias Guide
Migadu Email Infrastructure — Alias & Mailbox Management MC #100300 — 2026-05-10 | Owner: FlowFor...
SnowIT.ba SaaS Funnel MVP
SnowIT.ba SaaS Funnel MVP — Production Runbook 1. Overview What was delivered: Vercel Web An...
Email fetcher: one.com → Migadu migration
Email Fetcher Migration: one.com → Migadu MC Task: #100395 Migration Date: 2026-05-12 14:30-15:0...
Paperless-ngx — CF Access SSO Setup Plan
Implementation Now available as skill /cf-access-sso. Execute via Skill tool with args: subdomain...
OCD-Delta Webhook Runbook — Anti-Hallucination V2
OCD-Delta Webhook Runbook — Anti-Hallucination V2 Component: OCD-Delta (Orchestrator Claim Detect...
Deterministic Session Summary Compiler Runbook
Deterministic Session Summary Compiler Runbook MC: #101065 Status: partial implementation, pendin...
Cross-company Workflow Runner v0
Cross-company workflow runner v0 Last verified: 2026-05-25 What it is ~/system/tools/cross-compan...
Slack Bot Runbook
Service: Slack Bot Label: com.john.slack-botTier: P1 (Critical) What It Does Claude-powered Slac...