@unoverse-platform/studio 0.1.94 → 0.1.96

package/local/scaffold.mjs

@@ -185,11 +185,43 @@ export function topUpSamples(home, project) {
  * Skills, prompt blocks and nodes are per-developer and not per-project, so they are made
  * once here and never by `createProject`.
  */
+
+/**
+ * EDITOR HELP FOR NODES, WITHOUT A LINE IN EVERY FILE (2026-09-05). The YAML language
+ * server maps files to schemas by glob from `.vscode/settings.json`, so a workspace that
+ * carries this mapping gets autocomplete and errors on every node file it will ever hold,
+ * and no file needs a `$schema:` key. The schemas are the docs site's, so the mapping
+ * stays true across releases. Written once, never over a developer's own settings.
+ */
+const SCHEMAS = "https://docs.unoverse.ai/schemas/nodes";
+const NODE_SCHEMA_MAP = {
+  [`${SCHEMAS}/package.schema.json`]: ["nodes/*/package.yaml"],
+  [`${SCHEMAS}/credential.schema.json`]: ["nodes/*/credentials/*.yaml"],
+  [`${SCHEMAS}/node.schema.json`]: ["nodes/*/nodes/*/node.yaml"],
+  [`${SCHEMAS}/interface.schema.json`]: ["nodes/*/nodes/*/interface.yaml"],
+  [`${SCHEMAS}/config.schema.json`]: ["nodes/*/nodes/*/config.yaml"],
+  [`${SCHEMAS}/test.schema.json`]: ["nodes/*/nodes/*/test.yaml"],
+  [`${SCHEMAS}/run.schema.json`]: ["nodes/*/nodes/*/api/run.yaml"],
+  [`${SCHEMAS}/events.schema.json`]: ["nodes/*/nodes/*/api/events.yaml"],
+  [`${SCHEMAS}/service.schema.json`]: ["nodes/*/nodes/*/api/service.yaml"],
+  [`${SCHEMAS}/toolExchange.schema.json`]: ["nodes/*/nodes/*/api/toolExchange.yaml"],
+  [`${SCHEMAS}/audio.schema.json`]: ["nodes/*/nodes/*/api/audio.yaml"],
+};
+export function writeEditorSettings(home) {
+  const dir = join(home, ".vscode");
+  mkdirSync(dir, { recursive: true });
+  const settings = join(dir, "settings.json");
+  if (!existsSync(settings)) writeFileSync(settings, JSON.stringify({ "yaml.schemas": NODE_SCHEMA_MAP }, null, 2) + "\n");
+  const ext = join(dir, "extensions.json");
+  if (!existsSync(ext)) writeFileSync(ext, JSON.stringify({ recommendations: ["redhat.vscode-yaml"] }, null, 2) + "\n");
+}
+
 export function createFirstProject(home, name) {
   const root = createProject(home, name);
   // Only nodes/ remains beside the design tree; skills/ and blocks/ moved INTO the org
   // (createProject makes them) so every authored kind sits in one place.
   for (const d of ["nodes"]) mkdirSync(join(home, d), { recursive: true });
+  writeEditorSettings(home);
 
   topUpSamples(home, name);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unoverse-platform/studio",
-  "version": "0.1.94",
+  "version": "0.1.96",
   "type": "module",
   "description": "Unoverse Studio: the local authoring app. Reads your own rx/ folder, no backend.",
   "scripts": {

package/vendor/base/src/lint/nodes/index.mjs

@@ -15,7 +15,7 @@
  *
  * FOUR TIERS (docs/architecture/DECLARATIVE_NODES.md §6). This is tiers 2 and 3.
  *   1  editor    $schema pointers + .vscode yaml.schemas, no tool
- *   2  structural   every part validated against nodes/_schema/*.json
+ *   2  structural   every part validated against the node schemas (packages/docs/schemas/nodes)
  *   3  semantic     the cross-file rules a schema cannot express
  *   4  dry run      `unoverse node test`, executes against testData, not here
  */
@@ -36,16 +36,17 @@ import { lintPackage } from "./package.mjs";
 /**
  * Where the node schemas are, for this run.
  *
- * The platform's own tree carries them at `nodes/_schema/`, and every node file points at
- * them with `$schema:` for editor squiggles. A DEVELOPER'S WORKSPACE DOES NOT: it holds only
- * their packages, and a linter that then warned "no schema found" on every file was
- * validating nothing while looking busy. So the schemas travel with the linter. In dist
- * they sit beside this file (copy-lint.mjs puts them there, and the CLI vendors that
- * folder); from source they are the monorepo's copy, five levels up.
+ * Their home is packages/docs/schemas/nodes, which the docs site serves at the URL every
+ * node file's `$schema:` names (so any editor validates online). The linter runs offline
+ * and a developer's workspace holds no copy, and a linter that warned "no schema found" on
+ * every file was validating nothing while looking busy. So the schemas travel with the
+ * linter: in dist they sit beside this file (copy-lint.mjs puts them there, and the CLI
+ * vendors that folder); from source they are the docs tree's copy. A `_schema` folder in
+ * the workspace itself still wins, for anyone pinning a version.
  */
 function schemaHome(home) {
   const here = dirname(fileURLToPath(import.meta.url));
-  for (const c of [join(home, "_schema"), join(here, "_schema"), resolve(here, "../../../../../apps/unoverse/nodes/_schema")])
+  for (const c of [join(home, "_schema"), join(here, "_schema"), resolve(here, "../../../../docs/schemas/nodes")])
     if (existsSync(c)) return c;
   return join(home, "_schema");
 }

package/vendor/base/src/lint/nodes/schema.mjs

@@ -1,5 +1,5 @@
 /**
- * Tier 2: structural validation against nodes/_schema/*.json.
+ * Tier 2: structural validation against the node schemas (packages/docs/schemas/nodes).
  *
  * A JSON Schema catches shape. Everything a schema CANNOT express (cross-file agreement,
  * ordering, reachability) is tier 3 and lives in the rule modules.
@@ -25,13 +25,13 @@ try {
 }
 
 export const SCHEMA_ID = {
-  node: "https://unoverse/nodes/node.schema.json",
-  interface: "https://unoverse/nodes/interface.schema.json",
-  config: "https://unoverse/nodes/config.schema.json",
-  api: "https://unoverse/nodes/api.schema.json",
-  test: "https://unoverse/nodes/test.schema.json",
-  package: "https://unoverse/nodes/package.schema.json",
-  credential: "https://unoverse/nodes/credential.schema.json",
+  node: "https://docs.unoverse.ai/schemas/nodes/node.schema.json",
+  interface: "https://docs.unoverse.ai/schemas/nodes/interface.schema.json",
+  config: "https://docs.unoverse.ai/schemas/nodes/config.schema.json",
+  api: "https://docs.unoverse.ai/schemas/nodes/api.schema.json",
+  test: "https://docs.unoverse.ai/schemas/nodes/test.schema.json",
+  package: "https://docs.unoverse.ai/schemas/nodes/package.schema.json",
+  credential: "https://docs.unoverse.ai/schemas/nodes/credential.schema.json",
 };
 
 /** The four sections that may live in their own file OR inline in node.yaml. */
@@ -53,7 +53,7 @@ export function loadSchemas() {
 export function validateAgainst(schemaId, doc, file, label) {
   const schema = state.schemas[schemaId];
   if (!schema) {
-    report("warn", file, `no schema found for ${label}. Is nodes/_schema/ present?`);
+    report("warn", file, `no schema found for ${label}. The linter's bundled schemas are missing; rebuild base`);
     return;
   }
   const v = new Validator(schema, "7", false);