Historial de sesiones Harness

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Tesserae puede importar transcript locales de AI-agent y renderizarlos como memoria del proyecto en la sección sessions/ del sitio estático.

Esta función está separada intencionalmente de export-agent-harness:

• export-agent-harness es contexto saliente para herramientas como Claude Code, Codex, Gemini, Cursor, Kiro y OpenCode.
• project sessions ... es historial entrante: normaliza sesiones previas de Claude Code/Codex para el proyecto actual, las guarda bajo .tesserae/harness_sessions/ y permite que project build-site publique páginas de índice/detalle de sesiones.

Modelo de privacidad

La importación de sesiones es explícita. Un project compile o project build-site normal lee sesiones ya normalizadas desde .tesserae/harness_sessions/, pero no hace surprise-scrape de directorios privados de transcript del harness.

Los registros de sesiones importados son artefactos locales del proyecto. Revísalos antes de publicar un sitio público, especialmente si tus transcript pueden incluir secretos, rutas privadas, datos de clientes o código no publicado.

Descubrir e importar sesiones locales

Desde la raíz del proyecto:

tesserae project sessions discover --import

Discovery escanea raíces locales de transcript de Claude Code y Codex que pertenecen al directorio de trabajo del proyecto actual. Usa --root para escanear un directorio de configuración específico y repite --harness para limitar discovery:

tesserae project sessions discover \
  --root ~/.claude \
  --root ~/.codex \
  --harness claude-code \
  --harness codex \
  --import

Sin --import, discovery imprime lo encontrado sin escribir registros de sesión normalizados.

Importar JSON normalizado directamente

Si otra herramienta ya produjo JSON HarnessSession normalizado, importa un archivo o una lista de archivos:

tesserae project sessions import path/to/session.json path/to/more-sessions.json

Cada entrada puede contener un objeto de sesión o una lista de objetos de sesión.

Listar sesiones importadas

tesserae project sessions list

Las sesiones se almacenan debajo de:

.tesserae/harness_sessions/
  manifest.json
  <harness>/
    <session>.json
    <session>.md

Construir las páginas estáticas de sesiones

Después de importar sesiones, reconstruye el sitio:

tesserae project build-site

El sitio emite:

.tesserae/site/sessions/index.html
.tesserae/site/sessions/<project>/<session>.html

El sitio generado enlaza Sessions desde el global rail, las tarjetas Browse de inicio, las entradas de búsqueda y el breadcrumb trail de cada página de detalle de sesión.

Diseño de la página de detalle de sesión

Las páginas de detalle usan el shell compartido del sitio estático en vez de un transcript dump independiente. Incluyen:

• hero y stat strip;
• resumen de alto nivel;
• timeline y size metadata;
• decisions, files, commands, tools y errors cuando existen;
• subagent tree colapsado;
• conversación user/assistant turno por turno;
• tool-use blocks colapsados adjuntos bajo el turno assistant anterior;
• un conversation rail izquierdo que enlaza a anchors #turn-N.

El markdown de conversación se renderiza mediante el renderer markdown del sitio. Superficies semánticas como inline code, command/tag markup explícito, paths, filenames y hashtags se decoran como chips compactos; los sustantivos aleatorios en mayúscula no se convierten automáticamente en chips.

Typography actual de transcript:

Checklist de publicación de sesiones

Antes de desplegar un sitio público que incluya sesiones:

1. Ejecuta tesserae project sessions list y confirma que el conteo sea el esperado.
2. Inspecciona .tesserae/harness_sessions/ en busca de contenido sensible.
3. Reconstruye con tesserae project build-site.
4. Abre localmente sessions/index.html y al menos una página de detalle de sesión.
5. Confirma que los tool blocks estén colapsados por defecto y que los raw tool payloads sean aceptables para publicar.
6. Despliega con tesserae project deploy --build una vez que el source tree esté committed.