main
190
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
ef669ec812 | fix(security): host-match plugin entry URL allowlist (close CodeQL substring-sanitization bypass) (#237) | ||
|
|
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.
|
||
|
|
5de306c346 |
merge: bring main (v1.4 via #217, #219, #222) into feat/mcp-public-hardening
# Conflicts: # .planning/ROADMAP.md # .planning/STATE.md # package.json |
||
|
|
295e06afa6 |
merge: resolve main into gsd/v1.3-location-intelligence (#217)
# Conflicts: # .planning/ROADMAP.md # .planning/STATE.md # package.json |
||
|
|
7c87c99c62 |
feat: auto port isolation for multi-worktree dev (#222)
* fix(e2e): guard marketplace webServer and exclude per-app tests from main Playwright config Root cause: playwright.config.ts unconditionally started the marketplace dev server at ../worldwideview-marketplace. In CI only worldwideview is checked out, so spawn() received a non-existent cwd which Node.js surfaces as "spawn /bin/sh ENOENT", crashing the entire test run before any browser launched. Two targeted fixes: 1. Wrap the marketplace webServer entry in fs.existsSync(MARKETPLACE_DIR) so CI skips it gracefully. Use playwright.marketplace.config.ts to run cross-app marketplace tests locally. 2. Add testIgnore for web-auth.spec.ts and marketplace-from-instance.spec.ts — both target sibling repos (worldwideview-web / worldwideview-marketplace) and have their own dedicated configs (playwright.web.config.ts / playwright.marketplace.config.ts). The main config should only exercise the worldwideview app itself. * feat(09-02): add playwright.cross-app.config.ts and .env.test for cross-origin specs - Add playwright.cross-app.config.ts with dual webServer array (wwv.local:3001 + marketplace.wwv.local:3002) - testMatch targets both upcoming cross-app spec files; baseURL set to marketplace.wwv.local:3002 - Create worldwideview/.env.test with PLAYWRIGHT_TEST_EMAIL + PLAYWRIGHT_TEST_PASSWORD (gitignored) - Add explicit .env.test entry to .gitignore (was not covered by existing .env/.env.local patterns) - Bump version 2.20.2 -> 2.21.0 (feat: minor) * feat(09-02): add cross-app Playwright specs for redirect handshake and sign-out (REQ-16) - Add marketplace-redirect-handshake.spec.ts: 2 tests verifying next= param construction and login-then-redirect-back flow - Add marketplace-sign-out.spec.ts: 1 test verifying avatar dropdown sign-out clears session and returns to marketplace home - Update playwright.cross-app.config.ts to load .env.test credentials via fs (no dotenv package required) - All specs target https://marketplace.wwv.local:3002 (never localhost:3002) for correct .wwv.local cookie domain - 3 tests total listed by playwright --list * feat: add planning-sync hook script for .planning branch isolation * fix: guard planning-sync against missing .planning, wrong repo, and silent checkout failures - Exit early if .planning/.git doesn't exist (avoids false-success on machines without the private repo) - Exit early if CWD is not a worldwideview repo or worktree (prevents syncing from wwv-data-engine etc.) - Wrap both checkout calls in exit-code checks so failures emit WARNING messages instead of false success * feat: add post-checkout hook for .planning auto-sync * fix: add existence guard to post-checkout hook before calling planning-sync * docs: add .planning branch convention to worktree-bootstrap skill * feat(11-01): add LegalFooter component and .legal-footer CSS class - Create src/components/layout/LegalFooter.tsx as a Server Component - Export named function LegalFooter with two external anchors - Both anchors use target="_blank" rel="noopener noreferrer" (T-11-01) - Links target locked URLs: privacy-policy and cloud-terms-of-service - Append .legal-footer + a + a:hover rules to globals.css - position:fixed bottom:0 z-index:10 per UI-SPEC - Bump version 2.23.2 -> 2.23.3 * feat(11-01): remove Vercel Analytics, mount LegalFooter in root layout - Remove @vercel/analytics/next import from layout.tsx (D-02) - Remove {process.env.VERCEL && <Analytics />} JSX (D-02, T-11-02) - Add import { LegalFooter } from @/components/layout/LegalFooter - Render <LegalFooter /> as last child of <body> (D-04) - Remove @vercel/analytics from dependencies in package.json - Regenerate pnpm-lock.yaml after dependency removal - AdSense block (lines 27-37) untouched per D-03 - Bump version 2.23.3 -> 2.23.4 * fix(worktree): fix link_planning hook path conversion for Windows Worktrunk substitutes {{ worktree_path }} as a Unix-style path (/c/dev/...) which cmd.exe cannot resolve. It also strips $ sigils from variable names before executing hook commands, making inline PowerShell variables unusable. Extract junction logic to .agents/scripts/link-planning.ps1 and unlink-planning.ps1. The hooks now call powershell -File with the path as an argument, avoiding both issues entirely. * docs: add ADR-004 and phase-2 implementation plans Adds the Supabase session cookies httponly ADR alongside the six implementation plan documents produced during the auth gate phase. * feat(auth): implement Phase 2 cloud auth gate (ADR-003 closeout) - Cloud edition login page redirects to NEXT_PUBLIC_AUTH_HOST_URL; local/demo editions keep the NextAuth credentials form - Delete signup pages and Supabase PKCE callback route from worldwideview (auth host owns them per ADR-003) - Add Supabase SSR helpers (cookieOptions, server, client) with httpOnly:true cookies per ADR-004 - Dual-dispatch install-redirect and grant-token: Supabase on cloud, NextAuth on local/demo; redirect param unified to ?next= - Add streaming mode to safeFetch for MJPEG camera proxy streams - Extract LoginForm into its own component - Update Playwright config to conditionally start marketplace dev server * fix(types): cast undici ReadableStream body to BodyInit to satisfy DOM types node:stream/web ReadableStream is structurally incompatible with the DOM ReadableStream expected by the Response constructor -- the pipeThrough signature differs on the T | undefined generic bound. Cast to BodyInit (which is the correct type for the streaming pass-through) to resolve the TS2345 error in ssrf.ts line 112. * fix(e2e): exclude cross-app marketplace specs from default Playwright run marketplace-redirect-handshake.spec.ts and marketplace-sign-out.spec.ts require a running marketplace.wwv.local:3002 instance (cross-app environment). They were being picked up by playwright.config.ts in CI where that host does not exist, causing ERR_NAME_NOT_RESOLVED failures. Added both files to testIgnore alongside the existing exclusions; they should be run via playwright.cross-app.config.ts only. * fix: add pointer event support to bottom panel resize for webkit Playwright's webkit engine dispatches pointermove/pointerup reliably during synthetic drags but mousemove sometimes does not fire. Add pointermove and pointerup listeners alongside the existing mouse listeners, and add onPointerDown to the drag handle, so the resize test passes across all three browser engines. * fix(marketplace): derive redirect/entry allowlists from env vars Hardcoded ALLOWED_REDIRECT_HOSTS and entry-URL allowlists rejected custom deployment hostnames (e.g. marketplace.wwv.local) causing 400 errors on grant-token, install-redirect, and validateManifest. All three validators now read NEXT_PUBLIC_MARKETPLACE_URL, NEXT_PUBLIC_WWV_MARKETPLACE_URL, and MARKETPLACE_URL at module load and add each hostname to their respective allowlists. Unparsable env values are skipped silently. No hostnames are hardcoded; validators are inert when the env vars are absent (production config unchanged). * fix: parameterize engine host port binding via WWV_ENGINE_HOST_PORT * fix: read engine port from NEXT_PUBLIC_WWV_LOCAL_ENGINE_PORT in engineManifest * fix: read engine port from NEXT_PUBLIC_WWV_LOCAL_ENGINE_PORT in resolveEngineUrl * feat: add dev-all.mjs orchestrator with auto engine port detection Replaces the concurrently one-liner dev:all script with a Node.js orchestrator that finds a free port starting at 5000, then injects WWV_ENGINE_HOST_PORT, NEXT_PUBLIC_WWV_LOCAL_ENGINE_PORT, and COMPOSE_PROJECT_NAME before starting the app and backends concurrently. * feat: wire dev:all to auto-port orchestrator * fix: skip WS auth in local engine container and silence concurrently deprecation * fix: set NODE_ENV=development in engine container to allow WWV_SKIP_WS_AUTH * chore: regenerate pnpm-lock.yaml for wwv-lib workspace deps Merge from main introduced @worldwideview/wwv-lib-aviation and @worldwideview/wwv-lib-incidents in package.json but pnpm-lock.yaml (inherited from main) had no entries for them. pnpm install --no-frozen-lockfile regenerated the lockfile to include both workspace packages, unblocking the frozen-lockfile CI enforcement. |
||
|
|
98ae79fe9b |
merge: bring main bug fixes into feat/mcp-public-hardening (#218 OSM UTF-8, #220 plugin per-plugin bundling)
# Conflicts: # .planning/ROADMAP.md # .planning/STATE.md # package.json |
||
|
|
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. |
||
|
|
f6be5af85c |
fix(plugins): bundle wwv-lib-aviation and wwv-lib-incidents per-plugin (#220)
* docs(22-01): execution summary for market-tracker provider abstraction * docs(22-02): execution summary for provider factory and test updates Plan 22-02 complete: providers/index.ts created, src/index.ts refactored, tests updated. All 17 tests pass. Redis key and seeder contract preserved. * feat(cables): bundle TeleGeography GeoJSON statically, delete proxy route - Add public/data/undersea-cables.geojson (728KB, 712 features, CC BY 4.0) - Delete src/app/api/undersea-cables/route.ts (24h proxy to submarinecablemap.com) - Static file served by Next.js at /data/undersea-cables.geojson with zero config * docs(24-01): execution summary for undersea cables static asset swap - SUMMARY.md: 4/4 tasks, build passes, deviations documented - STATE.md: milestone 100% complete, all phases done - ROADMAP.md: Phase 24 marked complete with 1/1 plans * fix(plugins): bundle wwv-lib-aviation and wwv-lib-incidents per-plugin Removes both base-class libs from the host pantry (EXTERNAL_GLOBALS and hostGlobals.ts). The 5 consumer plugins now declare them under dependencies so Vite inlines them at build time, eliminating ManifestLoadError bare-import failures permanently. Also: publicDir:false stops 1.4GB dist pollution, CONFIG_HASH invalidation ensures rebuilt bundles after externals change, ManifestLoadError now emits actionable bundling guidance, build logging shows per-plugin progress and final built/cached/failed stats. |
||
|
|
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. |
||
|
|
14e7ababcd |
feat(30-01): implement localData validator branch in validateManifest (GREEN)
- Validates localData is an array when present (MAN-LD / T-30-02)
- Per-entry: non-empty name, type in {geojson,route}, path starts with /
- Rejects path containing .. (T-30-01 traversal defense)
- Mirrors mcpTools validator pattern; no any, no @ts-ignore
- All 23 validateManifest tests green
|
||
|
|
21d0222e68 |
test(30-01): add RED tests for localData validator branch (MAN-LD)
- Happy path (no localData, well-formed localData) -- already pass - 5 failing RED cases: non-array, missing name, invalid type, non-/ path, .. traversal path -- all fail as expected before GREEN implementation |
||
|
|
fcf1fdcc1a |
Merge branch 'main' into gsd/v1.3-location-intelligence
Resolved add/add conflicts from squash-merge of feat/mcp-support (PR #215). All v1.3 Location Intelligence additions preserved as union over v1.2 baseline: - MCP_SERVER_VERSION kept at 1.3.0 - flyTo, setFilter, clearFilter GlobeCommand variants and validators retained - search_entities filters param retained in tools.ts and service.ts - filterDefinitions on SessionCatalog and catalog publisher retained - zremrangebyscore/zcard on RedisClient retained - registerGeocodingTools/registerFavoritesTools/registerFilterTools in mcp route retained - v1.3 agent prompt in ConnectAgentHelper retained - package.json version kept at 2.46.6 (our higher value) |
||
|
|
4858342ed6 |
feat(mcp): Full MCP Support v1.2 - API keys, MCP server, globe control, data query, plugin tools (#215)
* test(16-01): add failing RED test scaffold for apiKeyAuth helper
- Imports generateApiKey + authenticateApiKey from ./apiKeyAuth (does not exist -- intentional RED)
- Mocks @/lib/db userApiKey (findUnique/create/findMany/count/deleteMany/update) and @/core/edition
- KEY-01: prefix starts with wwv_, fullToken = prefix.secret, secret != hashedSecret
- KEY-02/API-01: null on missing header, no-dot token, unknown prefix, wrong secret; { userId, keyId } on valid token
- T-16-01 timing oracle: // [slow] test brackets authenticateApiKey with performance.now() asserting elapsed > 100ms
* test(16-01): add failing RED test scaffolds for api-keys route handlers
- route.test.ts imports GET/POST from ./route (does not exist -- intentional RED)
- [id]/route.test.ts imports DELETE from ./route (does not exist -- intentional RED)
- Mocks @/lib/auth, @/lib/db (userApiKey), @/core/edition, @/lib/apiKeyAuth
- KEY-03: GET returns 200+{keys} with session, 401 without; response never contains hashedSecret
- KEY-04: POST returns 422 max_keys_reached at count>=3; returns 201+fullToken when under limit
- KEY-03 DELETE: 200 on owned key (count:1), 404 on foreign (count:0), 401 with no session
- Ownership: asserts deleteMany called with where containing both id and userId
* feat(16-02): add UserApiKey model to schema.prisma
- Add model UserApiKey with uuid PK, userId FK (Cascade), tenantId String?,
prefix String @unique, hashedSecret, name, createdAt, lastUsedAt DateTime?
- Add @@map("user_api_keys") following project snake_case convention
- Add apiKeys UserApiKey[] relation to User model
- Bump version 2.24.6 -> 2.25.0 (minor: new feature)
* feat(16-02): implement apiKeyAuth.ts - timing-safe API key primitive
- generateApiKey(): prefix "wwv_" + 8 base64url chars, secret = 32-byte
base64url, hashedSecret = bcrypt(secret, 12), fullToken = prefix.secret
- authenticateApiKey(): parses Bearer header, splits on first ".", findUnique
by prefix, always runs bcrypt compare (DUMMY_HASH on miss for T-16-01),
fire-and-forget throttled lastUsedAt update (1/min/key)
- DUMMY_HASH: pre-baked cost-12 literal eliminates cold-start gap (Pitfall 1)
- Uses async hash/compare from bcryptjs (never compareSync - Pitfall 2)
- Exports GeneratedKey + AuthenticatedKey interfaces (API-01)
- All 11 tests GREEN including timing-oracle test (elapsed > 100ms)
* feat(16-03): implement GET + POST /api/api-keys route handlers
- GET lists user's keys selecting only { id, name, prefix, createdAt, lastUsedAt } (hashedSecret never returned)
- POST enforces max-3 limit (422 max_keys_reached), calls generateApiKey(), returns fullToken once in 201 response
- P2002 prefix-collision handled with single retry
- isDemo gate (403) runs before session check on both handlers
- All 6 route.test.ts tests GREEN (KEY-01, KEY-03, KEY-04)
* feat(16-03): implement DELETE /api/api-keys/[id] ownership-scoped revoke
- deleteMany where { id, userId } — atomic BOLA prevention (T-16-06)
- count 0 -> 404 not_found; count 1 -> 200 success: true
- isDemo gate (403) before session check
- All 4 [id]/route.test.ts tests GREEN (KEY-03)
- Full suite 403/403 tests green, no regressions
* docs(16-03): complete api-key CRUD routes plan summary + state update
- 16-03-SUMMARY.md: GET+POST+DELETE route handlers, 403/403 tests green
- STATE.md: current position advanced to plan 4 of 4, wave 2 decisions recorded
- ROADMAP.md: phase 16 progress updated (3/4 summaries)
* feat(16-04): personal API keys section + Keys & Access wiring
- Add PersonalApiKeysSection client component (API & MCP Access)
consuming GET/POST/DELETE /api/api-keys: list, generate with
one-time reveal, inline-confirm revoke, max-3 disabled state
- Rename Header settings modal title to 'Keys & Access' and render
the section below ApiKeysTab behind an !isDemo edition gate
- Harden secret/name inputs against password-manager capture
(autoComplete=off, data-lpignore, data-form-type=other)
- Phase 17 connect-your-agent helper left as a code-comment placeholder
* fix(test): narrow overloaded NextAuth auth export for vi.mocked typing
The 16-03 api-keys route tests called vi.mocked(auth), which resolved the
NextAuth v5 NextMiddleware overload and rejected the Session/null mock value
(TS2345 x7, breaking tsc/pnpm build while vitest stayed green). Narrow auth to
its no-arg session-getter signature via a typed mockAuth helper so vi.mocked
picks the correct overload. Test-only; no runtime change (10/10 still pass).
* test(17-01): RED scaffold for /api/mcp route + transport spike
- route.test.ts: locks 401 JSON-RPC auth gate (MCP-03), 403 demo gate
before auth (MCP-04), happy-path gate passage (MCP-01/02), X-Accel-Buffering
streaming header (MCP-06), per-request stateless construction (MCP-05)
- transport-spike.test.ts: skips cleanly (SDK absent); proves
WebStandardStreamableHTTPServerTransport + McpServer instantiate/connect
outside a custom server when SDK is installed (de-risks D-17-02)
- route.ts absent by design -- these are Wave 0 RED baselines
* fix(16): surface auth failures in PersonalApiKeysSection fetch; rename section header to "Service Keys"
- PersonalApiKeysSection: check r.ok before consuming response JSON; a 401
(e.g. AUTH_URL domain mismatch on local dev) was silently producing
data.keys === undefined which fell through the ?? [] guard and rendered
"No API keys yet" instead of the error message. Fixes KEY-03 reload symptom.
- route.test.ts: add assertion that 401 response body must not contain a
`keys` field, locking in the invariant that callers must check r.ok.
- ApiKeysTab: rename "Your API Keys" section header to "Service Keys" per
16-UI-SPEC.md Copywriting Contract (line 261).
* feat(17-02): install @modelcontextprotocol/sdk + createMcpServer() factory
- Add @modelcontextprotocol/sdk@^1.29.0 to dependencies (SDK legitimacy
gate cleared by orchestrator; official Anthropic MCP SDK, MIT license)
- Create src/lib/mcp/server.ts: createMcpServer() returns a fresh McpServer
per call with capabilities: { tools: { listChanged: true } } per R-1
- Add stateless/never-cache guard-rail comment + Phase 18/20/21 seam docs
- Add vitest.config.ts clearMocks: true to fix mock isolation between
describe blocks (required for Wave 0 MCP-04 demo-gate tests to pass)
- Transport spike (17-01 Task 3) now PASSES green with SDK installed
* feat(17-02): stateless /api/mcp route handler (Wave 0 RED tests GREEN)
- Create src/app/api/mcp/route.ts: GET/POST/DELETE delegates to
handleMcpRequest(); exports for Next.js App Router
- Gate ordering: isDemo -> 403 JSON-RPC FIRST (before auth); then
authenticateApiKey() -> 401 JSON-RPC on failure (MCP-03/04/D-17-05)
- Fresh McpServer + WebStandardStreamableHTTPServerTransport per request
(sessionIdGenerator: undefined); stateless guard-rail comment (D-17-04)
- AuthInfo injected via closure: { token: "", clientId: userId, scopes: [],
extra: { userId, keyId } } for Phase 18/20/21 resource scoping (R-1)
- X-Accel-Buffering: no + Cache-Control: no-cache merged on streamed
response without buffering body (D-17-06, MCP-06, Pitfall 1)
- All 12 Wave 0 route tests GREEN; transport spike GREEN; 416 tests pass
* refactor(16): replace bcrypt with HMAC-SHA256 key hashing
Switch API key secret storage from bcrypt (200-400ms per auth) to
HMAC-SHA256(signingKey, secret) with timingSafeEqual comparison.
- Signing key: API_KEY_HMAC_SECRET env var, falls back to AUTH_SECRET
- Timing-oracle defense preserved: miss path computes dummy HMAC digest
(same 32-byte length) before timingSafeEqual so both paths are constant-work
- Removes DUMMY_HASH literal, async bcrypt re-hash, and bcryptjs dependency use
- generateApiKey is now synchronous (no bcrypt await)
- M3 fix included: lastUsedAtThrottle TTL-evicts at 2x window to prevent
unbounded Map growth; note added that it is per-replica
- Tests updated: timing-oracle test asserts behavioral contract not elapsed
time (HMAC is microsecond-fast); added hex-format and randomness assertions
NOTE: existing bcrypt-hashed keys in the DB will fail authentication after
this change. Acceptable pre-launch; no live keys to migrate.
* feat(16): security hardening - rate limits, TOCTOU fix, header spoof, name length
H1 - Rate limiting:
- Add mcpLimiter (60 req/min/IP) at Gate 0 in /api/mcp, runs before edition
check and auth so scanners never reach the DB layer
- Add apiKeyManagementLimiter (10 req/min/IP) on GET/POST/DELETE api-keys handlers
- Both limiters exported from rateLimiters.ts with getClientIp re-export
- TODO comment: move to @upstash/ratelimit for multi-replica deployments
- Tests: route.test.ts mocks the limiter module; new MCP 429 tests would live
in mcp/route.test.ts (existing suite passes; limiter tested in rateLimit.test.ts)
H2 - Tenant-header spoof prevention:
- proxy.ts: delete x-tenant-subdomain before NextResponse.next() on /api/*,
then re-inject only the server-resolved value so a forged header cannot
drive the Prisma tenant extension
M1 - TOCTOU on max-3:
- Wrap count + create in prisma.$transaction(..., { isolationLevel: "Serializable" })
so concurrent POSTs cannot both read count < 3 and both succeed
- Route test updated to mock $transaction inline execution
M2 - Name length:
- Reject name > 64 chars server-side with 422 name_too_long before the transaction
- Tests added for > 64 (reject) and exactly 64 (accept)
L2 - Log flooding:
- Downgrade console.error to console.warn on /api/mcp auth failure
* feat(17-03): connect-agent helper UI + nginx runbook + version 2.26.0
- Add ConnectAgentHelper component: per-edition /api/mcp URL, mcpServers
JSON block (Bearer in Authorization header, never in URL), Manual block,
agent-capabilities prompt, deferred CLI "coming soon" note
- Mount ConnectAgentHelper in PersonalApiKeysSection replacing TODO placeholder
- Create .agents/context/server-management.md: Coolify/Nginx streaming
runbook (X-Accel-Buffering: no, proxy_read_timeout 120s, Coolify UI steps)
- Bump version 2.25.0 -> 2.26.0 (feat: new MCP connect-helper surface)
* feat(mcp): add Globe State Sync + Data Query MCP tools (Phases 18 + 20)
Phase 18 - Globe State Sync (v2.27.0):
- ioredis singleton (src/lib/redis.ts), GlobeStateSnapshot type, globeStateStore ZSET session registry
- POST /api/globe/state with dual auth (NextAuth session primary, Bearer fallback per R-2)
- useSessionId + useGlobeStateSync browser hooks with 500ms debounce + 10s heartbeat
- GlobeView wiring for real-time state push
- registerGlobeResources MCP module: RSRC-02 (globe://state/{sessionId}), RSRC-03 (globe://sessions), RSRC-04 (globe://layers)
- Route.ts first R-1 serialized edit
Phase 20 - Data Query Tools:
- Transport-neutral service layer (src/lib/data-query/service.ts): searchEntities, getEntitiesInRegion, getEntityDetails, getPluginData
- REST routes: GET /api/v1/entities/search, GET /api/v1/entities/region
- registerDataQueryTools MCP module: TOOL-01 search_entities, TOOL-02 get_entities_in_region, TOOL-03 get_entity_details, TOOL-04 get_plugin_data
- Route.ts second R-1 serialized edit
- vitest global setup (src/test/setup.ts) for next-auth jsdom compatibility
498/498 tests GREEN. Zero new TypeScript errors.
* feat(19a): globe command system tools via Redis queue + HTTP polling
Add MCP "globe command" system tools so an authenticated agent can act on
an open globe: pan, focus an entity, toggle a layer, and scrub the timeline.
Transport is poll-based (no WebSocket, no custom server.ts): tools RPUSH a
validated command to a per-session Redis list (TTL 60s), the browser polls
GET /api/globe/commands on an interval, drains atomically (MULTI lrange+del),
re-validates, and dispatches to the Cesium camera (DataBus) and Zustand store.
This is the durable transport; WebSocket push (19b) can layer on later without
rewriting the type guard, tools, sessionId resolution, or browser dispatch.
Covers CTRL-04 + CTRL-05. 19b (WS push) remains deferred.
- GlobeCommand discriminated union + isValidGlobeCommand guard (never throws;
validates timeWindow against the literal set and currentTime as a real date)
- globeCommandQueue: atomic enqueue (multi.rpush.expire) + drain + session resolve
- registerGlobeCommandTools: 4 MCP tools, userId from auth ctx only, graceful
no-session result, z.enum for timeWindow
- GET /api/globe/commands: dual-auth (session primary, Bearer fallback),
UUID sessionId 400 guard, dedicated globeCommandsLimiter
- useGlobeCommandBridge: 1500ms poll with in-flight guard + unmount cleanup
- route.ts: third per-request registrar call (R-1)
Reviewed by code-reviewer + security-reviewer (no Critical/High; auth provenance,
gate ordering, and tenant isolation verified). Suite 573/0.
* test(21-01): RED tests for plugin-tools quality phase (Wave 0)
- validateManifest.test.ts: MAN-01..08 for mcpTools/mcpCapabilities validation
- pluginTools.test.ts: PT-01..08 for getNamespacedTools + minimal input validator
- mcpSessionCatalog.test.ts: CAT-01..06 for per-session catalog publish/read + key scoping
- pluginToolsList.test.ts: LIST-01..05 for dynamic tools/list composition
- mcpRelay.test.ts: RELAY-01 + SEC-01..05 for request/response relay + security invariants
- pluginToolDispatch.test.ts: MCP-QA-01..04 + SEC-01/06 for auth/dispatch QA
* feat(21-02): make Wave 1 SDK tests GREEN
- Add McpToolDeclaration interface to wwv-plugin-sdk manifest.ts (NO execution field - v3 invariant)
- Add mcpTools? and mcpCapabilities? optional fields to PluginManifest
- Add executeMcpTool? hook to WorldPlugin interface in index.ts
- Re-export McpToolDeclaration from sdk index.ts and src/core/plugins/PluginManifest.ts
- Extend validateManifest to validate mcpTools entries (name presence + safe identifier check) and mcpCapabilities (string array)
- Create src/lib/mcp/pluginTools.ts with getNamespacedTools (auto-namespaces to {pluginId}__name) and validateToolArgs (hand-rolled type/required/enum validator, no external schema library)
* feat(21-03): mcpSessionCatalog Redis store + catalog POST route
- publishSessionCatalog/readSessionCatalog with {userId}:{sessionId} key scoping and TTL
- POST /api/mcp/catalog with dual-auth, UUID guard, size cap, isDemo 403 gate
- userId from auth result only -- never from request body
- CAT-01..06 tests GREEN
* feat(21-03): browser catalog-publisher hook useMcpCatalogPublisher
- Reads loaded plugins + manifests from pluginManager on mount and interval
- POSTs {tools, capabilities} to /api/mcp/catalog to keep catalog TTL fresh
- No-op when no plugins declare mcpTools
- sessionId from caller (useSessionId) -- no new identity source invented
- PLUG-04 browser-side catalog publishing
* feat(21-03): composePluginToolsList + dynamic tools/list in route.ts
- composePluginToolsList merges system tools with per-session plugin tools
- De-duplicates by namespaced name; capability-coverage copy in descriptions
- route.ts registerPluginTools reads catalog via resolveActiveSessionId+readSessionCatalog
- Plugin tool stub handlers registered (Wave 3 will wire relay)
- No DB/tenantId enumeration -- browser-published discovery only
- LIST-01..05 tests GREEN
* feat(21-04): add mcpRelay request/response machinery (PLUG-03)
- enqueueToolInvocation: RPUSH invocation to session-scoped list + ownership record
- waitForToolResult: blpop with bounded deadline; returns { timedOut: true } on expiry, never throws
- postToolResult: ownership check via EXISTS + result size cap; RPUSH to result list
- drainToolInvocations: atomic multi().lrange().del() drain (mirrors drainGlobeCommands)
- All Redis keys scoped {userId}:{sessionId}; result key also includes requestId (SEC-01..05 green)
* feat(21-04): add plugin tool dispatch + invocations/results routes (PLUG-03)
- pluginToolDispatch.ts: registerPluginToolDispatch reads catalog, registers relay handler per tool
- validateToolArgs BEFORE enqueue (MCP-QA-03); unknown tool never enqueued (MCP-QA-02)
- waitForToolResult with 10s deadline; graceful timeout text result on expiry (MCP-QA-04)
- userId from auth context only, never from tool args (SEC-06)
- GET /api/mcp/invocations: dual-auth, UUID sessionId guard, rate-limited; drains invocations
- POST /api/mcp/results: dual-auth, ownership check, size cap; writes via postToolResult
- route.ts: wire registerPluginToolDispatch at registrar seam; remove Wave 2 stub handler
- rateLimiters.ts: add mcpInvocationsLimiter + mcpResultsLimiter
* feat(21-04): add useMcpRelayBridge browser relay hook (PLUG-03)
- Polls GET /api/mcp/invocations every 1500ms (mirrors useGlobeCommandBridge cadence)
- For each invocation: strips {pluginId}__ prefix -> resolves plugin -> calls executeMcpTool
- On plugin error or missing executeMcpTool: posts sanitized error result so server blpop resolves
- inFlightRef prevents overlapping polls; activeRef prevents post-unmount state updates
- console.error in catch only; no any; no ts-ignore
* feat(21): plugin tools via frontend-relay (v2.29.0)
- McpToolDeclaration type in SDK (no execution field - server stays plugin-agnostic)
- WorldPlugin.executeMcpTool? browser-side hook
- validateManifest rules for mcpTools + mcpCapabilities
- getNamespacedTools ({pluginId}__{name}) + hand-rolled input validator
- Per-session catalog: browser publishes loaded plugins' tools to Redis
- POST /api/mcp/catalog + useMcpCatalogPublisher browser hook
- Dynamic tools/list: system tools + per-session namespaced plugin tools
- Request/response relay: enqueue invocation, blpop wait (10s deadline), graceful timeout
- GET /api/mcp/invocations + POST /api/mcp/results browser-facing relay routes
- useMcpRelayBridge: polls invocations, calls executeMcpTool, posts result
- All relay routes: dual-auth, UUID guard, isDemo 403, ownership check, size caps
- useMcpCatalogPublisher + useMcpRelayBridge wired into GlobeView
- README MCP config block
* fix: resolve merge conflicts and CI failures (v2.29.1)
- Merge origin/main (resolved package.json version conflict, kept 2.29.x)
- Fix Next.js 15 async params: api-keys/[id]/route.ts DELETE now awaits params
- Update api-keys/[id]/route.test.ts to pass Promise.resolve({id}) for params
- Fix TypeScript errors in globeResources.test.ts: cast mock.calls to typed tuples
- Fix TypeScript errors in globe/commands/route.test.ts: cast auth mock to session getter signature, add Session type imports
- Fix TypeScript error in mcp/route.test.ts: replace invalid query-string imports (./route?demo-post) with vi.resetModules() + plain ./route re-import
- Add public/plugins-local/** to eslint ignore: compiled bundles are not source
* fix: update pnpm-lock.yaml to include ioredis (CI frozen-lockfile fix)
* fix(security): validate pluginId to prevent SSRF and format string injection
CodeQL flagged two alerts in src/lib/data-query/service.ts: user-controlled
pluginId was interpolated directly into a fetch URL (SSRF, critical) and into
console.error template literals (format string, high). Added validatePluginId()
which enforces an alphanumeric+hyphen+underscore allowlist, uses URL constructor
to build safe paths, and removed user-controlled values from log template strings.
* fix(e2e): use pointer capture for bottom panel resize drag
Replaced the window-level mousemove/mouseup/pointermove/pointerup
listeners (gated on an isDragging state flag) with element-level
pointer capture on the resize handle. setPointerCapture routes all
subsequent pointermove/pointerup events to the element regardless of
where the pointer travels, which is required for webkit: without
capture, webkit drops synthetic pointermove events during Playwright
drags and during fast real-user drags that leave the element bounds.
This was a pre-existing failure on main (run 26639956515) reproduced
identically on this branch. The fix is correct production behaviour,
not a test workaround.
Bumps version 2.29.2 -> 2.29.3.
* feat(19b): SSE push transport for globe commands
Replace 1500ms setInterval poll loop in useGlobeCommandBridge with a
persistent EventSource (Server-Sent Events) connection. Commands are
pushed within 200ms of enqueue instead of up to 1500ms.
- New GET /api/globe/commands/stream route: ReadableStream with poll-
with-deadline loop, 15s keepalive, 16s max duration, cancel callback
for client-disconnect cleanup, same dual-auth + isDemo gate order
- useGlobeCommandBridge: replaced setInterval/fetch with EventSource;
dispatchCommand unchanged; envelope shape validation in onmessage
- globeCommandsStreamLimiter: 10 req/60s for the SSE endpoint
- GET /api/globe/commands poll route: added missing isDemo 403 gate
- 654/654 tests pass, 0 regressions
* fix(mcp): close v1.2 milestone-audit tech debt
Addresses tech debt surfaced by the v1.2 milestone audit and the
code/security reviews of the fixes:
- mcpRelay: make enqueueToolInvocation atomic via multi().rpush().expire().set()
and apply the same atomicity to postToolResult's result write (was two
separate non-atomic writes that could leak on partial failure)
- redis: add set() to the RedisMultiChain interface to support the above
- v1 entities (search + region): add dual-auth (NextAuth session primary,
Bearer fallback) matching globe/commands route; add isDemo 403 gate before
auth; guard limit against NaN from non-numeric ?limit input; document that
entity data is global/public so userId gates access but is not a query filter
- useGlobeStateSync: fire one immediate pushState on mount (ran-once ref guard)
to close the session-registration race where resolveActiveSessionId returned
null before the first heartbeat
- useMcpCatalogPublisher: wire getNamespacedTools instead of inline pluginId__name
string building (DRY); catalog payload shape unchanged
- remove dead export pluginToolsList.ts (composePluginToolsList had zero
production callers; McpServer auto-generates tools/list from registered tools)
643/643 tests pass, tsc clean, lint clean.
* feat(mcp): document session workflow + harden coordinate validation
Add the MCP server `instructions` block so a connecting agent learns the
session-discovery workflow up front: read the globe://sessions resource to
list active tabs, then pass an optional sessionId to target one specific
tab (omit to target the most-recently-active tab). Enrich the four globe
command tools' sessionId descriptions and the data-query tool descriptions
(empty result means no match or no live data, not an error). Bump the
advertised MCP server version to 1.2.0.
Harden coordinate validation across every MCP coordinate surface via a new
shared coordinateSchemas module: latitude [-90,90], longitude [-180,180],
altitude > 0, rejecting NaN/Infinity. Applied to pan_globe, focus_entity,
get_entities_in_region, and the /api/v1/entities/region route, with a
defense-in-depth runtime guard in isValidGlobeCommand. Fixes a UAT finding
where pan_globe accepted lat=999.
Quiet the useGlobeCommandBridge SSE onerror handler so it logs only on a
terminal close (readyState CLOSED, e.g. an unauthenticated tab), not on the
designed ~16s stream reconnect.
* fix(18-05): add isDemo gate to POST /api/globe/state
- Import isDemo from @/core/edition in route.ts
- Gate executes after rate limiter and before userId resolution
- 403 { error: "Not available in demo edition" } returned for demo edition
- Test: vi.hoisted editionMock pattern for mutable isDemo toggle
- All 6 tests green (5 pre-existing + 1 new demo-gate case)
- useGlobeStateSync confirmed to handle 403 silently (no code change needed)
* docs(18-05): complete gap-closure plan summary and update STATE.md
- 18-05-SUMMARY.md: isDemo gate on POST /api/globe/state, GAP-01 closed
- STATE.md: gap-closure entry with commit hash, test counts, deviation note
* fix(auth,api-keys): resolve POST /api/api-keys 500 and persist session users
- Auth: add ensureLocalUserPersisted() (idempotent upsert in authorize())
and persistDemoAdminIfNeeded() (upsert in jwt callback) so session userId
always has a DB row before FK-constrained inserts
- api-keys POST: map Prisma P2003 on user_api_keys_userId_fkey to 401
session_user_not_found instead of 500; other FK violations still 500
- api-keys GET/POST: add isDemo gate returning 403 before auth
- Tests: full coverage for all new paths (16 tests, 2 files)
|
||
|
|
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 |
||
|
|
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 |
||
|
|
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 |
||
|
|
053a916ada |
feat(23-01): add setFilter/clearFilter GlobeCommand variants + validator
- Add setFilter and clearFilter union members (per D-01) - Add isValidFilterValue discriminating text/select/range/boolean - Validate pluginId + every FilterValue for setFilter; optional string for clearFilter - 12 new GREEN validator tests (T-23-01-01 tampering mitigation) - Bump semver 2.38.0 -> 2.39.0 |
||
|
|
a8ed51d1a7 |
feat(22-04): wire flyTo command to Cesium camera
- Add flyTo case to useGlobeCommandBridge dispatchCommand: bbox emits cameraFlyToBbox, point emits cameraGoTo with lon:cmd.lng mapping and 15000m default alt - Subscribe to cameraFlyToBbox in useCameraActions, flying to Rectangle.fromDegrees - Bump version to 2.37.0 |
||
|
|
7583b4cac1 |
feat(22-01): add flyTo variant to GlobeCommand union + isValidGlobeCommand case
- Add flyTo member: { type: "flyTo"; lat; lng; alt?; bbox? }
- Add flyTo case to isValidGlobeCommand with lat/lng/alt/bbox validation
- bbox must be 4-element array of finite numbers within valid WGS84 bounds
- Add 8 RED->GREEN test cases in flyTo validator describe block
|
||
|
|
cd80ba130e |
feat(mcp): document session workflow + harden coordinate validation
Add the MCP server `instructions` block so a connecting agent learns the session-discovery workflow up front: read the globe://sessions resource to list active tabs, then pass an optional sessionId to target one specific tab (omit to target the most-recently-active tab). Enrich the four globe command tools' sessionId descriptions and the data-query tool descriptions (empty result means no match or no live data, not an error). Bump the advertised MCP server version to 1.2.0. Harden coordinate validation across every MCP coordinate surface via a new shared coordinateSchemas module: latitude [-90,90], longitude [-180,180], altitude > 0, rejecting NaN/Infinity. Applied to pan_globe, focus_entity, get_entities_in_region, and the /api/v1/entities/region route, with a defense-in-depth runtime guard in isValidGlobeCommand. Fixes a UAT finding where pan_globe accepted lat=999. Quiet the useGlobeCommandBridge SSE onerror handler so it logs only on a terminal close (readyState CLOSED, e.g. an unauthenticated tab), not on the designed ~16s stream reconnect. |
||
|
|
dc1e802922 |
fix(mcp): close v1.2 milestone-audit tech debt
Addresses tech debt surfaced by the v1.2 milestone audit and the code/security reviews of the fixes: - mcpRelay: make enqueueToolInvocation atomic via multi().rpush().expire().set() and apply the same atomicity to postToolResult's result write (was two separate non-atomic writes that could leak on partial failure) - redis: add set() to the RedisMultiChain interface to support the above - v1 entities (search + region): add dual-auth (NextAuth session primary, Bearer fallback) matching globe/commands route; add isDemo 403 gate before auth; guard limit against NaN from non-numeric ?limit input; document that entity data is global/public so userId gates access but is not a query filter - useGlobeStateSync: fire one immediate pushState on mount (ran-once ref guard) to close the session-registration race where resolveActiveSessionId returned null before the first heartbeat - useMcpCatalogPublisher: wire getNamespacedTools instead of inline pluginId__name string building (DRY); catalog payload shape unchanged - remove dead export pluginToolsList.ts (composePluginToolsList had zero production callers; McpServer auto-generates tools/list from registered tools) 643/643 tests pass, tsc clean, lint clean. |
||
|
|
7fd1d7ebf8 |
feat(19b): SSE push transport for globe commands
Replace 1500ms setInterval poll loop in useGlobeCommandBridge with a persistent EventSource (Server-Sent Events) connection. Commands are pushed within 200ms of enqueue instead of up to 1500ms. - New GET /api/globe/commands/stream route: ReadableStream with poll- with-deadline loop, 15s keepalive, 16s max duration, cancel callback for client-disconnect cleanup, same dual-auth + isDemo gate order - useGlobeCommandBridge: replaced setInterval/fetch with EventSource; dispatchCommand unchanged; envelope shape validation in onmessage - globeCommandsStreamLimiter: 10 req/60s for the SSE endpoint - GET /api/globe/commands poll route: added missing isDemo 403 gate - 654/654 tests pass, 0 regressions |
||
|
|
1aba01e40f | Merge remote-tracking branch 'origin/main' into feat/mcp-support | ||
|
|
9c28d5170f |
feat(21): plugin tools via frontend-relay (v2.29.0)
- McpToolDeclaration type in SDK (no execution field - server stays plugin-agnostic)
- WorldPlugin.executeMcpTool? browser-side hook
- validateManifest rules for mcpTools + mcpCapabilities
- getNamespacedTools ({pluginId}__{name}) + hand-rolled input validator
- Per-session catalog: browser publishes loaded plugins' tools to Redis
- POST /api/mcp/catalog + useMcpCatalogPublisher browser hook
- Dynamic tools/list: system tools + per-session namespaced plugin tools
- Request/response relay: enqueue invocation, blpop wait (10s deadline), graceful timeout
- GET /api/mcp/invocations + POST /api/mcp/results browser-facing relay routes
- useMcpRelayBridge: polls invocations, calls executeMcpTool, posts result
- All relay routes: dual-auth, UUID guard, isDemo 403, ownership check, size caps
- useMcpCatalogPublisher + useMcpRelayBridge wired into GlobeView
- README MCP config block
|
||
|
|
6cb86e0352 |
feat(21-04): add useMcpRelayBridge browser relay hook (PLUG-03)
- Polls GET /api/mcp/invocations every 1500ms (mirrors useGlobeCommandBridge cadence)
- For each invocation: strips {pluginId}__ prefix -> resolves plugin -> calls executeMcpTool
- On plugin error or missing executeMcpTool: posts sanitized error result so server blpop resolves
- inFlightRef prevents overlapping polls; activeRef prevents post-unmount state updates
- console.error in catch only; no any; no ts-ignore
|
||
|
|
cbd48e52fd |
feat(21-03): browser catalog-publisher hook useMcpCatalogPublisher
- Reads loaded plugins + manifests from pluginManager on mount and interval
- POSTs {tools, capabilities} to /api/mcp/catalog to keep catalog TTL fresh
- No-op when no plugins declare mcpTools
- sessionId from caller (useSessionId) -- no new identity source invented
- PLUG-04 browser-side catalog publishing
|
||
|
|
bda235f354 |
feat(21-02): make Wave 1 SDK tests GREEN
- Add McpToolDeclaration interface to wwv-plugin-sdk manifest.ts (NO execution field - v3 invariant)
- Add mcpTools? and mcpCapabilities? optional fields to PluginManifest
- Add executeMcpTool? hook to WorldPlugin interface in index.ts
- Re-export McpToolDeclaration from sdk index.ts and src/core/plugins/PluginManifest.ts
- Extend validateManifest to validate mcpTools entries (name presence + safe identifier check) and mcpCapabilities (string array)
- Create src/lib/mcp/pluginTools.ts with getNamespacedTools (auto-namespaces to {pluginId}__name) and validateToolArgs (hand-rolled type/required/enum validator, no external schema library)
|
||
|
|
5930bc7b25 |
test(21-01): RED tests for plugin-tools quality phase (Wave 0)
- validateManifest.test.ts: MAN-01..08 for mcpTools/mcpCapabilities validation - pluginTools.test.ts: PT-01..08 for getNamespacedTools + minimal input validator - mcpSessionCatalog.test.ts: CAT-01..06 for per-session catalog publish/read + key scoping - pluginToolsList.test.ts: LIST-01..05 for dynamic tools/list composition - mcpRelay.test.ts: RELAY-01 + SEC-01..05 for request/response relay + security invariants - pluginToolDispatch.test.ts: MCP-QA-01..04 + SEC-01/06 for auth/dispatch QA |
||
|
|
ef8decc892 |
feat(19a): globe command system tools via Redis queue + HTTP polling
Add MCP "globe command" system tools so an authenticated agent can act on an open globe: pan, focus an entity, toggle a layer, and scrub the timeline. Transport is poll-based (no WebSocket, no custom server.ts): tools RPUSH a validated command to a per-session Redis list (TTL 60s), the browser polls GET /api/globe/commands on an interval, drains atomically (MULTI lrange+del), re-validates, and dispatches to the Cesium camera (DataBus) and Zustand store. This is the durable transport; WebSocket push (19b) can layer on later without rewriting the type guard, tools, sessionId resolution, or browser dispatch. Covers CTRL-04 + CTRL-05. 19b (WS push) remains deferred. - GlobeCommand discriminated union + isValidGlobeCommand guard (never throws; validates timeWindow against the literal set and currentTime as a real date) - globeCommandQueue: atomic enqueue (multi.rpush.expire) + drain + session resolve - registerGlobeCommandTools: 4 MCP tools, userId from auth ctx only, graceful no-session result, z.enum for timeWindow - GET /api/globe/commands: dual-auth (session primary, Bearer fallback), UUID sessionId 400 guard, dedicated globeCommandsLimiter - useGlobeCommandBridge: 1500ms poll with in-flight guard + unmount cleanup - route.ts: third per-request registrar call (R-1) Reviewed by code-reviewer + security-reviewer (no Critical/High; auth provenance, gate ordering, and tenant isolation verified). Suite 573/0. |
||
|
|
a5b4b627a6 |
feat(mcp): add Globe State Sync + Data Query MCP tools (Phases 18 + 20)
Phase 18 - Globe State Sync (v2.27.0):
- ioredis singleton (src/lib/redis.ts), GlobeStateSnapshot type, globeStateStore ZSET session registry
- POST /api/globe/state with dual auth (NextAuth session primary, Bearer fallback per R-2)
- useSessionId + useGlobeStateSync browser hooks with 500ms debounce + 10s heartbeat
- GlobeView wiring for real-time state push
- registerGlobeResources MCP module: RSRC-02 (globe://state/{sessionId}), RSRC-03 (globe://sessions), RSRC-04 (globe://layers)
- Route.ts first R-1 serialized edit
Phase 20 - Data Query Tools:
- Transport-neutral service layer (src/lib/data-query/service.ts): searchEntities, getEntitiesInRegion, getEntityDetails, getPluginData
- REST routes: GET /api/v1/entities/search, GET /api/v1/entities/region
- registerDataQueryTools MCP module: TOOL-01 search_entities, TOOL-02 get_entities_in_region, TOOL-03 get_entity_details, TOOL-04 get_plugin_data
- Route.ts second R-1 serialized edit
- vitest global setup (src/test/setup.ts) for next-auth jsdom compatibility
498/498 tests GREEN. Zero new TypeScript errors.
|
||
|
|
7da3741fe2 |
feat(plugins): plugin management UX overhaul (#214)
- feat: wrench icon on local plugin layers in Data Layers panel - fix: plugin disable/enable lifecycle without page reload - fix: localStorage-only disable persistence (wwv-disabled-plugins key) - fix: hot-load plugin script on enable when disabled at startup - fix: disable shows reload banner; enable clears it - fix: enable no longer auto-turns layer on - fix: PluginIcon fallback for renamed/unknown Lucide icon names - fix: market-tracker icon LineChart -> ChartLine (Lucide rename) - style: GeoJSON importer fully themed via CSS variables (no hardcoded cyan) - style: Import GeoJSON button matches panel theme - style: Browse Plugins text centered |
||
|
|
b5f8c9ff32 |
feat(globe): add weather radar overlay with OpenWeatherMap tile proxy (#153)
* feat(globe): add weather radar overlay with OpenWeatherMap tile proxy Adds a complete weather overlay system: server-side tile proxy that hides the OWM API key, Cesium imagery layer integration at 60% opacity, and a dropdown in Graphics settings to toggle between clouds, precipitation, temperature, wind, and pressure layers. Closes #10. * fix(weather): address PR #153 review feedback - Remove console.error from tile proxy catch block - Validate tile x/y against zoom-level upper bound (2^z) and cap zoom at 18 - Fix useEffect race condition in weather overlay with cancelled flag - Replace stale enableFxaa/msaaSamples in DEFAULT_GRAPHICS with antiAliasing - Extract shared WEATHER_LAYERS constant into src/lib/weatherLayers.ts - Normalize indentation in GraphicsSettings.tsx Co-Authored-By: Claude Opus 4.6 <[email protected]> * fix(globe): consolidate weather overlay cleanup into return function Remove eager top-of-body removal of weatherLayerRef that created a double-removal pattern. The cleanup function already handled removal via a local layer variable with a ref guard; the eager removal was redundant and fragile under React 18 concurrent scheduling. Also drop the unused cancelled flag (UrlTemplateImageryProvider is synchronous, so the flag could never flip true inside the effect body). --------- Co-authored-by: Claude Opus 4.6 <[email protected]> Co-authored-by: Antigravity AI <[email protected]> |
||
|
|
eeec748d41 | fix(globe): enable Cesium World Terrain for non-Google 3D mode (#167) (#174) | ||
|
|
02336e6a0a |
fix(security): Phase 3 audit blockers — PKCE cookie path + WsClient subscribe race (#190)
* fix(incidents): add mapWebsocketPayload default to BaseIncidentPlugin
Default unwraps three WsClient-visible payload shapes:
- scheduler envelope { source, fetchedAt, items, totalCount } -> items
- GeoJSON FeatureCollection { features: [...] } -> normalised GeoEntity[]
- flat GeoEntity[] -> passthrough (with timestamp normalisation)
Resolves the silent-drop bug that left the earthquakes plugin showing an empty
layer when the scheduler's standard wrapping was used. Subclasses can still
override mapWebsocketPayload for domain-specific shapes (iranwarlive pattern
preserved by 2 override tests).
Test deltas:
- 2 it.fails tests flipped to passing (scheduler-wrap, GeoJSON unwrap).
- 2 'currently drops' companion tests deleted (bug is fixed, companions obsolete).
- 1 structural test updated: 'does NOT have mapWebsocketPayload' -> 'has mapWebsocketPayload defined'.
- Net: 12 tests -> 10 tests, all passing.
* test(ssrf): replace placeholder assertions with real tests for DNS pinning and size limits
The two expect(true).toBe(true) stubs in ssrf.spec.ts are replaced with
assertions that verify actual SSRF guard behavior:
- "enforces maxSize" — mocks undici.fetch to return an 11-byte body with a
10-byte limit; verifies response.text() rejects with "size exceeded"
- "does not follow redirects" — mocks dns.lookup + undici.fetch; verifies
redirect:manual is passed, fetch is called once, and the 301 is returned
without being followed; also asserts dispatcher is set (DNS pinning)
Uses vi.hoisted + vi.mock to patch dns/promises and undici at module level.
360/360 tests pass.
* fix(security): close Phase 3 audit blockers and unregistered flags
- WsClient.ts: guard subscribe() against sending frames while awaitingWelcome=true;
prevents pre-auth subscribe race when a second plugin subscribes mid-handshake
- connect/route.ts + callback/route.ts: set PKCE cookie path="/" to satisfy
RFC 6265bis __Host- prefix requirement (Chromium silently rejects __Host- + path!=/)
- pkce.spec.ts: update assertion to match corrected path="/"
- docs/plans/03-SECURITY.md: security audit report (13 closed, 1 fixed, 3 flags filed)
|
||
|
|
67fcd7923e |
test(auth): unit tests for ADR-001 ticket route, boot gate, and edition flag (#172)
* feat(auth): implement ADR-001 Workstream C — ticket auth, SSRF, and pre-flight audit
C1: Boot-time ENCRYPTION_MASTER_KEY / AUTH_SECRET validation (instrumentation.ts);
remove silent fallback in encryption.ts; guard marketplace token from data-plane misuse.
C2: SSRF host-allowlist (PROXY_HOST_ALLOWLIST) in ssrf.ts; route iframe proxy through safeFetch.
C3: ticketClient.ts — exchanges long-lived API key for 5-min EdDSA ticket from Marketplace;
audience fixed to ENGINE_AUDIENCE='wwv-data-engine'; cache keyed by engine not plugin.
C4: WsClient.ts first-message auth — sends {type:'auth',v:1,token} on open; queues subscribes
until {type:'welcome'}; gated by ticketAuthEnabledForPlugin.
C5: edition.ts — ticketAuthEnabledForPlugin reads NEXT_PUBLIC_WWV_TICKET_AUTH_PLUGINS flag.
Step 0: docs/deploys/2026-05-21-adr-001-preflight.md + docs/feature-flags.md audit artifacts.
Tests: ticketClient.spec, WsClient.spec, ssrf.spec updated (342 passing).
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(ci): resolve three PR #171 type-check and startup failures
- auth-contracts.spec.ts: assert WebSocketAuthMessage.token as PluginTicket
(not SensitiveString — distinct branded types fail toEqualTypeOf equality)
- pkce.spec.ts: replace function(){return this} mock with arrow fn to fix
TS2683 implicit-this error in strict mode
- test-local-dev.yml: add ENCRYPTION_MASTER_KEY so instrumentation.ts boot
validation doesn't crash the startup test in CI
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(ci): fix pkce mock constructor and env injection for startup test
- pkce.spec.ts: use function(this: object) instead of arrow fn so the
mock can be called with `new Configuration(...)` (arrow functions are
not constructors)
- test-local-dev.yml: sed-replace ENCRYPTION_MASTER_KEY in .env after
cp .env.example so Next.js instrumentation boot check passes in CI
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(ci): also sed-replace AUTH_SECRET in .env for startup test
.env.example has AUTH_SECRET= (empty), which Next.js loads and overrides
the system env var, causing the same boot crash as ENCRYPTION_MASTER_KEY.
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(setup): auto-generate ENCRYPTION_MASTER_KEY in setup.mjs
The Playwright CI workflow uses `pnpm run setup` which previously only
generated AUTH_SECRET. ENCRYPTION_MASTER_KEY remained empty from
.env.example, causing instrumentation.ts boot validation to crash.
This fix also improves the new-developer onboarding experience — both
required secrets are now generated in a single setup step.
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* test(auth): add unit tests for ticket route, instrumentation boot gate, and edition flag
Covers GET /api/auth/ticket (4 cases), register() startup validation (4 cases),
and ticketAuthEnabledForPlugin() dormant-safety gate (4 cases). All 350 tests pass.
Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
---------
Co-authored-by: Claude Opus 4.7 <[email protected]>
|
||
|
|
26568429bc |
feat(auth): ADR-001 Workstream C — ticket auth, SSRF protection, and pre-flight audit (#171)
* feat(auth): implement ADR-001 Workstream C — ticket auth, SSRF, and pre-flight audit
C1: Boot-time ENCRYPTION_MASTER_KEY / AUTH_SECRET validation (instrumentation.ts);
remove silent fallback in encryption.ts; guard marketplace token from data-plane misuse.
C2: SSRF host-allowlist (PROXY_HOST_ALLOWLIST) in ssrf.ts; route iframe proxy through safeFetch.
C3: ticketClient.ts — exchanges long-lived API key for 5-min EdDSA ticket from Marketplace;
audience fixed to ENGINE_AUDIENCE='wwv-data-engine'; cache keyed by engine not plugin.
C4: WsClient.ts first-message auth — sends {type:'auth',v:1,token} on open; queues subscribes
until {type:'welcome'}; gated by ticketAuthEnabledForPlugin.
C5: edition.ts — ticketAuthEnabledForPlugin reads NEXT_PUBLIC_WWV_TICKET_AUTH_PLUGINS flag.
Step 0: docs/deploys/2026-05-21-adr-001-preflight.md + docs/feature-flags.md audit artifacts.
Tests: ticketClient.spec, WsClient.spec, ssrf.spec updated (342 passing).
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(ci): resolve three PR #171 type-check and startup failures
- auth-contracts.spec.ts: assert WebSocketAuthMessage.token as PluginTicket
(not SensitiveString — distinct branded types fail toEqualTypeOf equality)
- pkce.spec.ts: replace function(){return this} mock with arrow fn to fix
TS2683 implicit-this error in strict mode
- test-local-dev.yml: add ENCRYPTION_MASTER_KEY so instrumentation.ts boot
validation doesn't crash the startup test in CI
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(ci): fix pkce mock constructor and env injection for startup test
- pkce.spec.ts: use function(this: object) instead of arrow fn so the
mock can be called with `new Configuration(...)` (arrow functions are
not constructors)
- test-local-dev.yml: sed-replace ENCRYPTION_MASTER_KEY in .env after
cp .env.example so Next.js instrumentation boot check passes in CI
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(ci): also sed-replace AUTH_SECRET in .env for startup test
.env.example has AUTH_SECRET= (empty), which Next.js loads and overrides
the system env var, causing the same boot crash as ENCRYPTION_MASTER_KEY.
Co-Authored-By: Claude Opus 4.7 <[email protected]>
* fix(setup): auto-generate ENCRYPTION_MASTER_KEY in setup.mjs
The Playwright CI workflow uses `pnpm run setup` which previously only
generated AUTH_SECRET. ENCRYPTION_MASTER_KEY remained empty from
.env.example, causing instrumentation.ts boot validation to crash.
This fix also improves the new-developer onboarding experience — both
required secrets are now generated in a single setup step.
Co-Authored-By: Claude Opus 4.7 <[email protected]>
---------
Co-authored-by: Claude Opus 4.7 <[email protected]>
|
||
|
|
6d62ca5677 |
fix(ws): diagnose & fix plugin 404s, WS auth failure, and reconnect storms (#169)
* fix(ws): exponential backoff + jitter on WsClient reconnect Replaces the fixed 5-second reconnect delay with an exponential backoff (5s→10s→20s→40s→60s cap, +4s random jitter) so simultaneous browser sessions don't thunder-herd the engine on restart. - Backoff resets only after a stable 5-second connection, not on every successful open, so rapid reconnect cycles don't mask the retry. - Stale-timer bookkeeping added to the cleanup/unsubscribe path. Also bundles two companion fixes discovered during the same session: fix(scripts): BOM-safe JSON parsing in sync/watch-local-plugins (Fix) PowerShell 5.1 emits a UTF-8 BOM that Node's JSON.parse rejects; readJsonFile() strips U+FEFF before parsing, matching pnpm behavior. docs(agents): add UTF-8 BOM troubleshooting entry (Fix) Documents diagnosis, fix, and prevention for the BOM crash. Co-Authored-By: Claude Opus 4.7 <[email protected]> * test(ws): pin Math.random to 0 so reconnect backoff test is deterministic With jitter (Math.random()*4000), advancing timers by exactly 5000ms no longer guaranteed to trigger the reconnect. Mocking Math.random to 0 in beforeEach makes the delay deterministic (base only, no jitter) across the full test suite. Co-Authored-By: Claude Sonnet 4.6 <[email protected]> --------- Co-authored-by: Claude Opus 4.7 <[email protected]> |
||
|
|
58aac77a0b |
fix(engine): resolve plugin 404s and local engine routing (#166)
* refactor(marketplace): drive auto-seeding from signed verified registry Retires the hard-coded DEFAULT_PLUGIN_IDS list and makes the signed verified registry the single source of truth for what lands in a fresh install. Publishing a plugin to the verified registry now auto-seeds it; no code change required to add new defaults. Also fixes the diagnosed plugins-404: fortiguard and nz-traffic-cameras were in the static list but not published to npm, causing every fresh boot to hit manifest 404s. Those entries are gone with the list. - Delete src/lib/marketplace/defaultPlugins.ts (legacy static list). - Seeder iterates getVerifiedPluginIds() from registryClient. - Skip markSeeded when the verified set is empty so a registry outage doesn't lock fresh installs into zero plugins; the next request retries (5-min cache in registryClient bounds the request rate). - Stamp every seeded plugin as trust=verified by definition. - Tests rewritten against a fake verified set; new test asserts empty-registry deferral. - Sync marketplace-architecture rule + migrate-legacy-plugin skill with the new model. - Patch bump: 2.15.15 -> 2.15.16. * fix(engine): resolve plugin 404s and local engine routing (#fix/diagnose-plugins-404) - fix: engineManifest + resolveEngineUrl: port 5001→5000 to match docker-compose binding; removed NEXT_PUBLIC_WWV_PLUGIN_DATA_ENGINE_URL from local engine detection — it was poisoning local routing with the production engine URL (Patch) - fix: WsClient: added normalizePluginId() converting underscore IDs to kebab-case so engine WebSocket messages route to the correct frontend plugin (Patch) - fix: docker-compose: added ./local-seeders:/app/seeders volume mount to wwv-data-engine so locally-developed seeders are visible to the engine (Patch) - feat: sync-local-plugins: added wwvHostRedirectPlugin — Vite plugin that intercepts @/ host-app imports in local plugin builds and redirects them to runtime host globals, preventing full app tree from being bundled into plugins (Minor) - docs: plugin-architecture.md: added Plugin Data Delivery Types section (REST-only, WS-only, hybrid), peerDependencies rule, .tsx extension rule, mapWebsocketPayload signature contract (Patch) - docs: data-engine-architecture.md: added §7 WebSocket Payload Format Contract documenting WsClient's three payload handling cases and the silent-drop footgun for plugins that send object payloads without mapWebsocketPayload (Patch) - docs: worldwideview-plugin-creation SKILL.md: fixed ISS example which was missing mapWebsocketPayload and would have silently dropped all WS data; clarified mapWebsocketPayload requirement for non-array payloads; fixed architecture decision tree (Patch) - docs: cesium-rendering.md: added Sizing Conventions table with defaults/ranges for point/billboard/model, cross-plugin parity rules, and silent-ignore footgun warning for size on billboard entities (Patch) - docs: added ADR-0002 documenting seeder exported name as canonical plugin ID (Patch) Version bumps: fix × 3 (Patch), feat × 1 (Minor) → 2.15.16 → 2.16.0 Co-Authored-By: Claude Sonnet 4.6 <[email protected]> * test(engine): update resolveEngineUrl test assertion from port 5001 to 5000 Follows the port correction in engineManifest.ts and resolveEngineUrl.ts. The test was asserting the old default (5001) instead of the corrected local engine port (5000), causing the Unit Tests CI check to fail. Co-Authored-By: Claude Sonnet 4.6 <[email protected]> --------- Co-authored-by: Claude Sonnet 4.6 <[email protected]> |
||
|
|
42564b537f |
ci(playwright): Add multi-browser test matrix (#150)
* ci(playwright): Add multi-browser test matrix (Patch) * fix(cesium): Disable MSAA in Firefox to prevent readPixels crash (Patch) |
||
|
|
fc7dd02ee2 |
refactor(core): harden typescript and fix linting violations (#146)
* chore(merge): resolve conflicts, fix mockWs error, and apply refactor standards * Potential fix for pull request finding 'CodeQL / Incomplete URL substring sanitization' Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> * Potential fix for pull request finding 'CodeQL / Incomplete URL substring sanitization' Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> * Potential fix for pull request finding 'CodeQL / Incomplete URL substring sanitization' Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> * fix(ci): Stabilize github actions and resolve test failures - fix(tests): update WsClient mock to use standard function for Vitest constructor compatibility - fix(db): correct PrismaClient import path to use generated output directory - fix(e2e): add predev database boot step to playwright CI workflow - chore: sync pnpm-lock.yaml after merge conflict resolution * refactor(plugins): decouple GeoJSON plugin and implement data bus lifecycle - feat(sdk): [Minor] Added dynamicPluginCreate, dynamicPluginRemove, and pluginUnregistered to DataBusEvents. - feat(core): [Minor] Implemented unregisterPlugin in PluginManager.ts for automated IndexedDB caching cleanup and polling teardown. - feat(core): [Minor] Added removeLayer to layersSlice.ts to support safe removal of plugin states. - refactor(plugins): [Patch] Refactored useGeoJsonImport.ts and ImportedLayerList.tsx to decouple from direct manager imports, utilizing DataBus for lifecycle events. - refactor(core): [Patch] Added pluginUnregistered listener to DataBusSubscriber.tsx to handle state and cache cleanup synchronously via event. * fix(types): resolve PluginManager type errors * refactor(core): decouple PluginManager and fix rendering invariants - refactor(core): Replace Zustand mutations in PluginManager with DataBus events (Patch) - refactor(sdk): Add layerLoadingChanged, pluginError, pluginUnregistered to DataBusEvents (Patch) - refactor(ui): Subscribe to new DataBus events in DataBusSubscriber (Patch) - fix(plugins): Remove size from BaseAviationPlugin to fix model rendering clipping (Patch) - fix(plugins): Migrate BaseIncidentPlugin from size to iconScale to fix billboard clipping (Patch) * chore: resolve lockfile conflict * fix: restore BottomPanelManager in AppShell and fix vitest config * fix(layout): restore bottom panel positioning and transition styling This commit corrects the missing bottom panel issue by resolving CSS aggregation errors and fixing transition logic. The version is bumped to 2.15.5. * refactor(core): harden typescript and fix linting violations This commit addresses the remaining any types and linting errors across the core engine. * fix(eslint): resolve react-hook immutability and cascading render violations --------- Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> |
||
|
|
339bf6c0f3 |
fix(plugins): ensure plugin fetch uses HTTP scheme (#140)
* fix(plugin-manager): downgrade non-fatal 'Failed to fetch' errors to warn, remove polling re-throw * fix(codeql): resolve format string vulnerability in console logging * fix(ci): restore playwright dependencies and configure tsconfig properly * fix(plugins): ensure plugin fetch uses HTTP scheme instead of WSS |
||
|
|
16c82c9184 |
refactor(lint): address React 19 hook purity and immutability violations (#136)
* chore(merge): resolve conflicts, fix mockWs error, and apply refactor standards * Potential fix for pull request finding 'CodeQL / Incomplete URL substring sanitization' Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> * Potential fix for pull request finding 'CodeQL / Incomplete URL substring sanitization' Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> * Potential fix for pull request finding 'CodeQL / Incomplete URL substring sanitization' Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> * fix(ci): Stabilize github actions and resolve test failures - fix(tests): update WsClient mock to use standard function for Vitest constructor compatibility - fix(db): correct PrismaClient import path to use generated output directory - fix(e2e): add predev database boot step to playwright CI workflow - chore: sync pnpm-lock.yaml after merge conflict resolution * refactor(plugins): decouple GeoJSON plugin and implement data bus lifecycle - feat(sdk): [Minor] Added dynamicPluginCreate, dynamicPluginRemove, and pluginUnregistered to DataBusEvents. - feat(core): [Minor] Implemented unregisterPlugin in PluginManager.ts for automated IndexedDB caching cleanup and polling teardown. - feat(core): [Minor] Added removeLayer to layersSlice.ts to support safe removal of plugin states. - refactor(plugins): [Patch] Refactored useGeoJsonImport.ts and ImportedLayerList.tsx to decouple from direct manager imports, utilizing DataBus for lifecycle events. - refactor(core): [Patch] Added pluginUnregistered listener to DataBusSubscriber.tsx to handle state and cache cleanup synchronously via event. * fix(types): resolve PluginManager type errors * refactor(core): decouple PluginManager and fix rendering invariants - refactor(core): Replace Zustand mutations in PluginManager with DataBus events (Patch) - refactor(sdk): Add layerLoadingChanged, pluginError, pluginUnregistered to DataBusEvents (Patch) - refactor(ui): Subscribe to new DataBus events in DataBusSubscriber (Patch) - fix(plugins): Remove size from BaseAviationPlugin to fix model rendering clipping (Patch) - fix(plugins): Migrate BaseIncidentPlugin from size to iconScale to fix billboard clipping (Patch) * chore: resolve lockfile conflict --------- Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> |
||
|
|
0a51e198d7 |
feat(globe): add OSM 3D Buildings overlay for non-Google imagery layers (#135)
Loads Cesium OSM Buildings (Ion asset 96188) as a 3DTileset when the active base layer is not Google Photorealistic 3D Tiles. Buildings only render in 3D scene mode and are automatically removed when switching to Google 3D, 2D, or Columbus View. Adds a "3D Buildings" toggle in Graphics Settings, persisted via the existing wwv_graphics cookie. |
||
|
|
1d6381182e |
fix(plugin-manager): downgrade non-fatal 'Failed to fetch' errors to warn (#139)
* fix(plugin-manager): downgrade non-fatal 'Failed to fetch' errors to warn, remove polling re-throw * fix(codeql): resolve format string vulnerability in console logging * fix(ci): restore playwright dependencies and configure tsconfig properly |
||
|
|
beb295445f | fix(data-engine): properly respect NEXT_PUBLIC_WWV_PLUGIN_DATA_ENGINE_URL in getLocalWsUrl and align port with engineManifest | ||
|
|
28e4e67043 |
feat: Multi-Worktree Database Lifecycle Automation and Deterministic Ports (#133)
* feat: implement Extensible Bottom Panels and Worktree DB automation - feat: Implemented BottomPanelManager and circular navigation dock for plugins - feat: Added dynamic DATABASE_URL injection with deterministic port assignments - fix: Added 3-retry mechanism to handle file lock (EBUSY / os error 32) issues - feat: Added telemetry for boot sequence visibility * fix(ui): resolve TS2339 by accessing plugin.name directly instead of plugin.metadata |
||
|
|
a475a5a562 |
perf(globe): replace viewer mutation with WeakMap<Viewer, Collections> [Patch]
Primitive collections (points, billboards, labels, polylines) were attached directly to the Cesium Viewer instance as `_wwvX` properties behind `(viewer as any)` casts. This created hidden coupling, blocked multi-viewer setups, and left ~11 `as any` casts across three files. Replace the viewer-mutation pattern with a module-level `WeakMap<CesiumViewer, PrimitiveCollections>`: - `initPrimitiveCollections` now writes into the WeakMap - `getCollections` reads from the WeakMap and returns a destructurable shape with optional fields, preserving the existing call pattern - `AnimationLoop` and `useEntityRendering` use `getCollections(viewer)` instead of direct `(viewer as any)._wwvX` reads - Zero `(viewer as any)._wwv*` remain; collections GC cleanly when the viewer is dropped Adds `src/core/globe/EntityRenderer.test.ts` with 7 tests covering: - WeakMap roundtrip (init populates, getCollections retrieves, per-viewer isolation, graceful no-scene) - Defer-clone behaviour from the previous commit (no clone on iconUrl/model path; clone on auto-SVG path; original untouched) Refs #95 Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]> |
||
|
|
8f859f4559 |
perf(globe): defer effectiveOptions clone to auto-SVG branch [Patch]
`renderSingleEntity` was cloning `options` for every entity via
`const effectiveOptions = { ...options }`, even when the auto-SVG
fallback below didn't need to mutate it. With 10k+ entities per
render pass this adds avoidable GC pressure in the hot loop.
The clone is now deferred into the auto-SVG branch that actually
mutates, so entities that arrive with `iconUrl` set (or `type === "model"`)
pass `options` through by reference with zero allocation.
Refs #95
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
|
||
|
|
8a594d28ea |
perf(globe): type window._wwvFrameCount via Window interface extension [Patch]
Replace `(window as any)._wwvFrameCount = frame` with a typed
`declare global { interface Window { _wwvFrameCount?: number } }`
and a plain `window._wwvFrameCount = frame` assignment.
The external plugin contract (a window-published frame counter for
throttling) is preserved; only the cast is removed.
Refs #95
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
|
||
|
|
2280fc4d19 |
Merge pull request #108 from devangpratap/fix/imagery-fallback-blank-globe
fix(globe): fall back to OSM when imagery providers fail without API keys |