feat: add NGSI-LD scope/scopeQ support (#110)

* feat: add NGSI-LD scope/scopeQ support (#109)

Add --scope-q option to entities list for hierarchical scope filtering,
display scope property in table output, and update geonicdb to v0.2.1.

* fix: update e2e hooks for geonicdb v0.2.1 API changes

User creation endpoint now expects primaryTenantId instead of tenantId.

* fix: address review comments — CHANGELOG PR number and object array handling

* chore: pin geonicdb to commit hash and add weekly compatibility check

Pin geonicdb dependency to specific commit (326b12a) to prevent
unexpected breakage from upstream changes. Add scheduled CI workflow
that tests against latest geonicdb weekly and creates an issue on failure.

* fix: add permissions block and fix heredoc variable expansion in compat workflow

* docs: update CHANGELOG with CI and dependency pinning entries

Author: miya0001

.github/workflows/geonicdb-compat.yml

@@ -0,0 +1,81 @@
+name: GeonicDB compatibility check
+
+on:
+  schedule:
+    - cron: "0 9 * * 1" # 毎週月曜 09:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.GH_APP_ID }}
+          private-key: ${{ secrets.GH_APP_PRIVATE_KEY }}
+          owner: geolonia
+          repositories: geonicdb
+
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Configure git for private repos
+        run: |
+          git config --global url."https://x-access-token:${{ steps.app-token.outputs.token }}@github.com/".insteadOf "https://github.com/"
+          git config --global --add url."https://x-access-token:${{ steps.app-token.outputs.token }}@github.com/".insteadOf "ssh://git@github.com/"
+          git config --global --add url."https://x-access-token:${{ steps.app-token.outputs.token }}@github.com/".insteadOf "git@github.com:"
+
+      - name: Update geonicdb to latest
+        run: |
+          node -e "
+            const p = require('./package.json');
+            p.devDependencies.geonicdb = 'github:geolonia/geonicdb';
+            require('fs').writeFileSync('package.json', JSON.stringify(p, null, 2) + '\n');
+          "
+          npm install
+
+      - name: Show updated version
+        run: npm ls geonicdb
+
+      - run: npm run lint
+      - run: npm run typecheck
+      - run: npm test
+      - run: npm run test:e2e
+
+      - name: Create issue on failure
+        if: failure()
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          GEONICDB_VERSION=$(npm ls geonicdb --json 2>/dev/null | node -e "
+            const d = JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));
+            const dep = d.dependencies?.geonicdb;
+            console.log(dep?.version ?? 'unknown');
+          ")
+          gh issue create \
+            --title "geonicdb 最新版 (${GEONICDB_VERSION}) との互換性エラー" \
+            --body "$(cat <<EOF
+          ## 概要
+
+          週次の互換性チェックで、geonicdb の最新版でテストが失敗しました。
+
+          - **geonicdb version**: ${GEONICDB_VERSION}
+          - **Workflow run**: ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}
+
+          ## 対応
+
+          1. Workflow run のログを確認し、破壊的変更の内容を特定
+          2. CLI 側のコードを修正
+          3. `package.json` の geonicdb コミットハッシュを最新に更新
+          EOF
+          )"

CHANGELOG.md

@@ -7,6 +7,13 @@
 
 ## [Unreleased]
 
+### 2026-04-24
+- **Feat**: `entities list` に `--scope-q` オプションを追加 — NGSI-LD `scopeQ` パラメータによるスコープフィルタリングに対応 (#110)
+- **Feat**: テーブル表示で `scope` プロパティを `id`, `type` の直後に表示 (#110)
+- **Feat**: `entities create` のヘルプに `scope` プロパティの使用例を追加 (#110)
+- **CI**: geonicdb 週次互換性チェックワークフローを追加 (#110)
+- **Refactor**: devDependency `geonicdb` をコミットハッシュでピン留めに変更 (#110)
+
 ## [0.12.1] - 2026-04-14
 
 ### 2026-04-14