@kosdev-code/kos-codegen-core 0.1.0-next.796 → 0.1.0-next.797

package/lib/generators/generate-polyglot-workspace.d.ts

@@ -2,6 +2,15 @@ import { CodegenFileSystem } from '../codegen-filesystem';
 export interface PolyglotWorkspaceOptions {
     /** Workspace/repo name (also determines the UI app name `<name>-ui`). */
     name: string;
+    /**
+     * The repo-root layer is IDENTICAL for every type — same scripts,
+     * workflows, and manifests, all runtime-tolerant of a missing half — so a
+     * repo can grow the other half later without restructuring. The type only
+     * seeds the manifests: "polyglot"/"ui" (default) pre-register the UI app
+     * artifact; "java" starts with empty artifact lists (ci:sync/java:add
+     * fill them in).
+     */
+    type?: "polyglot" | "ui" | "java";
     /**
      * `default_keyset` for the kos_build_handler manifests. Org-specific;
      * changeable in .github/build-*.json afterward. Default: "prod.kos".

package/lib/generators/generate-polyglot-workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-polyglot-workspace.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/generate-polyglot-workspace.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI/D,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAUD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CAuCzB"}
+{"version":3,"file":"generate-polyglot-workspace.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/generate-polyglot-workspace.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI/D,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAUD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CAyCzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-codegen-core",
-  "version": "0.1.0-next.796",
+  "version": "0.1.0-next.797",
   "type": "commonjs",
   "main": "./index.js",
   "module": "./index.mjs",
@@ -25,7 +25,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "1ddf27b7d03081c5b75d1f624934cea8fff5bd6b"
+      "gitHash": "ae85b0e139cfe68f206a8b6d32de39a8df590837"
     }
   }
 }

package/templates/polyglot-workspace/build/build-ui.sh.template

@@ -4,6 +4,13 @@ set -e -o pipefail
 THIS_SCRIPT=$(realpath "$0")
 TOP_DIR=$(dirname "$THIS_SCRIPT")/..
 
+# Skips cleanly while the repo has no ui half so the same scripts work for
+# every workspace shape. Grow a ui half with: kosui ui:add
+if [ ! -f "${TOP_DIR}/ui/package.json" ]; then
+  echo "No ui workspace yet (ui/package.json not found); skipping UI build."
+  exit 0
+fi
+
 # Provision a repo-local Node if none is installed (the mvnw pattern).
 . "$(dirname "$THIS_SCRIPT")/nodew.sh"
 

package/templates/polyglot-workspace/build/docker-build.sh.template

@@ -33,13 +33,19 @@ esac
 IMAGE="ghcr.io/kosdev-code/kos-buildpublish/kos_builder:dockerimage"
 WORKSPACE_NAME="$(basename "$(cd "$TOP_DIR" && pwd)")"
 
+# npm cache + node_modules volumes only make sense once a ui half exists
+# (and mounting /work/ui/node_modules would otherwise create a stray ui/).
+UI_VOLUMES=""
+if [ -f "${TOP_DIR}/ui/package.json" ]; then
+  UI_VOLUMES="-v kos-npm-cache-${WORKSPACE_NAME}:/root/.npm -v kos-node-modules-${WORKSPACE_NAME}:/work/ui/node_modules"
+fi
+
 # Named volumes keep Maven/npm caches warm between runs and keep the
 # container's linux node_modules out of the host's ui/node_modules.
 "$RUNTIME" run --rm \
   -v "$(cd "$TOP_DIR" && pwd):/work" \
   -v "kos-m2-${WORKSPACE_NAME}:/root/.m2" \
-  -v "kos-npm-cache-${WORKSPACE_NAME}:/root/.npm" \
-  -v "kos-node-modules-${WORKSPACE_NAME}:/work/ui/node_modules" \
+  ${UI_VOLUMES} \
   -w /work \
   -e KOS_KABTOOL_JAR=/usr/local/lib/kabtool.jar \
   -e JAVA_CMD=java \

package/templates/polyglot-workspace/build/release_version_prebuild.sh.template

@@ -11,12 +11,15 @@ if [ -z "${KOSBUILD_VERSION}" ]; then
   exit 1
 fi
 
-# Provision a repo-local Node if none is installed (the mvnw pattern).
-. "$(dirname "$THIS_SCRIPT")/nodew.sh"
-
-cd "${TOP_DIR}/ui"
-npm ci
-npx nx run-many --target=version --args=--ver="${KOSBUILD_VERSION}"
+if [ -f "${TOP_DIR}/ui/package.json" ]; then
+  # Provision a repo-local Node if none is installed (the mvnw pattern).
+  . "$(dirname "$THIS_SCRIPT")/nodew.sh"
+  cd "${TOP_DIR}/ui"
+  npm ci
+  npx nx run-many --target=version --args=--ver="${KOSBUILD_VERSION}"
+else
+  echo "No ui workspace yet; skipping ui version stamp."
+fi
 
 if [ -f "${TOP_DIR}/java/pom.xml" ]; then
   # Provision a repo-local JDK + Maven if none are installed.

package/templates/polyglot-workspace/github/build-release.json.template

@@ -3,12 +3,12 @@
   "prebuild_cmd": "build/release_version_prebuild.sh",
   "build_cmd": "build/build-release.sh",
 
-  "artifacts": [
+  "artifacts": [<% if (hasUi) { %>
     {
       "id": "<%= appUiName %>",
       "filename": "ui/dist/archives/packages/<%= appUiName %>/<%= appUiName %>.kab",
       "artifactstore": "kos-cdn",
       "marketplace": 1
-    }
+    }<% } %>
   ]
 }

package/templates/polyglot-workspace/github/build-ui.json.template

@@ -2,12 +2,12 @@
   "default_keyset": "<%= keyset %>",
   "build_cmd": "./build/build-ui.sh",
 
-  "artifacts": [
+  "artifacts": [<% if (hasUi) { %>
     {
       "id": "<%= appUiName %>",
       "filename": "ui/dist/archives/packages/<%= appUiName %>/<%= appUiName %>.kab",
       "artifactstore": "kos-cdn",
       "marketplace": 1
-    }
+    }<% } %>
   ]
 }

package/templates/polyglot-workspace/root/README.md.template

@@ -1,14 +1,16 @@
 # <%= nameDashCase %>
 
-Polyglot KOS application repository: a Java backend and a KOS UI workspace that
-build side-by-side KOS artifacts (KABs) published to the KOS marketplace.
+KOS application repository. The layout is the same whether the repo holds a
+UI workspace, a Java backend, or both — each half can be added at any time
+without restructuring, and every build/CI script skips cleanly over a half
+that doesn't exist yet.
 
 ## Layout
 
 | Path | Purpose |
 | --- | --- |
-| `ui/` | KOS UI workspace (Nx root lives here — run `npm`/`nx` commands inside `ui/`) |
-| `java/` | KOS Java backend (Maven; scaffold modules with the KOS Maven archetypes — see `java/README.md`) |
+| `ui/` | KOS UI workspace, if present (Nx root lives here — run `npm`/`nx` commands inside `ui/`; grow with `kosui ui:add`) |
+| `java/` | KOS Java backend, if present (Maven; scaffold modules with the KOS Maven archetypes — `kosui java:add` or see `java/README.md`) |
 | `build/` | Repo-level build orchestration scripts used locally and by CI |
 | `.github/` | CI workflows and `kos_build_handler` manifests (`build-*.json`) |
 
@@ -18,9 +20,9 @@ artifacts, published together by the release pipeline.
 ## Local builds
 
 ```sh
-./build/build-ui.sh        # npm ci + build all UI KABs
-./build/build-java.sh      # mvn build (skips cleanly while java/ is empty)
-./build/build-release.sh   # UI then Java (what the release pipeline runs)
+./build/build-ui.sh        # npm ci + build all UI KABs (skips if no ui/)
+./build/build-java.sh      # mvn build (skips if no java modules)
+./build/build-release.sh   # both, in order — what the release pipeline runs
 ```
 
 **No toolchain? No problem.** The build scripts provision what's missing
@@ -28,7 +30,7 @@ automatically (the `mvnw` pattern): `build/nodew.sh` fetches a pinned Node
 runtime and `build/jdkw.sh` a pinned Temurin JDK + Maven, each into the
 repo-local, gitignored `.kos/` on first use. Developers with their own
 toolchains/IDEs are never touched — the wrappers always defer to an existing
-install, so working on just `java/` in your own IDE needs nothing from here.
+install, so working on just one half in your own IDE needs nothing from here.
 
 Optional: `./build/docker-build.sh ui|java|release` runs a build inside the
 same container image CI uses (docker or podman; `docker login ghcr.io` for the
@@ -46,7 +48,7 @@ git tag 1.0.0 && git push origin 1.0.0
 
 The release workflow derives `KOSBUILD_VERSION` from the tag, then
 `build/release_version_prebuild.sh` stamps it into every UI project's
-`.kos.json` (via `nx run-many --target=version`) and into the Maven POMs
+`.kos.json` (via `nx run-many --target=version`) and the Maven POMs
 (`mvn versions:set`) before building and publishing all artifacts.
 
 ## CI configuration
@@ -64,6 +66,6 @@ keyset.
 ## Adding artifacts
 
 Every KAB the repo produces must be listed in the `artifacts` arrays of
-`.github/build-ui.json` / `build-java.json` and the union kept in
-`build-release.json`. Update these when adding UI projects or Java modules
-(`kosui ci:sync` automates this where available).
+`.github/build-ui.json` / `build-java.json`, with the union kept in
+`build-release.json`. `kosui ci:sync` keeps these in sync with the projects
+and modules that actually exist (`kosui java:add` updates them automatically).