@sackville-mcp/core 0.0.1-alpha.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Curtis Autery
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.mts

@@ -0,0 +1,138 @@
+import Database from "better-sqlite3";
+
+//#region src/types.d.ts
+/** Metadata read from a Sackville index's `sackville_meta` table. */
+interface SchemaMeta {
+  schemaVersion: number;
+  embedModel: string;
+  embedDim: number;
+  builtAt: string | null;
+  builderVersion: string | null;
+}
+/** A full documentation fragment — the complete record for one `docs` row. */
+interface DocFragment {
+  id: number;
+  library: string;
+  version: string;
+  title: string;
+  symbol: string | null;
+  type: string | null;
+  headingPath: string | null;
+  url: string | null;
+  attribution: string | null;
+  body: string;
+}
+/** Filters and limits for a docs search. */
+interface SearchOptions {
+  library?: string;
+  version?: string;
+  type?: string;
+  /** Defaults to 8, clamped to 25. */
+  limit?: number;
+  /**
+   * Optional query embedding (length must equal the schema's embed_dim). When
+   * provided, results fuse FTS (bm25) with vector KNN via reciprocal rank
+   * fusion; when omitted, search is full-text only.
+   */
+  queryVector?: number[];
+}
+/** One search hit. Compact by design — full bodies are fetched separately. */
+interface SearchResult {
+  id: number;
+  title: string;
+  symbol: string | null;
+  type: string | null;
+  library: string;
+  version: string;
+  /** Relevance score; higher is better. Results are pre-sorted best-first. */
+  score: number;
+  /** Short highlighted excerpt from the body. */
+  snippet: string;
+}
+//#endregion
+//#region src/db.d.ts
+interface OpenOptions {
+  /** Open read-only (default true — the server never mutates an index). */
+  readonly?: boolean;
+}
+/**
+ * Open a Sackville index, load the sqlite-vec extension, and assert the schema
+ * version matches what this build expects. Throws on mismatch so a stale or
+ * foreign index can never be served silently.
+ */
+declare function openDb(path: string, options?: OpenOptions): Database.Database;
+/** Read the `sackville_meta` key/value table into a typed object. */
+declare function readMeta(db: Database.Database): SchemaMeta;
+//#endregion
+//#region src/doc.d.ts
+/**
+ * Fetch a full documentation fragment by id. This is the one place full body
+ * text is returned (the MCP `get_doc` tool and the `sackville://doc/{id}`
+ * resource wrap it); search results stay compact. Returns undefined if absent.
+ */
+declare function getDoc(db: Database.Database, id: number): DocFragment | undefined;
+//#endregion
+//#region src/project.d.ts
+/** Package ecosystems Sackville can detect an installed version in. */
+type Ecosystem = 'node' | 'python' | 'ruby';
+/** Where a detected version came from (most authoritative first, per ecosystem). */
+type VersionSource = 'node_modules' | 'package-lock.json' | 'package.json' | 'python:dist-info' | 'python:lock' | 'python:requirements' | 'python:pyproject' | 'ruby:Gemfile.lock' | 'ruby:Gemfile' | 'none';
+interface DetectedVersion {
+  /** Concrete installed version, or a declared range/constraint, or null. */
+  version: string | null;
+  source: VersionSource;
+}
+interface DetectOptions {
+  /** Restrict detection to one ecosystem. Omit to auto-probe node → python → ruby. */
+  ecosystem?: Ecosystem;
+}
+/**
+ * Detect the installed version of a package in a project directory.
+ *
+ * With an explicit `ecosystem`, runs only that detector. Otherwise auto-probes
+ * node → python → ruby and returns the first hit. Each ecosystem prefers the
+ * concrete installed version, then a lockfile, then the declared range — the
+ * result feeds `resolveVersion`, which accepts concrete versions and ranges.
+ */
+declare function detectInstalledVersion(projectDir: string, pkg: string, opts?: DetectOptions): DetectedVersion;
+//#endregion
+//#region src/schema.d.ts
+declare const EXPECTED_SCHEMA_VERSION = 1;
+declare const EXPECTED_EMBED_DIM = 384;
+declare const EXPECTED_EMBED_MODEL = "bge-small-en-v1.5";
+//#endregion
+//#region src/search.d.ts
+/**
+ * Search the docs index. Full-text (FTS5/bm25) always runs; when `queryVector`
+ * is supplied, vector KNN (sqlite-vec) is fused with it via reciprocal rank
+ * fusion. Library/version/type filters apply to both halves. Results are sorted
+ * best-first; bodies are never returned (fetch them via getDoc).
+ */
+declare function searchDocs(db: Database.Database, query: string, options?: SearchOptions): SearchResult[];
+//#endregion
+//#region src/version.d.ts
+/** Outcome of resolving an installed version to an available doc release. */
+interface VersionResolution {
+  /** The available version string to use, or null if none is acceptable. */
+  resolved: string | null;
+  /** True when the request was exactly satisfied (not a same-major fallback). */
+  exact: boolean;
+  /** Human/agent-readable explanation of the decision. */
+  note: string;
+  /** Available versions, newest first. */
+  available: string[];
+}
+/** Distinct versions of a library present in the index, newest first. */
+declare function listVersions(db: Database.Database, library: string): string[];
+/**
+ * Resolve a requested/installed version (exact, range, or bare major) to the
+ * best available doc release.
+ *
+ * Policy (ARCHITECTURE §7.2): prefer an exactly-satisfying release; otherwise
+ * fall back to the newest release sharing the requested MAJOR and flag it;
+ * never silently return a wrong-major release.
+ */
+declare function resolveVersion(available: string[], requested: string): VersionResolution;
+//#endregion
+export { type DetectOptions, type DetectedVersion, type DocFragment, EXPECTED_EMBED_DIM, EXPECTED_EMBED_MODEL, EXPECTED_SCHEMA_VERSION, type Ecosystem, type OpenOptions, type SchemaMeta, type SearchOptions, type SearchResult, type VersionResolution, type VersionSource, detectInstalledVersion, getDoc, listVersions, openDb, readMeta, resolveVersion, searchDocs };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/db.ts","../src/doc.ts","../src/project.ts","../src/schema.ts","../src/search.ts","../src/version.ts"],"mappings":";;;;UACiB,UAAA;EACf,aAAA;EACA,UAAA;EACA,QAAA;EACA,OAAA;EACA,cAAA;AAAA;;UAIe,WAAA;EACf,EAAA;EACA,OAAA;EACA,OAAA;EACA,KAAA;EACA,MAAA;EACA,IAAA;EACA,WAAA;EACA,GAAA;EACA,WAAA;EACA,IAAA;AAAA;;UAIe,aAAA;EACf,OAAA;EACA,OAAA;EACA,IAAA;EARA;EAUA,KAAA;EATI;AAAA;AAIN;;;EAWE,WAAA;AAAA;;UAIe,YAAA;EACf,EAAA;EACA,KAAA;EACA,MAAA;EACA,IAAA;EACA,OAAA;EACA,OAAA;;EAEA,KAAA;EAPA;EASA,OAAA;AAAA;;;UC5Ce,WAAA;EDJA;ECMf,QAAQ;AAAA;;;;;;iBAQM,MAAA,CAAO,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,QAAA,CAAS,QAAQ;;iBAqBlE,QAAA,CAAS,EAAA,EAAI,QAAA,CAAS,QAAA,GAAW,UAAU;;;;ADnC3D;;;;iBEOgB,MAAA,CAAO,EAAA,EAAI,QAAA,CAAS,QAAA,EAAU,EAAA,WAAa,WAAW;;;;KCJ1D,SAAA;;KAGA,aAAA;AAAA,UAYK,eAAA;;EAEf,OAAA;EACA,MAAA,EAAQ,aAAa;AAAA;AAAA,UAGN,aAAA;EHpBf;EGsBA,SAAA,GAAY,SAAS;AAAA;AHrBP;AAIhB;;;;;;;AAJgB,iBGgEA,sBAAA,CACd,UAAA,UACA,GAAA,UACA,IAAA,GAAM,aAAA,GACL,eAAe;;;cCvEL,uBAAA;AAAA,cACA,kBAAA;AAAA,cACA,oBAAA;;;;AJJb;;;;;iBKsCgB,UAAA,CACd,EAAA,EAAI,QAAA,CAAS,QAAA,EACb,KAAA,UACA,OAAA,GAAS,aAAA,GACR,YAAA;;;;UCvCc,iBAAA;ENHA;EMKf,QAAA;;EAEA,KAAA;ENNA;EMQA,IAAA;ENNA;EMQA,SAAA;AAAA;;iBAIc,YAAA,CAAa,EAAA,EAAI,QAAA,CAAS,QAAQ,EAAE,OAAA;ANNpD;;;;;;;;AAAA,iBM8BgB,cAAA,CAAe,SAAA,YAAqB,SAAA,WAAoB,iBAAiB"}

package/dist/index.mjs

@@ -0,0 +1,465 @@
+import Database from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import semver from "semver";
+//#region src/schema.ts
+const EXPECTED_SCHEMA_VERSION = 1;
+const EXPECTED_EMBED_DIM = 384;
+const EXPECTED_EMBED_MODEL = "bge-small-en-v1.5";
+//#endregion
+//#region src/db.ts
+/**
+* Open a Sackville index, load the sqlite-vec extension, and assert the schema
+* version matches what this build expects. Throws on mismatch so a stale or
+* foreign index can never be served silently.
+*/
+function openDb(path, options = {}) {
+	const db = new Database(path, { readonly: options.readonly ?? true });
+	sqliteVec.load(db);
+	const meta = readMeta(db);
+	if (meta.schemaVersion !== 1) {
+		db.close();
+		throw new Error(`Sackville index schema mismatch at ${path}: file is v${meta.schemaVersion}, this build expects v1. Rebuild the index.`);
+	}
+	return db;
+}
+/** Read the `sackville_meta` key/value table into a typed object. */
+function readMeta(db) {
+	const rows = db.prepare("SELECT key, value FROM sackville_meta").all();
+	const map = new Map(rows.map((r) => [r.key, r.value]));
+	return {
+		schemaVersion: Number(map.get("schema_version")),
+		embedModel: map.get("embed_model") ?? "",
+		embedDim: Number(map.get("embed_dim")),
+		builtAt: map.get("built_at") ?? null,
+		builderVersion: map.get("builder_version") ?? null
+	};
+}
+//#endregion
+//#region src/doc.ts
+/**
+* Fetch a full documentation fragment by id. This is the one place full body
+* text is returned (the MCP `get_doc` tool and the `sackville://doc/{id}`
+* resource wrap it); search results stay compact. Returns undefined if absent.
+*/
+function getDoc(db, id) {
+	return db.prepare(`
+    SELECT id,
+           library,
+           version,
+           title,
+           symbol,
+           type,
+           heading_path AS headingPath,
+           url,
+           attribution,
+           body
+    FROM docs
+    WHERE id = ?
+  `).get(id);
+}
+//#endregion
+//#region src/project.ts
+const NONE = {
+	version: null,
+	source: "none"
+};
+function readText(path) {
+	try {
+		return readFileSync(path, "utf8");
+	} catch {
+		return;
+	}
+}
+function readJson(path) {
+	const text = readText(path);
+	if (text === void 0) return void 0;
+	try {
+		return JSON.parse(text);
+	} catch {
+		return;
+	}
+}
+function readdirSafe(path) {
+	try {
+		return readdirSync(path);
+	} catch {
+		return [];
+	}
+}
+function escapeRe(s) {
+	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+* Detect the installed version of a package in a project directory.
+*
+* With an explicit `ecosystem`, runs only that detector. Otherwise auto-probes
+* node → python → ruby and returns the first hit. Each ecosystem prefers the
+* concrete installed version, then a lockfile, then the declared range — the
+* result feeds `resolveVersion`, which accepts concrete versions and ranges.
+*/
+function detectInstalledVersion(projectDir, pkg, opts = {}) {
+	const detectors = {
+		node: detectNode,
+		python: detectPython,
+		ruby: detectRuby
+	};
+	if (opts.ecosystem) return detectors[opts.ecosystem](projectDir, pkg);
+	for (const eco of [
+		"node",
+		"python",
+		"ruby"
+	]) {
+		const found = detectors[eco](projectDir, pkg);
+		if (found.version !== null) return found;
+	}
+	return NONE;
+}
+function depRange(manifest, pkg) {
+	for (const field of [
+		"dependencies",
+		"devDependencies",
+		"peerDependencies",
+		"optionalDependencies"
+	]) {
+		const deps = manifest[field];
+		if (deps?.[pkg]) return deps[pkg];
+	}
+}
+function detectNode(dir, pkg) {
+	const installed = readJson(join(dir, "node_modules", pkg, "package.json"));
+	if (typeof installed?.version === "string") return {
+		version: installed.version,
+		source: "node_modules"
+	};
+	const lock = readJson(join(dir, "package-lock.json"));
+	if (lock) {
+		const packages = lock.packages;
+		const deps = lock.dependencies;
+		const locked = packages?.[`node_modules/${pkg}`]?.version ?? deps?.[pkg]?.version;
+		if (locked) return {
+			version: locked,
+			source: "package-lock.json"
+		};
+	}
+	const manifest = readJson(join(dir, "package.json"));
+	if (manifest) {
+		const range = depRange(manifest, pkg);
+		if (range) return {
+			version: range,
+			source: "package.json"
+		};
+	}
+	return NONE;
+}
+/** PEP 503 name normalization: lowercase, runs of `-_.` collapse to a single `-`. */
+function canonPy(name) {
+	return name.toLowerCase().replace(/[-_.]+/g, "-");
+}
+/** Candidate site-packages roots inside a project's virtualenv(s). */
+function sitePackagesDirs(dir) {
+	const out = [];
+	for (const venv of [
+		".venv",
+		"venv",
+		"env"
+	]) {
+		const lib = join(dir, venv, "lib");
+		for (const py of readdirSafe(lib)) if (py.startsWith("python")) out.push(join(lib, py, "site-packages"));
+		out.push(join(dir, venv, "Lib", "site-packages"));
+	}
+	return out;
+}
+function pythonDistInfo(dir, want) {
+	for (const sp of sitePackagesDirs(dir)) for (const entry of readdirSafe(sp)) {
+		if (!entry.endsWith(".dist-info")) continue;
+		const meta = readText(join(sp, entry, "METADATA"));
+		if (!meta) continue;
+		const name = /^Name:\s*(.+)$/m.exec(meta)?.[1]?.trim();
+		const version = /^Version:\s*(.+)$/m.exec(meta)?.[1]?.trim();
+		if (name && version && canonPy(name) === want) return version;
+	}
+}
+/** uv.lock / poetry.lock: `[[package]]` blocks with `name`/`version`. */
+function tomlLockVersion(text, want) {
+	for (const block of text.split("[[package]]")) {
+		const name = /^\s*name\s*=\s*"([^"]+)"/m.exec(block)?.[1];
+		if (!name || canonPy(name) !== want) continue;
+		const version = /^\s*version\s*=\s*"([^"]+)"/m.exec(block)?.[1];
+		if (version) return version;
+	}
+}
+/** Pipfile.lock (JSON): `default`/`develop` → `{ pkg: { version: "==x.y" } }`. */
+function pipfileLockVersion(text, want) {
+	let json;
+	try {
+		json = JSON.parse(text);
+	} catch {
+		return;
+	}
+	for (const section of ["default", "develop"]) {
+		const deps = json[section];
+		if (!deps) continue;
+		for (const [name, spec] of Object.entries(deps)) if (canonPy(name) === want && typeof spec?.version === "string") return spec.version.replace(/^==/, "").trim();
+	}
+}
+/** Parse a PEP 508 requirement spec into name + constraint (markers dropped). */
+function pep508(spec) {
+	const m = /^([A-Za-z0-9_.-]+)\s*(?:\[[^\]]*\])?\s*(.*)$/.exec(spec.trim());
+	if (!m?.[1]) return void 0;
+	return {
+		name: m[1],
+		constraint: (m[2] ?? "").split(";")[0]?.trim() ?? ""
+	};
+}
+function requirementsVersion(text, want) {
+	for (const raw of text.split(/\r?\n/)) {
+		const line = (raw.split("#")[0] ?? "").trim();
+		if (!line || line.startsWith("-")) continue;
+		const parsed = pep508(line);
+		if (!parsed || canonPy(parsed.name) !== want) continue;
+		if (parsed.constraint.startsWith("==")) return parsed.constraint.slice(2).trim();
+		return parsed.constraint || "*";
+	}
+}
+function pyprojectVersion(text, want) {
+	const arr = /dependencies\s*=\s*\[([\s\S]*?)\]/.exec(text)?.[1];
+	if (arr) for (const m of arr.matchAll(/["']([^"']+)["']/g)) {
+		const parsed = m[1] ? pep508(m[1]) : void 0;
+		if (parsed && canonPy(parsed.name) === want) return parsed.constraint || "*";
+	}
+	const poetry = /\[tool\.poetry\.dependencies\]([\s\S]*?)(?:\n\[|$)/.exec(text)?.[1];
+	if (poetry) for (const raw of poetry.split(/\r?\n/)) {
+		const m = /^\s*([A-Za-z0-9_.-]+)\s*=\s*["']([^"']+)["']/.exec(raw);
+		if (m?.[1] && canonPy(m[1]) === want) return m[2] ?? "*";
+	}
+}
+function detectPython(dir, pkg) {
+	const want = canonPy(pkg);
+	const installed = pythonDistInfo(dir, want);
+	if (installed) return {
+		version: installed,
+		source: "python:dist-info"
+	};
+	for (const lock of ["uv.lock", "poetry.lock"]) {
+		const text = readText(join(dir, lock));
+		const version = text && tomlLockVersion(text, want);
+		if (version) return {
+			version,
+			source: "python:lock"
+		};
+	}
+	const pipfile = readText(join(dir, "Pipfile.lock"));
+	const pipfileVersion = pipfile && pipfileLockVersion(pipfile, want);
+	if (pipfileVersion) return {
+		version: pipfileVersion,
+		source: "python:lock"
+	};
+	const req = readText(join(dir, "requirements.txt"));
+	const reqVersion = req && requirementsVersion(req, want);
+	if (reqVersion) return {
+		version: reqVersion,
+		source: "python:requirements"
+	};
+	const pyproject = readText(join(dir, "pyproject.toml"));
+	const pyprojectVer = pyproject && pyprojectVersion(pyproject, want);
+	if (pyprojectVer) return {
+		version: pyprojectVer,
+		source: "python:pyproject"
+	};
+	return NONE;
+}
+function detectRuby(dir, pkg) {
+	const want = pkg.toLowerCase();
+	const lock = readText(join(dir, "Gemfile.lock"));
+	if (lock) {
+		for (const m of lock.matchAll(/^ {4}([A-Za-z0-9_.-]+) \(([^)]+)\)/gm)) if (m[1]?.toLowerCase() === want) return {
+			version: m[2] ?? "",
+			source: "ruby:Gemfile.lock"
+		};
+	}
+	const gemfile = readText(join(dir, "Gemfile"));
+	if (gemfile) {
+		const m = new RegExp(`gem\\s+['"]${escapeRe(pkg)}['"]\\s*(?:,\\s*['"]([^'"]+)['"])?`, "i").exec(gemfile);
+		if (m) return {
+			version: m[1] ?? "*",
+			source: "ruby:Gemfile"
+		};
+	}
+	return NONE;
+}
+//#endregion
+//#region src/search.ts
+const DEFAULT_LIMIT = 8;
+const MAX_LIMIT = 25;
+const RRF_K = 60;
+const CANDIDATES = 64;
+/** Build a safe FTS5 MATCH string: quote each alphanumeric token (implicit AND). */
+function ftsMatch(query) {
+	const tokens = query.toLowerCase().match(/[\p{L}\p{N}]+/gu);
+	if (!tokens || tokens.length === 0) return null;
+	return tokens.map((t) => `"${t}"`).join(" ");
+}
+function excerpt(body, max = 160) {
+	const collapsed = body.replace(/\s+/g, " ").trim();
+	return collapsed.length <= max ? collapsed : `${collapsed.slice(0, max).trimEnd()}…`;
+}
+/**
+* Search the docs index. Full-text (FTS5/bm25) always runs; when `queryVector`
+* is supplied, vector KNN (sqlite-vec) is fused with it via reciprocal rank
+* fusion. Library/version/type filters apply to both halves. Results are sorted
+* best-first; bodies are never returned (fetch them via getDoc).
+*/
+function searchDocs(db, query, options = {}) {
+	const limit = Math.min(Math.max(options.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT);
+	const useVector = Array.isArray(options.queryVector) && options.queryVector.length === 384;
+	const snippets = /* @__PURE__ */ new Map();
+	const ftsRanked = runFts(db, query, options, snippets);
+	const vecRanked = useVector ? runVector(db, options) : [];
+	const scores = /* @__PURE__ */ new Map();
+	for (const ranked of [ftsRanked, vecRanked]) ranked.forEach((id, i) => {
+		scores.set(id, (scores.get(id) ?? 0) + 1 / (RRF_K + i + 1));
+	});
+	if (scores.size === 0) return [];
+	const topIds = [...scores.entries()].sort((a, b) => b[1] - a[1]).slice(0, limit).map(([id]) => id);
+	const placeholders = topIds.map(() => "?").join(",");
+	const rows = db.prepare(`SELECT id, title, symbol, type, library, version, body
+       FROM docs WHERE id IN (${placeholders})`).all(...topIds);
+	const byId = new Map(rows.map((r) => [r.id, r]));
+	const results = [];
+	for (const id of topIds) {
+		const row = byId.get(id);
+		if (!row) continue;
+		const { body, ...meta } = row;
+		results.push({
+			...meta,
+			score: scores.get(id) ?? 0,
+			snippet: snippets.get(id) ?? excerpt(body)
+		});
+	}
+	return results;
+}
+function runFts(db, query, options, snippets) {
+	const match = ftsMatch(query);
+	if (!match) return [];
+	const clauses = ["docs_fts MATCH @match"];
+	const params = {
+		match,
+		cand: CANDIDATES
+	};
+	if (options.library !== void 0) {
+		clauses.push("d.library = @library");
+		params.library = options.library;
+	}
+	if (options.version !== void 0) {
+		clauses.push("d.version = @version");
+		params.version = options.version;
+	}
+	if (options.type !== void 0) {
+		clauses.push("d.type = @type");
+		params.type = options.type;
+	}
+	const rows = db.prepare(`SELECT docs_fts.rowid AS id, snippet(docs_fts, 1, '[', ']', '…', 12) AS snippet
+       FROM docs_fts JOIN docs d ON d.id = docs_fts.rowid
+       WHERE ${clauses.join(" AND ")}
+       ORDER BY bm25(docs_fts) LIMIT @cand`).all(params);
+	const ids = [];
+	for (const r of rows) {
+		ids.push(r.id);
+		snippets.set(r.id, r.snippet);
+	}
+	return ids;
+}
+function runVector(db, options) {
+	const clauses = ["embedding MATCH @vec", "k = @k"];
+	const params = {
+		vec: JSON.stringify(options.queryVector),
+		k: CANDIDATES
+	};
+	if (options.library !== void 0) {
+		clauses.push("library = @library");
+		params.library = options.library;
+	}
+	if (options.version !== void 0) {
+		clauses.push("version = @version");
+		params.version = options.version;
+	}
+	if (options.type !== void 0) {
+		clauses.push("type = @type");
+		params.type = options.type;
+	}
+	return db.prepare(`SELECT doc_id AS id FROM docs_vec
+       WHERE ${clauses.join(" AND ")}
+       ORDER BY distance`).all(params).map((r) => r.id);
+}
+//#endregion
+//#region src/version.ts
+/** Distinct versions of a library present in the index, newest first. */
+function listVersions(db, library) {
+	return sortDesc(db.prepare("SELECT DISTINCT version FROM docs WHERE library = ? ORDER BY version").all(library).map((r) => r.version));
+}
+function sortDesc(versions) {
+	return [...versions].sort((a, b) => {
+		const av = semver.coerce(a);
+		const bv = semver.coerce(b);
+		if (av && bv) return semver.rcompare(av, bv);
+		return b.localeCompare(a);
+	});
+}
+/**
+* Resolve a requested/installed version (exact, range, or bare major) to the
+* best available doc release.
+*
+* Policy (ARCHITECTURE §7.2): prefer an exactly-satisfying release; otherwise
+* fall back to the newest release sharing the requested MAJOR and flag it;
+* never silently return a wrong-major release.
+*/
+function resolveVersion(available, requested) {
+	const sorted = sortDesc(available);
+	if (sorted.length === 0) return {
+		resolved: null,
+		exact: false,
+		note: "no versions are indexed",
+		available: sorted
+	};
+	for (const version of sorted) {
+		const coerced = semver.coerce(version);
+		if (coerced && satisfies(coerced, requested)) return {
+			resolved: version,
+			exact: true,
+			note: `matched ${requested} to ${version}`,
+			available: sorted
+		};
+	}
+	const major = requestedMajor(requested);
+	if (major !== null) {
+		for (const version of sorted) if (semver.coerce(version)?.major === major) return {
+			resolved: version,
+			exact: false,
+			note: `no exact docs for ${requested}; using nearest ${major}.x release ${version}`,
+			available: sorted
+		};
+	}
+	return {
+		resolved: null,
+		exact: false,
+		note: `no docs for ${requested}; available versions: ${sorted.join(", ")}`,
+		available: sorted
+	};
+}
+function satisfies(version, requested) {
+	if (semver.validRange(requested)) return semver.satisfies(version, requested);
+	const coerced = semver.coerce(requested);
+	return coerced ? semver.eq(version, coerced) : false;
+}
+function requestedMajor(requested) {
+	const coerced = semver.coerce(requested);
+	if (coerced) return coerced.major;
+	const min = semver.validRange(requested) ? semver.minVersion(requested) : null;
+	return min ? min.major : null;
+}
+//#endregion
+export { EXPECTED_EMBED_DIM, EXPECTED_EMBED_MODEL, EXPECTED_SCHEMA_VERSION, detectInstalledVersion, getDoc, listVersions, openDb, readMeta, resolveVersion, searchDocs };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/schema.ts","../src/db.ts","../src/doc.ts","../src/project.ts","../src/search.ts","../src/version.ts"],"sourcesContent":["// Contract constants. These MUST equal the values in schema/sackville.schema.json\n// (guarded by schema.test.ts). Both languages assert them before operating on an\n// index file, which is what makes the file-as-contract safe.\nexport const EXPECTED_SCHEMA_VERSION = 1\nexport const EXPECTED_EMBED_DIM = 384\nexport const EXPECTED_EMBED_MODEL = 'bge-small-en-v1.5'\n","import Database from 'better-sqlite3'\nimport * as sqliteVec from 'sqlite-vec'\nimport { EXPECTED_SCHEMA_VERSION } from './schema.js'\nimport type { SchemaMeta } from './types.js'\n\nexport interface OpenOptions {\n  /** Open read-only (default true — the server never mutates an index). */\n  readonly?: boolean\n}\n\n/**\n * Open a Sackville index, load the sqlite-vec extension, and assert the schema\n * version matches what this build expects. Throws on mismatch so a stale or\n * foreign index can never be served silently.\n */\nexport function openDb(path: string, options: OpenOptions = {}): Database.Database {\n  const db = new Database(path, { readonly: options.readonly ?? true })\n  sqliteVec.load(db)\n\n  const meta = readMeta(db)\n  if (meta.schemaVersion !== EXPECTED_SCHEMA_VERSION) {\n    db.close()\n    throw new Error(\n      `Sackville index schema mismatch at ${path}: file is v${meta.schemaVersion}, ` +\n        `this build expects v${EXPECTED_SCHEMA_VERSION}. Rebuild the index.`,\n    )\n  }\n  return db\n}\n\ninterface MetaRow {\n  key: string\n  value: string\n}\n\n/** Read the `sackville_meta` key/value table into a typed object. */\nexport function readMeta(db: Database.Database): SchemaMeta {\n  const rows = db.prepare('SELECT key, value FROM sackville_meta').all() as MetaRow[]\n  const map = new Map(rows.map((r) => [r.key, r.value]))\n  return {\n    schemaVersion: Number(map.get('schema_version')),\n    embedModel: map.get('embed_model') ?? '',\n    embedDim: Number(map.get('embed_dim')),\n    builtAt: map.get('built_at') ?? null,\n    builderVersion: map.get('builder_version') ?? null,\n  }\n}\n","import type Database from 'better-sqlite3'\nimport type { DocFragment } from './types.js'\n\n/**\n * Fetch a full documentation fragment by id. This is the one place full body\n * text is returned (the MCP `get_doc` tool and the `sackville://doc/{id}`\n * resource wrap it); search results stay compact. Returns undefined if absent.\n */\nexport function getDoc(db: Database.Database, id: number): DocFragment | undefined {\n  const sql = `\n    SELECT id,\n           library,\n           version,\n           title,\n           symbol,\n           type,\n           heading_path AS headingPath,\n           url,\n           attribution,\n           body\n    FROM docs\n    WHERE id = ?\n  `\n  return db.prepare(sql).get(id) as DocFragment | undefined\n}\n","import { readdirSync, readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\n/** Package ecosystems Sackville can detect an installed version in. */\nexport type Ecosystem = 'node' | 'python' | 'ruby'\n\n/** Where a detected version came from (most authoritative first, per ecosystem). */\nexport type VersionSource =\n  | 'node_modules'\n  | 'package-lock.json'\n  | 'package.json'\n  | 'python:dist-info'\n  | 'python:lock'\n  | 'python:requirements'\n  | 'python:pyproject'\n  | 'ruby:Gemfile.lock'\n  | 'ruby:Gemfile'\n  | 'none'\n\nexport interface DetectedVersion {\n  /** Concrete installed version, or a declared range/constraint, or null. */\n  version: string | null\n  source: VersionSource\n}\n\nexport interface DetectOptions {\n  /** Restrict detection to one ecosystem. Omit to auto-probe node → python → ruby. */\n  ecosystem?: Ecosystem\n}\n\nconst NONE: DetectedVersion = { version: null, source: 'none' }\n\nfunction readText(path: string): string | undefined {\n  try {\n    return readFileSync(path, 'utf8')\n  } catch {\n    return undefined\n  }\n}\n\nfunction readJson(path: string): Record<string, unknown> | undefined {\n  const text = readText(path)\n  if (text === undefined) return undefined\n  try {\n    return JSON.parse(text)\n  } catch {\n    return undefined\n  }\n}\n\nfunction readdirSafe(path: string): string[] {\n  try {\n    return readdirSync(path)\n  } catch {\n    return []\n  }\n}\n\nfunction escapeRe(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\n/**\n * Detect the installed version of a package in a project directory.\n *\n * With an explicit `ecosystem`, runs only that detector. Otherwise auto-probes\n * node → python → ruby and returns the first hit. Each ecosystem prefers the\n * concrete installed version, then a lockfile, then the declared range — the\n * result feeds `resolveVersion`, which accepts concrete versions and ranges.\n */\nexport function detectInstalledVersion(\n  projectDir: string,\n  pkg: string,\n  opts: DetectOptions = {},\n): DetectedVersion {\n  const detectors: Record<Ecosystem, (d: string, p: string) => DetectedVersion> = {\n    node: detectNode,\n    python: detectPython,\n    ruby: detectRuby,\n  }\n  if (opts.ecosystem) return detectors[opts.ecosystem](projectDir, pkg)\n  for (const eco of ['node', 'python', 'ruby'] as const) {\n    const found = detectors[eco](projectDir, pkg)\n    if (found.version !== null) return found\n  }\n  return NONE\n}\n\n// ── Node ────────────────────────────────────────────────────────────────────\n\nfunction depRange(manifest: Record<string, unknown>, pkg: string): string | undefined {\n  for (const field of [\n    'dependencies',\n    'devDependencies',\n    'peerDependencies',\n    'optionalDependencies',\n  ]) {\n    const deps = manifest[field] as Record<string, string> | undefined\n    if (deps?.[pkg]) return deps[pkg]\n  }\n  return undefined\n}\n\nfunction detectNode(dir: string, pkg: string): DetectedVersion {\n  const installed = readJson(join(dir, 'node_modules', pkg, 'package.json'))\n  if (typeof installed?.version === 'string') {\n    return { version: installed.version, source: 'node_modules' }\n  }\n\n  const lock = readJson(join(dir, 'package-lock.json'))\n  if (lock) {\n    const packages = lock.packages as Record<string, { version?: string }> | undefined\n    const deps = lock.dependencies as Record<string, { version?: string }> | undefined\n    const locked = packages?.[`node_modules/${pkg}`]?.version ?? deps?.[pkg]?.version\n    if (locked) return { version: locked, source: 'package-lock.json' }\n  }\n\n  const manifest = readJson(join(dir, 'package.json'))\n  if (manifest) {\n    const range = depRange(manifest, pkg)\n    if (range) return { version: range, source: 'package.json' }\n  }\n\n  return NONE\n}\n\n// ── Python ───────────────────────────────────────────────────────────────────\n\n/** PEP 503 name normalization: lowercase, runs of `-_.` collapse to a single `-`. */\nfunction canonPy(name: string): string {\n  return name.toLowerCase().replace(/[-_.]+/g, '-')\n}\n\n/** Candidate site-packages roots inside a project's virtualenv(s). */\nfunction sitePackagesDirs(dir: string): string[] {\n  const out: string[] = []\n  for (const venv of ['.venv', 'venv', 'env']) {\n    const lib = join(dir, venv, 'lib')\n    for (const py of readdirSafe(lib)) {\n      if (py.startsWith('python')) out.push(join(lib, py, 'site-packages'))\n    }\n    out.push(join(dir, venv, 'Lib', 'site-packages')) // Windows layout\n  }\n  return out\n}\n\nfunction pythonDistInfo(dir: string, want: string): string | undefined {\n  for (const sp of sitePackagesDirs(dir)) {\n    for (const entry of readdirSafe(sp)) {\n      if (!entry.endsWith('.dist-info')) continue\n      const meta = readText(join(sp, entry, 'METADATA'))\n      if (!meta) continue\n      const name = /^Name:\\s*(.+)$/m.exec(meta)?.[1]?.trim()\n      const version = /^Version:\\s*(.+)$/m.exec(meta)?.[1]?.trim()\n      if (name && version && canonPy(name) === want) return version\n    }\n  }\n  return undefined\n}\n\n/** uv.lock / poetry.lock: `[[package]]` blocks with `name`/`version`. */\nfunction tomlLockVersion(text: string, want: string): string | undefined {\n  for (const block of text.split('[[package]]')) {\n    const name = /^\\s*name\\s*=\\s*\"([^\"]+)\"/m.exec(block)?.[1]\n    if (!name || canonPy(name) !== want) continue\n    const version = /^\\s*version\\s*=\\s*\"([^\"]+)\"/m.exec(block)?.[1]\n    if (version) return version\n  }\n  return undefined\n}\n\n/** Pipfile.lock (JSON): `default`/`develop` → `{ pkg: { version: \"==x.y\" } }`. */\nfunction pipfileLockVersion(text: string, want: string): string | undefined {\n  let json: Record<string, unknown>\n  try {\n    json = JSON.parse(text)\n  } catch {\n    return undefined\n  }\n  for (const section of ['default', 'develop']) {\n    const deps = json[section] as Record<string, { version?: string }> | undefined\n    if (!deps) continue\n    for (const [name, spec] of Object.entries(deps)) {\n      if (canonPy(name) === want && typeof spec?.version === 'string') {\n        return spec.version.replace(/^==/, '').trim()\n      }\n    }\n  }\n  return undefined\n}\n\n/** Parse a PEP 508 requirement spec into name + constraint (markers dropped). */\nfunction pep508(spec: string): { name: string; constraint: string } | undefined {\n  const m = /^([A-Za-z0-9_.-]+)\\s*(?:\\[[^\\]]*\\])?\\s*(.*)$/.exec(spec.trim())\n  if (!m?.[1]) return undefined\n  return { name: m[1], constraint: (m[2] ?? '').split(';')[0]?.trim() ?? '' }\n}\n\nfunction requirementsVersion(text: string, want: string): string | undefined {\n  for (const raw of text.split(/\\r?\\n/)) {\n    const line = (raw.split('#')[0] ?? '').trim()\n    if (!line || line.startsWith('-')) continue // skip blanks + options (-r, --hash, …)\n    const parsed = pep508(line)\n    if (!parsed || canonPy(parsed.name) !== want) continue\n    if (parsed.constraint.startsWith('==')) return parsed.constraint.slice(2).trim()\n    return parsed.constraint || '*'\n  }\n  return undefined\n}\n\nfunction pyprojectVersion(text: string, want: string): string | undefined {\n  // PEP 621 [project] dependencies = [\"pkg>=1\", …]\n  const arr = /dependencies\\s*=\\s*\\[([\\s\\S]*?)\\]/.exec(text)?.[1]\n  if (arr) {\n    for (const m of arr.matchAll(/[\"']([^\"']+)[\"']/g)) {\n      const parsed = m[1] ? pep508(m[1]) : undefined\n      if (parsed && canonPy(parsed.name) === want) return parsed.constraint || '*'\n    }\n  }\n  // Poetry [tool.poetry.dependencies] pkg = \"^1.0\"\n  const poetry = /\\[tool\\.poetry\\.dependencies\\]([\\s\\S]*?)(?:\\n\\[|$)/.exec(text)?.[1]\n  if (poetry) {\n    for (const raw of poetry.split(/\\r?\\n/)) {\n      const m = /^\\s*([A-Za-z0-9_.-]+)\\s*=\\s*[\"']([^\"']+)[\"']/.exec(raw)\n      if (m?.[1] && canonPy(m[1]) === want) return m[2] ?? '*'\n    }\n  }\n  return undefined\n}\n\nfunction detectPython(dir: string, pkg: string): DetectedVersion {\n  const want = canonPy(pkg)\n\n  const installed = pythonDistInfo(dir, want)\n  if (installed) return { version: installed, source: 'python:dist-info' }\n\n  for (const lock of ['uv.lock', 'poetry.lock']) {\n    const text = readText(join(dir, lock))\n    const version = text && tomlLockVersion(text, want)\n    if (version) return { version, source: 'python:lock' }\n  }\n  const pipfile = readText(join(dir, 'Pipfile.lock'))\n  const pipfileVersion = pipfile && pipfileLockVersion(pipfile, want)\n  if (pipfileVersion) return { version: pipfileVersion, source: 'python:lock' }\n\n  const req = readText(join(dir, 'requirements.txt'))\n  const reqVersion = req && requirementsVersion(req, want)\n  if (reqVersion) return { version: reqVersion, source: 'python:requirements' }\n\n  const pyproject = readText(join(dir, 'pyproject.toml'))\n  const pyprojectVer = pyproject && pyprojectVersion(pyproject, want)\n  if (pyprojectVer) return { version: pyprojectVer, source: 'python:pyproject' }\n\n  return NONE\n}\n\n// ── Ruby ──────────────────────────────────────────────────────────────────────\n\nfunction detectRuby(dir: string, pkg: string): DetectedVersion {\n  const want = pkg.toLowerCase()\n\n  const lock = readText(join(dir, 'Gemfile.lock'))\n  if (lock) {\n    // Top-level resolved specs are indented exactly four spaces: `    name (x.y.z)`.\n    for (const m of lock.matchAll(/^ {4}([A-Za-z0-9_.-]+) \\(([^)]+)\\)/gm)) {\n      if (m[1]?.toLowerCase() === want) return { version: m[2] ?? '', source: 'ruby:Gemfile.lock' }\n    }\n  }\n\n  const gemfile = readText(join(dir, 'Gemfile'))\n  if (gemfile) {\n    const re = new RegExp(`gem\\\\s+['\"]${escapeRe(pkg)}['\"]\\\\s*(?:,\\\\s*['\"]([^'\"]+)['\"])?`, 'i')\n    const m = re.exec(gemfile)\n    if (m) return { version: m[1] ?? '*', source: 'ruby:Gemfile' }\n  }\n\n  return NONE\n}\n","import type Database from 'better-sqlite3'\nimport { EXPECTED_EMBED_DIM } from './schema.js'\nimport type { SearchOptions, SearchResult } from './types.js'\n\nconst DEFAULT_LIMIT = 8\nconst MAX_LIMIT = 25\n// Reciprocal Rank Fusion constant (standard default).\nconst RRF_K = 60\n// Candidate pool pulled from each ranked list before fusion.\nconst CANDIDATES = 64\n\n/** Build a safe FTS5 MATCH string: quote each alphanumeric token (implicit AND). */\nfunction ftsMatch(query: string): string | null {\n  const tokens = query.toLowerCase().match(/[\\p{L}\\p{N}]+/gu)\n  if (!tokens || tokens.length === 0) return null\n  return tokens.map((t) => `\"${t}\"`).join(' ')\n}\n\nfunction excerpt(body: string, max = 160): string {\n  const collapsed = body.replace(/\\s+/g, ' ').trim()\n  return collapsed.length <= max ? collapsed : `${collapsed.slice(0, max).trimEnd()}…`\n}\n\ninterface MetaRow {\n  id: number\n  title: string\n  symbol: string | null\n  type: string | null\n  library: string\n  version: string\n  body: string\n}\n\n/**\n * Search the docs index. Full-text (FTS5/bm25) always runs; when `queryVector`\n * is supplied, vector KNN (sqlite-vec) is fused with it via reciprocal rank\n * fusion. Library/version/type filters apply to both halves. Results are sorted\n * best-first; bodies are never returned (fetch them via getDoc).\n */\nexport function searchDocs(\n  db: Database.Database,\n  query: string,\n  options: SearchOptions = {},\n): SearchResult[] {\n  const limit = Math.min(Math.max(options.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT)\n  const useVector =\n    Array.isArray(options.queryVector) && options.queryVector.length === EXPECTED_EMBED_DIM\n\n  const snippets = new Map<number, string>()\n  const ftsRanked = runFts(db, query, options, snippets)\n  const vecRanked = useVector ? runVector(db, options) : []\n\n  // Reciprocal rank fusion across the available ranked lists.\n  const scores = new Map<number, number>()\n  for (const ranked of [ftsRanked, vecRanked]) {\n    ranked.forEach((id, i) => {\n      scores.set(id, (scores.get(id) ?? 0) + 1 / (RRF_K + i + 1))\n    })\n  }\n  if (scores.size === 0) return []\n\n  const topIds = [...scores.entries()]\n    .sort((a, b) => b[1] - a[1])\n    .slice(0, limit)\n    .map(([id]) => id)\n\n  const placeholders = topIds.map(() => '?').join(',')\n  const rows = db\n    .prepare(\n      `SELECT id, title, symbol, type, library, version, body\n       FROM docs WHERE id IN (${placeholders})`,\n    )\n    .all(...topIds) as MetaRow[]\n  const byId = new Map(rows.map((r) => [r.id, r]))\n\n  const results: SearchResult[] = []\n  for (const id of topIds) {\n    const row = byId.get(id)\n    if (!row) continue\n    const { body, ...meta } = row\n    results.push({\n      ...meta,\n      score: scores.get(id) ?? 0,\n      snippet: snippets.get(id) ?? excerpt(body),\n    })\n  }\n  return results\n}\n\nfunction runFts(\n  db: Database.Database,\n  query: string,\n  options: SearchOptions,\n  snippets: Map<number, string>,\n): number[] {\n  const match = ftsMatch(query)\n  if (!match) return []\n\n  const clauses = ['docs_fts MATCH @match']\n  const params: Record<string, unknown> = { match, cand: CANDIDATES }\n  if (options.library !== undefined) {\n    clauses.push('d.library = @library')\n    params.library = options.library\n  }\n  if (options.version !== undefined) {\n    clauses.push('d.version = @version')\n    params.version = options.version\n  }\n  if (options.type !== undefined) {\n    clauses.push('d.type = @type')\n    params.type = options.type\n  }\n\n  const rows = db\n    .prepare(\n      `SELECT docs_fts.rowid AS id, snippet(docs_fts, 1, '[', ']', '…', 12) AS snippet\n       FROM docs_fts JOIN docs d ON d.id = docs_fts.rowid\n       WHERE ${clauses.join(' AND ')}\n       ORDER BY bm25(docs_fts) LIMIT @cand`,\n    )\n    .all(params) as { id: number; snippet: string }[]\n\n  const ids: number[] = []\n  for (const r of rows) {\n    ids.push(r.id)\n    snippets.set(r.id, r.snippet)\n  }\n  return ids\n}\n\nfunction runVector(db: Database.Database, options: SearchOptions): number[] {\n  const clauses = ['embedding MATCH @vec', 'k = @k']\n  const params: Record<string, unknown> = {\n    vec: JSON.stringify(options.queryVector),\n    k: CANDIDATES,\n  }\n  if (options.library !== undefined) {\n    clauses.push('library = @library')\n    params.library = options.library\n  }\n  if (options.version !== undefined) {\n    clauses.push('version = @version')\n    params.version = options.version\n  }\n  if (options.type !== undefined) {\n    clauses.push('type = @type')\n    params.type = options.type\n  }\n\n  const rows = db\n    .prepare(\n      `SELECT doc_id AS id FROM docs_vec\n       WHERE ${clauses.join(' AND ')}\n       ORDER BY distance`,\n    )\n    .all(params) as { id: number }[]\n  return rows.map((r) => r.id)\n}\n","import type Database from 'better-sqlite3'\nimport semver from 'semver'\n\n/** Outcome of resolving an installed version to an available doc release. */\nexport interface VersionResolution {\n  /** The available version string to use, or null if none is acceptable. */\n  resolved: string | null\n  /** True when the request was exactly satisfied (not a same-major fallback). */\n  exact: boolean\n  /** Human/agent-readable explanation of the decision. */\n  note: string\n  /** Available versions, newest first. */\n  available: string[]\n}\n\n/** Distinct versions of a library present in the index, newest first. */\nexport function listVersions(db: Database.Database, library: string): string[] {\n  const rows = db\n    .prepare('SELECT DISTINCT version FROM docs WHERE library = ? ORDER BY version')\n    .all(library) as { version: string }[]\n  return sortDesc(rows.map((r) => r.version))\n}\n\nfunction sortDesc(versions: string[]): string[] {\n  return [...versions].sort((a, b) => {\n    const av = semver.coerce(a)\n    const bv = semver.coerce(b)\n    if (av && bv) return semver.rcompare(av, bv)\n    return b.localeCompare(a)\n  })\n}\n\n/**\n * Resolve a requested/installed version (exact, range, or bare major) to the\n * best available doc release.\n *\n * Policy (ARCHITECTURE §7.2): prefer an exactly-satisfying release; otherwise\n * fall back to the newest release sharing the requested MAJOR and flag it;\n * never silently return a wrong-major release.\n */\nexport function resolveVersion(available: string[], requested: string): VersionResolution {\n  const sorted = sortDesc(available)\n  if (sorted.length === 0) {\n    return { resolved: null, exact: false, note: 'no versions are indexed', available: sorted }\n  }\n\n  // 1. Exact / range satisfaction — newest first.\n  for (const version of sorted) {\n    const coerced = semver.coerce(version)\n    if (coerced && satisfies(coerced, requested)) {\n      return {\n        resolved: version,\n        exact: true,\n        note: `matched ${requested} to ${version}`,\n        available: sorted,\n      }\n    }\n  }\n\n  // 2. Same-major fallback.\n  const major = requestedMajor(requested)\n  if (major !== null) {\n    for (const version of sorted) {\n      if (semver.coerce(version)?.major === major) {\n        return {\n          resolved: version,\n          exact: false,\n          note: `no exact docs for ${requested}; using nearest ${major}.x release ${version}`,\n          available: sorted,\n        }\n      }\n    }\n  }\n\n  // 3. Refuse — never serve a wrong-major release silently.\n  return {\n    resolved: null,\n    exact: false,\n    note: `no docs for ${requested}; available versions: ${sorted.join(', ')}`,\n    available: sorted,\n  }\n}\n\nfunction satisfies(version: semver.SemVer, requested: string): boolean {\n  if (semver.validRange(requested)) {\n    return semver.satisfies(version, requested)\n  }\n  const coerced = semver.coerce(requested)\n  return coerced ? semver.eq(version, coerced) : false\n}\n\nfunction requestedMajor(requested: string): number | null {\n  const coerced = semver.coerce(requested)\n  if (coerced) return coerced.major\n  const min = semver.validRange(requested) ? semver.minVersion(requested) : null\n  return min ? min.major : null\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@sackville-mcp/core",
+  "version": "0.0.1-alpha.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "better-sqlite3": "^12.10.0",
+    "semver": "^7.8.1",
+    "sqlite-vec": "^0.1.9"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/semver": "^7.7.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ceautery/sackville.git",
+    "directory": "packages/core"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --dts",
+    "typecheck": "tsc --noEmit"
+  }
+}