@geraldmaron/construct 1.1.1 → 1.2.0

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": "—"
+    }
+  }
+}

package/specialists/contracts.json

@@ -40,7 +40,7 @@
         "mustContain": ["goal", "intent", "workCategory", "riskFlags", "acceptanceCriteria"]
       },
       "output": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "type": "decision"
       },
       "preconditions": [
@@ -63,7 +63,7 @@
         "mustContain": ["question", "method", "sources", "findings", "confidence"]
       },
       "output": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "type": "decision"
       },
       "preconditions": [
@@ -104,6 +104,12 @@
           "id": "prd-numeric-claims-cited",
           "description": "Every numeric claim in the PRD body cites a source (no fabricated percentages or multipliers)",
           "check": "artifact-claims-cited"
+        },
+        {
+          "id": "prd-manifest-reviewers",
+          "description": "Manifest required reviewers must appear in agent log before handoff",
+          "check": "artifact-reviewers-seen",
+          "fromManifest": true
         }
       ]
     },
@@ -117,7 +123,7 @@
         "mustContain": ["problem", "functionalRequirements", "nonFunctionalRequirements", "acceptanceCriteria", "constraints"]
       },
       "output": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "type": "decision"
       },
       "preconditions": [
@@ -149,6 +155,12 @@
           "id": "adr-numeric-claims-cited",
           "description": "Every numeric claim in the ADR body cites a source",
           "check": "artifact-claims-cited"
+        },
+        {
+          "id": "adr-manifest-reviewers",
+          "description": "Manifest required reviewers must appear in agent log before handoff",
+          "check": "artifact-reviewers-seen",
+          "fromManifest": true
         }
       ]
     },
@@ -179,11 +191,11 @@
       "consumer": "cx-engineer",
       "trigger": { "intent": ["implementation", "fix"] },
       "input": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "mustContain": ["goal", "approach", "tasks", "acceptanceCriteria"]
       },
       "output": {
-        "schema": "lib/schemas/implementation.json",
+        "schema": "lib/contract-schemas/implementation.json",
         "type": "implementation"
       },
       "preconditions": [
@@ -202,11 +214,11 @@
       "consumer": "cx-ai-engineer",
       "trigger": { "riskFlags": ["ai"], "intent": ["implementation"] },
       "input": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "mustContain": ["goal", "approach", "evalCriteria"]
       },
       "output": {
-        "schema": "lib/schemas/implementation.json",
+        "schema": "lib/contract-schemas/implementation.json",
         "type": "implementation"
       },
       "preconditions": [
@@ -222,11 +234,11 @@
       "consumer": "cx-reviewer",
       "trigger": { "always": true },
       "input": {
-        "schema": "lib/schemas/implementation.json",
+        "schema": "lib/contract-schemas/implementation.json",
         "mustContain": ["filesChanged", "verificationChecklist"]
       },
       "output": {
-        "schema": "lib/schemas/review-report.json",
+        "schema": "lib/contract-schemas/review-report.json",
         "type": "review-report",
         "mustContain": ["verdict"],
         "mustContainOneOf": [["findings", "noIssuesFoundAt"]],
@@ -251,11 +263,11 @@
       "consumer": "cx-qa",
       "trigger": { "always": true },
       "input": {
-        "schema": "lib/schemas/implementation.json",
+        "schema": "lib/contract-schemas/implementation.json",
         "mustContain": ["filesChanged", "tests"]
       },
       "output": {
-        "schema": "lib/schemas/test-report.json",
+        "schema": "lib/contract-schemas/test-report.json",
         "type": "test-report"
       },
       "preconditions": [
@@ -273,11 +285,11 @@
       "consumer": "cx-security",
       "trigger": { "riskFlags": ["security"] },
       "input": {
-        "schema": "lib/schemas/review-report.json",
+        "schema": "lib/contract-schemas/review-report.json",
         "mustContain": ["target", "findings"]
       },
       "output": {
-        "schema": "lib/schemas/review-report.json",
+        "schema": "lib/contract-schemas/review-report.json",
         "type": "review-report",
         "specialization": "security",
         "mustContain": ["threatModelUpdatedAt", "contractStart"]
@@ -297,7 +309,7 @@
       "consumer": "cx-release-manager",
       "trigger": { "intent": ["implementation"], "workCategory": "deep" },
       "input": {
-        "schema": "lib/schemas/test-report.json",
+        "schema": "lib/contract-schemas/test-report.json",
         "mustContain": ["verdict", "passed", "failed", "coverage"]
       },
       "output": {
@@ -467,7 +479,7 @@
         "mustContain": ["problemStatement", "hypothesis", "keyUnknowns", "evidenceThreshold", "recommendation"]
       },
       "output": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "type": "decision"
       },
       "preconditions": [
@@ -517,7 +529,7 @@
       "consumer": "cx-operations",
       "trigger": { "intent": ["implementation"], "workCategory": "deep" },
       "input": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "mustContain": ["goal", "approach", "tasks", "acceptanceCriteria"]
       },
       "output": {
@@ -652,7 +664,7 @@
       "consumer": "cx-evaluator",
       "trigger": { "riskFlags": ["ai", "quality"], "intent": ["implementation"] },
       "input": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "mustContain": ["goal", "approach", "evalCriteria"]
       },
       "output": {
@@ -686,7 +698,7 @@
       "consumer": "cx-platform-engineer",
       "trigger": { "riskFlags": ["platform", "infrastructure"], "intent": ["implementation"] },
       "input": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "mustContain": ["goal", "approach", "platformDependencies"]
       },
       "output": {
@@ -713,7 +725,7 @@
         "mustContain": ["solution", "migration", "rollback"]
       },
       "output": {
-        "schema": "lib/schemas/implementation.json",
+        "schema": "lib/contract-schemas/implementation.json",
         "type": "implementation"
       },
       "preconditions": [
@@ -731,7 +743,7 @@
       "consumer": "cx-legal-compliance",
       "trigger": { "riskFlags": ["compliance", "privacy", "licensing"] },
       "input": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "mustContain": ["goal", "approach", "dataFlows"]
       },
       "output": {
@@ -811,7 +823,7 @@
         "mustContain": ["findings", "wcagCriterion", "userImpact"]
       },
       "output": {
-        "schema": "lib/schemas/test-report.json",
+        "schema": "lib/contract-schemas/test-report.json",
         "type": "test-report"
       },
       "preconditions": [
@@ -858,7 +870,7 @@
         "mustContain": ["entryPoints", "keyFiles", "gaps"]
       },
       "output": {
-        "schema": "lib/schemas/implementation.json",
+        "schema": "lib/contract-schemas/implementation.json",
         "type": "implementation"
       },
       "preconditions": [
@@ -918,7 +930,7 @@
       "consumer": "cx-data-engineer",
       "trigger": { "riskFlags": ["data", "pipeline"], "intent": ["implementation"] },
       "input": {
-        "schema": "lib/schemas/decision.json",
+        "schema": "lib/contract-schemas/decision.json",
         "mustContain": ["goal", "approach", "dataContracts"]
       },
       "output": {
@@ -973,7 +985,7 @@
       "consumer": "cx-test-automation",
       "trigger": { "intent": ["implementation"], "automation.required": true },
       "input": {
-        "schema": "lib/schemas/test-report.json",
+        "schema": "lib/contract-schemas/test-report.json",
         "mustContain": ["testStrategy", "verdict"]
       },
       "output": {
@@ -1005,7 +1017,7 @@
         "mustContain": ["framework", "coverageTargets", "flakeBudget"]
       },
       "output": {
-        "schema": "lib/schemas/implementation.json",
+        "schema": "lib/contract-schemas/implementation.json",
         "type": "implementation"
       },
       "preconditions": [