thenotoriousllama · Oct 15, 2026 · Oct 15, 2026 · Oct 15, 2026 · Oct 15, 2026 · Oct 15, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -5,7 +5,7 @@
   },
   "metadata": {
     "description": "The Wasp Nest: core plus add-on packs.",
-    "version": "3.0.0"
+    "version": "3.0.1"
   },
   "plugins": [
     {

diff --git a/PUBLICATION-MANIFEST.json b/PUBLICATION-MANIFEST.json
diff --git a/README.md b/README.md
@@ -165,31 +165,31 @@ The Drone and Stinger pairing is enforced by the source validator. A missing pai
 
 ## What ships
 
-Marketplace release **v3.0.0**. The core and add-on packs have independent manifest versions; counts and descriptions below are read from the built plugins, not maintained by hand.
+Marketplace release **v3.0.1**. The core and add-on packs have independent manifest versions; counts and descriptions below are read from the built plugins, not maintained by hand.
 
 | Plugin | Version | Stingers | Drones | What it does |
 | --- | --- | ---: | ---: | --- |
-| [wasp-nest-core](plugins/wasp-nest-core/README.md) | 3.0.0 | 18 | 14 | The Wasp Nest core: shared Drones and Stingers, orchestration commands, rules, and hooks. |
-| [app-primer-zero](plugins/app-primer-zero/README.md) | 3.0.0 | 1 | 0 | Prepare an app library, contracts, schema baseline and a wave handoff before building. |
-| [backend-and-desktop-tools](plugins/backend-and-desktop-tools/README.md) | 3.0.0 | 10 | 10 | Implement TypeScript, Python, Go, Rust, native apps, APIs and terminal workflows. |
-| [browser-and-app-testing-tools](plugins/browser-and-app-testing-tools/README.md) | 3.0.0 | 4 | 4 | Automate browsers, capture live apps and measure Lighthouse/PageSpeed behavior. |
-| [business-and-product-tools](plugins/business-and-product-tools/README.md) | 3.0.0 | 15 | 15 | Form and run a company, discover product needs, hire teams and improve delivery. |
-| [code-audit-tools](plugins/code-audit-tools/README.md) | 3.0.0 | 12 | 11 | Audit repositories and app security, measure bloat, inspect branches and plan remediation. |
-| [content-intelligence](plugins/content-intelligence/README.md) | 3.0.0 | 2 | 0 | Find and verify current repository/news topics and prepare voice-matched drafts. |
-| [data-and-ai-tools](plugins/data-and-ai-tools/README.md) | 3.0.0 | 12 | 12 | Design data, retrieval, AI runtime, model tooling and agent operations. |
-| [developer-learning-tools](plugins/developer-learning-tools/README.md) | 3.0.0 | 4 | 4 | Explain technical sources with source-grounded analogies and learner checks. |
-| [documentation-tools](plugins/documentation-tools/README.md) | 3.0.0 | 8 | 8 | Refresh, extract, publish and package documentation from real sources. |
-| [growth-and-customer-tools](plugins/growth-and-customer-tools/README.md) | 3.0.0 | 15 | 15 | Research buyers, acquire leads, follow up, support customers and grow accounts. |
-| [highlevel](plugins/highlevel/README.md) | 3.0.0 | 3 | 3 | Integrate HighLevel, build with AI Studio and map exported workflows. |
-| [infrastructure-decision-tools](plugins/infrastructure-decision-tools/README.md) | 3.0.0 | 6 | 6 | Prepare platform assets and account dependencies without implicit setup actions. |
-| [littlebird-toolkit](plugins/littlebird-toolkit/README.md) | 3.0.0 | 30 | 0 | Turn Littlebird memory into evidence-backed operating work. |
-| [media-and-creative-tools](plugins/media-and-creative-tools/README.md) | 3.0.0 | 4 | 4 | Create consented photography and integrate voice and video production. |
-| [platform-and-release-tools](plugins/platform-and-release-tools/README.md) | 3.0.0 | 20 | 20 | Integrate authentication, payments, analytics, messaging and production delivery. |
-| [product-studio](plugins/product-studio/README.md) | 3.0.0 | 3 | 3 | Turn an idea into a buildable plan: product strategy, Claude-Design-grade UX, a PRD map, a wave plan and a Definition of Done. |
-| [repository-modernization-tools](plugins/repository-modernization-tools/README.md) | 3.0.0 | 1 | 1 | Compose repository baseline, safe refactoring and contributor onboarding through selected specialist owners. |
-| [software-economics-tools](plugins/software-economics-tools/README.md) | 3.0.0 | 4 | 4 | Model supplied software economics and costs with explicit scenarios and evidence. |
-| [web-development-tools](plugins/web-development-tools/README.md) | 3.0.0 | 30 | 30 | Build web interfaces and sites with React, Svelte, design systems and accessible components. |
-| [website-audit-tools](plugins/website-audit-tools/README.md) | 3.0.0 | 21 | 20 | Audit a public website with crawl, SEO, accessibility, conversion and evidence-backed reports. |
+| [wasp-nest-core](plugins/wasp-nest-core/README.md) | 3.0.1 | 18 | 14 | The Wasp Nest core: shared Drones and Stingers, orchestration commands, rules, and hooks. |
+| [app-primer-zero](plugins/app-primer-zero/README.md) | 3.0.1 | 1 | 0 | Prepare an app library, contracts, schema baseline and a wave handoff before building. |
+| [backend-and-desktop-tools](plugins/backend-and-desktop-tools/README.md) | 3.0.1 | 10 | 10 | Implement TypeScript, Python, Go, Rust, native apps, APIs and terminal workflows. |
+| [browser-and-app-testing-tools](plugins/browser-and-app-testing-tools/README.md) | 3.0.1 | 4 | 4 | Automate browsers, capture live apps and measure Lighthouse/PageSpeed behavior. |
+| [business-and-product-tools](plugins/business-and-product-tools/README.md) | 3.0.1 | 15 | 15 | Form and run a company, discover product needs, hire teams and improve delivery. |
+| [code-audit-tools](plugins/code-audit-tools/README.md) | 3.0.1 | 12 | 11 | Audit repositories and app security, measure bloat, inspect branches and plan remediation. |
+| [content-intelligence](plugins/content-intelligence/README.md) | 3.0.1 | 2 | 0 | Find and verify current repository/news topics and prepare voice-matched drafts. |
+| [data-and-ai-tools](plugins/data-and-ai-tools/README.md) | 3.0.1 | 12 | 12 | Design data, retrieval, AI runtime, model tooling and agent operations. |
+| [developer-learning-tools](plugins/developer-learning-tools/README.md) | 3.0.1 | 4 | 4 | Explain technical sources with source-grounded analogies and learner checks. |
+| [documentation-tools](plugins/documentation-tools/README.md) | 3.0.1 | 8 | 8 | Refresh, extract, publish and package documentation from real sources. |
+| [growth-and-customer-tools](plugins/growth-and-customer-tools/README.md) | 3.0.1 | 15 | 15 | Research buyers, acquire leads, follow up, support customers and grow accounts. |
+| [highlevel](plugins/highlevel/README.md) | 3.0.1 | 3 | 3 | Integrate HighLevel, build with AI Studio and map exported workflows. |
+| [infrastructure-decision-tools](plugins/infrastructure-decision-tools/README.md) | 3.0.1 | 6 | 6 | Prepare platform assets and account dependencies without implicit setup actions. |
+| [littlebird-toolkit](plugins/littlebird-toolkit/README.md) | 3.0.1 | 30 | 0 | Turn Littlebird memory into evidence-backed operating work. |
+| [media-and-creative-tools](plugins/media-and-creative-tools/README.md) | 3.0.1 | 4 | 4 | Create consented photography and integrate voice and video production. |
+| [platform-and-release-tools](plugins/platform-and-release-tools/README.md) | 3.0.1 | 20 | 20 | Integrate authentication, payments, analytics, messaging and production delivery. |
+| [product-studio](plugins/product-studio/README.md) | 3.0.1 | 3 | 3 | Turn an idea into a buildable plan: product strategy, Claude-Design-grade UX, a PRD map, a wave plan and a Definition of Done. |
+| [repository-modernization-tools](plugins/repository-modernization-tools/README.md) | 3.0.1 | 1 | 1 | Compose repository baseline, safe refactoring and contributor onboarding through selected specialist owners. |
+| [software-economics-tools](plugins/software-economics-tools/README.md) | 3.0.1 | 4 | 4 | Model supplied software economics and costs with explicit scenarios and evidence. |
+| [web-development-tools](plugins/web-development-tools/README.md) | 3.0.1 | 30 | 30 | Build web interfaces and sites with React, Svelte, design systems and accessible components. |
+| [website-audit-tools](plugins/website-audit-tools/README.md) | 3.0.1 | 21 | 20 | Audit a public website with crawl, SEO, accessibility, conversion and evidence-backed reports. |
 
 The [Claude catalog](.claude-plugin/marketplace.json) and [Codex catalog](.agents/plugins/marketplace.json) expose these packs individually. Runtime guides and research distillations ship with them. Raw research archives, `node_modules/`, and ingested photography models do not. The photography pack retains only its blank model template.
 

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-3.0.0
+3.0.1
diff --git a/learn/guides/COMMANDS.md b/learn/guides/COMMANDS.md
@@ -4,7 +4,7 @@ A command gives a repeatable job a short name. It answers **what whole workflow
 
 ## Choose the right command
 
-The catalog defines fourteen source commands: seven in Core and seven in optional plugins. The Core commands below are shown by short name; native Claude uses the `wasp-nest-core:` prefix. Local home installations also expose flat commands.
+The catalog defines seventy-seven source commands: nine in Core and sixty-eight in optional plugins. The tables below list the main entry points; `plugin-catalog.json` has the complete list per plugin. The Core commands below are shown by short name; native Claude uses the `wasp-nest-core:` prefix. Local home installations also expose flat commands.
 
 | Command | Use it when | Expected result |
 | --- | --- | --- |
@@ -15,6 +15,8 @@ The catalog defines fourteen source commands: seven in Core and seven in optiona
 | [`/register`](../../plugins/wasp-nest-core/commands/register.md) | A new Drone/Stinger pair exists but is not discoverable. | Pairing, roster guide, cross-links, and validation. |
 | [`/drift-audit`](../../plugins/wasp-nest-core/commands/drift-audit.md) | The roster may disagree with shipped files. | A findings report; it does not silently fix drift. |
 | [`/re-research`](../../plugins/wasp-nest-core/commands/re-research.md) | A Stinger's external facts need a dated refresh. | Updated evidence and distillation for that one Stinger. |
+| [`/choose-outcome`](../../plugins/wasp-nest-core/commands/choose-outcome.md) | You know the result you want but not which pack or skill owns it. | One recommended route that separates proposed coverage, source presence and installed availability. |
+| [`/qualify-wiring`](../../plugins/wasp-nest-core/commands/qualify-wiring.md) | A skill, agent, command or plugin was added or rewired. | A qualification of source, generated carriers, selected owners and native proof. |
 
 ## Optional command owners
 

diff --git a/learn/guides/GETTING-STARTED.md b/learn/guides/GETTING-STARTED.md
@@ -20,6 +20,8 @@ codex plugin add wasp-nest-core@wasp-nest
 
 Purge the previous Wasp Nest installation before adopting v3; no legacy aliases or command bridge are provided. Keep Core enabled. The [public README](../../README.md#what-ships) lists the current optional packs and their command homes. Install the `highlevel` pack only when you need HighLevel API, AI Studio, or workflow-export work, for example. A pack contains its own Stingers and, where applicable, Drones.
 
+**Python on Windows:** commands in these docs are written as `python3`. On Windows, use `py -3` (or `python`) in their place, for example `py -3 scripts/validate.py`. If `python3` opens the Microsoft Store instead, turn off its app-execution alias under Settings, Apps, Advanced app settings, App execution aliases.
+
 For native Codex roles, first review `~/.wasp-nest/installed-plugins.json` with actual roots for Core and the enabled optional plugins. The local installer writes it; a marketplace/UI install alone is not proven to do so. Then open `/hooks`, trust Core's registration hook and start a new local session. It registers declared roles from that explicit selection under `$CODEX_HOME/agents` (normally `~/.codex/agents`). If a same-name definition has changed, it is backed up before replacement. Role registration requires both the explicit selection and hook trust. Installed Stingers remain their own entry points. [Harness Capabilities](../reference/HARNESS-CAPABILITIES.md) explains why a Claude command appears as a wrapper skill in Codex.
 
 ## Decide whether to set up your home

diff --git a/learn/guides/HOW-WE-BUILD.md b/learn/guides/HOW-WE-BUILD.md
@@ -149,7 +149,9 @@ Before it stops, the AI saves its work and writes down where things stand: what
 
 ### The beacon
 
-A small background helper called the **beacon** writes a "heartbeat" file every time something happens in a session. It lives in `~/.wasp-nest/beacon/`. TARS reads these heartbeats to tell whether a session is still making progress. The beacon only watches. It never blocks anything.
+A small helper called the **beacon** writes a "heartbeat" file whenever one of the session events it is hooked to fires. It lives in `~/.wasp-nest/beacon/`. TARS reads these heartbeats to tell whether a session is still making progress. The beacon only watches. It never blocks anything.
+
+The beacon is bound by the home installs for Claude Code (`~/.claude/settings.json`), Codex (`~/.codex/hooks.json`) and ZCode. The native plugin installs do not bind it: the Claude, OpenAI and Cursor plugins carry no beacon hook, and the Cursor home install does not bind it either. Where it is not bound, there are no heartbeat files, so TARS has only the session list to go on. [`docs/HOOK-CATALOG.md`](../reference/HOOK-CATALOG.md) lists the bindings for each install.
 
 ### Writing style
 

diff --git a/learn/guides/TROUBLESHOOTING.md b/learn/guides/TROUBLESHOOTING.md
@@ -10,7 +10,7 @@ Claude Code exposes plugin commands. Codex receives corresponding Stinger wrappe
 
 ## An optional Codex role is missing
 
-Check the explicit `~/.wasp-nest/installed-plugins.json` selection and the actual package roots, required Core, matching versions and workflow prerequisites. Then check Core's trusted registration hook. A cached marketplace folder is not an enabled selection, and marketplace/UI installation alone is not proven to write the registry. The local installer records it automatically.
+Check the explicit `~/.wasp-nest/installed-plugins.json` selection and the actual package roots, required Core, matching versions and workflow prerequisites. Then check Core's trusted registration hook. A cached marketplace folder is not an enabled selection, and marketplace/UI installation alone is not proven to write the registry. Skill and command resolution after a Claude Code `/plugin install` falls back to Claude's own `~/.claude/plugins/installed_plugins.json` when the Wasp Nest registry is absent; Codex role registration still needs the explicit registry. The local installer records it automatically.
 
 Use the matching installed Stinger when a native role is unavailable and report that limit. Do not copy a different plugin's role into place or invent a native selector.
 

diff --git a/learn/pdf/How-We-Build-The-Wasp-Nest.pdf b/learn/pdf/How-We-Build-The-Wasp-Nest.pdf
diff --git a/learn/reference/HOOK-CATALOG.md b/learn/reference/HOOK-CATALOG.md
@@ -81,7 +81,7 @@ These names come from the builder's `BEACON_EVENTS`. They are configured targets
 
 The registrar needs `PLUGIN_ROOT` to identify trusted Core. Without it, registration is a no-op. The OpenAI binding uses that plugin-root convention. The Claude registrar attempt does not prove that a Claude client supplies the same environment.
 
-Selection comes from `WASP_NEST_PLUGIN_REGISTRY` or `~/.wasp-nest/installed-plugins.json`. The resolver can also recognize trusted Core. It requires one catalog owner, matching plugin versions, declared dependencies, and the requested installed file. Missing prerequisites, identity mismatches, unsafe component links, and unknown components cause refusal. It does not assume that every cached plugin is enabled.
+Selection comes from `WASP_NEST_PLUGIN_REGISTRY` or `~/.wasp-nest/installed-plugins.json`. When neither exists, a Claude Code marketplace install is read from Claude Code's own install record (`~/.claude/plugins/installed_plugins.json`, or under `CLAUDE_CONFIG_DIR`), limited to Core's marketplace. The resolver can also recognize trusted Core. It requires one catalog owner, matching plugin versions, declared dependencies, and the requested installed file. Missing prerequisites, identity mismatches, unsafe component links, and unknown components cause refusal. It does not assume that every cached plugin is enabled.
 
 Before writes, the registrar checks selected paths, declared role names, TOML identity, and instruction-resource links. It projects valid links to their selected package resources, then writes the selected Codex home's `agents/` files. Changed existing roles receive backups under `~/.wasp-nest/backups/codex-agents/`. Identical files stay unchanged. Registration failure is reported as skipped and does not stop SessionStart.