chore(80.6-13): v0.1.0 release artifacts (CHANGELOG, MIGRATION, release workflow)

Plan 80.6-13 — release prep + wheel build + local smoke.

Files:
- CHANGELOG.md (NEW): v0.1.0 release notes — full 10-command CLI surface,
  bundled artifacts (share/, goldens), locked Phase 80.1 architecture,
  install command per D-44, plugin entry-points contract per D-48.
- MIGRATION.md: extended v0.1.0 section with the plugin entry-point
  contract (D-48) — built-in registrations + the v0 unstable-contract
  caveat. Pin against supamem==0.1.* for plugin compat.
- .github/workflows/release.yml (NEW): tag-triggered release workflow.
  On tag push 'v*' it builds wheel + sdist via python -m build and
  uploads to a GitHub release with auto-generated notes via
  softprops/action-gh-release@v2.
- pyproject.toml: replaced [tool.hatch.build.targets.wheel.force-include]
  with explicit include= patterns for non-Python data files (.md, .mdc,
  .sh, .jsonl, .toml). force-include was duplicating files in the wheel
  because the share/ and eval/goldens/ trees are inside src/supamem/ which
  is already covered by packages= ["src/supamem"]. Single include= list
  ships the data files exactly once.

Verification:
  python -m build  -> dist/supamem-0.1.0-py3-none-any.whl + .tar.gz
  Fresh /tmp venv install via pip:
    supamem --version  -> 'supamem v0.1.0' + credit line
    supamem --help     -> all 10 subcommands listed
    importlib.resources finds share/rules/dual-memory.md AND
      eval/goldens/phase_80_1_tuned_hybrid.jsonl in the installed wheel
  148/148 pytest pass. ruff clean.

Next (Task 3, blocked on user approval per autonomous: false):
  git tag -a v0.1.0 -m "supamem v0.1.0 — initial release"
  git push origin main v0.1.0
  release.yml fires on tag push -> GitHub release v0.1.0 with artifacts.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dzmitrys-dev

.github/workflows/release.yml

@@ -0,0 +1,36 @@
+name: release
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build
+        run: pip install build
+
+      - name: Build wheel + sdist
+        run: python -m build
+
+      - name: List artifacts
+        run: ls -lh dist/
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+          fail_on_unmatched_files: true

CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+All notable changes to `supamem` will be documented in this file.
+
+## v0.1.0 — 2026-04-29
+
+The initial public release. Extracted from the SoftChat dual-memory stack
+(Phases 80.1–80.5) and shipped as a project-agnostic Python package under MIT.
+
+### CLI surface (10 commands)
+
+- `supamem init` — greenfield bootstrap (probes Qdrant, creates per-project
+  hybrid collection, writes `.supamem/config.toml`).
+- `supamem install --client {claude-code|cursor|opencode}` — patches the
+  client config atomically; idempotent; `--dry-run` supported.
+- `supamem uninstall --client X` — reverses install cleanly.
+- `supamem index [--target tuned] [--force] [--snapshot cursor]` — embeds
+  Markdown sources into Qdrant or refreshes the Cursor `.mdc` snapshot.
+- `supamem mcp-server [--transport stdio|http] [--port N] [--host H]` —
+  runs the MCP server. Streamable HTTP per Nov 2025 MCP spec (D-45).
+- `supamem hook {claude-code|opencode} [--file-path X]` — per-client
+  PreToolUse hook delegate. Fail-soft: never blocks the calling tool.
+- `supamem doctor [--show-secrets]` — health probe + resolved config chain
+  + version-drift advisory across detected clients.
+- `supamem stats [--show today|week|all] [--format table|json]` — Welford
+  schema-v2 usage counters from `~/.cache/supamem/audit.jsonl`.
+- `supamem migrate --source X --target Y --path {coexist|migrate|adopt-as-is}`
+  — brownfield migration with snapshot-before-destructive guard.
+- `supamem eval [--regress] [--goldens path]` — recall@5 + p95 latency +
+  total tokens against the bundled 33-query corpus. Phase 80.1 baselines:
+  `mean_recall_at_5 >= 0.60`, `total_tokens <= 4000`, `p95_latency_ms <= 500`.
+
+### Bundled
+
+- `~/.supamem/share/{rules,skills,commands,hooks,cursor-rules}/` — canonical
+  artifacts referenced by every client config (SC-3 reference-not-copy
+  contract; Cursor `.mdc` is the documented copy exception).
+- 33-query golden corpus at `supamem.eval.goldens.phase_80_1_tuned_hybrid`
+  for `--regress` (per D-46).
+- Plugin entry-point groups for retrieval, embedder, and chunker so
+  third-party packages can extend supamem without forking (per D-48).
+
+### Locked architecture (Phase 80.1 D-19 / D-25)
+
+- Hybrid retrieval: BM25 (`Qdrant/bm25`) + dense (`sentence-transformers/
+  all-MiniLM-L6-v2`) with Qdrant native `FusionQuery(RRF)`, prefetch=20.
+- T-1 markdown header chunker, soft-max 250 tokens, fallback 200/20.
+- T-4 recency boost, T-5 cosine dedup (threshold 0.97), T-8 token-budget
+  truncation (1500).
+
+### Install
+
+```bash
+uv tool install git+https://github.com/dzmitrys-dev/supamem@v0.1.0
+```
+
+PyPI publish is deferred to v0.2 per D-44. v0.1.0 is git-tag-only so
+SoftChat's rip-out commit (Plan 80.6-14) can pin a verifiable artifact
+before the broader package distribution surface lands.
+
+### Notes
+
+- Forward-compat: tool `title` field set on every MCP tool registration;
+  Cursor / Claude.ai web honor it today; Claude Code TUI ignores but will
+  pick up automatically when the upstream lands.
+- Stylish `rich`-powered CLI output (banner, panels, spinners, status
+  tables) on every long-running command.
+- Made with care by [SoftChat](https://app.softchat.ru) and
+  [SoftSkillz](https://softskillz.ai).

MIGRATION.md

@@ -8,6 +8,33 @@ First public release. No upgrade path required — install via:
 uv tool install git+https://github.com/dzmitrys-dev/supamem@v0.1.0
 ```
 
+### Plugin entry-point contract (D-48)
+
+`supamem` exposes three plugin groups via `pyproject.toml`
+`[project.entry-points]`. Third-party packages can register additional
+backends without forking:
+
+```toml
+[project.entry-points."supamem.retrieval"]
+my_backend = "my_pkg.backend:MyBackend"
+
+[project.entry-points."supamem.embedder"]
+my_dense = "my_pkg.embedders:MyDenseEmbedder"
+
+[project.entry-points."supamem.chunker"]
+my_chunker = "my_pkg.chunker:my_chunk_fn"
+```
+
+**Compatibility caveat (v0):** the plugin contract is _unstable_ until v1.
+A `0.x.y` minor bump may break plugins. Pin against `supamem==0.1.*` in
+your plugin's `requirements`. The shape of `RetrievedChunk`, the
+`Backend.query(text, k)` signature, and entry-point group names are the
+load-bearing surface; everything else may move.
+
+The built-in registrations (`tuned_hybrid`, `dense`, `bm25` for retrieval;
+`minilm`, `bm25` for embedder; `markdown_header` for chunker) are part of
+the wheel and resolve automatically via `importlib.metadata.entry_points`.
+
 ## SoftChat -> supamem migration
 
 _(Filled in by Phase 80.6 plan 14: SoftChat rip-out.)_

pyproject.toml

@@ -47,10 +47,13 @@ markdown_header = "supamem.indexer.chunker:chunk_markdown"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/supamem"]
-
-[tool.hatch.build.targets.wheel.force-include]
-"src/supamem/share" = "supamem/share"
-"src/supamem/eval/goldens" = "supamem/eval/goldens"
+include = [
+  "src/supamem/**/*.md",
+  "src/supamem/**/*.mdc",
+  "src/supamem/**/*.sh",
+  "src/supamem/**/*.jsonl",
+  "src/supamem/**/*.toml",
+]
 
 [tool.ruff]
 line-length = 100