@novedu/cli 0.2.0 → 0.3.0

package/dist/main.js

@@ -40,6 +40,26 @@ function warning(code, message, extra = {}) {
 		...extra
 	};
 }
+/**
+* Flattens a treeified Zod error into `path: message` lines so a generic
+* "Document does not match the expected structure" becomes actionable — e.g.
+* `Unrecognized key: "nae"` and `name: Invalid input: expected string`.
+* Framework-agnostic: shared by the web UI (`ErrorList`), the share-tutor
+* action, and the CLI formatter, so a schema error reads the same everywhere.
+*/
+function formatZodIssues(zodIssues) {
+	const out = [];
+	const walk = (node, path) => {
+		if (!node || typeof node !== "object") return;
+		if (Array.isArray(node.errors)) for (const message of node.errors) out.push(path.length ? `${path.join(".")}: ${message}` : message);
+		if (node.properties) for (const [key, child] of Object.entries(node.properties)) walk(child, [...path, key]);
+		if (Array.isArray(node.items)) node.items.forEach((child, index) => {
+			walk(child, [...path, String(index)]);
+		});
+	};
+	walk(zodIssues, []);
+	return out;
+}
 //#endregion
 //#region ../lib/tutors/consistency.ts
 /** Compare a supplied value against its declared property type. Returns null when it matches. */
@@ -635,6 +655,20 @@ function context(item) {
 function renderWarnings(warnings) {
 	return warnings.map((w) => `  ${yellow("⚠")} ${yellow(w.code)} ${w.message}${context(w)}`);
 }
+/**
+* Render each error as a line, with any flattened Zod schema-issue detail
+* indented beneath it — so a generic "Document does not match the expected
+* structure" is followed by the actual field paths (e.g. `Unrecognized key:
+* "nae"`), matching what the web UI shows.
+*/
+function renderErrors(errors) {
+	const lines = [];
+	for (const e of errors) {
+		lines.push(`  ${red("✗")} ${red(e.code)} ${e.message}${context(e)}`);
+		if (e.zodIssues) for (const issue of formatZodIssues(e.zodIssues)) lines.push(`      ${dim(issue)}`);
+	}
+	return lines;
+}
 function formatResult(result, source) {
 	const lines = [];
 	if (result.ok) {
@@ -652,7 +686,7 @@ function formatResult(result, source) {
 	lines.push(red(`✘ Invalid tutor`) + dim(` — ${source}`));
 	lines.push("");
 	lines.push(red(`${result.errors.length} error(s):`));
-	for (const e of result.errors) lines.push(`  ${red("✗")} ${red(e.code)} ${e.message}${context(e)}`);
+	lines.push(...renderErrors(result.errors));
 	if (result.warnings.length) {
 		lines.push("");
 		lines.push(yellow(`${result.warnings.length} warning(s):`));
@@ -677,7 +711,7 @@ function formatFragmentResult(result, source) {
 	lines.push(red(`✘ Invalid fragment file`) + dim(` — ${source}`));
 	lines.push("");
 	lines.push(red(`${result.errors.length} error(s):`));
-	for (const e of result.errors) lines.push(`  ${red("✗")} ${red(e.code)} ${e.message}${context(e)}`);
+	lines.push(...renderErrors(result.errors));
 	if (result.warnings.length) {
 		lines.push("");
 		lines.push(yellow(`${result.warnings.length} warning(s):`));
@@ -723,7 +757,16 @@ function runValidate(pathOrUrl, kind) {
 	}));
 }
 function registerValidate(program) {
-	program.command("validate").description("Validate a tutor YAML (default) or a fragment library by local path or public http(s) URL").argument("<pathOrUrl>", "path to a tutor or fragment YAML file, or a public http(s) URL").option("--kind <kind>", "what the file is: 'tutor' (default) or 'fragment'", "tutor").option("--json", "print the raw validation result as JSON").action(async (pathOrUrl, options) => {
+	program.command("validate").description("Validate a tutor YAML (default) or a fragment library by local path or public http(s) URL").argument("<pathOrUrl>", "path to a tutor or fragment YAML file, or a public http(s) URL").option("--kind <kind>", "what the file is: 'tutor' (default) or 'fragment'", "tutor").option("--json", "print the raw validation result as JSON").addHelpText("after", `
+Examples:
+  # Validate a tutor (also strict-renders every fragment in every referenced library)
+  $ novedu-cli validate ./tutors/my-tutor.yaml
+
+  # Validate a fragment library on its own
+  $ novedu-cli validate ./tutors/my-fragments.yaml --kind fragment
+
+  # Machine-readable output for CI
+  $ novedu-cli validate https://example.com/tutor.yaml --json`).action(async (pathOrUrl, options) => {
 		if (options.kind !== void 0 && options.kind !== "tutor" && options.kind !== "fragment") {
 			console.error(`Invalid --kind "${options.kind}": expected "tutor" or "fragment".`);
 			process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novedu/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Command-line companion for the Novedu chat app. Validates tutor YAML definitions and fragment libraries (more commands to follow).",
   "type": "module",
   "repository": {