@codefast/cli 0.3.13-canary.1 → 0.3.13-canary.3

package/dist/lib/core/application/ports/cli-io.port.d.ts

@@ -0,0 +1,31 @@
+import type { Dirent } from "node:fs";
+/**
+ * Filesystem surface for CLI use cases — inject in tests. Implementations live in infra.
+ */
+export type CliFs = {
+    existsSync: (path: string) => boolean;
+    /**
+     * Resolve symlinks when possible; fall back to normalizing `inputPath` to an absolute path.
+     */
+    canonicalPathSync: (inputPath: string) => string;
+    statSync: (path: string) => {
+        isDirectory: () => boolean;
+        isFile: () => boolean;
+    };
+    readFileSync: (path: string, encoding: BufferEncoding) => string;
+    writeFileSync: (path: string, data: string, encoding: BufferEncoding) => void;
+    readdirSync: (path: string) => string[];
+    readFile: (path: string, encoding: BufferEncoding) => Promise<string>;
+    writeFile: (path: string, data: string, encoding: BufferEncoding) => Promise<void>;
+    readdir: (path: string, options?: {
+        recursive?: boolean;
+        withFileTypes?: boolean;
+    }) => Promise<string[] | Dirent[]>;
+    rename: (oldPath: string, newPath: string) => Promise<void>;
+    unlink: (path: string) => Promise<void>;
+};
+export type CliLogger = {
+    out: (line: string) => void;
+    err: (line: string) => void;
+};
+//# sourceMappingURL=cli-io.port.d.ts.map

package/dist/lib/core/application/ports/cli-io.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-io.port.d.ts","sourceRoot":"","sources":["../../../../../src/lib/core/application/ports/cli-io.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC;;OAEG;IACH,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,WAAW,EAAE,MAAM,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,OAAO,CAAA;KAAE,CAAC;IAClF,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,MAAM,CAAC;IACjE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9E,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACxC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KACvD,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC"}

package/dist/lib/core/application/schema-parse.util.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import { type AppError } from "#lib/core/domain/errors.domain";
+import { type Result } from "#lib/core/domain/result.model";
+/**
+ * Validates `input` with `schema`, returning {@link AppError} with code `VALIDATION_ERROR` on failure.
+ */
+export declare function parseWithSchema<T>(schema: z.ZodType<T>, input: unknown): Result<T, AppError>;
+//# sourceMappingURL=schema-parse.util.d.ts.map

package/dist/lib/core/application/schema-parse.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-parse.util.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/application/schema-parse.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAWrE;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAM5F"}

package/dist/lib/core/application/schema-parse.util.js

@@ -0,0 +1,20 @@
+import { appError } from "#lib/core/domain/errors.domain";
+import { err, ok } from "#lib/core/domain/result.model";
+function formatZodIssues(issues) {
+    return issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+        return `${path}${issue.message}`;
+    })
+        .join("; ");
+}
+/**
+ * Validates `input` with `schema`, returning {@link AppError} with code `VALIDATION_ERROR` on failure.
+ */
+export function parseWithSchema(schema, input) {
+    const parsed = schema.safeParse(input);
+    if (!parsed.success) {
+        return err(appError("VALIDATION_ERROR", formatZodIssues(parsed.error.issues)));
+    }
+    return ok(parsed.data);
+}

package/dist/lib/core/application/utils/caught-unknown-message.util.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Stable, user-facing text for values caught as `unknown`.
+ * Avoids `String(unknown)` / `[object Object]` and satisfies strict `no-base-to-string`.
+ */
+export declare function messageFromCaughtUnknown(value: unknown): string;
+//# sourceMappingURL=caught-unknown-message.util.d.ts.map

package/dist/lib/core/application/utils/caught-unknown-message.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caught-unknown-message.util.d.ts","sourceRoot":"","sources":["../../../../../src/lib/core/application/utils/caught-unknown-message.util.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4B/D"}

package/dist/lib/core/application/utils/caught-unknown-message.util.js

@@ -0,0 +1,34 @@
+/**
+ * Stable, user-facing text for values caught as `unknown`.
+ * Avoids `String(unknown)` / `[object Object]` and satisfies strict `no-base-to-string`.
+ */
+export function messageFromCaughtUnknown(value) {
+    if (value instanceof Error) {
+        return value.message;
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (typeof value === "symbol") {
+        return String(value);
+    }
+    if (value === null) {
+        return "null";
+    }
+    if (value === undefined) {
+        return "undefined";
+    }
+    try {
+        const serialized = JSON.stringify(value);
+        if (typeof serialized === "string") {
+            return serialized;
+        }
+    }
+    catch {
+        // Circular structure, BigInt in tree, etc.
+    }
+    return "[unserializable non-Error value]";
+}

package/dist/lib/core/application/utils/verbose-diagnostics.util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * When true, infrastructure failures may log full stack traces (e.g. in {@link consumeCliAppError}).
+ */
+export declare function isVerboseInfraDiagnostics(): boolean;
+//# sourceMappingURL=verbose-diagnostics.util.d.ts.map

package/dist/lib/core/application/utils/verbose-diagnostics.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-diagnostics.util.d.ts","sourceRoot":"","sources":["../../../../../src/lib/core/application/utils/verbose-diagnostics.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAGnD"}

package/dist/lib/core/application/utils/verbose-diagnostics.util.js

@@ -0,0 +1,7 @@
+/**
+ * When true, infrastructure failures may log full stack traces (e.g. in {@link consumeCliAppError}).
+ */
+export function isVerboseInfraDiagnostics() {
+    const raw = process.env.CODEFAST_VERBOSE;
+    return raw === "1" || raw === "true";
+}

package/dist/lib/core/domain/errors.domain.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cross-context application errors for Result-based use cases (CLI orchestration).
+ */
+export type AppErrorCode = "NOT_FOUND" | "VALIDATION_ERROR" | "INFRA_FAILURE";
+export type AppError = {
+    readonly code: AppErrorCode;
+    readonly message: string;
+    readonly cause?: unknown;
+};
+export declare function appError(code: AppErrorCode, message: string, cause?: unknown): AppError;
+//# sourceMappingURL=errors.domain.d.ts.map

package/dist/lib/core/domain/errors.domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.domain.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/domain/errors.domain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAE9E,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAKvF"}

package/dist/lib/core/domain/errors.domain.js

@@ -0,0 +1,9 @@
+/**
+ * Cross-context application errors for Result-based use cases (CLI orchestration).
+ */
+export function appError(code, message, cause) {
+    if (cause === undefined) {
+        return { code, message };
+    }
+    return { code, message, cause };
+}

package/dist/lib/core/domain/result.model.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Lightweight functional Result type for use-case boundaries.
+ */
+export type Ok<T> = {
+    readonly ok: true;
+    readonly value: T;
+};
+export type Err<E> = {
+    readonly ok: false;
+    readonly error: E;
+};
+export type Result<T, E> = Ok<T> | Err<E>;
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<E>(error: E): Err<E>;
+export declare function isOk<T, E>(result: Result<T, E>): result is Ok<T>;
+export declare function isErr<T, E>(result: Result<T, E>): result is Err<E>;
+//# sourceMappingURL=result.model.d.ts.map

package/dist/lib/core/domain/result.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.model.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/domain/result.model.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7D,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAEvC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAEhE;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAElE"}

package/dist/lib/core/domain/result.model.js

@@ -0,0 +1,15 @@
+/**
+ * Lightweight functional Result type for use-case boundaries.
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+export function isOk(result) {
+    return result.ok === true;
+}
+export function isErr(result) {
+    return result.ok === false;
+}

package/dist/lib/core/infra/container.adapter.d.ts

@@ -0,0 +1,58 @@
+import type { AppError } from "#lib/core/domain/errors.domain";
+import type { Result } from "#lib/core/domain/result.model";
+import type { CliFs, CliLogger } from "#lib/core/application/ports/cli-io.port";
+import type { AnalyzeDirectoryDeps } from "#lib/arrange/application/use-cases/analyze-directory.use-case";
+import type { ArrangeAnalyzeDirectoryRequest } from "#lib/arrange/application/requests/analyze-directory.request";
+import type { ArrangeSyncRunRequest } from "#lib/arrange/application/requests/arrange-sync.request";
+import type { ArrangeSuggestGroupsRequest } from "#lib/arrange/application/requests/suggest-groups.request";
+import type { ArrangeSyncDeps } from "#lib/arrange/application/use-cases/run-arrange-sync.use-case";
+import { type ArrangeSuggestGroupsOutput } from "#lib/arrange/application/use-cases/suggest-cn-groups.use-case";
+import type { AnalyzeReport } from "#lib/arrange/domain/types.domain";
+import type { ArrangeTargetWorkspaceAndConfig } from "#lib/arrange/presentation/arrange-prelude.presenter";
+import type { MirrorSyncRunDeps } from "#lib/mirror/application/use-cases/run-mirror-sync.use-case";
+import type { MirrorSyncRunRequest } from "#lib/mirror/application/requests/mirror-sync.request";
+import type { MirrorSyncCommandPrelude } from "#lib/mirror/presentation/mirror-prelude.presenter";
+import type { TagSyncExecutionInput, TagSyncRunDeps } from "#lib/tag/application/use-cases/run-tag-sync.use-case";
+import type { TagSyncResult } from "#lib/tag/domain/types.domain";
+import type { TagCommandPrelude } from "#lib/tag/presentation/tag-prelude.presenter";
+import { createTagProgressListener } from "#lib/tag/presentation/tag-sync.presenter";
+/**
+ * Composition root: wires default infra adapters and exposes thin use-case facades.
+ */
+export type CliContainer = {
+    readonly fs: CliFs;
+    readonly logger: CliLogger;
+    readonly arrange: {
+        readonly deps: AnalyzeDirectoryDeps & ArrangeSyncDeps;
+        prepareTargetWorkspaceAndConfig(args: {
+            readonly currentWorkingDirectory: string;
+            readonly rawTarget: string | undefined;
+        }): Promise<Result<ArrangeTargetWorkspaceAndConfig, AppError>>;
+        analyzeDirectory(request: ArrangeAnalyzeDirectoryRequest): Result<AnalyzeReport, AppError>;
+        runArrangeSync(request: ArrangeSyncRunRequest): Promise<Result<number, AppError>>;
+        suggestCnGroups(request: ArrangeSuggestGroupsRequest): ArrangeSuggestGroupsOutput;
+        presentAnalyzeReport(resolvedTargetPath: string, report: AnalyzeReport): void;
+    };
+    readonly mirror: {
+        readonly deps: MirrorSyncRunDeps;
+        prepareMirrorSync(args: {
+            readonly currentWorkingDirectory: string;
+            readonly packageArg: string | undefined;
+            readonly globalCliRaw: unknown;
+        }): Promise<Result<MirrorSyncCommandPrelude, AppError>>;
+        runMirrorSync(request: MirrorSyncRunRequest): Promise<Result<number, AppError>>;
+    };
+    readonly tag: {
+        readonly deps: TagSyncRunDeps;
+        prepareTagSync(args: {
+            readonly currentWorkingDirectory: string;
+            readonly rawTarget: string | undefined;
+            readonly globalCliRaw: unknown;
+        }): Promise<Result<TagCommandPrelude, AppError>>;
+        runTagSync(input: TagSyncExecutionInput): Promise<Result<TagSyncResult, AppError>>;
+        createProgressListener(emitLine: (line: string) => void): ReturnType<typeof createTagProgressListener>;
+        presentSyncCliResult(result: TagSyncResult, rootDir: string): number;
+    };
+};
+export declare function createCliContainer(): CliContainer;
+//# sourceMappingURL=container.adapter.d.ts.map

package/dist/lib/core/infra/container.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.adapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/infra/container.adapter.ts"],"names":[],"mappings":"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"}

package/dist/lib/core/infra/container.adapter.js

@@ -0,0 +1,80 @@
+import { withCliPortTelemetry, isCliTelemetryEnabled, } from "#lib/core/infra/logging-decorator.adapter";
+import { analyzeDirectory } from "#lib/arrange/application/use-cases/analyze-directory.use-case";
+import { runArrangeSync } from "#lib/arrange/application/use-cases/run-arrange-sync.use-case";
+import { suggestCnGroupsForCli, } from "#lib/arrange/application/use-cases/suggest-cn-groups.use-case";
+import { prepareArrangeTargetWorkspaceAndConfig } from "#lib/arrange/presentation/arrange-prelude.presenter";
+import { presentAnalyzeCliReport } from "#lib/arrange/presentation/present-analyze-cli.presenter";
+import { DomainSourceParserAdapter } from "#lib/arrange/infra/domain-source-parser.adapter";
+import { FileWalkerAdapter } from "#lib/arrange/infra/file-walker.adapter";
+import { createNodeCliFs, createNodeCliLogger } from "#lib/infra/node-io.adapter";
+import { runMirrorSync } from "#lib/mirror/application/use-cases/run-mirror-sync.use-case";
+import { prepareMirrorSync } from "#lib/mirror/presentation/mirror-prelude.presenter";
+import { FileSystemServiceAdapter } from "#lib/mirror/infra/file-system-service.adapter";
+import { mirrorSyncReporterAdapter } from "#lib/mirror/infra/mirror-sync-reporter.adapter";
+import { PackageRepositoryAdapter } from "#lib/mirror/infra/package-repository.adapter";
+import { WorkspaceServiceAdapter } from "#lib/mirror/infra/workspace-service.adapter";
+import { runTagSync } from "#lib/tag/application/use-cases/run-tag-sync.use-case";
+import { prepareTagSync } from "#lib/tag/presentation/tag-prelude.presenter";
+import { createTagProgressListener, presentTagSyncCliResult, } from "#lib/tag/presentation/tag-sync.presenter";
+import { tagTargetResolverAdapter } from "#lib/tag/infra/tag-target-resolver.adapter";
+import { tagTypeScriptTreeWalkAdapter } from "#lib/tag/infra/typescript-tree-walk.adapter";
+function maybeTelemetry(portName, implementation, logger) {
+    if (!isCliTelemetryEnabled()) {
+        return implementation;
+    }
+    return withCliPortTelemetry({ portName, implementation, logger });
+}
+export function createCliContainer() {
+    const logger = createNodeCliLogger();
+    const rawFs = createNodeCliFs();
+    const fs = maybeTelemetry("CliFs", rawFs, logger);
+    const fileWalker = maybeTelemetry("FileWalkerPort", new FileWalkerAdapter(logger), logger);
+    const domainSourceParser = maybeTelemetry("DomainSourceParserPort", new DomainSourceParserAdapter(logger), logger);
+    const arrangeDeps = {
+        fs,
+        logger,
+        fileWalker,
+        domainSourceParser,
+    };
+    const mirrorDeps = {
+        fs,
+        logger,
+        workspaceService: maybeTelemetry("WorkspaceServicePort", new WorkspaceServiceAdapter(), logger),
+        packageRepository: maybeTelemetry("PackageRepositoryPort", new PackageRepositoryAdapter(), logger),
+        fileSystemService: maybeTelemetry("FileSystemServicePort", new FileSystemServiceAdapter(), logger),
+        mirrorReporter: maybeTelemetry("MirrorSyncReporterPort", mirrorSyncReporterAdapter, logger),
+    };
+    const rawTagResolver = tagTargetResolverAdapter;
+    const targetResolver = maybeTelemetry("TagTargetResolverPort", rawTagResolver, logger);
+    const tagDeps = {
+        fs,
+        targetResolver,
+        typeScriptTreeWalk: maybeTelemetry("TypeScriptTreeWalkPort", tagTypeScriptTreeWalkAdapter, logger),
+    };
+    let cli;
+    cli = {
+        fs,
+        logger,
+        arrange: {
+            deps: arrangeDeps,
+            prepareTargetWorkspaceAndConfig: (args) => prepareArrangeTargetWorkspaceAndConfig(cli, args),
+            analyzeDirectory: (request) => analyzeDirectory(request, arrangeDeps),
+            runArrangeSync: (request) => runArrangeSync(request, arrangeDeps),
+            suggestCnGroups: (request) => suggestCnGroupsForCli(request),
+            presentAnalyzeReport: (resolvedTargetPath, report) => presentAnalyzeCliReport(logger, resolvedTargetPath, report),
+        },
+        mirror: {
+            deps: mirrorDeps,
+            prepareMirrorSync: (args) => prepareMirrorSync(cli, args),
+            runMirrorSync: (request) => runMirrorSync(request, mirrorDeps),
+        },
+        tag: {
+            deps: tagDeps,
+            prepareTagSync: (args) => prepareTagSync(cli, args),
+            runTagSync: (input) => runTagSync(input, tagDeps),
+            createProgressListener: (emitLine) => createTagProgressListener(emitLine),
+            presentSyncCliResult: (result, rootDir) => presentTagSyncCliResult(logger, result, rootDir),
+        },
+    };
+    return cli;
+}

package/dist/lib/core/infra/logging-decorator.adapter.d.ts

@@ -0,0 +1,12 @@
+import type { CliLogger } from "#lib/core/application/ports/cli-io.port";
+/**
+ * Wraps a port implementation (object of functions) to log call timing and summarized arguments via `logger`.
+ * Does not modify application or domain code — wire only from the composition root.
+ */
+export declare function withCliPortTelemetry<T extends object>(args: {
+    readonly portName: string;
+    readonly implementation: T;
+    readonly logger: CliLogger;
+}): T;
+export declare function isCliTelemetryEnabled(): boolean;
+//# sourceMappingURL=logging-decorator.adapter.d.ts.map

package/dist/lib/core/infra/logging-decorator.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-decorator.adapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/infra/logging-decorator.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCzE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B,GAAG,CAAC,CA+CJ;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C"}

package/dist/lib/core/infra/logging-decorator.adapter.js

@@ -0,0 +1,75 @@
+function summarizeTelemetryArg(value, maxLen = 160) {
+    if (typeof value === "string") {
+        return value.length > maxLen ? `${value.slice(0, maxLen)}…(${value.length} chars)` : value;
+    }
+    if (value === null || value === undefined) {
+        return String(value);
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (typeof value === "object") {
+        try {
+            const json = JSON.stringify(value);
+            if (typeof json === "string") {
+                return json.length > maxLen ? `${json.slice(0, maxLen)}…` : json;
+            }
+        }
+        catch {
+            return "[object]";
+        }
+    }
+    return "[value]";
+}
+function isPromiseLike(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        "then" in value &&
+        typeof value.then === "function");
+}
+/**
+ * Wraps a port implementation (object of functions) to log call timing and summarized arguments via `logger`.
+ * Does not modify application or domain code — wire only from the composition root.
+ */
+export function withCliPortTelemetry(args) {
+    const { portName, implementation, logger } = args;
+    return new Proxy(implementation, {
+        get(target, propertyKey, receiver) {
+            if (typeof propertyKey === "symbol") {
+                return Reflect.get(target, propertyKey, receiver);
+            }
+            const propertyName = String(propertyKey);
+            const value = Reflect.get(target, propertyKey, receiver);
+            if (typeof value !== "function") {
+                return value;
+            }
+            return (...callArgs) => {
+                const argSummary = callArgs.map((arg) => summarizeTelemetryArg(arg)).join(", ");
+                logger.out(`[telemetry:${portName}.${propertyName}] ← (${argSummary})`);
+                const startedAt = performance.now();
+                try {
+                    const result = value.apply(target, callArgs);
+                    if (isPromiseLike(result)) {
+                        return result.then((resolved) => {
+                            logger.out(`[telemetry:${portName}.${propertyName}] → ok ${(performance.now() - startedAt).toFixed(2)}ms`);
+                            return resolved;
+                        }, (rejection) => {
+                            logger.out(`[telemetry:${portName}.${propertyName}] → err ${(performance.now() - startedAt).toFixed(2)}ms`);
+                            throw rejection;
+                        });
+                    }
+                    logger.out(`[telemetry:${portName}.${propertyName}] → ${(performance.now() - startedAt).toFixed(2)}ms`);
+                    return result;
+                }
+                catch (caughtSyncError) {
+                    logger.out(`[telemetry:${portName}.${propertyName}] → err ${(performance.now() - startedAt).toFixed(2)}ms`);
+                    throw caughtSyncError;
+                }
+            };
+        },
+    });
+}
+export function isCliTelemetryEnabled() {
+    const raw = process.env.ENABLE_TELEMETRY;
+    return raw === "1" || raw === "true";
+}

package/dist/lib/core/presentation/cli-executor.presenter.d.ts

@@ -0,0 +1,33 @@
+import type { AppError } from "#lib/core/domain/errors.domain";
+import type { Result } from "#lib/core/domain/result.model";
+import type { CliLogger } from "#lib/core/application/ports/cli-io.port";
+/**
+ * Maps {@link AppError} codes to `process.exitCode` for CLI commands.
+ */
+export declare function exitCodeForAppError(error: AppError): number;
+/**
+ * When `outcome` is {@link Err}, logs via {@link formatAppError}, sets `process.exitCode`, returns `false`.
+ * When `Ok`, optionally logs `successMessage` to stdout and returns `true`.
+ */
+export declare function consumeCliAppError<T>(logger: CliLogger, outcome: Result<T, AppError>, options?: {
+    readonly successMessage?: string;
+}): outcome is {
+    readonly ok: true;
+    readonly value: T;
+};
+/**
+ * Awaits a use case and applies the same handling as {@link consumeCliAppError}.
+ */
+export declare function consumeCliAppErrorAsync<T>(logger: CliLogger, outcomePromise: Promise<Result<T, AppError>>, options?: {
+    readonly successMessage?: string;
+}): Promise<Result<T, AppError>>;
+/**
+ * Completes CLI handling: errors are logged and `process.exitCode` is set; success runs `onSuccess`
+ * and assigns `process.exitCode` from its return value (default `0`).
+ */
+export declare function runCliResult<T>(logger: CliLogger, outcome: Result<T, AppError>, onSuccess: (value: T) => number | void): void;
+/**
+ * Async variant of {@link runCliResult}.
+ */
+export declare function runCliResultAsync<T>(logger: CliLogger, outcomePromise: Promise<Result<T, AppError>>, onSuccess: (value: T) => number | void | Promise<number | void>): Promise<void>;
+//# sourceMappingURL=cli-executor.presenter.d.ts.map

package/dist/lib/core/presentation/cli-executor.presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-executor.presenter.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/presentation/cli-executor.presenter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAY3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,EAC5B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAkBrD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAC5C,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAI9B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,EAC5B,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GACrC,IAAI,CAMN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAC5C,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC9D,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/lib/core/presentation/cli-executor.presenter.js

@@ -0,0 +1,73 @@
+import process from "node:process";
+import { formatAppError } from "#lib/core/presentation/format-app-error.presenter";
+import { isVerboseInfraDiagnostics } from "#lib/core/application/utils/verbose-diagnostics.util";
+function assertExhaustiveAppErrorCode(code) {
+    return code;
+}
+/**
+ * Maps {@link AppError} codes to `process.exitCode` for CLI commands.
+ */
+export function exitCodeForAppError(error) {
+    const { code } = error;
+    switch (code) {
+        case "NOT_FOUND":
+            return 1;
+        case "VALIDATION_ERROR":
+            return 1;
+        case "INFRA_FAILURE":
+            return 1;
+        default:
+            return assertExhaustiveAppErrorCode(code);
+    }
+}
+/**
+ * When `outcome` is {@link Err}, logs via {@link formatAppError}, sets `process.exitCode`, returns `false`.
+ * When `Ok`, optionally logs `successMessage` to stdout and returns `true`.
+ */
+export function consumeCliAppError(logger, outcome, options) {
+    if (!outcome.ok) {
+        logger.err(formatAppError(outcome.error));
+        if (isVerboseInfraDiagnostics() &&
+            outcome.error.code === "INFRA_FAILURE" &&
+            outcome.error.cause instanceof Error &&
+            outcome.error.cause.stack !== undefined) {
+            logger.err(outcome.error.cause.stack);
+        }
+        process.exitCode = exitCodeForAppError(outcome.error);
+        return false;
+    }
+    if (options?.successMessage !== undefined) {
+        logger.out(options.successMessage);
+    }
+    return true;
+}
+/**
+ * Awaits a use case and applies the same handling as {@link consumeCliAppError}.
+ */
+export async function consumeCliAppErrorAsync(logger, outcomePromise, options) {
+    const outcome = await outcomePromise;
+    consumeCliAppError(logger, outcome, options);
+    return outcome;
+}
+/**
+ * Completes CLI handling: errors are logged and `process.exitCode` is set; success runs `onSuccess`
+ * and assigns `process.exitCode` from its return value (default `0`).
+ */
+export function runCliResult(logger, outcome, onSuccess) {
+    if (!consumeCliAppError(logger, outcome)) {
+        return;
+    }
+    const exit = onSuccess(outcome.value);
+    process.exitCode = exit === undefined ? 0 : exit;
+}
+/**
+ * Async variant of {@link runCliResult}.
+ */
+export async function runCliResultAsync(logger, outcomePromise, onSuccess) {
+    const outcome = await outcomePromise;
+    if (!consumeCliAppError(logger, outcome)) {
+        return;
+    }
+    const exit = await onSuccess(outcome.value);
+    process.exitCode = exit === undefined ? 0 : exit;
+}

package/dist/lib/core/presentation/format-app-error.presenter.d.ts

@@ -0,0 +1,6 @@
+import type { AppError } from "#lib/core/domain/errors.domain";
+/**
+ * Stable, user-facing line for CLI output. Exhaustive over every `AppError["code"]`.
+ */
+export declare function formatAppError(error: AppError): string;
+//# sourceMappingURL=format-app-error.presenter.d.ts.map

package/dist/lib/core/presentation/format-app-error.presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-app-error.presenter.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/presentation/format-app-error.presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM/D;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAYtD"}

package/dist/lib/core/presentation/format-app-error.presenter.js

@@ -0,0 +1,19 @@
+function assertExhaustiveAppErrorCode(code) {
+    return `Unhandled error code: ${String(code)}`;
+}
+/**
+ * Stable, user-facing line for CLI output. Exhaustive over every `AppError["code"]`.
+ */
+export function formatAppError(error) {
+    const { code, message } = error;
+    switch (code) {
+        case "NOT_FOUND":
+            return `[NOT_FOUND] ${message}`;
+        case "VALIDATION_ERROR":
+            return `[VALIDATION_ERROR] ${message}`;
+        case "INFRA_FAILURE":
+            return `[INFRA_FAILURE] ${message}`;
+        default:
+            return assertExhaustiveAppErrorCode(code);
+    }
+}

package/dist/lib/core/presentation/global-cli-options.presenter.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AppError } from "#lib/core/domain/errors.domain";
+import type { Result } from "#lib/core/domain/result.model";
+export declare const GlobalCliOptionsSchema: z.ZodObject<{
+    color: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GlobalCliOptions = z.infer<typeof GlobalCliOptionsSchema>;
+export declare function parseGlobalCliOptions(raw: unknown): Result<GlobalCliOptions, AppError>;
+//# sourceMappingURL=global-cli-options.presenter.d.ts.map

package/dist/lib/core/presentation/global-cli-options.presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-cli-options.presenter.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/presentation/global-cli-options.presenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAEtF"}

package/dist/lib/core/presentation/global-cli-options.presenter.js

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import { parseWithSchema } from "#lib/core/application/schema-parse.util";
+export const GlobalCliOptionsSchema = z.object({
+    color: z.boolean().optional(),
+});
+export function parseGlobalCliOptions(raw) {
+    return parseWithSchema(GlobalCliOptionsSchema, raw);
+}

package/dist/lib/core/presentation/load-codefast-config.presenter.d.ts

@@ -0,0 +1,8 @@
+import { type AppError } from "#lib/core/domain/errors.domain";
+import { type Result } from "#lib/core/domain/result.model";
+import type { CliContainer } from "#lib/core/infra/container.adapter";
+import type { CodefastConfig } from "#lib/config/domain/schema.domain";
+export declare function tryLoadCodefastConfig(cli: CliContainer, rootDir: string): Promise<Result<{
+    config: CodefastConfig;
+}, AppError>>;
+//# sourceMappingURL=load-codefast-config.presenter.d.ts.map

package/dist/lib/core/presentation/load-codefast-config.presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-codefast-config.presenter.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/presentation/load-codefast-config.presenter.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,EAAE,QAAQ,CAAC,CAAC,CAQvD"}