@forwardimpact/schema 0.1.0 → 0.2.0

package/lib/schema-validation.js

@@ -227,7 +227,7 @@ async function validateDirectory(ajv, dirPath, schemaId) {
  * @returns {string} Full schema $id URL
  */
 function getSchemaId(schemaFilename) {
-  return `https://schema.forwardimpact.team/json/${schemaFilename}`;
+  return `https://www.forwardimpact.team/schema/json/${schemaFilename}`;
 }
 
 /**

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@forwardimpact/schema",
-  "version": "0.1.0",
-  "description": "Schema definitions and validation for Engineering Pathway framework",
+  "version": "0.2.0",
+  "description": "Schema definitions and data loading for skills, behaviours, and role frameworks",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/forwardimpact/pathway",
+    "url": "https://github.com/forwardimpact/monorepo",
     "directory": "apps/schema"
   },
+  "homepage": "https://www.forwardimpact.team/schema",
   "type": "module",
   "main": "lib/index.js",
   "bin": {
     "fit-schema": "./bin/fit-schema.js"
   },
   "scripts": {
-    "validate": "node ./bin/fit-schema.js validate",
     "generate-index": "node ./bin/fit-schema.js generate-index",
-    "validate:shacl": "node ./bin/fit-schema.js validate:shacl"
+    "validate": "node ./bin/fit-schema.js validate"
   },
   "files": [
     "bin/",

package/schema/json/behaviour-questions.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/behaviour-questions.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/behaviour-questions.schema.json",
   "title": "Behaviour Interview Questions",
   "description": "Interview questions for a behaviour, organized by maturity level",
   "type": "object",

package/schema/json/behaviour.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/behaviour.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/behaviour.schema.json",
   "title": "Behaviour",
   "description": "Mindset and way of working that underpins effective application of skills",
   "type": "object",

package/schema/json/capability.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/capability.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/capability.schema.json",
   "title": "Capability",
   "description": "Capability area that groups related skills with responsibilities and checklists",
   "type": "object",

package/schema/json/defs.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/defs.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/defs.schema.json",
   "title": "Engineering Pathway Common Definitions",
   "description": "Shared definitions for all pathway schemas",
   "$defs": {

package/schema/json/discipline.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/discipline.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/discipline.schema.json",
   "title": "Discipline",
   "description": "Engineering specialization that defines T-shaped skill profiles",
   "type": "object",

package/schema/json/drivers.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/drivers.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/drivers.schema.json",
   "title": "Drivers",
   "description": "Organizational outcomes that productive teams achieve",
   "type": "array",

package/schema/json/framework.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/framework.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/framework.schema.json",
   "title": "Framework",
   "description": "High-level framework configuration and entity definitions",
   "type": "object",

package/schema/json/grades.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/grades.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/grades.schema.json",
   "title": "Grades",
   "description": "Career levels defining expectations for skill proficiency, behaviour maturity, and scope of impact",
   "type": "array",

package/schema/json/self-assessments.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/self-assessments.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/self-assessments.schema.json",
   "title": "Self Assessments",
   "description": "Example candidate profiles for testing candidate matching",
   "type": "array",

package/schema/json/skill-questions.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/skill-questions.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/skill-questions.schema.json",
   "title": "Skill Interview Questions",
   "description": "Interview questions for a skill, organized by level",
   "type": "object",

package/schema/json/stages.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/stages.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/stages.schema.json",
   "title": "Stages",
   "description": "Engineering lifecycle stages with their tools, handoffs, and constraints",
   "type": "array",

package/schema/json/track.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schema.forwardimpact.team/json/track.schema.json",
+  "$id": "https://www.forwardimpact.team/schema/json/track.schema.json",
   "title": "Track",
   "description": "Work context that modifies skill and behaviour expectations",
   "type": "object",

package/schema/rdf/behaviour-questions.ttl

@@ -0,0 +1,96 @@
+@prefix fit: <https://www.forwardimpact.team/schema/rdf/> .
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+
+# =============================================================================
+# Behaviour Questions Schema
+# =============================================================================
+# Interview questions for assessing behaviours.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:forBehaviour a rdf:Property ;
+    rdfs:label "forBehaviour"@en ;
+    rdfs:comment "The behaviour this question assesses"@en ;
+    rdfs:domain fit:Question ;
+    rdfs:range fit:Behaviour .
+
+fit:atMaturity a rdf:Property ;
+    rdfs:label "atMaturity"@en ;
+    rdfs:comment "The behaviour maturity this question is for"@en ;
+    rdfs:domain fit:Question ;
+    rdfs:range fit:BehaviourMaturity .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Behaviour Question Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourQuestionShape a sh:NodeShape ;
+    sh:targetClass fit:Question ;
+    sh:property [
+        sh:path fit:id ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "id" ;
+        sh:description "Unique question identifier" ;
+    ] ;
+    sh:property [
+        sh:path fit:text ;
+        sh:datatype xsd:string ;
+        sh:maxLength 150 ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "text" ;
+        sh:description "The question text (under 150 characters)" ;
+    ] ;
+    sh:property [
+        sh:path fit:lookingFor ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 4 ;
+        sh:name "lookingFor" ;
+        sh:description "2-4 bullet points of good answer indicators" ;
+    ] ;
+    sh:property [
+        sh:path fit:expectedDurationMinutes ;
+        sh:datatype xsd:integer ;
+        sh:minInclusive 1 ;
+        sh:maxCount 1 ;
+        sh:name "expectedDurationMinutes" ;
+        sh:description "Expected duration in minutes" ;
+    ] ;
+    sh:property [
+        sh:path fit:followUps ;
+        sh:datatype xsd:string ;
+        sh:maxCount 3 ;
+        sh:name "followUps" ;
+        sh:description "1-3 probing questions for deeper exploration" ;
+    ] ;
+    sh:property [
+        sh:path fit:forBehaviour ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "forBehaviour" ;
+        sh:description "The behaviour this question assesses (behaviour ID)" ;
+    ] ;
+    sh:property [
+        sh:path fit:atMaturity ;
+        sh:in ( fit:emerging fit:developing fit:practicing fit:role_modeling fit:exemplifying ) ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "atMaturity" ;
+        sh:description "The behaviour maturity this question is for" ;
+    ] .

package/schema/rdf/behaviour.ttl

@@ -0,0 +1,130 @@
+@prefix fit: <https://www.forwardimpact.team/schema/rdf/> .
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+
+# =============================================================================
+# Behaviour Schema
+# =============================================================================
+# Mindset and way of working that underpins effective application of skills.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Classes
+# -----------------------------------------------------------------------------
+
+fit:Behaviour a rdfs:Class ;
+    rdfs:label "Behaviour"@en ;
+    rdfs:comment "Mindset and way of working that underpins effective application of skills"@en .
+
+fit:BehaviourHumanSection a rdfs:Class ;
+    rdfs:label "Behaviour Human Section"@en ;
+    rdfs:comment "Human-specific content for a behaviour"@en .
+
+fit:BehaviourAgentSection a rdfs:Class ;
+    rdfs:label "Behaviour Agent Section"@en ;
+    rdfs:comment "Agent-specific content for a behaviour"@en .
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:maturityDescriptions a rdf:Property ;
+    rdfs:label "maturityDescriptions"@en ;
+    rdfs:comment "Description of expectations at each maturity level"@en ;
+    rdfs:range fit:MaturityDescriptions .
+
+fit:workingStyle a rdf:Property ;
+    rdfs:label "workingStyle"@en ;
+    rdfs:comment "How the agent should apply this behaviour"@en ;
+    rdfs:domain fit:BehaviourAgentSection ;
+    rdfs:range xsd:string .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Behaviour Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourShape a sh:NodeShape ;
+    sh:targetClass fit:Behaviour ;
+    sh:property [
+        sh:path fit:id ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:maxCount 1 ;
+        sh:name "id" ;
+        sh:description "Behaviour identifier (derived from filename)" ;
+    ] ;
+    sh:property [
+        sh:path fit:name ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "name" ;
+        sh:description "Human-readable behaviour name" ;
+    ] ;
+    sh:property [
+        sh:path fit:human ;
+        sh:node fit:BehaviourHumanSectionShape ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "human" ;
+        sh:description "Human-specific content" ;
+    ] ;
+    sh:property [
+        sh:path fit:agent ;
+        sh:node fit:BehaviourAgentSectionShape ;
+        sh:maxCount 1 ;
+        sh:name "agent" ;
+        sh:description "Agent-specific content" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Behaviour Human Section Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourHumanSectionShape a sh:NodeShape ;
+    sh:targetClass fit:BehaviourHumanSection ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the behaviour" ;
+    ] ;
+    sh:property [
+        sh:path fit:maturityDescriptions ;
+        sh:node fit:MaturityDescriptionsShape ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "maturityDescriptions" ;
+        sh:description "Description of expectations at each maturity level" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Behaviour Agent Section Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourAgentSectionShape a sh:NodeShape ;
+    sh:targetClass fit:BehaviourAgentSection ;
+    sh:property [
+        sh:path fit:title ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "title" ;
+        sh:description "Short title for the behaviour's agent application" ;
+    ] ;
+    sh:property [
+        sh:path fit:workingStyle ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "workingStyle" ;
+        sh:description "How the agent should apply this behaviour" ;
+    ] .