@kosdev-code/kos-codegen-core 3.0.8 → 3.0.9

package/lib/generators/add-future-to-model/model-transformer.d.ts

@@ -4,14 +4,13 @@ export declare class ModelFileTransformer {
     private codegenFs;
     private options;
     constructor(codegenFs: CodegenFileSystem, options: NormalizedAddFutureToModelOptions);
+    private get progressType();
     transform(): void;
-    private addESLintDisable;
+    private removeLegacyImports;
     private addImports;
-    private addServiceImport;
-    private addInterfaceMerging;
+    private removeLegacyClassMembers;
     private addDecorator;
     private updatePublicType;
-    private removeLegacySetup;
     private addFutureMethod;
     private addOnFutureUpdateMethod;
 }

package/lib/generators/add-future-to-model/model-transformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-transformer.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/add-future-to-model/model-transformer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAC;AAEjE,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;gBADP,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,iCAAiC;IAGpD,SAAS,IAAI,IAAI;IAyBjB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,UAAU;IA6GlB,OAAO,CAAC,gBAAgB;IA+CxB,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,eAAe;IA+DvB,OAAO,CAAC,uBAAuB;CA8ChC"}
+{"version":3,"file":"model-transformer.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/add-future-to-model/model-transformer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAC;AA0BjE,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;gBADP,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,iCAAiC;IAGpD,OAAO,KAAK,YAAY,GAKvB;IAED,SAAS,IAAI,IAAI;IAsCjB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,UAAU;IA8BlB,OAAO,CAAC,wBAAwB;IA+BhC,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,uBAAuB;CAiChC"}

package/lib/generators/add-future-to-model/normalize-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-options.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/add-future-to-model/normalize-options.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,SAAS,CAAC;AAEjB,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,uBAAuB,EAChC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C,iCAAiC,CAsEnC"}
+{"version":3,"file":"normalize-options.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/add-future-to-model/normalize-options.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,SAAS,CAAC;AAEjB,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,uBAAuB,EAChC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C,iCAAiC,CA0EnC"}

package/lib/generators/add-future-to-model/registration-transformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registration-transformer.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/add-future-to-model/registration-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAC;AAEjE,qBAAa,2BAA2B;IAEpC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;gBADP,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,iCAAiC;IAGpD,SAAS,IAAI,IAAI;IAiBjB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,mBAAmB;CAyD5B"}
+{"version":3,"file":"registration-transformer.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/add-future-to-model/registration-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAC;AAEjE,qBAAa,2BAA2B;IAEpC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;gBADP,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,iCAAiC;IAGpD,SAAS,IAAI,IAAI;IA0BjB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,mBAAmB;CAyD5B"}

package/lib/generators/augment/resolve-model-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-model-file.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/augment/resolve-model-file.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,cAAc,EACrB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAqCnE"}
+{"version":3,"file":"resolve-model-file.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/augment/resolve-model-file.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,cAAc,EACrB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAiDnE"}

package/lib/generators/ci-sync.d.ts

@@ -0,0 +1,26 @@
+import { CodegenFileSystem } from '../codegen-filesystem';
+export interface DiscoveredArtifact {
+    id: string;
+    filename: string;
+    layer?: number;
+}
+export interface CiSyncOptions {
+    /** Remove stale entries instead of keeping and reporting them. */
+    prune?: boolean;
+}
+export interface CiSyncManifestResult {
+    added: string[];
+    stale: string[];
+    pruned: string[];
+}
+export interface CiSyncResult {
+    manifests: Record<string, CiSyncManifestResult>;
+    discovered: {
+        ui: DiscoveredArtifact[];
+        java: DiscoveredArtifact[];
+    };
+}
+export declare function discoverUiArtifacts(codegenFs: CodegenFileSystem): DiscoveredArtifact[];
+export declare function discoverJavaArtifacts(codegenFs: CodegenFileSystem): DiscoveredArtifact[];
+export declare function syncCiManifests(codegenFs: CodegenFileSystem, options?: CiSyncOptions): CiSyncResult;
+//# sourceMappingURL=ci-sync.d.ts.map

package/lib/generators/ci-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-sync.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/ci-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAChD,UAAU,EAAE;QAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC;QAAC,IAAI,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;CACtE;AAgBD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,iBAAiB,GAC3B,kBAAkB,EAAE,CAwCtB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iBAAiB,GAC3B,kBAAkB,EAAE,CAsBtB;AAkDD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAmBd"}

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

@@ -0,0 +1,38 @@
+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".
+     */
+    keyset?: string;
+    /**
+     * Node version build/nodew.sh pins and auto-provisions when the machine
+     * has none. Defaults to the Node running this generator — grounded in a
+     * version known to work with the scaffolded workspace.
+     */
+    nodeVersion?: string;
+    /** JDK major build/jdkw.sh pins (matches the archetypes' java.version). */
+    jdkMajor?: string;
+    /** Maven version build/jdkw.sh provisions when mvn is absent. */
+    mavenVersion?: string;
+}
+export interface PolyglotWorkspaceResult {
+    /**
+     * Root-relative paths the caller must mark executable (CodegenFileSystem
+     * has no chmod; CI invokes these directly as ./build/<script>).
+     */
+    executablePaths: string[];
+}
+export declare function generatePolyglotWorkspace(codegenFs: CodegenFileSystem, templateDir: string, options: PolyglotWorkspaceOptions): PolyglotWorkspaceResult;
+//# sourceMappingURL=generate-polyglot-workspace.d.ts.map

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

@@ -0,0 +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;;;;;;;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/lib/generators/index.d.ts

@@ -1,6 +1,11 @@
 export { generateSplashProject, type SplashProjectOptions, } from './generate-splash-project';
 export { generateInit, type KosInitOptions } from './generate-init';
+export { generatePolyglotWorkspace, type PolyglotWorkspaceOptions, type PolyglotWorkspaceResult, } from './generate-polyglot-workspace';
+export { syncCiManifests, discoverUiArtifacts, discoverJavaArtifacts, type CiSyncOptions, type CiSyncResult, type CiSyncManifestResult, type DiscoveredArtifact, } from './ci-sync';
+export { ensureJavaAggregatorPom, type EnsureJavaAggregatorOptions, finalizeArchetypeModule, type FinalizeArchetypeModuleOptions, addJavaArtifactToManifests, type AddJavaArtifactOptions, } from './java-workspace';
 export { normalizeOptions, type KosBaseGeneratorOptions, type NormalizedOptions, } from './normalize-options';
+export { buildKabTargets, type KabTargetsOptions, type KabTargetDefinition, UPDATE_RELEASE_VERSION_SCRIPT_PATH, } from './kab-targets';
+export { UPDATE_RELEASE_VERSION_SCRIPT } from './release-version-script';
 export { appendBarrelExport } from './barrel-utils';
 export { updateModelIndex } from './update-model-index';
 export { generateHook, type HookOptions } from './generate-hook';
@@ -11,6 +16,7 @@ export { generateModel, type ModelOptions, type GenerateModelParams, } from './g
 export { addFutureToModel, type AddFutureToModelOptions, type NormalizedAddFutureToModelOptions, } from './add-future-to-model';
 export { addContainerSupportToModel, type AddContainerSupportOptions, } from './add-container-support';
 export { addModelEffectToModel, type AddModelEffectOptions, addDependencyToModel, type AddDependencyOptions, addChildToModel, type AddChildOptions, type ChildShape, addTopicHandlerToModel, type AddTopicHandlerOptions, addConfigPropertyToModel, type AddConfigPropertyOptions, addServiceRequestToModel, type AddServiceRequestOptions, addPropertyToModel, type AddPropertyOptions, addComputedToModel, type AddComputedOptions, } from './member-mutators';
+export { resolveModelFilePath, type ModelFileQuery, } from './augment/resolve-model-file';
 export { transformSourceFile, ensureNamedImport, resolveSdkModuleSpecifier, getModelClass, addClassDecorator, ensureDeclarationMerge, ensureFileEslintDisable, addDecoratedMethod, addDecoratedProperty, addPlainProperty, addGetter, } from './augment/ts-toolkit';
 export { validateModel, type ValidateModelOptions, type ValidationFinding, type ValidationResult, } from './validate';
 export { describeModel, type DescribeModelOptions, type DescribedMember, type ModelDescription, } from './describe';

package/lib/generators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,GACvC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,0BAA0B,EAC1B,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/index.ts"],"names":[],"mappings":"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"}

package/lib/generators/java-workspace.d.ts

@@ -0,0 +1,33 @@
+import { CodegenFileSystem } from '../codegen-filesystem';
+export interface EnsureJavaAggregatorOptions {
+    groupId: string;
+    /** Aggregator artifactId (typically the workspace name). */
+    artifactId: string;
+    moduleName: string;
+}
+export declare function ensureJavaAggregatorPom(codegenFs: CodegenFileSystem, options: EnsureJavaAggregatorOptions): void;
+export interface FinalizeArchetypeModuleOptions {
+    moduleName: string;
+    /** kos-bom version to pin (replaces the template's 0.0.0-SNAPSHOT). */
+    kosVersion?: string;
+    /** Fills the template's undefined ${kos-kab-maven-plugin.version}. */
+    kabPluginVersion?: string;
+    /** Explicit version for the api-info dep the kos-bom doesn't manage. */
+    apiInfoVersion?: string;
+}
+/**
+ * Repair a freshly archetype-generated module for use inside a polyglot
+ * workspace. Returns human-readable notes about anything it could NOT fix
+ * (missing versions the caller failed to derive) so the CLI can warn.
+ */
+export declare function finalizeArchetypeModule(codegenFs: CodegenFileSystem, options: FinalizeArchetypeModuleOptions): string[];
+export interface AddJavaArtifactOptions {
+    moduleName: string;
+}
+/**
+ * Register the module's KAB in build-java.json and build-release.json.
+ * Only the artifacts arrays are touched — keyset/build_cmd/etc. are the
+ * user's (same contract as ci:sync).
+ */
+export declare function addJavaArtifactToManifests(codegenFs: CodegenFileSystem, options: AddJavaArtifactOptions): void;
+//# sourceMappingURL=java-workspace.d.ts.map

package/lib/generators/java-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"java-workspace.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/java-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,2BAA2B,GACnC,IAAI,CA+BN;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,8BAA8B,GACtC,MAAM,EAAE,CAqEV;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CA4BN"}

package/lib/generators/kab-targets.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared KOS artifact-target bundle.
+ *
+ * Every project that packages a KAB gets the same target family:
+ *   kab        — kabtool build + list (dependsOn zip)
+ *   zip        — archiver (dependsOn build [+ descriptor])
+ *   descriptor — descriptor.mjs (optional; apps/plugins/content/i18n)
+ *   version    — stamps the release version into the project's `.kos.json`
+ *
+ * The `version` target is KOS *artifact* versioning: it rewrites the
+ * `version` field of the project's `.kos.json` (which kabtool/descriptor bake
+ * into the KAB) and never touches `package.json`. Tag-based release pipelines
+ * drive it via:
+ *   nx run-many --target=version --args=--ver=$KOSBUILD_VERSION
+ *
+ * kab and version are deliberately produced by ONE helper so no generator can
+ * emit a KAB-packaging project that is not release-versionable.
+ */
+export interface KabTargetsOptions {
+    /** Project name as Nx knows it (argument to kabtool/archiver/descriptor). */
+    name: string;
+    /** Subdirectory of dist/archives/ the KAB lands in. Default: "packages". */
+    archiveDir?: string;
+    /**
+     * Output directory under dist/ for descriptor.json (e.g. `apps/my-ui`,
+     * `plugins/my-plugin`). When set, a `descriptor` target is emitted and
+     * `zip` depends on it. Omit for projects without a descriptor (themes).
+     */
+    descriptorDir?: string;
+    /** Build target `zip` depends on. Default: "build" (plugins: "build:production"). */
+    buildTarget?: string;
+}
+export interface KabTargetDefinition {
+    command: string;
+    options?: Record<string, unknown>;
+    dependsOn?: string[];
+}
+export declare const UPDATE_RELEASE_VERSION_SCRIPT_PATH = "tools/scripts/update-release-version.mjs";
+export declare function buildKabTargets(options: KabTargetsOptions): Record<string, KabTargetDefinition>;
+//# sourceMappingURL=kab-targets.d.ts.map

package/lib/generators/kab-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kab-targets.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/kab-targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,kCAAkC,6CACH,CAAC;AAE7C,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CA+CrC"}

package/lib/generators/release-version-script.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Source of tools/scripts/update-release-version.mjs — the implementation of
+ * the `version` target emitted by buildKabTargets (see kab-targets.ts).
+ *
+ * Kept as a constant (not a .template file) so the preset generator and the
+ * add-version-targets migration emit byte-identical scripts and cannot drift.
+ * The script has no template variables: the project name arrives via argv.
+ */
+export declare const UPDATE_RELEASE_VERSION_SCRIPT = "import devkit from \"@nx/devkit\";\nimport { resolve } from \"path\";\nimport { readFileSync, writeFileSync } from \"fs\";\nimport prettier from \"prettier\";\n\n// KOS artifact versioning: stamps the project's .kos.json \"version\" field\n// (which kabtool bakes into the KAB). Never touches package.json.\n// Driven by tag-based releases:\n//   nx run-many --target=version --args=--ver=$KOSBUILD_VERSION\n\nconst { readCachedProjectGraph } = devkit;\nconst [, , name, versionArg] = process.argv;\n\n// \"{args.ver}\" arrives literally when the target runs without --args=--ver=<v>;\n// treat that (or a missing arg) as \"report current version, change nothing\".\nconst version =\n  versionArg && !versionArg.startsWith(\"{args\") ? versionArg : undefined;\n\nif (!name) {\n  console.error(\"usage: update-release-version.mjs <project> <version>\");\n  process.exit(1);\n}\n\nconst graph = readCachedProjectGraph();\nconst project = graph.nodes[name];\nif (!project) {\n  console.error(\"Unknown project: \" + name);\n  process.exit(1);\n}\n\nconst kosJsonPath = resolve(process.cwd(), project.data.root, \".kos.json\");\nlet kosJson;\ntry {\n  kosJson = JSON.parse(readFileSync(kosJsonPath, \"utf8\"));\n} catch {\n  console.error(\"Missing or invalid .kos.json: \" + kosJsonPath);\n  process.exit(1);\n}\n\nif (!version) {\n  console.log(name + \": \" + kosJson.version + \" (no --ver given; unchanged)\");\n  process.exit(0);\n}\n\nconst prettierOptions = await prettier.resolveConfig(kosJsonPath);\nconst output = await prettier.format(\n  JSON.stringify({ ...kosJson, version }, null, 2),\n  { ...prettierOptions, parser: \"json\" }\n);\nwriteFileSync(kosJsonPath, output);\nconsole.log(name + \": version -> \" + version);\n";
+//# sourceMappingURL=release-version-script.d.ts.map

package/lib/generators/release-version-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-version-script.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/release-version-script.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,0sDAmDzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-codegen-core",
-  "version": "3.0.8",
+  "version": "3.0.9",
   "type": "commonjs",
   "main": "./index.js",
   "module": "./index.mjs",
@@ -25,7 +25,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "29a870c61fdd44a1dbbef550f682c9d991e98146"
+      "gitHash": "ae85b0e139cfe68f206a8b6d32de39a8df590837"
     }
   }
 }

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

@@ -0,0 +1,18 @@
+#!/bin/bash
+set -e -o pipefail
+
+THIS_SCRIPT=$(realpath "$0")
+TOP_DIR=$(dirname "$THIS_SCRIPT")/..
+
+# Skips cleanly while java/ has no modules so the repo builds end-to-end from
+# day one. Scaffold modules with the KOS Maven archetypes — see java/README.md.
+if [ ! -f "${TOP_DIR}/java/pom.xml" ]; then
+  echo "No Java modules yet (java/pom.xml not found); skipping Java build."
+  exit 0
+fi
+
+# Provision a repo-local JDK + Maven if none are installed (the mvnw pattern).
+. "$(dirname "$THIS_SCRIPT")/jdkw.sh"
+
+cd "${TOP_DIR}/java"
+mvn clean install --no-snapshot-updates -DskipTests -T4

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

@@ -0,0 +1,11 @@
+#!/bin/bash
+set -e -o pipefail
+
+THIS_SCRIPT=$(realpath "$0")
+THIS_SCRIPT_DIR=$(dirname "$THIS_SCRIPT")
+
+echo "************ Run UI Build ***********"
+"${THIS_SCRIPT_DIR}/build-ui.sh"
+
+echo "************ Run Java Build ***********"
+"${THIS_SCRIPT_DIR}/build-java.sh"

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

@@ -0,0 +1,23 @@
+#!/bin/bash
+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"
+
+cd "${TOP_DIR}/ui"
+
+echo "************ NPM Install ***********"
+npm ci
+
+echo "************ Build UI KABs ***********"
+npm run kab

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

@@ -0,0 +1,55 @@
+#!/bin/bash
+set -e -o pipefail
+
+# Run a repo build inside the same container image CI uses — no local Node,
+# JDK, or Maven required (only Docker or Podman). "Works in the container" ≈
+# "works in CI". Usage: ./build/docker-build.sh [ui|java|release]  (default:
+# release)
+#
+# The image is pulled from GitHub Container Registry; if the pull is denied,
+# authenticate first:  docker login ghcr.io -u <github-user>   (or podman login)
+
+THIS_SCRIPT=$(realpath "$0")
+TOP_DIR=$(dirname "$THIS_SCRIPT")/..
+TARGET="${1:-release}"
+
+if command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1; then
+  RUNTIME=docker
+elif command -v podman >/dev/null 2>&1; then
+  RUNTIME=podman
+else
+  echo "Neither a running docker daemon nor podman found — install one, or use ./build/build-${TARGET}.sh with a local toolchain." >&2
+  exit 1
+fi
+
+case "$TARGET" in
+  ui | java | release) ;;
+  *)
+    echo "usage: $0 [ui|java|release]" >&2
+    exit 1
+    ;;
+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" \
+  ${UI_VOLUMES} \
+  -w /work \
+  -e KOS_KABTOOL_JAR=/usr/local/lib/kabtool.jar \
+  -e JAVA_CMD=java \
+  ${KOSBUILD_VERSION:+-e KOSBUILD_VERSION="${KOSBUILD_VERSION}"} \
+  --entrypoint bash \
+  "$IMAGE" \
+  -lc "./build/build-${TARGET}.sh"

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

@@ -0,0 +1,93 @@
+# jdkw — JDK + Maven wrapper (the mvnw pattern, one level deeper).
+#
+# SOURCE this file (it edits PATH/JAVA_HOME): `. "$(dirname "$0")/jdkw.sh"`
+# If mvn and a JDK >= the pin are already on PATH they are used as-is —
+# developers with their own toolchain/IDE are never touched. Otherwise a
+# pinned Temurin JDK and Apache Maven are provisioned ONCE into .kos/
+# (repo-local, gitignored) so the java build runs with no global installs.
+
+JDKW_JAVA_MAJOR="<%= jdkMajor %>"
+JDKW_MAVEN_VERSION="<%= mavenVersion %>"
+
+jdkw_top_dir() {
+  # BASH_SOURCE because this file is sourced, not executed.
+  local src="${BASH_SOURCE[0]:-$0}"
+  echo "$(cd "$(dirname "$src")/.." && pwd)"
+}
+
+jdkw_java_ok() {
+  command -v java >/dev/null 2>&1 || return 1
+  local v
+  v="$(java -version 2>&1 | head -n 1 | sed -E 's/.*version "([0-9]+).*/\1/')" || return 1
+  [ "$v" -ge "$JDKW_JAVA_MAJOR" ] 2>/dev/null
+}
+
+jdkw_os() {
+  case "$(uname -s)" in
+    Darwin) echo "mac" ;;
+    Linux) echo "linux" ;;
+    *) return 1 ;;
+  esac
+}
+
+jdkw_arch() {
+  case "$(uname -m)" in
+    arm64 | aarch64) echo "aarch64" ;;
+    x86_64) echo "x64" ;;
+    *) return 1 ;;
+  esac
+}
+
+jdkw_ensure_java() {
+  if jdkw_java_ok; then
+    return 0
+  fi
+  local top os arch dest home
+  top="$(jdkw_top_dir)"
+  os="$(jdkw_os)" || {
+    echo "jdkw: unsupported OS $(uname -s) — install JDK ${JDKW_JAVA_MAJOR}+ manually" >&2
+    return 1
+  }
+  arch="$(jdkw_arch)" || {
+    echo "jdkw: unsupported arch $(uname -m) — install JDK ${JDKW_JAVA_MAJOR}+ manually" >&2
+    return 1
+  }
+  dest="${top}/.kos/jdk-${JDKW_JAVA_MAJOR}"
+  if [ ! -d "${dest}/bin" ] && [ ! -d "${dest}/Contents/Home/bin" ]; then
+    echo "jdkw: no JDK ${JDKW_JAVA_MAJOR}+ found; provisioning Temurin ${JDKW_JAVA_MAJOR} into .kos/ (one-time)" >&2
+    mkdir -p "$dest"
+    curl -fsSL "https://api.adoptium.net/v3/binary/latest/${JDKW_JAVA_MAJOR}/ga/${os}/${arch}/jdk/hotspot/normal/eclipse" |
+      tar -xz -C "$dest" --strip-components=1 || {
+        echo "jdkw: JDK download failed — install JDK ${JDKW_JAVA_MAJOR}+ manually" >&2
+        return 1
+      }
+  fi
+  if [ -d "${dest}/Contents/Home" ]; then
+    home="${dest}/Contents/Home"
+  else
+    home="$dest"
+  fi
+  export JAVA_HOME="$home"
+  export PATH="${home}/bin:${PATH}"
+}
+
+jdkw_ensure_maven() {
+  if command -v mvn >/dev/null 2>&1; then
+    return 0
+  fi
+  local top dest
+  top="$(jdkw_top_dir)"
+  dest="${top}/.kos/maven/apache-maven-${JDKW_MAVEN_VERSION}"
+  if [ ! -x "${dest}/bin/mvn" ]; then
+    echo "jdkw: no mvn found; provisioning Apache Maven ${JDKW_MAVEN_VERSION} into .kos/ (one-time)" >&2
+    mkdir -p "${top}/.kos/maven"
+    curl -fsSL "https://archive.apache.org/dist/maven/maven-3/${JDKW_MAVEN_VERSION}/binaries/apache-maven-${JDKW_MAVEN_VERSION}-bin.tar.gz" |
+      tar -xz -C "${top}/.kos/maven" || {
+        echo "jdkw: Maven download failed — install Maven manually" >&2
+        return 1
+      }
+  fi
+  export PATH="${dest}/bin:${PATH}"
+}
+
+jdkw_ensure_java && jdkw_ensure_maven

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

@@ -0,0 +1,73 @@
+# nodew — Node wrapper, the mvnw pattern for Node.js.
+#
+# SOURCE this file (it edits PATH): `. "$(dirname "$0")/nodew.sh"`
+# If a suitable node is already on PATH it is used as-is. Otherwise a pinned
+# Node runtime is downloaded ONCE into .kos/node/ (repo-local, gitignored) so
+# non-UI developers can run the build scripts with no global Node install.
+# npm ships inside the Node distribution.
+
+NODEW_VERSION="<%= nodeVersion %>"
+NODEW_MAJOR="${NODEW_VERSION%%.*}"
+
+nodew_top_dir() {
+  # BASH_SOURCE because this file is sourced, not executed.
+  local src="${BASH_SOURCE[0]:-$0}"
+  echo "$(cd "$(dirname "$src")/.." && pwd)"
+}
+
+nodew_have_suitable_node() {
+  command -v node >/dev/null 2>&1 || return 1
+  local v
+  v="$(node --version 2>/dev/null)" || return 1
+  v="${v#v}"
+  [ "${v%%.*}" -ge "$NODEW_MAJOR" ] 2>/dev/null
+}
+
+nodew_platform() {
+  case "$(uname -s)" in
+    Darwin) echo "darwin" ;;
+    Linux) echo "linux" ;;
+    *) return 1 ;;
+  esac
+}
+
+nodew_arch() {
+  case "$(uname -m)" in
+    arm64 | aarch64) echo "arm64" ;;
+    x86_64) echo "x64" ;;
+    *) return 1 ;;
+  esac
+}
+
+nodew_ensure() {
+  if nodew_have_suitable_node; then
+    return 0
+  fi
+
+  local top platform arch dist dest
+  top="$(nodew_top_dir)"
+  platform="$(nodew_platform)" || {
+    echo "nodew: unsupported OS $(uname -s) — install Node.js ${NODEW_MAJOR}+ manually" >&2
+    return 1
+  }
+  arch="$(nodew_arch)" || {
+    echo "nodew: unsupported arch $(uname -m) — install Node.js ${NODEW_MAJOR}+ manually" >&2
+    return 1
+  }
+  dist="node-v${NODEW_VERSION}-${platform}-${arch}"
+  dest="${top}/.kos/node/${dist}"
+
+  if [ ! -x "${dest}/bin/node" ]; then
+    echo "nodew: no Node ${NODEW_MAJOR}+ found; provisioning ${dist} into .kos/node/ (one-time)" >&2
+    mkdir -p "${top}/.kos/node"
+    curl -fsSL "https://nodejs.org/dist/v${NODEW_VERSION}/${dist}.tar.gz" |
+      tar -xz -C "${top}/.kos/node" || {
+        echo "nodew: download failed — install Node.js ${NODEW_MAJOR}+ manually" >&2
+        return 1
+      }
+  fi
+
+  export PATH="${dest}/bin:${PATH}"
+}
+
+nodew_ensure

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

@@ -0,0 +1,34 @@
+#!/bin/bash
+set -e -o pipefail
+
+THIS_SCRIPT=$(realpath "$0")
+TOP_DIR=$(dirname "$THIS_SCRIPT")/..
+
+# KOS artifact versioning: stamp the tag-derived release version into every
+# UI project's .kos.json and into the Maven POMs before the release build.
+if [ -z "${KOSBUILD_VERSION}" ]; then
+  echo "KOSBUILD_VERSION must be defined for release builds"
+  exit 1
+fi
+
+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.
+  . "$(dirname "$THIS_SCRIPT")/jdkw.sh"
+  cd "${TOP_DIR}/java"
+  # -DprocessAllModules: archetype-generated modules are standalone (no
+  # <parent> link to the aggregator), so a plain versions:set would stamp
+  # only the aggregator and leave module KABs at the old version.
+  mvn versions:set -DnewVersion="${KOSBUILD_VERSION}" -DprocessAllModules=true -DgenerateBackupPoms=false
+else
+  echo "No Java modules yet; skipping Java version stamp."
+fi

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

@@ -0,0 +1,6 @@
+{
+  "default_keyset": "<%= keyset %>",
+  "build_cmd": "./build/build-java.sh",
+
+  "artifacts": []
+}

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

@@ -0,0 +1,14 @@
+{
+  "default_keyset": "<%= keyset %>",
+  "prebuild_cmd": "build/release_version_prebuild.sh",
+  "build_cmd": "build/build-release.sh",
+
+  "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

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