@probnaya/057-cli 0.2.0 → 1.0.1
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/NOTICE.md +8 -0
- package/README.md +42 -20
- package/dist/assets/{index-BQEdszeO.js → index-JB-esYG9.js} +21 -33
- package/dist/index.html +1 -1
- package/dist-server/057.mjs +58 -39
- package/package.json +2 -1
package/NOTICE.md
CHANGED
|
@@ -28,6 +28,14 @@ No web fonts are bundled or fetched. The interface names IBM Plex Mono first in
|
|
|
28
28
|
falls through to the system monospace when it is not installed locally, so no font is redistributed
|
|
29
29
|
and no font licence applies.
|
|
30
30
|
|
|
31
|
+
**057 Desktop** (`057.app`, built by `desktop/app/bundle.sh`; not part of the npm package)
|
|
32
|
+
redistributes two further components, each with its licence inside the app bundle:
|
|
33
|
+
|
|
34
|
+
| Component | Version | License | Copyright | In the bundle |
|
|
35
|
+
| --- | --- | --- | --- | --- |
|
|
36
|
+
| IBM Plex Mono, Regular and Medium (WOFF2, unmodified) | 2.5.0 | SIL Open Font License 1.1 | © 2017 IBM Corp., Reserved Font Name "Plex" | `Contents/Resources/Fonts/IBMPlexMono-LICENSE.txt` |
|
|
37
|
+
| Node.js (official darwin-arm64 build, re-signed as the Core helper) | 24.14.0 | MIT, with the third-party licences Node lists | Node.js contributors and others | `Contents/Resources/Licenses/Node-LICENSE.txt` |
|
|
38
|
+
|
|
31
39
|
---
|
|
32
40
|
|
|
33
41
|
## React, React DOM, and scheduler
|
package/README.md
CHANGED
|
@@ -9,16 +9,20 @@ A spatial interface for observing the shape of a computational workday.
|
|
|
9
9
|
|
|
10
10
|
**Infrastructure is permanent. Activity is temporary. The field remembers.**
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
One instrument, two ways in:
|
|
13
|
+
|
|
14
|
+
- **Download for macOS** — 057.app, at <https://057.probnaya.work/download/macos>. Apple silicon,
|
|
15
|
+
macOS 14 or later.
|
|
16
|
+
- **Install with npm** — the web / CLI surface:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npx @probnaya/057-cli
|
|
20
|
+
```
|
|
15
21
|
|
|
16
|
-
Then open the URL it prints.
|
|
22
|
+
Then open the URL it prints.
|
|
17
23
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
> and a WebGPU browser**, and nothing else honestly. The store format may change between 0.x
|
|
21
|
-
> releases. Read *Experimental limitations* before you rely on it.
|
|
24
|
+
Nothing else is needed — no account, no configuration, no network. Both run the same Core, read the
|
|
25
|
+
same store and mean the same things; 057 runs on **macOS only**, and honestly nothing else.
|
|
22
26
|
|
|
23
27
|
## What it is
|
|
24
28
|
|
|
@@ -38,6 +42,19 @@ anywhere, because token counts are reported and money mostly is not.
|
|
|
38
42
|
|
|
39
43
|
## Run it
|
|
40
44
|
|
|
45
|
+
### 057 for macOS
|
|
46
|
+
|
|
47
|
+
Download the disk image from <https://057.probnaya.work/download/macos>, drag 057 to Applications
|
|
48
|
+
and open it. The app carries its own Core — no Node, npm or terminal — and starts observing when it
|
|
49
|
+
opens. Closing the window leaves it observing from the menu bar; quitting the app stops it. It is
|
|
50
|
+
signed with Developer ID and notarized by Apple.
|
|
51
|
+
|
|
52
|
+
**Open in Browser** (the menu-bar menu, or View) opens the browser surface its Core serves. The
|
|
53
|
+
**057** menu has **Notifications**, off by default; on, 057 tells you only when its Core fails or a
|
|
54
|
+
source has failed for ten minutes.
|
|
55
|
+
|
|
56
|
+
### The web / CLI surface
|
|
57
|
+
|
|
41
58
|
```bash
|
|
42
59
|
npx @probnaya/057-cli
|
|
43
60
|
```
|
|
@@ -57,18 +74,22 @@ npm install -g @probnaya/057-cli
|
|
|
57
74
|
057 --help
|
|
58
75
|
```
|
|
59
76
|
|
|
60
|
-
|
|
61
|
-
and nothing is installed into your login items. If `5057` is busy it takes the next free
|
|
62
|
-
prints it.
|
|
77
|
+
The command runs in the foreground and stops when you stop it. There is no daemon, no background
|
|
78
|
+
service, and nothing is installed into your login items. If `5057` is busy it takes the next free
|
|
79
|
+
port and prints it.
|
|
80
|
+
|
|
81
|
+
One store has one observer. If 057.app is already running, `057` says so and names the URL its Core
|
|
82
|
+
serves, and `057 --open` opens it; the history is the same either way.
|
|
63
83
|
|
|
64
84
|
## Requirements
|
|
65
85
|
|
|
66
86
|
| | |
|
|
67
87
|
| --- | --- |
|
|
88
|
+
| **macOS app** | Apple silicon, macOS 14 or later. Nothing else to install. |
|
|
68
89
|
| **OS** | **macOS only.** The package declares `"os": ["darwin"]` and npm will refuse to install elsewhere — the process sampler reads a BSD process table and the Cursor reader looks in a macOS path. A 057 that silently mis-parsed your process table would be worse than one that will not start. |
|
|
69
90
|
| **Node** | 24.x. The package declares `>=22.5.0`, where the built-in SQLite the store needs first exists, but only 24 has been exercised. |
|
|
70
91
|
| **Browser** | A WebGPU browser: Chrome 113+, Edge 113+, or Safari 26+. Without WebGPU the interface says so plainly rather than falling back to something that is not FIELD. |
|
|
71
|
-
| **Network** | Only to download the package. Running 057 needs none. |
|
|
92
|
+
| **Network** | Only to download the app or the package. Running 057 needs none. |
|
|
72
93
|
|
|
73
94
|
## What it reads, and what it keeps
|
|
74
95
|
|
|
@@ -77,7 +98,7 @@ coding runtimes on your machine have already written for their own purposes. 057
|
|
|
77
98
|
processes, does not read process memory, and does not watch your keyboard, screen, network or
|
|
78
99
|
filesystem at large.
|
|
79
100
|
|
|
80
|
-
**Stored:**
|
|
101
|
+
**Stored:** the machine's name; working-directory and workspace paths; process and command
|
|
81
102
|
names; session and execution labels as the runtime recorded them; models, tools, token counts,
|
|
82
103
|
statuses and timings; and a timeline of when your machine was working.
|
|
83
104
|
|
|
@@ -152,13 +173,14 @@ how to delete it, and what it is licensed under. The full manual is at
|
|
|
152
173
|
| [Reading FIELD](https://057.probnaya.work/docs/field) | How to read the interface. |
|
|
153
174
|
| [Troubleshooting](https://057.probnaya.work/docs/troubleshooting) | Failure modes, and which ones are safe to act on. |
|
|
154
175
|
|
|
155
|
-
##
|
|
176
|
+
## Limitations
|
|
156
177
|
|
|
157
|
-
Stated plainly
|
|
178
|
+
Stated plainly.
|
|
158
179
|
|
|
159
|
-
- **macOS only
|
|
160
|
-
|
|
161
|
-
|
|
180
|
+
- **macOS only.** The browser surface needs WebGPU; the app needs Apple silicon. Neither is a
|
|
181
|
+
"coming soon"; both are refusals to pretend.
|
|
182
|
+
- **The store format is versioned** and upgrades in place, and a store from a newer 057 is refused
|
|
183
|
+
rather than downgraded.
|
|
162
184
|
- **Exits are inferred.** The process sampler is a five-second snapshot, not a kernel hook: it
|
|
163
185
|
cannot see an exit, only stop seeing a process, and everything derived from that says so. A
|
|
164
186
|
process that starts and exits within one interval is never observed at all.
|
|
@@ -180,7 +202,7 @@ by design, because adding accounts to a local instrument would be adding the exa
|
|
|
180
202
|
product does not have.
|
|
181
203
|
|
|
182
204
|
**Do not put 057 behind a reverse proxy, and do not set `O57_HOST` on a network you do not control.**
|
|
183
|
-
Either publishes an unauthenticated read of your
|
|
205
|
+
Either publishes an unauthenticated read of your machine's name, your project paths, your session labels,
|
|
184
206
|
your models and a record of when you were at your machine, to anything that can reach that address.
|
|
185
207
|
057 warns you at startup if you do it. There is no auth to turn on.
|
|
186
208
|
|
|
@@ -189,7 +211,7 @@ metadata rather than opening it publicly.
|
|
|
189
211
|
|
|
190
212
|
## Licence
|
|
191
213
|
|
|
192
|
-
057 is publicly installable, but
|
|
214
|
+
057 is publicly installable, but it is not an open-source release. It is distributed under the
|
|
193
215
|
PolyForm Internal Use License 1.0.0: personal use and internal business or workplace use are
|
|
194
216
|
permitted, redistribution is not, and private modifications for permitted purposes remain governed
|
|
195
217
|
by the licence. See `LICENSE.md` for the terms. Third-party components retain their own licences as
|