Code GenerationGenerated assets and ownership

Code generation scripts/*.generated.*

Generated scripts and tools

Workspace scripts implement operations that are too stateful or detailed for portable Make recipes.

When to use

Use this reference when generating, reviewing or operating a Service Architect project.

Behavior

Merge scripts apply file ownership, mode preservation, diagnostics and post-merge interface validation.
Kubernetes orchestration manages registry, k3s, infrastructure charts, service releases and verification.
Dependency-cache scripts bootstrap Nexus, Git mirrors and package-manager environments.
Temporal scripts initialize PostgreSQL schemas and create the configured namespace idempotently.
Language scripts encapsulate CMake builds, sanitizers, lint, formatting, integration tests and standalone packaging.
tools contains pinned or downloaded command wrappers used by generated Make targets.

Common workspace scripts

Scripts present across generated language workspaces.

FilePurposeDescription

clone.generated.shGenerated executable

Restore independently published components at moduleVersion.

scripts/merge.generated.shGenerated executable

Merge a complete archive into an existing workspace.

scripts/merge-overwrite.txtGenerated policy

Exact public paths that remain generator-owned without generated in the basename.

scripts/merge_validate.generated.pyGenerated validator

Verify generated/business interfaces and emit structured diagnostics.

scripts/merge_file.sh + merge_post.shPreserved hooks

Optional project merge extensions.

scripts/kubernetes.generated.shGenerated executable

Build, deploy, test, inspect and remove the local cluster.

scripts/dependency-cache.generated.shGenerated executable

Manage Nexus and Git mirror lifecycle.

scripts/dependency_cache_bootstrap.generated.pyGenerated

Configure proxy repositories idempotently.

scripts/git_mirror.generated.cgiGenerated

Serve cached Git repositories.

scripts/dependency-source-cache.generated.shGenerated

Invalidate source/CMake state without discarding expensive caches.

scripts/temporal/create-namespace.generated.shGenerated

Create the graph namespace when absent.

scripts/temporal/setup-postgres.generated.shGenerated

Prepare Temporal PostgreSQL persistence.

Language-specific scripts

Additional generated executables selected by a backend.

FileBackendDescription

scripts/build.generated.shC++

Drive the canonical containerized CMake build.

scripts/cmake-docker.generated.shC++

Run CMake actions in the reusable toolchain image.

scripts/conan-install.generated.shC++

Resolve pinned C++ package dependencies.

scripts/lint.generated.sh + format.generated.shC++

Run clang tooling consistently in Docker.

scripts/test.generated.shC++

Execute generated unit test targets.

scripts/sanitizer-test.generated.shC++

Build and execute ASan/UBSan or TSan variants.

scripts/integration-test.generated.shC++

Run generated cross-service transport scenario.

scripts/package-cpp-service.generated.shC++

Create independent service trees under dist/.

scripts/package-rust-service.generated.shRust

Create standalone Cargo service repositories.

scripts/package-typescript-service.generated.shTypeScript

Create standalone npm service repositories.

scripts/run-with-progress.generated.shC++/TypeScript

Print progress for long silent dependency/build steps.

scripts/node-diagnostics.generated.mjsTypeScript service

Write Node reports and heap snapshots on signals.

Tool directory

Pinned tools downloaded or exposed by generated Make targets.

PathPurposeDescription

tools/bufSchemas

Format and generate protobuf artifacts.

tools/protoc + protoc-gen-*Go/protobuf

Compile descriptors and Go protobuf/gRPC bindings.

tools/oapi-codegenGo/OpenAPI

Generate Go HTTP API bindings.

tools/golangci-lintGo quality

Run generated Go lint policy.

tools/actLocal CI

Execute GitHub Actions workflows locally.

tools/gh + tools/glabRepository publishing

Create and push GitHub/GitLab component repositories.

tools/userverC++ framework

Pinned/local userver source and patches for C++ generation.

tools/typescript-bufTypeScript schemas

Pinned TypeScript protobuf generation tool.

Script-backed commands

make merge-check        -> scripts/merge.generated.sh --dry-run
make kubernetes-up      -> scripts/kubernetes.generated.sh up
make cpp-asan-test      -> scripts/sanitizer-test.generated.sh
make typescript-package -> scripts/package-typescript-service.generated.sh