wholestack 0.4.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,60 @@
1
+ # wholestack
2
+
3
+ A conversational terminal agent for the [Wholestack](https://wholestack.ai) codegen engine. Describe what you want in plain language — it writes an ISL contract, generates a full-stack (Next.js + Postgres) or Solidity app, and proves it with ShipGate (Foundry · Slither · Halmos · firewall).
4
+
5
+ ```bash
6
+ npm install -g wholestack
7
+ ```
8
+
9
+ ## Quick start
10
+
11
+ ```bash
12
+ wholestack login # opens your browser to authorize this device
13
+ wholestack # start an interactive session
14
+ wholestack "build me a todo app with auth" # one-shot
15
+ ```
16
+
17
+ The `zeta` command is installed as an alias for `wholestack`.
18
+
19
+ ## Login & billing
20
+
21
+ Builds run on the hosted Wholestack engine and spend one **build credit** from your
22
+ membership wallet — the same credits and tiers as the web app. So you must be
23
+ signed in and on a paid plan to generate and keep code.
24
+
25
+ ```bash
26
+ wholestack login # browser device login (recommended)
27
+ wholestack login --token <vbfl_…> # headless / CI: paste a token from your dashboard
28
+ wholestack login --no-browser # print the URL instead of auto-opening
29
+ wholestack logout # forget the stored token
30
+ ```
31
+
32
+ `login` mints a personal access token tied to your account and stores it at
33
+ `~/.zeta-g/config.json` (chmod 600). Revoke it anytime from **Account → Security**
34
+ on wholestack.ai.
35
+
36
+ ## Common flags
37
+
38
+ | Flag | Meaning |
39
+ |------|---------|
40
+ | `-m, --model <id>` | pick the brain tier (`zeta-g1-lite` / `zeta-g1` / `zeta-g1-max`) |
41
+ | `--think` / `--no-think` | toggle extended reasoning |
42
+ | `--plan` | plan mode (no mutations) |
43
+ | `-p, --print` | non-interactive, print result and exit |
44
+ | `--zeta-url <url>` | override the engine origin (defaults to https://wholestack.ai) |
45
+
46
+ ## Security verification
47
+
48
+ Run ShipGate's gates on a generated contract:
49
+
50
+ ```bash
51
+ wholestack prove ./contracts MyToken --property conservation
52
+ ```
53
+
54
+ ## Requirements
55
+
56
+ - Node.js ≥ 20
57
+
58
+ ## License
59
+
60
+ MIT