@fiale-plus/pi-rogue-bundle 0.1.9 → 0.1.11

package/README.md

@@ -1,32 +1,43 @@
 # Pi-Rogue Bundle
 
-`@fiale-plus/pi-rogue-bundle` is the prepared umbrella package that stitches together:
+`@fiale-plus/pi-rogue-bundle` is the **single consolidated public artefact** for Pi-Rogue.
 
-- `@fiale-plus/pi-rogue-advisor`
-- `@fiale-plus/pi-rogue-orchestration`
+It stitches together (and bundles for a true single-package install):
 
-It is a thin, official surface for local usage when you want one install and both command families together.
+- `@fiale-plus/pi-rogue-advisor` (logic; direct releases paused)
+- `@fiale-plus/pi-rogue-orchestration` (logic; direct releases paused)
 
-## Install
+Direct installs of the advisor/orchestration packages are paused (marked private). All users and future releases go through the bundle. See `docs/release.md` and root `AGENTS.md` / `README.md` for the release policy.
+
+## Install (recommended)
 
 ```bash
-# from repo root (workspace install)
+pi install npm:@fiale-plus/pi-rogue-bundle
+```
+
+For local monorepo dev:
+
+```bash
+# from repo root
 npm install
-# and then use workspace packages as needed
+# then use workspace packages as needed (e.g. for testing changes to advisor/orch before a bundle release)
 ```
 
 ## Scope boundaries
 
 - **Lab / internal helpers are excluded from this bundle.**
-- `@fiale-plus/pi-rogue-bundle` currently includes only the published logic surfaces.
-- Internal helper packages (`@fiale-plus/pi-rogue-guardrails`, `@fiale-plus/pi-rogue-brain`, `@fiale-plus/pi-rogue-repo-arch`) are maintained separately in the lab section.
+- `@fiale-plus/pi-rogue-bundle` is the only published surface for the logic.
+- Internal helper packages (`@fiale-plus/pi-rogue-guardrails`, `@fiale-plus/pi-rogue-brain`, `@fiale-plus/pi-rogue-repo-arch`) are maintained separately in the lab section and not published.
 
 ## Command surface
 
-- `/advisor`, `/goal`, `/loop`, `/autoresearch`, `/autoresearch-lab` plus status/config/command paths inherited from the two included packages.
+- `/advisor`, `/goal`, `/loop`, `/autoresearch`, `/autoresearch-lab` plus status/config/command paths (all provided via the bundle).
 
 ## Status
 
-- **Published?** In progress (prepared package)
-- **NPM version/downloads:** not yet published (no registry entry yet)
-- **Stability:** public surface; no extra internal helper behavior
+- **Published:** yes (single artefact)
+- The advisor and orchestration packages continue to receive code changes in this repo; they ship inside bundle releases via `bundledDependencies`.
+
+## Release notes
+
+Only `pi-rogue-bundle-<semver>` tags/releases are produced. See `docs/release.md` for the full clean policy and checklist.

package/node_modules/@fiale-plus/pi-rogue-advisor/README.md

@@ -0,0 +1,59 @@
+# @fiale-plus/pi-rogue-advisor
+
+> **Releases paused.** This package is now internal. All usage and updates are via the single consolidated `@fiale-plus/pi-rogue-bundle` artefact (see root README, `docs/release.md`, and AGENTS.md). Direct installs and independent releases are on pause; the package is marked private. Code here continues to evolve and ships inside bundle releases.
+
+## What this package is
+
+Strategic advisor for Pi sessions with low-overhead preflight/post-review routing, model auto-detection, session memory, and orchestration-managed mid-session check-ins.
+
+- SOTA-first model fallback: `gpt-5.5`/`claude-opus-4-6`/`claude-sonnet-4-6` where available.
+- Keeps command-level behavior simple and explicit.
+
+## Install
+
+**For users:** Use the bundle (releases for this package are paused):
+
+```bash
+pi install npm:@fiale-plus/pi-rogue-bundle
+```
+
+**For local development (monorepo only):**
+
+```bash
+npm install --workspace packages/advisor
+```
+
+(See root README and docs/release.md for the consolidated policy.)
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `/pi-rogue` | Show the Pi-Rogue cockpit + command pointers |
+| `/advisor` | Show status (`/advisor status`) and quick hint |
+| `/advisor status` | Show mode, review policy, check-in status, model selection, counters |
+| `/advisor on` | Enable advisor (auto mode) |
+| `/advisor off` | Disable advisor |
+| `/advisor mode auto\|manual\|off` | Change routing behavior |
+| `/advisor review light\|strict\|off` | Change review strictness |
+| `/advisor pause <N>` | Pause advisor auto-runs for the next N turns |
+| `/advisor unpause` | Resume advisor auto-runs immediately |
+| `/advisor config` | Show current config |
+| `/advisor model <provider>/<model>` | Set explicit model override |
+| `/advisor <question>` | Get one-shot advisory response |
+
+## Notes on defaults
+
+- `mode`: `auto`
+- `review`: `light`
+- `checkins`: `off` (orchestration turns them on when a goal or loop is active)
+- `checkinIntervalMinutes`: `30`
+- `model`: not set (auto-detected)
+- Successful `on_track` review verdicts are recorded silently instead of displayed as follow-up messages.
+
+Check-ins gate on session activity and `checkinIntervalMinutes`, avoid overlapping calls, and use higher/advanced advisor models first with regular model fallback enabled by default. They are lifecycle-managed by orchestration: activating a goal or `/loop` enables them, and clearing either disables them.
+
+## Stability guarantees
+
+- No flattening: the advisor remains its own surface and does not hide orchestration commands.
+- Cockpit is simple and explicit: `/pi-rogue` is the top-level status view.

package/node_modules/@fiale-plus/pi-rogue-advisor/advisor/index.ts

@@ -0,0 +1 @@
+export { default, registerAdvisor } from "../src/extension.js";