@aikdna/kdna-core 0.12.1 → 0.12.3

package/README.md

@@ -1,10 +1,10 @@
 # @aikdna/kdna-core
 
-Core library for KDNA judgment assets.
+Core library for local `.kdna` judgment assets.
 
-KDNA Core v1 defines the official `.kdna` source/container contract used by
-the CLI, Studio export, skills, MCP integrations, and downstream agent
-runtimes.
+KDNA Core v1 defines the `.kdna` file format, schemas, secure container
+reader, LoadPlan contract, and runtime projection helpers used by the CLI,
+Studio export, skills, MCP integrations, and downstream agent runtimes.
 
 ## Installation
 
@@ -26,9 +26,10 @@ Use the `./v1` entrypoint for current KDNA Core v1 tooling:
 const {
   inspect,
   validate,
+  planLoad,
+  loadAuthorized,
   pack,
   unpack,
-  loadV1,
   buildChecksumsV1
 } = require('@aikdna/kdna-core/v1');
 
@@ -37,7 +38,12 @@ if (!validation.overall_valid) {
   throw new Error(validation.problems.join('\n'));
 }
 
-const compact = loadV1('./asset.kdna', {
+const plan = planLoad('./asset.kdna');
+if (plan.can_load_now !== true) {
+  throw new Error(`Asset is not loadable yet: ${plan.required_action}`);
+}
+
+const compact = loadAuthorized('./asset.kdna', {
   profile: 'compact',
   as: 'prompt'
 });
@@ -50,7 +56,8 @@ v1 source directory
 → buildChecksumsV1
 → pack
 → validate
-→ loadV1
+→ planLoad
+→ loadAuthorized
 → agent/runtime context
 ```
 
@@ -75,7 +82,7 @@ A v1 `.kdna` container is a zip package of the same files. `validate()` checks:
 
 ## Load Profiles
 
-`loadV1()` supports:
+`loadAuthorized()` supports:
 
 - `index`
 - `compact`
@@ -89,15 +96,14 @@ Output formats:
 
 ## Boundary
 
-KDNA Core v1 is content-neutral. It does not recommend assets, assign quality
-badges, run a marketplace, or define a public registry. Future signature,
-encryption, licensing, and entitlement work is gated outside the current v1
-baseline.
+KDNA Core v1 is content-neutral. It validates file structure and loadability;
+it does not rank judgment quality or endorse specific assets.
 
 ## Legacy API
 
 The package root still exports compatibility APIs for older KDNA paths. New
-tooling should prefer `@aikdna/kdna-core/v1`.
+tooling should prefer `@aikdna/kdna-core/v1` and the `planLoad` /
+`loadAuthorized` path.
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aikdna/kdna-core",
-  "version": "0.12.1",
-  "description": "KDNA core library — load, validate, lint, and render KDNA domain judgment assets. Supports KDNA Container format (payload.kdnab via CBOR).",
+  "version": "0.12.3",
+  "description": "KDNA Core library for validating, planning, and loading local .kdna judgment assets.",
   "type": "commonjs",
   "main": "src/index.js",
   "module": "src/index.mjs",
@@ -35,7 +35,7 @@
     "kdna",
     "kdna-core",
     "ai-agent",
-    "domain-cognition"
+    "judgment-assets"
   ],
   "license": "Apache-2.0",
   "repository": {

package/schema/manifest.schema.json

@@ -71,7 +71,12 @@
       "additionalProperties": true,
       "properties": {
         "name": { "type": "string", "minLength": 1 },
-        "id": { "type": "string" }
+        "id": { "type": "string" },
+        "creator_type": {
+          "type": "string",
+          "enum": ["human", "agent", "tool", "organization"],
+          "description": "Kind of creator identity represented by this record."
+        }
       },
       "description": "Who produced the asset. Provenance only; not a trust claim."
     },

package/src/types.d.ts

@@ -560,6 +560,7 @@ export function planLoad(inputPath: string, options?: { password?: string; hasPa
 export function buildChecksumsV1(sourceDir: string): KDNAV1Checksums;
 export function pack(sourceDir: string, outputPath: string): void;
 export function unpack(inputPath: string, outputDir: string): void;
+export function loadAuthorized(inputPath: string, options?: { profile?: 'index' | 'compact' | 'scenario' | 'full' | string; as?: 'json' | 'prompt' | string }): Record<string, any>;
 export function loadV1(inputPath: string, options?: { profile?: 'index' | 'compact' | 'scenario' | 'full' | string; as?: 'json' | 'prompt' | string }): Record<string, any>;
 export const FORBIDDEN_OUTPUT_TERMS: readonly string[];
 

package/src/v1/index.js

@@ -1374,6 +1374,12 @@ function loadV1(inputPath, opts = {}) {
   return loadAuthorized(inputPath, opts);
 }
 
+function normalizeTextList(value) {
+  if (Array.isArray(value)) return value.filter((item) => typeof item === 'string' && item.trim()).map((item) => item.trim());
+  if (typeof value === 'string' && value.trim()) return [value.trim()];
+  return [];
+}
+
 function normalizeCompactAxiom(axiom) {
   if (typeof axiom === 'string') {
     return {
@@ -1393,8 +1399,8 @@ function normalizeCompactAxiom(axiom) {
     id: axiom.id || null,
     statement,
     one_sentence: axiom.one_sentence || statement,
-    applies_when: Array.isArray(axiom.applies_when) ? axiom.applies_when : [],
-    does_not_apply_when: Array.isArray(axiom.does_not_apply_when) ? axiom.does_not_apply_when : [],
+    applies_when: normalizeTextList(axiom.applies_when),
+    does_not_apply_when: normalizeTextList(axiom.does_not_apply_when),
     failure_risk: axiom.failure_risk || null,
   };
 }