internal/

Package attach ingests uploaded images and videos: it sniffs the real content type, optionally optimizes images (EXIF-orient, downscale, re-encode to lossy WebP, keep-smaller), and returns the bytes to persist plus metadata.

Package cli implements Pine's cobra command tree: init, serve, the Beads-style ticket commands (list/show/create/update/close/dep/ready/log), upgrade (self-update from GitHub Releases), learn (capture/list/search/show/ supersede/rm persistent learnings), and the AI helpers (context/prompt/export/doctor/optimize).

Package config loads, validates, and saves Pine's two JSON config files: .pine/config.json (project settings) and .pine/board.json (kanban columns).

Package contextgen builds the markdown that teaches an AI agent about the project: `pine context` (whole-project briefing) and `pine prompt <ID>` (a fix request for one ticket).

Package crossbranch aggregates tickets that live on other git branches into a read-only overlay for the board.

Package doctor validates a .pine workspace: config/board schemas, ticket integrity, dependency/epic consistency, and attachment health.

Package frontmatter holds the YAML frontmatter parsing/serialization primitives shared by internal/ticket and internal/learning: splitting the "---" delimited block from the body, decoding string lists leniently, and formatting/parsing timestamps.

Package gitx exposes read-only git awareness (branch, working-tree status, recent commits, tracked files) behind a small Client interface.

Package learning is the pure domain layer for Pine learnings: parsing and serializing markdown+frontmatter files under .pine/learnings/.

Package links resolves typed graph references between tickets, memory topics, MEMORY.md, and learnings, and builds a unified graph with computed backlinks.

Package memory manages project MEMORY.md and topic files under .pine/memory/.

Package search maintains an in-memory Bleve index over tickets and learnings.

Package server exposes the store over an HTTP+JSON API and serves the embedded web UI.

Package store is Pine's single write path over a .pine/ directory.

Package syncignore manages the Pine-owned block in .pine/.gitignore that controls whether tickets/ and attachments/ are committed or kept local.

Package ticket is the pure domain layer for Pine tickets: parsing and serializing the markdown+frontmatter file format, reading body sections, and computing the dependency/epic graph.

Package view builds the presentation DTO for a ticket, joining the parsed ticket with computed dependency state, epic children, attachments, and its content hash.

Package watch turns raw filesystem notifications under .pine/ into debounced, classified change events.

Package workspace manages the machine-wide registry of Pine repos at ~/.pine/repos.json.