# 🧠🗂️ JOURNAL SYSTEM OVERVIEW ("Mind Prosthetic Log")

## 🛍️ PURPOSE

To help externalize memory, track psychological patterns, log important events, and record internal states in a structured, searchable way—compensating for:

- Rapid memory loss or forgetting what you were just thinking/saying

- Difficulty organizing and verbalizing complex emotions

- Inability to track patterns over time without external structure

- Need for logs to aid therapy, legal documentation, co-parenting disputes

- Cross-platform native app (Linux/Windows/macOS) with mobile access via Tailscale + NiceGUI

- Designed for neurodivergent daily use with structured, low-friction interfaces

- Allows fragment logging, full journal entry templates, tagging, and search

- Uses Python where powerful NLP/AI tasks are needed

- Expandable to Android (ideal) and iOS (via browser or shortcuts)

---

## 🧱 COMPONENTS

### 1. Templates & Daily Entries

Multiple modular templates are available, including:

- Full daily entry (see below)

- Meltdown logs

- Shutdown summaries

- Therapy prep and recap

- Legal event summaries

#### Daily Entry Format Example:

```markdown
📅 Date: YYYY-MM-DD

## 🧠 Cognitive State

- [ ] Masking
- [ ] Shutdown
- [ ] Meltdown
- [ ] Freeze
- [ ] Flow state

- Notes:

## 🧠 Mental / Emotional Snapshot

- Internal monologue or silence?
- Thought loops or rumination?
- Anxiety level: (0–10)
- Depression level: (0–10)
- Suicidal ideation: (Y/N, passive/active)
- Emotional state(s): Angry / Tired / Hopeful / Numb / Triggered / Overwhelmed / Energized / etc.
- Notes:

## ⚡ Memory / Mind Failures

- Forgot something mid-sentence?
- Lost train of thought?
- Couldn't speak thoughts?
- Time blindness / lost hours?
- Notes:

## 📜 Events / Triggers

- Interactions (e.g., with co-parent, child, officials)
- Flashbacks / trauma triggers
- Physical symptoms
- Legal / medical events
- Notes:

## 💬 Communication / Expression Log

- Messages I didn’t send
- Things I forgot to say
- Things I said that I didn’t mean
- Verbal conflicts / miscommunication

## 🧰 Coping / Tools Used

- Breathing
- Music
- Walking
- Writing
- AI journaling
- Hiding / Isolation
- Notes:

## 🧠 Reflection

- What do I wish I’d done differently?
- What patterns am I noticing?
- Is this getting better or worse?
- Notes:
```

---

### 2. Modular "Insert Blocks"

Quick journal fragments for when you're too overwhelmed to fill out a full template.

#### Example block types:

- `!FLASHBACK:` description of what triggered it

- `!FORGOT:` mid-thought freeze or sentence drop

- `!QUOTE:` something I wish I'd said

- `!TRIGGER:` encounter that caused a somatic or shutdown response

- `!LOOP:` thought pattern or obsession

- `!VIOLATION:` emotional harm from another person (e.g., co-parent)

- `!SOMATIC:` physical response (shaking, tears, tight chest)

These can be dropped into a daily log or used stand-alone.

---

### 3. Indexing / Metadata System

To make logs searchable:

- **Tagging**: `#shutdown`, `#CPTSD`, `#co-parent`, `#legal`, etc.

- **Timestamps**: `@HH:MM`

- **Sources**: `> from text convo`, `> from therapy session`, `> from memory`, etc.

- **Priority markers**:
  
  - `‼️` = urgent
  
  - `🔁` = recurring pattern
  
  - `🧩` = unexplained moment

---

### 4. Use Cases

This system supports:

- **Therapy**: structure logs showing memory gaps, trauma patterns, breakdowns

- **Legal**: document co-parenting issues and harmful behavior neutrally and time-stamped

- **Internal Growth**: recognize cycles, triggers, and patterns

- **Compensation**: catch memory failures before they damage communication or safety

---

### 5. Capture Modes (Tools)

**Currently Available:**

- **Desktop UI** (NiceGUI)

- **Mobile browser access** via Tailscale

- **CLI tools**: `jfrag`, `vault`, `server`, `search`

- **ChatGPT log syntax** (can copy-paste into assistant)

- **Encrypted Vaults**: Journals saved as monthly `.vault` files

- **Automatic data cleanup**: Decrypted data auto-cleared on shutdown


- **Voice-to-text input**: (desktop + mobile)

- **Calendar and rich Markdown**: preview in UI

- **SQcypher backend**: Enrypted database backend.

---

## 🛍️ Syntax Format

```markdown
!TYPE @time #tags
Description of the event, thought, or experience.
```

### 📦 Example Fragments:

```markdown
!FLASHBACK @15:20 #CPTSD #shutdown
Smelled her shampoo in the hallway and got hit with a memory of the hospital visit. Heart raced, froze completely.

!FORGOT @16:45 #aphantasia #mindblank
Mid-sentence memory drop while trying to explain Phaylynn’s school schedule. Just froze and couldn’t finish. Felt ashamed.

!TRIGGER @email #co-parent #legal
Kathryn’s message today saying “you never do anything for her” triggered a whole-body tension + tears. Completely false.

!QUOTE @walk #unsaid
What I *wanted* to say was: “You act like you want control more than peace.” Didn’t say it.

!LOOP #rumination
Keep repeating: “What if I’m the problem? What if it *is* all my fault?” over and over.

!SOMATIC @22:05 #CPTSD
Shaking in both arms, vision blurring, and that sharp ice-feeling in my chest. No obvious trigger identified yet.
```

---

## 🔢 Fragment Insert Interfaces

### 📱 Mobile (Planned)

- Shortcut or PWA access

- Prompts: Type, Time, Tags, Description

- Appends to `YYYY-MM-DD.md` securely via NiceGUI interface

### 💻 CLI / Bash

```bash
jfrag "!TRIGGER" "Person texted me 'you don’t do anything for her'..." "#co-parent #shutdown"
```

Appends to journal or vault.

### 🤖 AI Session Logging

Say:

```
!QUOTE "I wish you would just work with me instead of against me."
```

Assistant logs it into today's entry using proper syntax.

---

## ✅ Summary: Current & Future Tasks

### 🔹 Completed

- Vault encryption and cleanup

- UI (NiceGUI), cross-platform and Tailscale-accessible

- CLI tooling (vault, jfrag, search)

- Metadata and tag system

- AI summarization and pattern detection

- Documentation and structured templates

- Voice-to-text input (desktop & mobile)

- Calendar view + richer Markdown preview in UI

- Advanced NLP (sentiment, NER, topic modeling)

- SQLcypher backend for fast structured search

- Entry merging logic (into existing sections)


### 🔹 In Progress / Planned

- Export therapy-ready summaries

- Weekly/monthly summary generator

- AI tag suggestion

- In-memory decrypted vault reading (no full file extraction)