@aikdna/kdna-studio-cli 0.5.4 → 0.5.6

package/README.md

@@ -4,20 +4,21 @@ Official Studio command-line entry for KDNA judgment asset creation — turns yo
 
 **Official** means this package is part of the KDNA official toolchain. It does not imply content trust, asset endorsement, registry status, or quality rating.
 
-Two authoring paths: interview-first (articulate your judgment directly) and distillation-first (provide content, find the patterns, confirm what's really you).
+Two authoring paths: interview-first (articulate judgment directly) and distillation-first (provide content, find the patterns, review what belongs in scope).
 
 Distillation-first authoring is domain-first: declare the target domain, owner scope, granularity, task scope, include areas, exclude areas, and load condition before extracting candidates. A single `.kdna` should stay scoped; complex work should compose multiple domain assets through a KDNA Cluster.
 
 This package provides the `kdna-studio` command. It creates Studio projects,
-imports evidence, manages judgment cards, checks Human Lock, compiles locked
-cards, and exports canonical `.kdna` assets with build reports.
+imports evidence, manages judgment cards, records optional review/provenance
+signals, compiles reviewed project content, and exports canonical `.kdna`
+assets with build reports.
 
 It is intentionally separate from `@aikdna/kdna-cli`:
 
 | Package | Command | Role |
 | --- | --- | --- |
-| `@aikdna/kdna-cli` | `kdna` | Runtime CLI: verify, install, load, compare, publish existing `.kdna` assets |
-| `@aikdna/kdna-studio-cli` | `kdna-studio` | Authoring CLI: create, lock, compile, export trusted `.kdna` assets |
+| `@aikdna/kdna-cli` | `kdna` | Runtime CLI: inspect, validate, plan-load, load, pack, and unpack `.kdna` assets |
+| `@aikdna/kdna-studio-cli` | `kdna-studio` | Authoring CLI: create, review, compile, and export `.kdna` files |
 | `@aikdna/kdna-studio-core` | none | Studio SDK/compiler kernel used by apps and this CLI |
 
 ## Install
@@ -51,12 +52,15 @@ kdna-studio card add my_domain axiom \
   --field does_not_apply_when='["pure formatting"]' \
   --field failure_risk="generic advice"
 kdna-studio card approve my_domain --all --by expert --statement "I confirm this judgment."
-kdna-studio lock my_domain
 kdna-studio export my_domain --format v1 --out dist/my_domain.kdna
 ```
 
 Candidate promotion is scope-gated: only candidates with `status == accepted` and `scope_fit == true` are promoted to cards by default. Use `kdna-studio candidate override <project> <candidate-id>` only when a human intentionally overrides the scope gate.
 
+The current Studio CLI export workflow uses approved cards as release evidence.
+This is Studio project policy, not a KDNA Core v1 format-validity rule. Human
+Lock, signatures, and quality claims are separate trust/provenance layers.
+
 After export, use the runtime CLI:
 
 ```bash
@@ -65,7 +69,7 @@ kdna plan-load dist/my_domain.kdna --json
 kdna load dist/my_domain.kdna --profile=compact --as=prompt
 ```
 
-`kdna-studio` is the CLI entry for confirmed KDNA authoring. `kdna` is the
+`kdna-studio` is the CLI entry for Studio project authoring. `kdna` is the
 runtime control plane for inspecting, validating, packing, unpacking, and
 loading existing `.kdna` assets.
 
@@ -100,7 +104,7 @@ kdna-studio identity show
 ## Import from existing KDNA or legacy folders
 
 ```bash
-# Fork an existing .kdna asset (cards imported as draft — re-lock required)
+# Fork an existing .kdna asset (cards imported as draft — review before Studio export)
 kdna-studio create forked --from-kdna ./parent.kdna --name @scope/forked
 
 # Migrate a legacy JSON source folder

package/bin/kdna-studio.js

@@ -48,8 +48,8 @@ Create (three entry paths):
   kdna-studio create <project-dir> --from-kdna <file.kdna> --name <@scope/name>
   kdna-studio create <project-dir> --from-folder <source-dir> --name <@scope/name>
 
-Migrate (dev source → trusted .kdna in one command):
-  kdna-studio migrate <source-dir|project> --format v1 --out <file.kdna> --name <@scope/name> --by <id> --statement <text> [--sign]
+Migrate (dev source or Studio project → canonical .kdna in one command):
+  kdna-studio migrate <source-dir|project> --format v1 --out <file.kdna> --name <@scope/name> --by <id> --statement <text>
 
 Authoring:
   kdna-studio import <project> <source-file-or-dir>               # import evidence (txt/md/json/yaml/csv/log/srt/vtt/html)
@@ -58,7 +58,6 @@ Authoring:
   kdna-studio card list <project>
   kdna-studio card add <project> <type> --field key=value [--field key=value]
   kdna-studio card approve <project> <card-id> --by <id> --statement <text> [--sign] [--passphrase <pass>]
-  kdna-studio lock <project>
   kdna-studio compile <project> --out <dir>
   kdna-studio export <project> --format v1 --out <file.kdna>
   kdna-studio export <project> --out <file.kdna> [--sign]                  # legacy v2
@@ -80,8 +79,6 @@ Distillation:
   kdna-studio candidate override <project> <candidate-id>        # override scope gate
   kdna-studio candidate promote <project>                        # promote accepted+scope_fit → cards
   kdna-studio report <project>
-  kdna-studio install <@scope/name|file.kdna> [--trusted]
-  kdna-studio update <@scope/name>
 
 Project may be a directory containing studio.project.json or a project JSON file.`);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aikdna/kdna-studio-cli",
-  "version": "0.5.4",
-  "description": "Official KDNA Studio command-line authoring entry for creating, locking, compiling, and exporting .kdna judgment assets through the KDNA toolchain.",
+  "version": "0.5.6",
+  "description": "Official KDNA Studio command-line authoring entry for creating, reviewing, compiling, and exporting .kdna judgment assets through the KDNA toolchain.",
   "type": "commonjs",
   "bin": {
     "kdna-studio": "bin/kdna-studio.js"
@@ -22,7 +22,7 @@
     "kdna-studio",
     "kdna-studio-cli",
     "authoring",
-    "human-lock",
+    "provenance",
     "judgment-cards"
   ],
   "license": "Apache-2.0",
@@ -38,13 +38,13 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@aikdna/kdna-core": "^0.11.1",
-    "@aikdna/kdna-studio-core": "^1.5.3",
+    "@aikdna/kdna-core": "^0.12.1",
+    "@aikdna/kdna-studio-core": "^1.5.6",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "cbor-x": "^1.6.4"
   },
   "devDependencies": {
-    "@aikdna/kdna-core": "^0.11.1"
+    "@aikdna/kdna-core": "^0.12.1"
   }
 }