@itkoren/sqmd 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Added
+
+### Changed
+
+### Fixed
+
+### Deprecated
+
+### Removed
+
+### Security
+
+---
+
+## [0.1.0] - 2026-03-17
+
+### Added
+- Local semantic search engine for Markdown files (`sqmd` CLI)
+- Ingestion pipeline: directory scanner, remark-based Markdown parser, token-aware chunker with configurable overlap
+- Content fingerprinting via SHA-256 (`hashFile`, `hashPath`) for incremental re-indexing
+- LanceDB vector store with Apache Arrow schema (`ChunkRecord`, `FileRecord`)
+- HuggingFace Transformers local embeddings with nomic-embed-text asymmetric prefix support (`search_query:` / `search_document:`)
+- Ollama embedding backend alternative
+- Hybrid search combining vector similarity and BM25 full-text search
+- Cross-encoder reranker (`CrossEncoderReranker`) using `@huggingface/transformers` text-classification pipeline
+- REST API via Hono + `@hono/node-server` (search, documents, index status/trigger, health endpoints)
+- MCP server integration for tool-based access
+- File watcher daemon using chokidar for live re-indexing
+- RAG context builder with token-budget capping and attribution (Source / Section / Lines)
+- RAG prompt templates (`ragSystemPrompt`, `formatResults`, `buildRagPrompt`)
+- YAML configuration with Zod validation and env-var overrides
+- Biome 1.9 for lint + format (`npm run check`)
+- Vitest 2.x test suite with workspace projects (`unit` / `integration`) and v8 coverage (80% thresholds)
+- GitHub Actions CI workflow (push/PR: type-check → lint → test → coverage → build)
+- GitHub Actions release workflow (tag `v*.*.*`: test → build → GitHub Release → npm publish with provenance)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 George Liu (eva2000)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.