diffs-pane 0.1.0

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "diffs-pane",
+  "version": "0.1.0",
+  "description": "Standalone live diff viewer and review pane for Git and jj working trees. Outputs authenticated localhost URLs.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=24.0.0",
+    "pnpm": ">=11.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itsmingjie/diffs-pane.git"
+  },
+  "bugs": {
+    "url": "https://github.com/itsmingjie/diffs-pane/issues"
+  },
+  "homepage": "https://github.com/itsmingjie/diffs-pane#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "dp": "./bin/dp.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "extension",
+    "skills",
+    "ui/fonts/CommitMono-LICENSE.txt",
+    "ui/fonts/Geist-LICENSE.txt",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@parcel/watcher": "^2.6.0"
+  },
+  "devDependencies": {
+    "@fontsource-variable/geist": "^5.3.0",
+    "@pierre/diffs": "1.2.12",
+    "@pierre/trees": "1.0.0-beta.5",
+    "@radix-ui/react-icons": "^1.3.2",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "oxfmt": "^0.60.0",
+    "oxlint": "^1.75.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "pnpm run build:server && pnpm run build:ui",
+    "build:server": "tsc -p tsconfig.server.json",
+    "build:ui": "vite build",
+    "dev:ui": "vite",
+    "dev:sample": "pnpm run build && node scripts/dev-sample.js",
+    "dev:sample:stop": "node scripts/dev-sample.js --stop",
+    "typecheck": "tsc -p tsconfig.server.json --noEmit && tsc -p tsconfig.ui.json --noEmit",
+    "lint": "oxlint --max-warnings 0 src ui/src extension test scripts",
+    "format": "oxfmt src ui/src extension test scripts bin",
+    "format:check": "oxfmt --check src ui/src extension test scripts bin",
+    "release": "node scripts/release.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/skills/diffs-pane/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: diffs-pane
+description: Live diff review between humans and coding agents with the dp CLI. Use when asked to open or share a diff viewer, review working-tree changes, read or address inline feedback, resolve review comments, or show changes from the latest agent turn.
+license: Apache-2.0
+compatibility: Requires Node.js 24+, the dp executable, and a Git or jj working tree.
+---
+
+# diffs-pane
+
+`dp` gives humans a live browser view of an agent’s working-tree changes. Humans
+leave inline comments; agents read them from the CLI, fix the code, and resolve
+only the feedback they addressed.
+
+Install: `pnpm add --global diffs-pane`
+
+## Start here
+
+From the repository being reviewed:
+
+```sh
+dp watch
+```
+
+The command prints one authenticated localhost URL. Share it with the user. The
+viewer follows filesystem changes automatically, so do not rerun `dp watch`
+after every edit and do not repeatedly print the URL.
+
+Useful variants:
+
+```sh
+dp watch branch                            # full branch diff (default)
+dp watch unstaged                          # worktree diff
+dp watch turn                              # changes since turn start
+dp watch --root /path/to/repo --base main
+dp watch --owner <integration-name>         # hold an integration lease
+dp watch --no-watch                         # static viewer without live updates
+```
+
+## Review workflow
+
+When the user asks to address review comments:
+
+1. Read the current feedback. This is non-destructive and safe to repeat.
+
+   ```sh
+   dp reviews
+   dp reviews --json
+   ```
+
+   Text output uses blocks such as:
+
+   ```text
+   <File>src/app.ts:12-15 (additions, branch)</File>
+   <Comment>
+   Extract this into a helper.
+   </Comment>
+   <Diff>
+   @@ -10,6 +10,9 @@ function main() {
+    ...
+   </Diff>
+   ```
+
+   `<File>` contains `path:line-range (side, source[, outdated])`. An outdated
+   comment refers to lines that changed after it was created; use its saved
+   `<Diff>` excerpt to recover the intent. JSON output includes stable comment
+   ids and, for live sessions, direct browser URLs.
+
+2. Fix each comment in the repository. Comments re-anchor automatically when
+   their saved text has one unambiguous match.
+
+3. Resolve only comments that were actually addressed:
+
+   ```sh
+   dp resolve <comment-id> [<comment-id>...]
+   ```
+
+   Use `dp resolve --all` only when every current comment was handled. Resolution
+   updates an open viewer immediately.
+
+4. Summarize the fixes and identify any feedback left unresolved.
+
+## Turn tracking
+
+Turn tracking powers the viewer’s **Last turn** source:
+
+```sh
+dp turn start --session <session-id> --turn <turn-id> --agent <name>
+# perform the work
+dp turn end --session <session-id> --turn <turn-id>
+```
+
+`start` captures a read-only baseline and is idempotent while the same turn is
+active. It does not modify the index or working tree. Prefer lifecycle hooks
+when the harness supports them.
+
+## Session commands
+
+```sh
+dp status [--json]
+dp stop [--root <path>] [--owner <name>]
+dp stop --owner <name> --all
+dp stop --all
+```
+
+A working tree has one shared session. Owners are leases; the session stops only
+when its final lease is released, and the daemon exits when no sessions remain.
+
+## Operational rules
+
+- Share a capability URL only with the intended local user.
+- Do not open the browser yourself unless the user asks for UI inspection.
+- Never edit persisted review files by hand; use `dp reviews` and `dp resolve`.
+- Never resolve a comment that was not addressed.
+- Do not mutate the repository to obtain a diff. `dp` is read-only and never
+  runs automatic jj recovery commands.

package/ui/fonts/CommitMono-LICENSE.txt

@@ -0,0 +1,92 @@
+Copyright (c) 2023 Eigil Nikolajsen (eigi0088@gmail.com)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION AND CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/ui/fonts/Geist-LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright 2024 The Geist Project Authors (https://github.com/vercel/geist-font) Geist-Italic[wght].ttf: Copyright 2024 The Geist Project Authors (https://github.com/vercel/geist-font)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.