@aikdna/kdna-cli 0.16.3 → 0.16.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aikdna/kdna-cli",
-  "version": "0.16.3",
+  "version": "0.16.5",
   "description": "KDNA CLI — create, validate, install, and manage domain cognition packages for AI agents.",
   "type": "commonjs",
   "bin": {

package/src/cli.js

@@ -7,7 +7,14 @@
  */
 
 const { error, EXIT, setQuiet, setExitCodeOnly } = require('./cmds/_common');
-const { cmdValidate, cmdPack, cmdPackEncrypt, cmdUnpack, cmdUnpackEncrypt, cmdInspect } = require('./cmds/domain');
+const {
+  cmdValidate,
+  cmdPack,
+  cmdPackEncrypt,
+  cmdUnpack,
+  cmdUnpackEncrypt,
+  cmdInspect,
+} = require('./cmds/domain');
 const { cmdList, cmdRegistry } = require('./cmds/registry');
 const {
   cmdCompare,
@@ -24,12 +31,31 @@ const { cmdIdentity } = require('./cmds/identity');
 const { cmdSetup } = require('./cmds/setup');
 const { cmdDoctor } = require('./cmds/doctor');
 const { cmdTrace, cmdHistory } = require('./cmds/trace');
-const { cmdLicenseGenerate, cmdLicenseVerify, cmdLicenseBind, cmdLicenseShow, cmdLicenseInstall } = require('./cmds/license');
+const {
+  cmdLicenseGenerate,
+  cmdLicenseVerify,
+  cmdLicenseBind,
+  cmdLicenseShow,
+  cmdLicenseInstall,
+} = require('./cmds/license');
 const { cmdPreview, cmdProject, cmdEval, cmdExport, cmdDemo } = require('./cmds/legacy');
-const { cmdStudioScaffold, cmdCardsValidate, cmdLockVerify, cmdStudioCompile, cmdStudioReadiness } = require('./cmds/studio');
+const {
+  cmdStudioScaffold,
+  cmdCardsValidate,
+  cmdLockVerify,
+  cmdStudioCompile,
+  cmdStudioReadiness,
+} = require('./cmds/studio');
 const { cmdTestRun, cmdTestImport } = require('./cmds/test');
 const { cmdChangelog } = require('./cmds/changelog');
-const { cmdProposalCreate, cmdProposalValidate, cmdReview, cmdLockCard, cmdEvolution, cmdRegression } = require('./cmds/governance');
+const {
+  cmdProposalCreate,
+  cmdProposalValidate,
+  cmdReview,
+  cmdLockCard,
+  cmdEvolution,
+  cmdRegression,
+} = require('./cmds/governance');
 const { cmdBadgeCompute, cmdRegistryAudit, cmdPackage } = require('./cmds/badge');
 
 // ─── Main ─────────────────────────────────────────────────────────────
@@ -81,6 +107,7 @@ Agent Runtime:
 
 Testing & Verification:
   verify <name>                    3-layer: structure + trust + judgment
+  verify <name> --i18n               I18N verification: locale dirs, overlays, card completeness
   verify <name> --judgment --run-tests  Judgment validation with eval cases
   compare <name> --input "..."     With/without KDNA reasoning diff
   compare <name> --input "..." --report-md     Markdown report format
@@ -252,8 +279,10 @@ switch (cmd) {
   }
   case 'inspect': {
     const target = args.filter((a) => !a.startsWith('--'))[1];
-    if (!target) error('Usage: kdna inspect <path>');
-    cmdInspect(target, args.includes('--json'));
+    if (!target) error('Usage: kdna inspect <path> [--json] [--locale zh-CN]');
+    const localeIdx = args.indexOf('--locale');
+    const locale = localeIdx >= 0 ? args[localeIdx + 1] : null;
+    cmdInspect(target, args.includes('--json'), locale);
     break;
   }
   case 'verify': {
@@ -330,7 +359,10 @@ switch (cmd) {
     } else if (sub === 'validate') {
       cmdProposalValidate(args);
     } else {
-      error('Usage: kdna proposal create --from-test <run.json> --domain <path>\n       kdna proposal validate <proposal.json>', EXIT.INPUT_ERROR);
+      error(
+        'Usage: kdna proposal create --from-test <run.json> --domain <path>\n       kdna proposal validate <proposal.json>',
+        EXIT.INPUT_ERROR,
+      );
     }
     break;
   }
@@ -403,7 +435,9 @@ switch (cmd) {
     break;
   }
   case 'list': {
-    cmdList(args.includes('--available'), args.includes('--json'));
+    const localeIdx = args.indexOf('--locale');
+    const locale = localeIdx >= 0 ? args[localeIdx + 1] : null;
+    cmdList(args.includes('--available'), args.includes('--json'), locale);
     break;
   }
   case 'setup': {

package/src/cmds/domain.js

@@ -587,14 +587,14 @@ function parseSimpleYaml(raw) {
 
 // ─── Inspect ───────────────────────────────────────────────────────────
 
-function cmdInspect(dir, jsonMode = false) {
+function cmdInspect(dir, jsonMode = false, locale = null) {
   const abs = path.resolve(dir);
   const stat = fs.existsSync(abs) ? fs.statSync(abs) : null;
   if (!stat) error(`Path not found: ${abs}`, EXIT.INPUT_ERROR);
 
   // Single .kdna file
   if (stat.isFile() && abs.endsWith('.kdna')) {
-    inspectKdnaFile(abs, jsonMode);
+    inspectKdnaFile(abs, jsonMode, locale);
     return;
   }
 
@@ -657,18 +657,27 @@ function cmdInspect(dir, jsonMode = false) {
       axioms: (c.axioms || []).map((a) => a.one_sentence || null).filter(Boolean),
     };
 
-    // Governance metadata (KDNA_CARD.json)
-    const card = readJson(path.join(abs, 'KDNA_CARD.json'));
-    if (card) {
+    // Add governance + locale data
+    if (kdnaCard) {
       result.governance = {
-        risk_level: card.risk_level || null,
-        review_status: card.review_status || null,
-        intended_use: card.intended_use || [],
-        out_of_scope: card.out_of_scope || [],
-        known_limitations: card.known_limitations || [],
-        requires_expert_review: card.requires_expert_review || false,
+        risk_level: kdnaCard.risk_level || null,
+        review_status: kdnaCard.review_status || null,
+        intended_use: kdnaCard.intended_use || [],
+        out_of_scope: kdnaCard.out_of_scope || [],
+        known_limitations: kdnaCard.known_limitations || [],
+        requires_expert_review: kdnaCard.requires_expert_review || false,
       };
+      if (locale) {
+        result.governance.display_name = kdnaCard.display_name || null;
+        result.governance.summary = kdnaCard.summary || null;
+        result.governance.locale = locale;
+      }
     }
+    // Add i18n info from kdna.json
+    if (m.languages) result.languages = m.languages;
+    if (m.default_language) result.default_language = m.default_language;
+    if (m.i18n_level) result.i18n_level = m.i18n_level;
+
     console.log(JSON.stringify(result, null, 2));
     return;
   }
@@ -718,11 +727,22 @@ function cmdInspect(dir, jsonMode = false) {
 
   if (evo)   console.log(`  Evolution stages:   ${(evo.stages || []).length}`);
 
-  // Governance metadata
-  const kdnaCard = readJson(path.join(abs, 'KDNA_CARD.json'));
+  // Governance metadata (with locale support)
+  let kdnaCard = readJson(path.join(abs, 'KDNA_CARD.json'));
+  if (locale && !kdnaCard) {
+    kdnaCard = readJson(path.join(abs, 'locales', locale, 'KDNA_CARD.json'));
+  }
+  if (locale && kdnaCard) {
+    const localeCard = readJson(path.join(abs, 'locales', locale, 'KDNA_CARD.json'));
+    if (localeCard) kdnaCard = localeCard;
+  }
   if (kdnaCard) {
+    const displayName = kdnaCard.display_name || '';
+    const summary = kdnaCard.summary || '';
     console.log('');
     console.log('  ── Governance ──');
+    if (displayName && locale) console.log(`  Display name:   ${displayName}`);
+    if (summary && locale) console.log(`  Summary:        ${summary}`);
     console.log(`  Risk level:     ${kdnaCard.risk_level || '?'}`);
     console.log(`  Review status:  ${kdnaCard.review_status || '?'}`);
     if (kdnaCard.intended_use?.length) console.log(`  Intended use:   ${kdnaCard.intended_use[0]}${kdnaCard.intended_use.length > 1 ? ` (+${kdnaCard.intended_use.length - 1} more)` : ''}`);

package/src/cmds/registry.js

@@ -3,7 +3,7 @@ const path = require('path');
 const { CANONICAL_REGISTRY_URL, REGISTRY_CACHE, fetchRegistry } = require('../registry');
 const { error, readJson, loadRegistry, INSTALL_DIR, EXIT } = require('./_common');
 
-function cmdList(showAvailable, jsonMode = false) {
+function cmdList(showAvailable, jsonMode = false, locale = null) {
   if (showAvailable) {
     const domains = loadRegistry({ allowNetwork: true });
     if (!domains || !domains.length) {

package/src/verify.js

@@ -240,10 +240,16 @@ function checkJudgment(destDir) {
   } else if (hasScope || hasOutOfScope) {
     score.max += 2;
     score.total += 1;
-    issues.push({ severity: 'warn', msg: 'partial: README boundary declaration incomplete (missing Scope or Out-of-Scope section)' });
+    issues.push({
+      severity: 'warn',
+      msg: 'partial: README boundary declaration incomplete (missing Scope or Out-of-Scope section)',
+    });
   } else {
     score.max += 2;
-    issues.push({ severity: 'error', msg: 'README missing boundary declaration: require ## Scope + ## Out of Scope (or v2.1 Four Questions)' });
+    issues.push({
+      severity: 'error',
+      msg: 'README missing boundary declaration: require ## Scope + ## Out of Scope (or v2.1 Four Questions)',
+    });
   }
 
   // 2. v2.1 axiom governance fields
@@ -321,14 +327,20 @@ function checkJudgment(destDir) {
     } else if (files.length > 0) {
       score.max += 2;
       score.total += 1;
-      issues.push({ severity: 'warn', msg: `evals/ has only ${files.length} files (require ≥4: core/boundary/failure/excluded)` });
+      issues.push({
+        severity: 'warn',
+        msg: `evals/ has only ${files.length} files (require ≥4: core/boundary/failure/excluded)`,
+      });
     } else {
       score.max += 2;
       issues.push({ severity: 'error', msg: 'evals/ directory exists but contains no case files' });
     }
   } else {
     score.max += 2;
-    issues.push({ severity: 'error', msg: 'evals/ directory missing: require ≥4 evaluation cases' });
+    issues.push({
+      severity: 'error',
+      msg: 'evals/ directory missing: require ≥4 evaluation cases',
+    });
   }
 
   // 6. judgment_version manifest field (REQUIRED)
@@ -367,6 +379,94 @@ function renderLayer(result) {
   }
 }
 
+// ─── I18N layer ──────────────────────────────────────────────────────
+
+function checkI18n(destDir) {
+  const issues = [];
+  const passed = [];
+  const manifest = readJson(path.join(destDir, 'kdna.json')) || {};
+  const languages = manifest.languages || [];
+  const i18nLevel = manifest.i18n_level || 'L0';
+
+  if (languages.length === 0) {
+    passed.push('i18n: no languages declared (L0 — monolingual)');
+    return { layer: 'i18n', passed: true, issues, results: passed };
+  }
+
+  passed.push(`languages declared: ${languages.join(', ')}`);
+  passed.push(`i18n level: ${i18nLevel}`);
+
+  const canonical = manifest.default_language || languages[0] || 'en';
+  for (const lang of languages) {
+    if (lang === canonical) continue;
+    const localeDir = path.join(destDir, 'locales', lang);
+
+    // L1: card + readme
+    if (['L1', 'L2', 'L3', 'L4'].includes(i18nLevel)) {
+      if (!fs.existsSync(path.join(localeDir, 'KDNA_CARD.json'))) {
+        issues.push({ severity: 'error', msg: `i18n: ${lang} KDNA_CARD.json missing` });
+      } else {
+        const card = readJson(path.join(localeDir, 'KDNA_CARD.json'));
+        if (card) {
+          passed.push(`locales/${lang}/KDNA_CARD.json OK`);
+          if (!card.display_name)
+            issues.push({ severity: 'warn', msg: `i18n: ${lang} card missing display_name` });
+          if (!card.intended_use?.length)
+            issues.push({ severity: 'warn', msg: `i18n: ${lang} card missing intended_use` });
+        }
+      }
+      if (!fs.existsSync(path.join(localeDir, 'README.md'))) {
+        issues.push({ severity: 'warn', msg: `i18n: ${lang} README.md missing` });
+      } else {
+        passed.push(`locales/${lang}/README.md OK`);
+      }
+    }
+
+    // L2: overlay files
+    if (['L2', 'L3', 'L4'].includes(i18nLevel)) {
+      const coreOverlay = path.join(localeDir, 'KDNA_Core.overlay.json');
+      if (!fs.existsSync(coreOverlay)) {
+        issues.push({ severity: 'error', msg: `i18n: ${lang} KDNA_Core.overlay.json missing` });
+      } else {
+        const overlay = readJson(coreOverlay);
+        if (overlay?.translations) {
+          const core = readJson(path.join(destDir, 'KDNA_Core.json'));
+          if (core?.axioms) {
+            const validIds = new Set(core.axioms.map((a) => a.id));
+            for (const key of Object.keys(overlay.translations)) {
+              const refId = key.split('.')[0];
+              if (!validIds.has(refId)) {
+                issues.push({
+                  severity: 'error',
+                  msg: `i18n: overlay refs unknown axiom: ${refId}`,
+                });
+              }
+            }
+          }
+          passed.push(
+            `locales/${lang}/KDNA_Core.overlay.json OK (${Object.keys(overlay.translations).length} translations)`,
+          );
+        }
+      }
+      if (!fs.existsSync(path.join(localeDir, 'KDNA_Patterns.overlay.json'))) {
+        issues.push({ severity: 'warn', msg: `i18n: ${lang} KDNA_Patterns.overlay.json missing` });
+      }
+    }
+  }
+
+  if (manifest.languages?.length && !manifest.i18n_level) {
+    issues.push({ severity: 'warn', msg: 'i18n: languages declared but i18n_level not set' });
+  }
+
+  return {
+    layer: 'i18n',
+    passed: issues.filter((i) => i.severity === 'error').length === 0,
+    issues,
+    results: passed.concat(issues.map((i) => i.msg)),
+    score: { total: passed.length, max: passed.length + issues.length },
+  };
+}
+
 // ─── Main ──────────────────────────────────────────────────────────────
 
 function cmdVerify(input, args = []) {
@@ -376,15 +476,22 @@ function cmdVerify(input, args = []) {
     structure: args.includes('--structure'),
     trust: args.includes('--trust'),
     judgment: args.includes('--judgment'),
+    i18n: args.includes('--i18n'),
   };
-  const all = !want.structure && !want.trust && !want.judgment;
+  const all = !want.structure && !want.trust && !want.judgment && !want.i18n;
   if (all) want.structure = want.trust = want.judgment = true;
 
   // Resolve name → installed path + scope/entry
   const parsed = parseName(input);
   if (!parsed) {
     if (jsonMode) {
-      console.log(JSON.stringify({ name: input, ok: false, error: `Invalid name "${input}". Use @scope/name or bare name.` }));
+      console.log(
+        JSON.stringify({
+          name: input,
+          ok: false,
+          error: `Invalid name "${input}". Use @scope/name or bare name.`,
+        }),
+      );
     } else {
       console.error(`Invalid name "${input}". Use @scope/name or bare name.`);
     }
@@ -394,7 +501,13 @@ function cmdVerify(input, args = []) {
   const destDir = path.join(INSTALL_DIR, parsed.scope, parsed.ident);
   if (!fs.existsSync(destDir)) {
     if (jsonMode) {
-      console.log(JSON.stringify({ name: parsed.full, ok: false, error: `${parsed.full} is not installed. Run: kdna install ${input}` }));
+      console.log(
+        JSON.stringify({
+          name: parsed.full,
+          ok: false,
+          error: `${parsed.full} is not installed. Run: kdna install ${input}`,
+        }),
+      );
     } else {
       console.error(`${parsed.full} is not installed. Run: kdna install ${input}`);
     }
@@ -418,6 +531,7 @@ function cmdVerify(input, args = []) {
   if (want.structure) results.push(checkStructure(destDir));
   if (want.trust) results.push(checkTrust(destDir, scope, entry));
   if (want.judgment) results.push(checkJudgment(destDir));
+  if (want.i18n) results.push(checkI18n(destDir));
 
   // ── JSON output ──────────────────────────────────────────────────────
   if (jsonMode) {
@@ -444,12 +558,18 @@ function cmdVerify(input, args = []) {
       exitCode = EXIT.JUDGMENT_QUALITY_FAILED;
     }
 
-    console.log(JSON.stringify({
-      name: parsed.full,
-      path: destDir,
-      layers,
-      ok: exitCode === EXIT.OK,
-    }, null, 2));
+    console.log(
+      JSON.stringify(
+        {
+          name: parsed.full,
+          path: destDir,
+          layers,
+          ok: exitCode === EXIT.OK,
+        },
+        null,
+        2,
+      ),
+    );
     process.exit(exitCode);
   }