go-session/CONTEXT.md

Context — go-session

Relevant knowledge from OpenBrain.

1. go-session [service] (score: 0.080)

[go-session] Licence

EUPL-1.2

2. go-session [convention] (score: 0.021)

Coding Standards

• UK English throughout (colour, licence, initialise)
• declare(strict_types=1) equivalent: explicit types on all signatures
• go test ./... must pass before commit
• go vet ./... must be clean before commit
• SPDX-Licence-Identifier: EUPL-1.2 header on all source files
• Conventional commits: type(scope): description
• Co-Author: Co-Authored-By: Virgil <virgil@lethean.io>
• Test naming: TestFunctionName_Context_Good/Bad/Ugly
• New tool types: add struct in parser.go, case in extractToolInput, label in html.go, tape entry in video.go, and tests in parser_test.go

3. go-session [service] (score: 0.006)

[go-session] Labels

The input label adapts to the tool type:

• Bash: "Command"
• Read, Glob, Grep: "Target"
• Edit, Write: "File"
• User messages: "Message"
• Assistant: "Response"

4. go-session [service] (score: -0.002)

[go-session] Installation

go get dappco.re/go/core/session@latest

5. go-session [convention] (score: -0.004)

Commands

go test ./...          # Run all tests
go test -v -run Name   # Run single test
go vet ./...           # Vet the package

6. go-session [service] (score: -0.023)

[go-session] Event Card Layout

Each card displays:

Element	Description
Timestamp	HH:MM:SS of the event
Tool badge	Colour-coded tool name
Input summary	Truncated to 120 characters
Duration	Formatted as ms/s/min/hr
Status icon	Green tick or red cross for tool calls

Clicking a card expands it to show the full input (labelled contextually as Command, Message, File, or Target) and the complete output.

7. go-session [service] (score: -0.024)

[go-session] Tape Configuration

The generated tape uses these defaults:

FontSize 16
Width 1400
Height 800
TypingSpeed 30ms
Theme "Catppuccin Mocha"
Shell bash

See also: Home | Session-Format

8. go-session [service] (score: -0.031)

[go-session] Prerequisites

go install github.com/charmbracelet/vhs@latest

9. go-session [service] (score: -0.040)

[go-session] How It Works

1. A VHS .tape script is generated from the session events
2. The tape uses the Catppuccin Mocha theme at 1400x800 resolution
3. Only tool_use events are rendered:
   • Bash: Shows the command being typed, abbreviated output, and a status indicator
   • Read/Edit/Write: Shows a comment line with the file path
   • Task: Shows an "Agent:" comment with the task description
4. Each event includes a brief pause for readability
5. VHS renders the tape to the specified MP4 path

10. go-session [service] (score: -0.044)

[go-session] Core Types

// Session holds parsed metadata and events from a transcript.
type Session struct {
    ID        string
    Path      string
    StartTime time.Time
    EndTime   time.Time
    Events    []Event
}

// Event represents a single action in the session timeline.
type Event struct {
    Timestamp time.Time
    Type      string        // "tool_use", "user", "assistant", "error"
    Tool      string        // "Bash", "Read", "Edit", "Write", "Grep", "Glob", etc.
    ToolID    string
    Input     string
    Output    string
    Duration  time.Duration
    Success   bool
    ErrorMsg  string
}