@codefast/cli 0.3.14-canary.2 → 0.3.15

package/dist/{lib/tag/adapters/primary → domains/tag/presentation}/cli/tag.command.mjs

@@ -1,13 +1,11 @@
-import { CliLoggerToken, CliRuntimeToken } from "../../../../core/contracts/tokens.mjs";
-import { parseWithCliSchema } from "../../../../core/presentation/cli-schema.parser.mjs";
-import { consumeCliAppError } from "../../../../core/presentation/cli-executor.presenter.mjs";
-import { exitCodeForTagSyncResult } from "../../../application/tag-sync-cli-result.mjs";
-import { formatTagSyncJsonOutput } from "../../../application/tag-sync-json.format.mjs";
-import { PrepareTagSyncUseCaseToken, RunTagSyncUseCaseToken } from "../../../contracts/tokens.mjs";
-import { tagSyncRunRequestSchema } from "../../../presentation/tag-cli.schema.mjs";
-import { PresentTagSyncResultPresenterToken, TagSyncProgressListenerToken } from "./presentation.tokens.mjs";
+import { CliExecutorToken, CliLoggerPortToken, CliRuntimeToken, CliSchemaParsingToken } from "../../../../shell/application/cli-runtime.tokens.mjs";
+import { PrepareTagSyncUseCaseToken, PresentTagSyncProgressPresenterToken, PresentTagSyncResultPresenterToken, RunTagSyncUseCaseToken } from "../../composition/tokens.mjs";
+import { exitCodeForTagSyncResult } from "../../application/tag-sync-cli-result.mjs";
+import { CLI_COMMAND_SLOT_NAME } from "../../../../shell/contracts/cli-command-slots.mjs";
+import { readOptionalPositionalArg } from "../../../../shell/domain/cli-positional-arg.value-object.mjs";
+import { tagSyncRunRequestSchema } from "../presenters/tag-cli.schema.mjs";
 import { inject, injectable } from "@codefast/di";
-//#region src/lib/tag/adapters/primary/cli/tag.command.ts
+//#region src/domains/tag/presentation/cli/tag.command.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -219,12 +217,14 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 }
 let _dec, _initClass;
 _dec = injectable([
-	inject(CliLoggerToken),
+	inject(CliLoggerPortToken),
 	inject(CliRuntimeToken),
 	inject(PrepareTagSyncUseCaseToken),
 	inject(RunTagSyncUseCaseToken),
-	inject(TagSyncProgressListenerToken),
-	inject(PresentTagSyncResultPresenterToken)
+	inject(PresentTagSyncProgressPresenterToken),
+	inject(PresentTagSyncResultPresenterToken),
+	inject(CliSchemaParsingToken),
+	inject(CliExecutorToken)
 ]);
 let _TagCommand;
 (class {
@@ -232,33 +232,65 @@ let _TagCommand;
 	runtime;
 	prepareTagSync;
 	runTagSync;
-	tagProgressListener;
+	tagProgressPresenter;
 	presentSyncCliResult;
+	schemaValidation;
+	cliExecutor;
 	static {
 		({c: [_TagCommand, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
-	constructor(logger, runtime, prepareTagSync, runTagSync, tagProgressListener, presentSyncCliResult) {
+	constructor(logger, runtime, prepareTagSync, runTagSync, tagProgressPresenter, presentSyncCliResult, schemaValidation, cliExecutor) {
 		this.logger = logger;
 		this.runtime = runtime;
 		this.prepareTagSync = prepareTagSync;
 		this.runTagSync = runTagSync;
-		this.tagProgressListener = tagProgressListener;
+		this.tagProgressPresenter = tagProgressPresenter;
 		this.presentSyncCliResult = presentSyncCliResult;
+		this.schemaValidation = schemaValidation;
+		this.cliExecutor = cliExecutor;
 	}
-	name = "tag";
-	description = "Add @since <version> JSDoc tags to exported declarations";
-	register(program) {
-		program.command(this.name).alias("annotate").description(this.description).argument("[target]", "Directory or file to annotate (default: auto-discover workspace packages)").option("--dry-run", "Show summary without writing files", false).option("--json", "Print one JSON summary on stdout (suppresses human progress)", false).action(this.execute.bind(this));
+	get definition() {
+		return {
+			name: CLI_COMMAND_SLOT_NAME.tag,
+			description: "Add @since <version> JSDoc tags to exported declarations",
+			aliases: ["annotate"],
+			route: [
+				{
+					kind: "optionalPositional",
+					argumentTemplate: "[target]",
+					helpBlurb: "Directory or file to annotate (default: auto-discover workspace packages)"
+				},
+				{
+					kind: "booleanFlag",
+					flagPhrase: "--dry-run",
+					helpBlurb: "Show summary without writing files",
+					whenUnsetUses: false
+				},
+				{
+					kind: "booleanFlag",
+					flagPhrase: "--json",
+					helpBlurb: "Print one JSON summary on stdout (suppresses human progress)",
+					whenUnsetUses: false
+				}
+			],
+			action: async (positionalArguments, localOptionRecord) => {
+				const typedOptionsCarrier = localOptionRecord;
+				await this.runAnnotatedTagVerb(readOptionalPositionalArg(positionalArguments[0]), {
+					dryRun: typedOptionsCarrier.dryRun,
+					json: typedOptionsCarrier.json
+				});
+			}
+		};
 	}
-	async execute(target, options, _command) {
+	async runAnnotatedTagVerb(rawTargetPiece, options) {
 		const prelude = await this.prepareTagSync.execute({
 			currentWorkingDirectory: this.runtime.cwd(),
-			rawTarget: target
+			rawTarget: rawTargetPiece
 		});
-		if (!consumeCliAppError(this.logger, prelude)) return;
+		if (!this.cliExecutor.consumeCliAppError(prelude)) return;
 		const { rootDir, config, resolvedTargetPath } = prelude.value;
 		const tagConfig = config.tag ?? {};
-		const parsed = parseWithCliSchema(tagSyncRunRequestSchema, {
+		const parsed = this.schemaValidation.parseWithSchema(tagSyncRunRequestSchema, {
 			rootDir,
 			write: !options.dryRun,
 			json: options.json,
@@ -266,17 +298,25 @@ let _TagCommand;
 			skipPackages: tagConfig.skipPackages,
 			config: tagConfig
 		});
-		if (!consumeCliAppError(this.logger, parsed)) return;
+		if (!this.cliExecutor.consumeCliAppError(parsed)) return;
 		const tagOutcome = await this.runTagSync.execute({
 			...parsed.value,
-			listener: parsed.value.json ? void 0 : this.tagProgressListener
+			listener: parsed.value.json ? void 0 : this.tagProgressPresenter
 		});
-		if (!consumeCliAppError(this.logger, tagOutcome)) return;
+		if (!this.cliExecutor.consumeCliAppError(tagOutcome)) return;
 		if (parsed.value.json) {
-			this.logger.out(formatTagSyncJsonOutput(tagOutcome.value, rootDir));
+			this.logger.out(this.formatTagSyncJsonOutput(tagOutcome.value, rootDir));
 			this.runtime.setExitCode(exitCodeForTagSyncResult(tagOutcome.value));
 		} else this.runtime.setExitCode(this.presentSyncCliResult.present(tagOutcome.value, rootDir));
 	}
+	formatTagSyncJsonOutput(result, rootDir) {
+		return JSON.stringify({
+			schemaVersion: 1,
+			ok: result.hookError === null,
+			cwd: rootDir,
+			result
+		});
+	}
 	static {
 		_initClass();
 	}

package/dist/{lib/tag/presentation/tag-sync-progress-listener.presenter.mjs → domains/tag/presentation/presenters/present-tag-sync-progress.presenter.mjs}

@@ -1,7 +1,6 @@
-import { CliLoggerToken } from "../../core/contracts/tokens.mjs";
-import { formatProgress } from "./tag-sync.presenter.mjs";
+import { CliLoggerPortToken } from "../../../../shell/application/cli-runtime.tokens.mjs";
 import { inject, injectable } from "@codefast/di";
-//#region src/lib/tag/presentation/tag-sync-progress-listener.presenter.ts
+//#region src/domains/tag/presentation/presenters/present-tag-sync-progress.presenter.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -212,32 +211,38 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 	};
 }
 let _dec, _initClass;
-_dec = injectable([inject(CliLoggerToken)]);
-let _TagSyncProgressListener;
+_dec = injectable([inject(CliLoggerPortToken)]);
+let _PresentTagSyncProgressPresenter;
 (class {
 	logger;
 	static {
-		({c: [_TagSyncProgressListener, _initClass]} = _apply_decs_2311(this, [_dec], []));
+		({c: [_PresentTagSyncProgressPresenter, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
 	constructor(logger) {
 		this.logger = logger;
 	}
 	onTargetStarted(target) {
-		this.logger.out(formatProgress({
+		this.logger.out(this.formatProgress({
 			type: "target-started",
 			target
 		}));
 	}
 	onTargetCompleted(target, result) {
-		this.logger.out(formatProgress({
+		this.logger.out(this.formatProgress({
 			type: "target-completed",
 			target,
 			result
 		}));
 	}
+	formatProgress(event) {
+		const targetDisplayName = (target) => target.packageName ?? target.rootRelativeTargetPath;
+		if (event.type === "target-started") return `[tag] Processing ${targetDisplayName(event.target)}...`;
+		const changedFiles = event.result.result?.filesChanged ?? 0;
+		return `[tag] Done ${targetDisplayName(event.target)} (${changedFiles} changes)`;
+	}
 	static {
 		_initClass();
 	}
 });
 //#endregion
-export { _TagSyncProgressListener as TagSyncProgressListener };
+export { _PresentTagSyncProgressPresenter as PresentTagSyncProgressPresenter };

package/dist/domains/tag/presentation/presenters/present-tag-sync-result.presenter.mjs

@@ -0,0 +1,290 @@
+import { CliLoggerPortToken } from "../../../../shell/application/cli-runtime.tokens.mjs";
+import "../../../../shell/domain/cli-exit-codes.domain.mjs";
+import { exitCodeForTagSyncResult } from "../../application/tag-sync-cli-result.mjs";
+import { inject, injectable } from "@codefast/di";
+//#region src/domains/tag/presentation/presenters/present-tag-sync-result.presenter.ts
+function toPrimitive(input, hint) {
+	if (typeof input !== "object" || input === null) return input;
+	var prim = input[Symbol.toPrimitive];
+	if (prim !== void 0) {
+		var res = prim.call(input, hint || "default");
+		if (typeof res !== "object") return res;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return (hint === "string" ? String : Number)(input);
+}
+function toPropertyKey(arg) {
+	var key = toPrimitive(arg, "string");
+	return typeof key === "symbol" ? key : String(key);
+}
+function checkInRHS(value) {
+	if (Object(value) !== value) throw TypeError("right-hand side of 'in' should be an object, got " + (value !== null ? typeof value : "null"));
+	return value;
+}
+function setFunctionName(fn, name, prefix) {
+	if (typeof name === "symbol") {
+		name = name.description;
+		name = name ? "[" + name + "]" : "";
+	}
+	try {
+		Object.defineProperty(fn, "name", {
+			configurable: true,
+			value: prefix ? prefix + " " + name : name
+		});
+	} catch (_) {}
+	return fn;
+}
+function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis, instanceBrand, parentClass) {
+	var symbolMetadata = Symbol.metadata || Symbol.for("Symbol.metadata");
+	var defineProperty = Object.defineProperty;
+	var create = Object.create;
+	var metadata;
+	var existingNonFields = [create(null), create(null)];
+	var hasClassDecs = classDecs.length;
+	var _;
+	function createRunInitializers(initializers, useStaticThis, hasValue) {
+		return function(thisArg, value) {
+			if (useStaticThis) {
+				value = thisArg;
+				thisArg = targetClass;
+			}
+			for (var i = 0; i < initializers.length; i++) value = initializers[i].apply(thisArg, hasValue ? [value] : []);
+			return hasValue ? value : thisArg;
+		};
+	}
+	function assertCallable(fn, hint1, hint2, throwUndefined) {
+		if (typeof fn !== "function") {
+			if (throwUndefined || fn !== void 0) throw new TypeError(hint1 + " must " + (hint2 || "be") + " a function" + (throwUndefined ? "" : " or undefined"));
+		}
+		return fn;
+	}
+	function applyDec(Class, decInfo, decoratorsHaveThis, name, kind, initializers, ret, isStatic, isPrivate, isField, hasPrivateBrand) {
+		function assertInstanceIfPrivate(target) {
+			if (!hasPrivateBrand(target)) throw new TypeError("Attempted to access private element on non-instance");
+		}
+		var decs = [].concat(decInfo[0]);
+		var decVal = decInfo[3];
+		var isClass = !ret;
+		var isAccessor = kind === 1;
+		var isGetter = kind === 3;
+		var isSetter = kind === 4;
+		var isMethod = kind === 2;
+		function bindPropCall(name, useStaticThis, before) {
+			return function(_this, value) {
+				if (useStaticThis) {
+					value = _this;
+					_this = Class;
+				}
+				if (before) before(_this);
+				return desc[name].call(_this, value);
+			};
+		}
+		var desc1 = {};
+		var init = [];
+		var key = isGetter ? "get" : isSetter || isAccessor ? "set" : "value";
+		if (!isClass) {
+			if (isPrivate) {
+				if (isField || isAccessor) desc1 = {
+					get: setFunctionName(function() {
+						return decVal(this);
+					}, name, "get"),
+					set: function(value) {
+						decInfo[4](this, value);
+					}
+				};
+				else desc1[key] = decVal;
+				if (!isField) setFunctionName(desc1[key], name, isMethod ? "" : key);
+			} else if (!isField) desc1 = Object.getOwnPropertyDescriptor(Class, name);
+			if (!isField && !isPrivate) {
+				_ = existingNonFields[+isStatic][name];
+				if (_ && (_ ^ kind) !== 7) throw new Error("Decorating two elements with the same name (" + desc1[key].name + ") is not supported yet");
+				existingNonFields[+isStatic][name] = kind < 3 ? 1 : kind;
+			}
+		}
+		var newValue = Class;
+		for (var i = decs.length - 1; i >= 0; i -= decoratorsHaveThis ? 2 : 1) {
+			var dec = assertCallable(decs[i], "A decorator", "be", true);
+			var decThis = decoratorsHaveThis ? decs[i - 1] : void 0;
+			var decoratorFinishedRef = {};
+			var ctx = {
+				kind: [
+					"field",
+					"accessor",
+					"method",
+					"getter",
+					"setter",
+					"class"
+				][kind],
+				name,
+				metadata,
+				addInitializer: (function(decoratorFinishedRef, initializer) {
+					if (decoratorFinishedRef.v) throw new TypeError("attempted to call addInitializer after decoration was finished");
+					assertCallable(initializer, "An initializer", "be", true);
+					initializers.push(initializer);
+				}).bind(null, decoratorFinishedRef)
+			};
+			if (isClass) {
+				_ = dec.call(decThis, newValue, ctx);
+				decoratorFinishedRef.v = 1;
+				if (assertCallable(_, "class decorators", "return")) newValue = _;
+				continue;
+			}
+			ctx.static = isStatic;
+			ctx.private = isPrivate;
+			_ = ctx.access = { has: isPrivate ? hasPrivateBrand.bind() : function(target) {
+				return name in target;
+			} };
+			if (!isSetter) _.get = isPrivate ? isMethod ? function(_this) {
+				assertInstanceIfPrivate(_this);
+				return desc1.value;
+			} : bindPropCall("get", 0, assertInstanceIfPrivate) : function(target) {
+				return target[name];
+			};
+			if (!isMethod && !isGetter) _.set = isPrivate ? bindPropCall("set", 0, assertInstanceIfPrivate) : function(target, value) {
+				target[name] = value;
+			};
+			newValue = dec.call(decThis, isAccessor ? {
+				get: desc1.get,
+				set: desc1.set
+			} : desc1[key], ctx);
+			decoratorFinishedRef.v = 1;
+			if (isAccessor) {
+				if (typeof newValue === "object" && newValue) {
+					if (_ = assertCallable(newValue.get, "accessor.get")) desc1.get = _;
+					if (_ = assertCallable(newValue.set, "accessor.set")) desc1.set = _;
+					if (_ = assertCallable(newValue.init, "accessor.init")) init.unshift(_);
+				} else if (newValue !== void 0) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined");
+			} else if (assertCallable(newValue, (isField ? "field" : "method") + " decorators", "return")) if (isField) init.unshift(newValue);
+			else desc1[key] = newValue;
+		}
+		if (kind < 2) ret.push(createRunInitializers(init, isStatic, 1), createRunInitializers(initializers, isStatic, 0));
+		if (!isField && !isClass) if (isPrivate) if (isAccessor) ret.splice(-1, 0, bindPropCall("get", isStatic), bindPropCall("set", isStatic));
+		else ret.push(isMethod ? desc1[key] : assertCallable.call.bind(desc1[key]));
+		else defineProperty(Class, name, desc1);
+		return newValue;
+	}
+	function applyMemberDecs() {
+		var ret = [];
+		var protoInitializers;
+		var staticInitializers;
+		var pushInitializers = function(initializers) {
+			if (initializers) ret.push(createRunInitializers(initializers));
+		};
+		var applyMemberDecsOfKind = function(isStatic, isField) {
+			for (var i = 0; i < memberDecs.length; i++) {
+				var decInfo = memberDecs[i];
+				var kind = decInfo[1];
+				var kindOnly = kind & 7;
+				if ((kind & 8) == isStatic && !kindOnly == isField) {
+					var name = decInfo[2];
+					var isPrivate = !!decInfo[3];
+					var decoratorsHaveThis = kind & 16;
+					applyDec(isStatic ? targetClass : targetClass.prototype, decInfo, decoratorsHaveThis, isPrivate ? "#" + name : toPropertyKey(name), kindOnly, kindOnly < 2 ? [] : isStatic ? staticInitializers = staticInitializers || [] : protoInitializers = protoInitializers || [], ret, !!isStatic, isPrivate, isField, isStatic && isPrivate ? function(_) {
+						return checkInRHS(_) === targetClass;
+					} : instanceBrand);
+				}
+			}
+		};
+		applyMemberDecsOfKind(8, 0);
+		applyMemberDecsOfKind(0, 0);
+		applyMemberDecsOfKind(8, 1);
+		applyMemberDecsOfKind(0, 1);
+		pushInitializers(protoInitializers);
+		pushInitializers(staticInitializers);
+		return ret;
+	}
+	function defineMetadata(Class) {
+		return defineProperty(Class, symbolMetadata, {
+			configurable: true,
+			enumerable: true,
+			value: metadata
+		});
+	}
+	if (parentClass !== void 0) metadata = parentClass[symbolMetadata];
+	metadata = create(metadata == null ? null : metadata);
+	_ = applyMemberDecs();
+	if (!hasClassDecs) defineMetadata(targetClass);
+	return {
+		e: _,
+		get c() {
+			var initializers = [];
+			return hasClassDecs && [defineMetadata(targetClass = applyDec(targetClass, [classDecs], classDecsHaveThis, targetClass.name, 5, initializers)), createRunInitializers(initializers, 1)];
+		}
+	};
+}
+function _identity(x) {
+	return x;
+}
+let _dec, _initClass;
+_dec = injectable([inject(CliLoggerPortToken)]);
+let _PresentTagSyncResultPresenter;
+new class extends _identity {
+	constructor() {
+		super(_PresentTagSyncResultPresenter), _initClass();
+	}
+	static [class PresentTagSyncResultPresenter {
+		logger;
+		static {
+			({c: [_PresentTagSyncResultPresenter, _initClass]} = _apply_decs_2311(this, [_dec], []));
+		}
+		constructor(logger) {
+			this.logger = logger;
+		}
+		present(result, rootDir) {
+			this.logger.out(this.formatTargetTable(result.selectedTargets, rootDir));
+			if (result.selectedTargets.length === 0) {
+				this.logger.err("No packages found in workspace. Check your pnpm-workspace.yaml or provide an explicit target path.");
+				return 1;
+			}
+			const warningsAndErrorsSection = this.formatWarningsAndErrors(result);
+			if (warningsAndErrorsSection) this.logger.err(warningsAndErrorsSection);
+			this.logger.out(this.formatSummary(result));
+			return exitCodeForTagSyncResult(result);
+		}
+		withColorizedLine(line, colorCode) {
+			return `${colorCode}${line}${_PresentTagSyncResultPresenter.colorReset}`;
+		}
+		warningsAndErrorsFromResult(result) {
+			const entries = [];
+			for (const targetResult of result.targetResults) if (targetResult.runError) entries.push(targetResult.runError);
+			if (result.hookError) entries.push(result.hookError);
+			return entries;
+		}
+		formatTargetTable(targets, rootDir) {
+			const packageColumnWidth = Math.max(7, ...targets.map((target) => (target.packageName ?? "-").length));
+			const pathColumnWidth = Math.max(4, ...targets.map((target) => target.rootRelativeTargetPath.length));
+			const lines = [];
+			lines.push(`[tag] Root: ${rootDir}`);
+			lines.push(`[tag] Resolved targets: ${targets.length}`);
+			lines.push("[tag] Targets:");
+			lines.push(`  ${"package".padEnd(packageColumnWidth)}   ${"path".padEnd(pathColumnWidth)}   source`);
+			lines.push(`  ${"-".repeat(packageColumnWidth)}   ${"-".repeat(pathColumnWidth)}   ${"-".repeat(6)}`);
+			for (const target of targets) lines.push(`  ${(target.packageName ?? "-").padEnd(packageColumnWidth)}   ${target.rootRelativeTargetPath.padEnd(pathColumnWidth)}   ${target.source}`);
+			return lines.join("\n");
+		}
+		formatWarningsAndErrors(result) {
+			const entries = this.warningsAndErrorsFromResult(result);
+			if (entries.length === 0) return null;
+			const lines = [this.withColorizedLine("⚠️ Warnings & Errors", _PresentTagSyncResultPresenter.colors.yellow)];
+			for (const entry of entries) lines.push(this.withColorizedLine(`- ${entry}`, _PresentTagSyncResultPresenter.colors.red));
+			return lines.join("\n");
+		}
+		formatSummary(result) {
+			const isDryRun = result.mode === "dry-run";
+			const summaryPrefix = isDryRun ? "[tag:dry-run]" : "[tag]";
+			const versionSuffix = result.versionSummary === "mixed" && result.distinctVersions.length > 0 ? ` [${result.distinctVersions.join(", ")}]` : "";
+			const summaryColor = result.targetResults.some((targetResult) => targetResult.runError !== null) || result.hookError !== null ? _PresentTagSyncResultPresenter.colors.red : isDryRun ? _PresentTagSyncResultPresenter.colors.yellow : _PresentTagSyncResultPresenter.colors.green;
+			const lines = [this.withColorizedLine(`${summaryPrefix} version=${result.versionSummary}${versionSuffix} files=${result.filesChanged}/${result.filesScanned} declarations=${result.taggedDeclarations}`, summaryColor)];
+			if (result.skippedPackages.length > 0) lines.push(`[tag] Skipped: ${result.skippedPackages.length} package(s)`);
+			return lines.join("\n");
+		}
+	}];
+	colorReset = "\x1B[0m";
+	colors = {
+		red: "\x1B[31m",
+		green: "\x1B[32m",
+		yellow: "\x1B[33m"
+	};
+}();
+//#endregion
+export { _PresentTagSyncResultPresenter as PresentTagSyncResultPresenter };

package/dist/{lib/tag/presentation → domains/tag/presentation/presenters}/tag-cli.schema.mjs

@@ -1,5 +1,5 @@
 import { z } from "zod";
-//#region src/lib/tag/presentation/tag-cli.schema.ts
+//#region src/domains/tag/presentation/presenters/tag-cli.schema.ts
 const tagSyncRunRequestSchema = z.object({
 	rootDir: z.string().min(1),
 	write: z.boolean(),

package/dist/domains/tag/tag.module.mjs

@@ -0,0 +1,28 @@
+import { createOptionalCliPortTelemetryActivation } from "../../shell/wiring/optional-cli-port-telemetry-activation.mjs";
+import { ShellInfrastructureModule } from "../../shell/shell.module.mjs";
+import { TagTargetResolverAdapter as _TagTargetResolverAdapter } from "./infrastructure/adapters/tag-target-resolver.adapter.mjs";
+import { TagSinceWriterAdapter as _TagSinceWriterAdapter } from "./infrastructure/adapters/tag-since-writer.adapter.mjs";
+import { TagVersionResolverAdapter as _TagVersionResolverAdapter } from "./infrastructure/adapters/tag-version-resolver.adapter.mjs";
+import { TagTargetPathResolverAdapter as _TagTargetPathResolverAdapter } from "./infrastructure/adapters/tag-target-path-resolver.adapter.mjs";
+import { PrepareTagSyncUseCaseToken, PresentTagSyncProgressPresenterToken, PresentTagSyncResultPresenterToken, RunTagSyncUseCaseToken, TagEligibleWorkspacePathsPortToken, TagSinceWriterPortToken, TagTargetPathResolverPortToken, TagTargetRunnerPortToken, TagVersionResolverPortToken } from "./composition/tokens.mjs";
+import { TagTargetRunnerAdapter as _TagTargetRunnerAdapter } from "./infrastructure/adapters/tag-target-runner.adapter.mjs";
+import { PrepareTagSyncUseCase as _PrepareTagSyncUseCase } from "./application/use-cases/prepare-tag-sync.use-case.mjs";
+import { RunTagSyncUseCase as _RunTagSyncUseCase } from "./application/use-cases/run-tag-sync.use-case.mjs";
+import { PresentTagSyncResultPresenter as _PresentTagSyncResultPresenter } from "./presentation/presenters/present-tag-sync-result.presenter.mjs";
+import { PresentTagSyncProgressPresenter as _PresentTagSyncProgressPresenter } from "./presentation/presenters/present-tag-sync-progress.presenter.mjs";
+import { Module } from "@codefast/di";
+//#region src/domains/tag/tag.module.ts
+const TagModule = Module.create("cli-tag", (moduleBuilder) => {
+	moduleBuilder.import(ShellInfrastructureModule);
+	moduleBuilder.bind(TagEligibleWorkspacePathsPortToken).to(_TagTargetResolverAdapter).singleton().onActivation(createOptionalCliPortTelemetryActivation(TagEligibleWorkspacePathsPortToken));
+	moduleBuilder.bind(TagSinceWriterPortToken).to(_TagSinceWriterAdapter).singleton().onActivation(createOptionalCliPortTelemetryActivation(TagSinceWriterPortToken));
+	moduleBuilder.bind(TagVersionResolverPortToken).to(_TagVersionResolverAdapter).singleton().onActivation(createOptionalCliPortTelemetryActivation(TagVersionResolverPortToken));
+	moduleBuilder.bind(TagTargetRunnerPortToken).to(_TagTargetRunnerAdapter).singleton().onActivation(createOptionalCliPortTelemetryActivation(TagTargetRunnerPortToken));
+	moduleBuilder.bind(TagTargetPathResolverPortToken).to(_TagTargetPathResolverAdapter).singleton().onActivation(createOptionalCliPortTelemetryActivation(TagTargetPathResolverPortToken));
+	moduleBuilder.bind(PrepareTagSyncUseCaseToken).to(_PrepareTagSyncUseCase).singleton();
+	moduleBuilder.bind(RunTagSyncUseCaseToken).to(_RunTagSyncUseCase).singleton();
+	moduleBuilder.bind(PresentTagSyncResultPresenterToken).to(_PresentTagSyncResultPresenter).singleton();
+	moduleBuilder.bind(PresentTagSyncProgressPresenterToken).to(_PresentTagSyncProgressPresenter).singleton();
+});
+//#endregion
+export { TagModule };

package/dist/program.mjs

@@ -1,4 +1,5 @@
-import { createCliRuntimeContainer, resolveCliCommands } from "./lib/bootstrap/composition-root.mjs";
+import { registerCliCommandTreesOnProgram } from "./bootstrap/register-cli-command-trees.mjs";
+import { createCliRuntimeContainer, resolveCliCommands } from "./bootstrap/composition-root.mjs";
 import process from "node:process";
 import { readFileSync } from "node:fs";
 import path from "node:path";
@@ -18,7 +19,7 @@ function readVersion() {
 function createProgram(commands) {
 	const program = new Command();
 	program.name("codefast").description("Codefast monorepo developer CLI").version(readVersion()).option("--no-color", "Disable ANSI color output").configureHelp({ sortSubcommands: true }).showHelpAfterError("(use --help for usage)");
-	for (const cliCommand of commands) cliCommand.register(program);
+	registerCliCommandTreesOnProgram(program, commands);
 	return program;
 }
 async function runCli(argv) {

package/dist/shell/application/cli-runtime.tokens.mjs

@@ -0,0 +1,18 @@
+import { token } from "@codefast/di";
+//#region src/shell/application/cli-runtime.tokens.ts
+const CliTelemetryPortToken = token("CliTelemetryPort");
+const CliFilesystemPortToken = token("FilesystemPort");
+const CliLoggerPortToken = token("CliLoggerPort");
+const CliPathPortToken = token("CliPathPort");
+const RepoRootResolverPortToken = token("RepoRootResolverPort");
+const TypeScriptSourceFileWalkerPortToken = token("TypeScriptSourceFileWalkerPort");
+const CliRuntimeToken = token("CliRuntimePort");
+const LoadCodefastConfigUseCaseToken = token("LoadCodefastConfigUseCase");
+const CliSchemaParsingToken = token("CliSchemaParsing");
+const GlobalCliOptionsParsePortToken = token("GlobalCliOptionsParsePort");
+const FormatAppErrorPortToken = token("FormatAppErrorPort");
+const CliVerboseDiagnosticsPortToken = token("CliVerboseDiagnosticsPort");
+const CliExecutorToken = token("CliExecutor");
+const WorkspacePackageLayoutPortToken = token("WorkspacePackageLayoutPort");
+//#endregion
+export { CliExecutorToken, CliFilesystemPortToken, CliLoggerPortToken, CliPathPortToken, CliRuntimeToken, CliSchemaParsingToken, CliTelemetryPortToken, CliVerboseDiagnosticsPortToken, FormatAppErrorPortToken, GlobalCliOptionsParsePortToken, LoadCodefastConfigUseCaseToken, RepoRootResolverPortToken, TypeScriptSourceFileWalkerPortToken, WorkspacePackageLayoutPortToken };

package/dist/shell/application/coordination/cli-executor.coordination.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/coordination/cli-schema-parsing.coordination.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/global-cli-options.model.mjs

@@ -0,0 +1,5 @@
+import { z } from "zod";
+//#region src/shell/application/global-cli-options.model.ts
+/** Commander global opts shape validated before mirror prelude (`color` from `--no-color`). */ const globalCliCommanderOptionsSchema = z.object({ color: z.boolean().optional() });
+//#endregion
+export { globalCliCommanderOptionsSchema };

package/dist/shell/application/ports/inbound/load-codefast-config.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/cli-fs.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/cli-logger.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/cli-path.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/cli-runtime.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/cli-telemetry.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/cli-verbose-diagnostics.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/format-app-error.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/global-cli-options-parse.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/repo-root-resolver.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/typescript-source-file-walker.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/outbound/workspace-package-layout.port.mjs

@@ -0,0 +1 @@
+export {};

package/dist/shell/application/ports/primary/command.port.mjs

@@ -0,0 +1 @@
+export {};