neo-agent-skills 0.1.80 → 0.1.82

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -166,7 +166,7 @@ Expand these audits only when their trigger fires; otherwise omit them rather th
166
166
  - **📜 Source-of-Authority Audit:** review cites operator or peer authority for a demand.
167
167
  - **🔌 Wire-Format Compatibility Audit:** PR alters JSON-RPC notification schemas, payload envelopes, native API wire formats, event payloads, tool signatures, or database schemas.
168
168
  - **🧠 Turn-Memory / Substrate-Load Audit:** PR modifies files in `/turn-memory-pre-flight` IN-SCOPE list. Verify the author documented the decision-tree application and load-effect audit in the PR body; if missing, load `audits/loading-runtime-effect.md` and use its Required Action template.
169
- - **📸 Before/After Audit:** PR targets `neomjs/neo-stage`. The body embeds at least one before (base) and one after (head) screenshot of what it changes; a missing pair is Request Changes, since the operator merges no Stage PR without one.
169
+ - **📸 Before/After Audit:** PR targets `neomjs/neo-stage`. The body embeds at least one before (base) and one after (head) screenshot of what it changes, and both render for a signed-in viewer: embed `https://github.com/neomjs/neo-stage/blob/<full-sha>/<path>?raw=true`, since a `raw.githubusercontent.com` embed 404s on this private repo and counts as missing. A missing pair is Request Changes, since the operator merges no Stage PR without one.
170
170
 
171
171
  ---
172
172
 
@@ -72,40 +72,23 @@ Detect your checkout class **mechanically** — never guess from harness names.
72
72
 
73
73
  The pull refreshes code; in `neo-agent-brain` (where `ai/` lives post-split), `--migrate-config` reconciles the gitignored `config.mjs` operator-overlay with pulled `config.template.mjs` leaves — a pull alone is NOT enough, because daemons and MCP servers read the overlay, not the template. Because the AI harness initializes MCP servers *before* an agent's first turn, sunset is the only window where this refresh lands in time for the next session's boot. **Any failure (dirty tree, switch/pull/script error) is surfaced in the Step 3 handover comment and the final sunset payload — the refresh is best-effort and must NEVER block sunset completion.**
74
74
 
75
- > **Division of labor + retirement (Substrate Accretion Defense):** the orchestrator's `primary-dev-sync` task syncs the operator's primary checkout only; per-agent clones are never daemon-pulled (an FF-pull racing an active session is the hazard), so this step owns agent-clone freshness and sunset is its safe window. The pull retires only if clone topology changes or a session-liveness-aware sync lane ships; the `neo-agent-brain`-scoped reconcile only if MCP server boot auto-reconciles overlays or local `ai/config.mjs` overlays retire.
75
+ > **Division of labor + retirement (Substrate Accretion Defense):** the orchestrator's dev-sync lane keeps the checkouts the daemons run from current on its cadence — its own root, or those listed in `devSyncRoots` — never a seat's clones; a seat's clones are the seat's own (the Fleet Manager gives every seat its full set), and an FF-pull racing an active session is the hazard, so this step owns their freshness and sunset is its safe window. The pull retires only if a session-liveness-aware sync lane covers seat clones; the `neo-agent-brain`-scoped reconcile only if MCP server boot auto-reconciles overlays or local `ai/config.mjs` overlays retire.
76
76
 
77
- - **Linked worktree — push only:** do NOT switch to `dev` (the primary holds it; git refuses to share a branch across worktrees). Ensure your current PR branch is fully committed and pushed (`git push origin HEAD`). The next agent session will either resume this worktree or bootstrap a new one from the primary's refreshed `dev`.
77
+ - **Linked worktree — push, then refresh your own clone from here:** do NOT switch to `dev` in the worktree (the clone holds it; git refuses to share a branch across worktrees). Commit and push the PR branch (`git push origin HEAD`), then refresh the clone's `dev` from the worktree, best-effort — the pull and, in `neo-agent-brain`, the overlay reconcile, as above:
78
78
 
79
- #### Primary-Checkout Staleness Probe (Linked worktree only) — per #11013
80
-
81
- The "main checkout's updated `dev`" assumption above only holds if the operator has pulled `origin/dev` into the primary checkout. Primary's `dev` can fall behind because:
82
-
83
- - Worktree agents (per the Linked-worktree rule above) do NOT pull `dev` into primary.
84
- - Operators don't always run `git pull origin dev` between sunset events.
85
- - In `neo-agent-brain`, the daemons running from primary (`orchestrator-daemon`, `wake-daemon`, `DreamService`, KB sync) read pre-merge code when primary is stale.
86
-
87
- **Mandatory sunset probe (Isolated Worktree branch only):**
88
-
89
- ```bash
90
- # Resolve primary-checkout path from the shared .git/ common dir.
91
- # git rev-parse --git-common-dir returns "<primary>/.git" from any worktree.
92
- PRIMARY_DOT_GIT=$(git rev-parse --git-common-dir)
93
- PRIMARY_ROOT=$(cd "$PRIMARY_DOT_GIT/.." && pwd)
94
-
95
- # Refresh remote refs so the count is accurate.
96
- git -C "$PRIMARY_ROOT" fetch origin dev --quiet 2>/dev/null
97
-
98
- # Count commits primary's local dev is behind origin/dev.
99
- BEHIND=$(git -C "$PRIMARY_ROOT" rev-list --count dev..origin/dev 2>/dev/null || echo 0)
100
- ```
101
-
102
- **Conditional handover-comment block (fire only when `BEHIND > 0`):**
103
-
104
- > ⚠️ **Primary-checkout reminder:** the operator's primary checkout (`<PRIMARY_ROOT>`) `dev` branch is **`<BEHIND>` commits behind `origin/dev`**. Run `git -C <PRIMARY_ROOT> pull origin dev` in your main checkout (in `neo-agent-brain` also `node <PRIMARY_ROOT>/ai/scripts/setup/initServerConfigs.mjs --migrate-config`, so the gitignored `config.mjs` overlay reconciles to the pulled `config.template.mjs` leaves).
105
-
106
- When `BEHIND == 0`, suppress the block — no handover-comment noise on a fresh primary.
79
+ ```bash
80
+ CLONE="$(cd "$(git rev-parse --git-common-dir)/.." && pwd)" # the seat's own clone, which this worktree belongs to
81
+ if [ -z "$(git -C "$CLONE" status --porcelain)" ] && [ "$(git -C "$CLONE" branch --show-current)" = dev ]; then
82
+ git -C "$CLONE" pull --ff-only origin dev
83
+ if [ -f "$CLONE/ai/scripts/setup/initServerConfigs.mjs" ]; then
84
+ (cd "$CLONE" && node ai/scripts/setup/initServerConfigs.mjs --migrate-config)
85
+ fi
86
+ else
87
+ echo 'clone dirty or not on dev — skip refresh, surface in handover'
88
+ fi
89
+ ```
107
90
 
108
- **Why at sunset:** the operator is the next actor between sessions and the agent is already writing the handover; mid-session staleness of the primary belongs to `primary-dev-sync` (the division of labor above).
91
+ The same surfacing rule as the primary-clone branch: a skip or a failed pull goes into the handover, never blocks the sunset. The next session resumes this worktree or bootstraps a new one from the refreshed `dev`. Every seat owns its clones; no one else refreshes them.
109
92
 
110
93
  ### Step 2: Active PR Cycle State is daemon-owned — agents must NOT trigger sandman
111
94
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "neo-agent-skills",
3
- "version": "0.1.80",
3
+ "version": "0.1.82",
4
4
  "description": "Install the workflow substrate a cross-model AI team actually runs on: ticket intake, PR review gates, lane coordination and guards, versioned as a package. The skills Neo.mjs maintainers load every session — materialized into your repo, not copied.",
5
5
  "type": "module",
6
6
  "license": "MIT",