Reorganize repo structure and standards references
This commit is contained in:
1 parent
3cb93a81be
commit
be2054274d
5885 files changed
+2588
-195
No files matched your search
@@ -0,0 +1,292 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"$id": "https://toolctrl.local/docs/feature-manifests/schema.json",
|
||||
"title": "ToolCTRL Feature Manifest",
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": [
|
||||
"schemaVersion",
|
||||
"id",
|
||||
"title",
|
||||
"classification",
|
||||
"status",
|
||||
"owner",
|
||||
"description",
|
||||
"rationale",
|
||||
"codeAreas",
|
||||
"dependencies",
|
||||
"consumers",
|
||||
"integration",
|
||||
"boundaries",
|
||||
"pruning",
|
||||
"validation"
|
||||
],
|
||||
"properties": {
|
||||
"schemaVersion": {
|
||||
"type": "string",
|
||||
"const": "1.0"
|
||||
},
|
||||
"id": {
|
||||
"type": "string",
|
||||
"pattern": "^[a-z0-9][a-z0-9-]*$"
|
||||
},
|
||||
"title": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"classification": {
|
||||
"type": "string",
|
||||
"enum": ["core", "plugin-candidate", "remove-candidate", "mixed"]
|
||||
},
|
||||
"status": {
|
||||
"type": "string",
|
||||
"enum": ["active", "proposed", "review-needed"]
|
||||
},
|
||||
"owner": {
|
||||
"type": "string",
|
||||
"description": "Planning owner or broad ownership area, not a code owner assignment."
|
||||
},
|
||||
"description": {
|
||||
"type": "string"
|
||||
},
|
||||
"rationale": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"codeAreas": {
|
||||
"type": "array",
|
||||
"description": "Likely source locations. Paths may be globs or package/module names.",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"dependencies": {
|
||||
"type": "array",
|
||||
"description": "Feature manifest IDs this feature needs to function.",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"pattern": "^[a-z0-9][a-z0-9-]*$"
|
||||
}
|
||||
},
|
||||
"consumers": {
|
||||
"type": "array",
|
||||
"description": "Feature manifest IDs or feature surfaces that depend on this one.",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"type": "array",
|
||||
"description": "Optional list for bundle manifests such as plugin or removal candidates.",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "title", "rationale", "codeAreas"],
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"pattern": "^[a-z0-9][a-z0-9-]*$"
|
||||
},
|
||||
"title": {
|
||||
"type": "string"
|
||||
},
|
||||
"rationale": {
|
||||
"type": "string"
|
||||
},
|
||||
"codeAreas": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"notes": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"integration": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": [
|
||||
"ownership",
|
||||
"surfaces",
|
||||
"configuration",
|
||||
"workers",
|
||||
"externalProviders",
|
||||
"permissions",
|
||||
"auditEvents",
|
||||
"billingImpacts",
|
||||
"uat"
|
||||
],
|
||||
"properties": {
|
||||
"ownership": {
|
||||
"type": "string",
|
||||
"enum": ["tenant-owned", "admin-managed", "hybrid", "system-only"]
|
||||
},
|
||||
"surfaces": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["adminRoutes", "tenantRoutes", "publicRoutes", "apiRoutes"],
|
||||
"properties": {
|
||||
"adminRoutes": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"tenantRoutes": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"publicRoutes": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"apiRoutes": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
}
|
||||
}
|
||||
},
|
||||
"configuration": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["admin", "tenant", "environment", "secrets"],
|
||||
"properties": {
|
||||
"admin": {
|
||||
"type": "array",
|
||||
"description": "Admin-owned settings, provider credentials, policy, and defaults.",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"tenant": {
|
||||
"type": "array",
|
||||
"description": "Tenant-owned settings visible or editable in tenant surfaces.",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"environment": {
|
||||
"type": "array",
|
||||
"description": "Required environment variables or deployment configuration.",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"secrets": {
|
||||
"type": "array",
|
||||
"description": "Secret values and where they are owned. Do not store secret values here.",
|
||||
"items": { "type": "string" }
|
||||
}
|
||||
}
|
||||
},
|
||||
"workers": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["required", "queues", "jobs", "notes"],
|
||||
"properties": {
|
||||
"required": { "type": "boolean" },
|
||||
"queues": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"jobs": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"notes": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
}
|
||||
}
|
||||
},
|
||||
"externalProviders": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"permissions": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"pattern": "^[a-z][A-Za-z0-9]*(\\.(?:[A-Za-z][A-Za-z0-9]*|\\*))+$"
|
||||
}
|
||||
},
|
||||
"auditEvents": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"
|
||||
}
|
||||
},
|
||||
"billingImpacts": {
|
||||
"type": "array",
|
||||
"items": { "type": "string" }
|
||||
},
|
||||
"uat": {
|
||||
"type": "array",
|
||||
"description": "Operator-verifiable acceptance checks for planning and implementation.",
|
||||
"items": { "type": "string" }
|
||||
}
|
||||
}
|
||||
},
|
||||
"boundaries": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["mustKeep", "mayMoveToPlugin", "mustNotTouch"],
|
||||
"properties": {
|
||||
"mustKeep": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"mayMoveToPlugin": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"mustNotTouch": {
|
||||
"type": "array",
|
||||
"description": "Areas excluded from the current phase or known to be owned by parallel work.",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"pruning": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["phase", "action", "notes"],
|
||||
"properties": {
|
||||
"phase": {
|
||||
"type": "string"
|
||||
},
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": ["keep", "extract-plugin", "remove", "review"]
|
||||
},
|
||||
"notes": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"validation": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["source", "lastReviewed"],
|
||||
"properties": {
|
||||
"source": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"lastReviewed": {
|
||||
"type": "string",
|
||||
"format": "date"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user