dsh-plugin-git-commit-push 0.0.0-stage → 1.0.1

package/setup.ps1

@@ -0,0 +1,226 @@
+<#
+.SYNOPSIS
+  Install a local CHECKOUT of dsh-plugin-git-commit-push into a DSH profile.
+
+.DESCRIPTION
+  Wires the plugin into the profile's bundle stack in two deliberate steps:
+
+    1. adds the plugin to the profile's package.json as a `link:` dependency;
+    2. appends the package to `dsh.profile.bundles`.
+
+  Installing from npm does not need this script: use Settings > Plugins (type
+  `dsh-plugin-git-commit-push`) or
+  `dsh plugin --profile <profile> add dsh-plugin-git-commit-push`.
+  This script is for a checkout you are editing, which should be linked rather
+  than copied into node_modules.
+
+  The mount row is deliberately NOT written into the profile's patch file: it
+  comes from the package's own bundle patch (`cordis.patch.yml`, declared as
+  `dsh.bundle.patch` in this package's package.json), which the launcher applies
+  for every profile that selects the bundle. That declaration is also what makes
+  the package manageable: the Plugins page can enable, disable and uninstall a
+  bundle, and refuses every action on a package without one with the diagnostic
+  "这个包没有声明组合包，不能作为插件管理" (`not-bundle`).
+
+  A profile set up by an earlier revision of this script still carries a
+  hand-written mount row in its cordis.patch.yml under the marker block below.
+  Loader `insert` is append-only — two inserts of the same id mount the plugin
+  twice — so this script strips that legacy block whenever it finds one.
+
+  Steps 1 and 2 change the bundle set, which a running profile does not pick up:
+  DSH must be restarted afterwards. Every write is idempotent — run this as many
+  times as you like — and a backup of each file is written before the first
+  modification.
+
+  Nothing here touches your git configuration, your repositories, or any DSH
+  setting other than the edits above.
+
+.PARAMETER Profile
+  Profile name under $env:USERPROFILE\.dsh\profiles. Defaults to `desktop`.
+
+.PARAMETER Uninstall
+  Reverses the two edits, strips a legacy mount row and removes the linked package.
+
+.EXAMPLE
+  powershell -ExecutionPolicy Bypass -File .\setup.ps1
+  powershell -ExecutionPolicy Bypass -File .\setup.ps1 -Profile web
+  powershell -ExecutionPolicy Bypass -File .\setup.ps1 -Uninstall
+#>
+[CmdletBinding()]
+param(
+  [string]$Profile = 'desktop',
+  [switch]$Uninstall
+)
+
+$ErrorActionPreference = 'Stop'
+
+$pluginDir = $PSScriptRoot
+$pluginName = 'dsh-plugin-git-commit-push'
+$dshHome = Join-Path $env:USERPROFILE '.dsh'
+$profileDir = Join-Path $dshHome "profiles\$Profile"
+$nodeExe = Join-Path $dshHome 'dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe'
+$pnpmCli = Join-Path $dshHome 'dsh-runtimes\dsh-primary-runtime\dependencies\pnpm\bin\pnpm.mjs'
+
+function Write-Step([string]$Text) { Write-Host "  $Text" }
+function Write-Ok([string]$Text) { Write-Host "  [ok]   $Text" -ForegroundColor Green }
+function Write-Info([string]$Text) { Write-Host "  [info] $Text" -ForegroundColor Cyan }
+function Write-Warn2([string]$Text) { Write-Host "  [warn] $Text" -ForegroundColor Yellow }
+
+Write-Host ''
+Write-Host "dsh-plugin-git-commit-push $(if ($Uninstall) { 'uninstall' } else { 'install' })" -ForegroundColor White
+Write-Host ''
+
+# --- 1. Preconditions ------------------------------------------------------
+if (-not (Test-Path -LiteralPath $profileDir)) {
+  throw "Profile directory not found: $profileDir"
+}
+if (-not (Test-Path -LiteralPath (Join-Path $profileDir 'package.json'))) {
+  throw "Not a DSH profile (no package.json): $profileDir"
+}
+
+$packageJsonPath = Join-Path $profileDir 'package.json'
+$patchPath = Join-Path $profileDir 'cordis.patch.yml'
+if (-not (Test-Path -LiteralPath $patchPath)) {
+  throw "Not a DSH profile (no cordis.patch.yml): $profileDir"
+}
+
+$gitCmd = Get-Command git -ErrorAction SilentlyContinue
+if ($null -eq $gitCmd) {
+  Write-Warn2 'git was not found on PATH. The plugin needs it at runtime; install Git before using it.'
+} else {
+  Write-Ok "git found: $($gitCmd.Source)"
+}
+
+if (-not (Test-Path -LiteralPath $nodeExe)) {
+  throw "Bundled node not found: $nodeExe`nSet it manually, or install the package with your own pnpm instead."
+}
+if (-not (Test-Path -LiteralPath $pnpmCli)) {
+  throw "Bundled pnpm not found: $pnpmCli"
+}
+Write-Ok 'bundled node + pnpm located'
+
+# --- 2. Back up once -------------------------------------------------------
+# NOTE: the concatenation must be `$file + '.suffix'`, NOT "$file.suffix".
+# Inside an expandable string PowerShell reads `.git-commit-plugin` as a
+# PROPERTY access on $file, which yields $null — the backup would silently land
+# in the current directory under a mangled name and the second file would never
+# be backed up at all.
+#
+# The patch file is backed up further down, and only when this run actually has
+# to change it (the legacy mount-row migration). A fresh install leaves it
+# untouched.
+$manifestBackup = $packageJsonPath + '.git-commit-plugin.bak'
+if (-not (Test-Path -LiteralPath $manifestBackup)) {
+  Copy-Item -LiteralPath $packageJsonPath -Destination $manifestBackup
+  Write-Ok "backed up package.json -> $(Split-Path -Leaf $manifestBackup)"
+}
+
+# --- 3. Edit the profile manifest and patch layer --------------------------
+# The manifest edit is delegated to lib/profile-edit.mjs, the SAME code setup.sh
+# runs on macOS/Linux. Editing a user's profile package.json is the one step that
+# must not go wrong, and two hand-written implementations of it would drift: this
+# way one reviewed implementation (idempotent, keeps unknown fields, no BOM,
+# self-verifying) serves both platforms.
+$editArgs = @(
+  "$pluginDir\lib\profile-edit.mjs"
+  '--profile-dir', $profileDir
+  '--package', $pluginName
+)
+if ($Uninstall) { $editArgs += '--remove' } else { $editArgs += @('--link', $pluginDir) }
+
+& $nodeExe @editArgs
+if ($LASTEXITCODE -ne 0) { throw "profile manifest edit failed with exit code $LASTEXITCODE" }
+Write-Ok 'package.json updated'
+
+# The plugin is mounted by the bundle patch this package ships
+# (cordis.patch.yml, declared as dsh.bundle.patch). Nothing is written into the
+# profile's own cordis.patch.yml on a fresh install.
+#
+# What this step does is the MIGRATION: an earlier revision of this script wrote
+# a mount row into the profile patch instead, and Loader `insert` is
+# append-only — leaving that row in place next to the bundle's own row would
+# mount the plugin twice. So the marker block is stripped whenever it is found;
+# the edit is idempotent (it is stripped and never rewritten) and the profile
+# patch is backed up first, because this is the only run that may change it.
+$beginMarker = '# >>> dsh-plugin-git-commit-push'
+$endMarker = '# <<< dsh-plugin-git-commit-push'
+$patchText = Get-Content -LiteralPath $patchPath -Raw
+$existingBlock = [regex]::Match($patchText, "(?s)\s*$([regex]::Escape($beginMarker)).*?$([regex]::Escape($endMarker))")
+if ($existingBlock.Success) {
+  $patchBackup = $patchPath + '.git-commit-plugin.bak'
+  if (-not (Test-Path -LiteralPath $patchBackup)) {
+    Copy-Item -LiteralPath $patchPath -Destination $patchBackup
+    Write-Ok "backed up cordis.patch.yml -> $(Split-Path -Leaf $patchBackup)"
+  }
+  $patchText = $patchText.Remove($existingBlock.Index, $existingBlock.Length)
+  $patchText = $patchText -replace "(\r?\n){3,}", "`n`n"
+  [System.IO.File]::WriteAllText($patchPath, "$($patchText.TrimEnd())`n", (New-Object System.Text.UTF8Encoding($false)))
+  Write-Ok 'cordis.patch.yml: legacy mount row removed (the bundle patch mounts the plugin now)'
+} else {
+  Write-Ok 'cordis.patch.yml: no legacy mount row to remove'
+}
+
+# --- 4. Link the package ---------------------------------------------------
+Write-Step 'running pnpm install in the profile (this may take a moment)...'
+Push-Location $profileDir
+# pnpm writes progress and warnings to stderr routinely. With
+# $ErrorActionPreference = 'Stop' and a `2>&1` redirect, Windows PowerShell turns
+# those into terminating errors, so the script would die before it could read
+# $LASTEXITCODE. Relax the preference for the duration of the native call.
+$previousPreference = $ErrorActionPreference
+$ErrorActionPreference = 'Continue'
+try {
+  & $nodeExe $pnpmCli install
+  $pnpmExit = $LASTEXITCODE
+} finally {
+  $ErrorActionPreference = $previousPreference
+  Pop-Location
+}
+if ($pnpmExit -ne 0) { throw "pnpm install failed with exit code $pnpmExit" }
+Write-Ok 'package linked into the profile'
+
+# --- 5. Verify -------------------------------------------------------------
+# On uninstall the linked directory is expected to be gone (pnpm pruned it in
+# step 4); reporting that as a warning would read like a failure.
+$linkedModule = Join-Path $profileDir "node_modules\$pluginName"
+if ($Uninstall) {
+  if (Test-Path -LiteralPath $linkedModule) {
+    Write-Warn2 "node_modules\$pluginName is still present; run pnpm install in the profile to prune it"
+  } else {
+    Write-Ok "module removed from node_modules\$pluginName"
+  }
+} elseif (Test-Path -LiteralPath $linkedModule) {
+  Write-Ok "module present at node_modules\$pluginName"
+} else {
+  Write-Warn2 "node_modules\$pluginName is missing; the profile will not find the plugin"
+}
+
+if (-not $Uninstall) {
+  Write-Host ''
+  Write-Host 'Done. Restart DeepSeek Harness to load the bundle.' -ForegroundColor White
+  Write-Host ''
+  Write-Host '  Close DeepSeek Harness first if it is running: a bundle addition is' -ForegroundColor Gray
+  Write-Host '  read at profile start, not live. Then start it again.' -ForegroundColor Gray
+  Write-Host ''
+  Write-Host '  After the restart you get:' -ForegroundColor Gray
+  Write-Host '    - a tool named  git_commit_push   (prepare / apply / auto)' -ForegroundColor Gray
+  Write-Host '    - a slash command  /git-commit-push   (runs without the model, 0 tokens)' -ForegroundColor Gray
+  Write-Host ''
+  Write-Host '  The plugin is a declared bundle, so Settings > Plugins can now' -ForegroundColor Gray
+  Write-Host '  enable, disable and uninstall it without this script.' -ForegroundColor Gray
+  Write-Host ''
+  Write-Host '  Settings live in:' -ForegroundColor Gray
+  Write-Host "    $(Join-Path $pluginDir 'git-commit-push.config.json')" -ForegroundColor Gray
+  Write-Host ''
+  Write-Host '  If anything goes wrong, restore the backed-up profile files:' -ForegroundColor Gray
+  Write-Host "    $(Join-Path $profileDir 'package.json.git-commit-plugin.bak')" -ForegroundColor Gray
+  Write-Host '    cordis.patch.yml.git-commit-plugin.bak  (only if the migration touched it)' -ForegroundColor Gray
+  Write-Host ''
+} else {
+  Write-Host ''
+  Write-Host 'Uninstalled. Restart DeepSeek Harness for the bundle set to change.' -ForegroundColor White
+  Write-Host 'Backups of your original profile files are next to them (*.git-commit-plugin.bak).' -ForegroundColor Gray
+  Write-Host ''
+}
+
+exit 0

package/setup.sh

@@ -0,0 +1,190 @@
+#!/usr/bin/env bash
+#
+# Install a local CHECKOUT of dsh-plugin-git-commit-push into a DSH profile on
+# macOS or Linux. The Windows equivalent is setup.ps1; both do the same two
+# things and both delegate the profile-manifest edit to lib/profile-edit.mjs, so
+# the risky step is the same reviewed code on every platform.
+#
+#   1. links the plugin into the profile's package.json as a `link:` dependency;
+#   2. appends the package to `dsh.profile.bundles`.
+#
+# Installing from npm does not need this script: use Settings > Plugins, or
+#   dsh plugin --profile <profile> add dsh-plugin-git-commit-push
+# This script is for a checkout you are editing, which should be linked rather
+# than copied into node_modules.
+#
+# The mount row is deliberately NOT written here. It comes from the package's own
+# bundle patch (cordis.patch.yml, declared as `dsh.bundle.patch`), which the
+# launcher applies for every profile that selects the bundle. That declaration is
+# also what makes the package manageable: without it the Plugins page answers
+# every request with "这个包没有声明组合包，不能作为插件管理" (`not-bundle`).
+#
+# What this script does add is the migration: an earlier revision wrote the mount
+# row into the profile's cordis.patch.yml instead, and Loader `insert` is
+# append-only — two inserts of one id mount the plugin twice — so that legacy
+# block is stripped whenever it is found.
+#
+# Restart DSH afterwards. `patchReload: live` re-reads the mount row but does
+# NOT re-import an ESM module, so code changes need a restart.
+#
+# Usage:
+#   ./setup.sh [profile]            install (default profile: desktop)
+#   ./setup.sh [profile] --uninstall
+#
+# Environment:
+#   DSH_HOME   DSH home directory (default: ~/.dsh)
+
+set -eu
+
+plugin_dir=$(cd -- "$(dirname -- "$0")" && pwd)
+plugin_name='dsh-plugin-git-commit-push'
+dsh_home=${DSH_HOME:-"$HOME/.dsh"}
+
+profile='desktop'
+uninstall=0
+for arg in "$@"; do
+  case "$arg" in
+    --uninstall|-u) uninstall=1 ;;
+    --help|-h)
+      sed -n '2,35p' "$0" | sed 's/^# \{0,1\}//'
+      exit 0
+      ;;
+    -*) printf 'unknown option: %s\n' "$arg" >&2; exit 2 ;;
+    *) profile=$arg ;;
+  esac
+done
+
+profile_dir="$dsh_home/profiles/$profile"
+
+ok()   { printf '  [ok]   %s\n' "$1"; }
+info() { printf '  [info] %s\n' "$1"; }
+warn() { printf '  [warn] %s\n' "$1"; }
+die()  { printf '  [fail] %s\n' "$1" >&2; exit 1; }
+
+printf '\n%s %s\n\n' "$plugin_name" "$([ "$uninstall" = 1 ] && echo uninstall || echo install)"
+
+# ---------------------------------------------------------------- preconditions
+[ -d "$profile_dir" ] || die "profile directory not found: $profile_dir"
+manifest="$profile_dir/package.json"
+patch_file="$profile_dir/cordis.patch.yml"
+[ -f "$manifest" ] || die "not a DSH profile (no package.json): $profile_dir"
+[ -f "$patch_file" ] || die "not a DSH profile (no cordis.patch.yml): $profile_dir"
+
+if command -v git >/dev/null 2>&1; then
+  ok "git found: $(command -v git)"
+else
+  warn 'git was not found on PATH. The plugin needs it at runtime; install Git before using it.'
+fi
+
+# Prefer a node already on PATH; otherwise use the runtime DSH ships with.
+node_bin=''
+if command -v node >/dev/null 2>&1; then
+  node_bin=$(command -v node)
+else
+  for candidate in \
+    "$dsh_home/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node" \
+    "/Applications/DeepSeek Harness.app/Contents/Resources/app.asar.unpacked/dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node"
+  do
+    if [ -x "$candidate" ]; then node_bin=$candidate; break; fi
+  done
+fi
+[ -n "$node_bin" ] || die 'no node executable found. Install Node 20+, or set DSH_HOME to your DSH home.'
+ok "node: $node_bin"
+
+pnpm_cli="$dsh_home/dsh-runtimes/dsh-primary-runtime/dependencies/pnpm/bin/pnpm.mjs"
+
+# ------------------------------------------------------------------- backups
+stamp=$(date +%Y%m%d-%H%M%S)
+for file in "$manifest" "$patch_file"; do
+  backup="$file.git-commit-plugin.bak"
+  if [ ! -f "$backup" ]; then
+    # `cp -p` preserves the mode; a plain cp is fine but this keeps parity with
+    # the Windows installer's intent (never overwrite an existing backup).
+    cp -p "$file" "$backup"
+    ok "backed up $(basename "$file") -> $(basename "$backup")"
+  fi
+  cp -p "$file" "$file.pre-install-$stamp"
+done
+info "pre-install snapshots written as *.pre-install-$stamp"
+
+# ------------------------------------------------------- 1+2. profile manifest
+if [ "$uninstall" = 1 ]; then
+  "$node_bin" "$plugin_dir/lib/profile-edit.mjs" \
+    --profile-dir "$profile_dir" --package "$plugin_name" --remove || die 'manifest edit failed'
+else
+  "$node_bin" "$plugin_dir/lib/profile-edit.mjs" \
+    --profile-dir "$profile_dir" --package "$plugin_name" --link "$plugin_dir" || die 'manifest edit failed'
+fi
+ok 'package.json updated'
+
+# ------------------------------------------------------- 3. legacy mount row
+# The mount row comes from this package's bundle patch (cordis.patch.yml), so
+# nothing is added to the profile patch here. What is removed is the row an
+# earlier revision of this script wrote: Loader `insert` is append-only, so
+# leaving it next to the bundle's own row would mount the plugin twice.
+begin_marker='# >>> dsh-plugin-git-commit-push'
+end_marker='# <<< dsh-plugin-git-commit-push'
+
+# Strip any previous block (POSIX awk, no GNU-only flags, no in-place sed: the
+# `-i` flag differs between BSD/macOS and GNU, which is exactly the kind of
+# portability trap this avoids). The file is only replaced when the block was
+# actually there, so a fresh install leaves cordis.patch.yml byte-identical.
+awk -v begin="$begin_marker" -v end="$end_marker" '
+  $0 == begin { skipping = 1 }
+  skipping != 1 { print }
+  $0 == end { skipping = 0; next }
+' "$patch_file" > "$patch_file.tmp"
+
+if cmp -s "$patch_file" "$patch_file.tmp"; then
+  rm -f "$patch_file.tmp"
+  ok 'cordis.patch.yml: no legacy mount row to remove'
+else
+  backup="$patch_file.git-commit-plugin.bak"
+  if [ ! -f "$backup" ]; then
+    cp -p "$patch_file" "$backup"
+    ok "backed up $(basename "$patch_file") -> $(basename "$backup")"
+  fi
+  mv "$patch_file.tmp" "$patch_file"
+  ok 'cordis.patch.yml: legacy mount row removed (the bundle patch mounts the plugin now)'
+fi
+
+# ---------------------------------------------------------------- 4. link it
+if [ "$uninstall" = 1 ]; then
+  info 'skipping pnpm install (removal)'
+else
+  if [ -f "$pnpm_cli" ]; then
+    info 'running pnpm install in the profile (this may take a moment)...'
+    ( cd "$profile_dir" && "$node_bin" "$pnpm_cli" install ) || die 'pnpm install failed'
+    ok 'package linked into the profile'
+  else
+    warn "bundled pnpm not found at $pnpm_cli"
+    warn "run this yourself to link the package:  cd '$profile_dir' && pnpm install"
+  fi
+
+  if [ -e "$profile_dir/node_modules/$plugin_name" ]; then
+    ok "module present at node_modules/$plugin_name"
+  else
+    warn "node_modules/$plugin_name is missing; the profile will not find the plugin"
+    warn 'run `pnpm install` inside the profile directory and try again'
+  fi
+fi
+
+# --------------------------------------------------------------------- report
+printf '\n'
+if [ "$uninstall" = 1 ]; then
+  printf 'Uninstalled. Restart DeepSeek Harness for the bundle set to change.\n'
+  printf 'Backups: %s\n\n' "$manifest.git-commit-plugin.bak"
+else
+  printf 'Done. Restart DeepSeek Harness to load the plugin.\n\n'
+  printf '  A bundle change is read at profile start, not live, and a host-code\n'
+  printf '  change needs a fresh ESM import. Quit DSH first, then start it again.\n\n'
+  printf '  After the restart you get:\n'
+  printf '    - tool   git_commit_push   (prepare / apply / auto)  [costs model tokens]\n'
+  printf '    - command /git-commit-push  (no model involved)      [0 model tokens]\n\n'
+  printf '  The plugin is a declared bundle, so Settings > Plugins can now enable,\n'
+  printf '  disable and uninstall it without this script.\n\n'
+  printf '  Settings: %s\n' "$plugin_dir/git-commit-push.config.json"
+  printf '  Backups : %s\n\n' "$manifest.git-commit-plugin.bak"
+fi
+
+exit 0