mccloud-assistant 0.1.0__tar.gz

mccloud_assistant-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: mccloud-assistant
+Version: 0.1.0
+Summary: McCloud — personal AI assistant TUI
+Author: stephen-daq
+License: MIT
+Project-URL: Homepage, https://github.com/stephen-daq/my-chief-of-staff
+Project-URL: Repository, https://github.com/stephen-daq/my-chief-of-staff
+Keywords: tui,terminal,ai,assistant,claude
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: textual>=0.83.0
+Requires-Dist: anthropic>=0.40
+Requires-Dist: google-api-python-client>=2.0
+Requires-Dist: google-auth-oauthlib>=1.0
+Requires-Dist: slack_sdk>=3.0
+Provides-Extra: server
+Requires-Dist: fastapi>=0.100; extra == "server"
+Requires-Dist: uvicorn>=0.20; extra == "server"
+
+# mccloud
+
+Personal AI assistant TUI — powered by Claude.
+
+## Install
+
+```sh
+pipx install mccloud-assistant
+```
+
+### From source
+
+```sh
+git clone https://github.com/stephen-daq/mccloud
+cd mccloud
+make install
+```
+
+## Run
+
+```sh
+mccloud
+```
+
+Or from source:
+
+```sh
+make run
+```
+
+## Keys
+
+| key | pane |
+| --- | --- |
+| `1` | Reminders (tasks + Apple Reminders) |
+| `2` | Calendar (events + meetings) |
+| `3` | Obsidian |
+| `4` | Notion |
+| `5` | Slack |
+| `c` | Chat |
+| `p` | Prompts |
+| `?` | Help |
+| `j / k` | Next / previous pane |
+| `] / [` | Same as j / k |
+| `h` | Focus sidebar |
+| `l` | Focus main content |
+| `q` | Quit |
+
+### Inside Prompts
+| key | action |
+| --- | --- |
+| `↑ / ↓` | Move between features |
+| `e` | Open highlighted prompt in Zed |
+
+## Prompt files
+
+Each feature gets a system prompt at `prompts/<feature-id>.md`. Press `e` in the Prompts pane to create and edit one. These files are the instructions Claude will follow when that feature is eventually wired up.
+
+## Layout
+
+```
+src/chief_of_staff/
+  app.py        # FEATURES list (single source of truth), all panes, ChiefOfStaffApp
+  app.tcss      # Textual CSS
+  __main__.py   # entry point — `cos` after `make install`
+prompts/        # per-feature system prompt files (created on demand by pressing e)
+```
+
+Add a new feature by appending a `Feature(...)` to `FEATURES` in `app.py`. The keybinding, sidebar entry, and placeholder pane all flow from that list.

mccloud_assistant-0.1.0/README.md

@@ -0,0 +1,69 @@
+# mccloud
+
+Personal AI assistant TUI — powered by Claude.
+
+## Install
+
+```sh
+pipx install mccloud-assistant
+```
+
+### From source
+
+```sh
+git clone https://github.com/stephen-daq/mccloud
+cd mccloud
+make install
+```
+
+## Run
+
+```sh
+mccloud
+```
+
+Or from source:
+
+```sh
+make run
+```
+
+## Keys
+
+| key | pane |
+| --- | --- |
+| `1` | Reminders (tasks + Apple Reminders) |
+| `2` | Calendar (events + meetings) |
+| `3` | Obsidian |
+| `4` | Notion |
+| `5` | Slack |
+| `c` | Chat |
+| `p` | Prompts |
+| `?` | Help |
+| `j / k` | Next / previous pane |
+| `] / [` | Same as j / k |
+| `h` | Focus sidebar |
+| `l` | Focus main content |
+| `q` | Quit |
+
+### Inside Prompts
+| key | action |
+| --- | --- |
+| `↑ / ↓` | Move between features |
+| `e` | Open highlighted prompt in Zed |
+
+## Prompt files
+
+Each feature gets a system prompt at `prompts/<feature-id>.md`. Press `e` in the Prompts pane to create and edit one. These files are the instructions Claude will follow when that feature is eventually wired up.
+
+## Layout
+
+```
+src/chief_of_staff/
+  app.py        # FEATURES list (single source of truth), all panes, ChiefOfStaffApp
+  app.tcss      # Textual CSS
+  __main__.py   # entry point — `cos` after `make install`
+prompts/        # per-feature system prompt files (created on demand by pressing e)
+```
+
+Add a new feature by appending a `Feature(...)` to `FEATURES` in `app.py`. The keybinding, sidebar entry, and placeholder pane all flow from that list.

mccloud_assistant-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "mccloud-assistant"
+version = "0.1.0"
+description = "McCloud — personal AI assistant TUI"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [{ name = "stephen-daq" }]
+keywords = ["tui", "terminal", "ai", "assistant", "claude"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "textual>=0.83.0",
+    "anthropic>=0.40",
+    "google-api-python-client>=2.0",
+    "google-auth-oauthlib>=1.0",
+    "slack_sdk>=3.0",
+]
+
+[project.optional-dependencies]
+server = [
+    "fastapi>=0.100",
+    "uvicorn>=0.20",
+]
+
+[project.urls]
+Homepage = "https://github.com/stephen-daq/my-chief-of-staff"
+Repository = "https://github.com/stephen-daq/my-chief-of-staff"
+
+[project.scripts]
+mccloud = "mccloud.__main__:main"
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

mccloud_assistant-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mccloud_assistant-0.1.0/src/mccloud/__main__.py

@@ -0,0 +1,9 @@
+from mccloud.app import McCloudApp
+
+
+def main() -> None:
+    McCloudApp().run()
+
+
+if __name__ == "__main__":
+    main()

mccloud_assistant-0.1.0/src/mccloud/app.py

@@ -0,0 +1,243 @@
+from __future__ import annotations
+
+import json
+
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Horizontal, ScrollableContainer, Vertical
+from textual.widgets import ContentSwitcher, Header, Label, ListItem, ListView, Static
+
+from mccloud.features import FEATURES, FEATURES_BY_ID, FEATURE_IDS, Feature
+from mccloud.panes._config import _get_enabled_features, _get_tabs_config, _read_assistant_name, _get_user_name, _GENERAL_CONFIG
+from mccloud.panes.calendar import CalendarPane
+from mccloud.panes.chat import ChatPane
+from mccloud.panes.config import ConfigScreen, GeneralPane, UserPane
+from mccloud.panes.github import GitHubPane
+from mccloud.panes.notes import ObsidianPane
+from mccloud.panes.reminders import RemindersPane
+from mccloud.panes.slack import SlackPane
+
+
+class FeaturePane(ScrollableContainer):
+    def __init__(self, feature: Feature) -> None:
+        super().__init__(id=feature.id)
+        self.feature = feature
+
+    def compose(self) -> ComposeResult:
+        f = self.feature
+        yield Static(f.name, classes="title")
+        yield Static(f.summary, classes="summary")
+        if f.planned:
+            yield Static("Planned", classes="section-header")
+            for item in f.planned:
+                yield Static(f"  •  {item}", classes="bullet")
+        yield Static("Not yet implemented — UI scaffolding only.", classes="not-implemented")
+
+
+class HelpPane(ScrollableContainer):
+    def compose(self) -> ComposeResult:
+        yield Static("Help", classes="title")
+        yield Static("Jump to any pane", classes="section-header")
+        for i, f in enumerate(_get_enabled_features(), 1):
+            yield Static(f"  [b]{i}[/b]  {f.name}", classes="bullet")
+        yield Static("  [b]?[/b]  This screen", classes="bullet")
+        yield Static("Navigation", classes="section-header")
+        yield Static("  [b]j / k[/b]  Next / previous pane", classes="bullet")
+        yield Static("  [b]] / [[/b]  Same as j / k", classes="bullet")
+        yield Static("  [b]h[/b]  Focus the sidebar nav", classes="bullet")
+        yield Static("  [b]l[/b]  Focus the main content area", classes="bullet")
+        yield Static("  [b]q[/b]  Quit", classes="bullet")
+        yield Static("Reminders pane", classes="section-header")
+        yield Static("  [b]↑ / ↓[/b]  Move between reminders", classes="bullet")
+        yield Static("  [b]enter[/b]  Mark reminder as done", classes="bullet")
+        yield Static("  [b]e[/b]  Edit reminder title", classes="bullet")
+        yield Static("  [b]d[/b]  Delete reminder (confirmation required)", classes="bullet")
+        yield Static("  [b]a[/b]  Add new reminder", classes="bullet")
+        yield Static("  [b]r[/b]  Refresh from Apple Reminders", classes="bullet")
+        yield Static("Prompts pane", classes="section-header")
+        yield Static("  [b]↑ / ↓[/b]  Move between features", classes="bullet")
+        yield Static("  [b]e[/b]  Open highlighted skill in editor", classes="bullet")
+
+
+class AppFooter(Horizontal):
+    DEFAULT_CSS = """
+    AppFooter {
+        dock: bottom;
+        background: $panel;
+        height: 1;
+        padding: 0 1;
+    }
+    #footer-left  { width: 1fr; }
+    #footer-right { width: auto; text-align: right; }
+    """
+
+    _LEFT  = [("j", "↑"), ("k", "↓"), ("l", "→"), ("h", "←"), ("q", "quit")]
+    _RIGHT = [("*", "config"), ("?", "help")]
+
+    @staticmethod
+    def _pill(key: str, desc: str) -> str:
+        return (
+            f"[bold white on #0e4780] {key} [/bold white on #0e4780]"
+            f"[on #071e36] {desc} [/on #071e36]"
+        )
+
+    def compose(self) -> ComposeResult:
+        left  = " ".join(self._pill(k, d) for k, d in self._LEFT)
+        right = " ".join(self._pill(k, d) for k, d in self._RIGHT)
+        yield Static(left,  markup=True, id="footer-left")
+        yield Static(right, markup=True, id="footer-right")
+
+
+class McCloudApp(App):
+    TITLE = "McCloud"
+    CSS_PATH = "app.tcss"
+
+    BINDINGS = [
+        Binding("*", "config", "Config", show=False),
+        Binding("?", "switch('help')", "Help"),
+        Binding("j", "cycle(1)", "Next pane"),
+        Binding("k", "cycle(-1)", "Prev pane"),
+        Binding("]", "cycle(1)", "", show=False),
+        Binding("[", "cycle(-1)", "", show=False),
+        Binding("h", "focus_sidebar", "", show=False),
+        Binding("l", "focus_main", "", show=False),
+        Binding("q", "quit", "Quit"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        enabled = _get_enabled_features()
+        initial = enabled[0].id if enabled else "help"
+        yield Header(show_clock=True)
+        with Horizontal(id="body"):
+            with Vertical(id="sidebar"):
+                yield Static("McCloud", id="brand")
+                yield ListView(
+                    *[
+                        ListItem(Label(f"  [b]{i}[/b]   {f.name}"), id=f"nav-{f.id}")
+                        for i, f in enumerate(enabled, 1)
+                    ],
+                    id="nav",
+                )
+                yield Static("[dim]? for help[/dim]", id="hint")
+            with ContentSwitcher(initial=initial, id="main"):
+                for f in enabled:
+                    if f.id == "reminders":
+                        yield RemindersPane(id="reminders")
+                    elif f.id == "calendar":
+                        yield CalendarPane(id="calendar")
+                    elif f.id == "chat":
+                        yield ChatPane(id="chat")
+                    elif f.id == "slack":
+                        yield SlackPane(id="slack")
+                    elif f.id == "github":
+                        yield GitHubPane(id="github")
+                    elif f.id == "obsidian":
+                        yield ObsidianPane(id="obsidian")
+                    else:
+                        yield FeaturePane(f)
+                yield HelpPane(id="help")
+        yield AppFooter()
+
+    def on_mount(self) -> None:
+        enabled = _get_enabled_features()
+        initial = enabled[0].id if enabled else "help"
+        self._sync_sidebar(initial)
+        self._apply_assistant_name(_read_assistant_name())
+        self._apply_user_name(_get_user_name())
+        if _GENERAL_CONFIG.exists():
+            try:
+                saved_theme = json.loads(_GENERAL_CONFIG.read_text()).get("theme", "")
+                if saved_theme and saved_theme in getattr(self, "available_themes", {}):
+                    self.theme = saved_theme
+            except Exception:
+                pass
+
+    def on_key(self, event) -> None:
+        if event.character and event.character.isdigit():
+            n = int(event.character)
+            enabled = _get_enabled_features()
+            if 0 < n <= len(enabled):
+                self.action_switch(enabled[n - 1].id)
+                event.stop()
+
+    def _apply_assistant_name(self, name: str) -> None:
+        self.title = name
+        try:
+            enabled = _get_enabled_features()
+            idx = next((i for i, f in enumerate(enabled, 1) if f.id == "chat"), None)
+            if idx is not None:
+                label = self.query_one("#nav-chat ListItem Label", Label)
+                label.update(f"  [b]{idx}[/b]   {name}")
+        except Exception:
+            pass
+
+    def _apply_user_name(self, name: str) -> None:
+        self.sub_title = f"for {name}" if name else ""
+
+    def on_general_pane_assistant_name_changed(self, event: GeneralPane.AssistantNameChanged) -> None:
+        self._apply_assistant_name(event.name)
+
+    def on_user_pane_user_name_changed(self, event: UserPane.UserNameChanged) -> None:
+        self._apply_user_name(event.name)
+
+    def action_switch(self, target: str) -> None:
+        if target in FEATURES_BY_ID and not _get_tabs_config().get(target, True):
+            return
+        self.query_one(ContentSwitcher).current = target
+        self._sync_sidebar(target)
+
+    def action_config(self) -> None:
+        self.push_screen(ConfigScreen())
+
+    def action_cycle(self, direction: int) -> None:
+        from textual.widgets import OptionList
+        focused = self.screen.focused
+        if isinstance(focused, OptionList):
+            focused.action_cursor_down() if direction > 0 else focused.action_cursor_up()
+            return
+        if isinstance(focused, ListView) and focused.id != "nav":
+            focused.action_cursor_down() if direction > 0 else focused.action_cursor_up()
+            return
+        enabled_ids = [f.id for f in _get_enabled_features()]
+        if not enabled_ids:
+            return
+        current = self.query_one(ContentSwitcher).current or enabled_ids[0]
+        if current not in enabled_ids:
+            target = enabled_ids[0]
+        else:
+            target = enabled_ids[(enabled_ids.index(current) + direction) % len(enabled_ids)]
+        self.action_switch(target)
+
+    def action_focus_sidebar(self) -> None:
+        self.query_one("#nav", ListView).focus()
+
+    def action_focus_main(self) -> None:
+        cs = self.query_one(ContentSwitcher)
+        pane_id = cs.current or FEATURE_IDS[0]
+        try:
+            pane = self.query_one(f"#{pane_id}")
+            if hasattr(pane, "focus_content"):
+                pane.focus_content()
+                return
+            if pane.can_focus:
+                pane.focus()
+            else:
+                for widget in pane.walk_children():
+                    if widget.can_focus:
+                        widget.focus()
+                        return
+        except Exception:
+            pass
+
+    def _sync_sidebar(self, target: str) -> None:
+        nav = self.query_one("#nav", ListView)
+        for i, f in enumerate(_get_enabled_features()):
+            if f.id == target:
+                nav.index = i
+                return
+
+    def on_list_view_selected(self, event: ListView.Selected) -> None:
+        item_id = event.item.id or ""
+        target = item_id.removeprefix("nav-")
+        if target and target in FEATURES_BY_ID:
+            self.action_switch(target)

mccloud_assistant-0.1.0/src/mccloud/calendar_cli.py

@@ -0,0 +1,190 @@
+"""Google Calendar data layer."""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+import httplib2
+import google_auth_httplib2
+from google.auth.transport.requests import Request
+from google.oauth2.credentials import Credentials
+from google_auth_oauthlib.flow import InstalledAppFlow
+from googleapiclient.discovery import build
+
+SCOPES = ["https://www.googleapis.com/auth/calendar"]
+_CREDS_DIR = Path(__file__).parent.parent.parent / ".credentials"
+_TOKEN_FILE = _CREDS_DIR / "google_token.json"
+_CLIENT_SECRET = next(_CREDS_DIR.glob("client_secret_*.json"), None)
+
+_JOIN_RE = re.compile(
+    r"https?://(?:"
+    r"[\w-]+\.zoom\.us/[^\s<\"']+"
+    r"|meet\.google\.com/[^\s<\"']+"
+    r"|teams\.microsoft\.com/[^\s<\"']+"
+    r"|[\w-]+\.webex\.com/[^\s<\"']+"
+    r")"
+)
+
+
+def is_authenticated() -> bool:
+    if not _TOKEN_FILE.exists():
+        return False
+    try:
+        creds = Credentials.from_authorized_user_file(str(_TOKEN_FILE), SCOPES)
+        if creds.valid:
+            return True
+        if creds.expired and creds.refresh_token:
+            creds.refresh(Request())
+            _TOKEN_FILE.write_text(creds.to_json())
+            return True
+    except Exception:
+        pass
+    return False
+
+
+def authenticate() -> None:
+    if not _CLIENT_SECRET:
+        raise FileNotFoundError("No client_secret_*.json found in .credentials/")
+    flow = InstalledAppFlow.from_client_secrets_file(str(_CLIENT_SECRET), SCOPES)
+    creds = flow.run_local_server(port=0)
+    _CREDS_DIR.mkdir(exist_ok=True)
+    _TOKEN_FILE.write_text(creds.to_json())
+
+
+def _creds() -> Credentials:
+    creds = Credentials.from_authorized_user_file(str(_TOKEN_FILE), SCOPES)
+    if creds.expired and creds.refresh_token:
+        creds.refresh(Request())
+        _TOKEN_FILE.write_text(creds.to_json())
+    return creds
+
+
+@dataclass
+class CalendarEvent:
+    id: str
+    title: str
+    start: datetime
+    end: datetime
+    all_day: bool = False
+    location: str = ""
+    description: str = ""
+    calendar_name: str = ""
+    calendar_id: str = ""
+    join_url: str = ""
+    html_link: str = ""
+
+    @property
+    def duration_minutes(self) -> int:
+        return int((self.end - self.start).total_seconds() / 60)
+
+
+def _extract_join_url(event: dict) -> str:
+    for field in ("location", "description", "hangoutLink"):
+        text = event.get(field, "") or ""
+        m = _JOIN_RE.search(text)
+        if m:
+            return m.group(0)
+    return ""
+
+
+def _build_service():
+    creds = _creds()
+    http = google_auth_httplib2.AuthorizedHttp(creds, http=httplib2.Http(timeout=5))
+    return build("calendar", "v3", http=http, cache_discovery=False)
+
+
+def get_calendars() -> list[dict]:
+    service = _build_service()
+    items = service.calendarList().list().execute().get("items", [])
+    return [{"id": c["id"], "name": c.get("summary", c["id"])} for c in items]
+
+
+def get_user_domain() -> str:
+    """Return the domain of the authenticated user's email, e.g. 'arena-ai.com'."""
+    service = _build_service()
+    cal = service.calendarList().get(calendarId="primary").execute()
+    email = cal.get("id", "")
+    return email.split("@")[1] if "@" in email else ""
+
+
+def add_calendar(email: str) -> str:
+    """Subscribe to another person's calendar. Returns the calendar's display name."""
+    service = _build_service()
+    result = service.calendarList().insert(body={"id": email}).execute()
+    return result.get("summary", email)
+
+
+def remove_calendar(calendar_id: str) -> None:
+    """Unsubscribe from a calendar by its ID (usually the owner's email)."""
+    service = _build_service()
+    service.calendarList().delete(calendarId=calendar_id).execute()
+
+
+def get_events(days: int = 7) -> list[CalendarEvent]:
+    service = _build_service()
+
+    now = datetime.now(tz=timezone.utc)
+    time_min = now.isoformat()
+    time_max = now.replace(hour=23, minute=59, second=59).isoformat()
+    if days > 1:
+        from datetime import timedelta
+        time_max = (now + timedelta(days=days - 1)).replace(
+            hour=23, minute=59, second=59
+        ).isoformat()
+
+    calendars = service.calendarList().list().execute().get("items", [])
+
+    events: list[CalendarEvent] = []
+    for cal in calendars:
+        if cal.get("accessRole") not in ("owner", "writer", "reader"):
+            continue
+        result = service.events().list(
+            calendarId=cal["id"],
+            timeMin=time_min,
+            timeMax=time_max,
+            singleEvents=True,
+            orderBy="startTime",
+            maxResults=50,
+        ).execute()
+        for e in result.get("items", []):
+            if e.get("status") == "cancelled":
+                continue
+            start_raw = e.get("start", {})
+            end_raw = e.get("end", {})
+            all_day = "date" in start_raw and "dateTime" not in start_raw
+            if all_day:
+                start = datetime.fromisoformat(start_raw["date"]).replace(
+                    tzinfo=timezone.utc
+                )
+                end = datetime.fromisoformat(end_raw["date"]).replace(
+                    tzinfo=timezone.utc
+                )
+            else:
+                start = datetime.fromisoformat(start_raw["dateTime"]).astimezone()
+                end = datetime.fromisoformat(end_raw["dateTime"]).astimezone()
+            events.append(CalendarEvent(
+                id=e["id"],
+                title=e.get("summary", "(no title)"),
+                start=start,
+                end=end,
+                all_day=all_day,
+                location=e.get("location", ""),
+                description=re.sub(r"<[^>]+>", "", e.get("description", "")).strip(),
+                calendar_name=cal.get("summary", ""),
+                calendar_id=cal["id"],
+                join_url=_extract_join_url(e),
+                html_link=e.get("htmlLink", ""),
+            ))
+
+    events.sort(key=lambda e: e.start)
+    # deduplicate by id (event can appear in multiple calendars)
+    seen: set[str] = set()
+    unique: list[CalendarEvent] = []
+    for e in events:
+        if e.id not in seen:
+            seen.add(e.id)
+            unique.append(e)
+    return unique