mirror of
https://github.com/farcasclaudiu/openclaw.git
synced 2026-06-29 13:02:10 +03:00
chore: Also format scripts and skills.
This commit is contained in:
cpojer
@@ -28,55 +28,55 @@ An alternative register for OpenProse that draws from One Thousand and One Night
|
||||
|
||||
### Core Constructs
|
||||
|
||||
| Functional | Nights | Reference |
|
||||
|------------|--------|-----------|
|
||||
| `agent` | `djinn` | Spirit bound to serve, grants wishes |
|
||||
| `session` | `tale` | A story told, a narrative unit |
|
||||
| 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 |
|
||||
| `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 |
|
||||
| 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..." |
|
||||
| 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 |
|
||||
| `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 |
|
||||
| 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 |
|
||||
| Functional | Nights | Reference |
|
||||
| ---------- | --------- | ------------------------------ |
|
||||
| `prompt` | `command` | What is commanded of the djinn |
|
||||
| `model` | `spirit` | Which spirit answers |
|
||||
|
||||
### Unchanged
|
||||
|
||||
@@ -297,14 +297,14 @@ oath config = { spirit: "opus", persist: 3 }
|
||||
|
||||
## 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` |
|
||||
| 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` |
|
||||
|
||||
---
|
||||
|
||||
@@ -312,36 +312,36 @@ oath config = { spirit: "opus", persist: 3 }
|
||||
|
||||
### For `djinn` (agent)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| `genie` | Disney connotation, less literary |
|
||||
| `spirit` | Used for `model` |
|
||||
| `ifrit` | Too specific (a type of djinn) |
|
||||
| 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 |
|
||||
| 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 |
|
||||
|---------|------------------|
|
||||
| Keyword | Rejected because |
|
||||
| --------- | ------------------------------------------ |
|
||||
| `caravan` | Sequential connotation (one after another) |
|
||||
| `chorus` | Greek, wrong tradition |
|
||||
| `souk` | Less widely known |
|
||||
| `chorus` | Greek, wrong tradition |
|
||||
| `souk` | Less widely known |
|
||||
|
||||
### For `scroll` (context)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| `letter` | Too small/personal |
|
||||
| `tome` | Too large |
|
||||
| `message` | Too plain |
|
||||
| Keyword | Rejected because |
|
||||
| --------- | ------------------ |
|
||||
| `letter` | Too small/personal |
|
||||
| `tome` | Too large |
|
||||
| `message` | Too plain |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -29,55 +29,55 @@ An alternative register for OpenProse that draws from the works of Jorge Luis Bo
|
||||
|
||||
### 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| Functional | Borges | Reference |
|
||||
| ---------- | -------- | ------------------------------ |
|
||||
| `prompt` | `query` | Asking the Library |
|
||||
| `model` | `author` | Which author writes this dream |
|
||||
|
||||
### Unchanged
|
||||
|
||||
@@ -299,15 +299,15 @@ zahir config = { author: "opus", recur: 3 }
|
||||
|
||||
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 |
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
@@ -315,35 +315,35 @@ For those unfamiliar with the source material:
|
||||
|
||||
### For `dreamer` (agent)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| `author` | Used for `model` instead |
|
||||
| `scribe` | Too passive, just records |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| Keyword | Rejected because |
|
||||
| --------- | --------------------------------- |
|
||||
| `funes` | Too obscure as standalone keyword |
|
||||
| `recall` | Sounds like a function call |
|
||||
| `archive` | More Library of Babel than Funes |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -29,55 +29,55 @@ An alternative register for OpenProse that leans into literary, theatrical, and
|
||||
|
||||
### 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| Functional | Folk | Origin | Connotation |
|
||||
| ---------- | -------- | -------- | ---------------------- |
|
||||
| `prompt` | `charge` | Chivalry | Giving a quest or duty |
|
||||
| `model` | `voice` | Theatre | Which voice speaks |
|
||||
|
||||
### Unchanged
|
||||
|
||||
@@ -274,39 +274,39 @@ perform review("quantum computing")
|
||||
|
||||
### 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 |
|
||||
| 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) |
|
||||
| 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) |
|
||||
| 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 |
|
||||
| Keyword | Origin | Rejected because |
|
||||
| ------------ | ------ | ------------------------ |
|
||||
| `fork` | Path | Too technical (git fork) |
|
||||
| `branch` | Tree | Also too technical |
|
||||
| `divergence` | Latin | Too abstract |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -28,55 +28,55 @@ An alternative register for OpenProse that draws from Greek epic poetry—the Il
|
||||
|
||||
### 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| Functional | Homeric | Reference |
|
||||
| ---------- | -------- | ------------------- |
|
||||
| `prompt` | `charge` | The quest given |
|
||||
| `model` | `muse` | Which muse inspires |
|
||||
|
||||
### Unchanged
|
||||
|
||||
@@ -296,14 +296,14 @@ fate config = { muse: "opus", persist: 3 }
|
||||
|
||||
## 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` |
|
||||
| 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` |
|
||||
|
||||
---
|
||||
|
||||
@@ -311,27 +311,27 @@ fate config = { muse: "opus", persist: 3 }
|
||||
|
||||
### For `hero` (agent)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| `champion` | More medieval than Homeric |
|
||||
| `warrior` | Too martial, not all tasks are battles |
|
||||
| `wanderer` | Too passive |
|
||||
| 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 |
|
||||
|---------|------------------|
|
||||
| Keyword | Rejected because |
|
||||
| ------- | --------------------------------------- |
|
||||
| `labor` | Good but reserved for `repeat N labors` |
|
||||
| `quest` | More medieval/RPG |
|
||||
| `task` | Too plain |
|
||||
| `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 |
|
||||
| Keyword | Rejected because |
|
||||
| --------- | ------------------------------ |
|
||||
| `army` | Too specifically martial |
|
||||
| `fleet` | Only works for naval metaphors |
|
||||
| `phalanx` | Too technical |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -28,55 +28,55 @@ An alternative register for OpenProse that draws from the works of Franz Kafka
|
||||
|
||||
### Core Constructs
|
||||
|
||||
| Functional | Kafka | Reference |
|
||||
|------------|-------|-----------|
|
||||
| `agent` | `clerk` | A functionary in the apparatus |
|
||||
| `session` | `proceeding` | An official action taken |
|
||||
| Functional | Kafka | Reference |
|
||||
| ---------- | ------------- | -------------------------------------- |
|
||||
| `agent` | `clerk` | A functionary in the apparatus |
|
||||
| `session` | `proceeding` | An official action taken |
|
||||
| `parallel` | `departments` | Multiple bureaus acting simultaneously |
|
||||
| `block` | `regulation` | A codified procedure |
|
||||
| `block` | `regulation` | A codified procedure |
|
||||
|
||||
### Composition & Binding
|
||||
|
||||
| Functional | Kafka | Reference |
|
||||
|------------|-------|-----------|
|
||||
| `use` | `requisition` | Requesting from the archives |
|
||||
| `input` | `petition` | What is submitted for consideration |
|
||||
| `output` | `verdict` | What is returned by the apparatus |
|
||||
| `let` | `file` | Recording in the system |
|
||||
| `const` | `statute` | Unchangeable law |
|
||||
| `context` | `dossier` | The accumulated file on a case |
|
||||
| Functional | Kafka | Reference |
|
||||
| ---------- | ------------- | ----------------------------------- |
|
||||
| `use` | `requisition` | Requesting from the archives |
|
||||
| `input` | `petition` | What is submitted for consideration |
|
||||
| `output` | `verdict` | What is returned by the apparatus |
|
||||
| `let` | `file` | Recording in the system |
|
||||
| `const` | `statute` | Unchangeable law |
|
||||
| `context` | `dossier` | The accumulated file on a case |
|
||||
|
||||
### Control Flow
|
||||
|
||||
| Functional | Kafka | Reference |
|
||||
|------------|-------|-----------|
|
||||
| `repeat N` | `N hearings` | Repeated appearances before the court |
|
||||
| `for...in` | `for each...in the matter of` | Bureaucratic iteration |
|
||||
| `loop` | `appeal` | Endless re-petition, the process continues |
|
||||
| `until` | `until` | Unchanged |
|
||||
| `while` | `while` | Unchanged |
|
||||
| `choice` | `tribunal` | Where judgment is rendered |
|
||||
| `option` | `ruling` | One possible judgment |
|
||||
| `if` | `in the event that` | Bureaucratic conditional |
|
||||
| `elif` | `or in the event that` | Continued conditional |
|
||||
| `else` | `otherwise` | Default ruling |
|
||||
| Functional | Kafka | Reference |
|
||||
| ---------- | ----------------------------- | ------------------------------------------ |
|
||||
| `repeat N` | `N hearings` | Repeated appearances before the court |
|
||||
| `for...in` | `for each...in the matter of` | Bureaucratic iteration |
|
||||
| `loop` | `appeal` | Endless re-petition, the process continues |
|
||||
| `until` | `until` | Unchanged |
|
||||
| `while` | `while` | Unchanged |
|
||||
| `choice` | `tribunal` | Where judgment is rendered |
|
||||
| `option` | `ruling` | One possible judgment |
|
||||
| `if` | `in the event that` | Bureaucratic conditional |
|
||||
| `elif` | `or in the event that` | Continued conditional |
|
||||
| `else` | `otherwise` | Default ruling |
|
||||
|
||||
### Error Handling
|
||||
|
||||
| Functional | Kafka | Reference |
|
||||
|------------|-------|-----------|
|
||||
| `try` | `submit` | Submitting for processing |
|
||||
| `catch` | `should it be denied` | Rejection by the apparatus |
|
||||
| `finally` | `regardless` | What happens no matter the outcome |
|
||||
| `throw` | `reject` | The system refuses |
|
||||
| `retry` | `resubmit` | Try the process again |
|
||||
| Functional | Kafka | Reference |
|
||||
| ---------- | --------------------- | ---------------------------------- |
|
||||
| `try` | `submit` | Submitting for processing |
|
||||
| `catch` | `should it be denied` | Rejection by the apparatus |
|
||||
| `finally` | `regardless` | What happens no matter the outcome |
|
||||
| `throw` | `reject` | The system refuses |
|
||||
| `retry` | `resubmit` | Try the process again |
|
||||
|
||||
### Session Properties
|
||||
|
||||
| Functional | Kafka | Reference |
|
||||
|------------|-------|-----------|
|
||||
| `prompt` | `directive` | Official instructions |
|
||||
| `model` | `authority` | Which level of the hierarchy |
|
||||
| Functional | Kafka | Reference |
|
||||
| ---------- | ----------- | ---------------------------- |
|
||||
| `prompt` | `directive` | Official instructions |
|
||||
| `model` | `authority` | Which level of the hierarchy |
|
||||
|
||||
### Unchanged
|
||||
|
||||
@@ -280,7 +280,7 @@ statute config = { authority: "opus", resubmit: 3 }
|
||||
## The Case For Kafka
|
||||
|
||||
1. **Darkly comic.** Programs-as-bureaucracy is funny and relatable.
|
||||
2. **Surprisingly apt.** Software often *is* an inscrutable apparatus.
|
||||
2. **Surprisingly apt.** Software often _is_ an inscrutable apparatus.
|
||||
3. **Clean mappings.** Petition/verdict, file/dossier, clerk/proceeding all work well.
|
||||
4. **Appeal as loop.** The endless appeal process is a perfect metaphor for retry logic.
|
||||
5. **Cultural resonance.** "Kafkaesque" is a widely understood adjective.
|
||||
@@ -297,15 +297,15 @@ statute config = { authority: "opus", resubmit: 3 }
|
||||
|
||||
## Key Kafka Concepts
|
||||
|
||||
| Term | Meaning | Used for |
|
||||
|------|---------|----------|
|
||||
| The apparatus | The inscrutable system | The VM itself |
|
||||
| K. | The protagonist, never fully named | The user |
|
||||
| The Trial | Process without clear rules | Program execution |
|
||||
| The Castle | Unreachable authority | Higher-level systems |
|
||||
| Clerk | Functionary who processes | `agent` → `clerk` |
|
||||
| Proceeding | Official action | `session` → `proceeding` |
|
||||
| Dossier | Accumulated file | `context` → `dossier` |
|
||||
| Term | Meaning | Used for |
|
||||
| ------------- | ---------------------------------- | ------------------------ |
|
||||
| The apparatus | The inscrutable system | The VM itself |
|
||||
| K. | The protagonist, never fully named | The user |
|
||||
| The Trial | Process without clear rules | Program execution |
|
||||
| The Castle | Unreachable authority | Higher-level systems |
|
||||
| Clerk | Functionary who processes | `agent` → `clerk` |
|
||||
| Proceeding | Official action | `session` → `proceeding` |
|
||||
| Dossier | Accumulated file | `context` → `dossier` |
|
||||
|
||||
---
|
||||
|
||||
@@ -313,37 +313,37 @@ statute config = { authority: "opus", resubmit: 3 }
|
||||
|
||||
### For `clerk` (agent)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| `official` | Too generic |
|
||||
| `functionary` | Hard to spell |
|
||||
| `bureaucrat` | Too pejorative |
|
||||
| `advocate` | Too positive/helpful |
|
||||
| Keyword | Rejected because |
|
||||
| ------------- | -------------------- |
|
||||
| `official` | Too generic |
|
||||
| `functionary` | Hard to spell |
|
||||
| `bureaucrat` | Too pejorative |
|
||||
| `advocate` | Too positive/helpful |
|
||||
|
||||
### For `proceeding` (session)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| `case` | Overloaded (switch case) |
|
||||
| Keyword | Rejected because |
|
||||
| --------- | -------------------------------- |
|
||||
| `case` | Overloaded (switch case) |
|
||||
| `hearing` | Reserved for `repeat N hearings` |
|
||||
| `trial` | Used in Homeric register |
|
||||
| `process` | Too technical |
|
||||
| `trial` | Used in Homeric register |
|
||||
| `process` | Too technical |
|
||||
|
||||
### For `departments` (parallel)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| `bureaus` | Good alternative, slightly less clear |
|
||||
| `offices` | Too mundane |
|
||||
| `ministries` | More Orwellian than Kafkaesque |
|
||||
| Keyword | Rejected because |
|
||||
| ------------ | ------------------------------------- |
|
||||
| `bureaus` | Good alternative, slightly less clear |
|
||||
| `offices` | Too mundane |
|
||||
| `ministries` | More Orwellian than Kafkaesque |
|
||||
|
||||
### For `appeal` (loop)
|
||||
|
||||
| Keyword | Rejected because |
|
||||
|---------|------------------|
|
||||
| Keyword | Rejected because |
|
||||
| ---------- | ------------------- |
|
||||
| `recourse` | Too legal-technical |
|
||||
| `petition` | Used for `input` |
|
||||
| `process` | Too generic |
|
||||
| `petition` | Used for `input` |
|
||||
| `process` | Too generic |
|
||||
|
||||
---
|
||||
|
||||
@@ -368,6 +368,6 @@ Not recommended for:
|
||||
## Closing Note
|
||||
|
||||
> "Someone must have slandered Josef K., for one morning, without having done anything wrong, he was arrested."
|
||||
> — *The Trial*
|
||||
> — _The Trial_
|
||||
|
||||
In the Kafka register, your program is Josef K. The apparatus will process it. Whether it succeeds or fails, no one can say for certain. But the proceedings will continue.
|
||||
|
||||
Reference in New Issue
Block a user