getgloss 0.5.0 → 0.7.0

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.
Files changed (16) hide show
  1. package/README.md +8 -11
  2. package/dist/cli/index.js +404 -184
  3. package/dist/cli/index.js.map +1 -1
  4. package/dist/server/daemon.js +360 -169
  5. package/dist/server/daemon.js.map +1 -1
  6. package/dist/web/assets/{index-rvNgmEHK.css → index-BsRo7I09.css} +1 -1
  7. package/dist/web/assets/index-DDsgJ3zo.js +179 -0
  8. package/dist/web/gloss-demo-captions.vtt +16 -0
  9. package/dist/web/gloss-demo-poster.jpg +0 -0
  10. package/dist/web/gloss-demo.mp4 +0 -0
  11. package/dist/web/index.html +2 -2
  12. package/dist/web/setup/index.html +11 -0
  13. package/dist/web/setup.md +5 -0
  14. package/package.json +24 -24
  15. package/skill/SKILL.md +31 -5
  16. package/dist/web/assets/index-AW7l4N7K.js +0 -188
package/dist/web/gloss-demo-captions.vtt ADDED
@@ -0,0 +1,16 @@
1
+ WEBVTT
2
+
3
+ 00:00:00.000 --> 00:00:15.000
4
+ Gloss opens the working tree diff in a local browser review.
5
+
6
+ 00:00:15.000 --> 00:00:35.000
7
+ The reviewer scans the changed files and leaves comments on the diff.
8
+
9
+ 00:00:35.000 --> 00:00:55.000
10
+ Gloss keeps the agent waiting while the browser review is in progress.
11
+
12
+ 00:00:55.000 --> 00:01:20.000
13
+ Submitted feedback is written back to the local review files for the agent.
14
+
15
+ 00:01:20.000 --> 00:01:53.727
16
+ The agent can read the comments, apply the requested fixes, and validate the result.
package/dist/web/gloss-demo-poster.jpg ADDED
Binary file
package/dist/web/gloss-demo.mp4 ADDED
Binary file
package/dist/web/index.html CHANGED
@@ -28,8 +28,8 @@
28
28
  content="Comment on local code diffs and save feedback in your repo."
29
29
  />
30
30
  <meta name="twitter:image" content="https://getgloss.dev/og.png" />
31
- <script type="module" crossorigin src="/assets/index-AW7l4N7K.js"></script>
32
- <link rel="stylesheet" crossorigin href="/assets/index-rvNgmEHK.css">
31
+ <script type="module" crossorigin src="/assets/index-DDsgJ3zo.js"></script>
32
+ <link rel="stylesheet" crossorigin href="/assets/index-BsRo7I09.css">
33
33
  </head>
34
34
  <body>
35
35
  <div id="root"></div>
package/dist/web/setup/index.html CHANGED
@@ -258,6 +258,13 @@
258
258
  6. Optionally mark individual comments handled:
259
259
  gloss resolve &lt;reviewId&gt; --comment &lt;commentId&gt; --summary "&lt;what changed&gt;"
260
260
  7. Run gloss resolve &lt;reviewId&gt; --summary "&lt;what changed&gt;", then summarize what changed.</pre>
261
+ <p>
262
+ Browser review shortcuts:
263
+ </p>
264
+ <ul>
265
+ <li><code>Command+Enter</code> saves the active draft comment.</li>
266
+ <li><code>Command+Shift+Enter</code> submits already-saved comments.</li>
267
+ </ul>
261
268
  </section>
262
269
 
263
270
  <section>
@@ -278,6 +285,10 @@
278
285
  Leave the command running. Gloss exits after the browser review is submitted and writes
279
286
  feedback under <code>~/.gloss/reviews/&lt;reviewId&gt;/</code>.
280
287
  </p>
288
+ <p>
289
+ In the browser review, <code>Command+Enter</code> saves the active draft comment and
290
+ <code>Command+Shift+Enter</code> submits already-saved comments.
291
+ </p>
281
292
  <p>Start a fresh session with the same command for follow-up diffs.</p>
282
293
  </section>
283
294
 
package/dist/web/setup.md CHANGED
@@ -60,6 +60,11 @@ The skill pairs the CLI with the browser app:
60
60
  7. Run `gloss resolve <reviewId> --summary "<what changed>"`, then summarize
61
61
  what changed.
62
62
 
63
+ Browser review shortcuts:
64
+
65
+ - `Command+Enter` saves the active draft comment.
66
+ - `Command+Shift+Enter` submits the review with already-saved comments.
67
+
63
68
  ## Update Your Persistent Instructions
64
69
 
65
70
  Add Gloss guidance to the persistent instruction file this agent will actually
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "getgloss",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "Local browser-based diff review for coding-agent loops.",
5
5
  "type": "module",
6
6
  "packageManager": "pnpm@10.33.2",
@@ -30,31 +30,31 @@
30
30
  "node": ">=20"
31
31
  },
32
32
  "dependencies": {
33
- "@hono/node-server": "^1.14.4",
34
- "@pierre/diffs": "^1.2.1",
35
- "@tailwindcss/vite": "^4.1.7",
36
- "commander": "^14.0.0",
37
- "execa": "^9.5.3",
38
- "get-port": "^7.1.0",
39
- "hono": "^4.7.10",
40
- "lucide-react": "^1.16.0",
41
- "open": "^10.1.2",
42
- "react": "^19.1.0",
43
- "react-dom": "^19.1.0",
44
- "ulid": "^3.0.0",
45
- "zustand": "^5.0.5"
33
+ "@hono/node-server": "1.19.14",
34
+ "@tailwindcss/vite": "4.3.0",
35
+ "commander": "14.0.3",
36
+ "execa": "9.6.1",
37
+ "get-port": "7.2.0",
38
+ "hono": "4.12.21",
39
+ "lucide-react": "1.16.0",
40
+ "open": "10.2.0",
41
+ "react": "19.2.6",
42
+ "react-dom": "19.2.6",
43
+ "ulid": "3.0.2",
44
+ "zustand": "5.0.13"
46
45
  },
47
46
  "devDependencies": {
48
- "@biomejs/biome": "^2.0.6",
49
- "@types/node": "^24.0.1",
50
- "@types/react": "^19.1.6",
51
- "@types/react-dom": "^19.1.5",
52
- "@vitejs/plugin-react": "^4.5.2",
53
- "tsup": "^8.5.0",
54
- "tsx": "^4.20.3",
55
- "typescript": "^5.8.3",
56
- "vite": "^6.3.5",
57
- "vitest": "^3.2.3"
47
+ "@biomejs/biome": "2.4.15",
48
+ "@types/node": "24.12.4",
49
+ "@types/react": "19.2.15",
50
+ "@types/react-dom": "19.2.3",
51
+ "@vitejs/plugin-react": "4.7.0",
52
+ "tailwindcss": "4.3.0",
53
+ "tsup": "8.5.1",
54
+ "tsx": "4.22.3",
55
+ "typescript": "5.9.3",
56
+ "vite": "6.4.2",
57
+ "vitest": "3.2.4"
58
58
  },
59
59
  "keywords": [
60
60
  "diff",
package/skill/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gloss
3
- description: Open local working-tree or branch changes in Gloss for browser review, wait for submitted feedback, and address returned comments. Use when the user asks to review local code changes, says "gloss this" or "open Gloss", wants to inspect a browser diff, or wants comments handled before a PR.
3
+ description: Open local working-tree or branch changes in Gloss for browser review, wait for submitted feedback, and address returned comments or discuss them before editing. Use when the user asks to review local code changes, says "gloss this" or "open Gloss", wants to inspect a browser diff, wants comments handled before a PR, or asks to discuss/propose feedback fixes first.
4
4
  ---
5
5
 
6
6
  # Gloss
@@ -10,10 +10,36 @@ description: Open local working-tree or branch changes in Gloss for browser revi
10
10
  1. Run `gloss open --json` from the repo root unless the user names a base ref.
11
11
  2. Leave the command running. It blocks until the browser review is submitted.
12
12
  3. Parse the JSON output and read `feedbackPath` when present.
13
- 4. Address every comment in file and line order.
14
- 5. Validate the fix with the narrowest relevant checks.
15
- 6. When useful, run `gloss resolve <reviewId> --comment <commentId> --summary "<what changed>"` as each comment is handled.
16
- 7. Run `gloss resolve <reviewId> --summary "<what changed>"`, then summarize the feedback addressed and validation performed.
13
+ 4. Decide the mode (see "Discussion Mode" below). Default is apply-directly.
14
+ 5. Address every comment in file and line order, or per the discussion plan.
15
+ 6. Validate the fix with the narrowest relevant checks.
16
+ 7. When useful, run `gloss resolve <reviewId> --comment <commentId> --summary "<what changed>"` as each comment is handled.
17
+ 8. Run `gloss resolve <reviewId> --summary "<what changed>"`, then summarize the feedback addressed and validation performed.
18
+
19
+ ## Discussion Mode
20
+
21
+ Some feedback is ambiguous, opinionated, or wide-reaching enough that the right
22
+ move is to talk through it before editing code. Enter discussion mode when any
23
+ of these are true:
24
+
25
+ - The user asked for it before running gloss — phrases like "discuss first",
26
+ "talk through it", "don't apply yet", "let's discuss", "review the comments
27
+ with me", or "propose first".
28
+ - A comment is genuinely ambiguous and you'd otherwise have to guess intent.
29
+
30
+ When in discussion mode:
31
+
32
+ 1. Read every comment in `feedback.json` first. Do not edit any files yet.
33
+ 2. Group comments by file. For each, restate the comment in one line and
34
+ propose how you'd address it — the approach plus the lines that would
35
+ change. Flag any that conflict, are out of scope, or need a decision.
36
+ 3. Ask the user which to apply, modify, or skip. Wait for an answer.
37
+ 4. Apply only what's approved. Skip or defer the rest, and note skipped items
38
+ in the resolution summary so they aren't silently dropped.
39
+ 5. Validate, then resolve as usual.
40
+
41
+ Default (no discussion request and no ambiguous comments): the current
42
+ apply-directly workflow.
17
43
 
18
44
  Feedback is stored under `~/.gloss/reviews/<reviewId>/`:
19
45