dsh-git-desk 0.0.0-stage → 0.18.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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Parth Patel
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,80 @@
1
- # Temporary Holding Version
1
+ # Git desk for DeepSeek Harness
2
2
 
3
- 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.
3
+ A Git tab in the Harness right sidebar. It opens on demand from the Start guide or tab strip, follows the session's workspace, and lists every repository under it, so a project with several repositories works without leaving the conversation. It shows full-file diffs, stages files and blocks, creates and switches branches, commits, syncs, stashes, and reads history.
4
+
5
+ ![Horizontal mode tabs over the file list and the split diff](docs/screenshots/overview-dark.png)
6
+
7
+ ![The Git tab docked next to the conversation, staged files and the AI commit menu open](docs/screenshots/app-window-dark.png)
8
+
9
+ ## Install
10
+
11
+ The npm package name is `dsh-git-desk`. Add it to the current DSH profile with the plugin manager, then reload the window. For a local checkout, link this folder into the `web` profile as `dsh-git-desk` and reload.
12
+
13
+ ## Open it
14
+
15
+ 1. Reload the window once. In the desktop app, `Ctrl+R` reloads the current page. Use a hard reload if the old sidebar entry is still visible.
16
+ 2. Open the Git tab from the **Git changes** card in the right sidebar Start guide, or use the add control in the tab strip.
17
+ 3. Switch sessions and the tab follows the new session's workspace.
18
+
19
+ The tab is not a global panel. It does not sit above the Workspace session list.
20
+
21
+ ![Right-sidebar Git tab, changes list](docs/screenshots/changes-dark.png)
22
+
23
+ ![Repository picker, two repositories in one workspace](docs/screenshots/repo-menu-dark.png)
24
+
25
+ ![Split diff in the right sidebar, two arrows per block](docs/screenshots/unstaged-dark.png)
26
+
27
+ ![Unstaged split diff with per-block arrows and the commit box](docs/screenshots/split-diff-dark.png)
28
+
29
+ ## What it does
30
+
31
+ - **Repositories.** Every repository in the workspace is listed. The header picker scopes the whole panel, including its remote, branches, and sync. When the workspace has no repository, the panel offers to initialize one.
32
+ - **Changes.** Conflicts, Staged, and Unstaged groups. A file with both kinds appears in both groups with `↕`.
33
+ - **Bulk staging.** Each section header has one icon for the whole section. The plus stages every unstaged file, the minus unstages every staged file, both in a single request. The tooltip names the action. Conflicted files are excluded until they are resolved. A rename sends both of its paths, so the section empties completely.
34
+ - **Full-file diff.** Both sides show the entire file, line 1 to the last line. No unchanged runs are collapsed.
35
+ - **Change navigation.** The toolbar shows which change you are reading and how many the file has. The arrows jump to the previous or next change and keep both sides aligned.
36
+ - **Tooltips.** Every icon-only control shows a native tooltip with the same text as its accessible name, so the sync, layout, and staging icons read without guessing.
37
+ - **Two comparisons.** Staged compares `HEAD` to `Staged` with one arrow per block. Unstaged compares `Staged` to `Local` with two arrows per block.
38
+ - **Block actions.** Left arrow stages a local block. Right arrow in the unstaged diff reverts the block to the staged version after confirmation. Right arrow in the staged diff unstages the block.
39
+ - **Commit.** Message, amend toggle, and commit button. The button is disabled until something is staged and no conflict remains.
40
+ - **AI commit actions.** The sparkle button next to Commit offers two actions. **Write a commit message** reads the staged patch and fills the message field. **Create a branch and commit** generates the message, derives the branch name, and opens the branch dialog for confirmation. Both use the model selected in Settings and run only when you click them.
41
+ - **Branches.** The header menu searches local and remote branches, switches local branches, and creates a branch from `HEAD` without a commit. Choosing a remote branch creates a local tracking branch. The commit box still offers **Branch** for create-and-commit.
42
+ - **Branch and commit.** Creates a branch from the current `HEAD`, commits only the staged changes, and leaves Push as the next action.
43
+ - **Sync.** Fetch, pull, and push appear once in the header. Ahead and behind counts appear on push and pull only when they are not zero.
44
+ - **History.** Lanes, refs, author, relative time, commit detail, file list, and a read-only full-file diff preview in the right panel matching JetBrains ergonomics.
45
+ - **Commit actions.** Right-click a commit, or use the actions control in the detail header, to undo the last commit, revert it, cherry-pick it onto the current branch, or reset the branch to it. Undo and revert open Changes with the message filled and the changes staged. Undo is refused for a pushed HEAD, revert and cherry-pick are refused for merge commits, and every action is refused while another operation is in progress. The menu states the reason on the disabled row.
46
+ - **Stashes.** File-level stash with a message, then apply, pop, or drop.
47
+ - **Conflicts.** Marker view with `Accept ours` and `Accept theirs`. Commit is blocked until the conflict group is empty.
48
+ - **Layout.** Changes, History, and Stashes are horizontal segmented tabs above a consistent two-panel body: the navigator on the left and the preview on the right. Below 900 pixels the navigator and diff take turns at full width. The split diff stays the default, with the two arrows in the center gutter. The right pane is a preview at normal width; use the expand control for a full-width split, or switch to the unified diff.
49
+ - **Theme.** Every color uses native `--dsw-alias-*` or `--dsw-specific-*` design system tokens. Dark and light follow the host.
50
+
51
+ ## Architecture
52
+
53
+ The client is a right-sidebar tab type. It registers a guide card, the tab body under `sidebar.right.pane.tab`, and the chip title under `sidebar.right.pane.tab.title`. The body resolves the current session's workspace and calls one authenticated Host channel, `/git-rpc`. The Host runs Git through `ctx.subprocess` with argv arrays and timeouts, and returns status and diff data. The client never runs Git.
54
+
55
+ Writes rebuild the exact index blob from the versions the diff came from, verify both side hashes, and reject a stale block. The full file is always read on both sides.
56
+
57
+ Commit messages can be written by the model selected in Settings. The Host sends the staged patch and the last five commit subjects to that provider only when the sparkle action runs. The message is cleaned to one `type(scope): summary` line before it reaches the field.
58
+
59
+ Details, endpoint table, and verification are in [`docs/implementation.md`](docs/implementation.md).
60
+
61
+ ## Limits in this version
62
+
63
+ - The tab uses the current session's workspace path. A per-session `workingDirectory` override or a DSH worktree outside the workspace is not followed.
64
+ - Stash is file-level. Hunk-level stash is not implemented.
65
+ - Commit messages and branch names are not generated by a model.
66
+ - Conflict resolution is whole-side plus the marker view. There is no three-pane editor.
67
+ - Block arrows are hidden on a rename; use the file buttons.
68
+ - Symlinks, non-UTF-8 text files, and text files over 5 MB are treated as binary.
69
+ - Large diffs are not virtualized yet.
70
+
71
+ ## Design package
72
+
73
+ The interactive mockup is still the design reference:
74
+
75
+ - [`mockup/index.html`](mockup/index.html) is a self-contained prototype with local fonts and no network calls.
76
+ - [`docs/design-brief.md`](docs/design-brief.md) records placement, layout, interactions, decisions, and open questions.
77
+ - [`docs/features/FEAT-001-git-integration.md`](docs/features/FEAT-001-git-integration.md) holds contracts, rules, acceptance criteria, and the implementation map.
78
+ - [`docs/research/jetbrains-git.md`](docs/research/jetbrains-git.md) and [`docs/research/vscode-and-gui-clients.md`](docs/research/vscode-and-gui-clients.md) hold the evidence notes.
79
+
80
+ The mockup palette approximates the harness theme. The plugin uses only host tokens.