schema-resume-validator 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e49ee98c8f5eb9d19a35053731446e94e6e9cc12471a92c965d39ab8eb5855c
-  data.tar.gz: 0326c213338e27f959ed7b4e515a409892a0c3ab06ca7d95a398b6a08635e611
+  metadata.gz: 4d785a0e550c5e5eb9d7ab2bbb6e7d0977dfab6dcee108d6b934f2e0de3754b2
+  data.tar.gz: c5b97fc92f8a9aa8c9a4c8a5846e74018d946273263b65abafed1bdb76e8ff00
 SHA512:
-  metadata.gz: ea78337519c989d8f312ced4e5fac349bdb6bb2719aeb14f72d45608f823f94f23e739d54ebe76fe8a6c501a9e3d12c1189529778e0bb1e111ce33165cb41b3c
-  data.tar.gz: 414898422facfaeab31184cc9688e783a8721a3273b3b4fdb2c2c89a78471984a37729f19427084734de50f6a79cca19911faf4ca993415e875a2fd10b24531c
+  metadata.gz: 9e36c63753da817fd4a629e34caf08820ed60201854aa9f97c8b21f85d8b8b6db021db533d880f7cc88fffdcfd26980a0fa4262ef2ff0eef07f2f85bf9e53fcb
+  data.tar.gz: cef33601db4d1b1f3ad9b993dc0c8eab890daeff126a1c24a2601dc41a8038b93471d578c743f68d5efffc17d59b92cb16e623fd41ee4958cf8b2ebda3a6af48

data/schemas/context.jsonld

@@ -27,6 +27,11 @@
       "@type": "xsd:string"
     },
     
+    "demographics": {
+      "@id": "schema:Person",
+      "@type": "@id"
+    },
+    
     "age": {
       "@id": "schema:age",
       "@type": "xsd:integer"
@@ -192,7 +197,13 @@
       "@type": "@id",
       "@container": "@list"
     },
-    
+
+    "positions": {
+      "@id": "schema:hasOccupation",
+      "@type": "@id",
+      "@container": "@list"
+    },
+
     "position": {
       "@id": "schema:jobTitle",
       "@type": "xsd:string"

data/schemas/meta-schema.json

@@ -1,11 +1,10 @@
 {
-  "$schema": "https://schema-resume.org/meta-schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://schema-resume.org/meta-schema.json",
   "$comment": "Primary domain: https://schema-resume.org/ | Alternate domain: https://tradik.github.io/schema-resume/",
-  "title": "Schema Resume Meta-Schema v1.1.0",
+  "title": "Schema Resume Meta-Schema v1.3.0",
   "description": "Self-hosted meta-schema providing validation rules for resume documents without external dependencies",
   "type": "object",
-  "version": "1.1.0",
   "definitions": {
     "schemaArray": {
       "type": "array",

data/schemas/schema-resume.xsd

@@ -3,11 +3,11 @@
            xmlns:sr="https://schema-resume.org/xml/1.0"
            targetNamespace="https://schema-resume.org/xml/1.0"
            elementFormDefault="qualified"
-           version="1.1.0">
+           version="1.3.0">
 
   <xs:annotation>
     <xs:documentation>
-      Schema Resume XML Schema Definition (XSD) v1.1.0
+      Schema Resume XML Schema Definition (XSD) v1.3.0
       Self-hosted XML schema for CV/Resume validation with work authorization and tools tracking
       
       This schema provides comprehensive validation for resume/CV documents in XML format.
@@ -17,7 +17,7 @@
       Primary domain: https://schema-resume.org/
       Alternate domain: https://tradik.github.io/schema-resume/
       
-      Version: 1.1.0
+      Version: 1.3.0
       License: MIT
       Repository: https://github.com/tradik/schema-resume
     </xs:documentation>
@@ -105,15 +105,33 @@
     </xs:sequence>
   </xs:complexType>
 
+  <!--
+    Protected personal characteristics. Omit unless the receiving market expects
+    them: in the UK and most of the EU a CV should not carry age, date of birth
+    or gender. Grouped so that including them is a deliberate choice and a
+    processor can strip them in one step.
+  -->
+  <xs:complexType name="DemographicsType">
+    <xs:sequence>
+      <xs:element name="age" type="xs:integer" minOccurs="0"/>
+      <xs:element name="dateOfBirth" type="sr:iso8601DateType" minOccurs="0"/>
+      <xs:element name="gender" type="xs:string" minOccurs="0"/>
+    </xs:sequence>
+    <xs:attribute name="type" type="xs:string"/>
+  </xs:complexType>
+
   <!-- Basics Section -->
   <xs:complexType name="BasicsType">
     <xs:sequence>
       <xs:element name="name" type="xs:string" minOccurs="0"/>
       <xs:element name="label" type="xs:string" minOccurs="0"/>
       <xs:element name="title" type="xs:string" minOccurs="0"/>
+      <!-- DEPRECATED since 1.3.0: use <demographics>. Kept, in their original
+           sequence position, so every 1.x document keeps validating. -->
       <xs:element name="age" type="xs:integer" minOccurs="0"/>
       <xs:element name="dateOfBirth" type="sr:iso8601DateType" minOccurs="0"/>
       <xs:element name="gender" type="xs:string" minOccurs="0"/>
+      <xs:element name="demographics" type="sr:DemographicsType" minOccurs="0"/>
       <xs:element name="legalNote" type="sr:LegalNoteType" minOccurs="0"/>
       <xs:element name="image" type="xs:anyURI" minOccurs="0"/>
       <xs:element name="email" type="xs:string" minOccurs="0"/>
@@ -201,6 +219,25 @@
       <xs:element name="endDate" type="sr:iso8601DateType" minOccurs="0"/>
       <xs:element name="summary" type="xs:string" minOccurs="0"/>
       <xs:element name="highlights" type="sr:StringListType" minOccurs="0"/>
+      <xs:element name="positions" type="sr:PositionListType" minOccurs="0"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Multiple roles held at the same organization over time (career progression) -->
+  <xs:complexType name="PositionListType">
+    <xs:sequence>
+      <xs:element name="item" type="sr:PositionType" minOccurs="0" maxOccurs="unbounded"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="PositionType">
+    <xs:sequence>
+      <xs:element name="position" type="xs:string" minOccurs="0"/>
+      <xs:element name="workType" type="sr:workTypeEnum" minOccurs="0"/>
+      <xs:element name="startDate" type="sr:iso8601DateType" minOccurs="0"/>
+      <xs:element name="endDate" type="sr:iso8601DateType" minOccurs="0"/>
+      <xs:element name="summary" type="xs:string" minOccurs="0"/>
+      <xs:element name="highlights" type="sr:StringListType" minOccurs="0"/>
     </xs:sequence>
   </xs:complexType>
 
@@ -223,6 +260,16 @@
     </xs:sequence>
   </xs:complexType>
 
+  <!-- Legal disclaimers, consent statements, or data processing notes -->
+  <xs:complexType name="LegalNoteType">
+    <xs:sequence>
+      <xs:element name="text" type="xs:string" minOccurs="0"/>
+      <xs:element name="country" type="sr:countryCodeType" minOccurs="0"/>
+      <xs:element name="type" type="xs:string" minOccurs="0"/>
+      <xs:element name="url" type="xs:anyURI" minOccurs="0"/>
+    </xs:sequence>
+  </xs:complexType>
+
   <!-- Volunteer Section -->
   <xs:complexType name="VolunteerType">
     <xs:sequence>

data/schemas/schema.json

@@ -1,23 +1,7 @@
 {
-  "@context": {
-    "@vocab": "https://schema-resume.org/",
-    "schema": "http://schema.org/",
-    "xsd": "http://www.w3.org/2001/XMLSchema#",
-    "name": "schema:name",
-    "email": "schema:email",
-    "url": "schema:url",
-    "telephone": "schema:telephone",
-    "address": "schema:address",
-    "jobTitle": "schema:jobTitle",
-    "worksFor": "schema:worksFor",
-    "alumniOf": "schema:alumniOf",
-    "award": "schema:award",
-    "knowsAbout": "schema:knowsAbout",
-    "knowsLanguage": "schema:knowsLanguage"
-  },
-  "$schema": "https://schema-resume.org/meta-schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://schema-resume.org/schema.json",
-  "$comment": "Primary domain: https://schema-resume.org/ | Alternate domain: https://tradik.github.io/schema-resume/",
+  "$comment": "The JSON-LD context for documents that follow this schema is published separately at https://schema-resume.org/context.jsonld — a resume document references it from its own @context. Until 1.3.0 a 14-term fragment of it was embedded here as a top-level @context, which covered 9 of the 102 canonical terms, defined 7 that did not exist, contradicted the canonical definition of `address`, and made this file fail JSON Schema strict-mode validation as an unknown keyword.",
   "additionalProperties": true,
   "definitions": {
     "iso8601": {
@@ -59,16 +43,45 @@
         },
         "age": {
           "type": "integer",
-          "description": "Age of the person in years",
+          "description": "DEPRECATED since 1.3.0 — use basics.demographics.age. Still accepted so that every 1.x document keeps validating; scheduled for removal in 2.0.0.",
+          "deprecated": true,
           "minimum": 0
         },
         "dateOfBirth": {
           "$ref": "#/definitions/iso8601",
-          "description": "Date of birth in ISO 8601 format"
+          "description": "DEPRECATED since 1.3.0 — use basics.demographics.dateOfBirth. Still accepted so that every 1.x document keeps validating; scheduled for removal in 2.0.0.",
+          "deprecated": true
         },
         "gender": {
           "type": "string",
-          "description": "Gender identity of the person"
+          "description": "DEPRECATED since 1.3.0 — use basics.demographics.gender. Still accepted so that every 1.x document keeps validating; scheduled for removal in 2.0.0.",
+          "deprecated": true
+        },
+        "demographics": {
+          "type": "object",
+          "description": "Protected personal characteristics. Omit this object entirely unless the receiving market expects it. In the UK and most of the EU a CV should not carry age, date of birth or gender: they are protected characteristics under the Equality Act 2010 and comparable law, employers are advised not to request them, and including them invites discrimination claims. Some markets, notably Germany and Japan, do conventionally include a date of birth. Provided as a separate object so that supplying it is a deliberate choice and so that a processor can drop it in one step.",
+          "additionalProperties": true,
+          "properties": {
+            "@type": {
+              "type": "string",
+              "description": "Schema.org type. Use 'Person' for Schema.org validation.",
+              "default": "Person"
+            },
+            "age": {
+              "type": "integer",
+              "description": "Age in years. Derived data that goes stale; prefer dateOfBirth if either is genuinely required.",
+              "minimum": 0,
+              "maximum": 150
+            },
+            "dateOfBirth": {
+              "$ref": "#/definitions/iso8601",
+              "description": "Date of birth in ISO 8601 format. Conventional in some markets (DE, JP), discouraged in others (UK, US)."
+            },
+            "gender": {
+              "type": "string",
+              "description": "Gender identity, in the person's own words. Free text on purpose: an enumeration here would exclude people. In the EU this may be special-category data under GDPR Article 9."
+            }
+          }
         },
         "legalNote": {
           "type": "object",
@@ -119,7 +132,6 @@
         "keyAchievements": {
           "type": "array",
           "description": "Notable career achievements and accomplishments",
-          "additionalItems": false,
           "items": {
             "type": "string",
             "description": "Individual achievement"
@@ -128,7 +140,6 @@
         "coreCompetencies": {
           "type": "array",
           "description": "Core professional competencies and areas of expertise",
-          "additionalItems": false,
           "items": {
             "type": "string",
             "description": "Competency or area of expertise"
@@ -167,7 +178,6 @@
         "profiles": {
           "type": "array",
           "description": "List of social media and professional network profiles",
-          "additionalItems": false,
           "items": {
             "type": "object",
             "additionalProperties": true,
@@ -191,7 +201,6 @@
         "nationalities": {
           "type": "array",
           "description": "Citizenship and nationality information",
-          "additionalItems": false,
           "items": {
             "type": "object",
             "additionalProperties": true,
@@ -214,7 +223,6 @@
         "workAuthorization": {
           "type": "array",
           "description": "Work authorization information for multiple countries",
-          "additionalItems": false,
           "items": {
             "type": "object",
             "additionalProperties": true,
@@ -256,7 +264,6 @@
     "work": {
       "type": "array",
       "description": "Employment history including current and previous positions",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -365,11 +372,53 @@
           "highlights": {
             "type": "array",
             "description": "Notable achievements and accomplishments in this role",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Individual achievement or accomplishment"
             }
+          },
+          "positions": {
+            "type": "array",
+            "description": "Multiple roles held at the same organization over time, capturing career progression such as promotions. Use this to avoid repeating organization details (name, location, url) for each role. The top-level 'position', 'startDate', 'endDate', 'summary', and 'highlights' fields remain valid for single-role entries; prefer either the singular fields or this array, not both, for the same information.",
+            "items": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "@type": {
+                  "type": "string",
+                  "description": "Schema.org type, should be 'schema:EmployeeRole' for validator.schema.org compatibility"
+                },
+                "position": {
+                  "type": "string",
+                  "description": "Job title or role held at the organization (e.g., 'Senior Software Engineer')"
+                },
+                "workType": {
+                  "type": "string",
+                  "description": "Type of work arrangement (remote, hybrid, onsite, full-time, part-time, contract, freelance, internship, temporary)",
+                  "enum": ["remote", "hybrid", "onsite", "full-time", "part-time", "contract", "freelance", "internship", "temporary"]
+                },
+                "startDate": {
+                  "$ref": "#/definitions/iso8601",
+                  "description": "Date when this role began"
+                },
+                "endDate": {
+                  "$ref": "#/definitions/iso8601",
+                  "description": "Date when this role ended (omit if currently in this role)"
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "Overview of responsibilities within this specific role"
+                },
+                "highlights": {
+                  "type": "array",
+                  "description": "Notable achievements and accomplishments in this specific role",
+                  "items": {
+                    "type": "string",
+                    "description": "Individual achievement or accomplishment"
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -377,7 +426,6 @@
     "volunteer": {
       "type": "array",
       "description": "Volunteer work and community involvement activities",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -414,7 +462,6 @@
           "highlights": {
             "type": "array",
             "description": "Key accomplishments and impact made through volunteer work",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Specific achievement or contribution"
@@ -426,7 +473,6 @@
     "education": {
       "type": "array",
       "description": "Academic qualifications and educational background",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -487,7 +533,6 @@
           "courses": {
             "type": "array",
             "description": "Relevant modules, courses, or subjects studied",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Course name or code"
@@ -499,7 +544,6 @@
     "awards": {
       "type": "array",
       "description": "Professional awards, honours, and recognitions received",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -530,7 +574,6 @@
     "certificates": {
       "type": "array",
       "description": "Professional certifications and accreditations obtained",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -558,7 +601,6 @@
     "publications": {
       "type": "array",
       "description": "Published works including papers, articles, and books",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -590,7 +632,6 @@
     "skills": {
       "type": "array",
       "description": "Technical and professional competencies",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -615,7 +656,6 @@
           "keywords": {
             "type": "array",
             "description": "Specific technologies, tools, or techniques within this skill area",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Technology or tool name"
@@ -627,7 +667,6 @@
     "tools": {
       "type": "array",
       "description": "Specific tools, software, and platforms used professionally",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -668,7 +707,6 @@
     "languages": {
       "type": "array",
       "description": "Languages spoken and proficiency levels",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -691,7 +729,6 @@
     "interests": {
       "type": "array",
       "description": "Personal interests and hobbies outside of work",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -707,7 +744,6 @@
           "keywords": {
             "type": "array",
             "description": "Specific topics or activities within this interest",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Specific topic or activity"
@@ -719,7 +755,6 @@
     "references": {
       "type": "array",
       "description": "Professional references and testimonials",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -738,7 +773,6 @@
     "projects": {
       "type": "array",
       "description": "Personal and professional projects undertaken",
-      "additionalItems": false,
       "items": {
         "type": "object",
         "additionalProperties": true,
@@ -758,7 +792,6 @@
           "highlights": {
             "type": "array",
             "description": "Key features, achievements, or outcomes of the project",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Individual highlight or achievement"
@@ -767,7 +800,6 @@
           "keywords": {
             "type": "array",
             "description": "Technologies, methodologies, or tools used in the project",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Technology or tool name"
@@ -789,7 +821,6 @@
           "roles": {
             "type": "array",
             "description": "Roles held or responsibilities taken in the project",
-            "additionalItems": false,
             "items": {
               "type": "string",
               "description": "Role or responsibility"
@@ -842,8 +873,7 @@
       }
     }
   },
-  "title": "Schema Resume v1.1.0",
+  "title": "Schema Resume v1.3.0",
   "description": "Self-hosted JSON-LD schema for CV/Resume parsing and validation with work authorization and tools tracking",
-  "type": "object",
-  "version": "1.1.0"
+  "type": "object"
 }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schema-resume-validator
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Schema Resume
@@ -9,22 +9,28 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-27 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json-schema
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement