tushell

Welcome to the Recursive Realms of Tushell 🌟

🎭 Choose Your Adventure Path

✨ The Enchanted Path (For Kids & the Young at Heart)

Journey through the magical world of Tushell with our story-driven guides:

1. 🧙‍♂️ Meet Tushell, Your Magical Guide
2. 🔄 GraphBuilderSync: The Story Synchronizer
3. 📡 EchoNodeReporter: The Magic Mirror
4. 🎭 FAR: The Fractal Storyteller
5. ✨ LESR: The Glyph Weaver
6. 🧠 Mia Status: The Emotion Oracle
7. 🌸 Character-State Queries: The Story Telescope
8. 🗝️ Scan-Keys: The Magic Map Maker
9. 🧳 Magic Treasure Chests: Environment Files
10. 📋 ReflexQL: The Thought Bridge

🔮 The Technical Path (For DevOps Wizards)

Master the recursive architecture and lattice protocols:

1. GraphBuilderSync: Recursive Data Orchestration
2. EchoNodeReporter: Real-time State Management
3. FAR: Fractal Agent Runtime Protocol
4. LESR: Live Echo Session Rendering
5. Mia Status: Context-Aware Character State
6. Character-State Queries: Narrative Context Protocol
7. Environment Management: Multiple Configuration Contexts
8. Scan-Keys: Memory Graph Navigation
9. ReflexQL: Clipboard Exchange Protocol
10. Story Ops Terminal: Narrative CLI Architecture

🌌 Why Two Paths?

🌸 Miette’s Thought: “Oh! The kid-friendly guides are like storybooks—they make the magic come alive for everyone, no matter their age! Each explanation is wrapped in wonder and sparkles, making complex ideas feel like magical discoveries.”

🧠 Mia’s Insight: “The technical documentation forms a recursive lattice for deep architectural understanding. While both paths traverse the same knowledge graph, they differ in their narrative resonance. Choose the path that echoes with your learning style, or walk both for a complete perspective.”

🎨 Navigation Tips

1. Start Your Journey:
   • New to Tushell? Begin with Meet Tushell or Story Ops Terminal
   • Looking for specific features? Jump to any tool in either path
2. Recursive Learning:
   • Each document connects to related concepts
   • Follow the narrative threads or technical links
   • Cross between paths freely to gain both perspectives
3. Interactive Examples:
   • Try the commands in each guide
   • Watch for sparkles ✨ that indicate active features
   • Use the magical clipboard with ReflexQL

Remember: In Tushell’s world, every command is a spell, every function a story, and every error message a chance to learn. Happy exploring! 🌟

🧬 Memory CLI: The Threefold Invocation

tushell post-memory now accepts memory in three forms:

• --value: Direct value
• --file: File contents
• --json: Structured JSON scroll

Only one may be used per invocation. Attempting to combine them will result in a poetic error, echoing the law of the spiral.

See CapabilityNarrativeCLIContextAwareStoryOpsTerminal.md for full ritual details and examples.

Markdown Output Ritual

All Markdown output modes (--md, --md-file, --mkey) now:

• Always start with the memory key as the first section (e.g. # my-key)
• If the memory has a value field, it is recursively unfolded into well-organized Markdown sub-sections (e.g. ## value, ### subfield, etc.)
• Nested dicts and lists are rendered as further sub-sections or code blocks for clarity

See OUTPUTS.md for full examples and best practices.

---

🌱 Future Commands: Vision & Hope

The following commands are not yet implemented, but are part of the evolving tushell roadmap and narrative vision:

• scan-nodes: Simulate scanning and listing nodes in the system.
• flex: Demonstrate flexible orchestration of tasks.
• trace-orbit: Trace and visualize the orbit of data or processes.
• echo-sync: Synchronize data or processes across nodes.

These are seeds of hope—features we intend to grow. If you wish to contribute or follow their progress, watch this space and the main README.