This commit is contained in:
DevRunbook release export
@@ -0,0 +1,291 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"$id": "https://devrunbook.local/schemas/playbook.schema.json",
|
||||
"title": "DevRunbook Playbook Package Manifest",
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["apiVersion", "kind", "metadata", "package", "spec", "quality"],
|
||||
"properties": {
|
||||
"apiVersion": {"const": "devrunbook.io/v1alpha1"},
|
||||
"kind": {"const": "Playbook"},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "slug", "version", "title", "summary", "category", "tags", "lifecycle", "riskTier", "authors"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$", "maxLength": 120},
|
||||
"slug": {"type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 100},
|
||||
"version": {"type": "string", "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"},
|
||||
"title": {"type": "string", "minLength": 3, "maxLength": 120},
|
||||
"summary": {"type": "string", "minLength": 20, "maxLength": 320},
|
||||
"category": {"type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"},
|
||||
"tags": {"type": "array", "minItems": 1, "maxItems": 20, "uniqueItems": true, "items": {"type": "string", "pattern": "^[a-z0-9+#.]+(?:-[a-z0-9+#.]+)*$"}},
|
||||
"lifecycle": {"enum": ["draft", "reviewed", "validated", "battle-tested", "deprecated"]},
|
||||
"riskTier": {"enum": ["low", "moderate", "high", "critical"]},
|
||||
"authors": {
|
||||
"type": "array",
|
||||
"minItems": 1,
|
||||
"maxItems": 10,
|
||||
"items": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["name"],
|
||||
"properties": {
|
||||
"name": {"type": "string", "minLength": 1, "maxLength": 120},
|
||||
"url": {"type": "string", "format": "uri"}
|
||||
}
|
||||
}
|
||||
},
|
||||
"license": {"type": "string", "maxLength": 80},
|
||||
"replacement": {"type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"}
|
||||
}
|
||||
},
|
||||
"package": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["files"],
|
||||
"properties": {
|
||||
"files": {
|
||||
"type": "array",
|
||||
"minItems": 3,
|
||||
"maxItems": 200,
|
||||
"items": {"$ref": "#/$defs/packageFile"}
|
||||
}
|
||||
}
|
||||
},
|
||||
"spec": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["type", "intent", "modes", "defaultMode", "autonomy", "inputs", "compatibility", "guardrails", "workflow", "validation", "completion", "failurePolicy", "reporting", "template", "exports"],
|
||||
"properties": {
|
||||
"type": {"enum": ["quick", "guided", "run-pack"]},
|
||||
"intent": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["problem", "outcome", "whenToUse", "whenNotToUse"],
|
||||
"properties": {
|
||||
"problem": {"type": "string", "minLength": 20, "maxLength": 1000},
|
||||
"outcome": {"type": "string", "minLength": 20, "maxLength": 1000},
|
||||
"whenToUse": {"type": "array", "minItems": 1, "maxItems": 12, "items": {"type": "string", "minLength": 5, "maxLength": 300}},
|
||||
"whenNotToUse": {"type": "array", "minItems": 1, "maxItems": 12, "items": {"type": "string", "minLength": 5, "maxLength": 300}}
|
||||
}
|
||||
},
|
||||
"modes": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/workMode"}},
|
||||
"defaultMode": {"$ref": "#/$defs/workMode"},
|
||||
"autonomy": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["min", "max", "default"],
|
||||
"properties": {
|
||||
"min": {"$ref": "#/$defs/autonomyLevel"},
|
||||
"max": {"$ref": "#/$defs/autonomyLevel"},
|
||||
"default": {"$ref": "#/$defs/autonomyLevel"}
|
||||
}
|
||||
},
|
||||
"inputs": {
|
||||
"type": "array",
|
||||
"maxItems": 40,
|
||||
"items": {"$ref": "#/$defs/input"}
|
||||
},
|
||||
"compatibility": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["repositoryRequired", "languages", "frameworks", "packageManagers", "databases", "deploymentTypes", "requiredProfileCapabilities", "incompatibleConditions"],
|
||||
"properties": {
|
||||
"repositoryRequired": {"type": "boolean"},
|
||||
"languages": {"$ref": "#/$defs/stringSet"},
|
||||
"frameworks": {"$ref": "#/$defs/stringSet"},
|
||||
"packageManagers": {"$ref": "#/$defs/stringSet"},
|
||||
"databases": {"$ref": "#/$defs/stringSet"},
|
||||
"deploymentTypes": {"$ref": "#/$defs/stringSet"},
|
||||
"requiredProfileCapabilities": {"type": "array", "uniqueItems": true, "maxItems": 30, "items": {"$ref": "#/$defs/profileCapability"}},
|
||||
"incompatibleConditions": {"type": "array", "maxItems": 20, "items": {"$ref": "#/$defs/condition"}}
|
||||
}
|
||||
},
|
||||
"guardrails": {"type": "array", "minItems": 1, "maxItems": 40, "items": {"$ref": "#/$defs/guardrail"}},
|
||||
"workflow": {"type": "array", "minItems": 1, "maxItems": 40, "items": {"$ref": "#/$defs/workflowStep"}},
|
||||
"validation": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["commandRoles", "checks"],
|
||||
"properties": {
|
||||
"commandRoles": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/commandRole"}},
|
||||
"checks": {"type": "array", "minItems": 1, "maxItems": 40, "items": {"$ref": "#/$defs/check"}}
|
||||
}
|
||||
},
|
||||
"completion": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["criteria"],
|
||||
"properties": {
|
||||
"criteria": {"type": "array", "minItems": 1, "maxItems": 30, "items": {"type": "string", "minLength": 8, "maxLength": 500}}
|
||||
}
|
||||
},
|
||||
"failurePolicy": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["onValidationFailure", "onAmbiguity", "onMissingContext", "onOutOfScopeCause", "onExternalDependencyUnavailable", "onUnableToReproduce"],
|
||||
"properties": {
|
||||
"onValidationFailure": {"type": "string", "minLength": 20, "maxLength": 1000},
|
||||
"onAmbiguity": {"type": "string", "minLength": 20, "maxLength": 1000},
|
||||
"onMissingContext": {"type": "string", "minLength": 20, "maxLength": 1000},
|
||||
"onOutOfScopeCause": {"type": "string", "minLength": 20, "maxLength": 1000},
|
||||
"onExternalDependencyUnavailable": {"type": "string", "minLength": 20, "maxLength": 1000},
|
||||
"onUnableToReproduce": {"type": "string", "minLength": 20, "maxLength": 1000}
|
||||
}
|
||||
},
|
||||
"reporting": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["sections"],
|
||||
"properties": {
|
||||
"sections": {"type": "array", "minItems": 1, "maxItems": 20, "items": {"$ref": "#/$defs/reportSection"}}
|
||||
}
|
||||
},
|
||||
"template": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["main", "partials"],
|
||||
"properties": {
|
||||
"main": {"$ref": "#/$defs/packagePath"},
|
||||
"partials": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/packagePath"}}
|
||||
}
|
||||
},
|
||||
"exports": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["prompt", "markdown", "runPack", "agentsSuggestion"],
|
||||
"properties": {
|
||||
"prompt": {"type": "boolean"},
|
||||
"markdown": {"type": "boolean"},
|
||||
"runPack": {"type": "boolean"},
|
||||
"agentsSuggestion": {"type": "boolean"}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"quality": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["reviewStatus", "testedStacks", "knownLimitations", "evaluationCaseIds"],
|
||||
"properties": {
|
||||
"reviewStatus": {"enum": ["unreviewed", "editorial-reviewed", "technical-reviewed", "evaluation-backed"]},
|
||||
"testedStacks": {"$ref": "#/$defs/stringSet"},
|
||||
"knownLimitations": {"type": "array", "maxItems": 20, "items": {"type": "string", "minLength": 5, "maxLength": 500}},
|
||||
"evaluationCaseIds": {"type": "array", "uniqueItems": true, "items": {"type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$"}}
|
||||
}
|
||||
}
|
||||
},
|
||||
"$defs": {
|
||||
"workMode": {"enum": ["inspect", "plan", "guided", "execute", "recovery"]},
|
||||
"autonomyLevel": {"enum": ["observe", "diagnose", "plan", "implement", "verify", "repair"]},
|
||||
"commandRole": {"enum": ["install", "format", "format-check", "lint", "typecheck", "unit-test", "integration-test", "end-to-end-test", "build", "dev-start", "smoke-test", "migration-status", "migration-apply", "security-scan", "dependency-audit"]},
|
||||
"profileCapability": {"enum": ["install-command", "format-command", "lint-command", "typecheck-command", "test-command", "unit-test-command", "integration-test-command", "end-to-end-test-command", "build-command", "dev-start-command", "smoke-test-command", "migration-command", "security-scan-command", "dependency-audit-command", "default-branch", "protected-paths"]},
|
||||
"stringSet": {"type": "array", "uniqueItems": true, "maxItems": 50, "items": {"type": "string", "minLength": 1, "maxLength": 80}},
|
||||
"packagePath": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[A-Za-z0-9._/-]+$", "maxLength": 500},
|
||||
"packageFile": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["path", "role", "digest", "exportByDefault"],
|
||||
"properties": {
|
||||
"path": {"$ref": "#/$defs/packagePath"},
|
||||
"role": {"enum": ["template", "partial", "documentation", "changelog", "example", "evaluation", "resource", "run-pack-resource"]},
|
||||
"digest": {"type": "boolean"},
|
||||
"exportByDefault": {"type": "boolean"}
|
||||
}
|
||||
},
|
||||
"condition": {
|
||||
"oneOf": [
|
||||
{
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["fact"],
|
||||
"properties": {
|
||||
"fact": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["path", "operator"],
|
||||
"properties": {
|
||||
"path": {"type": "string", "pattern": "^(inputs|repository|composition|platform)(?:\\.[A-Za-z][A-Za-z0-9_-]*)+$", "maxLength": 240},
|
||||
"operator": {"enum": ["exists", "truthy", "falsy", "eq", "neq", "in", "not-in", "contains", "gt", "gte", "lt", "lte"]},
|
||||
"value": {}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{"type": "object", "additionalProperties": false, "required": ["all"], "properties": {"all": {"type": "array", "minItems": 1, "maxItems": 20, "items": {"$ref": "#/$defs/condition"}}}},
|
||||
{"type": "object", "additionalProperties": false, "required": ["any"], "properties": {"any": {"type": "array", "minItems": 1, "maxItems": 20, "items": {"$ref": "#/$defs/condition"}}}},
|
||||
{"type": "object", "additionalProperties": false, "required": ["not"], "properties": {"not": {"$ref": "#/$defs/condition"}}}
|
||||
]
|
||||
},
|
||||
"input": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["key", "label", "description", "type", "required", "sensitive", "includeInOutput"],
|
||||
"properties": {
|
||||
"key": {"type": "string", "pattern": "^[a-z][A-Za-z0-9]*$", "maxLength": 80},
|
||||
"label": {"type": "string", "minLength": 2, "maxLength": 120},
|
||||
"description": {"type": "string", "minLength": 10, "maxLength": 500},
|
||||
"type": {"enum": ["string", "multiline", "boolean", "integer", "enum", "multiselect", "path", "command", "string-list", "key-value-list"]},
|
||||
"required": {"type": "boolean"},
|
||||
"sensitive": {"type": "boolean"},
|
||||
"includeInOutput": {"type": "boolean"},
|
||||
"default": {},
|
||||
"options": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "maxLength": 120}},
|
||||
"minLength": {"type": "integer", "minimum": 0},
|
||||
"maxLength": {"type": "integer", "minimum": 1},
|
||||
"minimum": {"type": "integer"},
|
||||
"maximum": {"type": "integer"},
|
||||
"visibleWhen": {"$ref": "#/$defs/condition"}
|
||||
}
|
||||
},
|
||||
"guardrail": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "severity", "text"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "pattern": "^[a-z][a-z0-9-]*$"},
|
||||
"severity": {"enum": ["info", "warning", "blocking"]},
|
||||
"text": {"type": "string", "minLength": 10, "maxLength": 1000},
|
||||
"rationale": {"type": "string", "maxLength": 500},
|
||||
"when": {"$ref": "#/$defs/condition"}
|
||||
}
|
||||
},
|
||||
"workflowStep": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "title", "instruction", "required"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "pattern": "^[a-z][a-z0-9-]*$"},
|
||||
"title": {"type": "string", "minLength": 3, "maxLength": 120},
|
||||
"instruction": {"type": "string", "minLength": 20, "maxLength": 2000},
|
||||
"required": {"type": "boolean"},
|
||||
"when": {"$ref": "#/$defs/condition"}
|
||||
}
|
||||
},
|
||||
"check": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "type", "description", "blocking", "evidence"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "pattern": "^[a-z][a-z0-9-]*$"},
|
||||
"type": {"enum": ["command", "manual", "artifact", "assertion"]},
|
||||
"description": {"type": "string", "minLength": 10, "maxLength": 1000},
|
||||
"blocking": {"type": "boolean"},
|
||||
"evidence": {"type": "string", "minLength": 5, "maxLength": 500},
|
||||
"when": {"$ref": "#/$defs/condition"}
|
||||
}
|
||||
},
|
||||
"reportSection": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "title", "required", "description"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "pattern": "^[a-z][a-z0-9-]*$"},
|
||||
"title": {"type": "string", "minLength": 2, "maxLength": 120},
|
||||
"required": {"type": "boolean"},
|
||||
"description": {"type": "string", "minLength": 10, "maxLength": 500}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user