Grand Diomande Research · Full HTML Reader

Knowledge Ferment

> Ideas age in storage, gain depth through passive cross-linking. > **NEW in v2.3:** The Vineyard — move upstream from cellar to cultivation. Plant idea seeds in terroir plots, graft concepts across domains, observe growing seasons, prune weak branches, and harvest when ripe. The cellar receives. The vineyard creates.

Agents That Account for Themselves proposal experiment writeup candidate score 42 .md

Full Public Reader

Knowledge Ferment

Version: 2.3.0
Generation: 19

> Ideas age in storage, gain depth through passive cross-linking.
> NEW in v2.3: The Vineyard — move upstream from cellar to cultivation. Plant idea seeds in terroir plots, graft concepts across domains, observe growing seasons, prune weak branches, and harvest when ripe. The cellar receives. The vineyard creates.

Concept

Like wine or cheese, some ideas improve with time. Knowledge Fermentation is passive incubation — ideas rest in a cellar, and the system periodically discovers connections that weren't obvious when the idea was young.

Contrast with Dream Weaver:
- Dream Weaver: Active incubation, guided evolution, explicit growth cycles
- Knowledge Ferment: Passive aging, emergent connections, time-based depth

The Cellar

Ideas enter as raw notes and age through stages:

AgeStageDepth Modifier
0-1dFresh1.0×
1-7dYoung1.2×
7-30dMaturing1.5×
30-90dAged2.0×
90d+Vintage3.0×

Depth increases as:
1. Time passes (natural aging)
2. Cross-links are discovered
3. Ideas are referenced in conversations
4. Related ideas enter the cellar

Commands

Core

/ferment add <note>        — Add note to cellar
/ferment cellar            — View cellar inventory
/ferment aged              — Show vintage ideas (90d+)
/ferment taste <id>        — Deep-read an idea + connections
/ferment crosslink         — Run passive cross-linking cycle
/ferment vintage           — Show best-aged insights
/ferment stats             — Cellar statistics

Blending (v1.1)

/ferment blend <id1> <id2> — Blend mature ideas into synthesis
/ferment suggest-blends    — AI suggests blend opportunities
/ferment blends            — View all created blends
/ferment decant <id>       — Extract refined essence from blend
/ferment report            — Full cellar fermentation report

The Sommelier (v1.2 — NEW)

/ferment sommelier         — Activate sommelier mode (context-aware)
/ferment pair <topic>      — Find aged ideas that pair with topic
/ferment recommend         — Get curated recommendations for current session
/ferment flight <theme>    — Tasting flight of related vintage ideas
/ferment reserve <id>      — Mark idea as reserve (exceptional quality)
/ferment occasion          — Suggest ideas based on time/mood/project
/ferment vertical <keyword>— Trace evolution of a concept over time
/ferment cellar-notes      — Add tasting notes to an idea

---

The Sommelier (v1.2)

A master sommelier doesn't just know wines — they read the room, understand the meal, and recommend the perfect pairing for the moment. The Sommelier does this for your aged ideas.

Context Awareness

The Sommelier analyzes:
- Current conversation — What are you discussing right now?
- Active projects — What's in your workspace?
- Time of day — Morning calls for energizing insights, evening for contemplative ones
- Mood signals — Detected from conversation tone
- Recent memory — What patterns have emerged this week?

Pairing Algorithm

pair_score = (
    keyword_overlap × 0.3 +
    project_relevance × 0.25 +
    depth_score × 0.2 +
    temporal_resonance × 0.15 +
    mood_alignment × 0.1
)

Temporal Resonance: Ideas from similar past contexts (same day of week, similar projects, seasonal patterns) score higher.

Mood Alignment:
| Mood | Preferred Ideas |
|------|-----------------|
| Focused | High-depth, single-domain |
| Creative | Cross-linked, multi-domain |
| Reflective | Vintage, philosophical |
| Urgent | Actionable, project-specific |
| Exploratory | Young with high potential |

Tasting Flights

A flight is a curated set of 3-5 related ideas presented together, like a wine tasting flight:

/ferment flight "distributed systems"

🍷 FLIGHT: Distributed Thinking
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. 🥂 [Aged] "Every autonomous system needs explicit environmental controls"
   → Your amuse-bouche: sets the stage

2. 🍾 [Vintage] "Sub-agents lack context without enrichment"
   → The body: core insight on distribution

3. 🍷 [Maturing] "Projects share deep abstractions across domains"
   → The pairing: cross-domain connection

Sommelier's Note: These three form a progression from
control → context → abstraction. Consider together when
designing multi-agent systems.

Reserve Collection

Some ideas transcend normal vintage status. Mark them as reserve for:
- Exceptional insight density
- Foundational concepts that inform many others
- "Aha moment" ideas worth revisiting

Reserve ideas get:
- 🏅 Special designation in listings
- Priority in recommendations
- Protected from auto-archiving
- Highlighted in relevant flights

Vertical Tastings

Track how a concept evolved across multiple cellared ideas:

/ferment vertical "context"

📊 VERTICAL: "context" across time
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Jan 15: "Context is the missing link in agent spawning"
  └─ Depth: 1.2 | Links: 2

Jan 22: "Every spawn needs inherited context"
  └─ Depth: 1.8 | Links: 5

Jan 31: "Enriched spawn pattern solves context inheritance"
  └─ Depth: 2.1 | Links: 3

Evolution: Problem → Realization → Solution
The concept matured from observation to pattern.

Cellar Notes

Add evolving tasting notes to track how your understanding deepens:

/ferment cellar-notes idea_abc "Initial thought: seems related to auth"

# Later...
/ferment cellar-notes idea_abc "After blending: actually about trust boundaries"

Notes are timestamped and preserved, showing cognitive evolution.

Occasion-Based Recommendations

/ferment occasion

🌅 Good Morning! The Sommelier recommends:

For your Monday start:
• [Reserve] "Documentation-driven development prevents scope creep"
  Perfect for planning the week ahead

For creative energy:
• [Aged] "Unrelated projects share deep abstractions"
  Cross-pollinate your morning brainstorm

For that meeting at 2pm (Calendar: "Architecture Review"):
• [Vintage] "Environmental controls affect autonomous outcomes"
  Directly relevant context

---

The Distillery (v1.3 — NEW)

While blending combines flavors, distillation extracts the pure essence. Like turning wine into brandy, the Distillery takes multiple aged ideas and concentrates them into high-proof wisdom — removing everything non-essential.

Commands

/ferment distill <id1> <id2> [id3...]  — Distill ideas into a spirit
/ferment spirits                        — View all distilled spirits
/ferment proof <spirit_id>              — Check proof with tasting notes
/ferment barrel <spirit_id> [type]      — Age spirit in a barrel
/ferment stillage                       — View distillation residue
/ferment suggest-distill                — Find distillation candidates
/ferment tasting-note <id> <note>       — Add tasting note to spirit
/ferment distillery-report              — Full distillery status

How Distillation Works

Requirements:
- At least 2 ideas
- All ideas must be 'aged' (30+ days) or 'vintage' (90+ days)
- Higher depth = higher proof output

The process:
1. Ideas are combined in the still
2. Keywords are weighted by depth
3. Common themes become the essence
4. Non-essential details become stillage (residue)
5. Output is a concentrated spirit with a proof rating

Proof Scale

Proof measures concentration (like alcohol proof):

ProofCharacterDescription
40-60💧 LightSubtle, contemplative wisdom
60-80✨ BalancedWell-rounded, approachable
80-120⚡ PowerfulDeep, commanding insight
120-160🔥 ExceptionalRare, intense concentration
160+🏆 LegendaryPerfect conditions achieved

Barrel Aging

Spirits can be aged further in barrels for enhanced character:

/ferment barrel spirit_abc oak

🛢️ Spirit now aging in oak barrel. Check back in a few days.
   +15 proof over time

Barrel Types:

TypeCharacterBonus
oakStandard, balanced+0.3/day
sherrySweet, complex+0.5/day
portRich, fruity+0.4/day
bourbonVanilla, caramel+0.35/day
rumTropical, bold+0.45/day

Maturity Classifications

Spirits age and develop over time:

AgeClassificationCharacter
< 1dWhiteRaw, immediate truth
1-7dSilverEdges smoothing
7-30dReposadoComplexity emerging
30-90dAñejoDeep character
90d+Extra-AñejoProfound, transcendent

Stillage

After distillation, stillage remains — the residue left behind. This isn't waste; it's a record of what contributed to each spirit:

/ferment stillage spirit_abc

🫗 STILLAGE — 3 residues

   From: idea_20260115_context...
   → After distilling 'Sub-agents lack context...' — keywords [context, agents, spawn] contributed to essence

Example Distillation

/ferment distill idea_123 idea_456 idea_789

⚗️ DISTILLED: spirit_20260201_a1b2c3d4
   Proof: 142
   Essence: [CONTEXT, SYSTEMS, EMERGENCE] — Distilled from 3 vintage insights:
   The convergence point is context intersecting with systems and emergence.
   Sources: 3 ideas

💡 Tip: Use 'barrel spirit_20260201_a1b2c3d4 sherry' to age further

Philosophy

Not everything needs to be combined. Sometimes you need to reduce. Distillation is about finding the single truth that runs through multiple insights — the common thread that, once extracted, becomes more powerful than any individual idea.

Stillage is not waste — it's evidence of refinement. The ideas that didn't make it into the essence still contributed by showing where the boundaries lie.

Extract the truth. Let clarity emerge from complexity.

---

The Cocktail Bar (v1.4 — NEW)

While spirits are concentrated wisdom, they're often too intense to apply directly. The Cocktail Bar mixes spirits with fresh context — your current project, conversation, mood, time of day — to create situational wisdom that's immediately actionable.

Commands

/ferment menu                      — View all cocktail recipes
/ferment mix <recipe> [--topic X]  — Mix a specific cocktail
/ferment quick-mix <topic>         — Auto-select recipe based on topic
/ferment bartender [mood]          — Get personalized recommendation
/ferment cocktails [n]             — View recent cocktails
/ferment rate <id> <1-5> [note]    — Rate a cocktail
/ferment create-recipe <name>      — Create custom recipe
/ferment bar-report                — Full bar status

House Recipes

RecipeOccasionCharacter
Morning ClaritymorningHigh-proof, focused, clarity garnish
Brainstorm BlastbrainstormMultiple spirits, wild connections
Evening ReflectioneveningVintage spirits, contemplative
Crisis ShotcrisisHighest-proof, direct, actionable
Deep DiveresearchTopic-matched, thorough exploration
Serendipity SpritzanyRandom selection, playful surprise

How Mixing Works

1. Recipe Selection — Choose a recipe or let the bartender pick
2. Spirit Selection — Spirits matching recipe requirements are selected
3. Fresh Context — Current project, topic, time gathered as "ingredients"
4. Mixing — Spirit essences combined with context
5. Garnish — Final touch applied based on occasion

The Bartender

Ask for recommendations based on:
- Time of day — Different wisdom for different hours
- Mood — stressed, stuck, curious, tired, playful, focused
- Project — Context-aware suggestions

/ferment bartender stuck

🤵 BARTENDER'S RECOMMENDATION
══════════════════════════════════════════════════

Sounds like you need some creative fuel.

🥃 Brainstorm Blast
   Explosive creativity mix. Multiple spirits, cross-domain, wild garnish.

💡 Try: /ferment mix recipe_brainstorm_blast --topic "your problem"

Cocktail Strength

StrengthCharacter
0.5-0.8🍃 Light — gentle, approachable
0.8-1.2🥃 Balanced — ready to inspire
1.2-1.5🔥 Strong — handle with care
1.5+🔥🔥 Potent — breakthrough potential

Custom Recipes

Create your own cocktail recipes:

/ferment create-recipe "Monday Motivation"

Edit `[home-path]` for full customization:

json
{
  "spirit_requirements": ["proof>=100", "maturity:aged"],
  "fresh_ingredients": ["active_project", "today_goals"],
  "garnish": "clarity",
  "occasion": "morning"
}

Philosophy

Aged spirits are concentrated wisdom, but wisdom without context is just trivia. The Cocktail Bar bridges timeless insights with immediate needs — the right wisdom, mixed for the moment.

A good bartender knows what you need before you do.

---

Terroir & Appellations (v1.5 — NEW)

Like wine, ideas are shaped by where and when they were born. Terroir captures the origin context — the "soil and climate" that gave each idea its unique character. Appellations certify ideas from exceptional origins with protected designation.

Commands

/ferment add-terroir <note> [--domain X] [--energy Y] [--tone Z]
                           — Add idea with full terroir capture
/ferment terroir <id>      — View terroir for an idea
/ferment appellations      — List all appellations with stats
/ferment appellation <name> — View ideas certified under appellation
/ferment similar-terroir <id> [n]
                           — Find ideas from similar terroirs
/ferment era start <name> [desc] — Start a new vintage era
/ferment era close         — Close the current era
/ferment era current       — View active era
/ferment era list          — View all eras
/ferment terroir-report    — Full terroir analysis

What Terroir Captures

DimensionValuesMeaning
Time of Daymorning, afternoon, evening, nightWhen the idea was born
Energy Levelhigh, neutral, lowYour energy when creating
Focus Statedeep, normal, scatteredQuality of attention
Emotional Toneexcited, curious, calm, frustrated, neutralEmotional context
Collaborationsolo, pair, groupWho was involved
Domaincoding, philosophy, design, etc.Subject area

Terroir Character Notes

Each terroir combination has a character profile:

/ferment terroir idea_abc

🌍 TERROIR: idea_abc
   Signature: coding-night-high-curious
   Character: deep, unfiltered; energetic, bold; exploratory, open

Time-based Character:
| Time | Character |
|------|-----------|
| Morning | fresh, clear-headed |
| Afternoon | productive, focused |
| Evening | reflective, synthesizing |
| Night | deep, unfiltered |

House Appellations

Six pre-defined appellations for exceptional origin contexts:

AppellationLevelCriteriaCharacter
🏆 Flow State ReserveGrand Crudeep focus + high energyPeak performance territory
🏅 Midnight EpiphanyPremier Crunight + high energyBreakthrough territory
🏅 Collaboration CruPremier Crupair collaborationWisdom of multiple minds
🏅 Problem CruciblePremier Crufrustrated + high energySolutions born from struggle
🏷️ Dawn ThoughtsVillagemorning + normal focusNew day clarity
🏷️ Curious ExplorationVillagecurious toneThe learner's vintage

Creating Custom Appellations

Edit `[home-path]`:

json
{
  "appellation_custom": {
    "id": "appellation_custom",
    "name": "Late Night Code",
    "description": "Ideas born during late-night coding sessions",
    "criteria": {
      "time_of_day": "night",
      "domain": "coding"
    },
    "level": "premier_cru"
  }
}

Vintage Eras

Named periods in your cellar's history — like wine vintage years:

/ferment era start "The Great Refactor"

📅 ERA STARTED: The Great Refactor
   The Great Refactor era
   ID: era_20260201_a1b2c3

When you close an era, it calculates:
- Duration in days
- Idea count from that period
- Average depth of ideas
- Dominant domains
- Notable ideas (top 3 by depth)

/ferment era close

📅 ERA CLOSED: The Great Refactor
   Duration: 14 days
   Ideas: 23
   Avg Depth: 2.4

Similar Terroir Matching

Find ideas from similar origin contexts:

/ferment similar-terroir idea_abc

🌍 SIMILAR TERROIRS to idea_abc

   [aged] "Async patterns need explicit cleanup..."
   Similarity: 85%
   Character: deep, unfiltered; energetic

   [maturing] "Event-driven beats polling..."
   Similarity: 70%
   Character: productive, focused; curious

Terroir Report

Full analysis of your terroir patterns:

/ferment terroir-report

🌍 TERROIR REPORT
{
  "total_terroirs": 47,
  "by_time": {"morning": 12, "afternoon": 18, "evening": 10, "night": 7},
  "by_energy": {"high": 15, "neutral": 28, "low": 4},
  "by_tone": {"curious": 20, "neutral": 15, "excited": 8, "frustrated": 4},
  "top_signature": {"signature": "coding-afternoon-neutral-curious", "count": 9},
  "appellations": {
    "Flow State Reserve": 3,
    "Curious Exploration": 12
  }
}

Philosophy

Not all ideas are created equal — some are born in peak conditions and carry that character forever. Terroir is the memory of those conditions. Appellations celebrate ideas from exceptional origins.

Like a sommelier reading a wine label, knowing an idea's terroir helps you understand its character and find similar insights.

Every idea has a birthplace. Honor where it came from.

---

Library Collection & Corkage (v1.6 — NEW)

Like a winery's Library Collection — the bottles set aside from each vintage for posterity — and corkage — opening your best bottles to share with others — this evolution adds permanent curation and external sharing.

Commands

/ferment library                  — View the Library Collection
/ferment library-add <id> [note]  — Add idea/spirit to Library
/ferment library-remove <id>      — Remove from Library
/ferment library-notes <id> <note>— Add curator's note
/ferment library-criteria         — Show auto-curation thresholds

/ferment corkage <id>             — Prepare idea for sharing
/ferment corkage-tweet <id>       — Format as tweet (280 chars)
/ferment corkage-quote <id>       — Format as quotable insight
/ferment corkage-blog <id>        — Expand into blog-ready prose
/ferment corkage-gift <id> <to>   — Share with another person/agent
/ferment corkage-history          — View all shared wisdom

/ferment label <id>               — Generate beautiful wine label
/ferment labels                   — View all generated labels
/ferment export-collection [fmt]  — Export Library (md/json/html)

The Library Collection

The cellar's crown jewels — not just aged ideas, but the best aged ideas, systematically preserved for posterity.

What qualifies for the Library:
| Criterion | Threshold | Weight |
|-----------|-----------|--------|
| Depth score | ≥ 3.0 | 25
| Vintage status | 90+ days | 20
| Cross-links | ≥ 5 | 20
| References | ≥ 3 | 15
| Appellation | Premier/Grand Cru | 10
| Reserve status | marked | 10

Auto-curation: During heartbeats, ideas scoring 80

/ferment library

📚 THE LIBRARY COLLECTION
═══════════════════════════════════════════════════════════

   🏆 lib_001 — "Context is the soul of communication"
      Depth: 3.8 | Vintage: 127 days | Links: 7
      Curator's Note: "The insight that launched enriched-spawn"

   🏆 lib_002 — "Every autonomous system needs boundaries"
      Depth: 4.1 | Vintage: 98 days | Links: 5
      Curator's Note: "Foundation of the governance framework"

   📊 Collection Stats: 12 items | Avg depth: 3.6 | Oldest: 203 days

Library Tiers

TierSymbolCriteriaMeaning
Cellar Standard📕meets thresholdWorthy of preservation
Curator's Choice📗+ exceptional notePersonal significance
Cornerstone📘+ foundationalOthers build on this
Masterpiece📙+ rare convergencePerfect conditions

Corkage: Sharing Wisdom

Opening your best bottles to share with the world. Corkage transforms internal wisdom into external formats.

Tweet Format (280 chars):

/ferment corkage-tweet idea_abc

🐦 READY TO SHARE:
━━━━━━━━━━━━━━━━━

"Context isn't just data — it's the difference between
a tool and a collaborator. Every spawn without context
inheritance is a stranger doing your work."

📊 275/280 chars | Depth: 3.8 | Vintage: 127 days

Quote Format (for slides, cards, walls):

/ferment corkage-quote idea_abc

✨ QUOTABLE INSIGHT:
━━━━━━━━━━━━━━━━━━━

    "Context is the soul of communication.
     Without it, every message is a message
     in a bottle — hoping someone understands."

                    — From the Cellar, Jan 2026
                      Depth 3.8 | Grand Cru

Blog Format (expanded prose):

/ferment corkage-blog idea_abc

📝 BLOG DRAFT:
━━━━━━━━━━━━━━

# The Soul of Communication

[Hook paragraph expanding the core insight...]

[Context and examples from cross-linked ideas...]

[Practical application...]

[Closing with the distilled essence...]

📊 ~400 words | Sources: 3 cross-linked ideas

Gift Format (for sharing with others):

/ferment corkage-gift idea_abc "[email]"

🎁 WISDOM GIFT PREPARED:
━━━━━━━━━━━━━━━━━━━━━━━━

For: [email]
From: Your Knowledge Cellar

[Beautifully formatted insight with attribution]

📋 Copied to clipboard / Ready to send

Wine Labels

Generate beautiful labels for your best ideas — perfect for visual documentation or sharing.

/ferment label idea_abc

🏷️ WINE LABEL GENERATED:
━━━━━━━━━━━━━━━━━━━━━━━━

╭────────────────────────────────────╮
│                                    │
│  ☆ GRAND CRU ☆                   │
│                                    │
│  C O N T E X T                    │
│  I N H E R I T A N C E            │
│                                    │
│  "Every spawn needs its parent's  │
│   wisdom, not just its task."     │
│                                    │
│  ──────────────────────────────   │
│  Vintage: January 2026            │
│  Depth: 3.8 | Proof: 142          │
│  Terroir: night-high-deep-curious │
│  Appellation: Flow State Reserve  │
│                                    │
│  🍷 From the Cellar of [User]     │
╰────────────────────────────────────╯

📎 Saved to: [home-path]

Export Collection

Export your entire Library Collection in various formats:

/ferment export-collection md

📦 EXPORTED: library-collection.md
   Location: [home-path]
   Items: 12
   Format: Markdown with full metadata

Export Formats:
| Format | Use Case |
|--------|----------|
| `md` | Documentation, README files |
| `json` | Programmatic access, backup |
| `html` | Beautiful standalone page |
| `obsidian` | Obsidian-compatible with links |

Corkage History

Track what you've shared and when:

/ferment corkage-history

📤 CORKAGE HISTORY
━━━━━━━━━━━━━━━━━━

2026-02-01 09:15 — idea_abc → tweet (275 chars)
2026-01-28 14:30 — spirit_xyz → blog (412 words)
2026-01-25 18:00 — idea_def → gift to [email]

📊 Total shared: 23 | Tweets: 12 | Blogs: 5 | Gifts: 6

Sharing Philosophy

ActionPurpose
LibraryPreserve for yourself
CorkageShare with the world
LabelMake it beautiful
GiftShare personally
ExportBackup & documentation

Auto-Behaviors (v1.6)

During heartbeats:
- Scan for Library candidates (80
- Flag but don't auto-add (respect curation)
- Track sharing patterns (best times, formats)
- Suggest "ready to share" for untapped vintage ideas

Philosophy

A cellar that only stores is a museum. Wisdom gains meaning when shared. Corkage is the moment you decide your insight is ready for the world — whether as a tweet, a blog post, or a gift to a friend.

The Library Collection is your permanent record — the ideas that defined your thinking, preserved exactly as they were when they matured.

Age it well. Curate carefully. Share generously.

---

The Cellar Network (v1.7 — NEW)

Wisdom doesn't have to stay in one cellar. The Cellar Network enables trading wisdom between cellars — like wine estates exchanging their best vintages. Export packaged wisdom, import from other cellars, track provenance and attribution.

Commands

/ferment network-init <name>              — Initialize your cellar's network identity
/ferment network-profile                  — View your network profile
/ferment network-package [--theme X]      — Create a wisdom package for export
/ferment network-import <file> [--integrate]
                                         — Preview/import a wisdom package
/ferment network-shareable               — Find ideas ready to share
/ferment network-imports                 — View import history
/ferment network-exports                 — View export history
/ferment network-thanks <id> [rating]    — Send thanks for received wisdom
/ferment network-stats                   — Network statistics
/ferment network-report                  — Full network activity report

Your Cellar Profile

Every cellar in the network has an identity:

/ferment network-init "Philosophy Corner" --style focused --specialties "ai,ethics,systems"

🌐 NETWORK PROFILE CREATED
═══════════════════════════════════

   Name: Philosophy Corner
   ID: cellar_a1b2c3d4e5f6
   Style: focused
   Specialties: ai, ethics, systems

💡 Your cellar is now ready to share wisdom!

Profile Styles:
| Style | Character |
|-------|-----------|
| eclectic | Wide-ranging, diverse interests |
| focused | Deep expertise in specific domains |
| experimental | Cutting-edge, unconventional ideas |
| traditional | Time-tested, foundational insights |

Creating Wisdom Packages

Package your best ideas for sharing:

/ferment network-package --theme "agent-architecture"

📦 WISDOM PACKAGE CREATED
═══════════════════════════════════

   ID: pkg_20260201_a1b2c3
   Theme: agent-architecture
   Ideas: 5 | Spirits: 2
   Total Depth: 18.4

   📁 Saved to: [home-path]
   💡 Share this file to trade wisdom!

Auto-selection: Without specific IDs, packages include aged/vintage ideas above your share threshold (default: 3.0 depth).

Selective packaging:

/ferment network-package --ideas idea_abc,idea_xyz --spirits spirit_123 --theme "insights"

Importing Wisdom

When you receive a package from another cellar:

/ferment network-import [home-path]

📦 WISDOM PACKAGE PREVIEW
═══════════════════════════════════

   From: Deep Thoughts Cellar (cellar_9x8y7z...)
   Theme: distributed-systems
   Ideas: 8 | Spirits: 1
   Total Depth: 24.2

   Preview:
   • Context is the soul of agent communication...
   • Every autonomous system needs explicit boundaries...
   • Sub-agents without inherited context are strangers...

💡 Use 'network-import <file> --integrate' to add to your cellar

Integration: Adding `--integrate` imports the ideas with full attribution:
- Ideas prefixed with `[via Source Cellar]`
- Tagged with source information
- Inherit 70
- Source cellar added to your connections

Provenance Tracking

Imported wisdom carries its history:

json
{
  "provenance": [
    {"cellar_id": "cellar_abc", "cellar_name": "Original Thinker", "action": "created", "timestamp": "..."},
    {"cellar_id": "cellar_xyz", "cellar_name": "Philosophy Corner", "action": "imported", "timestamp": "..."}
  ]
}

If you re-export imported wisdom, the provenance chain extends — like wine passing through multiple estates.

Network Reputation

Your reputation grows through:
- Sharing quality wisdom (+reputation when others send thanks)
- Receiving feedback (high ratings boost score)
- Building connections (active trading networks)

Reputation Tiers:
| Score | Tier | Meaning |
|-------|------|---------|
| 90+ | legendary | Master curator, sought-after wisdom |
| 75-89 | renowned | Established, trusted source |
| 60-74 | established | Regular, reliable contributor |
| 40-59 | emerging | Growing presence |
| 0-39 | nascent | Just starting |

Finding Shareable Wisdom

/ferment network-shareable

📦 READY TO SHARE — 12 ideas
═══════════════════════════════════

   🍷 [vintage] idea_20260115_context...
      Context inheritance patterns...
      Depth: 4.2 | Share Score: 4.8

   🍷 [aged] idea_20260122_autonomy...
      Autonomous systems need boundaries...
      Depth: 3.5 | Share Score: 3.9

Share Score = depth + (cross-links × 0.2) — ideas with rich connections are more valuable to share.

Sending Thanks

Acknowledge received wisdom:

/ferment network-thanks import_20260201 4.5

🙏 Thanks sent for import_20260201
   Rating: ⭐⭐⭐⭐½

Thanks and ratings:
- Boost sender's reputation in your view
- Help you remember valuable sources
- Complete the wisdom exchange loop

Network Statistics

/ferment network-stats

🌐 NETWORK STATS
═══════════════════════════════════

   Cellar: Philosophy Corner (established)
   Shared: 23 | Received: 18
   Balance: +5
   Exports: 7 | Imports: 5
   Connections: 4
   Ready to share: 12 ideas

Balance: Positive = net contributor; Negative = net receiver. Both are fine — the goal is active exchange, not hoarding.

Philosophy

A cellar that never shares becomes stale. Wisdom flourishes through exchange — your insight might be the missing piece in someone else's understanding, and theirs might illuminate your blind spots.

The Cellar Network makes passive cross-linking social. Ideas don't just connect within your cellar — they connect across the network of all cellars, forming a distributed knowledge graph.

Share generously. Receive gracefully. Build connections.

---

The Auction House & Wine Futures (v1.8)

Like Christie's wine auctions and Bordeaux en primeur futures, the Auction House brings economic dynamics to idea trading. Value your ideas professionally, sell them at auction, or invest in promising ideas before they mature.

Professional Valuation

Every idea has value. The appraiser considers:

  • Base Value — From depth and age (1 point depth = 5 units)
  • Rarity Premium — Unique terroir, rare keywords, night ideas
  • Network Premium — Library inclusion, curator status
  • Volatility — How much the value might change (older = more stable)
/ferment valuate idea_abc

📊 VALUATION: idea_abc
═══════════════════════════════════

   Tier: Collectors Item
   Estimate: 35 - 42 - 55

   Base Value: 28.0
   Rarity Premium: +8.0
   Network Premium: +6.0
   Volatility: ±12%

   Notes: Stage: vintage, Age: 127d

Value Tiers:
| Tier | Value | Meaning |
|------|-------|---------|
| museum_piece | 100+ | Worth preserving forever |
| collectors_item | 50-99 | Rare and valuable |
| fine_vintage | 25-49 | Quality investment |
| everyday_quality | 10-24 | Good but accessible |
| table_wine | <10 | Simple pleasures |

Creating Auctions

Put your best ideas up for sale:

/ferment auction-create idea_abc --duration 24 --reserve 20 --start 10

🔨 AUCTION CREATED
═══════════════════════════════════

   ID: auction_20260202_abc123
   Item: idea - idea_abc
   Starting Bid: 10
   Reserve: 20
   Ends: 24.0h

💡 Share auction ID to receive bids!

Auction Settings:
- `--duration` — Hours until auction ends (default: 24)
- `--reserve` — Minimum price to sell (default: 0)
- `--start` — Starting bid (default: 1)
- `--title` — Custom auction title

Bidding

/ferment auction-bid auction_20260202_abc123 25

✋ BID PLACED
   Auction: auction_20260202_abc123
   Amount: 25
   Status: winning

Bid Rules:
- Must exceed current bid + increment
- Increment = 5
- Previous winning bid becomes "outbid"

Settlement

When auctions end:

/ferment auction-settle auction_20260202_abc123

🔨 AUCTION SETTLED
═══════════════════════════════════

   Status: SOLD
   Winner: cellar_xyz123...
   Price: 35

Outcomes:
- sold — Reserve met, winner receives item
- unsold — Reserve not met or no bids

Wine Futures (En Primeur)

Invest in ideas before they mature — like buying Bordeaux futures.

/ferment future-buy idea_fresh123 vintage

📈 FUTURES CONTRACT CREATED
═══════════════════════════════════

   ID: future_20260202_fresh...
   Idea: idea_fresh123
   Current Stage: young
   Target Stage: vintage
   Price Paid: 15
   Projected Value: 45
   Discount: 67%

💡 Contract delivers when idea reaches vintage!

How Futures Work:
1. You buy a "future" on a young idea
2. Pay upfront at a discount (risk premium)
3. When idea reaches target stage, contract delivers
4. You receive the mature idea (or its value)

Discount Formula:
- 15
- Young → Vintage = 3 stages = 45

Checking Futures

Monitor your pending contracts:

/ferment futures

📈 PENDING FUTURES — 3
═══════════════════════════════════

   📄 future_20260202_abc
      [young → vintage] idea_abc123
      Paid: 15 | Projected: 45
      Discount: 67%

Delivery Check

Periodically check if any futures are ready:

/ferment futures-check

📈 FUTURES DELIVERED — 1
═══════════════════════════════════

   📈 future_20260101_xyz
      Idea: idea_xyz
      Paid: 20 → Actual: 52
      P/L: +32 (160% ROI)

Profit/Loss Calculation:
- Actual value at delivery vs price paid
- ROI = (actual - paid) / paid
- `beat_projection` = actual > projected

Portfolio View

See your overall futures position:

/ferment portfolio

📊 FUTURES PORTFOLIO
═══════════════════════════════════

   Invested: 150
   Projected: 380
   Delivered: 210
   Expected ROI: 153%

   Pending: 5 | Delivered: 3

Auction House Statistics

/ferment auction-stats

🏛️ AUCTION HOUSE STATS
═══════════════════════════════════

   Active: 2 | Sold: 15 | Unsold: 3
   Total Volume: 1,234

   Futures Pending: 5 | Delivered: 8
   Valuations: 47

Commands Summary

# Valuation
/ferment valuate <id>           — Professional appraisal

# Auctions
/ferment auction-create <id>    — Create auction [--duration --reserve --start --title]
/ferment auction-bid <auc> <amt>— Place bid on auction
/ferment auction-settle <auc>   — Settle ended auction
/ferment auctions               — List active auctions
/ferment auction-history        — View past auctions

# Wine Futures
/ferment future-buy <id> [stage]— Buy futures contract (default: vintage)
/ferment futures                — View pending contracts
/ferment futures-check          — Settle deliverable futures
/ferment portfolio              — Portfolio summary

# Statistics
/ferment auction-stats          — Overall marketplace stats

Philosophy

Ideas have economic value. The Auction House makes this explicit — not to commodify wisdom, but to create incentives for quality curation. Good ideas attract investment. Bad ideas get filtered out.

Wine futures encourage long-term thinking. Instead of demanding immediate payoff, you invest in potential. Sometimes you win big; sometimes ideas don't develop as expected. That's the game.

Value quality. Invest in potential. Let markets curate.

---

Sediment Analysis & Racking (v1.9)

Like wine developing tartrate crystals and dead yeast as it ages, ideas accumulate sediment — the parts that don't hold up over time.

What Becomes Sediment?

CategoryExamples
Outdated ReferencesVersion numbers, "new" tools, deprecated APIs
Temporal Markers"Today", "this week", deadlines that passed
Context Dependencies"Assuming X", "when Y launches", "depends on Z"
Urgency Claims"ASAP", "urgent", priorities that faded

Sediment Analysis

Analyze an aged idea (7+ days) to separate:
- Clear Essence — The timeless insight that remains
- Sediment — What hasn't aged well
- Context Dependencies — Assumptions that may have shifted

bash
# Analyze sediment in an idea
ferment analyze-sediment <idea_id>

Output:
- Clarity Score (0-100
- Sediment Ratio —
- Outdated aspects — Specific markers detected
- Lessons — What we learn from what didn't last

Racking

Like racking wine from barrel to barrel, leaving sediment behind:

bash
# Rack an idea to boost depth
ferment rack <idea_id>

Effects:
- Depth bonus based on clarity score (up to +0.5)
- Clearer ideas benefit more from racking
- Sediment preserved for archaeology

Racking Candidates

Find ideas ready for racking:

bash
# Suggest rackable ideas (default: 30+ days old)
ferment suggest-rack [min_age_days]

Shows:
- Age and stage
- Clarity score (visual bar)
- Potential depth bonus

Sediment Archaeology

The sediment isn't waste — it's data. What tends to age poorly reveals patterns:

bash
# Full archaeology report
ferment sediment-report

# Dig for specific patterns
ferment sediment-dig [pattern]

Examples:

bash
ferment sediment-dig version    # Ideas with version dependencies
ferment sediment-dig deadline   # Ideas tied to passed deadlines
ferment sediment-dig assumption # Ideas with context assumptions

Archaeology Insights

Over time, sediment analysis reveals:
- What categories of ideas age best?
- What language patterns predict obsolescence?
- How do your timeless insights differ from context-bound plans?

Philosophy

Not all ideas are meant to be eternal. Some are brilliant for their moment — tactical responses to specific situations. The sediment system doesn't judge these as failures; it honors them as archaeology.

By studying what didn't last, we learn to craft ideas that do.

Time is the ultimate editor. Let it work.

---

Blending (v1.1)

Like creating a fine wine blend from different vintages, Fermentation Blends combine mature ideas into synthesized insights.

Requirements:
- At least 2 ideas at 'maturing' stage or older
- Ideas should share thematic keywords

What happens when you blend:
1. Combined keywords form new connection web
2. Blend gets 1.5× depth bonus from source average
3. Source ideas get link depth boost (+0.15)
4. Synthesis creates emergent insight

Blend suggestions find clusters of cross-linked mature ideas that share 4+ keywords — these are natural blend candidates.

Decanting extracts a blend's refined essence with serving recommendations.

---

Auto-Behaviors

During heartbeats, the fermentation daemon:
1. Ages all ideas (update depth scores)
2. Runs cross-linking (find new connections)
3. Promotes ideas that reach vintage status
4. Surfaces forgotten gems (aged but unreferenced)
5. Prepares daily sommelier brief (top 3 contextual recommendations)
6. NEW: Ages barreled spirits (+1 day per heartbeat cycle)
7. NEW: Suggests distillation when 3+ aged ideas cluster

Cross-Linking Algorithm

Connections form when:
- Keyword overlap exceeds threshold
- Semantic similarity detected
- Same project/topic domain
- Temporal proximity (entered cellar near each other)

Each cross-link adds +0.1 depth per connection (max +2.0 from links).

Integration

  • Dream Weaver: Bloomed dreams can be cellared for further aging
  • Memory Defrag: Fermented insights inform consolidation
  • Insight Archaeology: Vintage ideas are prime excavation targets
  • Heartbeat: Sommelier can surface relevant ideas proactively

Storage

[home-path]
├── inventory.json         # All cellared ideas
├── crosslinks.json        # Discovered connections
├── vintage.json           # Promoted vintage ideas
├── reserve.json           # Reserve collection
├── cellar-notes.json      # Tasting notes per idea
├── sommelier-state.json   # Context preferences
├── spirits.json           # Distilled spirits (v1.3)
├── stillage.json          # Distillation residue (v1.3)
├── cocktails.json         # Mixed cocktails history (v1.4)
├── recipes.json           # Cocktail recipes (v1.4)
├── terroirs.json          # Idea origin contexts (v1.5)
├── appellations.json      # Certified origin designations (v1.5)
├── eras.json              # Named vintage eras (v1.5)
├── library.json           # Library Collection crown jewels (v1.6)
├── corkage-history.json   # Sharing history (v1.6)
├── labels/                # Generated wine labels (v1.6)
├── exports/               # Exported collections (v1.6)
├── network-profile.json   # Cellar network identity (v1.7)
├── network-imports.json   # Import history (v1.7)
├── network-exports.json   # Export history (v1.7)
├── network/               # Wisdom packages for sharing (v1.7)
├── valuations.json        # Professional appraisals (NEW v1.8)
├── auctions.json          # Active and completed auctions (NEW v1.8)
├── bids.json              # Bid history (NEW v1.8)
├── futures.json           # Wine futures contracts (NEW v1.8)
├── marketplace/           # Marketplace exports (NEW v1.8)
├── oracle-predictions.json # Oracle predictions (v2.0)
├── oracle-patterns.json   # Discovered fermentation patterns (v2.0)
├── oracle-accuracy.json   # Prediction accuracy tracking (v2.0)
├── emergences.json        # Emerged meta-insights (NEW v2.2)
├── emergence-pending.json # Patterns approaching threshold (NEW v2.2)
├── emergence-history.json # Timeline and ripple effects (NEW v2.2)
├── emergence-config.json  # Thresholds and settings (NEW v2.2)
└── ferment.log            # Aging cycle logs

---

The Fermentation Oracle (v2.0)

The Oracle observes patterns humans miss. Through analysis of historical fermentation data, it forecasts which ideas will age best, learns from its prediction accuracy, and guides optimal cellaring strategy.

Commands

/ferment oracle-predict <id>  — Get fermentation forecast for an idea
/ferment oracle-check         — Verify past predictions, update accuracy
/ferment oracle-insights      — High-level patterns and meta-insights
/ferment oracle-forecast [days] — Cellar state prediction (default 90 days)
/ferment oracle-assess <text> — Pre-cellar assessment before adding idea

Oracle Predictions

For each idea, the Oracle predicts:

MetricDescription
Stage DepthsForecasted depth at young/maturing/aged/vintage
Vintage ProbabilityLikelihood of reaching vintage status (0-100
Library ProbabilityLikelihood of library collection worthiness
Distill WorthyPotential as spirit source material
Pattern SignalsWhich positive patterns the idea matches
Risk FactorsWhat might impede fermentation
Optimal AgingRecommended days before evaluation

Pattern Discovery

The Oracle learns from your cellar's history. It discovers patterns like:

  • Cross-Link Magnet — Ideas with 3+ connections tend to vintage
  • Evening Philosophy — Philosophical ideas born at night age well
  • Flow State Code — High-energy coding insights develop clarity
  • Multi-Domain Resonance — Cross-domain ideas gain richer depth

As more ideas pass through fermentation, patterns strengthen with evidence.

Risk Factor Detection

Before cellaring, the Oracle checks for:

  • sparse_keywords — Too few concepts for cross-linking
  • context_dependent — From ephemeral conversation context
  • temporal_references — Contains "today", "now", "recent"

Ideas with risks aren't rejected — they're flagged for attention.

Prediction Accuracy

The Oracle tracks its own performance:

/ferment oracle-check

🔮 ORACLE ACCURACY CHECK — 5 predictions
   ✅ idea_abc [vintage] — Predicted: 5.2, Actual: 4.9, Accuracy: 94%
   ⚠️ idea_def [aged] — Predicted: 3.8, Actual: 2.6, Accuracy: 68%

Accuracy feeds back into pattern confidence. Patterns that don't predict well lose weight; those that do gain credibility.

Pre-Cellar Assessment

Before adding an idea, get an Oracle read:

/ferment oracle-assess "Distributed systems benefit from eventual consistency"

🔮 PRE-CELLAR ASSESSMENT
   Potential: [████████░░] 80%

   🌟 Recommendation: CELLAR_PRIORITY
      High potential! Cellar immediately and monitor

   🔑 Keywords: distributed, systems, eventual, consistency
   ✨ Matching Patterns: Multi-Domain Resonance

Cellar Forecast

Look ahead to see what's coming:

/ferment oracle-forecast 90

🔮 CELLAR FORECAST — 90 days
   📈 Expected Depth Change: +45.3

   🍷 Will Reach Vintage (3):
      • idea_123 (in 42 days)
      • idea_456 (in 71 days)

   ⚠️ Ideas at Risk:
      • idea_789 (75d, depth: 1.8) — Low depth despite age

   🎯 Recommended Focus:
      • Monitor 5 maturing ideas approaching vintage
      • Cross-link 3 young ideas to boost potential

Oracle Philosophy

The Oracle doesn't replace your judgment — it augments it. Pattern recognition across hundreds of ideas reveals what intuition might miss. But ideas are not wine; some of the best insights defy prediction.

Use the Oracle as a guide, not a gatekeeper. Trust patterns, but leave room for surprise.

---

The Microbiome (v2.1 — NEW)

Like the microbial cultures that actually drive wine fermentation, The Microbiome is an invisible ecosystem of connection-agents that develop organically without explicit action. This is the engine of truly passive cross-linking.

Concept

When you add ideas to the cellar, you don't see the connections forming. Microbes are spawned in the background, sensing potential links between ideas. They grow slowly, and only when mature do they "surface" as visible cross-links.

Contrast with explicit crosslink:
- `crosslink` — Manual, immediate, you decide the connection
- Microbiome — Automatic, slow, connections emerge organically

Microbe Strains

Different types of microbes specialize in different connection types:

StrainDescriptionGrowth RateLink Strength
semanticKeyword and meaning overlap0.30/day0.40
temporalIdeas created close in time0.20/day0.25
contextualSimilar terroir/origin0.25/day0.35
emotionalSimilar emotional tone0.15/day0.30
proximityReferenced in same sessions0.35/day0.45
wildUnexpected emergent connections0.10/day0.60

Wild microbes grow slowly but create the strongest connections — they're the unexpected insights.

Microbe Lifecycle

     SPORE → GROWING → ACTIVE → MATURE → SURFACED
      0.0      0.2       0.5      0.8       1.0

1. Spawn — Microbe detects potential between two ideas
2. Grow — Strength increases daily based on strain + resonance
3. Surface — At 95
4. Die — Microbe's work is done (or it failed to grow)

Resonance

Microbes grow faster when ideas resonate:
- Keyword overlap
- Temporal proximity (created around same time)
- Same project/tags
- Similar stage

High resonance = faster growth = quicker surfacing.

Colonies

When 3+ microbes cluster around related ideas, they form a Colony:
- Colonies have collective vitality
- They can be cultivated (human-guided encouragement)
- Multiple microbes working together surface connections faster

Commands

/ferment microbiome-health        — View ecosystem health
/ferment microbiome-cycle         — Run growth cycle (call periodically!)
/ferment microbiome-peek [n]      — See active microbes
/ferment microbiome-colonies      — View formed colonies
/ferment microbiome-report        — Full ecosystem report
/ferment microbiome-cultivate <id> [notes]
                                  — Encourage a colony
/ferment microbiome-inoculate     — Spawn microbes for promising pairs

CLI Examples

bash
# Check ecosystem health
ferment microbiome-health

🦠 MICROBIOME HEALTH
══════════════════════════════════════════════════

   Health: [██████░░░░] 60% (healthy)

   📊 Population:
      Microbes: 12
      Colonies: 2 (1 thriving)
      Avg Strength: 0.45
      Diversity: 83%

   🧬 Strain Distribution:
      semantic: 5
      temporal: 3
      wild: 2
      proximity: 2
bash
# Run a growth cycle
ferment microbiome-cycle

🦠 Running microbiome cycle...

   ✅ Cycle Complete
      Grown: 12 microbes
      Surfaced: 1 connections
      Died: 0 microbes
      Colonies formed: 1
      New microbes spawned: 3

   🎉 Surfaced Connections:
      • [semantic] idea_abc123... ↔ idea_def456...
        Keywords: context, agents, spawn
bash
# Peek at what's developing
ferment microbiome-peek 5

🦠 MICROBIOME PEEK — 5 microbes
══════════════════════════════════════════════════

   SEMANTIC [████████░░] mature 🔔
   A: Sub-agents spawned via sessions_spawn...
   B: Every autonomous system needs explicit...
   Keywords: context, spawn, environment
   Age: 14.2d

   WILD [████░░░░░░] growing
   A: Code documentation enriched with prover...
   B: Music composition through visual symbol...
   Keywords: creative
   Age: 8.5d
bash
# Cultivate a promising colony
ferment microbiome-cultivate colony_abc123 "Focus on context inheritance patterns"

🌱 CULTIVATED: Context-Spawn Colony
   Vitality: 120%
   Members boosted: 4

Integration with Heartbeats

The microbiome works best with periodic cycles. Add to your heartbeat routine:

markdown
## Microbiome Maintenance
- [ ] Run `ferment microbiome-cycle` (grows all microbes)
- [ ] Check `ferment microbiome-health` for ecosystem status

Or integrate into crosslink cycles — microbiome cycles run automatically during `ferment crosslink`.

When to Cultivate

Cultivation is optional human guidance. Use it when:
- You see a colony forming around important ideas
- You want to encourage specific connection types
- Wild discoveries look promising

Cultivation boosts growth rate by 30

Microbiome Philosophy

Real fermentation isn't something you do — it's something you let happen. The Microbiome embodies this: connections develop in the dark, without your attention, surfacing only when ready.

You don't decide what connects. You create the conditions and wait.

Let the invisible do its work. Trust the ecosystem.

---

The Emergence Layer (v2.2 — NEW)

When enough passive connections form between ideas, something new crystallizes — not through human curation, but through genuine emergence. The Emergence Layer detects when connection density reaches critical mass and automatically surfaces meta-insights the cellar discovered on its own.

Concept

Contrast with Blending:
- Blending — You choose which ideas to combine (active)
- Emergence — The cellar identifies convergence patterns (passive)

Emergence happens when:
1. 4+ ideas become densely interconnected (via microbiome surfacing)
2. Connection density exceeds threshold (default: 0.7)
3. A common thread runs through all connected ideas
4. The pattern hasn't been explicitly blended before

Emergence Types

TypeDescriptionMin IdeasDensity Threshold
Cluster CrystallizationDense local group forms cohesive insight40.70
Bridge InsightSingle idea connects two distant clusters2 clusters0.60
Cascade PatternChain of connections reveals sequence50.65
Contradiction ResolutionOpposing ideas synthesize into higher truth20.80
Wild EmergenceUnexpected connection becomes central3+ wild links0.50

Commands

/ferment emergence-scan         — Scan for emergent patterns (run periodically)
/ferment emergences            — View all emerged insights
/ferment emergence <id>        — Deep-read an emergence with full context
/ferment emergence-pending     — View patterns approaching threshold
/ferment emergence-threshold [n] — Set/view density threshold (0.5-0.9)
/ferment emergence-history     — Timeline of emergences
/ferment emergence-lineage <id> — Trace which ideas contributed
/ferment emergence-ripple <id>  — See downstream effects of an emergence

CLI Examples

bash
# Scan for new emergences
ferment emergence-scan

🌟 EMERGENCE SCAN
══════════════════════════════════════════════════

   New Emergences: 1
   Approaching Threshold: 3

   ✨ EMERGED: emergence_20260202_a1b2c3
      Type: Cluster Crystallization
      Ideas: 5
      Density: 0.78

      "Autonomous systems need context inheritance,
       environmental boundaries, and explicit cleanup —
       these aren't separate concerns but a unified
       pattern of SITUATED AGENCY."

      Contributing Ideas:
      • idea_context... (Context is the soul...)
      • idea_boundary... (Every system needs boundaries...)
      • idea_cleanup... (Async patterns need explicit cleanup...)
      • idea_spawn... (Sub-agents without context...)
      • idea_env... (Environmental controls affect...)

   📊 APPROACHING (3):
      • [0.65/0.70] 4 ideas around "distributed cognition"
      • [0.62/0.70] 3 ideas around "emergence patterns"
      • [0.58/0.70] 4 ideas around "documentation-as-design"
bash
# View an emergence deeply
ferment emergence emergence_20260202_a1b2c3

🌟 EMERGENCE: Situated Agency Pattern
══════════════════════════════════════════════════

   Type: Cluster Crystallization
   Emerged: 2026-02-02 14:30:15
   Density: 0.78

   ╭────────────────────────────────────────────╮
   │                                            │
   │   "Situated Agency" — the pattern where    │
   │   autonomous components require:           │
   │                                            │
   │   1. Context inheritance (know where you   │
   │      came from)                            │
   │   2. Environmental boundaries (know your   │
   │      limits)                               │
   │   3. Explicit lifecycle (know when to end) │
   │                                            │
   │   Not three concerns, but ONE concern      │
   │   viewed from three angles.                │
   │                                            │
   ╰────────────────────────────────────────────╯

   📜 LINEAGE:
      idea_context (vintage, 127d) ─┬─> emergence
      idea_boundary (aged, 98d) ────┤
      idea_cleanup (maturing, 45d) ─┤
      idea_spawn (aged, 89d) ───────┤
      idea_env (vintage, 134d) ─────┘

   🔗 Key Microbes That Surfaced This:
      • [semantic] context ↔ spawn (strength: 0.92)
      • [contextual] boundary ↔ env (strength: 0.87)
      • [wild] cleanup ↔ context (strength: 0.71)

   💡 The wild microbe (cleanup ↔ context) was the
      catalyst — an unexpected connection that unified
      what seemed like separate concerns.

Emergence Anatomy

Each emergence contains:

ComponentDescription
SynthesisThe crystallized meta-insight (auto-generated)
Contributing IdeasThe ideas that converged
Density ScoreHow tightly connected the ideas are
Emergence TypeWhich pattern triggered it
CatalystThe connection that pushed over threshold
TimestampWhen it emerged

Auto-Synthesis

When an emergence is detected, the system auto-generates a synthesis by:

1. Extracting core keywords from all contributing ideas
2. Identifying the common thread (highest-overlap keywords)
3. Detecting the relationship pattern (unified, sequential, contrasting)
4. Generating a meta-insight that captures the convergence

Synthesis quality depends on:
- Idea depth (higher = better articulation)
- Microbe diversity (multiple strains = richer synthesis)
- Cluster coherence (tighter = clearer insight)

Emergence Ripples

Emergences affect the cellar:

bash
ferment emergence-ripple emergence_abc

🌊 RIPPLE EFFECTS: emergence_abc
══════════════════════════════════════════════════

   Direct Effects:
   • Contributing ideas: +0.3 depth (emergence bonus)
   • New tag "situated-agency" applied to 5 ideas
   • Cross-link strength boosted for cluster

   Downstream Effects:
   • 2 other ideas now connected to emergence cluster
   • 1 new microbe spawned (emergence ↔ new idea)
   • Oracle patterns updated with emergence data

   Meta Effect:
   • Emergence added to Library candidates (score: 87%)

Contradiction Resolution

A special emergence type when opposing ideas resolve:

🌟 CONTRADICTION RESOLUTION EMERGED

   Thesis:  "Tight coupling enables efficient systems"
   Antithesis: "Loose coupling enables resilient systems"

   ⚡ SYNTHESIS:
   "Coupling is a spectrum, not a binary. Efficient
    AND resilient systems use tight coupling within
    bounded contexts and loose coupling between them."

   Type: Contradiction Resolution
   Density: 0.83 (high-tension synthesis)

Pending Emergences

Ideas approaching critical mass:

bash
ferment emergence-pending

📊 APPROACHING EMERGENCE — 3 patterns
══════════════════════════════════════════════════

   [████████░░] 0.68/0.70 — "distributed cognition"
      Ideas: idea_swarm, idea_collective, idea_network, idea_consensus
      Needs: 1-2 more microbe surfaces
      Estimated: 3-5 days

   [███████░░░] 0.62/0.70 — "documentation as design"
      Ideas: idea_docs, idea_spec, idea_contract
      Needs: Stronger connections or 1 more idea
      Estimated: 7-10 days

   [██████░░░░] 0.58/0.70 — "emergence patterns"
      Ideas: idea_emerge, idea_crystal, idea_phase, idea_threshold
      Needs: Wild microbe catalyst likely required
      Estimated: Unknown (waiting for wild connection)

Cultivation & Interference

You can gently encourage pending emergences:

bash
# Encourage a pending emergence (subtle, respects organic process)
ferment emergence-encourage "distributed cognition"

🌱 Encouraging emergence around "distributed cognition"...
   • Spawned 2 additional microbes targeting cluster
   • Growth rate: +15% for existing connections

⚠️ Note: Over-cultivation can force unnatural synthesis.
   Let it emerge when ready.

But you cannot force emergence. If density doesn't naturally reach threshold, the insight isn't ready.

Emergence vs Blending

AspectBlendingEmergence
InitiationHuman selects ideasSystem detects pattern
TimingOn commandWhen threshold reached
ResultCombined essenceCrystallized meta-insight
ControlFullMinimal (can encourage)
SurpriseExpectedOften unexpected
QualityDepends on selectionDepends on organic growth

Use blending when you know what you want to combine.
Trust emergence when you don't know what the cellar knows.

Heartbeat Integration

Add to your heartbeat routine:

markdown
## Emergence Monitoring
- [ ] Run `ferment emergence-scan` (detect new patterns)
- [ ] Check `ferment emergence-pending` for approaching insights
- [ ] Review any new emergences for accuracy

Storage

[home-path]
├── emergences.json        # All emerged meta-insights
├── emergence-pending.json # Patterns approaching threshold
├── emergence-history.json # Timeline and ripple effects
└── emergence-config.json  # Thresholds and settings

Emergence Philosophy

Blending is curation. Emergence is discovery.

The most profound insights often come from connections we didn't make consciously — ideas that linked themselves while we weren't watching. The Emergence Layer honors this by stepping back and letting the cellar's invisible ecosystem do what ecosystems do: self-organize into something greater than the sum of parts.

You plant seeds. You create conditions. And sometimes, the garden surprises you.

Not all wisdom comes from thinking. Some comes from waiting.

---

Philosophy

Not all ideas need active attention. Some just need time. The fermentation system respects the natural pace of understanding — ideas that seem disconnected today may reveal deep connections after weeks of quiet rest.

The Sommelier ensures these aged insights aren't forgotten — the right idea, at the right moment, can change everything.

Let time do its work. Let wisdom surface when needed.

---

The Vineyard (v2.3 — NEW)

The cellar transforms ideas through time. But where do ideas come from?

The Vineyard moves upstream — a cultivation system where raw inspiration becomes plantable seeds, grows through seasons, and is harvested at the right moment for fermentation. Not all ideas should go straight to the cellar. Some need to grow first.

Commands

bash
# Planting
ferment plant <seed>            — Plant idea seed in active plot
ferment plant <seed> --plot <n> — Plant in specific terroir plot
ferment nursery                 — View seeds waiting to be planted
ferment seedling <id>           — Check on a growing seedling

# Plot Management
ferment plots                   — View all vineyard plots
ferment plot-create <name>      — Create new terroir plot
ferment plot-focus <name>       — Set active plot for planting
ferment plot-character <name>   — View plot's accumulated character

# Cultivation
ferment graft <scion> <root>    — Graft idea onto different root stock
ferment prune <id>              — Remove weak branch to strengthen core
ferment water <id>              — Give focused attention (boosts growth)
ferment sunlight <id>           — Expose to new contexts (broadens scope)
ferment trellis <id1> <id2>     — Support ideas growing together

# Seasons
ferment season                  — Current growing season + character
ferment season-history          — Past seasons and their yields
ferment season-transition       — Manually transition (careful!)

# Harvest
ferment ready                   — Ideas ready for harvest
ferment harvest <id>            — Move to cellar (ends growth phase)
ferment harvest-all             — Harvest everything ready
ferment vineyard-report         — Full vineyard status

Terroir Plots

Different ideas thrive in different soil. Terroir plots are conceptual domains where certain types of ideas grow best:

Plot NameCharacterBest For
`technical`Precise, structuredCode patterns, architecture ideas
`creative`Wild, associativeArt concepts, novel combinations
`philosophical`Deep, contemplativeEthics, meaning, meta-questions
`personal`Intimate, specificLife lessons, relationship insights
`strategic`Action-orientedPlans, decisions, tactics
`observational`Sensory, detailedThings noticed, patterns seen

Create custom plots for your domains:

bash
ferment plot-create linguistics --character "evolving, layered, cultural"

🌱 Created plot: linguistics
   Character: evolving, layered, cultural
   Soil type: Rich (high concept density expected)

The Growth Cycle

Ideas in the vineyard progress through stages:

SEED → SPROUT → SHOOT → VINE → MATURE → READY
  │       │       │      │       │        │
  └───────┴───────┴──────┴───────┴────────┘
              Growing Season
StageDurationDescription
Seed0-3dRaw inspiration, undefined potential
Sprout3-7dFirst differentiation, showing direction
Shoot7-14dRapid growth, forming structure
Vine14-30dEstablishing connections, branching
Mature30-60dFull development, strengthening
Ready60d+Optimal harvest window

Unlike cellar aging (passive), vineyard growth responds to attention:
- Watering accelerates growth
- Sunlight broadens the idea
- Pruning deepens focus
- Trellising creates relationships

Growing Seasons

The vineyard observes four seasons, each with different characteristics:

SeasonCharacterGrowth RateBest Actions
SpringGenerative, explosive1.5×Plant many seeds, accept wild ideas
SummerExpansive, connective1.2×Water frequently, trellis connections
AutumnSelective, harvesting0.8×Harvest ripe ideas, prune weak ones
WinterDormant, reflective0.5×Let vineyard rest, plan next season

Season transitions happen automatically every ~30 days, or you can observe natural markers:
- Spring: After a creative burst or new project
- Summer: Deep in productive flow
- Autumn: Approaching completion or deadline
- Winter: Between projects, resting periods

bash
ferment season

🍂 CURRENT SEASON: Autumn
═══════════════════════════════════════

   Duration: Day 18 of ~30
   Character: Selective, harvesting
   Growth rate: 0.8×

   Recommended actions:
   • Harvest mature ideas (15 ready)
   • Prune underdeveloped vines (7 candidates)
   • Review season's growth for lessons

   Ideas planted this season: 23
   Ideas harvested: 8
   Natural pruning: 3

Grafting

Grafting combines the root stock of one idea with the scion (growing part) of another:

bash
ferment graft "minimal API design" "N'Ko writing system"

🌿 GRAFT INITIATED
═══════════════════════════════════════

   Scion: "N'Ko writing system"
   Root stock: "minimal API design"

   Potential hybrid:
   "Minimal linguistic API — N'Ko-inspired
    interface design with inherent beauty
    and cultural depth"

   Growth prediction:
   • Compatibility: 67% (interesting tension)
   • Vigor: High (cross-domain energy)
   • Risk: May reject (very different domains)

   ⚠️ Grafts need extra care. Water weekly.

Why graft?
- Root stock provides stability and nutrients (foundational concepts)
- Scion provides the fruit (innovative expression)
- Cross-domain grafts often yield the most interesting hybrids

Pruning

Ideas that aren't developing well drain energy from the vineyard. Pruning removes weak branches:

bash
ferment prune idea_weak

✂️ PRUNING: idea_weak
═══════════════════════════════════════

   Original: "Something about async patterns maybe"
   Stage: Sprout (stalled for 14 days)
   Connections: 0
   Growth rate: 0.1×

   Diagnosis: Unclear core, no natural connections

   Options:
   1. Prune completely (return energy to soil)
   2. Cut back to essence (attempt salvage)
   3. Graft onto stronger root stock

   > Pruning completely...

   ♻️ Nutrients returned to plot: technical
   📊 Plot fertility: +0.05

Pruning isn't failure — it's recognizing what won't bear fruit. The nutrients return to the soil.

Harvest Timing

Harvest too early: Idea underdeveloped, will age poorly in cellar
Harvest too late: Idea overripe, may have peaked in vineyard

bash
ferment ready

🍇 READY FOR HARVEST — 5 ideas
═══════════════════════════════════════

   ⭐ vine_semantic (Mature, 47d)
      "Semantic layers should be domain-agnostic"
      Plot: technical
      Connections: 4
      Ripeness: 92% — PEAK HARVEST WINDOW

   ● vine_patience (Mature, 52d)
      "Patience isn't waiting, it's trusting the process"
      Plot: philosophical
      Connections: 2
      Ripeness: 88% — Ready

   ○ vine_grafted_nko (Vine, 38d)
      "Minimal linguistic API with cultural depth"
      Plot: creative
      Connections: 3
      Ripeness: 71% — Approaching (7-10 days)

   ⚠️ vine_overripe (Mature, 89d)
      "Old insight about X"
      Ripeness: 97% — Harvest soon or quality declines

Harvest → Cellar Transition

When you harvest, the idea enters the cellar with vineyard bonuses:

bash
ferment harvest vine_semantic

🍷 HARVESTING: vine_semantic
═══════════════════════════════════════

   Vineyard journey:
   • Planted: 47 days ago (Spring)
   • Plot: technical
   • Grafts: None
   • Times watered: 6
   • Times pruned: 1 (focused the idea)

   Entering cellar as:
   • Stage: Young (with vineyard bonus)
   • Initial depth: 1.8× (vs 1.0× for raw add)
   • Pre-established connections: 4
   • Terroir tag: "technical-spring-cultivated"

   ✨ Vineyard-grown ideas age faster and
      connect richer in the cellar.

The Nursery

Not every thought is ready to plant. The Nursery holds seeds that need more definition:

bash
ferment nursery

🌱 NURSERY — 12 seeds waiting
═══════════════════════════════════════

   Recent (< 3 days):
   • "Something about emergent protocols"
   • "Why does X feel different than Y"
   • "Connection between music and code"

   Aging (3-7 days):
   • "That pattern I keep seeing"
   • "What's the core of elegance?"

   Stale (> 7 days):
   ⚠️ These should be planted or discarded
   • "Vague idea from last week"
   • "Untitled thought"

   Actions:
   • ferment plant <seed> — Move to vineyard
   • ferment discard <seed> — Release back to nothing
   • ferment refine <seed> — Add more definition

Vineyard Health

bash
ferment vineyard-report

🍇 VINEYARD HEALTH REPORT
═══════════════════════════════════════

   PLOTS (5 active)
   ├── technical: 12 vines, fertility 0.85
   ├── creative: 8 vines, fertility 0.92
   ├── philosophical: 5 vines, fertility 0.78
   ├── personal: 3 vines, fertility 0.65
   └── linguistics: 2 vines, fertility 0.90

   SEASON: Autumn (day 18)

   GROWTH STATS
   • Seeds planted this season: 23
   • Currently growing: 30
   • Ready for harvest: 5
   • Pruned/discarded: 4

   RECOMMENDATIONS
   • 🍇 Harvest 5 ready vines before winter
   • ✂️ Consider pruning 3 stalled vines
   • 💧 vine_creative_123 needs attention
   • 🌱 technical plot is getting crowded

   SEASON PROJECTION
   • Expected harvests before winter: 8-12
   • Vines likely to winter over: 15
   • Plot readiness for spring: Good

Cellar ↔ Vineyard Flow

Ideas can flow in both directions:

                 ┌──────────────┐
   Raw thought → │   NURSERY    │ ← Fleeting ideas
                 └──────┬───────┘
                        │ plant
                        ▼
                 ┌──────────────┐
                 │   VINEYARD   │ ← Cultivation
                 │  (growing)   │
                 └──────┬───────┘
                        │ harvest
                        ▼
                 ┌──────────────┐
                 │    CELLAR    │ ← Aging
                 │  (fermenting)│
                 └──────────────┘
                        │
                   emergence / blend / distill
                        │
                        ▼
                 ┌──────────────┐
                 │   LIBRARY    │ ← Wisdom
                 └──────────────┘

But also:
- Cellar ideas that need more development can be "replanted"
- Emerged insights can spawn new vineyard seeds
- Library items can inspire new plantings

Storage

[home-path]
├── vineyard/
│   ├── plots.json           # All terroir plots
│   ├── vines.json           # Growing ideas
│   ├── nursery.json         # Seeds waiting to plant
│   ├── seasons.json         # Season history
│   ├── grafts.json          # Graft records
│   └── harvest-history.json # Harvest timeline

Heartbeat Integration

Add vineyard checks to your routine:

markdown
## Vineyard Cultivation
- [ ] Check `ferment season` for current conditions
- [ ] Review `ferment ready` for harvest opportunities
- [ ] Water any ideas you've been thinking about
- [ ] Prune stalled vines in Autumn
- [ ] Plant new seeds in Spring (be generous)

Vineyard Philosophy

The cellar is patient — ideas enter and time does its work.

The vineyard is active care — ideas need attention to grow. Not every thought should go straight to aging. Some need cultivation first: definition, connection, pruning, strengthening.

The wine metaphor completes:
- Vineyard: Where grapes (ideas) grow through seasons
- Harvest: Selecting what's ready for transformation
- Cellar: Where fermentation and aging happen
- Library: Where the finest bottles are kept

You can't make great wine from poor grapes. Cultivation matters.

Plant with intention. Grow with care. Harvest with wisdom.

Promotion Decision

Attach run IDs, datasets, metrics, and reproduction commands.

Source Anchor

homelab/clawdbot/skills/knowledge-ferment/SKILL.md

Detected Structure

Method · Evaluation · References · Architecture