Skip to content

release/documentation team sync#153

Closed
jb-thery wants to merge 38 commits into
mainfrom
release/documentation-team-sync
Closed

release/documentation team sync#153
jb-thery wants to merge 38 commits into
mainfrom
release/documentation-team-sync

Conversation

@jb-thery

Copy link
Copy Markdown
Member

jb-thery added 30 commits July 9, 2026 08:41
Improve Ragmir retrieval evidence fidelity, MCP smoke coverage, and query sanitizer hardening.
Add verified local Gemma chat profiles, persistent desktop runtime, and hardened retrieval safeguards.
* feat(core): add local PDF OCR onboarding

* docs: document OCR setup and upstream credits

* refactor(workspace): remove native and hosted surfaces

* refactor(landing): keep library-only positioning

* docs: streamline open-source developer guidance

* refactor(landing): simplify closing copy
* fix(workspace): remove leftover UI package

* fix(workspace): remove leftover UI package
Build optional add-ons before running the clean-checkout library demo.
Preserve document structure for retrieval, bound MCP output, add exact citation expansion, and report metadata-only output savings.
Preview structured chunks, explain hybrid retrieval, isolate nested monorepo knowledge bases, and expose bounded MCP context resources.
* feat(landing): redesign use case workflows

* fix(api): harden the public TypeScript surface

* test(core): allow slower setup integration checks

* docs: lead package guides with agent workflows
* fix(tts): resolve relative inputs from project cwd

* feat(landing): present realistic local workflows

* docs: lead with agent-first usage
* feat(core): add persistent Node.js client

* docs: document persistent Node.js integrations

* fix(landing): align npm version accessible label
* fix(core): keep chat and tts truly optional

* fix(landing): polish local rag workflows
Raise meaningful coverage across Core, Chat, TTS, and the landing.

Harden ingestion, retrieval, local generation, MCP responses, cancellation,
and bounded input handling.

Align public docs, npm READMEs, team guidance, privacy claims, and
landing SEO.
Clarify offline and Edge TTS language selection, document Qwen and Gemma Chat profiles, and stabilize resource-heavy integration tests.
* feat(core): add reproducible performance benchmarks

* feat(core): add verifiable retrieval quality gates

* fix(core): preserve last-known-good index rows

* fix(core): serialize local index writers

* test(core): stabilize writer lock contention

* feat(core): bound ingestion memory

* fix(core): make citation coordinates verifiable

* feat(core): scale ingestion metadata

* feat(core): cache source fingerprints

* feat(core): maintain LanceDB storage

* feat(core): bound index generation retention

* feat(core): add adaptive vector indexing

* perf(core): remove search hot-path overhead

* feat(core): calibrate deterministic hybrid ranking

* feat(core): bound multilingual research

* fix(core): validate mixed-case ingestion paths

* feat(core): make lexical retrieval recall-safe

* feat(core): add workload-aware backpressure

* feat(core): manage embedding model lifecycle

* feat(core): resume batched PDF OCR

* perf(core): make diagnostics manifest-backed

* perf(core): reuse evaluation and MCP resources

* fix(core): make sidecar recovery durable

* fix(core): harden private runtime boundaries

* perf(core): apply MCP budgets before materialization

* perf(core): add privacy-safe ingestion observability

Attribute ingestion phases, throughput, queueing, cache state, and bounded failure counters.

Keep diagnostics content-free and leave timers disabled unless explicitly requested or subscribed.

* perf(core): optimize large parser paths

* feat(core): expose runtime portability proof

* perf(core): accelerate CLI startup

* perf(core): benchmark local hash prototype

* perf(core): evaluate local reranking

* perf(core): evaluate index compression

* perf(core): evaluate content deduplication

* fix(deps): override vulnerable archive utility

* feat(core): expose deterministic corpus fingerprint

Persist a stable hash of indexed relative paths and source checksums.
Expose it through CLI, client diagnostics, and MCP so teams can verify
local corpus equivalence without sharing index storage.

* docs: align corpus fingerprint guidance

* fix(landing): clarify library positioning and metadata

* fix(ci): build core before coverage tests
* docs: simplify public guides and landing copy

* fix(release): publish curated GitHub notes

Require release promotions to describe highlights, substantive changes, and verification.

Generate GitHub releases from that curated contract instead of a terse commit list.
Add team diagnostics and safe upgrade continuity.
Release highlights:
- keep retrieval ready after safe migrations when only privacy warnings remain

Release details:
- **Upgrade DX:** report security follow-ups as non-blocking advisories
- **Continuity:** preserve strict doctor checks while avoiding unnecessary reindex loops

Verification:
- pass pnpm validate
- verify both PAC indexes report current and ready with their advisories
jb-thery added 8 commits July 18, 2026 21:28
Release highlights:
- keep team comparisons synchronized when operational indexes only have privacy advisories

Release details:
- **Team DX:** surface per-side security advisory counts without blocking exact
  drift analysis
- **Compatibility:** interpret existing v2.19 snapshots by stored operational health
  without changing the schema

Verification:
- pass pnpm validate
- verify the PAC snapshot compares strictly against itself while preserving its
  extractor advisory
Release highlights:
- keep public release notes complete when Conventional Commit bullets wrap

Release details:
- **Release automation:** join indented bullet continuations before generating
  the curated GitHub release body
- **Repository rules:** document the line-length-safe release note convention

Verification:
- pass pnpm validate after confirming the isolated retention test
- prove wrapped detail and verification bullets remain complete in release notes
Add the canonical guided setup prompt and tighten the responsive landing presentation.
Publish Ragmir under AGPL-3.0-only from v3.0.0 onward, provide a separate commercial licensing path, ship complete license files in every npm tarball, and enforce the policy in validation. Releases before v3.0.0 keep their published license.
Release highlights:
- replace the normal snapshot exchange with one safe `rgr team sync` workflow
- keep one private index per developer while Git remains the reviewed source of truth

Release details:
- fetch only the current upstream and apply only clean non-divergent fast-forward updates
- refresh incrementally and keep the last valid index on fetch or ingestion failure
- report dirty, ahead, diverged, detached, offline, and no-upstream states with one action
- add no-pull, no-fetch, check, strict, JSON controls, and a typed library API
- keep snapshots as advanced diagnostics and align skills, docs, landing, and structured data

Verification:
- pass 510 Core tests, including 11 real Git edge-case scenarios
- pass public API, package, semantic-release, release-artifact, and smoke checks
- pass Quality gate, CodeQL, Linux x64, macOS ARM64, and Commitlint checks
- verify the refreshed corpus with zero missing, stale, sensitive, or failed files
Release highlights:
- make private team knowledge refresh understandable in one safe Git workflow

Release details:
- Documentation: focus normal sync on reviewed upstream changes and one command
- Documentation: move snapshots and MCP internals behind advanced disclosure
- Reliability: give slow Git-and-index fixtures the existing 15-second test budget

Verification:
- pnpm validate
- GitNexus detects low-risk documentation and test changes
Release highlights:
- make private team knowledge refresh understandable in one safe Git workflow

Release details:
- Documentation: focus normal sync on reviewed upstream changes and one command
- Documentation: move snapshots and MCP internals behind advanced disclosure
- Reliability: stabilize slow Git-and-index fixture coverage

Verification:
- pnpm validate
- CI quality and portability checks pass
@jb-thery

Copy link
Copy Markdown
Member Author

Superseded by a clean release branch based on main.

@jb-thery jb-thery closed this Jul 19, 2026
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