candlekeep-cli 0.6.0

CandleKeep CLI - Manage your document library from the terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# Changelog

## [0.6.0] - 2026-02-14

### Added
- **Access Session Tracking**: Research session management for analytics
  - `ck access start` - Start a new research session with optional `--intent`
  - `ck access complete` - Complete the current research session
  - Global `--session <id>` flag to attach commands to an existing session
  - Global `--no-session` flag to disable session tracking (used by book-enricher)
- All item commands (`list`, `toc`, `read`, `add`, `remove`) now pass session context to API for access logging

### Changed
- API client refactored to support session headers on all requests
- Auth commands updated to pass session context

## [0.5.0] - 2026-02-14

### Added
- **Sources Management**: Commands for managing content sources
  - `ck sources list` - List saved sources (tweets, etc.)
  - `ck sources delete <id>` - Delete a source by ID
- Item list now uses `status` field instead of latest job lookup

## [0.4.0] - 2026-02-04

### Added
- **Markdown Document Support**: Full CRUD operations for markdown documents
  - `ck items create <title>` - Create new markdown documents with `--content` flag
  - `ck items get <id>` - Retrieve markdown content for a document
  - `ck items put <id>` - Update markdown content for existing documents
- Table of contents extraction now works for both PDF and markdown documents
- Real-time content versioning with page tracking

### Changed
- `ck items list` now shows markdown documents alongside PDFs
- `ck items toc` supports both PDF and markdown documents
- `ck items read` works with markdown page ranges

## [0.3.1] - 2026-02-03

### Added
- **TOC Support in Enrich**: New `--toc` option for `ck items enrich` command
  - Accepts JSON array: `--toc '[{"title":"Chapter 1","page":1,"level":1}]'`
  - Validates TOC entries (non-empty titles, page >= 1, level >= 1)
  - Saves TOC to item metadata for navigation

### Changed
- `ck items enrich` now requires at least one of: --title, --author, --description, or --toc

## [0.3.0] - 2026-02-03

### Added
- **Book Enrichment System**: New commands to manage document metadata
  - `ck items enrich <id>` - Update title, author, description with confidence score
  - `ck items flag <id>` - Flag items needing metadata enrichment
- **Enhanced List Display**:
  - New "Enrich" column showing enrichment status (⚠/✓/-)
  - "Enrichment Queue" section at bottom showing items needing review
  - Items sorted by page count (smallest first in queue)
- **JSON Output Enhancements**:
  - `enrichmentQueue` array in `--json` output
  - New fields: `author`, `needsEnrichment`, `enrichmentConfidence`, `enrichedAt`

### Changed
- Items list now shows 5 columns: ID, Title, Pages, Status, Enrich

## [0.2.1] - 2026-01-30

### Changed
- Added release safeguards and documentation

## [0.2.0] - 2026-01-30

### Added
- Initial CLI release with core functionality
- `ck auth login/logout/whoami` commands
- `ck items list/add/read/toc/remove` commands
- Markdown file upload support