@effected/workspaces 0.12.0 → 0.13.0

package/ConfigDependencyHooks.js

@@ -293,7 +293,10 @@ var ConfigDependencyHooks = class ConfigDependencyHooks extends Context.Service(
 				const candidatePath = join(root, "node_modules", ".pnpm-config", name, filename);
 				const candidateUrl = pathToFileURL(candidatePath).href;
 				const result = yield* Effect.result(Effect.tryPromise({
-					try: () => import(candidateUrl),
+					try: () => import(
+						/* webpackIgnore: true */
+						candidateUrl
+),
 					catch: (cause) => cause
 				}));
 				if (Result.isSuccess(result)) {

package/PackageManagerName.js

@@ -15,6 +15,35 @@ const PackageManagerName = Schema.Literals([
 	"bun"
 ]);
 /**
+* The markers {@link PackageManagerDetector} probes, in the priority order it
+* probes them.
+*
+* @remarks
+* One vocabulary serves both halves of the detection contract: the failure path
+* reports every member as `PackageManagerDetectionError.checked`, and the
+* success path reports the one that fired as
+* `DetectedPackageManager.evidence`. A closed literal union rather than
+* free text, so a consumer logging *why* a workspace was classified asserts
+* against the kit's vocabulary instead of re-deriving the probe with its own
+* filesystem reads.
+*
+* The `package.json#…` spellings name manifest *fields*; the rest are marker
+* files at the workspace root.
+*
+* @public
+*/
+const PackageManagerEvidence = Schema.Literals([
+	"pnpm-workspace.yaml",
+	"bun.lock",
+	"bun.lockb",
+	"yarn.lock",
+	"package.json#workspaces",
+	"pnpm-lock.yaml",
+	"package-lock.json",
+	"package.json#devEngines.packageManager",
+	"package.json#packageManager"
+]);
+/**
 * The outcome of package-manager detection at a workspace root.
 *
 * @remarks
@@ -25,6 +54,15 @@ const PackageManagerName = Schema.Literals([
 * `devEngines.packageManager`; see {@link PackageManagerDetector} for the
 * precedence between them.
 *
+* `evidence` is the rung of the priority order that decided the **name** — the
+* verdict's provenance, in the same vocabulary the failure path reports as
+* `PackageManagerDetectionError.checked`. For the bun and yarn rungs the
+* lockfile is the recorded signal even though the rung is a conjunction (the
+* lockfile *plus* a manifest field naming the manager): the manifest field alone
+* would have resolved in the declaration tier, so the lockfile is what this rung
+* added. The version's provenance is deliberately not carried — it follows the
+* two-field precedence above, which is a rule, not a probe.
+*
 * @public
 */
 var DetectedPackageManager = class extends Schema.Class("DetectedPackageManager")({
@@ -33,7 +71,9 @@ var DetectedPackageManager = class extends Schema.Class("DetectedPackageManager"
 	/** Its version, when a manifest field agrees on the manager and carries one. */
 	version: Schema.Option(Schema.String),
 	/** The JavaScript runtime the manager implies. */
-	runtime: Schema.Literals(["node", "bun"])
+	runtime: Schema.Literals(["node", "bun"]),
+	/** The rung of the priority order that decided the name. */
+	evidence: PackageManagerEvidence
 }) {};
 /** Whether `value` is a non-null, non-array object — corepack's own shape test. */
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
@@ -97,18 +137,11 @@ var PackageManagerDetectionError = class extends Schema.TaggedError()("PackageMa
 		return `No package manager detected at ${this.root} (checked ${this.checked.join(", ")})`;
 	}
 };
-/** The markers probed, in priority order. Exposed on the error so the contract is not prose-only. */
-const CHECKED = [
-	"pnpm-workspace.yaml",
-	"bun.lock",
-	"bun.lockb",
-	"yarn.lock",
-	"package.json#workspaces",
-	"pnpm-lock.yaml",
-	"package-lock.json",
-	"package.json#packageManager",
-	"package.json#devEngines.packageManager"
-];
+/**
+* The markers probed, in priority order. Derived from the evidence vocabulary so
+* the failure path's `checked` and the success path's `evidence` cannot drift.
+*/
+const CHECKED = PackageManagerEvidence.literals;
 /**
 * Detects which package manager owns a workspace root.
 *
@@ -219,44 +252,52 @@ var PackageManagerDetector = class PackageManagerDetector extends Context.Servic
 			if (yield* has(root, "pnpm-workspace.yaml")) return DetectedPackageManager.make({
 				name: "pnpm",
 				version: versionFor(hints, "pnpm"),
-				runtime: "node"
+				runtime: "node",
+				evidence: "pnpm-workspace.yaml"
 			});
-			const bunLock = (yield* has(root, "bun.lock")) || (yield* has(root, "bun.lockb"));
-			if (bunLock && namesManager(hints, "bun")) return DetectedPackageManager.make({
+			const bunLock = (yield* has(root, "bun.lock")) ? Option.some("bun.lock") : (yield* has(root, "bun.lockb")) ? Option.some("bun.lockb") : Option.none();
+			if (Option.isSome(bunLock) && namesManager(hints, "bun")) return DetectedPackageManager.make({
 				name: "bun",
 				version: versionFor(hints, "bun"),
-				runtime: "bun"
+				runtime: "bun",
+				evidence: bunLock.value
 			});
 			if ((yield* has(root, "yarn.lock")) && namesManager(hints, "yarn")) return DetectedPackageManager.make({
 				name: "yarn",
 				version: versionFor(hints, "yarn"),
-				runtime: "node"
+				runtime: "node",
+				evidence: "yarn.lock"
 			});
 			const workspaces = Option.map(manifest, (fields) => fields.workspaces);
 			if (Option.isSome(workspaces) && workspaces.value !== void 0 && workspaces.value !== null) return DetectedPackageManager.make({
 				name: "npm",
 				version: versionFor(hints, "npm"),
-				runtime: "node"
+				runtime: "node",
+				evidence: "package.json#workspaces"
 			});
 			if (yield* has(root, "pnpm-lock.yaml")) return DetectedPackageManager.make({
 				name: "pnpm",
 				version: versionFor(hints, "pnpm"),
-				runtime: "node"
+				runtime: "node",
+				evidence: "pnpm-lock.yaml"
 			});
-			if (bunLock && namesManager(hints, "bun")) return DetectedPackageManager.make({
+			if (Option.isSome(bunLock) && namesManager(hints, "bun")) return DetectedPackageManager.make({
 				name: "bun",
 				version: versionFor(hints, "bun"),
-				runtime: "bun"
+				runtime: "bun",
+				evidence: bunLock.value
 			});
 			if ((yield* has(root, "yarn.lock")) && namesManager(hints, "yarn")) return DetectedPackageManager.make({
 				name: "yarn",
 				version: versionFor(hints, "yarn"),
-				runtime: "node"
+				runtime: "node",
+				evidence: "yarn.lock"
 			});
 			if (yield* has(root, "package-lock.json")) return DetectedPackageManager.make({
 				name: "npm",
 				version: versionFor(hints, "npm"),
-				runtime: "node"
+				runtime: "node",
+				evidence: "package-lock.json"
 			});
 			const declared = declaredName(hints);
 			if (Option.isSome(declared)) {
@@ -264,7 +305,8 @@ var PackageManagerDetector = class PackageManagerDetector extends Context.Servic
 				if (name === "pnpm" || name === "npm" || name === "yarn" || name === "bun") return DetectedPackageManager.make({
 					name,
 					version: versionFor(hints, name),
-					runtime: name === "bun" ? "bun" : "node"
+					runtime: name === "bun" ? "bun" : "node",
+					evidence: Option.isSome(hints.devEngines) ? "package.json#devEngines.packageManager" : "package.json#packageManager"
 				});
 			}
 			return yield* Effect.fail(new PackageManagerDetectionError({
@@ -307,7 +349,12 @@ var PackageManagerDetector = class PackageManagerDetector extends Context.Servic
 	* const TestDetector = PackageManagerDetector.layerTest({
 	*   detect: () =>
 	*     Effect.succeed(
-	*       DetectedPackageManager.make({ name: "pnpm", version: Option.none(), runtime: "node" }),
+	*       DetectedPackageManager.make({
+	*         name: "pnpm",
+	*         version: Option.none(),
+	*         runtime: "node",
+	*         evidence: "pnpm-workspace.yaml",
+	*       }),
 	*     ),
 	* });
 	* ```
@@ -331,4 +378,4 @@ var PackageManagerDetector = class PackageManagerDetector extends Context.Servic
 };
 
 //#endregion
-export { DetectedPackageManager, PackageManagerDetectionError, PackageManagerDetector, PackageManagerName };
+export { DetectedPackageManager, PackageManagerDetectionError, PackageManagerDetector, PackageManagerEvidence, PackageManagerName };

package/index.d.ts

@@ -1069,6 +1069,32 @@ declare const PackageManagerName: Schema.Literals<readonly ["npm", "pnpm", "yarn
  * @public
  */
 type PackageManagerName = typeof PackageManagerName.Type;
+/**
+ * The markers {@link PackageManagerDetector} probes, in the priority order it
+ * probes them.
+ *
+ * @remarks
+ * One vocabulary serves both halves of the detection contract: the failure path
+ * reports every member as `PackageManagerDetectionError.checked`, and the
+ * success path reports the one that fired as
+ * `DetectedPackageManager.evidence`. A closed literal union rather than
+ * free text, so a consumer logging *why* a workspace was classified asserts
+ * against the kit's vocabulary instead of re-deriving the probe with its own
+ * filesystem reads.
+ *
+ * The `package.json#…` spellings name manifest *fields*; the rest are marker
+ * files at the workspace root.
+ *
+ * @public
+ */
+declare const PackageManagerEvidence: Schema.Literals<readonly ["pnpm-workspace.yaml", "bun.lock", "bun.lockb", "yarn.lock", "package.json#workspaces", "pnpm-lock.yaml", "package-lock.json", "package.json#devEngines.packageManager", "package.json#packageManager"]>;
+/**
+ * The decoded type of {@link (PackageManagerEvidence:variable)}: the marker
+ * that decided a detection.
+ *
+ * @public
+ */
+type PackageManagerEvidence = typeof PackageManagerEvidence.Type;
 declare const DetectedPackageManager_base: Schema.Class<DetectedPackageManager, Schema.Struct<{
   /** The detected manager. */
   readonly name: Schema.Literals<readonly ["npm", "pnpm", "yarn", "bun"]>;
@@ -1076,6 +1102,8 @@ declare const DetectedPackageManager_base: Schema.Class<DetectedPackageManager,
   readonly version: Schema.Option<Schema.String>;
   /** The JavaScript runtime the manager implies. */
   readonly runtime: Schema.Literals<readonly ["node", "bun"]>;
+  /** The rung of the priority order that decided the name. */
+  readonly evidence: Schema.Literals<readonly ["pnpm-workspace.yaml", "bun.lock", "bun.lockb", "yarn.lock", "package.json#workspaces", "pnpm-lock.yaml", "package-lock.json", "package.json#devEngines.packageManager", "package.json#packageManager"]>;
 }>, {}>;
 /**
  * The outcome of package-manager detection at a workspace root.
@@ -1088,6 +1116,15 @@ declare const DetectedPackageManager_base: Schema.Class<DetectedPackageManager,
  * `devEngines.packageManager`; see {@link PackageManagerDetector} for the
  * precedence between them.
  *
+ * `evidence` is the rung of the priority order that decided the **name** — the
+ * verdict's provenance, in the same vocabulary the failure path reports as
+ * `PackageManagerDetectionError.checked`. For the bun and yarn rungs the
+ * lockfile is the recorded signal even though the rung is a conjunction (the
+ * lockfile *plus* a manifest field naming the manager): the manifest field alone
+ * would have resolved in the declaration tier, so the lockfile is what this rung
+ * added. The version's provenance is deliberately not carried — it follows the
+ * two-field precedence above, which is a rule, not a probe.
+ *
  * @public
  */
 declare class DetectedPackageManager extends DetectedPackageManager_base {}
@@ -1209,7 +1246,12 @@ declare class PackageManagerDetector extends PackageManagerDetector_base {
    * const TestDetector = PackageManagerDetector.layerTest({
    *   detect: () =>
    *     Effect.succeed(
-   *       DetectedPackageManager.make({ name: "pnpm", version: Option.none(), runtime: "node" }),
+   *       DetectedPackageManager.make({
+   *         name: "pnpm",
+   *         version: Option.none(),
+   *         runtime: "node",
+   *         evidence: "pnpm-workspace.yaml",
+   *       }),
    *     ),
    * });
    * ```
@@ -3030,5 +3072,5 @@ interface GetWorkspacePackagesSyncOptions extends WorkspacesSyncOptions {
  */
 declare const getWorkspacePackagesSync: (root: string, options: GetWorkspacePackagesSyncOptions) => ReadonlyArray<WorkspacePackage>;
 //#endregion
-export { type CatalogAssemblyFailure, CatalogSet, ChangeDetectionError, type ChangeDetectionFailure, ChangeDetectionOptions, ChangeDetector, type ChangeDetectorShape, type ClassifyOptions, ConfigDependencyHooks, type ConfigDependencyHooksShape, CyclicDependencyError, type DependencyDiff, DependencyGraph, DetectedPackageManager, type FindWorkspaceRootOptions, type GetWorkspacePackagesSyncOptions, type HookInjection, type ImporterVersions, LockfileReadError, type LockfileReadFailure, LockfileReader, type LockfileReaderOptions, type LockfileReaderShape, PackageManagerDetectionError, type PackageManagerDetectionFailure, PackageManagerDetector, type PackageManagerDetectorShape, PackageManagerName, PackageNotFoundError, type PackageRelease, PackageStateSnapshot, PublishConfig, PublishTarget, PublishabilityDetector, type PublishabilityDetectorShape, ReleaseTag, type SyncFileSystem, type SyncPath, type TagClassification, type TagFormatOptions, TagStyle, TrackingTag, type TrackingTagOptions, type VersioningDetectOptions, VersioningStrategy, VersioningStrategyType, WORKSPACE_MARKERS, WorkspaceCatalogs, type WorkspaceCatalogsOptions, type WorkspaceCatalogsShape, WorkspaceDiscovery, WorkspaceDiscoveryError, type WorkspaceDiscoveryFailure, type WorkspaceDiscoveryOptions, type WorkspaceDiscoveryShape, WorkspaceInfo, type WorkspaceLookupFailure, WorkspaceManifestError, WorkspacePackage, WorkspacePatternError, WorkspaceRoot, WorkspaceRootNotFoundError, type WorkspaceRootShape, type WorkspaceSnapshotAtFailure, type WorkspaceSnapshotWorktreeFailure, WorkspaceSnapshots, type WorkspaceSnapshotsOptions, type WorkspaceSnapshotsShape, WorkspaceStateSnapshot, Workspaces, type WorkspacesOptions, type WorkspacesServices, type WorkspacesSyncOptions, classifyTag, findWorkspaceRootSync, getWorkspacePackagesSync };
+export { type CatalogAssemblyFailure, CatalogSet, ChangeDetectionError, type ChangeDetectionFailure, ChangeDetectionOptions, ChangeDetector, type ChangeDetectorShape, type ClassifyOptions, ConfigDependencyHooks, type ConfigDependencyHooksShape, CyclicDependencyError, type DependencyDiff, DependencyGraph, DetectedPackageManager, type FindWorkspaceRootOptions, type GetWorkspacePackagesSyncOptions, type HookInjection, type ImporterVersions, LockfileReadError, type LockfileReadFailure, LockfileReader, type LockfileReaderOptions, type LockfileReaderShape, PackageManagerDetectionError, type PackageManagerDetectionFailure, PackageManagerDetector, type PackageManagerDetectorShape, PackageManagerEvidence, PackageManagerName, PackageNotFoundError, type PackageRelease, PackageStateSnapshot, PublishConfig, PublishTarget, PublishabilityDetector, type PublishabilityDetectorShape, ReleaseTag, type SyncFileSystem, type SyncPath, type TagClassification, type TagFormatOptions, TagStyle, TrackingTag, type TrackingTagOptions, type VersioningDetectOptions, VersioningStrategy, VersioningStrategyType, WORKSPACE_MARKERS, WorkspaceCatalogs, type WorkspaceCatalogsOptions, type WorkspaceCatalogsShape, WorkspaceDiscovery, WorkspaceDiscoveryError, type WorkspaceDiscoveryFailure, type WorkspaceDiscoveryOptions, type WorkspaceDiscoveryShape, WorkspaceInfo, type WorkspaceLookupFailure, WorkspaceManifestError, WorkspacePackage, WorkspacePatternError, WorkspaceRoot, WorkspaceRootNotFoundError, type WorkspaceRootShape, type WorkspaceSnapshotAtFailure, type WorkspaceSnapshotWorktreeFailure, WorkspaceSnapshots, type WorkspaceSnapshotsOptions, type WorkspaceSnapshotsShape, WorkspaceStateSnapshot, Workspaces, type WorkspacesOptions, type WorkspacesServices, type WorkspacesSyncOptions, classifyTag, findWorkspaceRootSync, getWorkspacePackagesSync };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -4,7 +4,7 @@ import { PackageNotFoundError, WorkspaceDiscovery, WorkspaceDiscoveryError, Work
 import { CyclicDependencyError, DependencyGraph } from "./DependencyGraph.js";
 import { ChangeDetectionError, ChangeDetectionOptions, ChangeDetector } from "./ChangeDetector.js";
 import { ConfigDependencyHooks } from "./ConfigDependencyHooks.js";
-import { DetectedPackageManager, PackageManagerDetectionError, PackageManagerDetector, PackageManagerName } from "./PackageManagerName.js";
+import { DetectedPackageManager, PackageManagerDetectionError, PackageManagerDetector, PackageManagerEvidence, PackageManagerName } from "./PackageManagerName.js";
 import { LockfileReadError, LockfileReader } from "./LockfileReader.js";
 import { PublishTarget, PublishabilityDetector } from "./Publishability.js";
 import { ReleaseTag, TagStyle, TrackingTag, classifyTag } from "./ReleaseTag.js";
@@ -15,4 +15,4 @@ import { WorkspaceSnapshots } from "./WorkspaceSnapshots.js";
 import { Workspaces } from "./Workspaces.js";
 import { findWorkspaceRootSync, getWorkspacePackagesSync } from "./WorkspacesSync.js";
 
-export { CatalogSet, ChangeDetectionError, ChangeDetectionOptions, ChangeDetector, ConfigDependencyHooks, CyclicDependencyError, DependencyGraph, DetectedPackageManager, LockfileReadError, LockfileReader, PackageManagerDetectionError, PackageManagerDetector, PackageManagerName, PackageNotFoundError, PackageStateSnapshot, PublishConfig, PublishTarget, PublishabilityDetector, ReleaseTag, TagStyle, TrackingTag, VersioningStrategy, VersioningStrategyType, WORKSPACE_MARKERS, WorkspaceCatalogs, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspaceInfo, WorkspaceManifestError, WorkspacePackage, WorkspacePatternError, WorkspaceRoot, WorkspaceRootNotFoundError, WorkspaceSnapshots, WorkspaceStateSnapshot, Workspaces, classifyTag, findWorkspaceRootSync, getWorkspacePackagesSync };
+export { CatalogSet, ChangeDetectionError, ChangeDetectionOptions, ChangeDetector, ConfigDependencyHooks, CyclicDependencyError, DependencyGraph, DetectedPackageManager, LockfileReadError, LockfileReader, PackageManagerDetectionError, PackageManagerDetector, PackageManagerEvidence, PackageManagerName, PackageNotFoundError, PackageStateSnapshot, PublishConfig, PublishTarget, PublishabilityDetector, ReleaseTag, TagStyle, TrackingTag, VersioningStrategy, VersioningStrategyType, WORKSPACE_MARKERS, WorkspaceCatalogs, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspaceInfo, WorkspaceManifestError, WorkspacePackage, WorkspacePatternError, WorkspaceRoot, WorkspaceRootNotFoundError, WorkspaceSnapshots, WorkspaceStateSnapshot, Workspaces, classifyTag, findWorkspaceRootSync, getWorkspacePackagesSync };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/workspaces",
-	"version": "0.12.0",
+	"version": "0.13.0",
 	"private": false,
 	"description": "Monorepo workspace tooling as Effect services — root discovery, package enumeration, the dependency graph, package-manager detection, pnpm catalog resolution, lockfile IO and git-based change detection.",
 	"keywords": [
@@ -47,11 +47,11 @@
 	},
 	"dependencies": {
 		"@effected/commands": "^0.4.0",
-		"@effected/git": "^0.7.0",
+		"@effected/git": "^0.8.0",
 		"@effected/glob": "^0.3.0",
 		"@effected/lockfiles": "^0.4.1",
 		"@effected/npm": "^0.9.0",
-		"@effected/package-json": "^0.8.0",
+		"@effected/package-json": "^0.9.0",
 		"@effected/semver": "^0.4.0",
 		"@effected/walker": "^0.4.0",
 		"@effected/yaml": "^0.8.0",