@savvy-web/silk-effects 1.0.0 → 1.1.0

package/changesets/index.js

@@ -25,8 +25,8 @@ import { MergeSectionsPlugin } from "./remark/plugins/merge-sections.js";
 import { NormalizeFormatPlugin } from "./remark/plugins/normalize-format.js";
 import { ReorderSectionsPlugin } from "./remark/plugins/reorder-sections.js";
 import { ChangelogTransformer } from "./api/transformer.js";
-import { ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, makeConfigInspectorTest } from "./services/config-inspector.js";
-import { BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, makeBranchAnalyzerTest } from "./services/branch-analyzer.js";
+import { ClassificationReasonSchema, ClassificationSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, InspectedConfigSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, makeConfigInspectorTest } from "./services/config-inspector.js";
+import { BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, FileStatusSchema, makeBranchAnalyzerTest } from "./services/branch-analyzer.js";
 import { ChangelogService, ChangelogServiceBase } from "./services/changelog.js";
 import { WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive } from "./services/workspace-snapshot.js";
 import { SectionCategorySchema } from "./categories/types.js";
@@ -49,9 +49,11 @@ import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/pres
 //#region src/changesets/index.ts
 var changesets_exports = /* @__PURE__ */ __exportAll({
 	AggregateDependencyTablesPlugin: () => AggregateDependencyTablesPlugin,
+	BranchAnalysisSchema: () => BranchAnalysisSchema,
 	BranchAnalyzer: () => BranchAnalyzer,
 	BranchAnalyzerBase: () => BranchAnalyzerBase,
 	BranchAnalyzerLive: () => BranchAnalyzerLive,
+	BranchFileEntrySchema: () => BranchFileEntrySchema,
 	Categories: () => Categories,
 	Changelog: () => Changelog,
 	ChangelogService: () => ChangelogService,
@@ -63,6 +65,8 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	ChangesetSummarySchema: () => ChangesetSummarySchema,
 	ChangesetValidationError: () => ChangesetValidationError,
 	ChangesetValidationErrorBase: () => ChangesetValidationErrorBase,
+	ClassificationReasonSchema: () => ClassificationReasonSchema,
+	ClassificationSchema: () => ClassificationSchema,
 	CommitHashSchema: () => CommitHashSchema,
 	ConfigInspector: () => ConfigInspector,
 	ConfigInspectorBase: () => ConfigInspectorBase,
@@ -80,6 +84,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	DependencyTableTypeSchema: () => DependencyTableTypeSchema,
 	DependencyTypeSchema: () => DependencyTypeSchema,
 	DependencyUpdateSchema: () => DependencyUpdateSchema,
+	FileStatusSchema: () => FileStatusSchema,
 	GitError: () => GitError,
 	GitErrorBase: () => GitErrorBase,
 	GitHubApiError: () => GitHubApiError,
@@ -90,6 +95,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	GitHubServiceBase: () => GitHubServiceBase,
 	GlobSchema: () => GlobSchema,
 	HeadingHierarchyRule: () => HeadingHierarchyRule,
+	InspectedConfigSchema: () => InspectedConfigSchema,
 	IssueLinkRefsPlugin: () => IssueLinkRefsPlugin,
 	IssueNumberSchema: () => IssueNumberSchema,
 	JsonPathSchema: () => JsonPathSchema,
@@ -114,6 +120,8 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	ReorderSectionsPlugin: () => ReorderSectionsPlugin,
 	RepoSchema: () => RepoSchema,
 	RequiredSectionsRule: () => RequiredSectionsRule,
+	ResolvedPackageScopeSchema: () => ResolvedPackageScopeSchema,
+	ResolvedVersionFileSchema: () => ResolvedVersionFileSchema,
 	SectionCategorySchema: () => SectionCategorySchema,
 	SilkChangesetPreset: () => SilkChangesetPreset,
 	SilkChangesetTransformPreset: () => SilkChangesetTransformPreset,

package/changesets/services/branch-analyzer.js

@@ -1,6 +1,6 @@
 import { GitError } from "../errors.js";
-import { ConfigInspector } from "./config-inspector.js";
-import { Context, Effect, Layer } from "effect";
+import { ClassificationReasonSchema, ConfigInspector } from "./config-inspector.js";
+import { Context, Effect, Layer, Schema } from "effect";
 import { execFileSync } from "node:child_process";
 
 //#region src/changesets/services/branch-analyzer.ts
@@ -45,6 +45,23 @@ import { execFileSync } from "node:child_process";
 *
 * @packageDocumentation
 */
+/** Git diff status as reported by `--name-status`. @public */
+const FileStatusSchema = Schema.Literal("added", "modified", "deleted", "renamed", "copied", "typechange", "unmerged", "unknown").annotations({ identifier: "FileStatus" });
+/** One file entry in the branch analysis output. @public */
+const BranchFileEntrySchema = Schema.Struct({
+	path: Schema.String.annotations({ description: "Repo-relative path (the new path in the case of renames)." }),
+	status: FileStatusSchema,
+	package: Schema.NullOr(Schema.String).annotations({ description: "Owning package, or null if outside every known release surface." }),
+	reason: ClassificationReasonSchema
+}).annotations({ identifier: "BranchFileEntry" });
+/** Structured result of analyzing the current branch against its base. @public */
+const BranchAnalysisSchema = Schema.Struct({
+	baseBranch: Schema.String,
+	mergeBaseSha: Schema.String,
+	files: Schema.Array(BranchFileEntrySchema),
+	packagesAffected: Schema.Array(Schema.String),
+	unmappedFiles: Schema.Array(Schema.String).annotations({ description: "Repo-relative paths whose package is null — candidates for an AskUserQuestion." })
+}).annotations({ identifier: "BranchAnalysis" });
 const _tag = Context.Tag("BranchAnalyzer");
 /**
 * Base class for {@link BranchAnalyzer}.
@@ -275,4 +292,4 @@ function makeBranchAnalyzerTest(fixed) {
 }
 
 //#endregion
-export { BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, makeBranchAnalyzerTest };
+export { BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, FileStatusSchema, makeBranchAnalyzerTest };

package/changesets/services/config-inspector.js

@@ -1,8 +1,10 @@
 import { ConfigurationError } from "../errors.js";
 import { ChangesetOptionsSchema } from "../schemas/options.js";
 import { ChangesetConfigReader } from "../../services/ChangesetConfigReader.js";
+import { SilkPublishability, readTargetsBinding } from "../../services/SilkPublishability.js";
 import { Context, Effect, Layer, Schema } from "effect";
 import { isAbsolute, join, relative, resolve } from "node:path";
+import { FileSystem } from "@effect/platform";
 import { globSync } from "tinyglobby";
 import { WorkspaceDiscovery } from "workspaces-effect";
 
@@ -41,6 +43,46 @@ import { WorkspaceDiscovery } from "workspaces-effect";
 *
 * @packageDocumentation
 */
+/** A `versionFiles` entry expanded to its absolute target paths. @public */
+const ResolvedVersionFileSchema = Schema.Struct({
+	glob: Schema.String,
+	paths: Schema.Array(Schema.String).annotations({ description: "JSONPath expressions to update (defaults to [\"$.version\"])." }),
+	matchedFiles: Schema.Array(Schema.String)
+}).annotations({ identifier: "ResolvedVersionFile" });
+/** A package's resolved release surface. @public */
+const ResolvedPackageScopeSchema = Schema.Struct({
+	name: Schema.String,
+	workspaceDir: Schema.String,
+	version: Schema.String,
+	additionalScopes: Schema.Array(Schema.String),
+	additionalScopeFiles: Schema.Array(Schema.String),
+	versionFiles: Schema.Array(ResolvedVersionFileSchema)
+}).annotations({ identifier: "ResolvedPackageScope" });
+/** Structured representation of a resolved `.changeset/config.json`. @public */
+const InspectedConfigSchema = Schema.Struct({
+	configPath: Schema.String,
+	projectDir: Schema.String.annotations({ description: "Absolute project root (the directory containing .changeset/)." }),
+	changelog: Schema.NullOr(Schema.String),
+	baseBranch: Schema.String,
+	access: Schema.Literal("public", "restricted"),
+	ignore: Schema.Array(Schema.String),
+	packages: Schema.Array(ResolvedPackageScopeSchema),
+	legacyVersionFilesUsed: Schema.Boolean
+}).annotations({ identifier: "InspectedConfig" });
+/** Reason a path was attributed to a package (or left unmapped). @public */
+const ClassificationReasonSchema = Schema.Union(Schema.Literal("workspace"), Schema.Struct({
+	kind: Schema.Literal("additionalScope"),
+	glob: Schema.String
+}), Schema.Struct({
+	kind: Schema.Literal("versionFile"),
+	glob: Schema.String
+}), Schema.Null).annotations({ identifier: "ClassificationReason" });
+/** The result of classifying a single path against a resolved config. @public */
+const ClassificationSchema = Schema.Struct({
+	path: Schema.String,
+	package: Schema.NullOr(Schema.String),
+	reason: ClassificationReasonSchema
+}).annotations({ identifier: "Classification" });
 const _tag = Context.Tag("ConfigInspector");
 /**
 * Base class for {@link ConfigInspector}.
@@ -187,6 +229,48 @@ function buildResolvedScopes(params) {
 	return scopes;
 }
 /**
+* Read a workspace package's raw package.json. A genuinely missing manifest
+* resolves to `null` so the caller can skip that package — a workspace
+* directory without a `package.json` is not a release surface. Any OTHER
+* failure (unreadable file, malformed JSON) is surfaced as a
+* {@link ConfigurationError} carrying the package path, rather than silently
+* dropping the package, which would cascade into wrong attribution.
+*/
+function readRawPackageJson(fs, pkgDir) {
+	const pkgJsonPath = join(pkgDir, "package.json");
+	return fs.readFileString(pkgJsonPath).pipe(Effect.flatMap((content) => Effect.try(() => JSON.parse(content))), Effect.catchAll((err) => {
+		if (err.reason === "NotFound") return Effect.succeed(null);
+		return Effect.fail(new ConfigurationError({
+			field: "workspace",
+			reason: `Failed to read or parse ${pkgJsonPath}: ${err instanceof Error ? err.message : String(err)}`
+		}));
+	}));
+}
+/**
+* Build resolved scopes from the discovered workspace packages, keeping only
+* those that are a release surface (declare publishConfig that yields at least
+* one publish target). Used when `.changeset/config.json` declares no explicit
+* `packages` record. The changeset `ignore` list is intentionally NOT consulted
+* here — an ignored package still declares publishConfig and remains a valid
+* changeset target.
+*/
+function buildFallbackScopes(fs, workspaces) {
+	return Effect.forEach(workspaces, (ws) => Effect.gen(function* () {
+		const raw = yield* readRawPackageJson(fs, ws.path);
+		if (raw === null) return [];
+		const binding = yield* readTargetsBinding(fs, ws.path);
+		if (SilkPublishability.detect(ws.name, raw, binding).length === 0) return [];
+		return [{
+			name: ws.name,
+			workspaceDir: ws.path,
+			version: ws.version,
+			additionalScopes: [],
+			additionalScopeFiles: [],
+			versionFiles: []
+		}];
+	})).pipe(Effect.map((nested) => nested.flat()));
+}
+/**
 * Cross-package validation: no overlap in `additionalScopes`, no shadowing
 * of another workspace package's directory (regardless of whether that
 * package is itself declared in `config.packages`), and no duplicate
@@ -244,7 +328,7 @@ function configErrorFromParseError(parseError, configPath) {
 * Each shape carries a private cache keyed by absolute project dir so
 * repeat `inspect`/`classify` calls reuse the materialized state.
 */
-function makeShape(reader, discovery) {
+function makeShape(reader, discovery, fs) {
 	const cache = /* @__PURE__ */ new Map();
 	const inspect = (cwd) => Effect.gen(function* () {
 		const projectDir = resolve(cwd);
@@ -280,8 +364,9 @@ function makeShape(reader, discovery) {
 			path: w.path,
 			version: w.version
 		}));
+		const hasExplicitPackages = Object.keys(decodedOptions.packages ?? {}).length > 0;
 		let scopes;
-		try {
+		if (hasExplicitPackages) try {
 			scopes = buildResolvedScopes({
 				options: decodedOptions,
 				workspaces,
@@ -293,6 +378,7 @@ function makeShape(reader, discovery) {
 			if (e instanceof ConfigurationError) return yield* Effect.fail(e);
 			throw e;
 		}
+		else scopes = yield* buildFallbackScopes(fs, workspaces);
 		const inspected = {
 			configPath,
 			projectDir,
@@ -367,7 +453,7 @@ function classifyOne(inspected, path) {
 * @public
 */
 const ConfigInspectorLive = Layer.effect(ConfigInspector, Effect.gen(function* () {
-	return makeShape(yield* ChangesetConfigReader, yield* WorkspaceDiscovery);
+	return makeShape(yield* ChangesetConfigReader, yield* WorkspaceDiscovery, yield* FileSystem.FileSystem);
 }));
 /**
 * Test factory — build a {@link ConfigInspector} that returns a fixed
@@ -387,4 +473,4 @@ function makeConfigInspectorTest(fixed) {
 }
 
 //#endregion
-export { ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, makeConfigInspectorTest };
+export { ClassificationReasonSchema, ClassificationSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, InspectedConfigSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, makeConfigInspectorTest };

package/commitlint/config/plugins.js

@@ -26,8 +26,11 @@ const MARKDOWN_PATTERNS = {
 	codeFences: /```/,
 	/** Markdown inline code (`code`) - only flag if excessive */
 	inlineCode: /`[^`]+`/g,
-	/** Markdown bold (**text** or __text__) */
-	bold: /(\*\*|__)[^*_]+(\*\*|__)/,
+	/** Markdown bold — asterisk form only (**text**). Underscore runs are NOT
+	* treated as bold, because __SNAKE_CASE__ identifiers (e.g.
+	* __PACKAGE_VERSION__) are legitimate commit-body prose. Agents emit
+	* **bold**, not __bold__, so coverage is unchanged. */
+	bold: /\*\*[^*]+\*\*/,
 	/** Markdown italic (*text* or _text_) - be careful not to match normal underscores */
 	italic: /(?<!\w)\*[^*]+\*(?!\w)/,
 	/** Markdown links [text](url) */

package/index.d.ts

@@ -1,6 +1,6 @@
 import { Context, Data, Effect, Equal, Hash, Layer, Option, Schema, Stream } from "effect";
-import { PackageManagerDetector, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot } from "workspaces-effect";
 import { Command, CommandExecutor, FileSystem } from "@effect/platform";
+import { PackageManagerDetector, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot } from "workspaces-effect";
 import { Plugin } from "unified";
 import { PlatformError } from "@effect/platform/Error";
 
@@ -2652,88 +2652,77 @@ declare class ChangesetConfigReader extends ChangesetConfigReader_base {}
 declare const ChangesetConfigReaderLive: Layer.Layer<ChangesetConfigReader, never, FileSystem.FileSystem>;
 //#endregion
 //#region src/changesets/services/config-inspector.d.ts
-/**
- * A `versionFiles` entry expanded to its absolute target paths.
- *
- * @public
- */
-interface ResolvedVersionFile {
-  /** The original glob from the config. */
-  readonly glob: string;
-  /** JSONPath expressions to update (defaults to `["$.version"]`). */
-  readonly paths: ReadonlyArray<string>;
-  /** Absolute file paths the glob matched at inspection time. */
-  readonly matchedFiles: ReadonlyArray<string>;
-}
-/**
- * A package's release surface after the config has been resolved against the
- * workspace and the globs have been materialized.
- *
- * @public
- */
-interface ResolvedPackageScope {
-  /** Package name (matches the workspace package's `package.json#name`). */
-  readonly name: string;
-  /** Absolute path to the package's workspace directory. */
-  readonly workspaceDir: string;
-  /** Current version from the workspace package's `package.json`. */
-  readonly version: string;
-  /** Globs declared in the config's `additionalScopes`. */
-  readonly additionalScopes: ReadonlyArray<string>;
-  /** Files matched by `additionalScopes` (absolute paths). */
-  readonly additionalScopeFiles: ReadonlyArray<string>;
-  /** Version-file entries, each with their globs materialized. */
-  readonly versionFiles: ReadonlyArray<ResolvedVersionFile>;
-}
-/**
- * Structured representation of a resolved `.changeset/config.json` for
- * consumers (CLI commands, agents, tests).
- *
- * @public
- */
-interface InspectedConfig {
-  /** Absolute path of the resolved `.changeset/config.json`. */
-  readonly configPath: string;
-  /** Absolute path of the project root (the directory containing `.changeset/`). */
-  readonly projectDir: string;
-  /** The changelog formatter ID (e.g., `"@savvy-web/changesets/changelog"`). */
-  readonly changelog: string | null;
-  /** The base branch the workflow diffs against. */
-  readonly baseBranch: string;
-  /** Whether configured packages publish as public or restricted. */
-  readonly access: "public" | "restricted";
-  /** Package names ignored by the changeset workflow. */
-  readonly ignore: ReadonlyArray<string>;
-  /** Per-package release surfaces. */
-  readonly packages: ReadonlyArray<ResolvedPackageScope>;
-  /** True when the inspected config still used the deprecated top-level `versionFiles[]`. */
-  readonly legacyVersionFilesUsed: boolean;
-}
-/**
- * Reason a path was attributed to a particular package (or left unmapped).
- *
- * @public
- */
-type ClassificationReason = "workspace" | {
-  readonly kind: "additionalScope";
-  readonly glob: string;
-} | {
-  readonly kind: "versionFile";
-  readonly glob: string;
-} | null;
-/**
- * The result of classifying a single path against a resolved config.
- *
- * @public
- */
-interface Classification {
-  /** Repo-relative path. */
-  readonly path: string;
-  /** Owning package name, or `null` if the path is outside every known release surface. */
-  readonly package: string | null;
-  /** Why this attribution was made. `null` mirrors `package: null`. */
-  readonly reason: ClassificationReason;
-}
+/** A `versionFiles` entry expanded to its absolute target paths. @public */
+declare const ResolvedVersionFileSchema: Schema.Struct<{
+  glob: typeof Schema.String;
+  paths: Schema.Array$<typeof Schema.String>;
+  matchedFiles: Schema.Array$<typeof Schema.String>;
+}>;
+/** A `versionFiles` entry expanded to its absolute target paths. @public */
+type ResolvedVersionFile = Schema.Schema.Type<typeof ResolvedVersionFileSchema>;
+/** A package's resolved release surface. @public */
+declare const ResolvedPackageScopeSchema: Schema.Struct<{
+  name: typeof Schema.String;
+  workspaceDir: typeof Schema.String;
+  version: typeof Schema.String;
+  additionalScopes: Schema.Array$<typeof Schema.String>;
+  additionalScopeFiles: Schema.Array$<typeof Schema.String>;
+  versionFiles: Schema.Array$<Schema.Struct<{
+    glob: typeof Schema.String;
+    paths: Schema.Array$<typeof Schema.String>;
+    matchedFiles: Schema.Array$<typeof Schema.String>;
+  }>>;
+}>;
+/** A package's resolved release surface. @public */
+type ResolvedPackageScope = Schema.Schema.Type<typeof ResolvedPackageScopeSchema>;
+/** Structured representation of a resolved `.changeset/config.json`. @public */
+declare const InspectedConfigSchema: Schema.Struct<{
+  configPath: typeof Schema.String;
+  projectDir: Schema.SchemaClass<string, string, never>;
+  changelog: Schema.NullOr<typeof Schema.String>;
+  baseBranch: typeof Schema.String;
+  access: Schema.Literal<["public", "restricted"]>;
+  ignore: Schema.Array$<typeof Schema.String>;
+  packages: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    workspaceDir: typeof Schema.String;
+    version: typeof Schema.String;
+    additionalScopes: Schema.Array$<typeof Schema.String>;
+    additionalScopeFiles: Schema.Array$<typeof Schema.String>;
+    versionFiles: Schema.Array$<Schema.Struct<{
+      glob: typeof Schema.String;
+      paths: Schema.Array$<typeof Schema.String>;
+      matchedFiles: Schema.Array$<typeof Schema.String>;
+    }>>;
+  }>>;
+  legacyVersionFilesUsed: typeof Schema.Boolean;
+}>;
+/** Structured representation of a resolved `.changeset/config.json`. @public */
+type InspectedConfig = Schema.Schema.Type<typeof InspectedConfigSchema>;
+/** Reason a path was attributed to a package (or left unmapped). @public */
+declare const ClassificationReasonSchema: Schema.Union<[Schema.Literal<["workspace"]>, Schema.Struct<{
+  kind: Schema.Literal<["additionalScope"]>;
+  glob: typeof Schema.String;
+}>, Schema.Struct<{
+  kind: Schema.Literal<["versionFile"]>;
+  glob: typeof Schema.String;
+}>, typeof Schema.Null]>;
+/** Reason a path was attributed to a package (or left unmapped). @public */
+type ClassificationReason = Schema.Schema.Type<typeof ClassificationReasonSchema>;
+/** The result of classifying a single path against a resolved config. @public */
+declare const ClassificationSchema: Schema.Struct<{
+  path: typeof Schema.String;
+  package: Schema.NullOr<typeof Schema.String>;
+  reason: Schema.Union<[Schema.Literal<["workspace"]>, Schema.Struct<{
+    kind: Schema.Literal<["additionalScope"]>;
+    glob: typeof Schema.String;
+  }>, Schema.Struct<{
+    kind: Schema.Literal<["versionFile"]>;
+    glob: typeof Schema.String;
+  }>, typeof Schema.Null]>;
+}>;
+/** The result of classifying a single path against a resolved config. @public */
+type Classification = Schema.Schema.Type<typeof ClassificationSchema>;
 /**
  * Effect service interface for inspecting a project's changeset config.
  *
@@ -2797,7 +2786,7 @@ declare class ConfigInspector extends ConfigInspectorBase {}
  *
  * @public
  */
-declare const ConfigInspectorLive: Layer.Layer<ConfigInspector, never, ChangesetConfigReader | WorkspaceDiscovery>;
+declare const ConfigInspectorLive: Layer.Layer<ConfigInspector, never, ChangesetConfigReader | WorkspaceDiscovery | FileSystem.FileSystem>;
 /**
  * Test factory — build a {@link ConfigInspector} that returns a fixed
  * {@link InspectedConfig} without touching the filesystem.
@@ -2811,44 +2800,46 @@ declare const ConfigInspectorLive: Layer.Layer<ConfigInspector, never, Changeset
 declare function makeConfigInspectorTest(fixed: InspectedConfig): Layer.Layer<ConfigInspector>;
 //#endregion
 //#region src/changesets/services/branch-analyzer.d.ts
-/**
- * Git diff status as reported by `--name-status`.
- *
- * @public
- */
-type FileStatus = "added" | "modified" | "deleted" | "renamed" | "copied" | "typechange" | "unmerged" | "unknown";
-/**
- * One file entry in the branch analysis output.
- *
- * @public
- */
-interface BranchFileEntry {
-  /** Repo-relative path (the new path in the case of renames). */
-  readonly path: string;
-  /** Git diff status. */
-  readonly status: FileStatus;
-  /** Owning package, or `null` if the path is outside any known release surface. */
-  readonly package: string | null;
-  /** Reason for the package attribution; mirrors {@link Classification.reason}. */
-  readonly reason: ClassificationReason;
-}
-/**
- * Structured result of analyzing the current branch against its base.
- *
- * @public
- */
-interface BranchAnalysis {
-  /** The branch the diff was computed against. */
-  readonly baseBranch: string;
-  /** The merge-base SHA between `HEAD` and `baseBranch`. */
-  readonly mergeBaseSha: string;
-  /** Files changed since the merge base, with classification. */
-  readonly files: ReadonlyArray<BranchFileEntry>;
-  /** Unique package names that own at least one changed file. */
-  readonly packagesAffected: ReadonlyArray<string>;
-  /** Repo-relative paths whose `package` is `null` — candidates for an `AskUserQuestion`. */
-  readonly unmappedFiles: ReadonlyArray<string>;
-}
+/** Git diff status as reported by `--name-status`. @public */
+declare const FileStatusSchema: Schema.Literal<["added", "modified", "deleted", "renamed", "copied", "typechange", "unmerged", "unknown"]>;
+/** Git diff status as reported by `--name-status`. @public */
+type FileStatus = Schema.Schema.Type<typeof FileStatusSchema>;
+/** One file entry in the branch analysis output. @public */
+declare const BranchFileEntrySchema: Schema.Struct<{
+  path: Schema.SchemaClass<string, string, never>;
+  status: Schema.Literal<["added", "modified", "deleted", "renamed", "copied", "typechange", "unmerged", "unknown"]>;
+  package: Schema.NullOr<typeof Schema.String>;
+  reason: Schema.Union<[Schema.Literal<["workspace"]>, Schema.Struct<{
+    kind: Schema.Literal<["additionalScope"]>;
+    glob: typeof Schema.String;
+  }>, Schema.Struct<{
+    kind: Schema.Literal<["versionFile"]>;
+    glob: typeof Schema.String;
+  }>, typeof Schema.Null]>;
+}>;
+/** One file entry in the branch analysis output. @public */
+type BranchFileEntry = Schema.Schema.Type<typeof BranchFileEntrySchema>;
+/** Structured result of analyzing the current branch against its base. @public */
+declare const BranchAnalysisSchema: Schema.Struct<{
+  baseBranch: typeof Schema.String;
+  mergeBaseSha: typeof Schema.String;
+  files: Schema.Array$<Schema.Struct<{
+    path: Schema.SchemaClass<string, string, never>;
+    status: Schema.Literal<["added", "modified", "deleted", "renamed", "copied", "typechange", "unmerged", "unknown"]>;
+    package: Schema.NullOr<typeof Schema.String>;
+    reason: Schema.Union<[Schema.Literal<["workspace"]>, Schema.Struct<{
+      kind: Schema.Literal<["additionalScope"]>;
+      glob: typeof Schema.String;
+    }>, Schema.Struct<{
+      kind: Schema.Literal<["versionFile"]>;
+      glob: typeof Schema.String;
+    }>, typeof Schema.Null]>;
+  }>>;
+  packagesAffected: Schema.Array$<typeof Schema.String>;
+  unmappedFiles: Schema.Array$<typeof Schema.String>;
+}>;
+/** Structured result of analyzing the current branch against its base. @public */
+type BranchAnalysis = Schema.Schema.Type<typeof BranchAnalysisSchema>;
 /**
  * Effect service interface for branch analysis.
  *
@@ -5086,7 +5077,7 @@ declare const RequiredSectionsRule: import("unified-lint-rule").Plugin<Root, unk
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule: import("unified-lint-rule").Plugin<Root, unknown>;
 declare namespace index_d_exports {
-  export { AggregateDependencyTablesPlugin, BranchAnalysis, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, FileStatus, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PositiveInteger, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedVersionFile, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
+  export { AggregateDependencyTablesPlugin, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PositiveInteger, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts

package/index.js

@@ -1,5 +1,7 @@
 import { ChangesetConfigError } from "./errors/ChangesetConfigError.js";
 import { ChangesetConfigReader, ChangesetConfigReaderLive } from "./services/ChangesetConfigReader.js";
+import { ChangesetConfig, ChangesetConfigLive } from "./services/ChangesetConfig.js";
+import { PublishabilityDetectorAdaptiveLive, SilkPublishability, SilkPublishabilityDetectorLive, readTargetsBinding } from "./services/SilkPublishability.js";
 import { changesets_exports } from "./changesets/index.js";
 import { commitlint_exports } from "./commitlint/index.js";
 import { BiomeSyncError } from "./errors/BiomeSyncError.js";
@@ -24,10 +26,8 @@ import { ResolvedTool } from "./schemas/ResolvedTool.js";
 import { ToolDefinition } from "./schemas/ToolDefinition.js";
 import { AnalyzedWorkspace, SilkPublishConfig, WorkspaceAnalysis } from "./schemas/WorkspaceAnalysisSchemas.js";
 import { BiomeSchemaSync, BiomeSchemaSyncLive, buildSchemaUrl, extractSemver } from "./services/BiomeSchemaSync.js";
-import { ChangesetConfig, ChangesetConfigLive } from "./services/ChangesetConfig.js";
 import { ConfigDiscovery, ConfigDiscoveryLive } from "./services/ConfigDiscovery.js";
 import { ManagedSection, ManagedSectionLive } from "./services/ManagedSection.js";
-import { PublishabilityDetectorAdaptiveLive, SilkPublishability, SilkPublishabilityDetectorLive, readTargetsBinding } from "./services/SilkPublishability.js";
 import { TagStrategy, TagStrategyLive } from "./services/TagStrategy.js";
 import { VersioningStrategy, VersioningStrategyLive } from "./services/VersioningStrategy.js";
 import { SilkWorkspaceAnalyzer, SilkWorkspaceAnalyzerLive } from "./services/SilkWorkspaceAnalyzer.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",
@@ -24,25 +24,26 @@
 		".": {
 			"types": "./index.d.ts",
 			"import": "./index.js"
-		}
+		},
+		"./package.json": "./package.json"
 	},
 	"dependencies": {
 		"@changesets/get-github-info": "^0.8.0",
 		"jsonc-effect": "^0.2.1",
 		"mdast-util-heading-range": "^4.0.0",
 		"mdast-util-to-string": "^4.0.0",
-		"prettier": "^3.8.3",
+		"prettier": "^3.8.4",
 		"remark-gfm": "^4.0.1",
 		"remark-parse": "^11.0.0",
 		"remark-stringify": "^11.0.0",
 		"semver-effect": "^0.2.1",
 		"shell-quote": "^1.8.4",
-		"sort-package-json": "^3.6.1",
-		"tinyglobby": "^0.2.16",
+		"sort-package-json": "^4.0.0",
+		"tinyglobby": "^0.2.17",
 		"unified": "^11.0.5",
 		"unified-lint-rule": "^3.0.1",
 		"unist-util-visit": "^5.1.0",
-		"workspaces-effect": "^1.1.0",
+		"workspaces-effect": "^1.2.0",
 		"yaml": "^2.9.0",
 		"yaml-effect": "^0.6.0",
 		"yaml-lint": "^1.7.0"

package/services/SilkPublishability.js

@@ -1,8 +1,8 @@
 import { ChangesetConfig } from "./ChangesetConfig.js";
 import { Effect, Layer } from "effect";
 import { isAbsolute, join } from "node:path";
-import { PublishTarget, PublishabilityDetector, PublishabilityDetectorLive, WorkspaceDiscovery } from "workspaces-effect";
 import { FileSystem } from "@effect/platform";
+import { PublishTarget, PublishabilityDetector, PublishabilityDetectorLive, WorkspaceDiscovery } from "workspaces-effect";
 
 //#region src/services/SilkPublishability.ts
 const NPM_DEFAULT = "https://registry.npmjs.org/";

package/services/SilkWorkspaceAnalyzer.js

@@ -1,13 +1,13 @@
 import { ChangesetConfigReader } from "./ChangesetConfigReader.js";
-import { WorkspaceAnalysisError } from "../errors/WorkspaceAnalysisError.js";
-import { AnalyzedWorkspace, WorkspaceAnalysis } from "../schemas/WorkspaceAnalysisSchemas.js";
 import { ChangesetConfig } from "./ChangesetConfig.js";
 import { SilkPublishability, readTargetsBinding } from "./SilkPublishability.js";
+import { WorkspaceAnalysisError } from "../errors/WorkspaceAnalysisError.js";
+import { AnalyzedWorkspace, WorkspaceAnalysis } from "../schemas/WorkspaceAnalysisSchemas.js";
 import { TagStrategy } from "./TagStrategy.js";
 import { VersioningStrategy } from "./VersioningStrategy.js";
 import { Context, Effect, Layer, Option } from "effect";
-import { PackageManagerDetector, TopologicalSorter, WorkspaceDiscovery } from "workspaces-effect";
 import { FileSystem } from "@effect/platform";
+import { PackageManagerDetector, TopologicalSorter, WorkspaceDiscovery } from "workspaces-effect";
 
 //#region src/services/SilkWorkspaceAnalyzer.ts
 /**

package/services/ToolDiscovery.js

@@ -2,8 +2,8 @@ import { ToolNotFoundError } from "../errors/ToolNotFoundError.js";
 import { ToolResolutionError } from "../errors/ToolResolutionError.js";
 import { ResolvedTool } from "../schemas/ResolvedTool.js";
 import { Context, Effect, Layer, Option, Ref } from "effect";
-import { PackageManagerDetector, WorkspaceRoot } from "workspaces-effect";
 import { Command, CommandExecutor } from "@effect/platform";
+import { PackageManagerDetector, WorkspaceRoot } from "workspaces-effect";
 
 //#region src/services/ToolDiscovery.ts
 /**

package/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.58.7"
+      "packageVersion": "7.58.8"
     }
   ]
 }