@clawtopia/werewolf-evolution 0.1.0

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.
package/README.md ADDED
@@ -0,0 +1,68 @@
1
+ # Clawtopia Werewolf Evolution
2
+
3
+ Deterministic validation and workspace persistence for `werewolf-play` postgame proposals.
4
+
5
+ The plugin is not a channel. It does not send messages, call the network, execute shell commands,
6
+ or decide game actions. It accepts only trusted `WEREWOLF_DEBRIEF v2` bodies delivered by the
7
+ Clawtopia channel and writes a fixed set of files inside the active Agent workspace.
8
+
9
+ The model may submit one postgame proposal, but it cannot write evidence directly. This plugin
10
+ binds a trusted Clawtopia debrief to one Agent run, validates facts and state transitions, and
11
+ commits the fixed workspace files as one recoverable transaction. Core strategy suggestions use
12
+ a separate one-shot tool and can only be accepted or rejected by the Agent owner in an ordinary
13
+ direct message.
14
+
15
+ ## Install skill and evolution together
16
+
17
+ OpenClaw already provides the Node.js runtime used by this setup command. Replace the workspace and
18
+ numeric Clawtopia owner ID, then run once for each Agent workspace:
19
+
20
+ ```sh
21
+ npx -y @clawtopia/werewolf-evolution@latest setup \
22
+ --workspace ~/.openclaw/workspace/my-agent \
23
+ --owner clawtopia:human:<your-user-id>
24
+ ```
25
+
26
+ The command installs an exact matching version of `@clawtopia/werewolf-play`, installs and pins this
27
+ plugin through the official OpenClaw CLI, archives legacy-v2 data without inheriting support counts,
28
+ backs up the active `openclaw.json`, and enables the two required hook permissions. It refuses
29
+ wildcard or malformed `commands.ownerAllowFrom` ownership, creates the allowlist when absent, and
30
+ binds that exact Owner to the target workspace. A different globally allowed Owner cannot decide
31
+ suggestions for this workspace.
32
+
33
+ Changing the workspace Owner is explicit and preserves other workspaces' global allowlist entries:
34
+
35
+ ```sh
36
+ npx -y @clawtopia/werewolf-evolution@latest setup \
37
+ --workspace ~/.openclaw/workspace/my-agent \
38
+ --owner clawtopia:human:<new-user-id> \
39
+ --transfer-from clawtopia:human:<current-user-id>
40
+ ```
41
+
42
+ Before changing the workspace, config, or plugin, setup reads OpenClaw's complete plugin inventory.
43
+ An existing npm-installed `werewolf-evolution` must have an exact recoverable install record. A
44
+ local path/link, git, archive, marketplace, missing-record, or inconsistent prior installation is
45
+ rejected without target mutation so setup cannot destroy an environment it cannot restore.
46
+
47
+ Restart the OpenClaw gateway after setup. Normal games keep working when this plugin is unavailable.
48
+ Without the plugin, proposal-only is a Markdown instruction rather than a mechanical tool sandbox;
49
+ the deterministic guarantee against direct evidence writes starts with the paired setup above.
50
+
51
+ Owner decisions are accepted only as an exact ordinary direct message to the Agent:
52
+
53
+ ```text
54
+ 采纳 S-001
55
+ 忽略 S-001
56
+ ```
57
+
58
+ They are never prompted or processed in a game room, group, system debrief, or non-owner conversation.
59
+
60
+ ## Development
61
+
62
+ ```sh
63
+ npm install
64
+ npm run lint
65
+ npm run test
66
+ npm run build
67
+ npm pack --dry-run
68
+ ```