dsh-manage-session 0.5.1 → 0.5.4

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.
Files changed (63) hide show
  1. package/CHANGELOG.ja.md +207 -242
  2. package/CHANGELOG.ko.md +207 -242
  3. package/CHANGELOG.md +341 -341
  4. package/INSTALL.ja.md +164 -179
  5. package/INSTALL.ko.md +164 -179
  6. package/INSTALL.md +164 -179
  7. package/INSTALL.zh.md +164 -179
  8. package/LICENSE +21 -21
  9. package/README.en.md +4 -12
  10. package/README.ja.md +0 -12
  11. package/README.ko.md +0 -12
  12. package/README.md +4 -14
  13. package/cordis.patch.yml +16 -11
  14. package/dsh.plugin.json +4 -4
  15. package/lib/client.js +3882 -690
  16. package/lib/index.d.ts +759 -29
  17. package/lib/index.js +2604 -93
  18. package/locale/de.json +6 -0
  19. package/locale/en.json +6 -0
  20. package/locale/es.json +6 -0
  21. package/locale/fr.json +6 -0
  22. package/locale/it.json +6 -0
  23. package/locale/ja.json +6 -0
  24. package/locale/ko.json +6 -0
  25. package/locale/ru.json +6 -0
  26. package/locale/zh.json +6 -0
  27. package/package.json +43 -32
  28. package/src/client/bridge-scope.ts +213 -0
  29. package/src/client/card.tsx +150 -150
  30. package/src/client/history-panel.tsx +319 -319
  31. package/src/client/index.ts +465 -354
  32. package/src/client/locales.ts +857 -698
  33. package/src/client/panel.tsx +139 -118
  34. package/src/client/search/card.tsx +563 -0
  35. package/src/client/search/host-api.ts +208 -0
  36. package/src/client/search/locales.ts +780 -0
  37. package/src/client/search/manage.tsx +400 -0
  38. package/src/client/search/panel.tsx +815 -0
  39. package/src/client/search/platform.ts +136 -0
  40. package/src/config.ts +82 -33
  41. package/src/host/health/attribution.ts +118 -118
  42. package/src/host/health/lossless.ts +128 -128
  43. package/src/host/health/source-kind.ts +350 -350
  44. package/src/host/history/archive-source.ts +250 -202
  45. package/src/host/history/archive.ts +249 -194
  46. package/src/host/history/favorites.ts +71 -0
  47. package/src/host/history/purge.ts +370 -370
  48. package/src/host/index/archive-source.ts +90 -0
  49. package/src/host/index/engine.ts +571 -0
  50. package/src/host/index/extract.ts +272 -0
  51. package/src/host/index/peers.ts +62 -0
  52. package/src/host/index/rebuild.ts +368 -0
  53. package/src/host/index/schema.ts +136 -0
  54. package/src/host/index/snapshot.ts +135 -0
  55. package/src/host/index/sync.ts +286 -0
  56. package/src/host/registry/archive-registry.ts +317 -0
  57. package/src/host/settings-bridge.ts +237 -0
  58. package/src/index.ts +1421 -532
  59. package/README.de.md +0 -120
  60. package/README.es.md +0 -120
  61. package/README.fr.md +0 -120
  62. package/README.it.md +0 -120
  63. package/README.ru.md +0 -120
package/README.de.md DELETED
@@ -1,120 +0,0 @@
1
- # dsh-manage-session (Session Steward)
2
-
3
- - [中文 README](./README.md)
4
- - [English README](./README.en.md)
5
- - [日本語 README](./README.ja.md)
6
- - [한국어 README](./README.ko.md)
7
- - [Français README](./README.fr.md)
8
- - [Deutsch README](./README.de.md)
9
- - [Italiano README](./README.it.md)
10
- - [Русский README](./README.ru.md)
11
- - [Español README](./README.es.md)
12
-
13
- DSH-Web-Plugin für **Sitzungsverlaufsdateien + Sitzungs-Healthchecks**.
14
-
15
- > **Diese Version (0.5.0) macht die DSH-0.2.0-Linie zur Hauptlinie** (peer/engines = `>=0.2.0-rc.1 <0.2.1-0`, npm dist-tag `dsh-0.2.0`, Branch `compat/0.2.0`).
16
- > Die DSH-0.1.7-Linie wird weiterhin von 0.4.8 bedient (dist-tag `dsh-0.1.7`, Branch `compat/0.1.7`) und entwickelt sich nicht mehr mit dieser Linie weiter.
17
- > Die Host-Flächen, die dieses Plugin konsumiert (Sitzungsformat V4 und die First-Party-Produzentenlisten von `dsh-session-format-v3-to-v4`, die Dekodier-Exports von `dsh-session`, der Archivverzeichnis-Vertrag `session.jsonl.zstd`/`session.v3.jsonl.zstd` in doppelter Ausführung + `storages/session_projcache` + die beiden id-Listen in `workspace.json`), wurden in 0.2.0-rc.1 Punkt für Punkt als **unverändert verifiziert — null Codeänderungen**; diese Version ist eine reine Metadaten-Anpassung (Generationswechsel bei peer/engines, devDependencies exakt auf `0.2.0-rc.1` gepinnt, Release-Disziplin versionsbegleitend aktualisiert).
18
-
19
- - **Seniorenheim (Verlaufsdateien)**: den offiziellen Archivbestand durchsehen, mit zwei **unabhängigen** Aktionen —
20
- **Archivstatus aufheben** (ändert nur das Array, reversibel) und **Archivdateien endgültig löschen (Purge)** (löscht die Datenträger-Entitäten wirklich, irreversibel).
21
-
22
- > **Die beiden Aktionen sind nicht austauschbar und lassen sich nicht zusammenlegen**:
23
- >
24
- > | | Archivstatus aufheben | Archivdateien löschen (Purge) |
25
- > |---|---|---|
26
- > | Route | `session-history-prune` | `session-history-purge` |
27
- > | Was geändert wird | nur `global.archivedSessionIds` | löscht Datenträger-Entitäten + ändert das Archiv-Array + ändert die Mitglieder-Tabelle der Arbeitsbereiche |
28
- > | Verbleib der Sitzung | zurück in den ursprünglichen Arbeitsbereich der Seitenleiste | verschwindet aus der Welt |
29
- > | Reversibel | ✅ | ❌ |
30
- >
31
- > **Der Purge zieht zwangsläufig das Aufheben des Archivstatus nach sich** — sonst blieben Zombie-ids zurück, die „in der Seitenleiste unsichtbar sind und sobald man ihren Archivstatus aufhebt zu einer leeren Sitzung werden“.
32
- > Die Größe wird **pro Zeile** angezeigt (praktisch gemessen: ein einzelner Eintrag kann von 0 bis 23 MB reichen), der Button zeigt die Teiltsumme der Auswahl.
33
- >
34
- > **Zwei harte Randbedingungen** (einhalten, sonst war die Aktion umsonst):
35
- > 1. **Liste und Schreibzugriff haben dieselbe Quelle** — beide erkennen die Speicherdatei `~/.dsh/storages/workspace.json` an. Der `workspaceRegistry` im Host-Speicher ist ein Snapshot beim Start: Änderungen an der Datei schreiben nicht in ihn zurück; er dient nur als Diagnosefläche für „bereits aus der Datei hinaus, in diesem Prozess weiterhin wirksam“ (`pendingRestart`).
36
- > 2. **Direkt nach der Aktion DSH neu starten** — die Speicherschicht schreibt vollständig neu, der Speicher ist maßgeblich: Vor dem Beenden des Hosts schreibt **jede** Archiv- oder Arbeitsbereichsänderung den alten Zustand vollständig zurück und macht die soeben durchgeführte Aktion zunichte.
37
- - **Check-up (Gesundheitsprüfung / Sitzungsarzt)**: Vier-Gates-Check-up → Verordnung (Befehlsliste) → Entlassung (reversibler Eingriff + Vorher/Nachher-Vergleich).
38
-
39
- > Namensgrenze: **Dieses Paket bietet weder Suche noch Indizierung.** Suche/eigenständige Indizierung gehören in ein anderes Revier (`dsh-search-index`); keine der beiden Seiten verwendet die Unterdomänen-Begriffe der anderen, und keine interpretiert die Felder der anderen.
40
-
41
- ## Oberflächen-Vorschau
42
-
43
- Ein Eintrag **„Session Steward“** erscheint unten in der Seitenleiste, neben Suche und Einstellungen:
44
-
45
- ![Eintrag in der Seitenleiste](assets/left-sidebar.png)
46
-
47
- **Seniorenheim (Verlaufsdateien)** — Überblick über den offiziellen Archivbestand; jede Zeile zeigt ihre Größe und den Zustand der Datenträger-Entität; Zeilen auswählen, um den Archivstatus aufzuheben oder zu löschen (Purge):
48
-
49
- ![Seniorenheim (alles zusammengeführt)](assets/archive.png)
50
-
51
- **Check-up** — der Einstiegspunkt des Vier-Gates-Check-ups, der in einer reversiblen Verordnung endet:
52
-
53
- ![Check-up](assets/doctor.png)
54
-
55
- ## Installation
56
-
57
- ```bash
58
- dsh plugin --profile web add dsh-manage-session
59
- # oder ein lokales Entwicklungsverzeichnis
60
- dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
61
- ```
62
-
63
- Nach der Installation **muss der Host-Prozess neu gestartet werden** (ein Neuladen der Seite genügt nicht).
64
-
65
- ## Routen-Vertrag
66
-
67
- Präfix `/session-steward/api`, Methodennamen immer `session-*` (**niemals** mit den `index-*` des Suchindex vermischen);
68
- eine unbekannte Methode liefert einen expliziten Fehler, niemals Stillschweigen.
69
-
70
- | Methode | Subdomäne | Zweck |
71
- |---|---|---|
72
- | `session-history-list` | history | den Archivbestand auflisten (Speicherdatei hat Vorrang; mit Quelle, Degradierung, Größe pro Zeile und `pendingRestart`-Vermerk) |
73
- | `session-history-prune` | history | **Archivstatus aufheben**: ids massenweise aus dem Archiv-Array entfernen (automatische Sicherung, Neustart erforderlich) |
74
- | `session-history-purge` | history | **Archivdateien endgültig löschen**: Transkript-Verzeichnis + Projektions-Cache + beide id-Listen wirklich löschen (**irreversibel**) |
75
- | `session-health-status` | health | Schalterzustand und Methodentabelle (für das Polling des Panels) |
76
- | `session-health-scan` | health | Check-up im Batch (standardmäßig nur nicht-ok-Sitzungen zurückgeben) |
77
- | `session-health-session` | health | Vier-Gates-Bericht einer einzelnen Sitzung + Verordnung |
78
- | `session-health-repair` | health | reversibler Eingriff (Quarantäne des Projektions-Cache-Datensatzes) + Vorher/Nachher |
79
-
80
- Einstellungs-Namespace: `session-steward`; id des Seitenleisten-Eintrags: `dsh-manage-session`.
81
-
82
- ## Die beiden Schalter (feature gates)
83
-
84
- | Schalter | Feld | Wirkung bei Deaktivierung |
85
- |---|---|---|
86
- | Sitzungsverlaufsdateien | `historyFiles` (Standard true) | `session-history-*` wird nicht registriert, der Tab „Seniorenheim“ wird nicht gerendert |
87
- | Gesundheitsprüfung | `healthCheck` (Standard true) | `session-health-*` wird nicht registriert, der Tab „Check-up“ wird nicht gerendert |
88
-
89
- Bei Deaktivierung liefert die entsprechende Methode `{ ok: false, error: '子域已关闭(…=false):<method> 未注册' }` — **keine leeren Hüllen**.
90
-
91
- ## Der Vier-Gates-Check-up
92
-
93
- | gate | Kriterium | level |
94
- |---|---|---|
95
- | `log-integrity` | Multi-Frame-Scan mit zstd → Entfaltung der Provenance → Auspacken der gepackten Zeilen; seq fortlaufend, kein zerrissener Endframe | `fail` bei Leseproblemen; `warn` bei nur zerrissenem Endframe |
96
- | `projection-cache` | Abstand des `minSeq` von `~/.dsh/storages/session_projcache/sessions/<id>.json` zur letzten seq des Logs + nicht abgeschlossene Felder (openStep / activeStep.active / pendingTurnStart / turnBoundary=start) | `fail` bei Abstand und nicht abgeschlossen; `warn` wenn eines von beiden |
97
- | `lossless-json` | zeilenweise Prüfung auf verlustfreies JSON durch das hot-state `sessionProjections.checkpoint(session)` (undefined / nicht-endliche Zahlen / -0 / löchrige Sparse-Löcher / nicht-gewöhnlicher Prototyp / Funktionen·Symbol·BigInt / Zyklen) | `fail` bei einem Treffer, mit Projektions-Key → zugeordnetem Paket |
98
- | `cold-read` | Grund des letzten `turn/end`, ob ein offener open step ohne Abschluss existiert, ob nach der letzten user-Nachricht noch Assistant-Ausgabe folgt | `fail` bei open step; `warn` bei interrupted/fehlendem turn/end |
99
-
100
- **Die Verordnung** enthält nur drei reversible Dinge: ① den beschädigten Projektions-Cache-Datensatz in Quarantäne versetzen (zuerst sichern) ② bei nicht abgeschlossenen steps daran erinnern, auf die Abschlusserklärung des Hosts zu warten ③ eine ausführbare Befehlsliste ausgeben.
101
- **Verboten**: Sitzungslogs umschreiben, historische Daten ändern, Felder stillschweigend verwerfen.
102
-
103
- ## Der einzige Vertrag mit `dsh-search-index`
104
-
105
- Format der Archivdatei (`global.archivedSessionIds` von `~/.dsh/storages/workspace.json`):
106
- **dieses Plugin schreibt, der Suchindex liest nur**. Formatbeschreibung in
107
- `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
108
-
109
- ## Entwicklung
110
-
111
- ```bash
112
- pnpm install
113
- pnpm typecheck # tsc -b --pretty false
114
- pnpm test # vitest run
115
- pnpm build # tsc -b && tsdown → lib/index.js + lib/client.js
116
- ```
117
-
118
- ## Lizenz
119
-
120
- MIT
package/README.es.md DELETED
@@ -1,120 +0,0 @@
1
- # dsh-manage-session (Session Steward)
2
-
3
- - [中文 README](./README.md)
4
- - [English README](./README.en.md)
5
- - [日本語 README](./README.ja.md)
6
- - [한국어 README](./README.ko.md)
7
- - [Français README](./README.fr.md)
8
- - [Deutsch README](./README.de.md)
9
- - [Italiano README](./README.it.md)
10
- - [Русский README](./README.ru.md)
11
- - [Español README](./README.es.md)
12
-
13
- Plugin web de DSH para **archivos de historial de sesiones + controles de salud de sesiones**.
14
-
15
- > **Esta versión (0.5.0) toma la línea DSH 0.2.0 como línea principal** (peer/engines = `>=0.2.0-rc.1 <0.2.1-0`, dist-tag npm `dsh-0.2.0`, rama `compat/0.2.0`).
16
- > La línea DSH 0.1.7 sigue siendo atendida por 0.4.8 (dist-tag `dsh-0.1.7`, rama `compat/0.1.7`) y ya no evoluciona junto con esta línea.
17
- > Las superficies del host que consume este plugin (formato de sesión V4 y las listas de productores first-party de `dsh-session-format-v3-to-v4`, las exportaciones de decodificación de `dsh-session`, el contrato del directorio de archivos `session.jsonl.zstd`/`session.v3.jsonl.zstd` en doble ejemplar + `storages/session_projcache` + las dos listas de id de `workspace.json`) fueron verificadas punto por punto: en 0.2.0-rc.1 están **sin cambios, cero modificaciones de código**; esta versión es una adaptación de puros metadatos (cambio de generación de peer/engines, devDependencies fijadas con exactitud en `0.2.0-rc.1`, disciplina de publicación actualizada junto con la versión).
18
-
19
- - **Residencia (archivos de historial)**: explorar el conjunto oficial de archivos, con dos operaciones **independientes** —
20
- **quitar el estado de archivado** (solo modifica el arreglo, reversible) y **purgar los archivos de archivado** (borra de verdad las entidades en disco, irreversible).
21
-
22
- > **Las dos operaciones no son intercambiables y no pueden fusionarse**:
23
- >
24
- > | | Quitar el estado de archivado | Purgar los archivos de archivado |
25
- > |---|---|---|
26
- > | Ruta | `session-history-prune` | `session-history-purge` |
27
- > | Qué se modifica | solo `global.archivedSessionIds` | borra las entidades en disco + modifica el arreglo de archivado + modifica la tabla de miembros de los espacios de trabajo |
28
- > | Destino de la sesión | vuelve al espacio de trabajo original de la barra lateral | desaparece del mundo |
29
- > | Reversible | ✅ | ❌ |
30
- >
31
- > **La purga conlleva necesariamente quitar el estado de archivado** — de lo contrario quedarían id zombis «invisibles en la barra lateral que, en cuanto se les quita el archivado, se convierten en una sesión vacía».
32
- > El tamaño se muestra **por línea** (comprobado en la práctica: una sola entrada puede ir de 0 a 23 MB), y el botón muestra el subtotal de la selección.
33
- >
34
- > **Dos restricciones estrictas** (cúmplalas, o la operación habrá sido en vano):
35
- > 1. **La lista y la escritura tienen la misma fuente** — ambas reconocen el archivo de almacenamiento `~/.dsh/storages/workspace.json`. El `workspaceRegistry` en memoria del host es una instantánea tomada al arrancar: escribir en el archivo no lo actualiza; solo sirve como superficie de diagnóstico para «ya salió del archivo, sigue vigente en este proceso» (`pendingRestart`).
36
- > 2. **Reinicie DSH inmediatamente después de la operación** — la capa de almacenamiento reescribe todo el documento y da prioridad a la memoria: antes de que el host termine, **cualquier** cambio de archivado o de espacio de trabajo reescribe el estado antiguo por completo, anulando la operación recién hecha.
37
- - **Chequeo (control de salud / médico de sesiones)**: chequeo de cuatro puertas → receta (lista de comandos) → alta (intervención reversible + comparación antes/después).
38
-
39
- > Frontera de nombres: **este paquete no ofrece búsqueda ni indexación**. La búsqueda/la indexación independiente pertenecen a otro territorio (`dsh-search-index`); ninguna de las dos partes usa los términos de subdominio de la otra, ni interpreta los campos de la otra.
40
-
41
- ## Vista previa de la interfaz
42
-
43
- Una entrada **«Session Steward»** aparece al final de la barra lateral, junto a Búsqueda y Ajustes:
44
-
45
- ![Entrada de la barra lateral](assets/left-sidebar.png)
46
-
47
- **Residencia (archivos de historial)** — panorama del conjunto oficial de archivos; cada línea muestra su tamaño y el estado de la entidad en disco; marque líneas para quitar el archivado o purgar:
48
-
49
- ![Residencia (estado todo recogido)](assets/archive.png)
50
-
51
- **Chequeo** — el punto de entrada del chequeo de cuatro puertas, que termina en una receta reversible:
52
-
53
- ![Chequeo](assets/doctor.png)
54
-
55
- ## Instalación
56
-
57
- ```bash
58
- dsh plugin --profile web add dsh-manage-session
59
- # o un directorio de desarrollo local
60
- dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
61
- ```
62
-
63
- Después de instalar, **hay que reiniciar el proceso anfitrión** (refrescar la página no basta).
64
-
65
- ## Contrato de rutas
66
-
67
- Prefijo `/session-steward/api`, nombres de método siempre `session-*` (**nunca** mezclarlos con los `index-*` del índice de búsqueda);
68
- un método no reconocido devuelve un error explícito, nunca un silencio.
69
-
70
- | Método | Subdominio | Función |
71
- |---|---|---|
72
- | `session-history-list` | history | listar el conjunto de archivos (prioridad del archivo de almacenamiento; con fuente, degradación, tamaño por línea y anotación `pendingRestart`) |
73
- | `session-history-prune` | history | **quitar el estado de archivado**: retirar id del arreglo de archivado en lote (copia de seguridad automática, se requiere reinicio) |
74
- | `session-history-purge` | history | **purgar los archivos de archivado**: borrar de verdad el directorio de transcripciones + la caché de proyección + las dos listas de id (**irreversible**) |
75
- | `session-health-status` | health | estado de los interruptores y tabla de métodos (para el sondeo del panel) |
76
- | `session-health-scan` | health | chequeo por lotes (por defecto devuelve solo las sesiones no ok) |
77
- | `session-health-session` | health | informe de cuatro puertas de una sola sesión + receta |
78
- | `session-health-repair` | health | intervención reversible (cuarentena del registro de la caché de proyección) + antes/después |
79
-
80
- Espacio de nombres de ajustes: `session-steward`; id de la entrada de la barra lateral: `dsh-manage-session`.
81
-
82
- ## Los dos interruptores (feature gates)
83
-
84
- | Interruptor | Campo | Efecto al desactivar |
85
- |---|---|---|
86
- | Archivos de historial de sesiones | `historyFiles` (true por defecto) | `session-history-*` no se registra, la pestaña «Residencia» no se renderiza |
87
- | Control de salud | `healthCheck` (true por defecto) | `session-health-*` no se registra, la pestaña «Chequeo» no se renderiza |
88
-
89
- Al desactivarse, el método correspondiente devuelve `{ ok: false, error: '子域已关闭(…=false):<method> 未注册' }` — **sin caparazones vacíos**.
90
-
91
- ## El chequeo de cuatro puertas
92
-
93
- | gate | Criterio | level |
94
- |---|---|---|
95
- | `log-integrity` | escaneo multitudinario (multi-frame) de zstd → despliegue de la procedencia → desempaquetado de las líneas empaquetadas; seq continuos, sin tramo final desgarrado | `fail` si hay problemas de lectura; `warn` si solo hay un tramo final desgarrado |
96
- | `projection-cache` | retraso del `minSeq` de `~/.dsh/storages/session_projcache/sessions/<id>.json` respecto al último seq del registro + campos no liquidados (openStep / activeStep.active / pendingTurnStart / turnBoundary=start) | `fail` si hay retraso y no liquidado; `warn` si solo uno de los dos |
97
- | `lossless-json` | juicio línea a línea del JSON sin pérdidas mediante el `sessionProjections.checkpoint(session)` en caliente (undefined / números no finitos / -0 / huecos dispersos / prototipo no ordinario / funciones·Symbol·BigInt / ciclos) | `fail` al encontrar alguno, con la clave de proyección → paquete responsable |
98
- | `cold-read` | motivo del último `turn/end`, existencia de un open step sin cerrar, y si tras el último mensaje user hay salida del assistant | `fail` si hay open step; `warn` si interrupted/ausencia de turn/end |
99
-
100
- **La receta** solo propone tres cosas reversibles: ① poner en cuarentena el registro dañado de la caché de proyección (primero la copia de seguridad) ② si quedan step sin liquidar, recordar que hay que esperar a que el host los liquide ③ producir una lista de comandos ejecutables.
101
- **Prohibido**: reescribir los registros de sesión, modificar datos históricos, descartar campos en silencio.
102
-
103
- ## El único contrato con `dsh-search-index`
104
-
105
- Formato del archivo de archivado (`global.archivedSessionIds` de `~/.dsh/storages/workspace.json`):
106
- **este plugin escribe, el índice de búsqueda solo lee**. Descripción del formato en
107
- `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
108
-
109
- ## Desarrollo
110
-
111
- ```bash
112
- pnpm install
113
- pnpm typecheck # tsc -b --pretty false
114
- pnpm test # vitest run
115
- pnpm build # tsc -b && tsdown → lib/index.js + lib/client.js
116
- ```
117
-
118
- ## Licencia
119
-
120
- MIT
package/README.fr.md DELETED
@@ -1,120 +0,0 @@
1
- # dsh-manage-session (Session Steward)
2
-
3
- - [中文 README](./README.md)
4
- - [English README](./README.en.md)
5
- - [日本語 README](./README.ja.md)
6
- - [한국어 README](./README.ko.md)
7
- - [Français README](./README.fr.md)
8
- - [Deutsch README](./README.de.md)
9
- - [Italiano README](./README.it.md)
10
- - [Русский README](./README.ru.md)
11
- - [Español README](./README.es.md)
12
-
13
- Plugin web DSH : **fichiers d'historique des sessions + bilan de santé des sessions**.
14
-
15
- > **Cette version (0.5.0) prend la ligne DSH 0.2.0 comme ligne principale** (peer/engines = `>=0.2.0-rc.1 <0.2.1-0`, dist-tag npm `dsh-0.2.0`, branche `compat/0.2.0`).
16
- > La ligne DSH 0.1.7 reste servie par 0.4.8 (dist-tag `dsh-0.1.7`, branche `compat/0.1.7`) et n'évolue plus avec la présente ligne.
17
- > Les surfaces de l'hôte consommées par ce plugin (format de session V4 et listes de producteurs first-party de `dsh-session-format-v3-to-v4`, exports de décodage de `dsh-session`, contrat du répertoire d'archive `session.jsonl.zstd`/`session.v3.jsonl.zstd` en double exemplaire + `storages/session_projcache` + les deux listes d'id de `workspace.json`) ont été vérifiées point par point comme **inchangées dans 0.2.0-rc.1, zéro modification de code** ; cette version est une adaptation purement métadonnées (rotation des peer/engines, devDependencies épinglées exactement sur `0.2.0-rc.1`, discipline de publication mise à jour avec la version).
18
-
19
- - **Maison de retraite (fichiers d'historique)** : parcourir l'ensemble officiel des archives, avec deux opérations **indépendantes** —
20
- **retirer le statut d'archivage** (ne modifie que le tableau, réversible) et **purger les fichiers d'archive** (supprime réellement les entités sur disque, irréversible).
21
-
22
- > **Les deux opérations ne sont pas interchangeables et ne peuvent pas être fusionnées** :
23
- >
24
- > | | Retirer le statut d'archivage | Purger les fichiers d'archive |
25
- > |---|---|---|
26
- > | Route | `session-history-prune` | `session-history-purge` |
27
- > | Ce qui est modifié | uniquement `global.archivedSessionIds` | suppression des entités sur disque + modification du tableau d'archive + modification de la table des membres des espaces de travail |
28
- > | Devenir de la session | retour dans l'espace de travail d'origine de la barre latérale | disparaît du monde |
29
- > | Réversible | ✅ | ❌ |
30
- >
31
- > **La purge entraîne nécessairement le retrait du statut d'archivage** — sinon subsisteraient des id zombies « invisibles dans la barre latérale et qui, dès qu'on retire leur statut d'archivage, se transforment en session vide ».
32
- > La taille est affichée **par ligne** (constaté en pratique : une entrée peut aller de 0 à 23 Mo), et le bouton affiche le sous-total de la sélection.
33
- >
34
- > **Deux contraintes strictes** (à respecter, sinon l'opération est vaine) :
35
- > 1. **Liste et écriture ont la même source** — toutes deux se réfèrent au fichier de stockage `~/.dsh/storages/workspace.json`. Le `workspaceRegistry` en mémoire de l'hôte est un instantané pris au démarrage : écrire dans le fichier ne le met pas à jour ; il ne sert que de surface de diagnostic « déjà sorti du fichier, toujours actif en mémoire » (`pendingRestart`).
36
- > 2. **Redémarrer DSH immédiatement après l'opération** — la couche de stockage réécrit tout le document et donne la priorité à la mémoire : avant l'arrêt de l'hôte, **toute** modification d'archive ou d'espace de travail réécrit l'ancien état en entier, annulant l'opération qui vient d'être faite.
37
- - **Bilan de santé (contrôle de santé / médecin des sessions)** : bilan à quatre portes → ordonnance (liste de commandes) → sortie (traitement réversible + comparaison avant/après).
38
-
39
- > Frontière de nommage : **ce plugin ne fournit ni recherche ni indexation**. La recherche et l'indexation autonome relèvent d'un autre territoire (`dsh-search-index`) ; aucune des deux parties n'emploie les termes de sous-domaine de l'autre et aucune n'interprète les champs de l'autre.
40
-
41
- ## Aperçu de l'interface
42
-
43
- Une entrée **« Session Steward »** apparaît en bas de la barre latérale, aux côtés de Recherche et Paramètres :
44
-
45
- ![Entrée de la barre latérale](assets/left-sidebar.png)
46
-
47
- **Maison de retraite (fichiers d'historique)** — vue d'ensemble de l'ensemble officiel des archives ; chaque ligne indique sa taille et l'état de l'entité sur disque ; cochez des lignes pour retirer le statut d'archivage ou purger :
48
-
49
- ![Maison de retraite (état tout regroupé)](assets/archive.png)
50
-
51
- **Bilan de santé** — le point d'entrée du bilan à quatre portes, qui débouche sur une ordonnance réversible :
52
-
53
- ![Bilan de santé](assets/doctor.png)
54
-
55
- ## Installation
56
-
57
- ```bash
58
- dsh plugin --profile web add dsh-manage-session
59
- # ou un répertoire de développement local
60
- dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
61
- ```
62
-
63
- Après l'installation, **il faut redémarrer le processus hôte** (rafraîchir la page ne suffit pas).
64
-
65
- ## Contrat des routes
66
-
67
- Préfixe `/session-steward/api`, noms de méthodes toujours en `session-*` (**jamais** à mélanger avec les `index-*` de l'index de recherche) ;
68
- une méthode non reconnue renvoie une erreur explicite, jamais un silence.
69
-
70
- | Méthode | Sous-domaine | Rôle |
71
- |---|---|---|
72
- | `session-history-list` | history | lister l'ensemble des archives (fichier de stockage prioritaire ; avec source, dégradation, taille par ligne et annotation `pendingRestart`) |
73
- | `session-history-prune` | history | **retirer le statut d'archivage** : retirer des id du tableau d'archives en lot (sauvegarde automatique, redémarrage requis) |
74
- | `session-history-purge` | history | **purger les fichiers d'archive** : supprimer réellement le répertoire de transcription + le cache de projection + les deux listes d'id (**irréversible**) |
75
- | `session-health-status` | health | état des interrupteurs et table des méthodes (pour le polling du panneau) |
76
- | `session-health-scan` | health | bilan en lot (par défaut, ne renvoie que les sessions non ok) |
77
- | `session-health-session` | health | rapport aux quatre portes d'une seule session + ordonnance |
78
- | `session-health-repair` | health | traitement réversible (mise en quarantaine de l'enregistrement du cache de projection) + avant/après |
79
-
80
- Espace de noms des paramètres : `session-steward` ; id de l'entrée de la barre latérale : `dsh-manage-session`.
81
-
82
- ## Les deux interrupteurs (feature gates)
83
-
84
- | Interrupteur | Champ | Effet à la désactivation |
85
- |---|---|---|
86
- | Fichiers d'historique des sessions | `historyFiles` (true par défaut) | `session-history-*` n'est pas enregistré, l'onglet « Maison de retraite » n'est pas rendu |
87
- | Contrôle de santé | `healthCheck` (true par défaut) | `session-health-*` n'est pas enregistré, l'onglet « Bilan de santé » n'est pas rendu |
88
-
89
- Une fois désactivé, la méthode correspondante renvoie `{ ok: false, error: '子域已关闭(…=false):<method> 未注册' }` — **aucune coquille vide**.
90
-
91
- ## Le bilan à quatre portes
92
-
93
- | gate | Critère | level |
94
- |---|---|---|
95
- | `log-integrity` | balayage multi-trames zstd → déploiement de la provenance → déballage des lignes empaquetées ; seq continues, aucune trame finale déchirée | `fail` en cas de problème de lecture ; `warn` si uniquement une trame finale déchirée |
96
- | `projection-cache` | retard du `minSeq` de `~/.dsh/storages/session_projcache/sessions/<id>.json` par rapport au dernier seq du journal + champs non soldés (openStep / activeStep.active / pendingTurnStart / turnBoundary=start) | `fail` si retard et non soldé ; `warn` si l'un des deux seulement |
97
- | `lossless-json` | jugement ligne à ligne du JSON sans perte par le `sessionProjections.checkpoint(session)` à chaud (undefined / nombres non finis / -0 / trous creux / prototype non ordinaire / fonctions·Symbol·BigInt / cycles) | `fail` en cas de correspondance, avec la clé de projection → paquet attribué |
98
- | `cold-read` | raison du dernier `turn/end`, existence d'un open step non clôturé, présence éventuelle d'une sortie assistant après le dernier message user | `fail` si open step ; `warn` si interrupted/absence de turn/end |
99
-
100
- **L'ordonnance** ne propose que trois choses réversibles : ① mettre en quarantaine l'enregistrement endommagé du cache de projection (sauvegarde d'abord) ② s'il reste des steps non soldés, rappeler qu'il faut attendre la soldation par l'hôte ③ produire une liste de commandes exécutables.
101
- **Interdit** : réécrire les journaux de session, modifier les données historiques, abandonner silencieusement des champs.
102
-
103
- ## L'unique contrat avec `dsh-search-index`
104
-
105
- Format du fichier d'archive (`global.archivedSessionIds` de `~/.dsh/storages/workspace.json`) :
106
- **ce plugin écrit, l'index de recherche ne fait que lire**. Description du format dans
107
- `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
108
-
109
- ## Développement
110
-
111
- ```bash
112
- pnpm install
113
- pnpm typecheck # tsc -b --pretty false
114
- pnpm test # vitest run
115
- pnpm build # tsc -b && tsdown → lib/index.js + lib/client.js
116
- ```
117
-
118
- ## Licence
119
-
120
- MIT
package/README.it.md DELETED
@@ -1,120 +0,0 @@
1
- # dsh-manage-session (Session Steward)
2
-
3
- - [中文 README](./README.md)
4
- - [English README](./README.en.md)
5
- - [日本語 README](./README.ja.md)
6
- - [한국어 README](./README.ko.md)
7
- - [Français README](./README.fr.md)
8
- - [Deutsch README](./README.de.md)
9
- - [Italiano README](./README.it.md)
10
- - [Русский README](./README.ru.md)
11
- - [Español README](./README.es.md)
12
-
13
- Plugin web DSH per **file di cronologia delle sessioni + controlli di salute delle sessioni**.
14
-
15
- > **Questa versione (0.5.0) adotta la linea DSH 0.2.0 come linea principale** (peer/engines = `>=0.2.0-rc.1 <0.2.1-0`, dist-tag npm `dsh-0.2.0`, ramo `compat/0.2.0`).
16
- > La linea DSH 0.1.7 resta servita da 0.4.8 (dist-tag `dsh-0.1.7`, ramo `compat/0.1.7`) e non evolve più insieme alla presente linea.
17
- > Le superfici dell'host consumate da questo plugin (formato sessione V4 e le liste di produttori first-party di `dsh-session-format-v3-to-v4`, le esportazioni di decodifica di `dsh-session`, il contratto della directory di archivio `session.jsonl.zstd`/`session.v3.jsonl.zstd` in doppio esemplare + `storages/session_projcache` + le due liste di id di `workspace.json`) sono state verificate punto per punto come **immutate in 0.2.0-rc.1, zero modifiche al codice**; questa versione è un adattamento di soli metadati (passaggio di generazione di peer/engines, devDependencies fissate esattamente su `0.2.0-rc.1`, disciplina di rilascio aggiornata con la versione).
18
-
19
- - **Casa di riposo (file di cronologia)**: sfogliare l'insieme ufficiale degli archivi, con due operazioni **indipendenti** —
20
- **rimuovere lo stato di archiviazione** (modifica solo l'array, reversibile) ed **eliminare (purge) i file d'archivio** (cancella davvero le entità su disco, irreversibile).
21
-
22
- > **Le due operazioni non sono intercambiabili e non possono essere fuse**:
23
- >
24
- > | | Rimuovere lo stato di archiviazione | Eliminare i file d'archivio (purge) |
25
- > |---|---|---|
26
- > | Rotta | `session-history-prune` | `session-history-purge` |
27
- > | Cosa viene modificato | solo `global.archivedSessionIds` | cancella le entità su disco + modifica l'array degli archivi + modifica la tabella dei membri degli spazi di lavoro |
28
- > | Destinazione della sessione | torna nello spazio di lavoro originale della barra laterale | scompare dal mondo |
29
- > | Reversibile | ✅ | ❌ |
30
- >
31
- > **La purge comporta necessariamente la rimozione dello stato di archiviazione** — altrimenti resterebbero id zombie «invisibili nella barra laterale che, appena si rimuove loro l'archiviazione, diventano una sessione vuota».
32
- > La dimensione è mostrata **per riga** (riscontrato in pratica: una singola voce può andare da 0 a 23 MB), il pulsante mostra il subtotale della selezione.
33
- >
34
- > **Due vincoli rigorosi** (da rispettare, altrimenti l'operazione è vana):
35
- > 1. **Elenco e scrittura hanno la stessa fonte** — entrambe fanno riferimento al file di archiviazione `~/.dsh/storages/workspace.json`. Il `workspaceRegistry` in memoria dell'host è un'istantanea presa all'avvio: scrivere sul file non lo aggiorna; serve solo come superficie diagnostica per «già tolto dal file, ancora attivo in questo processo» (`pendingRestart`).
36
- > 2. **Riavviare DSH subito dopo l'operazione** — il livello di archiviazione riscrive tutto e dà priorità alla memoria: prima che l'host termini, **qualsiasi** modifica ad archivi o spazi di lavoro riscrive integralmente il vecchio stato, azzerando l'operazione appena compiuta.
37
- - **Check-up (controllo di salute / medico delle sessioni)**: check-up a quattro gate → prescrizione (elenco di comandi) → dimissione (intervento reversibile + confronto prima/dopo).
38
-
39
- > Confine di denominazione: **questo pacchetto non offre ricerca né indicizzazione**. Ricerca/indicizzazione autonoma appartengono a un altro territorio (`dsh-search-index`); nessuna delle due parti usa i termini di sottodominio dell'altra e nessuna interpreta i campi dell'altra.
40
-
41
- ## Anteprima dell'interfaccia
42
-
43
- Una voce **«Session Steward»** compare in fondo alla barra laterale, accanto a Ricerca e Impostazioni:
44
-
45
- ![Voce della barra laterale](assets/left-sidebar.png)
46
-
47
- **Casa di riposo (file di cronologia)** — panoramica dell'insieme ufficiale degli archivi; ogni riga mostra la propria dimensione e lo stato dell'entità su disco; seleziona le righe per rimuovere l'archiviazione o eliminare (purge):
48
-
49
- ![Casa di riposo (stato tutto raccordato)](assets/archive.png)
50
-
51
- **Check-up** — il punto d'ingresso del check-up a quattro gate, che si conclude con una prescrizione reversibile:
52
-
53
- ![Check-up](assets/doctor.png)
54
-
55
- ## Installazione
56
-
57
- ```bash
58
- dsh plugin --profile web add dsh-manage-session
59
- # oppure una directory di sviluppo locale
60
- dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
61
- ```
62
-
63
- Dopo l'installazione **è necessario riavviare il processo host** (ricaricare la pagina non basta).
64
-
65
- ## Contratto delle rotte
66
-
67
- Prefisso `/session-steward/api`, nomi dei metodi sempre `session-*` (**mai** mescolarli con gli `index-*` dell'indice di ricerca);
68
- un metodo non riconosciuto restituisce un errore esplicito, mai un silenzio.
69
-
70
- | Metodo | Sottodominio | Funzione |
71
- |---|---|---|
72
- | `session-history-list` | history | elencare l'insieme degli archivi (file di archiviazione prioritario; con fonte, degrado, dimensione per riga e annotazione `pendingRestart`) |
73
- | `session-history-prune` | history | **rimuovere lo stato di archiviazione**: togliere id dall'array degli archivi in blocco (backup automatico, richiesto riavvio) |
74
- | `session-history-purge` | history | **eliminare i file d'archivio**: cancellare davvero la directory delle trascrizioni + la cache di proiezione + le due liste di id (**irreversibile**) |
75
- | `session-health-status` | health | stato degli interruttori e tabella dei metodi (per il polling del pannello) |
76
- | `session-health-scan` | health | check-up in blocco (per impostazione predefinita restituisce solo le sessioni non ok) |
77
- | `session-health-session` | health | rapporto a quattro gate di una singola sessione + prescrizione |
78
- | `session-health-repair` | health | intervento reversibile (messa in quarantena del record della cache di proiezione) + prima/dopo |
79
-
80
- Namespace delle impostazioni: `session-steward`; id della voce della barra laterale: `dsh-manage-session`.
81
-
82
- ## I due interruttori (feature gate)
83
-
84
- | Interruttore | Campo | Effetto alla disattivazione |
85
- |---|---|---|
86
- | File di cronologia delle sessioni | `historyFiles` (predefinito true) | `session-history-*` non viene registrato, la scheda «Casa di riposo» non viene resa |
87
- | Controllo di salute | `healthCheck` (predefinito true) | `session-health-*` non viene registrato, la scheda «Check-up» non viene resa |
88
-
89
- Una volta disattivato, il metodo corrispondente restituisce `{ ok: false, error: '子域已关闭(…=false):<method> 未注册' }` — **nessun guscio vuoto**.
90
-
91
- ## Il check-up a quattro gate
92
-
93
- | gate | Criterio | level |
94
- |---|---|---|
95
- | `log-integrity` | scansione multi-frame zstd → dispiegamento della provenance → disimpacchettamento delle righe impacchettate; seq continui, nessun frame finale strappato | `fail` in caso di problemi di lettura; `warn` se solo frame finale strappato |
96
- | `projection-cache` | ritardo del `minSeq` di `~/.dsh/storages/session_projcache/sessions/<id>.json` rispetto all'ultimo seq del log + campi non saldati (openStep / activeStep.active / pendingTurnStart / turnBoundary=start) | `fail` se ritardo e non saldato; `warn` se uno solo dei due |
97
- | `lossless-json` | giudizio riga per riga sul JSON senza perdite tramite il `sessionProjections.checkpoint(session)` a caldo (undefined / numeri non finiti / -0 / buchi sparsi / prototipo non ordinario / funzioni·Symbol·BigInt / cicli) | `fail` in caso di riscontro, con chiave di proiezione → pacchetto attribuito |
98
- | `cold-read` | motivo dell'ultimo `turn/end`, esistenza di un open step non chiuso, eventuale output dell'assistant dopo l'ultimo messaggio user | `fail` se open step; `warn` se interrupted/assenza di turn/end |
99
-
100
- **La prescrizione** propone solo tre cose reversibili: ① mettere in quarantena il record danneggiato della cache di proiezione (prima il backup) ② se restano step non saldati, ricordare di attendere la saldazione da parte dell'host ③ produrre un elenco di comandi eseguibili.
101
- **Vietato**: riscrivere i log di sessione, modificare i dati storici, scartare silenziosamente campi.
102
-
103
- ## L'unico contratto con `dsh-search-index`
104
-
105
- Formato del file d'archivio (`global.archivedSessionIds` di `~/.dsh/storages/workspace.json`):
106
- **questo plugin scrive, l'indice di ricerca fa solo lettura**. Descrizione del formato in
107
- `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
108
-
109
- ## Sviluppo
110
-
111
- ```bash
112
- pnpm install
113
- pnpm typecheck # tsc -b --pretty false
114
- pnpm test # vitest run
115
- pnpm build # tsc -b && tsdown → lib/index.js + lib/client.js
116
- ```
117
-
118
- ## Licenza
119
-
120
- MIT
package/README.ru.md DELETED
@@ -1,120 +0,0 @@
1
- # dsh-manage-session (Session Steward)
2
-
3
- - [中文 README](./README.md)
4
- - [English README](./README.en.md)
5
- - [日本語 README](./README.ja.md)
6
- - [한국어 README](./README.ko.md)
7
- - [Français README](./README.fr.md)
8
- - [Deutsch README](./README.de.md)
9
- - [Italiano README](./README.it.md)
10
- - [Русский README](./README.ru.md)
11
- - [Español README](./README.es.md)
12
-
13
- Веб-плагин DSH для **файлов истории сессий + проверки здоровья сессий**.
14
-
15
- > **В этой версии (0.5.0) главной линией стала линия DSH 0.2.0** (peer/engines = `>=0.2.0-rc.1 <0.2.1-0`, npm dist-tag `dsh-0.2.0`, ветка `compat/0.2.0`).
16
- > Линию DSH 0.1.7 продолжает обслуживать 0.4.8 (dist-tag `dsh-0.1.7`, ветка `compat/0.1.7`); вместе с настоящей линией она больше не развивается.
17
- > Поверхности хоста, которые потребляет этот плагин (формат сессии V4 и списки first-party-продюсеров `dsh-session-format-v3-to-v4`, экспортируемые декодеры `dsh-session`, контракт каталога архивов `session.jsonl.zstd`/`session.v3.jsonl.zstd` в двух экземплярах + `storages/session_projcache` + два списка id в `workspace.json`), проверены по пунктам: в 0.2.0-rc.1 они **не изменились, нулевые правки кода**; этот релиз — адаптация одних лишь метаданных (смена поколения peer/engines, devDependencies точно закреплены на `0.2.0-rc.1`, дисциплина релизов обновлена вместе с версией).
18
-
19
- - **Дом престарелых (файлы истории)**: просмотр официального набора архивов, две **независимые** операции —
20
- **снять статус архивации** (меняет только массив, обратимо) и **очистить архивные файлы (purge)** (по-настоящему удаляет сущности с диска, необратимо).
21
-
22
- > **Эти две операции не взаимозаменяемы, и объединять их нельзя**:
23
- >
24
- > | | Снять статус архивации | Очистить архивные файлы (purge) |
25
- > |---|---|---|
26
- > | Маршрут | `session-history-prune` | `session-history-purge` |
27
- > | Что меняется | только `global.archivedSessionIds` | удаление сущностей с диска + изменение массива архивов + изменение таблицы участников рабочих пространств |
28
- > | Судьба сессии | возвращается в исходное рабочее пространство боковой панели | исчезает из мира |
29
- > | Обратимо | ✅ | ❌ |
30
- >
31
- > **Очистка с необходимостью влечёт снятие статуса архивации** — иначе останутся id-зомби, «невидимые в боковой панели, которые при снятии архивации превращаются в пустую сессию».
32
- > Размер показывается **построчно** (на практике: одна запись может занимать от 0 до 23 МБ), кнопка показывает подытог по выбранным.
33
- >
34
- > **Два жёстких ограничения** (соблюдайте, иначе операция окажется напрасной):
35
- > 1. **Список и запись исходят из одного и того же места** — оба признают файл хранилища `~/.dsh/storages/workspace.json`. Находящийся в памяти хоста `workspaceRegistry` — снимок на момент запуска: правка файла не записывается обратно в него; он служит лишь диагностической поверхностью для «уже удалено из файла, но в этом процессе ещё действует» (`pendingRestart`).
36
- > 2. **Сразу после операции перезапустите DSH** — слой хранилища выполняет полную перезапись, и память имеет приоритет: до завершения работы хоста **любое** изменение архивов или рабочих пространств целиком записывает старое состояние обратно, сводя только что выполненную операцию к нулю.
37
- - **Диспансеризация (проверка здоровья / сессионный врач)**: осмотр по четырём воротам → рецепт (список команд) → выписка (обратимое вмешательство + сравнение до/после).
38
-
39
- > Граница именования: **этот пакет не предоставляет поиск и индексацию**. Поиск/отдельная индексация относятся к другому владению (`dsh-search-index`); ни одна из сторон не употребляет поддоменные термины другой и не интерпретирует поля другой.
40
-
41
- ## Предпросмотр интерфейса
42
-
43
- Внизу боковой панели появляется пункт **«Session Steward»**, рядом с Поиском и Настройками:
44
-
45
- ![Пункт боковой панели](assets/left-sidebar.png)
46
-
47
- **Дом престарелых (файлы истории)** — обзор официального набора архивов; каждая строка показывает свой размер и состояние сущности на диске; отметьте строки, чтобы снять архивацию или очистить:
48
-
49
- ![Дом престарелых (всё сведено воедино)](assets/archive.png)
50
-
51
- **Диспансеризация** — вход в осмотр по четырём воротам, завершающийся обратимым рецептом:
52
-
53
- ![Диспансеризация](assets/doctor.png)
54
-
55
- ## Установка
56
-
57
- ```bash
58
- dsh plugin --profile web add dsh-manage-session
59
- # или локальный каталог разработки
60
- dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
61
- ```
62
-
63
- После установки **обязательно перезапустите процесс-хост** (обновления страницы недостаточно).
64
-
65
- ## Контракт маршрутов
66
-
67
- Префикс `/session-steward/api`, имена методов всегда `session-*` (**нельзя** смешивать с `index-*` поискового индекса);
68
- нераспознанный метод возвращает явную ошибку, никогда не молчит.
69
-
70
- | Метод | Поддомен | Назначение |
71
- |---|---|---|
72
- | `session-history-list` | history | перечислить набор архивов (приоритет у файла хранилища; с указанием источника, деградации, построчного размера и пометки `pendingRestart`) |
73
- | `session-history-prune` | history | **снять статус архивации**: массово убрать id из массива архивов (автоматическая резервная копия, требуется перезапуск) |
74
- | `session-history-purge` | history | **очистить архивные файлы**: по-настоящему удалить каталог транскриптов + кэш проекций + оба списка id (**необратимо**) |
75
- | `session-health-status` | health | состояние переключателей и таблица методов (для опроса панелью) |
76
- | `session-health-scan` | health | пакетная проверка (по умолчанию возвращает только сессии не-ok) |
77
- | `session-health-session` | health | отчёт по четырём воротам одной сессии + рецепт |
78
- | `session-health-repair` | health | обратимое вмешательство (карантин записи кэша проекций) + до/после |
79
-
80
- Пространство имён настроек: `session-steward`; id пункта боковой панели: `dsh-manage-session`.
81
-
82
- ## Два переключателя (feature gate)
83
-
84
- | Переключатель | Поле | Эффект выключения |
85
- |---|---|---|
86
- | Файлы истории сессий | `historyFiles` (по умолчанию true) | `session-history-*` не регистрируется, вкладка «Дом престарелых» не рендерится |
87
- | Проверка здоровья | `healthCheck` (по умолчанию true) | `session-health-*` не регистрируется, вкладка «Диспансеризация» не рендерится |
88
-
89
- При выключении соответствующий метод возвращает `{ ok: false, error: '子域已关闭(…=false):<method> 未注册' }` — **пустых оболочек не остаётся**.
90
-
91
- ## Осмотр по четырём воротам
92
-
93
- | gate | Критерий | level |
94
- |---|---|---|
95
- | `log-integrity` | мультифреймовое сканирование zstd → разворачивание provenance → распаковка упакованных строк; seq непрерывны, нет разорванных хвостовых фреймов | `fail` при проблемах чтения; `warn`, если только разорванный хвостовой фрейм |
96
- | `projection-cache` | отставание `minSeq` файла `~/.dsh/storages/session_projcache/sessions/<id>.json` от последнего seq журнала + незакрытые поля (openStep / activeStep.active / pendingTurnStart / turnBoundary=start) | `fail` при отставании и незакрытости; `warn`, если только одно из двух |
97
- | `lossless-json` | построчная проверка JSON на потерях через горячее состояние `sessionProjections.checkpoint(session)` (undefined / не конечные числа / -0 / разреженные дыры / необычный прототип / функции·Symbol·BigInt / циклы) | `fail` при обнаружении, с ключом проекции → пакетом-владельцем |
98
- | `cold-read` | причина последнего `turn/end`, наличие незакрытого open step, есть ли вывод assistant после последнего сообщения user | `fail` при open step; `warn` при interrupted/отсутствии turn/end |
99
-
100
- **Рецепт** предлагает только три обратимые вещи: ① поместить повреждённую запись кэша проекций в карантин (сначала резервная копия) ② при наличии незакрытых step напомнить дождаться их закрытия хостом ③ выдать список исполняемых команд.
101
- **Запрещено**: переписывать журналы сессий, менять исторические данные, молча отбрасывать поля.
102
-
103
- ## Единственный контракт с `dsh-search-index`
104
-
105
- Формат файла архива (`global.archivedSessionIds` из `~/.dsh/storages/workspace.json`):
106
- **этот плагин пишет, поисковый индекс только читает**. Описание формата в
107
- `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
108
-
109
- ## Разработка
110
-
111
- ```bash
112
- pnpm install
113
- pnpm typecheck # tsc -b --pretty false
114
- pnpm test # vitest run
115
- pnpm build # tsc -b && tsdown → lib/index.js + lib/client.js
116
- ```
117
-
118
- ## Лицензия
119
-
120
- MIT