@klickd/core 4.0.0 → 4.0.2

package/starter-skills/student.klickd

@@ -0,0 +1,240 @@
+{
+  "klickd_version": "4.0",
+  "payload_schema_version": "4.0.0-preview.1",
+  "domain_schema_version": "v4-starter-1.0",
+  "created_at": "2026-05-26T00:00:00Z",
+  "encrypted": false,
+  "domain": "education",
+  "profile_kind": "learner",
+  "_pack_metadata": {
+    "kind": "starter_skill_pack",
+    "non_normative": true,
+    "claims_v41_ga": false,
+    "contains_real_pii": false,
+    "contains_secrets": false,
+    "see_readme": "examples/v4/starter-skills/README.md",
+    "note": "Non-normative starter skill pack on the v4.0 envelope."
+  },
+  "x_klickd_pack": {
+    "pack": "x.klickd/student",
+    "pack_version": "0.1.0-starter",
+    "spec_ref": "examples/v4/starter-skills/README.md",
+    "publisher": {
+      "name": "klickd",
+      "ref": "https://klickd.app"
+    },
+    "frameworks": [
+      {
+        "scheme": "esco",
+        "version": "v1.1.1",
+        "iri_prefix": "http://data.europa.eu/esco/skill/",
+        "canonical_url": "https://esco.ec.europa.eu/en/classification/skill_main"
+      },
+      {
+        "scheme": "digcomp",
+        "version": "2.2",
+        "iri_prefix": "https://joint-research-centre.ec.europa.eu/digcomp/2.2/",
+        "canonical_url": "https://joint-research-centre.ec.europa.eu/digcomp_en"
+      },
+      {
+        "scheme": "lifecomp",
+        "version": "2020",
+        "iri_prefix": "https://joint-research-centre.ec.europa.eu/lifecomp/2020/",
+        "canonical_url": "https://joint-research-centre.ec.europa.eu/lifecomp_en"
+      },
+      {
+        "scheme": "eqf",
+        "version": "2017",
+        "iri_prefix": "https://europa.eu/europass/eqf/",
+        "canonical_url": "https://europa.eu/europass/en/europass-tools/european-qualifications-framework"
+      },
+      {
+        "scheme": "cefr",
+        "version": "2020",
+        "iri_prefix": "https://www.coe.int/cefr/",
+        "canonical_url": "https://www.coe.int/en/web/common-european-framework-reference-languages"
+      }
+    ],
+    "base_transversal_core": {
+      "frameworks": [
+        {
+          "scheme": "esco",
+          "version": "v1.1.1"
+        },
+        {
+          "scheme": "digcomp",
+          "version": "2.2"
+        },
+        {
+          "scheme": "lifecomp",
+          "version": "2020"
+        },
+        {
+          "scheme": "eqf",
+          "version": "2017"
+        }
+      ],
+      "transversal_refs": [
+        {
+          "competency_ref": "esco:S2",
+          "scheme": "esco",
+          "prefLabel": "information skills"
+        },
+        {
+          "competency_ref": "digcomp:1.2",
+          "scheme": "digcomp",
+          "prefLabel": "Evaluating data, information and digital content"
+        },
+        {
+          "competency_ref": "lifecomp:L2",
+          "scheme": "lifecomp",
+          "prefLabel": "Critical thinking"
+        },
+        {
+          "competency_ref": "lifecomp:L3",
+          "scheme": "lifecomp",
+          "prefLabel": "Managing learning"
+        }
+      ]
+    },
+    "identity": {
+      "pack_role": "student",
+      "display_name": null,
+      "school_or_institution_ref": null,
+      "enrolment_period": null
+    },
+    "competencies": [
+      {
+        "competency_ref": "esco:S2",
+        "scheme": "esco",
+        "prefLabel": "information skills"
+      },
+      {
+        "competency_ref": "digcomp:1.2",
+        "scheme": "digcomp",
+        "prefLabel": "Evaluating data, information and digital content"
+      },
+      {
+        "competency_ref": "digcomp:3.1",
+        "scheme": "digcomp",
+        "prefLabel": "Developing digital content"
+      },
+      {
+        "competency_ref": "lifecomp:L3",
+        "scheme": "lifecomp",
+        "prefLabel": "Managing learning"
+      }
+    ],
+    "levels": [
+      {
+        "framework_ref": "https://europa.eu/europass/eqf/level/4",
+        "level_label": "EQF level 4",
+        "effective_at": "2026-05-26"
+      }
+    ],
+    "language_proficiency": [],
+    "curriculum_refs": [],
+    "subjects": [
+      {
+        "subject_ref": "http://data.europa.eu/esco/isced-f/0541",
+        "prefLabel": "Mathematics",
+        "started_at": null,
+        "current_chapter_ref": null,
+        "coursework_pointer": null
+      }
+    ],
+    "mastery": [],
+    "preferences": {
+      "preferred_languages": [],
+      "pace_preference": null,
+      "modality_preference": [],
+      "feedback_cadence_preference": null,
+      "time_budget_per_week_minutes": null
+    },
+    "accessibility": {
+      "needs": [],
+      "accommodations": [],
+      "consent_to_disclose_to_agent": false
+    },
+    "exam_targets": [],
+    "history": [],
+    "gates": {
+      "verification_gates_default": {
+        "raise_only": true,
+        "claim_grounding_required": true,
+        "reversibility_threshold": "medium"
+      },
+      "human_veto_policy": {
+        "owner": "human_carrier",
+        "scope": [
+          "mastery_writes",
+          "exam_target_changes",
+          "accommodations_changes"
+        ]
+      }
+    },
+    "human_authority": {
+      "final_decision_owner": "human_carrier",
+      "agent_role": "advisory",
+      "escalation": "guardian_then_school"
+    },
+    "memory_scope": "memory.x_klickd.student",
+    "structured_memory": {
+      "scope": "memory.x_klickd.student",
+      "policy": "pack_scoped_only",
+      "entries": []
+    },
+    "evidence_policy": {
+      "required_for_claims": true,
+      "pointer_only": true,
+      "attestation_shape_ref": "rfc-002#8b"
+    },
+    "source_policy": {
+      "allow_inline_definitions": false,
+      "language_tags": [
+        "en",
+        "fr"
+      ]
+    },
+    "verification_gates": {
+      "version": 1,
+      "user_default": "silent",
+      "gates": [
+        {
+          "id": "exam-claim",
+          "action_class": "factual_claim_with_date",
+          "level": "confirm",
+          "reason": "Exam dates and curriculum claims require grounding before assertion."
+        },
+        {
+          "id": "mastery-write",
+          "action_class": "carrier_state_write",
+          "level": "confirm",
+          "reason": "Writing to mastery[] changes carrier-recorded competence and requires explicit consent."
+        },
+        {
+          "id": "public-post",
+          "action_class": "public_post",
+          "level": "block",
+          "reason": "No public posting from a learner pack; minor-safe default."
+        }
+      ]
+    },
+    "router_cost": {
+      "tokens_estimate": 850,
+      "baseline": "base_plus_one"
+    },
+    "forbidden_fields": [
+      "pedagogy",
+      "teaching_method",
+      "socratic_steps",
+      "prompt_strategy",
+      "scoring_rubric",
+      "intervention_policy",
+      "tone_rules",
+      "system_prompt_overrides",
+      "knowledge.mastered",
+      "mastered_topics"
+    ]
+  }
+}

package/starter-skills/user.klickd

@@ -0,0 +1,224 @@
+{
+  "klickd_version": "4.0",
+  "payload_schema_version": "4.0.0-preview.1",
+  "domain_schema_version": "v4-starter-1.0",
+  "created_at": "2026-05-26T00:00:00Z",
+  "encrypted": false,
+  "domain": "transversal",
+  "profile_kind": "carrier_base",
+  "_pack_metadata": {
+    "kind": "starter_skill_pack",
+    "non_normative": true,
+    "claims_v41_ga": false,
+    "contains_real_pii": false,
+    "contains_secrets": false,
+    "see_readme": "examples/v4/starter-skills/README.md",
+    "note": "Non-normative starter skill pack on the v4.0 envelope."
+  },
+  "x_klickd_pack": {
+    "pack": "x.klickd/user",
+    "pack_version": "0.1.0-starter",
+    "spec_ref": "examples/v4/starter-skills/README.md",
+    "publisher": {
+      "name": "klickd",
+      "ref": "https://klickd.app"
+    },
+    "frameworks": [
+      {
+        "scheme": "esco",
+        "version": "v1.1.1",
+        "iri_prefix": "http://data.europa.eu/esco/skill/",
+        "canonical_url": "https://esco.ec.europa.eu/en/classification/skill_main"
+      },
+      {
+        "scheme": "digcomp",
+        "version": "2.2",
+        "iri_prefix": "https://joint-research-centre.ec.europa.eu/digcomp/2.2/",
+        "canonical_url": "https://joint-research-centre.ec.europa.eu/digcomp_en"
+      },
+      {
+        "scheme": "lifecomp",
+        "version": "2020",
+        "iri_prefix": "https://joint-research-centre.ec.europa.eu/lifecomp/2020/",
+        "canonical_url": "https://joint-research-centre.ec.europa.eu/lifecomp_en"
+      },
+      {
+        "scheme": "eqf",
+        "version": "2017",
+        "iri_prefix": "https://europa.eu/europass/eqf/",
+        "canonical_url": "https://europa.eu/europass/en/europass-tools/european-qualifications-framework"
+      }
+    ],
+    "base_transversal_core": {
+      "frameworks": [
+        {
+          "scheme": "esco",
+          "version": "v1.1.1"
+        },
+        {
+          "scheme": "digcomp",
+          "version": "2.2"
+        },
+        {
+          "scheme": "lifecomp",
+          "version": "2020"
+        },
+        {
+          "scheme": "eqf",
+          "version": "2017"
+        }
+      ],
+      "transversal_refs": [
+        {
+          "competency_ref": "esco:S1",
+          "scheme": "esco",
+          "prefLabel": "communication, collaboration and creativity"
+        },
+        {
+          "competency_ref": "esco:S2",
+          "scheme": "esco",
+          "prefLabel": "information skills"
+        },
+        {
+          "competency_ref": "esco:S5",
+          "scheme": "esco",
+          "prefLabel": "working with computers"
+        },
+        {
+          "competency_ref": "digcomp:1.1",
+          "scheme": "digcomp",
+          "prefLabel": "Browsing, searching, filtering data, information and digital content"
+        },
+        {
+          "competency_ref": "digcomp:1.2",
+          "scheme": "digcomp",
+          "prefLabel": "Evaluating data, information and digital content"
+        },
+        {
+          "competency_ref": "lifecomp:L2",
+          "scheme": "lifecomp",
+          "prefLabel": "Critical thinking"
+        },
+        {
+          "competency_ref": "lifecomp:L3",
+          "scheme": "lifecomp",
+          "prefLabel": "Managing learning"
+        }
+      ]
+    },
+    "competencies": [
+      {
+        "competency_ref": "esco:S1",
+        "scheme": "esco",
+        "prefLabel": "communication, collaboration and creativity"
+      },
+      {
+        "competency_ref": "esco:S2",
+        "scheme": "esco",
+        "prefLabel": "information skills"
+      },
+      {
+        "competency_ref": "esco:S5",
+        "scheme": "esco",
+        "prefLabel": "working with computers"
+      },
+      {
+        "competency_ref": "digcomp:1.1",
+        "scheme": "digcomp",
+        "prefLabel": "Browsing, searching, filtering data, information and digital content"
+      },
+      {
+        "competency_ref": "digcomp:1.2",
+        "scheme": "digcomp",
+        "prefLabel": "Evaluating data, information and digital content"
+      }
+    ],
+    "levels": [
+      {
+        "framework_ref": "https://europa.eu/europass/eqf/level/4",
+        "level_label": "EQF level 4",
+        "effective_at": "2026-05-26"
+      }
+    ],
+    "language_proficiency": [],
+    "mastery": [],
+    "gates": {
+      "verification_gates_default": {
+        "raise_only": true,
+        "claim_grounding_required": true,
+        "reversibility_threshold": "medium"
+      },
+      "human_veto_policy": {
+        "owner": "human_carrier",
+        "scope": [
+          "public_post",
+          "identity_assertion",
+          "irreversible_action"
+        ]
+      }
+    },
+    "human_authority": {
+      "final_decision_owner": "human_carrier",
+      "agent_role": "advisory",
+      "escalation": "human_carrier_only"
+    },
+    "memory_scope": "memory.x_klickd.user",
+    "structured_memory": {
+      "scope": "memory.x_klickd.user",
+      "policy": "pack_scoped_only",
+      "entries": []
+    },
+    "evidence_policy": {
+      "required_for_claims": true,
+      "pointer_only": true,
+      "attestation_shape_ref": "rfc-002#8b"
+    },
+    "source_policy": {
+      "allow_inline_definitions": false,
+      "language_tags": [
+        "en",
+        "fr"
+      ]
+    },
+    "verification_gates": {
+      "version": 1,
+      "user_default": "silent",
+      "gates": [
+        {
+          "id": "factual-claim",
+          "action_class": "factual_claim_with_date",
+          "level": "confirm",
+          "reason": "Claims with dates require grounding (RFC-002 §8b)."
+        },
+        {
+          "id": "public-post",
+          "action_class": "public_post",
+          "level": "confirm",
+          "reason": "Public posting requires explicit human authorisation."
+        },
+        {
+          "id": "irreversible-action",
+          "action_class": "irreversible_action",
+          "level": "block",
+          "reason": "Irreversible actions blocked at base level; pack may raise but not lower."
+        }
+      ]
+    },
+    "router_cost": {
+      "tokens_estimate": 600,
+      "baseline": "base_plus_one"
+    },
+    "forbidden_fields": [
+      "pedagogy",
+      "teaching_method",
+      "socratic_steps",
+      "prompt_strategy",
+      "scoring_rubric",
+      "intervention_policy",
+      "tone_rules",
+      "system_prompt_overrides",
+      "knowledge.mastered",
+      "mastered_topics"
+    ]
+  }
+}

package/dist/klickd-payload-v4-preview.schema-W7RY72VP.json

@@ -1,98 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://klickd.app/schemas/v4-preview/klickd-payload.schema.json",
-  "title": "klickd Payload v4 Preview (PERMISSIVE, NON-NORMATIVE)",
-  "description": "PREVIEW schema for the .klickd v4 inner payload, targeting v4.0.0-preview.1. This schema is INTENTIONALLY PERMISSIVE: it accepts and preserves draft v4 structures (media_profile, verification_gates, human_veto_policy, claim_sources, verification_artifacts, migration, context_cost, profile_kind) without performing strict validation. additionalProperties is true at every level so that unknown fields round-trip verbatim. This schema MUST NOT be used to reject a file that is otherwise a valid v3.5.1 file. The normative schemas remain klickd-envelope-v3.schema.json and klickd-payload-v3.schema.json. See SPEC.md §33 and docs/rfcs/ for the design source.",
-  "type": "object",
-  "additionalProperties": true,
-  "properties": {
-    "preview": {
-      "type": "string",
-      "description": "Marks a file as belonging to a specific preview iteration. Recommended value for files written against this schema: 'v4.0.0-preview.1'. Absent in v3.x files."
-    },
-    "payload_schema_version": {
-      "type": "string",
-      "description": "Payload schema version. PERMISSIVE in this preview: any string is accepted. A future strict v4 schema MAY pin this to a concrete value."
-    },
-    "domain_schema_version": {
-      "type": "string",
-      "description": "Domain-specific schema version (e.g. 'education-1.2'). PERMISSIVE in this preview."
-    },
-    "profile_kind": {
-      "type": "string",
-      "description": "Top-level discriminator for the profile shape. Common values: 'learner', 'agent', 'team', 'robot'. v3.x is implicitly 'learner'; the preview makes this explicit and extensible. Custom strings are permitted."
-    },
-    "media_profile": {
-      "description": "RFC-001: portable, hash-referenced media context. Bytes live outside the .klickd file by default; the payload carries metadata, hashes, and (optionally) inline base64 below a documented threshold. PERMISSIVE: structure is not enforced here.",
-      "type": ["object", "array", "null"],
-      "additionalProperties": true
-    },
-    "verification_gates": {
-      "description": "RFC-002 v1: user's preferred friction profile, mapping action class to gate level (silent / warn / confirm / block / require-owner). PERMISSIVE: not enforced here.",
-      "type": ["object", "array", "null"],
-      "additionalProperties": true
-    },
-    "human_veto_policy": {
-      "description": "RFC-002 v1: standing rules about when a human MUST be in the loop, regardless of agent confidence. Overrides any lower gate. PERMISSIVE: not enforced here.",
-      "type": ["object", "null"],
-      "additionalProperties": true
-    },
-    "claim_sources": {
-      "description": "RFC-002 v1 + v2-additive: declarative preferences for where to ground factual claims, and records of what was actually used. PERMISSIVE: not enforced here.",
-      "type": ["object", "null"],
-      "additionalProperties": true
-    },
-    "verification_artifacts": {
-      "description": "RFC-002 §8b.8: pointer ledger of outputs already produced by expensive verification commands (test suites, builds, web fetches, DOI resolutions). MUST be a pointer ledger, not a payload sink. PERMISSIVE: structure is not enforced here.",
-      "type": ["array", "null"]
-    },
-    "error_journal": {
-      "description": "RFC-002 v1: append-only lessons learned that should influence future gate evaluation. PERMISSIVE: not enforced here.",
-      "type": ["array", "null"]
-    },
-    "risk_thresholds": {
-      "description": "RFC-002 v1: numeric / categorical knobs (e.g. public_reach, financial_amount_eur_max_silent). PERMISSIVE.",
-      "type": ["object", "null"],
-      "additionalProperties": true
-    },
-    "preflight_checks": {
-      "description": "RFC-002 v1: small, named checks an agent SHOULD run before acting on certain classes. PERMISSIVE.",
-      "type": ["array", "null"]
-    },
-    "contract_tests": {
-      "description": "RFC-002 v2-additive: machine-checkable contract tests bound to action classes. PERMISSIVE.",
-      "type": ["array", "null"]
-    },
-    "success_criteria": {
-      "description": "RFC-002 v2-additive: declarative success criteria per action class. PERMISSIVE.",
-      "type": ["object", "array", "null"],
-      "additionalProperties": true
-    },
-    "reversibility": {
-      "description": "RFC-002 v2-additive: declared reversibility for action classes. PERMISSIVE.",
-      "type": ["object", "null"],
-      "additionalProperties": true
-    },
-    "blast_radius": {
-      "description": "RFC-002 v2-additive: declared blast radius for action classes. PERMISSIVE.",
-      "type": ["object", "null"],
-      "additionalProperties": true
-    },
-    "migration": {
-      "description": "RFC-004: optional migration metadata block. Audit-only in this preview — no migration tooling ships with v4.0.0-preview.1. PERMISSIVE.",
-      "type": ["object", "null"],
-      "additionalProperties": true,
-      "properties": {
-        "source_version": {"type": "string"},
-        "migrated_at": {"type": "string"},
-        "migration_report_ref": {"type": "string"},
-        "backup_ref": {"type": "string"}
-      }
-    },
-    "context_cost": {
-      "description": "Research/benchmark track (benchmarks/context_cost/RFC.md): optional fields recording measured 'repeated context waste' for this profile. No normative semantics depend on this field. PERMISSIVE.",
-      "type": ["object", "null"],
-      "additionalProperties": true
-    }
-  }
-}