refactor: test-cid-v1-wide with UnixFSHAMTDirectoryMaxFanout=1024

lets make the fanout match the max links from files
and rename profile to `-wide`

this will make it easier to discuss in ipfs/specs#499

Author: lidel

config/profile.go

@@ -280,7 +280,7 @@ fetching may be degraded.
 		},
 	},
 	"test-cid-v1": {
-		Description: `Makes UnixFS import produce legacy CIDv1 with the same suboptimal settings as legacy-cid-v0, but with 1MiB file chunk, CIDv1 and raw leaves. Use only if legacy behavior is required.`,
+		Description: `Makes UnixFS import produce CIDv1 with raw leaves, sha2-256 and 1 MiB chunks (max 174 links per file, 256 per HAMT node, switch dir to HAMT above 256KiB).`,
 		Transform: func(c *Config) error {
 			c.Import.CidVersion = *NewOptionalInteger(1)
 			c.Import.UnixFSRawLeaves = True
@@ -293,16 +293,16 @@ fetching may be degraded.
 			return nil
 		},
 	},
-	"test-cid-v1-2025-v35": {
-		Description: `Makes UnixFS import produce modern CIDv1 with raw leaves, sha2-256 and 1 MiB chunks and wider file DAGs (1024 links per level).`,
+	"test-cid-v1-wide": {
+		Description: `Makes UnixFS import produce CIDv1 with raw leaves, sha2-256 and 1MiB chunks and wider file DAGs (max 1024 links per every node type, switch dir to HAMT above 1MiB).`,
 		Transform: func(c *Config) error {
 			c.Import.CidVersion = *NewOptionalInteger(1)
 			c.Import.UnixFSRawLeaves = True
 			c.Import.UnixFSChunker = *NewOptionalString("size-1048576") // 1MiB
 			c.Import.HashFunction = *NewOptionalString("sha2-256")
 			c.Import.UnixFSFileMaxLinks = *NewOptionalInteger(1024)
 			c.Import.UnixFSDirectoryMaxLinks = *NewOptionalInteger(0) // no limit here, use size-based Import.UnixFSHAMTDirectorySizeThreshold instead
-			c.Import.UnixFSHAMTDirectoryMaxFanout = *NewOptionalInteger(256)
+			c.Import.UnixFSHAMTDirectoryMaxFanout = *NewOptionalInteger(1024)
 			c.Import.UnixFSHAMTDirectorySizeThreshold = *NewOptionalString("1MiB") // 1MiB
 			return nil
 		},

docs/changelogs/v0.35.md

@@ -71,13 +71,11 @@ You can set default values for these options using the following configuration s
 
 The release updated configuration [profiles](https://github.com/ipfs/kubo/blob/master/docs/config.md#profile) to incorporate these new `Import.*` settings:
 - Updated Profile: `test-cid-v1` now includes current defaults as explicit `Import.UnixFSFileMaxLinks=174`, `Import.UnixFSDirectoryMaxLinks=0`, `Import.UnixFSHAMTDirectoryMaxFanout=256` and `Import.UnixFSHAMTDirectorySizeThreshold=256KiB`
-- New Profile: `test-cid-v1-2025-v35` adopts modern defaults, increasing the maximum file DAG width from 174 to 1024 and raising the HAMT directory sharding threshold from 256KiB to 1MiB, aligning with 1MiB file chunks.
-  - Benefits: Larger blocks (256KiB to 1MiB) enable up to 4x faster Amino DHT announcements and lookups.
-  - Status: This profile is a candidate for future default settings.
+- New Profile: `test-cid-v1-wide` adopts experimental directory DAG-shaping defaults, increasing the maximum file DAG width from 174 to 1024, HAMT fanout from 256 to 1024, and raising the HAMT directory sharding threshold from 256KiB to 1MiB, aligning with 1MiB file chunks.
   - Feedback: Try it out and share your thoughts at [discuss.ipfs.tech/t/should-we-profile-cids](https://discuss.ipfs.tech/t/should-we-profile-cids/18507) or [ipfs/specs#499](https://github.com/ipfs/specs/pull/499).
 
 > [!TIP]
-> Apply the modern CIDv1 test profile with `ipfs config profile apply test-cid-v1-2025-v35`.
+> Apply the modern CIDv1 test profile with `ipfs config profile apply test-cid-v1-wide`.
 
 #### 📦️ Important dependency updates
 

docs/config.md

@@ -2800,16 +2800,38 @@ Disables [Reprovider](#reprovider) system (and announcing to Amino DHT).
 
 Makes UnixFS import (`ipfs add`) produce legacy CIDv0 with no raw leaves, sha2-256 and 256 KiB chunks.
 
+See <https://github.com/ipfs/kubo/blob/master/config/profile.go> for exact [`Import.*`](#import) settings.
+
 > [!NOTE]
 > This profile is provided for legacy users and should not be used for new projects.
 
 ### `test-cid-v1` profile
 
-Makes UnixFS import (`ipfs add`) produce modern CIDv1 with raw leaves, sha2-256 and 1 MiB chunks.
+Makes UnixFS import (`ipfs add`) produce modern CIDv1 with raw leaves, sha2-256
+and 1 MiB chunks (max 174 links per file, 256 per HAMT node, switch dir to HAMT
+above 256KiB).
+
+See <https://github.com/ipfs/kubo/blob/master/config/profile.go> for exact [`Import.*`](#import) settings.
 
 > [!NOTE]
-> This profile will become the new implicit default, provided for testing purposes.
-> Follow [kubo#4143](https://github.com/ipfs/kubo/issues/4143) for more details.
+> [`Import.*`](#import) settings applied by this profile MAY change in future release. Provided for testing purposes.
+>
+> Follow [kubo#4143](https://github.com/ipfs/kubo/issues/4143) for more details,
+> and provide feedback in [discuss.ipfs.tech/t/should-we-profile-cids](https://discuss.ipfs.tech/t/should-we-profile-cids/18507) or [ipfs/specs#499](https://github.com/ipfs/specs/pull/499).
+
+### `test-cid-v1-wide` profile
+
+Makes UnixFS import (`ipfs add`) produce modern CIDv1 with raw leaves, sha2-256
+and 1 MiB chunks and wider file DAGs (max 1024 links per every node type,
+switch dir to HAMT above 1MiB).
+
+See <https://github.com/ipfs/kubo/blob/master/config/profile.go> for exact [`Import.*`](#import) settings.
+
+> [!NOTE]
+> [`Import.*`](#import) settings applied by this profile MAY change in future release. Provided for testing purposes.
+>
+> Follow [kubo#4143](https://github.com/ipfs/kubo/issues/4143) for more details,
+> and provide feedback in [discuss.ipfs.tech/t/should-we-profile-cids](https://discuss.ipfs.tech/t/should-we-profile-cids/18507) or [ipfs/specs#499](https://github.com/ipfs/specs/pull/499).
 
 ## Types
 

test/cli/add_test.go

@@ -199,7 +199,7 @@ func TestAdd(t *testing.T) {
 			require.NoError(t, err)
 			cidStr := node.IPFS("add", "-r", "-Q", randDir).Stdout.Trimmed()
 
-			// Confirm the number of links is more than UnixFSHAMTDirectoryMaxFanout=256 (indicating regular "basic" directory"
+			// Confirm the number of links is more than UnixFSHAMTDirectorySizeThreshold (indicating regular "basic" directory"
 			root, err := node.InspectPBNode(cidStr)
 			assert.NoError(t, err)
 			require.Equal(t, 903, len(root.Links))
@@ -219,7 +219,7 @@ func TestAdd(t *testing.T) {
 			require.NoError(t, err)
 			cidStr := node.IPFS("add", "-r", "-Q", randDir).Stdout.Trimmed()
 
-			// Confirm this time, the number of links is less than UnixFSHAMTDirectoryMaxFanout=256
+			// Confirm this time, the number of links is less than UnixFSHAMTDirectorySizeThreshold
 			root, err := node.InspectPBNode(cidStr)
 			assert.NoError(t, err)
 			require.Equal(t, 252, len(root.Links))
@@ -290,7 +290,7 @@ func TestAdd(t *testing.T) {
 			require.NoError(t, err)
 			cidStr := node.IPFS("add", "-r", "-Q", randDir).Stdout.Trimmed()
 
-			// Confirm the number of links is more than UnixFSHAMTDirectoryMaxFanout=256 (indicating regular "basic" directory"
+			// Confirm the number of links is more than UnixFSHAMTDirectoryMaxFanout (indicating regular "basic" directory"
 			root, err := node.InspectPBNode(cidStr)
 			assert.NoError(t, err)
 			require.Equal(t, 897, len(root.Links))
@@ -310,17 +310,17 @@ func TestAdd(t *testing.T) {
 			require.NoError(t, err)
 			cidStr := node.IPFS("add", "-r", "-Q", randDir).Stdout.Trimmed()
 
-			// Confirm this time, the number of links is less than UnixFSHAMTDirectoryMaxFanout=256
+			// Confirm this time, the number of links is less than UnixFSHAMTDirectoryMaxFanout
 			root, err := node.InspectPBNode(cidStr)
 			assert.NoError(t, err)
 			require.Equal(t, 252, len(root.Links))
 		})
 	})
 
-	t.Run("ipfs init --profile=test-cid-v1-2025-v35 applies UnixFSChunker=size-1048576 and UnixFSFileMaxLinks=1024", func(t *testing.T) {
+	t.Run("ipfs init --profile=test-cid-v1-wide applies UnixFSChunker=size-1048576 and UnixFSFileMaxLinks=1024", func(t *testing.T) {
 		t.Parallel()
 		seed := "v1-seed-1024"
-		profile := "--profile=test-cid-v1-2025-v35"
+		profile := "--profile=test-cid-v1-wide"
 
 		t.Run("under UnixFSFileMaxLinks=1024", func(t *testing.T) {
 			t.Parallel()
@@ -352,10 +352,10 @@ func TestAdd(t *testing.T) {
 		})
 	})
 
-	t.Run("ipfs init --profile=test-cid-v1-2025-v35 applies UnixFSHAMTDirectoryMaxFanout=256 and UnixFSHAMTDirectorySizeThreshold=1MiB", func(t *testing.T) {
+	t.Run("ipfs init --profile=test-cid-v1-wide applies UnixFSHAMTDirectoryMaxFanout=256 and UnixFSHAMTDirectorySizeThreshold=1MiB", func(t *testing.T) {
 		t.Parallel()
 		seed := "hamt-cid-v1"
-		profile := "--profile=test-cid-v1-2025-v35"
+		profile := "--profile=test-cid-v1-wide"
 
 		t.Run("under UnixFSHAMTDirectorySizeThreshold=1MiB", func(t *testing.T) {
 			t.Parallel()
@@ -371,7 +371,7 @@ func TestAdd(t *testing.T) {
 			require.NoError(t, err)
 			cidStr := node.IPFS("add", "-r", "-Q", randDir).Stdout.Trimmed()
 
-			// Confirm the number of links is more than UnixFSHAMTDirectoryMaxFanout=256 (indicating regular "basic" directory"
+			// Confirm the number of links is more than UnixFSHAMTDirectoryMaxFanout (indicating regular "basic" directory"
 			root, err := node.InspectPBNode(cidStr)
 			assert.NoError(t, err)
 			require.Equal(t, 3599, len(root.Links))
@@ -391,10 +391,10 @@ func TestAdd(t *testing.T) {
 			require.NoError(t, err)
 			cidStr := node.IPFS("add", "-r", "-Q", randDir).Stdout.Trimmed()
 
-			// Confirm this time, the number of links is less than UnixFSHAMTDirectoryMaxFanout=256
+			// Confirm this time, the number of links is less than UnixFSHAMTDirectoryMaxFanout
 			root, err := node.InspectPBNode(cidStr)
 			assert.NoError(t, err)
-			require.Equal(t, 256, len(root.Links))
+			require.Equal(t, 992, len(root.Links))
 		})
 	})