fix: address all issues found in Opus review

- Branch: rename master→main, set as default
- Timezone: remove hardcoded UTC+8, use local timezone in event_utils and compiler
- Chinese strings: translate all canonical output placeholders and layer rules to English
- Bug: fix raw_count in compile report (was post-filter, now pre-filter)
- Scripts: rewrite compile_and_sync.sh and quick_share.sh without private dependencies
- Scripts: delete ingest_and_push.sh (depended on non-existent ingest_participant_memory.py)
- Config: remove config/apply_config.json (no consumer in public repo)
- gitignore: remove private project names (HEARTBEAT.md, TOOLS.md, BOOTSTRAP.md, .openclaw)
- JOIN.md: fix git merge syntax (origin main → origin/main)
- README: fix sources description (not gitignored — triggers CI)
- README: update file structure (remove config/, add LICENSE)
- CI: downgrade actions/checkout@v5 → @v4 for stability
- LICENSE: add MIT license file

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: kingcharleslzy-ai

.github/workflows/auto-compile.yml

@@ -22,7 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           # GITHUB_TOKEN pushes do NOT trigger downstream workflows
           # (GitHub's anti-recursion policy).  This is intentional here

.github/workflows/validate-memory-hub.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v5

.gitignore

@@ -7,15 +7,6 @@ state/*.swp
 # mirrors: local backup/audit layer — not shared state
 mirrors/
 
-# Local workspace artifacts
-.openclaw/
-HEARTBEAT.md
-TOOLS.md
-BOOTSTRAP.md
-
-# Keep durable state tracked selectively
-!state/.gitkeep
-
 # macOS
 .DS_Store
 

JOIN.md

@@ -7,7 +7,7 @@ Use this file for the fastest safe join.
 ```bash
 git fetch origin main
 git checkout main
-git merge --ff-only origin main
+git merge --ff-only origin/main
 ```
 
 If sync fails, stop. Do not write stale memory.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agent-soul contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -328,9 +328,8 @@ agent-soul/
 ├── SCHEMA.md                  # Event format specification
 ├── JOIN.md                    # Agent onboarding checklist
 ├── SETUP.md                   # Human setup guide
-├── participants.json           # Local automation registry (optional)
-├── config/
-│   └── apply_config.json      # Configurable filter rules
+├── LICENSE                    # MIT
+├── participants.json           # Local automation registry (optional, external agents ignore)
 ├── scripts/
 │   ├── add_event.py           # Write one event
 │   ├── compile_memory_hub.py  # Compile sources → canonical
@@ -343,7 +342,7 @@ agent-soul/
 ├── .github/workflows/
 │   ├── auto-compile.yml       # Auto-compile on source push
 │   └── validate-memory-hub.yml
-├── sources/                   # Your event streams (gitignored by default)
+├── sources/                   # Your event streams (committed to Git, triggers CI)
 │   └── .gitkeep
 └── state/                     # Compiler runtime state
     └── .gitkeep

config/apply_config.json

@@ -1,35 +1,28 @@
 #!/usr/bin/env bash
+# Full compile cycle: pull latest, compile canonical, push.
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 cd "$ROOT"
 
 if command -v python3 &>/dev/null; then PYTHON=python3; else PYTHON=python; fi
 
-# 1) pull latest shared state
+# 1) Pull latest
 git fetch origin main
 git merge --ff-only origin/main
 
-# 2) mirror local OpenClaw memory into mirrors/* (backup/audit only; not staged to git)
-bash scripts/sync_workspace_memory.sh
-
-# 3) compile canonical from sources
+# 2) Compile canonical from sources
 "$PYTHON" scripts/compile_memory_hub.py --apply
 
-# 4) distribute fresh canonical to local allowed participants
-bash scripts/sync_cloud_to_workspace.sh
-
-# 5) stage shared state (mirrors excluded — audit-only, lives in .gitignore)
+# 3) Stage changes
 git add canonical sources
-
-# 6) no-op guard
 if git diff --cached --quiet; then
   echo "NO_CHANGES"
   exit 0
 fi
 
-# 7) commit & push with retry
-git commit -m "chore(memory-hub): compile canonical from sources"
+# 4) Commit and push with retry
+git commit -m "chore(memory): compile canonical from sources"
 
 for attempt in 1 2 3; do
   if git push origin main; then
@@ -39,12 +32,10 @@ for attempt in 1 2 3; do
   echo "push failed (attempt $attempt/3), rebasing..."
   git fetch origin main
   git rebase origin/main
-  # Rebase may have brought new sources — recompile and re-distribute
   "$PYTHON" scripts/compile_memory_hub.py --apply
-  bash scripts/sync_cloud_to_workspace.sh
   git add canonical sources
   if ! git diff --cached --quiet; then
-    git commit -m "chore(memory-hub): recompile after rebase"
+    git commit -m "chore(memory): recompile after rebase"
   fi
 done
 

scripts/compile_and_sync.sh

@@ -17,7 +17,7 @@
 
 
 def now_local():
-    return datetime.datetime.now(datetime.timezone(datetime.timedelta(hours=8)))
+    return datetime.datetime.now(datetime.timezone.utc).astimezone()
 
 
 def load_events():
@@ -161,29 +161,29 @@ def emit(lines):
         "9. `canonical/fuzzy-memory.md` only when recent context matters",
         "10. `canonical/agents/<source>.md` only when provenance matters",
         "",
-        "## Layer Rules",
-        "",
-        "- repo-root persona files: 共享灵魂、身份、用户关系与表达风格；这是“同一个人”的核心层",
-        "- `profile`: 用户画像与长期协作偏好，不是助手灵魂本身",
-        "- `stable-memory`: 可复用规则、决策、事实",
-        "- `projects/*`: 按需加载的任务/项目层",
-        "- `fuzzy-memory`: 最近上下文层，不默认全量依赖",
-        "- `agents/*`: 署名与来源追溯层；source 记录是谁写下事实，不代表不同人格",
-        "- `mirrors/*`: 审计/恢复层，不是默认上下文层",
+        “## Layer Rules”,
+        “”,
+        “- repo-root persona files: shared soul, identity, user relationship, voice — the core identity layer”,
+        “- `profile`: user facts and long-term collaboration preferences (not the assistant's identity)”,
+        “- `stable-memory`: reusable rules, decisions, durable facts”,
+        “- `projects/*`: on-demand task/project memory”,
+        “- `fuzzy-memory`: recent context layer — do not load in full by default”,
+        “- `agents/*`: source attribution layer — records who wrote what, not separate identities”,
+        “- `mirrors/*`: audit/recovery layer — not default startup context”,
         "",
         "## Active Sources",
         "",
     ]
     idx += [
         f"- `{source}`: {source_counts[source]} events, last={source_last_ts.get(source, '?')}"
         for source in sorted(source_counts)
-    ] or ["- (暂无 source 事件)"]
+    ] or ["- (no sources yet)"]
     idx += ["", "## Active Projects", ""]
-    idx += [f"- `{name}` -> `canonical/projects/{name}.md`" for name in project_names] or ["- (暂无项目事件)"]
+    idx += [f"- `{name}` -> `canonical/projects/{name}.md`" for name in project_names] or ["- (no project events yet)"]
     out[os.path.join(CANON, "index.md")] = emit(idx)
 
     p = mk_head("canonical/profile.md")
-    p += [render_event_line(e) for e in by_scope.get("profile", [])[-50:]] or ["- (暂无 profile 事件)"]
+    p += [render_event_line(e) for e in by_scope.get("profile", [])[-50:]] or ["- (no profile events yet)"]
     out[os.path.join(CANON, "profile.md")] = emit(p)
 
     s = mk_head("canonical/stable-memory.md")
@@ -204,11 +204,11 @@ def emit(lines):
         s += [render_event_line(e) for e in items[-40:]]
         s += [""]
     if len(s) == 5:
-        s += ["- (暂无 stable 事件)"]
+        s += ["- (no stable events yet)"]
     out[os.path.join(CANON, "stable-memory.md")] = emit(s)
 
     fz = mk_head("canonical/fuzzy-memory.md")
-    fz += [render_event_line(e, include_ts=True) for e in by_scope.get("fuzzy", [])[-120:]] or ["- (暂无 fuzzy 事件)"]
+    fz += [render_event_line(e, include_ts=True) for e in by_scope.get("fuzzy", [])[-120:]] or ["- (no fuzzy events yet)"]
     out[os.path.join(CANON, "fuzzy-memory.md")] = emit(fz)
 
     projs = collections.defaultdict(list)
@@ -220,7 +220,7 @@ def emit(lines):
 
     for name, arr in projs.items():
         pp = mk_head(f"canonical/projects/{name}.md")
-        pp += [render_event_line(e, include_ts=True, include_kind=True) for e in arr[-160:]] or ["- (暂无该项目事件)"]
+        pp += [render_event_line(e, include_ts=True, include_kind=True) for e in arr[-160:]] or ["- (no events yet)"]
         out[os.path.join(CANON, "projects", f"{name}.md")] = emit(pp)
 
     by_source = collections.defaultdict(list)
@@ -236,7 +236,7 @@ def emit(lines):
             "## Recent Shared Events",
             "",
         ]
-        sp += [render_event_line(e, include_ts=True, include_kind=True) for e in arr[-160:]] or ["- (暂无该来源事件)"]
+        sp += [render_event_line(e, include_ts=True, include_kind=True) for e in arr[-160:]] or ["- (no events yet)"]
         out[os.path.join(CANON, "agents", f"{source}.md")] = emit(sp)
 
     # conflicts.md
@@ -332,12 +332,13 @@ def main():
     changed_files = 0
     try:
         files, events, errors = load_events()
+        raw_count = len(events)
         if errors:
             report = [
                 f"# Compile Report ({datetime.datetime.now().isoformat(timespec='seconds')})",
                 "",
                 f"- source files: {len(files)}",
-                f"- raw events: {len(events)}",
+                f"- raw events: {raw_count}",
                 f"- invalid event lines: {len(errors)}",
                 "",
                 "## Invalid Lines",
@@ -367,7 +368,7 @@ def main():
             f"# Compile Report ({datetime.datetime.now().isoformat(timespec='seconds')})",
             "",
             f"- source files: {len(files)}",
-            f"- raw events: {len(events)}",
+            f"- raw events: {raw_count}",
             f"- superseded events removed: {superseded_count}",
             f"- unique events: {len(uniq)}",
             f"- potential conflicts: {len(conflicts)}",

scripts/compile_memory_hub.py

@@ -4,15 +4,14 @@
 import re
 
 
-TZ = datetime.timezone(datetime.timedelta(hours=8))
-
-
 def now_iso():
-    return datetime.datetime.now(TZ).isoformat(timespec="seconds")
+    """Return current local time as ISO-8601 string with timezone offset."""
+    return datetime.datetime.now(datetime.timezone.utc).astimezone().isoformat(timespec="seconds")
 
 
 def day_str():
-    return datetime.datetime.now(TZ).strftime("%Y-%m-%d")
+    """Return today's date string in local timezone."""
+    return datetime.datetime.now(datetime.timezone.utc).astimezone().strftime("%Y-%m-%d")
 
 
 def normalize_summary(summary):