@codefast/cli 0.10.0 → 0.12.0

package/dist/core/workspace/markdown-walk.js

@@ -1,4 +1,4 @@
-import { walkFiles } from "#/core/workspace/walk-files";
+import { walkFiles } from "#core/workspace/walk-files";
 /**
  * Every markdown file under a root, skipping build output and vendored trees.
  *

package/dist/core/workspace/package-version.d.ts

@@ -1,9 +1,9 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * Finds the `version` of the nearest enclosing `package.json`, or null when the first
  * one found declares none (the private workspace root is version-less by design).
  *
  * @since 0.8.0
  */
-declare function findNearestPackageVersion(fs: FilesystemPort, targetPath: string): string | null;
+declare function findNearestPackageVersion(fs: Filesystem, targetPath: string): string | null;
 export { findNearestPackageVersion };

package/dist/core/workspace/package-version.js

@@ -1,6 +1,6 @@
 import path from "node:path";
-import { findNearestAncestor } from "#/core/workspace/ancestor-directories";
-import { packageJsonFileName } from "#/core/workspace/well-known-files";
+import { findNearestAncestor } from "#core/workspace/ancestor-directories";
+import { packageJsonFileName } from "#core/workspace/well-known-files";
 /**
  * Finds the `version` of the nearest enclosing `package.json`, or null when the first
  * one found declares none (the private workspace root is version-less by design).

package/dist/core/workspace/resolver.d.ts

@@ -1,4 +1,4 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * A resolved project root and whether it is a pnpm workspace or a standalone single package.
  *
@@ -13,7 +13,7 @@ export type ResolvedProjectRoot = {
  *
  * @since 0.10.0
  */
-export declare function resolveProjectRoot(fromDirectory: string, fs: FilesystemPort): ResolvedProjectRoot;
+export declare function resolveProjectRoot(fromDirectory: string, fs: Filesystem): ResolvedProjectRoot;
 /**
  * Where the workspace package patterns came from.
  *
@@ -35,5 +35,5 @@ export type WorkspacePackageLayoutOutcome = {
  *
  * @since 0.3.16-canary.0
  */
-export declare function listWorkspacePackageDirectories(rootDirectoryPathAbsolute: string, fs: FilesystemPort, suppressGlobPermissionDiagnostics?: boolean): Promise<WorkspacePackageLayoutOutcome>;
+export declare function listWorkspacePackageDirectories(rootDirectoryPathAbsolute: string, fs: Filesystem, suppressGlobPermissionDiagnostics?: boolean): Promise<WorkspacePackageLayoutOutcome>;
 export {};

package/dist/core/workspace/resolver.js

@@ -1,10 +1,10 @@
 import path from "node:path";
 import { parse as parseYaml } from "yaml";
-import { messageFrom } from "#/core/errors";
-import { createAnyGlobMatcher } from "#/core/glob";
-import { logger } from "#/core/logger";
-import { findNearestAncestor } from "#/core/workspace/ancestor-directories";
-import { packageJsonFileName, workspaceYamlFileName } from "#/core/workspace/well-known-files";
+import { messageFrom } from "#core/errors";
+import { createAnyGlobMatcher } from "#core/glob";
+import { logger } from "#core/logger";
+import { findNearestAncestor } from "#core/workspace/ancestor-directories";
+import { packageJsonFileName, workspaceYamlFileName } from "#core/workspace/well-known-files";
 /**
  * Resolves the project root: the `pnpm-workspace.yaml` directory, or the nearest `package.json` for a single package.
  *

package/dist/core/workspace/source-walk.d.ts

@@ -1,4 +1,4 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * Every hand-written source file a comment convention applies to — `.ts`, `.tsx`, `.css`, and ignore files.
  *
@@ -7,7 +7,7 @@ import type { FilesystemPort } from "#/core/filesystem/port";
  *
  * @since 0.6.0
  */
-export declare function walkSourceFiles(rootDirectoryPath: string, fs: FilesystemPort): Array<string>;
+export declare function walkSourceFiles(rootDirectoryPath: string, fs: Filesystem): Array<string>;
 /**
  * Which comment syntax a path is written in, or `null` when the convention does not cover it.
  *

package/dist/core/workspace/source-walk.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { walkFiles } from "#/core/workspace/walk-files";
+import { walkFiles } from "#core/workspace/walk-files";
 // Ignore files carry the divider convention over `#` comments — the content rules stay code-only.
 const ignoreFileNames = new Set([
     ".gitignore",

package/dist/core/workspace/typescript-walk.d.ts

@@ -1,7 +1,7 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * Recursively collects the `.ts`/`.tsx` file paths under a root, skipping `.d.ts` and skip-listed directories.
  *
  * @since 0.3.16-canary.0
  */
-export declare function walkTsxFiles(rootDirectoryPath: string, fs: FilesystemPort): Array<string>;
+export declare function walkTsxFiles(rootDirectoryPath: string, fs: Filesystem): Array<string>;

package/dist/core/workspace/typescript-walk.js

@@ -1,4 +1,4 @@
-import { walkFiles } from "#/core/workspace/walk-files";
+import { walkFiles } from "#core/workspace/walk-files";
 /**
  * Recursively collects the `.ts`/`.tsx` file paths under a root, skipping `.d.ts` and skip-listed directories.
  *

package/dist/core/workspace/walk-files.d.ts

@@ -1,7 +1,7 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * Every file under a root the predicate accepts, skipping build output and vendored trees.
  *
  * @since 0.10.0
  */
-export declare function walkFiles(rootDirectoryPath: string, fs: FilesystemPort, shouldInclude: (filePath: string) => boolean): Array<string>;
+export declare function walkFiles(rootDirectoryPath: string, fs: Filesystem, shouldInclude: (filePath: string) => boolean): Array<string>;

package/dist/core/workspace/walk-files.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { defaultSkipDirectoryNames } from "#/core/workspace/skip-directories";
+import { defaultSkipDirectoryNames } from "#core/workspace/skip-directories";
 /**
  * Every file under a root the predicate accepts, skipping build output and vendored trees.
  *

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * The `@codefast/cli` public API: run the CLI in-process, and author a typed `codefast.config.*`.
  */
-export { runCli } from "#/cli";
-export { defineConfig } from "#/core/config/define-config";
-export type { CodefastAfterWriteHook, CodefastArrangeConfig, CodefastConfig, CodefastTagConfig, MirrorConfig, } from "#/core/config/schema";
+export { runCli } from "#cli";
+export { defineConfig } from "#core/config/define-config";
+export type { CodefastAfterWriteHook, CodefastArrangeConfig, CodefastConfig, CodefastTagConfig, MirrorConfig, } from "#core/config/schema";

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
  * The `@codefast/cli` public API: run the CLI in-process, and author a typed `codefast.config.*`.
  */
-export { runCli } from "#/cli";
-export { defineConfig } from "#/core/config/define-config";
+export { runCli } from "#cli";
+export { defineConfig } from "#core/config/define-config";

package/dist/mirror/cli-result.d.ts

@@ -1,4 +1,4 @@
-import type { GlobalStats } from "#/mirror/domain/types";
+import type { GlobalStats } from "#mirror/domain/types";
 /**
  * Maps a mirror run's stats to the process exit code.
  *

package/dist/mirror/cli-result.js

@@ -1,4 +1,4 @@
-import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#/core/exit-codes";
+import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#core/exit-codes";
 /**
  * Maps a mirror run's stats to the process exit code.
  *

package/dist/mirror/cli-schema.d.ts

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import type { MirrorSyncRunRequest } from "#/mirror/sync-types";
+import * as z from "zod";
+import type { MirrorSyncRunRequest } from "#mirror/domain/types";
 /**
  * Zod schema validating a `MirrorSyncRunRequest`.
  *

package/dist/mirror/cli-schema.js

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 /**
  * Zod schema validating a `MirrorSyncRunRequest`.
  *

package/dist/mirror/command.js

@@ -1,74 +1,45 @@
-import process from "node:process";
 import { Command } from "commander";
-import { globalCliCommanderOptionsSchema } from "#/core/cli/global-options";
-import { readOptionalPositionalArg } from "#/core/cli/positional";
-import { consumeCliAppError } from "#/core/cli/result-handle";
-import { nodeFilesystem } from "#/core/filesystem/node";
-import { logger } from "#/core/logger";
-import { parseWithSchema } from "#/core/schema-parse";
-import { exitCodeForMirrorSyncResult, formatMirrorSyncJsonOutput } from "#/mirror/cli-result";
-import { mirrorSyncRunRequestSchema } from "#/mirror/cli-schema";
-import { MirrorSyncProgressPresenter } from "#/mirror/output";
-import { prepareMirrorSync } from "#/mirror/prepare";
-import { runMirrorSync } from "#/mirror/sync";
+import { applyCommandPipeline } from "#core/cli/command-pipeline";
+import { nodeFilesystem } from "#core/filesystem/node";
+import { exitCodeForMirrorSyncResult, formatMirrorSyncJsonOutput } from "#mirror/cli-result";
+import { mirrorSyncRunRequestSchema } from "#mirror/cli-schema";
+import { MirrorSyncProgressPresenter } from "#mirror/output";
+import { prepareMirrorSync } from "#mirror/prepare";
+import { runMirrorSync } from "#mirror/run";
+const mirrorPipeline = {
+    positional: { name: "[package]", help: "Optional package path relative to repo root (e.g. packages/ui)" },
+    schema: mirrorSyncRunRequestSchema,
+    configureArgv: (command) => {
+        command.option("--dry-run", "Report what would change without writing package.json", false);
+        command.option("-v, --verbose", "Print extra diagnostics", false);
+    },
+    prepare: (fs, input) => prepareMirrorSync(fs, {
+        currentWorkingDirectory: input.currentWorkingDirectory,
+        packageArg: input.rawArg,
+        globals: input.globals,
+    }),
+    buildRequest: ({ prelude, opts }) => ({
+        rootDir: prelude.rootDir,
+        config: prelude.config.mirror ?? {},
+        packageFilter: prelude.packageFilter,
+        write: !opts.dryRun,
+    }),
+    createPresenter: ({ opts, globals }) => {
+        const presenter = new MirrorSyncProgressPresenter();
+        presenter.configure({ noColor: globals.color === false, verbose: !!opts.verbose, dryRun: !!opts.dryRun });
+        return presenter;
+    },
+    run: (fs, request, presenter) => runMirrorSync(fs, { ...request, listener: presenter }),
+    formatJson: ({ result, opts, elapsedSeconds }) => formatMirrorSyncJsonOutput(result, elapsedSeconds, !opts.dryRun),
+    exitCode: exitCodeForMirrorSyncResult,
+};
 /**
  * Creates the `mirror` subcommand, which writes `package.json#exports` from `dist/`.
  *
  * @since 0.3.16-canary.0
  */
 export function createMirrorCommand() {
-    const cmd = new Command("mirror")
-        .description("Write package.json exports from dist/ for workspace packages")
-        .argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)")
-        .option("--dry-run", "Report what would change without writing package.json", false)
-        .option("-v, --verbose", "Print extra diagnostics", false)
-        .option("--json", "Print one JSON summary on stdout (suppresses human progress)", false)
-        .action(async (packageArg, opts, command) => {
-        const globalsOptionCarrier = command.optsWithGlobals?.() ??
-            command.opts();
-        const globalOptionsOutcome = parseWithSchema(globalCliCommanderOptionsSchema, globalsOptionCarrier);
-        if (!consumeCliAppError(globalOptionsOutcome)) {
-            return;
-        }
-        const prelude = await prepareMirrorSync(nodeFilesystem, {
-            currentWorkingDirectory: process.cwd(),
-            packageArg: readOptionalPositionalArg(packageArg),
-            globals: globalOptionsOutcome.value,
-        });
-        if (!consumeCliAppError(prelude)) {
-            return;
-        }
-        const write = !opts.dryRun;
-        const { rootDir, config, packageFilter } = prelude.value;
-        const parsed = parseWithSchema(mirrorSyncRunRequestSchema, {
-            rootDir,
-            config: config.mirror ?? {},
-            packageFilter,
-            write,
-        });
-        if (!consumeCliAppError(parsed)) {
-            return;
-        }
-        const json = !!opts.json;
-        const noColor = globalOptionsOutcome.value.color === false;
-        const verbose = !!opts.verbose;
-        const progressPresenter = new MirrorSyncProgressPresenter();
-        const listener = json ? undefined : progressPresenter;
-        if (!json) {
-            progressPresenter.configure({ noColor, verbose, dryRun: !write });
-        }
-        const startTime = performance.now();
-        const outcome = await runMirrorSync(nodeFilesystem, {
-            ...parsed.value,
-            listener,
-        });
-        if (!consumeCliAppError(outcome)) {
-            return;
-        }
-        if (json) {
-            logger.out(formatMirrorSyncJsonOutput(outcome.value, (performance.now() - startTime) / 1000, write));
-        }
-        process.exitCode = exitCodeForMirrorSyncResult(outcome.value);
-    });
+    const cmd = new Command("mirror").description("Write package.json exports from dist/ for workspace packages");
+    applyCommandPipeline(cmd, nodeFilesystem, mirrorPipeline);
     return cmd;
 }

package/dist/mirror/dist-filesystem-node.d.ts

@@ -0,0 +1,8 @@
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { DistFilesystem } from "#mirror/domain/dist-filesystem";
+/**
+ * Creates the `DistFilesystem` the mirror scan uses, backed by a `Filesystem`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function createMirrorDistFilesystem(fs: Filesystem): DistFilesystem;

package/dist/mirror/{dist-filesystem-impl.js → dist-filesystem-node.js}

@@ -1,8 +1,8 @@
 import path from "node:path";
-import { isDirentList } from "#/mirror/domain/dirent-guard";
-import { normalizePath } from "#/mirror/domain/path-normalizer";
+import { isDirentList } from "#mirror/domain/dirent-guard";
+import { normalizePath } from "#mirror/domain/path-normalizer";
 /**
- * Creates the `DistFilesystem` the mirror scan uses, backed by a `FilesystemPort`.
+ * Creates the `DistFilesystem` the mirror scan uses, backed by a `Filesystem`.
  *
  * @since 0.3.16-canary.0
  */

package/dist/mirror/domain/dirent-guard.d.ts

@@ -1,4 +1,4 @@
-import type { DirectoryEntry } from "#/core/filesystem/port";
+import type { DirectoryEntry } from "#core/filesystem/filesystem";
 /**
  * Narrow `fs.promises.readdir` overload result to `Dirent[]` when `withFileTypes: true`.
  * Accepts both historical checks (`isFile` / `isDirectory`) in one guard.

package/dist/mirror/domain/exports.d.ts

@@ -1,5 +1,5 @@
-import type { DistFilesystem } from "#/mirror/domain/dist-filesystem";
-import type { GenerateExportsResult } from "#/mirror/domain/types";
+import type { DistFilesystem } from "#mirror/domain/dist-filesystem";
+import type { GenerateExportsResult } from "#mirror/domain/types";
 /**
  * Creates a transform that strips a configured prefix from export paths, or `null` when none is set.
  *

package/dist/mirror/domain/exports.js

@@ -1,5 +1,5 @@
 import * as nodePath from "node:path";
-import { PACKAGE_JSON_EXPORT, VALID_DTS_EXTENSIONS, VALID_JS_EXTENSIONS } from "#/mirror/domain/constants";
+import { PACKAGE_JSON_EXPORT, VALID_DTS_EXTENSIONS, VALID_JS_EXTENSIONS } from "#mirror/domain/constants";
 function groupDistFilesByModule(relativeDistFiles) {
     const distModulesByPath = new Map();
     for (const relativeDistFile of relativeDistFiles) {

package/dist/mirror/domain/types.d.ts

@@ -1,5 +1,5 @@
-import type { GlobalCliOptions } from "#/core/cli/global-options";
-import type { CodefastConfig } from "#/core/config/schema";
+import type { GlobalCliOptions } from "#core/cli/global-options";
+import type { CodefastConfig } from "#core/config/schema";
 /**
  * One conditional exports entry, keyed by resolution condition.
  *
@@ -128,4 +128,61 @@ export interface MirrorSyncCommandPrelude {
     readonly config: CodefastConfig;
     readonly packageFilter: string | undefined;
 }
+/**
+ * The inputs a mirror run is invoked with.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorSyncRunRequest = {
+    rootDir: string;
+    packageFilter?: string | undefined;
+    config?: unknown;
+    /** When false, compute and report changes without writing package.json. Defaults to true. */
+    write?: boolean | undefined;
+};
+/**
+ * Whether a run targets a single package or the discovered workspace set.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorProcessingModeInput = {
+    kind: "single";
+} | {
+    kind: "multi";
+    source: WorkspaceMultiDiscoverySource;
+};
+/**
+ * Callbacks a mirror run invokes as it progresses through packages.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorSyncProgressListener = {
+    configure(options: {
+        readonly noColor: boolean;
+        readonly verbose: boolean;
+        readonly dryRun: boolean;
+    }): void;
+    onBanner(): void;
+    onProcessingMode(mode: MirrorProcessingModeInput): void;
+    onNoPackages(): void;
+    onPackageComplete(pkgStats: PackageStats, ordinal: number, total: number): void;
+    onComplete(stats: GlobalStats, elapsedSeconds: number): void;
+};
+/**
+ * A run request paired with an optional progress listener.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorSyncExecutionInput = MirrorSyncRunRequest & {
+    readonly listener?: MirrorSyncProgressListener | undefined;
+};
+/**
+ * The stdout/stderr line-writer shape the reporter prints through.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type CliLoggerLike = {
+    out(line: string): void;
+    err(line: string): void;
+};
 export {};

package/dist/mirror/output.d.ts

@@ -1,6 +1,4 @@
-import type { GlobalStats, PackageStats } from "#/mirror/domain/types";
-import type { MirrorProcessingModeInput } from "#/mirror/sync-reporter";
-import type { MirrorSyncProgressListener } from "#/mirror/sync-types";
+import type { GlobalStats, MirrorProcessingModeInput, MirrorSyncProgressListener, PackageStats } from "#mirror/domain/types";
 /**
  * A progress listener that renders mirror run events through the CLI reporter.
  *

package/dist/mirror/output.js

@@ -1,5 +1,6 @@
-import { logger } from "#/core/logger";
-import { MirrorSyncReporter } from "#/mirror/sync-reporter";
+import process from "node:process";
+import { messageFrom } from "#core/errors";
+import { logger } from "#core/logger";
 const cliLogger = logger;
 /**
  * A progress listener that renders mirror run events through the CLI reporter.
@@ -45,4 +46,128 @@ export class MirrorSyncProgressPresenter {
         this.reporter.mirrorSummarySeparator(cliLogger);
         this.reporter.mirrorSummary(cliLogger, stats, elapsedSeconds);
     }
+}
+const ANSI = {
+    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",
+};
+/**
+ * Console rendering — ANSI styling and layout — for every line a mirror run prints.
+ */
+class MirrorSyncReporter {
+    colorsAreEnabled = true;
+    configureMirrorColors(noColor) {
+        this.colorsAreEnabled = !!process.stdout.isTTY && !noColor;
+    }
+    mirrorBanner(target) {
+        target.out(`\n${this.paint("📦 Mirror — package exports", ANSI.bold + ANSI.cyan)}`);
+        target.out(`${this.paint("═".repeat(60), ANSI.dim)}\n`);
+    }
+    mirrorDryRunNotice(target) {
+        target.out(`${this.paint("Dry run — no files will be written.", ANSI.yellow)}\n`);
+    }
+    mirrorProcessingMode(target, mode) {
+        if (mode.kind === "single") {
+            target.out(`${this.paint("Processing single package...", ANSI.dim)}\n`);
+            return;
+        }
+        if (mode.source === "default-patterns") {
+            target.out(`${this.paint("Discovering workspace packages using default patterns (packages/*)…", ANSI.dim)}\n`);
+            return;
+        }
+        if (mode.source === "pnpm-workspace-yaml") {
+            target.out(`${this.paint("Discovering workspace packages from pnpm-workspace.yaml…", ANSI.dim)}\n`);
+            return;
+        }
+        if (mode.source === "single-package") {
+            target.out(`${this.paint("No pnpm-workspace.yaml — processing the single package at the project root…", ANSI.dim)}\n`);
+            return;
+        }
+        target.out(`${this.paint("pnpm-workspace.yaml declares an empty workspace package list.", ANSI.dim)}\n`);
+    }
+    mirrorNoPackages(target) {
+        target.out(this.paint("⚠ No packages found", ANSI.yellow));
+    }
+    logSkippedWorkspacePackage(target, index, total, displayName, reason) {
+        const progress = this.paint(`[${index}/${total}]`, ANSI.dim);
+        target.out(`${progress} ${this.paint("○", ANSI.gray)} ${this.paint(displayName, ANSI.dim)}`);
+        target.out(`  ${this.paint("└─", ANSI.dim)} ${this.paint(`Skipped: ${reason}`, ANSI.gray)}`);
+        target.out("");
+    }
+    logPackageSuccess(target, index, total, pkgStats, generatedDistAssetCounts, verbose) {
+        const progress = this.paint(`[${index}/${total}]`, ANSI.dim);
+        target.out(`${progress} ${this.paint("✓", ANSI.brightGreen)} ${this.paint(pkgStats.name, ANSI.bold)}`);
+        if (verbose) {
+            target.out(`  ${this.paint("├─", ANSI.dim)} Path: ${pkgStats.path}`);
+            if (pkgStats.hasTransform) {
+                target.out(`  ${this.paint("├─", ANSI.dim)} ${this.paint("Custom path transformation", ANSI.cyan)}`);
+            }
+            if (pkgStats.cssConfigStatus) {
+                const status = pkgStats.cssConfigStatus === "disabled" ? "CSS disabled" : "CSS configured";
+                target.out(`  ${this.paint("├─", ANSI.dim)} ${this.paint(status, ANSI.cyan)}`);
+            }
+        }
+        const breakdown = [];
+        if (generatedDistAssetCounts.jsCount > 0) {
+            breakdown.push(this.paint(`${generatedDistAssetCounts.jsCount} modules`, ANSI.green));
+        }
+        if (generatedDistAssetCounts.cssCount > 0) {
+            breakdown.push(this.paint(`${generatedDistAssetCounts.cssCount} CSS`, ANSI.magenta));
+        }
+        if (pkgStats.extraExports > 0) {
+            breakdown.push(this.paint(`${pkgStats.extraExports} custom`, ANSI.yellow));
+        }
+        const totalExportsText = this.paint(`${pkgStats.totalExports} exports`, ANSI.brightCyan);
+        if (breakdown.length === 0) {
+            target.out(`  ${this.paint("└─", ANSI.dim)} ${totalExportsText}`);
+        }
+        else {
+            target.out(`  ${this.paint("└─", ANSI.dim)} ${breakdown.join(" + ")} = ${totalExportsText}`);
+        }
+        target.out("");
+    }
+    logPrunedStaleExport(target, exportSpecifier) {
+        target.out(`  ${this.paint("└─", ANSI.dim)} ${this.paint(`Pruned stale export: ${exportSpecifier}`, ANSI.gray)}`);
+    }
+    logPackageError(target, index, total, displayName, errorValue, verbose) {
+        target.out(`${this.paint(`[${index}/${total}]`, ANSI.dim)} ${this.paint("✗", ANSI.yellow)} ${this.paint(displayName, ANSI.bold)}`);
+        target.out(`  ${this.paint("└─", ANSI.dim)} ${this.paint(`Error: ${messageFrom(errorValue)}`, ANSI.yellow)}\n`);
+        if (verbose) {
+            target.err(errorValue instanceof Error && errorValue.stack ? errorValue.stack : messageFrom(errorValue));
+        }
+    }
+    mirrorSummarySeparator(target) {
+        target.out(this.paint("═".repeat(60), ANSI.dim));
+    }
+    mirrorSummary(target, stats, elapsedSeconds) {
+        target.out(`${this.paint("📊 Summary", ANSI.bold)} ${this.paint(`(completed in ${elapsedSeconds.toFixed(2)}s)`, ANSI.dim)}\n`);
+        target.out(`  ${this.paint("Packages:", ANSI.bold)}`);
+        target.out(`  ${this.paint("├─", ANSI.dim)} Processed: ${this.paint(String(stats.packagesProcessed), ANSI.green)}`);
+        if (stats.packagesSkipped > 0) {
+            target.out(`  ${this.paint("├─", ANSI.dim)} Skipped: ${this.paint(String(stats.packagesSkipped), ANSI.gray)}`);
+        }
+        if (stats.packagesErrored > 0) {
+            target.out(`  ${this.paint("├─", ANSI.dim)} Errors: ${this.paint(String(stats.packagesErrored), ANSI.yellow)}`);
+        }
+        target.out(`  ${this.paint("└─", ANSI.dim)} Total found: ${stats.packagesFound}\n`);
+        target.out(`  ${this.paint("Exports:", ANSI.bold)}`);
+        target.out(`  ${this.paint("├─", ANSI.dim)} JS Modules: ${this.paint(String(stats.totalJsModules), ANSI.cyan)}`);
+        target.out(`  ${this.paint("├─", ANSI.dim)} CSS Files: ${this.paint(String(stats.totalCssExports), ANSI.magenta)}`);
+        target.out(`  ${this.paint("└─", ANSI.dim)} Total: ${this.paint(String(stats.totalExports), ANSI.brightCyan)}\n`);
+        target.out(`${this.paint("═".repeat(60), ANSI.dim)}\n`);
+    }
+    paint(text, openSequence) {
+        if (!this.colorsAreEnabled) {
+            return text;
+        }
+        return `${openSequence}${text}${ANSI.reset}`;
+    }
 }

package/dist/mirror/package-path.d.ts

@@ -1,12 +1,12 @@
-import { AppError } from "#/core/errors";
-import type { FilesystemPort } from "#/core/filesystem/port";
-import type { Result } from "#/core/result";
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
 /**
  * Resolves the optional positional package argument to a root-relative path, or `undefined` when absent.
  *
  * @since 0.3.16-canary.0
  */
-export declare function resolveMirrorPackageFromCliArg(fs: FilesystemPort, args: {
+export declare function resolveMirrorPackageFromCliArg(fs: Filesystem, args: {
     readonly rootDir: string;
     readonly packageArg: string | undefined;
     readonly currentWorkingDirectory: string;
@@ -16,4 +16,4 @@ export declare function resolveMirrorPackageFromCliArg(fs: FilesystemPort, args:
  *
  * @since 0.3.16-canary.0
  */
-export declare function resolvePackageFilterUnderRoot(fs: FilesystemPort, rootDir: string, packageFilter: string): Result<string, AppError>;
+export declare function resolvePackageFilterUnderRoot(fs: Filesystem, rootDir: string, packageFilter: string): Result<string, AppError>;

package/dist/mirror/package-path.js

@@ -1,7 +1,7 @@
 import path from "node:path";
-import { AppError } from "#/core/errors";
-import { err, ok } from "#/core/result";
-import { normalizePath } from "#/mirror/domain/path-normalizer";
+import { AppError } from "#core/errors";
+import { err, ok } from "#core/result";
+import { normalizePath } from "#mirror/domain/path-normalizer";
 /**
  * Resolves the optional positional package argument to a root-relative path, or `undefined` when absent.
  *

package/dist/mirror/prepare.d.ts

@@ -1,14 +1,14 @@
-import type { GlobalCliOptions } from "#/core/cli/global-options";
-import { AppError } from "#/core/errors";
-import type { FilesystemPort } from "#/core/filesystem/port";
-import type { Result } from "#/core/result";
-import type { MirrorSyncCommandPrelude } from "#/mirror/domain/types";
+import type { GlobalCliOptions } from "#core/cli/global-options";
+import type { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+import type { MirrorSyncCommandPrelude } from "#mirror/domain/types";
 /**
  * Resolves the repo root, config, and package filter into the prelude a mirror run starts from.
  *
  * @since 0.3.16-canary.0
  */
-export declare function prepareMirrorSync(fs: FilesystemPort, args: {
+export declare function prepareMirrorSync(fs: Filesystem, args: {
     readonly currentWorkingDirectory: string;
     readonly packageArg: string | undefined;
     readonly globals: GlobalCliOptions;