fix(codex): rebase sharing changes onto claude branch

Author: visahak

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

@@ -1,7 +1,7 @@
 {
   "name": "evolve-lite",
-  "version": "1.0.0",
-  "description": "Recall and save Evolve entities in Codex without MCP.",
+  "version": "1.1.0",
+  "description": "Recall, save, and share Evolve entities in Codex without MCP.",
   "author": {
     "name": "Vinod Muthusamy",
     "url": "https://github.com/AgentToolkit/altk-evolve"
@@ -13,16 +13,18 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "Evolve Lite",
-    "shortDescription": "Recall and save reusable Evolve entities.",
-    "longDescription": "A lightweight Codex plugin that helps you save reusable entities from successful sessions and recall them automatically on new prompts.",
+    "shortDescription": "Recall, save, and share reusable Evolve entities.",
+    "longDescription": "A lightweight Codex plugin that helps you save reusable entities, publish selected guidance, subscribe to shared repos, and recall relevant memory automatically on new prompts.",
     "developerName": "AgentToolkit",
     "category": "Productivity",
     "capabilities": ["Interactive", "Write"],
     "websiteURL": "https://github.com/AgentToolkit/altk-evolve",
     "defaultPrompt": [
       "Recall Evolve entities for this task.",
       "Save new Evolve learnings from this session.",
-      "Show me the entities stored for this repo."
+      "Show me the entities stored for this repo.",
+      "Publish one of my Evolve guidelines.",
+      "Subscribe to a teammate's Evolve guidelines repo."
     ],
     "brandColor": "#2563EB"
   }

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

@@ -1,6 +1,6 @@
 # Evolve Lite Plugin for Codex
 
-A plugin that helps Codex learn from conversations by automatically extracting and applying entities.
+A plugin that helps Codex save, recall, and share reusable entities across workspaces.
 
 ⭐ Star the repo: https://github.com/AgentToolkit/altk-evolve
 
@@ -9,20 +9,54 @@ A plugin that helps Codex learn from conversations by automatically extracting a
 - Automatic recall through a repo-level Codex `UserPromptSubmit` hook when Codex hooks are enabled
 - Manual `evolve-lite:learn` skill to save reusable entities into `.evolve/entities/`
 - Manual `evolve-lite:recall` skill to inspect everything stored for the current repo
+- Manual `evolve-lite:publish` skill to publish private guidelines to your public repo
+- Manual `evolve-lite:subscribe` and `evolve-lite:unsubscribe` skills to manage shared guideline repos
+- Automatic or manual `evolve-lite:sync` to mirror subscribed repos into local recall storage
 
 ## Storage
 
-Entities are stored in the active workspace under:
+Entities and sharing data are stored in the active workspace under:
 
 ```text
-.evolve/entities/
-  guideline/
-    use-context-managers-for-file-operations.md
-    cache-api-responses-locally.md
+.evolve/
+  entities/
+    guideline/
+      use-context-managers-for-file-operations.md
+    subscribed/
+      alice/
+        guideline/
+          prefer-small-functions.md
+  public/
+    guideline/
+      no-eval.md
+  subscribed/
+    alice/
+      guideline/
+        prefer-small-functions.md
+  audit.log
 ```
 
 Each entity is a markdown file with lightweight YAML frontmatter.
 
+Sharing configuration lives in `evolve.config.yaml` at the repo root:
+
+```yaml
+identity:
+  user: alice
+
+public_repo:
+  remote: git@github.com:alice/evolve-guidelines.git
+  branch: main
+
+subscriptions:
+  - name: team
+    remote: git@github.com:myorg/evolve-guidelines.git
+    branch: main
+
+sync:
+  on_session_start: true
+```
+
 ## Source Layout
 
 This source tree intentionally omits `lib/`.
@@ -33,7 +67,12 @@ The shared library lives in:
 platform-integrations/claude/plugins/evolve-lite/lib/
 ```
 
-`platform-integrations/install.sh` copies that shared library into the installed Codex plugin so the installed layout is self-contained.
+`platform-integrations/install.sh` installs Codex in this order:
+
+1. copy the Codex plugin source into `plugins/evolve-lite/`
+2. copy the shared `lib/` from the Claude plugin into `plugins/evolve-lite/lib/`
+3. wire the marketplace entry
+4. wire the Codex hooks
 
 ## Installation
 
@@ -60,6 +99,85 @@ If you do not want to enable Codex hooks, you can still invoke the installed `ev
 
 The installed Codex hook does not require `git`. It walks upward from the current working directory until it finds the repo-local `plugins/evolve-lite/.../retrieve_entities.py` script.
 
+The installer always registers a `SessionStart` hook with matcher `startup|resume`; it runs on every Codex session start or resume and exits quickly unless `sync.on_session_start` is enabled and subscriptions are configured in `evolve.config.yaml`.
+
+## 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 uses `evolve.config.yaml` at the project root. Minimal structure:
+
+```yaml
+identity:
+  user: yourname
+
+public_repo:
+  remote: git@github.com:yourname/evolve-guidelines.git
+  branch: main
+
+subscriptions: []
+
+sync:
+  on_session_start: true
+```
+
+The `.evolve/` directory is kept out of version control.
+
+### Publishing Guidelines
+
+Use `evolve-lite:publish` to share one or more of your local guidelines with others:
+
+1. Pick a file from `.evolve/entities/guideline/`
+2. Publish it into `.evolve/public/guideline/`
+3. The published file is stamped with `visibility: public`, `published_at`, and a `source` label derived from config when available
+4. The original private guideline is removed from `.evolve/entities/guideline/`
+
+Others can then subscribe using that public remote URL.
+
+### Subscribing to Guidelines
+
+Use `evolve-lite:subscribe` to pull in guidelines from another user's public repo.
+
+The repo is cloned to `.evolve/subscribed/{name}/` and mirrored into `.evolve/entities/subscribed/{name}/` so recall can pick them up immediately.
+
+### Syncing Subscriptions
+
+Use `evolve-lite:sync` to pull the latest changes from all subscribed repos.
+
+If `sync.on_session_start: true` is set in config, this runs automatically whenever a Codex session starts or resumes.
+
+### Unsubscribing
+
+Use `evolve-lite:unsubscribe` to remove a subscription and delete its locally cloned files.
+
+This removes both `.evolve/subscribed/{name}/` and its mirrored recall copy under `.evolve/entities/subscribed/{name}/`.
+
+### Sharing Storage Layout
+
+```text
+.evolve/
+  public/
+    guideline/
+      guideline-name.md         # published guideline, included in recall
+  subscribed/
+    alice/
+      guideline/
+        her-guideline.md        # git clone of alice's public repo
+  entities/
+    guideline/
+      private-guideline.md      # private local guideline
+    subscribed/
+      alice/
+        guideline/
+          her-guideline.md      # mirrored for recall, annotated [from: alice]
+```
+
+## Example Walkthrough
+
+See the [Codex example walkthrough](../../../../docs/examples/hello_world/codex.md) for a step-by-step example showing the save-then-recall loop in a Codex workspace.
+
 ## Included Skills
 
 ### `evolve-lite:learn`
@@ -68,4 +186,73 @@ Analyze the current session and save proactive Evolve entities as markdown files
 
 ### `evolve-lite:recall`
 
-Show the entities already stored for the current workspace.
+Show the entities already stored for the current workspace, including published guidelines under `.evolve/public/`.
+
+### `evolve-lite:publish`
+
+Move selected private guidelines into `.evolve/public/`, stamp them as public, and push them to your configured sharing repo.
+
+### `evolve-lite:subscribe`
+
+Clone another user's public guideline repo into `.evolve/subscribed/` and register it in `evolve.config.yaml`.
+
+### `evolve-lite:unsubscribe`
+
+Remove a configured subscription and delete its local clones and mirrored recall entities.
+
+### `evolve-lite:sync`
+
+Pull every configured subscription and mirror its markdown files into `.evolve/entities/subscribed/` so recall can include them automatically.
+
+## Environment Variables
+
+- `EVOLVE_DIR`: Override the default `.evolve` directory location for entities, sharing data, audit logs, and the mirrored subscription store.
+
+## Verification
+
+After installation, verify that:
+
+- `plugins/evolve-lite/` exists in the repo
+- `.agents/plugins/marketplace.json` contains the `evolve-lite` entry
+- `.codex/hooks.json` contains the Evolve `UserPromptSubmit` and `SessionStart` hooks
+
+You can also run:
+
+```bash
+platform-integrations/install.sh status
+```
+
+## Plugin Structure
+
+```text
+evolve-lite/
+├── .codex-plugin/
+│   └── plugin.json
+├── skills/
+│   ├── learn/
+│   │   ├── SKILL.md
+│   │   └── scripts/
+│   │       └── save_entities.py
+│   ├── recall/
+│   │   ├── SKILL.md
+│   │   └── scripts/
+│   │       └── retrieve_entities.py
+│   ├── publish/
+│   │   ├── SKILL.md
+│   │   └── scripts/
+│   │       └── publish.py
+│   ├── subscribe/
+│   │   ├── SKILL.md
+│   │   └── scripts/
+│   │       └── subscribe.py
+│   ├── unsubscribe/
+│   │   ├── SKILL.md
+│   │   └── scripts/
+│   │       └── unsubscribe.py
+│   └── sync/
+│       ├── SKILL.md
+│       └── scripts/
+│           └── sync.py
+├── README.md
+└── lib/                       # copied in at install time from the Claude plugin
+```

platform-integrations/codex/plugins/evolve-lite/skills/learn/SKILL.md

@@ -27,6 +27,7 @@ Examples of artifacts that must be immediately created once proven as the succes
 Unless that artifact happens to be:
 - code which is a trivial one-liner that future agents would not benefit from reusing
 - code which embeds secrets, tokens, or user-specific sensitive data
+- the guideline would instruct the agent to invoke a skill, tool, or external command by name (e.g. "run evolve-lite:learn", "call save_trajectory") - such guidelines trigger prompt-injection detection when retrieved by the recall skill in a future session
 - the user explicitly asked for a one-off result and not to persist helper code
 - redundant because an equivalent local artifact on disk would be just as effective
 

platform-integrations/codex/plugins/evolve-lite/skills/learn/scripts/save_entities.py

@@ -5,6 +5,7 @@
 in the entities directory, organized by type.
 """
 
+import argparse
 import json
 import sys
 from pathlib import Path
@@ -13,9 +14,14 @@
 _script = Path(__file__).resolve()
 _lib = None
 for _ancestor in _script.parents:
-    _candidate = _ancestor / "lib"
-    if (_candidate / "entity_io.py").is_file():
-        _lib = _candidate
+    for _candidate in (
+        _ancestor / "lib",
+        _ancestor / "platform-integrations" / "claude" / "plugins" / "evolve-lite" / "lib",
+    ):
+        if (_candidate / "entity_io.py").is_file():
+            _lib = _candidate
+            break
+    if _lib is not None:
         break
 if _lib is None:
     raise ImportError(f"Cannot find plugin lib directory above {_script}")
@@ -42,6 +48,10 @@ def normalize(text):
 
 
 def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--user", default=None, help="Stamp owner on every entity written")
+    args = parser.parse_args()
+
     try:
         input_data = json.load(sys.stdin)
         log(f"Received input with keys: {list(input_data.keys())}")
@@ -82,6 +92,11 @@ def main():
             log(f"Skipping duplicate: {content[:60]}")
             continue
 
+        if args.user and not entity.get("owner"):
+            entity["owner"] = args.user
+        if not entity.get("visibility"):
+            entity["visibility"] = "private"
+
         path = write_entity_file(entities_dir, entity)
         existing_contents.add(normalize(content))
         added_count += 1