Commit Graph
259 Commits
Author SHA1 Message Date
Antigravity AI a0646a5ab1 fix: merge origin/main, resolve version conflict (bump to 2.48.24)
Merged latest main (2.48.23) into fix/hardcoded-engine-urls. Resolved the
single conflict in package.json by taking main's changes and bumping the
version to 2.48.24 per the patch-level commit rule.
2026-06-05 00:28:16 +12:00
Silvertakana 9a5adb832e docs(rules): seeder authoring contract + close-context-gaps meta-directive (#240)
* docs(rules): add seeder authoring contract to data-engine-architecture rule

Adds section 8 documenting how to write a seeder: the auto-discovery model,
the three module shapes (interval+fetch, cron+fn, init), the { redis }-only
ctx, and publishing via @worldwideview/seeder-sdk. Includes good/bad examples
contrasting the ctx.setLiveSnapshot trap (which caused a silent CI failure)
against the two correct shapes. This rule auto-loads on local-seeders/** edits.

* docs(rules): add close-context-gaps AI meta-directive to AGENTS.md

When missing/wrong/undocumented context causes an error, a long struggle, or
slow understanding, agents must fix the doc/context (or add a guardrail) at its
source, or ask the user to; in autonomous mode, log the gap to revisit. Codifies
the lesson from the seeder ctx.setLiveSnapshot incident for all contributors.
2026-06-05 00:25:44 +12:00
Antigravity AI 3200d38194 refactor(env): rename NEXT_PUBLIC_WWV_DATA_ENGINE_URL to NEXT_PUBLIC_WWV_LOCAL_ENGINE_URL
Rename the env var to make its scope unambiguous: it is a local dev
override only and must never be set in production. Split the old single
var into two with clearly documented purposes:

- NEXT_PUBLIC_WWV_LOCAL_ENGINE_URL (local dev, .env.local, browser+server)
  Used by resolveEngineUrl.ts and engineManifest.ts to redirect WS
  connections to a locally-running engine during plugin development.
  Each worktree should use a different port to avoid collisions.

- WWV_DATA_ENGINE_URL (production, docker-compose/Coolify, server-side only)
  Used by service.ts for MCP REST calls to the engine. NOT read by
  the browser. Set in docker-compose, not in .env.local.

service.ts shim reads WWV_DATA_ENGINE_URL first so existing production
docker-compose deployments are not broken by this rename.

Also fixes stale dataengine.worldwideview.dev subdomain references in
hostGlobals.ts (cloud fallback URLs now correctly point to dataenginev2).
2026-06-05 00:24:27 +12:00
Silvertakana f447bd7e72 fix(ci): stub seeder interval+fetch + drop redundant compose mount (#239)
Companion to wwv-data-engine fix/ci-stub-interval-fetch. The source-of-truth
stub (docker/ci/stub-seeder) used cron+fn and called ctx.setLiveSnapshot,
which the seeder ctx ({ redis }) does not expose — the snapshot never landed.
Switch to interval+fetch (return the array; scheduler auto-wraps + stores it).

Also remove the plugin-CI compose's ./stub-seeder volume mount and the stale
'Known foundation gap (deferred)' comment: the stub is now baked into the :ci
image at /app/seeders/stub, so the compose needs no host path and a consumer
repo can run it with only this YAML.
2026-06-04 23:58:20 +12:00
Silvertakana a833cf4790 fix(ci-probe): subscribe to pluginId on /stream + safe stub + plugin-CI auth bypass (#238) 2026-06-04 23:40:08 +12:00
SilvertakanaandClaude Sonnet 4.6 352fbce768 feat: CI smoke-test foundation (probe + mock-upstream + isolated docker CI) (#236)
* feat: CI smoke-test foundation (probe + docker compose + rule updates)

Phase 1 of multi-repo CI initiative for catching plugin/seeder integration
failures (ADR-0002 id drift, missing mapWebsocketPayload, namespace
collisions, BOM in package.json) that current CI misses.

- packages/wwv-ci-probe: shared CLI with `seeder`, `ws`, `id-contract`
  subcommands. README documents why no `plugin` subcommand (Playwright belongs
  in wwv-plugins, not coupled to this probe). `files` + `prepublishOnly`
  configured for clean npm publish.
- docker/ci/: reusable docker-compose stacks for plugin-CI and seeder-CI,
  plus mock-upstream HTTP fixture server and CI-only stub-seeder. Compose
  comments document scope boundary (consumer workflow owns user/plugin-row
  injection via Playwright globalSetup pattern) and the deferred stub-seeder
  bake-in for wwv-data-engine.
- .github/workflows/docker-publish.yml: adds `:ci` tag alias for downstream
  consumers (one-line edit).
- .agents/rules/*: rename worldwideview-plugins → wwv-plugins (4 files) to
  reflect repo rename + clarify it lives at local-plugins/ as its own git
  working tree.

Bump 2.15.16 → 2.16.0 (Minor — new ci-probe package + new docker/ci
infrastructure are net-new features for the CI ecosystem).

Foundation has NOT been booted end-to-end yet — ghcr.io/silvertakana/
worldwideview:ci doesn't exist until this lands on main and the workflow
publishes. Next session: validate via real compose-up, then mirror the :ci
tag in wwv-data-engine repo and wire consumer workflows in wwv-plugins.

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* refactor(ci-probe): extract shared payload-shape validator with contract tests

* fix(ci): add /__health route to mock-upstream and gate engine on service_healthy

* chore: bump version to 2.48.18 for CI foundation landing

* chore: bump to 2.48.19 and reconcile lockfile after merging main (validateManifest fix)

---------

Co-authored-by: Claude Sonnet 4.6 <[email protected]>
2026-06-04 23:00:02 +12:00
Antigravity AI 0f43baacf0 fix(engine): replace stale dataengine subdomain with dataenginev2
hostGlobals.ts and resolveEngineUrl.ts comment both referenced the old
dataengine.worldwideview.dev subdomain; updated to dataenginev2.worldwideview.dev.
2026-06-04 22:35:17 +12:00
Silvertakana ef669ec812 fix(security): host-match plugin entry URL allowlist (close CodeQL substring-sanitization bypass) (#237) 2026-06-04 22:34:08 +12:00
Antigravity AI 138f26c8e8 refactor(data-engine): consolidate engine URL to single NEXT_PUBLIC_WWV_DATA_ENGINE_URL
Replaces two separate env vars (NEXT_PUBLIC_WWV_LOCAL_ENGINE_PORT and
WWV_DATA_ENGINE_URL) with one: NEXT_PUBLIC_WWV_DATA_ENGINE_URL (full
HTTP base URL, default http://localhost:5000). Available both client-side
and server-side so it only needs to be defined once.

- engineManifest.ts: getLocalEngineBase() reads the new var directly
- resolveEngineUrl.ts: getLocalWsUrl() converts http->ws from the new var
- service.ts: getEngineUrl() reads the new var (fixes 5001->5000 default)
- Tests updated to set the full URL instead of a port number
- .env.example documents the new var with local and Docker examples
2026-06-04 22:24:08 +12:00
dependabot[bot] 915d1a006d build(deps-dev): bump concurrently from 9.2.1 to 10.0.3 (#230)
Bumps [concurrently](https://github.com/open-cli-tools/concurrently) from 9.2.1 to 10.0.3.
- [Release notes](https://github.com/open-cli-tools/concurrently/releases)
- [Commits](https://github.com/open-cli-tools/concurrently/compare/v9.2.1...v10.0.3)

---
updated-dependencies:
- dependency-name: concurrently
  dependency-version: 10.0.3
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-04 22:13:29 +12:00
Antigravity AI cdad4dc776 fix(data-engine): replace hardcoded engine URLs with env var
Deduplicates the WWV_DATA_ENGINE_URL fallback: discoveryHelpers.ts now
calls getEngineUrl() from data-query/service instead of inlining the
same logic. Comments and test mocks that referenced literal localhost:5001
or localhost:5000 now reference NEXT_PUBLIC_WWV_LOCAL_ENGINE_PORT or use
a generic test host. Closes #182.
2026-06-04 21:10:21 +12:00
Antigravity AI f75b416aa8 docs(triage): add issue triage guide and /triage-issue command
- TRIAGE.md: plugin-request vs enhancement intake, #4 funnel, build/do-not-build rule
- /triage-issue command at .agents/workflows/triage-issue.md, registered in AGENTS.md
2026-06-04 20:06:26 +12:00
Antigravity AI d35e62857f fix(gc-scan): stop false-positive ts-ignore matches and fix outdated-dep parser
- ts-ignore/ts-nocheck detector now only flags real suppression directives
  (token immediately after the // or /* comment opener), not prose mentions
- outdated-dep detector now parses pnpm's Unicode box-drawing table, skipping
  header/separator rows; surfaces real outdated deps instead of one garbage row
2026-06-04 19:27:00 +12:00
Silvertakana 57a2dc74d6 fix(ui): stabilize bottom-panel resize drag on webkit (#233)
Guard the resize pointermove handler with an isDraggingRef flag instead of
hasPointerCapture(), which behaves inconsistently across webkit versions in
CI for repeated drag sequences. setPointerCapture still delivers move/up
events when the pointer leaves the handle bounds.

Salvaged from the retired feat/phase-2-auth-gate branch (orig d91cc429); the
setPointerCapture work it built on is already on main.
2026-06-04 18:47:04 +12:00
Silvertakana 8ca4bdd9fa fix(auth): harden globe login gate with revocable sessions and deny-by-default API (#232)
- User.sessionVersion + jwt-callback revalidation rejects deleted-user,
  cross-database, and stale-version tokens (fixes cross-worktree stay-logged-in)
- POST /api/auth/revoke ("sign out everywhere") bumps sessionVersion
- proxy: deny-by-default /api with public allowlist + CORS preflight passthrough;
  anchored static-asset allowlist closes the path.includes(".") bypass
- harden session cookie options (httpOnly/sameSite/secure) and cut maxAge to 7 days
- unify https/secure-context detection in isHttpsDeployment() so the cookie
  writer (auth) and edge reader (proxy) never disagree on the __Secure- prefix
- augment next-auth User/Session/JWT types

Verified: 1009/1009 tests, build exit 0, live HTTP reproduction of all gates.
2026-06-04 18:17:46 +12:00
dependabot[bot] 54541ba62c build(deps): bump the dependencies group with 15 updates (#229)
Bumps the dependencies group with 15 updates:

| Package | From | To |
| --- | --- | --- |
| [@sentry/nextjs](https://github.com/getsentry/sentry-javascript) | `10.54.0` | `10.56.0` |
| [@supabase/supabase-js](https://github.com/supabase/supabase-js/tree/HEAD/packages/core/supabase-js) | `2.106.2` | `2.107.0` |
| [cesium](https://github.com/CesiumGS/cesium) | `1.141.0` | `1.142.0` |
| [next](https://github.com/vercel/next.js) | `16.2.6` | `16.2.7` |
| [react](https://github.com/facebook/react/tree/HEAD/packages/react) | `19.2.6` | `19.2.7` |
| [@types/react](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/react) | `19.2.15` | `19.2.16` |
| [react-dom](https://github.com/facebook/react/tree/HEAD/packages/react-dom) | `19.2.6` | `19.2.7` |
| [resium](https://github.com/reearth/resium) | `1.21.1` | `1.22.0` |
| [zustand](https://github.com/pmndrs/zustand) | `5.0.13` | `5.0.14` |
| [@typescript-eslint/eslint-plugin](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/eslint-plugin) | `8.60.0` | `8.60.1` |
| [@typescript-eslint/parser](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/parser) | `8.60.0` | `8.60.1` |
| [@vitest/coverage-v8](https://github.com/vitest-dev/vitest/tree/HEAD/packages/coverage-v8) | `4.1.7` | `4.1.8` |
| [eslint-config-next](https://github.com/vercel/next.js/tree/HEAD/packages/eslint-config-next) | `16.2.6` | `16.2.7` |
| [tsx](https://github.com/privatenumber/tsx) | `4.22.3` | `4.22.4` |
| [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) | `8.0.14` | `8.0.16` |


Updates `@sentry/nextjs` from 10.54.0 to 10.56.0
- [Release notes](https://github.com/getsentry/sentry-javascript/releases)
- [Changelog](https://github.com/getsentry/sentry-javascript/blob/develop/CHANGELOG.md)
- [Commits](https://github.com/getsentry/sentry-javascript/compare/10.54.0...10.56.0)

Updates `@supabase/supabase-js` from 2.106.2 to 2.107.0
- [Release notes](https://github.com/supabase/supabase-js/releases)
- [Changelog](https://github.com/supabase/supabase-js/blob/master/packages/core/supabase-js/CHANGELOG.md)
- [Commits](https://github.com/supabase/supabase-js/commits/v2.107.0/packages/core/supabase-js)

Updates `cesium` from 1.141.0 to 1.142.0
- [Release notes](https://github.com/CesiumGS/cesium/releases)
- [Changelog](https://github.com/CesiumGS/cesium/blob/main/CHANGES.md)
- [Commits](https://github.com/CesiumGS/cesium/compare/1.141...1.142)

Updates `next` from 16.2.6 to 16.2.7
- [Release notes](https://github.com/vercel/next.js/releases)
- [Changelog](https://github.com/vercel/next.js/blob/canary/release.js)
- [Commits](https://github.com/vercel/next.js/compare/v16.2.6...v16.2.7)

Updates `react` from 19.2.6 to 19.2.7
- [Release notes](https://github.com/facebook/react/releases)
- [Changelog](https://github.com/facebook/react/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/react/commits/v19.2.7/packages/react)

Updates `@types/react` from 19.2.15 to 19.2.16
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/react)

Updates `react-dom` from 19.2.6 to 19.2.7
- [Release notes](https://github.com/facebook/react/releases)
- [Changelog](https://github.com/facebook/react/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/react/commits/v19.2.7/packages/react-dom)

Updates `resium` from 1.21.1 to 1.22.0
- [Release notes](https://github.com/reearth/resium/releases)
- [Changelog](https://github.com/reearth/resium/blob/main/CHANGELOG.md)
- [Commits](https://github.com/reearth/resium/compare/v1.21.1...v1.22.0)

Updates `zustand` from 5.0.13 to 5.0.14
- [Release notes](https://github.com/pmndrs/zustand/releases)
- [Commits](https://github.com/pmndrs/zustand/compare/v5.0.13...v5.0.14)

Updates `@types/react` from 19.2.15 to 19.2.16
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/react)

Updates `@typescript-eslint/eslint-plugin` from 8.60.0 to 8.60.1
- [Release notes](https://github.com/typescript-eslint/typescript-eslint/releases)
- [Changelog](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/CHANGELOG.md)
- [Commits](https://github.com/typescript-eslint/typescript-eslint/commits/v8.60.1/packages/eslint-plugin)

Updates `@typescript-eslint/parser` from 8.60.0 to 8.60.1
- [Release notes](https://github.com/typescript-eslint/typescript-eslint/releases)
- [Changelog](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/parser/CHANGELOG.md)
- [Commits](https://github.com/typescript-eslint/typescript-eslint/commits/v8.60.1/packages/parser)

Updates `@vitest/coverage-v8` from 4.1.7 to 4.1.8
- [Release notes](https://github.com/vitest-dev/vitest/releases)
- [Changelog](https://github.com/vitest-dev/vitest/blob/main/docs/releases.md)
- [Commits](https://github.com/vitest-dev/vitest/commits/v4.1.8/packages/coverage-v8)

Updates `eslint-config-next` from 16.2.6 to 16.2.7
- [Release notes](https://github.com/vercel/next.js/releases)
- [Changelog](https://github.com/vercel/next.js/blob/canary/release.js)
- [Commits](https://github.com/vercel/next.js/commits/v16.2.7/packages/eslint-config-next)

Updates `tsx` from 4.22.3 to 4.22.4
- [Release notes](https://github.com/privatenumber/tsx/releases)
- [Changelog](https://github.com/privatenumber/tsx/blob/master/release.config.cjs)
- [Commits](https://github.com/privatenumber/tsx/compare/v4.22.3...v4.22.4)

Updates `vite` from 8.0.14 to 8.0.16
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.0.16/packages/vite)

---
updated-dependencies:
- dependency-name: "@sentry/nextjs"
  dependency-version: 10.56.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: "@supabase/supabase-js"
  dependency-version: 2.107.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: cesium
  dependency-version: 1.142.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: next
  dependency-version: 16.2.7
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: react
  dependency-version: 19.2.7
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: "@types/react"
  dependency-version: 19.2.16
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: react-dom
  dependency-version: 19.2.7
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: resium
  dependency-version: 1.22.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: zustand
  dependency-version: 5.0.14
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: "@types/react"
  dependency-version: 19.2.16
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: "@typescript-eslint/eslint-plugin"
  dependency-version: 8.60.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: "@typescript-eslint/parser"
  dependency-version: 8.60.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: "@vitest/coverage-v8"
  dependency-version: 4.1.8
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: eslint-config-next
  dependency-version: 16.2.7
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: tsx
  dependency-version: 4.22.4
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: vite
  dependency-version: 8.0.16
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
...

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-03 22:31:35 +12:00
Antigravity AI d71aac8268 fix(deps): add vitest override to keep audit clean after lockfile regen
A 'pnpm install --lockfile-only' re-resolved local-plugins/wwv-plugin-nz-traffic-cameras
back to the vulnerable [email protected] (GHSA-5xrq-8626-4rwp), undoing #219's pin and
failing the Dependency Audit. Pin it durably via a pnpm override so any future
regen stays clean (closes the recurrence behind #97).

Verified: [email protected] gone from lockfile, frozen-lockfile exit 0,
pnpm audit --audit-level high exit 0 (7 moderate, 0 high/critical).
2026-06-03 21:58:55 +12:00
Antigravity AI bfe64faade fix(deps): restore wwv-lib-aviation/incidents workspace deps + sync lockfile
The main merge resolved package.json with --ours, dropping the two
workspace deps that main's #220 (per-plugin bundling) added. Restore them
and regenerate the lockfile so 'pnpm install --frozen-lockfile' (CI) passes.

Verified: frozen-lockfile install exits 0.
2026-06-03 21:36:00 +12:00
Antigravity AI aa3984eb21 fix(docs): make MCP quickstart local-first (self-host is the shipping target)
The quickstart was cloud-only: it told self-hosters MCP is a 'cloud-edition
feature', pointed them at worldmonitor.app, and used the cloud endpoint -
actively wrong for the local edition that actually ships MCP today.

- lead with the local self-host flow: pnpm install/setup/dev(:all) -> sign in
  at localhost:3000 -> generate key -> paste localhost:3000/api/mcp -> open tab
- document pnpm dev vs pnpm dev:all (Redis + engine needed for command tools,
  geocoding, and live data); clarify which tools need which
- add update_favorite + fly_to to the tier tables; localhost-ize troubleshooting
- preserve cloud guidance under 'Cloud edition (coming soon)' for the future
  hosted launch (not deleted)
2026-06-03 21:10:49 +12:00
Antigravity AI a0bb4b7e74 fix(db): add missing migrations for user_api_keys and marketplace_credentials
The migration history only contained 20260509061229_init (6 tables), but
schema.prisma declares UserApiKey (user_api_keys) and MarketplaceCredential
(marketplace_credentials). Those tables existed only via the dev-only
'prisma db push' hook, so a fresh production 'prisma migrate deploy' built a
DB missing user_api_keys -> all MCP API-key auth threw 'relation does not
exist' (DOA in production).

- add 20260510000000_add_marketplace_credentials_and_api_keys (slots between
  init and add_favorite_notes); columns/constraints/indexes/FK mirror schema
- track the previously-untracked 20260531214034_add_favorite_notes migration

Verified: 'migrate deploy' on a fresh DB yields all 8 tables, zero drift
(prisma migrate diff: No difference detected). Dev DB baselined via
'migrate resolve --applied'; prisma validate + generate + tsc clean.
2026-06-03 21:02:57 +12:00
Antigravity AI a5fade9783 feat(36): Onboarding and Framing - MCP public-launch quickstart, prerequisites, honest command-tool framing
Phase 36 of v1.5 MCP Public-Launch Hardening (ONBRD-01..03).

- docs/mcp-quickstart.md: public sign-up -> generate key -> paste JSON ->
  open globe tab walkthrough; two capability tiers (read vs command);
  troubleshooting incl. engine_unreachable / no_active_plugins (ONBRD-01).
- ConnectAgentHelper: prerequisites callout (signed-in, cloud edition,
  open-tab requirement for command tools); extracted AGENT_PROMPT and
  CopyField into separate modules (file 352 -> 201 lines) (ONBRD-02).
- Every command tool description now begins with a shared
  SESSION_REQUIRED_PREAMBLE stating the live-open-tab requirement
  unmissably (pan_globe, focus_entity, toggle_layer, set_timeline,
  set_filter, clear_filter, fly_to) (ONBRD-03).
- New src/lib/mcp/toolDescriptionFragments.ts dedups the 7 identical
  preambles into one constant.

Gate: tsc clean, 1004 tests pass, build green.
2026-06-03 16:00:28 +12:00
Antigravity AI 0f860185cd fix(mcp): wire production deployment and throttle the shared geocoder (Phase 35)
Phase 35 of v1.5 MCP Public-Launch Hardening (DEPLOY-01..04):
- DEPLOY-01: production and cloud compose now provision a co-located Redis
  (password-protected via REDIS_PASSWORD, internal-only) and wire REDIS_URL,
  so sessions, command queue, geocode cache, and rate limiters work in prod.
- DEPLOY-02: set WWV_DATA_ENGINE_URL to the engine REST base (not the
  NEXT_PUBLIC_.../stream WS URL) so MCP data tools reach /manifest.
- DEPLOY-03: a single global 1 req/s Nominatim throttle (peek/commit sliding
  window with a queued-waiter cap and an in-process fallback) protects the
  shared geocoder; the 24h cache is checked before the throttle.
- DEPLOY-04: deploy/INFRA-CHECKLIST.md documents the operator actions
  (managed Redis rediss://, WWV_DATA_ENGINE_URL, distinct API_KEY_HMAC_SECRET,
  AUTH_SECRET, WWV_TRUSTED_IP_HEADER for multi-proxy, health semantics).

Security hardening from review: require AUTH_SECRET (no weak committed
fallback), password the co-located Redis, bind cloud Postgres to loopback,
de-duplicate the geocode result normaliser. Patch.
2026-06-03 15:36:39 +12:00
Antigravity AI b95ff5d580 fix(mcp): make /api/health probe real dependencies (Phase 34)
Phase 34 of v1.5 MCP Public-Launch Hardening (OBS-01):
- /api/health now probes Redis (ping), the database (SELECT 1), the data
  engine (manifest reachable), and HMAC config in parallel with 2s timeouts,
  returning {status, checks, edition, timestamp}.
- HTTP 503 when the DB is down or the HMAC secret is misconfigured
  (cloud/demo); HTTP 200 'degraded' when Redis or the engine is down so a
  serving-but-degraded container is not killed.
- Extract isSigningKeyValid() (src/lib/signingKeyConfig.ts) as the single
  source of truth for the SEC-01 rule, reused by getSigningKey and the health
  config probe (closes the Phase 32 deferred 'surface misconfig at deploy').
- Add ping() to the RedisClient interface; reuse getEngineUrl() so the probe
  and data layer resolve the same engine URL.

Patch: turns the always-healthy stub into real dependency observability.
2026-06-03 15:14:14 +12:00
Antigravity AI 813d2b28c2 fix(mcp): make tool responses honest to agents (Phase 33)
Phase 33 of v1.5 MCP Public-Launch Hardening (TOOL-01..05):
- TOOL-01: data-query tools never report no_session_active; they return
  the true reason (no_data_matches / engine_unreachable / no_active_plugins).
  Verified live: an empty region query with no browser session now returns
  no_data_matches.
- TOOL-02: toggle_layer / set_filter validate the id against the live plugin
  set and warn instead of returning success for an unrecognized id;
  focus_entity resolves entityId+pluginId to coordinates server-side and
  returns an honest error when it cannot.
- TOOL-03: get_entities_in_region returns count + truncated + totalMatched and
  tightens radiusKmToBbox (cos(lat), clamped to a full-globe span).
- TOOL-04: investigate_area and get_plugin_data cap output (200) with a
  truncated flag so a single response cannot blow client context.
- TOOL-05: MCP_SERVER_INSTRUCTIONS match the real response shapes;
  list_available_plugins distinguishes engine_unreachable from
  no_active_plugins and surfaces local sources distinctly.

Patch: corrects misleading tool behavior, no API removal.
2026-06-03 15:00:00 +12:00
Antigravity AI 3fd234736e feat(mcp): abuse-resistance and input hardening for public launch (Phase 32)
Phase 32 of v1.5 MCP Public-Launch Hardening (SEC-01..04):
- SEC-01: require a dedicated API_KEY_HMAC_SECRET in cloud/demo editions;
  getSigningKey fails closed if it is unset or equal to AUTH_SECRET.
  Local dev keeps the AUTH_SECRET fallback.
- SEC-02: Redis-backed per-key sliding-window rate limit (120/60s) applied
  after auth, returns JSON-RPC -32000 / HTTP 429, fails open on Redis outage
  behind the existing per-IP pre-auth gate.
- SEC-03: derive client IP from the trusted-proxy (rightmost X-Forwarded-For)
  hop with an optional WWV_TRUSTED_IP_HEADER override, defeating spoofing.
- SEC-04: length + charset bounds on entityId/pluginId/layerId/name/notes
  (shared identifierSchemas) and in isValidGlobeCommand; favorites capped at
  500 per user.

Consolidates id schemas, extracts MCP response helpers, accurate Retry-After,
unique sliding-window members. Minor semver bump: adds new guardrails.
2026-06-03 14:26:47 +12:00
Antigravity AI 121f7b22fe fix(mcp): harden transport error contract for public launch (Phase 31)
Phase 31 of v1.5 MCP Public-Launch Hardening (TRANS-01..04):
- Wrap the MCP route handler in a top-level try/catch returning a
  well-formed JSON-RPC -32603 (id:null, 500) instead of bare HTTP 500s
  when auth/Redis/transport throws.
- authenticateApiKey now returns null (clean 401) on a DB outage instead
  of rejecting; logs only the error class name (no connection strings).
- Add explicit maxDuration=30 on the MCP route, above the 10s relay blpop.
- Stop advertising tools.listChanged (stateless server cannot push);
  document the re-call tools/list contract in server instructions.

Sanitize the catch-all log so a Redis/Prisma error message cannot leak
credentials to server logs. Patch: behavior-hardening, no API change.
2026-06-03 13:55:11 +12:00
Antigravity AI ad5e7c7576 fix(globe): load plugin data when an agent toggles a layer via MCP
The toggle_layer MCP command only flipped the Zustand UI switch via the
command bridge and never started the plugin data lifecycle, so an
agent-enabled layer showed as toggled but rendered no data.

Extract the shared setLayerActive() helper (src/core/plugins/layerActivation.ts)
that drives pluginManager.enablePlugin/disablePlugin plus store state, and
route both the UI click (LayerPanel) and the agent command bridge
(useGlobeCommandBridge) through it so agent toggles trigger the identical
data fetch/stream path. Verified live: an MCP toggle_layer(camera) loads
2,376 camera entities with no browser interaction.

Patch: behavior fix, no API change.
2026-06-03 12:15:39 +12:00
Antigravity AI f7435926cd fix(30): Phase 30 gap closure - registry tests, security hardening, code review fixes
GAP 1 - Registry tests (was 5 failing, now 27 passing):
- Add injectable fs reader (_setReaderForTest/_restoreReader) to registry.ts
  to bypass Vitest jsdom/Node built-in mock interop limitations
- Switch import to node:fs/promises and use _readdir/_readfile internally
- Rewrite registry describe block to inject fake readers directly

GAP 2 - Security hardening (T-30-01/03/04):
- fetchRouteSource: SSRF guard rejects any path not starting with "/" or containing "://"
- getRegistry: type allowlist drops sources with types other than geojson/route
- fetchGeojsonSource: post-join path confinement asserts absolutePath stays inside public/
- sync-local-plugins.mjs: filter localData before writing plugin.json (type, path, no "..")
- Add tests: SSRF guard rejects absolute-URL route, type allowlist drops csv sources

GAP 3 - Code review fixes:
- normalizers.ts: genericity fix - id uses pluginId param not hardcoded "camera-"
- fetchRouteSource: drop NEXTAUTH_URL (auth callback URL, wrong for app base)
- fetchRouteSource: remove stray console.error (no-stray-console rule)
2026-06-02 17:15:09 +12:00
Antigravity AI 23d3aecf06 fix(29): fix getEngineUrl WSS URL bug + get_entity_details double-encoding
- service.ts: getEngineUrl() now reads WWV_DATA_ENGINE_URL (server-side HTTP URL)
  instead of NEXT_PUBLIC_WWV_PLUGIN_DATA_ENGINE_URL (a wss:// WebSocket URL).
  Fallback changed from localhost:5000 to localhost:5001 (data engine dev port).
  This unblocks all MCP data-query tools from reaching the data engine locally.

- tools.ts: get_entity_details empty path no longer calls toolError(JSON.stringify(...))
  which double-encoded emptyReason inside an error string. Now returns the standard
  success envelope { success: true, data: null, emptyReason } matching search_entities
  and get_entities_in_region contracts (Phase 28 emptyReason discrimination).
2026-05-31 20:49:56 +12:00
Antigravity AI 5bc9b3ab96 chore(release): v2.48.0
Bump minor version for v1.4 Agentic Intelligence milestone (Phases 26-29):
MCP tool description standards, response contracts, and discovery tools.
2026-05-31 18:59:57 +12:00
Antigravity AI 3221d0b758 feat(28-03): add tests for update_favorite and list_favorites notes
- Tests: happy path (both fields), name-only, notes-only, empty-args (no DB write), P2025 not-found
- Test: list_favorites items include notes field
- Test: update_favorite uses (userId, entityId) selector from ctx only
- Rule 3 fix: add update vi.fn() to prisma manual mock (was missing)
2026-05-31 18:13:21 +12:00
Antigravity AI 0f5dba2d9f feat(28-03): implement update_favorite tool and surface notes in list_favorites
- Register update_favorite(favoriteId, {name?, notes?}) tool keyed on (userId, entityId)
- Partial updates: name-only changes label, notes-only changes notes, both changes both
- Neither field supplied returns 'nothing to update' without DB write
- P2025 not-found returns 'update_favorite: favorite not found'
- list_favorites description updated to document notes field in output shape
- userId scoped via ctx only (SAFE-02 pattern, T-28-06 mitigated)
2026-05-31 18:12:01 +12:00
Antigravity AI 32640e61b0 feat(28-03): add nullable notes column to Favorite model
- Add notes String? field to Favorite model in prisma/schema.prisma
- Applied to live DB via prisma db push (schema drift from prior db push workflow)
- Regenerated Prisma client (v7.8.0)
2026-05-31 18:11:03 +12:00
Antigravity AI c93c6d7f80 test(28-01): add emptyReason branch tests for search_entities
- Cover plugin_not_streaming when snapshot null
- Cover no_data_matches when streaming but zero matches
- Cover no_session_active session-first precedence overriding plugin reason
- Cover non-empty result has no emptyReason key in envelope
2026-05-31 18:07:22 +12:00
Antigravity AI 08d2fae5e9 feat(28-01): discriminated emptyReason service results and userId-aware query tools
- Add EmptyReason union type and QueryResult/SingleResult generics to types.ts
- Refactor searchEntities/getEntitiesInRegion to return QueryResult with plugin_not_streaming vs no_data_matches
- Refactor getEntityDetails/getPluginData to return SingleResult discriminating null causes
- Add registerDataQueryTools(server, { userId }) signature; thread resolveActiveSessionId for no_session_active precedence
- Pass emptyReason through all four MCP tool response envelopes (only on empty results)
- Wire registerDataQueryTools with userId in route.ts registration seam
- Update all callers (REST routes, favoritesTools) and fix existing tests for new return shapes
2026-05-31 18:06:20 +12:00
Antigravity AI cb5b1cb420 feat(26-01): add MCP server orientation instructions and prompts
- Extend MCP_SERVER_INSTRUCTIONS with role-framing header ('geospatial intelligence assistant'), MENTAL MODEL section (globe/plugins/sessions), and WORKFLOWS section with 3 do-X-before-Y rules (sessions-before-command, tools/list-before-plugin, geocode-before-fly)
- Add registerOrientationPrompts registrar with orient-globe prompt (returns active sessions + layers + camera in one call) and investigate prompt (static step-numbered geocode/plugin/fly/query workflow)
- Wire registerOrientationPrompts into route.ts registration seam alongside existing registrars
- Add 17 unit tests covering instructions content, both prompt registrations, orient-globe handler (sessions/layers/camera and empty-session fallback), and investigate handler (step-numbering, no placeholders, place-name weaving)
2026-05-31 16:28:34 +12:00
Antigravity AI 8134e2b890 docs(v1.3): mark Location Intelligence milestone complete
All 4 phases (22-25) shipped: geocoding+favorites, entity filtering,
route wiring + MCP_SERVER_VERSION 1.3.0, and documentation.
Milestone audit: SHIP (18/18 requirements). Browser UAT: PASS (8/8 tools).

Bump 2.46.5 -> 2.46.6.
2026-05-31 14:04:55 +12:00
Antigravity AI f1405bd313 docs(25-01): add v1.3.0 changelog entry (DOC-04)
- lists all 8 new MCP tools, search_entities filters enhancement, MCP_SERVER_VERSION 1.3.0 bump
- bump 2.46.4 -> 2.46.5
2026-05-31 13:38:05 +12:00
Antigravity AI 2eec714912 docs(25-01): list v1.3 tools in ConnectAgentHelper prompt (DOC-03)
- agent capabilities prompt now enumerates all 12 callable MCP tools with one-line descriptions
- links plugin authors to docs/plugin-filter-guide.md
- bump 2.46.3 -> 2.46.4
2026-05-31 13:37:40 +12:00
Antigravity AI 26d2063a1e docs(25-01): add plugin filter guide with flights worked example (DOC-02)
- explains getFilterDefinitions, FilterDefinition/FilterValue shapes, get_plugin_filters/set_filter flow
- bump 2.46.2 -> 2.46.3
2026-05-31 13:37:06 +12:00
Antigravity AI 84f8ade70c docs(25-01): enrich v1.3 MCP tool descriptions (DOC-01)
- geocode_location/fly_to/save_favorite/list_favorites/remove_favorite/set_filter/clear_filter/get_plugin_filters now document inputs, output shape, and a usage example
- bump 2.46.1 -> 2.46.2
2026-05-31 13:36:29 +12:00
Antigravity AI 5ea7855e02 test(24-01): verify MCP 1.3.0 version and v1.3 tool surface
- Assert MCP_SERVER_VERSION === 1.3.0 (INTG-02)
- Assert all 8 v1.3 tools register (INTG-01)
- Assert search_entities exposes optional filters param
- package.json 2.46.0 -> 2.46.1 (patch)
2026-05-31 13:31:43 +12:00
Antigravity AI 5201ae32c8 feat(24-01): bump MCP_SERVER_VERSION to 1.3.0
- Advertise MCP protocol server version 1.3.0 on initialize handshake
- Reflects the v1.3 tool surface (geocoding, favorites, filtering)
- package.json 2.45.1 -> 2.46.0 (minor)
2026-05-31 13:29:04 +12:00
Antigravity AI ca8c6ad940 refactor: remove dead readSessionCatalog re-export breaking route type gen
- Drop trailing export { readSessionCatalog } from catalog/route.ts (Next.js App Router rejects non-route-handler exports -> TS2344 in generated route types)
- Trim now-unused readSessionCatalog import (only existed to support the re-export)
- All consumers already import readSessionCatalog from @/lib/mcpSessionCatalog
- Bump 2.45.0 -> 2.45.1
2026-05-31 13:26:35 +12:00
Antigravity AI ac9aa64ddb feat(23-03): wire registerFilterTools into MCP route
- import registerFilterTools from ./filterTools
- call registerFilterTools(server, { userId }) after registerFavoritesTools, before registerPluginTools
- inherits isDemo gate + Bearer auth SAFE envelope
- update registration seam comment for Phase 23
- bump semver 2.44.0 -> 2.45.0
2026-05-31 13:16:41 +12:00
Antigravity AI 7a055f6bb8 feat(23-02): publish plugin filterDefinitions through catalog publisher and route
- collectCatalog gathers getFilterDefinitions() from each loaded plugin (D-05)
- filter-only plugins now publish (early-return guards on tools AND filterDefinitions empty)
- catalog route validates and forwards optional filterDefinitions, identity still from auth only
- gives get_plugin_filters a data source
2026-05-31 13:14:16 +12:00
Antigravity AI 45594304f8 feat(23-02): add inline filters param to searchEntities and search_entities tool
- searchEntities applies filters on full GeoEntity.properties via matchFilterValue before SearchResult conversion (D-07/D-08)
- limit counts only matching entities; missing property key fails filter
- search_entities MCP tool exposes optional filters inputSchema via filterValueSchema
- SearchOptions type gains optional filters field
- 4 new filters tests GREEN, no regression
2026-05-31 13:12:50 +12:00
Antigravity AI 1b67e70bf9 feat(23-02): add set_filter, clear_filter, get_plugin_filters MCP tools
- Create registerFilterTools registrar mirroring globeCommandTools/favoritesTools
- set_filter/clear_filter enqueue GlobeCommand via enqueueGlobeCommand
- get_plugin_filters reads filterDefinitions from session catalog, returns [] when absent
- Makes filterTools.test.ts GREEN (7 tests)
2026-05-31 13:11:05 +12:00
Antigravity AI 5535673f8d feat(23-01): extend SessionCatalog, wire bridge filter dispatch, RED tool stubs
- SessionCatalog gains optional filterDefinitions (D-05); type guard stays backward compatible
- useGlobeCommandBridge dispatches setFilter/clearFilter to filterSlice (D-04)
- Add RED filterTools.test.ts locking set_filter/clear_filter/get_plugin_filters contract
- Bump semver 2.40.0 -> 2.41.0
2026-05-31 13:07:56 +12:00
Antigravity AI f0e658b4c2 feat(23-01): extract matchFilterValue + add shared filterValueSchema
- Extract pure matchFilterValue from filterEngine (D-08, behavior identical)
- filterEngine imports the shared helper; tests still GREEN
- Add filterValueSchema zod discriminated union (D-02, T-23-01-02 mitigation)
- Bump semver 2.39.0 -> 2.40.0
2026-05-31 13:06:36 +12:00