@codefast/cli 0.10.0 → 0.11.0

package/dist/core/cli/result-handle.d.ts

@@ -10,10 +10,4 @@ export declare function consumeCliAppError<Value>(outcome: Result<Value, AppErro
 }): outcome is {
     readonly ok: true;
     readonly value: Value;
-};
-/**
- * Awaits a `Result`, hands a success to `onSuccess`, and records the returned exit code on the process.
- *
- * @since 0.3.16-canary.0
- */
-export declare function runCliResultAsync<Value>(outcomePromise: Promise<Result<Value, AppError>>, onSuccess: (value: Value) => number | void | Promise<number | void>): Promise<void>;
+};

package/dist/core/cli/result-handle.js

@@ -38,17 +38,4 @@ export function consumeCliAppError(outcome, options) {
         logger.out(options.successMessage);
     }
     return true;
-}
-/**
- * Awaits a `Result`, hands a success to `onSuccess`, and records the returned exit code on the process.
- *
- * @since 0.3.16-canary.0
- */
-export async function runCliResultAsync(outcomePromise, onSuccess) {
-    const outcome = await outcomePromise;
-    if (!consumeCliAppError(outcome)) {
-        return;
-    }
-    const exit = await onSuccess(outcome.value);
-    process.exitCode = exit === undefined ? 0 : exit;
 }

package/dist/core/config/loader.d.ts

@@ -1,5 +1,5 @@
 import type { CodefastConfig } from "#/core/config/schema";
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#/core/filesystem/filesystem";
 /**
  * A loaded config together with its schema warnings and the path it was read from.
  *
@@ -15,4 +15,4 @@ export type LoadConfigPayload = {
  *
  * @since 0.3.16-canary.0
  */
-export declare function loadConfigPayload(startDir: string, fs: FilesystemPort): Promise<LoadConfigPayload>;
+export declare function loadConfigPayload(startDir: string, fs: Filesystem): Promise<LoadConfigPayload>;

package/dist/core/config/schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 /**
  * A config hook invoked with the written file paths after a command rewrites files.
  *

package/dist/core/config/schema.js

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 const afterWriteHookSchema = z.custom((value) => typeof value === "function", {
     message: "Expected a function",
 });

package/dist/core/config.d.ts

@@ -1,12 +1,12 @@
 import type { CodefastConfig } from "#/core/config/schema";
 import { AppError } from "#/core/errors";
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#/core/filesystem/filesystem";
 import type { Result } from "#/core/result";
 /**
  * Loads the `codefast.config.js` for a workspace root, reporting schema warnings along the way.
  *
  * @since 0.3.16-canary.0
  */
-export declare function loadCodefastConfig(rootDir: string, fs: FilesystemPort): Promise<Result<{
+export declare function loadCodefastConfig(rootDir: string, fs: Filesystem): Promise<Result<{
     config: CodefastConfig;
 }, AppError>>;

package/dist/core/filesystem/{port.d.ts → filesystem.d.ts}

@@ -20,7 +20,7 @@ export interface DirectoryEntry {
  *
  * @since 0.3.16-canary.0
  */
-export interface FilesystemPort {
+export interface Filesystem {
     existsSync(filePath: string): boolean;
     canonicalPathSync(inputPath: string): string;
     statSync(filePath: string): {

package/dist/core/filesystem/node.d.ts

@@ -1,7 +1,7 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#/core/filesystem/filesystem";
 /**
- * The `FilesystemPort` implementation backed by Node's real filesystem.
+ * The `Filesystem` implementation backed by Node's real filesystem.
  *
  * @since 0.3.16-canary.0
  */
-export declare const nodeFilesystem: FilesystemPort;
+export declare const nodeFilesystem: Filesystem;

package/dist/core/filesystem/node.js

@@ -2,7 +2,7 @@ import fsSync from "node:fs";
 import fsPromises from "node:fs/promises";
 import path from "node:path";
 /**
- * The `FilesystemPort` implementation backed by Node's real filesystem.
+ * The `Filesystem` implementation backed by Node's real filesystem.
  *
  * @since 0.3.16-canary.0
  */

package/dist/core/source-text-edit.d.ts

@@ -24,6 +24,20 @@ export declare function textPrefixFromLineStartToPosition(source: string, pos: n
  * @since 0.3.16-canary.0
  */
 export declare function endAfterOptionalCommaFollowingInSource(source: string, tokenEnd: number): number;
+/**
+ * Returns the edits with every overlap removed, keeping the outermost of any overlapping pair.
+ *
+ * @remarks A planned edit replaces a whole AST node, so two ranges either nest or are disjoint and
+ * the outer replacement already contains the inner span verbatim — dropping the nested edit keeps
+ * the output valid. Higher-priority edits must come first so an exact-range tie keeps the earlier
+ * one. This is the invariant `applyEditsDescending` assumes; run it before applying.
+ *
+ * @since 0.11.0
+ */
+export declare function dropOverlappingEdits<Edit extends {
+    start: number;
+    end: number;
+}>(edits: ReadonlyArray<Edit>): Array<Edit>;
 /**
  * Applies non-overlapping text edits from the highest offset down and returns the edited source.
  *

package/dist/core/source-text-edit.js

@@ -54,6 +54,28 @@ export function endAfterOptionalCommaFollowingInSource(source, tokenEnd) {
     }
     return tokenEnd;
 }
+/**
+ * Returns the edits with every overlap removed, keeping the outermost of any overlapping pair.
+ *
+ * @remarks A planned edit replaces a whole AST node, so two ranges either nest or are disjoint and
+ * the outer replacement already contains the inner span verbatim — dropping the nested edit keeps
+ * the output valid. Higher-priority edits must come first so an exact-range tie keeps the earlier
+ * one. This is the invariant `applyEditsDescending` assumes; run it before applying.
+ *
+ * @since 0.11.0
+ */
+export function dropOverlappingEdits(edits) {
+    const ordered = [...edits].toSorted((editA, editB) => editA.start - editB.start || editB.end - editA.end);
+    const kept = [];
+    let lastEnd = -1;
+    for (const edit of ordered) {
+        if (edit.start >= lastEnd) {
+            kept.push(edit);
+            lastEnd = edit.end;
+        }
+    }
+    return kept;
+}
 /**
  * Applies non-overlapping text edits from the highest offset down and returns the edited source.
  *

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

@@ -1,7 +1,7 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#/core/filesystem/filesystem";
 /**
  * Every markdown file under a root, skipping build output and vendored trees.
  *
  * @since 0.5.0
  */
-export declare function walkMarkdownFiles(rootDirectoryPath: string, fs: FilesystemPort): Array<string>;
+export declare function walkMarkdownFiles(rootDirectoryPath: string, fs: Filesystem): Array<string>;

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/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/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/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/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/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 { applyCommandPipeline } from "#/core/cli/command-pipeline";
 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 { 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-impl.d.ts → dist-filesystem-node.d.ts}

@@ -1,8 +1,8 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+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 `FilesystemPort`.
+ * Creates the `DistFilesystem` the mirror scan uses, backed by a `Filesystem`.
  *
  * @since 0.3.16-canary.0
  */
-export declare function createMirrorDistFilesystem(fs: FilesystemPort): DistFilesystem;
+export declare function createMirrorDistFilesystem(fs: Filesystem): DistFilesystem;

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

@@ -2,7 +2,7 @@ import path from "node:path";
 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/types.d.ts

@@ -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 process from "node:process";
+import { messageFrom } from "#/core/errors";
 import { logger } from "#/core/logger";
-import { MirrorSyncReporter } from "#/mirror/sync-reporter";
 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 { 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/prepare.d.ts

@@ -1,6 +1,6 @@
 import type { GlobalCliOptions } from "#/core/cli/global-options";
-import { AppError } from "#/core/errors";
-import type { FilesystemPort } from "#/core/filesystem/port";
+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";
 /**
@@ -8,7 +8,7 @@ import type { MirrorSyncCommandPrelude } from "#/mirror/domain/types";
  *
  * @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;