{"success":true,"filters":{"category":null,"primitive":null,"search":null},"summary":{"contracts":14,"categories":5,"requiredFields":86,"relationships":45,"evidenceOutputs":58,"failClosedRules":42,"apiSurfaces":38,"sourceModules":49},"contracts":[{"id":"primitive-contract-user","primitive":"user","name":"User","category":"identity","purpose":"Represents the learner, manager, admin, instructor, or API-linked person whose AI readiness evidence is being produced.","owns":["Authentication identity","Learner profile","Role assignment","Organization membership","Personal readiness evidence"],"requiredFields":["id","email","orgId","role","createdAt"],"relationships":["Belongs to one organization when training is tenant-scoped","Enrolls in courses and learning paths","Submits attempts and receives grading results","Earns credentials, badges, and certificates","May manage teams or approve content depending on role"],"evidenceProduced":["Identity-bound attempt history","Credential registry ownership","Learning progress","Manager report learner row"],"sourceModules":["src/lib/db/schema.ts:users","src/lib/auth.ts","src/lib/content-access.ts","src/lib/enterprise-access.ts"],"apiSurfaces":["/api/enterprise/users","/api/enterprise/training-data","/api/readiness/score-model","/api/proof-artifacts"],"failClosedRules":["Private evidence writes require a resolved user.","Production auth must not fall back to demo identity.","Managers can only inspect learners inside their permitted org or team boundary."]},{"id":"primitive-contract-organization","primitive":"organization","name":"Organization","category":"identity","purpose":"Defines the tenant boundary for company academies, custom content, manager reports, exports, policy training, and enterprise integrations.","owns":["Tenant identity","Company academy","Custom branding","Approved AI tool catalog","Enterprise integration settings"],"requiredFields":["id","name","createdAt"],"relationships":["Owns users, teams, courses, scenarios, skill atoms, rubric contracts, and tool scripts","Scopes enterprise API keys, SSO, SCIM, LMS, HRIS, and webhooks","Aggregates team and department readiness evidence"],"evidenceProduced":["Org readiness dashboard","Compliance training evidence","Audit logs","Department benchmark reports","AI adoption risk and ROI dashboards"],"sourceModules":["src/lib/db/schema.ts:organizations","src/lib/platform/company-academy.ts","src/lib/platform/org-readiness-dashboard.ts","src/lib/platform/integrations.ts"],"apiSurfaces":["/api/company-academy","/api/org-readiness-dashboard","/api/integrations","/api/evidence-export-center"],"failClosedRules":["Org-only content cannot be read without a matching orgId.","Enterprise exports must include tenant identity but not private raw scenario contents.","Platform admins need explicit org context for tenant-scoped mutations."]},{"id":"primitive-contract-role","primitive":"role","name":"Role","category":"learning","purpose":"Maps a learner to the AI workflows, tools, risks, skill atoms, scenarios, rubrics, and credentials that matter for their job.","owns":["Role academy","Vertical positioning","Workflow scope","Tool mission mix","Readiness benchmarks"],"requiredFields":["slug","name","audience","workflows","skillAtoms","toolMissions"],"relationships":["Routes learners into role academies, demos, readiness assessments, and learning paths","Filters skill graph nodes and scenario seeds","Defines manager report and benchmark context"],"evidenceProduced":["Role selection recommendation","Role readiness benchmark","Role academy proof packet","Vertical SEO landing page"],"sourceModules":["src/lib/platform/verticals.ts","src/lib/platform/role-selection-quiz.ts","src/lib/platform/readiness-benchmarks.ts","src/lib/platform/vertical-seo-matrix.ts"],"apiSurfaces":["/api/role-academies","/api/role-selection-quiz","/api/readiness/benchmarks","/api/vertical-seo-matrix"],"failClosedRules":["Unknown roles route to assessment instead of fabricated credentials.","Custom role curricula require source grounding before publishing.","Role policy enforcement must override generic workflow advice."]},{"id":"primitive-contract-skill-atom","primitive":"skill_atom","name":"Skill Atom","category":"learning","purpose":"Stores the smallest trainable and assessable AI capability across a role, workflow, tool, industry, or policy boundary.","owns":["Trainable capability","Failure modes","Practice pattern","Assessment configuration","Prerequisite graph"],"requiredFields":["id","name","version","status","visibility","context","pattern","assessment"],"relationships":["Belongs to courses, learning paths, missions, scenarios, and rubric contracts","Depends on other skill atoms through required, recommended, or related edges","Feeds readiness scoring dimensions and credential evidence"],"evidenceProduced":["Skill mastery status","Skill atom result","Skill graph coverage edge","Credential skill evidence"],"sourceModules":["src/lib/db/schema.ts:skillAtoms","src/lib/platform/skill-atoms.ts","src/lib/platform/skill-graph.ts","src/app/api/skill-atoms/route.ts"],"apiSurfaces":["/api/skill-atoms","/api/skill-graph","/api/platform/manifest"],"failClosedRules":["Draft skill atoms cannot count as learner readiness evidence.","Org-only skill atoms cannot leak into public catalogs.","Deprecated skill atoms remain visible only for historical evidence references."]},{"id":"primitive-contract-scenario","primitive":"scenario","name":"Scenario","category":"learning","purpose":"Represents a realistic work situation used for simulations, drills, assessments, capstones, and company-specific practice.","owns":["Scenario context","Difficulty","Ideal behaviors","Linked skill atoms","Recommended tool scripts"],"requiredFields":["id","title","context","rubric","difficulty","status","visibility"],"relationships":["Instantiates from scenario seeds","Links to courses, missions, skill atoms, and rubric contracts","Produces attempts and grading results","Can be generated from policies, tickets, calls, SOPs, briefs, and docs"],"evidenceProduced":["Simulation attempt","Baseline scenario result","Exit scenario result","Manager review artifact"],"sourceModules":["src/lib/db/schema.ts:scenarios","src/lib/platform/scenario-seeds.ts","src/lib/demo-scenarios.ts","src/lib/platform/studio.ts"],"apiSurfaces":["/api/demo/scenarios","/api/studio/source-training","/api/course-library","/api/grading/universal"],"failClosedRules":["Private or org-only scenario text cannot be included in public proof artifacts.","Company-generated scenarios require privacy review before learner use.","Scenario attempts must reference the rubric contract version used at grading time."]},{"id":"primitive-contract-rubric-contract","primitive":"rubric_contract","name":"Rubric Contract","category":"grading","purpose":"Defines the versioned scoring standard that turns subjective AI workflow performance into comparable readiness evidence.","owns":["Rubric dimensions","Scoring configuration","Failure modes","Standards alignment","Version changelog"],"requiredFields":["id","name","version","status","visibility","dimensions","scoringConfig"],"relationships":["Scores scenarios, assessments, missions, workflow submissions, and capstones","Links to skill atom assessment configuration","Feeds universal grading and credential pass criteria"],"evidenceProduced":["Dimension scores","Failure mode detections","Pass/fail readiness signal","Rubric version audit trail"],"sourceModules":["src/lib/db/schema.ts:rubricContracts","src/lib/platform/rubrics.ts","src/lib/platform/grading-governance.ts","src/lib/ai/grading.ts"],"apiSurfaces":["/api/grading/universal","/api/grading-governance","/api/grading-coverage","/api/platform/manifest"],"failClosedRules":["Grading cannot persist without rubric contract identity or scoring fallback metadata.","Model output must validate before being accepted as rubric evidence.","Rubric changes require version history so old credentials remain explainable."]},{"id":"primitive-contract-mission","primitive":"mission","name":"Mission","category":"learning","purpose":"Packages practice into a guided loop that can include scenarios, tools, workflow steps, timed drills, daily practice, or team competition tasks.","owns":["Practice objective","Mission steps","Target skill atoms","Tool requirements","Completion evidence"],"requiredFields":["id","title","role","difficulty","steps","evidenceRequired"],"relationships":["Belongs to learning paths, daily missions, tool mission catalogs, and competitions","Creates workflow sessions and step attempts","Feeds streak, XP, credential, and manager evidence"],"evidenceProduced":["Mission completion","Tool practice artifact","Workflow step attempt","Daily practice streak"],"sourceModules":["src/lib/platform/daily-missions.ts","src/lib/platform/tool-mission-catalog.ts","src/lib/platform/team-competitions.ts","src/lib/db/schema.ts:toolMissionStepAttempts"],"apiSurfaces":["/api/daily-missions","/api/tool-missions","/api/team-competitions","/api/workflow-portfolio"],"failClosedRules":["Mission completion cannot award evidence without required step proof.","Tool missions must respect the approved tool catalog for the learner role.","Practice scoring cannot be promoted to credential evidence without the required rubric gate."]},{"id":"primitive-contract-learning-path","primitive":"learning_path","name":"Learning Path","category":"learning","purpose":"Orders baseline assessment, missions, simulations, tool practice, workflow proof, exit assessment, and credentials for a role or company academy.","owns":["Path sequence","Maturity track","Role target","Manager evidence plan","Credential handoff"],"requiredFields":["id","targetRole","track","steps","skillsGained","managerEvidence"],"relationships":["Assembles courses, missions, scenarios, skill atoms, assessments, and credentials","Can be personalized after baseline assessment","Feeds manager coaching reports and weekly skill reports"],"evidenceProduced":["Learning plan","Path progress","Before/after readiness movement","Credential eligibility"],"sourceModules":["src/lib/platform/learning-paths.ts","src/lib/platform/personalized-learning-plans.ts","src/lib/platform/weekly-skill-reports.ts"],"apiSurfaces":["/api/learning-path-catalog","/api/personalized-learning-plans","/api/weekly-skill-reports"],"failClosedRules":["A path without role context routes to role selection or baseline assessment.","Manager evidence is read-only until attempts and results exist.","Personalized paths must preserve tenant content visibility."]},{"id":"primitive-contract-assessment","primitive":"assessment","name":"Assessment","category":"grading","purpose":"Measures baseline or exit readiness using role scenarios, rubric contracts, tool practice, and policy safety gates.","owns":["Assessment timing","Scenario set","Pass criteria","Blocking gates","Remediation routing"],"requiredFields":["id","role","type","scenarioIds","rubricContractIds","passingCriteria"],"relationships":["Starts personalized learning plans","Closes learning paths with exit evidence","Feeds readiness scores, benchmarks, manager reports, and credentials"],"evidenceProduced":["Baseline readiness score","Exit readiness score","Dimension movement","Remediation plan"],"sourceModules":["src/lib/platform/exit-assessments.ts","src/lib/platform/readiness-score-model.ts","src/lib/readiness/service.ts","src/app/api/readiness/assessment-options/route.ts"],"apiSurfaces":["/api/readiness/assessment-options","/api/exit-assessments","/api/readiness/score-model"],"failClosedRules":["Exit assessment cannot issue credentials when blocking safety gates fail.","Baseline results must not overwrite historical exit evidence.","Assessment evidence must keep rubric contract version metadata."]},{"id":"primitive-contract-attempt","primitive":"attempt","name":"Attempt","category":"grading","purpose":"Captures a learner submission, workflow step, simulation turn, or mission action before it becomes a scored result.","owns":["Submitted response","Attempt number","Scenario or step reference","Session context","Timestamp"],"requiredFields":["id","userId","scenarioId","response","createdAt"],"relationships":["Belongs to a user, scenario, mission, workflow session, or assessment","Receives one or more grading results","Can become proof artifact input after validation"],"evidenceProduced":["Raw learner response reference","Workflow step history","Simulation transcript checkpoint","Retake and improvement trail"],"sourceModules":["src/lib/db/schema.ts:gradingResults","src/lib/db/schema.ts:workflowStepAttempts","src/lib/db/schema.ts:toolMissionStepAttempts","src/app/api/grading/universal/route.ts"],"apiSurfaces":["/api/grading/universal","/api/workflow-portfolio","/api/tool-missions"],"failClosedRules":["Attempts require identity before being persisted as readiness evidence.","Oversized or prompt-injection-like submissions must be rejected or flagged before grading.","Attempt data is never exported without proof metadata and tenant filtering."]},{"id":"primitive-contract-result","primitive":"result","name":"Result","category":"grading","purpose":"Stores the evaluated outcome of an attempt, including scores, feedback, failure modes, evidence, and skill atom performance.","owns":["Scores","Feedback","Suggestions","Dimension scores","Failure mode detections","Evidence collected"],"requiredFields":["id","userId","scenarioId","response","scores","percentage","rubricContractId","createdAt"],"relationships":["Belongs to one attempt or scenario response","References rubric contract and version","Feeds readiness score, proof artifacts, credentials, and manager reports"],"evidenceProduced":["Universal grading result","Skill atom result","Readiness score contribution","Manager coaching signal"],"sourceModules":["src/lib/db/schema.ts:gradingResults","src/lib/platform/grading-coverage.ts","src/lib/platform/proof-artifacts.ts","src/lib/platform/manager-coaching-reports.ts"],"apiSurfaces":["/api/grading/universal","/api/grading-coverage","/api/proof-artifacts","/api/manager-coaching-reports"],"failClosedRules":["Result payloads must pass schema validation before persistence.","Failed safety gates cannot be hidden by high aggregate score.","Result exports expose proof references, not private raw responses by default."]},{"id":"primitive-contract-credential","primitive":"credential","name":"Credential","category":"evidence","purpose":"Proves a learner demonstrated a defined set of AI skills through certificates, badges, readiness scores, portfolios, and evidence trails.","owns":["Certificate number","Verification hash","Credential status","Skills completed","Expiration or renewal policy"],"requiredFields":["id","userId","courseId","certificateNumber","finalScore","passingScore","verificationHash","status"],"relationships":["Belongs to a user and course","References skill atoms and proof artifacts","Feeds certification registry, HRIS exports, and public verification"],"evidenceProduced":["Verifiable certificate","Skill badge","Credential registry record","Renewal evidence"],"sourceModules":["src/lib/db/schema.ts:certificates","src/lib/platform/credentials.ts","src/lib/platform/certification-registry.ts","src/lib/platform/proof-artifacts.ts"],"apiSurfaces":["/api/credentials/catalog","/api/certification-registry","/certificates/verify","/api/evidence-export-center"],"failClosedRules":["Credential issuance requires passing score and required proof artifacts.","Revoked or expired credentials must verify as inactive.","Public verification cannot reveal private scenario text or learner submissions."]},{"id":"primitive-contract-manager-report","primitive":"manager_report","name":"Manager Report","category":"evidence","purpose":"Turns learner results into team-level coaching, readiness movement, risk, credential progress, and next actions.","owns":["Team rollup","Learner rows","Weak dimensions","Coaching actions","Export format"],"requiredFields":["id","role","teamScope","learners","rollups","managerActions"],"relationships":["Aggregates attempts, results, assessments, credentials, and proof artifacts","Feeds org dashboards, department benchmarks, and export center","Can be viewed only by permitted managers and admins"],"evidenceProduced":["Manager coaching report","Readiness improvement summary","Team remediation list","Exportable report packet"],"sourceModules":["src/lib/platform/manager-coaching-reports.ts","src/lib/platform/department-benchmark-reports.ts","src/lib/platform/proof-artifacts.ts","src/lib/platform/access-control.ts"],"apiSurfaces":["/api/manager-coaching-reports","/api/department-benchmark-reports","/api/proof-artifacts","/api/evidence-export-center"],"failClosedRules":["Managers cannot inspect another org or team without permission.","Reports must separate coaching insight from private raw learner content.","Exported reports require tenant, time period, and evidence references."]},{"id":"primitive-contract-org-readiness-dashboard","primitive":"org_readiness_dashboard","name":"Org Readiness Dashboard","category":"enterprise","purpose":"Shows company-level AI capability, risk, policy comprehension, workflow improvement, credential coverage, and adoption value.","owns":["Department readiness","Skill coverage","Adoption risk","ROI confidence","Executive actions"],"requiredFields":["orgId","departments","readinessScores","riskSignals","evidenceLinks"],"relationships":["Aggregates manager reports, org skills map, benchmarks, credentials, policy training, and ROI dashboards","Routes leaders to rollout decisions and governance actions","Exports audit and board-ready evidence packets"],"evidenceProduced":["Workforce AI readiness dashboard","Org skills map","Adoption risk dashboard","Productivity ROI dashboard","Compliance evidence packet"],"sourceModules":["src/lib/platform/org-readiness-dashboard.ts","src/lib/platform/org-skills-map.ts","src/lib/platform/adoption-risk-dashboard.ts","src/lib/platform/adoption-roi-dashboard.ts"],"apiSurfaces":["/api/org-readiness-dashboard","/api/org-skills-map","/api/adoption-risk-dashboard","/api/adoption-roi-dashboard"],"failClosedRules":["Dashboard rows require tenant-scoped source evidence.","Executive views should aggregate sensitive learner evidence by default.","Scale recommendations require readiness, risk, and proof artifact coverage."]}]}