nodality 1.2.9 → 1.2.10

package/bin/nodality.js

@@ -64,6 +64,13 @@ function showUsage() {
                                               #   --dir=<path>        copy SKILL.md anywhere
                                               #   --no-mcp            skip MCP registration
                                               # Re-run after upgrading to refresh in place.
+  nodality schema [type] [--check]            # Print the machine-readable element
+                                              # schema, derived from the source
+                                              # at run time. With a type, print
+                                              # just that type — the form an
+                                              # agent puts in its context.
+                                              #   --check  exit 1 if schema.json
+                                              #            is stale (used in CI)
   nodality help
 
 Compile flags:
@@ -872,6 +879,11 @@ async function main() {
     await runFanoutStandalone(rest);
   } else if (command === "stage") {
     await runStage(rest);
+  } else if (command === "schema") {
+    // Lazily imported like `mcp` and `skill`: a subcommand nobody invoked
+    // should cost nothing, and a broken generator must not take the CLI down.
+    const { runSchema } = await import("./schema-cli.mjs");
+    await runSchema(rest);
   } else if (command === "skill") {
     const { runSkillInstall } = await import("./install-skill.mjs");
     await runSkillInstall(rest);

package/bin/schema-cli.mjs

@@ -0,0 +1,28 @@
+// bin/schema-cli.mjs — `npx nodality schema [type] [--check]`
+//
+// Stage 2 of AGENTIC-FIRST-PLAN.md. The point of the subcommand is property 2
+// of "agentic-first": schema ON DEMAND rather than schema in context. A model
+// that can fetch one type's parameters pays for that type once, instead of
+// carrying every type's vocabulary in every request.
+//
+// The schema is regenerated from source on each call rather than read from
+// the committed schema.json, so what an agent is told can never be staler
+// than the library it is talking to. `--check` compares the two and is what
+// CI runs.
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+export async function runSchema(args) {
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  const gen = path.join(here, "..", "scripts", "generate-schema.mjs");
+  const type = args.find((a) => !a.startsWith("--"));
+  const passthrough = args.includes("--check")
+    ? ["--check"]
+    : type ? ["--type", type] : ["--stdout"];
+
+  await new Promise((resolve) => {
+    const p = spawn(process.execPath, [gen, ...passthrough], { stdio: "inherit" });
+    p.on("exit", (code) => { process.exitCode = code ?? 0; resolve(); });
+  });
+}

package/dist/animator.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/animator.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/audionew.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/audionew.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/base.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/base.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-desktop-bar.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-desktop-bar.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-mobile-bar.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-mobile-bar.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.8
+ * nodality v1.2.9
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */