From 630054aa9ccb45453a39b25a471ebdd9f057a14a Mon Sep 17 00:00:00 2001
From: Tom Smith <142233216+tomsmith8@users.noreply.github.com>
Date: Tue, 7 Apr 2026 16:32:22 +0100
Subject: [PATCH] Add llms.txt, robots.txt, and ai-plugin.json

---
 public/.well-known/ai-plugin.json | 15 ++++++++++
 public/llms.txt                   | 49 +++++++++++++++++++++++++++++++
 public/robots.txt                 |  5 ++++
 3 files changed, 69 insertions(+)
 create mode 100644 public/.well-known/ai-plugin.json
 create mode 100644 public/llms.txt
 create mode 100644 public/robots.txt

diff --git a/public/.well-known/ai-plugin.json b/public/.well-known/ai-plugin.json
new file mode 100644
index 00000000..60470c15
--- /dev/null
+++ b/public/.well-known/ai-plugin.json
@@ -0,0 +1,15 @@
+{
+  "schema_version": "v1",
+  "name": "GraphMindset",
+  "description": "Knowledge graph explorer with Lightning Network payments. Search nodes, manage sources, edit ontology schemas, boost content.",
+  "auth": {
+    "type": "none"
+  },
+  "api": {
+    "type": "openapi",
+    "url": "/openapi.json"
+  },
+  "logo_url": "/logo.png",
+  "contact_email": "",
+  "legal_info_url": ""
+}
diff --git a/public/llms.txt b/public/llms.txt
new file mode 100644
index 00000000..74a77b84
--- /dev/null
+++ b/public/llms.txt
@@ -0,0 +1,49 @@
+# GraphMindset
+
+> Knowledge graph explorer and ontology editor built on Lightning Network
+
+GraphMindset is a frontend for exploring, searching, and managing knowledge graphs. It connects to a Neo4j-backed graph database via jarvis-backend and authenticates via jarvis-boltwall using Lightning Network L402 payments.
+
+## Core Features
+
+- Search knowledge graph nodes by keyword
+- View and manage data sources (Twitter handles, YouTube channels, RSS feeds, GitHub repos)
+- Add content via URL with automatic source type detection
+- Visual ontology/schema editor for defining node types and relationships
+- Lightning Network payments for premium features (L402 protocol)
+- Boost nodes with Lightning keysend payments
+- Media playback for podcast episodes and audio content
+
+## Pages
+
+- `/` - Main app: sidebar with sources + search bar + graph viewport
+- `/ontology` - Schema/ontology editor with dagre-based hierarchy visualization
+
+## Authentication
+
+Authentication uses the Sphinx Bridge protocol (postMessage-based). Users authenticate via:
+1. Sphinx desktop/mobile app (Lightning wallet with message signing)
+2. WebLN browser extensions (e.g. Alby)
+
+API requests include signed message parameters (`sig`, `msg`) for identity verification.
+
+## API
+
+All API requests go through a boltwall gateway that handles auth and payments.
+
+### Key Endpoints
+- `GET /isAdmin` - Check auth status, admin role, feature flags
+- `GET /v2/nodes?q={query}` - Search graph nodes
+- `GET /schema/all` - Get full ontology (node types + relationships)
+- `POST /radar` - Add content source
+- `POST /boost` - Boost a node with Lightning payment
+- `GET /about` - Graph metadata (name, description)
+- `GET /balance` - L402 token balance
+
+## Tech Stack
+
+- Next.js 16, TypeScript, Tailwind v4, shadcn/ui
+- Zustand for state management
+- dagre for graph layout
+- sphinx-bridge for Lightning auth
+- lsat-js for L402 payment protocol
diff --git a/public/robots.txt b/public/robots.txt
new file mode 100644
index 00000000..5553a409
--- /dev/null
+++ b/public/robots.txt
@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+
+# LLM agent files
+Sitemap: /llms.txt