projectmemory-cli 0.1.0__py3-none-any.whl

projectmemory_cli/project_context.py

@@ -0,0 +1,244 @@
+"""Project context resolution and session guard.
+
+Resolution order for current project:
+  1. Explicit project argument (--project flag or positional name/id)
+  2. Current directory / git remote mapping
+  3. Stored current_project_id in config
+  4. Interactive selection
+
+The session guard always fetches fresh state from the backend —
+local cache is never treated as authoritative.
+"""
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+from typing import Optional
+
+from platformdirs import user_config_dir
+
+from projectmemory_cli import config, output
+from projectmemory_cli.api.client import APIClient
+from projectmemory_cli.api.errors import (
+    APIError,
+    AuthenticationError,
+    NoActiveSessionError,
+)
+from projectmemory_cli.models.api import ActiveSession, ProjectSummary
+
+APP_NAME = "projectmemory"
+REPO_MAP_FILE = Path(user_config_dir(APP_NAME)) / "repo_map.json"
+
+
+# ---------------------------------------------------------------------------
+# Repository mapping
+# ---------------------------------------------------------------------------
+
+def _load_repo_map() -> dict:
+    if not REPO_MAP_FILE.exists():
+        return {}
+    try:
+        return json.loads(REPO_MAP_FILE.read_text())
+    except Exception:
+        return {}
+
+
+def _save_repo_map(data: dict) -> None:
+    REPO_MAP_FILE.parent.mkdir(parents=True, exist_ok=True)
+    REPO_MAP_FILE.write_text(json.dumps(data, indent=2))
+
+
+def save_repo_mapping(path: str, project_id: int, project_name: str) -> None:
+    data = _load_repo_map()
+    data[path] = {"project_id": project_id, "project_name": project_name}
+    _save_repo_map(data)
+
+
+def remove_repo_mapping(path: str) -> bool:
+    data = _load_repo_map()
+    if path in data:
+        del data[path]
+        _save_repo_map(data)
+        return True
+    return False
+
+
+def get_mapped_project_id_for_cwd() -> Optional[tuple[int, str]]:
+    """Return (project_id, project_name) if CWD or a git root is mapped."""
+    from projectmemory_cli import git
+    data = _load_repo_map()
+    if not data:
+        return None
+
+    cwd = str(Path.cwd())
+    if cwd in data:
+        entry = data[cwd]
+        return entry["project_id"], entry["project_name"]
+
+    # Check git repo root
+    root = git.get_repo_root()
+    if root:
+        root_str = str(root)
+        if root_str in data:
+            entry = data[root_str]
+            return entry["project_id"], entry["project_name"]
+
+        # Check by git remote
+        remote_name = git.normalize_github_repo(git.get_remote_url(root))
+        if remote_name:
+            key = f"git_remote:{remote_name}"
+            if key in data:
+                entry = data[key]
+                return entry["project_id"], entry["project_name"]
+
+    return None
+
+
+# ---------------------------------------------------------------------------
+# Project resolution
+# ---------------------------------------------------------------------------
+
+def fetch_projects(client: APIClient) -> list[ProjectSummary]:
+    data = client.get("/api/cli/projects/")
+    return [ProjectSummary.model_validate(p) for p in data.get("projects", [])]
+
+
+def find_project_by_name_or_id(
+    projects: list[ProjectSummary], query: str
+) -> Optional[ProjectSummary]:
+    """Find by exact ID match first, then case-insensitive name."""
+    query = query.strip()
+    # Try numeric ID
+    try:
+        pid = int(query)
+        for p in projects:
+            if p.id == pid:
+                return p
+    except ValueError:
+        pass
+    # Name match (case-insensitive, partial)
+    ql = query.lower()
+    for p in projects:
+        if p.name.lower() == ql:
+            return p
+    # Partial
+    matches = [p for p in projects if ql in p.name.lower()]
+    if len(matches) == 1:
+        return matches[0]
+    return None
+
+
+def select_project_interactive(projects: list[ProjectSummary]) -> Optional[ProjectSummary]:
+    """Present a questionary menu to pick a project."""
+    import questionary
+    if not projects:
+        return None
+    choices = [
+        questionary.Choice(
+            title=f"{p.name}{'  [active session]' if p.has_active_session else ''}",
+            value=p,
+        )
+        for p in projects
+    ]
+    try:
+        result = questionary.select(
+            "Select project:",
+            choices=choices,
+        ).ask()
+        return result
+    except (KeyboardInterrupt, EOFError):
+        return None
+
+
+def resolve_project(
+    client: APIClient,
+    *,
+    arg: Optional[str] = None,
+    interactive: bool = True,
+) -> Optional[ProjectSummary]:
+    """Full project resolution pipeline."""
+
+    projects: list[ProjectSummary] | None = None
+
+    def _projects() -> list[ProjectSummary]:
+        nonlocal projects
+        if projects is None:
+            projects = fetch_projects(client)
+        return projects
+
+    # 1. Explicit argument
+    if arg:
+        ps = _projects()
+        found = find_project_by_name_or_id(ps, arg)
+        if found:
+            return found
+        output.error(f"Project not found: {arg!r}")
+        raise SystemExit(5)
+
+    # 2. Current directory / git mapping
+    mapped = get_mapped_project_id_for_cwd()
+    if mapped:
+        project_id, _ = mapped
+        ps = _projects()
+        found = find_project_by_name_or_id(ps, str(project_id))
+        if found:
+            return found
+
+    # 3. Stored current project
+    stored_id = config.get_current_project_id()
+    if stored_id:
+        ps = _projects()
+        found = find_project_by_name_or_id(ps, stored_id)
+        if found:
+            return found
+
+    # 4. Interactive selection
+    if interactive:
+        ps = _projects()
+        if not ps:
+            output.error("You have no projects. Run: pm project create")
+            raise SystemExit(5)
+        return select_project_interactive(ps)
+
+    return None
+
+
+# ---------------------------------------------------------------------------
+# Session guard
+# ---------------------------------------------------------------------------
+
+def get_active_session_for_project(client: APIClient, project_id: int) -> Optional[ActiveSession]:
+    """Fetch the active session for a project from the backend (never cached)."""
+    try:
+        data = client.get("/api/cli/session/status/")
+    except AuthenticationError:
+        raise
+    except APIError:
+        return None
+    sessions = data.get("active_sessions", [])
+    for s in sessions:
+        if s.get("project") == project_id:
+            return ActiveSession.model_validate(s)
+    return None
+
+
+def guard_project_session(
+    client: APIClient,
+    *,
+    project_arg: Optional[str] = None,
+) -> tuple[ProjectSummary, ActiveSession]:
+    """Resolve project and verify active session. Exit with clear message on failure."""
+    project = resolve_project(client, arg=project_arg)
+    if not project:
+        output.error("No current project.")
+        output.hint("Run:\n  pm resume")
+        raise SystemExit(1)
+
+    session = get_active_session_for_project(client, project.id)
+    if not session:
+        output.error(f"No active session for {project.name}.")
+        output.hint("Run:\n  pm resume")
+        raise SystemExit(8)
+
+    return project, session

projectmemory_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,239 @@
+Metadata-Version: 2.4
+Name: projectmemory-cli
+Version: 0.1.0
+Summary: Project Memory CLI — developer context in your terminal
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=25
+Requires-Dist: platformdirs>=4
+Requires-Dist: pydantic>=2
+Requires-Dist: questionary>=2
+Requires-Dist: rich>=13
+Requires-Dist: tomli-w>=1
+Requires-Dist: typer[all]>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest-mock>=3; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Project Memory CLI
+
+Developer context in your terminal — a Python CLI client for [projectmemory.app](https://projectmemory.app).
+
+## Installation
+
+```bash
+pip install projectmemory-cli
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/your-org/projectmemory-cli
+cd projectmemory-cli
+pip install -e ".[dev]"
+```
+
+Both `pm` and `projectmemory` are registered as executable names.
+
+## Quick Start
+
+```bash
+# Authenticate (opens browser)
+pm login
+
+# Create a project and start its first session
+pm project create
+
+# Or resume an existing project/session
+pm resume "My App"
+
+# See your current context
+pm memory show
+
+# Work with tasks
+pm task list
+pm task add "Implement login"
+pm task done 42      # completes task, then optionally links a commit
+pm done              # interactive task completion shortcut
+
+# Capture notes
+pm capture "Don't forget to update the Stripe webhook URL"
+
+# Report an issue
+pm issue add "Login fails on mobile Safari"
+
+# End your session with the shared backend review
+pm session end
+```
+
+## Commands
+
+### Authentication
+| Command | Description |
+|---|---|
+| `pm login` | Authenticate via browser |
+| `pm logout` | Revoke token |
+| `pm whoami` | Show current user |
+| `pm auth status` | Check auth status |
+| `pm doctor` | Diagnose CLI config, auth, backend, project, session, and Git state |
+
+### Projects
+| Command | Description |
+|---|---|
+| `pm project list` | List all projects |
+| `pm project create` | Create a project (interactive) |
+| `pm project current` | Show current project + session |
+| `pm project link` | Link this directory to a project |
+| `pm project unlink` | Remove directory mapping |
+| `pm web` | Open project in browser |
+
+### Work Sessions
+| Command | Description |
+|---|---|
+| `pm resume [project]` | Start or resume a session |
+| `pm session status` | Show all active sessions |
+| `pm session end` | End the current session |
+
+### Project Memory
+| Command | Description |
+|---|---|
+| `pm memory show` | Display all memory fields |
+| `pm memory status set [text]` | Update Current Status |
+| `pm memory context set [text]` | Update Important Context |
+| `pm memory update` | Interactive memory update, including open issues |
+
+### Next Action
+| Command | Description |
+|---|---|
+| `pm next` | Show current Next Action |
+| `pm next set [text]` | Set Next Action (interactive menu) |
+| `pm next task <id>` | Link a task as Next Action |
+| `pm next issue <id>` | Link an issue as Next Action |
+| `pm next clear` | Clear Next Action |
+
+### Tasks
+| Command | Description |
+|---|---|
+| `pm task list` | List tasks; supports `--open`, `--completed`, `--snoozed`, `--all` |
+| `pm task add [title]` | Create a task |
+| `pm task done <id>` | Complete task + optional commit link |
+| `pm done` | Interactive task completion shortcut |
+| `pm task snooze <id>` | Snooze task |
+| `pm task reopen <id>` | Reopen task |
+| `pm task edit <id>` | Edit task |
+| `pm task delete <id>` | Delete task |
+
+### Notes
+| Command | Description |
+|---|---|
+| `pm note list` | List notes |
+| `pm note add [content]` | Create a note; supports `--title`, `--editor`, `--stdin` |
+| `pm note search <query>` | Search notes |
+| `pm capture [text]` | Quick note shortcut |
+| `pm note edit <id>` | Edit a note |
+| `pm note delete <id>` | Delete a note |
+
+### Issues
+| Command | Description |
+|---|---|
+| `pm issue list` | List issues; supports `--open`, `--resolved`, `--all` |
+| `pm issue add [description]` | Report an issue |
+| `pm issue resolve <id>` | Mark issue as resolved |
+| `pm issue reopen <id>` | Reopen issue |
+| `pm issue edit <id>` | Edit issue |
+| `pm issue delete <id>` | Delete issue |
+
+### Commits
+| Command | Description |
+|---|---|
+| `pm commit link` | Interactive recovery flow for linking a commit to a completed task |
+| `pm commit link HEAD --task 24` | Directly link a commit/ref to a completed task |
+
+## Configuration
+
+Configuration is stored at `~/.config/projectmemory/config.toml`.
+
+The default `api_url` is the Project Memory site root, for example `https://projectmemory.app`. The CLI adds API paths such as `/api/cli/...` internally.
+
+```bash
+pm config show         # show all settings
+pm config set api_url https://your-instance.example.com
+pm config reset        # restore defaults
+```
+
+### Environment variables
+
+| Variable | Description |
+|---|---|
+| `PROJECTMEMORY_API_URL` | API base URL |
+| `PROJECTMEMORY_TOKEN` | Token override (skip keyring) |
+| `PROJECTMEMORY_PROJECT` | Current project ID override |
+| `PROJECTMEMORY_NO_COLOR` | Disable color output |
+
+
+## Diagnostics
+
+Run a read-only diagnostic report when troubleshooting local configuration or support issues:
+
+```bash
+pm doctor
+pm doctor --json
+pm doctor --verbose
+pm doctor --no-network
+```
+
+`pm doctor` never prints authentication tokens, refresh tokens, passwords, private keys, or OAuth secrets. It exits with `0` when healthy, `1` when warnings are present, and `2` when critical issues prevent normal CLI use.
+
+## Directory Linking
+
+Link the current git repository to a project so `pm` knows which project to use automatically:
+
+```bash
+cd ~/code/my-app
+pm project link "My App"
+
+# Now pm commands in this directory use "My App" automatically
+pm task list    # no --project needed
+```
+
+## How Sessions Work
+
+The CLI shares the session model with the web app. Sessions must be active for write operations (creating tasks, notes, issues, updating memory).
+
+- `pm resume` starts or resumes the backend session for the selected project
+- `pm session end` shows the shared backend Session Review and finalizes that exact session
+- If the web app ends your session, the CLI will show a clear error and ask you to `pm resume` again
+- A user can have active sessions in multiple projects, but the CLI has one current project
+- Switching projects can end the current project session, keep it active, or cancel
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run with coverage
+pytest --cov=projectmemory_cli --cov-report=term-missing
+
+# Lint
+ruff check projectmemory_cli/
+
+# Type check
+mypy projectmemory_cli/
+```
+
+## Security
+
+- Tokens are stored in the OS keyring (or `~/.config/projectmemory/credentials.json` with `chmod 600` as fallback)
+- Passwords are never stored
+- The `PROJECTMEMORY_TOKEN` environment variable overrides stored credentials (read-only)
+- Tokens can be revoked remotely via `pm logout` or from the web app at projectmemory.app/settings

projectmemory_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+projectmemory_cli/__init__.py,sha256=_mSPeKukKlAdhOhlyV7KDX3nbP8dTqDsNKZyypYB17o,57
+projectmemory_cli/app.py,sha256=SJEYEj0lh6RozWj80C2AnjsyceQojEDelIKEl5gpKag,2742
+projectmemory_cli/config.py,sha256=G764kH7NtINJsGwivL6qsGO6h98N53XJeIqlSMf5bVw,2591
+projectmemory_cli/credentials.py,sha256=tZwBgJRa8IkN9oYs8hWwyMfVs9qpeX4XTA-VLtRY6as,2400
+projectmemory_cli/git.py,sha256=eu3i6K1T_n1PCrVUnsr2ZLUVFy_fjQXPfgKhUxDvoD4,3693
+projectmemory_cli/main.py,sha256=gQZnlXah8alZblfSkMmd-ZmeTG-EGQJ2zO1vWJi0ZsU,174
+projectmemory_cli/output.py,sha256=5U5QKQgObXt7tkFJR9CZsnbETw8eiWiq8J3H2Lcm-ho,6083
+projectmemory_cli/project_context.py,sha256=i5sv3E-5EyN3Ig-xR3k0aM8L6vFRt0FACxZNLoqrzvE,7151
+projectmemory_cli/api/__init__.py,sha256=d7XMEse6wwtLORqrQmnhaKMI8KM3lJSzRVE7HVskq1w,19
+projectmemory_cli/api/auth.py,sha256=VAkHwcBezEL7Q8ftw_M3XhtKLM67e2forJK4s_24PgM,2996
+projectmemory_cli/api/client.py,sha256=ZXnYj1nBNt_6vQIKr5ewUoBOyHNBTAHgEQ0ZAn1O-KU,4328
+projectmemory_cli/api/errors.py,sha256=38bgoIFaJGjg5AoJpBim-lKUUGI1EHHEePIfhWf9HMQ,4249
+projectmemory_cli/api/sessions.py,sha256=_61u2Ln3m74ZMjEowZ14ChV1jb3H5PV5QAVcBL_4mJ4,894
+projectmemory_cli/commands/__init__.py,sha256=zltFPaCZgkeTdOH1YWrUEqqBF9Dg6tokgAFcmqP4_n4,24
+projectmemory_cli/commands/auth.py,sha256=xhKPerPKqpagFGV0ohCYxa-J-_WsDnD_6rvWTaJdXSA,4949
+projectmemory_cli/commands/commits.py,sha256=t-MdXCdz3D4ppB8bg7HRzDziVYGyIvquqS3nEgh72kg,5596
+projectmemory_cli/commands/config.py,sha256=7qybOO4Gu-8V6z3beX4WgT_QMdvxVZnmnU7DyDECTSk,1693
+projectmemory_cli/commands/doctor.py,sha256=dcBWnpiA0-F-LW_sVNL5_WLnhAoTGzuD8imH_lpoeO8,15454
+projectmemory_cli/commands/issues.py,sha256=nTZqFGtXnSO6RkBGdB0YqrSj80KIcpmKT0C1KrcVIkw,8143
+projectmemory_cli/commands/memory.py,sha256=oR_IGCsbT0S-Jmd4cOeIulGDmNBG2FQ-HZppEr7R5r8,8089
+projectmemory_cli/commands/next_action.py,sha256=DpoIg74NCCq009I6o6NaE3WZ7PVEKsNe2cHR5kpzIdk,10286
+projectmemory_cli/commands/notes.py,sha256=RfNSiqX-Qqej6wGz22Pm50r8E9rkOxK231Tj-qtyGq0,7769
+projectmemory_cli/commands/projects.py,sha256=X1-DHFB34IR8kz-oK8EonFXj-gatgEtkQH6tl9EaIqo,11073
+projectmemory_cli/commands/resume.py,sha256=623w3_dphwBPxl9Fp2tXCIYFCJ4v5M2tGxBjqs4_g18,8819
+projectmemory_cli/commands/sessions.py,sha256=_RmAKhiTX1PQlVrBi651gjjcvA5aYYrVeq63So29hEM,10446
+projectmemory_cli/commands/tasks.py,sha256=MfN9Vqij7myr8Hd9I-32eV9oslg8qItLfT1McOB1qwg,15732
+projectmemory_cli/models/__init__.py,sha256=Olg44Lfn1NJZ590xdEv7rZrS47PxSUnCXo9pOnSJm1s,41
+projectmemory_cli/models/api.py,sha256=q8-lAaH7mimedjYRAPgvWMwQ6EaOVwt1U_K9TImtuM4,5800
+projectmemory_cli-0.1.0.dist-info/METADATA,sha256=wSoHLLMEtzrWEs28KTQaN4jb3is43ScHDhuQWsofnJU,7156
+projectmemory_cli-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+projectmemory_cli-0.1.0.dist-info/entry_points.txt,sha256=PFSO5C1l54v5RTc5LnHZUB3JKLhsCSXIMQwEPGW70Hg,93
+projectmemory_cli-0.1.0.dist-info/RECORD,,

projectmemory_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

projectmemory_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pm = projectmemory_cli.main:app
+projectmemory = projectmemory_cli.main:app