agent-profile-kit 0.237.0 → 0.238.0

package/README.md

@@ -3,13 +3,13 @@
 Agent Profile Kit composes your Skills and Context into portable Profiles and
 installs them into the projects you choose, as native material for your agents.
 
-The initial release supports macOS only, on the Node.js 22 line — the package's
-declared primary Node runtime; no newer Node release line is claimed. The
+The initial release supports macOS only, on Node.js 22 or newer. Node 22 is
+the primary qualification line, and CI also runs the packed CLI on Node 23
+through 26 ([ADR-0054](docs/adr/0054-support-node-22-and-newer.md)). The
 actually observed baseline (macOS version, CPU architecture, and Node version)
 is recorded in each supervised qualification run's record, retained as CI
-evidence. Supporting additional environments is an explicit decision backed by
-matching packed installation and lifecycle evidence, never an engine-range
-promise.
+evidence. Supporting additional operating systems is an explicit decision
+backed by matching packed installation and lifecycle evidence.
 
 Supported agents: Antigravity, Codex, Claude Code, Grok, OpenCode, and Pi.
 

package/dist/cli.js

@@ -7199,7 +7199,7 @@ var AUTHORING_EXAMPLES = {
 // package.json
 var package_default = {
   name: "agent-profile-kit",
-  version: "0.237.0",
+  version: "0.238.0",
   description: "Compose portable agent material into host-native profiles.",
   license: "MIT",
   repository: {
@@ -7226,7 +7226,7 @@ var package_default = {
     prepack: "bun run build"
   },
   engines: {
-    node: ">=22 <23",
+    node: ">=22",
     bun: "1.4.0"
   },
   os: [
@@ -12091,12 +12091,19 @@ async function planGrokProject(profileId, modules, skills = [], options = {}) {
   const path = resolveGrokContextRulePath(options);
   const skillOutputs = await Promise.all([...skills].sort((left, right) => left.id.localeCompare(right.id)).map((skill2) => planSkillPackageDirectory(skill2, GROK_SKILLS_DISCOVERY_ROOT, ["Grok discovers Skill package through native project .grok/skills"], GROK_SKILL_PROJECTION, materials)));
   const outputs = modules.length > 0 ? [contextRule2(profileId, modules, path, materials), ...skillOutputs] : [...skillOutputs];
-  const setupSteps = modules.length > 0 && path === CLAUDE_CONTEXT_RULE_PATH ? [{
+  const trustSteps = outputs.length > 0 ? [{
+    consequence: "The Profile does not load until the project is trusted.",
+    kind: "trust-required",
+    message: "Trust the bound project in Grok.",
+    humanAction: "trust this project",
+    provenance: "standing"
+  }] : [];
+  const setupSteps = modules.length > 0 && path === CLAUDE_CONTEXT_RULE_PATH ? [...trustSteps, {
     kind: "shared-path",
     message: `Grok uses Profile Context from Claude's shared rule path: ${CLAUDE_CONTEXT_RULE_PATH}.`,
     humanAction: `it reads Claude's Context file at ${CLAUDE_CONTEXT_RULE_PATH}`,
     provenance: "standing"
-  }] : [];
+  }] : trustSteps;
   return {
     host: "grok",
     hostVersion: skillsRequireDisabledModelInvocation(skills) ? GROK_HOST_VERSION_WITH_INVOCATION : skills.length > 0 ? GROK_HOST_VERSION_WITH_SKILLS : GROK_HOST_VERSION,

package/docs/guides/agent-workflow.md

@@ -7,7 +7,7 @@ Use this workflow when helping a person set up Agent Profile Kit, migrate their
 When a user points you at this repository or asks you to set up Agent Profile Kit from scratch, execute these five steps non-interactively (confirming user choices before writing):
 
 1. **Run `apkit` without requiring manual CLI setup.**
-   Check whether `apkit` is on `PATH` (`command -v apkit`). If not, invoke it via `npx --yes --package agent-profile-kit apkit <command>`. Always pass explicit paths and `--auto-confirm` (or `--yes` on `init` when switching Workspaces) so commands never hang waiting for a terminal prompt. Optionally offer to add `alias apkit="npx --yes --package agent-profile-kit apkit"` to `~/.zshrc` if the user wants a short command for themselves.
+   Check whether `apkit` is on `PATH` (`command -v apkit`). If not, invoke it via `npx --yes --package agent-profile-kit apkit <command>`. Always pass explicit paths, and pass `--auto-confirm` to the commands that confirm (`install`, `uninstall`, and `configure profile`) so they never hang waiting for a terminal prompt. `init`, `new`, `validate`, `status`, and `update` take no confirmation flag: run without a terminal, they never prompt, and a supplied `init` path counts as confirmation. Optionally offer to add `alias apkit="npx --yes --package agent-profile-kit apkit"` to `~/.zshrc` if the user wants a short command for themselves.
 2. **Initialize or connect the Workspace.**
    Check `~/.agents/agent-profile-kit/config.yaml` first. If no Workspace is configured, ask the user where they want their Workspace (suggest `~/agent-profile-workspace` or `~/projects/agent-profile-workspace`) and run `apkit init <workspace>`.
 3. **Discover and migrate existing Skills and instruction files.**
@@ -141,7 +141,10 @@ When a user points you at this repository or asks you to set up Agent Profile Ki
    packages after restarting running sessions. Pi bindings load the generated
    `.pi/APPEND_SYSTEM.md` and shared `.agents/skills/<Artifact ID>` packages after
    Pi's native trust boundary; packages, extensions, and other Skill sources coexist
-   through Pi agent resolution. For non-Git projects, remind the user that Codex must
+   through Pi agent resolution. Grok bindings load the generated `.grok/rules/` rule
+   (or Claude's shared rule when Claude is co-selected and Grok's Claude rules
+   compatibility is on) and `.grok/skills/<Artifact ID>`
+   packages after Grok's native folder trust. For non-Git projects, remind the user that Codex must
    launch from the exact bound root.
 8. Use `apkit status` for the bound Project containing cwd, pass one explicit
    Project root, or use `apkit status --all` for the fleet. Its concise result

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-profile-kit",
-  "version": "0.237.0",
+  "version": "0.238.0",
   "description": "Compose portable agent material into host-native profiles.",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "prepack": "bun run build"
   },
   "engines": {
-    "node": ">=22 <23",
+    "node": ">=22",
     "bun": "1.4.0"
   },
   "os": [