@codefast/cli 0.10.0 → 0.12.0

package/dist/mirror/prepare.js

@@ -1,22 +1,18 @@
-import { loadCodefastConfig } from "#/core/config";
-import { AppError } from "#/core/errors";
-import { messageFrom } from "#/core/errors";
-import { err, ok } from "#/core/result";
-import { resolveProjectRoot } from "#/core/workspace/resolver";
-import { resolveMirrorPackageFromCliArg } from "#/mirror/package-path";
+import { resolveProjectRootResult } from "#core/cli/resolve-root";
+import { loadCodefastConfig } from "#core/config";
+import { ok } from "#core/result";
+import { resolveMirrorPackageFromCliArg } from "#mirror/package-path";
 /**
  * Resolves the repo root, config, and package filter into the prelude a mirror run starts from.
  *
  * @since 0.3.16-canary.0
  */
 export async function prepareMirrorSync(fs, args) {
-    let rootDir;
-    try {
-        rootDir = resolveProjectRoot(args.currentWorkingDirectory, fs).rootDir;
-    }
-    catch (caughtError) {
-        return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
+    const rootOutcome = resolveProjectRootResult(fs, args.currentWorkingDirectory);
+    if (!rootOutcome.ok) {
+        return rootOutcome;
     }
+    const rootDir = rootOutcome.value;
     const filterOutcome = resolveMirrorPackageFromCliArg(fs, {
         rootDir,
         packageArg: args.packageArg,

package/dist/mirror/run.d.ts

@@ -0,0 +1,12 @@
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+import type { GlobalStats } from "#mirror/domain/types";
+import type { MirrorSyncExecutionInput } from "#mirror/domain/types";
+export type { MirrorSyncExecutionInput } from "#mirror/domain/types";
+/**
+ * Runs the mirror sync across the targeted packages and returns the aggregate stats.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function runMirrorSync(fs: Filesystem, input: MirrorSyncExecutionInput): Promise<Result<GlobalStats, AppError>>;

package/dist/mirror/{sync.js → run.js}

@@ -1,11 +1,11 @@
 import path from "node:path";
-import { AppError } from "#/core/errors";
-import { messageFrom } from "#/core/errors";
-import { err, ok } from "#/core/result";
-import { listWorkspacePackageDirectories } from "#/core/workspace/resolver";
-import { normalizePath } from "#/mirror/domain/path-normalizer";
-import { resolvePackageFilterUnderRoot } from "#/mirror/package-path";
-import { syncExportsForWorkspacePackage } from "#/mirror/sync-workspace-package";
+import { AppError } from "#core/errors";
+import { messageFrom } from "#core/errors";
+import { err, ok } from "#core/result";
+import { listWorkspacePackageDirectories } from "#core/workspace/resolver";
+import { normalizePath } from "#mirror/domain/path-normalizer";
+import { resolvePackageFilterUnderRoot } from "#mirror/package-path";
+import { syncExportsForWorkspacePackage } from "#mirror/sync-workspace-package";
 /**
  * Runs the mirror sync across the targeted packages and returns the aggregate stats.
  *

package/dist/mirror/supplement-exports.d.ts

@@ -1,4 +1,4 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * The export specifiers a preserve-mode run added conditions to.
  *
@@ -12,7 +12,7 @@ export type SupplementResult = {
  *
  * @since 0.3.16-canary.0
  */
-export declare function supplementExportsInPackageJson(fs: FilesystemPort, packageJsonPath: string, packageDir: string, options: {
+export declare function supplementExportsInPackageJson(fs: Filesystem, packageJsonPath: string, packageDir: string, options: {
     source: boolean | string;
     types: boolean;
     import: boolean;
@@ -24,4 +24,4 @@ export declare function supplementExportsInPackageJson(fs: FilesystemPort, packa
  *
  * @since 0.3.16-canary.0
  */
-export declare function buildSourcePathResolver(fs: FilesystemPort, packageDir: string): (modulePath: string) => string;
+export declare function buildSourcePathResolver(fs: Filesystem, packageDir: string): (modulePath: string) => string;

package/dist/mirror/supplement-exports.js

@@ -1,6 +1,6 @@
 import path from "node:path";
-import { distDirName } from "#/core/workspace/well-known-files";
-import { writePackageJsonExportsAtomic } from "#/mirror/write-exports";
+import { distDirName } from "#core/workspace/well-known-files";
+import { writePackageJsonExportsAtomic } from "#mirror/write-exports";
 const DTS_EXTENSIONS = [".d.mts", ".d.ts", ".d.cts"];
 const JS_EXTENSIONS = [".mjs", ".js"];
 /**

package/dist/mirror/sync-workspace-package.d.ts

@@ -1,9 +1,9 @@
-import type { MirrorConfig } from "#/core/config/schema";
-import type { FilesystemPort } from "#/core/filesystem/port";
-import type { PackageStats } from "#/mirror/domain/types";
+import type { MirrorConfig } from "#core/config/schema";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { PackageStats } from "#mirror/domain/types";
 /**
  * Regenerates one package's `package.json#exports` from its `dist/` and returns the package's stats.
  *
  * @since 0.3.16-canary.0
  */
-export declare function syncExportsForWorkspacePackage(fs: FilesystemPort, rootDir: string, packagePathStr: string, config: MirrorConfig, write?: boolean): Promise<PackageStats>;
+export declare function syncExportsForWorkspacePackage(fs: Filesystem, rootDir: string, packagePathStr: string, config: MirrorConfig, write?: boolean): Promise<PackageStats>;

package/dist/mirror/sync-workspace-package.js

@@ -1,24 +1,21 @@
 import path from "node:path";
-import { messageFrom } from "#/core/errors";
-import { distDirName, packageJsonFileName } from "#/core/workspace/well-known-files";
-import { createMirrorDistFilesystem } from "#/mirror/dist-filesystem-impl";
-import { createPathTransform, generateExports } from "#/mirror/domain/exports";
-import { resolvePackageDisplayName } from "#/mirror/domain/package-display-name";
-import { buildSourcePathResolver, supplementExportsInPackageJson } from "#/mirror/supplement-exports";
-import { writePackageJsonExportsAtomic } from "#/mirror/write-exports";
+import { messageFrom } from "#core/errors";
+import { distDirName, packageJsonFileName } from "#core/workspace/well-known-files";
+import { createMirrorDistFilesystem } from "#mirror/dist-filesystem-node";
+import { createPathTransform, generateExports } from "#mirror/domain/exports";
+import { resolvePackageDisplayName } from "#mirror/domain/package-display-name";
+import { buildSourcePathResolver, supplementExportsInPackageJson } from "#mirror/supplement-exports";
+import { writePackageJsonExportsAtomic } from "#mirror/write-exports";
 /**
  * Regenerates one package's `package.json#exports` from its `dist/` and returns the package's stats.
  *
  * @since 0.3.16-canary.0
  */
 export async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr, config, write = true) {
-    const pathJoin = path.join;
-    const pathResolve = path.resolve;
-    const pathBasename = path.basename;
-    const packageDir = pathResolve(rootDir, packagePathStr);
-    const distDir = pathJoin(packageDir, distDirName);
-    const packageJsonPath = pathJoin(packageDir, packageJsonFileName);
-    const folderBasename = pathBasename(packageDir);
+    const packageDir = path.resolve(rootDir, packagePathStr);
+    const distDir = path.join(packageDir, distDirName);
+    const packageJsonPath = path.join(packageDir, packageJsonFileName);
+    const folderBasename = path.basename(packageDir);
     const distFilesystem = createMirrorDistFilesystem(fs);
     const pkgStats = {
         name: folderBasename,

package/dist/mirror/write-exports.d.ts

@@ -1,12 +1,12 @@
-import type { FilesystemPort } from "#/core/filesystem/port";
-import type { ExportMapData, ExportOriginalPathBySpecifier } from "#/mirror/domain/types";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { ExportMapData, ExportOriginalPathBySpecifier } from "#mirror/domain/types";
 /**
  * Writes `exports` into `package.json` via a temp file + rename (atomic on same volume).
  * Preserves a trailing newline after JSON.
  *
  * @since 0.3.16-canary.0
  */
-export declare function writePackageJsonExportsAtomic(fs: FilesystemPort, packageJsonPath: string, mergeInput: {
+export declare function writePackageJsonExportsAtomic(fs: Filesystem, packageJsonPath: string, mergeInput: {
     generatedExports: ExportMapData;
     managedExportSpecifiers: Array<string>;
     originalPathBySpecifier: ExportOriginalPathBySpecifier;

package/dist/mirror/write-exports.js

@@ -1,6 +1,6 @@
-import { messageFrom } from "#/core/errors";
-import { PACKAGE_JSON_EXPORT } from "#/mirror/domain/constants";
-import { MirrorError, MirrorErrorCode } from "#/mirror/domain/errors";
+import { messageFrom } from "#core/errors";
+import { PACKAGE_JSON_EXPORT } from "#mirror/domain/constants";
+import { MirrorError, MirrorErrorCode } from "#mirror/domain/errors";
 /**
  * Writes `exports` into `package.json` via a temp file + rename (atomic on same volume).
  * Preserves a trailing newline after JSON.

package/dist/pack-slim/cli-result.d.ts

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

package/dist/pack-slim/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 pack-slim run's stats to the process exit code.
  *

package/dist/pack-slim/cli-schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 /**
  * The validated serializable inputs of a pack-slim run.
  *

package/dist/pack-slim/cli-schema.js

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 /**
  * Zod schema validating the serializable inputs of a pack-slim run.
  *

package/dist/pack-slim/command.js

@@ -1,80 +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 { AppError, messageFrom } from "#/core/errors";
-import { nodeFilesystem } from "#/core/filesystem/node";
-import { logger } from "#/core/logger";
-import { err } from "#/core/result";
-import { parseWithSchema } from "#/core/schema-parse";
-import { resolveProjectRoot } from "#/core/workspace/resolver";
-import { exitCodeForPackSlimResult, formatPackSlimJsonOutput } from "#/pack-slim/cli-result";
-import { packSlimRunRequestSchema } from "#/pack-slim/cli-schema";
-import { PackSlimProgressPresenter } from "#/pack-slim/output";
-import { runPackSlim } from "#/pack-slim/sync";
-import { ensureWorkingTreeClean } from "#/pack-slim/working-tree";
+import { applyCommandPipeline } from "#core/cli/command-pipeline";
+import { nodeFilesystem } from "#core/filesystem/node";
+import { ok } from "#core/result";
+import { exitCodeForPackSlimResult, formatPackSlimJsonOutput } from "#pack-slim/cli-result";
+import { packSlimRunRequestSchema } from "#pack-slim/cli-schema";
+import { PackSlimProgressPresenter } from "#pack-slim/output";
+import { preparePackSlim } from "#pack-slim/prepare";
+import { runPackSlim } from "#pack-slim/run";
+import { ensureWorkingTreeClean } from "#pack-slim/working-tree";
+const packSlimPipeline = {
+    positional: { name: "[package]", help: "Optional package path relative to repo root (e.g. packages/ui)" },
+    schema: packSlimRunRequestSchema,
+    configureArgv: (command) => {
+        command.option("--dry-run", "Report what would change without touching any file", false);
+        command.option("--force", "Run even if the git working tree has uncommitted tracked changes", false);
+    },
+    prepare: (fs, input) => preparePackSlim(fs, { currentWorkingDirectory: input.currentWorkingDirectory, packageArg: input.rawArg }),
+    // A destructive slim must never land on uncommitted work; --dry-run writes nothing, so it is exempt.
+    guard: async ({ prelude, opts }) => !opts.dryRun && !opts.force ? ensureWorkingTreeClean(prelude.rootDir) : ok(undefined),
+    buildRequest: ({ prelude, opts }) => ({
+        rootDir: prelude.rootDir,
+        packageFilter: prelude.packageFilter,
+        write: !opts.dryRun,
+    }),
+    createPresenter: ({ opts }) => {
+        const presenter = new PackSlimProgressPresenter();
+        presenter.configure({ dryRun: !!opts.dryRun });
+        return presenter;
+    },
+    run: (fs, request, presenter) => runPackSlim(fs, { ...request, listener: presenter }),
+    formatJson: ({ result, opts, elapsedSeconds }) => formatPackSlimJsonOutput(result, elapsedSeconds, !opts.dryRun),
+    exitCode: exitCodeForPackSlimResult,
+};
 /**
  * Creates the `pack-slim` subcommand, which slims published packages down to what a consumer reads before publish.
  *
  * @since 0.8.1
  */
 export function createPackSlimCommand() {
-    const cmd = new Command("pack-slim")
-        .description("Strip src, source conditions, unshipped imports, dev-only scripts, devDependencies, and dist source maps from " +
-        "published packages before publish")
-        .argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)")
-        .option("--dry-run", "Report what would change without touching any file", false)
-        .option("--force", "Run even if the git working tree has uncommitted tracked changes", 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;
-        }
-        let rootDir;
-        try {
-            rootDir = resolveProjectRoot(process.cwd(), nodeFilesystem).rootDir;
-        }
-        catch (caughtError) {
-            consumeCliAppError(err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError)));
-            return;
-        }
-        const write = !opts.dryRun;
-        // A destructive slim must never land on a developer's uncommitted work; --dry-run writes nothing, so it is exempt.
-        if (write && !opts.force) {
-            const cleanCheck = ensureWorkingTreeClean(rootDir);
-            if (!consumeCliAppError(cleanCheck)) {
-                return;
-            }
-        }
-        const parsed = parseWithSchema(packSlimRunRequestSchema, {
-            rootDir,
-            packageFilter: readOptionalPositionalArg(packageArg),
-            write,
-        });
-        if (!consumeCliAppError(parsed)) {
-            return;
-        }
-        const json = !!opts.json;
-        const presenter = new PackSlimProgressPresenter();
-        if (!json) {
-            presenter.configure({ dryRun: !write });
-        }
-        const startTime = performance.now();
-        const outcome = await runPackSlim(nodeFilesystem, {
-            ...parsed.value,
-            listener: json ? undefined : presenter,
-        });
-        if (!consumeCliAppError(outcome)) {
-            return;
-        }
-        if (json) {
-            logger.out(formatPackSlimJsonOutput(outcome.value, (performance.now() - startTime) / 1000, write));
-        }
-        process.exitCode = exitCodeForPackSlimResult(outcome.value);
-    });
+    const cmd = new Command("pack-slim").description("Strip src, source conditions, unshipped imports, dev-only scripts, devDependencies, and dist source maps from " +
+        "published packages before publish");
+    applyCommandPipeline(cmd, nodeFilesystem, packSlimPipeline);
     return cmd;
 }

package/dist/pack-slim/domain/transform.d.ts

@@ -54,12 +54,33 @@ export declare function isLifecycleScript(name: string): boolean;
  * Produces a publish manifest carrying only what a consumer's `tsc` and Node read.
  *
  * @remarks Operates on a structural clone, so the caller's manifest is left intact. A consumer never enables `source`
- * and resolves `#/` through `types`/`default` to `dist`, so dropping the source lane, the `imports` left pointing
+ * and resolves `#` through `types`/`default` to `dist`, so dropping the source lane, the `imports` left pointing
  * outside `files`, the scripts that are not lifecycle hooks, and `devDependencies` leaves the published surface whole.
  *
  * @since 0.8.1
  */
 export declare function slimPublishManifest(manifest: Record<string, unknown>): SlimManifestResult;
+/**
+ * A published `exports`/`imports` target the slimmed manifest points at but does not ship.
+ *
+ * @since 0.12.0
+ */
+export interface UnshippedTarget {
+    readonly field: "exports" | "imports";
+    readonly subpath: string;
+    readonly target: string;
+}
+/**
+ * The publish targets a package would resolve to a file it does not ship.
+ *
+ * @remarks Runs the same slim the publish step applies, then checks each surviving `exports`/`imports`
+ * target against the shipped `files`. A non-empty result means a consumer resolves that subpath to a
+ * missing file — the failure dropping a stylesheet's `src` subtree produces. With no `files` field npm
+ * ships everything, so nothing is unshipped.
+ *
+ * @since 0.12.0
+ */
+export declare function unshippedPublishTargets(manifest: Record<string, unknown>): Array<UnshippedTarget>;
 /**
  * Strips every `sourceMappingURL` directive line from an emitted file's text.
  *

package/dist/pack-slim/domain/transform.js

@@ -58,16 +58,16 @@ export function isLifecycleScript(name) {
  * Produces a publish manifest carrying only what a consumer's `tsc` and Node read.
  *
  * @remarks Operates on a structural clone, so the caller's manifest is left intact. A consumer never enables `source`
- * and resolves `#/` through `types`/`default` to `dist`, so dropping the source lane, the `imports` left pointing
+ * and resolves `#` through `types`/`default` to `dist`, so dropping the source lane, the `imports` left pointing
  * outside `files`, the scripts that are not lifecycle hooks, and `devDependencies` leaves the published surface whole.
  *
  * @since 0.8.1
  */
 export function slimPublishManifest(manifest) {
     const draft = structuredClone(manifest);
-    const filesSrcRemoved = removeSrcFromFiles(draft);
     const exportsSourceRemoved = deleteSourceConditions(draft.exports);
     const importsSourceRemoved = deleteSourceConditions(draft.imports);
+    const filesSrcRemoved = removeSrcFromFiles(draft);
     const importsUnshippedRemoved = deleteUnshippedImports(draft);
     const scriptsRemoved = deleteDevOnlyScripts(draft);
     const devDependenciesRemoved = deleteDevDependencies(draft);
@@ -85,6 +85,44 @@ export function slimPublishManifest(manifest) {
         },
     };
 }
+/**
+ * The publish targets a package would resolve to a file it does not ship.
+ *
+ * @remarks Runs the same slim the publish step applies, then checks each surviving `exports`/`imports`
+ * target against the shipped `files`. A non-empty result means a consumer resolves that subpath to a
+ * missing file — the failure dropping a stylesheet's `src` subtree produces. With no `files` field npm
+ * ships everything, so nothing is unshipped.
+ *
+ * @since 0.12.0
+ */
+export function unshippedPublishTargets(manifest) {
+    const { manifest: slimmed } = slimPublishManifest(manifest);
+    const files = Array.isArray(slimmed.files)
+        ? slimmed.files.filter((entry) => typeof entry === "string")
+        : [];
+    if (files.length === 0) {
+        return [];
+    }
+    const unshipped = [];
+    for (const field of ["exports", "imports"]) {
+        const node = slimmed[field];
+        if (!isRecord(node)) {
+            continue;
+        }
+        for (const subpath of Object.keys(node)) {
+            for (const target of collectTargets(node[subpath])) {
+                // Only relative file targets can be unshipped; npm always includes package.json.
+                if (!target.startsWith("./") || stripDotSlash(target) === "package.json") {
+                    continue;
+                }
+                if (!isShippedTarget(target, files)) {
+                    unshipped.push({ field, subpath, target });
+                }
+            }
+        }
+    }
+    return unshipped;
+}
 /**
  * Strips every `sourceMappingURL` directive line from an emitted file's text.
  *
@@ -98,18 +136,37 @@ export function stripSourceMappingComment(text) {
     }
     return { text: kept.join("\n"), stripped: true };
 }
+// Replaces the `src` files entry with only the src subtrees the published surface still points into —
+// a stylesheet export like `./css/*` -> `./src/css/*` ships Tailwind source, so dropping all of src
+// would ship a broken export. Runs after the source conditions are stripped, so the `#*` source lane
+// no longer counts; with nothing left pointing into src the entry is dropped outright.
 function removeSrcFromFiles(manifest) {
     const files = manifest.files;
-    if (!Array.isArray(files)) {
+    if (!Array.isArray(files) || !files.includes("src")) {
         return false;
     }
-    const next = files.filter((entry) => entry !== "src");
-    if (next.length === files.length) {
-        return false;
-    }
-    manifest.files = next;
+    const keep = srcPathsShippedBySurface(manifest);
+    manifest.files = files.flatMap((entry) => (entry === "src" ? keep : [entry]));
     return true;
 }
+// The src subtrees a surviving `exports`/`imports` target still ships, e.g. `./src/css/*` -> `src/css`.
+function srcPathsShippedBySurface(manifest) {
+    const targets = [...collectTargets(manifest.exports), ...collectTargets(manifest.imports)];
+    const kept = new Set();
+    for (const target of targets) {
+        const relative = stripDotSlash(target);
+        if (relative !== "src" && !relative.startsWith("src/")) {
+            continue;
+        }
+        const segments = relative.split("/");
+        // A glob tail (`*`, `**`) ships its directory; a concrete file ships itself.
+        if (segments.at(-1)?.includes("*")) {
+            segments.pop();
+        }
+        kept.add(segments.join("/"));
+    }
+    return [...kept].sort();
+}
 // Walks a conditions tree deleting every `source` key. A subpath key always starts with ".", so only real condition
 // objects match; an `imports` entry this leaves empty is what the unshipped pass removes.
 function deleteSourceConditions(node) {

package/dist/pack-slim/output.d.ts

@@ -1,4 +1,4 @@
-import type { PackSlimPackageStats, PackSlimProgressListener, PackSlimRunStats } from "#/pack-slim/domain/types";
+import type { PackSlimPackageStats, PackSlimProgressListener, PackSlimRunStats } from "#pack-slim/domain/types";
 /**
  * A progress listener that renders pack-slim run events as human-readable CLI lines.
  *

package/dist/pack-slim/output.js

@@ -1,4 +1,4 @@
-import { logger } from "#/core/logger";
+import { logger } from "#core/logger";
 /**
  * A progress listener that renders pack-slim run events as human-readable CLI lines.
  *

package/dist/pack-slim/prepare.d.ts

@@ -0,0 +1,21 @@
+import type { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+/**
+ * The repo root and package filter a pack-slim run starts from.
+ *
+ * @since 0.8.1
+ */
+export interface PackSlimCommandPrelude {
+    readonly rootDir: string;
+    readonly packageFilter: string | undefined;
+}
+/**
+ * Resolves the repo root and optional package filter into the prelude a pack-slim run starts from.
+ *
+ * @since 0.8.1
+ */
+export declare function preparePackSlim(fs: Filesystem, args: {
+    readonly currentWorkingDirectory: string;
+    readonly packageArg: string | undefined;
+}): Promise<Result<PackSlimCommandPrelude, AppError>>;

package/dist/pack-slim/prepare.js

@@ -0,0 +1,14 @@
+import { resolveProjectRootResult } from "#core/cli/resolve-root";
+import { ok } from "#core/result";
+/**
+ * Resolves the repo root and optional package filter into the prelude a pack-slim run starts from.
+ *
+ * @since 0.8.1
+ */
+export async function preparePackSlim(fs, args) {
+    const rootOutcome = resolveProjectRootResult(fs, args.currentWorkingDirectory);
+    if (!rootOutcome.ok) {
+        return rootOutcome;
+    }
+    return ok({ rootDir: rootOutcome.value, packageFilter: args.packageArg });
+}

package/dist/pack-slim/{sync.d.ts → run.d.ts}

@@ -1,8 +1,8 @@
-import { AppError } from "#/core/errors";
-import type { FilesystemPort } from "#/core/filesystem/port";
-import type { Result } from "#/core/result";
-import type { PackSlimRunRequest } from "#/pack-slim/cli-schema";
-import type { PackSlimProgressListener, PackSlimRunStats } from "#/pack-slim/domain/types";
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+import type { PackSlimRunRequest } from "#pack-slim/cli-schema";
+import type { PackSlimProgressListener, PackSlimRunStats } from "#pack-slim/domain/types";
 /**
  * A pack-slim run request paired with an optional progress listener.
  *
@@ -20,4 +20,4 @@ export type PackSlimRunInput = PackSlimRunRequest & {
  *
  * @since 0.8.1
  */
-export declare function runPackSlim(fs: FilesystemPort, input: PackSlimRunInput): Promise<Result<PackSlimRunStats, AppError>>;
+export declare function runPackSlim(fs: Filesystem, input: PackSlimRunInput): Promise<Result<PackSlimRunStats, AppError>>;

package/dist/pack-slim/{sync.js → run.js}

@@ -1,9 +1,9 @@
 import path from "node:path";
-import { AppError, messageFrom } from "#/core/errors";
-import { err, ok } from "#/core/result";
-import { listWorkspacePackageDirectories } from "#/core/workspace/resolver";
-import { distDirName, packageJsonFileName } from "#/core/workspace/well-known-files";
-import { isMapAnnotatedFile, isSourceMapFile, slimPublishManifest, stripSourceMappingComment, } from "#/pack-slim/domain/transform";
+import { AppError, messageFrom } from "#core/errors";
+import { err, ok } from "#core/result";
+import { listWorkspacePackageDirectories } from "#core/workspace/resolver";
+import { distDirName, packageJsonFileName } from "#core/workspace/well-known-files";
+import { isMapAnnotatedFile, isSourceMapFile, slimPublishManifest, stripSourceMappingComment, } from "#pack-slim/domain/transform";
 /**
  * Slims every published package's manifest and build output for publish and returns the aggregate stats.
  *

package/dist/pack-slim/working-tree.d.ts

@@ -1,5 +1,5 @@
-import { AppError } from "#/core/errors";
-import type { Result } from "#/core/result";
+import { AppError } from "#core/errors";
+import type { Result } from "#core/result";
 /**
  * Whether git's tracked-only porcelain output reports any uncommitted change.
  *

package/dist/pack-slim/working-tree.js

@@ -1,6 +1,6 @@
 import { execFileSync } from "node:child_process";
-import { AppError, messageFrom } from "#/core/errors";
-import { err, ok } from "#/core/result";
+import { AppError, messageFrom } from "#core/errors";
+import { err, ok } from "#core/result";
 /**
  * Whether git's tracked-only porcelain output reports any uncommitted change.
  *

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

@@ -1,7 +1,13 @@
-import type { TagSyncResult } from "#/tag/domain/types";
+import type { TagResult } from "#tag/domain/types";
 /**
  * Maps a tag run's result to the process exit code.
  *
  * @since 0.3.16-canary.0
  */
-export declare function exitCodeForTagSyncResult(result: TagSyncResult): number;
+export declare function exitCodeForTagResult(result: TagResult): number;
+/**
+ * Serializes a tag run's result as the `--json` output string.
+ *
+ * @since 0.11.0
+ */
+export declare function formatTagJsonOutput(result: TagResult, rootDir: string): string;

package/dist/tag/cli-result.js

@@ -1,13 +1,26 @@
-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 tag run's result to the process exit code.
  *
  * @since 0.3.16-canary.0
  */
-export function exitCodeForTagSyncResult(result) {
+export function exitCodeForTagResult(result) {
     if (result.selectedTargets.length === 0) {
         return CLI_EXIT_GENERAL_ERROR;
     }
     const hasRunErrors = result.targetResults.some((targetResult) => targetResult.runError !== null);
     return hasRunErrors || result.hookError !== null ? CLI_EXIT_GENERAL_ERROR : CLI_EXIT_SUCCESS;
+}
+/**
+ * Serializes a tag run's result as the `--json` output string.
+ *
+ * @since 0.11.0
+ */
+export function formatTagJsonOutput(result, rootDir) {
+    return JSON.stringify({
+        schemaVersion: 1,
+        ok: result.hookError === null,
+        cwd: rootDir,
+        result,
+    });
 }

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

@@ -1,8 +1,8 @@
-import { z } from "zod";
-import type { TagSyncRunRequest } from "#/tag/sync";
+import * as z from "zod";
+import type { TagRunRequest } from "#tag/domain/types";
 /**
- * Zod schema validating a `TagSyncRunRequest`.
+ * Zod schema validating a `TagRunRequest`.
  *
  * @since 0.3.16-canary.0
  */
-export declare const tagSyncRunRequestSchema: z.ZodType<TagSyncRunRequest>;
+export declare const tagRunRequestSchema: z.ZodType<TagRunRequest>;