pageproof 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 0.1.2 - 2026-05-16
+
+- Updated the bundled Codex/Claude `SKILL.md`.
+
+## 0.1.1 - 2026-05-16
+
+- Renamed the package and other pieces to `pageproof`.
+
+## 0.1.0 - 2026-05-16
+
+- Initial npm release.

package/assets/SKILL.md

@@ -10,49 +10,54 @@ file. It handles footnotes and citations, and reloads automatically when the sou
 
 ## Opening a preview
 
-Use this skill when the user asks to preview a Markdown document.
-Always invoke in detached mode so the shell returns once the preview is up:
+When the user asks to preview a Markdown document, invoke this comment:
 ```sh
 pageproof --detached "FILE.md"
 ```
-It will launch a browser tab and start an HTTP server 
-on a random localhost port. It will also print a status URL.
+It will start an HTTP server on a random localhost port, and open a browser tab.
+On WSL, it will use `cmd.exe` to open the browser.
 
-If the user asks about errors in the document, fetch this printed status URL:
+The agent's sandbox must permit spawning the browser opener and making localhost HTTP
+requests. If either action is blocked, request approval/escalation with a short
+justification rather than treating the denial as a bug with the document or the pageproof command.
+
+The `pageproof` command will also print a status URL and a PID. Do not report these
+to the user, unless the user explicitly asks for them. They are intended for you to
+monitor the status of the document and the previewer so that you can help the user,
+they are not useful for the user directly.
+
+The server should automatically shut down when the user closes the browser tab.
+
+
+## Inspecting the status of the previewer
+
+If the user asks about errors in the document, fetch the printed status URL:
 ```sh
 curl http://localhost:<port>/status.json
 ```
 The status includes Pandoc warnings and errors for the current document.
 
+To check on the health of the server, either monitor the server's PID (which is printed on startup), or fetch `/status.json` which reports whether a browser is currently attached.
+
+To terminate the server, kill the PID that was printed at startup:
+```sh
+kill <PID>
+```
+
+
 ## Styles
 
-To choose a different document style, for example double-spaced output:
+If the user asks for a different document style, for example double-spaced output,
+terminate the server then restart it with the requested style, e.g.
 ```sh
 pageproof --detached --style=doublespaced FILE.md
 ```
 
-Use this to list available styles:
+To see a list available styles:
 ```sh
 pageproof --styles
 ```
 
-There are
-also options to specify the citation format. Use the CLI's `--citations` option
+This command also shows options to specify the citation format. Use the CLI's `--citations` option
 when the user asks for a specific citation style.
 
-## Permissions and lifecycle
-
-`pageproof` launches a browser tab and binds an HTTP server on a random localhost
-port. Under WSL the browser is opened via `cmd.exe`. 
-
-The sandbox must permit spawning the browser opener and making localhost HTTP
-requests. If either action is blocked, request approval/escalation with a short
-justification rather than treating the denial as a document or CLI bug.
-
-The server should automatically shut down when the user closes the browser tab.
-To check on the health of the server, either monitor the server's PID
-(which is printed on startup), or fetch `/status.json` which reports whether
-a browser is currently attached. To terminate the server, kill the printed PID:
-```sh
-kill <PID>
-```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pageproof",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Live Pandoc Markdown preview with paginated browser output.",
   "type": "module",
   "author": "Damon Wischik <djw1005@cam.ac.uk>",
@@ -21,6 +21,7 @@
     "bin/",
     "src/",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md"
   ],