feat(evolve-lite): add entity sharing skills and CI tests (#188)

* feat(evolve-lite): add entity sharing skills and CI tests

New skills: publish, subscribe, unsubscribe, sync
New lib modules: config.py, audit.py
Updated: plugin.json, hooks.json, entity_io.py, save_entities.py, retrieve_entities.py

CI test suite (110 tests in tests/platform_integrations/):
- test_config.py, test_audit.py, test_entity_io_core.py
- test_publish.py, test_subscribe.py, test_sync.py
- test_retrieve.py, test_save_entities.py, test_plugin_structure.py

* Addresses CodeRabbit review findings

Author: visahak

platform-integrations/claude/plugins/evolve-lite/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "evolve-lite",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Learn from conversations with auto-generated entities",
   "author": {
     "name": "Vinod Muthusamy"

platform-integrations/claude/plugins/evolve-lite/README.md

@@ -55,6 +55,90 @@ You can also manually invoke `/evolve-lite:learn` at any time.
 > - Set a specific `"matcher"` string to restrict triggering to prompts that contain that text.
 > - Reduce `"timeout"` to cap how long the learn step can run.
 
+## Sharing Guidelines
+
+Evolve Lite supports sharing guidelines between users via public Git repositories. You can publish your own guidelines so others can subscribe to them, and subscribe to guidelines published by others.
+
+### Setup
+
+Sharing requires an `evolve.config.yaml` at the project root. If it doesn't exist, the subscribe or publish skills will prompt you to create one. Minimal structure:
+
+```yaml
+identity:
+  user: yourname          # used to stamp ownership on published guidelines
+public_repo:
+  remote: git@github.com:yourname/evolve-guidelines.git
+  branch: main
+subscriptions: []
+sync:
+  on_session_start: true  # auto-sync on each session start
+```
+
+The `.evolve/` directory is kept out of version control — the skills automatically add it to `.gitignore`.
+
+### Publishing Guidelines
+
+Use `/evolve-lite:publish` to share one or more of your local guidelines with others:
+
+1. The skill lists files in `.evolve/entities/guideline/`
+2. You pick which ones to publish
+3. Each selected file is copied to `.evolve/public/`, stamped with your username as the owner, committed, and pushed to your `public_repo.remote`
+
+Others can then subscribe using that remote URL.
+
+### Subscribing to Guidelines
+
+Use `/evolve-lite:subscribe` to pull in guidelines from another user's public repo:
+
+```text
+/evolve-lite:subscribe
+> Remote URL: git@github.com:alice/evolve-guidelines.git
+> Short name: alice
+```
+
+The repo is cloned to `.evolve/subscribed/alice/` and mirrored into `.evolve/entities/subscribed/alice/` so recall picks them up immediately.
+
+### Syncing Subscriptions
+
+Use `/evolve-lite:sync` to pull the latest changes from all subscribed repos:
+
+```text
+/evolve-lite:sync
+> Synced 2 repo(s): alice (+2 added, 0 updated, 0 removed), bob (+0 added, 1 updated, 0 removed)
+```
+
+If `sync.on_session_start: true` is set in config, this runs automatically at the start of each session.
+
+> **Note:** Sync uses `git fetch` + `git reset --hard` on each cloned subscription repo, so local state always matches the remote exactly. Accidentally deleted or modified files are automatically restored on the next sync.
+
+### Unsubscribing
+
+Use `/evolve-lite:unsubscribe` to remove a subscription and delete its locally cloned files:
+
+```text
+/evolve-lite:unsubscribe
+> Which subscription would you like to remove?
+> 1. alice
+> 2. bob
+```
+
+The skill confirms before deleting `.evolve/subscribed/{name}/` and its mirror under `.evolve/entities/subscribed/{name}/`.
+
+### Sharing Storage Layout
+
+```text
+.evolve/
+  public/                     # git repo pushed to your public remote
+    guideline-name.md         # owner-stamped guideline
+  subscribed/
+    alice/                    # git clone of alice's public repo
+      her-guideline.md
+  entities/
+    subscribed/
+      alice/                  # mirrored for recall
+        her-guideline.md
+```
+
 ## Example Walkthrough
 
 See the [Evolve Lite guide](../../../../docs/integrations/claude/evolve-lite.md#example-walkthrough) for a step-by-step example showing the full learn-then-recall loop across two sessions.

platform-integrations/claude/plugins/evolve-lite/hooks/hooks.json

@@ -11,6 +11,17 @@
         ]
       }
     ],
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/skills/sync/scripts/sync.py --quiet"
+          }
+        ]
+      }
+    ],
     "Stop": [
       {
         "matcher": "",

platform-integrations/claude/plugins/evolve-lite/lib/audit.py

@@ -0,0 +1,33 @@
+"""Append-only audit log writer for .evolve/audit.log."""
+
+import datetime
+import json
+import pathlib
+
+
+def append(project_root=".", **fields):
+    """Append a JSON audit entry to .evolve/audit.log.
+
+    Args:
+        project_root: Root directory that contains .evolve/.
+        **fields: Arbitrary key-value fields to include in the log entry.
+    """
+    path = pathlib.Path(project_root) / ".evolve" / "audit.log"
+    path.parent.mkdir(parents=True, exist_ok=True)
+    entry = {**fields, "ts": datetime.datetime.now(datetime.UTC).isoformat().replace("+00:00", "Z")}
+    with path.open("a", encoding="utf-8") as f:
+        f.write(json.dumps(entry) + "\n")
+
+
+if __name__ == "__main__":
+    import tempfile
+
+    with tempfile.TemporaryDirectory() as d:
+        append(project_root=d, action="test", actor="alice")
+        log_path = __import__("pathlib").Path(d) / ".evolve" / "audit.log"
+        line = log_path.read_text(encoding="utf-8").strip()
+        entry = __import__("json").loads(line)
+        assert entry["action"] == "test"
+        assert entry["actor"] == "alice"
+        assert "ts" in entry
+    print("audit.py ok")