threadsense 0.2.0__tar.gz → 0.3.0__tar.gz

threadsense-0.3.0/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: threadsense
+Version: 0.3.0
+Summary: Evidence-first discussion intelligence tooling.
+License: MIT License
+        
+        Copyright (c) 2026 Tom Mathews
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic-settings>=2.13.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: rich>=14.3.3
+Description-Content-Type: text/markdown
+
+# ThreadSense
+
+**Discussion intelligence, not scraping.** ThreadSense is a reproducible pipeline that turns public discussion threads into structured, evidence-backed product and research intelligence.
+
+## Why ThreadSense
+
+Scrapers give you raw payloads. AI summarizers give you prose. Neither gives you a defensible basis for decisions.
+
+ThreadSense keeps the evidence chain intact at every stage:
+
+1. **Acquire** — source connectors fetch threads from Reddit, Hacker News, GitHub Discussions, and GitHub Gists
+2. **Normalize** — source-specific payloads are mapped into a canonical thread model with provenance metadata
+3. **Analyze** — deterministic extraction identifies issues, feature requests, themes, and sentiment — each linked to the comment that produced it
+4. **Synthesize** — optional local-model inference adds summaries on top of the deterministic evidence layer
+5. **Report** — structured outputs in Markdown, HTML, or JSON, with full traceability from finding back to source comment
+
+Every stage produces a persisted, inspectable artifact. Rerun any stage independently. Diff results across runs. Audit exactly where a finding came from.
+
+## What This Enables
+
+### Single-thread analysis
+
+Feed a discussion URL. Get structured findings — issues, requests, themes, severity — with every claim linked to the comment that produced it.
+
+```bash
+uv run threadsense run reddit \
+  "https://www.reddit.com/r/ClaudeCode/comments/1ro0qbl/anyone_actually_built_a_second_brain_that_isnt/" \
+  --format markdown \
+  --with-summary \
+  --summary-required
+```
+
+Works with GitHub Gists too — flat-comment discussions with code context:
+
+```bash
+uv run threadsense run gist \
+  "https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f" \
+  --format markdown
+```
+
+### Cross-thread research
+
+Search a topic across multiple subreddits. ThreadSense deterministically selects, ranks, and analyzes matching threads, then synthesizes a corpus-level report.
+
+```bash
+uv run threadsense --output-format human research reddit \
+  --query "second brain OR agentic PKM" \
+  --subreddit ClaudeCode \
+  --subreddit LocalLLaMA \
+  --subreddit AI_Agents \
+  --limit 5 \
+  --per-subreddit-limit 3 \
+  --with-summary
+```
+
+### Domain-aware analysis
+
+The analysis layer uses a contract system with domain-specific vocabularies (developer tools, product feedback, hiring, research, financial markets, gaming). Each domain defines its own theme keywords, issue markers, and severity calibration — so analysis adapts to context rather than applying one-size-fits-all heuristics.
+
+## Architecture
+
+```text
+fetch → normalize → analyze → [optional inference] → report
+         ↓              ↓              ↓                ↓
+     raw artifact   canonical     analysis         report artifact
+                    artifact      artifact
+```
+
+- **Deterministic core** — parsing, normalization, scoring, and selection are reproducible across runs
+- **Inference on top** — LLM synthesis is optional and layered over deterministic evidence, never a substitute for it
+- **Stable artifacts** — each stage persists a separate JSON artifact with `schema_version` and SHA256 provenance
+- **Fail fast** — invalid URLs, malformed payloads, and schema inconsistencies surface immediately
+
+## Sources and Discovery
+
+| Capability      | Reddit | Hacker News | GitHub Discussions | GitHub Gists |
+| --------------- | :----: | :---------: | :----------------: | :----------: |
+| Thread analysis |  yes   |     yes     |        yes         |     yes      |
+| Topic research  |  yes   |      —      |         —          |      —       |
+
+## Output Modes
+
+| Mode    | Purpose                                          |
+| ------- | ------------------------------------------------ |
+| `json`  | Machine-readable payloads for downstream tooling |
+| `human` | Rich terminal panels and summaries for operators |
+| `quiet` | Status-only output for scripts and CI            |
+
+```bash
+uv run threadsense --output-format human research reddit ...
+```
+
+See [docs/output-modes.md](docs/output-modes.md) for details.
+
+## Who This Is For
+
+- **Product teams** validating pain points and feature demand from community discussions
+- **Founders** doing market and competitor research across technical communities
+- **DevRel teams** tracking developer workflow friction and tooling sentiment
+- **Researchers** studying technical communities with reproducible methodology
+
+## Quickstart
+
+```bash
+# 1. Install
+uv sync
+
+# 2. Validate local setup
+uv run threadsense preflight
+
+# 3. Analyze a single thread
+uv run threadsense run reddit \
+  "https://www.reddit.com/r/ClaudeCode/comments/1ro0qbl/anyone_actually_built_a_second_brain_that_isnt/"
+
+# 4. Analyze a GitHub Gist
+uv run threadsense run gist \
+  "https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f"
+
+# 5. Research a topic across subreddits
+uv run threadsense research reddit \
+  --query "second brain OR agentic PKM" \
+  --subreddit ClaudeCode \
+  --subreddit LocalLLaMA \
+  --subreddit AI_Agents
+```
+
+## CLI Commands
+
+| Command           | Purpose                                             |
+| ----------------- | --------------------------------------------------- |
+| `run`             | End-to-end single-thread pipeline                   |
+| `research reddit` | Cross-subreddit topic research and corpus synthesis |
+| `fetch`           | Acquire raw thread data                             |
+| `normalize`       | Map raw data to canonical model                     |
+| `analyze`         | Deterministic evidence extraction                   |
+| `infer`           | LLM-assisted synthesis                              |
+| `report`          | Generate output reports                             |
+| `corpus`          | Build and analyze cross-thread corpora              |
+| `inspect`         | Examine persisted artifacts                         |
+| `batch run`       | Process multiple threads                            |
+| `preflight`       | Validate local environment                          |
+| `serve`           | Local API server                                    |
+
+Full command reference: [docs/usage.md](docs/usage.md)
+
+## Artifact Storage
+
+Every pipeline run produces inspectable artifacts under `.threadsense/`:
+
+```text
+.threadsense/
+├── raw/<source>/          # Source payloads as fetched
+├── normalized/<source>/   # Canonical thread model
+├── analysis/<source>/     # Evidence-linked findings
+├── reports/<source>/      # Rendered reports
+├── corpora/<corpus-id>/   # Manifest, analysis, and report
+└── batches/               # Batch run metadata
+```
+
+Details: [docs/artifacts.md](docs/artifacts.md)
+
+## Local Runtime
+
+ThreadSense runs without a local model for deterministic analysis. Summaries and synthesis require a local OpenAI-compatible endpoint (default: `http://127.0.0.1:8080/v1/chat/completions`).
+
+Details: [docs/local-runtime-contract.md](docs/local-runtime-contract.md)
+
+## Documentation
+
+| Document                                                    | Content                             |
+| ----------------------------------------------------------- | ----------------------------------- |
+| [usage.md](docs/usage.md)                                   | Command reference                   |
+| [research-reddit.md](docs/research-reddit.md)               | Reddit topic research workflow      |
+| [output-modes.md](docs/output-modes.md)                     | JSON, human, and quiet output modes |
+| [artifacts.md](docs/artifacts.md)                           | Artifact types and storage layout   |
+| [overview.md](docs/overview.md)                             | Product and workflow overview       |
+| [system-design.md](docs/system-design.md)                   | Architecture and system boundaries  |
+| [local-runtime-contract.md](docs/local-runtime-contract.md) | Local inference contract            |
+| [pitch.md](docs/pitch.md)                                   | Product positioning                 |
+
+## Validation
+
+```bash
+uv run ruff check
+uv run ruff format --check .
+uv run mypy --strict src tests
+uv run pytest
+```
+
+## Current Limits
+
+- Topic research is implemented for Reddit; other source discovery workflows are planned
+- Reddit research queries support `OR`/`|` clause unions only (intentionally narrow for deterministic alignment)
+- Corpus reports are Markdown only
+- GitHub Gist comments are flat (no threading); analysis uses temporal/semantic clustering
+- GitHub Gist connector does not retry on transient API errors (502/503)
+- The local API is a trusted local surface, not a hardened public service
+
+## Direction
+
+- Richer corpus presentation and operator workflows
+- Discovery workflows beyond Reddit
+- Evaluation and replay benchmarking
+- Source-distribution and research-quality reporting

threadsense-0.3.0/README.md

@@ -0,0 +1,204 @@
+# ThreadSense
+
+**Discussion intelligence, not scraping.** ThreadSense is a reproducible pipeline that turns public discussion threads into structured, evidence-backed product and research intelligence.
+
+## Why ThreadSense
+
+Scrapers give you raw payloads. AI summarizers give you prose. Neither gives you a defensible basis for decisions.
+
+ThreadSense keeps the evidence chain intact at every stage:
+
+1. **Acquire** — source connectors fetch threads from Reddit, Hacker News, GitHub Discussions, and GitHub Gists
+2. **Normalize** — source-specific payloads are mapped into a canonical thread model with provenance metadata
+3. **Analyze** — deterministic extraction identifies issues, feature requests, themes, and sentiment — each linked to the comment that produced it
+4. **Synthesize** — optional local-model inference adds summaries on top of the deterministic evidence layer
+5. **Report** — structured outputs in Markdown, HTML, or JSON, with full traceability from finding back to source comment
+
+Every stage produces a persisted, inspectable artifact. Rerun any stage independently. Diff results across runs. Audit exactly where a finding came from.
+
+## What This Enables
+
+### Single-thread analysis
+
+Feed a discussion URL. Get structured findings — issues, requests, themes, severity — with every claim linked to the comment that produced it.
+
+```bash
+uv run threadsense run reddit \
+  "https://www.reddit.com/r/ClaudeCode/comments/1ro0qbl/anyone_actually_built_a_second_brain_that_isnt/" \
+  --format markdown \
+  --with-summary \
+  --summary-required
+```
+
+Works with GitHub Gists too — flat-comment discussions with code context:
+
+```bash
+uv run threadsense run gist \
+  "https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f" \
+  --format markdown
+```
+
+### Cross-thread research
+
+Search a topic across multiple subreddits. ThreadSense deterministically selects, ranks, and analyzes matching threads, then synthesizes a corpus-level report.
+
+```bash
+uv run threadsense --output-format human research reddit \
+  --query "second brain OR agentic PKM" \
+  --subreddit ClaudeCode \
+  --subreddit LocalLLaMA \
+  --subreddit AI_Agents \
+  --limit 5 \
+  --per-subreddit-limit 3 \
+  --with-summary
+```
+
+### Domain-aware analysis
+
+The analysis layer uses a contract system with domain-specific vocabularies (developer tools, product feedback, hiring, research, financial markets, gaming). Each domain defines its own theme keywords, issue markers, and severity calibration — so analysis adapts to context rather than applying one-size-fits-all heuristics.
+
+## Architecture
+
+```text
+fetch → normalize → analyze → [optional inference] → report
+         ↓              ↓              ↓                ↓
+     raw artifact   canonical     analysis         report artifact
+                    artifact      artifact
+```
+
+- **Deterministic core** — parsing, normalization, scoring, and selection are reproducible across runs
+- **Inference on top** — LLM synthesis is optional and layered over deterministic evidence, never a substitute for it
+- **Stable artifacts** — each stage persists a separate JSON artifact with `schema_version` and SHA256 provenance
+- **Fail fast** — invalid URLs, malformed payloads, and schema inconsistencies surface immediately
+
+## Sources and Discovery
+
+| Capability      | Reddit | Hacker News | GitHub Discussions | GitHub Gists |
+| --------------- | :----: | :---------: | :----------------: | :----------: |
+| Thread analysis |  yes   |     yes     |        yes         |     yes      |
+| Topic research  |  yes   |      —      |         —          |      —       |
+
+## Output Modes
+
+| Mode    | Purpose                                          |
+| ------- | ------------------------------------------------ |
+| `json`  | Machine-readable payloads for downstream tooling |
+| `human` | Rich terminal panels and summaries for operators |
+| `quiet` | Status-only output for scripts and CI            |
+
+```bash
+uv run threadsense --output-format human research reddit ...
+```
+
+See [docs/output-modes.md](docs/output-modes.md) for details.
+
+## Who This Is For
+
+- **Product teams** validating pain points and feature demand from community discussions
+- **Founders** doing market and competitor research across technical communities
+- **DevRel teams** tracking developer workflow friction and tooling sentiment
+- **Researchers** studying technical communities with reproducible methodology
+
+## Quickstart
+
+```bash
+# 1. Install
+uv sync
+
+# 2. Validate local setup
+uv run threadsense preflight
+
+# 3. Analyze a single thread
+uv run threadsense run reddit \
+  "https://www.reddit.com/r/ClaudeCode/comments/1ro0qbl/anyone_actually_built_a_second_brain_that_isnt/"
+
+# 4. Analyze a GitHub Gist
+uv run threadsense run gist \
+  "https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f"
+
+# 5. Research a topic across subreddits
+uv run threadsense research reddit \
+  --query "second brain OR agentic PKM" \
+  --subreddit ClaudeCode \
+  --subreddit LocalLLaMA \
+  --subreddit AI_Agents
+```
+
+## CLI Commands
+
+| Command           | Purpose                                             |
+| ----------------- | --------------------------------------------------- |
+| `run`             | End-to-end single-thread pipeline                   |
+| `research reddit` | Cross-subreddit topic research and corpus synthesis |
+| `fetch`           | Acquire raw thread data                             |
+| `normalize`       | Map raw data to canonical model                     |
+| `analyze`         | Deterministic evidence extraction                   |
+| `infer`           | LLM-assisted synthesis                              |
+| `report`          | Generate output reports                             |
+| `corpus`          | Build and analyze cross-thread corpora              |
+| `inspect`         | Examine persisted artifacts                         |
+| `batch run`       | Process multiple threads                            |
+| `preflight`       | Validate local environment                          |
+| `serve`           | Local API server                                    |
+
+Full command reference: [docs/usage.md](docs/usage.md)
+
+## Artifact Storage
+
+Every pipeline run produces inspectable artifacts under `.threadsense/`:
+
+```text
+.threadsense/
+├── raw/<source>/          # Source payloads as fetched
+├── normalized/<source>/   # Canonical thread model
+├── analysis/<source>/     # Evidence-linked findings
+├── reports/<source>/      # Rendered reports
+├── corpora/<corpus-id>/   # Manifest, analysis, and report
+└── batches/               # Batch run metadata
+```
+
+Details: [docs/artifacts.md](docs/artifacts.md)
+
+## Local Runtime
+
+ThreadSense runs without a local model for deterministic analysis. Summaries and synthesis require a local OpenAI-compatible endpoint (default: `http://127.0.0.1:8080/v1/chat/completions`).
+
+Details: [docs/local-runtime-contract.md](docs/local-runtime-contract.md)
+
+## Documentation
+
+| Document                                                    | Content                             |
+| ----------------------------------------------------------- | ----------------------------------- |
+| [usage.md](docs/usage.md)                                   | Command reference                   |
+| [research-reddit.md](docs/research-reddit.md)               | Reddit topic research workflow      |
+| [output-modes.md](docs/output-modes.md)                     | JSON, human, and quiet output modes |
+| [artifacts.md](docs/artifacts.md)                           | Artifact types and storage layout   |
+| [overview.md](docs/overview.md)                             | Product and workflow overview       |
+| [system-design.md](docs/system-design.md)                   | Architecture and system boundaries  |
+| [local-runtime-contract.md](docs/local-runtime-contract.md) | Local inference contract            |
+| [pitch.md](docs/pitch.md)                                   | Product positioning                 |
+
+## Validation
+
+```bash
+uv run ruff check
+uv run ruff format --check .
+uv run mypy --strict src tests
+uv run pytest
+```
+
+## Current Limits
+
+- Topic research is implemented for Reddit; other source discovery workflows are planned
+- Reddit research queries support `OR`/`|` clause unions only (intentionally narrow for deterministic alignment)
+- Corpus reports are Markdown only
+- GitHub Gist comments are flat (no threading); analysis uses temporal/semantic clustering
+- GitHub Gist connector does not retry on transient API errors (502/503)
+- The local API is a trusted local surface, not a hardened public service
+
+## Direction
+
+- Richer corpus presentation and operator workflows
+- Discovery workflows beyond Reddit
+- Evaluation and replay benchmarking
+- Source-distribution and research-quality reporting

{threadsense-0.2.0 → threadsense-0.3.0}/docs/artifacts.md

@@ -25,6 +25,7 @@ Examples:
 - `.threadsense/raw/reddit/<thread-id>.json`
 - `.threadsense/raw/hackernews/<story-id>.json`
 - `.threadsense/raw/github_discussions/<thread-id>.json`
+- `.threadsense/raw/github_gist/<gist-id>.json`
 
 Purpose:
 
@@ -41,6 +42,7 @@ Examples:
 - `.threadsense/normalized/reddit/<thread-id>.json`
 - `.threadsense/normalized/hackernews/<thread-id>.json`
 - `.threadsense/normalized/github_discussions/<thread-id>.json`
+- `.threadsense/normalized/github_gist/<gist-id>.json`
 
 Purpose:
 
@@ -57,6 +59,7 @@ Examples:
 - `.threadsense/analysis/reddit/<thread-id>.json`
 - `.threadsense/analysis/hackernews/<thread-id>.json`
 - `.threadsense/analysis/github_discussions/<thread-id>.json`
+- `.threadsense/analysis/github_gist/<gist-id>.json`
 
 Purpose:
 

{threadsense-0.2.0 → threadsense-0.3.0}/docs/overview.md

@@ -6,7 +6,7 @@ ThreadSense is an evidence-first discussion intelligence system for turning publ
 
 The implemented system supports:
 
-- source connectors for Reddit, Hacker News, and GitHub Discussions
+- source connectors for Reddit, Hacker News, GitHub Discussions, and GitHub Gists
 - canonical normalization into a shared thread model
 - deterministic analysis with evidence-linked findings
 - optional local-model synthesis for thread and corpus summaries
@@ -90,9 +90,10 @@ ThreadSense separates source-specific acquisition from canonical normalization.
 
 Current source support:
 
-- Reddit
-- Hacker News
-- GitHub Discussions
+- Reddit — threaded comments via JSON API with "more" expansion
+- Hacker News — recursive tree-based item fetching via Firebase API
+- GitHub Discussions — GraphQL with cursor-based pagination for comments and replies
+- GitHub Gists — REST API with paginated flat comments; authentication optional for public gists
 
 Each connector preserves enough source metadata for traceability, while normalization maps the result into a canonical `Thread` object with:
 
@@ -182,7 +183,7 @@ JSON is for machines. Human mode is for operators. Both should expose the same u
 ThreadSense is best described as:
 
 ```text
-multi-source thread analysis + corpus synthesis + subreddit topic research
+multi-source discussion intelligence + corpus synthesis + subreddit topic research
 ```
 
 It is not just a scraper, and it is not just a summarizer. It is a reproducible pipeline from source thread to inspectable intelligence.

{threadsense-0.2.0 → threadsense-0.3.0}/docs/system-design.md

@@ -49,6 +49,7 @@ subreddit search -> candidate ranking -> selected thread fetch/analyze
 - `src/threadsense/connectors/reddit.py`
 - `src/threadsense/connectors/hackernews.py`
 - `src/threadsense/connectors/github_discussions.py`
+- `src/threadsense/connectors/github_gist.py`
 
 Responsibilities:
 
@@ -58,11 +59,11 @@ Responsibilities:
 - preserve source-specific thread metadata
 - return raw artifacts for later normalization
 
-Special note for Reddit:
+Special notes:
 
-- direct thread fetch is URL-based
-- topic research uses explicit subreddit search
-- exact time-window filtering is applied after Reddit retrieval
+- Reddit: direct thread fetch is URL-based; topic research uses explicit subreddit search with exact time-window filtering after retrieval
+- GitHub Discussions: GraphQL with cursor-based pagination for comments (100/page) and replies; requires authentication token
+- GitHub Gists: REST API with paginated flat comments; authentication optional for public gists; comments have no threading (all depth=0)
 
 ### Canonical Model
 

{threadsense-0.2.0 → threadsense-0.3.0}/docs/usage.md

@@ -43,7 +43,7 @@ Top-level commands:
 ### Single-thread run
 
 ```bash
-uv run threadsense run reddit <reddit-url> \
+uv run threadsense run [<source>] <url> \
   [--format markdown|html|json] \
   [--with-summary] \
   [--summary-required] \
@@ -51,7 +51,9 @@ uv run threadsense run reddit <reddit-url> \
   [--flat]
 ```
 
-Example:
+Source can be `reddit`, `hn`, `github-discussions`, `gist`, or omitted for auto-detection.
+
+Examples:
 
 ```bash
 uv run threadsense run reddit \
@@ -61,6 +63,12 @@ uv run threadsense run reddit \
   --summary-required
 ```
 
+```bash
+uv run threadsense run gist \
+  "https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f" \
+  --format markdown
+```
+
 ### Topic research across subreddits
 
 ```bash
@@ -125,6 +133,20 @@ uv run threadsense fetch hn <hackernews-item-url> [--output path/to/raw.json]
 uv run threadsense fetch github-discussions <discussion-url> [--output path/to/raw.json]
 ```
 
+### `fetch github-gist`
+
+```bash
+uv run threadsense fetch github-gist <gist-url> [--output path/to/raw.json]
+```
+
+Aliases: `fetch gist`
+
+Notes:
+
+- Authentication is optional. Public gists work without a token (60 req/hr rate limit).
+- Set `THREADSENSE_GITHUB_GIST_TOKEN` for authenticated access (5,000 req/hr).
+- Comments are paginated at 100/page automatically.
+
 ## `normalize`
 
 Normalize one raw artifact into the canonical thread schema.
@@ -147,6 +169,19 @@ uv run threadsense normalize hn --input path/to/raw.json [--output path/to/norma
 uv run threadsense normalize github-discussions --input path/to/raw.json [--output path/to/normalized.json]
 ```
 
+### `normalize github-gist`
+
+```bash
+uv run threadsense normalize github-gist --input path/to/raw.json [--output path/to/normalized.json]
+```
+
+Aliases: `normalize gist`
+
+Notes:
+
+- Gist comments are flat — all normalized to `depth=0` with no `parent_comment_id`.
+- Multi-file gists are concatenated into a single body, each file prefixed with its filename.
+
 ## `analyze`
 
 Run deterministic analysis for one canonical thread artifact.

{threadsense-0.2.0 → threadsense-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "threadsense"
-version = "0.2.0"
+version = "0.3.0"
 description = "Evidence-first discussion intelligence tooling."
 readme = "README.md"
 license = { file = "LICENSE" }

{threadsense-0.2.0 → threadsense-0.3.0}/src/threadsense/__init__.py

@@ -2,4 +2,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"