@uns-kit/cli 2.0.47 → 2.0.50

package/dist/index.js

@@ -394,7 +394,9 @@ function setPackageScript(scripts, name, command) {
     return true;
 }
 function ensureUnsReferenceScripts(scripts) {
-    return setPackageScript(scripts, "sync-uns-schema", "node ./node_modules/@uns-kit/core/dist/tools/sync-uns-schema.js");
+    const schemaChanged = setPackageScript(scripts, "sync-uns-schema", "node ./node_modules/@uns-kit/core/dist/tools/sync-uns-schema.js");
+    const metadataChanged = setPackageScript(scripts, "sync-uns-metadata", "node ./node_modules/@uns-kit/core/dist/tools/sync-uns-metadata.js");
+    return schemaChanged || metadataChanged;
 }
 const OBSOLETE_SCRIPTS = [
     "generate-uns-dictionary",
@@ -847,12 +849,8 @@ async function upgradeProject(targetPath) {
             changed = true;
         }
     }
-    // Ensure sync-uns-schema is present if any uns-reference scripts were present
-    const hadUnsReference = removed.some((name) => name.startsWith("generate-uns"));
-    if (hadUnsReference && !scripts["sync-uns-schema"]) {
-        scripts["sync-uns-schema"] = "node ./node_modules/@uns-kit/core/dist/tools/sync-uns-schema.js";
-        changed = true;
-    }
+    const syncScriptsChanged = ensureUnsReferenceScripts(scripts);
+    changed = syncScriptsChanged || changed;
     if (changed) {
         await writeFile(packagePath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
     }
@@ -863,8 +861,11 @@ async function upgradeProject(targetPath) {
             console.log(`    - ${name}`);
         }
     }
-    if (hadUnsReference && !scripts["sync-uns-schema"]) {
-        console.log("  Added: sync-uns-schema");
+    if (syncScriptsChanged) {
+        console.log("  Added/updated: sync-uns-schema, sync-uns-metadata");
+    }
+    else {
+        console.log("  Ensured: sync-uns-schema, sync-uns-metadata");
     }
     if (!changed) {
         console.log("  Already up to date.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uns-kit/cli",
-  "version": "2.0.47",
+  "version": "2.0.50",
   "description": "Command line scaffolding tool for UNS applications",
   "type": "module",
   "license": "MIT",
@@ -26,13 +26,14 @@
   ],
   "dependencies": {
     "azure-devops-node-api": "^15.1.1",
-    "@uns-kit/core": "2.0.46"
+    "@uns-kit/core": "2.0.50"
   },
   "unsKitPackages": {
-    "@uns-kit/core": "2.0.46",
-    "@uns-kit/api": "2.0.46",
-    "@uns-kit/cron": "2.0.45",
-    "@uns-kit/temporal": "2.0.44"
+    "@uns-kit/core": "2.0.50",
+    "@uns-kit/api": "2.0.50",
+    "@uns-kit/cron": "2.0.50",
+    "@uns-kit/database": "2.0.50",
+    "@uns-kit/temporal": "2.0.47"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/templates/cron/AGENTS.md

@@ -4,7 +4,7 @@ Pointers for AI/code-assist tools when working in this generated project.
 
 ## What to read locally
 
-- `package.json` for scripts (`generate-uns-*`, `generate-codegen`, etc.).
+- `package.json` for scripts (`sync-uns-*`, `generate-codegen`, etc.).
 - `config.schema.json` for the app config shape; `processName` is required.
 - `src/examples/*.ts` for cron-driven publish patterns and description registration.
 - Installed docs (under `node_modules`):
@@ -16,9 +16,6 @@ Pointers for AI/code-assist tools when working in this generated project.
 
 ## Generators in this project
 
-- `pnpm run generate-uns-dictionary` -> updates `src/uns/uns-dictionary.generated.ts`
-- `pnpm run generate-uns-measurements` -> updates `src/uns/uns-measurements.generated.ts`
-- `pnpm run generate-uns-reference` -> runs both
-- `pnpm run generate-uns-metadata` -> refreshes topic/tag unions (requires GraphQL connectivity)
 - `pnpm run generate-codegen` -> GraphQL codegen (after configure-codegen)
 - `pnpm run sync-uns-schema -- --controller-url ... --token ...` -> pulls `uns-dictionary.json` + `uns-measurements.json` from the controller and regenerates local TS helpers
+- `pnpm run sync-uns-metadata -- --controller-url ... --token ...` -> pulls topics/tags/assets from the controller and regenerates local TS helpers

package/templates/default/AGENTS.md

@@ -4,7 +4,7 @@ Pointers for AI/code-assist tools when working in this generated project.
 
 ## What to read locally
 
-- `package.json` for scripts (`generate-uns-*`, `generate-codegen`, etc.).
+- `package.json` for scripts (`sync-uns-*`, `generate-codegen`, etc.).
 - `config.schema.json` for the app config shape; `processName` is required.
 - `src/examples/*.ts` for idiomatic publishing (multi-attribute) and description registration.
 - Installed docs (under `node_modules`):
@@ -16,9 +16,6 @@ Pointers for AI/code-assist tools when working in this generated project.
 
 ## Generators in this project
 
-- `pnpm run generate-uns-dictionary` -> updates `src/uns/uns-dictionary.generated.ts`
-- `pnpm run generate-uns-measurements` -> updates `src/uns/uns-measurements.generated.ts`
-- `pnpm run generate-uns-reference` -> runs both
-- `pnpm run generate-uns-metadata` -> refreshes topic/tag unions (requires GraphQL connectivity)
 - `pnpm run generate-codegen` -> GraphQL codegen (after configure-codegen)
 - `pnpm run sync-uns-schema -- --controller-url ... --token ...` -> pulls `uns-dictionary.json` + `uns-measurements.json` from the controller and regenerates local TS helpers
+- `pnpm run sync-uns-metadata -- --controller-url ... --token ...` -> pulls topics/tags/assets from the controller and regenerates local TS helpers

package/templates/default/README.md

@@ -12,11 +12,8 @@ pnpm run build  # emit dist/ output
 pnpm run start  # run the compiled entrypoint
 pnpm run generate-config-schema  # regenerate config.schema.json and AppConfig augmentations
 pnpm run generate-codegen            # regenerate typed GraphQL operations (after configure-codegen)
-pnpm run generate-uns-metadata  # rebuild UNS topics/tags from the live schema
-pnpm run generate-uns-dictionary  # generate typed object/attribute dictionary from uns-dictionary.json
-pnpm run generate-uns-measurements  # generate typed measurement units from uns-measurements.json
-pnpm run generate-uns-reference    # run both dictionary + measurements generators
 pnpm run sync-uns-schema -- --controller-url http://localhost:3200 --token <admin-bearer-token>  # pull dictionary + measurements from the controller
+pnpm run sync-uns-metadata -- --controller-url http://localhost:3200 --token <metadata-export-token>  # refresh topics/tags/assets for IntelliSense
 ```
 
 ## Configuration
@@ -74,8 +71,7 @@ console.log(values);
 - Run `uns-kit configure-vscode` to copy workspace/launch configuration for VS Code.
 - Run `uns-kit configure-codegen` to scaffold GraphQL code generation and UNS refresh scripts.
 - Run `pnpm run sync-uns-schema -- --controller-url ... --token ...` to pull `uns-dictionary.json` and `uns-measurements.json` from the controller export into this project, then regenerate the typed files automatically.
-- If you want to curate local files manually, edit `uns-dictionary.json` (object types/attributes + descriptions) and run `pnpm run generate-uns-dictionary` to emit `src/uns/uns-dictionary.generated.ts` for IDE hints/metadata; publish calls will automatically fall back to these descriptions when you omit them.
-- Edit `uns-measurements.json` (units + descriptions) and run `pnpm run generate-uns-measurements` to emit `src/uns/uns-measurements.generated.ts` and feed measurement unit IntelliSense.
+- Run `pnpm run sync-uns-metadata -- --controller-url ... --token ...` to regenerate topic, tag, and asset IntelliSense from the controller metadata export. The token must be admin or include `export:uns-reference`.
 - Run `uns-kit configure-api` / `configure-cron` / `configure-temporal` to pull in example stubs and install the matching UNS plugins (add `--overwrite` to refresh templates).
 - Run `uns-kit configure-python` to copy the Python gateway client template (examples, scripts, proto).
 - Commit your new project and start building!

package/templates/default/package.json

@@ -28,7 +28,8 @@
     "format:check": "prettier --check .",
     "generate-config-schema": "node ./node_modules/@uns-kit/core/dist/tools/generate-config-schema.js",
     "generate-codegen": "graphql-code-generator --require dotenv/config --config codegen.ts",
-    "sync-uns-schema": "node ./node_modules/@uns-kit/core/dist/tools/sync-uns-schema.js"
+    "sync-uns-schema": "node ./node_modules/@uns-kit/core/dist/tools/sync-uns-schema.js",
+    "sync-uns-metadata": "node ./node_modules/@uns-kit/core/dist/tools/sync-uns-metadata.js"
   },
   "dependencies": {
     "@uns-kit/core": "__UNS_KIT_CORE_VERSION__",

package/templates/default/src/uns/uns-assets.ts

@@ -1,6 +1,6 @@
-// Generated UNS asset list. Run `pnpm refresh-uns` to update.
+// Generated UNS asset list. Run `pnpm run sync-uns-metadata` to update.
 export const GeneratedAssets = {
-  /** Example asset. Replace with your own names after running generate-uns-metadata. */
+  /** Example asset. Replace with your own names after running sync-uns-metadata. */
   "asset": "asset",
 } as const;
 export type GeneratedAssetName = typeof GeneratedAssets[keyof typeof GeneratedAssets];

package/templates/default/src/uns/uns-tags.ts

@@ -1,2 +1,2 @@
-// Generated UNS tag union. Run `pnpm refresh-uns` to update.
+// Generated UNS tag union. Run `pnpm run sync-uns-metadata` to update.
 export type UnsTags = string & {};

package/templates/default/src/uns/uns-topics.ts

@@ -1,2 +1,2 @@
-// Generated UNS topic union. Run `pnpm refresh-uns` to update.
+// Generated UNS topic union. Run `pnpm run sync-uns-metadata` to update.
 export type UnsTopics = string & {};