@agimon-ai/doompi-cache 0.0.1-alpha.5 → 0.0.1-alpha.7

package/README.md

@@ -1,35 +1,50 @@
 # @agimon-ai/doompi-cache
 
-Provider prompt cache policy and deterministic routing for DoomPi
+Provider prompt-cache policy and deterministic routing for DoomPi.
 
-This package is a composable [DoomPi](https://www.npmjs.com/package/@agimon-ai/doompi) subsystem. Use it with the distribution or install it independently in [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent).
+DoomPi loads this package as fixed core. It derives stable provider cache keys from the active
+session composition and applies them only to supported provider requests. The package can also run
+as a standalone [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) extension.
+
+> **Alpha:** cache routing and provider integration may change between releases.
 
 ## Requirements
 
 - Node.js 22.19.0 or newer
-- `@earendil-works/pi-coding-agent` 0.84.3
+- Pi 0.84.3 for standalone extension use
 
 ## Install
 
+A DoomPi installation already includes this package. Do not add it to `.doom/modes.yaml`.
+
+To load it directly in Pi:
+
 ```bash
 pi install npm:@agimon-ai/doompi-cache
 ```
 
-The package declares its Pi extension entry, so Pi loads it after installation. DoomPi users can include the package through their normal profile and domain composition instead.
+Pi reads the extension entry from `package.json.pi.extensions` and loads it after installation.
 
 ## Package behavior
 
-DoomPi derives an opaque provider cache key from stable model-visible state, including the composition fingerprint, ordered domains, profile, persona, active minor modes, effective model, and child prompt projection. Returning to equivalent state restores the same key, but provider expiry or eviction can still make that namespace cold.
+DoomPi derives an opaque provider cache key from stable model-visible state: the composition
+fingerprint, ordered domains, profile, persona, active minor modes, effective model, and child prompt
+projection. Returning to equivalent state restores the same key. Provider expiry or eviction can
+still make the cache cold.
 
-The Pi extension rewrites only a nonblank cache key already emitted for an allowlisted OpenAI-family wire API. It preserves supported retention and provider cache markers, avoids adding unsupported fields to proxies, and reports only provider-observed token usage. Telemetry always reports current provider residency as `unknown`.
+The Pi extension rewrites only a nonblank cache key already emitted for an allowlisted OpenAI-family
+wire API. It preserves supported retention and provider cache markers, does not add unsupported
+fields to proxies, and reports only provider-observed token usage. Telemetry reports current
+provider residency as `unknown`.
 
 ## Help
 
-The published package includes `llms.txt` and the package-owned `src/prompts/doompi-use-cache/SKILL.md`. When the DoomPi Help minor mode is active, the extension contributes `doompi-use-cache` to its live Help catalog. The contribution follows Help provider replacement and is withdrawn when the extension shuts down.
-
-Help remains optional. Loading the standalone Pi extension does not require DoomPi Help or any other DoomPi runtime service.
+The published package includes `llms.txt` and `src/prompts/doompi-use-cache/SKILL.md`. While DoomPi
+Help is active, the extension adds `doompi-use-cache` to the live Help catalog. The contribution
+follows Help provider replacement and is removed when the extension shuts down.
 
-To add another package-owned Help prompt, use the `scaffold-doom-prompt` feature with a `doompi-author-*` or `doompi-use-*` name and a concise description. Then link the generated `SKILL.md` from `llms.txt` and register a matching descriptor through the optional `DOOM_HELP_SERVICE` injection in the Pi adapter. Keep prompts as published resources under `src/prompts`; do not export them or copy them into `dist`.
+Help is optional. The standalone Pi extension does not require DoomPi Help or another DoomPi runtime
+service.
 
 ## Public API
 
@@ -46,7 +61,8 @@ import {
 } from '@agimon-ai/doompi-cache/env';
 ```
 
-The Pi host entry is available at `@agimon-ai/doompi-cache/extensions/pi`. The root API has no import-time extension side effects.
+The Pi host entry is `@agimon-ai/doompi-cache/extensions/pi`. Importing the root API does not install
+the extension.
 
 ## Development
 
@@ -59,7 +75,8 @@ pnpm exec vibe-lint check .
 npm pack --dry-run
 ```
 
-The official OpenAI canary is opt-in and reports provider `cached_tokens` without treating a cold result as a deterministic failure:
+The live OpenAI canary is opt-in. It reports provider `cached_tokens`; a cold result does not fail
+the test deterministically:
 
 ```bash
 DOOMPI_CACHE_LIVE_OPENAI=1 \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/doompi-cache",
-  "version": "0.0.1-alpha.5",
+  "version": "0.0.1-alpha.7",
   "description": "Provider prompt cache policy and deterministic routing for DoomPi",
   "keywords": [
     "ai",
@@ -60,8 +60,8 @@
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "pi-cache-optimizer": "2.8.3",
-    "@agimon-ai/doompi-config": "0.0.1-alpha.38",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.38"
+    "@agimon-ai/doompi-config": "0.0.1-alpha.40",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.40"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.3",
@@ -70,7 +70,7 @@
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
     "vitest": "4.1.11",
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.36"
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.38"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.3"