feat(config): export diffProjectConfig from the public entrypoint (#6447)

## What changed

`diffProjectConfig` and its supporting types (`ConfigChange`,
`ConfigChangeClass`, `ConfigChangeCounts`, `ConfigChangeSet`,
`DiffProjectConfigOptions`) move from `@supabase/config/internal` to the
package's public `.` entrypoint.

## Why

ADR 0022 deliberately deferred exporting the config-diff classification
engine publicly until a second real consumer needed it, rather than
exporting it speculatively. Studio is now that second consumer, so this
promotes the (already pure/synchronous) engine to the public surface
`apps/cli` and Studio can both read.

## Notes for reviewers

- `config-diff.ts` itself is newly added to `index.ts`'s pure runtime
graph, but every module it transitively depends on
(`config-document.ts`, `project-config/project-config.ts`,
`project-config/registry.ts`, `sparse.ts`) was already reachable from
that graph, so no new transitive module or bare specifier enters it.
- `apps/cli`'s `config diff` command (`diff.handler.ts`,
`diff.format.ts`, and their test) are updated to import
`diffProjectConfig`/`ConfigChange*` from `@supabase/config` instead of
`@supabase/config/internal`; other internal-only imports in those files
(`loadCliConfig`, `projectConfigApiBlockKeys`) are unaffected.
- `packages/config/AGENTS.md`, `packages/config/README.md`, and ADR 0022
are updated to reflect the new entrypoint.

Author: Coly010

apps/cli/src/legacy/commands/config/config.format.ts

@@ -1,4 +1,5 @@
-import { type ConfigChange, projectConfigApiBlockKeys } from "@supabase/config/internal";
+import type { ConfigChange } from "@supabase/config";
+import { projectConfigApiBlockKeys } from "@supabase/config/internal";
 
 import { LEGACY_BRANCH_UUID_PATTERN } from "../../shared/legacy-ref-patterns.ts";
 import { legacySanitizeInlineName } from "../../shared/legacy-http-errors.ts";

apps/cli/src/legacy/commands/config/diff/diff.format.ts

@@ -1,4 +1,4 @@
-import type { ConfigChange, ConfigChangeSet } from "@supabase/config/internal";
+import type { ConfigChange, ConfigChangeSet } from "@supabase/config";
 
 import { legacySanitizeInlineName } from "../../../shared/legacy-http-errors.ts";
 import {

apps/cli/src/legacy/commands/config/diff/diff.format.unit.test.ts

@@ -1,4 +1,4 @@
-import type { ConfigChangeSet } from "@supabase/config/internal";
+import type { ConfigChangeSet } from "@supabase/config";
 import { describe, expect, test } from "vitest";
 
 import { legacyConfigApiScope, legacyConfigScopeLine } from "../config.format.ts";

apps/cli/src/legacy/commands/config/diff/diff.handler.ts

@@ -1,13 +1,10 @@
 import {
   CLI_CONFIG_SCHEMA_URL,
+  diffProjectConfig,
   fromApiProjectConfig,
   ProjectConfigParseError,
-} from "@supabase/config";
-import {
-  diffProjectConfig,
-  loadCliConfig,
-  remoteNameForProjectRef,
-} from "@supabase/config/internal";
+} from "@supabase/config/effect";
+import { loadCliConfig, remoteNameForProjectRef } from "@supabase/config/internal";
 import { operationDefinitions } from "@supabase/api/effect";
 import { Effect, Option } from "effect";
 

apps/cli/src/legacy/commands/config/diff/diff.live.test.ts

@@ -1,4 +1,5 @@
-import { type ConfigChangeClass, projectConfigMappingRows } from "@supabase/config/internal";
+import type { ConfigChangeClass } from "@supabase/config";
+import { projectConfigMappingRows } from "@supabase/config/internal";
 import { expect } from "vitest";
 
 import { requireLiveSuccess, test } from "../../../../../tests/helpers/live.ts";

apps/cli/src/legacy/commands/config/pull/pull.format.ts

@@ -1,5 +1,4 @@
-import type { ConfigFormat } from "@supabase/config";
-import type { ConfigChange, ConfigChangeSet } from "@supabase/config/internal";
+import type { ConfigChange, ConfigChangeSet, ConfigFormat } from "@supabase/config";
 
 import { legacySanitizeInlineName } from "../../../shared/legacy-http-errors.ts";
 import {

apps/cli/src/legacy/commands/config/pull/pull.format.unit.test.ts

@@ -1,4 +1,4 @@
-import type { ConfigChange, ConfigChangeSet } from "@supabase/config/internal";
+import type { ConfigChange, ConfigChangeSet } from "@supabase/config";
 import { describe, expect, test } from "vitest";
 
 import {

apps/cli/src/legacy/commands/config/pull/pull.handler.ts

@@ -1,21 +1,21 @@
 import {
   CLI_CONFIG_SCHEMA_URL,
+  diffProjectConfig,
   fromApiProjectConfig,
   ProjectConfigParseError,
   type CliConfigParseError,
+  type ConfigChangeSet,
   type ConfigFormat,
   type LoadedCliConfig,
-} from "@supabase/config";
+} from "@supabase/config/effect";
 import {
   applyConfigEdits,
   decodeCliConfigDocumentForValidationEffect,
-  type ConfigChangeSet,
+  loadCliConfig,
+  writeCliConfigDocumentText,
   type ConfigEdit,
   type ConfigEditRefusalReason,
   type DecodeCliConfigDocumentForValidationEffectOptions,
-  diffProjectConfig,
-  loadCliConfig,
-  writeCliConfigDocumentText,
 } from "@supabase/config/internal";
 import { operationDefinitions } from "@supabase/api/effect";
 import { Effect, FileSystem, Option, Result, Schema, SchemaIssue } from "effect";

apps/cli/src/legacy/commands/config/pull/pull.plan.ts

@@ -1,12 +1,16 @@
 import {
+  type CliConfigValueOrigin,
   type ConfigChange,
   type ConfigChangeSet,
+  diffProjectConfig,
+  type EffectiveConfig,
+  type ProjectConfig,
+} from "@supabase/config";
+import {
   type ConfigEditValue,
   dualScopeProjectConfigPaths,
-  diffProjectConfig,
   ENV_CAPTURE_REGEX,
 } from "@supabase/config/internal";
-import type { CliConfigValueOrigin, EffectiveConfig, ProjectConfig } from "@supabase/config";
 
 import type { LegacyConfigPullDestination } from "./pull.scope.ts";
 

apps/cli/src/legacy/commands/config/pull/pull.plan.unit.test.ts

@@ -1,9 +1,11 @@
 import {
-  diffProjectConfig,
+  type CliConfigValueOrigin,
   type ConfigChange,
   type ConfigChangeSet,
-} from "@supabase/config/internal";
-import type { CliConfigValueOrigin, EffectiveConfig, ProjectConfig } from "@supabase/config";
+  diffProjectConfig,
+  type EffectiveConfig,
+  type ProjectConfig,
+} from "@supabase/config";
 import { describe, expect, test } from "vitest";
 
 import {