docs: core v1 documentation

* updated ROADMAP

Author: desertthunder

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "[typescript]": { "editor.defaultFormatter": "dprint.dprint" },
+    "[typescriptreact]": { "editor.defaultFormatter": "dprint.dprint" },
+    "[javascript]": { "editor.defaultFormatter": "dprint.dprint" },
+    "[javascriptreact]": { "editor.defaultFormatter": "dprint.dprint" }
+}

internal/docs/ROADMAP.md

@@ -47,10 +47,10 @@ Notes have create, list, read, edit, and remove commands with interactive and st
     - [ ] Add [OAuth2](#publications--authentication)
 - [x] Verify `pub pull` fetches and syncs documents from leaflet.
 - [x] Confirm `pub list` with status filtering (`all`, `published`, `draft`).
-- [ ] Test `pub post` creates new documents with draft/preview/validate modes.
-- [ ] Ensure `pub patch` updates existing documents correctly.
-- [ ] Validate `pub push` handles batch operations (create/update).
-- [ ] Verify markdown conversion to leaflet block format (headings, code, images, facets).
+- [x] Test `pub post` creates new documents with draft/preview/validate modes.
+- [x] Ensure `pub patch` updates existing documents correctly.
+- [x] Validate `pub push` handles batch operations (create/update).
+- [x] Verify markdown conversion to leaflet block format (headings, code, images, facets).
 
 ### Media Domains
 
@@ -200,6 +200,17 @@ Features that demonstrate Go proficiency and broaden Noteleaf’s scope.
 - [ ] External imports (Goodreads, IMDB, Letterboxd)
 - [ ] Cross-referencing across media types
 - [ ] Analytics: velocity, completion rates
+- [ ] Books (Open Library integration enhancements)
+    - [ ] Author detail fetching (full names, bio)
+    - [ ] Edition-specific metadata
+    - [ ] Cover image download and caching
+    - [ ] Reading progress tracking
+    - [ ] Personal reading lists sync
+- [ ] Movies/TV (external API integration)
+    - [ ] Movie databases (TMDb, OMDb)
+    - [ ] Rotten Tomatoes integration
+- [ ] Music
+    - [ ] Music services (MusicBrainz, Album of the Year)
 
 ### Articles
 
@@ -232,17 +243,24 @@ Features that demonstrate Go proficiency and broaden Noteleaf’s scope.
         - [ ] Ephemeral HTTP server on localhost
         - [ ] Browser launch integration
         - [ ] Timeout handling for abandoned flows
-    - [ ] Migration path from app passwords to OAuth
-        - [ ] Detect existing app password sessions
-        - [ ] Prompt users to upgrade authentication
-        - [ ] Maintain backward compatibility
+    - [ ] Support both OAuth & App Passwords but recommend OAuth
+- [ ] Leaflet.pub enhancements
+    - [ ] Multiple Publications: Manage separate publications for different topics
+    - [ ] Image Upload: Automatically upload images to blob storage and embed in documents
+    - [ ] Status Management: Publish drafts and unpublish documents from CLI
+    - [ ] Metadata Editing: Update document titles, summaries, and tags
+    - [ ] Backlink Support: Parse and resolve cross-references between documents
+    - [ ] Offline Mode: Queue posts and patches for later upload
 
 ### User Experience
 
 - [ ] Shell completions
 - [ ] Manpages and docs generator
 - [ ] Theming and customizable output
 - [ ] Calendar integration
+- [ ] Task synchronization services
+- [ ] Git repository linking
+- [ ] Note export to other platforms
 
 ### Tasks
 
@@ -274,7 +292,8 @@ Features that demonstrate Go proficiency and broaden Noteleaf’s scope.
 
 ### Local API Server
 
-A local HTTP server daemon that exposes Noteleaf data for web UIs and extensions. Runs on the user's machine and provides programmatic access to tasks, notes, and media.
+A local HTTP server daemon that exposes Noteleaf data for web UIs and extensions.
+Runs on the user's machine and provides programmatic access to tasks, notes, and media.
 
 #### Architecture
 
@@ -402,26 +421,40 @@ SQLite persistence, CI with GitHub Actions and Codecov, TUIs with Charm stack, i
 #### Post v1
 
 - Backup/restore
+    - [ ] Automated backups
+    - [ ] Backup scheduling and rotation
 - Multiple profiles
 - Optional synchronization
+    - [ ] Sync service
+- Import/Export
+    - [ ] CSV export for tasks
+    - [ ] Markdown export for tasks
+    - [ ] Bulk export commands
+    - [ ] Migration utilities (TaskWarrior, todo.txt, etc.)
+    - [ ] Git integration for notes/data versioning
 
 ## v1 Feature Matrix
 
-| Domain   | Feature               | Status    |
-|----------|-----------------------|-----------|
-| Tasks    | CRUD                  | Complete  |
-| Tasks    | Projects/tags         | Complete  |
-| Tasks    | Time tracking         | Complete  |
-| Tasks    | Dependencies          | Complete  |
-| Tasks    | Recurrence            | Complete  |
-| Tasks    | Wait/scheduled        | Planned   |
-| Tasks    | Urgency scoring       | Planned   |
-| Notes    | CRUD                  | Complete  |
-| Notes    | Search/tagging        | Planned   |
-| Media    | Books/movies/TV       | Complete  |
-| Media    | Articles              | Complete  |
-| Media    | Source/ratings        | Planned   |
-| Articles | Parser + storage      | Complete  |
-| System   | SQLite persistence    | Complete  |
-| System   | Synchronization       | Future    |
-| System   | Import/export formats | Future    |
+| Domain       | Feature                    | Status    |
+|--------------|----------------------------|-----------|
+| Tasks        | CRUD                       | Complete  |
+| Tasks        | Projects/tags              | Complete  |
+| Tasks        | Time tracking              | Complete  |
+| Tasks        | Dependencies               | Complete  |
+| Tasks        | Recurrence                 | Complete  |
+| Tasks        | Wait/scheduled             | Planned   |
+| Tasks        | Urgency scoring            | Planned   |
+| Notes        | CRUD                       | Complete  |
+| Notes        | Search/tagging             | Planned   |
+| Publications | AT Protocol sync           | Complete  |
+| Publications | Post/patch/push            | Complete  |
+| Publications | Markdown conversion        | Complete  |
+| Publications | OAuth2                     | Future    |
+| Media        | Books/movies/TV            | Complete  |
+| Media        | Articles                   | Complete  |
+| Media        | Source/ratings             | Planned   |
+| Articles     | Parser + storage           | Complete  |
+| System       | SQLite persistence         | Complete  |
+| System       | Configuration management   | Complete  |
+| System       | Synchronization            | Future    |
+| System       | Import/export formats      | Future    |

website/TODO.md

@@ -4,31 +4,31 @@ This document tracks documentation coverage for the Noteleaf website. The goal i
 
 ## Integration and Workflows
 
-- [ ] External Integrations
-  - [ ] Open Library API
-  - [ ] Leaflet.pub API
-  - [ ] ATProto authentication
+- [x] External Integrations
+  - [x] Open Library API
+  - [x] Leaflet.pub API
+  - [x] ATProto authentication
 - [ ] Workflows and Examples
   - [ ] Daily task review workflow
   - [ ] Note-taking for research
   - [ ] Reading list management
   - [ ] Publishing a blog post to leaflet.pub
   - [ ] Linking tasks, notes, and media
-- [ ] Import/Export
-  - [ ] Exporting data
-  - [ ] Backup and restore
-  - [ ] Migration from other tools
+- [x] Import/Export
+  - [x] Exporting data
+  - [x] Backup and restore
+  - [x] Migration from other tools
 
 ## Development
 
-- [ ] Building Noteleaf
-  - [ ] Development vs production builds
-  - [ ] Build tags
-  - [ ] Task automation (Taskfile)
-- [ ] Testing
-  - [ ] Running tests
-  - [ ] Coverage reports
-  - [ ] Test patterns and scaffolding
+- [x] Building Noteleaf
+  - [x] Development vs production builds
+  - [x] Build tags
+  - [x] Task automation (Taskfile)
+- [x] Testing
+  - [x] Running tests
+  - [x] Coverage reports
+  - [x] Test patterns and scaffolding
 - [ ] Contributing
   - [ ] Code organization
   - [ ] Adding new commands
@@ -54,14 +54,6 @@ This document tracks documentation coverage for the Noteleaf website. The goal i
   - [ ] Zettelkasten method
   - [ ] Research notes
   - [ ] Meeting notes
-- [ ] Publishing Tutorials
-  - [ ] Writing a blog post
-  - [ ] Creating a publication
-  - [ ] Managing drafts
-- [ ] Advanced Tutorials
-  - [ ] Scripting with Noteleaf
-  - [ ] Custom automation
-  - [ ] Data analysis
 
 ## Appendices
 

website/docs/development/building.md

@@ -0,0 +1,167 @@
+---
+title: Building Noteleaf
+sidebar_label: Building
+sidebar_position: 1
+description: Build configurations and development workflows.
+---
+
+# Building Noteleaf
+
+Noteleaf uses [Task](https://taskfile.dev) for build automation, providing consistent workflows across development, testing, and releases.
+
+## Prerequisites
+
+- Go 1.21 or later
+- [Task](https://taskfile.dev) (install via `brew install go-task/tap/go-task` on macOS)
+- Git (for version information)
+
+## Build Types
+
+### Development Build
+
+Quick build without version injection for local development:
+
+```sh
+task build
+```
+
+Output: `./tmp/noteleaf`
+
+### Development Build with Version
+
+Build with git commit hash and development tools enabled:
+
+```sh
+task build:dev
+```
+
+Version format: `git describe` output (e.g., `v0.1.0-15-g1234abc`)
+Output: `./tmp/noteleaf`
+
+### Release Candidate Build
+
+Build with `-rc` tag, excludes development tools:
+
+```sh
+git tag v1.0.0-rc1
+task build:rc
+```
+
+Requirements:
+
+- Clean git tag with `-rc` suffix
+- Tag format: `v1.0.0-rc1`, `v2.1.0-rc2`, etc.
+
+### Production Build
+
+Build for release with strict validation:
+
+```sh
+git tag v1.0.0
+task build:prod
+```
+
+Requirements:
+
+- Clean semver git tag (e.g., `v1.0.0`, `v2.1.3`)
+- No uncommitted changes
+- No prerelease suffix
+
+## Build Tags
+
+Production builds use the `prod` build tag to exclude development and seed commands:
+
+```go
+//go:build !prod
+```
+
+Commands excluded from production:
+
+- `noteleaf dev` - Development utilities
+- `noteleaf seed` - Test data generation
+
+## Version Information
+
+Build process injects version metadata via ldflags:
+
+```go
+// internal/version/version.go
+var (
+    Version   = "dev"           // Git tag or "dev"
+    Commit    = "none"          // Git commit hash
+    BuildDate = "unknown"       // Build timestamp
+)
+```
+
+View version information:
+
+```sh
+task version:show
+noteleaf version
+```
+
+## Build Artifacts
+
+All binaries are built to `./tmp/` directory:
+
+```
+tmp/
+└── noteleaf    # Binary for current platform
+```
+
+## Development Workflow
+
+Full development cycle with linting and testing:
+
+```sh
+task dev
+```
+
+Runs:
+
+1. Clean build artifacts
+2. Run linters (vet, fmt)
+3. Execute all tests
+4. Build binary
+
+## Manual Build
+
+Build directly with Go (bypasses Task automation):
+
+```sh
+go build -o ./tmp/noteleaf ./cmd
+```
+
+With version injection:
+
+```sh
+go build -ldflags "-X github.com/stormlightlabs/noteleaf/internal/version.Version=v1.0.0" -o ./tmp/noteleaf ./cmd
+```
+
+## Cross-Platform Builds
+
+Build for specific platforms:
+
+```sh
+# Linux
+GOOS=linux GOARCH=amd64 go build -o ./tmp/noteleaf-linux ./cmd
+
+# Windows
+GOOS=windows GOARCH=amd64 go build -o ./tmp/noteleaf.exe ./cmd
+
+# macOS (ARM)
+GOOS=darwin GOARCH=arm64 go build -o ./tmp/noteleaf-darwin-arm64 ./cmd
+```
+
+## Clean Build
+
+Remove all build artifacts:
+
+```sh
+task clean
+```
+
+Removes:
+
+- `./tmp/` directory
+- `coverage.out` and `coverage.html`