@blockyfy/stg-cli 0.4.0 → 0.4.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.
Files changed (4) hide show
  1. package/README.md +70 -57
  2. package/dist/index.js +204 -292
  3. package/dist/index.js.map +1 -1
  4. package/package.json +56 -56
package/README.md CHANGED
@@ -1,57 +1,70 @@
1
- # @blockyfy/stg-cli (Pretest CLI)
2
-
3
- AI firewall CLI that mutates proprietary code identifiers before sending to LLM APIs. Your code hits AI naked — Pretest fixes that.
4
-
5
- ## Install
6
-
7
- ```bash
8
- npm install -g @blockyfy/stg-cli
9
- ```
10
-
11
- ## Quickstart
12
-
13
- ```bash
14
- # Initialize config in your project
15
- pretest init
16
-
17
- # Start the proxy (default port 9339)
18
- pretest start
19
-
20
- # Point your AI tools at the proxy
21
- export ANTHROPIC_BASE_URL=http://localhost:9339
22
- export OPENAI_BASE_URL=http://localhost:9339/v1
23
-
24
- # Scan a file for identifiers and secrets
25
- pretest scan src/
26
-
27
- # Mutate a file and print to stdout
28
- pretest mutate src/app.ts
29
-
30
- # Reverse mutations using stored map
31
- pretest reverse mutated-output.ts
32
-
33
- # View audit log
34
- pretest audit --json
35
- ```
36
-
37
- ## Commands
38
-
39
- | Command | Description |
40
- |---------|-------------|
41
- | `pretest init` | Scan cwd, create .pretest/ config |
42
- | `pretest start` | Start proxy on :9339 |
43
- | `pretest scan <file\|dir>` | Scan for identifiers + secrets |
44
- | `pretest mutate <file>` | Redact scanner hits (secrets/PII), then mutate identifiers; print to stdout |
45
- | `pretest reverse <file>` | Reverse using stored map |
46
- | `pretest audit` | Print audit log |
47
- | `pretest version` | Print version |
48
-
49
- ## Exit Codes
50
-
51
- - `0` -- Success
52
- - `1` -- Error
53
- - `2` -- Secrets found
54
-
55
- ## Learn More
56
-
57
- Package page and release notes: [https://www.npmjs.com/package/@blockyfy/stg-cli](https://www.npmjs.com/package/@blockyfy/stg-cli).
1
+ # @pretense/cli
2
+
3
+ AI firewall CLI that mutates proprietary code identifiers before sending to LLM APIs. Your code hits AI naked -- Pretense fixes that.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install -g @pretense/cli
9
+ ```
10
+
11
+ ## Quickstart
12
+
13
+ ```bash
14
+ # Initialize config in your project
15
+ pretense init
16
+
17
+ # Save a dashboard API key (read_write for mutation via proxy), or set PRETENSE_API_KEY
18
+ pretense login --key YOUR_KEY
19
+
20
+ # Start the proxy (default port 9339) — validates key before binding
21
+ pretense start
22
+
23
+ # Point your AI tools at the proxy
24
+ export ANTHROPIC_BASE_URL=http://localhost:9339
25
+ export OPENAI_BASE_URL=http://localhost:9339/v1
26
+
27
+ # Scan a file for identifiers and secrets
28
+ pretense scan src/
29
+
30
+ # Mutate a file and print to stdout
31
+ pretense mutate src/app.ts
32
+
33
+ # Reverse mutations using stored map
34
+ pretense reverse mutated-output.ts
35
+
36
+ # View audit log
37
+ pretense audit --json
38
+
39
+ # Plan / quota (live when backend reachable; falls back offline)
40
+ pretense status
41
+ ```
42
+
43
+ ## Commands
44
+
45
+ | Command | Description |
46
+ | --------------------------- | -------------------------------------------------------------- |
47
+ | `pretense init` | Scan cwd, create `.pretense/` config |
48
+ | `pretense login [--key …]` | Save dashboard API key to `~/.pretense/config.json` |
49
+ | `pretense logout` | Remove saved dashboard API key |
50
+ | `pretense start` | Validate key, start proxy on `:9339` |
51
+ | `pretense scan <file\|dir>` | Scan for identifiers + secrets |
52
+ | `pretense mutate <file>` | Redact scanner hits (secrets/PII), mutate identifiers → stdout |
53
+ | `pretense reverse <file>` | Reverse using stored map |
54
+ | `pretense audit` | Print audit log |
55
+ | `pretense status` | Plan, quota, usage (`usage` is an alias) |
56
+ | `pretense credits` | Remaining mutation budget (`tokens` is an alias) |
57
+ | `pretense upgrade` | Compare plans / upgrade |
58
+ | `pretense version` | Print version |
59
+
60
+ Env: **`PRETENSE_API_KEY`**, **`PRETENSE_API_URL`**, **`PRETENSE_API_TIMEOUT_MS`** (backend HTTP timeout, default 15s).
61
+
62
+ ## Exit Codes
63
+
64
+ - `0` -- Success
65
+ - `1` -- Error
66
+ - `2` -- Secrets found
67
+
68
+ ## Learn More
69
+
70
+ Visit [pretense.ai](https://pretense.ai) for documentation and enterprise features.