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

{affinity_sdk-0.9.2 → affinity_sdk-0.9.11}/.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.11}/.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.11}/.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.11}/.gitignore

@@ -58,3 +58,4 @@ tools/tmp_readonly_endpoint_syntax_suite.py
 tmp-scripts/set_primary_email_status.py
 test-output/
 CLAUDE.md
+.sandbox.env

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

@@ -5,8 +5,151 @@ 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).
 
+## [Unreleased]
+
+## 0.9.11 - 2026-01-17
+
+### Added
+- CLI: Query `include` clause now displays included relationships inline by default. Use `--include-style=separate` for separate tables or `--include-style=ids-only` for raw IDs. JSON output includes full `included` and `included_by_parent` mappings for correlation.
+- CLI: Query `include` extended syntax for custom display fields: `include: {companies: {display: ["name", "domain"]}}`.
+- SDK: `with_interaction_dates` and `with_interaction_persons` parameters for `CompanyService.get()` and `PersonService.get()`. When enabled, routes to V1 API to fetch interaction date summaries (last/next meeting, email dates, team member IDs).
+- CLI: `--expand interactions` option for `list export` command. Adds interaction date summaries to each list entry (last meeting, next meeting, last email, last interaction with daysSince/daysUntil calculations and team member names). Supports both JSON and CSV output formats.
+- CLI: `expand: ["interactionDates"]` support in `query` command. Enriches records with interaction date summaries directly on each record in `result.data`. Works with `persons`, `companies`, and `listEntries` queries.
+- CLI: `--check-unreplied-emails` flag for `list export` command. Detects unreplied incoming emails for each list entry and adds date, daysSince, and subject to output. Use `--unreplied-lookback-days` to configure lookback period (default: 30 days).
+- CLI: `--with-interaction-dates` and `--with-interaction-persons` flags for `company get` and `person get` commands. Fetches interaction date summaries directly in entity get operations.
+- MCP: Query tool `format` parameter now functional (was previously ignored). Supports `toon`, `markdown`, `json`, `jsonl`, `csv`.
+- CLI: `--max-output-bytes` option for `query` command. Enables format-aware truncation for MCP use, returning exit code 100 when truncated.
+- CLI: `format_toon_envelope()` function for TOON output with full envelope (`data[N]{...}:`, `pagination:`, `included_*:` sections).
+- SDK: Batch association methods for PersonService, CompanyService, and OpportunityService:
+  - `get_associated_company_ids_batch(person_ids)` / `get_associated_opportunity_ids_batch(person_ids)`
+  - `get_associated_person_ids_batch(company_ids)` / `get_associated_opportunity_ids_batch(company_ids)`
+  - `get_associated_person_ids_batch(opportunity_ids)` / `get_associated_company_ids_batch(opportunity_ids)`
+  - All return `dict[EntityId, list[AssocId]]` with `on_error="raise"|"skip"` parameter.
+- SDK: `retries` parameter on `persons.get()`, `companies.get()`, and `opportunities.get()` methods. Enables automatic retry with exponential backoff on 404 errors to handle V1→V2 eventual consistency after create operations. Default is `retries=0` (fail fast).
+- CLI: Reminder date options now accept relative dates and keywords in addition to ISO-8601:
+  - `--due-date`: `+7d`, `+2w`, `+1m`, `+1y`, `today`, `tomorrow`, `yesterday`, `now`
+  - `--due-after`, `--due-before`: Same formats for filtering in `reminder ls`
+  - Example: `xaffinity reminder create --due-date +7d --type one-time --owner-id 123`
+- CLI: Domain validation for `company create` and `company update` now provides helpful error messages:
+  - Detects underscores (RFC 1035 violation) and suggests dash replacement
+  - Detects URL prefixes and extracts domain
+  - Example: `--domain test_company.com` → "Use 'test-company.com' instead"
+- Docs: V1→V2 eventual consistency guide covering 404 after create and stale data after update scenarios.
+- Tests: Integration test suite for SDK write operations (`tests/integration/`).
+
+### Changed
+- SDK: `OpportunityService.get_associated_people()` and `get_associated_companies()` now use V2 batch lookup instead of individual V1 fetches, reducing N+1 API calls (e.g., 50 people now fetched in 2 calls instead of 51).
+- SDK: Query executor `_batch_fetch_by_ids()` now uses V2 batch lookup for persons and companies, improving query performance on relationship includes.
+- CLI: Query `include` clause now fetches relationship IDs in parallel, then batch-fetches full records via V2 API, reducing API calls from N×M to N+1 for deduped lookups.
+
+### Changed (Breaking)
+- MCP: Query tool default format changed from `json` to `toon` for better token efficiency (~40% fewer tokens).
+- CLI: TOON query output now includes full envelope structure instead of data-only format. The `data` prefix is added to the array header: `data[N]{fields}:` instead of `[N]{fields}:`.
+
+### Fixed
+- MCP: Query tool now honors the `format` parameter instead of always using JSON output.
+- SDK: `ListEntryService.batch_update_fields()` now uses correct V2 API payload format. Previously failed with "Missing discriminator for property operation" error.
+
+## 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.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: affinity-sdk
-Version: 0.9.2
+Version: 0.9.11
 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.11}/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.11}/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.11/affinity/cli/__main__.py

@@ -0,0 +1,6 @@
+"""Enable running the CLI via `python -m affinity.cli`."""
+
+from affinity.cli.main import cli
+
+if __name__ == "__main__":
+    cli()

{affinity_sdk-0.9.2 → affinity_sdk-0.9.11}/affinity/cli/commands/_entity_files_dump.py

@@ -94,9 +94,9 @@ async def dump_entity_files_bundle(
                         break
                 if max_files is not None and produced >= max_files:
                     break
-                if not resp.next_page_token:
+                if not resp.next_cursor:
                     break
-                token = resp.next_page_token
+                token = resp.next_cursor
 
             for _ in range(workers):
                 await queue.put(None)