v2.2.6

.gitea/workflows/default_nottags.yaml

@@ -7,7 +7,7 @@ on:
 
 env:
   IMAGE: code.foss.global/host.today/ht-docker-node:npmci
-  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@/${{gitea.repository}}.git
+  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitlab.com/${{gitea.repository}}.git
   NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
   NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
   NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}

.gitea/workflows/default_tags.yaml

@@ -7,7 +7,7 @@ on:
 
 env:
   IMAGE: code.foss.global/host.today/ht-docker-node:npmci
-  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@/${{gitea.repository}}.git
+  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitlab.com/${{gitea.repository}}.git
   NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
   NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
   NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}

.gitignore

@@ -16,6 +16,10 @@ node_modules/
 dist/
 dist_*/
 
+# rust
+rust/target/
+dist_rust/
+
 # AI
 .claude/
 .serena/

.vscode/settings.json

@@ -1,7 +1,7 @@
 {
   "json.schemas": [
     {
-      "fileMatch": ["/npmextra.json"],
+      "fileMatch": ["/smartconfig.json"],
       "schema": {
         "type": "object",
         "properties": {

changelog.md

@@ -1,6 +1,56 @@
 # Changelog
 
+## 2026-05-08 - 2.2.6 - fix(tsdockermanager)
+update project info loading to use the async ProjectInfo factory
+
+- bump @push.rocks/projectinfo from ^5.0.2 to ^5.1.0
+- replace direct ProjectInfo construction with await ProjectInfo.create(paths.cwd) during manager preparation
+
+## 2026-04-30 - 2.2.5 - fix(scripts)
+use pnpm for the test script build command
+
+- updates the test script in package.json to run the build through pnpm instead of npm
+
+## 2026-03-24 - 2.2.4 - fix(config)
+migrate configuration loading to smartconfig and update build tooling compatibility
+
+- switch configuration loading and documentation to .smartconfig.json
+- upgrade build and test dependencies for tsbuild 4.4.0 and TypeScript 6 compatibility
+- remove deprecated tsconfig baseUrl and paths settings and add an lru-cache override to avoid type issues
+
+## 2026-03-24 - 2.2.3 - fix(config)
+update workflow repository URL handling and package config file references
+
+- Switches Gitea workflow repository URLs to use gitlab.com explicitly for authenticated CI git operations.
+- Replaces the published config file entry from npmextra.json to .smartconfig.json in package metadata.
+- Adds Rust build output directories to .gitignore.
+- Refreshes changelog and README formatting to match the current smartconfig-based configuration.
+
+## 2026-03-24 - 2.2.2 - fix(config)
+
+rename npmextra configuration file to .smartconfig.json
+
+- Moves the existing project metadata and release configuration from npmextra.json to .smartconfig.json without changing its contents.
+
+## 2026-03-24 - 2.2.1 - fix(config)
+
+switch configuration loading from npmextra to smartconfig
+
+- replace the @push.rocks/npmextra dependency with @push.rocks/smartconfig
+- update config initialization to use Smartconfig for the @git.zone/tsdocker settings
+- refresh CLI help text to reference smartconfig.json instead of npmextra.json
+
+## 2026-03-19 - 2.2.0 - feat(cli/buildx)
+
+add pull control for builds and isolate buildx builders per project
+
+- adds a new pull build option with --no-pull CLI support and defaults builds to refreshing base images with --pull
+- passes the selected buildx builder explicitly into build commands instead of relying on global docker buildx use state
+- generates project-hashed builder suffixes so concurrent runs from different project directories do not share the same local builder
+- updates session logging to include project hash and builder suffix for easier build diagnostics
+
 ## 2026-03-15 - 2.1.0 - feat(cli)
+
 add global remote builder configuration and native SSH buildx nodes for multi-platform builds
 
 - adds a new `tsdocker config` command with subcommands to add, remove, list, and show remote builder definitions
@@ -9,14 +59,15 @@ add global remote builder configuration and native SSH buildx nodes for multi-pl
 - updates the README and CLI help to document remote builder configuration and native cross-platform build workflows
 
 ## 2026-03-12 - 2.0.2 - fix(repo)
-no changes to commit
 
+no changes to commit
 
 ## 2026-03-12 - 2.0.1 - fix(repository)
+
 no changes to commit
 
-
 ## 2026-03-12 - 2.0.0 - BREAKING CHANGE(cli)
+
 remove legacy container test runner and make the default command show the man page
 
 - Removes legacy testing and VS Code commands, including `runinside`, `vscode`, generated Dockerfile assets, and related configuration fields (`baseImage`, `command`, `dockerSock`, `keyValueObject`)
@@ -24,10 +75,11 @@ remove legacy container test runner and make the default command show the man pa
 - Updates CLI and documentation to reflect default help output and the current build/push-focused workflow
 
 ## 2026-02-07 - 1.17.4 - fix()
+
 no changes
 
-
 ## 2026-02-07 - 1.17.3 - fix(registry)
+
 increase default maxRetries in fetchWithRetry from 3 to 6 to improve resilience when fetching registry resources
 
 - Changed default maxRetries from 3 to 6 in ts/classes.registrycopy.ts
@@ -35,6 +87,7 @@ increase default maxRetries in fetchWithRetry from 3 to 6 to improve resilience
 - No API or behavior changes besides the increased default retry count
 
 ## 2026-02-07 - 1.17.2 - fix(registry)
+
 improve HTTP fetch retry logging, backoff calculation, and token-cache warning
 
 - Include HTTP method in logs and normalize method to uppercase for consistency
@@ -44,6 +97,7 @@ improve HTTP fetch retry logging, backoff calculation, and token-cache warning
 - Add a warning log when clearing cached token after a 401 response
 
 ## 2026-02-07 - 1.17.1 - fix(registrycopy)
+
 add fetchWithRetry wrapper to apply timeouts, retries with exponential backoff, and token cache handling; use it for registry HTTP requests
 
 - Introduces fetchWithRetry(url, options, timeoutMs, maxRetries) to wrap fetch with AbortSignal timeout, exponential backoff retries, and retry behavior only for network errors and 5xx responses
@@ -52,6 +106,7 @@ add fetchWithRetry wrapper to apply timeouts, retries with exponential backoff,
 - Adds logging on retry attempts and backoff delays to improve robustness and observability
 
 ## 2026-02-07 - 1.17.0 - feat(tsdocker)
+
 add Dockerfile filtering, optional skip-build flow, and fallback Docker config credential loading
 
 - Add TsDockerManager.filterDockerfiles(patterns) to filter discovered Dockerfiles by glob-style patterns and warn when no matches are found
@@ -60,6 +115,7 @@ add Dockerfile filtering, optional skip-build flow, and fallback Docker config c
 - Import RegistryCopy and add info/warn logs when credentials are loaded or missing
 
 ## 2026-02-07 - 1.16.0 - feat(core)
+
 Introduce per-invocation TsDockerSession and session-aware local registry and build orchestration; stream and parse buildx output for improved logging and visibility; detect Docker topology and add CI-safe cleanup; update README with multi-arch, parallel-build, caching, and local registry usage and new CLI flags.
 
 - Add TsDockerSession to allocate unique ports, container names and builder suffixes for concurrent runs (especially in CI).
@@ -72,6 +128,7 @@ Introduce per-invocation TsDockerSession and session-aware local registry and bu
 - Large README improvements: multi-arch flow, persistent local registry, parallel builds, caching, new CLI and clean flags, and examples for CI integration.
 
 ## 2026-02-07 - 1.15.1 - fix(registry)
+
 use persistent local registry and OCI Distribution API image copy for pushes
 
 - Adds RegistryCopy class implementing the OCI Distribution API to copy images (including multi-arch manifest lists) from the local registry to remote registries.
@@ -83,6 +140,7 @@ use persistent local registry and OCI Distribution API image copy for pushes
 - Breaking change: registry usage and push behavior changed (config.push ignored and local registry mandatory) — bump major version.
 
 ## 2026-02-07 - 1.15.0 - feat(clean)
+
 Make the `clean` command interactive: add smartinteract prompts, docker context detection, and selective resource removal with support for --all and -y auto-confirm
 
 - Adds dependency @push.rocks/smartinteract and exposes it from the plugins module
@@ -92,6 +150,7 @@ Make the `clean` command interactive: add smartinteract prompts, docker context
 - Replaces blunt shell commands with safer, interactive selection and adds improved error handling and logging
 
 ## 2026-02-07 - 1.14.0 - feat(build)
+
 add level-based parallel builds with --parallel and configurable concurrency
 
 - Introduces --parallel and --parallel=<n> CLI flags to enable level-based parallel Docker builds (default concurrency 4).
@@ -102,6 +161,7 @@ add level-based parallel builds with --parallel and configurable concurrency
 - Updates documentation (readme.hints.md) with usage examples and implementation notes.
 
 ## 2026-02-07 - 1.13.0 - feat(docker)
+
 add Docker context detection, rootless support, and context-aware buildx registry handling
 
 - Introduce DockerContext class to detect current Docker context and rootless mode and to log warnings and context info
@@ -111,6 +171,7 @@ add Docker context detection, rootless support, and context-aware buildx registr
 - Pass isRootless into local registry startup and build pipeline; emit rootless-specific warnings and registry reachability hint
 
 ## 2026-02-06 - 1.12.0 - feat(docker)
+
 add detailed logging for buildx, build commands, local registry, and local dependency info
 
 - Log startup of local registry including a note about buildx dependency bridging
@@ -120,6 +181,7 @@ add detailed logging for buildx, build commands, local registry, and local depen
 - Non-functional change: purely adds informational logging to improve observability during builds
 
 ## 2026-02-06 - 1.11.0 - feat(docker)
+
 start temporary local registry for buildx dependency resolution and ensure buildx builder uses host network
 
 - Introduce a temporary local registry (localhost:5234) with start/stop helpers and push support to expose local images for buildx
@@ -130,6 +192,7 @@ start temporary local registry for buildx dependency resolution and ensure build
 - Ensure buildx builder is created with --driver-opt network=host and recreate existing builder if it lacks host network to allow registry access from build containers
 
 ## 2026-02-06 - 1.10.0 - feat(classes.dockerfile)
+
 support using a local base image as a build context in buildx commands
 
 - Adds --build-context flag mapping base image to docker-image://<localTag> when localBaseImageDependent && localBaseDockerfile are set
@@ -137,6 +200,7 @@ support using a local base image as a build context in buildx commands
 - Logs an info message indicating the local build context mapping
 
 ## 2026-02-06 - 1.9.0 - feat(build)
+
 add verbose build output, progress logging, and timing for builds/tests
 
 - Add 'verbose' option to build/test flows (interfaces, CLI, and method signatures) to allow streaming raw docker build output or run silently
@@ -147,6 +211,7 @@ add verbose build output, progress logging, and timing for builds/tests
 - Use silent exec variants when verbose is false and stream exec when verbose is true
 
 ## 2026-02-06 - 1.8.0 - feat(build)
+
 add optional content-hash based build cache to skip rebuilding unchanged Dockerfiles
 
 - Introduce TsDockerCache to compute SHA-256 of Dockerfile content and persist cache to .nogit/tsdocker_support.json
@@ -156,12 +221,14 @@ add optional content-hash based build cache to skip rebuilding unchanged Dockerf
 - Cache records store contentHash, imageId, buildTag and timestamp
 
 ## 2026-02-06 - 1.7.0 - feat(cli)
+
 add CLI version display using commitinfo
 
 - Imported commitinfo from './00_commitinfo_data.js' and called tsdockerCli.addVersion(commitinfo.version) to surface package/commit version in the Smartcli instance
 - Change made in ts/tsdocker.cli.ts — small user-facing CLI enhancement; no breaking changes
 
 ## 2026-02-06 - 1.6.0 - feat(docker)
+
 add support for no-cache builds and tag built images for local dependency resolution
 
 - Introduce IBuildCommandOptions.noCache to control --no-cache behavior
@@ -171,6 +238,7 @@ add support for no-cache builds and tag built images for local dependency resolu
 - Log tagging actions and execute docker tag via smartshellInstance
 
 ## 2026-02-06 - 1.5.0 - feat(build)
+
 add support for selective builds, platform override and build timeout
 
 - Introduce IBuildCommandOptions with patterns, platform and timeout to control build behavior
@@ -180,6 +248,7 @@ add support for selective builds, platform override and build timeout
 - Implement streaming exec with timeout to kill long-running builds and surface timeout errors
 
 ## 2026-02-04 - 1.4.3 - fix(dockerfile)
+
 fix matching of base images to local Dockerfiles by stripping registry prefixes when comparing image references
 
 - Added Dockerfile.extractRepoVersion(imageRef) to normalize image references by removing registry prefixes (detects registries containing '.' or ':' or 'localhost').
@@ -187,13 +256,15 @@ fix matching of base images to local Dockerfiles by stripping registry prefixes
 - Prevents mismatches when baseImage includes a registry (e.g. "host.today/repo:version") so it correctly matches a local cleanTag like "repo:version".
 
 ## 2026-01-21 - 1.4.2 - fix(classes.dockerfile)
+
 use a single top-level fs import instead of requiring fs inside methods
 
-- Added top-level import: import * as fs from 'fs' in ts/classes.dockerfile.ts
+- Added top-level import: import \* as fs from 'fs' in ts/classes.dockerfile.ts
 - Removed inline require('fs') calls and replaced with the imported fs in constructor and test() to keep imports consistent
 - No behavioral change expected; this is a cleanup/refactor to standardize module usage
 
 ## 2026-01-20 - 1.4.1 - fix(docs)
+
 update README: expand usage, installation, quick start, features, troubleshooting and migration notes
 
 - Expanded README content: new Quick Start, Installation examples, and detailed Features section (containerized testing, smart Docker builds, multi-registry push, multi-architecture support, zero-config start)
@@ -202,6 +273,7 @@ update README: expand usage, installation, quick start, features, troubleshootin
 - Documentation-only change — no source code modified
 
 ## 2026-01-20 - 1.4.0 - feat(tsdocker)
+
 add multi-registry and multi-arch Docker build/push/pull manager, registry storage, Dockerfile handling, and new CLI commands
 
 - Introduce TsDockerManager orchestrator to discover, sort, build, test, push and pull Dockerfiles
@@ -214,6 +286,7 @@ add multi-registry and multi-arch Docker build/push/pull manager, registry stora
 - Update README and readme.hints with new features, configuration examples and command list
 
 ## 2026-01-19 - 1.3.0 - feat(packaging)
+
 Rename package scope to @git.zone and migrate to ESM; rename CLI/config keys, update entrypoints and imports, bump Node requirement to 18, and adjust scripts/dependencies
 
 - Package renamed to @git.zone/tsdocker (scope change) — consumers must update package reference.

package.json

@@ -1,15 +1,15 @@
 {
   "name": "@git.zone/tsdocker",
-  "version": "2.1.0",
+  "version": "2.2.6",
   "private": false,
-  "description": "develop npm modules cross platform with docker",
+  "description": "A comprehensive Docker build tool for TypeScript projects with multi-arch support, multi-registry push, and CI-safe session isolation.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
   "bin": {
     "tsdocker": "cli.js"
   },
   "scripts": {
-    "test": "(npm run build)",
+    "test": "(pnpm run build)",
     "build": "(tsbuild)",
     "buildDocs": "tsdoc"
   },
@@ -18,7 +18,16 @@
     "url": "https://gitlab.com/gitzone/tsdocker.git"
   },
   "keywords": [
-    "docker"
+    "docker",
+    "typescript",
+    "buildx",
+    "multi-arch",
+    "multi-registry",
+    "oci",
+    "container",
+    "ci-cd",
+    "docker-build",
+    "cross-platform"
   ],
   "author": "Lossless GmbH",
   "license": "MIT",
@@ -27,22 +36,22 @@
   },
   "homepage": "https://gitlab.com/gitzone/tsdocker#readme",
   "devDependencies": {
-    "@git.zone/tsbuild": "^4.3.0",
+    "@git.zone/tsbuild": "^4.4.0",
     "@git.zone/tsrun": "^2.0.1",
-    "@git.zone/tstest": "^3.3.2",
+    "@git.zone/tstest": "^3.5.1",
     "@types/node": "^25.5.0"
   },
   "dependencies": {
-    "@push.rocks/lik": "^6.3.1",
-    "@push.rocks/npmextra": "^5.3.3",
-    "@push.rocks/projectinfo": "^5.0.2",
+    "@push.rocks/lik": "^6.4.0",
+    "@push.rocks/projectinfo": "^5.1.0",
     "@push.rocks/smartcli": "^4.0.20",
+    "@push.rocks/smartconfig": "^6.0.1",
     "@push.rocks/smartfs": "^1.5.0",
     "@push.rocks/smartinteract": "^2.0.16",
     "@push.rocks/smartlog": "^3.2.1",
     "@push.rocks/smartlog-destination-local": "^9.0.2",
     "@push.rocks/smartlog-source-ora": "^1.0.9",
-    "@push.rocks/smartshell": "^3.3.7"
+    "@push.rocks/smartshell": "^3.3.8"
   },
   "packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34",
   "type": "module",
@@ -55,10 +64,12 @@
     "dist_ts_web/**/*",
     "assets/**/*",
     "cli.js",
-    "npmextra.json",
+    ".smartconfig.json",
     "readme.md"
   ],
   "pnpm": {
-    "overrides": {}
+    "overrides": {
+      "lru-cache": ">=11.0.0"
+    }
   }
 }

readme.hints.md

@@ -3,6 +3,7 @@
 ## Module Purpose
 
 tsdocker is a comprehensive Docker development and building tool. It provides:
+
 - Building Dockerfiles with dependency ordering
 - Multi-registry push/pull support
 - Multi-architecture builds (amd64/arm64)
@@ -10,7 +11,7 @@ tsdocker is a comprehensive Docker development and building tool. It provides:
 ## New CLI Commands (2026-01-19)
 
 | Command                    | Description                                    |
-|---------|-------------|
+| -------------------------- | ---------------------------------------------- |
 | `tsdocker`                 | Show usage / man page                          |
 | `tsdocker build`           | Build all Dockerfiles with dependency ordering |
 | `tsdocker push [registry]` | Push images to configured registries           |
@@ -22,7 +23,7 @@ tsdocker is a comprehensive Docker development and building tool. It provides:
 
 ## Configuration
 
-Configure in `package.json` under `@git.zone/tsdocker`:
+Configure in `.smartconfig.json` under `@git.zone/tsdocker`:
 
 ```json
 {
@@ -106,6 +107,7 @@ Implementation: `Dockerfile.computeLevels()` groups topologically sorted Dockerf
 All builds now go through a persistent local registry (`localhost:5234`) with volume storage at `.nogit/docker-registry/`. Pushes use the `RegistryCopy` class (`ts/classes.registrycopy.ts`) which implements the OCI Distribution API to copy images (including multi-arch manifest lists) from the local registry to remote registries. This replaces the old `docker tag + docker push` approach that only worked for single-platform images.
 
 Key classes:
+
 - `RegistryCopy` — HTTP-based OCI image copy (auth, blob transfer, manifest handling)
 - `Dockerfile.push()` — Now delegates to `RegistryCopy.copyImage()`
 - `Dockerfile.needsLocalRegistry()` — Always returns true
@@ -115,10 +117,16 @@ The `config.push` field is now a no-op (kept for backward compat).
 
 ## Build Status
 
-- Build: ✅ Passes
+- Build: ✅ Passes (TypeScript 6 via tsbuild 4.4.0)
 
-## Previous Upgrades (2025-11-22)
+## Previous Upgrades
 
+### 2026-03-24
+- Upgraded `@git.zone/tsbuild` from 4.3.0 to 4.4.0 (TypeScript 6)
+- Removed deprecated `baseUrl`/`paths` from tsconfig.json
+- Added pnpm override `lru-cache: ">=11.0.0"` to fix TS6 type incompatibility with lru-cache@10.x
+
+### 2025-11-22
 - Updated all @git.zone/_ dependencies to @git.zone/_ scope
 - Updated all @pushrocks/_ dependencies to @push.rocks/_ scope
 - Migrated from smartfile v8 to smartfs v1.1.0

readme.md

@@ -44,6 +44,7 @@ tsdocker build
 ```
 
 tsdocker will:
+
 1. 🔍 Discover all `Dockerfile*` files in your project
 2. 📊 Analyze `FROM` dependencies between them
 3. 🔄 Sort them topologically
@@ -85,7 +86,7 @@ tsdocker push --no-build Dockerfile_api Dockerfile_web
 ## CLI Commands
 
 | Command                    | Description                                                  |
-|---------|-------------|
+| -------------------------- | ------------------------------------------------------------ |
 | `tsdocker`                 | Show usage / man page                                        |
 | `tsdocker build`           | Build all Dockerfiles with dependency ordering               |
 | `tsdocker push`            | Build + push images to configured registries                 |
@@ -99,7 +100,7 @@ tsdocker push --no-build Dockerfile_api Dockerfile_web
 ### Build Flags
 
 | Flag                     | Description                                                                     |
-|------|-------------|
+| ------------------------ | ------------------------------------------------------------------------------- |
 | `<patterns>`             | Positional Dockerfile name patterns (e.g. `Dockerfile_base`, `Dockerfile_app*`) |
 | `--platform=linux/arm64` | Override build platform for a single architecture                               |
 | `--timeout=600`          | Build timeout in seconds                                                        |
@@ -113,7 +114,7 @@ tsdocker push --no-build Dockerfile_api Dockerfile_web
 ### Push Flags
 
 | Flag               | Description                                                         |
-|------|-------------|
+| ------------------ | ------------------------------------------------------------------- |
 | `<patterns>`       | Positional Dockerfile name patterns to select which images to push  |
 | `--registry=<url>` | Push to a single specific registry instead of all configured        |
 | `--no-build`       | Skip the build phase; only push existing images from local registry |
@@ -121,7 +122,7 @@ tsdocker push --no-build Dockerfile_api Dockerfile_web
 ### Config Subcommands
 
 | Subcommand       | Description                         |
-|------------|-------------|
+| ---------------- | ----------------------------------- |
 | `add-builder`    | Add or update a remote builder node |
 | `remove-builder` | Remove a remote builder by name     |
 | `list-builders`  | List all configured remote builders |
@@ -130,7 +131,7 @@ tsdocker push --no-build Dockerfile_api Dockerfile_web
 **`add-builder` flags:**
 
 | Flag               | Description                                               |
-|------|-------------|
+| ------------------ | --------------------------------------------------------- |
 | `--name=<name>`    | Builder name (e.g. `arm64-builder`)                       |
 | `--host=<user@ip>` | SSH host (e.g. `armbuilder@192.168.1.100`)                |
 | `--platform=<p>`   | Target platform (e.g. `linux/arm64`)                      |
@@ -139,13 +140,13 @@ tsdocker push --no-build Dockerfile_api Dockerfile_web
 ### Clean Flags
 
 | Flag    | Description                                        |
-|------|-------------|
+| ------- | -------------------------------------------------- |
 | `--all` | Include all images and volumes (not just dangling) |
 | `-y`    | Auto-confirm all prompts                           |
 
 ## Configuration
 
-Configure tsdocker in your `package.json` or `npmextra.json` under the `@git.zone/tsdocker` key:
+Configure tsdocker in your `.smartconfig.json` under the `@git.zone/tsdocker` key:
 
 ```json
 {
@@ -168,7 +169,7 @@ Configure tsdocker in your `package.json` or `npmextra.json` under the `@git.zon
 #### Build & Push Options
 
 | Option            | Type       | Default           | Description                                    |
-|--------|------|---------|-------------|
+| ----------------- | ---------- | ----------------- | ---------------------------------------------- |
 | `registries`      | `string[]` | `[]`              | Registry URLs to push to                       |
 | `registryRepoMap` | `object`   | `{}`              | Map registries to different repository paths   |
 | `buildArgEnvMap`  | `object`   | `{}`              | Map Docker build ARGs to environment variables |
@@ -218,7 +219,7 @@ tsdocker uses a **local OCI registry** as the canonical store for all built imag
 ### 🔑 Why a Local Registry?
 
 | Problem                                             | Solution                                                            |
-|---------|----------|
+| --------------------------------------------------- | ------------------------------------------------------------------- |
 | `docker buildx --load` fails for multi-arch images  | `buildx --push` to local registry works for any number of platforms |
 | `docker push` only pushes single-platform manifests | OCI API copy preserves full manifest lists (multi-arch)             |
 | Images lost between build and push phases           | Persistent storage at `.nogit/docker-registry/` survives restarts   |
@@ -247,7 +248,7 @@ Every tsdocker invocation gets its own **session** with unique:
 This prevents resource conflicts when multiple CI jobs run tsdocker in parallel. Auto-detected CI systems:
 
 | Environment Variable | CI System      |
-|---------------------|-----------|
+| -------------------- | -------------- |
 | `GITEA_ACTIONS`      | Gitea Actions  |
 | `GITHUB_ACTIONS`     | GitHub Actions |
 | `GITLAB_CI`          | GitLab CI      |
@@ -260,7 +261,7 @@ In local dev, no suffix is added — keeping a persistent builder for faster reb
 tsdocker automatically detects your Docker environment topology:
 
 | Topology       | Detection                          | Meaning                                               |
-|----------|-----------|---------|
+| -------------- | ---------------------------------- | ----------------------------------------------------- |
 | `local`        | Default                            | Standard Docker installation on the host              |
 | `socket-mount` | `/.dockerenv` exists               | Running inside a container with Docker socket mounted |
 | `dind`         | `DOCKER_HOST` starts with `tcp://` | Docker-in-Docker setup                                |
@@ -309,6 +310,7 @@ Build for multiple platforms using Docker Buildx:
 ```
 
 tsdocker automatically:
+
 - Sets up a Buildx builder with `--driver-opt network=host` (so buildx can reach the local registry)
 - Pushes multi-platform images to the local registry via `buildx --push`
 - Copies the full manifest list (including all platform variants) to remote registries on `tsdocker push`
@@ -354,6 +356,7 @@ When remote builders are configured and the project's `platforms` includes a mat
 ```
 
 **Prerequisites for the remote machine:**
+
 - Docker installed and running
 - A user with Docker group access (no sudo needed)
 - SSH key access configured
@@ -380,7 +383,7 @@ tsdocker groups Dockerfiles into **dependency levels** using topological analysi
 tsdocker discovers files matching `Dockerfile*`:
 
 | File Name                | Version Tag                 |
-|-----------|-------------|
+| ------------------------ | --------------------------- |
 | `Dockerfile`             | `latest`                    |
 | `Dockerfile_v1.0.0`      | `v1.0.0`                    |
 | `Dockerfile_alpine`      | `alpine`                    |
@@ -492,6 +495,7 @@ tsdocker list
 ```
 
 Output:
+
 ```
 Discovered Dockerfiles:
 ========================
@@ -556,7 +560,7 @@ build-and-push:
     - npm install -g @git.zone/tsdocker
     - tsdocker push
   variables:
-    DOCKER_REGISTRY_1: "registry.gitlab.com|$CI_REGISTRY_USER|$CI_REGISTRY_PASSWORD"
+    DOCKER_REGISTRY_1: 'registry.gitlab.com|$CI_REGISTRY_USER|$CI_REGISTRY_PASSWORD'
 ```
 
 **GitHub Actions:**
@@ -568,7 +572,7 @@ build-and-push:
     tsdocker login
     tsdocker push
   env:
-    DOCKER_REGISTRY_1: "ghcr.io|${{ github.actor }}|${{ secrets.GITHUB_TOKEN }}"
+    DOCKER_REGISTRY_1: 'ghcr.io|${{ github.actor }}|${{ secrets.GITHUB_TOKEN }}'
 ```
 
 **Gitea Actions:**
@@ -579,7 +583,7 @@ build-and-push:
     npm install -g @git.zone/tsdocker
     tsdocker push
   env:
-    DOCKER_REGISTRY_1: "gitea.example.com|${{ secrets.REGISTRY_USER }}|${{ secrets.REGISTRY_PASSWORD }}"
+    DOCKER_REGISTRY_1: 'gitea.example.com|${{ secrets.REGISTRY_USER }}|${{ secrets.REGISTRY_PASSWORD }}'
 ```
 
 tsdocker auto-detects all three CI systems and enables session isolation automatically — no extra configuration needed.
@@ -608,7 +612,7 @@ await manager.push();
 ### CI & Session Control
 
 | Variable                 | Description                                                                |
-|----------|-------------|
+| ------------------------ | -------------------------------------------------------------------------- |
 | `TSDOCKER_SESSION_ID`    | Override the auto-generated session ID (default: random 8-char hex)        |
 | `TSDOCKER_REGISTRY_PORT` | Override the dynamically allocated local registry port                     |
 | `CI`                     | Generic CI detection (also `GITHUB_ACTIONS`, `GITLAB_CI`, `GITEA_ACTIONS`) |
@@ -616,7 +620,7 @@ await manager.push();
 ### Registry Credentials
 
 | Variable                                         | Description                                    |
-|----------|-------------|
+| ------------------------------------------------ | ---------------------------------------------- |
 | `DOCKER_REGISTRY_1` through `DOCKER_REGISTRY_10` | Pipe-delimited: `registry\|username\|password` |
 | `DOCKER_REGISTRY_URL`                            | Registry URL for single-registry setup         |
 | `DOCKER_REGISTRY_USER`                           | Username for single-registry setup             |

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/tsdocker',
-  version: '2.1.0',
-  description: 'develop npm modules cross platform with docker'
+  version: '2.2.6',
+  description: 'A comprehensive Docker build tool for TypeScript projects with multi-arch support, multi-registry push, and CI-safe session isolation.'
 }

ts/classes.dockerfile.ts

@@ -266,7 +266,7 @@ export class Dockerfile {
   public static async buildDockerfiles(
     sortedArrayArg: Dockerfile[],
     session: TsDockerSession,
-    options?: { platform?: string; timeout?: number; noCache?: boolean; verbose?: boolean; isRootless?: boolean; parallel?: boolean; parallelConcurrency?: number; onRegistryStarted?: () => Promise<void>; onBeforeRegistryStop?: () => Promise<void> },
+    options?: { platform?: string; timeout?: number; noCache?: boolean; pull?: boolean; verbose?: boolean; isRootless?: boolean; parallel?: boolean; parallelConcurrency?: number; onRegistryStarted?: () => Promise<void>; onBeforeRegistryStop?: () => Promise<void> },
   ): Promise<Dockerfile[]> {
     const total = sortedArrayArg.length;
     const overallStart = Date.now();
@@ -668,13 +668,14 @@ export class Dockerfile {
   /**
    * Builds the Dockerfile
    */
-  public async build(options?: { platform?: string; timeout?: number; noCache?: boolean; verbose?: boolean }): Promise<number> {
+  public async build(options?: { platform?: string; timeout?: number; noCache?: boolean; pull?: boolean; verbose?: boolean }): Promise<number> {
     const startTime = Date.now();
     const buildArgsString = await Dockerfile.getDockerBuildArgs(this.managerRef);
     const config = this.managerRef.config;
     const platformOverride = options?.platform;
     const timeout = options?.timeout;
     const noCacheFlag = options?.noCache ? ' --no-cache' : '';
+    const pullFlag = options?.pull !== false ? ' --pull' : '';
     const verbose = options?.verbose ?? false;
 
     let buildContextFlag = '';
@@ -689,23 +690,24 @@ export class Dockerfile {
     }
 
     let buildCommand: string;
+    const builderFlag = this.managerRef.currentBuilderName ? ` --builder ${this.managerRef.currentBuilderName}` : '';
 
     if (platformOverride) {
       // Single platform override via buildx
-      buildCommand = `docker buildx build --progress=plain --platform ${platformOverride}${noCacheFlag}${buildContextFlag} --load -t ${this.buildTag} -f ${this.filePath} ${buildArgsString} .`;
+      buildCommand = `docker buildx build${builderFlag} --progress=plain --platform ${platformOverride}${noCacheFlag}${pullFlag}${buildContextFlag} --load -t ${this.buildTag} -f ${this.filePath} ${buildArgsString} .`;
       logger.log('info', `Build: buildx --platform ${platformOverride} --load`);
     } else if (config.platforms && config.platforms.length > 1) {
       // Multi-platform build using buildx — always push to local registry
       const platformString = config.platforms.join(',');
       const registryHost = this.session?.config.registryHost || 'localhost:5234';
       const localTag = `${registryHost}/${this.buildTag}`;
-      buildCommand = `docker buildx build --progress=plain --platform ${platformString}${noCacheFlag}${buildContextFlag} -t ${localTag} -f ${this.filePath} ${buildArgsString} --push .`;
+      buildCommand = `docker buildx build${builderFlag} --progress=plain --platform ${platformString}${noCacheFlag}${pullFlag}${buildContextFlag} -t ${localTag} -f ${this.filePath} ${buildArgsString} --push .`;
       this.localRegistryTag = localTag;
       logger.log('info', `Build: buildx --platform ${platformString} --push to local registry`);
     } else {
       // Standard build
       const versionLabel = this.managerRef.projectInfo?.npm?.version || 'unknown';
-      buildCommand = `docker build --progress=plain --label="version=${versionLabel}"${noCacheFlag} -t ${this.buildTag} -f ${this.filePath} ${buildArgsString} .`;
+      buildCommand = `docker build --progress=plain --label="version=${versionLabel}"${noCacheFlag}${pullFlag} -t ${this.buildTag} -f ${this.filePath} ${buildArgsString} .`;
       logger.log('info', 'Build: docker build (standard)');
     }
 

ts/classes.tsdockermanager.ts

@@ -25,6 +25,7 @@ export class TsDockerManager {
   public projectInfo: any;
   public dockerContext: DockerContext;
   public session!: TsDockerSession;
+  public currentBuilderName?: string;
   private dockerfiles: Dockerfile[] = [];
   private activeRemoteBuilders: IRemoteBuilder[] = [];
   private sshTunnelManager?: SshTunnelManager;
@@ -49,7 +50,7 @@ export class TsDockerManager {
 
     // Load project info
     try {
-      const projectinfoInstance = new plugins.projectinfo.ProjectInfo(paths.cwd);
+      const projectinfoInstance = await plugins.projectinfo.ProjectInfo.create(paths.cwd);
       this.projectInfo = {
         npm: {
           name: projectinfoInstance.npm.name,
@@ -266,6 +267,7 @@ export class TsDockerManager {
                     platform: options?.platform,
                     timeout: options?.timeout,
                     noCache: options?.noCache,
+                    pull: options?.pull,
                     verbose: options?.verbose,
                   });
                   logger.log('ok', `${progress} Built ${df.cleanTag} in ${formatDuration(elapsed)}`);
@@ -311,6 +313,7 @@ export class TsDockerManager {
                 platform: options?.platform,
                 timeout: options?.timeout,
                 noCache: options?.noCache,
+                pull: options?.pull,
                 verbose: options?.verbose,
               });
               logger.log('ok', `${progress} Built ${dockerfileArg.cleanTag} in ${formatDuration(elapsed)}`);
@@ -349,6 +352,7 @@ export class TsDockerManager {
         platform: options?.platform,
         timeout: options?.timeout,
         noCache: options?.noCache,
+        pull: options?.pull,
         verbose: options?.verbose,
         isRootless: this.dockerContext.contextInfo?.isRootless,
         parallel: options?.parallel,
@@ -401,6 +405,7 @@ export class TsDockerManager {
       await this.ensureBuildxLocal(builderName);
     }
 
+    this.currentBuilderName = builderName;
     logger.log('ok', `Docker buildx ready (builder: ${builderName}, platforms: ${platforms})`);
   }
 
@@ -426,7 +431,7 @@ export class TsDockerManager {
     // Create the local node
     const localPlatformFlag = localPlatforms.length > 0 ? ` --platform ${localPlatforms.join(',')}` : '';
     await smartshellInstance.exec(
-      `docker buildx create --name ${builderName} --driver docker-container --driver-opt network=host${localPlatformFlag} --use`
+      `docker buildx create --name ${builderName} --driver docker-container --driver-opt network=host${localPlatformFlag}`
     );
 
     // Append remote nodes
@@ -441,7 +446,7 @@ export class TsDockerManager {
     }
 
     // Bootstrap all nodes
-    await smartshellInstance.exec('docker buildx inspect --bootstrap');
+    await smartshellInstance.exec(`docker buildx inspect --builder ${builderName} --bootstrap`);
 
     // Store active remote builders for SSH tunnel setup during build
     this.activeRemoteBuilders = remoteBuilders;
@@ -456,20 +461,18 @@ export class TsDockerManager {
     if (inspectResult.exitCode !== 0) {
       logger.log('info', 'Creating new buildx builder with host network...');
       await smartshellInstance.exec(
-        `docker buildx create --name ${builderName} --driver docker-container --driver-opt network=host --use`
+        `docker buildx create --name ${builderName} --driver docker-container --driver-opt network=host`
       );
-      await smartshellInstance.exec('docker buildx inspect --bootstrap');
+      await smartshellInstance.exec(`docker buildx inspect --builder ${builderName} --bootstrap`);
     } else {
       const inspectOutput = inspectResult.stdout || '';
       if (!inspectOutput.includes('network=host')) {
         logger.log('info', 'Recreating buildx builder with host network (migration)...');
         await smartshellInstance.exec(`docker buildx rm ${builderName} 2>/dev/null`);
         await smartshellInstance.exec(
-          `docker buildx create --name ${builderName} --driver docker-container --driver-opt network=host --use`
+          `docker buildx create --name ${builderName} --driver docker-container --driver-opt network=host`
         );
-        await smartshellInstance.exec('docker buildx inspect --bootstrap');
-      } else {
-        await smartshellInstance.exec(`docker buildx use ${builderName}`);
+        await smartshellInstance.exec(`docker buildx inspect --builder ${builderName} --bootstrap`);
       }
     }
     this.activeRemoteBuilders = [];

ts/classes.tsdockersession.ts

@@ -4,6 +4,7 @@ import { logger } from './tsdocker.logging.js';
 
 export interface ISessionConfig {
   sessionId: string;
+  projectHash: string;
   registryPort: number;
   registryHost: string;
   registryContainerName: string;
@@ -17,8 +18,8 @@ export interface ISessionConfig {
  * Generates unique ports, container names, and builder names so that
  * concurrent CI jobs on the same Docker host don't collide.
  *
- * In local (non-CI) dev the builder suffix is empty, preserving the
- * persistent builder behavior.
+ * In local (non-CI) dev the builder suffix contains a project hash so
+ * that concurrent runs in different project directories use separate builders.
  */
 export class TsDockerSession {
   public config: ISessionConfig;
@@ -34,16 +35,18 @@ export class TsDockerSession {
   public static async create(): Promise<TsDockerSession> {
     const sessionId =
       process.env.TSDOCKER_SESSION_ID || crypto.randomBytes(4).toString('hex');
+    const projectHash = crypto.createHash('sha256').update(process.cwd()).digest('hex').substring(0, 8);
 
     const registryPort = await TsDockerSession.allocatePort();
     const registryHost = `localhost:${registryPort}`;
     const registryContainerName = `tsdocker-registry-${sessionId}`;
 
     const { isCI, ciSystem } = TsDockerSession.detectCI();
-    const builderSuffix = isCI ? `-${sessionId}` : '';
+    const builderSuffix = isCI ? `-${projectHash}-${sessionId}` : `-${projectHash}`;
 
     const config: ISessionConfig = {
       sessionId,
+      projectHash,
       registryPort,
       registryHost,
       registryContainerName,
@@ -99,9 +102,10 @@ export class TsDockerSession {
     logger.log('info', '=== TSDOCKER SESSION ===');
     logger.log('info', `Session ID:     ${c.sessionId}`);
     logger.log('info', `Registry:       ${c.registryHost} (container: ${c.registryContainerName})`);
+    logger.log('info', `Project hash:   ${c.projectHash}`);
+    logger.log('info', `Builder suffix: ${c.builderSuffix}`);
     if (c.isCI) {
       logger.log('info', `CI detected:    ${c.ciSystem}`);
-      logger.log('info', `Builder suffix: ${c.builderSuffix}`);
     }
   }
 }

ts/interfaces/index.ts

@@ -69,6 +69,7 @@ export interface IBuildCommandOptions {
   platform?: string;    // Single platform override (e.g., 'linux/arm64')
   timeout?: number;     // Build timeout in seconds
   noCache?: boolean;    // Force rebuild without Docker layer cache (--no-cache)
+  pull?: boolean;       // Pull fresh base images before building (default: true)
   cached?: boolean;     // Skip builds when Dockerfile content hasn't changed
   verbose?: boolean;    // Stream raw docker build output (default: silent)
   context?: string;      // Explicit Docker context name (--context flag)

ts/tsdocker.cli.ts

@@ -41,6 +41,7 @@ BUILD / PUSH OPTIONS
     --platform=<p>      Target platform (e.g. linux/arm64)
     --timeout=<s>       Build timeout in seconds
     --no-cache          Rebuild without Docker layer cache
+    --no-pull           Skip pulling latest base images (use cached)
     --cached            Skip builds when Dockerfile is unchanged
     --verbose           Stream raw docker build output
     --parallel[=<n>]    Parallel builds (optional concurrency limit)
@@ -66,7 +67,7 @@ CONFIG SUBCOMMANDS
     show                Show full global config
 
 CONFIGURATION
-    Configure via npmextra.json under the "@git.zone/tsdocker" key:
+    Configure via smartconfig.json under the "@git.zone/tsdocker" key:
 
       registries        Array of registry URLs to push to
       registryRepoMap   Map of registry URL to repo path overrides
@@ -120,6 +121,8 @@ export let run = () => {
       if (argvArg.cache === false) {
         buildOptions.noCache = true;
       }
+      // --pull is default true; --no-pull sets pull=false
+      buildOptions.pull = argvArg.pull !== false;
       if (argvArg.cached) {
         buildOptions.cached = true;
       }
@@ -170,6 +173,7 @@ export let run = () => {
       if (argvArg.cache === false) {
         buildOptions.noCache = true;
       }
+      buildOptions.pull = argvArg.pull !== false;
       if (argvArg.verbose) {
         buildOptions.verbose = true;
       }
@@ -243,6 +247,7 @@ export let run = () => {
       if (argvArg.cache === false) {
         buildOptions.noCache = true;
       }
+      buildOptions.pull = argvArg.pull !== false;
       if (argvArg.cached) {
         buildOptions.cached = true;
       }

ts/tsdocker.config.ts

@@ -3,8 +3,8 @@ import * as paths from './tsdocker.paths.js';
 import type { ITsDockerConfig } from './interfaces/index.js';
 
 const buildConfig = async (): Promise<ITsDockerConfig> => {
-  const npmextra = new plugins.npmextra.Npmextra(paths.cwd);
-  const config = npmextra.dataFor<ITsDockerConfig>('@git.zone/tsdocker', {
+  const smartconfig = new plugins.smartconfig.Smartconfig(paths.cwd);
+  const config = smartconfig.dataFor<ITsDockerConfig>('@git.zone/tsdocker', {
     registries: [],
     registryRepoMap: {},
     buildArgEnvMap: {},

ts/tsdocker.plugins.ts

@@ -1,6 +1,6 @@
 // push.rocks scope
 import * as lik from '@push.rocks/lik';
-import * as npmextra from '@push.rocks/npmextra';
+import * as smartconfig from '@push.rocks/smartconfig';
 import * as path from 'path';
 import * as projectinfo from '@push.rocks/projectinfo';
 import * as smartcli from '@push.rocks/smartcli';
@@ -16,7 +16,7 @@ export const smartfs = new SmartFs(new SmartFsProviderNode());
 
 export {
   lik,
-  npmextra,
+  smartconfig,
   path,
   projectinfo,
   smartcli,

tsconfig.json

@@ -5,8 +5,7 @@
     "moduleResolution": "NodeNext",
     "esModuleInterop": true,
     "verbatimModuleSyntax": true,
-    "baseUrl": ".",
-    "paths": {}
+    "useDefineForClassFields": false
   },
   "exclude": ["dist_*/**/*.d.ts"]
 }