open-ready 0.1.69 → 0.1.71
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/CLAUDE.md +24 -0
- package/package.json +1 -1
package/CLAUDE.md
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# CLAUDE.md — `open-ready` (`packages/open-when-ready`)
|
|
2
|
+
|
|
3
|
+
**npm name:** `open-ready` · **skill:** [`skills/open-ready`](../../skills/open-ready/SKILL.md)
|
|
4
|
+
· **runner:** Vitest · **build:** none — `open-when-ready.mjs` ships as-is
|
|
5
|
+
|
|
6
|
+
Wraps a dev server: watches its output, opens the browser when it reports
|
|
7
|
+
ready, and on an error runs an AI search for the message instead.
|
|
8
|
+
|
|
9
|
+
## The hard part is detection
|
|
10
|
+
|
|
11
|
+
Ready/error detection is pattern-matching against other tools' stdout, which
|
|
12
|
+
changes when they upgrade. So:
|
|
13
|
+
|
|
14
|
+
- **A missed "ready" is worse than a late one** — never open the browser
|
|
15
|
+
speculatively on a timer if a pattern didn't match; that is how users get a
|
|
16
|
+
blank tab.
|
|
17
|
+
- Keep the pass-through faithful: the wrapped process's stdout/stderr, exit
|
|
18
|
+
code and signals must reach the user unchanged. A wrapper that swallows an
|
|
19
|
+
exit code breaks every script that calls it.
|
|
20
|
+
- New framework patterns go in the existing pattern table, not in a new branch.
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
cd packages/open-when-ready && bun run test
|
|
24
|
+
```
|