dsh-session-sync 0.1.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/ARCHITECTURE.md +86 -0
- package/CHANGELOG.md +18 -0
- package/LICENSE +201 -0
- package/README.es.md +181 -0
- package/README.hi.md +181 -0
- package/README.md +181 -0
- package/README.pt.md +181 -0
- package/README.zh.md +181 -0
- package/SECURITY.md +39 -0
- package/THIRD_PARTY_NOTICES.md +25 -0
- package/cordis.patch.yml +41 -0
- package/index.mjs +775 -0
- package/lib/constants.mjs +109 -0
- package/lib/domain.mjs +29 -0
- package/lib/engine.mjs +289 -0
- package/lib/errors.mjs +99 -0
- package/lib/gate.mjs +152 -0
- package/lib/git.mjs +377 -0
- package/lib/merge.mjs +96 -0
- package/lib/mirror.mjs +120 -0
- package/lib/paths.mjs +107 -0
- package/lib/render.mjs +107 -0
- package/lib/sanitize.mjs +105 -0
- package/lib/status.mjs +69 -0
- package/package.json +144 -0
- package/types.d.ts +132 -0
package/README.hi.md
ADDED
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
# dsh-session-sync
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+
**DeepSeek Harness के लिए क्रॉस-डिवाइस सत्र सिंक — आपके सत्र स्टोर का एक समर्पित git मिरर।**
|
|
6
|
+
|
|
7
|
+
*अपने सत्रों को डिवाइसों के बीच सिंक करें, किसी भी टकराव में दोनों पक्ष रखें, कभी कोई टर्न न खोएँ।*
|
|
8
|
+
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-session-sync/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-session-sync/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-session-sync)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-session-sync)
|
|
16
|
+
|
|
17
|
+
[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## संगतता
|
|
24
|
+
|
|
25
|
+
| सतह | स्थिति |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Harness | DeepSeek Harness `0.1.0-rc.6` |
|
|
28
|
+
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
29
|
+
| प्लेटफ़ॉर्म | जहाँ भी `git` और DSH चलते हैं (git-आधारित मिरर; कोई प्लेटफ़ॉर्म-विशिष्ट कोड नहीं) |
|
|
30
|
+
| मॉडल | केवल-टेक्स्ट मॉडल पूर्ण रूप से समर्थित; विज़न या अतिरिक्त क्षमता की आवश्यकता नहीं |
|
|
31
|
+
|
|
32
|
+
## आपको क्या मिलता है
|
|
33
|
+
|
|
34
|
+
`dsh-session-sync` आपके DSH सत्र स्टोर को एक समर्पित git वर्कट्री में मिरर करता है और उसे एक ऐसे रिमोट से सिंक करता है जिसे **आप** नियंत्रित करते हैं — कोई क्लाउड सेवा नहीं, कोई तृतीय-पक्ष स्टोरेज नहीं:
|
|
35
|
+
|
|
36
|
+
- **`/sync` कमांड** — `status` (ब्रांच, सैनिटाइज़ किया गया रिमोट, आगे/पीछे, गंदी फ़ाइलें, फ़ोर्क), `diff`, `log`, `pull`, `push`, `help`।
|
|
37
|
+
- **`sync_status` / `sync_pull` / `sync_push` टूल** — मॉडल के लिए वही सतह, एक टर्न के अंदर।
|
|
38
|
+
- **Append-only टकराव समाधान** — सत्र लॉग append-only होते हैं; किसी भी विचलन पर प्लगइन **दोनों** पक्ष रखता है (स्थानीय संस्करण रखा जाता है, रिमोट संस्करण फ़ोर्क फ़ाइलों के रूप में संरक्षित रहता है) और कभी चुपचाप ओवरराइट नहीं करता। विचलित सत्र सत्र-स्तर पर भी फ़ोर्क हो सकते हैं।
|
|
39
|
+
- **स्वचालित मोड** — स्टार्ट पर pull, हर बंद टर्न के बाद push, और आवधिक pull, सभी कॉन्फ़िगर करने योग्य और प्रतिवर्ती।
|
|
40
|
+
- **पुष्टि-गेटेड लेखन** — `pull`/`push` पहले पूछते हैं (`userQuestions` या `approval` के माध्यम से); केवल-पठन सतहें कभी नहीं पूछतीं; बिना उत्तरदाता के ऑपरेशन बंद-असफल होता है।
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
डिवाइस A रिमोट (आपका git रिपॉज़िटरी) डिवाइस B
|
|
44
|
+
$DSH_HOME/sessions ──मिरर──▶ commit ──push──▶ [sessions] ──pull──▶ merge (दोनों रखें + fork)
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## त्वरित शुरुआत
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
# 1. बंडल को अपने प्रोफ़ाइल में इंस्टॉल करें
|
|
51
|
+
dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main"
|
|
52
|
+
|
|
53
|
+
# या npm से (प्रकाशित संस्करण)
|
|
54
|
+
dsh plugin --profile web add dsh-session-sync
|
|
55
|
+
|
|
56
|
+
# 2. इसे एक निजी git रिमोट की ओर इंगित करें और पंक्ति सत्यापित करें
|
|
57
|
+
dsh --profile web --dump-config | grep -A2 'id: session-sync'
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
फिर अपने प्रोफ़ाइल पैच में रिमोट सेट करें (एक **निजी** रिपॉज़िटरी आधार है) और सिंक करें:
|
|
61
|
+
|
|
62
|
+
```yaml
|
|
63
|
+
- insert:
|
|
64
|
+
- id: session-sync
|
|
65
|
+
name: dsh-session-sync
|
|
66
|
+
config:
|
|
67
|
+
remote: git@github.com:you/your-dsh-sessions.git
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
> /sync status
|
|
72
|
+
> /sync pull
|
|
73
|
+
> /sync push
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## इंस्टॉल और अनइंस्टॉल
|
|
77
|
+
|
|
78
|
+
- **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main"` (`git+https://github.com/PerryLink/dsh-session-sync.git` से इंस्टॉल करने के बराबर)। कोई बिल्ड चरण नहीं — `index.mjs` और `lib/` ही प्रकाशित आर्टिफ़ैक्ट हैं।
|
|
79
|
+
- **npm चैनल** (प्रकाशित संस्करण): `dsh plugin --profile web add dsh-session-sync`।
|
|
80
|
+
- **tarball चैनल**: इस रिपॉज़िटरी में `pnpm pack` चलाएँ, फिर `dsh plugin --profile web add ./dsh-session-sync-<version>.tgz`।
|
|
81
|
+
- **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-session-sync` (या प्रोफ़ाइल पैच से पंक्ति हटाएँ)।
|
|
82
|
+
|
|
83
|
+
## कॉन्फ़िगरेशन
|
|
84
|
+
|
|
85
|
+
सभी ट्यूनेबल Schemastery `Config` फ़ील्ड हैं (cordis.yml से बदले जा सकते हैं)। id-लक्षित ओवरराइड पूरी पंक्ति को बदल देता है — जो कुंजियाँ चाहिए उन्हें दोबारा लिखें। `cordis.patch.yml` हर कुंजी को इनलाइन दस्तावेज़ित करता है।
|
|
86
|
+
|
|
87
|
+
| कुंजी | डिफ़ॉल्ट | अर्थ |
|
|
88
|
+
|---|---|---|
|
|
89
|
+
| `enabled` | `true` | मास्टर स्विच; `false` कमांड, टूल, लिसनर और स्वचालित मोड हटा देता है |
|
|
90
|
+
| `backend` | `git` | सिंक बैकएंड; केवल `git` लागू है (एन्क्रिप्टेड बैकएंड आरक्षित हैं और तेज़ी से असफल होते हैं) |
|
|
91
|
+
| `sessionRoot` | `''` | सत्र स्टोर रूट; खाली = `$DSH_HOME/sessions` (दोनों अनुपस्थित होने पर लोड असफल) |
|
|
92
|
+
| `repoDir` | `''` | सिंक वर्कट्री रूट; खाली = `$DSH_HOME/dsh-session-sync/repo` |
|
|
93
|
+
| `remote` | `''` | रिमोट पता (pull/push से पहले आवश्यक; status/diff इसके बिना काम करते हैं) |
|
|
94
|
+
| `branch` | `main` | रिमोट ब्रांच का नाम |
|
|
95
|
+
| `gitBin` | `git` | git एक्ज़ीक्यूटेबल पथ |
|
|
96
|
+
| `autoPullOnStart` | `false` | प्लगइन माउंट होने पर एक बार pull करें (कॉन्फ़िग ही अनुमति है; पुनः पुष्टि नहीं) |
|
|
97
|
+
| `autoPushOnTurnEnd` | `false` | हर बंद टर्न के बाद push करें |
|
|
98
|
+
| `pullIntervalMinutes` | `0` | हर N मिनट में आवधिक pull (`0` = बंद, अधिकतम `10080`) |
|
|
99
|
+
| `confirmVia` | `auto` | पुष्टि चैनल: `auto` (पहले userQuestions, फिर approval), `userQuestions`, `approval` |
|
|
100
|
+
| `graceMs` | `10000` | git को मारने की अनुग्रह अवधि (ms) |
|
|
101
|
+
| `commandTimeoutMs` | `120000` | प्रति-कमांड टाइमआउट (ms) |
|
|
102
|
+
| `maxOutputBytes` | `262144` | प्रति-स्ट्रीम एकत्रित आउटपुट सीमा (बाइट्स) |
|
|
103
|
+
| `commitName` | `dsh-session-sync` | कमिट लेखक नाम |
|
|
104
|
+
| `commitEmail` | `dsh-session-sync@localhost` | कमिट लेखक ईमेल |
|
|
105
|
+
| `registerCommand` | `true` | `/sync` कमांड पंजीकृत करें |
|
|
106
|
+
| `registerTools` | `true` | tools सेवा उपस्थित होने पर `sync_*` टूल पंजीकृत करें |
|
|
107
|
+
|
|
108
|
+
आपके प्रोफ़ाइल पैच में ओवरराइड का उदाहरण:
|
|
109
|
+
|
|
110
|
+
```yaml
|
|
111
|
+
- insert:
|
|
112
|
+
- id: session-sync
|
|
113
|
+
name: dsh-session-sync
|
|
114
|
+
config:
|
|
115
|
+
remote: git@github.com:you/your-dsh-sessions.git
|
|
116
|
+
branch: main
|
|
117
|
+
autoPushOnTurnEnd: true
|
|
118
|
+
pullIntervalMinutes: 30
|
|
119
|
+
confirmVia: userQuestions
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## टूल और सतहें
|
|
123
|
+
|
|
124
|
+
| सतह | केवल-पठन | पुष्टि आवश्यक | नोट्स |
|
|
125
|
+
|---|---|---|---|
|
|
126
|
+
| `/sync status` | ✅ | — | ब्रांच, सैनिटाइज़ किया रिमोट, आगे/पीछे, गंदी फ़ाइलें, फ़ोर्क फ़ाइलें, अंतिम pull/push |
|
|
127
|
+
| `/sync diff` | ✅ | — | अनकमिटेड बदलाव + `HEAD..remote` आँकड़े (केवल-पठन) |
|
|
128
|
+
| `/sync log` | ✅ | — | सिंक रिपॉज़िटरी के अंतिम कमिट |
|
|
129
|
+
| `/sync pull` | | ✅ | Fetch + merge दोनों-रखें अर्थ के साथ; स्थानीय रखा जाता है, रिमोट फ़ोर्क के रूप में संरक्षित |
|
|
130
|
+
| `/sync push` | | ✅ | मिरर + commit + push; कभी force-push नहीं करता, अस्वीकृति पर एक बार सुलह करके पुनः प्रयास |
|
|
131
|
+
| `sync_status` | ✅ | — | मॉडल के लिए `/sync status` जैसे ही तथ्य |
|
|
132
|
+
| `sync_pull` | | ✅ | मॉडल-कॉल करने योग्य pull |
|
|
133
|
+
| `sync_push` | | ✅ | मॉडल-कॉल करने योग्य push |
|
|
134
|
+
|
|
135
|
+
## अनुमतियाँ और डेटा
|
|
136
|
+
|
|
137
|
+
- **अनुमतियाँ**: परिवर्तनकारी ऑपरेशन पुष्टि द्वार (`confirmVia`) को पार करते हैं; प्लगइन कभी भी हार्नेस की `userQuestions`/`approval` सेवाओं को फिर से लागू या बायपास नहीं करता। स्वचालित मोड कॉन्फ़िग अनुदान से आच्छादित हैं और कभी पुनः पुष्टि नहीं करते।
|
|
138
|
+
- **डेटा**: सिंक मेटाडेटा (डिवाइस id, अंतिम pull/push, अंतिम push head, अंतिम त्रुटि) `session-sync` स्टोरेज डोमेन में रहता है। सत्र फ़ाइलें अपारदर्शी बाइट्स के रूप में कॉपी होती हैं — प्लगइन उन्हें कभी पार्स नहीं करता। डिवाइस id क्रॉस-डिवाइस फ़ोर्क श्रेय के लिए सिंक रिपॉज़िटरी में `device.txt` में भी लिखा जाता है।
|
|
139
|
+
- **सत्र लॉग**: `sync/push`, `sync/pull`, और `sync/conflict` `types.d.ts` में घोषित हैं; वे केवल तभी जोड़े जाते हैं जब होस्ट प्रकारों को पंजीकृत करता है (ज्ञात सीमाएँ देखें)। जो कुछ भी लिखा या दिखाया जाता है वह सैनिटाइज़ किया जाता है।
|
|
140
|
+
|
|
141
|
+
## सुरक्षा सीमाएँ
|
|
142
|
+
|
|
143
|
+
- **कभी चुपचाप ओवरराइट नहीं।** Append-only तीन-तरफ़ा मर्ज किसी भी विचलन पर दोनों पक्ष रखता है; फ़ोर्क फ़ाइलें कभी नहीं हटतीं, और git कभी force-push, reset, rebase या ब्रांच स्विच नहीं करता।
|
|
144
|
+
- **पथ संरोधन।** फ़ाइलें अपारदर्शी बाइट्स के रूप में मिरर होती हैं, सिमलिंक अस्वीकृत होते हैं, और हर जोड़े गए पथ की संरोधन जाँच होती है (`PATH_UNSAFE` तेज़ी से असफल)।
|
|
145
|
+
- **सैनिटाइज़ किया आउटपुट।** रिमोट-URL क्रेडेंशियल, टोकन और `key=value` रहस्य मॉडल या लॉग तक पहुँचने से पहले हटा दिए जाते हैं; पथ प्रदर्शन अपनी रूट के बाहर सब कुछ अस्वीकार करता है।
|
|
146
|
+
- **कोई क्रेडेंशियल स्टोरेज नहीं।** प्लगइन स्वयं कोई क्रेडेंशियल संग्रहीत नहीं करता; git क्रेडेंशियल आपके सामान्य git credential helper में रहते हैं। आरक्षित एंड-टू-एंड एन्क्रिप्शन बैकएंड लागू नहीं है और कुंजियाँ कभी सिंक रिपॉज़िटरी में नहीं जातीं।
|
|
147
|
+
- **git कठोरीकरण।** git `GIT_TERMINAL_PROMPT=0` और `GIT_OPTIONAL_LOCKS=0` के साथ चलता है, समय-सीमा और सिग्नल से सीमित, प्रति-स्ट्रीम आउटपुट सीमा के साथ।
|
|
148
|
+
- **बंद-असफल।** पुष्टि उत्तरदाता, रिमोट की अनुपस्थिति, या असुरक्षित पथ ऑपरेशन को तेज़ी से अस्वीकार करता है।
|
|
149
|
+
|
|
150
|
+
## ज्ञात सीमाएँ
|
|
151
|
+
|
|
152
|
+
- **केवल git बैकएंड।** एंड-टू-एंड एन्क्रिप्शन बैकएंड (age/GPG शैली) आरक्षित हैं लेकिन लागू नहीं; एक को कॉन्फ़िगर करना लोड पर तेज़ी से असफल होता है। तब तक, सत्र बाइट्स **आपके** git रिमोट में अनएन्क्रिप्टेड रहते हैं — एक निजी रिपॉज़िटरी का उपयोग करें।
|
|
153
|
+
- **git आवश्यक।** प्लगइन को `git` एक्ज़ीक्यूटेबल और `subprocess` सेवा चाहिए; उनके बिना, सिंक ऑपरेशन स्पष्ट कारण से असफल होते हैं (प्रोफ़ाइलें बूट होती रहती हैं)।
|
|
154
|
+
- **`0.1.0-rc.6` पर सत्र ईवेंट।** हार्नेस अभी `sync/*` प्रकार पंजीकृत नहीं करता, इसलिए rc.6 पर सत्र-लॉग जोड़ छोड़ दिए जाते हैं (सत्र लोड होते रहते हैं); प्लगइन उन्हें स्वतः सक्षम करता है जब कोई होस्ट प्रकार पंजीकृत करता है या `ignorable` लिफ़ाफ़े का समर्थन करता है।
|
|
155
|
+
- **टर्न के बीच `approval`।** `/sync` टर्न के बीच चलता है, जहाँ `approval` चैनल के पास जोड़ने के लिए कोई खुला टर्न नहीं होता; कमांड-संचालित सिंक के लिए `confirmVia: userQuestions` का उपयोग करें, या टर्न के अंदर टूल द्वारा सिंक चलाएँ।
|
|
156
|
+
|
|
157
|
+
## विकास
|
|
158
|
+
|
|
159
|
+
```sh
|
|
160
|
+
pnpm install # node ^22.19 || >=24
|
|
161
|
+
pnpm run typecheck && pnpm run typecheck:ci # प्रकाशित rc.6 peers के विरुद्ध tsc --checkJs
|
|
162
|
+
pnpm test # node --test (6 सुइट; git सुइट बिना git के छोड़े जाते हैं)
|
|
163
|
+
pnpm run verify:self-contained # निर्भरता spec रजिस्ट्री से हल होती हैं
|
|
164
|
+
pnpm run verify:artifacts # प्रकाशित फ़ाइलें उपस्थित + index.mjs import योग्य
|
|
165
|
+
pnpm run check:readmes # पाँच-भाषा README संगतता
|
|
166
|
+
pnpm pack # प्रकाशित tarball
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
कोई बिल्ड चरण नहीं: शुद्ध ESM, `index.mjs` और `lib/` ही प्रकाशित आर्टिफ़ैक्ट हैं।
|
|
170
|
+
|
|
171
|
+
## Topics
|
|
172
|
+
|
|
173
|
+
`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
|
|
174
|
+
|
|
175
|
+
## योगदानकर्ता
|
|
176
|
+
|
|
177
|
+
- [@PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: git मिरर इंजन, append-only दोनों-रखें मर्ज, `/sync` कमांड और `sync_*` टूल, स्वचालित मोड, सैनिटाइज़र, और पाँच-भाषा दस्तावेज़।
|
|
178
|
+
|
|
179
|
+
## लाइसेंस
|
|
180
|
+
|
|
181
|
+
[LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-session-sync contributors
|
package/README.md
ADDED
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
# dsh-session-sync
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+
**Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.**
|
|
6
|
+
|
|
7
|
+
*Sync your sessions between devices, keep both sides on any conflict, never lose a turn.*
|
|
8
|
+
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-session-sync/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-session-sync/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-session-sync)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-session-sync)
|
|
16
|
+
|
|
17
|
+
[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Compatibility
|
|
24
|
+
|
|
25
|
+
| Surface | Status |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Harness | DeepSeek Harness `0.1.0-rc.6` |
|
|
28
|
+
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
29
|
+
| Platforms | Anywhere `git` and DSH run (git-based mirror; no platform-specific code) |
|
|
30
|
+
| Model | Text-only models fully supported; no vision or extra model capability required |
|
|
31
|
+
|
|
32
|
+
## What you get
|
|
33
|
+
|
|
34
|
+
`dsh-session-sync` mirrors your DSH session store into a dedicated git worktree and syncs it to a remote **you** control — no cloud service, no third-party storage:
|
|
35
|
+
|
|
36
|
+
- **`/sync` command** — `status` (branch, sanitized remote, ahead/behind, dirty files, forks), `diff`, `log`, `pull`, `push`, `help`.
|
|
37
|
+
- **`sync_status` / `sync_pull` / `sync_push` tools** — the same surface for the model, inside a turn.
|
|
38
|
+
- **Append-only conflict resolution** — session logs are append-only; on any divergence the plugin keeps **both** sides (local version kept, remote version preserved as fork files) and never silently overwrites. Diverged sessions can also fork at the session level.
|
|
39
|
+
- **Auto modes** — pull on start, push after every closed turn, and periodic pull, all configurable and all reversible.
|
|
40
|
+
- **Confirmation-gated writes** — `pull`/`push` ask first (through `userQuestions` or `approval`); read-only surfaces never ask; with no answerer the operation fails closed.
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
device A remote (your git repo) device B
|
|
44
|
+
$DSH_HOME/sessions ──mirror──▶ commit ──push──▶ [sessions] ──pull──▶ merge (keep-both + fork)
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Quick start
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
# 1. install the bundle into your profile
|
|
51
|
+
dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main"
|
|
52
|
+
|
|
53
|
+
# or from npm (published releases)
|
|
54
|
+
dsh plugin --profile web add dsh-session-sync
|
|
55
|
+
|
|
56
|
+
# 2. point it at a private git remote and verify the row
|
|
57
|
+
dsh --profile web --dump-config | grep -A2 'id: session-sync'
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Then set the remote in your profile patch (a **private** repository is the baseline) and sync:
|
|
61
|
+
|
|
62
|
+
```yaml
|
|
63
|
+
- insert:
|
|
64
|
+
- id: session-sync
|
|
65
|
+
name: dsh-session-sync
|
|
66
|
+
config:
|
|
67
|
+
remote: git@github.com:you/your-dsh-sessions.git
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
> /sync status
|
|
72
|
+
> /sync pull
|
|
73
|
+
> /sync push
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Install & uninstall
|
|
77
|
+
|
|
78
|
+
- **git channel** (latest `main`): `dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main"` (equivalent to installing from `git+https://github.com/PerryLink/dsh-session-sync.git`). No build step — `index.mjs` and `lib/` are the shipped artifacts.
|
|
79
|
+
- **npm channel** (published releases): `dsh plugin --profile web add dsh-session-sync`.
|
|
80
|
+
- **tarball channel**: `pnpm pack` in this repo, then `dsh plugin --profile web add ./dsh-session-sync-<version>.tgz`.
|
|
81
|
+
- **uninstall**: `dsh plugin --profile web remove dsh-session-sync` (or remove the row from the profile patch).
|
|
82
|
+
|
|
83
|
+
## Configuration
|
|
84
|
+
|
|
85
|
+
All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id-targeted override replaces the whole row — restate every key you need. `cordis.patch.yml` documents each key inline.
|
|
86
|
+
|
|
87
|
+
| Key | Default | Meaning |
|
|
88
|
+
|---|---|---|
|
|
89
|
+
| `enabled` | `true` | Master switch; `false` unregisters the command, tools, listeners, and auto modes |
|
|
90
|
+
| `backend` | `git` | Sync backend; only `git` is implemented (encrypted backends are reserved and fail loud) |
|
|
91
|
+
| `sessionRoot` | `''` | Session store root; empty = `$DSH_HOME/sessions` (both missing fails load) |
|
|
92
|
+
| `repoDir` | `''` | Sync worktree root; empty = `$DSH_HOME/dsh-session-sync/repo` |
|
|
93
|
+
| `remote` | `''` | Remote address (required before pull/push; status/diff work without one) |
|
|
94
|
+
| `branch` | `main` | Remote branch name |
|
|
95
|
+
| `gitBin` | `git` | git executable path |
|
|
96
|
+
| `autoPullOnStart` | `false` | Pull once when the plugin mounts (config is the grant; no re-confirm) |
|
|
97
|
+
| `autoPushOnTurnEnd` | `false` | Push after every closed turn |
|
|
98
|
+
| `pullIntervalMinutes` | `0` | Periodic pull every N minutes (`0` = off, max `10080`) |
|
|
99
|
+
| `confirmVia` | `auto` | Confirmation channel: `auto` (userQuestions first, then approval), `userQuestions`, `approval` |
|
|
100
|
+
| `graceMs` | `10000` | Grace period for git kills (ms) |
|
|
101
|
+
| `commandTimeoutMs` | `120000` | Per-command timeout (ms) |
|
|
102
|
+
| `maxOutputBytes` | `262144` | Per-stream collected-output cap (bytes) |
|
|
103
|
+
| `commitName` | `dsh-session-sync` | Commit author name |
|
|
104
|
+
| `commitEmail` | `dsh-session-sync@localhost` | Commit author email |
|
|
105
|
+
| `registerCommand` | `true` | Register the `/sync` command |
|
|
106
|
+
| `registerTools` | `true` | Register the `sync_*` tools when the tools service is present |
|
|
107
|
+
|
|
108
|
+
Example override in your profile patch:
|
|
109
|
+
|
|
110
|
+
```yaml
|
|
111
|
+
- insert:
|
|
112
|
+
- id: session-sync
|
|
113
|
+
name: dsh-session-sync
|
|
114
|
+
config:
|
|
115
|
+
remote: git@github.com:you/your-dsh-sessions.git
|
|
116
|
+
branch: main
|
|
117
|
+
autoPushOnTurnEnd: true
|
|
118
|
+
pullIntervalMinutes: 30
|
|
119
|
+
confirmVia: userQuestions
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Tools & surfaces
|
|
123
|
+
|
|
124
|
+
| Surface | Read-only | Needs confirmation | Notes |
|
|
125
|
+
|---|---|---|---|
|
|
126
|
+
| `/sync status` | ✅ | — | Branch, sanitized remote, ahead/behind, dirty files, fork files, last pull/push |
|
|
127
|
+
| `/sync diff` | ✅ | — | Uncommitted changes + `HEAD..remote` stat (read-only) |
|
|
128
|
+
| `/sync log` | ✅ | — | Last commits in the sync repository |
|
|
129
|
+
| `/sync pull` | | ✅ | Fetch + merge with keep-both semantics; local kept, remote preserved as forks |
|
|
130
|
+
| `/sync push` | | ✅ | Mirror + commit + push; never force-pushes, reconciles and retries once on rejection |
|
|
131
|
+
| `sync_status` | ✅ | — | Same facts as `/sync status` for the model |
|
|
132
|
+
| `sync_pull` | | ✅ | Model-callable pull |
|
|
133
|
+
| `sync_push` | | ✅ | Model-callable push |
|
|
134
|
+
|
|
135
|
+
## Permissions & data
|
|
136
|
+
|
|
137
|
+
- **Permissions**: mutating operations cross the confirmation gate (`confirmVia`); the plugin never re-implements or bypasses the harness's `userQuestions`/`approval` services. Auto modes are covered by the config grant and never re-confirm.
|
|
138
|
+
- **Data**: sync metadata (device id, last pull/push, last push head, last error) lives in the `session-sync` storage domain. Session files are copied as opaque bytes — the plugin never parses them. The device id is also written to `device.txt` in the sync repository for cross-device fork attribution.
|
|
139
|
+
- **Session log**: `sync/push`, `sync/pull`, and `sync/conflict` are declared in `types.d.ts`; they are appended only when the host records the types (see Known limitations). Everything written or shown is sanitized.
|
|
140
|
+
|
|
141
|
+
## Security boundaries
|
|
142
|
+
|
|
143
|
+
- **Never silently overwrite.** The append-only three-way merge keeps both sides on any divergence; fork files are never deleted, and git never force-pushes, resets, rebases, or switches branches.
|
|
144
|
+
- **Path containment.** Files are mirrored as opaque bytes with symlinks refused and every joined path containment-checked (`PATH_UNSAFE` fails loud).
|
|
145
|
+
- **Sanitized output.** Remote-URL credentials, tokens, and `key=value` secrets are redacted before reaching the model or the log; path display refuses anything outside its root.
|
|
146
|
+
- **No credential storage.** The plugin stores no credentials; git credentials live in your normal git credential helper. The reserved end-to-end-encryption backend is unimplemented and keys never enter the sync repository.
|
|
147
|
+
- **Git hardening.** Git runs with `GIT_TERMINAL_PROMPT=0` and `GIT_OPTIONAL_LOCKS=0`, deadline- and signal-bounded, with a per-stream output cap.
|
|
148
|
+
- **Fail closed.** A missing confirmation answerer, a missing remote, or an unsafe path refuses the operation loudly.
|
|
149
|
+
|
|
150
|
+
## Known limitations
|
|
151
|
+
|
|
152
|
+
- **git backend only.** End-to-end-encryption backends (age/GPG-style) are reserved but not implemented; configuring one fails loudly at load. Until then, session bytes are stored unencrypted in **your** git remote — use a private repository.
|
|
153
|
+
- **git required.** The plugin needs the `git` executable and the `subprocess` service; without them, sync operations fail with a clear reason (profiles keep booting).
|
|
154
|
+
- **Session events on `0.1.0-rc.6`.** The harness does not yet record `sync/*` event types, so on rc.6 the session-log appends are skipped (sessions keep loading); the plugin enables them automatically once a host records the types or supports the `ignorable` envelope.
|
|
155
|
+
- **`approval` between turns.** `/sync` runs between turns, where the `approval` channel has no open turn to attach to; use `confirmVia: userQuestions` for command-driven sync, or drive sync through the tools inside a turn.
|
|
156
|
+
|
|
157
|
+
## Development
|
|
158
|
+
|
|
159
|
+
```sh
|
|
160
|
+
pnpm install # node ^22.19 || >=24
|
|
161
|
+
pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs against the published rc.6 peers
|
|
162
|
+
pnpm test # node --test (6 suites; git suites skip without git)
|
|
163
|
+
pnpm run verify:self-contained # dependency specs resolve from the registry
|
|
164
|
+
pnpm run verify:artifacts # shipped files present + index.mjs importable
|
|
165
|
+
pnpm run check:readmes # five-language README consistency
|
|
166
|
+
pnpm pack # the published tarball
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
There is no build step: pure ESM, `index.mjs` and `lib/` are the shipped artifacts.
|
|
170
|
+
|
|
171
|
+
## Topics
|
|
172
|
+
|
|
173
|
+
`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
|
|
174
|
+
|
|
175
|
+
## Contributors
|
|
176
|
+
|
|
177
|
+
- [@PerryLink](https://github.com/PerryLink) — creator and maintainer: git mirror engine, append-only keep-both merge, `/sync` command and `sync_*` tools, auto modes, sanitizers, and the five-language docs.
|
|
178
|
+
|
|
179
|
+
## License
|
|
180
|
+
|
|
181
|
+
[LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-session-sync contributors
|
package/README.pt.md
ADDED
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
# dsh-session-sync
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+
**Sincronização de sessões entre dispositivos para o DeepSeek Harness — um espelho git dedicado do seu armazenamento de sessões.**
|
|
6
|
+
|
|
7
|
+
*Sincronize suas sessões entre dispositivos, mantenha os dois lados em qualquer conflito, nunca perca um turno.*
|
|
8
|
+
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-session-sync/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-session-sync/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-session-sync)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-session-sync)
|
|
16
|
+
|
|
17
|
+
[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Compatibilidade
|
|
24
|
+
|
|
25
|
+
| Superfície | Status |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Harness | DeepSeek Harness `0.1.0-rc.6` |
|
|
28
|
+
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
29
|
+
| Plataformas | Qualquer lugar onde `git` e o DSH rodem (espelho baseado em git; sem código específico de plataforma) |
|
|
30
|
+
| Modelo | Modelos somente texto são totalmente suportados; sem necessidade de visão ou capacidade extra |
|
|
31
|
+
|
|
32
|
+
## O que você obtém
|
|
33
|
+
|
|
34
|
+
O `dsh-session-sync` espelha o seu armazenamento de sessões do DSH em uma árvore de trabalho git dedicada e o sincroniza com um remoto que **você** controla — sem serviço em nuvem, sem armazenamento de terceiros:
|
|
35
|
+
|
|
36
|
+
- **Comando `/sync`** — `status` (branch, remoto higienizado, à frente/atrás, arquivos sujos, forks), `diff`, `log`, `pull`, `push`, `help`.
|
|
37
|
+
- **Ferramentas `sync_status` / `sync_pull` / `sync_push`** — a mesma superfície para o modelo, dentro de um turno.
|
|
38
|
+
- **Resolução de conflitos append-only** — os registros de sessão são append-only; em qualquer divergência o plugin mantém **os dois** lados (a versão local é mantida, a remota é preservada como arquivos fork) e nunca sobrescreve em silêncio. Sessões divergentes também podem bifurcar no nível da sessão.
|
|
39
|
+
- **Modos automáticos** — pull ao iniciar, push após cada turno fechado e pull periódico, todos configuráveis e reversíveis.
|
|
40
|
+
- **Escritas com confirmação** — `pull`/`push` perguntam primeiro (via `userQuestions` ou `approval`); superfícies somente leitura nunca perguntam; sem respondedor a operação falha fechada.
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
dispositivo A remoto (seu repositório git) dispositivo B
|
|
44
|
+
$DSH_HOME/sessions ──espelho──▶ commit ──push──▶ [sessions] ──pull──▶ merge (manter ambos + fork)
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Início rápido
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
# 1. instale o bundle no seu perfil
|
|
51
|
+
dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main"
|
|
52
|
+
|
|
53
|
+
# ou pelo npm (versões publicadas)
|
|
54
|
+
dsh plugin --profile web add dsh-session-sync
|
|
55
|
+
|
|
56
|
+
# 2. aponte-o para um remoto git privado e verifique a linha
|
|
57
|
+
dsh --profile web --dump-config | grep -A2 'id: session-sync'
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Depois defina o remoto no seu patch de perfil (um repositório **privado** é a base) e sincronize:
|
|
61
|
+
|
|
62
|
+
```yaml
|
|
63
|
+
- insert:
|
|
64
|
+
- id: session-sync
|
|
65
|
+
name: dsh-session-sync
|
|
66
|
+
config:
|
|
67
|
+
remote: git@github.com:you/your-dsh-sessions.git
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
> /sync status
|
|
72
|
+
> /sync pull
|
|
73
|
+
> /sync push
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Instalação e desinstalação
|
|
77
|
+
|
|
78
|
+
- **Canal git** (último `main`): `dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main"` (equivalente a instalar de `git+https://github.com/PerryLink/dsh-session-sync.git`). Sem etapa de compilação — `index.mjs` e `lib/` são os artefatos publicados.
|
|
79
|
+
- **Canal npm** (versões publicadas): `dsh plugin --profile web add dsh-session-sync`.
|
|
80
|
+
- **Canal tarball**: `pnpm pack` neste repositório, depois `dsh plugin --profile web add ./dsh-session-sync-<version>.tgz`.
|
|
81
|
+
- **Desinstalar**: `dsh plugin --profile web remove dsh-session-sync` (ou remova a linha do patch de perfil).
|
|
82
|
+
|
|
83
|
+
## Configuração
|
|
84
|
+
|
|
85
|
+
Todos os ajustes são campos de `Config` do Schemastery (alteráveis pelo cordis.yml). Uma sobrescrita direcionada por id substitui a linha inteira — repita cada chave de que você precisa. O `cordis.patch.yml` documenta cada chave em linha.
|
|
86
|
+
|
|
87
|
+
| Chave | Padrão | Significado |
|
|
88
|
+
|---|---|---|
|
|
89
|
+
| `enabled` | `true` | Interruptor mestre; `false` remove comando, ferramentas, ouvintes e modos automáticos |
|
|
90
|
+
| `backend` | `git` | Backend de sincronização; somente `git` está implementado (backends criptografados são reservados e falham alto) |
|
|
91
|
+
| `sessionRoot` | `''` | Raiz do armazenamento de sessões; vazio = `$DSH_HOME/sessions` (ambos ausentes falha o carregamento) |
|
|
92
|
+
| `repoDir` | `''` | Raiz da árvore de trabalho; vazio = `$DSH_HOME/dsh-session-sync/repo` |
|
|
93
|
+
| `remote` | `''` | Endereço remoto (obrigatório antes de pull/push; status/diff funcionam sem ele) |
|
|
94
|
+
| `branch` | `main` | Nome da branch remota |
|
|
95
|
+
| `gitBin` | `git` | Caminho do executável git |
|
|
96
|
+
| `autoPullOnStart` | `false` | Faz pull uma vez quando o plugin monta (a configuração é a concessão; sem reconfirmar) |
|
|
97
|
+
| `autoPushOnTurnEnd` | `false` | Faz push após cada turno fechado |
|
|
98
|
+
| `pullIntervalMinutes` | `0` | Pull periódico a cada N minutos (`0` = desligado, máx. `10080`) |
|
|
99
|
+
| `confirmVia` | `auto` | Canal de confirmação: `auto` (userQuestions primeiro, depois approval), `userQuestions`, `approval` |
|
|
100
|
+
| `graceMs` | `10000` | Período de graça para matar git (ms) |
|
|
101
|
+
| `commandTimeoutMs` | `120000` | Tempo limite por comando (ms) |
|
|
102
|
+
| `maxOutputBytes` | `262144` | Limite de saída coletada por fluxo (bytes) |
|
|
103
|
+
| `commitName` | `dsh-session-sync` | Nome do autor do commit |
|
|
104
|
+
| `commitEmail` | `dsh-session-sync@localhost` | E-mail do autor do commit |
|
|
105
|
+
| `registerCommand` | `true` | Registra o comando `/sync` |
|
|
106
|
+
| `registerTools` | `true` | Registra as ferramentas `sync_*` quando o serviço tools está presente |
|
|
107
|
+
|
|
108
|
+
Exemplo de sobrescrita no seu patch de perfil:
|
|
109
|
+
|
|
110
|
+
```yaml
|
|
111
|
+
- insert:
|
|
112
|
+
- id: session-sync
|
|
113
|
+
name: dsh-session-sync
|
|
114
|
+
config:
|
|
115
|
+
remote: git@github.com:you/your-dsh-sessions.git
|
|
116
|
+
branch: main
|
|
117
|
+
autoPushOnTurnEnd: true
|
|
118
|
+
pullIntervalMinutes: 30
|
|
119
|
+
confirmVia: userQuestions
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Ferramentas e superfícies
|
|
123
|
+
|
|
124
|
+
| Superfície | Somente leitura | Requer confirmação | Notas |
|
|
125
|
+
|---|---|---|---|
|
|
126
|
+
| `/sync status` | ✅ | — | Branch, remoto higienizado, à frente/atrás, arquivos sujos, arquivos fork, último pull/push |
|
|
127
|
+
| `/sync diff` | ✅ | — | Alterações não commitadas + estatística `HEAD..remote` (somente leitura) |
|
|
128
|
+
| `/sync log` | ✅ | — | Últimos commits do repositório de sincronização |
|
|
129
|
+
| `/sync pull` | | ✅ | Fetch + merge com semântica de manter ambos; local mantido, remoto preservado como forks |
|
|
130
|
+
| `/sync push` | | ✅ | Espelho + commit + push; nunca força push, reconcilia e tenta novamente uma vez em rejeição |
|
|
131
|
+
| `sync_status` | ✅ | — | Os mesmos fatos que `/sync status` para o modelo |
|
|
132
|
+
| `sync_pull` | | ✅ | Pull invocável pelo modelo |
|
|
133
|
+
| `sync_push` | | ✅ | Push invocável pelo modelo |
|
|
134
|
+
|
|
135
|
+
## Permissões e dados
|
|
136
|
+
|
|
137
|
+
- **Permissões**: operações mutadoras cruzam a porta de confirmação (`confirmVia`); o plugin nunca reimplementa nem contorna os serviços `userQuestions`/`approval` do harness. Os modos automáticos são cobertos pela concessão de configuração e nunca reconfirmam.
|
|
138
|
+
- **Dados**: os metadados de sincronização (id de dispositivo, último pull/push, última cabeça de push, último erro) vivem no domínio de armazenamento `session-sync`. Os arquivos de sessão são copiados como bytes opacos — o plugin nunca os analisa. O id de dispositivo também é gravado em `device.txt` no repositório de sincronização para atribuição de forks entre dispositivos.
|
|
139
|
+
- **Registro de sessão**: `sync/push`, `sync/pull` e `sync/conflict` estão declarados em `types.d.ts`; eles são anexados somente quando o host registra os tipos (veja Limitações conhecidas). Tudo o que é gravado ou exibido é higienizado.
|
|
140
|
+
|
|
141
|
+
## Limites de segurança
|
|
142
|
+
|
|
143
|
+
- **Nunca sobrescreve em silêncio.** O merge de três vias append-only mantém os dois lados em qualquer divergência; arquivos fork nunca são excluídos e o git nunca força push, reset, rebase ou troca de branch.
|
|
144
|
+
- **Contenção de caminhos.** Os arquivos são espelhados como bytes opacos com links simbólicos recusados e cada caminho unido é verificado por contenção (`PATH_UNSAFE` falha alto).
|
|
145
|
+
- **Saída higienizada.** Credenciais de URL remota, tokens e segredos `key=value` são redigidos antes de chegar ao modelo ou ao registro; a exibição de caminhos recusa tudo fora de sua raiz.
|
|
146
|
+
- **Sem armazenamento de credenciais.** O plugin não armazena credenciais; as credenciais git vivem no seu helper de credenciais normal. O backend de criptografia de ponta a ponta reservado não está implementado e as chaves nunca entram no repositório de sincronização.
|
|
147
|
+
- **Endurecimento do git.** O git roda com `GIT_TERMINAL_PROMPT=0` e `GIT_OPTIONAL_LOCKS=0`, limitado por prazo e sinal, com um limite de saída por fluxo.
|
|
148
|
+
- **Falha fechada.** A ausência de respondedor de confirmação, de remoto ou um caminho inseguro recusa a operação alto.
|
|
149
|
+
|
|
150
|
+
## Limitações conhecidas
|
|
151
|
+
|
|
152
|
+
- **Somente backend git.** Backends de criptografia de ponta a ponta (estilo age/GPG) estão reservados mas não implementados; configurar um falha alto ao carregar. Até lá, os bytes da sessão são armazenados sem criptografia no **seu** remoto git — use um repositório privado.
|
|
153
|
+
- **git é necessário.** O plugin precisa do executável `git` e do serviço `subprocess`; sem eles, as operações de sincronização falham com um motivo claro (os perfis continuam iniciando).
|
|
154
|
+
- **Eventos de sessão no `0.1.0-rc.6`.** O harness ainda não registra os tipos `sync/*`, então no rc.6 os anexos ao registro de sessão são omitidos (as sessões continuam carregando); o plugin os habilita automaticamente quando um host registra os tipos ou suporta o envoltório `ignorable`.
|
|
155
|
+
- **`approval` entre turnos.** `/sync` roda entre turnos, onde o canal `approval` não tem um turno aberto para se anexar; use `confirmVia: userQuestions` para sincronização por comando, ou conduza a sincronização pelas ferramentas dentro de um turno.
|
|
156
|
+
|
|
157
|
+
## Desenvolvimento
|
|
158
|
+
|
|
159
|
+
```sh
|
|
160
|
+
pnpm install # node ^22.19 || >=24
|
|
161
|
+
pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs contra os peers rc.6 publicados
|
|
162
|
+
pnpm test # node --test (6 suites; suites git são omitidas sem git)
|
|
163
|
+
pnpm run verify:self-contained # as specs de dependência resolvem do registro
|
|
164
|
+
pnpm run verify:artifacts # arquivos publicados presentes + index.mjs importável
|
|
165
|
+
pnpm run check:readmes # consistência dos cinco README
|
|
166
|
+
pnpm pack # o tarball publicado
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
Não há etapa de compilação: ESM puro, `index.mjs` e `lib/` são os artefatos publicados.
|
|
170
|
+
|
|
171
|
+
## Topics
|
|
172
|
+
|
|
173
|
+
`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
|
|
174
|
+
|
|
175
|
+
## Contribuidores
|
|
176
|
+
|
|
177
|
+
- [@PerryLink](https://github.com/PerryLink) — criador e mantenedor: motor de espelho git, merge append-only mantendo ambos, comando `/sync` e ferramentas `sync_*`, modos automáticos, higienizadores e a documentação em cinco idiomas.
|
|
178
|
+
|
|
179
|
+
## Licença
|
|
180
|
+
|
|
181
|
+
[LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-session-sync contributors
|