getgloss 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Raj Joshi
+
+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

@@ -0,0 +1,109 @@
+# Gloss
+
+Gloss is a local browser review loop for coding agents. It captures your current
+git diff, opens a localhost review UI, lets you attach comments to changed
+lines or ranges, and writes structured feedback back into the repo for an
+agent to re-ingest.
+
+## Install
+
+```bash
+npm install -g getgloss
+gloss open --base HEAD --json
+```
+
+For one-off use:
+
+```bash
+npx getgloss open --base HEAD --json
+```
+
+For agent setup, use the Roughdraft-style prompt:
+
+```text
+Install Gloss for me using `npm i -g getgloss`, then read https://getgloss.dev/setup.md and set yourself up to use it.
+```
+
+The hosted install script is npm-only:
+
+```bash
+curl -fsSL https://getgloss.dev/install.sh | sh
+```
+
+## Commands
+
+```text
+gloss open [--base <ref>] [--print-url] [--no-open] [--json] [--no-watch] [--timeout <s>]
+gloss watch <reviewId>
+gloss start [--port <port>]
+gloss status
+gloss stop
+gloss mcp
+gloss doctor
+```
+
+`gloss open` lazy-starts a background server, captures tracked and untracked
+changes against the base ref, registers a review session, opens
+`http://localhost:<port>/review/<reviewId>`, and waits for submission unless
+`--no-watch` is passed.
+
+## Feedback Files
+
+Completed reviews are written to:
+
+```text
+<repo>/.gloss/reviews/<reviewId>/
+  meta.json
+  diff.json
+  feedback.json
+  feedback.md
+  original/
+```
+
+`feedback.json` is the agent-friendly source of truth. `feedback.md` is a
+human-readable summary ordered by file and line.
+
+## MCP
+
+`gloss mcp` starts a stdio MCP server exposing:
+
+- `list_pending_reviews`
+- `get_review`
+- `watch_review`
+- `get_review_feedback`
+- `mark_review_resolved`
+
+The MCP process talks to the same localhost server as the CLI.
+
+## Development
+
+```bash
+pnpm dev:web
+pnpm build
+pnpm test
+pnpm check
+pnpm setup
+```
+
+`pnpm setup` creates a per-worktree wrapper in `~/.local/bin` named
+`gloss-dev-<worktree>`, using an isolated state dir under `~/.gloss/dev/`.
+
+## Release Flow
+
+Releases follow Willow's tag-driven shape:
+
+1. Push a tag like `v0.1.0`.
+2. GitHub Actions runs checks, tests, and the production build.
+3. The package is published to npm as `getgloss`.
+4. A GitHub release is created with `npm pack` output and checksums.
+
+Required repository secrets:
+
+- `NPM_TOKEN`
+
+## Notes
+
+Gloss uses `@pierre/diffs` for diff parsing/rendering integration points and
+skins the browser chrome for the local review workflow. The package is
+Apache-2.0 licensed, which is compatible with this MIT project but worth
+calling out before publication.