@ranganathmk/trq 0.1.0

package/README.md

@@ -0,0 +1,61 @@
+# trq
+
+Record browser sessions, replay them, resume mid-session. CLI + Electron GUI in one install.
+
+## Install
+
+```bash
+npm install -g trq
+```
+
+This installs the `trq` binary globally and pulls Electron + Puppeteer as runtime dependencies.
+
+## CLI
+
+```bash
+trq new my-flow --url https://example.com    # start recording a new session
+trq list                                      # list all sessions
+trq show my-flow                              # print recorded events
+trq play my-flow                              # replay end-to-end (headful Chrome)
+trq play my-flow --to 5 --slow                # replay up to step 5, slowly
+trq resume my-flow                            # replay then keep recording from the end
+trq config show my-flow                       # inspect the session's config.json
+trq config set my-flow viewport '{"width":1280,"height":720}'
+trq config unset my-flow viewport
+trq studio                                    # launch the Electron GUI
+trq --help
+```
+
+## Studio (GUI)
+
+```bash
+trq studio
+```
+
+Opens the Electron desktop app with:
+
+- Session sidebar + record / play / resume / debug controls
+- Live events log with right-click edit / delete / insert / branch
+- Element inspector with selector ladder + quality badges
+- Pause-at-failure UI: retry / skip / edit / stop on a step failure, with auto-suggested fresh selectors
+
+## Sessions
+
+Stored in `./sessions/` by default. Override with:
+
+```bash
+TRQ_SESSIONS_DIR=/path/to/dir trq list
+```
+
+## Environment variables
+
+| Var | Effect |
+|---|---|
+| `TRQ_SESSIONS_DIR` | Override session storage dir. Default: `$CWD/sessions`. |
+| `TRQ_DEBUG_REPLAY` | When set, print per-step URL log + page-side selector-resolve diagnostics. |
+| `TRQ_DEBUG_CDP` | Mirror raw CDP traffic to stdout. |
+| `TRQ_DEBUG_LAYOUT` | Print BrowserView layout reflows. |
+
+## License
+
+MIT

package/bin/trq.mjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// trq CLI entry. Imports the bundled @trq/core dispatcher from dist/cli.mjs
+// (produced by packages/cli/build.mjs) so the published `trq` package is
+// fully self-contained — no separate @trq/core registry entry needed.
+//
+// Sets TRQ_STUDIO_PATH so the `studio` subcommand knows where the bundled
+// Electron app lives inside this package, regardless of where npm placed
+// it on a global install.
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const here = path.dirname(fileURLToPath(import.meta.url));
+process.env.TRQ_STUDIO_PATH = process.env.TRQ_STUDIO_PATH
+  ?? path.resolve(here, '../dist/studio');
+await import('../dist/cli.mjs');