@hegemonart/get-design-done 1.19.6 → 1.20.0

package/scripts/mcp-servers/gdd-state/schemas/frontmatter_update.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/scripts/mcp-servers/gdd-state/schemas/frontmatter_update.schema.json",
+  "title": "GddStateFrontmatterUpdate",
+  "description": "MCP tool gdd_state__frontmatter_update — patch one or more frontmatter fields. Rejects pipeline_state_version and stage (must use transition_stage). Emits state.mutation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["input", "output"],
+  "properties": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["patch"],
+      "properties": {
+        "patch": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "oneOf": [
+              { "type": "string" },
+              { "type": "number" },
+              { "type": "boolean" }
+            ]
+          },
+          "description": "Key/value pairs to merge into frontmatter. Disallowed keys: pipeline_state_version, stage."
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["success"],
+      "properties": {
+        "success": { "type": "boolean" },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "frontmatter": {
+              "type": "object",
+              "description": "The full frontmatter map after patch."
+            },
+            "keys": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["code", "message", "kind"],
+          "properties": {
+            "code": { "type": "string" },
+            "message": { "type": "string" },
+            "kind": { "type": "string", "enum": ["validation", "state_conflict", "operation_failed", "unknown"] }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/mcp-servers/gdd-state/schemas/get.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/scripts/mcp-servers/gdd-state/schemas/get.schema.json",
+  "title": "GddStateGet",
+  "description": "MCP tool gdd_state__get — read current STATE.md (parsed). Read-only; no event emitted.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["input", "output"],
+  "properties": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Optional projection. When present, limit data.state to these top-level keys. Unknown keys are ignored (no error)."
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["success"],
+      "properties": {
+        "success": { "type": "boolean" },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "state": {
+              "type": "object",
+              "description": "The parsed STATE.md (see scripts/lib/gdd-state/types.ts ParsedState). When fields[] was passed, only the requested keys are present."
+            },
+            "path": { "type": "string" }
+          }
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["code", "message", "kind"],
+          "properties": {
+            "code": { "type": "string" },
+            "message": { "type": "string" },
+            "kind": { "type": "string", "enum": ["validation", "state_conflict", "operation_failed", "unknown"] }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/mcp-servers/gdd-state/schemas/probe_connections.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/scripts/mcp-servers/gdd-state/schemas/probe_connections.schema.json",
+  "title": "GddStateProbeConnections",
+  "description": "MCP tool gdd_state__probe_connections — update <connections> map from probe results. Overwrites keys present in the input; does NOT delete keys not in the input. Emits state.mutation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["input", "output"],
+  "properties": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["probe_results"],
+      "properties": {
+        "probe_results": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "status"],
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Connection name (e.g. \"figma\", \"refero\")."
+              },
+              "status": {
+                "type": "string",
+                "enum": ["available", "unavailable", "not_configured"]
+              }
+            }
+          }
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["success"],
+      "properties": {
+        "success": { "type": "boolean" },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "updated": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Names of connection entries that were written."
+            },
+            "connections": {
+              "type": "object",
+              "description": "Full current <connections> map after update.",
+              "additionalProperties": {
+                "type": "string",
+                "enum": ["available", "unavailable", "not_configured"]
+              }
+            }
+          }
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["code", "message", "kind"],
+          "properties": {
+            "code": { "type": "string" },
+            "message": { "type": "string" },
+            "kind": { "type": "string", "enum": ["validation", "state_conflict", "operation_failed", "unknown"] }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/mcp-servers/gdd-state/schemas/resolve_blocker.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/scripts/mcp-servers/gdd-state/schemas/resolve_blocker.schema.json",
+  "title": "GddStateResolveBlocker",
+  "description": "MCP tool gdd_state__resolve_blocker — remove one <blockers> entry by 0-based index or exact text match. Emits state.mutation when a row is removed; returns operation_failed error when no row matches.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["input", "output"],
+  "properties": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "oneOf": [
+        { "required": ["index"] },
+        { "required": ["text"] }
+      ],
+      "properties": {
+        "index": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "0-based index into the <blockers> list. Mutually exclusive with text."
+        },
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Exact text match against blocker.text. First matching row is removed. Mutually exclusive with index."
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["success"],
+      "properties": {
+        "success": { "type": "boolean" },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "removed": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["stage", "date", "text"],
+              "properties": {
+                "stage": { "type": "string" },
+                "date": { "type": "string" },
+                "text": { "type": "string" }
+              }
+            },
+            "count": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["code", "message", "kind"],
+          "properties": {
+            "code": { "type": "string" },
+            "message": { "type": "string" },
+            "kind": { "type": "string", "enum": ["validation", "state_conflict", "operation_failed", "unknown"] }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/mcp-servers/gdd-state/schemas/set_status.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/scripts/mcp-servers/gdd-state/schemas/set_status.schema.json",
+  "title": "GddStateSetStatus",
+  "description": "MCP tool gdd_state__set_status — update <position>.status. Emits state.mutation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["input", "output"],
+  "properties": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["initialized", "in_progress", "completed", "blocked"]
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["success"],
+      "properties": {
+        "success": { "type": "boolean" },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "status": { "type": "string" }
+          }
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["code", "message", "kind"],
+          "properties": {
+            "code": { "type": "string" },
+            "message": { "type": "string" },
+            "kind": { "type": "string", "enum": ["validation", "state_conflict", "operation_failed", "unknown"] }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/mcp-servers/gdd-state/schemas/transition_stage.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/scripts/mcp-servers/gdd-state/schemas/transition_stage.schema.json",
+  "title": "GddStateTransitionStage",
+  "description": "MCP tool gdd_state__transition_stage — run gate and advance stage on pass. Emits state.transition (pass=true) or state.transition (pass=false with blockers).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["input", "output"],
+  "properties": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["to"],
+      "properties": {
+        "to": {
+          "type": "string",
+          "enum": ["brief", "explore", "plan", "design", "verify"],
+          "description": "Target stage to advance to. transition() resolves the gate from the current <position>.stage."
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["success"],
+      "properties": {
+        "success": { "type": "boolean" },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "from": {
+              "type": "string",
+              "description": "Stage we advanced from."
+            },
+            "to": {
+              "type": "string",
+              "enum": ["brief", "explore", "plan", "design", "verify"]
+            },
+            "state": {
+              "type": "object",
+              "description": "The updated parsed state after advance."
+            }
+          }
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["code", "message", "kind"],
+          "properties": {
+            "code": { "type": "string" },
+            "message": { "type": "string" },
+            "kind": { "type": "string", "enum": ["validation", "state_conflict", "operation_failed", "unknown"] },
+            "context": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "blockers": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                },
+                "toStage": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/mcp-servers/gdd-state/schemas/update_progress.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/scripts/mcp-servers/gdd-state/schemas/update_progress.schema.json",
+  "title": "GddStateUpdateProgress",
+  "description": "MCP tool gdd_state__update_progress — update <position> task_progress and/or status. Emits state.mutation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["input", "output"],
+  "properties": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "anyOf": [
+        { "required": ["task_progress"] },
+        { "required": ["status"] }
+      ],
+      "properties": {
+        "task_progress": {
+          "type": "string",
+          "pattern": "^[0-9]+/[0-9]+$",
+          "description": "e.g. \"3/7\"."
+        },
+        "status": {
+          "type": "string",
+          "enum": ["initialized", "in_progress", "completed", "blocked"]
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["success"],
+      "properties": {
+        "success": { "type": "boolean" },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "position": {
+              "type": "object",
+              "description": "The updated <position> block."
+            }
+          }
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["code", "message", "kind"],
+          "properties": {
+            "code": { "type": "string" },
+            "message": { "type": "string" },
+            "kind": { "type": "string", "enum": ["validation", "state_conflict", "operation_failed", "unknown"] }
+          }
+        }
+      }
+    }
+  }
+}