@ibobbyts/dsh-git-commit 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iBobbyTS
+
+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,68 @@
-# Temporary Holding Version
+# dsh-git-commit
 
-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.
+A lightweight floating **Git status + AI Commit** plugin for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness), published as **`@ibobbyts/dsh-git-commit`**.
+
+- View the current Session's Git branch and changed-line counts in a draggable, collapsible panel.
+- Generate a commit message through a model configured in DSH, then make **one real Git commit**.
+- Choose global/repository instructions, a model, optional Token metrics, and countdown color in the native DSH right sidebar.
+- Keep the floating panel within the visible window; **drag locations persist** across restarts. The settings panel includes **Reset floating window position**.
+- Non-Git directories show a compact warning or remain hidden according to your preference.
+
+## Install
+
+From the npm registry (recommended after the first publication):
+
+```sh
+dsh plugin --profile desktop add @ibobbyts/dsh-git-commit
+# Or: dsh plugin --profile web add @ibobbyts/dsh-git-commit
+```
+
+Alternatively, in **Plugins → Add plugin → Install third-party plugin**, use `https://github.com/iBobbyTS/dsh-git-commit.git`.
+
+**Upgrading from v0.1.x:** The npm package is now scoped. Remove the previous `dsh-git-commit` package/bundle before installing `@ibobbyts/dsh-git-commit`; the Host service name remains `gitCommit`, and the settings file is reused. Fully quit and restart DSH Desktop after installation.
+
+[Complete install, upgrade, and troubleshooting guide](docs/INSTALLATION.md)
+
+## How commits work
+
+If anything is staged, the plugin commits **only the staged Git index**. If nothing is staged, it snapshots all non-ignored worktree changes, generates a message, revalidates the snapshot, stages, and commits them. It never pushes or bypasses Git hooks. A changed snapshot fails safely instead of committing uninspected content.
+
+Small Diff: one LLM call. When a file has over 2,000 changed lines: one low-reasoning classification call (all paths and large-file previews), then one final generation call (Off reasoning when supported). Total **at most two LLM calls**. Large-file previews are explicitly marked; inputs are best-effort credential-redacted before transmission. See [Architecture](docs/ARCHITECTURE.md).
+
+## Call the Git commit service from another DSH Host plugin
+
+`@ibobbyts/dsh-git-commit` exposes a **Cordis-native Host service**. Declare `gitCommit` in your plugin's injection list. No separate MCP server or browser RPC is required:
+
+```ts
+import type {} from '@ibobbyts/dsh-git-commit'; // optional: Context type augmentation
+
+export const inject = ['gitCommit'];
+
+export async function run(ctx: import('@deepseek-ai/cordis').Context, cwd: string) {
+  const result = await ctx.gitCommit.commit({ cwd });
+  if (!result.success) throw new Error(result.error ?? 'Git commit failed');
+
+  return {
+    hash: result.hash,            // first 7 hex characters
+    message: result.message,      // actual committed message
+    additions: result.additions,  // actual committed lines
+    deletions: result.deletions,
+    scope: result.scope,          // 'staged' or 'all'
+    llm: result.llm,              // optional Token/TTFT/speed statistics
+  };
+}
+```
+
+`cwd` may point anywhere inside a Git worktree. Pass `{message: 'type: subject'}` to commit with a **caller-supplied message** instead of invoking an LLM, while retaining all snapshot and hook checks. Other operations include `ctx.gitCommit.status({cwd})` and `ctx.gitCommit.settings({cwd})`. Importing the types is optional at runtime; the service requires this plugin to be installed and enabled in the same DSH profile.
+
+[Full API contract](lib/index.d.ts) · [Settings reference](docs/CONFIGURATION.md)
+
+## Development and releases
+
+```sh
+npm install
+npm run check
+npm pack --dry-run --ignore-scripts
+```
+
+The source is MIT licensed. See [Development](docs/DEVELOPMENT.md), [npm release instructions](docs/RELEASING.md), and [third-party licenses](THIRD_PARTY.md). No npm token is committed to the repository.

package/THIRD_PARTY.md

@@ -0,0 +1,14 @@
+# References and third-party licenses
+
+The plugin is originally authored under [LICENSE](LICENSE). The repositories below were used as references; no upstream source tree has been copied into this repository. License and copyright information is provided for attribution and future contributors who may choose to port code.
+
+- **luigiinred/dsh-git-status-pill**, https://github.com/luigiinred/dsh-git-status-pill — MIT, Copyright (c) 2026 dsh-git-status-pill contributors. Reference for floating DSH `shell.overlay` UI.
+- **dennisrongo/dsh-plugins** (`plugins/dsh-git`), https://github.com/dennisrongo/dsh-plugins — MIT, Copyright (c) 2026 Dennis Rongo. Reference for DSH Git status services and `ctx.llm`.
+- **MantisWare/commit-ai**, https://github.com/MantisWare/commit-ai — MIT, Copyright (c) MantisWare, https://github.com/MantisWare. Historical reference for large-diff synthesis.
+- **SunParis/GitCommitGenerator**, https://github.com/SunParis/GitCommitGenerator — MIT, Copyright (c) 2026 Yuchen Sun. Reference for deterministic diff input filtering.
+- **@visulima/redact**, https://github.com/visulima/visulima/tree/main/packages/data-manipulation/redact — MIT, Copyright (c) Visulima contributors / Daniel Bannert. **Runtime dependency**; `stringAnonymize` and `credentialRules` are imported from the published package, not copied or reimplemented. The installed npm package includes its own MIT license.
+- **deepseek-ai/deepseek-harness**, https://github.com/deepseek-ai/deepseek-harness — canonical host/client API documentation and implementation reference; the plugin uses those APIs via its peer dependencies.
+
+This release removes the former **@mcarvin/smart-diff** runtime dependency. Prior versions used its public diff utilities; no smart-diff source is included in this release.
+
+The MIT license permits copying/modification/distribution subject to preservation of the license and copyright notices. For references used as a basis for future source-level porting, preserve the complete upstream license notice in the relevant copied/derived files or a dedicated `licenses/` directory before redistribution.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Host plugin service and Web/Desktop Client are activated by this DSH bundle.
+- insert:
+    - id: dsh-git-commit
+      name: '@ibobbyts/dsh-git-commit'