3 Commits

• Add label support for session entries

  - Add LabelEntry type with targetId and label (string | undefined)
  - Add labelsById map built on load via linear scan
  - Add getLabel(id) and appendLabelChange(targetId, label) methods
  - Add label field to SessionTreeNode, populated by getTree()
  - Update createBranchedSession to preserve labels for entries on path
  - Labels are ignored by buildSessionContext (not sent to LLM)
  - Add comprehensive tests for label functionality

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  9e68a59fed
• Session tree: simplify types, add branching API, comprehensive tests

  Types:
  - SessionEntryBase with type field, extended by all entry types
  - CustomEntry for hooks (type: 'custom', customType, data)
  - Remove XXXContent types and TreeNode (redundant)
  
  API:
  - Rename saveXXX to appendXXX with JSDoc explaining tree semantics
  - Rename branchInPlace to branch() with better docs
  - Add createBranchedSession(leafId) replacing index-based version
  - Add getTree() returning SessionTreeNode[] for tree traversal
  - Add appendCustomEntry(customType, data) for hooks
  
  Tests:
  - tree-traversal.test.ts: 28 tests covering append, getPath, getTree,
    branch, branchWithSummary, createBranchedSession
  - save-entry.test.ts: custom entry integration
  
  Docs:
  - Class-level JSDoc explaining append-only tree model
  - Method docs explaining leaf advancement and branching
  - CHANGELOG.md entry for all changes

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  6f94e24629
• Refactor session manager: migration chain, validation, tests

  - Add migrateV1ToV2/migrateToCurrentVersion for extensible migrations
  - createSummaryMessage now takes timestamp from entry
  - loadEntriesFromFile validates session header
  - findMostRecentSession only returns valid session files (reads first 512 bytes)
  - Remove ConversationEntry alias
  - Fix mom context.ts TreeNode type
  
  Tests:
  - migration.test.ts: v1 migration, idempotency
  - build-context.test.ts: 14 tests covering trivial, compaction, branches
  - file-operations.test.ts: loadEntriesFromFile, findMostRecentSession

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  beb70f126d