@aikdna/kdna-studio-cli 0.9.2 → 0.10.1

package/README.md

@@ -125,6 +125,11 @@ A KDNA runtime export contains only these top-level entries:
 - `payload.kdnab`
 - `checksums.json`
 
+The current producer writes `format_version: 0.1.0`, payload profile
+`kdna.payload.judgment` with `profile_version: 0.1.0`, and digest profile
+`kdna.digest-basis.runtime-entry-set` with `digest_profile_version: 0.1.0`.
+These compatibility coordinates are independent of package versions.
+
 Authoring/source entries such as `KDNA_Core.json`, `KDNA_Patterns.json`, and
 `source_cards` are not runtime distribution entries. They may exist in Studio
 compile output or legacy imports, but they must not be emitted by the runtime
@@ -161,6 +166,11 @@ kdna-studio create forked --from-kdna ./parent.kdna --name @scope/forked
 kdna-studio create migrated --from-folder ./old-domain-json --name @scope/migrated
 ```
 
+Current `.kdna` imports also preserve explicitly declared `highest_question`,
+`worldview`, ordered `value_order`, and `judgment_role` values in the editable
+project. Re-export writes those values back exactly; Studio does not infer a
+replacement judgment core from an axiom.
+
 ## Related
 
 - [KDNA Core](https://github.com/aikdna/kdna) — Official format specification

package/bin/kdna-studio.js

@@ -9,7 +9,7 @@ const { execFileSync } = require('child_process');
 
 function loadStudioCore() {
   const publishedCore = require('@aikdna/kdna-studio-core');
-  if (publishedCore.exportRuntime) return publishedCore;
+  if (publishedCore.exportRuntime && publishedCore.protocolContract) return publishedCore;
   try {
     return require('../../kdna-studio-core/src');
   } catch (_) {
@@ -26,6 +26,7 @@ const {
   creator: creatorApi,
   distillation: distillationApi,
   exportRuntime,
+  protocolContract,
 } = loadStudioCore();
 
 const llm = require('../src/llm');
@@ -513,14 +514,10 @@ function cardsFromRuntimePayload(payload) {
   for (const item of (Array.isArray(payload.cases) ? payload.cases : [])) {
     pushImportedCard(cards, 'case', item, item.id || null);
   }
-  // Accept both `self_check` (canonical) and `self_checks` (legacy schema
-  // name) so we round-trip assets written by either version of the
-  // payload-profile schema. Bug (#53): prior version used
-  // `arr || []`, which would crash with "object is not iterable" if
-  // the field was a truthy non-array (e.g. a single `{question: ...}`
-  // object instead of an array). The fix guards with Array.isArray.
-  const rawSelfCheck = payload.reasoning?.self_check
-    || payload.reasoning?.self_checks;
+  // The current payload contract has one self-check field. Refuse to infer a
+  // parallel field name: Core validation owns format migration, while Studio
+  // imports only the current validated payload shape.
+  const rawSelfCheck = payload.reasoning?.self_check;
   const selfCheckArr = Array.isArray(rawSelfCheck) ? rawSelfCheck : [];
   for (const selfCheck of selfCheckArr) {
     const fields = typeof selfCheck === 'string' ? { question: selfCheck } : selfCheck;
@@ -567,12 +564,27 @@ function cardsFromRuntimePayload(payload) {
 
 function cardsFromPayload(payload) {
   if (!payload || typeof payload !== 'object') return [];
-  if (payload.profile === 'judgment-profile-v1' || payload.core || payload.source_cards) {
+  if (
+    payload.profile === protocolContract.PAYLOAD_PROFILE &&
+    payload.profile_version === protocolContract.PAYLOAD_PROFILE_VERSION
+  ) {
     return cardsFromRuntimePayload(payload);
   }
   return [];
 }
 
+function judgmentCoreFromRuntimePayload(payload) {
+  const core = payload?.core;
+  if (!core || typeof core !== 'object' || Array.isArray(core)) return null;
+  const declared = {};
+  for (const field of ['highest_question', 'worldview', 'value_order', 'judgment_role']) {
+    if (Object.hasOwn(core, field)) {
+      declared[field] = JSON.parse(JSON.stringify(core[field]));
+    }
+  }
+  return Object.keys(declared).length > 0 ? declared : null;
+}
+
 function buildManifest(project, name) {
   // Bug (#58): prior version was a hand-rolled manifest builder that
   // shared zero logic with the canonical buildManifest in
@@ -591,7 +603,7 @@ function buildManifest(project, name) {
   const assetId = assetIdFromName(name || source.name || project.name);
   const author = source.author || project.author || {};
   return {
-    kdna_version: '1.0',
+    format_version: protocolContract.FORMAT_VERSION,
     asset_id: assetId,
     asset_uid: project.asset_uid || source.asset_uid || 'urn:uuid:' + crypto.randomUUID(),
     asset_type: project.type === 'cluster' ? 'cluster' : 'domain',
@@ -605,7 +617,11 @@ function buildManifest(project, name) {
       name: author.name || project.author?.name || 'Studio Export',
       id: author.id || project.author?.id || undefined,
     },
-    compatibility: { min_loader_version: '1.0.0', profile: 'judgment-profile-v1' },
+    compatibility: {
+      min_loader_version: '0.19.0',
+      profile: protocolContract.PAYLOAD_PROFILE,
+      profile_version: protocolContract.PAYLOAD_PROFILE_VERSION,
+    },
     payload: { path: 'payload.kdnab', encoding: 'cbor', encrypted: false },
     summary: source.core_insight || project.release?.description || source.description || '',
     description: source.description || project.release?.description || '',
@@ -664,6 +680,7 @@ function cmdCreate(args) {
         sourceMode,
         creatorIdentity,
         lineage,
+        judgmentCore: kdnaData.judgment_core,
       });
       project.cards = kdnaData.cards;
       // Bug #15 / #28 follow-up: store the source KDNA_* files on the
@@ -763,12 +780,14 @@ function importFromKdna(kdnaPath) {
   // Current assets carry strict-CBOR `payload.kdnab`. Legacy source folders
   // are migrated explicitly with --from-folder; they are not runtime assets.
   const importedCards = [];
+  let judgmentCore = null;
   if (!entries.has('payload.kdnab')) {
     fail('Not a current .kdna asset: missing payload.kdnab. Use --from-folder for legacy JSON source migration.');
   }
   try {
     const payload = decodePayload(entries.get('payload.kdnab'), manifest);
     importedCards.push(...cardsFromPayload(payload));
+    judgmentCore = judgmentCoreFromRuntimePayload(payload);
   } catch (e) {
     fail(`Could not import cards from payload.kdnab: ${e.message}`);
   }
@@ -786,6 +805,7 @@ function importFromKdna(kdnaPath) {
   return {
     lineage,
     cards: importedCards,
+    judgment_core: judgmentCore,
     source_manifest: manifest,
     source_patterns: null,
     source_reasoning: null,
@@ -834,6 +854,8 @@ function importFromFolder(sourceDir, projectDir, projectName, creatorIdentity, o
     if (manifest.core_insight) manifestData.core_insight = manifest.core_insight;
     if (manifest.created_at || manifest.created) manifestData.created = manifest.created_at || manifest.created;
     if (manifest.updated_at || manifest.updated) manifestData.updated = manifest.updated_at || manifest.updated;
+    // legacy-migration bookkeeping only: preserved in the Studio project for
+    // issuer-scoped governance; the Core 0.20 export manifest never projects it
     if (manifest.risk_level) manifestData.risk_level = manifest.risk_level;
     if (manifest.fitness_for_purpose) manifestData.fitness_for_purpose = manifest.fitness_for_purpose;
   }
@@ -1936,7 +1958,7 @@ function cmdStudioInstall(args) {
 function cmdStudioUpdate(args) {
   const target = args[0];
   if (!target) fail('Usage: kdna-studio update <@scope/name>');
-  // kdna update does not exist in kdna-cli v0.28.x. The correct
+  // kdna update does not exist in kdna-cli 0.28.x. The correct
   // path is to re-install via npm or use kdna install to pull
   // the latest published version of the asset.
   console.log(`To update ${target}, run:`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aikdna/kdna-studio-cli",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "description": "Official KDNA Studio command-line authoring entry for creating, reviewing, compiling, and exporting .kdna judgment assets through the KDNA toolchain.",
   "type": "commonjs",
   "bin": {
@@ -14,11 +14,18 @@
     "README.md"
   ],
   "scripts": {
-    "lint": "node --check bin/kdna-studio.js && node --check tests/cli.test.js",
+    "lint": "node scripts/run-lint.js",
+    "pretest": "node scripts/acquire-trusted-npm-release.js",
     "test": "node --test tests/*.test.js",
-    "test:all": "npm run lint && npm test",
+    "test:all": "node scripts/run-test-all.js",
+    "test:runtime": "node scripts/run-product-tests.js",
+    "test:candidate-chain": "node scripts/verify-runtime-candidate-chain.js",
+    "verify:candidate-sources": "node scripts/verify-runtime-candidate-sources.js",
+    "check:protocol-names": "node scripts/check-current-protocol-names.js",
     "release:check": "node scripts/release-check.js",
-    "prepublishOnly": "npm test && npm run release:check"
+    "release:generate-evidence": "node scripts/generate-release-evidence.js",
+    "release:publish-verified": "node scripts/publish-verified-artifact.js",
+    "prepublishOnly": "node scripts/run-test-all.js && node scripts/verify-runtime-candidate-chain.js && node scripts/release-check.js"
   },
   "keywords": [
     "kdna",
@@ -41,13 +48,12 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@aikdna/kdna-core": "0.17.0",
-    "@aikdna/kdna-studio-core": "1.9.0",
+    "@aikdna/kdna-core": "0.20.0",
+    "@aikdna/kdna-studio-core": "2.0.1",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "cbor-x": "^1.6.4"
   },
-  "main": "index.js",
   "directories": {
     "test": "tests"
   },