@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 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
- ```bash
13
- npx @probnaya/057-cli
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. Nothing else is needed — no account, no configuration, no network.
22
+ Then open the URL it prints.
17
23
 
18
- > **Public experiment — v0.1.2.** 057 is being released early and narrowly, to find out
19
- > whether the idea holds up on machines that are not the one it was built on. It supports **macOS
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
- 057 runs in the foreground and stops when you stop it. There is no daemon, no background service,
61
- and nothing is installed into your login items. If `5057` is busy it takes the next free port and
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:** hostname and machine name; working-directory and workspace paths; process and command
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
- ## Experimental limitations
176
+ ## Limitations
156
177
 
157
- Stated plainly, because this is a 0.1.0 and you are the experiment.
178
+ Stated plainly.
158
179
 
159
- - **macOS only, and WebGPU is required.** Neither is a "coming soon"; both are refusals to pretend.
160
- - **The store format may change.** It is versioned and upgrades in place, and a store from a newer
161
- 057 is refused rather than downgraded — but a 0.x release may still ask you to reset.
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 hostname, your project paths, your session labels,
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 v0.1.2 is not an open-source release. It is distributed under the
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