@hera-al/server 1.6.1

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

@@ -0,0 +1,358 @@
+---
+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.

package/bundled/open-prose/skills/prose/alts/borges.md

@@ -0,0 +1,360 @@
+---
+role: experimental
+summary: |
+  Borges register for OpenProse—a scholarly/metaphysical alternative keyword set.
+  Labyrinths, dreamers, forking paths, and infinite libraries. For benchmarking
+  against the functional register.
+status: draft
+requires: prose.md
+---
+
+# OpenProse Borges 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 the works of Jorge Luis Borges. Where the functional register is utilitarian and the folk register is whimsical, the Borges register is scholarly and metaphysical—everything feels like a citation from a fictional encyclopedia.
+
+## How to Use
+
+1. Load `prose.md` first (execution semantics)
+2. Load this file (keyword translations)
+3. When parsing `.prose` files, accept Borges 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 Borgesian lens.
+
+---
+
+## Complete Translation Map
+
+### Core Constructs
+
+| Functional | Borges    | Reference                                                       |
+| ---------- | --------- | --------------------------------------------------------------- |
+| `agent`    | `dreamer` | "The Circular Ruins" — dreamers who dream worlds into existence |
+| `session`  | `dream`   | Each execution is a dream within the dreamer                    |
+| `parallel` | `forking` | "The Garden of Forking Paths" — branching timelines             |
+| `block`    | `chapter` | Books within books, self-referential structure                  |
+
+### Composition & Binding
+
+| Functional | Borges     | Reference                                                |
+| ---------- | ---------- | -------------------------------------------------------- |
+| `use`      | `retrieve` | "The Library of Babel" — retrieving from infinite stacks |
+| `input`    | `axiom`    | The given premise (Borges' scholarly/mathematical tone)  |
+| `output`   | `theorem`  | What is derived from the axioms                          |
+| `let`      | `inscribe` | Writing something into being                             |
+| `const`    | `zahir`    | "The Zahir" — unforgettable, unchangeable, fixed in mind |
+| `context`  | `memory`   | "Funes the Memorious" — perfect, total recall            |
+
+### Control Flow
+
+| Functional | Borges              | Reference                              |
+| ---------- | ------------------- | -------------------------------------- |
+| `repeat N` | `N mirrors`         | Infinite reflections facing each other |
+| `for...in` | `for each...within` | Slightly more Borgesian preposition    |
+| `loop`     | `labyrinth`         | The maze that folds back on itself     |
+| `until`    | `until`             | Unchanged                              |
+| `while`    | `while`             | Unchanged                              |
+| `choice`   | `bifurcation`       | The forking of paths                   |
+| `option`   | `branch`            | One branch of diverging time           |
+| `if`       | `should`            | Scholarly conditional                  |
+| `elif`     | `or should`         | Continued conditional                  |
+| `else`     | `otherwise`         | Natural alternative                    |
+
+### Error Handling
+
+| Functional | Borges       | Reference                              |
+| ---------- | ------------ | -------------------------------------- |
+| `try`      | `venture`    | Entering the labyrinth                 |
+| `catch`    | `lest`       | "Lest it fail..." (archaic, scholarly) |
+| `finally`  | `ultimately` | The inevitable conclusion              |
+| `throw`    | `shatter`    | Breaking the mirror, ending the dream  |
+| `retry`    | `recur`      | Infinite regress, trying again         |
+
+### Session Properties
+
+| Functional | Borges   | Reference                      |
+| ---------- | -------- | ------------------------------ |
+| `prompt`   | `query`  | Asking the Library             |
+| `model`    | `author` | Which author writes this dream |
+
+### Unchanged
+
+These keywords already work or are too functional to replace sensibly:
+
+- `**...**` discretion markers — already "breaking the fourth wall"
+- `until`, `while` — already work
+- `map`, `filter`, `reduce`, `pmap` — pipeline operators
+- `max` — constraint modifier
+- `as` — aliasing
+- Model names: `sonnet`, `opus`, `haiku` — already literary
+
+---
+
+## 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
+# Borges
+retrieve "@alice/research" as research
+axiom topic: "What to investigate"
+
+dreamer helper:
+  author: sonnet
+
+inscribe findings = dream: helper
+  query: "Research {topic}"
+
+theorem summary = dream "Summarize"
+  memory: 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
+# Borges
+forking:
+  security = dream "Check security"
+  perf = dream "Check performance"
+  style = dream "Check style"
+
+dream "Synthesize review"
+  memory: { security, perf, style }
+```
+
+### Loop with Condition
+
+```prose
+# Functional
+loop until **the code is bug-free** (max: 5):
+  session "Find and fix bugs"
+```
+
+```prose
+# Borges
+labyrinth until **the code is bug-free** (max: 5):
+  dream "Find and fix bugs"
+```
+
+### Error Handling
+
+```prose
+# Functional
+try:
+  session "Risky operation"
+catch as err:
+  session "Handle error"
+    context: err
+finally:
+  session "Cleanup"
+```
+
+```prose
+# Borges
+venture:
+  dream "Risky operation"
+lest as err:
+  dream "Handle error"
+    memory: err
+ultimately:
+  dream "Cleanup"
+```
+
+### Choice Block
+
+```prose
+# Functional
+choice **the severity level**:
+  option "Critical":
+    session "Escalate immediately"
+  option "Minor":
+    session "Log for later"
+```
+
+```prose
+# Borges
+bifurcation **the severity level**:
+  branch "Critical":
+    dream "Escalate immediately"
+  branch "Minor":
+    dream "Log for later"
+```
+
+### Conditionals
+
+```prose
+# Functional
+if **has security issues**:
+  session "Fix security"
+elif **has performance issues**:
+  session "Optimize"
+else:
+  session "Approve"
+```
+
+```prose
+# Borges
+should **has security issues**:
+  dream "Fix security"
+or should **has performance issues**:
+  dream "Optimize"
+otherwise:
+  dream "Approve"
+```
+
+### Reusable Blocks
+
+```prose
+# Functional
+block review(topic):
+  session "Research {topic}"
+  session "Analyze {topic}"
+
+do review("quantum computing")
+```
+
+```prose
+# Borges
+chapter review(topic):
+  dream "Research {topic}"
+  dream "Analyze {topic}"
+
+do review("quantum computing")
+```
+
+### Fixed Iteration
+
+```prose
+# Functional
+repeat 3:
+  session "Generate idea"
+```
+
+```prose
+# Borges
+3 mirrors:
+  dream "Generate idea"
+```
+
+### Immutable Binding
+
+```prose
+# Functional
+const config = { model: "opus", retries: 3 }
+```
+
+```prose
+# Borges
+zahir config = { author: "opus", recur: 3 }
+```
+
+---
+
+## The Case For Borges
+
+1. **Metaphysical resonance.** AI sessions dreaming subagents into existence mirrors "The Circular Ruins."
+2. **Scholarly tone.** `axiom`/`theorem` frame programs as logical derivations.
+3. **Memorable metaphors.** The zahir you cannot change. The labyrinth you cannot escape. The library you retrieve from.
+4. **Thematic coherence.** Borges wrote about infinity, recursion, and branching time—all core to computation.
+5. **Literary prestige.** Borges is widely read; references land for many users.
+
+## The Case Against Borges
+
+1. **Requires familiarity.** "Zahir" and "Funes" are obscure to those who haven't read Borges.
+2. **Potentially pretentious.** May feel like showing off rather than communicating.
+3. **Translation overhead.** Users must map `labyrinth` → `loop` mentally.
+4. **Cultural specificity.** Less universal than folk/fairy tale tropes.
+
+---
+
+## Key Borges References
+
+For those unfamiliar with the source material:
+
+| Work                          | Concept Used                       | Summary                                                                               |
+| ----------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------- |
+| "The Circular Ruins"          | `dreamer`, `dream`                 | A man dreams another man into existence, only to discover he himself is being dreamed |
+| "The Garden of Forking Paths" | `forking`, `bifurcation`, `branch` | A labyrinth that is a book; time forks perpetually into diverging futures             |
+| "The Library of Babel"        | `retrieve`                         | An infinite library containing every possible book                                    |
+| "Funes the Memorious"         | `memory`                           | A man with perfect memory who cannot forget anything                                  |
+| "The Zahir"                   | `zahir`                            | An object that, once seen, cannot be forgotten or ignored                             |
+| "The Aleph"                   | (not used)                         | A point in space containing all other points                                          |
+| "Tlön, Uqbar, Orbis Tertius"  | (not used)                         | A fictional world that gradually becomes real                                         |
+
+---
+
+## Alternatives Considered
+
+### For `dreamer` (agent)
+
+| Keyword     | Rejected because          |
+| ----------- | ------------------------- |
+| `author`    | Used for `model` instead  |
+| `scribe`    | Too passive, just records |
+| `librarian` | More curator than creator |
+
+### For `labyrinth` (loop)
+
+| Keyword          | Rejected because |
+| ---------------- | ---------------- |
+| `recursion`      | Too technical    |
+| `eternal return` | Too long         |
+| `ouroboros`      | Wrong mythology  |
+
+### For `zahir` (const)
+
+| Keyword   | Rejected because                              |
+| --------- | --------------------------------------------- |
+| `aleph`   | The Aleph is about totality, not immutability |
+| `fixed`   | Too plain                                     |
+| `eternal` | Overused                                      |
+
+### For `memory` (context)
+
+| Keyword   | Rejected because                  |
+| --------- | --------------------------------- |
+| `funes`   | Too obscure as standalone keyword |
+| `recall`  | Sounds like a function call       |
+| `archive` | More Library of Babel than Funes  |
+
+---
+
+## Verdict
+
+Preserved for benchmarking against the functional and folk registers. The Borges register offers a distinctly intellectual/metaphysical flavor that may resonate with users who appreciate literary computing.
+
+Potential benchmarking questions:
+
+1. **Learnability** — Is `labyrinth` intuitive for loops?
+2. **Memorability** — Does `zahir` stick better than `const`?
+3. **Comprehension** — Do users understand `dreamer`/`dream` immediately?
+4. **Preference** — Which register do users find most pleasant?
+5. **Error rates** — Does the metaphorical mapping cause mistakes?