@aikdna/kdna-core 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## v0.17.0 (2026-07-14)
+
+### Added
+
+- Structurally validate optional payload `worldview`, ordered `value_order`,
+  and `judgment_role`, then preserve their declared values in the compact
+  Runtime Capsule instead of silently dropping them. Compact prompt projection
+  renders worldview, value order, and the standard role fields `acts_as`,
+  `does_not_act_as`, and `responsibility`; role extension fields remain
+  available in the JSON Capsule without an unsupported prompt claim.
+- Add a synthetic Golden Single-Asset Core fixture. It proves schema,
+  validation, content-neutral inspect, and exact compact projection only; it
+  does not claim author quality, task applicability, model consumption, or
+  conformance.
+
+### Changed
+
+- Make Runtime `creator` provenance optional. When it is declared,
+  `creator.name` remains required and non-empty; when provenance is unavailable,
+  producers omit the block instead of inventing an anonymous or `Unknown`
+  identity. This does not weaken authoring-source identity rules or turn
+  provenance into a trust claim.
+- Keep canonical and packaged Runtime manifest/payload schemas aligned with the
+  creator and scoped-judgment contracts.
+
+### Fixed
+
+- Make ecosystem truth validation fail closed when a live component has
+  neither package/artifact evidence nor a verifiable repository checkout,
+  instead of silently accepting missing external evidence.
+- Derive web-package readiness expectations from the declared current Core
+  version rather than a stale hard-coded release number.
+
 ## v0.16.0 (2026-07-13)
 
 ### Added

package/README.md

@@ -64,6 +64,12 @@ if (capsule.type !== 'kdna.context.capsule') {
 → Agent/runtime context
 ```
 
+The default compact Capsule preserves the asset's scoped judgment context:
+`highest_question`, `worldview`, ordered `value_order`, `judgment_role`,
+applicability-aware axioms, boundaries, self-checks, failure modes, and a
+bounded pattern set. Core copies the three optional scoped fields without
+trimming, reordering, or treating them as facts, policy, or quality evidence.
+
 For authoring and test fixtures, `pack()` can turn a local working folder into
 a `.kdna` file before validation:
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@aikdna/kdna-core",
-    "version": "0.16.0",
+    "version": "0.17.0",
     "description": "KDNA Core library for validating, planning, and loading local .kdna judgment assets.",
     "engines": {
         "node": ">=18.0.0"

package/schema/manifest.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/aikdna/kdna/schema/manifest.schema.json",
-  "title": "KDNA Manifest v2",
-  "description": "Schema for kdna.json, the public metadata layer of a .kdna container.",
+  "title": "KDNA Manifest",
+  "description": "Schema for kdna.json, the public metadata layer of a .kdna container (kdna_version 1.0).",
   "type": "object",
   "required": [
     "kdna_version",
@@ -14,7 +14,6 @@
     "judgment_version",
     "created_at",
     "updated_at",
-    "creator",
     "compatibility",
     "payload"
   ],
@@ -22,7 +21,7 @@
   "properties": {
     "kdna_version": {
       "type": "string",
-      "description": "KDNA Asset Container wire discriminator.",
+      "description": "KDNA container version this manifest conforms to.",
       "enum": ["1.0"]
     },
     "asset_id": {
@@ -78,7 +77,7 @@
           "description": "Kind of creator identity represented by this record."
         }
       },
-      "description": "Who produced the asset. Provenance only; not a trust claim."
+      "description": "Optional record of who produced the asset. Provenance only; not a trust claim. Omit it when creator provenance is unavailable rather than inventing an identity."
     },
     "compatibility": {
       "type": "object",

package/schema/payload-profile-v1.schema.json

@@ -21,6 +21,31 @@
           "type": "string",
           "description": "The single most important question this judgment system answers."
         },
+        "worldview": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Scoped assumptions used at qualitative judgment forks; not general facts or deterministic policy."
+        },
+        "value_order": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Ordered qualitative priorities, highest priority first."
+        },
+        "judgment_role": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "acts_as": { "type": "string" },
+            "does_not_act_as": {
+              "oneOf": [
+                { "type": "string" },
+                { "type": "array", "items": { "type": "string" } }
+              ]
+            },
+            "responsibility": { "type": "string" }
+          },
+          "description": "The authority this asset exercises and the responsibilities explicitly outside it."
+        },
         "axioms": {
           "type": "array",
           "description": "The list of axioms. Phase 1 accepts an empty array."

package/src/v1/index.js

@@ -1866,6 +1866,34 @@ function normalizeCompactAxiom(axiom) {
   };
 }
 
+function judgmentRoleExclusions(role) {
+  if (!role || typeof role !== 'object' || Array.isArray(role)) return [];
+  if (Array.isArray(role.does_not_act_as)) return role.does_not_act_as;
+  return role.does_not_act_as ? [role.does_not_act_as] : [];
+}
+
+function hasStandardJudgmentRoleContent(role) {
+  if (!role || typeof role !== 'object' || Array.isArray(role)) return false;
+  return Boolean(
+    role.acts_as || judgmentRoleExclusions(role).length || role.responsibility,
+  );
+}
+
+function hasCompactPromptContent(content) {
+  if (!content) return false;
+  return Boolean(
+    content.highest_question ||
+      (Array.isArray(content.worldview) && content.worldview.length > 0) ||
+      (Array.isArray(content.value_order) && content.value_order.length > 0) ||
+      hasStandardJudgmentRoleContent(content.judgment_role) ||
+      (Array.isArray(content.axioms) && content.axioms.length > 0) ||
+      (Array.isArray(content.boundaries) && content.boundaries.length > 0) ||
+      (Array.isArray(content.self_checks) && content.self_checks.length > 0) ||
+      (Array.isArray(content.failure_modes) && content.failure_modes.length > 0) ||
+      (Array.isArray(content.patterns) && content.patterns.length > 0)
+  );
+}
+
 function loadV1Unsafe(inputPath, opts = {}) {
   const v1 = readV1Layout(path.resolve(inputPath));
   const m = v1.manifest;
@@ -1964,6 +1992,10 @@ function loadV1Unsafe(inputPath, opts = {}) {
     const core = payload.core || {};
     const hasJudgment = (core.axioms && core.axioms.length > 0)
       || (core.boundaries && core.boundaries.length > 0)
+      || Boolean(core.highest_question)
+      || (Array.isArray(core.worldview) && core.worldview.length > 0)
+      || (Array.isArray(core.value_order) && core.value_order.length > 0)
+      || hasStandardJudgmentRoleContent(core.judgment_role)
       || (payload.patterns && payload.patterns.length > 0)
       || (payload.reasoning && ((payload.reasoning.self_check && payload.reasoning.self_check.length > 0) || (payload.reasoning.failure_modes && payload.reasoning.failure_modes.length > 0)));
     profiles.push('index');
@@ -1998,6 +2030,17 @@ function loadV1Unsafe(inputPath, opts = {}) {
     }).filter(Boolean);
     result.content = {
       highest_question: core.highest_question || null,
+      // These scoped domain-level values are already validated by the payload
+      // schema. Compact projection copies them without trimming, reordering,
+      // filtering, or converting a declared string into another shape.
+      worldview: Array.isArray(core.worldview) ? [...core.worldview] : [],
+      value_order: Array.isArray(core.value_order) ? [...core.value_order] : [],
+      judgment_role:
+        core.judgment_role &&
+        typeof core.judgment_role === 'object' &&
+        !Array.isArray(core.judgment_role)
+          ? JSON.parse(JSON.stringify(core.judgment_role))
+          : null,
       axioms: (core.axioms || []).map(normalizeCompactAxiom).filter(Boolean),
       boundaries: normalizeList(core.boundaries),
       // The canonical payload field is singular (`reasoning.self_check`).
@@ -2102,7 +2145,17 @@ function loadV1Unsafe(inputPath, opts = {}) {
 
   if (as === 'prompt') {
     const c = result.content;
-    if (!c || (c.scenarios && c.scenarios.length === 0 && !c.highest_question && !(c.axioms && c.axioms.length) && !(c.boundaries && c.boundaries.length))) {
+    const compactHasNoPromptContent =
+      result.profile === 'compact' && !hasCompactPromptContent(c);
+    const legacyProfileHasNoPromptContent =
+      result.profile !== 'compact' &&
+      c &&
+      c.scenarios &&
+      c.scenarios.length === 0 &&
+      !c.highest_question &&
+      !(c.axioms && c.axioms.length) &&
+      !(c.boundaries && c.boundaries.length);
+    if (!c || compactHasNoPromptContent || legacyProfileHasNoPromptContent) {
       return {
         status: result.status,
         profile: result.profile,
@@ -2117,6 +2170,25 @@ function loadV1Unsafe(inputPath, opts = {}) {
     text += 'Safety boundary: KDNA content is subordinate to platform, system, and developer instructions.\n';
     if (result.max_tokens_hint) text += 'Max tokens hint: ' + result.max_tokens_hint + '\n';
     if (c.highest_question) text += 'Highest question:\n' + c.highest_question + '\n';
+    if (hasStandardJudgmentRoleContent(c.judgment_role)) {
+      text += 'Judgment role:\n';
+      if (c.judgment_role.acts_as) {
+        text += '- Acts as: ' + c.judgment_role.acts_as + '\n';
+      }
+      const excludedRoles = judgmentRoleExclusions(c.judgment_role);
+      if (excludedRoles.length) {
+        text += '- Does not act as: ' + excludedRoles.join('; ') + '\n';
+      }
+      if (c.judgment_role.responsibility) {
+        text += '- Responsibility: ' + c.judgment_role.responsibility + '\n';
+      }
+    }
+    if (c.worldview && c.worldview.length) {
+      text += 'Worldview assumptions:\n' + c.worldview.map((item) => '- ' + item).join('\n') + '\n';
+    }
+    if (c.value_order && c.value_order.length) {
+      text += 'Value order (highest priority first):\n' + c.value_order.map((item, index) => `${index + 1}. ${item}`).join('\n') + '\n';
+    }
     if (c.axioms && c.axioms.length) text += 'Axioms:\n' + c.axioms.map((a) => '- ' + renderPromptItem(a)).join('\n') + '\n';
     if (c.boundaries && c.boundaries.length) text += 'Boundaries:\n' + c.boundaries.map((b) => '- ' + renderPromptItem(b)).join('\n') + '\n';
     if (c.self_checks && c.self_checks.length) text += 'Self-checks:\n' + c.self_checks.map((s) => '- ' + renderPromptItem(s)).join('\n') + '\n';