create-egregore 0.20.2 → 0.21.0-runtime-mvp.1

package/runtime/codex/egregore_runtime/status.py

@@ -0,0 +1,412 @@
+"""Bounded canonical status snapshots for activity and dashboard rituals."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import UTC, datetime, timedelta
+import hashlib
+import json
+from pathlib import Path
+import re
+from typing import Any, Iterable, Mapping
+
+from .artifacts import artifact_id_from_path, split_frontmatter
+from .contracts import ActorContext, Permission
+from .identity import actor_presentation_name
+from .policy import scope_allows_path
+from .questions import actor_aliases
+from .quests import CanonicalQuestService
+from .runtime import EgregoreRuntime
+from .todos import CanonicalTodoService
+
+
+STATUS_SCHEMA_VERSION = "egregore-status-snapshot/v1"
+STATUS_INDEX_SPEC_VERSION = "egregore-status-canonical/v1"
+MAX_SESSION_SOURCES = 200
+MAX_SESSION_RESULTS = 40
+MAX_QUEST_RESULTS = 20
+MAX_HANDOFF_RESULTS = 30
+MAX_QUESTION_RESULTS = 20
+
+
+def _scalar(fields: Mapping[str, Any], *names: str) -> str:
+    for name in names:
+        value = fields.get(name)
+        if value is not None and str(value).strip():
+            return str(value).strip()
+    return ""
+
+
+def _legacy_field(markdown: str, name: str) -> str:
+    match = re.search(rf"^\*\*{re.escape(name)}\*\*:\s*(.+)$", markdown, re.MULTILINE)
+    return match.group(1).strip() if match else ""
+
+
+def _heading(markdown: str) -> str:
+    match = re.search(r"^#(?:\s+[^:]+:)?\s*(.+)$", markdown, re.MULTILINE)
+    return match.group(1).strip() if match else ""
+
+
+def _parse_datetime(value: str) -> datetime | None:
+    if not value:
+        return None
+    try:
+        parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
+    except ValueError:
+        try:
+            parsed = datetime.fromisoformat(f"{value}T00:00:00+00:00")
+        except ValueError:
+            return None
+    return parsed.replace(tzinfo=UTC) if parsed.tzinfo is None else parsed.astimezone(UTC)
+
+
+def _actor_aliases(actor: ActorContext) -> frozenset[str]:
+    values = {actor.actor.actor_id, actor.actor.display_name}
+    values.update(str(value) for value in actor.actor.aliases.values())
+    if actor.account is not None:
+        values.update((actor.account.account_id, actor.account.display_name))
+        values.update(str(value) for value in actor.account.provider_aliases.values())
+    return frozenset(value.casefold() for value in values if value.strip())
+
+
+def _activity_status(record) -> str:
+    obligation = record.obligation_state.value
+    attention = record.attention_state.value
+    if obligation == "completed":
+        return "done"
+    if obligation in {"claimed", "read", "review_required"}:
+        return {"review_required": "review_due"}.get(obligation, obligation)
+    if attention == "expired" and record.intent == "fyi":
+        return "expired"
+    return "pending"
+
+
+def _handoff_row(actor: ActorContext, record) -> dict[str, Any]:
+    recipient = record.recipients[0] if len(record.recipients) == 1 else None
+    author = actor_presentation_name(
+        actor,
+        record.created_by,
+        record.created_by_alias,
+    )
+    return {
+        "id": record.artifact_id,
+        "sessionId": record.artifact_id,
+        "topic": record.title,
+        "author": author,
+        "from": author,
+        "authorActorId": record.created_by,
+        "recipient": actor_presentation_name(actor, recipient) if recipient else None,
+        "to": actor_presentation_name(actor, recipient) if recipient else None,
+        "date": record.created_at.date().isoformat(),
+        "filePath": record.canonical_path.removeprefix("memory/"),
+        "status": _activity_status(record),
+        "intent": record.intent or "unclassified",
+        "ageDays": record.age_days,
+        "authority": record.authority_state.value,
+        "attention": record.attention_state.value,
+        "obligation": record.obligation_state.value,
+        "lifecycleRevision": record.lifecycle_revision,
+        "lifecycleReason": record.terminal_reason,
+    }
+
+
+def _extract_open_threads(markdown: str) -> list[str]:
+    match = re.search(
+        r"^## (?:Open Threads|Next Steps)\s*$\n(.*?)(?=^## |\Z)",
+        markdown,
+        re.MULTILINE | re.DOTALL | re.IGNORECASE,
+    )
+    if not match:
+        return []
+    rows = []
+    for line in match.group(1).splitlines():
+        item = re.match(r"^\s*(?:[-*]|\d+\.)\s+(?:\[[ xX]\]\s*)?(.+)$", line)
+        if item and item.group(1).strip():
+            rows.append(item.group(1).strip())
+    return rows[:3]
+
+
+@dataclass(slots=True)
+class CanonicalStatusSnapshotService:
+    """Compile one authorized snapshot without projection or network authority."""
+
+    runtime: EgregoreRuntime
+    root: Path
+    clock: Any = None
+    memory_root: Path = field(init=False)
+
+    def __post_init__(self) -> None:
+        self.root = self.root.resolve()
+        self.memory_root = (self.root / "memory").resolve()
+        if self.clock is None:
+            self.clock = lambda: datetime.now(UTC)
+
+    def _decision(self, actor: ActorContext):
+        decision = self.runtime.authorize(actor, Permission.READ, ("org:status",))
+        if not decision.allowed:
+            raise PermissionError("organizational status read denied")
+        return decision
+
+    def _admin_visible(self, actor: ActorContext) -> bool:
+        """Egregore-surface admin protection for listings — fails closed."""
+
+        gate = getattr(self.runtime, "admin_gate", None)
+        if gate is None:
+            return True
+        try:
+            return bool(gate.actor_is_admin(actor))
+        except Exception:
+            return False
+
+    @staticmethod
+    def _fields_admin(fields: Mapping[str, Any]) -> bool:
+        return str(fields.get("admin", "")).strip().lower() == "true"
+
+    def _session_rows(
+        self,
+        actor: ActorContext,
+        *,
+        scopes: tuple[str, ...],
+        cutoff: datetime,
+    ) -> tuple[list[dict[str, Any]], int]:
+        candidates: list[Path] = []
+        for directory in ("sessions", "wraps", "handoffs"):
+            base = self.memory_root / directory
+            if base.is_dir():
+                candidates.extend(base.rglob("*.md"))
+        candidates = [path for path in candidates if not path.name.startswith("index")]
+        candidates.sort(key=lambda path: path.as_posix(), reverse=True)
+        considered = min(len(candidates), MAX_SESSION_SOURCES)
+        admin_visible = self._admin_visible(actor)
+        rows: list[dict[str, Any]] = []
+        for path in candidates[:MAX_SESSION_SOURCES]:
+            relative = path.relative_to(self.memory_root).as_posix()
+            canonical = f"memory/{relative}"
+            if not scope_allows_path(canonical, scopes):
+                continue
+            try:
+                markdown = path.read_text(encoding="utf-8")
+                fields, _ = split_frontmatter(markdown)
+            except (OSError, ValueError):
+                continue
+            occurred = _parse_datetime(
+                _scalar(fields, "date", "created_at", "created")
+                or _legacy_field(markdown, "Date")
+            )
+            if occurred is None or occurred < cutoff:
+                continue
+            author = (
+                _scalar(fields, "from", "author", "created_by", "started_by")
+                or _legacy_field(markdown, "Author")
+            )
+            topic = _scalar(fields, "topic", "title") or _heading(markdown)
+            branch = _scalar(fields, "branch") or _legacy_field(markdown, "Branch")
+            status = _scalar(fields, "status")
+            kind = relative.split("/", 1)[0]
+            if not status:
+                status = "wrapped" if kind == "wraps" else "handed_off" if kind == "handoffs" else "active"
+            if not admin_visible and self._fields_admin(fields):
+                # Tag-not-hide: existence stays visible, identity does not.
+                rows.append(
+                    {
+                        "id": "[admin]",
+                        "date": occurred.isoformat().replace("+00:00", "Z"),
+                        "topic": "[admin]",
+                        "branch": "",
+                        "author": "[admin]",
+                        "by": "[admin]",
+                        "status": "[admin]",
+                        "type": kind,
+                        "filePath": "[admin]",
+                        "openThreads": [],
+                    }
+                )
+                continue
+            rows.append(
+                {
+                    "id": _scalar(fields, "id", "session_id") or path.stem,
+                    "date": occurred.isoformat().replace("+00:00", "Z"),
+                    "topic": topic,
+                    "branch": branch,
+                    "author": author,
+                    "by": author,
+                    "status": status,
+                    "type": kind,
+                    "filePath": canonical,
+                    "openThreads": _extract_open_threads(markdown) if kind == "wraps" else [],
+                }
+            )
+        rows.sort(key=lambda row: row["date"], reverse=True)
+        return rows[:MAX_SESSION_RESULTS], considered
+
+    def _quests(self, actor: ActorContext, scopes: tuple[str, ...]) -> list[dict[str, Any]]:
+        service = CanonicalQuestService(memory_root=self.memory_root, write_document=self.runtime.write_document)
+        rows = []
+        admin_visible = self._admin_visible(actor)
+        gate = getattr(self.runtime, "admin_gate", None)
+        for quest in service.list(actor, authorized_scopes=scopes)[:MAX_QUEST_RESULTS]:
+            if (
+                not admin_visible
+                and gate is not None
+                and gate.path_is_admin(f"memory/quests/{quest.slug}.md")
+            ):
+                rows.append(
+                    {
+                        "quest": "[admin]",
+                        "slug": "[admin]",
+                        "title": "[admin]",
+                        "status": "[admin]",
+                        "projects": [],
+                        "priority": "",
+                        "started": "",
+                        "artifacts": 0,
+                        "daysSince": 0,
+                    }
+                )
+                continue
+            rows.append(
+                {
+                    "quest": quest.slug,
+                    "slug": quest.slug,
+                    "title": quest.title,
+                    "status": quest.status,
+                    "projects": list(quest.projects),
+                    "priority": quest.priority,
+                    "started": quest.started,
+                    "artifacts": len(re.findall(r"^\s*[-*]\s+\S", quest.body, re.MULTILINE)),
+                    "daysSince": max(0, (self.clock().date() - (_parse_datetime(quest.started) or self.clock()).date()).days),
+                }
+            )
+        return rows
+
+    def _todos(
+        self, actor: ActorContext, scopes: tuple[str, ...]
+    ) -> list[dict[str, Any]]:
+        aliases = [actor.actor.display_name, *actor.actor.aliases.values()]
+        person = next((str(value) for value in aliases if str(value).strip()), actor.actor.actor_id)
+        service = CanonicalTodoService(
+            memory_root=self.memory_root,
+            write_document=self.runtime.write_document,
+        )
+        if not scope_allows_path(service.canonical_path(person), scopes):
+            return []
+        snapshot = service.read(person)
+        return [dict(row) for row in snapshot.todos if row.get("status") in {"open", "blocked", "deferred"}]
+
+    def _questions(self, actor: ActorContext, limit: int) -> list[dict[str, Any]]:
+        decision = self.runtime.authorize(actor, Permission.DISCOVER, ("questions",))
+        if not decision.allowed:
+            return []
+        aliases = actor_aliases(actor)
+        directory = self.memory_root / "knowledge" / "questions"
+        rows = []
+        if not directory.is_dir():
+            return rows
+        for path in sorted(directory.glob("*.md"), reverse=True):
+            relative = path.relative_to(self.memory_root).as_posix()
+            canonical = f"memory/{relative}"
+            if not scope_allows_path(canonical, decision.scopes):
+                continue
+            try:
+                fields, _ = split_frontmatter(path.read_text(encoding="utf-8"))
+            except (OSError, ValueError):
+                continue
+            if str(fields.get("status") or "pending") != "pending":
+                continue
+            if not self._admin_visible(actor) and self._fields_admin(fields):
+                continue
+            recipient_actor = str(fields.get("to_actor_id") or "").strip()
+            recipient_alias = str(fields.get("to") or fields.get("addressed_to") or "").strip().removeprefix("@").casefold()
+            if recipient_actor:
+                addressed = recipient_actor == actor.actor.actor_id
+            else:
+                addressed = bool(recipient_alias and recipient_alias in aliases)
+            if not addressed:
+                continue
+            rows.append(
+                {
+                    "setId": str(fields.get("id") or artifact_id_from_path(relative)),
+                    "artifact_id": str(fields.get("id") or artifact_id_from_path(relative)),
+                    "topic": str(fields.get("topic") or fields.get("title") or path.stem),
+                    "from": str(fields.get("from") or fields.get("created_by") or "unknown"),
+                    "created": str(fields.get("created_at") or fields.get("created") or ""),
+                    "canonical_path": canonical,
+                }
+            )
+            if len(rows) >= limit:
+                break
+        return rows
+
+    def build(self, actor: ActorContext, *, time_range: str = "P7D") -> dict[str, Any]:
+        decision = self._decision(actor)
+        days = {"P1D": 1, "P7D": 7, "P30D": 30, "P365D": 365}.get(time_range, 7)
+        now = self.clock().astimezone(UTC)
+        sessions, source_count = self._session_rows(
+            actor,
+            scopes=decision.scopes,
+            cutoff=now - timedelta(days=days),
+        )
+        aliases = _actor_aliases(actor)
+        mine = [row for row in sessions if row["author"].casefold() in aliases]
+        team = [row for row in sessions if row["author"] and row["author"].casefold() not in aliases]
+
+        plan = self.runtime.lifecycle_plan(actor, artifact_types=("handoff",), user=actor.actor.display_name)
+        handoffs = [_handoff_row(actor, row) for row in plan.records][:MAX_HANDOFF_RESULTS]
+        active_handoffs = [row for row in handoffs if row["status"] in {"pending", "read", "claimed"}]
+        questions = self._questions(actor, MAX_QUESTION_RESULTS)
+        quests = self._quests(actor, decision.scopes)
+        todos = self._todos(actor, decision.scopes)
+        open_threads = [
+            {"id": row["id"], "date": row["date"], "topic": row["topic"], "threads": row["openThreads"]}
+            for row in mine
+            if row["openThreads"]
+        ][:3]
+        payload = {
+            "schema_version": STATUS_SCHEMA_VERSION,
+            "index_spec_version": STATUS_INDEX_SPEC_VERSION,
+            "source_revision": plan.source_revision,
+            "org_id": actor.profile.org_id,
+            "actor_id": actor.actor.actor_id,
+            "generated_at": now.isoformat(),
+            "bounds": {
+                "session_sources": source_count,
+                "session_source_limit": MAX_SESSION_SOURCES,
+                "session_result_limit": MAX_SESSION_RESULTS,
+                "handoff_result_limit": MAX_HANDOFF_RESULTS,
+                "question_result_limit": MAX_QUESTION_RESULTS,
+                "quest_result_limit": MAX_QUEST_RESULTS,
+            },
+            "sessions": sessions,
+            "my_sessions": mine,
+            "team_sessions": team,
+            "handoffs_to_me": handoffs,
+            "handoffs": active_handoffs,
+            "pending_questions": questions,
+            "questions": questions,
+            "answered_questions": [],
+            "quests": quests,
+            "todos": todos,
+            "open_threads": open_threads,
+            "stats": {
+                "totalSessions": len(mine),
+                "wrappedSessions": sum(row["status"] == "wrapped" for row in mine),
+                "openTodos": len(todos),
+                "oldestTodoDays": max(
+                    [max(0, (now.date() - (_parse_datetime(str(row.get("created") or "")) or now).date()).days) for row in todos],
+                    default=0,
+                ),
+            },
+            "lifecycle": {
+                "available": True,
+                "authority": "canonical_markdown",
+                "graph_dependency": False,
+                "index_spec_version": plan.index_spec_version,
+                "source_revision": plan.source_revision,
+                "snapshot_id": plan.snapshot_id,
+                "review_count": sum(row["status"] == "review_due" for row in handoffs),
+            },
+        }
+        digest_payload = {key: value for key, value in payload.items() if key != "generated_at"}
+        digest = hashlib.sha256(json.dumps(digest_payload, sort_keys=True).encode()).hexdigest()
+        payload["snapshot_id"] = f"status:{digest[:20]}"
+        return payload

package/runtime/codex/egregore_runtime/status_cli.py

@@ -0,0 +1,174 @@
+"""Runtime-neutral CLI for activity and dashboard status snapshots."""
+
+from __future__ import annotations
+
+import argparse
+from datetime import datetime
+import json
+import os
+from pathlib import Path
+import subprocess
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+from .contracts import Capability, Permission
+from .runtime import local_runtime
+from .status import CanonicalStatusSnapshotService
+
+
+def _root() -> Path:
+    return Path(os.environ.get("EGREGORE_ROOT") or Path.cwd()).resolve()
+
+
+def _session_id(root: Path) -> str:
+    if os.environ.get("EGREGORE_SESSION_ID"):
+        return os.environ["EGREGORE_SESSION_ID"]
+    try:
+        return (root / ".egregore-session-id").read_text(encoding="utf-8").strip() or "status-shell"
+    except OSError:
+        return "status-shell"
+
+
+def _connected_enrichment(root, config, runtime, actor, surface, time_range):
+    """Read one optional projection without allowing it to replace canonical state."""
+
+    if not actor.entitlements.has(Capability.CONNECTED_CONTROL_PLANE):
+        return {"status": "unavailable", "reason": "capability_missing"}
+    decision = runtime.authorize(actor, Permission.READ, ("projection:status",))
+    if not decision.allowed:
+        return {"status": "unavailable", "reason": "authorization_denied"}
+    api_url = str(config.get("api_url") or "").rstrip("/")
+    api_key = os.environ.get("EGREGORE_API_KEY", "")
+    if not api_key:
+        try:
+            for line in (root / ".env").read_text(encoding="utf-8").splitlines():
+                if line.startswith("EGREGORE_API_KEY="):
+                    api_key = line.split("=", 1)[1]
+                    break
+        except OSError:
+            pass
+    if not api_url or not api_key:
+        return {"status": "unavailable", "reason": "missing_config"}
+    aliases = dict(actor.actor.aliases)
+    if actor.account is not None:
+        aliases.update(actor.account.provider_aliases)
+    username = aliases.get("github") or aliases.get("github_username") or actor.actor.display_name
+    endpoint = "/api/activity/dashboard" if surface == "activity" else "/api/personal/dashboard"
+    query = {"github_username": username}
+    if surface == "dashboard":
+        query.update({"time_range": time_range, "session_id": actor.session_id})
+    request = Request(
+        f"{api_url}{endpoint}?{urlencode(query)}",
+        headers={"Authorization": f"Bearer {api_key}"},
+    )
+    try:
+        with urlopen(request, timeout=8) as response:  # noqa: S310 - configured control plane
+            body = json.loads(response.read().decode("utf-8"))
+    except HTTPError as exc:
+        reason = "auth_error" if exc.code in {401, 403} else "server_error"
+        return {"status": "offline", "reason": reason}
+    except (OSError, URLError, json.JSONDecodeError):
+        return {"status": "offline", "reason": "unreachable"}
+    return {"status": "connected", "reason": None, "payload": body}
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(prog="egregore-status")
+    parser.add_argument("surface", choices=("activity", "dashboard"))
+    parser.add_argument("--time-range", default="P7D", choices=("P1D", "P7D", "P30D", "P365D"))
+    parser.add_argument("--connected-enrichment", action="store_true")
+    args = parser.parse_args()
+    root = _root()
+    try:
+        config = json.loads((root / "egregore.json").read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        config = {}
+    runtime = local_runtime(root, push_remote=False)
+    actor = runtime.resolve_actor(session_id=_session_id(root), harness=os.environ.get("EGREGORE_RUNTIME", "shell"))
+    payload = CanonicalStatusSnapshotService(runtime, root).build(actor, time_range=args.time_range)
+    if args.surface == "dashboard":
+        payload["sessions"] = payload["my_sessions"]
+    branch = subprocess.run(
+        ["git", "-C", str(root), "branch", "--show-current"],
+        capture_output=True,
+        text=True,
+        check=False,
+    ).stdout.strip() or "unknown"
+    dirty = bool(
+        subprocess.run(
+            ["git", "-C", str(root), "status", "--porcelain"],
+            capture_output=True,
+            text=True,
+            check=False,
+        ).stdout.strip()
+    )
+    current_session_id = _session_id(root)
+    current = next(
+        (row for row in payload["my_sessions"] if row["id"] == current_session_id),
+        None,
+    ) or {
+        "id": current_session_id,
+        "status": "active",
+        "topic": None,
+        "branch": branch,
+    }
+    time_labels = {
+        "P1D": "today",
+        "P7D": "last 7 days",
+        "P30D": "last 30 days",
+        "P365D": "all time",
+    }
+    mode = str(config.get("mode") or ("connected" if config.get("api_url") else "local"))
+    payload.update(
+        {
+            "surface": args.surface,
+            "mode": mode,
+            "org": str(config.get("org_name") or actor.profile.name),
+            "me": actor.actor.display_name,
+            "date": datetime.now().strftime("%b %d"),
+            "range_label": time_labels[args.time_range],
+            "graph_status": "not_requested",
+            "graph_reason": "canonical_runtime_snapshot",
+            "current_session": current,
+            "git": {"branch": branch, "dirty": dirty},
+            "local_sessions": {
+                "sessions": payload["my_sessions"],
+                "session_count": len(payload["my_sessions"]),
+                "my_sessions": payload["my_sessions"],
+                "team_sessions": payload["team_sessions"],
+            },
+            "prs": [],
+            "checkins": [],
+            "focus_history": [],
+            "todos_merged": {
+                "activeTodoCount": len(payload["todos"]),
+                "blockedCount": sum(row.get("status") == "blocked" for row in payload["todos"]),
+                "deferredCount": sum(row.get("status") == "deferred" for row in payload["todos"]),
+                "staleBlockedCount": 0,
+                "lastCheckinDate": None,
+            },
+            "knowledge_gap": {"gapCount": 0},
+            "orphans": {"orphanCount": 0},
+            "trends": {
+                "resolution": {"avgDays": 0, "resolved": 0},
+                "throughput": {"created": 0, "completed": 0},
+                "capture": {"total": 0, "captured": 0},
+                "cadence": [],
+            },
+            "disk": {"handoffs": "", "decisions": ""},
+        }
+    )
+    if args.connected_enrichment:
+        enrichment = _connected_enrichment(
+            root, config, runtime, actor, args.surface, args.time_range
+        )
+        payload["connected_enrichment"] = enrichment
+        payload["graph_status"] = enrichment["status"]
+        payload["graph_reason"] = enrichment.get("reason")
+    print(json.dumps(payload, ensure_ascii=False, separators=(",", ":")))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())