From 0c0b385c966495e465807aaf852a00fbea98a83b Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 4 Sep 2026 08:01:17 +0000 Subject: [PATCH 1/2] Consolidate the changelog into the 0.1.0 release entry Everything to date ships as 0.1.0, so fold the Unreleased section into a dated release entry with the headliners (library API, MCP server, BM25 search, lean install) up top and the merge-order history below. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01QVbxD1gd3gsC6zXKE6L3ya --- CHANGELOG.md | 44 +++++++++++++++++++++----------------------- 1 file changed, 21 insertions(+), 23 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0f58f1d..86c7daa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,38 +1,36 @@ # Changelog -## Unreleased +## 0.1.0 — 2026-09-04 — first public release -- Search upgraded from TF-IDF cosine to **Okapi BM25** (term-frequency - saturation + document-length normalization, normalized to [0, 1] so the - graph-entity boost keeps its weight). A note spamming one query term no - longer outranks a note covering all of them, and short focused notes - beat long ones with the same match. New docs page: - [how search works](docs/how-search-works.md). - -- Library API: `import graphier; v = graphier.open("~/notes")` — entities, - relations, Datalog queries, conflicts, timeline, `to_networkx()`, and - matplotlib plotting (`plot_graph()`, `plot_timeline()`) via the - `graphier[viz]` extra. Same determinism, same sentence-level evidence. - Plots take styles and effects: "paper"/"dark" presets or a custom - `PlotStyle`, `focus=` neighborhood spotlight with glow on the graph, - `highlight=` lifeline spotlight on the timeline. +The launch cut: the app, the MCP server, and the Python library, built +across 22 pull requests with 63 passing tests. -- Lean PyPI install: `pip install graphier` no longer drags in - multi-gigabyte ML dependencies; `graphier setup` fetches the extraction - engine with `--no-deps`, and a friendly message explains the one - command if it's missing. Release workflow gains PyPI trusted - publishing (no token needed). +### Headliners +- **Library API**: `import graphier; v = graphier.open("~/notes")` — + entities, relations, Datalog queries, conflicts, timeline, + `to_networkx()`, and matplotlib plotting (`plot_graph()`, + `plot_timeline()`) via the `graphier[viz]` extra. Same determinism, + same sentence-level evidence. Plots take styles and effects: + "paper"/"dark" presets or a custom `PlotStyle`, `focus=` neighborhood + spotlight with glow on the graph, `highlight=` lifeline spotlight on + the timeline. - **MCP server** (`graphier-mcp`): the vault's knowledge graph queryable by Claude Code, Claude Desktop, Cursor, and any MCP client over stdio — nine tools (search, entity dossiers, relations, Datalog, conflicts, timeline, notes), every answer carrying sentence-level provenance. +- **Okapi BM25 search** (term-frequency saturation + document-length + normalization, normalized to [0, 1] so the graph-entity boost keeps + its weight), fully documented in + [how search works](docs/how-search-works.md). +- **Lean PyPI install**: `pip install graphier` doesn't drag in + multi-gigabyte ML dependencies; `graphier setup` fetches the extraction + engine with `--no-deps`. Releases publish to PyPI via trusted + publishing (no token needed). - Community infrastructure: CONTRIBUTING, extension guide, roadmap, issue/PR templates, packaging + release workflow. -## 0.1.0 — first public cut - -Everything so far, in merge order: +### Everything else, in merge order: - **Phase 1 walking skeleton** (#1): Markdown vault, FastAPI backend, CodeMirror editor with live entity underlines, entity/relations panel. From 801545e9a047cf335d35719d611fa32d4965a8b0 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 4 Sep 2026 08:02:56 +0000 Subject: [PATCH 2/2] Allow manual releases via workflow_dispatch A workflow_dispatch trigger with a tag_name input lets the release run be started from the Actions tab (or API) when a tag can't be pushed directly; softprops/action-gh-release creates the tag itself in that case. Tag-push releases behave exactly as before via github.ref_name. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01QVbxD1gd3gsC6zXKE6L3ya --- .github/workflows/release.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 27aab82..f4f8e37 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -3,6 +3,13 @@ name: Release on: push: tags: ["v*"] + # Manual release: creates the tag AND the release in one run — for + # when a tag can't be pushed directly (e.g. from a restricted session). + workflow_dispatch: + inputs: + tag_name: + description: "Tag to create and release (e.g. v0.1.0)" + required: true jobs: build: @@ -32,6 +39,7 @@ jobs: - name: Attach to GitHub release uses: softprops/action-gh-release@v2 with: + tag_name: ${{ inputs.tag_name || github.ref_name }} files: dist/* generate_release_notes: true - name: Upload dist for PyPI job