@fiale-plus/pi-rogue-advisor 0.1.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@fiale-plus/pi-rogue-advisor",
+  "version": "0.1.0",
+  "description": "PiRogue advisor extension for Pi — multi-model support, SOTA model suggestion, cache-aware session advisory.",
+  "type": "module",
+  "license": "MIT",
+  "repository": "https://github.com/fiale-plus/pi-rogue",
+  "keywords": [
+    "pi-package"
+  ],
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "pi": {
+    "extensions": [
+      "./src/extension.ts"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.74.0",
+    "@earendil-works/pi-ai": "^0.74.0",
+    "@earendil-works/pi-tui": "^0.74.0"
+  },
+  "dependencies": {
+    "typebox": "^1.1.24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "skills",
+    "assets",
+    "README.md",
+    "package.json"
+  ]
+}

package/skills/advisor/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: advisor
+description: Zero-config strategic advisor for Pi. Auto-detects best model, phase-aware routing, preflight + post-review + cache. Use for architecture, tradeoffs, planning.
+---
+
+# PiRogue Advisor
+
+Works out of the box. Just install and use `/advisor`.
+
+> 96 strategic calls saved ~$53 on GPT-5.5 over 3,071 turns — see [`docs/savings.md`](../../docs/savings.md)
+
+## Quick start
+
+- `/advisor` — status + config
+- `/advisor <question>` — get immediate advice
+- `/advisor on|off` — enable/disable
+
+Zero config needed. Falls back through SOTA models (gpt-5.5 → claude-opus-4-6 → sonnet-4-6) automatically.
+
+The router is phase-aware: it keeps tiny edits cheap, escalates complex/high-risk work to SOTA, and writes compact routing logs for future classifier training.
+
+## When to call
+
+Agent should call `advisor` tool before: new frameworks, refactoring, API design, concurrency, security, tradeoffs.
+Skip: reads, small edits, one-liners.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `/advisor` | Show status, config, cached note |
+| `/advisor <question>` | Get immediate strategic advice |
+| `/advisor on` | Enable auto mode (preflight+post+cache) |
+| `/advisor off` | Disable |
+| `/advisor mode auto\|manual\|off` | Set advisor mode |
+| `/advisor model <provider/model>` | Set specific model (e.g. `openai-codex/gpt-5.5`) |
+| `/advisor status` | Full status with model info |
+| `/advisor config` | Show current 3-field config |
+| `/advisor review light\|strict\|off` | Set review aggressiveness |
+
+## Config (3 fields, all optional)
+
+Defaults: `mode: auto, review: light`
+
+```json
+{ "mode": "auto", "review": "light" }
+```

package/src/extension.test.ts

@@ -0,0 +1,54 @@
+import { describe, it, expect } from "vitest";
+import type { AdvisorConfig } from "./extension.js";
+
+describe("AdvisorConfig", () => {
+  it("defaults to auto mode and light review with no model override", () => {
+    const cfg: AdvisorConfig = { mode: "auto", review: "light" };
+    expect(cfg.mode).toBe("auto");
+    expect(cfg.review).toBe("light");
+    expect(cfg.model).toBeUndefined();
+  });
+
+  it("accepts all 3 modes", () => {
+    for (const mode of ["auto", "manual", "off"] as const) {
+      const cfg: AdvisorConfig = { mode, review: "light" };
+      expect(cfg.mode).toBe(mode);
+    }
+  });
+
+  it("accepts all 3 review levels", () => {
+    for (const review of ["light", "strict", "off"] as const) {
+      const cfg: AdvisorConfig = { mode: "auto", review };
+      expect(cfg.review).toBe(review);
+    }
+  });
+
+  it("accepts optional model override", () => {
+    const cfg: AdvisorConfig = { mode: "auto", review: "light", model: "claude-sonnet-4-6" };
+    expect(cfg.model).toBe("claude-sonnet-4-6");
+  });
+
+  it("serializes/deserializes without data loss (JSON round-trip)", () => {
+    const original: AdvisorConfig = { mode: "auto", review: "light", model: "claude-opus-4-6" };
+    const json = JSON.stringify(original);
+    const parsed = JSON.parse(json) as AdvisorConfig;
+    expect(parsed.mode).toBe("auto");
+    expect(parsed.review).toBe("light");
+    expect(parsed.model).toBe("claude-opus-4-6");
+  });
+
+  it("has exactly 3 properties (mode, review, model)", () => {
+    const keys = Object.keys({ mode: "auto", review: "light" } as AdvisorConfig);
+    expect(keys.length).toBeLessThanOrEqual(3);
+    const allKeys = ["mode", "review", "model"];
+    const configKeys = Object.keys({ mode: "auto", review: "light" } as AdvisorConfig);
+    expect(configKeys.every((k) => allKeys.includes(k))).toBe(true);
+  });
+});
+
+describe("SOTA model suggestions", () => {
+  it("includes gpt-5.5 as primary option", () => {
+    const cfg: AdvisorConfig = { mode: "auto", review: "light" };
+    expect(cfg.model).toBeUndefined(); // model is optional, auto-detect
+  });
+});