sanka-cli 0.1.5__tar.gz

sanka_cli-0.1.5/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Sync dependencies
+        run: uv sync --group dev
+
+      - name: Ruff
+        run: uv run ruff check .
+
+      - name: Tests
+        run: uv run pytest

sanka_cli-0.1.5/.github/workflows/release.yml

@@ -0,0 +1,72 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/sanka-cli
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Sync dependencies
+        run: uv sync --group dev
+
+      - name: Ruff
+        run: uv run ruff check .
+
+      - name: Tests
+        run: uv run pytest
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Generate Homebrew formula
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          SHA256="$(shasum -a 256 "dist/sanka_cli-${VERSION}.tar.gz" | awk '{print $1}')"
+          uv run python scripts/render_homebrew_formula.py \
+            --version "${VERSION}" \
+            --sha256 "${SHA256}" \
+            --output packaging/homebrew/sanka.rb
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            dist/*
+            packaging/homebrew/sanka.rb
+
+      - name: Upload Homebrew formula template
+        uses: actions/upload-artifact@v4
+        with:
+          name: homebrew-formula
+          path: packaging/homebrew/sanka.rb
+
+      # Runs last so a PyPI failure can never block the GitHub release +
+      # formula (v0.1.3 failed here and left no release). Trusted publishing
+      # via the pending publisher for sanka-cli (repo sankaHQ/sanka-cli,
+      # workflow release.yml, environment pypi). v1.14+ required: v1.13's
+      # bundled validator rejects the Metadata-Version 2.5 that uv build
+      # emits (this bit v0.1.4).
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

sanka_cli-0.1.5/.gitignore

@@ -0,0 +1,11 @@
+.DS_Store
+.coverage
+.pytest_cache/
+.ruff_cache/
+.venv/
+__pycache__/
+build/
+dist/
+*.egg-info/
+tracking/
+uv.lock.bak

sanka_cli-0.1.5/AGENTS.md

@@ -0,0 +1,35 @@
+# sanka-cli Agent Guide
+
+Canonical agent instructions for this repo — `CLAUDE.md` symlinks here. Workspace-wide
+rules and the repo map live in the sanka-project workspace repo (`../AGENTS.md`).
+
+## What this is
+
+Public command-line interface for Sanka — a thin wrapper over the public CRM and AI
+API. Business logic stays on the server; the CLI handles developer API token auth and
+refresh, local profile/config management, request construction, table/JSON output, and
+polling for long-running workflow runs.
+
+## Stack & layout
+
+- Python ≥3.11, click + httpx + rich; keyring for token storage, platformdirs for config paths.
+- Package `sanka_cli/`, tests in `tests/`, packaging assets in `packaging/`, install script at `scripts/install.sh`.
+- Published to PyPI as `sanka-cli`; installable via `uv tool install sanka-cli` or the bootstrap script.
+
+## Commands
+
+```bash
+uv sync
+uv run -- python -m pytest tests/ -q
+uv run sanka --help
+```
+
+## Release flow
+
+1. Bump `version` in `pyproject.toml`, tag and create a GitHub Release with the sdist (`sanka_cli-<ver>.tar.gz`).
+2. Update the Homebrew tap: `../homebrew-cli/Formula/sanka.rb` pins the release `url` + `sha256` (plus vendored resource blocks) — it must be updated after every release or `brew install sankaHQ/cli/sanka` ships the old version.
+
+## Gotchas
+
+- Keep it thin: if a feature needs business logic, it belongs in the server API, not here.
+- This repo is public — no internal URLs, workspace paths, or credentials in code, docs, or fixtures.

sanka_cli-0.1.5/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

sanka_cli-0.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sanka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sanka_cli-0.1.5/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.5
+Name: sanka-cli
+Version: 0.1.5
+Summary: Public command-line interface for Sanka
+Project-URL: Homepage, https://github.com/sankaHQ/sanka-cli
+Project-URL: Documentation, https://github.com/sankaHQ/sanka-cli/blob/main/README.md
+Project-URL: Repository, https://github.com/sankaHQ/sanka-cli
+Project-URL: Issues, https://github.com/sankaHQ/sanka-cli/issues
+Author: Sanka
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1.8
+Requires-Dist: httpx>=0.27.2
+Requires-Dist: keyring>=25.6.0
+Requires-Dist: platformdirs>=4.3.6
+Requires-Dist: rich>=13.9.4
+Description-Content-Type: text/markdown
+
+# Sanka CLI
+
+Thin command-line wrapper for Sanka's public CRM and AI API.
+
+The CLI keeps business logic on the server. It handles:
+- Developer API token auth and refresh
+- local profile and config management
+- request construction for CRM, workflow, and AI endpoints
+- table or JSON output
+- polling for long-running workflow runs
+
+## Install
+
+From PyPI:
+
+```bash
+uv tool install sanka-cli
+```
+
+Bootstrap script from a pinned release tag:
+
+```bash
+curl -fsSLO https://raw.githubusercontent.com/sankaHQ/sanka-cli/v0.1.3/scripts/install.sh
+sh install.sh
+```
+
+From a pinned GitHub release tag:
+
+```bash
+uv tool install "git+https://github.com/sankaHQ/sanka-cli.git@v0.1.3"
+```
+
+Homebrew support is published through
+[`sankaHQ/homebrew-cli`](https://github.com/sankaHQ/homebrew-cli). Install with:
+
+```bash
+brew tap sankaHQ/cli
+brew install sankaHQ/cli/sanka
+```
+
+If you previously installed `sanka` from the old `sankaHQ/tap` tap
+(`sankaHQ/homebrew-tap`), remove that formula and untap it first:
+
+```bash
+brew uninstall sanka
+brew untap sankaHQ/tap
+brew tap sankaHQ/cli
+brew install sankaHQ/cli/sanka
+```
+
+## Authenticate
+
+Create a Developer API Token in Sanka, then save it locally. Login verifies the
+token against the API and prints the workspace and user it belongs to; a
+rejected token is not saved. If the API is unreachable, the token is saved with
+a warning so offline setup still works.
+
+```bash
+sanka auth login --access-token "<ACCESS_TOKEN>"
+```
+
+Check the active profile:
+
+```bash
+sanka auth status
+```
+
+## Command Areas
+
+CRM records:
+
+```bash
+sanka companies list
+sanka contacts get <contact-id>
+sanka deals create --data @deal.json
+sanka tickets delete <ticket-id>
+```
+
+Workflow automation:
+
+```bash
+sanka workflows list
+sanka workflows run <workflow-ref>
+sanka workflows run <workflow-ref> --wait
+```
+
+Custom Code — write a workflow action in JavaScript or Python, keep it in your own
+repository, and push versions to Sanka:
+
+```bash
+sanka code init --slug enrich-company --runtime node
+sanka code create
+sanka code push --activate -m "add tier logic"
+```
+
+Your repository is the source of truth. Versions are immutable and content-addressed,
+so pushing unchanged code returns the version that already exists — safe to run on
+every CI merge. Rolling back is a pointer move, not a redeploy:
+
+```bash
+sanka code versions enrich-company
+sanka code rollback enrich-company          # or: deploy --version 4
+```
+
+`pull` writes a deployed version back to disk and `diff` reports whether your working
+directory matches what is live. `diff` exits non-zero when they differ, which makes it
+usable as a CI drift check:
+
+```bash
+sanka code pull enrich-company --dir ./functions/enrich
+sanka code diff --dir ./functions/enrich
+```
+
+Secrets are per-function and never readable back — `list` shows only a masked suffix:
+
+```bash
+sanka code secrets set enrich-company CLEARBIT_API_KEY   # prompts, no echo
+sanka code secrets list enrich-company
+```
+
+Files are excluded from a push by `.sankaignore`; `.git`, `node_modules`,
+`__pycache__`, `.venv`, build output, and `.env` are excluded by default.
+
+AI helpers:
+
+```bash
+sanka ai score company <record-id>
+sanka ai score deal <record-id> --score-model-id <score-model-id>
+sanka ai enrich company <record-id> --force-refresh
+sanka ai enrich company --seed-name "Acme" --seed-url "https://acme.example" --dry-run
+```
+
+## Output Modes
+
+The CLI defaults to table output on a TTY and JSON otherwise. Override this per
+command when needed:
+
+```bash
+sanka --output json companies list
+```
+
+## Environment Overrides
+
+- `SANKA_PROFILE`
+- `SANKA_BASE_URL`
+- `SANKA_ACCESS_TOKEN`
+
+These override stored profile values without persisting them.
+
+## Docs
+
+- [Install](docs/install.md)
+- [Commands](docs/commands.md)
+- [Release](docs/release.md)

sanka_cli-0.1.5/README.md

@@ -0,0 +1,154 @@
+# Sanka CLI
+
+Thin command-line wrapper for Sanka's public CRM and AI API.
+
+The CLI keeps business logic on the server. It handles:
+- Developer API token auth and refresh
+- local profile and config management
+- request construction for CRM, workflow, and AI endpoints
+- table or JSON output
+- polling for long-running workflow runs
+
+## Install
+
+From PyPI:
+
+```bash
+uv tool install sanka-cli
+```
+
+Bootstrap script from a pinned release tag:
+
+```bash
+curl -fsSLO https://raw.githubusercontent.com/sankaHQ/sanka-cli/v0.1.3/scripts/install.sh
+sh install.sh
+```
+
+From a pinned GitHub release tag:
+
+```bash
+uv tool install "git+https://github.com/sankaHQ/sanka-cli.git@v0.1.3"
+```
+
+Homebrew support is published through
+[`sankaHQ/homebrew-cli`](https://github.com/sankaHQ/homebrew-cli). Install with:
+
+```bash
+brew tap sankaHQ/cli
+brew install sankaHQ/cli/sanka
+```
+
+If you previously installed `sanka` from the old `sankaHQ/tap` tap
+(`sankaHQ/homebrew-tap`), remove that formula and untap it first:
+
+```bash
+brew uninstall sanka
+brew untap sankaHQ/tap
+brew tap sankaHQ/cli
+brew install sankaHQ/cli/sanka
+```
+
+## Authenticate
+
+Create a Developer API Token in Sanka, then save it locally. Login verifies the
+token against the API and prints the workspace and user it belongs to; a
+rejected token is not saved. If the API is unreachable, the token is saved with
+a warning so offline setup still works.
+
+```bash
+sanka auth login --access-token "<ACCESS_TOKEN>"
+```
+
+Check the active profile:
+
+```bash
+sanka auth status
+```
+
+## Command Areas
+
+CRM records:
+
+```bash
+sanka companies list
+sanka contacts get <contact-id>
+sanka deals create --data @deal.json
+sanka tickets delete <ticket-id>
+```
+
+Workflow automation:
+
+```bash
+sanka workflows list
+sanka workflows run <workflow-ref>
+sanka workflows run <workflow-ref> --wait
+```
+
+Custom Code — write a workflow action in JavaScript or Python, keep it in your own
+repository, and push versions to Sanka:
+
+```bash
+sanka code init --slug enrich-company --runtime node
+sanka code create
+sanka code push --activate -m "add tier logic"
+```
+
+Your repository is the source of truth. Versions are immutable and content-addressed,
+so pushing unchanged code returns the version that already exists — safe to run on
+every CI merge. Rolling back is a pointer move, not a redeploy:
+
+```bash
+sanka code versions enrich-company
+sanka code rollback enrich-company          # or: deploy --version 4
+```
+
+`pull` writes a deployed version back to disk and `diff` reports whether your working
+directory matches what is live. `diff` exits non-zero when they differ, which makes it
+usable as a CI drift check:
+
+```bash
+sanka code pull enrich-company --dir ./functions/enrich
+sanka code diff --dir ./functions/enrich
+```
+
+Secrets are per-function and never readable back — `list` shows only a masked suffix:
+
+```bash
+sanka code secrets set enrich-company CLEARBIT_API_KEY   # prompts, no echo
+sanka code secrets list enrich-company
+```
+
+Files are excluded from a push by `.sankaignore`; `.git`, `node_modules`,
+`__pycache__`, `.venv`, build output, and `.env` are excluded by default.
+
+AI helpers:
+
+```bash
+sanka ai score company <record-id>
+sanka ai score deal <record-id> --score-model-id <score-model-id>
+sanka ai enrich company <record-id> --force-refresh
+sanka ai enrich company --seed-name "Acme" --seed-url "https://acme.example" --dry-run
+```
+
+## Output Modes
+
+The CLI defaults to table output on a TTY and JSON otherwise. Override this per
+command when needed:
+
+```bash
+sanka --output json companies list
+```
+
+## Environment Overrides
+
+- `SANKA_PROFILE`
+- `SANKA_BASE_URL`
+- `SANKA_ACCESS_TOKEN`
+
+These override stored profile values without persisting them.
+
+## Docs
+
+- [Install](docs/install.md)
+- [Commands](docs/commands.md)
+- [Release](docs/release.md)

sanka_cli-0.1.5/docs/commands.md

@@ -0,0 +1,52 @@
+# Commands
+
+## Authentication
+
+`auth login` verifies the token against the API before saving it and prints the
+workspace, user, and token name on success.
+
+```bash
+sanka auth login --access-token "<ACCESS_TOKEN>"
+sanka auth status
+sanka auth logout
+```
+
+## Profiles
+
+```bash
+sanka profiles list
+sanka profiles use prod
+```
+
+## CRM
+
+```bash
+sanka companies list
+sanka companies get <company-id>
+sanka contacts get <contact-id>
+sanka deals create --data @deal.json
+sanka tickets delete <ticket-id>
+```
+
+## Workflows
+
+```bash
+sanka workflows list
+sanka workflows get <workflow-ref>
+sanka workflows run <workflow-ref> --wait
+```
+
+## AI
+
+```bash
+sanka ai score company <record-id>
+sanka ai score deal <record-id> --score-model-id <score-model-id>
+sanka ai enrich company <record-id> --force-refresh
+sanka ai enrich company --seed-name "Acme" --seed-url "https://acme.example" --dry-run
+```
+
+## Output
+
+```bash
+sanka --output json companies list
+```

sanka_cli-0.1.5/docs/install.md

@@ -0,0 +1,56 @@
+# Install
+
+## From PyPI
+
+This is the default install path:
+
+```bash
+uv tool install sanka-cli
+```
+
+## Bootstrap Script
+
+```bash
+curl -fsSLO https://raw.githubusercontent.com/sankaHQ/sanka-cli/v0.1.3/scripts/install.sh
+sh install.sh
+```
+
+The script requires `uv` to be installed already and installs the pinned PyPI
+release by default. If a fallback is needed, set `SANKA_CLI_FALLBACK_SPEC` to an
+exact version or pinned Git ref, such as `sanka-cli==0.1.3` or
+`git+https://github.com/sankaHQ/sanka-cli.git@v0.1.3`.
+
+## From GitHub
+
+Use an immutable tag, not the moving default branch:
+
+```bash
+uv tool install "git+https://github.com/sankaHQ/sanka-cli.git@v0.1.3"
+```
+
+## Homebrew
+
+Tagged releases generate `packaging/homebrew/sanka.rb` with the exact release checksum,
+and the published tap lives in [`sankaHQ/homebrew-cli`](https://github.com/sankaHQ/homebrew-cli):
+
+```bash
+brew tap sankaHQ/cli
+brew install sankaHQ/cli/sanka
+```
+
+If you installed an older preview from `sankaHQ/tap`
+(`sankaHQ/homebrew-tap`), remove the old formula and untap it before
+installing from the new tap:
+
+```bash
+brew uninstall sanka
+brew untap sankaHQ/tap
+brew tap sankaHQ/cli
+brew install sankaHQ/cli/sanka
+```
+
+## Local Development
+
+```bash
+uv tool install .
+```

sanka_cli-0.1.5/docs/release.md

@@ -0,0 +1,29 @@
+# Release
+
+This repository is the public source for the `sanka` CLI. Tagged releases build the
+Python distributions, run tests, and generate the Homebrew formula from the release
+artifact checksum.
+
+## Release Flow
+
+1. Update `sanka_cli/__init__.py` and `pyproject.toml` to the release version.
+2. Create and push a tag such as `v0.1.0`.
+3. GitHub Actions builds the sdist and wheel, runs Ruff and pytest, and attaches the
+   artifacts to the GitHub release.
+4. The release workflow renders `packaging/homebrew/sanka.rb` with the exact checksum
+   for the tagged sdist and uploads that formula as a release artifact.
+5. Copy the generated formula into `sankaHQ/homebrew-cli`.
+6. Publish to PyPI when the repository has a configured `PYPI_API_TOKEN`.
+
+## Homebrew Formula
+
+The formula in this repo is generated, not hand-maintained. Re-render it locally with:
+
+```bash
+uv run python scripts/render_homebrew_formula.py \
+  --version 0.1.0 \
+  --sha256 <sha256-of-sanka_cli-0.1.0.tar.gz> \
+  --output packaging/homebrew/sanka.rb
+```
+
+The formula points at the GitHub release asset for the matching version.