stilura 0.0.0-stage → 0.6.1

package/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+Stilura (renamed from Litura) follows [semantic versioning](https://semver.org). Until 1.0 the minor number carries breaking changes.
+
+## Unreleased
+
+- Fixed cross-document Undo and saves from concurrent tabs. File writes now keep revision checks and history; workspace APIs reject symbolic links.
+- Desktop state survives server port changes. Closing, changing folders, and installing updates wait for confirmed saves. Partial brief answers survive reloads, and Save as falls back to a download where the system file-picker API is unavailable.
+
+- Renamed Litura → Stilura (*stilus*, the pen, + *litura*, the correction): npm package `stilura`, commands `stilura` / `stilura-mcp`, desktop app, skill (`skills/stilura`), and all user-facing strings. `STILURA_*` environment variables replace `LITURA_*` (old spellings still honored). The GitHub repo, release URLs, and the Tauri bundle identifier move with the name — reinstall the desktop app from the new releases page; its saved folder choice does not carry over. Browser drafts, `style.md`, and disk history (`.litura-history`, `litura:` storage keys, `<litura-edits>` tags) are untouched and keep working.
+
+## 0.6.0 — 2026-10-09
+
+- Litura now works alongside coding agents. `litura-mcp` (also `mcp-server.mjs`) is a stdio MCP server with seven tools — `draft_read`, `draft_write`, `review`, `rewrite`, `suggest`, `chat`, `idea` — that reuse the editor's own prompts; only `draft_write` changes anything, under the same revision guard as `PUT /draft`. A ready-made skill ships in `skills/litura/SKILL.md` with the voice rules, finding codes and the localhost API, for Codex CLI and Claude Code.
+- Continuations use their own suggestion model, chosen in Settings. It defaults to the cheapest authenticated model that writes well, with reasoning off; review, rewrites, chat and `/idea` keep the default model.
+- Settings offers ChatGPT Plus/Pro sign-in as an alternative to an API key, with a note that subscriptions count messages and automatic checks send many small requests.
+- The bubble's `Add to context` is now `Discuss`, matching the button on finding cards. After `Discuss` the paragraph `+` is available again: the passage stays selected, and that no longer hides it.
+- Markdown in the draft stays plain text: markers remain, dimmed, and what they mark is styled in place. Headings set bold, `**bold**`, `*italic*`, `_italic_` and `***both***` follow suit, `` `code` `` gets a quiet background, `[links](url)` an accent underline, `>` lines are muted, list markers dimmed and `---` carries a thin rule. Fenced blocks and inline code are left unparsed.
+- The draft sets larger (17px) on a 68-character measure. Margin notes are written in the draft's own italic, sit on the passage's baseline and open as a single line with no background. The conversation island now morphs its outline between the pill, the composer and a notice, notices are pill-sized and wait eight seconds (longer under the pointer), and `Suggesting…` shows in the folded pill instead of vanishing with the composer.
+- The paragraph `+` stands on the line under the pointer instead of a long paragraph's first line, stays up while a bubble is open, and on a paragraph that already has a note opens that note. The selection and Continue bubbles wait a beat (250 and 450 ms) and never appear if you type or click again first; every bubble fades in and out.
+- A margin note now stands on the line it was made at — its passage, or the line its `+` was pressed beside — instead of at the top of a long paragraph, and the `+` is no longer offered beside a line a note already covers. Retrying a failed draft load no longer duplicates the restored notes.
+- Notes in the margin no longer overlap: the rail cards were positioned relative to their normal place instead of the rail, and now also restack when a note grows. The conversation island sits 16px higher.
+- Experiment, Settings → While you write → Actions in the margin: `Note` and `Discuss` stand in the notes rail beside the selected line, and `Continue` sits right after the caret with its `⌘↵` hint, instead of floating over the text. Falls back to the floating bubble where there is no rail.
+- With a conversation open, the turns and the field now stand inside one opaque panel (near-black in dark mode) instead of floating over the draft, and the fade behind the island is gone. Notes in the margin no longer get cut at the header: the rail reaches the window top like the draft's lines do.
+- The text column now narrows (down to 52 characters) before margin notes give up their rail, so notes stay beside their lines on a 1100px pane instead of dropping into the chat.
+- The delete `×` on a margin note stands right after its last word instead of a box corner, and the paragraph `+` shows on a freshly loaded page without waiting for a resize.
+- A notice now takes over the whole island: the turns, finding cards and `×` above it are put away while it stands and come back when it goes, instead of hanging over an alert.
+- The draft no longer slides left when it grows past the window and a scrollbar appears (for instance when a note is added): the gutter is reserved on both edges.
+- Margin notes, slice 1: select a passage and press `Note` in the bubble to pin your own remark beside the line — plain text on the margin, no card chrome, blur commits and `Escape` drops, no Save/Cancel. Hover the empty margin beside a paragraph for its `+` (a paragraph note, never drifts); select all and press `Note` for the whole draft (pinned at the rail top, no mark). Notes stand in the margin rail on wide windows and stack in the chat stream on narrow ones. Create, edit, delete with Undo; notes persist per file. Notes go to the model with chat and rewrite requests as labeled scope context. No threads yet.
+
+## 0.5.0 — 2026-09-27
+
+- A file sidebar lists the `.md` and `.txt` files beside the draft, with a filter. Clicking one opens it; the previous text goes to History first. New, Open, Save as and History moved there from the header. The sidebar starts hidden.
+- `Save as new` uses the system save dialog.
+- Icons are now Tabler outline at a thinner stroke, resting dim and full on hover.
+- Provider errors such as an exceeded quota are shown as their message instead of raw JSON.
+- The chosen model survives restarts, even while it is missing from the current catalog.
+- The desktop app opens at once: it no longer fetches the model catalog on startup.
+
+## 0.4.2 — 2026-09-13
+
+- Clicking at the end of a paragraph now offers a Continue bubble, asking for the same continuation Cmd/Ctrl+Enter would. An explicit ask is allowed to open the next sentence and run longer than a background suggestion, instead of stopping at a finished thought.
+- Fixed the field popovers flashing at their previous position before snapping to the trigger.
+- Removed the unused standalone Rewrite button from the chat chip.
+
+## 0.4.0 — 2026-09-13
+
+- Added spell checking. Misspelled words are marked in the editor using a vendored en_US Hunspell dictionary, checked client-side alongside the existing style-tell markers.
+
+## 0.3.7 — 2026-09-13
+
+- Litura is now also a desktop app. A Tauri shell picks the writing folder, starts the same server on a free port, and shows it in its own window; it carries its own Node runtime, so nothing has to be installed first.
+- The review panel is one list again. Wording marks and review findings sat in separate sections repeating the same reason on every row; now they share a single list in document order, each row naming the passage and where the remark came from, with the reason on the card a click away. The header button says how many remarks are waiting instead of a bare number.
+- The desktop app updates itself: it asks GitHub on launch and from `Check for Updates…`, installs only what you accept and what its signing key verifies, and restarts. In that build the npm update switch is gone, since it would name a second, wrong way to update.
+
+## 0.3.6 — 2026-09-07
+
+- Published the latest editor interface and behavior updates together with the product audit and local draft history.
+
+## 0.3.5 — 2026-09-07
+
+- Refreshed the README preview with natural generic-writing highlights and meaningful rewrite options in a full-screen review flow.
+
+## 0.3.4 — 2026-09-07
+
+- Refreshed the README preview with a full-screen Litura review flow and three rewrite options.
+
+## 0.3.3 — 2026-09-07
+
+- Refreshed the README preview with a full-screen editor screenshot showing review marks and inline continuation.
+
+## 0.3.2 — 2026-09-07
+
+- Moved the Slop Score next to the settings control in the editor header.
+
+## 0.3.1 — 2026-09-07
+
+- The update badge now copies `npx litura-app` instead of opening a changelog, so the next update command is ready to paste.
+
+## 0.3.0 — 2026-09-07
+
+- Review remarks stay beside the passage they describe without shifting the draft when opened or clicked.
+- Added document actions and local history, replace-in-place previews, light/dark appearance settings, and automatic settings saves.
+- Refined the editor header, chat composer, settings controls, and release safety checks.
+
+## 0.2.0 — 2026-09-06
+
+- Settings can ask npm about new versions once a day, off by default. When a newer version is published the header shows a badge linking to this file; the badge links rather than installs, so updating stays a command you run. Left off, Litura opens no connection of its own.
+- Releases are cut by tag, with GitHub Actions running the checks and publishing over OIDC.
+
+## 0.1.0 — 2026-09-06
+
+First npm release, published as `litura-app`; the command it installs is `litura`.
+
+- Run from any folder with `npx litura-app`. The draft and the style guide are read from the folder Litura starts in, not from its install directory.
+- The browser opens on start, and a taken port falls through to the next free one.
+- `litura --version` and `litura --check-update` report the running and published versions. Litura opens no connection of its own.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vadim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,101 @@
-# Temporary Holding Version
+<img src="public/logo-tile.png" alt="Stilura mark" width="72">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Stilura
+
+Local AI writing enhancer that writes with you. It highlights generic, AI-sounding phrases in your draft, names the pattern, and offers rewrites. Nothing changes until you pick one.
+
+```bash
+npx stilura
+```
+
+![Stilura highlighting sales language, a "not X but Y" construction and a forced triple, with a finding card open](docs/screenshot.png)
+## How it works
+
+Stilura checks your draft against 20 named patterns in `style.md`: sales language, vague attribution, forced triples, filler openers, stacked qualifiers, and more. A second pass catches structural issues like buried points and broken paragraph promises.
+
+- **Options** — three rewrites for any finding. Hover to preview, click to apply.
+- **Discuss** — chat about a passage or the whole draft.
+- **Brief** (`/brief`) — tell it who reads this and what it should do. Rewrites aim at that reader; review stays unbiased.
+- **Continuations** — short next-line suggestions appear when you pause. `Tab` to accept, `Escape` to dismiss.
+
+Click the count in the header to see all findings. `F8` / `Shift+F8` to step between them. `Keep as is` dismisses one for good.
+
+## Run
+
+```bash
+npx stilura
+```
+
+Needs Node 20+. Opens [http://127.0.0.1:3000](http://127.0.0.1:3000). Choose a provider and model under the gear button.
+
+**Desktop:** download from [Releases](https://github.com/vadimchirkov/stilura/releases) (`.dmg` / `.exe` / `.AppImage` / `.deb`). On macOS, unsigned: `System Settings → Privacy & Security → Open Anyway` on first launch.
+
+**Shortcuts:** `Cmd/Ctrl+K` — chat. `Cmd/Ctrl+Enter` — continuation. `Cmd/Ctrl+S` — download draft. `/` in composer — commands.
+
+## Configuration
+
+Use the gear button to choose a provider, model, and reasoning level. Stilura also finds credentials stored by Pi and provider environment variables. ChatGPT Plus/Pro sign-in works as an alternative to an API key.
+
+```bash
+PI_PROVIDER=anthropic
+PI_MODEL=claude-sonnet-4-6
+PI_THINKING_LEVEL=medium
+PORT=3000
+STYLE_FILE=./style.md
+DRAFT_FILE=./draft.md
+```
+
+Edit `style.md` to describe the voice and constraints to preserve. Changes apply without restarting.
+
+## Data
+
+The draft lives in `draft.md` in your folder. Findings, chat, brief, and model choice live in browser local storage. Nothing leaves the machine except model requests to the provider you chose.
+
+The desktop app saves state under its application data directory, so changing ports does not reset it. Updates check GitHub on launch; accepting verifies the bundle against a signing key and restarts.
+
+## Agent integration
+
+The draft is a plain file, and the server exposes what the UI uses as HTTP endpoints. A skill for Claude Code / Codex ships in `skills/stilura/SKILL.md`:
+
+```bash
+cp -r skills/stilura ~/.claude/skills/
+```
+
+### MCP server
+
+Seven stdio tools — `draft_read`, `draft_write`, `review`, `rewrite`, `suggest`, `chat`, `idea` — in `mcp-server.mjs`. Same prompts as the editor, same revision guard.
+
+```bash
+# Claude Code
+claude mcp add --scope user stilura -- node /path/to/stilura/mcp-server.mjs
+```
+
+```toml
+# Codex: ~/.codex/config.toml
+[mcp_servers.stilura]
+command = "node"
+args = ["/path/to/stilura/mcp-server.mjs"]
+cwd = "/path/to/writing"
+tool_timeout_sec = 180
+```
+
+## Development
+
+```bash
+git clone https://github.com/vadimchirkov/stilura.git
+cd stilura && npm install && npm start
+```
+
+Node native HTTP server. Vanilla JS frontend with CodeMirror 6, bundled by esbuild (`src/app.js` → `public/app.js`).
+
+```bash
+npm run build       # bundle frontend
+npm run check       # lint + tests
+npm run desktop     # Tauri desktop shell (needs Rust + Tauri prerequisites)
+```
+
+See [SPEC.md](SPEC.md) for API contracts and behavior details.
+
+## License
+
+[MIT](LICENSE)