@codefast/cli 0.3.14-canary.1 → 0.3.14

package/dist/lib/mirror/{infra → adapters/secondary}/file-system-service.adapter.mjs

@@ -1,8 +1,9 @@
-import { isDirentList } from "./dirent-list.adapter.mjs";
-import { normalizePath } from "./path-normalizer.adapter.mjs";
+import { CliFsToken } from "../../../core/contracts/tokens.mjs";
+import { isDirentList } from "../../infrastructure/dirent-list.guard.mjs";
+import { normalizePath } from "../../domain/path-normalizer.value-object.mjs";
 import path from "node:path";
-import { injectable } from "@codefast/di";
-//#region src/lib/mirror/infra/file-system-service.adapter.ts
+import { inject, injectable } from "@codefast/di";
+//#region src/lib/mirror/adapters/secondary/file-system-service.adapter.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -216,15 +217,19 @@ let _dec, _initClass;
 function isKnownReadDirError(caughtError) {
 	return typeof caughtError === "object" && caughtError !== null && "code" in caughtError && (caughtError.code === "ENOENT" || caughtError.code === "EACCES");
 }
-_dec = injectable([]);
+_dec = injectable([inject(CliFsToken)]);
 let _FileSystemServiceAdapter;
 (class {
+	fs;
 	static {
 		({c: [_FileSystemServiceAdapter, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
-	async listRelativeFilesRecursively(fs, dirPath) {
+	constructor(fs) {
+		this.fs = fs;
+	}
+	async listRelativeFilesRecursively(dirPath) {
 		try {
-			const raw = await fs.readdir(dirPath, {
+			const raw = await this.fs.readdir(dirPath, {
 				recursive: true,
 				withFileTypes: true
 			});
@@ -238,9 +243,9 @@ let _FileSystemServiceAdapter;
 			throw caughtError;
 		}
 	}
-	async isDirectoryCssOnly(fs, distDir, dirPath) {
+	async isDirectoryCssOnly(distDir, dirPath) {
 		try {
-			const raw = await fs.readdir(path.join(distDir, dirPath), { withFileTypes: true });
+			const raw = await this.fs.readdir(path.join(distDir, dirPath), { withFileTypes: true });
 			if (!isDirentList(raw)) return false;
 			if (raw.length === 0) return true;
 			return raw.every((dirent) => dirent.isFile() && dirent.name.endsWith(".css"));

package/dist/lib/mirror/{infra → adapters/secondary}/mirror-sync-reporter.adapter.mjs

@@ -1,6 +1,7 @@
-import { configureMirrorColors, logPackageError, logPackageSuccess, logPrunedStaleExport, logSkippedWorkspacePackage, mirrorBanner, mirrorGlobWarning, mirrorNoPackages, mirrorProcessingMode, mirrorSummary, mirrorSummarySeparator } from "../presentation/reporter.presenter.mjs";
-import { injectable } from "@codefast/di";
-//#region src/lib/mirror/infra/mirror-sync-reporter.adapter.ts
+import { CliRuntimeToken } from "../../../core/contracts/tokens.mjs";
+import { configureMirrorColors, logPackageError, logPackageSuccess, logPrunedStaleExport, logSkippedWorkspacePackage, mirrorBanner, mirrorGlobWarning, mirrorNoPackages, mirrorProcessingMode, mirrorSummary, mirrorSummarySeparator } from "../../infrastructure/mirror-console-reporter.presenter.mjs";
+import { inject, injectable } from "@codefast/di";
+//#region src/lib/mirror/adapters/secondary/mirror-sync-reporter.adapter.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -211,13 +212,19 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 	};
 }
 let _dec, _initClass;
-_dec = injectable([]);
+_dec = injectable([inject(CliRuntimeToken)]);
 let _MirrorSyncReporterAdapter;
 (class {
+	runtime;
 	static {
 		({c: [_MirrorSyncReporterAdapter, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
-	configureMirrorColors = configureMirrorColors;
+	constructor(runtime) {
+		this.runtime = runtime;
+	}
+	configureMirrorColors(noColor) {
+		configureMirrorColors(noColor, this.runtime.isStdoutTty());
+	}
 	mirrorBanner = mirrorBanner;
 	mirrorProcessingMode = mirrorProcessingMode;
 	mirrorNoPackages = mirrorNoPackages;

package/dist/lib/mirror/{infra → adapters/secondary}/package-repository.adapter.mjs

@@ -1,6 +1,8 @@
-import { resolvePackageDisplayName, writePackageJsonExportsAtomic } from "./update-pkg.adapter.mjs";
-import { injectable } from "@codefast/di";
-//#region src/lib/mirror/infra/package-repository.adapter.ts
+import { CliFsToken } from "../../../core/contracts/tokens.mjs";
+import { resolvePackageDisplayName } from "../../domain/package-display-name.policy.mjs";
+import { writePackageJsonExportsAtomic } from "../../infrastructure/package-json-exports.repository.mjs";
+import { inject, injectable } from "@codefast/di";
+//#region src/lib/mirror/adapters/secondary/package-repository.adapter.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -211,17 +213,21 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 	};
 }
 let _dec, _initClass;
-_dec = injectable([]);
+_dec = injectable([inject(CliFsToken)]);
 let _PackageRepositoryAdapter;
 (class {
+	fs;
 	static {
 		({c: [_PackageRepositoryAdapter, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
+	constructor(fs) {
+		this.fs = fs;
+	}
 	resolvePackageDisplayName(packageJson, folderBasename) {
 		return resolvePackageDisplayName(packageJson, folderBasename);
 	}
-	writePackageJsonExportsAtomic(fs, packageJsonPath, mergeInput) {
-		return writePackageJsonExportsAtomic(fs, packageJsonPath, mergeInput);
+	writePackageJsonExportsAtomic(packageJsonPath, mergeInput) {
+		return writePackageJsonExportsAtomic(this.fs, packageJsonPath, mergeInput);
 	}
 	parsePackageJsonShape(rawPackageJson) {
 		if (rawPackageJson === null || typeof rawPackageJson !== "object" || Array.isArray(rawPackageJson)) throw new SyntaxError("package.json root must be a JSON object");

package/dist/lib/mirror/{application/services/sync-workspace-package.service.mjs → adapters/secondary/sync-workspace-package.adapter.mjs}

@@ -1,10 +1,10 @@
-import { CliFsToken, CliLoggerToken, CliPathToken } from "../../../core/operational/contracts/tokens.mjs";
-import { messageFromCaughtUnknown } from "../../../core/application/utils/caught-unknown-message.util.mjs";
+import { CliFsToken, CliLoggerToken, CliPathToken } from "../../../core/contracts/tokens.mjs";
+import { messageFromCaughtUnknown } from "../../../core/domain/caught-unknown-message.value-object.mjs";
 import { FileSystemServicePortToken, MirrorSyncReporterPortToken, PackageRepositoryPortToken } from "../../contracts/tokens.mjs";
 import { DIST_DIR, PACKAGE_JSON } from "../../domain/constants.domain.mjs";
-import { createPathTransform, generateExports } from "../use-cases/generate-mirror-exports.use-case.mjs";
-import { injectable } from "@codefast/di";
-//#region src/lib/mirror/application/services/sync-workspace-package.service.ts
+import { createPathTransform, generateExports } from "../../application/services/generate-mirror-exports.service.mjs";
+import { inject, injectable } from "@codefast/di";
+//#region src/lib/mirror/adapters/secondary/sync-workspace-package.adapter.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -215,23 +215,23 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 	};
 }
 let _dec, _initClass;
-function resolvePackageScopedConfig(configMap, pkgMeta) {
+function resolvePackageScopedConfig(configMap, packageMeta) {
 	if (!configMap) return;
-	return configMap[pkgMeta.packageName];
+	return configMap[packageMeta.packageName];
 }
-function isPackageSkipped(skipPackagesArray, pkgMeta) {
-	if (!skipPackagesArray) return false;
-	return skipPackagesArray.includes(pkgMeta.packageName);
+function isPackageSkipped(skipPackagesList, packageMeta) {
+	if (!skipPackagesList) return false;
+	return skipPackagesList.includes(packageMeta.packageName);
 }
 _dec = injectable([
-	CliFsToken,
-	CliPathToken,
-	PackageRepositoryPortToken,
-	FileSystemServicePortToken,
-	CliLoggerToken,
-	MirrorSyncReporterPortToken
+	inject(CliFsToken),
+	inject(CliPathToken),
+	inject(PackageRepositoryPortToken),
+	inject(FileSystemServicePortToken),
+	inject(CliLoggerToken),
+	inject(MirrorSyncReporterPortToken)
 ]);
-let _SyncWorkspacePackageServiceImpl;
+let _SyncWorkspacePackageAdapter;
 (class {
 	fs;
 	pathService;
@@ -240,7 +240,7 @@ let _SyncWorkspacePackageServiceImpl;
 	logger;
 	mirrorReporter;
 	static {
-		({c: [_SyncWorkspacePackageServiceImpl, _initClass]} = _apply_decs_2311(this, [_dec], []));
+		({c: [_SyncWorkspacePackageAdapter, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
 	constructor(fs, pathService, packageRepository, fileSystemService, logger, mirrorReporter) {
 		this.fs = fs;
@@ -277,16 +277,16 @@ let _SyncWorkspacePackageServiceImpl;
 		}
 		let packageJsonParseError;
 		try {
-			const pkgContent = await this.fs.readFile(packageJsonPath, "utf8");
-			const raw = JSON.parse(pkgContent);
-			const parsedPackageJson = this.packageRepository.parsePackageJsonShape(raw);
+			const packageContent = await this.fs.readFile(packageJsonPath, "utf8");
+			const rawPackageJson = JSON.parse(packageContent);
+			const parsedPackageJson = this.packageRepository.parsePackageJsonShape(rawPackageJson);
 			pkgStats.name = this.packageRepository.resolvePackageDisplayName(parsedPackageJson, folderBasename);
 		} catch (caughtError) {
 			pkgStats.name = folderBasename;
 			packageJsonParseError = caughtError;
 		}
-		const pkgMeta = { packageName: pkgStats.name };
-		if (isPackageSkipped(config.skipPackages, pkgMeta)) {
+		const packageMeta = { packageName: pkgStats.name };
+		if (isPackageSkipped(config.skipPackages, packageMeta)) {
 			pkgStats.skipped = true;
 			pkgStats.skipReason = "configured to skip";
 			stats.packagesSkipped++;
@@ -314,14 +314,14 @@ let _SyncWorkspacePackageServiceImpl;
 			return pkgStats;
 		}
 		try {
-			const pathTransform = createPathTransform(config, pkgMeta);
+			const pathTransform = createPathTransform(config, packageMeta);
 			pkgStats.hasTransform = !!pathTransform;
-			const cssConfig = resolvePackageScopedConfig(config.cssExports, pkgMeta);
+			const cssConfig = resolvePackageScopedConfig(config.cssExports, packageMeta);
 			if (cssConfig === false) pkgStats.cssConfigStatus = "disabled";
 			else if (cssConfig !== void 0) pkgStats.cssConfigStatus = "configured";
-			const customExports = resolvePackageScopedConfig(config.customExports, pkgMeta) || {};
-			const generatedExports = await generateExports(this.fs, this.pathService, this.fileSystemService, distDir, pathTransform, cssConfig, customExports);
-			const { prunedKeys } = await this.packageRepository.writePackageJsonExportsAtomic(this.fs, packageJsonPath, {
+			const customExports = resolvePackageScopedConfig(config.customExports, packageMeta) || {};
+			const generatedExports = await generateExports(this.pathService, this.fileSystemService, distDir, pathTransform, cssConfig, customExports);
+			const { prunedKeys } = await this.packageRepository.writePackageJsonExportsAtomic(packageJsonPath, {
 				generatedExports: generatedExports.exports,
 				managedExportSpecifiers: Object.keys(generatedExports.exports),
 				originalPathBySpecifier: generatedExports.originalPathBySpecifier
@@ -348,4 +348,4 @@ let _SyncWorkspacePackageServiceImpl;
 	}
 });
 //#endregion
-export { _SyncWorkspacePackageServiceImpl as SyncWorkspacePackageServiceImpl };
+export { _SyncWorkspacePackageAdapter as SyncWorkspacePackageAdapter };

package/dist/lib/mirror/{infra → adapters/secondary}/workspace-service.adapter.mjs

@@ -1,7 +1,8 @@
-import { resolvePackageFilterUnderRoot } from "./package-filter.adapter.mjs";
-import { findWorkspacePackageRelPaths } from "./workspace-packages.adapter.mjs";
-import { injectable } from "@codefast/di";
-//#region src/lib/mirror/infra/workspace-service.adapter.ts
+import { CliFsToken } from "../../../core/contracts/tokens.mjs";
+import { resolvePackageFilterUnderRoot } from "../../infrastructure/package-filter-resolver.service.mjs";
+import { findWorkspacePackageRelPaths } from "../../infrastructure/workspace-packages.service.mjs";
+import { inject, injectable } from "@codefast/di";
+//#region src/lib/mirror/adapters/secondary/workspace-service.adapter.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -212,17 +213,21 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 	};
 }
 let _dec, _initClass;
-_dec = injectable([]);
+_dec = injectable([inject(CliFsToken)]);
 let _WorkspaceServiceAdapter;
 (class {
+	fs;
 	static {
 		({c: [_WorkspaceServiceAdapter, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
+	constructor(fs) {
+		this.fs = fs;
+	}
 	resolvePackageFilterUnderRoot(rootDir, packageFilter) {
 		return resolvePackageFilterUnderRoot(rootDir, packageFilter);
 	}
-	findWorkspacePackageRelPaths(rootDir, fs, onGlobWarning) {
-		return findWorkspacePackageRelPaths(rootDir, fs, onGlobWarning);
+	findWorkspacePackageRelPaths(rootDir, onGlobWarning) {
+		return findWorkspacePackageRelPaths(rootDir, this.fs, onGlobWarning);
 	}
 	static {
 		_initClass();

package/dist/lib/mirror/application/{use-cases/generate-mirror-exports.use-case.mjs → services/generate-mirror-exports.service.mjs}

@@ -1,5 +1,5 @@
 import { PACKAGE_JSON_EXPORT, VALID_DTS_EXTENSIONS, VALID_JS_EXTENSIONS } from "../../domain/constants.domain.mjs";
-//#region src/lib/mirror/application/use-cases/generate-mirror-exports.use-case.ts
+//#region src/lib/mirror/application/services/generate-mirror-exports.service.ts
 function resolvePackageScopedConfig(configMap, pkgMeta) {
 	if (!configMap) return;
 	return configMap[pkgMeta.packageName];
@@ -131,11 +131,11 @@ function compareTuples(left, right) {
 	if (left[3] !== right[3]) return left[3] < right[3] ? -1 : 1;
 	return 0;
 }
-async function generateCssExports(fs, pathService, fileSystemService, distDir, cssConfig) {
+async function generateCssExports(pathService, fileSystemService, distDir, cssConfig) {
 	if (cssConfig === false) return {};
 	if (cssConfig === true) cssConfig = { enabled: true };
 	if (!cssConfig || cssConfig.enabled === false) return {};
-	const cssFiles = (await fileSystemService.listRelativeFilesRecursively(fs, distDir)).filter((relativeDistPath) => relativeDistPath.endsWith(".css"));
+	const cssFiles = (await fileSystemService.listRelativeFilesRecursively(distDir)).filter((relativeDistPath) => relativeDistPath.endsWith(".css"));
 	if (!cssFiles.length) return {};
 	const cssExports = { ...cssConfig.customExports };
 	const cssByDir = /* @__PURE__ */ new Map();
@@ -153,7 +153,7 @@ async function generateCssExports(fs, pathService, fileSystemService, distDir, c
 		const exportPath = `./${file}`;
 		if (!(exportPath in cssExports)) cssExports[exportPath] = `./dist/${file}`;
 	}
-	for (const [dirName, dirFiles] of cssByDir.entries()) if (await fileSystemService.isDirectoryCssOnly(fs, distDir, dirName) && !cssConfig.forceExportFiles) {
+	for (const [dirName, dirFiles] of cssByDir.entries()) if (await fileSystemService.isDirectoryCssOnly(distDir, dirName) && !cssConfig.forceExportFiles) {
 		const wildcardExport = `./${dirName}/*`;
 		if (!(wildcardExport in cssExports)) cssExports[wildcardExport] = `./dist/${dirName}/*`;
 	} else for (const file of dirFiles) {
@@ -164,8 +164,8 @@ async function generateCssExports(fs, pathService, fileSystemService, distDir, c
 }
 /**
 * Compute `package.json#exports` from a built `dist/` tree. No logging; no writes.
-*/ async function generateExports(fs, pathService, fileSystemService, distDir, pathTransform, cssConfig, customExports) {
-	const files = await fileSystemService.listRelativeFilesRecursively(fs, distDir);
+*/ async function generateExports(pathService, fileSystemService, distDir, pathTransform, cssConfig, customExports) {
+	const files = await fileSystemService.listRelativeFilesRecursively(distDir);
 	if (!files.length) return {
 		exports: { [PACKAGE_JSON_EXPORT]: PACKAGE_JSON_EXPORT },
 		originalPathBySpecifier: { [PACKAGE_JSON_EXPORT]: PACKAGE_JSON_EXPORT },
@@ -198,7 +198,7 @@ async function generateCssExports(fs, pathService, fileSystemService, distDir, c
 	let sortedKeys = Object.keys(exportsObj).sort((pathA, pathB) => compareTuples(getSortTuple(pathA, pathTransform), getSortTuple(pathB, pathTransform)));
 	const sortedExports = {};
 	for (const exportKey of sortedKeys) sortedExports[exportKey] = exportsObj[exportKey];
-	const cssExports = await generateCssExports(fs, pathService, fileSystemService, distDir, cssConfig ?? { enabled: true });
+	const cssExports = await generateCssExports(pathService, fileSystemService, distDir, cssConfig ?? { enabled: true });
 	Object.assign(sortedExports, cssExports);
 	for (const [specifier, mappedPath] of Object.entries(customExports || {})) if (specifier !== "./package.json") sortedExports[specifier] = mappedPath;
 	for (const cssSpecifier of Object.keys(cssExports)) if (!(cssSpecifier in originalPathBySpecifier)) originalPathBySpecifier[cssSpecifier] = cssSpecifier;

package/dist/lib/mirror/{presentation/resolve-mirror-package-arg.presenter.mjs → application/services/mirror-package-arg-resolver.service.mjs}

@@ -1,7 +1,7 @@
-import { appError } from "../../core/domain/errors.domain.mjs";
-import { err, ok } from "../../core/domain/result.model.mjs";
+import { AppError } from "../../../core/domain/errors.domain.mjs";
+import { err, ok } from "../../../core/domain/result.model.mjs";
 import path from "node:path";
-//#region src/lib/mirror/presentation/resolve-mirror-package-arg.presenter.ts
+//#region src/lib/mirror/application/services/mirror-package-arg-resolver.service.ts
 function normalizePathSegments(relPath) {
 	return relPath.split(path.sep).join("/").replace(/\\/g, "/");
 }
@@ -13,7 +13,7 @@ function resolveMirrorPackageArgToRelative(input) {
 	const resolved = path.isAbsolute(packageArg) ? path.resolve(packageArg) : path.resolve(cwdReal, packageArg);
 	const targetReal = fs.canonicalPathSync(resolved);
 	const normalized = normalizePathSegments(path.relative(rootReal, targetReal));
-	if (normalized.startsWith("..") || path.isAbsolute(normalized) || normalized === "" || normalized === ".") return err(appError("VALIDATION_ERROR", `Package path must be a subdirectory under monorepo root: ${rootDir}`));
+	if (normalized.startsWith("..") || path.isAbsolute(normalized) || normalized === "" || normalized === ".") return err(new AppError("VALIDATION_ERROR", `Package path must be a subdirectory under monorepo root: ${rootDir}`));
 	return ok(normalized);
 }
 //#endregion

package/dist/lib/mirror/{presentation/prepare-mirror.orchestrator.mjs → application/use-cases/prepare-mirror-sync.use-case.mjs}

@@ -1,13 +1,10 @@
-import { CliFsToken } from "../../core/operational/contracts/tokens.mjs";
-import { appError } from "../../core/domain/errors.domain.mjs";
-import { err, ok } from "../../core/domain/result.model.mjs";
-import { messageFromCaughtUnknown } from "../../core/application/utils/caught-unknown-message.util.mjs";
-import { findRepoRoot } from "../../infra/workspace/repo-root.adapter.mjs";
-import { TryLoadCodefastConfigPresenterToken } from "../../core/contracts/tokens.mjs";
-import { parseGlobalCliOptions } from "../../core/presentation/global-cli-options.presenter.mjs";
-import { resolveMirrorPackageArgToRelative } from "./resolve-mirror-package-arg.presenter.mjs";
+import { CliFsToken, LoadCodefastConfigUseCaseToken, RepoRootResolverPortToken } from "../../../core/contracts/tokens.mjs";
+import { AppError } from "../../../core/domain/errors.domain.mjs";
+import { err, ok } from "../../../core/domain/result.model.mjs";
+import { messageFromCaughtUnknown } from "../../../core/domain/caught-unknown-message.value-object.mjs";
+import { resolveMirrorPackageArgToRelative } from "../services/mirror-package-arg-resolver.service.mjs";
 import { inject, injectable } from "@codefast/di";
-//#region src/lib/mirror/presentation/prepare-mirror.orchestrator.ts
+//#region src/lib/mirror/application/use-cases/prepare-mirror-sync.use-case.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
 	var prim = input[Symbol.toPrimitive];
@@ -218,26 +215,30 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 	};
 }
 let _dec, _initClass;
-_dec = injectable([inject(CliFsToken), inject(TryLoadCodefastConfigPresenterToken)]);
-let _PrepareMirrorOrchestrator;
+_dec = injectable([
+	inject(CliFsToken),
+	inject(RepoRootResolverPortToken),
+	inject(LoadCodefastConfigUseCaseToken)
+]);
+let _PrepareMirrorSyncUseCaseImpl;
 (class {
 	fs;
-	tryLoadCodefastConfig;
+	repoRootResolver;
+	loadCodefastConfig;
 	static {
-		({c: [_PrepareMirrorOrchestrator, _initClass]} = _apply_decs_2311(this, [_dec], []));
+		({c: [_PrepareMirrorSyncUseCaseImpl, _initClass]} = _apply_decs_2311(this, [_dec], []));
 	}
-	constructor(fs, tryLoadCodefastConfig) {
+	constructor(fs, repoRootResolver, loadCodefastConfig) {
 		this.fs = fs;
-		this.tryLoadCodefastConfig = tryLoadCodefastConfig;
+		this.repoRootResolver = repoRootResolver;
+		this.loadCodefastConfig = loadCodefastConfig;
 	}
 	async execute(args) {
-		const globalsOutcome = parseGlobalCliOptions(args.globalCliRaw);
-		if (!globalsOutcome.ok) return globalsOutcome;
 		let rootDir;
 		try {
-			rootDir = findRepoRoot(this.fs, args.currentWorkingDirectory);
+			rootDir = this.repoRootResolver.findRepoRoot(args.currentWorkingDirectory);
 		} catch (caughtError) {
-			return err(appError("INFRA_FAILURE", messageFromCaughtUnknown(caughtError), caughtError));
+			return err(new AppError("INFRA_FAILURE", messageFromCaughtUnknown(caughtError), caughtError));
 		}
 		const filterOutcome = resolveMirrorPackageArgToRelative({
 			fs: this.fs,
@@ -246,10 +247,10 @@ let _PrepareMirrorOrchestrator;
 			currentWorkingDirectory: args.currentWorkingDirectory
 		});
 		if (!filterOutcome.ok) return filterOutcome;
-		const loadedOutcome = await this.tryLoadCodefastConfig.execute(rootDir);
+		const loadedOutcome = await this.loadCodefastConfig.execute(rootDir);
 		if (!loadedOutcome.ok) return loadedOutcome;
 		return ok({
-			globals: globalsOutcome.value,
+			globals: args.globals,
 			rootDir,
 			config: loadedOutcome.value.config,
 			packageFilter: filterOutcome.value
@@ -260,4 +261,4 @@ let _PrepareMirrorOrchestrator;
 	}
 });
 //#endregion
-export { _PrepareMirrorOrchestrator as PrepareMirrorOrchestrator };
+export { _PrepareMirrorSyncUseCaseImpl as PrepareMirrorSyncUseCaseImpl };

package/dist/lib/mirror/application/use-cases/run-mirror-sync.use-case.mjs

@@ -1,10 +1,10 @@
-import { CliFsToken, CliLoggerToken } from "../../../core/operational/contracts/tokens.mjs";
-import { appError } from "../../../core/domain/errors.domain.mjs";
+import { CliFsToken, CliLoggerToken } from "../../../core/contracts/tokens.mjs";
+import { AppError } from "../../../core/domain/errors.domain.mjs";
 import { err, ok } from "../../../core/domain/result.model.mjs";
-import { messageFromCaughtUnknown } from "../../../core/application/utils/caught-unknown-message.util.mjs";
-import { MirrorSyncReporterPortToken, SyncWorkspacePackageServiceToken, WorkspaceServicePortToken } from "../../contracts/tokens.mjs";
+import { messageFromCaughtUnknown } from "../../../core/domain/caught-unknown-message.value-object.mjs";
+import { MirrorSyncReporterPortToken, SyncWorkspacePackagePortToken, WorkspaceServicePortToken } from "../../contracts/tokens.mjs";
 import { formatMirrorSyncJsonOutput } from "../mirror-sync-json.format.mjs";
-import { injectable } from "@codefast/di";
+import { inject, injectable } from "@codefast/di";
 //#region src/lib/mirror/application/use-cases/run-mirror-sync.use-case.ts
 function toPrimitive(input, hint) {
 	if (typeof input !== "object" || input === null) return input;
@@ -217,11 +217,11 @@ function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis,
 }
 let _dec, _initClass;
 _dec = injectable([
-	CliFsToken,
-	CliLoggerToken,
-	WorkspaceServicePortToken,
-	MirrorSyncReporterPortToken,
-	SyncWorkspacePackageServiceToken
+	inject(CliFsToken),
+	inject(CliLoggerToken),
+	inject(WorkspaceServicePortToken),
+	inject(MirrorSyncReporterPortToken),
+	inject(SyncWorkspacePackagePortToken)
 ]);
 let _RunMirrorSyncUseCaseImpl;
 (class {
@@ -265,7 +265,7 @@ let _RunMirrorSyncUseCaseImpl;
 				targetPackages = [this.workspaceService.resolvePackageFilterUnderRoot(request.rootDir, request.packageFilter)];
 				if (!json) this.mirrorReporter.mirrorProcessingMode(this.logger, { kind: "single" });
 			} else {
-				const { relPaths, multiSource } = await this.workspaceService.findWorkspacePackageRelPaths(request.rootDir, this.fs, json ? () => {} : (message) => this.mirrorReporter.logWorkspaceGlobWarning(this.logger, message));
+				const { relPaths, multiSource } = await this.workspaceService.findWorkspacePackageRelPaths(request.rootDir, json ? () => {} : (message) => this.mirrorReporter.logWorkspaceGlobWarning(this.logger, message));
 				targetPackages = relPaths;
 				if (!json) this.mirrorReporter.mirrorProcessingMode(this.logger, {
 					kind: "multi",
@@ -291,7 +291,7 @@ let _RunMirrorSyncUseCaseImpl;
 			} else this.logger.out(formatMirrorSyncJsonOutput(stats, elapsed));
 			return ok(stats);
 		} catch (caughtError) {
-			return err(appError("INFRA_FAILURE", messageFromCaughtUnknown(caughtError), caughtError));
+			return err(new AppError("INFRA_FAILURE", messageFromCaughtUnknown(caughtError), caughtError));
 		}
 	}
 	static {

package/dist/lib/mirror/contracts/tokens.mjs

@@ -4,8 +4,8 @@ const WorkspaceServicePortToken = token("WorkspaceServicePort");
 const PackageRepositoryPortToken = token("PackageRepositoryPort");
 const FileSystemServicePortToken = token("FileSystemServicePort");
 const MirrorSyncReporterPortToken = token("MirrorSyncReporterPort");
-const SyncWorkspacePackageServiceToken = token("SyncWorkspacePackageService");
+const SyncWorkspacePackagePortToken = token("SyncWorkspacePackagePort");
 const RunMirrorSyncUseCaseToken = token("RunMirrorSyncUseCase");
-const PrepareMirrorOrchestratorToken = token("PrepareMirrorOrchestrator");
+const PrepareMirrorSyncUseCaseToken = token("PrepareMirrorSyncUseCase");
 //#endregion
-export { FileSystemServicePortToken, MirrorSyncReporterPortToken, PackageRepositoryPortToken, PrepareMirrorOrchestratorToken, RunMirrorSyncUseCaseToken, SyncWorkspacePackageServiceToken, WorkspaceServicePortToken };
+export { FileSystemServicePortToken, MirrorSyncReporterPortToken, PackageRepositoryPortToken, PrepareMirrorSyncUseCaseToken, RunMirrorSyncUseCaseToken, SyncWorkspacePackagePortToken, WorkspaceServicePortToken };

package/dist/lib/mirror/domain/package-display-name.policy.mjs

@@ -0,0 +1,9 @@
+//#region src/lib/mirror/domain/package-display-name.policy.ts
+/**
+* Domain rule: prefer `package.json#name` when it is present, otherwise use folder basename.
+*/ function resolvePackageDisplayName(packageJson, folderBasename) {
+	const declaredName = packageJson.name;
+	return typeof declaredName === "string" && declaredName.length > 0 ? declaredName : folderBasename;
+}
+//#endregion
+export { resolvePackageDisplayName };

package/dist/lib/mirror/{infra/path-normalizer.adapter.mjs → domain/path-normalizer.value-object.mjs}

@@ -1,5 +1,5 @@
 import path from "node:path";
-//#region src/lib/mirror/infra/path-normalizer.adapter.ts
+//#region src/lib/mirror/domain/path-normalizer.value-object.ts
 function normalizePath(pathString) {
 	return pathString.split(path.sep).join("/").replace(/\\/g, "/");
 }

package/dist/lib/mirror/{infra/dirent-list.adapter.mjs → infrastructure/dirent-list.guard.mjs}

@@ -1,4 +1,4 @@
-//#region src/lib/mirror/infra/dirent-list.adapter.ts
+//#region src/lib/mirror/infrastructure/dirent-list.guard.ts
 /**
 * Narrow `fs.promises.readdir` overload result to `Dirent[]` when `withFileTypes: true`.
 * Accepts both historical checks (`isFile` / `isDirectory`) in one guard.

package/dist/lib/mirror/infrastructure/mirror-console-reporter.presenter.mjs

@@ -0,0 +1,99 @@
+import { messageFromCaughtUnknown } from "../../core/domain/caught-unknown-message.value-object.mjs";
+//#region src/lib/mirror/infrastructure/mirror-console-reporter.presenter.ts
+const COLORS = {
+	reset: "\x1B[0m",
+	bold: "\x1B[1m",
+	dim: "\x1B[2m",
+	green: "\x1B[32m",
+	yellow: "\x1B[33m",
+	cyan: "\x1B[36m",
+	gray: "\x1B[90m",
+	magenta: "\x1B[35m",
+	brightGreen: "\x1B[92m",
+	brightCyan: "\x1B[96m"
+};
+let colorsEnabled = true;
+function color(value, code) {
+	if (!colorsEnabled) return value;
+	return `${code}${value}${COLORS.reset}`;
+}
+function configureMirrorColors(noColor, isStdoutTty) {
+	colorsEnabled = isStdoutTty && !noColor;
+}
+function mirrorBanner(logger) {
+	logger.out(`\n${color("📦 Mirror — package exports", COLORS.bold + COLORS.cyan)}`);
+	logger.out(`${color("═".repeat(60), COLORS.dim)}\n`);
+}
+function mirrorProcessingMode(logger, mode) {
+	if (mode.kind === "single") {
+		logger.out(`${color("Processing single package...", COLORS.dim)}\n`);
+		return;
+	}
+	if (mode.source === "default-patterns") {
+		logger.out(`${color("Discovering workspace packages using default patterns (packages/*)…", COLORS.dim)}\n`);
+		return;
+	}
+	if (mode.source === "pnpm-workspace-yaml") {
+		logger.out(`${color("Discovering workspace packages from pnpm-workspace.yaml…", COLORS.dim)}\n`);
+		return;
+	}
+	logger.out(`${color("pnpm-workspace.yaml declares an empty workspace package list.", COLORS.dim)}\n`);
+}
+function mirrorNoPackages(logger) {
+	logger.out(color("⚠ No packages found", COLORS.yellow));
+}
+function mirrorGlobWarning(logger, message) {
+	logger.out(color(`⚠ ${message}`, COLORS.yellow));
+}
+function logSkippedWorkspacePackage(logger, index, total, displayName, reason) {
+	const progress = color(`[${index}/${total}]`, COLORS.dim);
+	logger.out(`${progress} ${color("○", COLORS.gray)} ${color(displayName, COLORS.dim)}`);
+	logger.out(`  ${color("└─", COLORS.dim)} ${color(`Skipped: ${reason}`, COLORS.gray)}`);
+	logger.out("");
+}
+function logPackageSuccess(logger, index, total, packageStats, generatedDistAssetCounts, verbose) {
+	const progress = color(`[${index}/${total}]`, COLORS.dim);
+	logger.out(`${progress} ${color("✓", COLORS.brightGreen)} ${color(packageStats.name, COLORS.bold)}`);
+	if (verbose) {
+		logger.out(`  ${color("├─", COLORS.dim)} Path: ${packageStats.path}`);
+		if (packageStats.hasTransform) logger.out(`  ${color("├─", COLORS.dim)} ${color("Custom path transformation", COLORS.cyan)}`);
+		if (packageStats.cssConfigStatus) {
+			const status = packageStats.cssConfigStatus === "disabled" ? "CSS disabled" : "CSS configured";
+			logger.out(`  ${color("├─", COLORS.dim)} ${color(status, COLORS.cyan)}`);
+		}
+	}
+	const breakdown = [];
+	if (generatedDistAssetCounts.jsCount > 0) breakdown.push(color(`${generatedDistAssetCounts.jsCount} modules`, COLORS.green));
+	if (generatedDistAssetCounts.cssCount > 0) breakdown.push(color(`${generatedDistAssetCounts.cssCount} CSS`, COLORS.magenta));
+	if (packageStats.customExports > 0) breakdown.push(color(`${packageStats.customExports} custom`, COLORS.yellow));
+	const totalExportsText = color(`${packageStats.totalExports} exports`, COLORS.brightCyan);
+	if (breakdown.length === 0) logger.out(`  ${color("└─", COLORS.dim)} ${totalExportsText}`);
+	else logger.out(`  ${color("└─", COLORS.dim)} ${breakdown.join(" + ")} = ${totalExportsText}`);
+	logger.out("");
+}
+function logPrunedStaleExport(logger, exportSpecifier) {
+	logger.out(`  ${color("└─", COLORS.dim)} ${color(`Pruned stale export: ${exportSpecifier}`, COLORS.gray)}`);
+}
+function logPackageError(logger, index, total, displayName, errorValue, verbose) {
+	logger.out(`${color(`[${index}/${total}]`, COLORS.dim)} ${color("✗", COLORS.yellow)} ${color(displayName, COLORS.bold)}`);
+	logger.out(`  ${color("└─", COLORS.dim)} ${color(`Error: ${messageFromCaughtUnknown(errorValue)}`, COLORS.yellow)}\n`);
+	if (verbose) logger.err(errorValue instanceof Error && errorValue.stack ? errorValue.stack : messageFromCaughtUnknown(errorValue));
+}
+function mirrorSummarySeparator(logger) {
+	logger.out(color("═".repeat(60), COLORS.dim));
+}
+function mirrorSummary(logger, stats, elapsedSeconds) {
+	logger.out(`${color("📊 Summary", COLORS.bold)} ${color(`(completed in ${elapsedSeconds.toFixed(2)}s)`, COLORS.dim)}\n`);
+	logger.out(`  ${color("Packages:", COLORS.bold)}`);
+	logger.out(`  ${color("├─", COLORS.dim)} Processed: ${color(String(stats.packagesProcessed), COLORS.green)}`);
+	if (stats.packagesSkipped > 0) logger.out(`  ${color("├─", COLORS.dim)} Skipped: ${color(String(stats.packagesSkipped), COLORS.gray)}`);
+	if (stats.packagesErrored > 0) logger.out(`  ${color("├─", COLORS.dim)} Errors: ${color(String(stats.packagesErrored), COLORS.yellow)}`);
+	logger.out(`  ${color("└─", COLORS.dim)} Total found: ${stats.packagesFound}\n`);
+	logger.out(`  ${color("Exports:", COLORS.bold)}`);
+	logger.out(`  ${color("├─", COLORS.dim)} JS Modules: ${color(String(stats.totalJsModules), COLORS.cyan)}`);
+	logger.out(`  ${color("├─", COLORS.dim)} CSS Files: ${color(String(stats.totalCssExports), COLORS.magenta)}`);
+	logger.out(`  ${color("└─", COLORS.dim)} Total: ${color(String(stats.totalExports), COLORS.brightCyan)}\n`);
+	logger.out(`${color("═".repeat(60), COLORS.dim)}\n`);
+}
+//#endregion
+export { configureMirrorColors, logPackageError, logPackageSuccess, logPrunedStaleExport, logSkippedWorkspacePackage, mirrorBanner, mirrorGlobWarning, mirrorNoPackages, mirrorProcessingMode, mirrorSummary, mirrorSummarySeparator };

package/dist/lib/mirror/{infra/package-filter.adapter.mjs → infrastructure/package-filter-resolver.service.mjs}

@@ -1,7 +1,7 @@
-import { normalizePath } from "./path-normalizer.adapter.mjs";
+import { normalizePath } from "../domain/path-normalizer.value-object.mjs";
 import { realpathSync } from "node:fs";
 import path from "node:path";
-//#region src/lib/mirror/infra/package-filter.adapter.ts
+//#region src/lib/mirror/infrastructure/package-filter-resolver.service.ts
 function tryRealpath(entryPath) {
 	try {
 		return realpathSync.native(entryPath);