core/go-session
8
0
Fork 0
Code Issues 4 Pull requests Projects Releases Packages Wiki Activity Actions 2
Session parsing, timeline generation, and HTML/video rendering
51 commits 3 branches 13 tags 452 KiB
Find a file
Snider 209166507b
Some checks failed
Security Scan / security (push) Has been cancelled
Details
Test / test (push) Has been cancelled
Details
fix(go-session): replace syscall.ForkExec with c.Process() in video.go 
Replace syscall.ForkExec/Wait4 invocation of vhs with c.Process().Run(ctx,
vhsPath, tapePath) per Core v0.8 process primitive. Threads *core.Core
dependency through core_helpers.go Process accessor. Removes syscall
import.

GOWORK=off go test passes. Live MP4 render not validated in sandbox (no
vhs on PATH).

Co-authored-by: Codex <noreply@openai.com>
Closes tasks.lthn.sh/view.php?id=399
2026-04-25 21:20:20 +01:00
.core chore: add .core/ build and release configs 2026-03-06 18:52:37 +00:00
.forgejo/workflows ci: add Forgejo Actions test and security scan workflows 2026-02-23 03:28:08 +00:00
docs feat(html): add event permalinks 2026-04-01 04:47:53 +00:00
kb feat(html): add event permalinks 2026-04-01 04:47:53 +00:00
specs fix(coderabbit): address markdown linting findings 2026-03-17 13:55:52 +00:00
tests/cli/session feat(go-session): scaffold tests/cli/session Taskfile + test driver per AX-10 2026-04-24 22:44:55 +01:00
.editorconfig chore: add Go repo norms (badges, contributing, lint, taskfile, editorconfig) 2026-02-23 06:45:48 +00:00
.gitignore refactor(module): migrate module paths from forge.lthn.ai to dappco.re 2026-03-22 01:37:11 +00:00
.golangci.yml chore: add Go repo norms (badges, contributing, lint, taskfile, editorconfig) 2026-02-23 06:45:48 +00:00
analytics.go fix(go-session): annotate intrinsic banned imports per AX-6 2026-04-24 19:26:24 +01:00
analytics_test.go fix(go-session): replace testify with stdlib testing patterns (AX-6) 2026-04-24 17:37:40 +01:00
bench_test.go chore(session): align with core v0.8.0-alpha.1 2026-03-26 15:50:44 +00:00
CLAUDE.md test(conventions): enforce AX review rules 2026-03-26 11:14:35 +00:00
CODEX.md chore(session): enforce AX v0.8.0 conventions 2026-03-26 18:59:53 +00:00
CONTEXT.md refactor(module): migrate module paths from forge.lthn.ai to dappco.re 2026-03-22 01:37:11 +00:00
CONTRIBUTING.md chore: add Go repo norms (badges, contributing, lint, taskfile, editorconfig) 2026-02-23 06:45:48 +00:00
conventions_test.go chore(go-session): minor stale path cleanup per AX-6 2026-04-24 21:58:01 +01:00
core_helpers.go fix(go-session): replace syscall.ForkExec with c.Process() in video.go 2026-04-25 21:20:20 +01:00
GEMINI.md refactor(error-handling): replace fmt.Errorf and errors.New with coreerr.E() 2026-03-16 20:38:07 +00:00
go.mod chore(go-session): migrate module path to dappco.re/go/session 2026-04-24 20:18:03 +01:00
go.sum fix(go-session): replace testify with stdlib testing patterns (AX-6) 2026-04-24 17:37:40 +01:00
html.go fix(go-session): annotate intrinsic banned imports per AX-6 2026-04-24 19:26:24 +01:00
html_test.go fix(go-session): replace testify with stdlib testing patterns (AX-6) 2026-04-24 17:37:40 +01:00
parser.go fix(session): AX-6 sweep on parser.go (#398) — bufio/maps/path → core 2026-04-25 15:10:48 +01:00
parser_test.go docs(session): confirm ParseStats matches RFC §3 (#669, audit NOTABUG) 2026-04-25 07:28:26 +01:00
PROMPT.md refactor(module): migrate module paths from forge.lthn.ai to dappco.re 2026-03-22 01:37:11 +00:00
README.md refactor(module): migrate module paths from forge.lthn.ai to dappco.re 2026-03-22 01:37:11 +00:00
RECENT.md refactor(module): migrate module paths from forge.lthn.ai to dappco.re 2026-03-22 01:37:11 +00:00
search.go fix(go-session): annotate intrinsic banned imports per AX-6 2026-04-24 19:26:24 +01:00
search_test.go fix(go-session): replace testify with stdlib testing patterns (AX-6) 2026-04-24 17:37:40 +01:00
test_helpers_test.go fix(go-session): replace testify with stdlib testing patterns (AX-6) 2026-04-24 17:37:40 +01:00
threats.md docs(session): confirm ParseStats matches RFC §3 (#669, audit NOTABUG) 2026-04-25 07:28:26 +01:00
TODO.md refactor(module): migrate module paths from forge.lthn.ai to dappco.re 2026-03-22 01:37:11 +00:00
video.go fix(go-session): replace syscall.ForkExec with c.Process() in video.go 2026-04-25 21:20:20 +01:00
video_test.go fix(go-session): replace testify with stdlib testing patterns (AX-6) 2026-04-24 17:37:40 +01:00

README.md

Go Reference License: EUPL-1.2 Go Version

go-session

Claude Code JSONL transcript parser, analytics engine, and HTML timeline renderer. Parses Claude Code session files into structured event arrays (tool calls with round-trip durations, user and assistant messages), computes per-tool analytics (call counts, error rates, average and peak latency, estimated token usage), renders self-contained HTML timelines with collapsible panels and client-side search, and generates VHS tape scripts for MP4 video output. No external runtime dependencies — stdlib only.

Module: dappco.re/go/core/session Licence: EUPL-1.2 Language: Go 1.26

Quick Start

import "dappco.re/go/core/session"

sess, stats, err := session.ParseTranscript("/path/to/session.jsonl")
analytics := session.Analyse(sess)
fmt.Println(session.FormatAnalytics(analytics))

// Render interactive HTML timeline
err = session.RenderHTML(sess, "timeline.html")

// Search across all sessions in a directory
results, err := session.Search("~/.claude/projects/my-project", "git commit")

Documentation

  • Architecture — JSONL format, parsing pipeline, event types, analytics, HTML rendering, XSS protection
  • Development Guide — prerequisites, build, test patterns, coding standards
  • Project History — completed phases, known limitations, future considerations

Build & Test

go test ./...
go vet ./...
go build ./...

Licence

European Union Public Licence 1.2 — see LICENCE for details.