dsh-gitbar-lite 0.0.0-stage → 0.1.0

package/lib/shared.js

@@ -0,0 +1,125 @@
+/**
+ * dsh-gitbar-lite — wire contract, shared by the two halves.
+ *
+ * The browser half is a hand-written classic-script bundle and therefore cannot
+ * `import` this module; it repeats these literals verbatim. `test/check.mjs`
+ * asserts the repetition rather than trusting it — a drifted route or action
+ * name fails silently at runtime (the client would `fetch` a path nobody
+ * serves), which is exactly the failure this file exists to prevent.
+ *
+ * @module dsh-gitbar-lite/shared
+ */
+
+/** Package name; also the client module-loader id and the settings namespace. */
+export const PLUGIN_ID = 'dsh-gitbar-lite'
+
+/** The single exact Fetch route both halves speak over. */
+export const RPC_ROUTE = '/api/dsh-gitbar-lite/rpc'
+
+/** Every RPC action. The client sends `{ action, ...payload }`. */
+export const ACTIONS = {
+  /** Repository identity + working-tree status + branch/ahead-behind. */
+  STATUS: 'status',
+  /** Persist (or clear) this workspace's bound repository. */
+  BIND: 'bind',
+  /** Candidate repositories under the workspace, for the picker. */
+  REPOS: 'repos',
+  /** Stage or unstage the given paths, for real (`git add` / `git restore --staged`). */
+  STAGE: 'stage',
+  /** Commit what is staged. */
+  COMMIT: 'commit',
+  /** Commit what is staged, then push. */
+  COMMIT_PUSH: 'commitAndPush',
+  /** Push the current branch. */
+  PUSH: 'push',
+  /** Fetch from the upstream's remote. */
+  FETCH: 'fetch',
+  /** Discard changes: archive the diff, then restore. `paths: null` means all. */
+  DISCARD: 'discard',
+  /** One file's unified diff against HEAD, for the preview tab. */
+  FILE_DIFF: 'fileDiff',
+  /** Archived trash entries for the bound repository. */
+  TRASH_LIST: 'trashList',
+  /** One archived entry's diff text. */
+  TRASH_DIFF: 'trashDiff',
+  /** Drop one archived entry (and its diff on disk). */
+  TRASH_DELETE: 'trashDelete',
+  /** Drop every archived entry. */
+  TRASH_CLEAR: 'trashClear',
+  /** Read or write the small persisted UI preferences. */
+  PREFS: 'prefs',
+}
+
+/**
+ * Machine-readable failure codes. The client shows `message` and branches on
+ * `code` only where the recovery differs (a conflict, a rejected push, a
+ * missing credential).
+ */
+export const ERROR_CODES = {
+  BAD_REQUEST: 'E_BAD_REQUEST',
+  UNKNOWN_ACTION: 'E_UNKNOWN_ACTION',
+  NO_WORKSPACE: 'E_NO_WORKSPACE',
+  NO_REPO: 'E_NO_REPO',
+  NO_GIT: 'E_NO_GIT',
+  EMPTY_SUMMARY: 'E_EMPTY_SUMMARY',
+  NOTHING_STAGED: 'E_NOTHING_STAGED',
+  CONFLICT: 'E_CONFLICT',
+  GIT_FAILED: 'E_GIT_FAILED',
+  NO_REMOTE: 'E_NO_REMOTE',
+  NO_UPSTREAM: 'E_NO_UPSTREAM',
+  AUTH: 'E_AUTH',
+  PUSH_REJECTED: 'E_PUSH_REJECTED',
+  TRASH_NOT_FOUND: 'E_TRASH_NOT_FOUND',
+  INTERNAL: 'E_INTERNAL',
+}
+
+/**
+ * Which label the single context button wears. The client maps these to copy;
+ * the host decides by looking at the branch, the way GitHub Desktop does.
+ */
+export const PRIMARY_ACTIONS = {
+  /** Local commits exist that the upstream does not have. */
+  PUSH: 'push',
+  /** The branch has no upstream yet, so the first push has to set one. */
+  PUBLISH: 'publish',
+  /** Nothing to push: the button fetches. */
+  FETCH: 'fetch',
+}
+
+/**
+ * Per-file status buckets. `untracked` and `conflicted` are the two cases where
+ * a plain `git restore` is not the right verb.
+ */
+export const FILE_STATUS = {
+  MODIFIED: 'modified',
+  ADDED: 'added',
+  DELETED: 'deleted',
+  RENAMED: 'renamed',
+  UNTRACKED: 'untracked',
+  CONFLICTED: 'conflicted',
+}
+
+/** Trash entry origin: one path, or a whole working tree. */
+export const DISCARD_SCOPE = {
+  FILE: 'file',
+  ALL: 'all',
+}
+
+/** State-file names inside the plugin's own directory under DSH_HOME. */
+export const STATE_FILES = {
+  BINDINGS: 'bindings.json',
+  PREFS: 'prefs.json',
+  TRASH_INDEX: 'trash/index.json',
+}
+
+/** Directory the plugin owns under DSH_HOME. */
+export const STATE_DIR_NAME = 'dsh-gitbar-lite'
+
+/** Environment for every git child: no prompts, no locks, stable locale. */
+export const GIT_ENV = {
+  GIT_TERMINAL_PROMPT: '0',
+  GIT_OPTIONAL_LOCKS: '0',
+  GIT_CONFIG_COUNT: '0',
+  GIT_PAGER: 'cat',
+  LC_ALL: 'C',
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git Bar (lite)",
+    "description": "A GitHub Desktop-style Git panel: changed files, tick-to-stage, commit, commit and push, discard into a trash, and diff preview."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git 栏（轻量）",
+    "description": "GitHub Desktop 风格的 Git 面板：变更文件、勾选提交、舍弃进回收站、Commit and Push、diff 预览。"
+  }
+}

package/package.json

@@ -1,6 +1,90 @@
 {
   "name": "dsh-gitbar-lite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A GitHub Desktop-style Git panel for DSH: changed files, tick-to-stage, Summary + Description, Commit and Commit and Push, discard-to-trash, and diff preview, in the built-in right sidebar.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Ckarefulon",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ckarefulon/dsh-gitbar-lite.git"
+  },
+  "homepage": "https://github.com/Ckarefulon/dsh-gitbar-lite#readme",
+  "bugs": {
+    "url": "https://github.com/Ckarefulon/dsh-gitbar-lite/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json",
+    "./locale/en.json": "./locale/en.json",
+    "./locale/zh.json": "./locale/zh.json"
+  },
+  "files": [
+    "lib",
+    "locale",
+    "docs",
+    "cordis.patch.yml",
+    "icon.svg",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "icon": "./icon.svg",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "peers": "node scripts/install-peers.mjs",
+    "pretest": "node scripts/install-peers.mjs",
+    "test": "node --test test/parse.test.mjs test/diff.test.mjs test/store.test.mjs test/index.test.mjs test/client.test.mjs && node test/e2e.mjs && node test/check.mjs",
+    "test:unit": "node --test test/parse.test.mjs test/diff.test.mjs test/store.test.mjs test/index.test.mjs test/client.test.mjs",
+    "test:e2e": "node test/e2e.mjs",
+    "test:live": "node test/live.mjs",
+    "test:browser": "node test/serve.mjs",
+    "check": "node test/check.mjs && node scripts/check-client-bundle.mjs .",
+    "check:bundle": "node scripts/check-client-bundle.mjs ."
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "git",
+    "github-desktop",
+    "source-control",
+    "diff",
+    "commit",
+    "sidebar"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0 <5",
+    "@deepseek-ai/schemastery": ">=3.18.0 <4"
+  },
+  "meta": {
+    "title": "Git 栏（轻量）",
+    "description": "GitHub Desktop 风格的 Git 面板：变更文件、勾选提交、舍弃进回收站、Commit and Push、diff 预览。"
+  },
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.2.0-rc.2"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-sidebar-right"
+      ]
+    }
+  }
+}