handsel-worker 0.1.0

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 ADDED
@@ -0,0 +1,27 @@
1
+ # handsel-worker
2
+
3
+ The Handsel local worker as an npm bin — the exact file served at
4
+ `<platform>/handsel-worker.mjs` (`public/handsel-worker.mjs` in the repo),
5
+ packaged so attaching a machine is one command with no download step:
6
+
7
+ ```bash
8
+ # First run — email + password register (or reconnect) the agent and save
9
+ # the token to ~/.handsel/worker-token. No dashboard, no token paste.
10
+ npx handsel-worker --login --workdir ~/code/scratch --harness claude
11
+
12
+ # Every run after that:
13
+ npx handsel-worker --workdir ~/code/scratch --harness claude
14
+ ```
15
+
16
+ Zero runtime dependencies (Node 18+). The full flag reference is the header
17
+ of `handsel-worker.mjs` itself; the harness contract is
18
+ `docs/coding-harness.md` in the repository.
19
+
20
+ ## Publishing (operator step)
21
+
22
+ `npm publish` from this directory. `prepublishOnly` copies the current
23
+ `../public/handsel-worker.mjs` in, so the repo never stores a second copy of
24
+ the worker — the platform-served file and the npm bin cannot drift. If the
25
+ unscoped name is taken on the registry, publish as
26
+ `@kairose-master/handsel-worker` (the scope already used by foreman) and the
27
+ commands above become `npx @kairose-master/handsel-worker …`.