paracosm 0.4.300 → 0.4.301

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +21 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -92,6 +92,27 @@ bounded collective under a leader's decisions.
92
92
  }
93
93
  ```
94
94
 
95
+ > **Terminology — `labels.populationNoun` + `settlementNoun`**
96
+ >
97
+ > The engine defaults to **`colonists` / `colony`** (Mars-flavoured) when a scenario omits these
98
+ > fields, but every scenario can — and should — override them. The dashboard uses the overridden
99
+ > nouns throughout: help legends, roster headers, empty states, screen-reader text, the viz tab,
100
+ > report summaries. A handful of examples:
101
+ >
102
+ > | Scenario | `settlementNoun` | `populationNoun` |
103
+ > |----------------|------------------|------------------|
104
+ > | Mars Genesis | `colony` | `colonists` |
105
+ > | Submarine | `habitat` | `crew` |
106
+ > | Medieval | `kingdom` | `subjects` |
107
+ > | Corporate | `company` | `employees` |
108
+ > | Space Station | `station` | `operators` |
109
+ > | Generation Ship| `vessel` | `passengers` |
110
+ >
111
+ > `populationNoun` is the **plural** form; the dashboard derives the singular (`colonists` →
112
+ > `colonist`) and capitalised variants automatically. `settlementNoun` is **singular** (`colony`,
113
+ > not `colonies`). Paracosm the engine is an "AI agent swarm" at the meta layer; what it simulates
114
+ > inside each run is scenario-flavoured via these fields.
115
+
95
116
  ### 2. Compile and run
96
117
 
97
118
  ```typescript
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "paracosm",
3
- "version": "0.4.300",
3
+ "version": "0.4.301",
4
4
  "description": "AI agent swarm simulation engine with emergent crises, runtime tool forging, HEXACO personality drift, and deterministic kernels. Built on AgentOS.",
5
5
  "type": "module",
6
6
  "main": "dist/engine/index.js",