Skip to content

Main#93

Merged
leonardsellem merged 5 commits into
devfrom
main
Jun 25, 2026
Merged

Main#93
leonardsellem merged 5 commits into
devfrom
main

Conversation

@leonardsellem

Copy link
Copy Markdown
Owner

What & why

Briefly describe the change and the problem it solves. Link any issue or plan
(docs/plans/…).

Gates (must pass — same as CI's lint-test-license job)

  • uv run ruff check .
  • uv run python scripts/check_version_consistency.py
  • uv run pytest (new behavior is covered by a test — test-first)
  • uv run python scripts/license_scan.py (no new AGPL/GPL/SSPL dependency)
  • uv run python scripts/preflight_public_scan.py (no operator host/IP/token/secret added)

Security surface

  • This PR does not touch auth (src/hypermnesic/auth*.py), the MCP server,
    the write path (commit_note / serialize / frontmatter_gate), or the
    protected-path / governance guard.
  • If it does: I referenced the relevant SECURITY.md / threat-model entry, and a
    CODEOWNER review is requested.

Docs

  • User-facing changes are reflected in the docs (README / references / guides /
    CHANGELOG.md), and any tool/CLI/config surface change updates the matching
    reference doc.

Sign-off

  • My commits are signed off (git commit -s) per the DCO (see CONTRIBUTING.md).

leonardsellem and others added 5 commits June 19, 2026 13:14
…TDQS-A

Two proof points strengthened since the 2026-06-14 draft:
- PyPI 0.1.0 is published, so every engine draft now leads with the one-command
  'uv tool install hypermnesic' (+ local-proof) instead of hedging it.
- The server is listed on Glama with a passing automated build check and an A
  tool-definition-quality grade; cited as a third-party signal (not the official
  registry). Re-ticked the pre-post review checklist accordingly.

Still off-limits (unchanged): official MCP registry / awesome-list 'listed' claims
(registry not filed; awesome-mcp-servers PR still open) and Discussions availability.

Signed-off-by: Leonard Sellem <leonard@sellem.me>
docs(launch): refresh launch drafts — PyPI install lead + Glama TDQS-A signal
Built-for-myself / opinionated / lightweight / portable-memory framing now opens the
canonical story and every engine draft (Show HN, r/selfhosted, r/ObsidianMD,
r/LocalLLaMA, X/Bluesky, Discord), plus a new 'Narrative spine' section + a checklist
item to keep the voice consistent. The PyPI-install lead and Glama TDQS-A signal from
the prior commit are retained.

Signed-off-by: Leonard Sellem <leonard@sellem.me>
docs(launch): lead drafts with the authentic narrative
…nding USP (#92)

* chore: ignore .DS_Store

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Leonard Sellem <leonard@sellem.me>

* docs(readme): lead with the "one brain, every AI" use case and compounding USP

The README opened with a category label and a feature tour, so a cold reader
couldn't grasp the use case. Rewrite the top to lead with the scenario the
project was built for and an unequivocal USP, preserving the reference depth
below.

- Scenario-led hero ("One brain. Every AI. Yours.") above the receipt GIF.
- "Why it compounds": a new flywheel illustration (Capture -> Curate -> Recall
  -> Compound) plus the shared-brain argument, grounded in reviewable git-commit
  writes.
- "One endpoint, every client" reuses the connector montage.
- Honest "How it's different": mem0/Zep, Hindsight (higher LongMemEval on a more
  lenient judge axis, stated plainly), Honcho (complementary), and the
  DB-backed-brain origin beat; links the expanded why-hypermnesic.md.
- Quick start, How it works, Benchmarks, Docs, License preserved verbatim.

Docs kept in sync per the no-drift rule: why-hypermnesic.md gains vs. Hindsight
and vs. Honcho; CHANGELOG [Unreleased] records the rewrite. Brainstorm spec
added under docs/brainstorms/.

Verification: pytest 721 passed / 1 skipped; preflight_public_scan PASS.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Leonard Sellem <leonard@sellem.me>

* docs(readme): move flywheel asset to media/engine and log frame-review sign-off

Relocate the hero "Why it compounds" illustration from assets/ to
media/engine/flywheel.jpg, matching the demo-asset convention (media/ is the
leak scanner's default scope, unlike docs/launch/); update the README embed and
the CHANGELOG reference.

Add the media/.review-log.md sign-off row (plan U3 gate G7): visual frame review
plus a tesseract OCR sweep, both CLEAN — only fixture note titles
(projects/atlas.md, decisions/use-sqlite-vec.md, people/dana.md,
ideas/second-brain.md) and stage/surface labels, no host/IP/home-path/token/
account/Linear marker. Real brand logos intentionally kept (operator decision).

Verification: preflight_public_scan PASS (219 files); test_preflight_public_scan
+ test_product_readiness_docs green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Leonard Sellem <leonard@sellem.me>

---------

Signed-off-by: Leonard Sellem <leonard@sellem.me>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@leonardsellem leonardsellem merged commit 119a5f4 into dev Jun 25, 2026
2 checks passed
leonardsellem added a commit that referenced this pull request Jun 25, 2026
* docs: add CD automation brainstorm + implementation plan

Requirements brainstorm and Deep implementation plan for automating release-on-merge across hypermnesic and hypermnesic-companion: Conventional Commits -> auto version, changelog, tag, publish; dev->main batched; no approval gate. Source artifacts for the LS Linear epic.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Leonard Sellem <leonard@sellem.me>

* Main (#93)

* docs(launch): refresh launch drafts — lead with PyPI install + Glama TDQS-A

Two proof points strengthened since the 2026-06-14 draft:
- PyPI 0.1.0 is published, so every engine draft now leads with the one-command
  'uv tool install hypermnesic' (+ local-proof) instead of hedging it.
- The server is listed on Glama with a passing automated build check and an A
  tool-definition-quality grade; cited as a third-party signal (not the official
  registry). Re-ticked the pre-post review checklist accordingly.

Still off-limits (unchanged): official MCP registry / awesome-list 'listed' claims
(registry not filed; awesome-mcp-servers PR still open) and Discussions availability.

Signed-off-by: Leonard Sellem <leonard@sellem.me>

* docs(launch): lead drafts with the authentic narrative

Built-for-myself / opinionated / lightweight / portable-memory framing now opens the
canonical story and every engine draft (Show HN, r/selfhosted, r/ObsidianMD,
r/LocalLLaMA, X/Bluesky, Discord), plus a new 'Narrative spine' section + a checklist
item to keep the voice consistent. The PyPI-install lead and Glama TDQS-A signal from
the prior commit are retained.

Signed-off-by: Leonard Sellem <leonard@sellem.me>

* docs(readme): lead with the "one brain, every AI" use case and compounding USP (#92)

* chore: ignore .DS_Store

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Leonard Sellem <leonard@sellem.me>

* docs(readme): lead with the "one brain, every AI" use case and compounding USP

The README opened with a category label and a feature tour, so a cold reader
couldn't grasp the use case. Rewrite the top to lead with the scenario the
project was built for and an unequivocal USP, preserving the reference depth
below.

- Scenario-led hero ("One brain. Every AI. Yours.") above the receipt GIF.
- "Why it compounds": a new flywheel illustration (Capture -> Curate -> Recall
  -> Compound) plus the shared-brain argument, grounded in reviewable git-commit
  writes.
- "One endpoint, every client" reuses the connector montage.
- Honest "How it's different": mem0/Zep, Hindsight (higher LongMemEval on a more
  lenient judge axis, stated plainly), Honcho (complementary), and the
  DB-backed-brain origin beat; links the expanded why-hypermnesic.md.
- Quick start, How it works, Benchmarks, Docs, License preserved verbatim.

Docs kept in sync per the no-drift rule: why-hypermnesic.md gains vs. Hindsight
and vs. Honcho; CHANGELOG [Unreleased] records the rewrite. Brainstorm spec
added under docs/brainstorms/.

Verification: pytest 721 passed / 1 skipped; preflight_public_scan PASS.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Leonard Sellem <leonard@sellem.me>

* docs(readme): move flywheel asset to media/engine and log frame-review sign-off

Relocate the hero "Why it compounds" illustration from assets/ to
media/engine/flywheel.jpg, matching the demo-asset convention (media/ is the
leak scanner's default scope, unlike docs/launch/); update the README embed and
the CHANGELOG reference.

Add the media/.review-log.md sign-off row (plan U3 gate G7): visual frame review
plus a tesseract OCR sweep, both CLEAN — only fixture note titles
(projects/atlas.md, decisions/use-sqlite-vec.md, people/dana.md,
ideas/second-brain.md) and stage/surface labels, no host/IP/home-path/token/
account/Linear marker. Real brand logos intentionally kept (operator decision).

Verification: preflight_public_scan PASS (219 files); test_preflight_public_scan
+ test_product_readiness_docs green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Leonard Sellem <leonard@sellem.me>

---------

Signed-off-by: Leonard Sellem <leonard@sellem.me>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

---------

Signed-off-by: Leonard Sellem <leonard@sellem.me>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

---------

Signed-off-by: Leonard Sellem <leonard@sellem.me>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant