@mrclrchtr/supi-claude-md 1.1.2 → 1.1.3

package/README.md

@@ -1,73 +1,50 @@
 # @mrclrchtr/supi-claude-md
 
-Automatic `CLAUDE.md` / `AGENTS.md` context management for the [pi coding agent](https://github.com/earendil-works/pi).
+Subdirectory context for PI — your project's conventions follow the agent wherever it goes.
 
-## Install
+Pi loads your root `CLAUDE.md` by default. Claude-MD extends that downward: when the agent reaches into `src/auth/`, it picks up `src/auth/CLAUDE.md` too. Conventions are where the code is, not just at the project root.
 
-```bash
-pi install npm:@mrclrchtr/supi-claude-md
-```
+Then it helps you keep those files in shape — audit quality, flag stale sections, and capture session learnings with your approval.
 
-## What it adds
+## What you get
 
-This extension adds **subdirectory context discovery**: it injects `CLAUDE.md` / `AGENTS.md` from subdirectories when the agent touches files there.
+### Context that travels
 
-Pi loads root and ancestor instruction files natively into the system prompt on every turn. This package only handles subdirectories below `cwd`. To pick up root instruction file edits mid-session, use pi's `/reload` command or restart the session.
+Reads, writes, edits, LSP operations — any time the agent touches a file, it picks up the nearest `CLAUDE.md` or `AGENTS.md` in that directory. Conventions arrive exactly when they're needed, not dumped upfront.
 
-If your install surface includes the shared SuPi settings command (for example via `@mrclrchtr/supi`), this package contributes a Claude-MD section there:
+### Smart about when to refresh
 
-```text
-/supi-settings
-```
+First-time discovery always injects. Re-reads wait a configurable number of turns and skip when the context window is too full. No flooding.
 
-Inside `/supi-settings`, Claude-MD contributes:
+### CLAUDE.md maintenance
 
-- `Subdirectory Discovery`: on/off toggle
-- `Subdirectory Re-read Interval`: text input; enter a number of turns or `0` to disable subdirectory re-reads
-- `Context Threshold`: common percentage values from `0` to `100`
-- `Context File Names`: comma-separated text input; empty input restores the default filenames
+Two bundled skills:
 
-This package bundles two skills:
+- **claude-md-improver** — audit every CLAUDE.md in your repo. Flags redundancy, stale sections, and content already covered by SuPi's auto-injected context. Suggests targeted updates.
+- **claude-md-revision** — capture what you learned this session into CLAUDE.md. Ask the agent to remember a pattern, convention, or gotcha — it proposes the edit, you approve.
 
-- `claude-md-improver`: audit CLAUDE.md files, evaluate quality, and propose targeted updates. SuPi-aware: compares CLAUDE.md sections against a synthesized context baseline from `supi-code-intelligence` and `supi-claude-md`, then flags redundant content and suggests compression when only part of a section should stay
-- `claude-md-revision`: capture session learnings into CLAUDE.md with user approval
-
-## Configuration
-
-Configuration uses the shared SuPi config system.
+## Install
 
-Config file locations:
+```bash
+pi install npm:@mrclrchtr/supi-claude-md
+```
 
-- global: `~/.pi/agent/supi/config.json`
-- project: `.pi/supi/config.json`
+## Settings
 
-Use the `claude-md` section:
+Configure via `/supi-settings` or directly in config:
 
 ```json
 {
   "claude-md": {
+    "subdirs": true,
     "rereadInterval": 3,
     "contextThreshold": 80,
-    "subdirs": true,
     "fileNames": ["CLAUDE.md", "AGENTS.md"]
   }
 }
 ```
 
-Options:
-
-- `rereadInterval`: turns between re-reading previously injected subdirectory context; `0` disables subdirectory re-reads (first-time discovery is unaffected)
-- `contextThreshold`: skip subdirectory re-injection when context usage is at or above this percent; `100` disables context gating; first-time discovery is always allowed
-- `subdirs`: enable or disable subdirectory discovery
-- `fileNames`: ordered list of context filenames to search for
-
-## Requirements
-
-- `@earendil-works/pi-coding-agent`
-- `@earendil-works/pi-tui`
-- `@mrclrchtr/supi-core`
-
-## Source
-
-- Entrypoint: `src/claude-md.ts`
-- Skills: `skills/claude-md-improver/`, `skills/claude-md-revision/`
+- `subdirs` — toggle subdirectory discovery on/off
+- `rereadInterval` — turns between re-reading a directory's context (0 = never re-read)
+- `contextThreshold` — skip re-reads when context usage is above this percent
+- `fileNames` — which filenames to look for (comma-separated)

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -22,5 +22,13 @@
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
   },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
   "main": "src/index.ts"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-claude-md",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "SuPi claude-md extension — automatic subdirectory context injection for pi",
   "license": "MIT",
   "repository": {
@@ -21,7 +21,7 @@
     "!__tests__"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "1.1.2"
+    "@mrclrchtr/supi-core": "1.1.3"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"
@@ -30,6 +30,14 @@
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
   },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
   "pi": {
     "extensions": [
       "./src/claude-md.ts"