@mrclrchtr/supi-claude-md 0.2.0 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +23 -46
  2. package/node_modules/@mrclrchtr/supi-core/package.json +8 -4
  3. package/package.json +9 -6
package/README.md CHANGED
@@ -1,73 +1,50 @@
1
1
  # @mrclrchtr/supi-claude-md
2
2
 
3
- Automatic `CLAUDE.md` / `AGENTS.md` context management for the [pi coding agent](https://github.com/earendil-works/pi).
3
+ Subdirectory context for PI — your project's conventions follow the agent wherever it goes.
4
4
 
5
- ## Install
5
+ 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.
6
6
 
7
- ```bash
8
- pi install npm:@mrclrchtr/supi-claude-md
9
- ```
7
+ Then it helps you keep those files in shape — audit quality, flag stale sections, and capture session learnings with your approval.
10
8
 
11
- ## What it adds
9
+ ## What you get
12
10
 
13
- This extension adds **subdirectory context discovery**: it injects `CLAUDE.md` / `AGENTS.md` from subdirectories when the agent touches files there.
11
+ ### Context that travels
14
12
 
15
- 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.
13
+ 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.
16
14
 
17
- If your install surface includes the shared SuPi settings command (for example via `@mrclrchtr/supi`), this package contributes a Claude-MD section there:
15
+ ### Smart about when to refresh
18
16
 
19
- ```text
20
- /supi-settings
21
- ```
17
+ First-time discovery always injects. Re-reads wait a configurable number of turns and skip when the context window is too full. No flooding.
22
18
 
23
- Inside `/supi-settings`, Claude-MD contributes:
19
+ ### CLAUDE.md maintenance
24
20
 
25
- - `Subdirectory Discovery`: on/off toggle
26
- - `Subdirectory Re-read Interval`: text input; enter a number of turns or `0` to disable subdirectory re-reads
27
- - `Context Threshold`: common percentage values from `0` to `100`
28
- - `Context File Names`: comma-separated text input; empty input restores the default filenames
21
+ Two bundled skills:
29
22
 
30
- This package bundles two skills:
23
+ - **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.
24
+ - **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.
31
25
 
32
- - `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
33
- - `claude-md-revision`: capture session learnings into CLAUDE.md with user approval
34
-
35
- ## Configuration
36
-
37
- Configuration uses the shared SuPi config system.
26
+ ## Install
38
27
 
39
- Config file locations:
28
+ ```bash
29
+ pi install npm:@mrclrchtr/supi-claude-md
30
+ ```
40
31
 
41
- - global: `~/.pi/agent/supi/config.json`
42
- - project: `.pi/supi/config.json`
32
+ ## Settings
43
33
 
44
- Use the `claude-md` section:
34
+ Configure via `/supi-settings` or directly in config:
45
35
 
46
36
  ```json
47
37
  {
48
38
  "claude-md": {
39
+ "subdirs": true,
49
40
  "rereadInterval": 3,
50
41
  "contextThreshold": 80,
51
- "subdirs": true,
52
42
  "fileNames": ["CLAUDE.md", "AGENTS.md"]
53
43
  }
54
44
  }
55
45
  ```
56
46
 
57
- Options:
58
-
59
- - `rereadInterval`: turns between re-reading previously injected subdirectory context; `0` disables subdirectory re-reads (first-time discovery is unaffected)
60
- - `contextThreshold`: skip subdirectory re-injection when context usage is at or above this percent; `100` disables context gating; first-time discovery is always allowed
61
- - `subdirs`: enable or disable subdirectory discovery
62
- - `fileNames`: ordered list of context filenames to search for
63
-
64
- ## Requirements
65
-
66
- - `@earendil-works/pi-coding-agent`
67
- - `@earendil-works/pi-tui`
68
- - `@mrclrchtr/supi-core`
69
-
70
- ## Source
71
-
72
- - Entrypoint: `src/claude-md.ts`
73
- - Skills: `skills/claude-md-improver/`, `skills/claude-md-revision/`
47
+ - `subdirs` — toggle subdirectory discovery on/off
48
+ - `rereadInterval` — turns between re-reading a directory's context (0 = never re-read)
49
+ - `contextThreshold` — skip re-reads when context usage is above this percent
50
+ - `fileNames` — which filenames to look for (comma-separated)
package/node_modules/@mrclrchtr/supi-core/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "0.2.0",
3
+ "version": "1.1.3",
4
4
  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -22,9 +22,13 @@
22
22
  "@earendil-works/pi-coding-agent": "*",
23
23
  "@earendil-works/pi-tui": "*"
24
24
  },
25
- "devDependencies": {
26
- "@types/node": "25.6.2",
27
- "vitest": "4.1.5"
25
+ "peerDependenciesMeta": {
26
+ "@earendil-works/pi-coding-agent": {
27
+ "optional": true
28
+ },
29
+ "@earendil-works/pi-tui": {
30
+ "optional": true
31
+ }
28
32
  },
29
33
  "main": "src/index.ts"
30
34
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-claude-md",
3
- "version": "0.2.0",
3
+ "version": "1.1.3",
4
4
  "description": "SuPi claude-md extension — automatic subdirectory context injection for pi",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -21,7 +21,7 @@
21
21
  "!__tests__"
22
22
  ],
23
23
  "dependencies": {
24
- "@mrclrchtr/supi-core": "workspace:*"
24
+ "@mrclrchtr/supi-core": "1.1.3"
25
25
  },
26
26
  "bundledDependencies": [
27
27
  "@mrclrchtr/supi-core"
@@ -30,10 +30,13 @@
30
30
  "@earendil-works/pi-coding-agent": "*",
31
31
  "@earendil-works/pi-tui": "*"
32
32
  },
33
- "devDependencies": {
34
- "@types/node": "25.6.2",
35
- "vitest": "4.1.5",
36
- "@mrclrchtr/supi-test-utils": "workspace:*"
33
+ "peerDependenciesMeta": {
34
+ "@earendil-works/pi-coding-agent": {
35
+ "optional": true
36
+ },
37
+ "@earendil-works/pi-tui": {
38
+ "optional": true
39
+ }
37
40
  },
38
41
  "pi": {
39
42
  "extensions": [