create-egregore 0.19.3 → 0.19.6

package/runtime/pi/bin/worktree.sh

@@ -0,0 +1,198 @@
+#!/bin/bash
+# Worktree lifecycle management for Egregore sessions.
+# Each session gets an isolated worktree so parallel sessions don't conflict.
+#
+# Usage:
+#   bash bin/worktree.sh setup <worktree-path> <main-project-dir>
+#   bash bin/worktree.sh cleanup <worktree-path>
+#   bash bin/worktree.sh cleanup-stale <main-project-dir>
+#   bash bin/worktree.sh health [path]
+#   bash bin/worktree.sh list
+
+set -o pipefail
+
+if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
+  echo "Usage: worktree.sh <command> [args...]"
+  echo ""
+  echo "Worktree lifecycle management for Egregore sessions."
+  echo ""
+  echo "Commands:"
+  echo "  setup <path> <main-dir>         Set up symlinks for a new worktree"
+  echo "  cleanup <path>                  Remove a worktree"
+  echo "  cleanup-stale <main-dir>        List stale worktrees (manual review)"
+  echo "  health [path]                   Check worktree + branch health"
+  echo "  list                            List all git worktrees"
+  exit 0
+fi
+
+CMD="${1:-}"
+shift 2>/dev/null || true
+
+case "$CMD" in
+
+  setup)
+    # Setup symlinks so worktree shares state with main project.
+    # Args: <worktree-path> <main-project-dir>
+    WT_PATH="${1:?Usage: worktree.sh setup <worktree-path> <main-project-dir>}"
+    MAIN_DIR="${2:?Usage: worktree.sh setup <worktree-path> <main-project-dir>}"
+
+    # Symlink shared files from main project
+    for FILE in memory .env .egregore-state.json .egregore-session-id; do
+      SRC="$MAIN_DIR/$FILE"
+      DST="$WT_PATH/$FILE"
+      if [ "$FILE" = "memory" ]; then
+        # memory may be a symlink (follow to its target) or a real directory.
+        if [ -L "$SRC" ]; then
+          SRC=$(realpath "$SRC" 2>/dev/null) || continue
+        fi
+        [ -d "$SRC" ] || continue
+      else
+        [ -f "$SRC" ] || continue
+      fi
+      ln -sfn "$SRC" "$DST"
+    done
+
+    # Symlink egregore.json if not already present (committed file)
+    if [ -f "$MAIN_DIR/egregore.json" ] && [ ! -f "$WT_PATH/egregore.json" ]; then
+      ln -sfn "$MAIN_DIR/egregore.json" "$WT_PATH/egregore.json"
+    fi
+
+    # Find terminal TTY for statusline matching
+    _pid=$$
+    _tty=""
+    while [ "$_pid" -gt 1 ] 2>/dev/null; do
+      _ptty=$(ps -o tty= -p "$_pid" 2>/dev/null | tr -d ' ')
+      if [ -n "$_ptty" ] && [ "$_ptty" != "??" ]; then
+        _tty="$_ptty"
+        break
+      fi
+      _pid=$(ps -o ppid= -p "$_pid" 2>/dev/null | tr -d ' ')
+    done
+    [ -n "$_tty" ] && echo "$_tty" > "$WT_PATH/.egregore-worktree-tty"
+
+    echo "Worktree setup complete: $WT_PATH"
+    ;;
+
+  cleanup)
+    # Remove a worktree. Only called explicitly (ExitWorktree or manual).
+    # Args: <worktree-path>
+    WT_PATH="${1:?Usage: worktree.sh cleanup <worktree-path>}"
+
+    # Remove from instance registry if accidentally registered
+    REGISTRY="$HOME/.egregore/instances.json"
+    if [ -f "$REGISTRY" ]; then
+      RESOLVED_WT=$(realpath "$WT_PATH" 2>/dev/null || echo "$WT_PATH")
+      UPDATED=$(jq --arg p "$RESOLVED_WT" '[.[] | select(.path != $p)]' "$REGISTRY" 2>/dev/null)
+      if [ -n "$UPDATED" ]; then
+        echo "$UPDATED" > "$REGISTRY.tmp" && mv "$REGISTRY.tmp" "$REGISTRY"
+      fi
+    fi
+
+    git worktree remove "$WT_PATH" --force 2>/dev/null || true
+    git worktree prune 2>/dev/null || true
+
+    echo "Worktree cleaned up: $WT_PATH"
+    ;;
+
+  cleanup-stale)
+    # List stale worktrees for manual review. Does NOT auto-delete.
+    # Run interactively or from a cleanup command — never from session-start.
+    # Args: <main-project-dir>
+    MAIN_DIR="${1:?Usage: worktree.sh cleanup-stale <main-project-dir>}"
+    WT_BASE="$MAIN_DIR/.claude/worktrees"
+
+    if [ ! -d "$WT_BASE" ]; then
+      echo "No worktrees directory."
+      exit 0
+    fi
+
+    NOW_TS=$(date +%s)
+    FOUND=0
+
+    for WT_DIR in "$WT_BASE"/*/; do
+      [ -d "$WT_DIR" ] || continue
+
+      WT_NAME=$(basename "$WT_DIR")
+      WT_BRANCH=""
+      STATUS="unknown"
+
+      if [ -f "$WT_DIR/.git" ]; then
+        WT_BRANCH=$(git -C "$WT_DIR" branch --show-current 2>/dev/null || echo "?")
+
+        # Check if merged
+        if [ "$WT_BRANCH" != "?" ] && [ "$WT_BRANCH" != "develop" ] && [ "$WT_BRANCH" != "main" ]; then
+          if git merge-base --is-ancestor "$(git -C "$WT_DIR" rev-parse HEAD 2>/dev/null)" \
+               "$(git -C "$MAIN_DIR" rev-parse origin/develop 2>/dev/null)" 2>/dev/null; then
+            STATUS="merged"
+          else
+            STATUS="active"
+          fi
+        fi
+      else
+        STATUS="broken"
+      fi
+
+      # Age
+      WT_MTIME=$(stat -f %m "$WT_DIR" 2>/dev/null || stat -c %Y "$WT_DIR" 2>/dev/null || echo "$NOW_TS")
+      WT_AGE_H=$(( (NOW_TS - WT_MTIME) / 3600 ))
+
+      if [ "$STATUS" = "merged" ] || [ "$STATUS" = "broken" ] || [ "$WT_AGE_H" -gt 24 ]; then
+        echo "  $WT_NAME  [$STATUS]  ${WT_AGE_H}h old  branch: ${WT_BRANCH:-none}"
+        FOUND=$((FOUND + 1))
+      fi
+    done
+
+    if [ "$FOUND" -eq 0 ]; then
+      echo "No stale worktrees found."
+    else
+      echo ""
+      echo "To remove: bash bin/worktree.sh cleanup <path>"
+    fi
+
+    # Prune git's internal worktree list
+    git -C "$MAIN_DIR" worktree prune 2>/dev/null || true
+    ;;
+
+  health)
+    # Check worktree + branch health
+    # Exit codes: 0=healthy, 1=not_worktree, 2=branch_gone, 3=protected_branch
+    WT_PATH="${1:-$(pwd)}"
+
+    if [ ! -f "$WT_PATH/.git" ]; then
+      echo '{"status":"not_worktree"}'
+      exit 1
+    fi
+
+    BRANCH=$(git -C "$WT_PATH" branch --show-current 2>/dev/null || echo "")
+
+    case "$BRANCH" in
+      develop|main|master)
+        jq -n --arg branch "$BRANCH" '{status: "protected_branch", branch: $branch}'
+        exit 3
+        ;;
+    esac
+
+    # Check if remote branch still exists
+    git -C "$WT_PATH" fetch origin --prune --quiet 2>/dev/null || true
+    if ! git -C "$WT_PATH" ls-remote --heads origin "$BRANCH" 2>/dev/null | grep -q "$BRANCH"; then
+      if git -C "$WT_PATH" branch -r --merged origin/develop 2>/dev/null | grep -q "origin/$BRANCH" 2>/dev/null; then
+        jq -n --arg branch "$BRANCH" '{status: "merged", branch: $branch}'
+      else
+        jq -n --arg branch "$BRANCH" '{status: "remote_deleted", branch: $branch}'
+      fi
+      exit 2
+    fi
+
+    jq -n --arg branch "$BRANCH" '{status: "healthy", branch: $branch}'
+    exit 0
+    ;;
+
+  list)
+    git worktree list
+    ;;
+
+  *)
+    echo "Usage: worktree.sh {setup|cleanup|cleanup-stale|health|list}" >&2
+    exit 1
+    ;;
+esac

package/runtime/pi/manifest.json

@@ -0,0 +1,176 @@
+{
+  "source": "egregore-pi-meta-harness",
+  "policy": "Pi-native lifecycle layer over the public-safe portable Codex skill corpus",
+  "skillCount": 56,
+  "skills": [
+    "activity",
+    "add",
+    "announce",
+    "answer",
+    "archive",
+    "ask",
+    "branch",
+    "checkup",
+    "commit",
+    "contribute",
+    "dark-mode",
+    "dashboard",
+    "deep-reflect",
+    "delete-user",
+    "egregore-voice",
+    "emissary",
+    "env",
+    "handoff",
+    "harvest",
+    "ingest",
+    "ingest-google",
+    "ingest-user-interview",
+    "invite",
+    "issue",
+    "me",
+    "meeting",
+    "minion",
+    "note",
+    "onboarding",
+    "pr",
+    "project",
+    "pull",
+    "push",
+    "quest",
+    "quest-suggest",
+    "reflect",
+    "review-pr",
+    "save",
+    "scroll",
+    "search",
+    "session-view",
+    "setup",
+    "summon",
+    "sync-repos",
+    "telegram-connect",
+    "telemetry",
+    "test",
+    "the-spiral",
+    "thread",
+    "todo",
+    "tui-design",
+    "tutorial",
+    "update",
+    "view",
+    "visual-explain",
+    "wrap"
+  ],
+  "files": [
+    ".codex/config.toml",
+    ".codex/hooks.json",
+    ".codex/hooks/branch-guard.js",
+    ".codex/hooks/search-hint.js",
+    ".codex/skills/activity/SKILL.md",
+    ".codex/skills/add/SKILL.md",
+    ".codex/skills/announce/SKILL.md",
+    ".codex/skills/answer/SKILL.md",
+    ".codex/skills/archive/SKILL.md",
+    ".codex/skills/ask/SKILL.md",
+    ".codex/skills/branch/SKILL.md",
+    ".codex/skills/checkup/SKILL.md",
+    ".codex/skills/commit/SKILL.md",
+    ".codex/skills/contribute/SKILL.md",
+    ".codex/skills/dark-mode/SKILL.md",
+    ".codex/skills/dashboard/SKILL.md",
+    ".codex/skills/deep-reflect/SKILL.md",
+    ".codex/skills/delete-user/SKILL.md",
+    ".codex/skills/egregore-voice/SKILL.md",
+    ".codex/skills/emissary/SKILL.md",
+    ".codex/skills/env/SKILL.md",
+    ".codex/skills/handoff/SKILL.md",
+    ".codex/skills/harvest/SKILL.md",
+    ".codex/skills/ingest-google/SKILL.md",
+    ".codex/skills/ingest-user-interview/SKILL.md",
+    ".codex/skills/ingest/SKILL.md",
+    ".codex/skills/invite/SKILL.md",
+    ".codex/skills/issue/SKILL.md",
+    ".codex/skills/me/SKILL.md",
+    ".codex/skills/meeting/SKILL.md",
+    ".codex/skills/minion/SKILL.md",
+    ".codex/skills/note/SKILL.md",
+    ".codex/skills/onboarding/SKILL.md",
+    ".codex/skills/pr/SKILL.md",
+    ".codex/skills/project/SKILL.md",
+    ".codex/skills/pull/SKILL.md",
+    ".codex/skills/push/SKILL.md",
+    ".codex/skills/quest-suggest/SKILL.md",
+    ".codex/skills/quest/SKILL.md",
+    ".codex/skills/reflect/SKILL.md",
+    ".codex/skills/review-pr/SKILL.md",
+    ".codex/skills/save/SKILL.md",
+    ".codex/skills/scroll/SKILL.md",
+    ".codex/skills/scroll/agents/openai.yaml",
+    ".codex/skills/scroll/assets/shell.html",
+    ".codex/skills/search/SKILL.md",
+    ".codex/skills/session-view/SKILL.md",
+    ".codex/skills/setup/SKILL.md",
+    ".codex/skills/summon/SKILL.md",
+    ".codex/skills/sync-repos/SKILL.md",
+    ".codex/skills/telegram-connect/SKILL.md",
+    ".codex/skills/telemetry/SKILL.md",
+    ".codex/skills/test/SKILL.md",
+    ".codex/skills/the-spiral/SKILL.md",
+    ".codex/skills/thread/SKILL.md",
+    ".codex/skills/todo/SKILL.md",
+    ".codex/skills/tui-design/SKILL.md",
+    ".codex/skills/tutorial/SKILL.md",
+    ".codex/skills/update/SKILL.md",
+    ".codex/skills/view/SKILL.md",
+    ".codex/skills/view/agents/openai.yaml",
+    ".codex/skills/view/assets/compose-scaffold.html",
+    ".codex/skills/visual-explain/SKILL.md",
+    ".codex/skills/wrap/SKILL.md",
+    ".codex/spec-manifest.json",
+    ".pi/APPEND_SYSTEM.md",
+    ".pi/extensions/egregore.ts",
+    ".pi/settings.json",
+    ".pi/spec-manifest.json",
+    "AGENTS.md",
+    "bin/activity-data.sh",
+    "bin/agent.sh",
+    "bin/codex-install-skills.sh",
+    "bin/codex-render-spec.mjs",
+    "bin/codex-session-start.sh",
+    "bin/codex-skill-render.mjs",
+    "bin/codex-sync-skills.sh",
+    "bin/dashboard-data.sh",
+    "bin/graph-batch.sh",
+    "bin/graph-op.sh",
+    "bin/graph-wal.sh",
+    "bin/graph.sh",
+    "bin/handoff-pr-backfill.sh",
+    "bin/handoff-run.sh",
+    "bin/handoff-save-egregore.sh",
+    "bin/index-handoff.sh",
+    "bin/lib/artifact-id.sh",
+    "bin/lib/config.sh",
+    "bin/lib/context.sh",
+    "bin/lib/dashboard-artifact.sh",
+    "bin/lib/ensure-develop.sh",
+    "bin/lib/git-sync.sh",
+    "bin/lib/greeting.sh",
+    "bin/lib/hash.sh",
+    "bin/lib/identity.sh",
+    "bin/lib/metrics.sh",
+    "bin/lib/permissions.sh",
+    "bin/lib/time.sh",
+    "bin/lib/worktree-links.sh",
+    "bin/notify.sh",
+    "bin/pi-branch-policy.mjs",
+    "bin/pi-product-workflows.mjs",
+    "bin/pi-render-spec.mjs",
+    "bin/pi-session-start.sh",
+    "bin/publish-artifact.sh",
+    "bin/publish-references.sh",
+    "bin/repo-state.sh",
+    "bin/telemetry.sh",
+    "bin/worktree-create.sh",
+    "bin/worktree-remove.sh",
+    "bin/worktree.sh"
+  ]
+}