@agimon-ai/doompi-help 0.0.1-alpha.3 → 0.0.1-alpha.5
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.
- package/README.md +46 -13
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,15 +1,51 @@
|
|
|
1
1
|
# @agimon-ai/doompi-help
|
|
2
2
|
|
|
3
|
-
Activation-gated package guidance for DoomPi.
|
|
3
|
+
Activation-gated, package-owned guidance for DoomPi.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
the existing `minor_mode` client share the same activation service. Activation resolves a
|
|
7
|
-
contributor's bundled `llms.txt` first, then an immutable exact-version cache, and finally a
|
|
8
|
-
verified exact-version unpkg fallback. Deactivation removes generated Help skill wrappers
|
|
9
|
-
before the next prompt or catalog access; child sessions never load this package.
|
|
5
|
+
Help keeps extension documentation out of the default model context. Packages contribute concise `llms.txt` indexes; the Help host resolves and exposes them only while Help mode is active.
|
|
10
6
|
|
|
11
|
-
|
|
12
|
-
|
|
7
|
+
> **Alpha:** Help contribution contracts may change between releases.
|
|
8
|
+
|
|
9
|
+
## Requirements
|
|
10
|
+
|
|
11
|
+
- Node.js 22.19.0 or newer
|
|
12
|
+
- Pi 0.84.2
|
|
13
|
+
|
|
14
|
+
## Install
|
|
15
|
+
|
|
16
|
+
DoomPi includes Help as a core parent capability. To load the package directly in Pi:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
pi install npm:@agimon-ai/doompi-help
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
The Pi entrypoint is `@agimon-ai/doompi-help/extensions/doom`.
|
|
23
|
+
|
|
24
|
+
## Activate and deactivate
|
|
25
|
+
|
|
26
|
+
In an interactive DoomPi session, use `SPC h e`. Headless clients use the existing `minor_mode` protocol action.
|
|
27
|
+
|
|
28
|
+
Activation resolves each contributor in this order:
|
|
29
|
+
|
|
30
|
+
1. its published `llms.txt`;
|
|
31
|
+
2. an immutable exact-version cache;
|
|
32
|
+
3. a verified exact-version unpkg fallback.
|
|
33
|
+
|
|
34
|
+
Deactivation logically withdraws the active Help skills before the next prompt or catalog read. Cached package content or previously generated wrappers may remain on disk and must not be interpreted as still-active model context.
|
|
35
|
+
|
|
36
|
+
The package contributes `doompi-help`. Other packages, including Workflow and Config, own their own Help descriptors and indexes.
|
|
37
|
+
|
|
38
|
+
## Parent and child behavior
|
|
39
|
+
|
|
40
|
+
The DoomPi distribution assembles the Help host only in parent sessions and starts it inactive. Child sessions do not assemble the Help runtime. A custom plain-Pi host can load the extension directly, but must supply the lifecycle expected by its integration.
|
|
41
|
+
|
|
42
|
+
## Public API
|
|
43
|
+
|
|
44
|
+
```ts
|
|
45
|
+
import { activateHelpExtension, registerHelpExtension } from '@agimon-ai/doompi-help';
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
The root export is intended for hosts and tests; ordinary users activate Help through the extension and mode protocol.
|
|
13
49
|
|
|
14
50
|
## Development
|
|
15
51
|
|
|
@@ -20,9 +56,6 @@ pnpm test
|
|
|
20
56
|
pnpm lint
|
|
21
57
|
```
|
|
22
58
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
## Release order
|
|
59
|
+
## License
|
|
26
60
|
|
|
27
|
-
|
|
28
|
-
the `@agimon-ai/doompi` runtime that consumes both. Do not hand-edit generated changelogs.
|
|
61
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agimon-ai/doompi-help",
|
|
3
|
-
"version": "0.0.1-alpha.
|
|
3
|
+
"version": "0.0.1-alpha.5",
|
|
4
4
|
"description": "Activation-gated package guidance for DoomPi",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"access": "public"
|
|
43
43
|
},
|
|
44
44
|
"dependencies": {
|
|
45
|
-
"@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.
|
|
45
|
+
"@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.22"
|
|
46
46
|
},
|
|
47
47
|
"devDependencies": {
|
|
48
48
|
"@earendil-works/pi-coding-agent": "0.84.2",
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
"tsdown": "0.22.14",
|
|
52
52
|
"typescript": "6.0.3",
|
|
53
53
|
"vitest": "4.1.10",
|
|
54
|
-
"@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.
|
|
54
|
+
"@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.22"
|
|
55
55
|
},
|
|
56
56
|
"peerDependencies": {
|
|
57
57
|
"@earendil-works/pi-coding-agent": "0.84.2"
|