@yemi33/minions 0.1.2425 → 0.1.2426

package/docs/README.md

@@ -9,8 +9,8 @@ Hands-on stories and distribution guides for people running or evaluating Minion
 - [blog-first-successful-dispatch.md](blog-first-successful-dispatch.md) — Narrative walkthrough of the first end-to-end agent dispatch and the seven failed spawn attempts that preceded it.
 - [architecture-review-2026-07-09.md](architecture-review-2026-07-09.md) — Architecture review covering engine orchestration, SQL/JSON state boundaries, runtime/process recovery, worktree lifecycle, pipelines/schedules, and prompt assembly, verified against `origin/main` at `b1b83dd2`.
 - [documentation-audit-2026-07-09.md](documentation-audit-2026-07-09.md) — Verified user-facing documentation audit covering runtime, CLI, storage, routing, and broken-link corrections.
-- [distribution.md](distribution.md) — How Minions is published (this repo: `@opg-microsoft/minions` to GitHub Packages; paired peer `@yemi33/minions` to npm) and the bidirectional sync contract — automated opg → yemi33 backport workflow + manual yemi33 → opg sync PRs.
-- [internal-install.md](internal-install.md) — One-command internal install/upgrade of `@opg-microsoft/minions` from the ISS `ProjectFeed-ISS` Azure Artifacts feed using the caller's `az` login: the ordered migration plan, consistent state backup, temporary-token handling, active-agent deferral, and idempotency.
+- [internal-install.md](internal-install.md) — **Start here to install.** One-command internal install/upgrade of `@opg-microsoft/minions` from the ISS `ProjectFeed-ISS` Azure Artifacts feed using the caller's `az` login: the ordered migration plan, consistent state backup, temporary-token handling, active-agent deferral, and idempotency.
+- [distribution.md](distribution.md) — How Minions is published: the internal `@opg-microsoft/minions` customer channel consumed from ISS `ProjectFeed-ISS`, the public/legacy `@yemi33/minions` npm channel, and the bidirectional sync contract — automated opg → yemi33 backport workflow + manual yemi33 → opg sync PRs.
 - [onboarding.md](onboarding.md) — Condensed first-30-minutes walkthrough for a new operator.
 - [tutorials/README.md](tutorials/README.md) — Progressive tutorial track from installation through advanced automation and operations.
 

package/docs/index.html

@@ -88,7 +88,7 @@
   <h1>Minions <span>Mission Control</span></h1>
   <p class="tagline">Five autonomous coding agents, one engine, one dashboard. Plan, implement, review, verify, and ship code with human control at every gate.</p>
   <div class="hero-badges">
-    <span class="hero-badge green">Node.js 18+</span>
+    <span class="hero-badge green">Node.js 22.5+</span>
     <span class="hero-badge blue">Claude or Copilot</span>
     <span class="hero-badge yellow">Multi-Project</span>
     <span class="hero-badge purple">Dashboard + CLI</span>
@@ -96,6 +96,7 @@
   <div class="cta">
     <a href="https://www.npmjs.com/package/@yemi33/minions" class="cta-primary">Install from npm</a>
     <a href="#quickstart" class="cta-secondary">Quick Start</a>
+    <a href="https://github.com/opg-microsoft/minions/blob/HEAD/docs/internal-install.md" class="cta-secondary">OPG internal install</a>
     <a href="demo/memory-system.html" class="cta-secondary">Explore the Memory System</a>
   </div>
 </div>
@@ -221,10 +222,16 @@
 <!-- Quick Start -->
 <div class="quickstart" id="quickstart">
   <h2>Quick Start</h2>
-  <pre><span class="comment"># Prerequisites: Node.js 18+, Git, and at least one agent runtime</span>
+  <pre><span class="comment"># Prerequisites: Node.js 22.5+, Git, and at least one agent runtime</span>
 <span class="comment"># Install Claude Code or GitHub Copilot CLI separately, then install Minions</span>
 npm install -g @yemi33/minions
 
+<span class="comment"># OPG (Microsoft) only: the internal channel is @opg-microsoft/minions on the</span>
+<span class="comment"># ISS ProjectFeed-ISS feed. Clone the repository, then run the one-command</span>
+<span class="comment"># installer — it needs `az login` with read access to that feed.</span>
+<span class="comment">#   scripts\install-internal-minions.ps1     # Windows</span>
+<span class="comment">#   ./scripts/install-internal-minions.sh    # Linux / macOS</span>
+
 <span class="comment"># Bootstrap ~/.minions/ and scan/link repositories</span>
 minions init
 

package/docs/internal-install.md

@@ -1,10 +1,19 @@
 # Internal install & state migration (ISS ProjectFeed-ISS)
 
-One command installs or upgrades the internal Minions package
-(`@opg-microsoft/minions`) from the **ISS `ProjectFeed-ISS` Azure Artifacts npm
-registry** using your existing Azure CLI login, then migrates the existing
-runtime in place — preserving config, SQLite state, notes, plans, knowledge, and
-project links.
+**This is the supported installation path for OPG customers.** One command
+installs or upgrades the internal Minions package (`@opg-microsoft/minions`) from
+the **ISS `ProjectFeed-ISS` Azure Artifacts npm registry** using your existing
+Azure CLI login, then migrates the existing runtime in place — preserving config,
+SQLite state, notes, plans, knowledge, and project links.
+
+The registry is the feed's **base** npm registry:
+
+```
+https://pkgs.dev.azure.com/office/ISS/_packaging/ProjectFeed-ISS/npm/registry/
+```
+
+Packages live in the feed's Local view, so do **not** point at a view-qualified
+registry such as `ProjectFeed-ISS@Release`.
 
 No manually created PAT is required, accepted, or stored.
 
@@ -164,11 +173,24 @@ reinstates `download-artifact` + `install-internal` so the shim is re-linked.
 ## Relationship to `minions update`
 
 `minions update` is the in-place updater for whichever package is already
-installed. This script is the **channel bootstrap**: it is what moves a machine
-onto the internal ProjectFeed-ISS channel (including replacing a public
-`@yemi33/minions` install) and what installs the internal package on a machine
-that has no Minions at all. Once a machine is on the internal channel, routine
-upgrades are `minions update` — or this script again, which is idempotent.
+installed: it resolves the active package name from the installed manifest and
+reinstalls *that* package, so an internal install upgrades itself instead of
+pulling in the public one.
+
+It does **not** configure a registry. `minions update` shells out to plain
+`npm view <pkg> version` / `npm install -g <pkg>@<version>`
+(`engine/shared.js#buildNpmViewVersionCommand` / `#buildNpmGlobalInstallCommand`),
+so on the internal channel it only reaches `ProjectFeed-ISS` when your **own**
+npm configuration already has a persistent scoped registry entry and credentials
+for the feed — for example `@opg-microsoft:registry=<base feed URL>` in your user
+`.npmrc`. This script's npm config is deliberately temporary and is deleted after
+every run, so it leaves nothing behind for `minions update` to reuse.
+
+Re-running this script is therefore the upgrade path that always works: it
+acquires its own short-lived token per run and is idempotent. It is also the
+**channel bootstrap** — what moves a machine onto the internal ProjectFeed-ISS
+channel (including replacing a public `@yemi33/minions` install) and what installs
+the internal package on a machine that has no Minions at all.
 
 ## Troubleshooting
 

package/docs/onboarding.md

@@ -10,15 +10,41 @@ completed first dispatch. For deeper, progressive exercises, use the
 - Git
 - One supported runtime CLI with working authentication
 - A local Git repository you are comfortable allowing an agent to change
+- For the internal (OPG) install: Azure CLI signed in (`az login`) and Azure
+  Artifacts **read** permission on the ISS `ProjectFeed-ISS` feed
 
 Minions defaults to GitHub Copilot CLI. Claude Code and Codex are also
 supported.
 
 ## 1. Install and initialize
 
+Install the internal package `@opg-microsoft/minions` from the ISS
+`ProjectFeed-ISS` Azure Artifacts feed with the repository's one-command
+installer. It installs the package and runs `minions init --force` for you:
+
+```powershell
+scripts\install-internal-minions.ps1     # Windows
+```
+
+```bash
+./scripts/install-internal-minions.sh    # Linux / macOS
+```
+
+The installer acquires a short-lived token from your existing `az` login — no PAT
+is created, accepted, or stored. Full options and troubleshooting:
+[internal-install.md](internal-install.md).
+
+If you do not have access to the ISS `ProjectFeed-ISS` feed, install the public
+package from npm instead (separate release channel, not the OPG path):
+
 ```bash
 npm install -g @yemi33/minions
 minions init
+```
+
+Either way, verify the host next:
+
+```bash
 minions doctor
 ```
 

package/docs/tutorials/01-install-and-connect.md

@@ -9,6 +9,8 @@ repository, and start the engine and dashboard.
 - Git
 - GitHub Copilot CLI, Claude Code, or Codex CLI with working authentication
 - A local Git repository with an `origin` remote
+- For the internal (OPG) install: Azure CLI signed in (`az login`) and Azure
+  Artifacts **read** permission on the ISS `ProjectFeed-ISS` feed
 
 Minions defaults to GitHub Copilot CLI. Install it if you have not selected a
 different runtime:
@@ -19,6 +21,27 @@ npm install -g @github/copilot
 
 ## 1. Install and initialize
 
+Install the internal package `@opg-microsoft/minions` from the ISS
+`ProjectFeed-ISS` Azure Artifacts feed using the repository's one-command
+installer:
+
+```powershell
+scripts\install-internal-minions.ps1     # Windows
+```
+
+```bash
+./scripts/install-internal-minions.sh    # Linux / macOS
+```
+
+The installer validates feed access, installs the package, and then runs the
+supported `minions init --force` synchronization — so no separate `minions init`
+is needed. It authenticates with a short-lived token from your existing `az`
+login; no PAT is created, accepted, or stored. See
+[internal-install.md](internal-install.md) for options and troubleshooting.
+
+If you do not have access to the ISS `ProjectFeed-ISS` feed, install the public
+package from npm instead (a separate release channel, not the OPG path):
+
 ```bash
 npm install -g @yemi33/minions
 minions init

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.2425",
+  "version": "0.1.2426",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"