Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions plugins/magpie-setup/skills/isolated-setup-update/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ when_to_use: >-
capability: capability:platform
surface_hash: sha256:1f327e069312dad2
license: Apache-2.0
measured_tokens: 5327
measured_tokens: 5369
---

<!-- Placeholder convention (see AGENTS.md#placeholder-convention-used-in-skill-files):
Expand Down Expand Up @@ -225,7 +225,8 @@ If everything is in sync and verification still passes, say so explicitly and st

If something is out-of-date or has drifted, name the concrete follow-up:

- Framework checkout behind → run [`setup upgrade`](../setup/upgrade.md), which refreshes the gitignored snapshot per the committed `.apache-magpie.lock` after the same pre-flight checks this skill recommends and surfaces what arrived in the new snapshot.
- Framework checkout behind `origin/main` → the `git pull --ff-only` that check 1 printed, run by the user.
- Snapshot drift (the local lock differs from the committed `.apache-magpie.lock`) → run [`setup upgrade`](../setup/upgrade.md), which refreshes the gitignored snapshot per the committed `.apache-magpie.lock` after the same pre-flight checks this skill recommends and surfaces what arrived in the new snapshot.
- Pinned-tool (`bubblewrap` / `socat`) upgrade candidate worth adopting → manifest bump PR per [Bumping a pinned version](../../../../docs/setup/secure-agent-setup.md#bumping-a-pinned-version).
- `claude-code` newer build available, or below the `min_version` floor → `npm install -g --no-save @anthropic-ai/claude-code@latest` (no manifest bump — the runtime is unpinned; below-floor is a hard-fail in `setup-isolated-setup-verify`).
- comdev MCP checkout behind `origin/main` → run the printed `git pull --ff-only` + `npm install`; no manifest bump or cooldown (these track `main` by design).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"follow_up": [
{
"skill": "setup-isolated-setup-update",
"reason": "snapshot ref drift detected — refresh the snapshot via update; claude-code is at/above its min_version floor"
"reason": "check 5 ⚠ — bubblewrap drifted from its pin with a framework checkout found; claude-code is at/above its min_version floor"
}
]
}
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,7 @@ Check results (all 8 checks ran):
Check 2 (user-scope hooks): ✓
Check 3 (hook scripts): ✓
Check 4 (claude-iso): ✓
Check 5 (tool versions): ✓ claude-code 2.1.150 installed, at or above min_version floor 2.1.150
Check 5 (tool versions): ⚠ bubblewrap 0.11.0 installed, pinned 0.11.1 in the framework checkout at ~/code/magpie; claude-code 2.1.150 at or above min_version floor 2.1.150
Check 6 (sandbox.enabled): ✓
Check 7 (denial commands): ✓
Check 8 (project root): ✓

Snapshot drift: ref (local v0.9.2, committed pin v0.9.1)
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
{
"overall": "fail",
"follow_up": [
{
"skill": "setup-isolated-setup-install",
"reason": "checks 1, 2, 3, 4, 6, 7, 8 failed — sandbox disabled, hooks and scripts missing, claude-iso not sourced; re-install will also add the sandbox-add-project-root.sh helper for check 8"
},
{
"skill": "npm install -g --no-save @anthropic-ai/claude-code@latest",
"reason": "check 5 — claude-code 1.9.0 is BELOW the min_version floor 2.1.150; HARD FAIL under Claude Code — upgrade to @latest before re-verifying"
},
{
"skill": "setup-isolated-setup-install",
"reason": "checks 1, 2, 3, 4, 6, 7, 8 failed — sandbox disabled, hooks and scripts missing, claude-iso not sourced; re-install will also add the sandbox-add-project-root.sh helper for check 8"
}
]
}
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,9 @@ Return ONLY valid JSON with this structure:
`"fail"` when any check is ✗.
An `inconclusive` or `unchecked` check counts as neither ⚠ nor ✗ for `overall`, but still gets a `follow_up` entry.
`follow_up` is an empty array when every check is ✓.
Give one entry per distinct `skill`: when several checks point at the same skill or command, merge their reasons into that entry.
A finding whose remedy is the operator's own decision or edit, with no skill or command of its own, goes into the reason of the entry for the same check rather than an entry of its own.
Order the entries by urgency: a hard fail that stops the run (claude-code below its `min_version` floor) first, then the rest in the order `remediation.md` lists their checks.
`skill` is the skill slug (e.g. `"setup-isolated-setup-install"`) or
`"sandbox-add-project-root.sh --all-worktrees"` for the check-8 helper.
Do not include any text outside the JSON object.