feat(core): mark policies experimental

packages/core/src/config/config.ts

@@ -82,7 +82,7 @@ export const layer = Layer.effect(
     const configs = [...(supplementary[0] ?? []), ...direct, ...supplementary.slice(1).flat()]
     // Rules use the opposite order so a user-global rule can override a
     // repository rule. Statement order inside each file stays unchanged.
-    yield* policy.load(configs.toReversed().flatMap((config) => config.info.policies ?? []))
+    yield* policy.load(configs.toReversed().flatMap((config) => config.info.experimental?.policies ?? []))
 
     return Service.of({
       directories: Effect.fn("Config.directories")(function* () {

packages/core/src/config/schema.ts

@@ -14,6 +14,10 @@ export class Policy extends Schema.Class<Policy>("ConfigV2.Policy")({
   action: PolicyAction,
 }) {}
 
+export class Experimental extends Schema.Class<Experimental>("ConfigV2.Experimental")({
+  policies: Policy.pipe(Schema.Array, Schema.optional),
+}) {}
+
 export class Info extends Schema.Class<Info>("ConfigV2.Info")({
   $schema: Schema.optional(Schema.String).annotate({
     description: "JSON schema reference for configuration validation",
@@ -21,7 +25,7 @@ export class Info extends Schema.Class<Info>("ConfigV2.Info")({
   shell: Schema.String.pipe(Schema.optional).annotate({
     description: "Default shell to use for terminal and shell tool execution",
   }),
-  policies: Policy.pipe(Schema.Array, Schema.optional),
+  experimental: Experimental.pipe(Schema.optional),
   providers: Schema.Record(Schema.String, ConfigProvider.Info).pipe(Schema.optional),
 }) {}
 

packages/core/test/config/config.test.ts

@@ -132,7 +132,7 @@ describe("Config", () => {
           const file = path.join(tmp.path, "opencode.json")
           const contents = JSON.stringify({
             shell: "/bin/zsh",
-            policies: [{ effect: "deny", action: "provider.use", resource: "openai" }],
+            experimental: { policies: [{ effect: "deny", action: "provider.use", resource: "openai" }] },
             providers: { local: provider },
           })
           yield* Effect.promise(() => fs.writeFile(file, contents))
@@ -143,7 +143,7 @@ describe("Config", () => {
 
             expect(documents[0]?.info.$schema).toBeUndefined()
             expect(documents[0]?.info.shell).toBe("/bin/zsh")
-            expect(documents[0]?.info.policies?.[0]).toEqual({
+            expect(documents[0]?.info.experimental?.policies?.[0]).toEqual({
               effect: "deny",
               action: "provider.use",
               resource: "openai",
@@ -223,11 +223,11 @@ describe("Config", () => {
             await fs.mkdir(global, { recursive: true })
             await fs.writeFile(
               path.join(global, "opencode.json"),
-              JSON.stringify({ policies: [{ effect: "deny", action: "provider.use", resource: "openai" }] }),
+              JSON.stringify({ experimental: { policies: [{ effect: "deny", action: "provider.use", resource: "openai" }] } }),
             )
             await fs.writeFile(
               path.join(tmp.path, "opencode.json"),
-              JSON.stringify({ policies: [{ effect: "allow", action: "provider.use", resource: "openai" }] }),
+              JSON.stringify({ experimental: { policies: [{ effect: "allow", action: "provider.use", resource: "openai" }] } }),
             )
           })