v3.1.1

.gitignore

@@ -1,4 +1,23 @@
-node_modules/
+.nogit/
+
+# artifacts
 coverage/
 public/
-pages/
+
+# installs
+node_modules/
+
+# caches
+.yarn/
+.cache/
+.rpt2_cache
+
+# builds
+dist/
+dist_*/
+
+# AI
+.claude/
+.serena/
+
+#------# custom

.gitlab-ci.yml

@@ -1,71 +0,0 @@
-# gitzone standard
-image: hosttoday/ht-docker-node:npmci
-
-cache:
-  paths:
-  - .yarn/
-  key: "$CI_BUILD_STAGE"
-
-stages:
-- test
-- release
-- trigger
-- pages
-
-testLEGACY:
-  stage: test
-  script:
-    - npmci test legacy
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-    - docker
-  allow_failure: true
-
-testLTS:
-  stage: test
-  script:
-    - npmci test lts
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-    - docker
-    
-testSTABLE:
-  stage: test
-  script:
-    - npmci test stable
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-    - docker
-
-release:
-  stage: release
-  script:
-    - npmci publish
-  only:
-    - tags
-  tags:
-    - docker
-
-trigger:
-  stage: trigger
-  script:
-    - npmci trigger
-  only:
-    - tags
-  tags:
-    - docker
-
-pages:
-  image: hosttoday/ht-docker-node:npmci
-  stage: pages
-  script:
-    - npmci command yarn global add npmpage
-    - npmci command npmpage
-  tags:
-    - docker
-  only:
-    - tags
-  artifacts:
-    expire_in: 1 week
-    paths:
-    - public

.vscode/launch.json

@@ -0,0 +1,29 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "current file",
+      "type": "node",
+      "request": "launch",
+      "args": [
+        "${relativeFile}"
+      ],
+      "runtimeArgs": ["-r", "@git.zone/tsrun"],
+      "cwd": "${workspaceRoot}",
+      "protocol": "inspector",
+      "internalConsoleOptions": "openOnSessionStart"
+    },
+    {
+      "name": "test.ts",
+      "type": "node",
+      "request": "launch",
+      "args": [
+        "test/test.ts"
+      ],
+      "runtimeArgs": ["-r", "@git.zone/tsrun"],
+      "cwd": "${workspaceRoot}",
+      "protocol": "inspector",
+      "internalConsoleOptions": "openOnSessionStart"
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,26 @@
+{
+  "json.schemas": [
+    {
+      "fileMatch": ["/npmextra.json"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "npmci": {
+            "type": "object",
+            "description": "settings for npmci"
+          },
+          "gitzone": {
+            "type": "object",
+            "description": "settings for gitzone",
+            "properties": {
+              "projectType": {
+                "type": "string",
+                "enum": ["website", "element", "service", "npm", "wcc"]
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Lossless GmbH
+Copyright (c) 2016 Task Venture Capital GmbH
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,2 +0,0 @@
-# npmg
-Install and update global node modules without hassle.

changelog.md

@@ -0,0 +1,108 @@
+# Changelog
+
+## 2026-02-03 - 3.1.1 - fix(tools)
+no changes detected
+
+- No files were modified in this diff
+- No code or documentation changes to include in a commit message
+
+## 2026-02-03 - 3.1.0 - feat(cli)
+add update command to check and update globally installed @git.zone packages
+
+- Adds a new mod_update module and PackageManagerUtil to detect installed @git.zone packages and fetch latest versions
+- Supports npm, yarn and pnpm: detection, listing, version comparison and executing updates
+- Interactive confirmation via @push.rocks/smartinteract with a -y flag to skip prompt
+- Uses @push.rocks/smartshell to run shell commands for listing and updating packages
+- Wires the new 'update' command into the CLI (tools.cli) and updates CLI version to 3.0.0
+- Adds CLI helper files (cli.child.js, adjusts cli.js and cli.ts.js) to run TypeScript CLI via tsrun/runPath
+- Updates package.json to include new dependencies and npmextra.json with release registries and @git.zone/cli metadata
+- Updates .gitignore to exclude local AI tool dirs (.claude, .serena)
+
+## 2026-02-03 - 3.0.0 - BREAKING CHANGE(tools)
+replace install functionality with a minimal placeholder CLI; remove installer, logging, path utilities, and related assets
+
+- Removed installer implementation (ts/tools.install.ts) and package library asset (assets/package_library.json).
+- Removed logging and path utilities (ts/tools.logging.ts, ts/tools.paths.ts) and simplified plugins (ts/tools.plugins.ts) to only export smartcli.
+- Reworked CLI (ts/tools.cli.ts) to a placeholder standard command that prints messages instead of running installs; internal CLI version set to 2.0.22.
+- Module export/behavior changed: ts/index.ts now exports runCli and no longer auto-runs; tests updated to expect runCli.
+- package.json updated: description changed, several dependencies removed (e.g. @push.rocks/smartlog, @push.rocks/smartshell), @types/node bumped to ^22.0.0, and assets removed from packaged files list.
+- Removed project policy and metadata files: .snyk deleted and readme.md added with usage and legal information.
+
+## 2026-02-03 - 2.0.22 - core
+Core maintenance release.
+
+- fix(core): update — minor core fixes and maintenance improvements.
+
+## 2026-02-03 - 2.0.23 - release tag
+Release tag only — no recorded changelog details.
+
+- 2.0.23: release tag with no additional commit message.
+
+## 2020-10-05 - 2.0.3 - 2.0.21 - core (maintenance)
+Series of maintenance releases containing repeated small core fixes.
+
+- Multiple commits "fix(core): update" applied across 2.0.3 through 2.0.21 addressing minor bugs and stability improvements.
+- These releases are maintenance-focused; no user-facing feature additions recorded.
+
+## 2019-06-17 - 2.0.2 - core
+Maintenance update to core.
+
+- fix(core): update — continued minor fixes and upkeep.
+
+## 2018-06-07 - 2.0.0 - 2.0.1 - policy/package fixes
+Initial 2.0.x releases with policy and package fixes.
+
+- 2.0.0: fix(snyk policy): update — update to Snyk policy.
+- 2.0.1: fix(package.json): fix private property — corrected package.json property.
+- 2.0.2: release tag (later maintenance continued in subsequent 2.0.x).
+
+## 2018-06-07 - 1.0.9 - core (feature)
+New core scope added.
+
+- feat(core): new tools scope — introduces a "tools" scope in core.
+
+## 2017-06-04 - 1.0.8 - release tag
+Release tag only — no recorded changelog details.
+
+- 1.0.8: release tag with no additional commit message.
+
+## 2017-06-04 - 1.0.7 - cli
+CLI update.
+
+- update cli — improvements/updates to the command-line interface.
+
+## 2017-05-28 - 1.0.6 / 1.0.5 - docs & CLI
+Documentation and CLI additions.
+
+- 1.0.6: update README — documentation updates.
+- 1.0.5: add cli.js — adds CLI entry point.
+
+## 2017-05-28 - 1.0.4 - maintenance and cleanups
+Collection of maintenance, cleanup, and packaging updates for 1.0.4 over several commits.
+
+- update / cleanup — general code cleanups.
+- Update packageLibrary.json — package metadata adjusted.
+- added cli.js, added .npmignore — packaging and CLI support added.
+- Consolidated multiple 1.0.4 changes across 2016–2017 into this release.
+
+## 2016-03-03 - 1.0.3 - tests
+Test fix.
+
+- fix test.ts — test suite correction.
+
+## 2016-03-03 - 1.0.2 - CI
+Continuous integration fix.
+
+- fix Travis — adjusts CI configuration.
+
+## 2016-03-02 - 1.0.1 - install/tests
+Installer and tests improvements.
+
+- now installing things correctly — fixes installation behavior.
+- create test / update — test additions and miscellaneous updates.
+
+## 2016-03-02 - 1.0.0 - initial release
+Project initial structure and first release.
+
+- add structure / set up initial structure / cleanup — initial project layout and housekeeping.
+- initial (2016-02-29 and 2016-02-24) — first commits establishing the repository.

cli.child.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+process.env.CLI_CALL = 'true';
+import * as cliTool from './ts/index.js';
+cliTool.runCli();

cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+process.env.CLI_CALL = 'true';
+const cliTool = await import('./dist_ts/index.js');
+cliTool.runCli();

cli.ts.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+process.env.CLI_CALL = 'true';
+
+import * as tsrun from '@git.zone/tsrun';
+tsrun.runPath('./cli.child.js', import.meta.url);

dist/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const cli = require("./npmg.cli");
-cli.run();
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUNBLGtDQUFpQztBQUNqQyxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUEifQ==

dist/npmg.cli.d.ts

@@ -1 +0,0 @@
-export declare let run: () => Promise<void>;

dist/npmg.cli.js

@@ -1,17 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const plugins = require("./npmg.plugins");
-let npmgSmartcli = new plugins.smartcli.Smartcli();
-exports.run = () => __awaiter(this, void 0, void 0, function* () {
-    npmgSmartcli.addCommand('install').then((argvArg) => __awaiter(this, void 0, void 0, function* () {
-    }));
-});
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibnBtZy5jbGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9ucG1nLmNsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7O0FBQUEsMENBQXlDO0FBR3pDLElBQUksWUFBWSxHQUFHLElBQUksT0FBTyxDQUFDLFFBQVEsQ0FBQyxRQUFRLEVBQUUsQ0FBQTtBQUV2QyxRQUFBLEdBQUcsR0FBRztJQUNmLFlBQVksQ0FBQyxVQUFVLENBQUMsU0FBUyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQU8sT0FBTztJQUV0RCxDQUFDLENBQUEsQ0FBQyxDQUFBO0FBQ0osQ0FBQyxDQUFBLENBQUEifQ==

dist/npmg.install.d.ts

@@ -1 +0,0 @@
-export declare let install: (packageSetArg: String) => Promise<void>;

dist/npmg.install.js

@@ -1,36 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const plugins = require("./npmg.plugins");
-const paths = require("./npmg.paths");
-let installExec = (packageNames) => __awaiter(this, void 0, void 0, function* () {
-    let installString = '';
-    for (let packageName of packageNames) {
-        installString = installString + `${packageName} `;
-    }
-    yield plugins.smartshell.exec(`yarn global remove ${installString}`);
-    for (let packageName of packageNames) {
-        plugins.beautylog.info(`now preparing ${packageName}`);
-        yield plugins.smartshell.exec(`yarn global remove ${packageName}`);
-    }
-    yield plugins.smartshell.exec(`yarn global add ${installString}`);
-});
-let packageLibrary = plugins.smartfile.fs.toObjectSync(plugins.path.join(paths.packageBase, 'package_library.json'));
-exports.install = (packageSetArg) => __awaiter(this, void 0, void 0, function* () {
-    switch (packageSetArg) {
-        case 'default':
-            yield installExec(packageLibrary.default);
-            break;
-        default:
-            plugins.beautylog.warn('no set has been specified');
-            break;
-    }
-});
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibnBtZy5pbnN0YWxsLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvbnBtZy5pbnN0YWxsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7QUFBQSwwQ0FBMkM7QUFDM0Msc0NBQXVDO0FBRXZDLElBQUksV0FBVyxHQUFHLENBQU8sWUFBc0I7SUFDN0MsSUFBSSxhQUFhLEdBQUcsRUFBRSxDQUFBO0lBQ3RCLEdBQUcsQ0FBQyxDQUFDLElBQUksV0FBVyxJQUFJLFlBQVksQ0FBQyxDQUFDLENBQUM7UUFDckMsYUFBYSxHQUFHLGFBQWEsR0FBRyxHQUFHLFdBQVcsR0FBRyxDQUFBO0lBQ25ELENBQUM7SUFDRCxNQUFNLE9BQU8sQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLHNCQUFzQixhQUFhLEVBQUUsQ0FBQyxDQUFBO0lBQ3BFLEdBQUcsQ0FBQyxDQUFDLElBQUksV0FBVyxJQUFJLFlBQVksQ0FBQyxDQUFDLENBQUM7UUFDckMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsaUJBQWlCLFdBQVcsRUFBRSxDQUFDLENBQUE7UUFDdEQsTUFBTSxPQUFPLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxzQkFBc0IsV0FBVyxFQUFFLENBQUMsQ0FBQTtJQUNwRSxDQUFDO0lBQ0QsTUFBTSxPQUFPLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxtQkFBbUIsYUFBYSxFQUFFLENBQUMsQ0FBQTtBQUNuRSxDQUFDLENBQUEsQ0FBQTtBQUVELElBQUksY0FBYyxHQUFHLE9BQU8sQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDLFlBQVksQ0FDcEQsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFdBQVcsRUFBRSxzQkFBc0IsQ0FBQyxDQUM3RCxDQUFDO0FBRVMsUUFBQSxPQUFPLEdBQUcsQ0FBTyxhQUFxQjtJQUMvQyxNQUFNLENBQUMsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDO1FBQ3RCLEtBQUssU0FBUztZQUNaLE1BQU0sV0FBVyxDQUFDLGNBQWMsQ0FBQyxPQUFPLENBQUMsQ0FBQTtZQUN6QyxLQUFLLENBQUE7UUFDUDtZQUNFLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLDJCQUEyQixDQUFDLENBQUM7WUFDcEQsS0FBSyxDQUFBO0lBQ1QsQ0FBQztBQUNILENBQUMsQ0FBQSxDQUFBIn0=

dist/npmg.paths.d.ts

@@ -1 +0,0 @@
-export declare let packageBase: string;

dist/npmg.paths.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const plugins = require("./npmg.plugins");
-exports.packageBase = plugins.path.join('__dirname', '../');
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibnBtZy5wYXRocy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL25wbWcucGF0aHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSwwQ0FBMkM7QUFFaEMsUUFBQSxXQUFXLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxFQUFFLEtBQUssQ0FBQyxDQUFBIn0=

dist/npmg.plugins.d.ts

@@ -1,7 +0,0 @@
-import 'typings-global';
-import * as beautylog from 'beautylog';
-import * as path from 'path';
-import * as smartcli from 'smartcli';
-import * as smartfile from 'smartfile';
-import * as smartshell from 'smartshell';
-export { beautylog, path, smartcli, smartfile, smartshell };

dist/npmg.plugins.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-require("typings-global");
-const beautylog = require("beautylog");
-exports.beautylog = beautylog;
-const path = require("path");
-exports.path = path;
-const smartcli = require("smartcli");
-exports.smartcli = smartcli;
-const smartfile = require("smartfile");
-exports.smartfile = smartfile;
-const smartshell = require("smartshell");
-exports.smartshell = smartshell;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibnBtZy5wbHVnaW5zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvbnBtZy5wbHVnaW5zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUEsMEJBQXVCO0FBQ3ZCLHVDQUFzQztBQU9wQyw4QkFBUztBQU5YLDZCQUE0QjtBQU8xQixvQkFBSTtBQU5OLHFDQUFvQztBQU9sQyw0QkFBUTtBQU5WLHVDQUFzQztBQU9wQyw4QkFBUztBQU5YLHlDQUF3QztBQU90QyxnQ0FBVSJ9

npmextra.json

@@ -2,7 +2,26 @@
   "npmts": {
     "cli": true
   },
-  "npmci": {
+  "@git.zone/cli": {
+    "projectType": "npm",
+    "module": {
+      "githost": "gitlab.com",
+      "gitscope": "gitzone",
+      "gitrepo": "tools",
+      "shortDescription": "setup your environment with the most important tools and update them easily.",
+      "npmPackagename": "@git.zone/tools",
+      "license": "MIT",
+      "description": "manage git.zone tools"
+    },
+    "release": {
+      "registries": [
+        "https://verdaccio.lossless.digital",
+        "https://registry.npmjs.org"
+      ],
+      "accessLevel": "public"
+    }
+  },
+  "@ship.zone/szci": {
     "globalNpmTools": [
       "npmts"
     ]

package.json

@@ -1,14 +1,17 @@
 {
-  "name": "npmg",
-  "version": "1.0.5",
-  "description": "setup your environment with the most important tools and update them easily.",
-  "main": "dist/index.js",
-  "typings": "dist/index.d.ts",
+  "name": "@git.zone/tools",
+  "version": "3.1.1",
+  "private": false,
+  "type": "module",
+  "description": "A CLI tool placeholder for development utilities.",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
   "scripts": {
-    "test": "(npmts)"
+    "test": "(tstest test/ --web)",
+    "build": "(tsbuild --web)"
   },
   "bin": {
-    "npmg": "dist/cli.js"
+    "gtools": "cli.js"
   },
   "repository": {
     "type": "git",
@@ -27,14 +30,28 @@
   },
   "homepage": "https://github.com/GitZoneTools/npmg#readme",
   "devDependencies": {
-    "tapbundle": "^1.0.13"
+    "@git.zone/tsbuild": "^4.1.2",
+    "@git.zone/tstest": "^3.1.8"
   },
   "dependencies": {
-    "beautylog": "^6.1.10",
-    "smartcli": "^2.0.7",
-    "smartenv": "^3.0.0",
-    "smartfile": "4.2.17",
-    "smartshell": "^1.0.6",
-    "typings-global": "^1.0.16"
-  }
+    "@git.zone/tsrun": "^2.0.1",
+    "@push.rocks/smartcli": "^4.0.20",
+    "@push.rocks/smartinteract": "^2.0.16",
+    "@push.rocks/smartshell": "^3.3.0",
+    "@types/node": "^22.0.0"
+  },
+  "files": [
+    "ts/**/*",
+    "ts_web/**/*",
+    "dist/**/*",
+    "dist_*/**/*",
+    "dist_ts/**/*",
+    "dist_ts_web/**/*",
+    "cli.js",
+    "npmextra.json",
+    "readme.md"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ]
 }

package_library.json

@@ -1,11 +0,0 @@
-{
-  "default":[
-    "npm-check-updates",
-    "npmdocker",
-    "npmts",
-    "gitzone",
-    "browser-sync",
-    "typescript",
-    "tslint"
-  ]
-}

readme.md

@@ -0,0 +1,42 @@
+# @git.zone/tools 🛠️
+
+A CLI tool placeholder for development utilities.
+
+## Issue Reporting and Security
+
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
+
+## Installation 📦
+
+```bash
+npm install -g @git.zone/tools
+```
+
+## Usage 🚀
+
+```bash
+gtools
+```
+
+Currently a placeholder CLI with no commands implemented yet.
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

test/test.node.ts

@@ -0,0 +1,9 @@
+import { expect, tap } from '@git.zone/tstest/tapbundle';
+
+import * as tools from '../ts/index.js';
+
+tap.test('should export runCli function', async () => {
+  expect(typeof tools.runCli).toEqual('function');
+});
+
+export default tap.start();

test/test.ts

@@ -1,12 +0,0 @@
-import { expect, tap } from 'tapbundle'
-
-import * as npmgInstall from '../dist/npmg.install'
-import * as smartenv from 'smartenv'
-
-let environment = new smartenv.Smartenv()
-
-tap.test("should install default list globally when parsed 'default' as argument", async () => {
-  await npmgInstall.install('default')
-})
-
-tap.start()

ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@git.zone/tools',
+  version: '3.1.1',
+  description: 'A CLI tool placeholder for development utilities.'
+}

ts/index.ts

@@ -1,3 +1,7 @@
-import plugins = require("./npmg.plugins");
-import * as cli from './npmg.cli'
-cli.run()
+import * as cli from './tools.cli.js';
+
+export const runCli = async () => {
+  await cli.run();
+};
+
+runCli();

ts/mod_update/classes.packagemanager.ts

@@ -0,0 +1,193 @@
+import * as plugins from './mod.plugins.js';
+
+export type TPackageManager = 'npm' | 'yarn' | 'pnpm';
+
+export interface IInstalledPackage {
+  name: string;
+  version: string;
+  packageManager: TPackageManager;
+}
+
+export interface IPackageUpdateInfo {
+  name: string;
+  currentVersion: string;
+  latestVersion: string;
+  packageManager: TPackageManager;
+  needsUpdate: boolean;
+}
+
+export class PackageManagerUtil {
+  private shell = new plugins.smartshell.Smartshell({
+    executor: 'bash',
+  });
+
+  /**
+   * Check if a package manager is available on the system
+   */
+  public async isAvailable(pm: TPackageManager): Promise<boolean> {
+    try {
+      const result = await this.shell.execSilent(`which ${pm} >/dev/null 2>&1 && echo "found"`);
+      return result.exitCode === 0 && result.stdout.includes('found');
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Get all globally installed @git.zone packages for a package manager
+   */
+  public async getInstalledPackages(pm: TPackageManager): Promise<IInstalledPackage[]> {
+    const packages: IInstalledPackage[] = [];
+
+    try {
+      let result;
+      switch (pm) {
+        case 'npm':
+          result = await this.shell.execSilent('npm list -g --depth=0 --json 2>/dev/null || true');
+          break;
+        case 'yarn':
+          result = await this.shell.execSilent('yarn global list --depth=0 --json 2>/dev/null || true');
+          break;
+        case 'pnpm':
+          result = await this.shell.execSilent('pnpm list -g --depth=0 --json 2>/dev/null || true');
+          break;
+      }
+
+      const output = result.stdout.trim();
+      if (!output) {
+        return packages;
+      }
+
+      if (pm === 'npm') {
+        try {
+          const data = JSON.parse(output);
+          const deps = data.dependencies || {};
+          for (const [name, info] of Object.entries(deps)) {
+            if (name.startsWith('@git.zone/')) {
+              packages.push({
+                name,
+                version: (info as any).version || 'unknown',
+                packageManager: pm,
+              });
+            }
+          }
+        } catch {
+          // JSON parse failed
+        }
+      } else if (pm === 'pnpm') {
+        // pnpm returns an array of objects
+        try {
+          const data = JSON.parse(output);
+          // Handle array format from pnpm
+          const dataArray = Array.isArray(data) ? data : [data];
+          for (const item of dataArray) {
+            const deps = item.dependencies || {};
+            for (const [name, info] of Object.entries(deps)) {
+              if (name.startsWith('@git.zone/')) {
+                packages.push({
+                  name,
+                  version: (info as any).version || 'unknown',
+                  packageManager: pm,
+                });
+              }
+            }
+          }
+        } catch {
+          // JSON parse failed
+        }
+      } else if (pm === 'yarn') {
+        // Yarn global list --json outputs multiple JSON lines
+        const lines = output.split('\n').filter(l => l.trim());
+        for (const line of lines) {
+          try {
+            const data = JSON.parse(line);
+            if (data.type === 'tree' && data.data && data.data.trees) {
+              for (const tree of data.data.trees) {
+                const name = tree.name?.split('@')[0] || '';
+                if (name.startsWith('@git.zone/')) {
+                  const version = tree.name?.split('@').pop() || 'unknown';
+                  packages.push({
+                    name,
+                    version,
+                    packageManager: pm,
+                  });
+                }
+              }
+            }
+          } catch {
+            // Skip invalid JSON lines
+          }
+        }
+      }
+    } catch {
+      // Command failed, return empty array
+    }
+
+    return packages;
+  }
+
+  /**
+   * Get the latest version of a package from npm registry
+   */
+  public async getLatestVersion(packageName: string): Promise<string | null> {
+    try {
+      const result = await this.shell.execSilent(`npm view ${packageName} version 2>/dev/null`);
+      if (result.exitCode === 0 && result.stdout.trim()) {
+        return result.stdout.trim();
+      }
+    } catch {
+      // Command failed
+    }
+    return null;
+  }
+
+  /**
+   * Execute an update for a package using the specified package manager
+   */
+  public async executeUpdate(pm: TPackageManager, packageName: string): Promise<boolean> {
+    let command: string;
+
+    switch (pm) {
+      case 'npm':
+        command = `npm install -g ${packageName}@latest`;
+        break;
+      case 'yarn':
+        command = `yarn global add ${packageName}@latest`;
+        break;
+      case 'pnpm':
+        command = `pnpm add -g ${packageName}@latest`;
+        break;
+    }
+
+    console.log(`  Updating ${packageName} via ${pm}...`);
+
+    try {
+      const result = await this.shell.exec(command);
+      return result.exitCode === 0;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Compare two semver versions
+   * Returns true if latest > current
+   */
+  public isNewerVersion(current: string, latest: string): boolean {
+    const cleanVersion = (v: string) => v.replace(/^[^\d]*/, '');
+    const currentClean = cleanVersion(current);
+    const latestClean = cleanVersion(latest);
+
+    const currentParts = currentClean.split('.').map(n => parseInt(n, 10) || 0);
+    const latestParts = latestClean.split('.').map(n => parseInt(n, 10) || 0);
+
+    for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+      const curr = currentParts[i] || 0;
+      const lat = latestParts[i] || 0;
+      if (lat > curr) return true;
+      if (lat < curr) return false;
+    }
+
+    return false;
+  }
+}

ts/mod_update/index.ts

@@ -0,0 +1,135 @@
+import * as plugins from './mod.plugins.js';
+import { PackageManagerUtil, type TPackageManager, type IPackageUpdateInfo } from './classes.packagemanager.js';
+
+const GITZONE_PACKAGES = [
+  '@git.zone/cli',
+  '@git.zone/tsdoc',
+  '@git.zone/tsbuild',
+  '@git.zone/tstest',
+  '@git.zone/tspublish',
+  '@git.zone/tsbundle',
+  '@git.zone/tsdocker',
+  '@git.zone/tsview',
+  '@git.zone/tswatch',
+];
+
+export interface IUpdateOptions {
+  yes?: boolean;
+}
+
+export const run = async (options: IUpdateOptions = {}): Promise<void> => {
+  const pmUtil = new PackageManagerUtil();
+
+  console.log('Scanning for installed @git.zone packages...\n');
+
+  // Check which package managers are available
+  const availablePMs: TPackageManager[] = [];
+  for (const pm of ['npm', 'yarn', 'pnpm'] as TPackageManager[]) {
+    if (await pmUtil.isAvailable(pm)) {
+      availablePMs.push(pm);
+    }
+  }
+
+  if (availablePMs.length === 0) {
+    console.log('No package managers found (npm, yarn, pnpm).');
+    return;
+  }
+
+  console.log(`Found package managers: ${availablePMs.join(', ')}\n`);
+
+  // Collect all installed @git.zone packages from all package managers
+  const allPackages: IPackageUpdateInfo[] = [];
+
+  for (const pm of availablePMs) {
+    const installed = await pmUtil.getInstalledPackages(pm);
+    for (const pkg of installed) {
+      // Only include packages from our predefined list
+      if (GITZONE_PACKAGES.includes(pkg.name)) {
+        const latestVersion = await pmUtil.getLatestVersion(pkg.name);
+        if (latestVersion) {
+          allPackages.push({
+            name: pkg.name,
+            currentVersion: pkg.version,
+            latestVersion,
+            packageManager: pm,
+            needsUpdate: pmUtil.isNewerVersion(pkg.version, latestVersion),
+          });
+        }
+      }
+    }
+  }
+
+  if (allPackages.length === 0) {
+    console.log('No @git.zone packages found installed globally.');
+    return;
+  }
+
+  // Display package table
+  console.log('Installed @git.zone packages:\n');
+  console.log('  Package                      Current     Latest      PM      Status');
+  console.log('  ─────────────────────────────────────────────────────────────────────');
+
+  for (const pkg of allPackages) {
+    const name = pkg.name.padEnd(28);
+    const current = pkg.currentVersion.padEnd(12);
+    const latest = pkg.latestVersion.padEnd(12);
+    const pm = pkg.packageManager.padEnd(8);
+    const status = pkg.needsUpdate ? '⬆️  Update available' : '✓ Up to date';
+    console.log(`  ${name}${current}${latest}${pm}${status}`);
+  }
+
+  console.log('');
+
+  // Filter packages that need updates
+  const packagesToUpdate = allPackages.filter(p => p.needsUpdate);
+
+  if (packagesToUpdate.length === 0) {
+    console.log('All packages are up to date!');
+    return;
+  }
+
+  console.log(`Found ${packagesToUpdate.length} package(s) with available updates.\n`);
+
+  // Ask for confirmation unless -y flag is provided
+  let shouldUpdate = options.yes === true;
+
+  if (!shouldUpdate) {
+    const smartinteractInstance = new plugins.smartinteract.SmartInteract();
+    const answer = await smartinteractInstance.askQuestion({
+      type: 'confirm',
+      name: 'confirmUpdate',
+      message: 'Do you want to update these packages?',
+      default: true,
+    });
+    shouldUpdate = answer.value === true;
+  }
+
+  if (!shouldUpdate) {
+    console.log('Update cancelled.');
+    return;
+  }
+
+  // Execute updates
+  console.log('\nUpdating packages...\n');
+
+  let successCount = 0;
+  let failCount = 0;
+
+  for (const pkg of packagesToUpdate) {
+    const success = await pmUtil.executeUpdate(pkg.packageManager, pkg.name);
+    if (success) {
+      console.log(`  ✓ ${pkg.name} updated successfully`);
+      successCount++;
+    } else {
+      console.log(`  ✗ ${pkg.name} update failed`);
+      failCount++;
+    }
+  }
+
+  console.log('');
+  if (failCount === 0) {
+    console.log(`All ${successCount} package(s) updated successfully!`);
+  } else {
+    console.log(`Updated ${successCount} package(s), ${failCount} failed.`);
+  }
+};

ts/mod_update/mod.plugins.ts

@@ -0,0 +1,4 @@
+import * as smartinteract from '@push.rocks/smartinteract';
+import * as smartshell from '@push.rocks/smartshell';
+
+export { smartinteract, smartshell };

ts/npmg.cli.ts

@@ -1,10 +0,0 @@
-import * as plugins from './npmg.plugins'
-import * as install from './npmg.install'
-
-let npmgSmartcli = new plugins.smartcli.Smartcli()
-
-export let run = async () => {
-  npmgSmartcli.addCommand('install').then(async (argvArg) => {
-
-  })
-}

ts/npmg.install.ts

@@ -1,30 +0,0 @@
-import plugins = require('./npmg.plugins');
-import paths = require('./npmg.paths');
-
-let installExec = async (packageNames: string[]) => {
-  let installString = ''
-  for (let packageName of packageNames) {
-    installString = installString + `${packageName} `
-  }
-  await plugins.smartshell.exec(`yarn global remove ${installString}`)
-  for (let packageName of packageNames) {
-    plugins.beautylog.info(`now preparing ${packageName}`)
-    await plugins.smartshell.exec(`yarn global remove ${packageName}`)
-  }
-  await plugins.smartshell.exec(`yarn global add ${installString}`)
-}
-
-let packageLibrary = plugins.smartfile.fs.toObjectSync(
-  plugins.path.join(paths.packageBase, 'package_library.json')
-);
-
-export let install = async (packageSetArg: String) => {
-  switch (packageSetArg) {
-    case 'default':
-      await installExec(packageLibrary.default)
-      break
-    default:
-      plugins.beautylog.warn('no set has been specified');
-      break
-  }
-}

ts/npmg.paths.ts

@@ -1,3 +0,0 @@
-import plugins = require('./npmg.plugins');
-
-export let packageBase = plugins.path.join('__dirname', '../')

ts/npmg.plugins.ts

@@ -1,14 +0,0 @@
-import 'typings-global'
-import * as beautylog from 'beautylog'
-import * as path from 'path'
-import * as smartcli from 'smartcli'
-import * as smartfile from 'smartfile'
-import * as smartshell from 'smartshell'
-
-export {
-  beautylog,
-  path,
-  smartcli,
-  smartfile,
-  smartshell
-}

ts/tools.cli.ts

@@ -0,0 +1,23 @@
+import * as plugins from './tools.plugins.js';
+import * as modUpdate from './mod_update/index.js';
+
+export const run = async () => {
+  const toolsCli = new plugins.smartcli.Smartcli();
+
+  toolsCli.standardCommand().subscribe(async (argvArg) => {
+    console.log('@git.zone/tools - CLI utility for managing @git.zone packages\n');
+    console.log('Commands:');
+    console.log('  update       Check and update globally installed @git.zone packages');
+    console.log('  update -y    Update without confirmation prompt');
+    console.log('');
+    console.log('Use "gtools <command> --help" for more information about a command.');
+  });
+
+  toolsCli.addCommand('update').subscribe(async (argvArg) => {
+    const yesFlag = argvArg.y === true || argvArg.yes === true;
+    await modUpdate.run({ yes: yesFlag });
+  });
+
+  toolsCli.addVersion('3.0.0');
+  toolsCli.startParse();
+};

ts/tools.plugins.ts

@@ -0,0 +1,6 @@
+// push.rocks scope
+import * as smartcli from '@push.rocks/smartcli';
+import * as smartinteract from '@push.rocks/smartinteract';
+import * as smartshell from '@push.rocks/smartshell';
+
+export { smartcli, smartinteract, smartshell };

tslint.json

@@ -1,3 +0,0 @@
-{
-    "extends": "tslint-config-standard"
-}