blogwatcher-cli

Files (28)

• release.yml · .github/workflows/
• .gitignore
• .goreleaser.yaml
• AGENTS.md
• CLAUDE.md
• LICENSE
• README.md
• SKILL.md
• main.go · cmd/blogwatcher/
• go.mod
• go.sum
• commands.go · internal/cli/
• errors.go · internal/cli/
• metadata.go · internal/cli/
• metadata_test.go · internal/cli/
• root.go · internal/cli/
• controller.go · internal/controller/
• controller_test.go · internal/controller/
• model.go · internal/model/
• rss.go · internal/rss/
• rss_test.go · internal/rss/
• scanner.go · internal/scanner/
• scanner_test.go · internal/scanner/
• scraper.go · internal/scraper/
• scraper_test.go · internal/scraper/
• database.go · internal/storage/
• database_test.go · internal/storage/
• version.go · internal/version/

SKILL.md (first lines)

# BlogWatcher CLI

## Quick Orientation
- Use the Cobra entry point in `cmd/blogwatcher/main.go` and `internal/cli/`.
- Route business logic through `internal/controller` and persistence through `internal/storage`.
- Use scanning pipeline packages in `internal/scanner`, `internal/rss`, and `internal/scraper`.
- Remember the default SQLite path is `~/.blogwatcher/blogwatcher.db` (override with `BLOGWATCHER_DB`) and is created on demand.

## Run Commands
- Run locally with `go run ./cmd/blogwatcher ...`.
- Build with `go build ./cmd/blogwatcher`.

## Change Workflow
1. Add or adjust CLI commands in `internal/cli/commands.go` (Cobra options, arguments, output formatting).
2. Put non-trivial logic in `internal/controller` so the CLI stays thin and testable.
3. Update storage or schema in `internal/storage/database.go` and adjust model conversion in `internal/model` if needed.
4. Modify scanning behavior in `internal/scanner` and its helpers (`internal/rss`, `internal/scraper`).
5. Update or add tests under `internal/` or `cmd/` for every feature change or addition.

## Test Guidance
- Run tests with `go test ./...`.
- If you add a feature, add tests and any necessary dummy data.
- Keep tests focused on CLI behavior, controller logic, and scraper/RSS parsing outcomes.

## Output Conventions
- Preserve user-friendly CLI output with colors and clear errors.
- When listing posts available for reading, always include the link to each post in the output.
- Keep error handling consistent with existing exceptions (`BlogNotFoundError`, `BlogAlreadyExistsError`, `ArticleNotFoundError`).

### Example (posts available for reading)
```text
Unread articles (2):

  [12] [new] Understanding Click Contexts
       Blog: Real Python
       URL: https://realpython.com/click-context/
       Published: 2025-11-02

  [13] [new] Async IO in Practice
       Blog: Test & Code
       URL: https://testandcode.com/async-io-in-practice/
```

From Hyaxia/blogwatcher, MIT.

More from Hyaxia/blogwatcher