agent-policy-kit 0.1.0 → 0.2.0

package/docs/policy.md

@@ -2,14 +2,14 @@
 
 Start with policies/balanced.json or another preset in the selected release. The [JSON Schema](../schema/policy.schema.json) describes data shape; the configuration validator also checks the release catalog's known model/effort compatibility.
 
-- schemaVersion1; maxConcurrent is a shared target1..32.
-- clients contains codex, claude, kimi and/or agy (the technical key for Antigravity).
+- schemaVersion1; maxConcurrent is the shared fallback, from 1 to 32. Optional clients[tool].maxConcurrent overrides it for one tool. Older policies without overrides keep their shared behavior.
+- clients contains codex, claude, kimi, agy (the technical key for Antigravity) and/or grok (Grok Build).
 - Optional top-level selectedRoles is a nonempty unique array of worker, reviewer, explorer, tester, writer and routine IDs. Omit it for all six roles in the executing release. Only selected roles receive native files and routing instructions.
 - code/light hold default model+effort pairs.
 - Optional roles inside each client overrides each selected role independently. Worker/reviewer/tester otherwise use code; explorer/writer/routine use light. Public presets also contain role-specific overrides.
 - avoidModels is delegation guidance. An explicit page choice removes itself from that avoid list.
 
-Effort null means native behavior without an explicit effort override. Codex effort depends on the native model selector. Claude supports low through max as documented per model. Kimi actual aliases must declare the requested non-null effort. Antigravity's role field supports model tiers, with no per-role effort pin.
+Effort null means native behavior without an explicit effort override. Codex effort depends on the native model selector. Claude supports low through max as documented per model. Kimi actual aliases must declare the requested non-null effort. Antigravity's role field supports model tiers, with no per-role effort pin. Grok Build accepts any model ID and always uses effort null.
 
 A known model cannot request an effort excluded by the release catalog. Custom IDs can use the client's native level set, subject to actual native availability. Kimi can merge null with one explicit pin for a selected shared alias. Contradictory explicit pins are refused. Unselected role defaults do not require Kimi aliases or acquire pins. A section-wide effort conflicting with mixed default/pinned alias behavior is a prerequisite rather than a silent rewrite.
 

package/docs/releases.md

@@ -7,14 +7,14 @@
 Inspect the release and preview its plan:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.1.0 agent-policy release
-npx --yes --ignore-scripts --package agent-policy-kit@0.1.0 agent-policy setup --release
+npx --yes --ignore-scripts --package agent-policy-kit@0.2.0 agent-policy release
+npx --yes --ignore-scripts --package agent-policy-kit@0.2.0 agent-policy setup --release
 ```
 
 Apply explicitly:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.1.0 agent-policy setup --release --preset balanced --apply
+npx --yes --ignore-scripts --package agent-policy-kit@0.2.0 agent-policy setup --release --preset balanced --apply
 ```
 
 The package you select supplies both preferences and native templates. --release is a boolean, not another version argument. --preset selects fast/balanced/quality; its identity is stored alongside release/source. The same pattern selects an older compatible release for downgrade. Installing/updating an npm package alone does not change native files. Before publication, use that release's verified .tgz instead of the registry package spec.
@@ -37,4 +37,4 @@ Current native receipt v4 records the selected subset of six bounded role filena
 
 A release reproduces declared settings and templates. Provider aliases/tiers can resolve to new models, old model IDs can retire, and account access can change. See [model maintenance](model-updates.md). No runtime updater or model gateway is installed.
 
-Read [CHANGELOG](../CHANGELOG.md) for what changed, why, who should update and migration limits. Version 0.1.0 is the first release; synthetic versions in acceptance tests are not real releases.
+Read [CHANGELOG](../CHANGELOG.md) for what changed, why, who should update and migration limits. Version 0.1.0 was the first release and 0.2.0 is being prepared; synthetic versions in acceptance tests are not real releases.

package/docs/verification.md

@@ -1,6 +1,27 @@
 # Verification record
 
-Configuration release/page 0.1.0, macOS arm64, 2026-10-30. Configuration checks, native loading and model execution are separate results.
+Configuration checks, native loading and model execution are separate results.
+
+## 0.2.0
+
+macOS arm64, 2026-11-01.
+
+| Layer | Current evidence |
+|---|---|
+| Full Node 26.5.1 suite | PASS: 350/350, including source-denied real-tarball gates, selected-role native generation, Grok Build files under an isolated GROK_HOME, per-tool limits and expanded page commands |
+| Hosted CI | PASS on main 7f8666d: macOS Node 22.13.0 and Ubuntu Node 24 suites plus site-build ([run](https://github.com/automatis-tools/agent-policy-kit/actions/runs/41283600922)) |
+| Two synthetic releases | PASS: the actual 0.2.0 tarball and a synthetic 0.3.0 tarball, A to B to A, mixed applied versions, drift safety and original-user restoration |
+| Page command via npx | PASS: the generated multiline command runs through a real shell and npx with the local tarball; independent Codex 5 and Claude 2 limits and Grok Build values are read back from native files |
+| Preset audit | PASS: an independent review compared every preset, tool and role with the catalog and documentation and found no data defects; wording fixes were applied, and a test keeps the documentation tables in sync |
+| Grok Build discovery | PASS: `grok inspect --json` with Grok Build 1.0.70 lists an `apk-*` agent from an isolated GROK_HOME. Model selection and execution NOT CHECKED |
+| Native Codex/Claude/Kimi/Antigravity loading and provider execution | NOT CHECKED for 0.2.0; no live model tasks used as configuration proof |
+| Browser | The owner reviewed local previews manually; no automated browser run for 0.2.0 |
+| npm packaging | PASS: `npm pack --dry-run` and `npm publish --dry-run` list 42 files; no private evidence or configuration |
+| Current model catalog | Codex 9 selectors, Claude 19 selectors, Kimi 6 preferred aliases, Antigravity CLI 4 tiers, Grok Build 4 model IDs. Account access and model quality are not established by configuration tests. |
+
+## 0.1.0
+
+macOS arm64, 2026-10-30.
 
 | Layer | Current evidence |
 |---|---|
@@ -21,4 +42,4 @@ Configuration release/page 0.1.0, macOS arm64, 2026-10-30. Configuration checks,
 | Hosted macOS/Linux CI | See the public workflow runs linked from the GitHub release; local results above do not establish hosted CI. |
 | Deployment/publication | Public status and downloadable artifacts are recorded in the GitHub release; package checks below concern the reviewed tarball. |
 
-The 0.2.0 packages are synthetic test fixtures, not public releases. Browser evidence, disposable homes, raw configuration fixtures and logs stay outside Git/npm. Expanded commands preserve the selected cap and avoid lists; :native round-trips unpinned effort. A 2835-case preset/role/tool matrix produces identical native role files and routing instructions. Real-shell tests preserve colon/@/bracket IDs and prevent pathname expansion. The same pinned command consumes the published npm release. The verified local tarball supports testing before publication.
+At 0.1.0, the 0.2.0 packages were synthetic test fixtures, not public releases. Browser evidence, disposable homes, raw configuration fixtures and logs stay outside Git/npm. Expanded commands preserve the selected cap and avoid lists; :native round-trips unpinned effort. A 2835-case preset/role/tool matrix produces identical native role files and routing instructions. Real-shell tests preserve colon/@/bracket IDs and prevent pathname expansion. The same pinned command consumes the published npm release. The verified local tarball supports testing before publication.

package/models/catalog.json

@@ -694,6 +694,50 @@
         }
       ],
       "note": "Native per-subagent selectors are tiers, not the session model inventory. CLI 1.4.10 parser explicitly accepts inherit/flash_lite/flash/pro, including Flash Lite absent from the shared docs App table. Per-role effort is not exposed by the agent-file schema."
+    },
+    "grok": {
+      "label": "Grok Build",
+      "efforts": [],
+      "observedClientVersion": "1.0.70",
+      "models": [
+        {
+          "id": "grok-4.7",
+          "label": "Grok 4.7",
+          "efforts": [],
+          "defaultEffort": null,
+          "source": "https://docs.x.ai/developers/models",
+          "nativeSource": "https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md",
+          "kind": "model"
+        },
+        {
+          "id": "grok-4.6",
+          "label": "Grok 4.6",
+          "efforts": [],
+          "defaultEffort": null,
+          "source": "https://docs.x.ai/developers/models",
+          "nativeSource": "https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md",
+          "kind": "model"
+        },
+        {
+          "id": "grok-4.5",
+          "label": "Grok 4.5",
+          "efforts": [],
+          "defaultEffort": null,
+          "source": "https://docs.x.ai/developers/models",
+          "nativeSource": "https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md",
+          "kind": "model"
+        },
+        {
+          "id": "grok-build-0.1",
+          "label": "Grok Build 0.1",
+          "efforts": [],
+          "defaultEffort": null,
+          "source": "https://docs.x.ai/developers/models",
+          "nativeSource": "https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md",
+          "kind": "model"
+        }
+      ],
+      "note": "Per-subagent models are set in config.toml [subagents.models]; model IDs follow the documented xAI model list and account access varies. Per-role effort is not exposed by the agent-file schema, so subagents use the main session effort. [subagents] max_concurrent is a native cap."
     }
   }
 }

package/package.json

@@ -1,15 +1,19 @@
 {
   "name": "agent-policy-kit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Configure native subagent settings across coding tools, then exit",
   "type": "module",
   "license": "MIT",
-  "author": "Agent Policy Kit contributors",
+  "author": {
+    "name": "Mykola Maksymenko",
+    "url": "https://www.linkedin.com/in/nick-maximenko/"
+  },
   "keywords": [
     "codex",
     "claude-code",
     "kimi",
     "antigravity",
+    "grok-build",
     "subagents",
     "configuration",
     "model-settings"
@@ -57,5 +61,5 @@
   "bugs": {
     "url": "https://github.com/automatis-tools/agent-policy-kit/issues"
   },
-  "homepage": "https://agent-policy-kit.maksymenko-ml.workers.dev/v/0.1.0/"
+  "homepage": "https://agent-policy-kit.trymenow.io/v/0.2.0/"
 }

package/policies/balanced.json

@@ -69,6 +69,12 @@
         "model": "kimi-code/kimi-for-coding",
         "effort": "low"
       },
+      "roles": {
+        "writer": {
+          "model": "kimi-code/k3-256k",
+          "effort": "high"
+        }
+      },
       "avoidModels": []
     },
     "agy": {
@@ -91,6 +97,23 @@
         }
       },
       "avoidModels": []
+    },
+    "grok": {
+      "code": {
+        "model": "grok-4.7",
+        "effort": null
+      },
+      "light": {
+        "model": "grok-build-0.1",
+        "effort": null
+      },
+      "roles": {
+        "writer": {
+          "model": "grok-4.7",
+          "effort": null
+        }
+      },
+      "avoidModels": []
     }
   }
 }

package/policies/fast.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "maxConcurrent": 3,
+  "maxConcurrent": 2,
   "clients": {
     "codex": {
       "code": {
@@ -65,6 +65,17 @@
         "effort": null
       },
       "avoidModels": []
+    },
+    "grok": {
+      "code": {
+        "model": "grok-build-0.1",
+        "effort": null
+      },
+      "light": {
+        "model": "grok-build-0.1",
+        "effort": null
+      },
+      "avoidModels": []
     }
   }
 }

package/policies/quality.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "maxConcurrent": 3,
+  "maxConcurrent": 2,
   "clients": {
     "codex": {
       "code": {
-        "model": "gpt-6-astra",
-        "effort": "xhigh"
+        "model": "gpt-6.1-sol",
+        "effort": "high"
       },
       "light": {
         "model": "gpt-6.1-sol",
@@ -25,8 +25,8 @@
     },
     "claude": {
       "code": {
-        "model": "claude-fable-5-1",
-        "effort": "xhigh"
+        "model": "claude-opus-5-5",
+        "effort": "high"
       },
       "light": {
         "model": "claude-sonnet-5-5",
@@ -46,8 +46,8 @@
     },
     "kimi": {
       "code": {
-        "model": "kimi-code/k3.1-pro",
-        "effort": "max"
+        "model": "kimi-code/k3",
+        "effort": "high"
       },
       "light": {
         "model": "kimi-code/kimi-for-coding",
@@ -85,6 +85,27 @@
         }
       },
       "avoidModels": []
+    },
+    "grok": {
+      "code": {
+        "model": "grok-4.7",
+        "effort": null
+      },
+      "light": {
+        "model": "grok-build-0.1",
+        "effort": null
+      },
+      "roles": {
+        "explorer": {
+          "model": "grok-4.7",
+          "effort": null
+        },
+        "writer": {
+          "model": "grok-4.7",
+          "effort": null
+        }
+      },
+      "avoidModels": []
     }
   }
 }

package/schema/policy.schema.json

@@ -50,6 +50,9 @@
         },
         "agy": {
           "$ref": "#/$defs/tierClient"
+        },
+        "grok": {
+          "$ref": "#/$defs/grokClient"
         }
       }
     }
@@ -151,6 +154,12 @@
               "$ref": "#/$defs/profile"
             }
           }
+        },
+        "maxConcurrent": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 32,
+          "description": "Overrides the shared maxConcurrent fallback for this tool."
         }
       }
     },
@@ -200,6 +209,12 @@
               "$ref": "#/$defs/tierProfile"
             }
           }
+        },
+        "maxConcurrent": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 32,
+          "description": "Overrides the shared maxConcurrent fallback for this tool."
         }
       }
     },
@@ -281,6 +296,12 @@
               "$ref": "#/$defs/kimiProfile"
             }
           }
+        },
+        "maxConcurrent": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 32,
+          "description": "Overrides the shared maxConcurrent fallback for this tool."
         }
       }
     },
@@ -353,6 +374,83 @@
               "$ref": "#/$defs/claudeProfile"
             }
           }
+        },
+        "maxConcurrent": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 32,
+          "description": "Overrides the shared maxConcurrent fallback for this tool."
+        }
+      }
+    },
+    "grokProfile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "model",
+        "effort"
+      ],
+      "properties": {
+        "model": {
+          "$ref": "#/$defs/identifier"
+        },
+        "effort": {
+          "type": "null"
+        }
+      }
+    },
+    "grokClient": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "code",
+        "light",
+        "avoidModels"
+      ],
+      "properties": {
+        "code": {
+          "$ref": "#/$defs/grokProfile"
+        },
+        "light": {
+          "$ref": "#/$defs/grokProfile"
+        },
+        "avoidModels": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/identifier"
+          }
+        },
+        "roles": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "worker": {
+              "$ref": "#/$defs/grokProfile"
+            },
+            "reviewer": {
+              "$ref": "#/$defs/grokProfile"
+            },
+            "explorer": {
+              "$ref": "#/$defs/grokProfile"
+            },
+            "routine": {
+              "$ref": "#/$defs/grokProfile"
+            },
+            "tester": {
+              "$ref": "#/$defs/grokProfile"
+            },
+            "writer": {
+              "$ref": "#/$defs/grokProfile"
+            }
+          }
+        },
+        "maxConcurrent": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 32,
+          "description": "Overrides the shared maxConcurrent fallback for this tool."
         }
       }
     }