ci: add GitHub Actions workflow for tests + manifest drift check (#2)

* ci: add GitHub Actions workflow for tests + manifest drift check

Runs on push to main and on every PR. Mirrors the local invocation
exactly: install dev deps, run `python -m klarity_mcp --check` to catch
manifest drift, then run pytest. Single Python version (3.12) keeps the
job fast; can expand to a matrix later if 3.11 / 3.13 support actually
needs validating in CI.

Once this lands and runs green once, the `test` check name will be
available to add as a required status check on main if desired.

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

* ci: swap pip → uv for faster dependency install

uv pip install is roughly 5-10x faster than pip and the action's built-in
cache is keyed on pyproject.toml. Drops cold install from ~15s to ~2s and
warm install from ~3s to ~1s. Uses --system to install into the Python
provided by setup-python (no venv layer needed).

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

* assets: add Microsoft Copilot + multi-vendor logo, hero, and screenshot assets

Generated from logo.png (1092x1092) at all sizes required by Microsoft
Partner Center, OpenAI, and Anthropic. Includes app-package/ icons
(color.png 192x192, outline.png 32x32 transparent white) for the M365
manifest.json package zip. The outline.png uses a dedicated white-on-
transparent K mark (~/Downloads/K-White.png) rather than the full-color
logo, so it reads cleanly at 32x32 against the Teams left rail.

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

* release: bump version 0.1.0 → 1.0.0

Microsoft Teams store validator rejects manifests whose version starts
with '0' (verbatim: "App version should not start with '0'. Ex: 0.0.1
or 0.1 are not valid app versions and 1.0 / 1.5.1 / 1.0.0 / 2.5.0 are
valid app versions"). Bump to 1.0.0 ahead of M365 submission.

Cascades through all three public manifests via build_manifest_payloads:
- .claude-plugin/plugin.json
- .mcp.json (no version field — unchanged)
- gemini-extension.json

Architect-api's M365 manifest also reads plugin_version from this metadata,
so the next regen of private/microsoft-copilot-manifest.json picks up 1.0.0.

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

---------

Co-authored-by: Aditya Thiruvengadam <aditya@klaritylaw.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: 3 people

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "klarity",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Bring your organization's processes and operational knowledge into your AI assistant. The Klarity MCP connects to your Klarity workspace so you can query your organization's processes, explore the process index knowledge graph linking processes to systems and teams, and ground answers in how your business actually runs \u2014 not generic guesses.",
   "author": {
     "name": "Klarity Intelligence, Inc.",

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - 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@v3
+        with:
+          enable-cache: true
+          cache-dependency-glob: pyproject.toml
+
+      - name: Install dev dependencies
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Verify manifests are in sync
+        run: python -m klarity_mcp --check
+
+      - name: Run tests
+        run: pytest -v

assets/README.md

@@ -0,0 +1,71 @@
+# assets/
+
+Marketing and submission assets for Klarity MCP across vendor app stores.
+
+## Layout
+
+```
+assets/
+  logos/         # square brand logo at multiple sizes (master + downscaled)
+  hero/          # hero/banner image for store listings
+  screenshots/   # product screenshots (vendor-neutral filenames)
+  app-package/   # Microsoft 365 app-package icons (filenames pinned to manifest)
+```
+
+## Naming convention
+
+`klarity-{kind}-{WIDTH}x{HEIGHT}.{ext}` — sortable, self-describing, vendor-neutral.
+
+Exception: `app-package/color.png` and `app-package/outline.png` use Microsoft's
+required filenames so they match the `icons` block in `manifest.json`.
+
+## Vendor mapping
+
+**Microsoft 365 Copilot — Partner Center listing**
+- `logos/klarity-logo-48x48.png` (small)
+- `logos/klarity-logo-90x90.png` (medium)
+- `logos/klarity-logo-216x216.png` (large)
+- `hero/klarity-hero-815x378.png`
+- `screenshots/klarity-screenshot-1-1366x768.png`
+- `screenshots/klarity-screenshot-2-1366x768.png`
+
+**Microsoft 365 Copilot — app-package zip** (filenames must match `manifest.json`)
+- `app-package/color.png` (192x192, full color)
+- `app-package/outline.png` (32x32, transparent + white only, dedicated K-mark)
+
+**OpenAI / Anthropic / general listings**
+- `logos/klarity-logo-512x512.png`
+- `screenshots/klarity-screenshot-{1,2}-original.png` (706x557, 706x478)
+
+## Sources
+
+- Master logo (1092x1092): `~/Downloads/klarity-logo-1092x1092.png`, identical
+  (sha256-matched) to `klarity-mcp/logo.png` at the repo root.
+- Outline source (white K on transparent): `~/Downloads/K-White.png` (243x292).
+  Distinct from the full-color logo — used only for `app-package/outline.png`.
+  Cleaned + archived at `logos/klarity-logo-mark-white-243x292.png`.
+- Hero source: `~/Downloads/klarityai_cover.jpeg` (1128x191 banner).
+  Letterboxed onto extended-edge gradient to fit 815x378.
+- Screenshot sources: `~/Desktop/klarity-chatgpt-app-screenshot-{1,2}.png`.
+  Renamed to vendor-neutral `klarity-screenshot-{1,2}-*` and letterboxed onto
+  the matching dark-gray background (#212121) to fit 1366x768.
+
+## Regeneration
+
+All assets derive from the master `logo.png` plus the source files above.
+To regenerate logos at new sizes (requires Pillow in the active env):
+
+```bash
+poetry run python3 - <<'PY'
+from PIL import Image
+master = Image.open("logo.png")
+for s in (1092, 512, 216, 192, 90, 48):
+    out = f"assets/logos/klarity-logo-{s}x{s}.png"
+    img = master if s == 1092 else master.resize((s, s), Image.LANCZOS)
+    img.save(out, "PNG", optimize=True)
+PY
+```
+
+The Microsoft `app-package/outline.png` is not derived from `logo.png`; see
+the recipe in the original asset-generation task — it uses the dedicated
+white-on-transparent K mark and force-whitens any non-transparent pixels.