feat: add createos deploy command (#20)

* ci: auto-update Homebrew formula on new releases

Adds an `update-homebrew` job to the release workflow that:
- Downloads SHA256 checksums from the just-published release
- Generates an updated Formula/createos.rb with new version + hashes
- Pushes to NodeOps-app/homebrew-createos

Requires HOMEBREW_TAP_TOKEN secret (PAT with repo scope for the tap repo).
Runs after binaries are uploaded, so SHA256 files are always available.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add `createos deploy` command

Adds the most-requested missing command — `createos deploy` — which creates
new deployments directly from the CLI.

Automatically detects project type and routes accordingly:
- VCS (GitHub) projects → triggers deploy from latest commit on branch
- Upload projects → zips local directory and uploads (respects .gitignore-style patterns)
- Image projects → deploys a Docker image reference

Features:
- Auto-detects project from .createos.json (or --project flag)
- Real-time deployment status polling with spinner
- Prints live URL on success
- Shows build-log hint on failure
- Upload path: excludes node_modules, .git, .env, __pycache__, etc.
- Upload path: 50MB max, 10MB per-file limit
- 5-minute deployment timeout with graceful fallback

New API methods:
- TriggerLatestDeployment — POST /v1/projects/{id}/deployments/trigger-latest
- UploadDeploymentZip — POST /v1/projects/{id}/deployments/upload/zip
- GetDeployment — GET /v1/projects/{id}/deployments/{id}

Closes #3

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Update release.yaml

* feat: addressed suggested changes

* feat: addressed suggested changes

---------

Co-authored-by: Naman <naman307@Namans-MacBook-Pro.local>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Bhautik <bhautikrchudasama@gmail.com>

Author: 4 people

.github/workflows/release.yaml

@@ -68,6 +68,9 @@ jobs:
       GH_TOKEN: ${{ github.token }}
     steps:
       - uses: actions/checkout@v4
+        with:
+          repository: NodeOps-app/homebrew-tap
+          token: ${{ secrets.TAP_GITHUB_TOKEN }}
 
       - uses: actions/download-artifact@v4
         with:
@@ -77,16 +80,7 @@ jobs:
       - name: Upload release assets
         run: gh release upload "${{ github.ref_name }}" createos-* --clobber
 
-  update-tap:
-    needs: release
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          repository: NodeOps-app/homebrew-tap
-          token: ${{ secrets.TAP_GITHUB_TOKEN }}
-
-      - name: Update formula
+      - name: Update homebrew formula
         run: |
           VERSION="${{ github.ref_name }}"
           VERSION_NUM="${VERSION#v}"

.gitignore

@@ -1,3 +1,5 @@
 .claude
 .createos.json
 .env.*
+cos
+build.sh

README.md

@@ -129,6 +129,33 @@ createos --help
 | `createos projects get`    | Get project details |
 | `createos projects delete` | Delete a project    |
 
+### Deploy
+
+| Command                 | Description                                              |
+| ----------------------- | -------------------------------------------------------- |
+| `createos deploy`       | Deploy your project (auto-detects type)                  |
+
+**Deploy flags:**
+
+| Flag         | Description                                                        |
+| ------------ | ------------------------------------------------------------------ |
+| `--project`  | Project ID (auto-detected from `.createos.json`)                   |
+| `--branch`   | Branch to deploy from (VCS/GitHub projects only)                   |
+| `--image`    | Docker image to deploy (image projects only, e.g. `nginx:latest`)  |
+| `--dir`      | Directory to zip and upload (upload projects only, default: `.`)   |
+
+**Deploy behaviour by project type:**
+
+| Project type   | What happens                                                                          |
+| -------------- | ------------------------------------------------------------------------------------- |
+| VCS / GitHub   | Triggers from the latest commit. Prompts for branch interactively if not provided.   |
+| Upload         | Zips the local directory (respects `.gitignore`), uploads, and streams build logs.   |
+| Image          | Deploys the specified Docker image.                                                   |
+
+**Files excluded from upload zip:**
+
+Sensitive and noisy files are always excluded: `.env`, `.env.*`, secrets/keys (`*.pem`, `*.key`, `*.p12`, etc.), `node_modules`, build artifacts (`target`, `coverage`, etc.), OS/editor files, and anything listed in your project's `.gitignore`.
+
 ### Deployments
 
 | Command                           | Description                          |
@@ -253,6 +280,12 @@ createos --help
 All commands accept flags so they work in CI and non-interactive environments. Destructive commands require `--force` to skip the confirmation prompt.
 
 ```bash
+# Deploy
+createos deploy                                      # upload project — zips current dir
+createos deploy --dir ./dist                         # upload project — zip a specific dir
+createos deploy --branch main                        # VCS project — deploy from main
+createos deploy --image nginx:latest                 # image project
+
 # Projects
 createos projects get --project <id>
 createos projects delete --project <id> --force