From 608ff3590e8bf8c9c8f4e4862bbd1a3b2a65c6c8 Mon Sep 17 00:00:00 2001
From: JSONbored <49853598+JSONbored@users.noreply.github.com>
Date: Sun, 12 Jul 2026 06:35:41 -0700
Subject: [PATCH] fix(selfhost): recognize experimental: as a valid top-level
 manifest field

#5030 (the gittensor subnet plugin) added a real, actively-parsed
experimental: top-level manifest block, but never updated this
linter's TOP_LEVEL_FIELDS allowlist -- the same class of bug already
fixed once in this file for repoDocGeneration (#3364). All 3
production self-host repo configs declare experimental: gittensor:
true today; running the config-lint CLI against any of them produced
a false "unknown top-level field" warning.

Refs #5281
---
 src/selfhost/config-lint.ts            |  1 +
 test/unit/selfhost-config-lint.test.ts | 13 +++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/src/selfhost/config-lint.ts b/src/selfhost/config-lint.ts
index 01c4d08cd..18730a8d4 100644
--- a/src/selfhost/config-lint.ts
+++ b/src/selfhost/config-lint.ts
@@ -14,6 +14,7 @@ const TOP_LEVEL_FIELDS = [
   "settings",
   "review",
   "features",
+  "experimental",
   "contentLane",
   "repoDocGeneration",
   "reviewRecap",
diff --git a/test/unit/selfhost-config-lint.test.ts b/test/unit/selfhost-config-lint.test.ts
index 8c6fca20a..40dd25a5c 100644
--- a/test/unit/selfhost-config-lint.test.ts
+++ b/test/unit/selfhost-config-lint.test.ts
@@ -72,6 +72,19 @@ reviewRecap:
     expect(result.recognizedFields).toEqual(["repoDocGeneration"]);
   });
 
+  it("REGRESSION: recognizes a standalone experimental: block instead of flagging it as unknown (#5281)", () => {
+    // experimental is a fully real, actively-parsed top-level manifest field (#5030, the gittensor subnet
+    // plugin) that was missing from this linter's TOP_LEVEL_FIELDS allowlist -- #5030 touched
+    // focus-manifest.ts/index.ts/env.d.ts/gittensor-wire.ts/focus-manifest-loader.ts and the example YAML, but
+    // not this file, so a self-host operator using it got a false "unknown top-level field" warning even
+    // though the field works correctly. Confirmed live: all 3 production self-host repo configs declare it.
+    const result = lintManifestText("experimental:\n  gittensor: true\n");
+
+    expect(result.ok).toBe(true);
+    expect(result.warnings).toEqual([]);
+    expect(result.recognizedFields).toEqual(["experimental"]);
+  });
+
   it("recognizes a standalone reviewRecap: block instead of flagging it as unknown (#1963)", () => {
     const result = lintManifestText("reviewRecap:\n  enabled: true\n  cadenceDays: 14\n");