@honua/mcp-server 0.1.2-beta.0 → 0.1.8-beta.0

package/release/zero-to-map/contracts/aws-ecs-provision-binding.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://honua.io/schemas/aws-ecs-provision-binding.v1.json",
+  "title": "Honua pre-teardown AWS ECS provision binding",
+  "type": "object",
+  "required": ["schemaVersion", "target", "status", "candidateId", "releaseId", "endpoint", "adminKeySecretRef", "accessCredential", "serverImage", "components", "checks", "evidence"],
+  "properties": {
+    "schemaVersion": { "const": "honua.aws-ecs.provision-binding/v1" },
+    "target": { "const": "aws-ecs" },
+    "status": { "const": "ready" },
+    "candidateId": { "type": "string", "pattern": "^manifest-sha256:[0-9a-f]{64}$" },
+    "releaseId": { "type": "string", "minLength": 1 },
+    "endpoint": { "type": "string", "pattern": "^https://" },
+    "adminKeySecretRef": { "type": "string", "pattern": "^arn:aws(?:-us-gov|-cn)?:secretsmanager:[a-z0-9-]+:[0-9]{12}:secret:[A-Za-z0-9/_+=.@-]+$" },
+    "accessCredential": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "requestedGrants", "effectiveGrants", "status", "canAuthenticate", "referenceType", "referenceDigestSha256"],
+      "properties": {
+        "id": { "type": "string", "format": "uuid" },
+        "requestedGrants": { "type": "array", "minItems": 2, "maxItems": 2, "uniqueItems": true, "items": { "enum": ["admin:read", "admin:write"] } },
+        "effectiveGrants": { "type": "array", "minItems": 2, "maxItems": 2, "uniqueItems": true, "items": { "enum": ["admin:read", "admin:write"] } },
+        "status": { "const": "active" },
+        "canAuthenticate": { "const": true },
+        "referenceType": { "const": "aws-secrets-manager" },
+        "referenceDigestSha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "serverImage": { "type": "string", "pattern": "^ghcr\\.io/honua-io/honua-server:[^@]+@sha256:[0-9a-f]{64}$" },
+    "components": {
+      "type": "object",
+      "required": ["honua-server", "honua-devops", "honua-iac"],
+      "properties": {
+        "honua-server": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+        "honua-devops": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+        "honua-iac": { "type": "string", "pattern": "^[0-9a-f]{40}$" }
+      },
+      "additionalProperties": false
+    },
+    "checks": {
+      "type": "object",
+      "required": ["terraform-plan", "terraform-apply", "readiness", "admin-mcp-handoff"],
+      "properties": {
+        "terraform-plan": { "const": "passed" },
+        "terraform-apply": { "const": "passed" },
+        "readiness": { "const": "passed" },
+        "admin-mcp-handoff": { "const": "passed" }
+      },
+      "additionalProperties": false
+    },
+    "evidence": {
+      "type": "object",
+      "required": ["url", "sha256"],
+      "properties": { "url": { "type": "string", "pattern": "^https://" }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/release/zero-to-map/contracts/checkpoint.schema.json

@@ -0,0 +1,152 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://honua.io/schemas/zero-to-map-checkpoint.v1.json",
+  "title": "Honua zero-to-map pause/resume checkpoint",
+  "type": "object",
+  "required": ["schemaVersion", "state", "createdAt", "journeyId", "releaseContract", "target", "planSha256", "sourceRevision", "mcpEndpointSha256", "candidateId", "releaseId", "resume", "consoleReceiptRequest", "integrity"],
+  "properties": {
+    "schemaVersion": { "const": "honua.zero-to-map.checkpoint/v1" },
+    "state": { "enum": ["paused", "consumed"] },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "journeyId": { "type": "string", "minLength": 1 },
+    "releaseContract": { "type": "string", "minLength": 1 },
+    "target": { "enum": ["local-docker", "aws-ecs"] },
+    "planSha256": { "$ref": "#/$defs/sha256" },
+    "sourceRevision": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+    "mcpEndpointSha256": { "$ref": "#/$defs/sha256" },
+    "candidateId": { "type": "string", "minLength": 1 },
+    "releaseId": { "type": "string", "minLength": 1 },
+    "provisionReceiptSha256": { "$ref": "#/$defs/sha256" },
+    "resume": {
+      "type": "object",
+      "required": ["startedAt", "capturedVariables", "completedStages", "resumeAt"],
+      "properties": {
+        "startedAt": { "type": "string", "format": "date-time" },
+        "capturedVariables": { "type": "object" },
+        "completedStages": { "type": "array", "items": { "$ref": "#/$defs/stageReceipt" } },
+        "resumeAt": {
+          "type": "object",
+          "required": ["stageId", "actionId"],
+          "properties": { "stageId": { "const": "console" }, "actionId": { "const": "console-approval" } },
+          "additionalProperties": false
+        },
+        "catalog": { "$ref": "#/$defs/catalogReceipt" }
+      },
+      "additionalProperties": false
+    },
+    "consoleReceiptRequest": {
+      "type": "object",
+      "required": ["schemaVersion", "actionId", "receiptSchema", "matches", "requiredPointers", "equalPointers"],
+      "properties": {
+        "schemaVersion": { "const": "honua.zero-to-map.console-receipt-request/v1" },
+        "actionId": { "const": "console-approval" },
+        "receiptSchema": { "const": "honua.zero-to-map.console-receipt/v1" },
+        "matches": { "type": "object" },
+        "requiredPointers": { "type": "array", "items": { "type": "string", "pattern": "^/" } },
+        "equalPointers": {
+          "type": "array",
+          "items": { "type": "array", "prefixItems": [{ "type": "string", "pattern": "^/" }, { "type": "string", "pattern": "^/" }], "items": false }
+        }
+      },
+      "additionalProperties": false
+    },
+    "consumedAt": { "type": "string", "format": "date-time" },
+    "finalReceiptSha256": { "$ref": "#/$defs/sha256" },
+    "integrity": {
+      "type": "object",
+      "required": ["algorithm", "digest"],
+      "properties": { "algorithm": { "const": "sha256" }, "digest": { "$ref": "#/$defs/sha256" } },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "catalogReceipt": {
+      "$comment": "Catalog preflight evidence carried across the Console pause. Stages 6 and 7 issue no MCP action, so a resumed run cannot re-derive it and its final receipt would otherwise overwrite the pre-pause one with no catalog evidence.",
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "activeProfiles",
+        "expectedTotalTools",
+        "advertisedTotalTools",
+        "baseStaticTools",
+        "baseAdminTools",
+        "auditedExclusions",
+        "profiles",
+        "catalogSha256",
+        "adminRosterSha256",
+        "staticRosterSha256",
+        "exclusionRosterSha256"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "honua.zero-to-map.catalog/v1" },
+        "activeProfiles": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "expectedTotalTools": { "type": "integer", "minimum": 0 },
+        "advertisedTotalTools": { "type": "integer", "minimum": 0 },
+        "baseStaticTools": { "type": "integer", "minimum": 0 },
+        "baseAdminTools": { "type": "integer", "minimum": 0 },
+        "auditedExclusions": { "type": "integer", "minimum": 0 },
+        "profiles": { "type": "array", "items": { "$ref": "#/$defs/profileReceipt" } },
+        "catalogSha256": { "$ref": "#/$defs/sha256" },
+        "adminRosterSha256": { "$ref": "#/$defs/sha256" },
+        "staticRosterSha256": { "$ref": "#/$defs/sha256" },
+        "exclusionRosterSha256": { "$ref": "#/$defs/sha256" }
+      },
+      "additionalProperties": false
+    },
+    "profileReceipt": {
+      "type": "object",
+      "required": ["id", "expectedMembers", "advertisedMembers", "confirmedMembers", "nameResolvedMembers", "rosterSha256"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "expectedMembers": { "type": "integer", "minimum": 0 },
+        "advertisedMembers": { "type": "integer", "minimum": 0 },
+        "confirmedMembers": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "nameResolvedMembers": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "rosterSha256": { "$ref": "#/$defs/sha256" }
+      },
+      "additionalProperties": false
+    },
+    "stageReceipt": {
+      "type": "object",
+      "required": ["number", "id", "title", "status", "actions"],
+      "properties": {
+        "number": { "type": "integer", "minimum": 1 },
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "status": { "const": "passed" },
+        "actions": { "type": "array", "items": { "$ref": "#/$defs/actionReceipt" } }
+      },
+      "additionalProperties": false
+    },
+    "actionReceipt": {
+      "type": "object",
+      "required": ["id", "kind", "status", "startedAt", "finishedAt"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "kind": { "enum": ["cli", "mcp", "mcp-resource", "gpserver", "receipt", "http"] },
+        "status": { "const": "passed" },
+        "startedAt": { "type": "string", "format": "date-time" },
+        "finishedAt": { "type": "string", "format": "date-time" },
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "evidence": { "type": "object" },
+        "captures": { "type": "object" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "const": "consumed" } } },
+      "then": { "required": ["consumedAt", "finalReceiptSha256"] },
+      "else": { "not": { "anyOf": [{ "required": ["consumedAt"] }, { "required": ["finalReceiptSha256"] }] } }
+    },
+    {
+      "if": { "properties": { "target": { "const": "aws-ecs" } } },
+      "then": { "required": ["provisionReceiptSha256"] },
+      "else": { "not": { "required": ["provisionReceiptSha256"] } }
+    }
+  ],
+  "additionalProperties": false
+}

package/release/zero-to-map/contracts/console-receipt.schema.json

@@ -0,0 +1,150 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://honua.io/schemas/zero-to-map-console-receipt.v1.json",
+  "title": "Honua zero-to-map Console approval receipt",
+  "type": "object",
+  "required": ["schemaVersion", "journeyId", "releaseContract", "status", "proposals", "publications", "audit", "resources", "candidate", "checks", "shareUrl"],
+  "properties": {
+    "schemaVersion": { "const": "honua.zero-to-map.console-receipt/v1" },
+    "journeyId": { "const": "2026.1-zero-to-map" },
+    "releaseContract": { "const": "honua-release#123/D9.3" },
+    "status": { "const": "passed" },
+    "proposals": { "$ref": "#/$defs/studioFamiliesProposal" },
+    "publications": { "$ref": "#/$defs/studioFamiliesPublication" },
+    "audit": { "$ref": "#/$defs/studioFamiliesAudit" },
+    "resources": {
+      "type": "object",
+      "required": ["connectionId", "serviceId", "layerIds", "jobs", "gp", "artifactId", "studio"],
+      "properties": {
+        "connectionId": { "type": "string", "minLength": 1 },
+        "serviceId": { "type": "string", "minLength": 1 },
+        "layerIds": {
+          "type": "object",
+          "required": ["parcels", "zoning"],
+          "properties": {
+            "parcels": { "type": "integer", "minimum": 0 },
+            "zoning": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        },
+        "jobs": {
+          "type": "object",
+          "required": ["esriMcp", "gpServer", "directAnalysis"],
+          "properties": {
+            "esriMcp": { "type": "string", "minLength": 1 },
+            "gpServer": { "type": "string", "minLength": 1 },
+            "directAnalysis": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "gp": {
+          "type": "object",
+          "required": ["jobId", "serviceId", "taskName", "processId", "resultPackageId", "artifactId"],
+          "properties": {
+            "jobId": { "type": "string", "minLength": 1 },
+            "serviceId": { "const": "analysis" },
+            "taskName": { "const": "Buffer" },
+            "processId": { "const": "geometry.buffer" },
+            "resultPackageId": { "type": "string", "minLength": 1 },
+            "artifactId": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "gpServerResultNames": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "artifactId": { "type": "string", "minLength": 1 },
+        "studio": { "$ref": "#/$defs/studioFamiliesResource" }
+      },
+      "additionalProperties": false
+    },
+    "candidate": {
+      "type": "object",
+      "required": ["candidateId", "releaseId"],
+      "properties": {
+        "candidateId": { "type": "string", "minLength": 1 },
+        "releaseId": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "checks": {
+      "type": "object",
+      "required": ["health", "audit", "recovery"],
+      "properties": {
+        "health": { "const": "passed" },
+        "audit": { "const": "passed" },
+        "recovery": { "const": "passed" }
+      },
+      "additionalProperties": false
+    },
+    "shareUrl": { "type": "string", "format": "uri", "pattern": "^https://" }
+  },
+  "$defs": {
+    "studioFamiliesProposal": {
+      "type": "object",
+      "required": ["map", "app", "dashboard"],
+      "properties": { "map": { "$ref": "#/$defs/studioProposal" }, "app": { "$ref": "#/$defs/studioProposal" }, "dashboard": { "$ref": "#/$defs/studioProposal" } },
+      "additionalProperties": false
+    },
+    "studioProposal": {
+      "type": "object",
+      "required": ["draftId", "generation", "route", "proposalId", "executionOperationId"],
+      "properties": {
+        "draftId": { "type": "string", "format": "uuid" },
+        "generation": { "type": "integer", "minimum": 1 },
+        "route": { "type": "string", "minLength": 1 },
+        "proposalId": { "type": "string", "format": "uuid" },
+        "executionOperationId": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "studioFamiliesPublication": {
+      "type": "object",
+      "required": ["map", "app", "dashboard"],
+      "properties": { "map": { "$ref": "#/$defs/studioPublication" }, "app": { "$ref": "#/$defs/studioPublication" }, "dashboard": { "$ref": "#/$defs/studioPublication" } },
+      "additionalProperties": false
+    },
+    "studioPublication": {
+      "type": "object",
+      "required": ["requestId", "itemId", "versionId", "status", "publicationId", "publicUrl"],
+      "properties": {
+        "requestId": { "type": "string", "format": "uuid" },
+        "itemId": { "type": "string", "format": "uuid" },
+        "versionId": { "type": "string", "format": "uuid" },
+        "status": { "const": "published" },
+        "publicationId": { "type": "string", "minLength": 1 },
+        "publicUrl": { "type": "string", "format": "uri", "pattern": "^https://" }
+      },
+      "additionalProperties": false
+    },
+    "studioFamiliesAudit": {
+      "type": "object",
+      "required": ["map", "app", "dashboard"],
+      "properties": { "map": { "$ref": "#/$defs/studioAudit" }, "app": { "$ref": "#/$defs/studioAudit" }, "dashboard": { "$ref": "#/$defs/studioAudit" } },
+      "additionalProperties": false
+    },
+    "studioAudit": {
+      "type": "object",
+      "required": ["correlationId", "operationId"],
+      "properties": { "correlationId": { "type": "string", "minLength": 1 }, "operationId": { "type": "string", "minLength": 1 } },
+      "additionalProperties": false
+    },
+    "studioFamiliesResource": {
+      "type": "object",
+      "required": ["map", "app", "dashboard"],
+      "properties": { "map": { "$ref": "#/$defs/studioFamily" }, "app": { "$ref": "#/$defs/studioFamily" }, "dashboard": { "$ref": "#/$defs/studioFamily" } },
+      "additionalProperties": false
+    },
+    "studioFamily": {
+      "type": "object",
+      "required": ["draftId", "itemId", "versionId", "contentHash", "reopenedDraftId"],
+      "properties": {
+        "draftId": { "type": "string", "format": "uuid" },
+        "itemId": { "type": "string", "format": "uuid" },
+        "versionId": { "type": "string", "format": "uuid" },
+        "contentHash": { "type": "string", "minLength": 1 },
+        "reopenedDraftId": { "type": "string", "format": "uuid" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/release/zero-to-map/contracts/esri-gp-mcp.v1.json

@@ -0,0 +1,73 @@
+{
+  "schemaVersion": "honua.esri-gp-mcp-contract/v1",
+  "tools": [
+    {
+      "name": "honua_esri_gp_list_tasks",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "required": [],
+        "additionalProperties": false
+      },
+      "output": {
+        "required": ["tasks"],
+        "taskFields": [
+          "taskName",
+          "processId",
+          "displayName",
+          "category",
+          "isAlias",
+          "supportsSynchronousExecution"
+        ]
+      }
+    },
+    {
+      "name": "honua_esri_gp_describe_task",
+      "inputSchema": {
+        "type": "object",
+        "properties": { "taskName": { "type": "string" } },
+        "required": ["taskName"],
+        "additionalProperties": false
+      },
+      "output": {
+        "required": [
+          "taskName",
+          "processId",
+          "displayName",
+          "description",
+          "category",
+          "executionType",
+          "supportsSynchronousExecution",
+          "parameters"
+        ],
+        "parameterFields": [
+          "name",
+          "displayName",
+          "description",
+          "dataType",
+          "direction",
+          "parameterType",
+          "defaultValue",
+          "choiceList"
+        ]
+      }
+    },
+    {
+      "name": "honua_esri_gp_execute_task",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "serviceId": { "type": "string" },
+          "taskName": { "type": "string" },
+          "parameters": { "type": "object", "additionalProperties": true },
+          "idempotencyKey": { "type": "string" }
+        },
+        "required": ["serviceId", "taskName", "parameters"],
+        "additionalProperties": false
+      },
+      "output": {
+        "required": ["jobId", "status", "resourceUri", "serviceId", "taskName", "processId"]
+      }
+    }
+  ]
+}

package/release/zero-to-map/fixtures/parcels.geojson

@@ -0,0 +1,33 @@
+{
+  "type": "FeatureCollection",
+  "name": "zero_to_map_parcels",
+  "features": [
+    {
+      "type": "Feature",
+      "id": "P-101",
+      "properties": { "parcel_id": "P-101", "assessed_value": 420000, "zone": "R-1" },
+      "geometry": {
+        "type": "Polygon",
+        "coordinates": [[[-157.8616, 21.3067], [-157.8608, 21.3067], [-157.8608, 21.3073], [-157.8616, 21.3073], [-157.8616, 21.3067]]]
+      }
+    },
+    {
+      "type": "Feature",
+      "id": "P-102",
+      "properties": { "parcel_id": "P-102", "assessed_value": 675000, "zone": "B-2" },
+      "geometry": {
+        "type": "Polygon",
+        "coordinates": [[[-157.8607, 21.3067], [-157.8599, 21.3067], [-157.8599, 21.3073], [-157.8607, 21.3073], [-157.8607, 21.3067]]]
+      }
+    },
+    {
+      "type": "Feature",
+      "id": "P-103",
+      "properties": { "parcel_id": "P-103", "assessed_value": 910000, "zone": "R-1" },
+      "geometry": {
+        "type": "Polygon",
+        "coordinates": [[[-157.8616, 21.3074], [-157.8599, 21.3074], [-157.8599, 21.3080], [-157.8616, 21.3080], [-157.8616, 21.3074]]]
+      }
+    }
+  ]
+}

package/release/zero-to-map/fixtures/zoning.geojson

@@ -0,0 +1,24 @@
+{
+  "type": "FeatureCollection",
+  "name": "zero_to_map_zoning",
+  "features": [
+    {
+      "type": "Feature",
+      "id": "Z-R1",
+      "properties": { "zone": "R-1", "label": "Residential" },
+      "geometry": {
+        "type": "Polygon",
+        "coordinates": [[[-157.8620, 21.3064], [-157.8604, 21.3064], [-157.8604, 21.3083], [-157.8620, 21.3083], [-157.8620, 21.3064]]]
+      }
+    },
+    {
+      "type": "Feature",
+      "id": "Z-B2",
+      "properties": { "zone": "B-2", "label": "Community business" },
+      "geometry": {
+        "type": "Polygon",
+        "coordinates": [[[-157.8604, 21.3064], [-157.8595, 21.3064], [-157.8595, 21.3083], [-157.8604, 21.3083], [-157.8604, 21.3064]]]
+      }
+    }
+  ]
+}