refactor: lowercase Tools/Documents/Analytics folders; add clients/ and projects/ with context files; update AGENTS.md, README.md, manifest.json

2026-05-30 23:49:26 -05:00
parent 9967c6709b
commit c10598d197
14 changed files with 223 additions and 27 deletions
@@ -0,0 +1,14 @@
+# Projects
+
+Context files for internal and personal projects — background, repos, stack details, and working notes for AI agents.
+
+## Projects
+
+| File | Project |
+|------|---------|
+| [`silma-ai.md`](./silma-ai.md) | Silma AI — Jacob's AI assistant platform |
+| [`banner-and-pyre.md`](./banner-and-pyre.md) | MP Banner and Pyre |
+
+## Adding a New Project
+
+Create `<project-slug>.md` in this folder, then update `projects/README.md` and the root `manifest.json`.
@@ -0,0 +1,49 @@
+# MP Banner and Pyre
+
+Context for AI agents working on the Banner and Pyre project suite.
+
+---
+
+## Overview
+
+MP Banner and Pyre is a Mathison Projects initiative. It consists of multiple related repositories covering the main application, a migration layer, and a web frontend.
+
+---
+
+## Repositories
+
+| Repo | Location | Branch | Notes |
+|------|----------|--------|-------|
+| `mp-banner-and-pyre` | Gitea: `jacob-mathison/mp-banner-and-pyre` | `main` | Core project |
+| `mp-banner-and-pyre-migration` | Gitea: `jacob-mathison/mp-banner-and-pyre-migration` | `master` | Migration layer |
+| `mp-banner-and-pyre-web` | Gitea + Amplify | `main` | Web frontend |
+
+### Clone URLs (Gitea)
+```bash
+git clone http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre.git
+git clone http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre-migration.git
+git clone http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre-web.git
+```
+
+---
+
+## Deployment
+
+| Surface | Detail |
+|---------|--------|
+| **Amplify App** | `mp-banner-and-pyre-web` — App ID: `d1k6pj7qv29ic0` |
+| **Live URL** | `d1k6pj7qv29ic0.amplifyapp.com` |
+| **AWS Account** | `567637986724` |
+
+```bash
+# Trigger a deployment
+aws amplify start-job --app-id d1k6pj7qv29ic0 --branch-name main --job-type RELEASE
+```
+
+---
+
+## Notes for AI Agents
+
+- Three-repo structure: keep changes coordinated across core, migration, and web
+- `mp-banner-and-pyre-migration` uses `master` as its default branch (legacy)
+- All repos are **private** — use local Gitea only (see `tools/gitea.llm.md`)
@@ -0,0 +1,55 @@
+# Silma AI
+
+Context for AI agents working on the Silma AI platform.
+
+---
+
+## Overview
+
+Silma is Jacob Mathison's personal AI assistant — a catgirl AI agent running on OpenClaw. She has persistent memory, a defined personality, calendar/email/Discord/Telegram integrations, and a full local infrastructure stack.
+
+---
+
+## Infrastructure
+
+| Component | Detail |
+|-----------|--------|
+| **Platform** | OCPlatform (custom AI ops platform) |
+| **Host machine** | `Tabitha` — MacBook Pro arm64, `100.76.192.116` |
+| **Install root** | `/Users/Tabitha/.openclaw/` |
+| **Workspace** | `/Users/Tabitha/.openclaw/workspace/` |
+| **k8s namespace** | `silma-ai` on `docker-desktop` |
+
+## Local Services (k8s)
+
+| Service | Port | Notes |
+|---------|------|-------|
+| PostgreSQL + pgvector | `5432` | DB: `silma` |
+| Redis | `6379` | |
+| Elasticsearch | `9200` | |
+| Qdrant | `6333` | Vector DB for semantic memory |
+| MinIO | `9000` / `9001` | S3-compatible storage |
+| Vault | `18200` | Secrets management |
+| Temporal | `7233` | Workflow orchestration |
+| Grafana | `3000` | Metrics dashboards |
+
+---
+
+## Repositories
+
+| Repo | Location | Notes |
+|------|----------|-------|
+| `silma-ai-webapp` | `silmaai/silma-ai-webapp` (GitHub, private) | Silma web app |
+| `silma-backups` | `silmaai/silma-backups` (GitHub, private) | Memory and config backups |
+| `silma-kittens` | `silmaai/silma-kittens` (GitHub, private) | Remote node WebSocket bridge |
+| `silma-usdw` | `silmaai/silma-usdw` (GitHub, private) | U.S. Data Watch app |
+| `mp-silma-webapp` | Amplify App ID: `d390fbhya3a6oy` | Live Amplify deploy |
+
+---
+
+## Notes for AI Agents
+
+- Silma's workspace is at `/Users/Tabitha/.openclaw/workspace/` — treat it as her home directory
+- Memory lives in `memory/` (daily logs) and `MEMORY.md` (curated long-term)
+- Semantic memory uses ChromaDB — searchable via `npm run memory:search`
+- k8s port-forward required before accessing local services: `bash k8s/silma-ai/scripts/port-forward.sh`