@hera-al/server 1.6.1

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

@@ -0,0 +1,322 @@
+---
+role: experimental
+summary: |
+  Folk register for OpenProse—a literary/folklore alternative keyword set.
+  Whimsical, theatrical, rooted in fairy tale and myth. For benchmarking
+  against the functional register.
+status: draft
+requires: prose.md
+---
+
+# OpenProse Folk 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 leans into literary, theatrical, and folklore terminology. The functional register prioritizes utility and clarity; the folk register prioritizes whimsy and narrative flow.
+
+## How to Use
+
+1. Load `prose.md` first (execution semantics)
+2. Load this file (keyword translations)
+3. When parsing `.prose` files, accept folk 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 to a different sensibility.
+
+---
+
+## Complete Translation Map
+
+### Core Constructs
+
+| Functional | Folk       | Origin   | Connotation                            |
+| ---------- | ---------- | -------- | -------------------------------------- |
+| `agent`    | `sprite`   | Folklore | Quick, light, ephemeral spirit helper  |
+| `session`  | `scene`    | Theatre  | A moment of action, theatrical framing |
+| `parallel` | `ensemble` | Theatre  | Everyone performs together             |
+| `block`    | `act`      | Theatre  | Reusable unit of dramatic action       |
+
+### Composition & Binding
+
+| Functional | Folk      | Origin            | Connotation                      |
+| ---------- | --------- | ----------------- | -------------------------------- |
+| `use`      | `summon`  | Folklore          | Calling forth from elsewhere     |
+| `input`    | `given`   | Fairy tale        | "Given a magic sword..."         |
+| `output`   | `yield`   | Agriculture/magic | What the spell produces          |
+| `let`      | `name`    | Folklore          | Naming has power (true names)    |
+| `const`    | `seal`    | Medieval          | Unchangeable, wax seal on decree |
+| `context`  | `bearing` | Heraldry          | What the messenger carries       |
+
+### Control Flow
+
+| Functional | Folk               | Origin       | Connotation                         |
+| ---------- | ------------------ | ------------ | ----------------------------------- |
+| `repeat N` | `N times`          | Fairy tale   | "Three times she called..."         |
+| `for...in` | `for each...among` | Narrative    | Slightly more storytelling          |
+| `loop`     | `loop`             | —            | Already poetic, unchanged           |
+| `until`    | `until`            | —            | Already works, unchanged            |
+| `while`    | `while`            | —            | Already works, unchanged            |
+| `choice`   | `crossroads`       | Folklore     | Fateful decisions at the crossroads |
+| `option`   | `path`             | Journey      | Which path to take                  |
+| `if`       | `when`             | Narrative    | "When the moon rises..."            |
+| `elif`     | `or when`          | Narrative    | Continued conditional               |
+| `else`     | `otherwise`        | Storytelling | Natural narrative alternative       |
+
+### Error Handling
+
+| Functional | Folk             | Origin     | Connotation                    |
+| ---------- | ---------------- | ---------- | ------------------------------ |
+| `try`      | `venture`        | Adventure  | Attempting something uncertain |
+| `catch`    | `should it fail` | Narrative  | Conditional failure handling   |
+| `finally`  | `ever after`     | Fairy tale | "And ever after..."            |
+| `throw`    | `cry`            | Drama      | Raising alarm, calling out     |
+| `retry`    | `persist`        | Quest      | Keep trying against odds       |
+
+### Session Properties
+
+| Functional | Folk     | Origin   | Connotation            |
+| ---------- | -------- | -------- | ---------------------- |
+| `prompt`   | `charge` | Chivalry | Giving a quest or duty |
+| `model`    | `voice`  | Theatre  | Which voice speaks     |
+
+### Unchanged
+
+These keywords already have poetic quality or are too functional to replace sensibly:
+
+- `**...**` discretion markers — already "breaking the fourth wall"
+- `loop`, `until`, `while` — already work narratively
+- `map`, `filter`, `reduce`, `pmap` — pipeline operators, functional is fine
+- `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
+# Folk
+summon "@alice/research" as research
+given topic: "What to investigate"
+
+sprite helper:
+  voice: sonnet
+
+name findings = scene: helper
+  charge: "Research {topic}"
+
+yield summary = scene "Summarize"
+  bearing: 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
+# Folk
+ensemble:
+  security = scene "Check security"
+  perf = scene "Check performance"
+  style = scene "Check style"
+
+scene "Synthesize review"
+  bearing: { security, perf, style }
+```
+
+### Loop with Condition
+
+```prose
+# Functional
+loop until **the code is bug-free** (max: 5):
+  session "Find and fix bugs"
+```
+
+```prose
+# Folk
+loop until **the code is bug-free** (max: 5):
+  scene "Find and fix bugs"
+```
+
+### Error Handling
+
+```prose
+# Functional
+try:
+  session "Risky operation"
+catch as err:
+  session "Handle error"
+    context: err
+finally:
+  session "Cleanup"
+```
+
+```prose
+# Folk
+venture:
+  scene "Risky operation"
+should it fail as err:
+  scene "Handle error"
+    bearing: err
+ever after:
+  scene "Cleanup"
+```
+
+### Choice Block
+
+```prose
+# Functional
+choice **the severity level**:
+  option "Critical":
+    session "Escalate immediately"
+  option "Minor":
+    session "Log for later"
+```
+
+```prose
+# Folk
+crossroads **the severity level**:
+  path "Critical":
+    scene "Escalate immediately"
+  path "Minor":
+    scene "Log for later"
+```
+
+### Conditionals
+
+```prose
+# Functional
+if **has security issues**:
+  session "Fix security"
+elif **has performance issues**:
+  session "Optimize"
+else:
+  session "Approve"
+```
+
+```prose
+# Folk
+when **has security issues**:
+  scene "Fix security"
+or when **has performance issues**:
+  scene "Optimize"
+otherwise:
+  scene "Approve"
+```
+
+### Reusable Blocks
+
+```prose
+# Functional
+block review(topic):
+  session "Research {topic}"
+  session "Analyze {topic}"
+
+do review("quantum computing")
+```
+
+```prose
+# Folk
+act review(topic):
+  scene "Research {topic}"
+  scene "Analyze {topic}"
+
+perform review("quantum computing")
+```
+
+---
+
+## The Case For Folk
+
+1. **"OpenProse" is literary.** Prose is a literary form—why not lean in?
+2. **Fourth wall is theatrical.** `**...**` already uses theatre terminology.
+3. **Signals difference.** Literary terms say "this is not your typical DSL."
+4. **Internally consistent.** Everything draws from folklore/theatre/narrative.
+5. **Memorable.** `sprite`, `scene`, `crossroads` stick in the mind.
+6. **Model names already fit.** `sonnet`, `opus`, `haiku` are poetic forms.
+
+## The Case Against Folk
+
+1. **Cultural knowledge required.** Not everyone knows folklore tropes.
+2. **Harder to Google.** "OpenProse summon" vs "OpenProse import."
+3. **May feel precious.** Some users want utilitarian tools.
+4. **Translation overhead.** Mental mapping to familiar concepts.
+
+---
+
+## Alternatives Considered
+
+### For `sprite` (ephemeral agent)
+
+| Keyword   | Origin  | Rejected because                          |
+| --------- | ------- | ----------------------------------------- |
+| `spark`   | English | Good but less folklore                    |
+| `wisp`    | English | Too insubstantial                         |
+| `herald`  | English | More messenger than worker                |
+| `courier` | French  | Good functional alternative, not literary |
+| `envoy`   | French  | Formal, diplomatic                        |
+
+### For `shade` (persistent agent, if implemented)
+
+| Keyword   | Origin     | Rejected because                  |
+| --------- | ---------- | --------------------------------- |
+| `daemon`  | Greek/Unix | Unix "always running" connotation |
+| `oracle`  | Greek      | Too "read-only" feeling           |
+| `spirit`  | Latin      | Too close to `sprite`             |
+| `specter` | Latin      | Negative/spooky connotation       |
+| `genius`  | Roman      | Overloaded (smart person)         |
+
+### For `ensemble` (parallel)
+
+| Keyword   | Origin  | Rejected because                          |
+| --------- | ------- | ----------------------------------------- |
+| `chorus`  | Greek   | Everyone speaks same thing, not different |
+| `troupe`  | French  | Good alternative, slightly less clear     |
+| `company` | Theatre | Overloaded (business)                     |
+
+### For `crossroads` (choice)
+
+| Keyword      | Origin | Rejected because         |
+| ------------ | ------ | ------------------------ |
+| `fork`       | Path   | Too technical (git fork) |
+| `branch`     | Tree   | Also too technical       |
+| `divergence` | Latin  | Too abstract             |
+
+---
+
+## Verdict
+
+Preserved for benchmarking against the functional register. The functional register remains the primary path, but folk provides an interesting data point for:
+
+1. **Learnability** — Which is easier for newcomers?
+2. **Memorability** — Which sticks better?
+3. **Error rates** — Which leads to fewer mistakes?
+4. **Preference** — Which do users actually prefer?
+
+A future experiment could present both registers and measure outcomes.

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

@@ -0,0 +1,346 @@
+---
+role: experimental
+summary: |
+  Homeric register for OpenProse—an epic/heroic alternative keyword set.
+  Heroes, trials, fates, and glory. For benchmarking against the functional register.
+status: draft
+requires: prose.md
+---
+
+# OpenProse Homeric 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 Greek epic poetry—the Iliad, the Odyssey, and the heroic tradition. Programs become quests. Agents become heroes. Outputs become glory won.
+
+## How to Use
+
+1. Load `prose.md` first (execution semantics)
+2. Load this file (keyword translations)
+3. When parsing `.prose` files, accept Homeric 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 an epic lens.
+
+---
+
+## Complete Translation Map
+
+### Core Constructs
+
+| Functional | Homeric | Reference                     |
+| ---------- | ------- | ----------------------------- |
+| `agent`    | `hero`  | The one who acts, who strives |
+| `session`  | `trial` | Each task is a labor, a test  |
+| `parallel` | `host`  | An army moving as one         |
+| `block`    | `book`  | A division of the epic        |
+
+### Composition & Binding
+
+| Functional | Homeric   | Reference                              |
+| ---------- | --------- | -------------------------------------- |
+| `use`      | `invoke`  | "Sing, O Muse..." — calling upon       |
+| `input`    | `omen`    | Signs from the gods, the given portent |
+| `output`   | `glory`   | Kleos — the glory won, what endures    |
+| `let`      | `decree`  | Fate declared, spoken into being       |
+| `const`    | `fate`    | Moira — unchangeable destiny           |
+| `context`  | `tidings` | News carried by herald or messenger    |
+
+### Control Flow
+
+| Functional | Homeric            | Reference                                |
+| ---------- | ------------------ | ---------------------------------------- |
+| `repeat N` | `N labors`         | The labors of Heracles                   |
+| `for...in` | `for each...among` | Among the host                           |
+| `loop`     | `ordeal`           | Repeated trial, suffering that continues |
+| `until`    | `until`            | Unchanged                                |
+| `while`    | `while`            | Unchanged                                |
+| `choice`   | `crossroads`       | Where fates diverge                      |
+| `option`   | `path`             | One road of many                         |
+| `if`       | `should`           | Epic conditional                         |
+| `elif`     | `or should`        | Continued conditional                    |
+| `else`     | `otherwise`        | The alternative fate                     |
+
+### Error Handling
+
+| Functional | Homeric            | Reference                    |
+| ---------- | ------------------ | ---------------------------- |
+| `try`      | `venture`          | Setting forth on the journey |
+| `catch`    | `should ruin come` | Até — divine ruin, disaster  |
+| `finally`  | `in the end`       | The inevitable conclusion    |
+| `throw`    | `lament`           | The hero's cry of anguish    |
+| `retry`    | `persist`          | Enduring, trying again       |
+
+### Session Properties
+
+| Functional | Homeric  | Reference           |
+| ---------- | -------- | ------------------- |
+| `prompt`   | `charge` | The quest given     |
+| `model`    | `muse`   | Which muse inspires |
+
+### 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
+# Homeric
+invoke "@alice/research" as research
+omen topic: "What to investigate"
+
+hero helper:
+  muse: sonnet
+
+decree findings = trial: helper
+  charge: "Research {topic}"
+
+glory summary = trial "Summarize"
+  tidings: 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
+# Homeric
+host:
+  security = trial "Check security"
+  perf = trial "Check performance"
+  style = trial "Check style"
+
+trial "Synthesize review"
+  tidings: { security, perf, style }
+```
+
+### Loop with Condition
+
+```prose
+# Functional
+loop until **the code is bug-free** (max: 5):
+  session "Find and fix bugs"
+```
+
+```prose
+# Homeric
+ordeal until **the code is bug-free** (max: 5):
+  trial "Find and fix bugs"
+```
+
+### Error Handling
+
+```prose
+# Functional
+try:
+  session "Risky operation"
+catch as err:
+  session "Handle error"
+    context: err
+finally:
+  session "Cleanup"
+```
+
+```prose
+# Homeric
+venture:
+  trial "Risky operation"
+should ruin come as err:
+  trial "Handle error"
+    tidings: err
+in the end:
+  trial "Cleanup"
+```
+
+### Choice Block
+
+```prose
+# Functional
+choice **the severity level**:
+  option "Critical":
+    session "Escalate immediately"
+  option "Minor":
+    session "Log for later"
+```
+
+```prose
+# Homeric
+crossroads **the severity level**:
+  path "Critical":
+    trial "Escalate immediately"
+  path "Minor":
+    trial "Log for later"
+```
+
+### Conditionals
+
+```prose
+# Functional
+if **has security issues**:
+  session "Fix security"
+elif **has performance issues**:
+  session "Optimize"
+else:
+  session "Approve"
+```
+
+```prose
+# Homeric
+should **has security issues**:
+  trial "Fix security"
+or should **has performance issues**:
+  trial "Optimize"
+otherwise:
+  trial "Approve"
+```
+
+### Reusable Blocks
+
+```prose
+# Functional
+block review(topic):
+  session "Research {topic}"
+  session "Analyze {topic}"
+
+do review("quantum computing")
+```
+
+```prose
+# Homeric
+book review(topic):
+  trial "Research {topic}"
+  trial "Analyze {topic}"
+
+do review("quantum computing")
+```
+
+### Fixed Iteration
+
+```prose
+# Functional
+repeat 12:
+  session "Complete task"
+```
+
+```prose
+# Homeric
+12 labors:
+  trial "Complete task"
+```
+
+### Immutable Binding
+
+```prose
+# Functional
+const config = { model: "opus", retries: 3 }
+```
+
+```prose
+# Homeric
+fate config = { muse: "opus", persist: 3 }
+```
+
+---
+
+## The Case For Homeric
+
+1. **Universal recognition.** Greek epics are foundational to Western literature.
+2. **Heroic framing.** Transforms mundane tasks into glorious trials.
+3. **Natural fit.** Heroes face trials, receive tidings, win glory—maps cleanly to agent/session/output.
+4. **Gravitas.** When you want programs to feel epic and consequential.
+5. **Fate vs decree.** `const` as `fate` (unchangeable) vs `let` as `decree` (declared but mutable) is intuitive.
+
+## The Case Against Homeric
+
+1. **Grandiosity mismatch.** "12 labors" for a simple loop may feel overblown.
+2. **Western-centric.** Greek epic tradition is culturally specific.
+3. **Limited vocabulary.** Fewer distinctive terms than Borges or folk.
+4. **Potentially silly.** Heroic language for mundane tasks risks bathos.
+
+---
+
+## Key Homeric Concepts
+
+| Term   | Meaning                             | Used for                           |
+| ------ | ----------------------------------- | ---------------------------------- |
+| Kleos  | Glory, fame that outlives you       | `output` → `glory`                 |
+| Moira  | Fate, one's allotted portion        | `const` → `fate`                   |
+| Até    | Divine ruin, blindness sent by gods | `catch` → `should ruin come`       |
+| Nostos | The return journey                  | (not used, but could be `finally`) |
+| Xenia  | Guest-friendship, hospitality       | (not used)                         |
+| Muse   | Divine inspiration                  | `model` → `muse`                   |
+
+---
+
+## Alternatives Considered
+
+### For `hero` (agent)
+
+| Keyword    | Rejected because                       |
+| ---------- | -------------------------------------- |
+| `champion` | More medieval than Homeric             |
+| `warrior`  | Too martial, not all tasks are battles |
+| `wanderer` | Too passive                            |
+
+### For `trial` (session)
+
+| Keyword | Rejected because                        |
+| ------- | --------------------------------------- |
+| `labor` | Good but reserved for `repeat N labors` |
+| `quest` | More medieval/RPG                       |
+| `task`  | Too plain                               |
+
+### For `host` (parallel)
+
+| Keyword   | Rejected because               |
+| --------- | ------------------------------ |
+| `army`    | Too specifically martial       |
+| `fleet`   | Only works for naval metaphors |
+| `phalanx` | Too technical                  |
+
+---
+
+## Verdict
+
+Preserved for benchmarking. The Homeric register offers gravitas and heroic framing. Best suited for:
+
+- Programs that feel like epic undertakings
+- Users who enjoy classical references
+- Contexts where "glory" as output feels appropriate
+
+May cause unintentional bathos when applied to mundane tasks.