opencode-flema-engram-sidebar 0.2.0 → 0.4.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/README.md +139 -50
- package/dist/core.d.ts +4 -0
- package/dist/core.d.ts.map +1 -0
- package/dist/core.js +4 -0
- package/dist/core.js.map +1 -0
- package/dist/pi/sidebar.d.ts +49 -0
- package/dist/pi/sidebar.d.ts.map +1 -0
- package/dist/pi/sidebar.js +335 -0
- package/dist/pi/sidebar.js.map +1 -0
- package/dist/pi.d.ts +56 -0
- package/dist/pi.d.ts.map +1 -0
- package/dist/pi.js +249 -0
- package/dist/pi.js.map +1 -0
- package/dist/schemas/health.d.ts +4 -4
- package/dist/schemas/observation.d.ts +2 -2
- package/dist/schemas/odd-state.d.ts +40 -40
- package/dist/schemas/project.d.ts +2 -2
- package/dist/schemas/session.d.ts +12 -12
- package/dist/sidebar/hooks/use-engram.d.ts +3 -82
- package/dist/sidebar/hooks/use-engram.d.ts.map +1 -1
- package/dist/sidebar/hooks/use-engram.js +21 -432
- package/dist/sidebar/hooks/use-engram.js.map +1 -1
- package/dist/utils/sdd-detector.d.ts.map +1 -1
- package/dist/utils/sdd-detector.js +6 -3
- package/dist/utils/sdd-detector.js.map +1 -1
- package/dist/viewer/core.d.ts +93 -0
- package/dist/viewer/core.d.ts.map +1 -0
- package/dist/viewer/core.js +455 -0
- package/dist/viewer/core.js.map +1 -0
- package/package.json +20 -4
package/README.md
CHANGED
|
@@ -1,32 +1,35 @@
|
|
|
1
|
-
# Flema Engram para OpenCode
|
|
1
|
+
# Flema Engram para OpenCode y Pi
|
|
2
2
|
|
|
3
3
|
[](https://github.com/oniricosistemas/flema-engram/actions/workflows/ci.yml)
|
|
4
4
|
[](https://www.npmjs.com/package/opencode-flema-engram-sidebar)
|
|
5
5
|
[](https://nodejs.org/)
|
|
6
6
|
[](https://github.com/oniricosistemas/flema-engram/blob/main/LICENSE)
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
[Engram](https://github.com/Gentleman-Programming/engram) mientras trabajás dentro de OpenCode.
|
|
8
|
+
Una integración local-first y de solo lectura que mantiene visible el contexto reciente de
|
|
9
|
+
[Engram](https://github.com/Gentleman-Programming/engram) mientras trabajás dentro de OpenCode o Pi/Gentle Shell.
|
|
10
10
|
|
|
11
11
|
La canción **“Y aún yo te recuerdo”** inspiró artísticamente la idea central: que la
|
|
12
12
|
última memoria guardada siga presente en el contexto de desarrollo. Esta referencia
|
|
13
13
|
es un homenaje a esa inspiración; no implica afiliación, patrocinio ni titularidad
|
|
14
14
|
sobre la obra.
|
|
15
15
|
|
|
16
|
-
> **English summary:** Flema Engram is a local-first, read-only OpenCode
|
|
17
|
-
>
|
|
16
|
+
> **English summary:** Flema Engram is a local-first, read-only OpenCode and Pi
|
|
17
|
+
> integration that surfaces Engram health, project context, recent memories,
|
|
18
18
|
> blockers, and ODD task progress by default. An MCP stdio adapter is included only as an optional
|
|
19
19
|
> integration path.
|
|
20
20
|
|
|
21
|
-
## Inicio rápido
|
|
21
|
+
## Inicio rápido — 0.4.0
|
|
22
|
+
|
|
23
|
+
Elegí el registro en `tui.json` para OpenCode o la [instalación Pi / Gentle Shell](#viewer-para-pi--gentle-shell).
|
|
24
|
+
No hace falta una instalación global npm para ninguno de los viewers.
|
|
22
25
|
|
|
23
26
|
### Requisitos
|
|
24
27
|
|
|
25
28
|
| Componente | Requisito |
|
|
26
29
|
| --- | --- |
|
|
27
30
|
| Node.js | 22 o posterior |
|
|
28
|
-
|
|
|
29
|
-
| Engram | Servicio HTTP
|
|
31
|
+
| Host visual | OpenCode 1.18.25+ **o** Pi con API de extensiones/UI compatible; Gentle Shell fullscreen para el rail lateral |
|
|
32
|
+
| Engram | Servicio HTTP accesible desde el proceso del viewer; por defecto `http://127.0.0.1:7437` |
|
|
30
33
|
| Proyecto | Alguna observación o sesión reciente que permita validar el nombre |
|
|
31
34
|
|
|
32
35
|
### 1. Registrá el sidebar en `tui.json`
|
|
@@ -36,7 +39,7 @@ Configuración mínima:
|
|
|
36
39
|
```json
|
|
37
40
|
{
|
|
38
41
|
"$schema": "https://opencode.ai/tui.json",
|
|
39
|
-
"plugin": ["opencode-flema-engram-sidebar@0.
|
|
42
|
+
"plugin": ["opencode-flema-engram-sidebar@0.4.0"]
|
|
40
43
|
}
|
|
41
44
|
```
|
|
42
45
|
|
|
@@ -85,29 +88,92 @@ OpenCode 2 dispone además de `opencode plugin check` y `opencode plugin update`
|
|
|
85
88
|
CLI usa la sintaxis nativa correspondiente a la versión detectada.
|
|
86
89
|
|
|
87
90
|
#### Usando `opencode attach`
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
91
|
+
La configuración incluye detección del host de `opencode attach <url>` para intentar
|
|
92
|
+
consultar Engram en el puerto 7437, pero no crea túneles ni expone el servicio remoto.
|
|
93
|
+
La conectividad debe existir desde el proceso que carga el viewer; el loopback remoto
|
|
94
|
+
no es accesible automáticamente desde otra máquina. Configurá `baseUrl` explícitamente
|
|
95
|
+
si la detección no representa tu endpoint y comprobá su `/health` desde ese proceso.
|
|
96
|
+
No se garantiza compatibilidad con todas las topologías attach, proxies o URLs.
|
|
97
|
+
|
|
98
|
+
Usá una versión exacta: attach también puede reutilizar paquetes en caché. La línea
|
|
99
|
+
`🔌 Target: Local=… | Cloud=…` informa los destinos configurados; no prueba una
|
|
100
|
+
sincronización ni garantiza que ambos respondan. No expongas el puerto de Engram sin
|
|
101
|
+
controles de acceso.
|
|
93
102
|
|
|
94
103
|
### 2. Iniciá Engram y abrí OpenCode en tu proyecto
|
|
95
104
|
|
|
96
105
|
El sidebar hace una carga inicial, vuelve a consultar cada 30 segundos de forma
|
|
97
106
|
predeterminada y permite refrescar manualmente con <kbd>Alt</kbd>+<kbd>R</kbd>.
|
|
98
107
|
|
|
108
|
+
## Viewer para Pi / Gentle Shell
|
|
109
|
+
|
|
110
|
+
El mismo paquete incluye una extensión Pi de solo lectura. Para Pi convencional,
|
|
111
|
+
instalá la versión exacta compatible con esta documentación:
|
|
112
|
+
|
|
113
|
+
```sh
|
|
114
|
+
pi install npm:opencode-flema-engram-sidebar@0.4.0
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
Gentle Shell usa un home de paquetes aislado. Instalá allí la misma versión:
|
|
118
|
+
|
|
119
|
+
```sh
|
|
120
|
+
PI_CODING_AGENT_DIR="$HOME/.gentle-shell/agent" \
|
|
121
|
+
pi install npm:opencode-flema-engram-sidebar@0.4.0
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
En Gentle Shell fullscreen, la extensión participa del rail lateral sin reemplazar
|
|
125
|
+
el status existente. El panel empieza visible y expandido, con marco redondeado:
|
|
126
|
+
el borde usa el color semántico `border` y el título `accent` del theme activo.
|
|
127
|
+
Un clic izquierdo en el título colapsa o expande el panel, igual que el comando.
|
|
128
|
+
Muestra proyecto, salud, progreso ODD, bloqueos y actividad reciente. En Pi sin el
|
|
129
|
+
rail de Gentle Shell usa un overlay pasivo a la derecha cuando el terminal tiene
|
|
130
|
+
ancho suficiente. Los comandos de presentación son independientes:
|
|
131
|
+
|
|
132
|
+
```text
|
|
133
|
+
/engram-refresh # Refrescar datos y status; notificar el resultado
|
|
134
|
+
/engram-sidebar # Mostrar u ocultar el sidebar
|
|
135
|
+
/engram-sidebar-collapse # Colapsar o expandir el sidebar
|
|
136
|
+
/engram-widget # Mostrar u ocultar el widget debajo del editor
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
El widget compacto empieza oculto en cada sesión y su visibilidad no se persiste.
|
|
140
|
+
El sidebar y el widget refrescan al iniciar, reanudar o recargar una sesión y después
|
|
141
|
+
de que `mem_save` (o el alias `save_memory`) termina correctamente. Ocultar cualquiera
|
|
142
|
+
de las dos vistas no detiene el controller ni desactiva `/engram-refresh`.
|
|
143
|
+
|
|
144
|
+
No usa polling periódico y no agrega herramientas para escribir memorias. En modos
|
|
145
|
+
sin UI no consulta Engram ni intenta renderizar componentes terminales. En RPC no
|
|
146
|
+
monta el rail ni el overlay terminal.
|
|
147
|
+
|
|
148
|
+
Para el endpoint principal, definí `ENGRAM_URL` o `ENGRAM_BASE_URL`; sin configuración
|
|
149
|
+
se usa `http://127.0.0.1:7437` (el factory compartido también reconoce argumentos attach).
|
|
150
|
+
La configuración cloud compartida se describe en
|
|
151
|
+
[Seguridad y enfoque local-first](#seguridad-privacidad-y-enfoque-local-first).
|
|
152
|
+
`ENGRAM_PROJECT` puede fijar el candidato de proyecto; de lo contrario se valida el
|
|
153
|
+
nombre del directorio actual contra Engram. Los fallos de
|
|
154
|
+
inicialización se contienen en un estado `Engram unavailable` sin mostrar URLs,
|
|
155
|
+
tokens ni diagnósticos con credenciales.
|
|
156
|
+
|
|
157
|
+
Para desarrollo local, después de compilar el paquete:
|
|
158
|
+
|
|
159
|
+
```sh
|
|
160
|
+
npm run build
|
|
161
|
+
pi --extension ./dist/pi.js
|
|
162
|
+
```
|
|
163
|
+
|
|
99
164
|
## Qué es — y qué no es
|
|
100
165
|
|
|
101
166
|
| Sí es | No es |
|
|
102
167
|
| --- | --- |
|
|
103
|
-
| Un plugin para
|
|
104
|
-
| Una vista local y de solo lectura sobre Engram | Un reemplazo de Engram |
|
|
105
|
-
|
|
|
106
|
-
| Un cliente
|
|
168
|
+
| Un plugin para `sidebar_content` de OpenCode y una extensión Pi | Una TUI independiente |
|
|
169
|
+
| Una vista local-first y de solo lectura sobre Engram | Un reemplazo de Engram |
|
|
170
|
+
| Contexto de proyecto, actividad y progreso ODD | Un editor o administrador de memorias |
|
|
171
|
+
| Un cliente HTTP de Engram | Un servicio cloud o de sincronización |
|
|
107
172
|
| Un paquete con un adaptador MCP stdio opcional | Un producto centrado en MCP |
|
|
108
173
|
|
|
109
|
-
|
|
110
|
-
avanzadas y puede ignorarse por completo al usar
|
|
174
|
+
Los viewers de OpenCode y Pi son las integraciones visuales principales. El comando
|
|
175
|
+
MCP existe para integraciones avanzadas y puede ignorarse por completo al usar cualquiera
|
|
176
|
+
de los viewers.
|
|
111
177
|
|
|
112
178
|
## Cómo funciona
|
|
113
179
|
|
|
@@ -115,13 +181,13 @@ avanzadas y puede ignorarse por completo al usar el plugin de OpenCode.
|
|
|
115
181
|
2. El plugin resuelve un candidato de proyecto, lo prueba primero con una consulta
|
|
116
182
|
acotada por proyecto y conserva la enumeración reciente como fallback.
|
|
117
183
|
3. Consulta en paralelo salud, proyectos y observaciones del proyecto.
|
|
118
|
-
4.
|
|
119
|
-
|
|
184
|
+
4. Deriva tareas ODD desde espejos canónicos `odd/<feature>/tasks`, ordena la
|
|
185
|
+
actividad por actualización y reconoce bloqueos explícitos.
|
|
120
186
|
5. Renderiza texto dentro del sidebar de la sesión visible y conserva datos útiles
|
|
121
187
|
como `STALE` si una actualización posterior queda incompleta.
|
|
122
188
|
|
|
123
|
-
Las llamadas usan exclusivamente `GET` contra
|
|
124
|
-
|
|
189
|
+
Las llamadas usan exclusivamente `GET` contra los endpoints Engram configurados.
|
|
190
|
+
Los viewers no guardan, editan ni eliminan memorias.
|
|
125
191
|
|
|
126
192
|
### Endpoints utilizados
|
|
127
193
|
|
|
@@ -148,7 +214,7 @@ Usá la forma `[plugin, options]` solamente cuando necesites opciones:
|
|
|
148
214
|
"$schema": "https://opencode.ai/tui.json",
|
|
149
215
|
"plugin": [
|
|
150
216
|
[
|
|
151
|
-
"opencode-flema-engram-sidebar@0.
|
|
217
|
+
"opencode-flema-engram-sidebar@0.4.0",
|
|
152
218
|
{
|
|
153
219
|
"enabled": true,
|
|
154
220
|
"project": "mi-proyecto",
|
|
@@ -166,7 +232,7 @@ Usá la forma `[plugin, options]` solamente cuando necesites opciones:
|
|
|
166
232
|
| `enabled` | `boolean` | `false` evita que el plugin registre el sidebar. Por defecto está habilitado. |
|
|
167
233
|
| `project` | `string` | Nombre exacto de proyecto Engram. Tiene la prioridad más alta. |
|
|
168
234
|
| `pollInterval` | `number` | Intervalo automático en milisegundos; debe ser mayor que cero. Por defecto: `30000`. |
|
|
169
|
-
| `baseUrl` | `string` | Endpoint HTTP(S) de Engram
|
|
235
|
+
| `baseUrl` | `string` | Endpoint HTTP(S) principal de Engram. Gana sobre variables de entorno y detección por `opencode attach`. Por defecto: `http://127.0.0.1:7437`. |
|
|
170
236
|
| `timeoutMs` | `number` | Presupuesto común para requests locales y guards de etapas; debe ser finito y mayor que cero. Por defecto: `5000`. |
|
|
171
237
|
|
|
172
238
|
La precedencia del endpoint local es `baseUrl` explícito, `ENGRAM_URL`,
|
|
@@ -232,8 +298,9 @@ vacío explícito.
|
|
|
232
298
|
The sidebar derives ODD state from full feature-document mirrors whose `topic_key`
|
|
233
299
|
is `odd/<feature>/tasks`. Each feature shows explicit task counts: done out of total,
|
|
234
300
|
cancelled, in progress, blocked, and pending. Cancelled tasks are reported separately,
|
|
235
|
-
not counted as done. See [the ODD state contract](docs/odd-state-contract.md) for the
|
|
236
|
-
canonical checklist format and newest-valid-document selection.
|
|
301
|
+
not counted as done. See [the ODD state contract](https://github.com/oniricosistemas/flema-engram/blob/main/docs/odd-state-contract.md) for the
|
|
302
|
+
canonical checklist format and newest-valid-document selection. This shared ODD
|
|
303
|
+
contract also applies to Pi; the legacy workflow commands below are OpenCode-only.
|
|
237
304
|
|
|
238
305
|
This is a bounded recent-observation view (up to 20 canonical project observations),
|
|
239
306
|
not a complete project inventory. ODD derivation uses that entire window, not just
|
|
@@ -258,9 +325,12 @@ legacy opt-in described below.
|
|
|
258
325
|
|
|
259
326
|
### Bloqueos
|
|
260
327
|
|
|
261
|
-
Lista títulos de observaciones
|
|
262
|
-
explícitas como `status: blocked`, `blocker:`,
|
|
263
|
-
`
|
|
328
|
+
Lista títulos de observaciones de tipo `blocker`, o de otras observaciones con
|
|
329
|
+
`blocked` en el título o frases explícitas como `status: blocked`, `blocker:`,
|
|
330
|
+
`blocked by`, `depends on` o `waiting for`. Las observaciones `session_summary`
|
|
331
|
+
se excluyen de esas heurísticas de título y contenido: un resumen histórico no es
|
|
332
|
+
un bloqueo activo. Los registros de tipo `blocker` siguen contando. No infiere
|
|
333
|
+
bloqueos a partir de sentimiento o contexto ambiguo.
|
|
264
334
|
|
|
265
335
|
### Actividad reciente
|
|
266
336
|
|
|
@@ -274,7 +344,11 @@ reciente ocupa el primer lugar de **Recent Activity**. La vista muestra su títu
|
|
|
274
344
|
el contenido completo. Así mantiene presente la referencia más nueva sin convertir
|
|
275
345
|
el sidebar en un explorador de memorias.
|
|
276
346
|
|
|
277
|
-
### Refresh, carga y errores
|
|
347
|
+
### Refresh, carga y errores — OpenCode
|
|
348
|
+
|
|
349
|
+
Pi no usa este polling ni estos atajos: refresca por eventos y con
|
|
350
|
+
`/engram-refresh`, que actualiza el status y notifica `Engram refreshed` o
|
|
351
|
+
`Engram refresh incomplete`. Las reglas de vista acotada y datos `STALE` son compartidas.
|
|
278
352
|
|
|
279
353
|
- La primera carga se agenda una sola vez para el sidebar de la sesión visible.
|
|
280
354
|
- El polling automático usa `pollInterval` o 30 segundos.
|
|
@@ -303,7 +377,7 @@ Si Engram conoce `mi-proyecto`, el sidebar valida ese nombre y carga sus memoria
|
|
|
303
377
|
{
|
|
304
378
|
"$schema": "https://opencode.ai/tui.json",
|
|
305
379
|
"plugin": [
|
|
306
|
-
["opencode-flema-engram-sidebar@0.
|
|
380
|
+
["opencode-flema-engram-sidebar@0.4.0", { "project": "backend-api" }]
|
|
307
381
|
]
|
|
308
382
|
}
|
|
309
383
|
```
|
|
@@ -317,7 +391,7 @@ Engram. El valor debe coincidir; una configuración incorrecta queda como `unres
|
|
|
317
391
|
{
|
|
318
392
|
"$schema": "https://opencode.ai/tui.json",
|
|
319
393
|
"plugin": [
|
|
320
|
-
["opencode-flema-engram-sidebar@0.
|
|
394
|
+
["opencode-flema-engram-sidebar@0.4.0", { "pollInterval": 60000 }]
|
|
321
395
|
]
|
|
322
396
|
}
|
|
323
397
|
```
|
|
@@ -367,9 +441,9 @@ Preservá el resto de tus plugins y opciones al fusionar la configuración.
|
|
|
367
441
|
### Engram aparece offline
|
|
368
442
|
|
|
369
443
|
- Confirmá que Engram escuche en `127.0.0.1:7437` o en el endpoint declarado por `baseUrl`.
|
|
370
|
-
- Probá `<baseUrl>/health` desde
|
|
371
|
-
- Revisá firewalls
|
|
372
|
-
|
|
444
|
+
- Probá `<baseUrl>/health` desde el proceso o máquina que carga el viewer.
|
|
445
|
+
- Revisá firewalls, proxies y los destinos de `Target`. El cloud solo se consulta
|
|
446
|
+
si está configurado; no es una alternativa automática garantizada al endpoint local.
|
|
373
447
|
- Si una red o puente responde lentamente, aumentá `timeoutMs`; el mismo valor limita
|
|
374
448
|
requests HTTP y etapas del refresh.
|
|
375
449
|
- Una URL que no use `http:` o `https:` se rechaza dentro del sidebar con un diagnóstico
|
|
@@ -388,7 +462,8 @@ Preservá el resto de tus plugins y opciones al fusionar la configuración.
|
|
|
388
462
|
### Los datos parecen viejos
|
|
389
463
|
|
|
390
464
|
- Mirá si Health dice `STALE` y leé el detalle de etapa/endpoint.
|
|
391
|
-
-
|
|
465
|
+
- En OpenCode esperá el próximo polling o usá <kbd>Alt</kbd>+<kbd>R</kbd>;
|
|
466
|
+
en Pi usá `/engram-refresh` (no hay polling).
|
|
392
467
|
- Confirmá que la memoria pertenece exactamente al proyecto resuelto.
|
|
393
468
|
- El feed solo muestra cinco títulos y la consulta del sidebar está acotada a 20
|
|
394
469
|
observaciones.
|
|
@@ -509,9 +584,16 @@ La lista `files` permite publicar `dist`, `README.md` y `LICENSE`; npm agrega ad
|
|
|
509
584
|
la metadata obligatoria. El verificador exige, como mínimo:
|
|
510
585
|
|
|
511
586
|
- API raíz: `dist/index.js` y `dist/index.d.ts`;
|
|
512
|
-
- plugin: `dist/sidebar/plugin.js` y `dist/sidebar/plugin.d.ts`;
|
|
513
|
-
-
|
|
514
|
-
-
|
|
587
|
+
- plugin OpenCode (`./tui`): `dist/sidebar/plugin.js` y `dist/sidebar/plugin.d.ts`;
|
|
588
|
+
- controller compartido (`./core`): `dist/core.js` y `dist/core.d.ts`;
|
|
589
|
+
- extensión Pi (`./pi`): `dist/pi.js` y `dist/pi.d.ts`, registrada en `pi.extensions`;
|
|
590
|
+
- panel Pi: `dist/pi/sidebar.js` y `dist/pi/sidebar.d.ts`;
|
|
591
|
+
- CLI de mantenimiento `flema-engram`: `dist/maintenance.js`;
|
|
592
|
+
- MCP opcional `mcp-flema-engram`: `dist/stdio.js`;
|
|
593
|
+
- `README.md`, `LICENSE` y `package.json`.
|
|
594
|
+
|
|
595
|
+
`docs/` y `site/` no se incluyen en npm; las referencias de documentación apuntan al
|
|
596
|
+
repositorio público.
|
|
515
597
|
|
|
516
598
|
`prepublishOnly` ejecuta automáticamente:
|
|
517
599
|
|
|
@@ -557,7 +639,7 @@ Ejemplo de configuración local de OpenCode, equivalente a `opencode.example.jso
|
|
|
557
639
|
|
|
558
640
|
The server offers read-only MCP tools and resources for health, projects,
|
|
559
641
|
observations, sessions, ODD state, and explicit legacy SDD access. It uses the same
|
|
560
|
-
|
|
642
|
+
Engram HTTP configuration (loopback by default), without adding persistence or cloud synchronization.
|
|
561
643
|
|
|
562
644
|
### ODD-first project state and explicit legacy access
|
|
563
645
|
|
|
@@ -573,7 +655,7 @@ loaded exact-project observation window. Existing project metadata, observation
|
|
|
573
655
|
counts, explicit blockers, and recent activity remain available. Invalid mirrors
|
|
574
656
|
stay visible as diagnostics and never cause SDD fallback. Counts and derived
|
|
575
657
|
workflow state describe bounded recent observations, not an exhaustive inventory
|
|
576
|
-
or historical total. See [the ODD state contract](docs/odd-state-contract.md).
|
|
658
|
+
or historical total. See [the ODD state contract](https://github.com/oniricosistemas/flema-engram/blob/main/docs/odd-state-contract.md).
|
|
577
659
|
|
|
578
660
|
`includeLegacySdd` is an optional boolean, defaulting to `false`. By default the
|
|
579
661
|
tool does not derive legacy SDD or expose `changes`. To add legacy SDD changes to
|
|
@@ -593,24 +675,31 @@ behavior is unchanged.
|
|
|
593
675
|
|
|
594
676
|
## Seguridad, privacidad y enfoque local-first
|
|
595
677
|
|
|
596
|
-
-
|
|
597
|
-
-
|
|
678
|
+
- Por defecto el viewer consulta loopback; no requiere un servicio cloud ni telemetría.
|
|
679
|
+
- Un endpoint remoto explícito o detectado por attach implica tráfico de red: los
|
|
680
|
+
datos no están necesariamente limitados a esta máquina.
|
|
681
|
+
- El factory compartido puede agregar lecturas cloud si encuentra `ENGRAM_CLOUD_URL`
|
|
682
|
+
o configuración en `~/.engram/cloud.json`. Puede usar `ENGRAM_CLOUD_TOKEN` o
|
|
683
|
+
`ENGRAM_TOKEN` como Bearer token; revisá esa configuración antes de asumir un
|
|
684
|
+
runtime exclusivamente local.
|
|
598
685
|
- No ejecuta operaciones de escritura sobre memorias.
|
|
599
686
|
- No crea logs propios con contenido de observaciones.
|
|
600
687
|
- El contenido de memorias puede ser sensible: protegé el acceso al proceso y puerto
|
|
601
688
|
local de Engram como protegerías cualquier herramienta de desarrollo.
|
|
602
|
-
-
|
|
603
|
-
como instalar desde npm o abrir enlaces de documentación.
|
|
689
|
+
- Instalar desde npm y abrir documentación también puede requerir conexiones externas.
|
|
604
690
|
|
|
605
|
-
El
|
|
606
|
-
|
|
691
|
+
El adaptador cloud implementa lecturas HTTP y puede combinarse con el local; no es
|
|
692
|
+
un servicio alojado ni un mecanismo de sincronización. No se promete seguridad de
|
|
693
|
+
transporte para despliegues arbitrarios: el adaptador cloud permite certificados TLS
|
|
694
|
+
no verificados por defecto. Preferí loopback o una red controlada y no envíes tokens
|
|
695
|
+
a destinos no confiables.
|
|
607
696
|
|
|
608
697
|
## Roadmap y alcance diferido
|
|
609
698
|
|
|
610
699
|
Están explícitamente fuera del MVP actual:
|
|
611
700
|
|
|
612
701
|
- dashboard visual y acciones/atajos para abrirlo;
|
|
613
|
-
-
|
|
702
|
+
- túneles automáticos y compatibilidad garantizada con cualquier despliegue attach;
|
|
614
703
|
- selector manual de proyecto, navegación `j`/`k` y más atajos globales;
|
|
615
704
|
- sincronización cloud y edición de memorias.
|
|
616
705
|
|
package/dist/core.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC"}
|
package/dist/core.js
ADDED
package/dist/core.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,kBAAkB,GAInB,MAAM,6BAA6B,CAAC"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { SidebarViewModel } from "../viewer/core.js";
|
|
2
|
+
export interface PiSidebarTheme {
|
|
3
|
+
fg: (token: string, text: string) => string;
|
|
4
|
+
bold?: (text: string) => string;
|
|
5
|
+
}
|
|
6
|
+
export interface PiSidebarRenderHost {
|
|
7
|
+
requestRender: () => void;
|
|
8
|
+
}
|
|
9
|
+
export interface PiSidebarMouseEvent {
|
|
10
|
+
type: string;
|
|
11
|
+
button: string;
|
|
12
|
+
x: number;
|
|
13
|
+
y: number;
|
|
14
|
+
width: number;
|
|
15
|
+
height: number;
|
|
16
|
+
[key: string]: unknown;
|
|
17
|
+
}
|
|
18
|
+
export interface PiSidebarMouseResult {
|
|
19
|
+
handled?: boolean;
|
|
20
|
+
render?: boolean;
|
|
21
|
+
[key: string]: unknown;
|
|
22
|
+
}
|
|
23
|
+
export interface PiSidebarPanel {
|
|
24
|
+
render: (width: number) => string[];
|
|
25
|
+
invalidate: () => void;
|
|
26
|
+
digest: () => string;
|
|
27
|
+
handleMouse?: (event: PiSidebarMouseEvent) => PiSidebarMouseResult | undefined;
|
|
28
|
+
setState: (state: SidebarViewModel) => void;
|
|
29
|
+
setCollapsed: (collapsed: boolean) => void;
|
|
30
|
+
isCollapsed: () => boolean;
|
|
31
|
+
}
|
|
32
|
+
export interface PiSidebarTui extends PiSidebarRenderHost {
|
|
33
|
+
mode?: string;
|
|
34
|
+
terminal?: Record<symbol, unknown>;
|
|
35
|
+
}
|
|
36
|
+
export interface GentleShellRailAttachment {
|
|
37
|
+
isMounted: () => boolean;
|
|
38
|
+
isActive: () => boolean;
|
|
39
|
+
setVisible: (visible: boolean) => void;
|
|
40
|
+
invalidate: () => void;
|
|
41
|
+
dispose: () => void;
|
|
42
|
+
}
|
|
43
|
+
export declare const GENTLE_SHELL_SIDEBAR_STATE: unique symbol;
|
|
44
|
+
type RailComponent = Pick<PiSidebarPanel, "render" | "invalidate" | "digest" | "handleMouse">;
|
|
45
|
+
export declare function visibleTextWidth(value: string): number;
|
|
46
|
+
export declare function attachGentleShellRailPanel(tui: PiSidebarTui, component: RailComponent): GentleShellRailAttachment | undefined;
|
|
47
|
+
export declare function createPiSidebarPanel(tui: PiSidebarRenderHost, theme: PiSidebarTheme, initialState: SidebarViewModel, onCollapsedChange?: (collapsed: boolean) => void): PiSidebarPanel;
|
|
48
|
+
export {};
|
|
49
|
+
//# sourceMappingURL=sidebar.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/pi/sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,oBAAoB,GAAG,SAAS,CAAC;IAC/E,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,0BAA0B,eAAqD,CAAC;AAG7F,KAAK,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC;AAoB9F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAStD;AAgLD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,aAAa,GACvB,yBAAyB,GAAG,SAAS,CAuDvC;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,gBAAgB,EAC9B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAC/C,cAAc,CAyFhB"}
|