pi-studio 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to `pi-studio` are documented here.
+
+## [Unreleased]
+
+### Added
+- Single-workspace flow (no mode switching): always-on **Editor** pane + **Response** pane.
+- Explicit annotation scaffold action: **Insert annotation header** (upserts header and source metadata in-editor).
+- Clear top-level critique controls: **Critique editor text** + **Critique focus**.
+- Unified response actions:
+  - **Load response into editor** (for non-critique responses)
+  - **Load critique (notes)**
+  - **Load critique (full)**
+  - **Copy response**
+- Independent Markdown/Preview toggles for Editor and right pane.
+- `Auto-update response: On|Off` + `Get latest response` controls for terminal/editor-composability.
+- Source action: **Run editor text** to submit current editor text directly to the model.
+- Active-pane focus mode with keyboard shortcuts (`Cmd/Ctrl+Esc` or `F10` to toggle, `Esc` to exit), plus in-UI footer hint.
+- Theme-aware Studio browser palette derived from active pi theme tokens (bg/text/border/accent + status colors).
+- Server-side `pandoc` preview rendering endpoint for Studio panes (`gfm+tex_math_dollars` → HTML5 + MathML).
+- Math delimiter normalization before preview rendering for `\(...\)` and `\[...\]` syntax (fence-aware).
+- **Load file in editor** action in top controls (browser file picker into editor).
+- README screenshot gallery for dark/light workspace and critique/annotation views.
+
+### Changed
+- Removed Annotate/Critique tabs and related mode state.
+- Right pane now always shows the latest assistant output (reply or critique).
+- Response badge now reports response type + timestamp (`assistant response` / `assistant critique`).
+- Editor sync badge now tracks relation to latest response (`No response loaded`, `In sync with response`, `Edited since response`).
+- Footer continues to show explicit WS phase (`Connecting`, `Ready`, `Submitting`, `Disconnected`) alongside status text.
+- Running text and preparing annotated scaffolds are now separate explicit actions (no hidden header wrapping on send).
+- Critique-specific load actions now focus on notes/full views and are only shown for structured critique responses.
+- Studio still live-updates latest response when assistant output arrives outside studio requests (e.g., manual send from pi editor).
+- Preview pane typography/style now follows the higher-fidelity `/preview-browser` rendering style more closely.
+- Hardened Studio preview HTTP handling and added client-side preview-request timeout to avoid stuck "Rendering preview…" states.
+
+### Fixed
+- Studio boot blocker caused by unescaped preview HTML class-string quotes in inline script output.
+- `hydrateLatestAssistant` now infers response kind from hydrated markdown instead of reusing stale prior kind.
+- Added explicit `return` at end of `send_to_editor_request` handler for safer future handler additions.
+- `respondText` now includes `X-Content-Type-Options: nosniff` for consistency with JSON responses.
+- If `dompurify` is unavailable, preview now falls back to escaped plain markdown instead of injecting unsanitized HTML.
+- Preview sanitization now preserves MathML profile and strips MathML annotation tags to avoid duplicate raw TeX text beside rendered equations.
+
+## [0.1.0-alpha.1] - 2026-02-26
+
+Initial alpha baseline.
+
+### Added
+- `/studio` browser workflow with local HTTP + WebSocket server.
+- Startup modes: `/studio`, `/studio --last`, `/studio --blank`, `/studio <path>`.
+- Browser actions: **Apply Document**, **Save As**, **Save Over**, **Send to pi editor**, **Copy**.
+- Studio server controls: `/studio --status`, `/studio --stop`, `/studio --help`.
+- Source-state handling (blank / file / last response) and badge updates.
+
+### Changed
+- More robust loading of last assistant response from session state.
+- Initial document is server-rendered into the page for resilient preload behavior.
+- Last response auto-render now only applies when response appears structured for critique UI.
+- Improved status messaging for connection/format states.
+
+### Fixed
+- WebSocket reject-path HTTP line endings now use proper CRLF (`\r\n`).
+- Browser-side script escaping/runtime issues that could leave UI stuck at boot/connecting.
+- Section parsing logic hardened to avoid fragile regex escaping behavior.
+
+[0.1.0-alpha.1]: https://github.com/omaclaren/pi-studio/releases/tag/v0.1.0-alpha.1

package/README.md

@@ -0,0 +1,82 @@
+# pi-studio
+
+Experimental extension for [pi](https://github.com/badlogic/pi-mono) that opens a local browser workspace for annotating model responses/files, running edited prompts, and requesting critiques.
+
+Status: experimental alpha.
+
+## Screenshots
+
+**Dark workspace**
+
+![Dark workspace](./assets/screenshots/dark-workspace.png)
+
+**Dark critique flow**
+
+![Dark critique flow](./assets/screenshots/dark-critique.png)
+
+**Light workspace**
+
+![Light workspace](./assets/screenshots/light-workspace.png)
+
+**Dark annotation editing**
+
+![Dark annotation editing](./assets/screenshots/dark-annotation.png)
+
+## Features
+
+- Single workspace: Editor (left) + Response (right)
+- **Run editor text** sends editor content as-is
+- **Insert annotation header** adds/updates annotated-reply scaffold
+- **Critique editor text** requests structured critique (auto/writing/code focus)
+- Response load helpers:
+  - non-critique: **Load response into editor**
+  - critique: **Load critique (notes)** / **Load critique (full)**
+- File actions: **Save As…**, **Save Over**, **Load file in editor**
+- View toggles: `Editor: Markdown|Preview`, `Response: Markdown|Preview`
+- Theme-aware browser UI based on current pi theme
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/studio` | Open studio with last assistant response (fallback: blank) |
+| `/studio <path>` | Open studio with file preloaded |
+| `/studio --last` | Force load from last assistant response |
+| `/studio --blank` | Force blank editor start |
+| `/studio --status` | Show studio server status |
+| `/studio --stop` | Stop studio server |
+| `/studio --help` | Show command help |
+
+## Install
+
+From GitHub:
+
+```bash
+pi install https://github.com/omaclaren/pi-studio
+```
+
+From npm:
+
+```bash
+pi install npm:pi-studio
+```
+
+Run without installing:
+
+```bash
+pi -e https://github.com/omaclaren/pi-studio
+```
+
+## Notes
+
+- Local-only server (`127.0.0.1`) with rotating session tokens.
+- One studio request at a time.
+- Studio URLs include a token query parameter; avoid sharing full Studio URLs.
+- Preview panes render markdown via `pandoc` (`gfm+tex_math_dollars` → HTML5 + MathML), sanitized in-browser with `dompurify`.
+- Install pandoc for full preview rendering (`brew install pandoc` on macOS).
+- If `pandoc` is unavailable, preview falls back to plain markdown text with an inline warning.
+- Some screenshots may show the Grammarly browser widget. Grammarly is a separate browser extension and is not part of pi-studio, but it works alongside it.
+
+## License
+
+MIT

package/WORKFLOW.md

@@ -0,0 +1,105 @@
+# pi-studio workflow spec (v0.2 draft)
+
+## Goal
+
+Keep Studio simple while supporting both loops:
+
+1. **User → model feedback** (annotated reply)
+2. **Model → user critique** (structured critique package)
+
+Studio uses a **single workspace** (no tab/mode switching):
+- left pane: **Editor**
+- right pane: **Response**
+
+---
+
+## Core actions
+
+## 1) Insert annotation header (optional prep)
+
+Adds/updates an `annotated-reply` compatible scaffold in the editor:
+
+```md
+annotated reply below:
+original source: <last model response | file <path> | studio editor>
+
+---
+
+<your text>
+```
+
+Studio does **not** auto-send this scaffold; it is an explicit editor transform.
+
+## 2) Run editor text (plain send)
+
+Sends current editor text to the model unchanged.
+
+## 3) Critique editor text (structured review request)
+
+Critiques current editor text and expects/handles structured output:
+- `## Assessment`
+- `## Critiques` with `**C1**`, `**C2**`, ...
+- `## Document` with `{C1}`, `{C2}`, ... markers
+
+---
+
+## Response handling
+
+Right pane always shows the **latest assistant response** (reply or critique).
+
+When response is structured critique, Studio enables additional helpers:
+- **Load critique (notes)** (`## Assessment` + `## Critiques`)
+- **Load critique (full)** (`## Assessment` + `## Critiques` + `## Document`)
+
+For non-critique responses:
+- **Load response into editor**
+
+Always available:
+- **Copy response**
+
+---
+
+## State model (minimal)
+
+- `idle`
+- `submitting`
+- `error`
+
+Rules:
+- one in-flight request at a time
+- preserve editor draft across all actions
+- latest assistant message can be auto-followed or manually pulled
+
+---
+
+## Required UI elements
+
+- Header actions: **Save As…**, **Save Over** (file-backed), **Load file in editor**
+- Header view toggles: `Editor: Markdown|Preview`, `Response: Markdown|Preview`
+- Preview mode uses server-side `pandoc` rendering (math-aware) with plain-markdown fallback when renderer is unavailable.
+- Editor actions: **Insert annotation header**, **Run editor text**, **Critique editor text** (+ critique focus), **Send to pi editor**, **Copy editor**
+- Response actions include `Auto-update response: On|Off` + **Get latest response**
+- Source badge: `blank | last model response | file <path> | upload`
+- Response badge: `none | assistant response | assistant critique` (+ timestamp)
+- Sync badge: `No response loaded | In sync with response | Edited since response`
+- Footer WS/status phases: `Connecting`, `Ready`, `Submitting`, `Disconnected`
+
+---
+
+## Acceptance criteria
+
+1. `/studio --last` opens with editor loaded and no required mode selection.
+2. **Run editor text** sends the current editor content as-is and returns response to right pane.
+3. **Insert annotation header** updates the scaffold source metadata without duplicating headers.
+4. **Critique editor text** runs on current editor text and returns structured package when model complies.
+5. Structured critique helpers (`Load critique (notes)` / `Load critique (full)`) enable only when critique structure is present.
+6. Loading response/critique back into editor never loses draft unexpectedly.
+7. Terminal↔studio roundtrip remains intact (save, editor handoff, reopen).
+
+---
+
+## Non-goals (for now)
+
+- Multi-document tabs
+- Multi-user collaboration
+- Heavy schema validation