@hagicode/hagitask 0.1.0

package/schemas/community-index-v1.schema.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://tasks.hagicode.com/schemas/community-index-v1.schema.json",
+  "title": "HagiTask Community Index v1",
+  "description": "Lightweight, machine-readable discovery contract for community HagiTask entries. Every document published at /index.json MUST conform to this schema. It carries only discovery and acquisition metadata; executable detail lives in the standalone detail documents.",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "publisher", "tasks"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "const": 1,
+      "description": "Protocol version. Independent from any task package version."
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "RFC 3339 timestamp when this index document was produced by the build."
+    },
+    "publisher": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Organization or team publishing the community catalog."
+    },
+    "source": {
+      "type": "string",
+      "description": "Optional root URL or repository reference for the catalog source."
+    },
+    "tasks": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/taskEntry" }
+    }
+  },
+  "$defs": {
+    "taskEntry": {
+      "type": "object",
+      "required": [
+        "taskId",
+        "name",
+        "summary",
+        "category",
+        "tags",
+        "publisher",
+        "source",
+        "version",
+        "publishedAt",
+        "detailUrl",
+        "packageUrl",
+        "compatibility",
+        "integrity"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "taskId": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$",
+          "description": "Canonical, stable package identifier. Human-facing aliases MUST NOT be emitted as additional task IDs."
+        },
+        "name": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": { "type": "string", "minLength": 1 },
+          "description": "Localized display name keyed by locale code (e.g. \"en-US\")."
+        },
+        "summary": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": { "type": "string", "minLength": 1 },
+          "description": "Localized short summary keyed by locale code."
+        },
+        "category": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Primary discovery category used by the listing filters."
+        },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Secondary discovery tags."
+        },
+        "publisher": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Publisher of this specific task entry."
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Source reference for this entry (repository or catalog root)."
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+          "description": "Semver-like package version copied from the HagiTask manifest."
+        },
+        "publishedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "RFC 3339 timestamp of the task publication."
+        },
+        "detailUrl": {
+          "type": "string",
+          "pattern": "^/tasks/[a-z0-9][a-z0-9-]*\\.json$",
+          "description": "Stable public path to the standalone detail document."
+        },
+        "packageUrl": {
+          "type": "string",
+          "pattern": "^/packages/[a-z0-9][a-z0-9-]*\\.zip$",
+          "description": "Stable public path to the downloadable package archive."
+        },
+        "compatibility": { "$ref": "#/$defs/compatibility" },
+        "integrity": { "$ref": "#/$defs/integrity" }
+      }
+    },
+    "compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "agent": {
+          "type": "string",
+          "description": "Required agent capability name, or \"any\"."
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Required skill names."
+        },
+        "cli": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name"],
+            "additionalProperties": false,
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "command": { "type": "string" },
+              "args": { "type": "array", "items": { "type": "string" } }
+            }
+          },
+          "description": "Required CLI tooling."
+        }
+      }
+    },
+    "integrity": {
+      "type": "object",
+      "required": ["sha256"],
+      "additionalProperties": false,
+      "properties": {
+        "algorithm": { "const": "sha256" },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$",
+          "description": "Lowercase SHA-256 digest of the exact published package archive bytes."
+        }
+      }
+    }
+  }
+}

package/schemas/community-task-detail-v1.schema.json

@@ -0,0 +1,182 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://tasks.hagicode.com/schemas/community-task-detail-v1.schema.json",
+  "title": "HagiTask Community Task Detail v1",
+  "description": "Standalone, machine-readable detail contract for a single community HagiTask. Published at /tasks/<taskId>.json. It repeats identity metadata for standalone retrieval and adds description, requirements, resources, installation, documentation, and localization. The package archive is the installation unit; documentation links are optional metadata.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "taskId",
+    "version",
+    "publisher",
+    "source",
+    "name",
+    "summary",
+    "category",
+    "tags",
+    "compatibility",
+    "resources",
+    "installation",
+    "documentation"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "taskId": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
+    },
+    "publisher": { "type": "string", "minLength": 1 },
+    "source": { "type": "string", "minLength": 1 },
+    "publishedAt": { "type": "string", "format": "date-time" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "name": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "summary": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "description": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "type": "string" },
+      "description": "Optional longer localized description keyed by locale."
+    },
+    "category": { "type": "string", "minLength": 1 },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "compatibility": { "$ref": "#/$defs/compatibility" },
+    "requirements": {
+      "type": "array",
+      "description": "Normalized runtime requirements derived from backend/task-preset.json.",
+      "items": {
+        "type": "object",
+        "required": ["type", "name"],
+        "additionalProperties": false,
+        "properties": {
+          "type": { "type": "string", "enum": ["agent", "skills", "cli", "host", "capability"] },
+          "name": { "type": "string", "minLength": 1 },
+          "command": { "type": "string" },
+          "args": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "resources": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "manifest": { "type": "string", "description": "Public URL or site-root-relative path to the manifest." },
+        "backend": { "type": "string" },
+        "frontend": { "type": "string" },
+        "prompts": { "type": "string" },
+        "locales": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Locale bundle identifiers or public paths."
+        },
+        "storePage": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Public paths to store-page documents."
+        }
+      }
+    },
+    "installation": {
+      "type": "object",
+      "required": ["packageUrl", "mediaType", "sha256"],
+      "additionalProperties": false,
+      "properties": {
+        "packageUrl": {
+          "type": "string",
+          "pattern": "^/packages/[a-z0-9][a-z0-9-]*\\.zip$"
+        },
+        "mediaType": { "const": "application/zip" },
+        "size": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Byte size of the published archive when known."
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$",
+          "description": "Lowercase SHA-256 digest of the exact published archive bytes."
+        },
+        "algorithm": { "const": "sha256" }
+      }
+    },
+    "documentation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "storePage": {
+          "type": "object",
+          "description": "Localized store-page URLs keyed by locale code.",
+          "additionalProperties": { "type": "string" }
+        },
+        "external": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["label", "url"],
+            "additionalProperties": false,
+            "properties": {
+              "label": { "type": "string" },
+              "url": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "localization": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "defaultLocale": { "type": "string" },
+        "supportedLocales": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Optional source-of-truth metadata preserved from the package manifest (owner, status, icon, kind, etc.)."
+    }
+  },
+  "$defs": {
+    "compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "agent": { "type": "string" },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "cli": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name"],
+            "additionalProperties": false,
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "command": { "type": "string" },
+              "args": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/task-preset-plugin/commands.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hagicode.local/designs/task-preset-plugin-schemas/commands.schema.json",
+  "title": "Task Preset Plugin Command Catalog",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "selectionMode",
+    "groups",
+    "commands"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.1"
+    },
+    "selectionMode": {
+      "type": "string",
+      "enum": [
+        "single",
+        "multiple"
+      ]
+    },
+    "docs": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "baseUrl": {
+          "type": "string"
+        },
+        "routeTemplate": {
+          "type": "string"
+        },
+        "languageResolver": {
+          "type": "string"
+        }
+      }
+    },
+    "groups": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/group"
+      }
+    },
+    "commands": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/command"
+      }
+    }
+  },
+  "$defs": {
+    "group": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "title"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "title": {
+          "$ref": "#/$defs/localizedKey"
+        },
+        "description": {
+          "$ref": "#/$defs/localizedKey"
+        }
+      }
+    },
+    "command": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "groupId",
+        "label"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "groupId": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "skill": {
+          "type": "string"
+        },
+        "description": {
+          "$ref": "#/$defs/localizedKey"
+        },
+        "docsSlug": {
+          "type": "string"
+        },
+        "preludeTemplate": {
+          "type": "string"
+        }
+      }
+    },
+    "localizedKey": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key"
+      ],
+      "properties": {
+        "key": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/schemas/task-preset-plugin/locales.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hagicode.local/designs/task-preset-plugin-schemas/locales.schema.json",
+  "title": "Task Preset Plugin Locale Bundle",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/$defs/localeNode"
+  },
+  "$defs": {
+    "localeNode": {
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/localeNode"
+          }
+        }
+      ]
+    }
+  }
+}