@aikdna/kdna-cli 0.17.0 → 0.19.0

package/src/cmds/registry.js

@@ -1,9 +1,8 @@
-const fs = require('fs');
-const path = require('path');
 const { CANONICAL_REGISTRY_URL, REGISTRY_CACHE, fetchRegistry } = require('../registry');
-const { error, readJson, loadRegistry, INSTALL_DIR, EXIT } = require('./_common');
+const { error, loadRegistry, EXIT } = require('./_common');
+const { listInstalled, readContainer } = require('../package-store');
 
-function cmdList(showAvailable, jsonMode = false, locale = null) {
+function cmdList(showAvailable, jsonMode = false, _locale = null) {
   if (showAvailable) {
     const domains = loadRegistry({ allowNetwork: true });
     if (!domains || !domains.length) {
@@ -33,9 +32,7 @@ function cmdList(showAvailable, jsonMode = false, locale = null) {
     console.log('');
     for (const d of domains) {
       const name = d.name || d.id || '?';
-      const [scope, ident] = name.includes('/') ? name.split('/') : [null, name];
-      const installedPath = scope ? path.join(INSTALL_DIR, scope, ident) : null;
-      const installed = installedPath && fs.existsSync(installedPath) ? '[installed]' : '';
+      const installed = listInstalled().some((entry) => entry.full === name) ? '[installed]' : '';
       const yanked = d.yanked ? '[yanked] ' : '';
       const dep = d.deprecated ? '[deprecated] ' : '';
       console.log(
@@ -47,78 +44,29 @@ function cmdList(showAvailable, jsonMode = false, locale = null) {
     return;
   }
 
-  if (!fs.existsSync(INSTALL_DIR)) {
-    if (jsonMode) {
-      console.log(JSON.stringify([]));
-      process.exit(EXIT.OK);
-    }
-    console.log('No domains installed.');
-    console.log(`Installation directory: ${INSTALL_DIR}`);
-    return;
-  }
-
-  // v0.7 layout: ~/.kdna/domains/@scope/name/
-  const scopes = fs.readdirSync(INSTALL_DIR).filter((d) => {
-    if (!d.startsWith('@')) return false;
-    try {
-      return fs.statSync(path.join(INSTALL_DIR, d)).isDirectory();
-    } catch {
-      return false;
-    }
-  });
-
-  const installed = [];
-  for (const scope of scopes) {
-    const sd = path.join(INSTALL_DIR, scope);
-    for (const ident of fs.readdirSync(sd)) {
-      if (ident.startsWith('.')) continue;
-      const full = path.join(sd, ident);
-      try {
-        if (!fs.statSync(full).isDirectory()) continue;
-      } catch {
-        continue;
-      }
-      installed.push({ scope, ident, full });
-    }
-  }
-
-  // Detect and warn about legacy (un-scoped) installs
-  if (!jsonMode) {
-    const legacy = fs.readdirSync(INSTALL_DIR).filter((d) => {
-      if (d.startsWith('@') || d.startsWith('.')) return false;
-      try {
-        return fs.statSync(path.join(INSTALL_DIR, d)).isDirectory();
-      } catch {
-        return false;
-      }
-    });
-    if (legacy.length) {
-      console.log('⚠ Legacy (un-scoped) directories detected — please remove + re-install:');
-      legacy.forEach((d) => console.log(`    ~/.kdna/domains/${d}/`));
-      console.log('');
-    }
-  }
+  const installed = listInstalled();
 
   if (!installed.length) {
     if (jsonMode) {
       console.log(JSON.stringify([]));
       process.exit(EXIT.OK);
     }
-    console.log('No v0.7 domains installed.');
+    console.log('No KDNA assets installed.');
     console.log(`Run: kdna install <name>      # e.g. kdna install writing`);
     return;
   }
 
   // Build structured data for installed domains
-  const domains = installed.map(({ scope, ident, full }) => {
-    const core = readJson(path.join(full, 'KDNA_Core.json'));
-    const manifest = readJson(path.join(full, 'kdna.json'));
-    const cluster = readJson(path.join(full, 'cluster.json'));
+  const domains = installed.map((entry) => {
+    const { core = {}, manifest = {} } = readContainer(entry.asset_path);
     return {
-      name: `${scope}/${ident}`,
-      version: manifest?.version || manifest?._source?.version || core?.meta?.version || '?',
-      type: cluster ? 'cluster' : 'domain',
+      name: entry.full,
+      version: manifest?.version || entry.version || core?.meta?.version || '?',
+      type: 'domain',
       description: manifest?.description || core?.meta?.purpose || '',
+      asset: entry.asset_path,
+      asset_digest: entry.asset_digest || null,
+      content_digest: entry.content_digest || null,
     };
   });
 
@@ -135,7 +83,7 @@ function cmdList(showAvailable, jsonMode = false, locale = null) {
     if (d.description) console.log(`    ${d.description}`);
   }
   console.log('');
-  console.log(`Location: ${INSTALL_DIR}`);
+  console.log('Assets are stored under ~/.kdna/packages/.');
 }
 
 function cmdRegistry(subcommand) {

package/src/cmds/studio.js

@@ -10,7 +10,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { error, readJson, writeJson, EXIT } = require('./_common');
+const { error, readJson, writeJson, EXIT, isYesNoSelfCheck } = require('./_common');
 
 // ─── Scaffold ─────────────────────────────────────────────────────────
 
@@ -79,9 +79,16 @@ const CARD_TEMPLATES = {
 };
 
 function cmdStudioScaffold(name, args = []) {
-  if (!name) error('Usage: kdna studio scaffold <name> [--type=domain|cluster] [--minimal]', EXIT.INPUT_ERROR);
+  if (!name)
+    error(
+      'Usage: kdna studio scaffold <name> [--type=domain|cluster] [--minimal]',
+      EXIT.INPUT_ERROR,
+    );
   if (!/^[a-z][a-z0-9_-]*$/.test(name)) {
-    error(`Invalid name "${name}". Use lowercase letters, numbers, hyphens, underscores. Start with letter.`, EXIT.INPUT_ERROR);
+    error(
+      `Invalid name "${name}". Use lowercase letters, numbers, hyphens, underscores. Start with letter.`,
+      EXIT.INPUT_ERROR,
+    );
   }
 
   const type = args.includes('--type=cluster') ? 'cluster' : 'domain';
@@ -154,15 +161,22 @@ function cmdCardsValidate(projectPath, args = []) {
 
   if (!fs.existsSync(abs)) error(`Project file not found: ${abs}`, EXIT.INPUT_ERROR);
   const project = readJson(abs);
-  if (!project || !project.kdna_studio) error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
+  if (!project || !project.kdna_studio)
+    error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
 
   const errors = [];
   const warnings = [];
   const passed = [];
 
-  function fail(msg) { errors.push(msg); }
-  function warn(msg) { warnings.push(msg); }
-  function ok(msg) { passed.push(msg); }
+  function fail(msg) {
+    errors.push(msg);
+  }
+  function warn(msg) {
+    warnings.push(msg);
+  }
+  function ok(msg) {
+    passed.push(msg);
+  }
 
   // Validate each card set
   for (const [cardType, cardFile] of Object.entries(project.cards || {})) {
@@ -192,7 +206,11 @@ function cmdCardsValidate(projectPath, args = []) {
           } else {
             ok(`axiom ${label}: applies_when has ${ax.applies_when.length} entries`);
           }
-          if (!ax.does_not_apply_when || !Array.isArray(ax.does_not_apply_when) || ax.does_not_apply_when.length === 0) {
+          if (
+            !ax.does_not_apply_when ||
+            !Array.isArray(ax.does_not_apply_when) ||
+            ax.does_not_apply_when.length === 0
+          ) {
             fail(`axiom ${label}: missing does_not_apply_when`);
           } else {
             ok(`axiom ${label}: does_not_apply_when has ${ax.does_not_apply_when.length} entries`);
@@ -208,9 +226,11 @@ function cmdCardsValidate(projectPath, args = []) {
       case 'misunderstandings':
         for (const ms of cards) {
           const label = ms.id || '?';
-          if (!ms.wrong || ms.wrong.includes('[TODO]')) warn(`misunderstanding ${label}: wrong is placeholder`);
+          if (!ms.wrong || ms.wrong.includes('[TODO]'))
+            warn(`misunderstanding ${label}: wrong is placeholder`);
           else ok(`misunderstanding ${label}: wrong OK`);
-          if (!ms.correct || ms.correct.includes('[TODO]')) warn(`misunderstanding ${label}: correct is placeholder`);
+          if (!ms.correct || ms.correct.includes('[TODO]'))
+            warn(`misunderstanding ${label}: correct is placeholder`);
           else ok(`misunderstanding ${label}: correct OK`);
           if (!ms.key_distinction || ms.key_distinction.length < 15) {
             fail(`misunderstanding ${label}: key_distinction missing or too short`);
@@ -223,14 +243,18 @@ function cmdCardsValidate(projectPath, args = []) {
       case 'boundaries':
         for (const bd of cards) {
           const label = bd.id || '?';
-          if (!bd.scope || bd.scope.includes('[TODO]')) warn(`boundary ${label}: scope is placeholder`);
+          if (!bd.scope || bd.scope.includes('[TODO]'))
+            warn(`boundary ${label}: scope is placeholder`);
           else ok(`boundary ${label}: scope OK`);
-          if (!bd.out_of_scope || bd.out_of_scope.includes('[TODO]')) warn(`boundary ${label}: out_of_scope is placeholder`);
+          if (!bd.out_of_scope || bd.out_of_scope.includes('[TODO]'))
+            warn(`boundary ${label}: out_of_scope is placeholder`);
           else ok(`boundary ${label}: out_of_scope OK`);
           if (!bd.acceptable_exceptions || !Array.isArray(bd.acceptable_exceptions)) {
             warn(`boundary ${label}: acceptable_exceptions not declared`);
           } else {
-            ok(`boundary ${label}: acceptable_exceptions has ${bd.acceptable_exceptions.length} entries`);
+            ok(
+              `boundary ${label}: acceptable_exceptions has ${bd.acceptable_exceptions.length} entries`,
+            );
           }
         }
         break;
@@ -240,8 +264,8 @@ function cmdCardsValidate(projectPath, args = []) {
           const label = sc.id || '?';
           if (!sc.question || sc.question.includes('[TODO]')) {
             warn(`self_check ${label}: question is placeholder`);
-          } else if (!sc.question.trim().endsWith('?')) {
-            fail(`self_check ${label}: question should end with "?"`);
+          } else if (!isYesNoSelfCheck(sc.question)) {
+            fail(`self_check ${label}: question should be answerable with yes/no`);
           } else {
             ok(`self_check ${label}: question OK`);
           }
@@ -251,11 +275,14 @@ function cmdCardsValidate(projectPath, args = []) {
       case 'ontology':
         for (const ont of cards) {
           const label = ont.id || '?';
-          if (!ont.essence || ont.essence.includes('[TODO]')) warn(`ontology ${label}: essence is placeholder`);
+          if (!ont.essence || ont.essence.includes('[TODO]'))
+            warn(`ontology ${label}: essence is placeholder`);
           else ok(`ontology ${label}: essence OK`);
-          if (!ont.boundary || ont.boundary.includes('[TODO]')) warn(`ontology ${label}: boundary is placeholder`);
+          if (!ont.boundary || ont.boundary.includes('[TODO]'))
+            warn(`ontology ${label}: boundary is placeholder`);
           else ok(`ontology ${label}: boundary OK`);
-          if (!ont.trigger_signal || ont.trigger_signal.includes('[TODO]')) warn(`ontology ${label}: trigger_signal is placeholder`);
+          if (!ont.trigger_signal || ont.trigger_signal.includes('[TODO]'))
+            warn(`ontology ${label}: trigger_signal is placeholder`);
           else ok(`ontology ${label}: trigger_signal OK`);
         }
         break;
@@ -263,14 +290,20 @@ function cmdCardsValidate(projectPath, args = []) {
   }
 
   if (jsonMode) {
-    console.log(JSON.stringify({
-      project: path.basename(abs),
-      valid: errors.length === 0,
-      errors,
-      warnings,
-      passed: passed.length,
-      total_checks: errors.length + warnings.length + passed.length,
-    }, null, 2));
+    console.log(
+      JSON.stringify(
+        {
+          project: path.basename(abs),
+          valid: errors.length === 0,
+          errors,
+          warnings,
+          passed: passed.length,
+          total_checks: errors.length + warnings.length + passed.length,
+        },
+        null,
+        2,
+      ),
+    );
     process.exit(errors.length ? EXIT.VALIDATION_FAILED : EXIT.OK);
   }
 
@@ -298,7 +331,8 @@ function cmdLockVerify(projectPath, args = []) {
 
   if (!fs.existsSync(abs)) error(`Project file not found: ${abs}`, EXIT.INPUT_ERROR);
   const project = readJson(abs);
-  if (!project || !project.kdna_studio) error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
+  if (!project || !project.kdna_studio)
+    error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
 
   const locked = [];
   const unlocked = [];
@@ -324,7 +358,10 @@ function cmdLockVerify(projectPath, args = []) {
           locked.push(label);
         } else {
           // Check Feynman restatement for axioms and misunderstandings
-          if ((cardType === 'axioms' || cardType === 'misunderstandings') && !card.feynman_restatement) {
+          if (
+            (cardType === 'axioms' || cardType === 'misunderstandings') &&
+            !card.feynman_restatement
+          ) {
             unlocked.push(label);
             blocking.push(`${label} missing Feynman restatement`);
           } else {
@@ -341,15 +378,21 @@ function cmdLockVerify(projectPath, args = []) {
   const publishable = blocking.length === 0 && locked.length > 0;
 
   if (jsonMode) {
-    console.log(JSON.stringify({
-      project: path.basename(abs),
-      locked_cards: locked.length,
-      unlocked_cards: unlocked.length,
-      publishable,
-      blocking,
-      locked: locked.sort(),
-      unlocked: unlocked.sort(),
-    }, null, 2));
+    console.log(
+      JSON.stringify(
+        {
+          project: path.basename(abs),
+          locked_cards: locked.length,
+          unlocked_cards: unlocked.length,
+          publishable,
+          blocking,
+          locked: locked.sort(),
+          unlocked: unlocked.sort(),
+        },
+        null,
+        2,
+      ),
+    );
     process.exit(publishable ? EXIT.OK : EXIT.HUMAN_LOCK_REQUIRED);
   }
 
@@ -381,13 +424,15 @@ function cmdStudioCompile(projectPath, args = []) {
 
   if (!fs.existsSync(abs)) error(`Project file not found: ${abs}`, EXIT.INPUT_ERROR);
   const project = readJson(abs);
-  if (!project || !project.kdna_studio) error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
+  if (!project || !project.kdna_studio)
+    error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
 
   // Determine output directory
   const outIdx = args.indexOf('--out');
-  const outDir = outIdx >= 0
-    ? path.resolve(args[outIdx + 1])
-    : path.join(path.dirname(abs), project.exports?.dir || 'exports');
+  const outDir =
+    outIdx >= 0
+      ? path.resolve(args[outIdx + 1])
+      : path.join(path.dirname(abs), project.exports?.dir || 'exports');
 
   fs.mkdirSync(outDir, { recursive: true });
 
@@ -398,7 +443,6 @@ function cmdStudioCompile(projectPath, args = []) {
   // Compile axioms → KDNA_Core.json
   const axioms = loadCards(project, path.dirname(abs), 'axioms');
   const ontology = loadCards(project, path.dirname(abs), 'ontology');
-  const _boundaries = loadCards(project, path.dirname(abs), 'boundaries');
 
   const core = {
     meta: {
@@ -460,12 +504,17 @@ function cmdStudioCompile(projectPath, args = []) {
 
   // Compile manifest → kdna.json
   const manifest = {
-    kdna_spec: '1.0-rc',
+    format: 'kdna',
+    format_version: '1.0',
+    spec_version: '1.0-rc',
     name: `@aikdna/${project.name}`,
     version: '0.1.0',
+    judgment_version: '0.1.0',
     status: 'experimental',
+    quality_badge: 'untested',
     access: 'open',
-    language: 'en',
+    languages: ['en'],
+    default_language: 'en',
     author: { name: '', id: '' },
     license: { type: 'CC-BY-4.0' },
     description: '',
@@ -495,7 +544,7 @@ function cmdStudioCompile(projectPath, args = []) {
 
   console.log('');
   console.log('Next:');
-  console.log(`  kdna validate ${outDir}`);
+  console.log(`  kdna dev validate ${outDir}`);
 }
 
 function loadCards(project, projectDir, cardType) {
@@ -520,7 +569,8 @@ function cmdStudioReadiness(projectPath, args = []) {
 
   if (!fs.existsSync(abs)) error(`Project file not found: ${abs}`, EXIT.INPUT_ERROR);
   const project = readJson(abs);
-  if (!project || !project.kdna_studio) error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
+  if (!project || !project.kdna_studio)
+    error(`Not a KDNA Studio project: ${abs}`, EXIT.INPUT_ERROR);
 
   const readiness = {
     axioms: loadCardStats(project, path.dirname(abs), 'axioms'),
@@ -534,7 +584,9 @@ function cmdStudioReadiness(projectPath, args = []) {
   };
 
   // Determine publishability
-  const allTypes = Object.values(readiness).filter((v) => v && typeof v === 'object' && 'total' in v);
+  const allTypes = Object.values(readiness).filter(
+    (v) => v && typeof v === 'object' && 'total' in v,
+  );
   let allLocked = allTypes.every((t) => t.total > 0 && t.total === t.locked);
   if (allTypes.length === 0) allLocked = false;
   readiness.publishable = allLocked;

package/src/cmds/test.js

@@ -12,9 +12,9 @@ const fs = require('fs');
 const path = require('path');
 const { error, readJson, writeJson, EXIT } = require('./_common');
 const { parseName } = require('../registry');
+const { getInstalled } = require('../package-store');
 
 const USER_KDNA_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '.', '.kdna');
-const INSTALL_DIR = path.join(USER_KDNA_DIR, 'domains');
 const RUNS_DIR = path.join(USER_KDNA_DIR, 'runs');
 
 function cmdTestRun(args = []) {
@@ -38,8 +38,8 @@ function cmdTestRun(args = []) {
 
   const parsed = parseName(domain);
   if (!parsed) error(`Invalid name "${domain}".`, EXIT.INPUT_ERROR);
-  const destDir = path.join(INSTALL_DIR, parsed.scope, parsed.ident);
-  if (!fs.existsSync(destDir)) {
+  const installed = getInstalled(parsed.full);
+  if (!installed) {
     error(`${parsed.full} not installed. Run: kdna install ${domain}`, EXIT.INPUT_ERROR);
   }
 
@@ -64,7 +64,7 @@ function cmdTestRun(args = []) {
   const result = {
     test_id: testCase.id || `test_${Date.now()}`,
     domain: parsed.full,
-    domain_path: destDir,
+    domain_asset: installed.asset_path,
     input: typeof testCase.input === 'string' ? testCase.input : JSON.stringify(testCase.input),
     run_at: new Date().toISOString(),
     expected: {
@@ -115,8 +115,11 @@ function cmdTestRun(args = []) {
   if (!jsonMode) {
     console.log(`Test run recorded: ${result.test_id}`);
     console.log(`  Domain:  ${result.domain}`);
-    console.log(`  Input:   ${result.input.slice(0, 100)}${result.input.length > 100 ? '...' : ''}`);
-    if (result.expected.classification) console.log(`  Expected classification: ${result.expected.classification}`);
+    console.log(
+      `  Input:   ${result.input.slice(0, 100)}${result.input.length > 100 ? '...' : ''}`,
+    );
+    if (result.expected.classification)
+      console.log(`  Expected classification: ${result.expected.classification}`);
   }
 }
 

package/src/cmds/trace.js

@@ -1,10 +1,9 @@
 const fs = require('fs');
 const path = require('path');
-const crypto = require('crypto');
-const { EXIT, error, readJson } = require('./_common');
+const { EXIT } = require('./_common');
+const PATHS = require('../paths');
 
-const USER_KDNA_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '.', '.kdna');
-const TRACES_DIR = path.join(USER_KDNA_DIR, 'traces');
+const TRACES_DIR = PATHS.traces;
 
 function ensureTracesDir() {
   fs.mkdirSync(TRACES_DIR, { recursive: true });
@@ -60,9 +59,14 @@ function readAllTraces(opts = {}) {
 }
 
 function recordTrace(entry) {
-  ensureTracesDir();
-  const line = JSON.stringify(entry) + '\n';
-  fs.appendFileSync(todayFile(), line);
+  try {
+    ensureTracesDir();
+    const line = JSON.stringify(entry) + '\n';
+    fs.appendFileSync(todayFile(), line);
+  } catch {
+    // Traces are observability data. Loading and comparing KDNA assets must not
+    // fail just because the local trace directory is unavailable or read-only.
+  }
 }
 
 function parseSinceFlag(args) {

package/src/compare.js

@@ -1,5 +1,5 @@
 /**
- * kdna compare <name> --input "<text>" — Reasoning trajectory diff.
+ * kdna compare <name|file.kdna> --input "<text>" — Reasoning trajectory diff.
  *
  * Runs the same prompt twice on a real LLM:
  *   1. Without KDNA loaded (baseline)
@@ -24,7 +24,7 @@ const path = require('path');
 const https = require('https');
 
 const USER_KDNA_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '.', '.kdna');
-const INSTALL_DIR = path.join(USER_KDNA_DIR, 'domains');
+const { readContainer, resolveAsset } = require('./package-store');
 const CONFIG_FILE = path.join(USER_KDNA_DIR, 'config.json');
 
 const { parseName } = require('./registry');
@@ -179,10 +179,10 @@ async function callLlm(cfg, systemPrompt, userMessage) {
 
 // ─── KDNA → system prompt ─────────────────────────────────────────────
 
-function buildKdnaPrompt(destDir) {
-  const core = readJson(path.join(destDir, 'KDNA_Core.json'));
-  const pat = readJson(path.join(destDir, 'KDNA_Patterns.json'));
-  const manifest = readJson(path.join(destDir, 'kdna.json'));
+function buildKdnaPrompt(container) {
+  const core = container.core;
+  const pat = container.patterns;
+  const manifest = container.manifest;
 
   if (!core || !pat) return '';
 
@@ -302,7 +302,6 @@ function emitMarkdownReport(parsed, manifest, core, pat, responseA, responseB, d
   const bannedTerms = (pat.terminology?.banned_terms || []).map((t) =>
     typeof t === 'string' ? t : t.term,
   );
-  const misunderstandings = pat.misunderstandings || [];
 
   const lines = [];
   lines.push('# KDNA Judgment Comparison Report');
@@ -487,27 +486,30 @@ async function cmdCompare(input, args = []) {
   const idxInput = args.indexOf('--input');
   if (idxInput < 0 || !args[idxInput + 1]) {
     error(
-      'Usage: kdna compare <name> --input "<text>" [--report-md|--report-json] [--output <file>]',
+      'Usage: kdna compare <name|file.kdna> --input "<text>" [--report-md|--report-json] [--output <file>]',
       EXIT.INPUT_ERROR,
     );
   }
   const userInput = args[idxInput + 1];
 
-  const parsed = parseName(input);
-  if (!parsed) error(`Invalid name "${input}".`, EXIT.INPUT_ERROR);
-  const destDir = path.join(INSTALL_DIR, parsed.scope, parsed.ident);
-  if (!fs.existsSync(destDir)) {
-    error(`${parsed.full} not installed. Run: kdna install ${input}`, EXIT.INPUT_ERROR);
-  }
+  const asset = resolveAsset(input);
+  if (!asset)
+    error(
+      `KDNA asset not found: ${input}. Use an installed name or a .kdna file.`,
+      EXIT.INPUT_ERROR,
+    );
+  const parsed = asset.parsed || parseName(asset.name || '');
+  const label = parsed?.full || asset.name || input;
 
   const llm = loadLlmConfig();
-  const manifest = readJson(path.join(destDir, 'kdna.json')) || {};
-  const core = readJson(path.join(destDir, 'KDNA_Core.json')) || {};
-  const pat = readJson(path.join(destDir, 'KDNA_Patterns.json')) || {};
+  const container = readContainer(asset.asset_path);
+  const manifest = container.manifest || {};
+  const core = container.core || {};
+  const pat = container.patterns || {};
 
   if (!jsonMode && !reportMd && !reportJson) {
     console.log('═'.repeat(64));
-    console.log(`  kdna compare  ${parsed.full}`);
+    console.log(`  kdna compare  ${label}`);
     console.log(`  provider:     ${llm.provider} / ${llm.model}`);
     console.log(`  input length: ${userInput.length} chars`);
     console.log('═'.repeat(64));
@@ -516,7 +518,7 @@ async function cmdCompare(input, args = []) {
 
   const BASELINE_SYSTEM =
     'You are a helpful assistant. Respond to the user request concisely and specifically.';
-  const kdnaPrompt = buildKdnaPrompt(destDir);
+  const kdnaPrompt = buildKdnaPrompt(container);
   if (!kdnaPrompt) error('Could not build KDNA prompt — missing KDNA_Core or KDNA_Patterns.');
   const TREATMENT_SYSTEM =
     'You are a helpful assistant. The following domain judgment is loaded and you MUST apply it when relevant.\n\n' +
@@ -540,13 +542,30 @@ async function cmdCompare(input, args = []) {
   recordTrace({
     timestamp: new Date().toISOString(),
     agent: 'cli',
-    domain: parsed.full,
+    domain: label,
     type: 'compare',
+    asset: {
+      asset_path: asset.asset_path,
+      asset_digest: asset.asset_digest || null,
+      content_digest: asset.content_digest || null,
+      version: manifest.version || asset.version || null,
+      judgment_version: manifest.judgment_version || asset.judgment_version || null,
+      access: manifest.access || asset.access || null,
+    },
     compare: { model: llm.model, input_length: userInput.length },
   });
 
   if (reportMd) {
-    const report = emitMarkdownReport(parsed, manifest, core, pat, responseA, responseB, diff, llm);
+    const report = emitMarkdownReport(
+      parsed || { full: label },
+      manifest,
+      core,
+      pat,
+      responseA,
+      responseB,
+      diff,
+      llm,
+    );
     if (outputFile) {
       fs.writeFileSync(outputFile, report);
       console.log(`Report saved to ${outputFile}`);
@@ -558,7 +577,7 @@ async function cmdCompare(input, args = []) {
 
   if (reportJson) {
     const report = emitJsonReport(
-      parsed,
+      parsed || { full: label },
       manifest,
       core,
       pat,