Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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
Expand Down
44 changes: 21 additions & 23 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Loading