@codefast/cli 0.11.0 → 0.13.0

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

@@ -1,6 +1,6 @@
-import type { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
+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.
  *

package/dist/pack-slim/prepare.js

@@ -1,5 +1,5 @@
-import { resolveProjectRootResult } from "#/core/cli/resolve-root";
-import { ok } from "#/core/result";
+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.
  *

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

@@ -1,8 +1,8 @@
-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";
+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.
  *

package/dist/pack-slim/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.
  *
@@ -115,7 +115,7 @@ async function pruneDist(fs, distDir, write, pkgStats) {
     if (!fs.existsSync(distDir)) {
         return;
     }
-    const entries = (await fs.readdir(distDir, { recursive: true, withFileTypes: true }));
+    const entries = await fs.readdirEntries(distDir, { recursive: true });
     for (const entry of entries) {
         if (!entry.isFile()) {
             continue;

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,4 +1,4 @@
-import type { TagResult } from "#/tag/domain/types";
+import type { TagResult } from "#tag/domain/types";
 /**
  * Maps a tag run's result to the process exit code.
  *

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

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

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

package/dist/tag/command.js

@@ -1,11 +1,11 @@
 import { Command } from "commander";
-import { applyCommandPipeline } from "#/core/cli/command-pipeline";
-import { nodeFilesystem } from "#/core/filesystem/node";
-import { exitCodeForTagResult, formatTagJsonOutput } from "#/tag/cli-result";
-import { tagRunRequestSchema } from "#/tag/cli-schema";
-import { presentTagResult, TagProgressPresenter } from "#/tag/output";
-import { prepareTag } from "#/tag/prepare";
-import { runTag } from "#/tag/run";
+import { applyCommandPipeline } from "#core/cli/command-pipeline";
+import { nodeFilesystem } from "#core/filesystem/node";
+import { exitCodeForTagResult, formatTagJsonOutput } from "#tag/cli-result";
+import { tagRunRequestSchema } from "#tag/cli-schema";
+import { presentTagResult, TagProgressPresenter } from "#tag/output";
+import { prepareTag } from "#tag/prepare";
+import { runTag } from "#tag/run";
 const tagPipeline = {
     positional: { name: "[target]", help: "Directory or file to tag (default: auto-discover workspace packages)" },
     schema: tagRunRequestSchema,

package/dist/tag/domain/skip-filter.d.ts

@@ -1,4 +1,4 @@
-import type { TagTargetCandidate } from "#/tag/domain/types";
+import type { TagTargetCandidate } from "#tag/domain/types";
 /**
  * Partitions tag target candidates into those to tag and those to skip, matching each candidate's
  * package name against `skipPackages` as glob patterns.

package/dist/tag/domain/skip-filter.js

@@ -1,4 +1,4 @@
-import { createAnyGlobMatcher } from "#/core/glob";
+import { createAnyGlobMatcher } from "#core/glob";
 /**
  * Partitions tag target candidates into those to tag and those to skip, matching each candidate's
  * package name against `skipPackages` as glob patterns.

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

@@ -1,4 +1,4 @@
-import type { CodefastConfig } from "#/core/config/schema";
+import type { CodefastConfig } from "#core/config/schema";
 /**
  * Per-file outcome of a tag run.
  *

package/dist/tag/domain/version-summary.d.ts

@@ -1,10 +1,13 @@
-import type { TagTargetExecutionResult } from "#/tag/domain/types";
 /**
  * Collects the distinct, non-empty package versions stamped across a run's target results.
  *
  * @since 0.11.0
  */
-export declare function extractDistinctVersions(targetResults: Array<TagTargetExecutionResult>): Set<string>;
+export declare function extractDistinctVersions(targetResults: ReadonlyArray<{
+    readonly result: {
+        readonly version: string;
+    } | null;
+}>): Set<string>;
 /**
  * Summarizes a set of versions as `"none"`, the single version, or `"mixed"`.
  *

package/dist/tag/output.d.ts

@@ -1,4 +1,4 @@
-import type { TagProgressListener, TagResolvedTarget, TagResult, TagTargetExecutionResult } from "#/tag/domain/types";
+import type { TagProgressListener, TagResolvedTarget, TagResult, TagTargetExecutionResult } from "#tag/domain/types";
 /**
  * A progress listener that prints a line as each tag target starts and completes.
  *

package/dist/tag/output.js

@@ -1,4 +1,4 @@
-import { logger } from "#/core/logger";
+import { logger } from "#core/logger";
 /**
  * A progress listener that prints a line as each tag target starts and completes.
  *

package/dist/tag/prepare.d.ts

@@ -1,7 +1,7 @@
-import type { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
-import type { TagCommandPrelude } from "#/tag/domain/types";
+import type { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+import type { TagCommandPrelude } from "#tag/domain/types";
 /**
  * Resolves the repo root, config, and optional target path into the prelude a tag run starts from.
  *

package/dist/tag/prepare.js

@@ -1,7 +1,7 @@
-import { loadCodefastConfig } from "#/core/config";
-import { ok } from "#/core/result";
-import { resolveProjectRoot } from "#/core/workspace/resolver";
-import { resolveProvidedTagTargetPath } from "#/tag/target/resolve-path";
+import { loadCodefastConfig } from "#core/config";
+import { ok } from "#core/result";
+import { resolveProjectRoot } from "#core/workspace/resolver";
+import { resolveProvidedTagTargetPath } from "#tag/target/resolve-path";
 /**
  * Resolves the repo root, config, and optional target path into the prelude a tag run starts from.
  *

package/dist/tag/run.d.ts

@@ -1,7 +1,7 @@
-import { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
-import type { TagExecutionInput, TagResult } from "#/tag/domain/types";
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+import type { TagExecutionInput, TagResult } from "#tag/domain/types";
 /**
  * Applies `@since` tags across the selected targets and returns the aggregate result.
  *

package/dist/tag/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 { filterSkippedCandidates } from "#/tag/domain/skip-filter";
-import { extractDistinctVersions, summarizeVersions } from "#/tag/domain/version-summary";
-import { resolveTagTargetCandidates } from "#/tag/target/candidates";
-import { runTagOnTarget } from "#/tag/target/runner";
+import { AppError } from "#core/errors";
+import { messageFrom } from "#core/errors";
+import { err, ok } from "#core/result";
+import { filterSkippedCandidates } from "#tag/domain/skip-filter";
+import { extractDistinctVersions, summarizeVersions } from "#tag/domain/version-summary";
+import { resolveTagTargetCandidates } from "#tag/target/candidates";
+import { runTagOnTarget } from "#tag/target/runner";
 /**
  * Applies `@since` tags across the selected targets and returns the aggregate result.
  *

package/dist/tag/target/candidates.d.ts

@@ -1,5 +1,5 @@
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { TagTargetCandidate } from "#/tag/domain/types";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { TagTargetCandidate } from "#tag/domain/types";
 /**
  * Resolves the candidate targets for a tag run: the explicit target, or the discovered workspace packages.
  *

package/dist/tag/target/candidates.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import * as z from "zod";
-import { listWorkspacePackageDirectories } from "#/core/workspace/resolver";
-import { packageJsonFileName } from "#/core/workspace/well-known-files";
+import { listWorkspacePackageDirectories } from "#core/workspace/resolver";
+import { packageJsonFileName } from "#core/workspace/well-known-files";
 const packageJsonNameSchema = z.looseObject({
     name: z.string().min(1).optional(),
 });

package/dist/tag/target/resolve-path.d.ts

@@ -1,4 +1,4 @@
-import type { Filesystem } from "#/core/filesystem/filesystem";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * Canonicalizes the user-provided target path, or returns `undefined` when none was given.
  *

package/dist/tag/target/runner.d.ts

@@ -1,5 +1,5 @@
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { TagRunOptions, TagRunResult } from "#/tag/domain/types";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { TagRunOptions, TagRunResult } from "#tag/domain/types";
 /**
  * Stamps `@since` tags across one target's TypeScript files and returns the run result.
  *

package/dist/tag/target/runner.js

@@ -1,7 +1,7 @@
 import path from "node:path";
-import { walkTsxFiles } from "#/core/workspace/typescript-walk";
-import { TagSinceWriter } from "#/tag/writer/since-writer";
-import { resolveNearestPackageVersion } from "#/tag/writer/version-resolver";
+import { walkTsxFiles } from "#core/workspace/typescript-walk";
+import { TagSinceWriter } from "#tag/writer/since-writer";
+import { resolveNearestPackageVersion } from "#tag/writer/version-resolver";
 /**
  * Stamps `@since` tags across one target's TypeScript files and returns the run result.
  *

package/dist/tag/writer/since-writer.d.ts

@@ -1,5 +1,5 @@
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { TagFileResult } from "#/tag/domain/types";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { TagFileResult } from "#tag/domain/types";
 /**
  * The writer that adds missing `@since` tags to a file's exported declarations.
  *

package/dist/tag/writer/since-writer.js

@@ -1,5 +1,6 @@
 import { parseSync } from "oxc-parser";
-import { applyEditsDescending, indentOfLineContaining } from "#/core/source-text-edit";
+import { isOxcNode, programStatements } from "#core/oxc-node";
+import { applyEditsDescending, indentOfLineContaining } from "#core/source-text-edit";
 /**
  * Top-level statement kinds that carry a `@since` tag: function, class, interface,
  * type alias, enum, and variable declaration.
@@ -12,9 +13,6 @@ const TAGGABLE_DECLARATION_TYPES = new Set([
     "TSEnumDeclaration",
     "VariableDeclaration",
 ]);
-function isOxcNode(value) {
-    return typeof value === "object" && value !== null && typeof value.type === "string";
-}
 function identifierName(node) {
     if (isOxcNode(node) && node.type === "Identifier" && typeof node.name === "string") {
         return node.name;
@@ -35,7 +33,7 @@ export class TagSinceWriter {
     applySinceTagsToFile(filePath, version, write) {
         const sourceText = this.fs.readFileSync(filePath, "utf8");
         const { program, comments } = parseSync(filePath, sourceText);
-        const statements = program.body;
+        const statements = programStatements(program);
         const jsDocComments = comments.filter((comment) => comment.type === "Block" && comment.value.startsWith("*"));
         const edits = [];
         for (const declaration of this.collectExportedDeclarations(statements)) {

package/dist/tag/writer/version-resolver.d.ts

@@ -1,4 +1,4 @@
-import type { Filesystem } from "#/core/filesystem/filesystem";
+import type { Filesystem } from "#core/filesystem/filesystem";
 /**
  * Returns the `version` of the nearest enclosing `package.json` above a target path.
  *

package/dist/tag/writer/version-resolver.js

@@ -1,4 +1,4 @@
-import { findNearestPackageVersion } from "#/core/workspace/package-version";
+import { findNearestPackageVersion } from "#core/workspace/package-version";
 /**
  * Returns the `version` of the nearest enclosing `package.json` above a target path.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/cli",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Developer CLI for the Codefast monorepo (arrange, audit, mirror, pack-slim, tag)",
   "keywords": [
     "cli",
@@ -35,7 +35,7 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "imports": {
-    "#/*": {
+    "#*": {
       "types": "./dist/*.d.ts",
       "default": "./dist/*.js"
     }
@@ -51,16 +51,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@microsoft/tsdoc": "^0.16.0",
+    "@microsoft/tsdoc": "^0.17.0",
     "commander": "^15.0.0",
     "jiti": "^2.7.0",
-    "oxc-parser": "^0.148.0",
+    "oxc-parser": "^0.151.0",
     "picomatch": "^4.0.7",
-    "yaml": "^2.9.0",
-    "zod": "^4.6.2"
+    "yaml": "^2.9.1",
+    "zod": "^4.6.5"
   },
   "peerDependencies": {
-    "typescript": "^7.0.2"
+    "typescript": ">=7.0.0"
   },
   "peerDependenciesMeta": {
     "typescript": {

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

@@ -1,10 +0,0 @@
-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.
- * Returning `true` for an empty array is intentional: callers treat empty lists
- * the same regardless of the element type, so `[]` is safely accepted as `Dirent[]`.
- *
- * @since 0.3.16-canary.0
- */
-export declare function isDirentList(x: Array<string> | Array<DirectoryEntry>): x is Array<DirectoryEntry>;

package/dist/mirror/domain/dirent-guard.js

@@ -1,15 +0,0 @@
-/**
- * Narrow `fs.promises.readdir` overload result to `Dirent[]` when `withFileTypes: true`.
- * Accepts both historical checks (`isFile` / `isDirectory`) in one guard.
- * Returning `true` for an empty array is intentional: callers treat empty lists
- * the same regardless of the element type, so `[]` is safely accepted as `Dirent[]`.
- *
- * @since 0.3.16-canary.0
- */
-export function isDirentList(x) {
-    if (x.length === 0) {
-        return true;
-    }
-    const first = x[0];
-    return typeof first === "object" && first !== null && "isFile" in first && "isDirectory" in first;
-}