action-platform 0.2.0__tar.gz → 0.3.0__tar.gz

{action_platform-0.2.0 → action_platform-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: action-platform
-Version: 0.2.0
+Version: 0.3.0
 Summary: Your platform team, as a CLI.
 License: Apache License
                                     Version 2.0, January 2004
@@ -222,11 +222,13 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: api
 Provides-Extra: github
 Provides-Extra: gitlab
 Provides-Extra: mcp
 Requires-Dist: PyGithub ; extra == "github"
 Requires-Dist: cookiecutter
+Requires-Dist: fastapi (>=0.115) ; extra == "api"
 Requires-Dist: jinja2
 Requires-Dist: mcp (>=2.0) ; extra == "mcp"
 Requires-Dist: pydantic
@@ -235,6 +237,7 @@ Requires-Dist: python-ulid (>=3.0)
 Requires-Dist: rich
 Requires-Dist: typer
 Requires-Dist: typing-extensions
+Requires-Dist: uvicorn (>=0.30) ; extra == "api"
 Project-URL: Changelog, https://github.com/actionplatform/action-platform/blob/master/CHANGELOG.md
 Project-URL: Homepage, https://github.com/actionplatform/action-platform
 Project-URL: Issues, https://github.com/actionplatform/action-platform/issues
@@ -248,7 +251,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-  <strong>Your platform team, as a CLI.</strong>
+  <strong>Your platform team: a web app, a CLI and an MCP server on one core.</strong>
 </p>
 
 <p align="center">
@@ -260,7 +263,27 @@ Description-Content-Type: text/markdown
 
 ---
 
-Every new service costs the same week: scaffold, lint config, CI, versioning, deploy pipeline, IAM. Then the next one drifts from the last. **Action Platform** turns that week into one command and keeps every project on the same rails — without a control plane to host, a UI to learn, or a vendor to trust with your cloud.
+Every new service costs the same week: scaffold, lint config, CI, versioning, deploy pipeline, IAM. Then the next one drifts from the last. **Action Platform** turns that week into one command — or one click — and keeps every app on the same rails, in your git host and your cloud account.
+
+Three doors, one core:
+
+| | |
+|---|---|
+| **Web app** | Organizations › projects › apps. Create an app from a template, connect GitHub / GitLab / Bitbucket, cut releases, run deploys — from a browser. One command to self-host. |
+| **CLI** | `pipx install action-platform` and the same verbs on your machine: `init`, `branch`, `pr`, `release`, `deploy`, `rollback`, `diagnose`. |
+| **MCP server** | The same operations as tools for Claude Code, Codex, Cursor — locally, or against your hosted platform after `action-platform login`. |
+
+## Self-host in one command
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/actionplatform/action-platform/master/deploy/install.sh | sudo sh
+# with a domain and TLS:
+curl -fsSL https://raw.githubusercontent.com/actionplatform/action-platform/master/deploy/install.sh | sudo sh -s -- platform.example.com you@example.com
+```
+
+Installs Docker if needed, generates the secrets, starts Postgres + API + web (+ Traefik with Let's Encrypt when a domain is given) and prints the URL. Open it: first account, first organization, connect a code host — done. Files live in `/opt/action-platform`; see [`deploy/`](deploy/) for the compose file and the two Dockerfiles.
+
+## Or just the CLI
 
 ```bash
 pipx install action-platform
@@ -277,7 +300,7 @@ Thirty seconds later you have a FastAPI service with tests, lint, CI wired, a SA
 | **One command, whole lifecycle** | `init` → `release` → `deploy` → `rollback` → `diagnose` → `destroy`. Same verbs for a Python API on Lambda, a Go service in Docker, a React app on Amplify. |
 | **Templates from production, not tutorials** | Every project template is extracted from a real shipping product. Real layout, real CI, real gotchas already fixed. |
 | **Cloud is a layer, not a fork** | Projects stay cloud-agnostic. `--cloud aws/lambda` overlays deploy files; swap to `docker` tomorrow with one command. |
-| **Your CI, your account, your git** | Runs on GitHub Actions, GitLab CI or Jenkins you already have. Infra lands in **your** AWS account through OIDC — no long-lived keys, no agent, no SaaS in the loop. |
+| **Your CI, your account, your git** | Runs on GitHub Actions, GitLab CI or Jenkins you already have. Repositories on GitHub, GitLab, Bitbucket or any git server, connected with OAuth. Infra lands in **your** AWS account through OIDC — no long-lived keys, no vendor in the loop. |
 | **Governance that ships with the code** | Git-flow and Conventional Commits enforced by git hooks before a commit exists and by CI on every PR; changelog generated; `AGENTS.md` for humans and AI agents; Trivy scans; least-privilege IAM in `requirements/`. |
 | **Fix once, everywhere** | CI logic lives in versioned shared repos (`ci-scripts`, `ci-github`, `ci-gitlab`, `ci-jenkins`). Bump `v1`, every project picks it up. |
 
@@ -424,13 +447,80 @@ Any client — add to `.mcp.json`:
 { "mcpServers": { "action-platform": { "command": "uvx", "args": ["--from", "action-platform[mcp]", "action-platform-mcp"] } } }
 ```
 
+## The web app
+
+[`apps/web`](apps/web) — Next.js on top of the Python API. **Organization › Project › App**: an organization is the tenant and owns its code hosts; a project groups the apps that ship together; an app is one git repository the platform clones, audits, releases and deploys.
+
+- **Setup wizard** on first run: database (SQLite, PostgreSQL or MySQL), first account, first organization, code hosts.
+- **Connect with GitHub / GitLab / Bitbucket** through OAuth (or paste a token). Tokens are encrypted at rest and refreshed when they expire.
+- **Create project** wizard: type → stack → template → configure → review, with the equivalent `action-platform init` shown. Or add an existing repository by URL.
+- Per app: git-flow audit, commits, branches, tags, release preview → confirm → publish, deploy preflight → confirm → ship.
+- Strictly monochrome UI; every confirmation is an in-app dialog.
+
+Local development:
+
+```bash
+pip install "action-platform[api]"
+action-platform api --reload              # http://127.0.0.1:7788, OpenAPI at /docs
+cd apps/web && npm install && npm run dev # http://localhost:3000 → /setup
+```
+
+Drive a hosted platform from anywhere:
+
+```bash
+action-platform login https://platform.example.com   # browser opens, approve the code
+action-platform mcp --remote                          # the MCP tools now act on that platform
+```
+
+The TypeScript client is generated from the API's OpenAPI schema (`npm run api:types`): the Python response models in `action_platform/api/models.py` are the contract both sides compile against.
+
+## Releases: three artifacts, three versions
+
+One repository, independent versions — declared in `platform.toml`:
+
+```toml
+[components.web]
+path = "apps/web"
+
+[components.api]
+path = "action_platform/api"
+```
+
+| Command | Tag | Publishes |
+|---|---|---|
+| `action-platform release minor` | `v0.3.0` | `action-platform` on PyPI (library + CLI) |
+| `action-platform release -c api patch` | `api/v0.1.1` | `actionplatform/action-platform-api` image |
+| `action-platform release -c web minor` | `web/v0.2.0` | `actionplatform/action-platform-web` image |
+
+Each component keeps its own `LAST_VERSION` and `CHANGELOG.md` under its path; its changelog lists only the commits that touched it, and the root's excludes them. Off `master` every release is an `-rc.N` pre-release. Images go to Docker Hub and are mirrored to GHCR.
+
+## Layout
+
+```
+action_platform/
+  core/
+    manifest/     platform.toml: read, edit tables
+    scaffold/     templates matrix, generate, install into an existing repo
+    flow/         git, git-flow rules, branching, pull requests
+    release/      versioning, changelog, release, deploy
+    config.py · context.py · exception.py · action_platform.py (facade)
+  providers/
+    source/       github, gitlab, bitbucket, generic — repositories, releases, PRs
+  api/            FastAPI for the web app: apps registry, actions, per-request credentials
+  remote/         client + device-flow login for a hosted platform
+  mcp/            MCP server: local tools, or remote tools after login
+  cli/            Typer commands
+apps/web/         the web app (see its README)
+deploy/           Dockerfiles, docker-compose, install.sh
+```
+
 ## Extend it
 
 Deploy targets are plugins. Implement the `DeployTarget` contract — `preflight`, `create`, `deploy`, `switch_traffic`, `rollback`, `diagnose`, `delete` — publish it under the `action_platform.deploy_target` entry-point group, and `action-platform deploy` finds it by name.
 
 ```python
 from action_platform import ActionPlatform, Config
-from action_platform.providers import SourceGithub
+from action_platform.providers.source.github import SourceGithub
 
 tool = ActionPlatform(config=Config(source_host=SourceGithub(repo="acme/orders")))
 tool.release("minor")
@@ -445,7 +535,6 @@ Templates are plain cookiecutters in [actionplatform/templates](https://github.c
 | [templates](https://github.com/actionplatform/templates) | projects, clouds, services |
 | [ci-scripts](https://github.com/actionplatform/ci-scripts) | the one implementation of setup / check / release / commit lint |
 | [ci-github](https://github.com/actionplatform/ci-github) · [ci-gitlab](https://github.com/actionplatform/ci-gitlab) · [ci-jenkins](https://github.com/actionplatform/ci-jenkins) | thin wrappers per CI |
-| [strategy](https://github.com/actionplatform/strategy) | why it is built this way |
 
 ## License
 

{action_platform-0.2.0 → action_platform-0.3.0}/README.md

@@ -3,7 +3,7 @@
 </p>
 
 <p align="center">
-  <strong>Your platform team, as a CLI.</strong>
+  <strong>Your platform team: a web app, a CLI and an MCP server on one core.</strong>
 </p>
 
 <p align="center">
@@ -15,7 +15,27 @@
 
 ---
 
-Every new service costs the same week: scaffold, lint config, CI, versioning, deploy pipeline, IAM. Then the next one drifts from the last. **Action Platform** turns that week into one command and keeps every project on the same rails — without a control plane to host, a UI to learn, or a vendor to trust with your cloud.
+Every new service costs the same week: scaffold, lint config, CI, versioning, deploy pipeline, IAM. Then the next one drifts from the last. **Action Platform** turns that week into one command — or one click — and keeps every app on the same rails, in your git host and your cloud account.
+
+Three doors, one core:
+
+| | |
+|---|---|
+| **Web app** | Organizations › projects › apps. Create an app from a template, connect GitHub / GitLab / Bitbucket, cut releases, run deploys — from a browser. One command to self-host. |
+| **CLI** | `pipx install action-platform` and the same verbs on your machine: `init`, `branch`, `pr`, `release`, `deploy`, `rollback`, `diagnose`. |
+| **MCP server** | The same operations as tools for Claude Code, Codex, Cursor — locally, or against your hosted platform after `action-platform login`. |
+
+## Self-host in one command
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/actionplatform/action-platform/master/deploy/install.sh | sudo sh
+# with a domain and TLS:
+curl -fsSL https://raw.githubusercontent.com/actionplatform/action-platform/master/deploy/install.sh | sudo sh -s -- platform.example.com you@example.com
+```
+
+Installs Docker if needed, generates the secrets, starts Postgres + API + web (+ Traefik with Let's Encrypt when a domain is given) and prints the URL. Open it: first account, first organization, connect a code host — done. Files live in `/opt/action-platform`; see [`deploy/`](deploy/) for the compose file and the two Dockerfiles.
+
+## Or just the CLI
 
 ```bash
 pipx install action-platform
@@ -32,7 +52,7 @@ Thirty seconds later you have a FastAPI service with tests, lint, CI wired, a SA
 | **One command, whole lifecycle** | `init` → `release` → `deploy` → `rollback` → `diagnose` → `destroy`. Same verbs for a Python API on Lambda, a Go service in Docker, a React app on Amplify. |
 | **Templates from production, not tutorials** | Every project template is extracted from a real shipping product. Real layout, real CI, real gotchas already fixed. |
 | **Cloud is a layer, not a fork** | Projects stay cloud-agnostic. `--cloud aws/lambda` overlays deploy files; swap to `docker` tomorrow with one command. |
-| **Your CI, your account, your git** | Runs on GitHub Actions, GitLab CI or Jenkins you already have. Infra lands in **your** AWS account through OIDC — no long-lived keys, no agent, no SaaS in the loop. |
+| **Your CI, your account, your git** | Runs on GitHub Actions, GitLab CI or Jenkins you already have. Repositories on GitHub, GitLab, Bitbucket or any git server, connected with OAuth. Infra lands in **your** AWS account through OIDC — no long-lived keys, no vendor in the loop. |
 | **Governance that ships with the code** | Git-flow and Conventional Commits enforced by git hooks before a commit exists and by CI on every PR; changelog generated; `AGENTS.md` for humans and AI agents; Trivy scans; least-privilege IAM in `requirements/`. |
 | **Fix once, everywhere** | CI logic lives in versioned shared repos (`ci-scripts`, `ci-github`, `ci-gitlab`, `ci-jenkins`). Bump `v1`, every project picks it up. |
 
@@ -179,13 +199,80 @@ Any client — add to `.mcp.json`:
 { "mcpServers": { "action-platform": { "command": "uvx", "args": ["--from", "action-platform[mcp]", "action-platform-mcp"] } } }
 ```
 
+## The web app
+
+[`apps/web`](apps/web) — Next.js on top of the Python API. **Organization › Project › App**: an organization is the tenant and owns its code hosts; a project groups the apps that ship together; an app is one git repository the platform clones, audits, releases and deploys.
+
+- **Setup wizard** on first run: database (SQLite, PostgreSQL or MySQL), first account, first organization, code hosts.
+- **Connect with GitHub / GitLab / Bitbucket** through OAuth (or paste a token). Tokens are encrypted at rest and refreshed when they expire.
+- **Create project** wizard: type → stack → template → configure → review, with the equivalent `action-platform init` shown. Or add an existing repository by URL.
+- Per app: git-flow audit, commits, branches, tags, release preview → confirm → publish, deploy preflight → confirm → ship.
+- Strictly monochrome UI; every confirmation is an in-app dialog.
+
+Local development:
+
+```bash
+pip install "action-platform[api]"
+action-platform api --reload              # http://127.0.0.1:7788, OpenAPI at /docs
+cd apps/web && npm install && npm run dev # http://localhost:3000 → /setup
+```
+
+Drive a hosted platform from anywhere:
+
+```bash
+action-platform login https://platform.example.com   # browser opens, approve the code
+action-platform mcp --remote                          # the MCP tools now act on that platform
+```
+
+The TypeScript client is generated from the API's OpenAPI schema (`npm run api:types`): the Python response models in `action_platform/api/models.py` are the contract both sides compile against.
+
+## Releases: three artifacts, three versions
+
+One repository, independent versions — declared in `platform.toml`:
+
+```toml
+[components.web]
+path = "apps/web"
+
+[components.api]
+path = "action_platform/api"
+```
+
+| Command | Tag | Publishes |
+|---|---|---|
+| `action-platform release minor` | `v0.3.0` | `action-platform` on PyPI (library + CLI) |
+| `action-platform release -c api patch` | `api/v0.1.1` | `actionplatform/action-platform-api` image |
+| `action-platform release -c web minor` | `web/v0.2.0` | `actionplatform/action-platform-web` image |
+
+Each component keeps its own `LAST_VERSION` and `CHANGELOG.md` under its path; its changelog lists only the commits that touched it, and the root's excludes them. Off `master` every release is an `-rc.N` pre-release. Images go to Docker Hub and are mirrored to GHCR.
+
+## Layout
+
+```
+action_platform/
+  core/
+    manifest/     platform.toml: read, edit tables
+    scaffold/     templates matrix, generate, install into an existing repo
+    flow/         git, git-flow rules, branching, pull requests
+    release/      versioning, changelog, release, deploy
+    config.py · context.py · exception.py · action_platform.py (facade)
+  providers/
+    source/       github, gitlab, bitbucket, generic — repositories, releases, PRs
+  api/            FastAPI for the web app: apps registry, actions, per-request credentials
+  remote/         client + device-flow login for a hosted platform
+  mcp/            MCP server: local tools, or remote tools after login
+  cli/            Typer commands
+apps/web/         the web app (see its README)
+deploy/           Dockerfiles, docker-compose, install.sh
+```
+
 ## Extend it
 
 Deploy targets are plugins. Implement the `DeployTarget` contract — `preflight`, `create`, `deploy`, `switch_traffic`, `rollback`, `diagnose`, `delete` — publish it under the `action_platform.deploy_target` entry-point group, and `action-platform deploy` finds it by name.
 
 ```python
 from action_platform import ActionPlatform, Config
-from action_platform.providers import SourceGithub
+from action_platform.providers.source.github import SourceGithub
 
 tool = ActionPlatform(config=Config(source_host=SourceGithub(repo="acme/orders")))
 tool.release("minor")
@@ -200,7 +287,6 @@ Templates are plain cookiecutters in [actionplatform/templates](https://github.c
 | [templates](https://github.com/actionplatform/templates) | projects, clouds, services |
 | [ci-scripts](https://github.com/actionplatform/ci-scripts) | the one implementation of setup / check / release / commit lint |
 | [ci-github](https://github.com/actionplatform/ci-github) · [ci-gitlab](https://github.com/actionplatform/ci-gitlab) · [ci-jenkins](https://github.com/actionplatform/ci-jenkins) | thin wrappers per CI |
-| [strategy](https://github.com/actionplatform/strategy) | why it is built this way |
 
 ## License
 

{action_platform-0.2.0 → action_platform-0.3.0}/action_platform/__init__.py

@@ -1,7 +1,7 @@
 """Action Platform __init__ module."""
 
-__version__ = "0.1.2"
-__description__ = "🛠️ Action Platform padroniza init, release e deploy."
+__version__ = "0.3.0"
+__description__ = "Your platform team, as a CLI."
 
 from .core.config import Config
 from .core.context import Context

action_platform-0.3.0/action_platform/api/LAST_VERSION

@@ -0,0 +1 @@
+0.1.0

action_platform-0.3.0/action_platform/api/__init__.py

@@ -0,0 +1 @@
+"""Local web UI: a JSON API over the core modules plus the bundled SPA."""

action_platform-0.3.0/action_platform/api/credentials.py

@@ -0,0 +1,87 @@
+"""Source-host credentials handed to the API per request by the web app.
+
+Nothing is stored here: the web app keeps them (encrypted, per
+organization) and sends them with the calls that need them — push,
+release, pull request. While such a call runs, git authenticates with the
+same token through a credential helper injected via the environment.
+"""
+
+from __future__ import annotations
+
+import os
+from contextlib import contextmanager
+from typing import Iterator, Optional
+
+from pydantic import BaseModel
+
+from action_platform.core.config import Config
+from action_platform.providers.source import build_source_host
+
+GIT_USERNAMES = {
+    "github": "x-access-token",
+    "gitlab": "oauth2",
+    "bitbucket": "x-token-auth",
+}
+
+
+class SourceCredentials(BaseModel):
+    kind: str
+    token: str
+    username: Optional[str] = None
+    base_url: Optional[str] = None
+    owner: Optional[str] = None
+
+
+def apply(config: Config, creds: Optional[SourceCredentials]) -> Config:
+    """Rebuild config.source_host with the request's token instead of the environment's."""
+    if creds is None or config.source_host is None:
+        return config
+
+    config.source_host = build_source_host(
+        creds.kind,
+        config.source_host.repo,
+        base_url=creds.base_url,
+        token=creds.token,
+        username=creds.username,
+    )
+
+    return config
+
+
+@contextmanager
+def git_auth(creds: Optional[SourceCredentials]) -> Iterator[None]:
+    """Make every git subprocess in this block authenticate with `creds`.
+
+    Uses GIT_CONFIG_{COUNT,KEY,VALUE} (git ≥ 2.31) to replace the credential
+    helpers with one that answers from two environment variables, so the
+    token never lands in .git/config or on a command line — and the host's
+    own helpers (keychain, gh) never answer for the wrong account.
+    """
+    if creds is None:
+        yield
+        return
+
+    username = creds.username or GIT_USERNAMES.get(creds.kind, "git")
+    helper = '!f() { printf \'username=%s\\npassword=%s\\n\' "$AP_GIT_USER" "$AP_GIT_TOKEN"; }; f'
+    keys = {
+        "GIT_TERMINAL_PROMPT": "0",
+        "AP_GIT_USER": username,
+        "AP_GIT_TOKEN": creds.token,
+        "GIT_CONFIG_COUNT": "2",
+        # an empty value clears the helpers configured so far
+        "GIT_CONFIG_KEY_0": "credential.helper",
+        "GIT_CONFIG_VALUE_0": "",
+        "GIT_CONFIG_KEY_1": "credential.helper",
+        "GIT_CONFIG_VALUE_1": helper,
+    }
+    saved = {k: os.environ.get(k) for k in keys}
+    os.environ.update(keys)
+
+    try:
+        yield
+    finally:
+        for k, v in saved.items():
+            if v is None:
+                os.environ.pop(k, None)
+            else:
+                os.environ[k] = v

action_platform-0.3.0/action_platform/api/models.py

@@ -0,0 +1,177 @@
+"""Response models. They are the contract the web app's TypeScript client is generated from."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from pydantic import BaseModel
+
+
+class Version(BaseModel):
+    version: str
+
+
+class MatrixProject(BaseModel):
+    type: str
+    stack: str
+    template: str
+    default: bool
+    description: str
+
+
+class MatrixCloud(BaseModel):
+    name: str
+    types: list[str]
+    languages: list[str]
+    description: str
+
+
+class MatrixService(BaseModel):
+    name: str
+    providers: list[str]
+    description: str
+
+
+class Matrix(BaseModel):
+    projects: list[MatrixProject]
+    clouds: list[MatrixCloud]
+    services: list[MatrixService]
+
+
+class GitflowRules(BaseModel):
+    kinds: list[str]
+    protected: list[str]
+    types: list[str]
+
+
+class AppRow(BaseModel):
+    id: str
+    name: str
+    url: str
+    exists: bool
+    language: Optional[str] = None
+    type: Optional[str] = None
+    last_version: Optional[str] = None
+    branch: Optional[str] = None
+
+
+class AppEntry(BaseModel):
+    id: str
+    name: str
+    url: str
+    path: str
+    default_branch: str = ""
+
+
+class AppMeta(BaseModel):
+    name: str = ""
+    type: Optional[str] = None
+    stack: Optional[str] = None
+    template: Optional[str] = None
+    language: Optional[str] = None
+    ci: Optional[str] = None
+
+
+class AppDetail(BaseModel):
+    id: str
+    url: str
+    default_branch: str = ""
+    project: AppMeta
+    source_host: dict[str, str]
+    deploy: dict
+    release: dict[str, str]
+    services: dict
+    last_version: Optional[str] = None
+    branch: str
+    latest_tag: Optional[str] = None
+    clean: bool
+
+
+class GitflowReport(BaseModel):
+    branch: str
+    problems: list[str]
+    checked_commits: int
+    ok: bool
+
+
+class Commit(BaseModel):
+    sha: str
+    subject: str
+    author: str
+    date: str
+
+
+class Branch(BaseModel):
+    name: str
+    date: str
+    kind: Optional[str] = None
+    protected: bool
+    problem: Optional[str] = None
+
+
+class ReleasePreview(BaseModel):
+    current: str
+    next: str
+    changelog: str
+    dry_run: bool
+
+
+class DeployResult(BaseModel):
+    target: str
+    ok: bool
+    version: str
+    url: Optional[str] = None
+    error: Optional[str] = None
+
+
+class Diagnosis(BaseModel):
+    ok: bool
+    target: str
+    status: str = ""
+    version: Optional[str] = None
+    url: Optional[str] = None
+    details: dict[str, str] = {}
+
+
+class SourceCredentials(BaseModel):
+    kind: str
+    token: str
+    username: Optional[str] = None
+    base_url: Optional[str] = None
+    owner: Optional[str] = None
+
+
+class InitRequest(BaseModel):
+    type: str
+    stack: Optional[str] = None
+    template: Optional[str] = None
+    name: str
+    description: str = ""
+    package_name: Optional[str] = None
+    github_owner: Optional[str] = None
+    ci: Optional[str] = None
+    cloud: Optional[str] = None
+    git_init: bool = True
+    push: bool = False
+    private: bool = False
+    credentials: Optional[SourceCredentials] = None
+
+
+class InitResult(BaseModel):
+    id: str
+    name: str
+    path: str
+    url: str
+    template: str
+    cloud: Optional[str] = None
+    pushed: bool
+
+
+class PushRequest(BaseModel):
+    private: bool = False
+    credentials: Optional[SourceCredentials] = None
+
+
+class PushResult(BaseModel):
+    id: str
+    url: str