Home A - Z
Page Index

An Otter Wiki

Commit 4f44d2

2026-03-20 21:17:02 Claude (MCP): [mcp] Rewrite Home page: reorganize for VPS era, fix stale links, clean up archive references
Home.md ..
@@ 1,7 1,7 @@
---
category: index
tags: [meta]
- last_updated: 2026-03-17
+ last_updated: 2026-03-20
confidence: pretty_good
---
@@ 9,17 9,40 @@
Development tracking and documentation for robot.wtf — a free, volunteer-run MCP wiki service for the ATProto community.
- ## Minsky (IRC-based Multi-Agent Coordination)
+ ## Platform Design
- - [[Minsky/Agent_IRC_Architecture]] — Multi-agent coordination over IRC: transport abstraction, conversational IPC, agent naming, MVP sketch
- - [[Minsky/IRC_MCP_Bridge]] — Implementation plan: FastMCP server wrapping IRC as MCP tools (pydle, transport abstraction, TDD)
+ ### Architecture
+ - [[Design/VPS_Architecture]] — Architecture, auth, data model, deployment (Debian 12, Caddy, SQLite, ATProto OAuth)
+ - [[Design/Platform_Overview]] — Multi-tenancy model, routing, handler types, semantic search
+ - [[Design/Resolver]] — TenantResolver WSGI middleware: request flow, storage/DB swap, auth, access restrictions
+ - [[Design/Per_Wiki_Database]] — Per-wiki SQLite databases: isolation, migration, backup
+ - [[Design/Data_Model]] — Data model: tables, filesystem layout, URL structure
+ - [[Design/Server_Consolidation]] — Consolidating platform services
+
+ ### Auth
+ - [[Design/Auth]] — ATProto OAuth, MCP OAuth 2.1, bearer tokens, ACL model
+ - [[Design/Admin_Panel_Reenablement]] — Re-enabling Otterwiki admin panel under multi-tenancy
+
+ ### Operations
+ - [[Design/Operations]] — Bootstrap template, attachments, git remote, backups, rate limiting
+ - [[Design/Git_HTTP_Access]] — Git HTTP access: auth, security
+ - [[Design/Wiki_Stats_Plugin]] — Disk usage / quota tracking plugin
+ - [[Design/E2E_Testing]] — Playwright E2E testing infrastructure
+ - [[Design/Custom_Domains]] — Custom domain support via Caddy
+
+ ### Frontend
+ - [[Design/Frontend]] — Management SPA: URL scheme, cross-subdomain auth, screens
+ - [[Design/Landing_Page]] — Landing page spec: content, structure, tone
+ - [[Design/Dashboard_Visibility_Toggle]] — Wiki visibility toggle UX
- ## Active Design (robot.wtf — VPS + ATProto)
+ ### Semantic Search
+ - [[Design/Semantic_Search_V2]] — Current design: section-aware chunking, FAISS + MiniLM, lifecycle hooks
+ - [[Tasks/Semantic_Search_Architecture]] — Architecture decisions (implemented)
+ - [[Tasks/Semantic_Search_Multi_Tenant]] — Multi-tenant FAISS via BackendRegistry (implemented)
- ### Platform
- - [[Design/VPS_Architecture]] — Architecture, auth, data model, deployment (Debian 12, Caddy, SQLite, ATProto OAuth)
- - [[Design/Resolver]] — TenantResolver WSGI middleware: request flow, storage/DB swap, auth, access restrictions, known gotchas
- - [[Tasks/VPS_Phases]] — Implementation phases V0–V7: infrastructure, port, ATProto auth, MCP OAuth, frontend, launch
+ ### Future / Deferred
+ - [[Design/E-3_Encryption_Spike]] — Client-side encryption spike: feasibility, tradeoffs
+ - [[Tasks/Disk_Usage_Cap]] — Per-wiki disk usage limits
### Research Wiki (single-tenant system — still current)
- [[Design/Research_Wiki]] — Overview, architecture, deployment
@@ 27,57 50,54 @@
- [[Design/MCP_Server]] — Tools, configuration, return format, error handling
- [[Design/Note_Schema]] — Frontmatter schema, master index, session protocol
- ### Process
- - [[Design/Agent_Workflow]] — Delegation model: orchestrator, managers, Groucho/Chico/Zeppo
- - [[Design/Phase_Gates]] — Exit criteria and validation procedures per phase
+ ## Minsky (Multi-Agent Coordination)
- ### Dev Tracking (VPS)
- - [[Dev/V3_V5_Risk_Research]] — ATProto OAuth client + MCP OAuth AS: library assessment, scope resolution, implementation sketch
+ - [[Minsky/Agent_IRC_Architecture]] — Multi-agent coordination over IRC: transport, conversational IPC, agent naming
+ - [[Minsky/Directed_Message_Routing]] — Supervisor-directed message routing
+ - [[Minsky/IRC_MCP_Bridge]] — FastMCP server wrapping IRC as MCP tools
- ---
+ ## Tasks
- ## Archived Design (wikibot.io — AWS Serverless + Commercial)
+ - [[Tasks/VPS_Phases]] — Implementation phases V0–V7 (V0–V6 complete, V7 partial)
+ - [[Tasks/Emergent]] — Emergent tasks arising during development
+ - [[Tasks/MCP_Wiki_Routing]] — MCP wiki routing bug
- These pages document the original AWS serverless architecture with WorkOS auth and freemium billing. The designs are superseded by [[Design/VPS_Architecture]] but preserved in full — the application logic (ACL model, middleware, MCP tools, semantic search) carries forward, and the commercial design work (pricing, Stripe integration, tier enforcement) can be revived if the project ever needs it.
+ ## Dev Tracking (VPS)
- ### Platform
- - [[Design/Platform_Overview]] — AWS Lambda + EFS + DynamoDB architecture
- - [[Design/Data_Model]] — DynamoDB tables, EFS layout, URL structure
- - [[Design/Auth]] — WorkOS AuthKit, OAuth, ACL model, MCP auth
- - [[Design/Implementation_Phases]] — Phases 0–7, frontend screens, API surface, pricing
- - [[Design/Operations]] — AWS cost model, backups, CI/CD, rate limiting
- - [[Design/Frontend]] — Management SPA: URL scheme, cross-subdomain auth, framework, screens, hosting
+ - [[Dev/VPS_Deployment_Progress]] — Overall VPS deployment progress
+ - [[Dev/V3_V5_Risk_Research]] — ATProto OAuth + MCP OAuth AS: library assessment, risk
+ - [[Dev/V3_ATProto_Auth_Summary]] — V3 ATProto auth implementation
+ - [[Dev/VS-1_ATProto_Spike]] — ATProto OAuth spike results
+ - [[Dev/VS-2_MCP_OAuth_Summary]] — MCP OAuth AS spike results
+ - [[Dev/V1_SQLite_Port_Summary]] — V1 SQLite port from DynamoDB
+ - [[Dev/V1-3_Deployment_Summary]] — V1 deployment summary
+ - [[Dev/V6-1_Landing_Page_Summary]] — V6 landing page implementation
+ - [[Dev/V7_Ops_Hardening]] — V7 ops hardening notes
+ - [[Dev/2026-03-16_Beta_User_TLS_Fix]] — Beta user TLS certificate fix
+ - [[Dev/Proxmox_CPU_Type]] — Proxmox CPU type for numpy/ONNX
+ - [[Dev/Underscore_Filenames]] — Otterwiki fork: underscore filename convention
- ### Optimizations (Lambda-specific)
- - [[Design/CDN_Read_Path]] — Read path decoupling: fragment caching, assembly options, performance
- - [[Design/Lambda_Library_Mode]] — Write path optimization: lazy loading via `sys.modules` injection
+ ## Process
- ### Semantic Search
- - [[Design/Semantic_Search_V2]] — Section-aware chunking, full chunk text in results, section-level reads (current design)
- - [[Design/Async_Embedding_Pipeline]] — DynamoDB Streams + MiniLM embedding pipeline (AWS, archived)
- - [[Design/Semantic_Search]] — Original Chroma plugin design: chunking, index maintenance (archived)
-
- ### Content (still relevant for robot.wtf — tone and structure carry over)
- - [[Design/Landing_Page]] — Landing page spec: content, structure, tone, logo, deliverables
-
- ### Tasks (AWS phases)
- - [[Tasks/Prerequisites]] — Human setup before Phase 0
- - [[Tasks/Phase_0]] — Proof of Concept (EFS + Lambda, WorkOS + MCP)
- - [[Tasks/Phase_1]] — Single-User Serverless Wiki
- - [[Tasks/Phase_2]] — Multi-Tenancy and Auth
- - [[Tasks/Phase_3]] — Frontend
- - [[Tasks/Phase_4]] — Launch Readiness
- - [[Tasks/Launch_Checklist]] — Human actions required before going live
- - [[Tasks/Emergent]] — Tasks arising during development
- - [[Tasks/E-2_CDN_Read_Path]] — CDN read path: Option A (assembly Lambda)
- - [[Tasks/E-2_CDN_Read_Path_ClientSide]] — CDN read path: Option B (client-side assembly)
-
- ### Dev Tracking (AWS implementation)
- - [[Dev/Phase 0 — EFS Benchmarks]] — Track A results: cold start, read/write latency, concurrency
- - [[Dev/Phase_1_Gate_Results]] — Phase 1 acceptance test results (2026-03-13)
- - [[Tasks/P1-9_MCP_OAuth_Routing]] — Fix MCP OAuth discovery routing (completed)
+ - [[Design/Implementation_Workflow]] — Design/implementation pipeline: orchestrator, managers, agents
+ - [[Security/OWASP_2025_Audit]] — OWASP Top 10 security audit
- ---
+ ## Archive
+
+ ### AWS Design (wikibot.io — Lambda/EFS/DynamoDB)
+ Preserved at [[Archive/AWS_Design/]] — 9 pages covering the original serverless architecture, cold start benchmarks, CDN caching, and phase gates.
+
+ ### AWS Tasks (wikibot.io phases)
+ Preserved at [[Archive/AWS_Tasks/]] — 11 pages covering Phases 0–4, prerequisites, launch checklist, and MCP OAuth routing fixes.
+
+ ### AWS-era Dev Summaries
+ Phase 1–2 implementation summaries (Dev/P1-*, Dev/P2-*, Dev/Phase_1_*) remain in Dev/ for git history context but are not actively maintained.
+
+ ### Archived Design (still in Design/)
+ - [[Design/Semantic_Search]] — Original Chroma plugin design (superseded by V2)
+ - [[Design/Async_Embedding_Pipeline]] — DynamoDB Streams embedding pipeline (AWS-specific)
+ - [[Design/P2-Username_Summary]] — Phase 2 username routing (AWS-era)
## Meta
- [[Meta/Wiki_Usage_Guide]] — How agents use this wiki
+ - [[Dev/Claude_Code_Memory_Backup]] — Canonical memory snapshot
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9