@takuhon/core 0.4.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takuhon/core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "JSON Schema, validation, normalization, locale resolution, and JSON-LD generation for takuhon",
   "license": "Apache-2.0",
   "author": "Takuhon contributors",

package/takuhon.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://takuhon.example/schemas/0.2.0/takuhon.schema.json",
+  "$id": "https://takuhon.example/schemas/0.4.0/takuhon.schema.json",
   "title": "Takuhon Profile",
   "description": "Portable profile data format consumed by @takuhon/core. The canonical contract for profile content authored as takuhon.json.",
   "type": "object",
@@ -88,6 +88,16 @@
       "maxItems": 50,
       "items": { "$ref": "#/$defs/Patent" }
     },
+    "testScores": {
+      "type": "array",
+      "maxItems": 30,
+      "items": { "$ref": "#/$defs/TestScore" }
+    },
+    "recommendations": {
+      "type": "array",
+      "maxItems": 50,
+      "items": { "$ref": "#/$defs/Recommendation" }
+    },
     "contact": { "$ref": "#/$defs/Contact" },
     "settings": { "$ref": "#/$defs/Settings" },
     "meta": { "$ref": "#/$defs/Meta" }
@@ -400,7 +410,7 @@
     "MetaPrivacy": {
       "type": "object",
       "additionalProperties": true,
-      "description": "Opt-out flags that strip personally identifying fields from public API output (GET /api/profile, /api/jsonld, /takuhon.json). Admin endpoints (PUT /api/admin/*, GET /api/export) ignore these flags. Privacy-by-default: omitting the object or individual flags is equivalent to true.",
+      "description": "Opt-out flags that strip personally identifying fields from public API output (GET /api/profile, /api/jsonld, /takuhon.json). Admin endpoints (PUT /api/admin/*, GET /api/admin/export) ignore these flags. Privacy-by-default: omitting the object or individual flags is equivalent to true.",
       "properties": {
         "hideCredentialIds": {
           "type": "boolean",
@@ -604,6 +614,74 @@
         },
         "order": { "type": "integer", "minimum": 0 }
       }
+    },
+    "TestScore": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "score", "date"],
+      "properties": {
+        "id": { "$ref": "#/$defs/Slug" },
+        "title": { "$ref": "#/$defs/LocalizedTitle" },
+        "score": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 50,
+          "description": "Free-form score string (e.g. '112 / 120', '330', 'N1 Pass', or a percentile). The validator does not interpret its contents."
+        },
+        "date": { "$ref": "#/$defs/YearMonth" },
+        "relatedEducationId": {
+          "$ref": "#/$defs/Slug",
+          "description": "Optional reference to an education[].id (e.g. for a university course exam)."
+        },
+        "description": { "$ref": "#/$defs/LocalizedBody" },
+        "url": { "$ref": "#/$defs/Url" },
+        "order": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "Recommendation": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "body", "author"],
+      "properties": {
+        "id": { "$ref": "#/$defs/Slug" },
+        "body": { "$ref": "#/$defs/LocalizedBody" },
+        "author": { "$ref": "#/$defs/RecommendationAuthor" },
+        "relationship": {
+          "$ref": "#/$defs/LocalizedTitle",
+          "description": "How the recommender relates to the profile owner (e.g. 'managed directly', 'worked together')."
+        },
+        "date": { "$ref": "#/$defs/YearMonth" },
+        "relatedCareerId": {
+          "$ref": "#/$defs/Slug",
+          "description": "Optional reference to a careers[].id (the position the recommendation pertains to)."
+        },
+        "relatedEducationId": {
+          "$ref": "#/$defs/Slug",
+          "description": "Optional reference to an education[].id (e.g. a recommendation from a professor)."
+        },
+        "order": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "RecommendationAuthor": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "description": "Recommender's name, in its original script. Owner-curated; takuhon does not verify it."
+        },
+        "headline": {
+          "$ref": "#/$defs/LocalizedTitle",
+          "description": "Recommender's title / role / organization at the time of the recommendation."
+        },
+        "url": {
+          "$ref": "#/$defs/Url",
+          "description": "Link to the recommender's profile, for external verification by the reader."
+        }
+      }
     }
   }
 }