@honua/mcp-server 0.1.14 → 0.1.15

package/certification/geospatial-mcp-schemas/tools/alert_events.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/alert_events.schema.json",
+  "title": "alert_events inputSchema",
+  "description": "Argument shape for the platform-operations alert-events query tool (advertised name honua_alert_events). Read-only, paged (cursor-based): queries the alert-event history surfaced through the honua-server Console Operate alert API. Alert events come from two sources — spatial/threshold GIS alert rules (gis) and operations notifications not linked to an alert rule (ops). Filter by source, severity, rule, operator lifecycle state, and time range. The response is a page of alert events; see alert_events.result.schema.json. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "source": {
+      "type": "string",
+      "description": "Filter by alert source: 'gis' for spatial/threshold alert-rule events, 'ops' for operations notifications not linked to an alert rule.",
+      "enum": ["gis", "ops"]
+    },
+    "severity": {
+      "type": "string",
+      "description": "Filter by normalized alert severity (lower-case).",
+      "enum": ["info", "warning", "critical"]
+    },
+    "rule": {
+      "type": "string",
+      "description": "Filter by source alert-rule identifier or name."
+    },
+    "lifecycleState": {
+      "type": "string",
+      "description": "Filter by operator lifecycle status.",
+      "enum": ["open", "acknowledged", "suppressed", "resolved"]
+    },
+    "from": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Inclusive lower bound (ISO-8601) on the event observation time."
+    },
+    "to": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Exclusive upper bound (ISO-8601) on the event observation time."
+    },
+    "pageSize": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Maximum number of events to return in one page. The surface applies a server-defined default and maximum; an over-maximum request is clamped, not rejected."
+    },
+    "cursor": {
+      "type": "string",
+      "description": "Opaque continuation token from a prior page's nextCursor; absent on the first page."
+    }
+  },
+  "additionalProperties": false
+}

package/certification/geospatial-mcp-schemas/tools/bind_component_context.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/bind_component_context.schema.json",
+  "title": "bind_component_context inputSchema",
+  "description": "Argument shape for bind_component_context (composition profile, ADR-0032). Sets or clears one component's exploration-context membership, addressed by the ADR-0030 `ref` grammar (map, layer:{id}, widget:{id}, control:{id}). Because cross-filtering is identity of explorationContextId rather than an event→action edge, linking N components into one shared-state workspace is N calls to this tool, not one call per component pair. Omitting explorationContextId clears the binding and leaves the component independent. Target addressing matches the other composition tools: a composition document (mapPackageId or appPackageId) at the standard level, with the reference implementation's draft-lifecycle spelling (draftId + generation) admitted as x-honua-reference-shape. Validation gate: ref must resolve within the document, explorationContextId must resolve against the document's explorationContexts block, and role must be a member of the closed role vocabulary. See docs/adr/0032-shared-exploration-contexts.md and common/exploration.schema.json. Supplying explorationContextId requires role; omitting both clears the binding.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "ref"
+  ],
+  "properties": {
+    "mapPackageId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target MapPackage composition document. Exactly one of mapPackageId / appPackageId / draftId identifies the target."
+    },
+    "appPackageId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target AppPackage composition document. Exactly one of mapPackageId / appPackageId / draftId identifies the target."
+    },
+    "draftId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "x-honua-reference-shape: reference-implementation draft-lifecycle target. Requires generation."
+    },
+    "generation": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "x-honua-reference-shape: optimistic-concurrency generation of the draft being mutated; the call fails on generation conflict."
+    },
+    "ref": {
+      "$ref": "../common/interactions.schema.json#/$defs/componentRef",
+      "description": "The component whose binding is being set or cleared, in the ADR-0030 reference grammar."
+    },
+    "explorationContextId": {
+      "$ref": "../common/exploration.schema.json#/$defs/componentBinding/properties/explorationContextId",
+      "description": "Context to bind the component to. Omit to clear the component's binding; a component belongs to at most one context, so binding replaces any previous membership."
+    },
+    "role": {
+      "$ref": "../common/exploration.schema.json#/$defs/componentBinding/properties/role",
+      "description": "Role the component plays in the context, which the preset's propagation policy is keyed on. Meaningful only when explorationContextId is present; implementations SHOULD reject a role given without a context rather than storing an inert value."
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "required": [
+          "explorationContextId"
+        ]
+      },
+      "then": {
+        "required": [
+          "role"
+        ]
+      },
+      "description": "A component that joins a context must declare its role. The mapDriven, gridDriven, and chartDriven presets key propagation on role, and no inference or default is specified — without it two conforming runtimes could disagree on whether the component contributes state."
+    }
+  ]
+}

package/certification/geospatial-mcp-schemas/tools/bind_interaction.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/bind_interaction.schema.json",
+  "title": "bind_interaction inputSchema",
+  "description": "Argument shape for bind_interaction (composition profile, ADR-0030). Adds or replaces (by interaction id) one declarative event→action binding in a composition document. The standard-level target is a composition document (mapPackageId or appPackageId). The reference implementation authors compositions through a draft lifecycle; its optimistic-concurrency draft spelling (draftId + generation) is admitted as x-honua-reference-shape, consistent with ADR-0029's admission of reference spellings. Validation gate: the interaction's on.ref and do.ref must resolve to components declared in the target document, and the per-(on.ref, on.event) fan-out cap applies (recommended 8). See docs/adr/0030-declarative-interactions-and-layout.md and common/interactions.schema.json. Exactly one target must be supplied: mapPackageId, appPackageId, or the x-honua-reference-shape draftId (which requires generation). The oneOf below enforces that; without it a call with no target, with both package ids, or with draftId and no generation validated against a contract no server can route.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "interaction"
+  ],
+  "properties": {
+    "mapPackageId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target MapPackage composition document. Exactly one of mapPackageId / appPackageId / draftId identifies the target."
+    },
+    "appPackageId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target AppPackage composition document. Exactly one of mapPackageId / appPackageId / draftId identifies the target."
+    },
+    "draftId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "x-honua-reference-shape: reference-implementation draft-lifecycle target. Requires generation."
+    },
+    "generation": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "x-honua-reference-shape: optimistic-concurrency generation of the draft being mutated; the call fails on generation conflict."
+    },
+    "interaction": {
+      "$ref": "../common/interactions.schema.json#/$defs/interaction",
+      "description": "The binding to add or replace. Replacement matches on interaction.id."
+    }
+  },
+  "oneOf": [
+    {
+      "required": [
+        "mapPackageId"
+      ],
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "appPackageId"
+            ]
+          },
+          {
+            "required": [
+              "draftId"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "required": [
+        "appPackageId"
+      ],
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "mapPackageId"
+            ]
+          },
+          {
+            "required": [
+              "draftId"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "required": [
+        "draftId",
+        "generation"
+      ],
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "mapPackageId"
+            ]
+          },
+          {
+            "required": [
+              "appPackageId"
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}

package/certification/geospatial-mcp-schemas/tools/create_exploration_context.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/create_exploration_context.schema.json",
+  "title": "create_exploration_context inputSchema",
+  "description": "Argument shape for create_exploration_context (composition profile, ADR-0032). Adds or replaces (by context id) one exploration context in a composition document's `explorationContexts` collection. An exploration context is a named unit of shared interaction state that components join by id; changing a context's preset is expressed as replacing it by id, so there is no separate preset tool. The standard-level target is a composition document (mapPackageId or appPackageId); the reference implementation's optimistic-concurrency draft spelling (draftId + generation) is admitted as x-honua-reference-shape, consistent with ADR-0030's bind_interaction and ADR-0031's add_control. Validation gate: context.id must be unique within the document, every context.sourceIds entry must resolve to a source declared in the target document, and context.preset must be a member of the closed preset vocabulary. See docs/adr/0032-shared-exploration-contexts.md and common/exploration.schema.json.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["explorationContext"],
+  "properties": {
+    "mapPackageId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target MapPackage composition document. Exactly one of mapPackageId / appPackageId / draftId identifies the target."
+    },
+    "appPackageId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target AppPackage composition document. Exactly one of mapPackageId / appPackageId / draftId identifies the target."
+    },
+    "draftId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "x-honua-reference-shape: reference-implementation draft-lifecycle target. Requires generation."
+    },
+    "generation": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "x-honua-reference-shape: optimistic-concurrency generation of the draft being mutated; the call fails on generation conflict."
+    },
+    "explorationContext": {
+      "$ref": "../common/exploration.schema.json#/$defs/explorationContext",
+      "description": "The exploration context to add or replace. Replacement matches on explorationContext.id and preserves existing component bindings to that id, so re-authoring a context's preset does not unbind its components."
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/deploy_operations.result.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/deploy_operations.result.schema.json",
+  "title": "deploy_operations result payload",
+  "description": "Response payload for the deploy_operations tool: the paged deploy-operations envelope copied VERBATIM from the wire contract pinned in honua-server#2562 / PR #2577 (GET /api/v1/admin/deploy/operations). camelCase; null-valued properties are OMITTED (DefaultIgnoreCondition = WhenWritingNull), so a missing key means null. items is DeployOperationResponse[], newest-first by createdAt. warnings / blockingReasons / target.parameters / metadataRelease.jobIds|evidenceRefs|blockers|warnings are always present (possibly empty). x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["items", "page", "pageSize", "totalCount", "hasMore"],
+  "properties": {
+    "items": {
+      "type": "array",
+      "description": "DeployOperationResponse[], newest-first by createdAt.",
+      "items": { "$ref": "#/$defs/deployOperation" }
+    },
+    "page": { "type": "integer", "description": "Effective 1-based page." },
+    "pageSize": { "type": "integer", "description": "Effective (clamped) page size." },
+    "totalCount": { "type": "integer", "description": "Match count within the materialized window." },
+    "hasMore": { "type": "boolean", "description": "At least one more page exists." }
+  },
+  "$defs": {
+    "deployOperation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operationId", "kind", "status", "priority", "warnings", "blockingReasons", "createdAt", "updatedAt"],
+      "properties": {
+        "operationId": { "type": "string" },
+        "kind": { "type": "string", "description": "WorkflowOperationKind enum name, e.g. \"Deploy\"." },
+        "status": { "type": "string", "description": "WorkflowOperationStatus enum name, e.g. \"Submitted\"." },
+        "priority": { "type": "string", "description": "Priority enum name, e.g. \"Normal\"." },
+        "target": { "$ref": "#/$defs/target" },
+        "metadataRelease": { "$ref": "#/$defs/metadataRelease" },
+        "providerOperationId": { "type": "string" },
+        "currentPhase": { "type": "string" },
+        "observedState": { "type": "string" },
+        "errorMessage": { "type": "string" },
+        "warnings": { "type": "array", "items": { "type": "string" } },
+        "blockingReasons": { "type": "array", "items": { "type": "string" } },
+        "requestedBy": { "type": "string" },
+        "reason": { "type": "string" },
+        "correlationId": { "type": "string" },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "completedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["targetId", "targetKind", "backend", "environment", "targetName", "desiredRevision", "parameters"],
+      "properties": {
+        "targetId": { "type": "string" },
+        "targetKind": { "type": "string", "description": "Enum name." },
+        "backend": { "type": "string" },
+        "environment": { "type": "string" },
+        "targetName": { "type": "string" },
+        "artifactReference": { "type": "string" },
+        "runtimeProfile": { "type": "string" },
+        "currentRevision": { "type": "string" },
+        "desiredRevision": { "type": "string" },
+        "parameters": { "type": "object", "additionalProperties": { "type": "string" } }
+      }
+    },
+    "metadataRelease": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["packageId", "desiredRevision", "targetEnvironment", "jobIds", "evidenceRefs", "currentStage", "blockers", "warnings"],
+      "properties": {
+        "packageId": { "type": "string" },
+        "gitOperationId": { "type": "string" },
+        "prUrl": { "type": "string" },
+        "commitSha": { "type": "string" },
+        "desiredRevision": { "type": "string" },
+        "targetEnvironment": { "type": "string" },
+        "deployOperationId": { "type": "string" },
+        "jobIds": { "type": "array", "items": { "type": "string" } },
+        "evidenceRefs": { "type": "array", "items": { "$ref": "#/$defs/evidenceRef" } },
+        "currentStage": { "type": "string", "description": "Enum name." },
+        "rollbackPlan": { "$ref": "#/$defs/rollbackPlan" },
+        "blockers": { "type": "array", "items": { "type": "string" } },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "evidenceRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "refId", "at"],
+      "properties": {
+        "kind": { "type": "string" },
+        "refId": { "type": "string" },
+        "uri": { "type": "string" },
+        "at": { "type": "string", "format": "date-time" }
+      }
+    },
+    "rollbackPlan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["class", "isDataAffecting", "requiresExplicitApproval", "steps", "evidenceRequired"],
+      "properties": {
+        "class": { "type": "string", "description": "Enum name." },
+        "isDataAffecting": { "type": "boolean" },
+        "requiresExplicitApproval": { "type": "boolean" },
+        "steps": { "type": "array", "items": { "type": "string" } },
+        "evidenceRequired": { "type": "array", "items": { "type": "string" } },
+        "approvalPolicyRef": { "type": "string" }
+      }
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/deploy_operations.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/deploy_operations.schema.json",
+  "title": "deploy_operations inputSchema",
+  "description": "Argument shape for the deploy-operations tool (advertised name honua_deploy_operations). Read-only over the platform_release / server_upgrade operation workflow (mirror of GET /api/v1/admin/deploy/operations, whose wire contract is pinned by honua-server#2562 / PR #2577). Two modes: omit operationId to LIST deploy operations (newest-first by createdAt, paged) filtered by status and kind; provide operationId to GET a single operation. Uses platform_release / server_upgrade vocabulary — this is the platform-upgrade operation surface, distinct from the hosted-content honua://deployments/{deployment_id} resource. The response is a paged envelope of DeployOperationResponse items copied verbatim from the pinned contract; see deploy_operations.result.schema.json. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "operationId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Deploy-operation identifier to fetch a single operation (get mode). When omitted, the tool lists deploy operations (list mode)."
+    },
+    "status": {
+      "type": "string",
+      "description": "List-mode filter: WorkflowOperationStatus name (case-insensitive).",
+      "enum": [
+        "Planned",
+        "AwaitingApproval",
+        "Submitted",
+        "Reconciling",
+        "Succeeded",
+        "Failed",
+        "RollbackRequested",
+        "RolledBack",
+        "ManualInterventionRequired"
+      ]
+    },
+    "kind": {
+      "type": "string",
+      "description": "List-mode filter: WorkflowOperationKind name (case-insensitive).",
+      "enum": ["Deploy", "Rollback", "Migration", "MetadataRelease", "CoordinatedRelease"]
+    },
+    "page": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 1,
+      "description": "List-mode 1-based page number (default 1, must be >= 1)."
+    },
+    "pageSize": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 200,
+      "default": 50,
+      "description": "List-mode page size (default 50, clamped server-side to 1..200)."
+    }
+  },
+  "additionalProperties": false
+}

package/certification/geospatial-mcp-schemas/tools/operate_events.result.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/operate_events.result.schema.json",
+  "title": "operate_events result payload",
+  "description": "Response payload for the operate_events tool: a page of normalized events off the unified Operate timeline, mirroring the honua-server wire shape (OperateEventPageResponse / OperateEventResponse). items are newest-first; partialResult is true when at least one source produced a partial result, with per-source diagnostics in sourceErrors (keyed by lower-case kind). x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["items"],
+  "properties": {
+    "items": {
+      "type": "array",
+      "description": "Normalized events in this page (newest first).",
+      "items": { "$ref": "#/$defs/operateEvent" }
+    },
+    "partialResult": {
+      "type": "boolean",
+      "description": "True when at least one source produced a partial result."
+    },
+    "sourceErrors": {
+      "type": "object",
+      "description": "Per-source diagnostic messages keyed by lower-case kind.",
+      "additionalProperties": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "operateEvent": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["eventId", "kind", "severity", "occurredAt", "title"],
+      "properties": {
+        "eventId": { "type": "string", "description": "Source-prefixed event id, e.g. \"alert:42\"." },
+        "kind": { "type": "string", "enum": ["alert", "audit", "job", "release", "syncConflict", "temporalOp", "log"] },
+        "severity": { "type": "string", "enum": ["info", "notice", "warning", "error", "critical"] },
+        "occurredAt": { "type": "string", "format": "date-time" },
+        "title": { "type": "string" },
+        "summary": { "type": "string" },
+        "serviceId": { "type": "string" },
+        "layerId": { "type": "integer" },
+        "objectId": { "type": "integer" },
+        "actor": { "type": "string" },
+        "correlationId": { "type": "string" },
+        "traceId": { "type": "string" },
+        "requestId": { "type": "string" },
+        "operationId": { "type": "string" },
+        "releaseId": { "type": "string", "description": "Release id when tied to a platform_release / deploy release." },
+        "replicaId": { "type": "string" },
+        "changeSetId": { "type": "string" },
+        "resourceRef": { "type": "string" },
+        "providerLinks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["provider", "label", "url"],
+            "properties": {
+              "provider": { "type": "string" },
+              "label": { "type": "string" },
+              "url": { "type": "string" }
+            }
+          }
+        },
+        "detailsJson": { "type": "string", "description": "Source-specific structured payload as JSON text." }
+      }
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/operate_events.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/operate_events.schema.json",
+  "title": "operate_events inputSchema",
+  "description": "Argument shape for the platform-operations fused-timeline tool (advertised name honua_operate_events). Read-only, paged: queries the unified Operate event timeline (mirror of GET /api/v1/admin/observability/events), which fuses alert, audit, job, release, sync-conflict, temporal, and log events into one normalized stream. Filter by event kind, correlation id, operation id, release id, and time range to trace a platform_release / server_upgrade or a long-running operation across sources. The response is a page of normalized events; see operate_events.result.schema.json. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "kind": {
+      "type": "array",
+      "description": "Filter to one or more event categories (camelCase wire names).",
+      "items": {
+        "type": "string",
+        "enum": ["alert", "audit", "job", "release", "syncConflict", "temporalOp", "log"]
+      }
+    },
+    "correlationId": {
+      "type": "string",
+      "description": "Filter to events carrying this cross-cutting correlation id (typically the request X-Correlation-ID)."
+    },
+    "operationId": {
+      "type": "string",
+      "description": "Filter to events tied to this operation/job id."
+    },
+    "releaseId": {
+      "type": "string",
+      "description": "Filter to events tied to this platform_release / deploy release id (a Deploy operation's desiredRevision, or a metadata release's packageId)."
+    },
+    "from": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Inclusive lower bound (ISO-8601) on the event occurrence time."
+    },
+    "to": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Exclusive upper bound (ISO-8601) on the event occurrence time."
+    },
+    "pageSize": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Maximum number of events to return in one page. The surface applies a server-defined default and maximum; an over-maximum request is clamped, not rejected."
+    }
+  },
+  "additionalProperties": false
+}

package/certification/geospatial-mcp-schemas/tools/ops_findings.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/ops_findings.schema.json",
+  "title": "ops_findings inputSchema",
+  "description": "Argument shape for the platform-operations findings tool (advertised name honua_ops_findings). Read-only over the deterministic ops findings surface (mirror of GET /api/v1/admin/observability/findings). Two modes: omit findingId to LIST the active findings (server-ordered by descending severity), optionally narrowed by severity and rule; provide findingId to GET a single finding by its deterministic identifier. Each finding carries a recommendedAction {kind, summary, reason} and evidence references; the action is proposed (never executed) by finding id through the operation gateway, consistent with the honua-server ADR-0028 no-direct-AI-mutation posture. The response payload is the honua://ops/findings resource projection (see resources/ops-findings.schema.json). x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "findingId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Deterministic finding identifier to fetch a single finding (get mode). When omitted, the tool lists active findings (list mode)."
+    },
+    "severity": {
+      "type": "string",
+      "description": "Optional list-mode filter: return only findings at this severity.",
+      "enum": ["Info", "Warning", "Critical"]
+    },
+    "rule": {
+      "type": "string",
+      "description": "Optional list-mode filter: return only findings produced by this kebab-case rule identifier."
+    }
+  },
+  "additionalProperties": false
+}

package/certification/geospatial-mcp-schemas/tools/ops_health.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/ops_health.schema.json",
+  "title": "ops_health inputSchema",
+  "description": "Argument shape for the platform-operations health tool (advertised name honua_ops_health). Read-only: returns a single consolidated operational-health snapshot mirroring the honua-server admin endpoint GET /api/v1/admin/observability/ops-health (health-check roll-up, serving latency, geoprocessing queue depth, alert-dispatch backlog, coordinated-deploy readiness + platform-release skew, database/cache utilization). Takes no arguments. The response payload is the honua://ops/health resource projection (see resources/ops-health.schema.json). x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/certification/geospatial-mcp-schemas/tools/platform_release_status.result.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/platform_release_status.result.schema.json",
+  "title": "platform_release_status result payload",
+  "description": "Response payload for the platform_release_status tool: the declared platform_release / server_upgrade co-versioning + skew snapshot, mirroring the honua-server platformRelease projection (DeployPreflightPlatformRelease). Reports the declared release version, whether all planes are co-versioned, the per-plane serving/execution projections, and the identifiers of planes skewed from the declared release. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["releaseDeclared", "isCoVersioned", "serving", "execution", "skewedIds"],
+  "properties": {
+    "releaseVersion": {
+      "type": "string",
+      "description": "Declared platform release version, or absent/null when no release is configured."
+    },
+    "releaseDeclared": {
+      "type": "boolean",
+      "description": "Whether a platform release is declared."
+    },
+    "isCoVersioned": {
+      "type": "boolean",
+      "description": "Whether all planes are co-versioned with the declared release."
+    },
+    "serving": {
+      "type": "array",
+      "description": "Per-plane serving projections.",
+      "items": { "$ref": "#/$defs/plane" }
+    },
+    "execution": {
+      "type": "array",
+      "description": "Per-plane execution projections.",
+      "items": { "$ref": "#/$defs/plane" }
+    },
+    "skewedIds": {
+      "type": "array",
+      "description": "Identifiers of planes skewed from the declared release.",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "plane": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "projectedFromRelease", "skewed"],
+      "properties": {
+        "id": { "type": "string" },
+        "runtimeProfile": { "type": "string" },
+        "effectiveArtifactReference": { "type": "string" },
+        "projectedFromRelease": { "type": "boolean" },
+        "skewed": { "type": "boolean" }
+      }
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/platform_release_status.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/platform_release_status.schema.json",
+  "title": "platform_release_status inputSchema",
+  "description": "Argument shape for the platform-release status tool (advertised name honua_platform_release_status). Read-only: returns the declared platform_release / server_upgrade co-versioning snapshot (mirror of the platformRelease projection on the honua-server coordinated-deploy preflight) — the declared release version, whether all planes are co-versioned with it, the per-plane serving/execution projections, and the identifiers of any planes skewed from the declared release. Takes no arguments. Uses platform_release / server_upgrade vocabulary; this is distinct from the hosted-content honua://deployments/{deployment_id} resource. The response is the release-status snapshot; see platform_release_status.result.schema.json. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}