@arcanea/guardian-evolution 0.1.0 → 0.1.1

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 +46 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,46 @@
1
+ # @arcanea/guardian-evolution
2
+
3
+ Guardian Evolution — SONA learning, ReasoningBank, pattern extraction, and 7 RL algorithms for Guardian growth.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install @arcanea/guardian-evolution
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```js
14
+ const { EvolutionEngine } = require('@arcanea/guardian-evolution');
15
+ const { PPO } = require('@arcanea/guardian-evolution/algorithms');
16
+ const { SONAMode } = require('@arcanea/guardian-evolution/modes');
17
+
18
+ const engine = new EvolutionEngine({
19
+ algorithm: new PPO({ learningRate: 0.0003 }),
20
+ mode: SONAMode.EXPLORATORY
21
+ });
22
+
23
+ // Extract patterns from Guardian activity
24
+ const patterns = await engine.extractPatterns(guardianHistory);
25
+
26
+ // Evolve the Guardian using reinforcement learning
27
+ const evolved = await engine.evolve(guardian, patterns);
28
+ console.log(evolved.fitnessScore);
29
+ ```
30
+
31
+ ## API
32
+
33
+ | Export | Description |
34
+ |---|---|
35
+ | `EvolutionEngine` | Core engine driving Guardian growth cycles |
36
+ | `ReasoningBank` | Persistent store for extracted reasoning patterns |
37
+ | `PatternExtractor` | Extracts actionable patterns from Guardian logs |
38
+
39
+ ### Subpath Exports
40
+
41
+ - `@arcanea/guardian-evolution/algorithms` — 7 RL algorithms: `PPO`, `DQN`, `A3C`, `SAC`, `TD3`, `REINFORCE`, `CMA_ES`
42
+ - `@arcanea/guardian-evolution/modes` — SONA learning modes: `SONAMode.EXPLORATORY`, `SONAMode.EXPLOITATIVE`, `SONAMode.BALANCED`
43
+
44
+ ## License
45
+
46
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@arcanea/guardian-evolution",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Guardian Evolution — SONA learning, ReasoningBank, pattern extraction, and 7 RL algorithms for Guardian growth",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -39,7 +39,7 @@
39
39
  "files": ["dist", "README.md"],
40
40
  "publishConfig": { "access": "public" },
41
41
  "dependencies": {
42
- "@arcanea/guardian-memory": "workspace:*"
42
+ "@arcanea/guardian-memory": "^0.1.0"
43
43
  },
44
44
  "devDependencies": {
45
45
  "typescript": "^5.5.0"