@uns-kit/cli 3.0.5 → 3.0.7

package/README.md

@@ -2,16 +2,16 @@
 
 Command line scaffolding tool for the UNS toolkit. Bootstraps new projects with `@uns-kit/core` preconfigured and ready to extend with plugins. Also provides configure and upgrade commands for existing projects.
 
-Note: Apps built with uns-kit are intended to be managed by the **UNS Datahub controller**.
+Note: Apps built with uns-kit are intended to be managed by the **UNS OpenHub controller**.
 
 ## uns-kit in context
 
 | Package | Description |
 | --- | --- |
-| [`@uns-kit/core`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-core) | Base runtime (UnsProxyProcess, MQTT helpers, config tooling, gRPC gateway). |
-| [`@uns-kit/api`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-api) | Express plugin — HTTP endpoints, JWT/JWKS auth, Swagger, UNS metadata. |
-| [`@uns-kit/cron`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-cron) | Cron-driven scheduler that emits UNS events on a fixed cadence. |
-| [`@uns-kit/cli`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-cli) | CLI for scaffolding new UNS applications. |
+| [`@uns-kit/core`](https://github.com/uns-openhub/uns-kit/tree/main/packages/uns-core) | Base runtime (UnsProxyProcess, MQTT helpers, config tooling, gRPC gateway). |
+| [`@uns-kit/api`](https://github.com/uns-openhub/uns-kit/tree/main/packages/uns-api) | Express plugin — HTTP endpoints, JWT/JWKS auth, Swagger, UNS metadata. |
+| [`@uns-kit/cron`](https://github.com/uns-openhub/uns-kit/tree/main/packages/uns-cron) | Cron-driven scheduler that emits UNS events on a fixed cadence. |
+| [`@uns-kit/cli`](https://github.com/uns-openhub/uns-kit/tree/main/packages/uns-cli) | CLI for scaffolding new UNS applications. |
 
 ## Prerequisites
 
@@ -35,7 +35,7 @@ pnpm install
 pnpm run dev
 ```
 
-The scaffold creates a project directory from the default TypeScript template, pins `@uns-kit/core` to the current version, initialises a git repository if `git` is available, and marks the package as a controller-installable UNS Datahub add-on in `package.json`.
+The scaffold creates a project directory from the default TypeScript template, pins `@uns-kit/core` to the current version, initialises a git repository if `git` is available, and marks the package as a controller-installable UNS OpenHub add-on in `package.json`.
 
 The default template includes a Datahub REST client example (`UnsClient`) for last-value lookups, using a token-first pattern suitable for long-lived service tokens.
 
@@ -139,7 +139,7 @@ uns-kit upgrade           # upgrade current directory
 uns-kit upgrade ./my-app  # upgrade a specific project
 ```
 
-Removes scripts that have been superseded (`generate-uns-dictionary`, `generate-uns-measurements`, `generate-uns-reference`, `generate-uns-metadata`), ensures the `sync-uns-*` scripts and `package.json` UNS Datahub add-on metadata are present, and adds an idempotent managed section to `AGENTS.md` that directs agents to version-bounded `@uns-kit/core` migrations. Existing package metadata and project-specific agent instructions are preserved.
+Removes scripts that have been superseded (`generate-uns-dictionary`, `generate-uns-measurements`, `generate-uns-reference`, `generate-uns-metadata`), ensures the `sync-uns-*` scripts and `package.json` UNS OpenHub add-on metadata are present, and adds an idempotent managed section to `AGENTS.md` that directs agents to version-bounded `@uns-kit/core` migrations. Existing package metadata and project-specific agent instructions are preserved.
 
 The installed migration guide is `node_modules/@uns-kit/core/MIGRATIONS.md`.
 For example, an upgrade crossing `<2.0.71` to `>=2.0.71` must review MQTT

package/dist/index.js

@@ -10,8 +10,8 @@ import readline from "node:readline/promises";
 import { promisify } from "node:util";
 import * as azdev from "azure-devops-node-api";
 import { generateAgentsMarkdown, generateServiceSpecMarkdown, getServiceBundleOutputPublisherContracts, readAndValidateServiceBundle, } from "./service-bundle.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
+const currentFilename = fileURLToPath(import.meta.url);
+const currentDirname = path.dirname(currentFilename);
 const require = createRequire(import.meta.url);
 const cliVersion = resolveCliVersion();
 const coreVersion = resolveCoreVersion();
@@ -261,7 +261,7 @@ async function createProjectFromBundle(options) {
 }
 async function scaffoldTsProject(projectName, targetDir, options = {}) {
     await ensureTargetDir(targetDir, { allowExisting: options.allowExisting });
-    const templateDir = path.resolve(__dirname, `../templates/${options.templateName ?? DEFAULT_TEMPLATE_NAME}`);
+    const templateDir = path.resolve(currentDirname, `../templates/${options.templateName ?? DEFAULT_TEMPLATE_NAME}`);
     try {
         await access(templateDir);
     }
@@ -529,6 +529,7 @@ const AGENT_MIGRATION_BLOCK = [
     "- After installing the target version, read `node_modules/@uns-kit/core/MIGRATIONS.md` and apply every migration whose version boundary is crossed. Do not apply unrelated migrations.",
     "- When crossing `<2.0.71` to `>=2.0.71`, inspect MQTT proxy ownership and follow the documented shutdown migration. Process-owned and standalone proxies have different shutdown paths.",
     "- When crossing `<3.0.0` to `>=3.0.0`, migrate MQTT `message.table.columns` publishers from named arrays to named objects and consumers to object-entry iteration. Keep schema `tableColumns` and Assistant/UI table formats unchanged.",
+    "- When crossing `<3.0.7` to `>=3.0.7`, update the application's direct `zod` dependency to Zod 4, migrate Zod-3-only project config extension APIs, and regenerate `config.schema.json` plus `src/config/app-config.ts`.",
     AGENT_MIGRATION_END,
 ].join("\n");
 async function ensureAgentMigrationGuidance(targetDir) {
@@ -694,7 +695,7 @@ async function applyAzureDevopsConfig(targetDir, options) {
         scripts["pull-request"] = "node ./node_modules/@uns-kit/core/dist/tools/pull-request.js";
         pkgChanged = true;
     }
-    const azurePipelineTemplatePath = path.resolve(__dirname, "../templates/azure-pipelines.yml");
+    const azurePipelineTemplatePath = path.resolve(currentDirname, "../templates/azure-pipelines.yml");
     try {
         await access(azurePipelineTemplatePath);
     }
@@ -753,7 +754,7 @@ function logDevopsResult(result, options) {
 }
 async function configureVscode(targetPath, options = {}) {
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
-    const templateDir = path.resolve(__dirname, "../templates/vscode");
+    const templateDir = path.resolve(currentDirname, "../templates/vscode");
     try {
         await access(templateDir);
     }
@@ -786,7 +787,7 @@ async function configureVscode(targetPath, options = {}) {
 }
 async function configureConfigFiles(targetPath, options = {}) {
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
-    const templateDir = path.resolve(__dirname, "../templates/config-files");
+    const templateDir = path.resolve(currentDirname, "../templates/config-files");
     try {
         await access(templateDir);
     }
@@ -839,7 +840,7 @@ async function applyConfigTemplatePlaceholders(targetDir, relativePaths) {
 }
 async function configureCodegen(targetPath, options = {}) {
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
-    const templateDir = path.resolve(__dirname, "../templates/codegen");
+    const templateDir = path.resolve(currentDirname, "../templates/codegen");
     const packagePath = path.join(targetDir, "package.json");
     try {
         await access(templateDir);
@@ -1136,7 +1137,7 @@ function parseConfigureTemplatesArgs(args, availableTemplates) {
     return { targetPath, overwrite, includeAll, templateNames };
 }
 async function runConfigureTemplatesCommand(args) {
-    const templateRoot = path.resolve(__dirname, "../templates");
+    const templateRoot = path.resolve(currentDirname, "../templates");
     const availableTemplates = await listTemplateDirectories(templateRoot, { includeDefault: true });
     const allTemplates = await listTemplateDirectories(templateRoot, { includeDefault: false });
     const { targetPath, overwrite, includeAll, templateNames } = parseConfigureTemplatesArgs(args, availableTemplates);
@@ -1384,7 +1385,7 @@ function normalizeTemplateFilename(filename) {
 async function configurePlugin(options) {
     const { targetPath, templateName, dependencyName, dependencySpecifier, label, overwrite } = options;
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
-    const templateDir = path.resolve(__dirname, `../templates/${templateName}`);
+    const templateDir = path.resolve(currentDirname, `../templates/${templateName}`);
     const packagePath = path.join(targetDir, "package.json");
     try {
         await access(templateDir);
@@ -1852,7 +1853,7 @@ function normalizePackageName(input) {
         || "uns-app";
 }
 function resolveUnsPackageSpecifier(packageName, relativeLocalPath) {
-    const localPath = path.resolve(__dirname, relativeLocalPath);
+    const localPath = path.resolve(currentDirname, relativeLocalPath);
     if (existsSync(localPath)) {
         const pkg = require(localPath);
         const version = pkg?.version ?? "0.0.1";
@@ -1878,7 +1879,7 @@ function resolveUnsPackageVersion(packageName, relativeLocalPath) {
         return directVersion;
     }
     const workspaceVersion = attempt(() => {
-        const pkgPath = path.resolve(__dirname, relativeLocalPath);
+        const pkgPath = path.resolve(currentDirname, relativeLocalPath);
         const pkg = require(pkgPath);
         return pkg?.version;
     });
@@ -1944,7 +1945,7 @@ function resolveCoreVersion() {
         return directVersion;
     }
     const workspaceVersion = attempt(() => {
-        const localPath = path.resolve(__dirname, "../../uns-core/package.json");
+        const localPath = path.resolve(currentDirname, "../../uns-core/package.json");
         const pkg = require(localPath);
         return pkg?.version;
     });

package/dist/service-bundle.js

@@ -82,6 +82,7 @@ export function generateAgentsMarkdown(bundle) {
         "- After installing the target version, read `node_modules/@uns-kit/core/MIGRATIONS.md` and apply every migration whose version boundary is crossed. Do not apply unrelated migrations.",
         "- When crossing `<2.0.71` to `>=2.0.71`, inspect MQTT proxy ownership and follow the documented shutdown migration. Process-owned and standalone proxies have different shutdown paths.",
         "- When crossing `<3.0.0` to `>=3.0.0`, migrate MQTT `message.table.columns` publishers from named arrays to named objects and consumers to object-entry iteration. Keep schema `tableColumns` and Assistant/UI table formats unchanged.",
+        "- When crossing `<3.0.7` to `>=3.0.7`, update the application's direct `zod` dependency to Zod 4, migrate Zod-3-only project config extension APIs, and regenerate `config.schema.json` plus `src/config/app-config.ts`.",
         "<!-- uns-kit:migrations:end -->",
         "",
     ];

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@uns-kit/cli",
-  "version": "3.0.5",
+  "version": "3.0.7",
   "description": "Command line scaffolding tool for UNS applications",
   "type": "module",
   "license": "MIT",
   "author": "Aljoša Vister <aljosa.vister@gmail.com>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/uns-datahub/uns-kit.git",
+    "url": "https://github.com/uns-openhub/uns-kit.git",
     "directory": "packages/uns-cli"
   },
   "bin": {
@@ -25,15 +25,15 @@
     "templates"
   ],
   "dependencies": {
-    "azure-devops-node-api": "^15.1.1",
-    "@uns-kit/core": "3.0.5"
+    "azure-devops-node-api": "^15.1.2",
+    "@uns-kit/core": "3.0.7"
   },
   "unsKitPackages": {
-    "@uns-kit/core": "3.0.5",
-    "@uns-kit/api": "3.0.5",
-    "@uns-kit/cron": "3.0.5",
-    "@uns-kit/database": "3.0.5",
-    "@uns-kit/assistant-workflow": "3.0.5"
+    "@uns-kit/core": "3.0.7",
+    "@uns-kit/api": "3.0.7",
+    "@uns-kit/cron": "3.0.7",
+    "@uns-kit/database": "3.0.7",
+    "@uns-kit/assistant-workflow": "3.0.7"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/templates/cron/AGENTS.md

@@ -21,10 +21,13 @@ Pointers for AI/code-assist tools when working in this generated project.
 - `pnpm run sync-uns-metadata -- --controller-url ... --token ...` -> pulls topics/tags/assets from the controller and regenerates local TS helpers
 
 <!-- uns-kit:migrations:start -->
+
 ## UNS Kit dependency upgrades
 
 - Before changing any `@uns-kit/*` version, record the installed source version and intended target version.
 - After installing the target version, read `node_modules/@uns-kit/core/MIGRATIONS.md` and apply every migration whose version boundary is crossed. Do not apply unrelated migrations.
 - When crossing `<2.0.71` to `>=2.0.71`, inspect MQTT proxy ownership and follow the documented shutdown migration. Process-owned and standalone proxies have different shutdown paths.
 - When crossing `<3.0.0` to `>=3.0.0`, migrate MQTT `message.table.columns` publishers from named arrays to named objects and consumers to object-entry iteration. Keep schema `tableColumns` and Assistant/UI table formats unchanged.
+- When crossing `<3.0.7` to `>=3.0.7`, update the application's direct `zod` dependency to Zod 4, migrate Zod-3-only project config extension APIs, and regenerate `config.schema.json` plus `src/config/app-config.ts`.
+
 <!-- uns-kit:migrations:end -->

package/templates/default/AGENTS.md

@@ -21,10 +21,13 @@ Pointers for AI/code-assist tools when working in this generated project.
 - `pnpm run sync-uns-metadata -- --controller-url ... --token ...` -> pulls topics/tags/assets from the controller and regenerates local TS helpers
 
 <!-- uns-kit:migrations:start -->
+
 ## UNS Kit dependency upgrades
 
 - Before changing any `@uns-kit/*` version, record the installed source version and intended target version.
 - After installing the target version, read `node_modules/@uns-kit/core/MIGRATIONS.md` and apply every migration whose version boundary is crossed. Do not apply unrelated migrations.
 - When crossing `<2.0.71` to `>=2.0.71`, inspect MQTT proxy ownership and follow the documented shutdown migration. Process-owned and standalone proxies have different shutdown paths.
 - When crossing `<3.0.0` to `>=3.0.0`, migrate MQTT `message.table.columns` publishers from named arrays to named objects and consumers to object-entry iteration. Keep schema `tableColumns` and Assistant/UI table formats unchanged.
+- When crossing `<3.0.7` to `>=3.0.7`, update the application's direct `zod` dependency to Zod 4, migrate Zod-3-only project config extension APIs, and regenerate `config.schema.json` plus `src/config/app-config.ts`.
+
 <!-- uns-kit:migrations:end -->

package/templates/default/README.md

@@ -69,7 +69,7 @@ shows how a producer publishes:
 - `systemRole: "lifecycle-time-source"` with `lifecycle`
 
 These fields are retained in the produced-topics registry and stored by the
-UNS Datahub controller in `attribute_schema.schema_json`.
+UNS OpenHub controller in `attribute_schema.schema_json`.
 
 ## Sub-Asset Publishing
 
@@ -86,7 +86,7 @@ asset path and `asset` is the leaf sub-asset.
 
 ## Datahub client (last value)
 
-`UnsClient` provides a minimal REST client for the UNS Datahub API, including the batch last-value endpoint. Prefer a long-lived service token if available; you can pass it directly and skip username/password auth.
+`UnsClient` provides a minimal REST client for the UNS OpenHub API, including the batch last-value endpoint. Prefer a long-lived service token if available; you can pass it directly and skip username/password auth.
 
 ```ts
 import { ConfigFile, UnsClient } from "@uns-kit/core";

package/templates/default/package.json

@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@uns-kit/core": "__UNS_KIT_CORE_VERSION__",
-    "zod": "^3.23.8"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^22.19.1",