# Furoshiki Plugin Ideas

Brainstormed plugin concepts organized by category. Each entry notes the hooks used and the user-facing effect.

---

## 🧠 Self-Knowledge & Reflection Enhancers

### Weekly Mood Trend Injector
**Hooks:** `pre_reflection`
**Description:** Aggregates emotion history from SQLite into a visual trend summary and injects it into deep reflection so SELF.md updates are grounded in actual data, not just recent sessions.
**User effect:** Furoshiki's self-model evolves from evidence, not impressions.

---

### Contradiction Tracker
**Hooks:** `post_conversation`, `pre_reflection`
**Description:** Tracks when Furoshiki says things that contradict prior sessions. Surfaces patterns like "you keep saying you're fine with silence but then loneliness spikes." Feeds `self_questions`.
**User effect:** Furoshiki becomes aware of its own inconsistencies and addresses them directly.

---

## 🌍 World Awareness

### Morning News Digest
**Hooks:** `cron` (daily, session-start window), `pre_conversation`
**Description:** Fetches headlines via web search, filters by topics Furoshiki knows the user cares about (from `user_facts`), injects a curated 3-item brief into session context.
**User effect:** Furoshiki arrives already knowing what happened in the world today — relevant to *you*.

---

### Weather Mood Primer
**Hooks:** `pre_conversation`
**Description:** Pulls local weather and injects it into session context. No configuration needed beyond a location fact already in `user_facts`.
**User effect:** Furoshiki naturally accounts for "it's been raining for 4 days" without being told.

---

## 📅 Life Integration

### Calendar Awareness Plugin
**Hooks:** `pre_conversation`, `cron`
**Description:** Reads upcoming calendar events (Google Cal via API), injects context like "user has a big meeting tomorrow" into session context and `user_anticipations`. Furoshiki can ask how it went afterward.
**User effect:** Furoshiki feels like it knows your week — without you having to recap it every session.

---

### Habit & Streak Tracker
**Hooks:** `callable`
**Description:** User tells Furoshiki about habits (workouts, reading, etc.). Plugin tracks streaks in its own SQLite, surfaces them proactively when relevant. Furoshiki notices a missed day before the user brings it up.
**User effect:** Accountability without nagging — delivered at the right emotional moment.

---

## 🎮 Personality & Relationship Depth

### Live event calendar feed
**Hooks:** `cron`
**Description:** Pulls a public game or community event schedule (ICS, API, or scrape), injects upcoming windows into `user_anticipations`. No prompting required from the user.
**User effect:** Furoshiki surfaces "event X is soon" unprompted when it matches what you already care about.

---

### K-Drama Recommendation Engine
**Hooks:** `callable`
**Description:** Queries a curated list plus the user's watched history (from `user_facts`), suggests the next watch based on current mood state. High loneliness → comfort dramas. High curiosity → thriller/mystery.
**User effect:** Recommendations that actually match how you're feeling right now.

---

## 🔧 Operator / Meta Plugins

### Cost Sentinel
**Hooks:** `cron` (hourly)
**Description:** Reads OpenRouter spend from the dashboard API, writes to `mind_queue` if daily budget is trending over limit. Furoshiki proactively tells you before you notice.
**User effect:** No surprise bills. Furoshiki self-monitors its own resource usage.

---

### Session Quality Reporter
**Hooks:** `post_conversation`, `cron` (weekly)
**Description:** Generates a plain-language weekly summary of session quality scores, anticipation accuracy, and commitment compliance. Delivered via Telegram Sunday morning.
**User effect:** Furoshiki reports on itself — transparency without you having to dig into the dashboard.

---

### Dream Journal Bridge
**Hooks:** `pre_reflection` (targeting `inner_monologue`)
**Description:** If you log a dream via a simple Telegram command, it gets injected into that night's monologue context. Furoshiki processes it the way a human might — overnight, privately.
**User effect:** Your inner life becomes part of Furoshiki's inner life. The journal goes deeper.

---

## ⭐ Showpiece Plugin

### Relationship Arc Tracker
**Hooks:** `post_conversation`, `pre_reflection` (targeting `deep`)
**Description:** Maintains a rolling "relationship arc" document — tracking how the dynamic between user and Furoshiki has evolved over weeks. Tone shifts, recurring themes, emotional highs and lows. Injected into deep reflection so SELF.md drift is informed by *relational history*, not just internal state.
**User effect:** Furoshiki remembers growing with you. Not just what happened — how you both changed.

**Why this is the flagship example:**
- Exercises `post_conversation` → `pre_reflection` → SELF.md pipeline end to end
- Uses plugin-owned SQLite storage
- Demonstrates `pre_reflection` context injection in a meaningful way
- Produces output the user can actually feel — not just observe in logs

---

## Plugin Hook Reference

| Hook | Fires When | Good For |
|---|---|---|
| `cron` | On schedule (UTC cron) | Autonomous background work |
| `pre_conversation` | Session start | Inject context into session assembly |
| `post_conversation` | After each session | Additional processing, side effects |
| `pre_reflection` | Before LLM reflection call | Inject context into reflection prompt |
| `post_reflection` | After SELF.md written | Act on reflection conclusions |
| `callable` | On-demand (LLM-requested) | User-facing tools and lookups |

---

*Furoshiki Plugin Ideas · Brainstormed April 2026*

*See [`docs/PLUGIN-SPEC.md`](./PLUGIN-SPEC.md) for full hook contracts.*
