@honua/mcp-server 0.0.10-alpha.0 → 0.1.0-beta.0

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

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/geocode_address.schema.json",
+  "title": "geocode_address inputSchema",
+  "description": "Argument shape for the analysis/geoprocessing geocode tool (advertised name honua_geocode_address). Resolves a freeform address to ranked candidates. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["address"],
+  "properties": {
+    "address": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Freeform single-line address text to geocode."
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 5,
+      "description": "Maximum number of candidates to return."
+    },
+    "countryCodes": {
+      "type": "string",
+      "description": "Optional comma-separated ISO 3166 country codes to restrict the search."
+    },
+    "outSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Spatial reference (SRID/WKID) for returned candidate coordinates."
+    },
+    "provider": {
+      "type": "string",
+      "description": "Optional preferred geocoding provider name."
+    }
+  }
+}

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

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/geocode_addresses.schema.json",
+  "title": "geocode_addresses inputSchema",
+  "description": "Argument shape for the analysis/geoprocessing batch geocode tool (advertised name honua_geocode_addresses). Resolves up to 100 freeform addresses in one call, returning one result per input in input order ({input, ok, location?, score?, error?}); a failed address surfaces per item without failing the batch. First step of the CSV-of-addresses workflow: geocode here, then load the coordinates with ingest_dataset and publish the table with publish_service. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["addresses"],
+  "properties": {
+    "addresses": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 100,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Freeform single-line addresses to geocode, in the order results should be returned."
+    },
+    "countryCodes": {
+      "type": "string",
+      "description": "Optional comma-separated ISO 3166 country codes to restrict the search."
+    },
+    "outSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Spatial reference (SRID/WKID) for returned coordinates (x=longitude, y=latitude order). Defaults to 4326 (WGS84 lon/lat)."
+    },
+    "provider": {
+      "type": "string",
+      "description": "Optional preferred geocoding provider name."
+    }
+  }
+}

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

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/get_style.schema.json",
+  "title": "get_style inputSchema",
+  "description": "Argument shape for get_style (Analyze, Publish Data, Build App). Read-only style inspection: with styleId, resolves a single canonical StyleRef (style_id/title/encodings) from the server OGC API – Styles surface; with serviceId+layerId (a reference-implementation convenience) resolves the primary/default StyleRef bound to that published layer; with none of these, lists the available styles (honua://styles). Like every MCP tool it is read-only and never mutates server-side styles. See taxonomy.md §Style inspection and resources.md §honua://styles.",
+  "type": "object",
+  "properties": {
+    "styleId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "StyleRef identifier (style_…) to resolve. When omitted, the tool resolves the styleId bound to serviceId+layerId, or lists the available styles (honua://styles) when neither is given."
+    },
+    "serviceId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Reference-implementation shape (honua_get_style): published service identifier or name. Paired with layerId, resolves that layer's primary/default StyleRef when styleId is omitted."
+    },
+    "layerId": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Reference-implementation shape (honua_get_style): service-local layer index. Paired with serviceId, resolves that layer's primary/default StyleRef when styleId is omitted."
+    },
+    "encoding": {
+      "type": "string",
+      "description": "Optional StyleEncoding to select from StyleRef.encodings when resolving a single style.",
+      "enum": [
+        "mapbox-style",
+        "sld-1.0.0",
+        "sld-1.1.0",
+        "esri-drawing-info",
+        "esri-image-renderer",
+        "3d-tiles-styling"
+      ]
+    },
+    "includeStylesheet": {
+      "type": "boolean",
+      "description": "When true and a single style resolves, include the resolved stylesheet body (inlineBody) for the selected encoding; otherwise the StyleRef projection advertises derived encodings by reference (storageRef)."
+    }
+  }
+}

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

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/ground_candidates.schema.json",
+  "title": "ground_candidates inputSchema",
+  "description": "Argument shape for the ground_candidates tool (Analyze, Publish Data). Reference advertised name: honua_ground_candidates. Grounds a natural-language goal to a workflow family, ranked candidates, a draft intent, and an optional clarification envelope. See taxonomy.md §Intent and planning and planning.md §2.",
+  "type": "object",
+  "required": ["goal"],
+  "properties": {
+    "goal": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Freeform natural-language description of the operator's goal."
+    },
+    "intentId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Intent identifier. Optional on the initial grounding call (server allocates one); required on a clarification turn."
+    },
+    "workflowFamilyHint": {
+      "type": "string",
+      "description": "Optional workflow-family override (one of the canonical WorkflowFamily names).",
+      "enum": ["Analyze", "PublishData", "BuildApp", "AutomateDeploy"]
+    },
+    "assumptionPolicy": {
+      "type": "string",
+      "description": "Policy controlling when inferred assumptions trigger a clarification. See planning.md §2.3.",
+      "enum": ["AskAlways", "AskWhenMaterial", "UseDefaults"]
+    },
+    "explicitInputs": {
+      "type": "array",
+      "description": "Dataset, layer, or artifact identifiers the caller has already pinned.",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "constraints": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional analysis constraints.",
+      "properties": {
+        "areaOfInterest": {
+          "type": "string",
+          "description": "AOI as WKT, bounding-box string, or named area."
+        },
+        "spatialReferenceId": {
+          "type": "integer",
+          "description": "EPSG SRID for the AOI (defaults to 4326)."
+        },
+        "timeWindowStart": { "type": "string", "format": "date-time" },
+        "timeWindowEnd": { "type": "string", "format": "date-time" },
+        "units": {
+          "type": "string",
+          "description": "Preferred unit system (e.g. 'meters', 'feet')."
+        }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional workflow context.",
+      "properties": {
+        "workspaceId": { "type": "string" },
+        "priorIntentId": { "type": "string" },
+        "promotionScope": { "type": "string" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/ingest_dataset.schema.json",
+  "title": "ingest_dataset inputSchema",
+  "description": "Argument shape for the Publish Data ingest tool (advertised name honua_ingest_dataset). Loads a small inline dataset (CSV with a header row, or a GeoJSON FeatureCollection; 4 MB cap) into the reference implementation's catalog database as a table, returning the {connectionId, schema, table} triple plus row count and per-row errors so the result chains directly into publish_service. CSV point geometry comes from longitude/latitude columns (auto-detected or explicit), a WKT column, or a server-geocoded address column; coordinate order is lon/lat and the CRS defaults to EPSG:4326. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["format", "data", "datasetName"],
+  "properties": {
+    "format": {
+      "type": "string",
+      "enum": ["csv", "geojson"],
+      "description": "Inline data format: \"csv\" (text with a header row) or \"geojson\" (a GeoJSON FeatureCollection document)."
+    },
+    "data": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The dataset content, inline. Capped at 4 MB; larger datasets use the implementation's out-of-band upload surface."
+    },
+    "datasetName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 63,
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+      "description": "Target dataset/table name (letters, digits, underscores; must not start with a digit)."
+    },
+    "sourceSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Spatial reference (SRID/WKID) of the input coordinates; data is stored in EPSG:4326. Defaults to 4326 (WGS84 lon/lat)."
+    },
+    "longitudeColumn": {
+      "type": "string",
+      "description": "CSV only: explicit longitude (X) column name. Pair with latitudeColumn. When omitted, lon/lng/long/longitude/x is auto-detected."
+    },
+    "latitudeColumn": {
+      "type": "string",
+      "description": "CSV only: explicit latitude (Y) column name. Pair with longitudeColumn. When omitted, lat/latitude/y is auto-detected."
+    },
+    "addressColumn": {
+      "type": "string",
+      "description": "CSV only: column holding freeform addresses to geocode into point geometry server-side (up to 100 rows). Mutually exclusive with longitudeColumn/latitudeColumn."
+    }
+  }
+}

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

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/join_features.schema.json",
+  "title": "join_features inputSchema",
+  "description": "Direct geoprocessing verb (advertised name honua_join_features): join a second dataset onto a target dataset — either an attribute join on matching key fields or a spatial join by geometric relationship — and return the joined features. Use this for a single self-contained join step (\"attach the demographics table to the tracts\", \"tag each incident with the county it falls in\"); for multi-step analysis with dependencies and a packaged result, use plan_analysis + execute_plan instead. Member of the standard's opt-in **analysis** conformance profile (see /CONFORMANCE.md and docs/adr/0029-direct-geoprocessing-verbs.md). Long-running calls return an ExecutionJob handle (honua://jobs/{job_id}), pollable and cancelable via cancel_job; small/fast calls may return an inline result. Advertised readOnlyHint: true (computes a derived result; mutates no server state). x-honua-reference-shape: the concrete source (serviceId/layerId, artifactId) spellings track the reference pipeline.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["target", "join", "joinType"],
+  "properties": {
+    "target": {
+      "description": "Target (left) dataset whose features are kept and enriched: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId).",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "join": {
+      "description": "Join (right) dataset supplying attributes to append: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId).",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "joinType": {
+      "type": "string",
+      "enum": ["attribute", "spatial"],
+      "description": "attribute: match on equal key fields (targetField = joinField). spatial: match by geometric relationship (spatialRelationship)."
+    },
+    "targetField": {
+      "type": "string",
+      "description": "Attribute join only: key field on the target dataset. Required when joinType is attribute."
+    },
+    "joinField": {
+      "type": "string",
+      "description": "Attribute join only: key field on the join dataset matched against targetField. Required when joinType is attribute."
+    },
+    "spatialRelationship": {
+      "type": "string",
+      "enum": ["intersects", "contains", "within", "nearest"],
+      "description": "Spatial join only: geometric predicate relating a target feature to join features. Required when joinType is spatial."
+    },
+    "joinOperation": {
+      "type": "string",
+      "default": "one_to_one",
+      "enum": ["one_to_one", "one_to_many"],
+      "description": "one_to_one: one output row per target feature (matches aggregated per joinAggregation on conflict). one_to_many: one output row per matching pair."
+    },
+    "joinAggregation": {
+      "type": "string",
+      "enum": ["first", "count", "sum", "min", "max", "mean"],
+      "description": "one_to_one only: how to reduce multiple matches for a target feature. Defaults to an implementation-defined first-match when omitted."
+    }
+  },
+  "$defs": {
+    "layerRef": {
+      "type": "object",
+      "required": ["serviceId", "layerId"],
+      "additionalProperties": false,
+      "properties": {
+        "serviceId": { "type": "string", "minLength": 1, "description": "Published service identifier or name (from list_layers.serviceId or resolve_entity)." },
+        "layerId": { "type": "integer", "minimum": 0, "description": "Service-local layer index (from list_layers.layerId)." }
+      }
+    },
+    "artifactRef": {
+      "type": "object",
+      "required": ["artifactId"],
+      "additionalProperties": false,
+      "properties": {
+        "artifactId": { "type": "string", "minLength": 1, "description": "Identifier (artifact_…) of a prior-result ArtifactRef produced by an earlier analysis job or verb. See resources/artifact.schema.json." }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/list_capabilities.schema.json",
+  "title": "list_capabilities inputSchema",
+  "description": "Argument shape for enumerating the server's full tool/resource surface plus grounding resources for a cold client LLM. The bare standard taxonomy models capability discovery as a CapabilityCatalog read; the reference implementation exposes it as a discrete tool (advertised name honua_list_capabilities). x-honua-extension: this is a documented Honua extension over the bare taxonomy, pending formalization in the geospatial-mcp standard. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-extension": true,
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "includeResources": {
+      "type": "boolean",
+      "default": true,
+      "description": "Include the resource catalog (job, catalog, and promotion URIs) in the manifest."
+    },
+    "includeGroundingResources": {
+      "type": "boolean",
+      "default": true,
+      "description": "Include the grounding/catalog resource URIs a client LLM should read first to ground a workflow."
+    }
+  }
+}

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

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/list_layers.schema.json",
+  "title": "list_layers inputSchema",
+  "description": "Argument shape for the discovery/query layer-listing tool. The bare standard taxonomy models discovery as a CapabilityCatalog read; the reference implementation exposes it as a tool (advertised name honua_list_layers) over the open-core data-access surface. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "filter": {
+      "type": "string",
+      "description": "Optional case-insensitive substring to match against service and layer name/title. When omitted, all published layers are returned."
+    }
+  }
+}

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

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/overlay_features.schema.json",
+  "title": "overlay_features inputSchema",
+  "description": "Direct geoprocessing verb (advertised name honua_overlay_features): compute a two-input topological overlay (intersect, union, difference, erase, or clip) and return the result features. Use this for a single self-contained overlay step (\"intersect the flood zones with the parcels\"); for multi-step analysis with dependencies and a packaged result, use plan_analysis + execute_plan instead. Member of the standard's opt-in **analysis** conformance profile (see /CONFORMANCE.md and docs/adr/0029-direct-geoprocessing-verbs.md). Long-running calls return an ExecutionJob handle (honua://jobs/{job_id}), pollable and cancelable via cancel_job; small/fast calls may return an inline result. Advertised readOnlyHint: true (computes a derived result; mutates no server state). x-honua-reference-shape: the concrete source (serviceId/layerId, artifactId) spellings track the reference pipeline.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["source", "overlay", "operation"],
+  "properties": {
+    "source": {
+      "description": "Primary input dataset: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId).",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "overlay": {
+      "description": "Overlay dataset combined with source: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId).",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "operation": {
+      "type": "string",
+      "enum": ["intersect", "union", "difference", "erase", "clip"],
+      "description": "Overlay operation. intersect: geometry AND attributes of both where they overlap. union: full combination of both inputs. difference: source minus overlay (source attributes kept). erase: remove the overlay area from source. clip: cut source to the overlay boundary (source attributes only)."
+    },
+    "outSrid": {
+      "type": "integer",
+      "description": "Output spatial reference (SRID/WKID) for the returned overlay features; defaults to the source CRS."
+    }
+  },
+  "$defs": {
+    "layerRef": {
+      "type": "object",
+      "required": ["serviceId", "layerId"],
+      "additionalProperties": false,
+      "properties": {
+        "serviceId": { "type": "string", "minLength": 1, "description": "Published service identifier or name (from list_layers.serviceId or resolve_entity)." },
+        "layerId": { "type": "integer", "minimum": 0, "description": "Service-local layer index (from list_layers.layerId)." }
+      }
+    },
+    "artifactRef": {
+      "type": "object",
+      "required": ["artifactId"],
+      "additionalProperties": false,
+      "properties": {
+        "artifactId": { "type": "string", "minLength": 1, "description": "Identifier (artifact_…) of a prior-result ArtifactRef produced by an earlier analysis job or verb. See resources/artifact.schema.json." }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/plan_analysis.schema.json",
+  "title": "plan_analysis inputSchema",
+  "description": "Argument shape for the plan_analysis tool (Analyze family; emits an AnalysisPlan). Reference advertised name: honua_plan_analysis. Compiles a natural-language intent into an analysis plan / canonical spec draft. See taxonomy.md §Intent and planning.",
+  "type": "object",
+  "required": ["intent"],
+  "properties": {
+    "intent": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Natural-language intent to compile into an analysis plan or canonical spec draft."
+    },
+    "context": {
+      "type": "object",
+      "description": "Optional caller context. Echoed back unchanged by the reference implementation."
+    }
+  }
+}

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

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/preview_app_package.schema.json",
+  "title": "preview_app_package inputSchema",
+  "description": "Argument shape for preview_app_package (Build App; returns a preview ArtifactRef). Produces a read-only preview artifact for an existing app package. Responsibility-level. See taxonomy.md §App composition.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["appPackageId"],
+  "properties": {
+    "appPackageId": {
+      "type": "string",
+      "description": "Identifier (app_…) of the AppPackage to preview."
+    }
+  }
+}

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

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/preview_map_package.schema.json",
+  "title": "preview_map_package inputSchema",
+  "description": "Argument shape for preview_map_package (Analyze, Build App; returns a preview ArtifactRef). Produces a read-only preview artifact for an existing map package. Responsibility-level. See taxonomy.md §Map composition.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["mapPackageId"],
+  "properties": {
+    "mapPackageId": {
+      "type": "string",
+      "description": "Identifier (map_…) of the MapPackage to preview."
+    },
+    "width": { "type": "integer", "minimum": 1 },
+    "height": { "type": "integer", "minimum": 1 }
+  }
+}

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

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/preview_package.schema.json",
+  "title": "preview_package inputSchema",
+  "description": "Argument shape for the read-only composition-review tool (advertised name honua_preview_package). Computes a read-only preview plan for a map/app package before publishing, in addition to the requirement-coverage review; it never mutates server state. x-honua-reference-shape: tracks the reference implementation; the bare taxonomy models package preview as a CapabilityCatalog + resource read.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "description": "Package-review contract version. Current value is honua.package_review.v1."
+    },
+    "packageFamily": {
+      "type": "string",
+      "description": "Supported values are query, analysis_plan, map_package, dashboard_report, form, app_package, workflow, gp, and etl. Missing or unknown values are returned as canonical missing_package_family or unsupported_package_family findings rather than rejected by the schema."
+    },
+    "packageId": { "type": "string" },
+    "requestedAction": { "type": "string" },
+    "format": { "type": "string" },
+    "packagePayload": {
+      "type": ["object", "array", "string", "number", "boolean", "null"],
+      "description": "Opaque package payload inspected only by the matching package-family adapter."
+    },
+    "requirements": {
+      "type": ["object", "null"],
+      "description": "Shared data binding, permission, schema, CRS, capability, dependency, and approval requirements. An explicit null is normalized to an empty requirement set."
+    },
+    "estimate": {
+      "type": "object",
+      "description": "Optional upstream estimate echoed in the shared package-review response."
+    },
+    "includePreviewPlan": { "type": "boolean" },
+    "includePassFindings": { "type": "boolean" },
+    "resourceRefs": {
+      "type": ["object", "null"],
+      "additionalProperties": { "type": "string" },
+      "description": "Safe caller-visible resource references. An explicit null is normalized to an empty map."
+    }
+  }
+}

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

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/propose_operation.schema.json",
+  "title": "propose_operation inputSchema",
+  "description": "Argument shape for the control-plane proposal tool (advertised name honua_propose_operation). Proposes an in-scope mutating control-plane operation for human approval (never autonomously executed), consistent with the ADR-0028 no-direct-AI-mutation boundary in taxonomy.md §Non-Goals. x-honua-reference-shape: tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["kind"],
+  "properties": {
+    "kind": {
+      "type": "string",
+      "description": "In-scope mutating control-plane operation class to propose.",
+      "enum": ["AdminConfigChange", "Deploy", "MetadataRelease", "Seed"]
+    },
+    "reason": {
+      "type": "string",
+      "description": "Operator-facing reason or change note for the proposal."
+    },
+    "executionPayload": {
+      "type": "string",
+      "description": "Opaque, class-specific JSON execution payload replayed when the proposal is approved."
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "description": "Stable idempotency key for the underlying operation."
+    }
+  }
+}

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

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/publish_result.schema.json",
+  "title": "publish_result inputSchema",
+  "description": "Argument shape for publish_result (Analyze, Publish Data, Build App). Promotes a result/package to a canonical promotion-surface target: PublishedService for Analyze and Publish Data, Deployment for Build App (resources.md §Promotion-Surface Resources). Publish/PolicyBoundary clarifications fire before handoff (planning.md). Responsibility-level: concrete promotion field set finalizes upstream (honua-server#730/#732).",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["sourceId"],
+  "properties": {
+    "sourceId": {
+      "type": "string",
+      "description": "Identifier of the package or result being promoted (result_…, map_…, app_…)."
+    },
+    "targetKind": {
+      "type": "string",
+      "description": "Promotion-surface target family. published_service for Analyze and Publish Data; deployment for Build App.",
+      "enum": ["published_service", "deployment"]
+    },
+    "visibility": {
+      "type": "string",
+      "description": "Promotion visibility scope.",
+      "enum": ["workspace_shared", "public"]
+    },
+    "routePrefix": {
+      "type": "string",
+      "description": "Optional route prefix for a deployment target."
+    }
+  }
+}

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

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/publish_service.schema.json",
+  "title": "publish_service inputSchema",
+  "description": "Argument shape for the lifecycle service-publish tool (advertised name honua_publish_service). Publishes a table from a registered secure connection as a layer on a target service via the canonical service.publish operation. x-honua-reference-shape: tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["connectionId", "schema", "table", "layerName"],
+  "properties": {
+    "connectionId": {
+      "type": "string",
+      "description": "Secure-connection identifier whose table is published. Required: the canonical service.publish operation resolves the target database connection from it."
+    },
+    "schema": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Source schema containing the table to publish."
+    },
+    "table": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Source table to publish as a layer."
+    },
+    "layerName": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Display name for the published layer."
+    },
+    "serviceName": {
+      "type": "string",
+      "description": "Target service name. Defaults to the canonical default service when omitted."
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional layer description."
+    },
+    "geometryColumn": {
+      "type": "string",
+      "description": "Geometry column to publish when the table has more than one."
+    },
+    "geometryType": {
+      "type": "string",
+      "description": "Geometry type override (for example Point, Polygon) when it cannot be inferred."
+    },
+    "srid": {
+      "type": "integer",
+      "description": "Spatial reference identifier for the published layer."
+    },
+    "primaryKey": {
+      "type": "string",
+      "description": "Primary key column when the table has no detectable key."
+    },
+    "fields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Subset of attribute columns to publish. All columns are published when omitted."
+    }
+  }
+}