affinity-sdk 0.9.2__tar.gz → 0.9.9__tar.gz

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/.github/workflows/plugin-release.yml

@@ -3,22 +3,20 @@ name: Release MCP Plugin
 on:
   push:
     tags: ["mcp-v*.*.*"]  # Renamed from plugin-v*
-  workflow_call:
+  workflow_dispatch:
     inputs:
       version:
-        description: "Version to release (without prefix)"
-        required: true
+        description: "Version to release (without prefix, for API trigger)"
+        required: false
         type: string
       triggered_by:
         description: "What triggered this release"
         required: false
         type: string
-        default: "tag"
-  workflow_dispatch:
-    inputs:
+        default: "manual"
       tag:
-        description: 'Tag to release (e.g., mcp-v1.0.0)'
-        required: true
+        description: 'Tag to release manually (e.g., mcp-v1.0.0, ignored if version set)'
+        required: false
 
 permissions:
   contents: write
@@ -32,24 +30,37 @@ jobs:
         run: |
           set -euo pipefail
           if [[ -n "${{ inputs.version }}" ]]; then
-            # Called via workflow_call
+            # API-triggered release (from release-detect)
+            # Note: Version validation happens post-checkout in "Validate version matches VERSION file" step
             echo "version=${{ inputs.version }}" >> $GITHUB_OUTPUT
             echo "tag_name=mcp-v${{ inputs.version }}" >> $GITHUB_OUTPUT
-            echo "is_workflow_call=true" >> $GITHUB_OUTPUT
-            echo "Mode: workflow_call, version=${{ inputs.version }}"
+            echo "is_api_trigger=true" >> $GITHUB_OUTPUT
+            echo "Mode: workflow_dispatch (API), version=${{ inputs.version }}, triggered_by=${{ inputs.triggered_by }}"
+          elif [[ "${GITHUB_EVENT_NAME}" == "push" && "${GITHUB_REF_TYPE}" == "tag" ]]; then
+            # Tag push
+            TAG_NAME="${GITHUB_REF_NAME}"
+            VERSION="${TAG_NAME#mcp-v}"
+            echo "version=$VERSION" >> $GITHUB_OUTPUT
+            echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
+            echo "is_api_trigger=false" >> $GITHUB_OUTPUT
+            echo "Mode: tag push, tag=$TAG_NAME, version=$VERSION"
           else
-            # Called via tag push or workflow_dispatch
-            TAG_NAME="${{ github.event.inputs.tag || github.ref_name }}"
+            # Manual workflow_dispatch with tag input
+            TAG_NAME="${{ inputs.tag }}"
+            if [[ -z "$TAG_NAME" ]]; then
+              echo "::error::Manual dispatch requires either 'version' or 'tag' input"
+              exit 1
+            fi
             VERSION="${TAG_NAME#mcp-v}"
             echo "version=$VERSION" >> $GITHUB_OUTPUT
             echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
-            echo "is_workflow_call=false" >> $GITHUB_OUTPUT
-            echo "Mode: tag/dispatch, tag=$TAG_NAME, version=$VERSION"
+            echo "is_api_trigger=false" >> $GITHUB_OUTPUT
+            echo "Mode: workflow_dispatch (manual), tag=$TAG_NAME, version=$VERSION"
           fi
 
       - uses: actions/checkout@v6
         with:
-          ref: ${{ steps.version.outputs.is_workflow_call == 'true' && 'main' || (github.event.inputs.tag || github.ref) }}
+          ref: ${{ steps.version.outputs.is_api_trigger == 'true' && 'main' || (github.event.inputs.tag || github.ref) }}
 
       - name: Validate version matches VERSION file
         run: |
@@ -118,8 +129,8 @@ jobs:
           "$EXTRACT_DIR/server/run-server.sh" --health || echo "Health check not available (expected if CLI not configured)"
           rm -rf "$EXTRACT_DIR"
 
-      - name: Create and push tag
-        if: steps.version.outputs.is_workflow_call == 'true'
+      - name: Create and push tag (API trigger only)
+        if: steps.version.outputs.is_api_trigger == 'true'
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/.github/workflows/release-detect.yml

@@ -15,6 +15,7 @@ on:
 
 permissions:
   contents: read
+  actions: write  # Required for workflow_dispatch API
 
 jobs:
   detect-changes:
@@ -76,23 +77,59 @@ jobs:
   trigger-sdk-release:
     needs: detect-changes
     if: needs.detect-changes.outputs.sdk_changed == 'true'
-    uses: ./.github/workflows/release.yml
-    with:
-      version: ${{ needs.detect-changes.outputs.sdk_version }}
-      triggered_by: version-bump
-    secrets: inherit
-    permissions:
-      contents: write
-      id-token: write
-      attestations: write
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger SDK release workflow
+        uses: actions/github-script@v7
+        with:
+          script: |
+            // Use toJSON for safe string interpolation
+            const version = ${{ toJSON(needs.detect-changes.outputs.sdk_version) }};
+            console.log(`Triggering SDK release workflow for version ${version}`);
+
+            try {
+              await github.rest.actions.createWorkflowDispatch({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                workflow_id: 'release.yml',
+                ref: 'main',
+                inputs: {
+                  version: version,
+                  triggered_by: 'release-detect'
+                }
+              });
+              console.log(`✅ SDK release workflow triggered successfully for v${version}`);
+            } catch (error) {
+              console.error(`❌ Failed to trigger SDK release: ${error.message}`);
+              core.setFailed(`Failed to trigger SDK release workflow: ${error.message}`);
+            }
 
   trigger-mcp-release:
     needs: detect-changes
     if: needs.detect-changes.outputs.mcp_changed == 'true'
-    uses: ./.github/workflows/plugin-release.yml
-    with:
-      version: ${{ needs.detect-changes.outputs.mcp_version }}
-      triggered_by: version-bump
-    secrets: inherit
-    permissions:
-      contents: write
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger MCP plugin release workflow
+        uses: actions/github-script@v7
+        with:
+          script: |
+            // Use toJSON for safe string interpolation
+            const version = ${{ toJSON(needs.detect-changes.outputs.mcp_version) }};
+            console.log(`Triggering MCP plugin release workflow for version ${version}`);
+
+            try {
+              await github.rest.actions.createWorkflowDispatch({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                workflow_id: 'plugin-release.yml',
+                ref: 'main',
+                inputs: {
+                  version: version,
+                  triggered_by: 'release-detect'
+                }
+              });
+              console.log(`✅ MCP release workflow triggered successfully for v${version}`);
+            } catch (error) {
+              console.error(`❌ Failed to trigger MCP release: ${error.message}`);
+              core.setFailed(`Failed to trigger MCP release workflow: ${error.message}`);
+            }

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/.github/workflows/release.yml

@@ -3,22 +3,20 @@ name: Release (PyPI)
 on:
   push:
     tags: ["v*.*.*"]
-  workflow_call:
+  workflow_dispatch:
     inputs:
       version:
-        description: "Version to release (without v prefix)"
-        required: true
+        description: "Version to release (without v prefix, for API trigger)"
+        required: false
         type: string
       triggered_by:
         description: "What triggered this release"
         required: false
         type: string
-        default: "tag"
-  workflow_dispatch:
-    inputs:
+        default: "manual"
       target:
-        description: "Publish target (manual runs only)"
-        required: true
+        description: "Publish target (manual TestPyPI only, ignored if version set)"
+        required: false
         default: "none"
         type: choice
         options:
@@ -31,7 +29,8 @@ permissions:
   attestations: write
 
 concurrency:
-  group: release-${{ github.ref }}
+  # Use version for API triggers, ref_name for tag pushes
+  group: release-${{ inputs.version || github.ref_name }}
   cancel-in-progress: false
 
 jobs:
@@ -41,7 +40,7 @@ jobs:
       tag_name: ${{ steps.meta.outputs.tag_name }}
       version_tag: ${{ steps.meta.outputs.version_tag }}
       publish_target: ${{ steps.meta.outputs.publish_target }}
-      is_workflow_call: ${{ steps.meta.outputs.is_workflow_call }}
+      is_api_trigger: ${{ steps.meta.outputs.is_api_trigger }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -53,16 +52,22 @@ jobs:
         run: |
           set -euo pipefail
 
-          # Check if this is a workflow_call (version input provided)
           if [[ -n "${{ inputs.version }}" ]]; then
-            echo "is_workflow_call=true" >> "$GITHUB_OUTPUT"
+            # API-triggered release (from release-detect)
+            # IMPORTANT: Verify version matches pyproject.toml to prevent mismatches
+            PYPROJECT_VERSION=$(grep '^version = ' pyproject.toml | head -1 | cut -d'"' -f2)
+            if [[ "${{ inputs.version }}" != "$PYPROJECT_VERSION" ]]; then
+              echo "::error::Version mismatch: input=${{ inputs.version }}, pyproject.toml=$PYPROJECT_VERSION"
+              exit 1
+            fi
+            echo "is_api_trigger=true" >> "$GITHUB_OUTPUT"
             echo "version_tag=${{ inputs.version }}" >> "$GITHUB_OUTPUT"
             echo "tag_name=v${{ inputs.version }}" >> "$GITHUB_OUTPUT"
             echo "publish_target=pypi" >> "$GITHUB_OUTPUT"
-            echo "Mode: workflow_call, version=${{ inputs.version }}"
+            echo "Mode: workflow_dispatch (API), version=${{ inputs.version }}, triggered_by=${{ inputs.triggered_by }}"
           elif [[ "${GITHUB_EVENT_NAME}" == "push" && "${GITHUB_REF_TYPE}" == "tag" ]]; then
             # Tag push
-            echo "is_workflow_call=false" >> "$GITHUB_OUTPUT"
+            echo "is_api_trigger=false" >> "$GITHUB_OUTPUT"
             echo "publish_target=pypi" >> "$GITHUB_OUTPUT"
             echo "tag_name=${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
             if [[ "${GITHUB_REF_NAME}" != v* ]]; then
@@ -72,16 +77,16 @@ jobs:
             echo "version_tag=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
             echo "Mode: tag push, tag=${GITHUB_REF_NAME}"
           else
-            # Manual workflow_dispatch
-            echo "is_workflow_call=false" >> "$GITHUB_OUTPUT"
+            # Manual workflow_dispatch (TestPyPI dry run)
+            echo "is_api_trigger=false" >> "$GITHUB_OUTPUT"
             echo "publish_target=${{ inputs.target }}" >> "$GITHUB_OUTPUT"
             echo "tag_name=${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
             echo "version_tag=" >> "$GITHUB_OUTPUT"
-            echo "Mode: workflow_dispatch, target=${{ inputs.target }}"
+            echo "Mode: workflow_dispatch (manual), target=${{ inputs.target }}"
           fi
 
       - name: Require tag ref for publishing (tag-triggered only)
-        if: ${{ steps.meta.outputs.publish_target == 'pypi' && steps.meta.outputs.is_workflow_call != 'true' && github.ref_type != 'tag' }}
+        if: ${{ steps.meta.outputs.publish_target == 'pypi' && steps.meta.outputs.is_api_trigger != 'true' && github.ref_type != 'tag' }}
         shell: bash
         run: |
           echo "Publishing requires running the workflow on a tag ref (vX.Y.Z)." >&2
@@ -112,7 +117,7 @@ jobs:
           echo "Version validated: $PYPROJECT_VERSION"
 
       - name: Validate commit is on main (tag-triggered only)
-        if: ${{ steps.meta.outputs.is_workflow_call != 'true' && github.ref_type == 'tag' }}
+        if: ${{ steps.meta.outputs.is_api_trigger != 'true' && github.ref_type == 'tag' }}
         shell: bash
         run: |
           set -euo pipefail
@@ -185,6 +190,47 @@ jobs:
           path: dist/
           if-no-files-found: error
 
+      # Build MCPB bundle for convenience (same commit as SDK)
+      - name: Install jq
+        run: sudo apt-get install -y jq
+
+      - name: Install mcp-bash framework
+        run: |
+          # Source version and commit from lockfile (single source of truth)
+          source mcp/mcp-bash.lock
+          echo "Installing mcp-bash v${MCPBASH_VERSION} (${MCPBASH_COMMIT})"
+          curl -fsSL https://raw.githubusercontent.com/yaniv-golan/mcp-bash-framework/main/install.sh | \
+            bash -s -- --version "v${MCPBASH_VERSION}" --yes
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+          # Verify installed commit matches lockfile
+          INSTALLED_COMMIT=$(git -C "${XDG_DATA_HOME:-$HOME/.local/share}/mcp-bash" rev-parse HEAD)
+          if [[ "$INSTALLED_COMMIT" != "$MCPBASH_COMMIT" ]]; then
+            echo "::error::mcp-bash commit mismatch: expected $MCPBASH_COMMIT, got $INSTALLED_COMMIT"
+            exit 1
+          fi
+
+      - name: Build Claude Code plugin ZIP
+        run: |
+          cd mcp
+          make plugin
+          echo "Plugin version: $(cat .claude-plugin/VERSION)"
+          ls -la .claude-plugin/xaffinity-mcp-plugin.zip
+
+      - name: Build MCPB bundle
+        run: |
+          cd mcp
+          mcp-bash bundle --output dist --verbose
+          ls -la dist/*.mcpb
+
+      - name: Upload MCPB artifacts
+        uses: actions/upload-artifact@v6
+        with:
+          name: mcpb-${{ needs.validate.outputs.tag_name }}
+          path: |
+            mcp/.claude-plugin/xaffinity-mcp-plugin.zip
+            mcp/dist/*.mcpb
+          if-no-files-found: error
+
   publish:
     runs-on: ubuntu-latest
     needs: [validate, build]
@@ -197,25 +243,22 @@ jobs:
           name: dist-${{ needs.validate.outputs.tag_name }}
           path: dist/
 
-      # Note: attestations are disabled for workflow_call because PyPI's Trusted
-      # Publishing attestation feature doesn't support reusable workflows.
-      # See: https://docs.pypi.org/trusted-publishers/troubleshooting/#reusable-workflows-on-github
       - name: Publish to PyPI (trusted publishing)
         if: ${{ needs.validate.outputs.publish_target == 'pypi' }}
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
-          attestations: ${{ needs.validate.outputs.is_workflow_call != 'true' }}
+          attestations: true
 
       - name: Publish to TestPyPI (trusted publishing)
         if: ${{ needs.validate.outputs.publish_target == 'testpypi' }}
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           repository-url: https://test.pypi.org/legacy/
-          attestations: ${{ needs.validate.outputs.is_workflow_call != 'true' }}
+          attestations: true
 
   github-release:
     runs-on: ubuntu-latest
-    needs: [validate, publish]
+    needs: [validate, build, publish]
     if: ${{ needs.validate.outputs.publish_target == 'pypi' }}
     steps:
       - uses: actions/checkout@v6
@@ -239,8 +282,14 @@ jobs:
           name: dist-${{ needs.validate.outputs.tag_name }}
           path: dist/
 
-      - name: Create and push tag (workflow_call only)
-        if: ${{ needs.validate.outputs.is_workflow_call == 'true' }}
+      - name: Download MCPB artifacts
+        uses: actions/download-artifact@v7
+        with:
+          name: mcpb-${{ needs.validate.outputs.tag_name }}
+          path: mcpb/
+
+      - name: Create and push tag (API trigger only)
+        if: ${{ needs.validate.outputs.is_api_trigger == 'true' }}
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
@@ -253,7 +302,9 @@ jobs:
           tag_name: ${{ needs.validate.outputs.tag_name }}
           name: SDK ${{ needs.validate.outputs.tag_name }}
           body_path: release_notes.md
-          files: dist/*
+          files: |
+            dist/*
+            mcpb/**/*
           fail_on_unmatched_files: true
 
   smoke-test:
@@ -269,11 +320,15 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Smoke test installation
+      - name: Smoke test SDK installation
+        run: |
+          pip install affinity-sdk==${{ needs.validate.outputs.version_tag }}
+          python -c "from affinity import Affinity; print('SDK import OK')"
+
+      - name: Smoke test CLI installation
         run: |
-          pip install affinity-api==${{ needs.validate.outputs.version_tag }}
-          python -c "from affinity import Affinity; print('Import OK')"
-          python -c "from affinity.cli import app; print('CLI OK')"
+          pip install "affinity-sdk[cli]==${{ needs.validate.outputs.version_tag }}"
+          python -c "from affinity.cli import cli; print('CLI import OK')"
 
       - name: Warn on failure
         if: failure()

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/CHANGELOG.md

@@ -5,8 +5,106 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.9.9 - 2026-01-14
+
+### Added
+- CLI: `query` command now supports advanced relationship filtering:
+  - `all` quantifier: Filter where all related items match a condition (e.g., find persons where all their companies have ".com" domains)
+  - `none` quantifier: Filter where no related items match a condition (e.g., find persons with no spam interactions)
+  - `exists` subquery: Filter where at least one related item exists, optionally matching a condition (e.g., find persons who have email interactions)
+  - `_count` pseudo-field: Filter by count of related items (e.g., `"path": "companies._count", "op": "gte", "value": 2`)
+  - Available relationship paths: persons→companies/opportunities/interactions/notes/listEntries, companies→persons/opportunities/interactions/notes/listEntries, opportunities→persons/companies/interactions
+  - Note: These features cause N+1 API calls to fetch relationship data; use `--dry-run` to preview
+
+### Changed (Breaking)
+- CLI: Renamed relationship `"people"` to `"persons"` for consistency with entity type names:
+  - Query `include`: `{"from": "companies", "include": ["people"]}` → use `["persons"]`
+  - CLI `--expand`: `xaffinity company get <id> --expand people` → use `--expand persons`
+  - JSON output: `data.people` → `data.persons`
+
+### Fixed
+- CLI: Query engine no longer silently passes all records for `all`, `none`, and `_count` filters. Previously these were placeholder implementations that returned `True` for all records, causing incorrect query results. (Bug #15)
+
+## 0.9.8 - 2026-01-12
+
+### Fixed
+- CLI: `query` command now correctly fetches all records before applying filter, sort, or aggregate operations. Previously, limits were applied during fetch which caused incorrect results:
+  - With filters: Empty results when matching records were beyond the limit position
+  - With sort + limit: Random N records sorted instead of actual top N
+  - With aggregate: Inaccurate counts/sums computed on partial data
+
+## 0.9.7 - 2026-01-12
+
+### Fixed
+- CI: Smoke test now correctly installs CLI extras before testing CLI import
+
+## 0.9.6 - 2026-01-12
+
+### Added
+- CLI: `listEntries` queries now include convenience aliases: `listEntryId`, `entityId`, `entityName`, `entityType`. These intuitive field names work in both `select` and `where` clauses.
+- CLI: `listEntries` records now always include a `fields` key (defaults to `{}` if no custom fields).
+
+### Changed
+- CLI: Query projection now includes null values for explicitly selected fields. Previously, `select: ["entityName", "fields.Status"]` would return `{}` if Status was null; now returns `{"entityName": "Acme", "fields": {"Status": null}}`.
+
+## 0.9.5 - 2026-01-12
+
+### Added
+- CLI: New `--output`/`-o` option supporting multiple formats: `json`, `jsonl`, `markdown`, `toon`, `csv`, `table` (default).
+  - `markdown`: GitHub-flavored markdown tables, best for LLM analysis and comprehension
+  - `toon`: Token-Optimized Object Notation, 30-60% fewer tokens than JSON for large datasets
+  - `jsonl`: JSON Lines format, one object per line for streaming workflows
+  - Example: `xaffinity person ls --output markdown`, `xaffinity query -o toon`
+  - Existing `--csv` and `--json` flags continue to work as before.
+
+### Changed
+- CLI: `to_cell()` now extracts "text" from dropdown/multi-select fields instead of JSON-serializing the full dict. This makes CSV and other tabular outputs human-readable for dropdown values.
+
+### Fixed
+- CLI: `query` command with `limit` now correctly returns results when combined with client-side filters (like `has_any` on multi-select fields). Previously, the limit was applied during fetch before filtering, causing empty results when the first N records didn't match the filter criteria.
+
+## 0.9.4 - 2026-01-12
+
+### Added
+- CLI: `query` command now supports `has_any` and `has_all` operators for multi-select field filtering.
+- SDK/CLI: Filter parser now supports V2 API comparison operators: `>`, `>=`, `<`, `<=` for numeric/date comparisons.
+- SDK/CLI: Filter parser now supports word-based operator aliases for LLM/human clarity:
+  - `contains`, `starts_with`, `ends_with` (string matching)
+  - `gt`, `gte`, `lt`, `lte` (numeric/date comparisons)
+  - `is null`, `is not null`, `is empty` (null/empty checks)
+- SDK/CLI: Filter parser now supports collection bracket syntax `[A, B, C]` with operators:
+  - `in [A, B]` - value is one of the listed values
+  - `between [1, 10]` - value is in range (inclusive)
+  - `has_any [A, B]` - array field contains any of the values
+  - `has_all [A, B]` - array field contains all of the values
+  - `contains_any [A, B]` - substring match for any term
+  - `contains_all [A, B]` - substring match for all terms
+  - `= [A, B]` - set equality (array has exactly these elements)
+  - `=~ [A, B]` - V2 API collection contains (array contains all elements)
+
+### Fixed
+- CLI: `query` command now correctly filters on multi-select dropdown fields (like "Team Member"). The `eq` operator checks array membership for scalar values and set equality for array values. Previously, these queries returned 0 results due to strict equality comparison.
+- SDK/CLI: `list export --filter` now correctly matches multi-select dropdown fields. The `=`, `!=`, and `=~` operators now handle array values properly. Also fixes extraction of text values from multi-select dropdown API responses.
+- SDK/CLI: Fixed `=^` (starts_with) and `=$` (ends_with) operators which were broken due to tokenizer ordering issue.
+
+### Improved
+- SDK/CLI: Filter parser now provides helpful hints for common mistakes:
+  - Multi-word field names: suggests quoting (`"Team Member"`)
+  - Multi-word values: suggests quoting (`"Intro Meeting"`)
+  - SQL keywords (`AND`, `OR`): suggests correct symbols (`&`, `|`)
+  - Double equals (`==`): suggests single `=`
+
+## 0.9.3 - 2026-01-11
+
+### Changed
+- CI: SDK releases now include MCPB bundle and plugin ZIP for convenience.
+- CI: Enabled PyPI attestations via workflow_dispatch API trigger.
+
 ## 0.9.2 - 2026-01-11
 
+### Fixed
+- SDK: `AsyncListEntryService.pages()` now supports `progress_callback` parameter (sync/async parity fix).
+
 ### Changed
 - **BREAKING**: CLI: `interaction ls` JSON output restructured for consistency:
   - `.data.interactions` → `.data` (direct array)

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: affinity-sdk
-Version: 0.9.2
+Version: 0.9.9
 Summary: A modern, strongly-typed Python SDK for the Affinity CRM API
 Project-URL: Homepage, https://github.com/yaniv-golan/affinity-sdk
 Project-URL: Documentation, https://yaniv-golan.github.io/affinity-sdk/latest/

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/VERSIONING.md

@@ -69,7 +69,12 @@ The release detection workflow compares the current version in version files aga
 3. It checks if release tags exist:
    - SDK: checks for `v{version}` tag (e.g., `v0.9.2`)
    - MCP: checks for `mcp-v{version}` tag (e.g., `mcp-v1.7.6`)
-4. If no tag exists for the current version, it triggers the release workflow
+4. If no tag exists for the current version, it triggers the release workflow via `workflow_dispatch` API
+
+The release workflows are triggered via GitHub's workflow_dispatch API (not reusable workflows). This enables:
+- **PyPI attestations**: Full provenance attestation support for all releases
+- **GITHUB_TOKEN**: No PATs or GitHub Apps required
+- **Tag creation post-publish**: Tags are created after successful PyPI publish (SDK) or GitHub release (MCP)
 
 This approach is robust regardless of how many commits are pushed together, squash merges, rebases, or any other git workflow.
 
@@ -82,6 +87,8 @@ This approach is robust regardless of how many commits are pushed together, squa
 5. Commit and push to `main` (or merge PR)
 6. **Release runs automatically** — tag created post-release
 
+SDK releases include MCPB bundles (built from the same commit) for convenience, so users don't need to find separate MCP releases.
+
 ### MCP Release
 
 1. Update `mcp/VERSION`

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/affinity/cli/__init__.py

@@ -5,3 +5,7 @@ This package is only intended to be used when installing `affinity-sdk[cli]`.
 """
 
 from __future__ import annotations
+
+from .main import cli
+
+__all__ = ["cli"]

{affinity_sdk-0.9.2 → affinity_sdk-0.9.9}/affinity/cli/commands/company_cmds.py

@@ -1066,7 +1066,7 @@ def company_files_upload(
     "--expand",
     "expand",
     multiple=True,
-    type=click.Choice(["lists", "list-entries", "people"]),
+    type=click.Choice(["lists", "list-entries", "persons"]),
     help="Include related data (repeatable).",
 )
 @click.option(
@@ -1452,26 +1452,26 @@ def company_get(
                 )
                 data["listEntries"] = entries_items
 
-            if "people" in expand_set:
-                people_cap = max_results
-                if people_cap is None and not all_pages:
-                    people_cap = 100
-                if people_cap is not None and people_cap <= 0:
-                    data["people"] = []
+            if "persons" in expand_set:
+                persons_cap = max_results
+                if persons_cap is None and not all_pages:
+                    persons_cap = 100
+                if persons_cap is not None and persons_cap <= 0:
+                    data["persons"] = []
                 else:
                     person_ids = client.companies.get_associated_person_ids(company_id)
-                    total_people = len(person_ids)
-                    if people_cap is not None and total_people > people_cap:
+                    total_persons = len(person_ids)
+                    if persons_cap is not None and total_persons > persons_cap:
                         warnings.append(
-                            f"People truncated at {people_cap:,} items; re-run with --all "
+                            f"Persons truncated at {persons_cap:,} items; re-run with --all "
                             "or a higher --max-results to fetch more."
                         )
 
-                    people = client.companies.get_associated_people(
+                    persons = client.companies.get_associated_people(
                         company_id,
-                        max_results=people_cap,
+                        max_results=persons_cap,
                     )
-                    data["people"] = [
+                    data["persons"] = [
                         {
                             "id": int(person.id),
                             "name": person.full_name,
@@ -1484,7 +1484,7 @@ def company_get(
                                 else None
                             ),
                         }
-                        for person in people
+                        for person in persons
                     ]
 
         if "list-entries" in expand_set and entries_items and ctx.output != "json":