pi-skill-shiori 0.6.12 → 0.6.16

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 ## Unreleased
 
+## [0.6.16] - 2026-10-17
+
+### Changed
+
+- Share the retrieval-index contract between standard and expanded retrieval.
+
+## [0.6.15] - 2026-10-16
+
+### Changed
+
+- Pin Pi SDK development and smoke-test dependencies to 1.2.0 and guard user-only prompt handling for the new `before_agent_start` message union.
+
+## [0.6.14] - 2026-10-12
+
+### Changed
+
+- Pin the Pi SDK development and smoke-test dependencies to 1.1.0.
+- Standardize the documentation directory to lowercase so the Pi SDK smoke report is available at `docs/verification/pi-sdk-smoke.json` on case-sensitive hosts.
+
+## [0.6.13] - 2026-10-05
+
+### Added
+
+- Add session-local `/shiori:stats` timing diagnostics for inventory refresh and skill retrieval, with additive JSON counters and no prompt, skill-body, or cross-session analytics storage.
+
 ## [0.6.12] - 2026-09-30
 
 ### Changed
@@ -78,14 +103,14 @@ This project follows semantic versioning.
 
 ### Changed
 
-- `Docs/recommendation-surface.md` documents the dogfood review outcome and recommendation to keep badges on default surfaces.
+- `docs/recommendation-surface.md` documents the dogfood review outcome and recommendation to keep badges on default surfaces.
 
 ## [0.6.1] - 2026-07-01
 
 ### Changed
 
 - README aligned with Pi OSS minimal-docs policy: badges, required entrypoint sections, Quick start, Package contents, Links.
-- Detailed configuration and operational notes moved to `Docs/usage.md`.
+- Detailed configuration and operational notes moved to `docs/usage.md`.
 - README install examples and status text updated to match package version `0.6.1`.
 
 ## [0.6.0] - 2026-06-29
@@ -93,7 +118,7 @@ This project follows semantic versioning.
 ### Added
 
 - Bounded recommendation reason badges (`[trigger]`, `[description]`, `[low match]`) on recommended skills in auto-inject, `/shiori:recommend`, and `shiori_recommend` surfaces.
-- `Docs/recommendation-surface.md` describing badge vocabulary, a multi-skill example, and how badges relate to Always Visible Skill policy and recommendation metrics.
+- `docs/recommendation-surface.md` describing badge vocabulary, a multi-skill example, and how badges relate to Always Visible Skill policy and recommendation metrics.
 - Tests for reason present, absent, low-confidence, and badge formatting.
 
 ### Changed

package/README.md

@@ -19,7 +19,7 @@ For maintenance priorities and the phased plan, see [`ROADMAP.md`](ROADMAP.md).
 
 Pi Skill Shiori is a [Pi](https://pi.dev/) package for vaults or projects with many Agent Skills where the default catalog becomes noisy and expensive. It hides the normal skill catalog when safe, recommends triggerable skills with compact summaries, and loads full `SKILL.md` bodies on demand.
 
-`0.6.12` is the current working release. Prompt-boundary suppression is intentionally conservative: if Shiori cannot safely recognize a catalog boundary, it leaves the prompt untouched and warns instead of deleting too much.
+`0.6.16` is the current working release. Prompt-boundary suppression is intentionally conservative: if Shiori cannot safely recognize a catalog boundary, it leaves the prompt untouched and warns instead of deleting too much.
 
 ## Features
 
@@ -31,13 +31,14 @@ Pi Skill Shiori is a [Pi](https://pi.dev/) package for vaults or projects with m
 - **SQLite FTS retrieval** — indexes skill names, descriptions, and policy triggers with `node:sqlite` + FTS5, with token-match fallback.
 - **Recommendation reason badges** — compact `[trigger]`, `[description]`, and `[low match]` labels on surfaced skills.
 - **Session-local feedback metrics** — `/shiori:stats` tracks offers, loads, and follow-through without storing prompts.
+- **Timing diagnostics** — `/shiori:stats` separates inventory refresh and retrieval cost without storing prompts, skill bodies, or cross-session analytics.
 
 ## Install
 
 ### Global install from npm
 
 ```bash
-pi install npm:pi-skill-shiori@0.6.12
+pi install npm:pi-skill-shiori@0.6.16
 ```
 
 Without a version pin:
@@ -49,7 +50,7 @@ pi install npm:pi-skill-shiori
 ### Project-local install from npm
 
 ```bash
-pi install -l npm:pi-skill-shiori@0.6.12
+pi install -l npm:pi-skill-shiori@0.6.16
 ```
 
 Without a version pin:
@@ -61,7 +62,7 @@ pi install -l npm:pi-skill-shiori
 ### Install from GitHub
 
 ```bash
-pi install git:github.com/eiei114/pi-skill-shiori@v0.6.12
+pi install git:github.com/eiei114/pi-skill-shiori@v0.6.16
 pi install -l git:github.com/eiei114/pi-skill-shiori
 ```
 
@@ -81,7 +82,7 @@ pi install -l /absolute/path/to/pi-skill-shiori
 ## Quick start
 
 1. Install the package (see [Install](#install)).
-2. Create `.pi/skill-shiori.yml` in your Pi project (see [Docs/usage.md](Docs/usage.md#configure)).
+2. Create `.pi/skill-shiori.yml` in your Pi project (see [docs/usage.md](docs/usage.md#configure)).
 3. Start Pi and run `/shiori:doctor` to confirm policy path, indexed roots, and suppression status.
 4. Use `/shiori:bootstrap` to write `.pi/skill-shiori.generated.yml`, review it, copy needed sections into `.pi/skill-shiori.yml`, then run `/shiori:reload`.
 5. Ask the agent for help; Shiori injects compact candidates or use `/shiori:recommend` for an interactive flow.
@@ -112,17 +113,17 @@ shiori_load_skill({ skill: "reddit-research" })
 
 `shiori_load_skill` loads one skill by name. The Pi UI shows a compact result like `✓ Loaded reddit-research (6.3KB)`.
 
-Recommended skills show compact reason badges (`[trigger]`, `[description]`, `[low match]`). See [`Docs/recommendation-surface.md`](Docs/recommendation-surface.md) for badge vocabulary and metrics interplay.
+Recommended skills show compact reason badges (`[trigger]`, `[description]`, `[low match]`). See [`docs/recommendation-surface.md`](docs/recommendation-surface.md) for badge vocabulary and metrics interplay.
 
-For inventory roots, policy YAML, suppression statuses, and feedback metrics, see [`Docs/usage.md`](Docs/usage.md).
+For inventory roots, policy YAML, suppression statuses, and feedback metrics, see [`docs/usage.md`](docs/usage.md).
 
 ## Package contents
 
 | Path | Purpose |
 |---|---|
 | `src/` | Pi extension entrypoint and Shiori runtime |
-| `Docs/usage.md` | Configuration, inventory, suppression, and metrics details |
-| `Docs/recommendation-surface.md` | Recommendation badges and surface behavior |
+| `docs/usage.md` | Configuration, inventory, suppression, and metrics details |
+| `docs/recommendation-surface.md` | Recommendation badges and surface behavior |
 | `ROADMAP.md` | Maintenance direction and phased plan |
 | `CHANGELOG.md` | Version history |
 | `SECURITY.md` | Vulnerability reporting |

package/{Docs → docs}/usage.md

@@ -167,6 +167,17 @@ command: offers=1, loaded=2, zeroHits=1
 top skills: auth-helper(1/2), deploy-kit(1/1)
 ```
 
+## Timing diagnostics
+
+Run `/shiori:stats` to see a compact timing line alongside the existing recommendation feedback summary. The line separates inventory refresh cost from retrieval cost; the JSON payload exposes the same machine-readable counters under `timing.inventoryRefresh` and `timing.retrieval`:
+
+- `count` — successful operations recorded in the current session
+- `lastMs` — duration of the most recent successful operation
+- `totalMs` — cumulative duration of successful operations
+- `maxMs` — longest successful operation
+
+Inventory refresh timing covers the successful session-start, manual `/shiori:reload`, and automatic refresh rebuilds. Retrieval timing covers successful auto-injection, `shiori_recommend`, and `/shiori:recommend` retrievals. These are in-memory, session-local diagnostics: Shiori does not store prompt text, full queries, skill bodies, or cross-session analytics.
+
 ## Agent tools
 
 Shiori registers two tools the agent can call after candidates appear:

package/docs/verification/pi-sdk-smoke.json

@@ -0,0 +1,110 @@
+{
+  "schema_version": 1,
+  "verification_contract": "pi-sdk-behavior-v2",
+  "sdk_versions": {
+    "@earendil-works/pi-agent-core": "1.2.0",
+    "@earendil-works/pi-ai": "1.2.0",
+    "@earendil-works/pi-coding-agent": "1.2.0",
+    "@earendil-works/pi-tui": "1.2.0"
+  },
+  "platform": "win32",
+  "model_inference": "none; actual Pi host executes local Shiori slash commands in RPC mode",
+  "boundary": "The Pi SDK host, extension loader, extension lifecycle and Shiori commands are real. The deterministic smoke skill is filesystem input; no provider/model call or mocked host is used. Pi settings, home and temp paths are isolated and removed after the checks.",
+  "unhandled_errors": 0,
+  "extension_load_errors": 0,
+  "cases": [
+    {
+      "name": "extension_load",
+      "command": "npm run smoke:pi (actual locally pinned Pi RPC host and Shiori extension)",
+      "exit_code": 0,
+      "passed": true,
+      "evidence": "[extension_load] Pi SDK 1.2.0\n[first process stdout]\n{\"id\":\"load-commands\",\"type\":\"response\",\"command\":\"get_commands\",\"success\":true,\"data\":{\"commands\":[{\"name\":\"shiori:doctor\",\"description\":\"Show Pi Skill Shiori configuration and inventory status\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:reload\",\"description\":\"Rebuild Pi Skill Shiori inventory and optional Pi runtime resources\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:recommend\",\"description\":\"Recommend Agent Skills for a natural-language task and queue it for the agent\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:stats\",\"description\":\"Show Pi Skill Shiori operational counters and recommendation feedback\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:bootstrap\",\"description\":\"Generate a review policy draft from discovered skill descriptions\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}}]}}\n\n[first process stderr]\n",
+      "assertions": [
+        {
+          "id": "extension_registered",
+          "expected": "The actual Pi host lists Shiori's registered doctor command.",
+          "observed": "{\"commands\":[\"shiori:doctor\",\"shiori:reload\",\"shiori:recommend\",\"shiori:stats\",\"shiori:bootstrap\"]}",
+          "passed": true
+        }
+      ]
+    },
+    {
+      "name": "happy_path",
+      "command": "npm run smoke:pi (actual locally pinned Pi RPC host and Shiori extension)",
+      "exit_code": 0,
+      "passed": true,
+      "evidence": "[happy_path] Pi SDK 1.2.0\n[first process stdout]\n{\"id\":\"happy-commands\",\"type\":\"response\",\"command\":\"get_commands\",\"success\":true,\"data\":{\"commands\":[{\"name\":\"shiori:doctor\",\"description\":\"Show Pi Skill Shiori configuration and inventory status\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:reload\",\"description\":\"Rebuild Pi Skill Shiori inventory and optional Pi runtime resources\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:recommend\",\"description\":\"Recommend Agent Skills for a natural-language task and queue it for the agent\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:stats\",\"description\":\"Show Pi Skill Shiori operational counters and recommendation feedback\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:bootstrap\",\"description\":\"Generate a review policy draft from discovered skill descriptions\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}}]}}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"input\",\"title\":\"What do you want help with?\",\"placeholder\":\"Describe your task in natural language…\"}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"select\",\"title\":\"How should Shiori use these recommendations?\",\"options\":[\"Pre-load matches and queue task for agent\",\"Review recommendations only\",\"Cancel\"]}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Matched 1 skill(s): smoke-skill [trigger]\",\"notifyType\":\"info\"}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"select\",\"title\":\"Follow up on a recommendation:\",\"options\":[\"smoke-skill [trigger]\",\"Done\"]}\n{\"id\":\"happy-prompt\",\"type\":\"response\",\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}}\n\n[first process stderr]\n",
+      "assertions": [
+        {
+          "id": "feature_response",
+          "expected": "Pi handles Shiori's interactive recommendation command and the real extension returns its discovered smoke-skill.",
+          "observed": "{\"response\":{\"id\":\"happy-prompt\",\"type\":\"response\",\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}},\"notification\":{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Matched 1 skill(s): smoke-skill [trigger]\",\"notifyType\":\"info\"}}",
+          "passed": true
+        }
+      ]
+    },
+    {
+      "name": "error_path",
+      "command": "npm run smoke:pi (actual locally pinned Pi RPC host and Shiori extension)",
+      "exit_code": 0,
+      "passed": true,
+      "evidence": "[error_path] Pi SDK 1.2.0\n[first process stdout]\n{\"id\":\"error-commands\",\"type\":\"response\",\"command\":\"get_commands\",\"success\":true,\"data\":{\"commands\":[{\"name\":\"shiori:doctor\",\"description\":\"Show Pi Skill Shiori configuration and inventory status\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:reload\",\"description\":\"Rebuild Pi Skill Shiori inventory and optional Pi runtime resources\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:recommend\",\"description\":\"Recommend Agent Skills for a natural-language task and queue it for the agent\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:stats\",\"description\":\"Show Pi Skill Shiori operational counters and recommendation feedback\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:bootstrap\",\"description\":\"Generate a review policy draft from discovered skill descriptions\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}}]}}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"input\",\"title\":\"What do you want help with?\",\"placeholder\":\"Describe your task in natural language…\"}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Recommendation cancelled.\",\"notifyType\":\"info\"}\n{\"id\":\"error-prompt\",\"type\":\"response\",\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}}\n\n[first process stderr]\n",
+      "assertions": [
+        {
+          "id": "handled_error",
+          "expected": "Cancelling Shiori's actual RPC input dialog is handled with its cancellation notice and no model call.",
+          "observed": "{\"response\":{\"id\":\"error-prompt\",\"type\":\"response\",\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}},\"cancelled\":{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Recommendation cancelled.\",\"notifyType\":\"info\"}}",
+          "passed": true
+        }
+      ]
+    },
+    {
+      "name": "reload_cleanup",
+      "command": "npm run smoke:pi (actual locally pinned Pi RPC host and Shiori extension)",
+      "exit_code": 0,
+      "passed": true,
+      "evidence": "[reload sequence]\nfirst process:\n  reload-stats-before: success=true disposition=handled\n  reload-inventory: success=true disposition=handled\n  reload-stats-after: success=true disposition=handled\n  reload-recommend: success=true disposition=handled\n  firstExitCode=0\nsecond process:\n  reload-recommend: success=true disposition=handled\n  secondExitCode=0\n[reload_cleanup] Pi SDK 1.2.0\n[first process stdout]\n{\"id\":\"reload-first-commands\",\"type\":\"response\",\"command\":\"get_commands\",\"success\":true,\"data\":{\"commands\":[{\"name\":\"shiori:doctor\",\"description\":\"Show Pi Skill Shiori configuration and inventory status\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:reload\",\"description\":\"Rebuild Pi Skill Shiori inventory and optional Pi runtime resources\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:recommend\",\"description\":\"Recommend Agent Skills for a natural-language task and queue it for the agent\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:stats\",\"description\":\"Show Pi Skill Shiori operational counters and recommendation feedback\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:bootstrap\",\"description\":\"Generate a review policy draft from discovered skill descriptions\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}}]}}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Recommendation feedback (session-local, no prompts stored)\\noffers: 0 | candidate slots: 0 | loaded: 0\\nabandoned: 0 | zero-candidate queries: 0 | follow-through: n/a\\nTiming (session-local) | inventory refresh: count=1 last=<DURATION> total=<DURATION> max=<DURATION> | retrieval: count=0 last=<DURATION> total=<DURATION> max=<DURATION>\\n\\n{\\n  \\\"inventoryCount\\\": 1,\\n  \\\"duplicateCount\\\": 0,\\n  \\\"candidateHitCount\\\": 0,\\n  \\\"zeroCandidateCount\\\": 0,\\n  \\\"loadedSkillCount\\\": 0,\\n  \\\"explicitInvocationCount\\\": 0,\\n  \\\"retrievalBackend\\\": \\\"sqlite-fts\\\",\\n  \\\"suppressionStatus\\\": \\\"disabled\\\",\\n  \\\"inventoryRefreshCount\\\": 1,\\n  \\\"inventoryAutoRefreshCount\\\": 0,\\n  \\\"timing\\\": {\\n    \\\"inventoryRefresh\\\": {\\n      \\\"lastMs\\\": \"<DURATION>\",\\n      \\\"totalMs\\\": \"<DURATION>\",\\n      \\\"maxMs\\\": \"<DURATION>\",\\n      \\\"count\\\": 1\\n    },\\n    \\\"retrieval\\\": {\\n      \\\"lastMs\\\": \"<DURATION>\",\\n      \\\"totalMs\\\": \"<DURATION>\",\\n      \\\"maxMs\\\": \"<DURATION>\",\\n      \\\"count\\\": 0\\n    }\\n  },\\n  \\\"lastReloadAt\\\": \\\"<TIMESTAMP>\\\",\\n  \\\"recommendationFeedback\\\": {\\n    \\\"totalOffers\\\": 0,\\n    \\\"totalCandidateSlots\\\": 0,\\n    \\\"totalLoaded\\\": 0,\\n    \\\"totalAbandoned\\\": 0,\\n    \\\"zeroCandidateQueries\\\": 0,\\n    \\\"followThroughRate\\\": null,\\n    \\\"bySource\\\": {\\n      \\\"auto-inject\\\": {\\n        \\\"offers\\\": 0,\\n        \\\"candidateSlots\\\": 0,\\n        \\\"loaded\\\": 0,\\n        \\\"zeroHits\\\": 0\\n      },\\n      \\\"command\\\": {\\n        \\\"offers\\\": 0,\\n        \\\"candidateSlots\\\": 0,\\n        \\\"loaded\\\": 0,\\n        \\\"zeroHits\\\": 0\\n      },\\n      \\\"tool\\\": {\\n    \n…[elided 3910 characters]…\n,\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"input\",\"title\":\"What do you want help with?\",\"placeholder\":\"Describe your task in natural language…\"}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"select\",\"title\":\"How should Shiori use these recommendations?\",\"options\":[\"Pre-load matches and queue task for agent\",\"Review recommendations only\",\"Cancel\"]}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Matched 1 skill(s): smoke-skill [trigger]\",\"notifyType\":\"info\"}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"select\",\"title\":\"Follow up on a recommendation:\",\"options\":[\"smoke-skill [trigger]\",\"Done\"]}\n{\"id\":\"reload-recommend\",\"type\":\"response\",\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}}\n\n[first process stderr]\n\n[second process stdout]\n{\"id\":\"reload-second-commands\",\"type\":\"response\",\"command\":\"get_commands\",\"success\":true,\"data\":{\"commands\":[{\"name\":\"shiori:doctor\",\"description\":\"Show Pi Skill Shiori configuration and inventory status\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:reload\",\"description\":\"Rebuild Pi Skill Shiori inventory and optional Pi runtime resources\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:recommend\",\"description\":\"Recommend Agent Skills for a natural-language task and queue it for the agent\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:stats\",\"description\":\"Show Pi Skill Shiori operational counters and recommendation feedback\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}},{\"name\":\"shiori:bootstrap\",\"description\":\"Generate a review policy draft from discovered skill descriptions\",\"source\":\"extension\",\"sourceInfo\":{\"path\":\"<REPOSITORY>\\\\src\\\\index.ts\",\"source\":\"cli\",\"scope\":\"temporary\",\"origin\":\"top-level\"}}]}}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"input\",\"title\":\"What do you want help with?\",\"placeholder\":\"Describe your task in natural language…\"}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"select\",\"title\":\"How should Shiori use these recommendations?\",\"options\":[\"Pre-load matches and queue task for agent\",\"Review recommendations only\",\"Cancel\"]}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Matched 1 skill(s): smoke-skill [trigger]\",\"notifyType\":\"info\"}\n{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"select\",\"title\":\"Follow up on a recommendation:\",\"options\":[\"smoke-skill [trigger]\",\"Done\"]}\n{\"id\":\"reload-recommend\",\"type\":\"response\",\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}}\n\n[second process stderr]\n",
+      "assertions": [
+        {
+          "id": "inventory_reload",
+          "expected": "Runtime reload re-registers Shiori and resets its session-local inventory counter to the single new session_start refresh.",
+          "observed": "{\"post_reload_commands\":[\"shiori:doctor\",\"shiori:reload\",\"shiori:recommend\",\"shiori:stats\",\"shiori:bootstrap\"],\"post_reload_inventory_refresh_count\":1}",
+          "passed": true
+        },
+        {
+          "id": "reloaded_extension_registered",
+          "expected": "A second actual Pi process registers Shiori again after the first process shuts down.",
+          "observed": "{\"commands\":[\"shiori:doctor\",\"shiori:reload\",\"shiori:recommend\",\"shiori:stats\",\"shiori:bootstrap\"]}",
+          "passed": true
+        },
+        {
+          "id": "reloaded_feature_response",
+          "expected": "The second process handles Shiori's interactive recommendation and returns the discovered skill.",
+          "observed": "{\"response\":{\"id\":\"reload-recommend\",\"type\":\"response\",\"command\":\"prompt\",\"success\":true,\"data\":{\"disposition\":\"handled\"}},\"notification\":{\"type\":\"extension_ui_request\",\"id\":\"<RPC_ID>\",\"method\":\"notify\",\"message\":\"Matched 1 skill(s): smoke-skill [trigger]\",\"notifyType\":\"info\"}}",
+          "passed": true
+        },
+        {
+          "id": "clean_shutdown",
+          "expected": "Both actual Pi processes exit with status 0 and emit no unhandled or shutdown errors.",
+          "observed": "{\"first_exit_code\":0,\"second_exit_code\":0,\"runtime_errors\":null,\"extension_load_errors\":null}",
+          "passed": true
+        }
+      ]
+    },
+    {
+      "name": "host_shell",
+      "command": "npm run smoke:pi (native host shell launches the locally pinned Pi CLI)",
+      "exit_code": 0,
+      "passed": true,
+      "evidence": "1.2.0\n",
+      "assertions": [
+        {
+          "id": "native_shell_boundary",
+          "expected": "The native host shell launches the locally pinned Pi CLI and returns exactly its SDK version.",
+          "observed": "{\"exit_code\":0,\"output\":\"1.2.0\",\"expectedVersion\":\"1.2.0\"}",
+          "passed": true
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-skill-shiori",
-  "version": "0.6.12",
+  "version": "0.6.16",
   "description": "Pi extension that reduces Agent Skill catalog tokens with policy-based skill retrieval and on-demand skill loading.",
   "type": "module",
   "license": "MIT",
@@ -27,17 +27,19 @@
     "LICENSE",
     "SECURITY.md",
     "CHANGELOG.md",
-    "Docs",
+    "docs",
     "src"
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "tsc --noEmit",
     "test": "npm run typecheck && tsx --test tests/*.test.mjs",
+    "smoke:pi": "node scripts/pi-sdk-smoke.mjs",
     "prepublishOnly": "npm test",
     "release:npm:dry": "npm pack --dry-run",
     "release:npm": "npm publish --access public",
-    "version:check": "node scripts/check-version-bump.mjs"
+    "version:check": "node scripts/check-version-bump.mjs",
+    "smoke:pi:curated": "node scripts/pi-sdk-smoke.mjs --update-curated-report"
   },
   "pi": {
     "extensions": [
@@ -45,7 +47,7 @@
     ]
   },
   "dependencies": {
-    "yaml": "^2.8.1"
+    "yaml": "^2.9.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
@@ -54,9 +56,10 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^0.99.1",
-    "@earendil-works/pi-coding-agent": "^0.99.1",
-    "@earendil-works/pi-tui": "^0.99.1",
+    "@earendil-works/pi-agent-core": "1.2.0",
+    "@earendil-works/pi-ai": "1.2.0",
+    "@earendil-works/pi-coding-agent": "1.2.0",
+    "@earendil-works/pi-tui": "1.2.0",
     "@types/node": "^26.0.0",
     "tsx": "^4.22.4",
     "typebox": "latest",

package/src/index.ts

@@ -7,7 +7,7 @@ import { findDuplicates, formatInventoryRoots, isAutoRefreshEnabled, isInventory
 import type { SkillIndex } from "./indexer.js";
 import { loadRecommendedSkills } from "./load-skills.js";
 import { formatPlanningKickoffMessage, isPlanningIntent } from "./planning-kickoff.js";
-import { createStats } from "./metrics.js";
+import { createStats, formatTimingSummary, measureTiming } from "./metrics.js";
 import { createRecommendationFeedback } from "./recommendation-feedback.js";
 import { getPolicyPath, loadPolicyWithSource, loadedPolicySignature, type LoadedPolicy } from "./policy.js";
 import {
@@ -48,7 +48,10 @@ export default function piSkillShiori(pi: ExtensionAPI) {
   async function reload(cwd: string, currentPolicy?: LoadedPolicy): Promise<SkillIndex> {
     currentPolicy ??= await loadPolicyWithSource(cwd);
     const policy = currentPolicy.policy;
-    const inventory = await refreshSkillInventory(cwd, policy, index);
+    const inventory = await measureTiming(
+      stats.timing.inventoryRefresh,
+      () => refreshSkillInventory(cwd, policy, index),
+    );
     index = inventory.index;
     inventoryFingerprint = inventory.fingerprint;
     inventoryRoots = inventory.roots;
@@ -139,7 +142,14 @@ export default function piSkillShiori(pi: ExtensionAPI) {
       ctx.ui.notify("Pi Skill Shiori: Skill Catalog suppression pattern not found; leaving system prompt unchanged.", "warning");
     }
 
-    const candidates = retrieveCandidatesExpanded(event.prompt, current.skills, current.policy, current);
+    if (event.messageType === "custom") {
+      return { systemPrompt: suppression.systemPrompt };
+    }
+
+    const candidates = await measureTiming(
+      stats.timing.retrieval,
+      () => retrieveCandidatesExpanded(event.prompt, current.skills, current.policy, current),
+    );
     if (candidates.length === 0) {
       stats.zeroCandidateCount += 1;
       recommendationFeedback.recordZeroCandidates("auto-inject");
@@ -174,7 +184,10 @@ export default function piSkillShiori(pi: ExtensionAPI) {
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       const current = await ensureIndex(ctx.cwd);
       const policy = withRecommendLimits(current);
-      const candidates = retrieveCandidatesExpanded(params.task, current.skills, policy, current);
+      const candidates = await measureTiming(
+        stats.timing.retrieval,
+        () => retrieveCandidatesExpanded(params.task, current.skills, policy, current),
+      );
       const candidateNames = candidates.map((candidate) => candidate.skill.name);
       const loaded = await loadRecommendedSkills(candidates);
       recommendationFeedback.recordRecommendation(
@@ -340,7 +353,10 @@ export default function piSkillShiori(pi: ExtensionAPI) {
       }
 
       const policy = withRecommendLimits(current);
-      const candidates = retrieveCandidatesExpanded(query, current.skills, policy, current);
+      const candidates = await measureTiming(
+        stats.timing.retrieval,
+        () => retrieveCandidatesExpanded(query, current.skills, policy, current),
+      );
       const candidateNames = candidates.map((candidate) => candidate.skill.name);
       const planning = isPlanningIntent(query);
       const reviewOnly = action === RECOMMEND_REVIEW_ONLY;
@@ -417,11 +433,16 @@ export default function piSkillShiori(pi: ExtensionAPI) {
     handler: async (_args, ctx) => {
       const payload = {
         ...stats,
+        timing: {
+          inventoryRefresh: { ...stats.timing.inventoryRefresh },
+          retrieval: { ...stats.timing.retrieval },
+        },
         recommendationFeedback: recommendationFeedback.summarize(),
       };
       ctx.ui.notify(
         [
           recommendationFeedback.formatSummary(),
+          formatTimingSummary(stats.timing),
           "",
           JSON.stringify(payload, null, 2),
         ].join("\n"),

package/src/metrics.ts

@@ -1,4 +1,26 @@
-import type { ShioriStats } from "./types.js";
+import { performance } from "node:perf_hooks";
+import type { ShioriStats, ShioriTiming, TimingCounter } from "./types.js";
+
+const TIMING_DECIMAL_PLACES = 2;
+const TIMING_SCALE = 10 ** TIMING_DECIMAL_PLACES;
+
+type MonotonicClock = () => number;
+
+export function createTimingCounter(): TimingCounter {
+  return {
+    lastMs: 0,
+    totalMs: 0,
+    maxMs: 0,
+    count: 0,
+  };
+}
+
+export function createTiming(): ShioriTiming {
+  return {
+    inventoryRefresh: createTimingCounter(),
+    retrieval: createTimingCounter(),
+  };
+}
 
 export function createStats(): ShioriStats {
   return {
@@ -12,5 +34,47 @@ export function createStats(): ShioriStats {
     suppressionStatus: "disabled",
     inventoryRefreshCount: 0,
     inventoryAutoRefreshCount: 0,
+    timing: createTiming(),
   };
 }
+
+export function recordTiming(counter: TimingCounter, elapsedMs: number): void {
+  const duration = roundMilliseconds(elapsedMs);
+  counter.lastMs = duration;
+  counter.totalMs = roundMilliseconds(counter.totalMs + duration);
+  counter.maxMs = Math.max(counter.maxMs, duration);
+  counter.count += 1;
+}
+
+export async function measureTiming<T>(
+  counter: TimingCounter,
+  operation: () => T | PromiseLike<T>,
+  now: MonotonicClock = () => performance.now(),
+): Promise<T> {
+  const startedAt = now();
+  const result = await operation();
+  recordTiming(counter, now() - startedAt);
+  return result;
+}
+
+export function formatTimingSummary(timing: ShioriTiming): string {
+  return [
+    "Timing (session-local)",
+    `inventory refresh: ${formatTimingCounter(timing.inventoryRefresh)}`,
+    `retrieval: ${formatTimingCounter(timing.retrieval)}`,
+  ].join(" | ");
+}
+
+function formatTimingCounter(counter: TimingCounter): string {
+  const count = Number.isFinite(counter.count) && counter.count > 0 ? Math.trunc(counter.count) : 0;
+  return `count=${count} last=${formatMilliseconds(counter.lastMs)} total=${formatMilliseconds(counter.totalMs)} max=${formatMilliseconds(counter.maxMs)}`;
+}
+
+function formatMilliseconds(value: number): string {
+  return `${roundMilliseconds(value).toFixed(TIMING_DECIMAL_PLACES)}ms`;
+}
+
+function roundMilliseconds(value: number): number {
+  if (!Number.isFinite(value) || value <= 0) return 0;
+  return Math.round((value + Number.EPSILON) * TIMING_SCALE) / TIMING_SCALE;
+}

package/src/retrieval-expanded.ts

@@ -1,11 +1,8 @@
 import { buildRetrievalQueries } from "./query.js";
 import { compareCandidates, excludedSkillNames, retrieveCandidates } from "./retrieval.js";
+import type { RetrievalIndex } from "./retrieval.js";
 import type { ShioriPolicy, SkillCandidate, SkillRecord } from "./types.js";
 
-interface RetrievalIndex {
-  search(query: string, limit: number): SkillRecord[];
-}
-
 export function retrieveCandidatesExpanded(
   query: string,
   skills: SkillRecord[],

package/src/retrieval.ts

@@ -1,7 +1,7 @@
 import { attachRecommendationReason } from "./recommendation-reason.js";
 import type { ShioriPolicy, SkillCandidate, SkillRecord } from "./types.js";
 
-interface RetrievalIndex {
+export interface RetrievalIndex {
   search(query: string, limit: number): SkillRecord[];
 }
 

package/src/types.ts

@@ -48,6 +48,18 @@ export interface SkillCandidate {
   reason: RecommendationReasonKind | null;
 }
 
+export interface TimingCounter {
+  lastMs: number;
+  totalMs: number;
+  maxMs: number;
+  count: number;
+}
+
+export interface ShioriTiming {
+  inventoryRefresh: TimingCounter;
+  retrieval: TimingCounter;
+}
+
 export interface ShioriStats {
   inventoryCount: number;
   duplicateCount: number;
@@ -60,4 +72,5 @@ export interface ShioriStats {
   lastReloadAt?: string;
   inventoryRefreshCount: number;
   inventoryAutoRefreshCount: number;
+  timing: ShioriTiming;
 }