@geraldmaron/construct 1.1.1 → 1.2.1

package/specialists/artifact-manifest.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://geraldmaron.github.io/construct/specialists/artifact-manifest.schema.json",
+  "title": "Construct artifact capability manifest",
+  "type": "object",
+  "required": ["version", "artifacts"],
+  "additionalProperties": false,
+  "properties": {
+    "version": { "type": "integer", "minimum": 1 },
+    "description": { "type": "string" },
+    "workflowDefaults": { "$ref": "#/$defs/workflowDefaults" },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/artifactEntry" }
+    }
+  },
+  "$defs": {
+    "visualRequirement": {
+      "type": "object",
+      "required": ["id", "check"],
+      "properties": {
+        "id": { "type": "string" },
+        "check": { "type": "string", "enum": ["artifact-has-mermaid", "artifact-table-has-columns"] },
+        "diagram": { "type": "string" },
+        "columns": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "releaseGate": {
+      "type": "object",
+      "properties": {
+        "structuralLint": { "type": "boolean" },
+        "citationLint": { "type": "boolean" },
+        "proseMinimum": { "type": "integer", "minimum": 0 },
+        "requiredReviewers": { "type": "array", "items": { "type": "string" } },
+        "optionalReviewers": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "workflowDefaults": {
+      "type": "object",
+      "properties": {
+        "authorChain": { "type": "array", "items": { "type": "string" } },
+        "reviewerChain": { "type": "array", "items": { "type": "string" } },
+        "validation": { "$ref": "#/$defs/validation" },
+        "outputs": { "$ref": "#/$defs/outputs" }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "properties": {
+        "releaseGate": { "type": "boolean" },
+        "requiredChecks": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "outputs": {
+      "type": "object",
+      "properties": {
+        "formats": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "branding": { "type": "string", "enum": ["construct", "plain"] }
+      }
+    },
+    "artifactEntry": {
+      "type": "object",
+      "required": ["template", "primaryOwners", "toneDefault", "releaseGate"],
+      "properties": {
+        "template": { "type": "string" },
+        "primaryOwners": { "type": "array", "items": { "type": "string" } },
+        "workflowSkill": { "type": ["string", "null"] },
+        "toneDefault": { "type": "string" },
+        "toneAllowed": { "type": "array", "items": { "type": "string" } },
+        "structureRequirements": { "type": "array", "items": { "type": "string" } },
+        "visualRequirements": { "type": "array", "items": { "$ref": "#/$defs/visualRequirement" } },
+        "researchProfile": { "type": ["string", "null"] },
+        "releaseGate": { "$ref": "#/$defs/releaseGate" },
+        "documentClass": { "type": "string" },
+        "aliases": { "type": "array", "items": { "type": "string" } },
+        "authorChain": { "type": "array", "items": { "type": "string" } },
+        "reviewerChain": { "type": "array", "items": { "type": "string" } },
+        "validation": { "$ref": "#/$defs/validation" },
+        "outputs": { "$ref": "#/$defs/outputs" }
+      }
+    }
+  }
+}

package/specialists/audit-enrichments.json

@@ -0,0 +1,454 @@
+{
+  "$comment": "Human-equivalent metadata for construct audit specialists. Merged with live registry data by lib/audit-specialists.mjs.",
+  "version": 1,
+  "specialists": {
+    "orchestrator": {
+      "humanEquivalent": "Engineering program manager",
+      "researchProfile": null,
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "oracle": {
+      "humanEquivalent": "Platform SRE / fleet health owner",
+      "researchProfile": "external",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "rd-lead": {
+      "humanEquivalent": "Research lead / principal investigator",
+      "researchProfile": "external",
+      "toneProfile": "pedagogical",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "product-manager": {
+      "humanEquivalent": "Senior product manager",
+      "researchProfile": "user",
+      "toneProfile": "decision-forcing-direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "ux-researcher": {
+      "humanEquivalent": "UX researcher",
+      "researchProfile": "user",
+      "toneProfile": "pedagogical",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "operations": {
+      "humanEquivalent": "Technical program manager",
+      "researchProfile": null,
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "researcher": {
+      "humanEquivalent": "Research analyst",
+      "researchProfile": "external",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "business-strategist": {
+      "humanEquivalent": "Strategy / bizops lead",
+      "researchProfile": "market",
+      "toneProfile": "executive-concise",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "data-analyst": {
+      "humanEquivalent": "Product data analyst",
+      "researchProfile": "external",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "evaluator": {
+      "humanEquivalent": "ML / product evaluator",
+      "researchProfile": "external",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "ai-engineer": {
+      "humanEquivalent": "AI engineer",
+      "researchProfile": "external",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "architect": {
+      "humanEquivalent": "Staff software architect",
+      "researchProfile": "external",
+      "toneProfile": "decision-forcing-direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "engineer": {
+      "humanEquivalent": "Senior software engineer",
+      "researchProfile": "codebase",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "devil-advocate": {
+      "humanEquivalent": "Red-team reviewer",
+      "researchProfile": null,
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "reviewer": {
+      "humanEquivalent": "Staff engineer reviewer",
+      "researchProfile": "codebase",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "security": {
+      "humanEquivalent": "Application security engineer",
+      "researchProfile": "compliance",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "qa": {
+      "humanEquivalent": "QA lead",
+      "researchProfile": "codebase",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "debugger": {
+      "humanEquivalent": "Senior debugger / SRE investigator",
+      "researchProfile": "codebase",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "sre": {
+      "humanEquivalent": "Site reliability engineer",
+      "researchProfile": "external",
+      "toneProfile": "blameless",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "platform-engineer": {
+      "humanEquivalent": "Platform engineer",
+      "researchProfile": "codebase",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "legal-compliance": {
+      "humanEquivalent": "Legal / compliance counsel (technical)",
+      "researchProfile": "compliance",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "release-manager": {
+      "humanEquivalent": "Release manager",
+      "researchProfile": null,
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "docs-keeper": {
+      "humanEquivalent": "Staff technical writer",
+      "researchProfile": null,
+      "toneProfile": "friendly",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "designer": {
+      "humanEquivalent": "Product designer",
+      "researchProfile": "user",
+      "toneProfile": "friendly",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "accessibility": {
+      "humanEquivalent": "Accessibility specialist",
+      "researchProfile": "user",
+      "toneProfile": "pedagogical",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "explorer": {
+      "humanEquivalent": "Staff engineer (onboarding / exploration)",
+      "researchProfile": "codebase",
+      "toneProfile": "pedagogical",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "trace-reviewer": {
+      "humanEquivalent": "Observability / eval analyst",
+      "researchProfile": "external",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "data-engineer": {
+      "humanEquivalent": "Data engineer",
+      "researchProfile": "external",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    },
+    "test-automation": {
+      "humanEquivalent": "Test automation engineer",
+      "researchProfile": "codebase",
+      "toneProfile": "direct",
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-hcr9"
+    }
+  },
+  "roleOverlays": {
+    "architect": {
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-fb8s.11"
+    },
+    "architect.ai-systems": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "architect.data": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "architect.enterprise": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "architect.integration": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "architect.platform": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-analyst": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-analyst.experiment": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-analyst.product": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-analyst.product-intelligence": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-analyst.telemetry": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-engineer.pipeline": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-engineer.vector-retrieval": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "data-engineer.warehouse": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "debugger": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "designer": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "designer.accessibility": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "engineer": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "engineer.ai": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "engineer.data": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "engineer.platform": {
+      "grade": "strong",
+      "gap": "—",
+      "beadId": "construct-fb8s.7"
+    },
+    "operator": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "operator.docs": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "operator.release": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "operator.sre": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "orchestrator": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "product-manager": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "product-manager.ai-product": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "product-manager.business-strategy": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "product-manager.enterprise": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "product-manager.growth": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "product-manager.platform": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "product-manager.product": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "qa": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "qa.ai-eval": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "qa.api-contract": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "qa.data-pipeline": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "qa.test-automation": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "qa.web-ui": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "researcher": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "researcher.explorer": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "researcher.ux": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "reviewer": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "reviewer.devil-advocate": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "reviewer.evaluator": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "reviewer.trace": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "security": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "security.ai": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "security.appsec": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "security.cloud": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "security.legal-compliance": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "security.privacy": {
+      "grade": "strong",
+      "gap": "—"
+    },
+    "security.supply-chain": {
+      "grade": "strong",
+      "gap": "—"
+    }
+  }
+}