@triclaps/cli 0.0.2 → 0.0.4
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 +17 -5
- package/adapters/hermes_claps_adapter.py +697 -0
- package/index.js +5557 -811
- package/package.json +3 -2
- package/skills/preview-gateway/SKILL.md +10 -1
package/package.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@triclaps/cli",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.4",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": {
|
|
6
|
-
"claps-cli": "
|
|
6
|
+
"claps-cli": "index.js"
|
|
7
7
|
},
|
|
8
8
|
"engines": {
|
|
9
9
|
"node": ">=22.0.0"
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
"files": [
|
|
13
13
|
"index.js",
|
|
14
14
|
"skills",
|
|
15
|
+
"adapters",
|
|
15
16
|
"README.md"
|
|
16
17
|
],
|
|
17
18
|
"dependencies": {
|
|
@@ -20,6 +20,7 @@ Run the app locally and confirm it responds before exposing it.
|
|
|
20
20
|
Run `claps-cli preview expose --app-slug my-app --port 8000`.
|
|
21
21
|
- Make sure `CLAPS_AGENT_TOKEN` is present first.
|
|
22
22
|
- Use a stable `app-slug` for repeated QA or design review runs.
|
|
23
|
+
- If you need to override the deployed gateway host, also set `CLAPS_GATEWAY_BASE_URL`.
|
|
23
24
|
|
|
24
25
|
3. Keep the tunnel open
|
|
25
26
|
The command registers the preview app with CLAPS, prints the public URL, and keeps the reverse tunnel alive for both HTTP and websocket traffic.
|
|
@@ -29,7 +30,13 @@ Use the returned gateway URL for browser testing, QA, or design review.
|
|
|
29
30
|
- After the URL is live, hand off to the relevant playbook such as `qa`, `design-review`, or `design-consultation`.
|
|
30
31
|
- If the preview is meant to support repo delivery, include the URL in task updates or review evidence.
|
|
31
32
|
|
|
32
|
-
5.
|
|
33
|
+
5. Inspect or clean up registrations
|
|
34
|
+
Use the lifecycle commands when you need to verify or close a preview registration.
|
|
35
|
+
- `claps-cli preview list` shows the registered preview apps for the current actor.
|
|
36
|
+
- `claps-cli preview status --app-id <id>` shows whether the gateway currently sees the reverse tunnel as online or offline.
|
|
37
|
+
- `claps-cli preview remove --app-id <id>` removes a stale registration after the preview is no longer needed.
|
|
38
|
+
|
|
39
|
+
6. Stop the preview
|
|
33
40
|
Terminate the command when you no longer want the preview to be reachable.
|
|
34
41
|
|
|
35
42
|
## Validation checklist
|
|
@@ -38,6 +45,7 @@ Before treating the preview as usable, confirm all of the following:
|
|
|
38
45
|
|
|
39
46
|
- the local app is reachable on the expected host and port
|
|
40
47
|
- `claps-cli preview expose ...` prints a public URL without auth or registration errors
|
|
48
|
+
- `claps-cli preview list` or `preview status` shows the registration you just created
|
|
41
49
|
- the public URL loads the intended page, not just the tunnel landing response
|
|
42
50
|
- websocket features still work if the app depends on them
|
|
43
51
|
|
|
@@ -46,4 +54,5 @@ Before treating the preview as usable, confirm all of the following:
|
|
|
46
54
|
- Missing `CLAPS_AGENT_TOKEN`, which prevents preview registration entirely
|
|
47
55
|
- Exposing the wrong port or host, especially when the app is not actually listening on `127.0.0.1`
|
|
48
56
|
- Closing the CLI process and forgetting that the preview URL dies with it
|
|
57
|
+
- Forgetting to remove stale preview registrations after the tunnel process is gone
|
|
49
58
|
- Sharing the URL before checking that the tunneled page matches the local app state
|