loudmouth-ai 0.1.0 → 0.2.0

package/extensions/open-prose/skills/prose/alt-borges.md

@@ -1,141 +0,0 @@
----
-role: experimental
-summary: |
-  Borges-inspired alternative keywords for OpenProse. A "what if" exploration drawing
-  from The Library of Babel, Garden of Forking Paths, Circular Ruins, and other works.
-  Not for implementation—just capturing ideas.
-status: draft
----
-
-# OpenProse Borges Alternative
-
-A potential alternative register for OpenProse that draws from Jorge Luis Borges's literary universe: infinite libraries, forking paths, circular dreams, and metaphysical labyrinths. Preserved for future benchmarking against the functional language.
-
-## Keyword Translations
-
-### Agents & Persistence
-
-| Functional | Borges      | Connotation                                                                      |
-| ---------- | ----------- | -------------------------------------------------------------------------------- |
-| `agent`    | `dreamer`   | Ephemeral, created for a purpose (Circular Ruins: dreamed into existence)        |
-| `keeper`   | `librarian` | Persistent, remembers, catalogs (Library of Babel: keeper of infinite knowledge) |
-
-```prose
-# Functional
-agent executor:
-  model: sonnet
-
-keeper captain:
-  model: opus
-
-# Borges
-dreamer executor:
-  model: sonnet
-
-librarian captain:
-  model: opus
-```
-
-### Other Potential Translations
-
-| Functional | Borges     | Notes                                                |
-| ---------- | ---------- | ---------------------------------------------------- |
-| `session`  | `garden`   | Garden of Forking Paths: space of possibilities      |
-| `parallel` | `fork`     | Garden of Forking Paths: diverging timelines         |
-| `block`    | `hexagon`  | Library of Babel: unit of space/knowledge            |
-| `loop`     | `circular` | Circular Ruins: recursive, self-referential          |
-| `choice`   | `path`     | Garden of Forking Paths: choosing a branch           |
-| `context`  | `aleph`    | The Aleph: point containing all points (all context) |
-
-### Invocation Patterns
-
-```prose
-# Functional
-session: executor
-  prompt: "Do task"
-
-captain "Review this"
-  context: work
-
-# Borges
-garden: dreamer executor
-  prompt: "Do task"
-
-captain "Review this"    # librarian invocation (same pattern)
-  aleph: work
-```
-
-## Alternative Persistent Keywords Considered
-
-| Keyword     | Origin           | Connotation                   | Rejected because                     |
-| ----------- | ---------------- | ----------------------------- | ------------------------------------ |
-| `keeper`    | Library of Babel | Maintains order               | Too generic                          |
-| `cataloger` | Library of Babel | Organizes knowledge           | Too long, awkward                    |
-| `archivist` | General          | Preserves records             | Good but less Borgesian              |
-| `mirror`    | Various          | Reflects, persists            | Too passive, confusing               |
-| `book`      | Library of Babel | Contains knowledge            | Too concrete, conflicts with prose   |
-| `hexagon`   | Library of Babel | Unit of space                 | Better for blocks                    |
-| `librarian` | Library of Babel | Keeper of infinite knowledge  | **Selected**                         |
-| `tlonist`   | Tlön             | Inhabitant of imaginary world | Too obscure, requires deep knowledge |
-
-## Alternative Ephemeral Keywords Considered
-
-| Keyword      | Origin                  | Connotation              | Rejected because                     |
-| ------------ | ----------------------- | ------------------------ | ------------------------------------ |
-| `dreamer`    | Circular Ruins          | Created by dreaming      | **Selected**                         |
-| `dream`      | Circular Ruins          | Ephemeral creation       | Too abstract, noun vs verb confusion |
-| `phantom`    | Various                 | Ephemeral, insubstantial | Too negative/spooky                  |
-| `reflection` | Various                 | Mirror image             | Too passive                          |
-| `fork`       | Garden of Forking Paths | Diverging path           | Better for parallel                  |
-| `visitor`    | Library of Babel        | Temporary presence       | Too passive                          |
-| `seeker`     | Library of Babel        | Searching for knowledge  | Good but less ephemeral              |
-| `wanderer`   | Labyrinths              | Temporary explorer       | Good but less precise                |
-
-## The Case For Borges
-
-1. **Infinite recursion**: Borges's themes align with computational recursion (`circular`, `fork`)
-2. **Metaphysical precision**: Concepts like `aleph` (all context) are philosophically rich
-3. **Library metaphor**: `librarian` perfectly captures persistent knowledge
-4. **Forking paths**: `fork` / `path` naturally express parallel execution and choice
-5. **Dream logic**: `dreamer` suggests creation and ephemerality
-6. **Literary coherence**: All terms come from a unified literary universe
-7. **Self-reference**: Borges loved self-reference; fits programming's recursive nature
-
-## The Case Against Borges
-
-1. **Cultural barrier**: Requires deep familiarity with Borges's works
-2. **Abstractness**: `aleph`, `hexagon` may be too abstract for practical use
-3. **Overload**: `fork` could confuse (Unix fork vs. path fork)
-4. **Register mismatch**: Rest of language is functional (`session`, `parallel`, `loop`)
-5. **Accessibility**: Violates "self-evident" tenet for most users
-6. **Noun confusion**: `garden` as a verb-like construct might be awkward
-7. **Translation burden**: Non-English speakers may not know Borges
-
-## Borgesian Concepts Not Used (But Considered)
-
-| Concept     | Work                   | Why Not Used                           |
-| ----------- | ---------------------- | -------------------------------------- |
-| `mirror`    | Various                | Too passive, confusing with reflection |
-| `labyrinth` | Labyrinths             | Too complex, suggests confusion        |
-| `tlon`      | Tlön                   | Too obscure, entire imaginary world    |
-| `book`      | Library of Babel       | Conflicts with "prose"                 |
-| `sand`      | Book of Sand           | Too abstract, infinite but ephemeral   |
-| `zahir`     | The Zahir              | Obsessive, single-minded (too narrow)  |
-| `lottery`   | The Lottery in Babylon | Randomness (not needed)                |
-| `ruins`     | Circular Ruins         | Too negative, suggests decay           |
-
-## Verdict
-
-Preserved for benchmarking. The functional language (`agent` / `keeper`) is the primary path for now. Borges offers rich metaphors but at the cost of accessibility and self-evidence.
-
-## Notes on Borges's Influence
-
-Borges's work anticipates many computational concepts:
-
-- **Infinite recursion**: Circular Ruins, Library of Babel
-- **Parallel universes**: Garden of Forking Paths
-- **Self-reference**: Many stories contain themselves
-- **Information theory**: Library of Babel as infinite information space
-- **Combinatorics**: All possible books in the Library
-
-This alternative honors that connection while recognizing it may be too esoteric for practical use.

package/extensions/open-prose/skills/prose/alts/arabian-nights.md

@@ -1,358 +0,0 @@
----
-role: experimental
-summary: |
-  Arabian Nights register for OpenProse—a narrative/nested alternative keyword set.
-  Djinns, tales within tales, wishes, and oaths. For benchmarking against the functional register.
-status: draft
-requires: prose.md
----
-
-# OpenProse Arabian Nights Register
-
-> **This is a skin layer.** It requires `prose.md` to be loaded first. All execution semantics, state management, and VM behavior are defined there. This file only provides keyword translations.
-
-An alternative register for OpenProse that draws from One Thousand and One Nights. Programs become tales told by Scheherazade. Recursion becomes stories within stories. Agents become djinns bound to serve.
-
-## How to Use
-
-1. Load `prose.md` first (execution semantics)
-2. Load this file (keyword translations)
-3. When parsing `.prose` files, accept Arabian Nights keywords as aliases for functional keywords
-4. All execution behavior remains identical—only surface syntax changes
-
-> **Design constraint:** Still aims to be "structured but self-evident" per the language tenets—just self-evident through a storytelling lens.
-
----
-
-## Complete Translation Map
-
-### Core Constructs
-
-| Functional | Nights | Reference |
-|------------|--------|-----------|
-| `agent` | `djinn` | Spirit bound to serve, grants wishes |
-| `session` | `tale` | A story told, a narrative unit |
-| `parallel` | `bazaar` | Many voices, many stalls, all at once |
-| `block` | `frame` | A story that contains other stories |
-
-### Composition & Binding
-
-| Functional | Nights | Reference |
-|------------|--------|-----------|
-| `use` | `conjure` | Summoning from elsewhere |
-| `input` | `wish` | What is asked of the djinn |
-| `output` | `gift` | What is granted in return |
-| `let` | `name` | Naming has power (same as folk) |
-| `const` | `oath` | Unbreakable vow, sealed |
-| `context` | `scroll` | What is written and passed along |
-
-### Control Flow
-
-| Functional | Nights | Reference |
-|------------|--------|-----------|
-| `repeat N` | `N nights` | "For a thousand and one nights..." |
-| `for...in` | `for each...among` | Among the merchants, among the tales |
-| `loop` | `telling` | The telling continues |
-| `until` | `until` | Unchanged |
-| `while` | `while` | Unchanged |
-| `choice` | `crossroads` | Where the story forks |
-| `option` | `path` | One way the story could go |
-| `if` | `should` | Narrative conditional |
-| `elif` | `or should` | Continued conditional |
-| `else` | `otherwise` | The other telling |
-
-### Error Handling
-
-| Functional | Nights | Reference |
-|------------|--------|-----------|
-| `try` | `venture` | Setting out on the journey |
-| `catch` | `should misfortune strike` | The tale turns dark |
-| `finally` | `and so it was` | The inevitable ending |
-| `throw` | `curse` | Ill fate pronounced |
-| `retry` | `persist` | The hero tries again |
-
-### Session Properties
-
-| Functional | Nights | Reference |
-|------------|--------|-----------|
-| `prompt` | `command` | What is commanded of the djinn |
-| `model` | `spirit` | Which spirit answers |
-
-### Unchanged
-
-These keywords already work or are too functional to replace sensibly:
-
-- `**...**` discretion markers — already work
-- `until`, `while` — already work
-- `map`, `filter`, `reduce`, `pmap` — pipeline operators
-- `max` — constraint modifier
-- `as` — aliasing
-- Model names: `sonnet`, `opus`, `haiku` — already poetic
-
----
-
-## Side-by-Side Comparison
-
-### Simple Program
-
-```prose
-# Functional
-use "@alice/research" as research
-input topic: "What to investigate"
-
-agent helper:
-  model: sonnet
-
-let findings = session: helper
-  prompt: "Research {topic}"
-
-output summary = session "Summarize"
-  context: findings
-```
-
-```prose
-# Nights
-conjure "@alice/research" as research
-wish topic: "What to investigate"
-
-djinn helper:
-  spirit: sonnet
-
-name findings = tale: helper
-  command: "Research {topic}"
-
-gift summary = tale "Summarize"
-  scroll: findings
-```
-
-### Parallel Execution
-
-```prose
-# Functional
-parallel:
-  security = session "Check security"
-  perf = session "Check performance"
-  style = session "Check style"
-
-session "Synthesize review"
-  context: { security, perf, style }
-```
-
-```prose
-# Nights
-bazaar:
-  security = tale "Check security"
-  perf = tale "Check performance"
-  style = tale "Check style"
-
-tale "Synthesize review"
-  scroll: { security, perf, style }
-```
-
-### Loop with Condition
-
-```prose
-# Functional
-loop until **the code is bug-free** (max: 5):
-  session "Find and fix bugs"
-```
-
-```prose
-# Nights
-telling until **the code is bug-free** (max: 5):
-  tale "Find and fix bugs"
-```
-
-### Error Handling
-
-```prose
-# Functional
-try:
-  session "Risky operation"
-catch as err:
-  session "Handle error"
-    context: err
-finally:
-  session "Cleanup"
-```
-
-```prose
-# Nights
-venture:
-  tale "Risky operation"
-should misfortune strike as err:
-  tale "Handle error"
-    scroll: err
-and so it was:
-  tale "Cleanup"
-```
-
-### Choice Block
-
-```prose
-# Functional
-choice **the severity level**:
-  option "Critical":
-    session "Escalate immediately"
-  option "Minor":
-    session "Log for later"
-```
-
-```prose
-# Nights
-crossroads **the severity level**:
-  path "Critical":
-    tale "Escalate immediately"
-  path "Minor":
-    tale "Log for later"
-```
-
-### Conditionals
-
-```prose
-# Functional
-if **has security issues**:
-  session "Fix security"
-elif **has performance issues**:
-  session "Optimize"
-else:
-  session "Approve"
-```
-
-```prose
-# Nights
-should **has security issues**:
-  tale "Fix security"
-or should **has performance issues**:
-  tale "Optimize"
-otherwise:
-  tale "Approve"
-```
-
-### Reusable Blocks (Frame Stories)
-
-```prose
-# Functional
-block review(topic):
-  session "Research {topic}"
-  session "Analyze {topic}"
-
-do review("quantum computing")
-```
-
-```prose
-# Nights
-frame review(topic):
-  tale "Research {topic}"
-  tale "Analyze {topic}"
-
-tell review("quantum computing")
-```
-
-### Fixed Iteration
-
-```prose
-# Functional
-repeat 1001:
-  session "Tell a story"
-```
-
-```prose
-# Nights
-1001 nights:
-  tale "Tell a story"
-```
-
-### Immutable Binding
-
-```prose
-# Functional
-const config = { model: "opus", retries: 3 }
-```
-
-```prose
-# Nights
-oath config = { spirit: "opus", persist: 3 }
-```
-
----
-
-## The Case For Arabian Nights
-
-1. **Frame narrative is recursion.** Stories within stories maps perfectly to nested program calls.
-2. **Djinn/wish/gift.** The agent/input/output mapping is extremely clean.
-3. **Rich tradition.** One Thousand and One Nights is globally known.
-4. **Bazaar for parallel.** Many merchants, many stalls, all active at once—vivid metaphor.
-5. **Oath for const.** An unbreakable vow is a perfect metaphor for immutability.
-6. **"1001 nights"** as a loop count is delightful.
-
-## The Case Against Arabian Nights
-
-1. **Cultural sensitivity.** Must be handled respectfully, avoiding Orientalist tropes.
-2. **"Djinn" pronunciation.** Users unfamiliar may be uncertain (jinn? djinn? genie?).
-3. **Some mappings feel forced.** "Bazaar" for parallel is vivid but not obvious.
-4. **"Should misfortune strike"** is long for `catch`.
-
----
-
-## Key Arabian Nights Concepts
-
-| Term | Meaning | Used for |
-|------|---------|----------|
-| Scheherazade | The narrator who tells tales to survive | (the program author) |
-| Djinn | Supernatural spirit, bound to serve | `agent` → `djinn` |
-| Frame story | A story that contains other stories | `block` → `frame` |
-| Wish | What is asked of the djinn | `input` → `wish` |
-| Oath | Unbreakable promise | `const` → `oath` |
-| Bazaar | Marketplace, many vendors | `parallel` → `bazaar` |
-
----
-
-## Alternatives Considered
-
-### For `djinn` (agent)
-
-| Keyword | Rejected because |
-|---------|------------------|
-| `genie` | Disney connotation, less literary |
-| `spirit` | Used for `model` |
-| `ifrit` | Too specific (a type of djinn) |
-| `narrator` | Too meta, Scheherazade is the user |
-
-### For `tale` (session)
-
-| Keyword | Rejected because |
-|---------|------------------|
-| `story` | Good but `tale` feels more literary |
-| `night` | Reserved for `repeat N nights` |
-| `chapter` | More Western/novelistic |
-
-### For `bazaar` (parallel)
-
-| Keyword | Rejected because |
-|---------|------------------|
-| `caravan` | Sequential connotation (one after another) |
-| `chorus` | Greek, wrong tradition |
-| `souk` | Less widely known |
-
-### For `scroll` (context)
-
-| Keyword | Rejected because |
-|---------|------------------|
-| `letter` | Too small/personal |
-| `tome` | Too large |
-| `message` | Too plain |
-
----
-
-## Verdict
-
-Preserved for benchmarking. The Arabian Nights register offers a storytelling frame that maps naturally to recursive, nested programs. The djinn/wish/gift trio is particularly elegant.
-
-Best suited for:
-
-- Programs with deep nesting (stories within stories)
-- Workflows that feel like granting wishes
-- Users who enjoy narrative framing
-
-The `frame` keyword for reusable blocks is especially apt—Scheherazade's frame story containing a thousand tales.