@cognivia/cli 0.1.0 → 0.3.0

package/README.md

@@ -9,8 +9,15 @@ npm i -g @cognivia/cli
 cognivia diagnose --demo                 # bundled sample data, no key
 cognivia diagnose --input answers.json   # your export
 cognivia memory-state <learnerId>        # hosted API (needs COGNIVIA_API_KEY)
+cognivia report <learnerId>              # a learner's stored state as a readable report
+cognivia content items --input items.json          # item -> misconception maps
+cognivia content prerequisites --input pre.json    # concept -> prerequisite maps
 ```
 
+`content` maps sharpen `diagnose` on your own items and concepts; they need a
+self-serve live key. `items.json`: `[{ item_ref, distractors: { "wrong option": "misconception" } }]`.
+`pre.json`: `[{ concept, requires: ["prerequisite concept"] }]`.
+
 With `COGNIVIA_API_KEY` set it calls the hosted API; otherwise it computes locally.
 
 MIT · Manik Maurya

package/bin/cognivia.mjs

@@ -49,16 +49,37 @@ Usage:
   cognivia diagnose --demo
   cognivia diagnose --input answers.json [--json] [--out file]
   cognivia report --input answers.json [--out report.txt]
+  cognivia report <learnerId>                            (hosted; needs a live key)
   cognivia memory-state --input answers.json
+  cognivia memory-state <learnerId>                      (hosted; needs a live key)
+  cognivia content items --input items.json              (upload item -> misconception maps)
+  cognivia content prerequisites --input pre.json        (upload concept -> prerequisite maps)
+  cognivia content items | prerequisites                 (list what is stored)
   cognivia --version
 
 answers.json: JSON array of { subject, question, answer, correct, latencyMs, confidence(1-5) }
+items.json:   JSON array of { item_ref, distractors: { "wrong option": "misconception" } }
+pre.json:     JSON array of { concept, requires: ["prerequisite concept", ...] }
 Diagnostics are computed by @cognivia/core, the same engine behind the API, MCP server, and site.`);
 }
 
 switch (cmd) {
-  case "diagnose":
   case "report": {
+    // `cognivia report <learnerId>` renders a learner's stored memory state
+    // (hosted, needs a live key). Falls through to the attempts-based report.
+    const rid = args[1] && !args[1].startsWith("-") ? args[1] : null;
+    if (rid) {
+      if (!client.hasKey()) fail("report <learnerId> needs COGNIVIA_API_KEY (a live key).");
+      try {
+        const st = await client.memoryStateRemote(rid);
+        out(has("--json") ? JSON.stringify(st, null, 2) : client.renderMemoryState(st));
+      } catch (e) { fail("report: " + e.message); }
+      break;
+    }
+    // no id → fall through to the attempts-based report below.
+  }
+  // eslint-disable-next-line no-fallthrough
+  case "diagnose": {
     const attempts = loadAttempts();
     // Use the hosted API when a key is set (unless --demo or --local); else compute locally.
     const useRemote = !has("--demo") && (has("--remote") || (client.hasKey() && !has("--local")));
@@ -86,9 +107,39 @@ switch (cmd) {
     out(lines.join("\n"));
     break;
   }
+  case "content": {
+    // Owner-scoped content maps that sharpen /v1/diagnose on your own items.
+    //   cognivia content items --input items.json          upload item -> misconception maps
+    //   cognivia content prerequisites --input pre.json     upload concept -> prerequisite maps
+    //   cognivia content items | prerequisites              (no --input) list what is stored
+    if (!client.hasKey()) fail("content needs COGNIVIA_API_KEY (a self-serve live key).");
+    const kind = args[1];
+    const f = opt("--input");
+    const isUpload = f && f !== true;
+    const readArr = (key) => {
+      const data = JSON.parse(readFileSync(f, "utf8"));
+      const arr = Array.isArray(data) ? data : data[key];
+      if (!Array.isArray(arr) || !arr.length) fail("input must be a non-empty JSON array");
+      return arr;
+    };
+    try {
+      if (kind === "items") {
+        out(JSON.stringify(isUpload
+          ? await client.setItemMisconceptions(readArr("items"))
+          : await client.getItemMisconceptions(), null, 2));
+      } else if (kind === "prerequisites" || kind === "prereqs") {
+        out(JSON.stringify(isUpload
+          ? await client.setConceptPrerequisites(readArr("prerequisites"))
+          : await client.getConceptPrerequisites(), null, 2));
+      } else {
+        fail("content <items|prerequisites> [--input file.json]");
+      }
+    } catch (e) { fail("content: " + e.message); }
+    break;
+  }
   case "--version":
   case "-v":
-    console.log("cognivia/0.1.0 (core " + "0.1.0" + ")");
+    console.log("cognivia/0.3.0 (core " + "0.3.0" + ")");
     break;
   case undefined:
   case "help":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognivia/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Run Cognivia's learning diagnostics from the terminal. Point it at any learning or quiz app's answer export and get back the Learning Genome, per-item diagnosis, and a session report.",
   "type": "module",
   "bin": { "cognivia": "bin/cognivia.mjs" },
@@ -9,7 +9,7 @@
   "homepage": "https://cognivia-platform.vercel.app/intelligence",
   "repository": { "type": "git", "url": "git+https://github.com/Manik-Maurya/cognivia-platform.git", "directory": "packages/cli" },
   "engines": { "node": ">=18" },
-  "dependencies": { "@cognivia/core": "^0.1.0" },
+  "dependencies": { "@cognivia/core": "^0.3.0" },
   "publishConfig": { "access": "public" },
   "license": "MIT",
   "author": "Manik Maurya"