pluidr 0.7.2 → 0.7.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.
- package/README.md +25 -26
- package/package.json +45 -45
- package/src/templates/opencode.config.json +3 -0
package/README.md
CHANGED
|
@@ -12,11 +12,11 @@
|
|
|
12
12
|
|
|
13
13
|
Pluidr installs **3 primary agents + 14 subagents** into OpenCode — each primary agent owns its exclusive subagents, scoped permissions, and enforced workflow rules. No shared subagents. No ad-hoc delegation.
|
|
14
14
|
|
|
15
|
-
| Primary Agent |
|
|
16
|
-
|
|
17
|
-
| **Composer** |
|
|
18
|
-
| **Debugger** |
|
|
19
|
-
| **Prober** |
|
|
15
|
+
| Primary Agent | Purpose | Subagents |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| **Composer** | Feature work — Explore → Plan → Build | Researcher, Plan-Writer, Plan-Checker, Coder, Tester, Reviewer, Compose-Reporter |
|
|
18
|
+
| **Debugger** | Bug investigation — Investigate → Fix → Report | Inspector, Fixer, Debug-Reporter |
|
|
19
|
+
| **Prober** | Security audit — Trace → Patch → Audit | Tracer, Patcher, Auditor, Probe-Reporter |
|
|
20
20
|
|
|
21
21
|
---
|
|
22
22
|
|
|
@@ -35,21 +35,20 @@ You describe a feature / idea
|
|
|
35
35
|
│ │
|
|
36
36
|
│ Delegate: Researcher │
|
|
37
37
|
│ → deep codebase + web fact-finding │
|
|
38
|
-
│ →
|
|
39
|
-
│ unknowns / risks │
|
|
38
|
+
│ → confirmed-inferred facts / risks │
|
|
40
39
|
│ │
|
|
41
40
|
│ Composer internally assesses: │
|
|
42
41
|
│ Is this feature simple or complex? │
|
|
43
42
|
└──────────┬──────────────────────────────┘
|
|
44
43
|
│
|
|
45
|
-
|
|
46
|
-
│ Simple feature
|
|
47
|
-
▼
|
|
48
|
-
GUARDRAIL GATE 1a
|
|
49
|
-
"Build directly?"
|
|
50
|
-
│
|
|
51
|
-
│ Yes
|
|
52
|
-
│
|
|
44
|
+
┌────────┴───────────────┐
|
|
45
|
+
│ Simple feature │ Complex feature
|
|
46
|
+
▼ ▼
|
|
47
|
+
GUARDRAIL GATE 1a GUARDRAIL GATE 1b
|
|
48
|
+
"Build directly?" "Write a PRD?"
|
|
49
|
+
│ │
|
|
50
|
+
│ Yes │ Yes
|
|
51
|
+
│ ▼
|
|
53
52
|
│ ┌──────────────────────────────┐
|
|
54
53
|
│ │ PLAN PHASE │
|
|
55
54
|
│ │ │
|
|
@@ -62,9 +61,9 @@ GUARDRAIL GATE 1a GUARDRAIL GATE 1b
|
|
|
62
61
|
│ │ │
|
|
63
62
|
│ │ PASS → GUARDRAIL GATE 2 │
|
|
64
63
|
│ │ "Build from this PRD?" │
|
|
65
|
-
│
|
|
66
|
-
│
|
|
67
|
-
|
|
64
|
+
│ └─────────────┬────────────────┘
|
|
65
|
+
│ │ Yes
|
|
66
|
+
└──────────┬─────────────┘
|
|
68
67
|
▼
|
|
69
68
|
┌────────────────────────────────────────────┐
|
|
70
69
|
│ BUILD PHASE │
|
|
@@ -293,12 +292,6 @@ All agents resolve conflicts using this priority order (defined in `hierarchy.tx
|
|
|
293
292
|
npm install -g pluidr
|
|
294
293
|
```
|
|
295
294
|
|
|
296
|
-
Or run directly without installing:
|
|
297
|
-
|
|
298
|
-
```sh
|
|
299
|
-
npx pluidr init
|
|
300
|
-
```
|
|
301
|
-
|
|
302
295
|
## Usage
|
|
303
296
|
|
|
304
297
|
### `pluidr`
|
|
@@ -328,6 +321,7 @@ Checks installation health and reports ✓/✗ for each component:
|
|
|
328
321
|
- `opencode.jsonc` exists
|
|
329
322
|
- All 18 prompt files present
|
|
330
323
|
- Both plugin files present
|
|
324
|
+
- `pluidr-contrast` theme file present
|
|
331
325
|
- `package.json` with `@opencode-ai/plugin` dependency
|
|
332
326
|
- squeeze binary available
|
|
333
327
|
- Config is valid JSON
|
|
@@ -343,12 +337,13 @@ Checks the npm registry for a newer version of pluidr and prompts to install it.
|
|
|
343
337
|
Restores your previous configuration:
|
|
344
338
|
|
|
345
339
|
- Finds the latest timestamped backup and restores it to `opencode.jsonc`
|
|
346
|
-
-
|
|
340
|
+
- Restores `tui.json` from the latest backup (returning the TUI theme to its pre-Pluidr state)
|
|
341
|
+
- Removes `prompts/`, `plugins/`, `bin/`, and `themes/pluidr-contrast.json` directories and files
|
|
347
342
|
- Preserves `opencode.jsonc` and `package.json`
|
|
348
343
|
|
|
349
344
|
---
|
|
350
345
|
|
|
351
|
-
## Bundled
|
|
346
|
+
## Bundled Package
|
|
352
347
|
|
|
353
348
|
### `pluidr-flow`
|
|
354
349
|
|
|
@@ -363,3 +358,7 @@ Provides subagents with cross-session context access:
|
|
|
363
358
|
Hooks into tool execution to rewrite bash commands through the `squeeze` binary, filtering verbose output and saving **60–90% of tokens** across all agents.
|
|
364
359
|
|
|
365
360
|
Both plugins and their dependency declaration are installed automatically by `pluidr init` — no extra user action required. On OpenCode's first launch, the bundled Bun runtime installs `@opencode-ai/plugin` from the generated `package.json`.
|
|
361
|
+
|
|
362
|
+
### Themes & Colors
|
|
363
|
+
|
|
364
|
+
Pluidr comes with a pre-configured OLED high-contrast dark theme called **`pluidr-contrast`** that is automatically applied to your OpenCode terminal interface.
|
package/package.json
CHANGED
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "pluidr",
|
|
3
|
-
"version": "0.7.
|
|
4
|
-
"description": "Opinionated Engineering Workflow for OpenCode —
|
|
5
|
-
"keywords": [
|
|
6
|
-
"opencode",
|
|
7
|
-
"workflow",
|
|
8
|
-
"engineering",
|
|
9
|
-
"pipeline",
|
|
10
|
-
"ai-agents",
|
|
11
|
-
"code-review",
|
|
12
|
-
"debugging",
|
|
13
|
-
"security-audit",
|
|
14
|
-
"security",
|
|
15
|
-
"planner",
|
|
16
|
-
"builder",
|
|
17
|
-
"cli"
|
|
18
|
-
],
|
|
19
|
-
"license": "MIT",
|
|
20
|
-
"type": "module",
|
|
21
|
-
"scripts": {
|
|
22
|
-
"test": "node --test"
|
|
23
|
-
},
|
|
24
|
-
"bin": {
|
|
25
|
-
"pluidr": "bin/pluidr.js"
|
|
26
|
-
},
|
|
27
|
-
"repository": {
|
|
28
|
-
"type": "git",
|
|
29
|
-
"url": "git+https://github.com/funara/pluidr.git"
|
|
30
|
-
},
|
|
31
|
-
"homepage": "https://github.com/funara/pluidr#readme",
|
|
32
|
-
"bugs": {
|
|
33
|
-
"url": "https://github.com/funara/pluidr/issues"
|
|
34
|
-
},
|
|
35
|
-
"engines": {
|
|
36
|
-
"node": ">=18"
|
|
37
|
-
},
|
|
38
|
-
"files": [
|
|
39
|
-
"bin",
|
|
40
|
-
"src"
|
|
41
|
-
],
|
|
42
|
-
"dependencies": {
|
|
43
|
-
"@clack/prompts": "^0.9"
|
|
44
|
-
}
|
|
45
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "pluidr",
|
|
3
|
+
"version": "0.7.3",
|
|
4
|
+
"description": "Opinionated Engineering Workflow for OpenCode — Plan, Build, Review.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"opencode",
|
|
7
|
+
"workflow",
|
|
8
|
+
"engineering",
|
|
9
|
+
"pipeline",
|
|
10
|
+
"ai-agents",
|
|
11
|
+
"code-review",
|
|
12
|
+
"debugging",
|
|
13
|
+
"security-audit",
|
|
14
|
+
"security",
|
|
15
|
+
"planner",
|
|
16
|
+
"builder",
|
|
17
|
+
"cli"
|
|
18
|
+
],
|
|
19
|
+
"license": "MIT",
|
|
20
|
+
"type": "module",
|
|
21
|
+
"scripts": {
|
|
22
|
+
"test": "node --test"
|
|
23
|
+
},
|
|
24
|
+
"bin": {
|
|
25
|
+
"pluidr": "bin/pluidr.js"
|
|
26
|
+
},
|
|
27
|
+
"repository": {
|
|
28
|
+
"type": "git",
|
|
29
|
+
"url": "git+https://github.com/funara/pluidr.git"
|
|
30
|
+
},
|
|
31
|
+
"homepage": "https://github.com/funara/pluidr#readme",
|
|
32
|
+
"bugs": {
|
|
33
|
+
"url": "https://github.com/funara/pluidr/issues"
|
|
34
|
+
},
|
|
35
|
+
"engines": {
|
|
36
|
+
"node": ">=18"
|
|
37
|
+
},
|
|
38
|
+
"files": [
|
|
39
|
+
"bin",
|
|
40
|
+
"src"
|
|
41
|
+
],
|
|
42
|
+
"dependencies": {
|
|
43
|
+
"@clack/prompts": "^0.9"
|
|
44
|
+
}
|
|
45
|
+
}
|
|
@@ -25,6 +25,7 @@
|
|
|
25
25
|
|
|
26
26
|
"composer": {
|
|
27
27
|
"mode": "primary",
|
|
28
|
+
"color": "#00b4cc",
|
|
28
29
|
"temperature": 0.7,
|
|
29
30
|
"description": "Full engineering workflow: Explore, Plan, Build — 3 phases, 7 subagents. Starts in Explore mode, transitions via guardrail gates.",
|
|
30
31
|
"prompt": "{file:./prompts/composer.txt}",
|
|
@@ -55,6 +56,7 @@
|
|
|
55
56
|
|
|
56
57
|
"debugger": {
|
|
57
58
|
"mode": "primary",
|
|
59
|
+
"color": "#ff7039",
|
|
58
60
|
"description": "Root-cause analysis via inspector/fixer/reporter. Standalone primary agent — does not depend on Composer. Pure orchestrator — all investigation, fixes, and reports delegated to subagents.",
|
|
59
61
|
"prompt": "{file:./prompts/debugger.txt}",
|
|
60
62
|
"permission": {
|
|
@@ -345,6 +347,7 @@
|
|
|
345
347
|
|
|
346
348
|
"prober": {
|
|
347
349
|
"mode": "primary",
|
|
350
|
+
"color": "#66ffbf",
|
|
348
351
|
"temperature": 0.7,
|
|
349
352
|
"description": "Standalone security and quality auditing agent. Recon and vuln trace, minimal patch application, validation gate.",
|
|
350
353
|
"prompt": "{file:./prompts/prober.txt}",
|