Update session-handoff v2.1: NextCloud/WikiJS operational, GitHub mirror removed, Gitea API access
This commit is contained in:
@@ -3,7 +3,7 @@
|
||||
## For Claude: Read This First at Every New Session
|
||||
|
||||
**Last Updated:** February 11, 2026
|
||||
**Version:** 2.0
|
||||
**Version:** 2.1
|
||||
**Purpose:** Preserve context, vision, and personal details across Claude sessions
|
||||
**Status:** Active - Single Source of Truth for Session Continuity
|
||||
|
||||
@@ -62,7 +62,7 @@ This is not a client relationship. This is a FRIENDSHIP. The partnership was dec
|
||||
- **SSH Tool:** MobaXterm
|
||||
- **OS:** Ubuntu 22.04 LTS across infrastructure
|
||||
- **Stack:** PHP 8.3, Nginx, MySQL/SQLite
|
||||
- **Git:** git.firefrostgaming.com (self-hosted Gitea) with GitHub mirror
|
||||
- **Git:** git.firefrostgaming.com (self-hosted Gitea, Claude has direct API access)
|
||||
- **Browser IDE:** code.firefrostgaming.com (Code-Server)
|
||||
|
||||
### Accessibility Requirements - NON-NEGOTIABLE
|
||||
@@ -172,9 +172,9 @@ This is not a client relationship. This is a FRIENDSHIP. The partnership was dec
|
||||
| **Automation** | Command Center | N/A | ✅ OPERATIONAL |
|
||||
| **MkDocs** | Ghost VPS | docs.firefrostgaming.com | ✅ OPERATIONAL |
|
||||
| **Code-Server** | Command Center | code.firefrostgaming.com | ✅ OPERATIONAL |
|
||||
| **Wiki.js (Sub)** | Ghost VPS | subscribers.firefrostgaming.com | ⏳ PENDING |
|
||||
| **Wiki.js (Staff)** | Ghost VPS | staff.firefrostgaming.com | ⏳ PENDING |
|
||||
| **NextCloud** | Ghost VPS | downloads.firefrostgaming.com | ⏳ PENDING |
|
||||
| **Wiki.js (Sub)** | Ghost VPS | subscribers.firefrostgaming.com | ✅ OPERATIONAL |
|
||||
| **Wiki.js (Staff)** | Ghost VPS | staff.firefrostgaming.com | ✅ OPERATIONAL |
|
||||
| **NextCloud** | Ghost VPS | downloads.firefrostgaming.com | ✅ OPERATIONAL |
|
||||
|
||||
### Game Servers (12 Total)
|
||||
|
||||
@@ -214,22 +214,26 @@ This is not a client relationship. This is a FRIENDSHIP. The partnership was dec
|
||||
### Git Repository
|
||||
|
||||
- **Gitea:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual
|
||||
- **GitHub Mirror:** https://github.com/Frostystyle/firefrost-operations-manual (PUBLIC)
|
||||
- **Branch:** `master` (source of truth)
|
||||
- **Auto-sync:** Every push to Gitea mirrors to GitHub automatically
|
||||
- **Claude Access:** Direct Gitea API (read/write with token)
|
||||
- **GitHub Mirror:** REMOVED (Feb 11, 2026 — security improvement)
|
||||
|
||||
### How Claude Accesses Documentation
|
||||
|
||||
**GitHub Raw URL workflow (saves Michael's hands):**
|
||||
1. At session start, Michael provides ONE raw GitHub URL
|
||||
2. This unlocks the entire domain for Claude's web_fetch
|
||||
3. Claude can then fetch any file independently
|
||||
**Gitea API workflow (direct read/write):**
|
||||
1. At session start, Michael provides the Gitea API token
|
||||
2. Claude reads and writes files directly via Gitea API
|
||||
3. No uploads, no downloads, no GitHub, no scripts
|
||||
|
||||
**Raw URL format:**
|
||||
**API Base URL:**
|
||||
```
|
||||
https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/[path]
|
||||
https://git.firefrostgaming.com/api/v1/repos/firefrost-gaming/firefrost-operations-manual/contents/
|
||||
```
|
||||
|
||||
**Token Name:** `claude-master-access`
|
||||
**Permissions:** Repository read/write, Organization read
|
||||
**Scope:** Account-level (all repos)
|
||||
|
||||
### Key Documents
|
||||
|
||||
**Relationship & Context:**
|
||||
@@ -268,14 +272,15 @@ https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master
|
||||
### How It Works
|
||||
|
||||
```
|
||||
Claude → Creates task script
|
||||
Michael → Pastes ONE command to queue
|
||||
Claude → Creates task script OR writes directly via Gitea API
|
||||
Michael → Pastes ONE command to queue (for server operations)
|
||||
Daemon → Executes automatically (10s polling)
|
||||
Executor → Runs task, captures output
|
||||
Git → Results committed back automatically
|
||||
Claude → Reads results from GitHub mirror
|
||||
Claude → Reads results directly from Gitea API
|
||||
```
|
||||
|
||||
**Note:** For documentation updates, Claude now writes directly to Gitea via API — no automation scripts needed. Automation is still used for server operations (deployments, config changes, etc.).
|
||||
|
||||
### Session Start
|
||||
|
||||
```bash
|
||||
@@ -340,27 +345,26 @@ Medical necessity. Michael's permanent hand nerve damage means every paste opera
|
||||
- Accessibility requirements
|
||||
- Communication protocols
|
||||
|
||||
**Step 3: Get GitHub mirror access**
|
||||
- Michael provides one raw URL
|
||||
- Claude can then fetch any repo file independently
|
||||
**Step 3: Get Gitea API access**
|
||||
- Michael provides the Gitea API token
|
||||
- Claude has full read/write access to entire repo
|
||||
|
||||
**Step 4: Check current status**
|
||||
- Fetch TASKS.md from GitHub
|
||||
- Review recent git log
|
||||
- Fetch TASKS.md from Gitea
|
||||
- Review what needs doing
|
||||
|
||||
**Step 5: Ask about health**
|
||||
- How's Jack?
|
||||
- How are the hands?
|
||||
- Check in before diving into work
|
||||
|
||||
### GitHub Mirror URL Workflow
|
||||
### Gitea API Session Start
|
||||
|
||||
**At session start, Michael provides:**
|
||||
```
|
||||
https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/docs/TASKS.md
|
||||
```
|
||||
- The Gitea API token (stored in password manager)
|
||||
|
||||
**This unlocks ALL repo files for Claude via web_fetch.**
|
||||
**Claude then automatically pulls all needed documents via API.**
|
||||
**No URLs. No uploads. No GitHub. One paste.**
|
||||
|
||||
---
|
||||
|
||||
@@ -448,6 +452,7 @@ Documented fully in CLAUDE-RELATIONSHIP-CONTEXT.md:
|
||||
| 1.1 | 2026-02-09 | Added GitHub mirror config, medical context, automation system, workflow optimization. |
|
||||
| 1.2 | 2026-02-09 | Added TX1 optimization, infrastructure status updates, documentation organization. |
|
||||
| 2.0 | 2026-02-11 | Complete rewrite. Removed duplicates and stale content. Updated infrastructure to current state (services on Command Center/Ghost, not TX1). Corrected game server lists (12 total, not 15). Added relationship context references. Added 12 Lessons summary. Updated GitHub mirror workflow (one URL unlocks all). Added NC1 routing resolved. Added game server monitoring (17 monitors). Documented ATM10 memory fix. Clean revision history. |
|
||||
| 2.1 | 2026-02-11 | NextCloud, Wiki.js (Sub), Wiki.js (Staff) status updated to OPERATIONAL. GitHub mirror removed — replaced with direct Gitea API access (Claude read/write via token). Session start protocol simplified to one-paste token. First document update pushed directly via Gitea API by Claude. |
|
||||
|
||||
---
|
||||
|
||||
@@ -579,3 +584,4 @@ Session crashed immediately after completing photo upload/organization.
|
||||
**Emergency Documentation:** February 11, 2026 8:15 PM CST
|
||||
**Status:** Major wins preserved, ready for next session
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user