expedait-cli 0.2.0__tar.gz → 0.2.1__tar.gz

{expedait_cli-0.2.0 → expedait_cli-0.2.1}/.github/workflows/publish.yml

@@ -9,7 +9,7 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     permissions:
-      contents: read
+      contents: write
       id-token: write
     environment: pypi
     steps:
@@ -35,3 +35,8 @@ jobs:
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub Release with PR changelog
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "$GITHUB_REF_NAME" --generate-notes

{expedait_cli-0.2.0 → expedait_cli-0.2.1}/CLAUDE.md

@@ -24,6 +24,12 @@ uv run python -m pytest tests/test_auth.py  # run a single file
 - `expedait_cli/` — source: `main.py` (Click entrypoint), `client.py` (httpx API client), `auth.py`, `config.py`, `formatters.py`, `commands/` (Click subcommands)
 - `tests/` — pytest tests using `pytest-httpx` for mocking HTTP
 
+## Versioning
+
+When creating a PR, bump the patch version in `pyproject.toml` (the `version` field) and include that change in the PR.
+
+To publish a release, push a git tag matching the version (e.g. `git tag v0.2.1 && git push origin v0.2.1`). This triggers CI to publish to PyPI and create a GitHub Release with auto-generated notes listing the PRs since the previous tag.
+
 ## Style
 
 - Python 3.11+, no type-checker configured

expedait_cli-0.2.1/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: expedait-cli
+Version: 0.2.1
+Summary: CLI for Expedait project management — download specs, post comments
+License-Expression: Apache-2.0
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# Expedait CLI
+
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+Command-line interface for [Expedait](https://expedait.com) — download project specs and post comments from AI coding agents.
+
+## Quickstart
+
+```bash
+# Install with uv (recommended)
+uv pip install expedait-cli
+
+# Or install from source
+git clone https://github.com/Expedait/expedait-cli.git
+cd expedait-cli
+uv sync
+
+# Login to your Expedait instance
+expedait auth login
+
+# List your projects
+expedait projects list
+
+# Download all specs for a project
+expedait projects download 1 --output-dir ./specs
+```
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install expedait-cli
+```
+
+### From source
+
+```bash
+git clone https://github.com/Expedait/expedait-cli.git
+cd expedait-cli
+uv sync
+```
+
+This creates a virtual environment with the `expedait` command available.
+
+**Requirements:** Python 3.11+
+
+## Authentication
+
+### Interactive login
+
+```bash
+expedait auth login
+```
+
+Prompts for login method (SSO or email/password). Stores credentials in `~/.expedait/config.json`.
+
+### Environment variables (CI / agents)
+
+```bash
+export EXPEDAIT_TOKEN="your-jwt-token"
+export EXPEDAIT_API_URL="https://your-instance.expedait.com"
+export EXPEDAIT_TENANT_ID=1
+```
+
+**Token resolution order:** `EXPEDAIT_TOKEN` env var > `~/.expedait/config.json` > error.
+
+## Commands
+
+### Auth
+
+```bash
+expedait auth login       # Interactive login
+expedait auth status      # Show current user and tenant
+expedait auth logout      # Clear stored credentials
+```
+
+### Projects
+
+```bash
+expedait projects list                              # List all projects
+expedait projects get PROJECT_ID                    # Get project details
+expedait projects download PROJECT_ID               # Download all pages as ZIP
+expedait projects download PROJECT_ID --output-dir ./specs  # Extract to directory
+```
+
+### Pages
+
+```bash
+expedait pages list --project-id PROJECT_ID         # List pages in a project
+expedait pages get PAGE_ID                          # Print page markdown content
+expedait pages full PAGE_ID                         # Full context (content + comments + deps)
+expedait pages download PAGE_ID --output-dir ./out  # Download page as ZIP
+```
+
+### Comments
+
+```bash
+expedait comments list PAGE_ID                      # List comments on a page
+expedait comments create PAGE_ID \                  # Create a comment
+  --text "Comment content" \
+  --selected-text "text from page" \
+  --start-offset 100 \
+  --end-offset 120 \
+  --source-page-id 5                                # Optional: agent's source page
+expedait comments resolve PAGE_ID COMMENT_ID        # Mark as resolved
+expedait comments delete PAGE_ID COMMENT_ID         # Delete a comment
+```
+
+## Global Options
+
+```bash
+expedait --api-url https://host:8000 ...    # Override API URL
+expedait --tenant-id 2 ...                  # Override tenant
+expedait --format json ...                  # Force JSON output
+expedait --format text ...                  # Force human-readable output
+expedait --version                          # Show version
+```
+
+Output format defaults to `text` when connected to a terminal, `json` when piped.
+
+## Agent Skills
+
+For step-by-step guides on using the CLI from AI coding agents, see [expedait-skills](https://github.com/Expedait/expedait-skills).
+
+## Development
+
+```bash
+git clone https://github.com/Expedait/expedait-cli.git
+cd expedait-cli
+uv sync --group dev
+uv run python -m pytest
+```
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## License
+
+This project is licensed under the [Apache License 2.0](LICENSE).

{expedait_cli-0.2.0 → expedait_cli-0.2.1}/README.md

@@ -54,7 +54,7 @@ This creates a virtual environment with the `expedait` command available.
 expedait auth login
 ```
 
-Prompts for API URL, email, and password. Stores credentials in `~/.expedait/config.json`.
+Prompts for login method (SSO or email/password). Stores credentials in `~/.expedait/config.json`.
 
 ### Environment variables (CI / agents)
 

{expedait_cli-0.2.0 → expedait_cli-0.2.1}/expedait_cli/commands/auth_cmd.py

@@ -117,7 +117,6 @@ def _login_sso(api_url: str) -> tuple[str, dict]:
 def login(ctx: click.Context) -> None:
     """Login interactively via browser SSO or email/password."""
     api_url = resolve_api_url(ctx.obj.get("api_url"))
-    api_url = click.prompt("API URL", default=api_url)
 
     method = click.prompt(
         "Login method",

{expedait_cli-0.2.0 → expedait_cli-0.2.1}/pyproject.toml

@@ -4,8 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "expedait-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "CLI for Expedait project management — download specs, post comments"
+readme = "README.md"
+license = "Apache-2.0"
 requires-python = ">=3.11"
 dependencies = [
     "click>=8.1",

{expedait_cli-0.2.0 → expedait_cli-0.2.1}/tests/test_commands/test_auth_cmd.py

@@ -29,7 +29,7 @@ class TestAuthLoginPassword:
             result = runner.invoke(
                 cli,
                 ["auth", "login"],
-                input="https://app.expedait.org\npassword\nuser@test.com\npass123\n",
+                input="password\nuser@test.com\npass123\n",
             )
 
             assert result.exit_code == 0
@@ -46,7 +46,7 @@ class TestAuthLoginPassword:
             result = runner.invoke(
                 cli,
                 ["auth", "login"],
-                input="https://app.expedait.org\npassword\nbad@test.com\nwrong\n",
+                input="password\nbad@test.com\nwrong\n",
             )
 
             assert result.exit_code != 0
@@ -90,7 +90,7 @@ class TestAuthLoginSSO:
             result = runner.invoke(
                 cli,
                 ["auth", "login"],
-                input="https://app.expedait.org\nsso\n",
+                input="sso\n",
             )
 
             assert result.exit_code == 0
@@ -110,7 +110,7 @@ class TestAuthLoginSSO:
             result = runner.invoke(
                 cli,
                 ["auth", "login"],
-                input="https://app.expedait.org\nsso\n",
+                input="sso\n",
             )
 
             assert result.exit_code != 0
@@ -139,7 +139,7 @@ class TestAuthLoginSSO:
             result = runner.invoke(
                 cli,
                 ["auth", "login"],
-                input="https://app.expedait.org\nsso\n",
+                input="sso\n",
             )
 
             assert result.exit_code != 0
@@ -169,7 +169,7 @@ class TestAuthLoginMultipleTenants:
             result = runner.invoke(
                 cli,
                 ["auth", "login"],
-                input="https://app.expedait.org\npassword\nuser@test.com\npass123\n2\n",
+                input="password\nuser@test.com\npass123\n2\n",
             )
 
             assert result.exit_code == 0

expedait_cli-0.2.0/PKG-INFO

@@ -1,8 +0,0 @@
-Metadata-Version: 2.4
-Name: expedait-cli
-Version: 0.2.0
-Summary: CLI for Expedait project management — download specs, post comments
-License-File: LICENSE
-Requires-Python: >=3.11
-Requires-Dist: click>=8.1
-Requires-Dist: httpx>=0.27