panopticon-cli 0.3.4 → 0.3.6
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 +24 -5
- package/dist/cli/index.js +676 -484
- package/dist/cli/index.js.map +1 -1
- package/dist/dashboard/public/assets/index-C6PTmw-V.css +32 -0
- package/dist/dashboard/public/assets/index-kezR_sk3.js +423 -0
- package/dist/dashboard/public/index.html +13 -0
- package/dist/dashboard/server.js +102398 -0
- package/package.json +7 -2
package/README.md
CHANGED
|
@@ -223,6 +223,21 @@ See [docs/DNS_SETUP.md](docs/DNS_SETUP.md) for detailed DNS configuration (espec
|
|
|
223
223
|
- **Linear API key** - For issue tracking integration
|
|
224
224
|
- **Beads CLI (bd)** - For persistent task tracking across sessions
|
|
225
225
|
|
|
226
|
+
### Platform Support
|
|
227
|
+
|
|
228
|
+
The Panopticon dashboard includes terminal streaming, which requires a native binary (`node-pty`). Prebuilt binaries are available for:
|
|
229
|
+
|
|
230
|
+
| Platform | Architecture | Support |
|
|
231
|
+
|----------|-------------|---------|
|
|
232
|
+
| macOS | Intel (x64) | ✅ Prebuilt |
|
|
233
|
+
| macOS | Apple Silicon (arm64) | ✅ Prebuilt |
|
|
234
|
+
| Linux | x64 (glibc) | ✅ Prebuilt |
|
|
235
|
+
| Linux | arm64 (glibc) | ✅ Prebuilt |
|
|
236
|
+
| Linux | musl (Alpine) | ✅ Prebuilt |
|
|
237
|
+
| Windows | x64 | ✅ Prebuilt |
|
|
238
|
+
|
|
239
|
+
If a prebuilt binary is not available for your platform, node-gyp will automatically compile from source during installation (requires Python and build tools).
|
|
240
|
+
|
|
226
241
|
### Why CLI tools instead of API tokens?
|
|
227
242
|
|
|
228
243
|
Panopticon uses `gh` and `glab` CLIs instead of raw API tokens because:
|
|
@@ -699,7 +714,7 @@ pan work health status
|
|
|
699
714
|
pan work health daemon --interval 30
|
|
700
715
|
```
|
|
701
716
|
|
|
702
|
-
###
|
|
717
|
+
### FPP Hooks (Fixed Point Principle)
|
|
703
718
|
|
|
704
719
|
```bash
|
|
705
720
|
# Check for pending work on hook
|
|
@@ -1230,7 +1245,7 @@ This ensures every Panopticon-managed project has a well-defined canonical PRD t
|
|
|
1230
1245
|
agent-min-123/
|
|
1231
1246
|
state.json # Agent state (model, phase, complexity)
|
|
1232
1247
|
health.json # Health status
|
|
1233
|
-
hook.json #
|
|
1248
|
+
hook.json # FPP work queue
|
|
1234
1249
|
cv.json # Work history
|
|
1235
1250
|
mail/ # Incoming messages
|
|
1236
1251
|
handoffs/ # Handoff prompts (for debugging)
|
|
@@ -1296,11 +1311,15 @@ When an agent is stuck (no activity for 30+ minutes), Panopticon will:
|
|
|
1296
1311
|
2. Record the kill in health.json
|
|
1297
1312
|
3. Respawn with crash recovery context
|
|
1298
1313
|
|
|
1299
|
-
##
|
|
1314
|
+
## FPP (Fixed Point Principle)
|
|
1315
|
+
|
|
1316
|
+
> "Any runnable action is a fixed point and must resolve before the system can rest."
|
|
1317
|
+
|
|
1318
|
+
*Inspired by Doctor Who: a fixed point in time must occur — it cannot be avoided.*
|
|
1300
1319
|
|
|
1301
|
-
|
|
1320
|
+
**Fixed Point Principle (FPP):** Any runnable bead, hook, or agent action represents a fixed point in execution and must be resolved immediately. Panopticon continues executing until no fixed points remain.
|
|
1302
1321
|
|
|
1303
|
-
|
|
1322
|
+
FPP ensures agents are self-propelling:
|
|
1304
1323
|
1. Work items are pushed to the agent's hook
|
|
1305
1324
|
2. On spawn/recovery, the hook is checked
|
|
1306
1325
|
3. Pending work is injected into the agent's prompt
|