Primitive Demo Integration Matrix

Tracking issue: https://github.com/honua-io/honua-sdk-js/issues/187

This matrix keeps the primitive gap backlog honest: every primitive issue under the JS SDK parity epic must appear in at least one runnable demo lane before the epic closes. Rows can start as planned coverage, but a primitive issue should not close until its row points at implemented example code, validation commands, focused smoke coverage where the workflow is interactive, and proof markers that point at the primitive-specific imports or code paths exercised by that lane.

Coverage Matrix

Issue	Primitive	Demo lanes	Validation commands	Proof markers	Coverage status
#177	One-call app bootstrap and embed primitive	`examples/app-bootstrap-basic`	`npm run demo:app-bootstrap:typecheck` `npm run demo:app-bootstrap:build` `npm run test:playwright:app-bootstrap`	`import:examples/app-bootstrap-basic/src/main.ts:@honua/sdk-js/app` `marker:examples/app-bootstrap-basic/src/main.ts:createHonuaApp({`	Implemented focused demo lane for `createHonuaApp()` bootstrap and renderer injection.
#178	Controller-level layer and source CRUD primitives	`examples/runtime-parity-showcase`	`npm run demo:runtime-parity:typecheck` `npm run demo:runtime-parity:build` `npm run test:playwright:runtime-parity`	`import:examples/runtime-parity-showcase/src/main.ts:@honua/sdk-js/app-controller` `marker:examples/runtime-parity-showcase/src/main.ts:setLayerVisibility(layerId, visible)`	Implemented runtime parity lane for controller-owned layer visibility, source-backed package state, selection, and feature-state updates.
#179	Shared filter and crossfilter registry	`examples/runtime-parity-showcase` `examples/spatial-analytics-workbench`	`npm run demo:runtime-parity:typecheck` `npm run demo:spatial-analytics:typecheck` `npm run test:playwright:spatial-analytics`	`import:examples/spatial-analytics-workbench/src/model.ts:@honua/sdk-js/exploration` `marker:examples/spatial-analytics-workbench/src/model.ts:selectLinkedViewQueryProjection`	Implemented linked-view and analytics lanes for shared filter/crossfilter state projection with deterministic registry contract coverage.
#180	Renderer-neutral hit-test and pointer primitives	`examples/runtime-parity-showcase`	`npm run demo:runtime-parity:typecheck` `npm run demo:runtime-parity:build` `npm run test:playwright:runtime-parity`	`import:examples/runtime-parity-showcase/src/main.ts:@honua/sdk-js/interactions` `marker:examples/runtime-parity-showcase/src/main.ts:runtime.setFeatureStateForTarget`	Implemented runtime parity lane for renderer-neutral hit-test/selection handoff and feature-state updates.
#181	Expanded framework-neutral map controls and panels	`examples/web-components-basic`	`npm run demo:web-components:typecheck` `npm run demo:web-components:build` `npm run test:playwright:web-components`	`import:examples/web-components-basic/src/main.ts:@honua/sdk-js/web-components` `marker:examples/web-components-basic/src/main.ts:createHonuaWebComponentController`	Implemented focused web-components lane for map/chart/table controls and panel coordination.
#182	Sketch, attachments, domains, conflicts, and undo primitives	`examples/edit-workflow-demo`	`npm run demo:edit-workflow:typecheck` `npm run demo:edit-workflow:build` `npm run test:playwright:edit-workflow`	`import:examples/edit-workflow-demo/src/model.ts:@honua/sdk-js/contract` `marker:examples/edit-workflow-demo/src/model.ts:createEditSketchWorkflow` `marker:examples/edit-workflow-demo/src/model.ts:stageAttachmentAdd`	Implemented focused fixture lane for sketch, attachment, domain, conflict, rollback, and undo workflows.
#183	3D terrain, model, and scene runtime primitives	`examples/storytelling-25d-map` `examples/terrain-rgb-elevation`	`npm run demo:25d:typecheck` `npm run demo:terrain-elevation:typecheck` `npm run test:playwright:25d` `npm run test:playwright:terrain-elevation`	`import:examples/terrain-rgb-elevation/src/main.ts:@honua/sdk-js/honua` `marker:examples/terrain-rgb-elevation/src/main.ts:applyMapLibreScenePrimitives` `marker:examples/storytelling-25d-map/src/map.ts:toMapLibreExtrusionLayer`	Implemented scene lanes for 2.5D extrusions, Terrain-RGB diagnostics, and renderer-degraded scene primitives. Native 3D engine adapters remain separate future work.
#184	Warehouse and indexed spatial source primitives	`examples/spatial-analytics-workbench` `examples/kepler-analytics`	`npm run demo:spatial-analytics:typecheck` `npm run demo:spatial-analytics:build` `npm run demo:kepler:build` `npm run test:playwright:spatial-analytics`	`import:examples/spatial-analytics-workbench/src/model.ts:@honua/sdk-js/contract` `marker:examples/spatial-analytics-workbench/src/model.ts:assertValidSpatialAggregationRequest` `marker:examples/kepler-analytics/scripts/refresh-fixture.mjs:queryFeaturesAll`	Implemented analytics lanes for indexed aggregation contracts, warehouse-style source descriptors, deterministic fixture refresh, and export validation.
#185	Provider-ready agentic map and safety primitives	`examples/ai-spatial-app-builder` `examples/mcp-gis-assistant`	`npm run demo:ai-spatial-builder:typecheck` `npm run demo:mcp-gis-assistant:typecheck` `npm run test:playwright:ai-spatial-builder` `npm run test:playwright:mcp-gis-assistant`	`import:examples/ai-spatial-app-builder/src/safe-agent.ts:@honua/sdk-js/agent-tools` `import:examples/ai-spatial-app-builder/src/safe-agent.ts:@honua/sdk-js/agent-safety` `marker:examples/ai-spatial-app-builder/src/safe-agent.ts:verifyAgentStepAuthorization` `marker:examples/mcp-gis-assistant/src/assistant.ts:createHonuaAppWorkspace`	Implemented a fixture-backed typed-tool, signed/atomic safe-agent workflow and MCP-style assistant lane. Provider live integration remains host-mediated and outside deterministic demo proof.
#186	Control-plane SDK handoff for hosted maps, workspaces, imports, tokens, and connections	`examples/service-explorer` `examples/node-backend-quickstart`	`npm run demo:service-explorer:typecheck` `npm run demo:node-backend:typecheck` `npm run demo:node-backend:smoke` `npm run test:playwright:service-explorer`	`marker:examples/service-explorer/README.md:createHonuaControlPlane` `marker:examples/node-backend-quickstart/README.md:createHonuaControlPlane` `script:demo:node-backend:smoke`	Implemented documented control-plane handoff and backend smoke lane for hosted map/workspace/import/token/connection SDK usage. Live seeded-cloud acceptance remains tracked by #128.

Closure Rules

A primitive row is complete only when the listed demo lane contains code that exercises the primitive directly, not just adjacent existing behavior.
Interactive primitives need Playwright coverage unless the primitive is strictly non-browser. Non-browser primitives need an equivalent fixture or smoke command in the validation column.
Fixture-mode demos must stay deterministic and must not require live credentials. Live/staging variants may exist, but they cannot be the only proof for a primitive row.
New demo lanes must be added to npm run demo:examples:typecheck, npm run demo:examples:build, and the matrix before their primitive issue closes.
Every row must include proof markers in import:<file>:<module>, marker:<file>:<text>, or script:<package-script> form so npm run demo:primitive-matrix can fail stale or overstated coverage.
The final closure comment for #176 should paste or link this matrix with the implemented coverage status for each primitive.