@omgbase/astro 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 omgbase
+
+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.

package/README.md

@@ -0,0 +1,142 @@
+# `@omgbase/astro`
+
+Use an [omgbase](https://github.com/omgbase/omgbase) repository as the CMS for an [Astro](https://astro.build) static site.
+
+The package provides:
+
+- **`omgLoader`** — an Astro Content Layer loader driven by an **OQX** query
+- **Local transport** — embedded `@omgbase/core`
+- **Remote transport** — Streamable HTTP MCP (`query` + `docs_get_many`), same as `omg … --server <url>`
+- **Dev live-reload** — in `astro dev`, local vaults use Vite's FS watcher; remote polls MCP `changes_since`. Both update Astro's content data store so the normal HMR path fires — no custom integration required
+- **`createMcpHttpServer`** — optional local Streamable HTTP MCP server for demos/CI
+
+## Install
+
+```bash
+pnpm add @omgbase/astro @omgbase/core
+```
+
+Peer dependency: Astro 5+.
+
+## Local loader
+
+```ts
+// src/content.config.ts
+import { defineCollection, z } from "astro:content";
+import { omgLoader } from "@omgbase/astro";
+
+const posts = defineCollection({
+  loader: omgLoader({
+    workspace: "../content", // directory containing `.omgbase/`
+    repo: "content",
+    query: `from docs where $path.startsWith("posts/") && status == "published"`,
+    slug: ({ path }) => path.replace(/^posts\//, "").replace(/\.md$/i, ""),
+    href: ({ slug }) => `/blog/${slug}/`,
+  }),
+  schema: z.object({
+    title: z.string(),
+    status: z.string(),
+    path: z.string(),
+    docId: z.string(),
+    contentHash: z.string().nullable(),
+    slug: z.string(),
+  }),
+});
+
+export const collections = { posts };
+```
+
+Entry **id** = omg document id. **`data.slug`** is for routing (default: path without `.md`).
+
+### Inter-doc links
+
+When the loader hydrates a set of docs, markdown bodies are rewritten so links that resolve to another hydrated doc use that doc’s site URL:
+
+```ts
+omgLoader({
+  workspace: "../content",
+  query: `from docs where status == "published"`,
+  slug: ({ path }) => path.replace(/^posts\//, "").replace(/\.md$/i, ""),
+  href: ({ slug }) => `/blog/${slug}/`, // match your routes
+});
+```
+
+Resolution is identity-aware: live omg out-edges (`$dst`) gate rewrites when available, and authored destinations are matched with the same path rules as the engine (`./` / `../`, root-relative, `.md` aliases). Fragments (`#sec`) are preserved. External URLs, pure `#anchors`, code spans/fences, and destinations that aren’t in this load are left alone. Set `href: false` to disable rewriting.
+
+Query projections that return link URL *values* as columns are never rewritten — only markdown bodies going through `renderMarkdown`.
+
+## Remote loader (Streamable HTTP MCP)
+
+Point `url` at the same endpoint you’d pass to `omg query --server <url>` — including a stdio-mcp-to-http wrapper, secret path prefix, etc. Custom headers match CLI `-H`:
+
+```ts
+omgLoader({
+  url: process.env.OMG_URL!,                    // e.g. https://host/k/<secret>/mcp
+  headers: { "X-Env": "prod" },                 // map form
+  headerLines: ["X-Request-Id: build-42"],      // CLI -H "Name: value" form
+  token: process.env.OMG_TOKEN,                 // → Authorization: Bearer …
+  repo: "content",
+  query: `from docs where status == "published"`,
+});
+```
+
+Under the hood this uses `@omgbase/sync`’s `connectHttpEngine` (same client as the CLI).
+
+### Live reload in `astro dev`
+
+Enabled by default whenever Astro passes a `watcher` into the loader:
+
+| Transport | Mechanism |
+| --- | --- |
+| Local | Vite FS watch on the vault root (same hook as `glob()`) |
+| Remote | Poll MCP `changes_since` (default every 2s) |
+
+On change, the loader re-queries/hydrates into the content data store. Astro already watches that store file and hot-reloads pages — we don’t invent a second HMR channel.
+
+```ts
+omgLoader({
+  url: process.env.OMG_URL!,
+  query: `from docs where status == "published"`,
+  watch: { intervalMs: 1500 }, // or `watch: false` to disable
+});
+```
+
+### Demo MCP HTTP server
+
+If you don’t already have an HTTP MCP front-end, `createMcpHttpServer` wraps a local workspace:
+
+```ts
+import { createMcpHttpServer } from "@omgbase/astro/server";
+
+const mcp = await createMcpHttpServer({
+  workspace: "./content",
+  repo: "content",
+  token: "secret",
+  port: 8787,
+});
+// mcp.url → http://127.0.0.1:8787/mcp
+```
+
+Prefer your real wrapper/hosted endpoint for production builds.
+
+## Identity & caching
+
+- Astro entry **`id`** = omg document id (`d_…`)
+- **`data.slug`** = routing key (default: path with `.md` stripped; override with `slug`)
+- **`href`** = site URL used when rewriting markdown links between hydrated docs (default `/${slug}`; override to match routes)
+- Digests use omg `contentHash` (plus an href-map fingerprint when rewriting) so unchanged docs skip rewrite on reload
+
+## Example
+
+See [`examples/blog`](../../examples/blog):
+
+```bash
+pnpm install
+pnpm --filter @omgbase/astro build
+pnpm --filter @omgbase/example-blog dev:local
+# or (demo MCP HTTP server)
+pnpm --filter @omgbase/example-blog dev:remote
+# or point at your wrapper:
+OMG_URL=https://host/k/secret/mcp OMG_TOKEN=… pnpm --filter @omgbase/example-blog build:local
+# with OMG_TRANSPORT=remote and OMG_URL set in the environment
+```

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { omgLoader } from "./loader.js";
+export type { OmgLoaderOptions, OmgLoaderBaseOptions, OmgLoaderLocalOptions, OmgLoaderRemoteOptions, } from "./loader.js";
+export type { Transport, QueryHit, HydratedDoc, QueryOptions, HydrateOptions, DocOutEdge } from "./transport.js";
+export { createLocalTransport, LocalTransport } from "./local.js";
+export type { LocalTransportOptions } from "./local.js";
+export { createRemoteTransport, RemoteTransport, parseHeaderLine, resolveHeaders, } from "./remote.js";
+export type { RemoteTransportOptions } from "./remote.js";
+export type { WatchOption } from "./watch.js";
+export { defaultSlug, stripFrontmatter, mapDoc, mergeHitProjections, contentHashOf } from "./map.js";
+export type { SlugContext, MappedEntry } from "./map.js";
+export type { OmgEntryIntrinsics } from "./schema.js";
+export { defaultHref, buildHrefIndex, rewriteMarkdownLinks, resolveLinkHref, canonicalLinkPath, splitDestination, docDirOf, } from "./links.js";
+export type { HrefContext, HrefEntry, HrefIndex, OutEdge } from "./links.js";
+export { createMcpHttpServer, createPublicationServer, } from "./server.js";
+export type { McpHttpServerOptions, McpHttpServer, PublicationServerOptions, PublicationServer, } from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrG,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { omgLoader } from "./loader.js";
+export { createLocalTransport, LocalTransport } from "./local.js";
+export { createRemoteTransport, RemoteTransport, parseHeaderLine, resolveHeaders, } from "./remote.js";
+export { defaultSlug, stripFrontmatter, mapDoc, mergeHitProjections, contentHashOf } from "./map.js";
+export { defaultHref, buildHrefIndex, rewriteMarkdownLinks, resolveLinkHref, canonicalLinkPath, splitDestination, docDirOf, } from "./links.js";
+export { createMcpHttpServer, createPublicationServer, } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AASxC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIrG,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/links.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Identity-aware markdown link rewriting for rendered omg bodies.
+ *
+ * When the loader has hydrated docs, each link destination that resolves to one
+ * of those docs is rewritten to that doc's site `href` — keyed by omg doc id /
+ * path, not by string-guessing alone. Link URL columns / projections are never
+ * touched; only markdown bodies passed through {@link rewriteMarkdownLinks}.
+ */
+export interface HrefEntry {
+    docId: string;
+    path: string;
+    href: string;
+}
+export interface HrefIndex {
+    byDocId: Map<string, string>;
+    /** Canonical repo-relative paths (and `.md`-stripped aliases) → href. */
+    byPath: Map<string, string>;
+    /** Canonical path → doc id (for edge gating). */
+    docIdByPath: Map<string, string>;
+}
+/** Live out-edge to a document (from OQX `edges` or local `docLinks`). */
+export interface OutEdge {
+    src: string;
+    dst: string;
+    dstPath: string | null;
+}
+export interface HrefContext {
+    path: string;
+    docId: string;
+    slug: string;
+    properties: Record<string, Record<string, unknown>>;
+}
+/** Default site href: `/${slug}`. Override to match your routes (e.g. `/blog/${slug}/`). */
+export declare function defaultHref({ slug }: HrefContext): string;
+/** Directory prefix (`""` or `"a/b/"`) of a repo-relative doc path. */
+export declare function docDirOf(docPath: string): string;
+/** Split authored destination into path + fragment (`#…` / `^…`, marker kept). */
+export declare function splitDestination(dest: string): {
+    path: string;
+    fragment: string;
+};
+/**
+ * Canonical repo-relative path for a link as authored in `docDir`
+ * (mirrors omgbase `canonicalLinkPath`).
+ */
+export declare function canonicalLinkPath(path: string, docDir?: string): string;
+/** Build path/id indexes for every hydrated doc we may link to. */
+export declare function buildHrefIndex(entries: HrefEntry[]): HrefIndex;
+/** Stable fingerprint of the href map (for digests when rewrites are enabled). */
+export declare function hrefIndexFingerprint(index: HrefIndex): string;
+/**
+ * Resolve an authored destination against the href index.
+ * Returns null for external, pure-fragment, dangling, or unknown targets.
+ */
+export declare function resolveLinkHref(dest: string, srcPath: string, index: HrefIndex, allowedDstIds?: Set<string>): string | null;
+/**
+ * Rewrite link destinations in markdown that resolve to hydrated omg docs.
+ * Fenced code blocks and inline code spans are left untouched.
+ */
+export declare function rewriteMarkdownLinks(body: string, opts: {
+    srcPath: string;
+    hrefIndex: HrefIndex;
+    /**
+     * When set, only rewrite destinations whose resolved doc id appears in this
+     * set (typically live out-edge `$dst` values that are also in the index).
+     * When omitted, any destination that resolves to a hydrated doc is rewritten.
+     */
+    allowedDstIds?: Set<string>;
+}): string;
+/**
+ * Allowed destination doc ids for a source, from live out-edges ∩ href index.
+ * Phantoms / externals are dropped. Empty set means "no edge-gated targets".
+ */
+export declare function allowedDstsFor(srcDocId: string, edges: OutEdge[], index: HrefIndex): Set<string>;
+//# sourceMappingURL=links.d.ts.map

package/dist/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yEAAyE;IACzE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,iDAAiD;IACjD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,0EAA0E;AAC1E,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMjF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAcnE;AAOD,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,CAoB9D;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAM7D;AAYD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,MAAM,GAAG,IAAI,CAaf;AASD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B,GACA,MAAM,CAkER;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EAAE,EAChB,KAAK,EAAE,SAAS,GACf,GAAG,CAAC,MAAM,CAAC,CASb"}

package/dist/links.js

@@ -0,0 +1,198 @@
+/**
+ * Identity-aware markdown link rewriting for rendered omg bodies.
+ *
+ * When the loader has hydrated docs, each link destination that resolves to one
+ * of those docs is rewritten to that doc's site `href` — keyed by omg doc id /
+ * path, not by string-guessing alone. Link URL columns / projections are never
+ * touched; only markdown bodies passed through {@link rewriteMarkdownLinks}.
+ */
+/** Default site href: `/${slug}`. Override to match your routes (e.g. `/blog/${slug}/`). */
+export function defaultHref({ slug }) {
+    return `/${slug}`;
+}
+/** Directory prefix (`""` or `"a/b/"`) of a repo-relative doc path. */
+export function docDirOf(docPath) {
+    const i = docPath.lastIndexOf("/");
+    return i < 0 ? "" : docPath.slice(0, i + 1);
+}
+/** Split authored destination into path + fragment (`#…` / `^…`, marker kept). */
+export function splitDestination(dest) {
+    const caret = dest.indexOf("^");
+    if (caret >= 0)
+        return { path: dest.slice(0, caret), fragment: dest.slice(caret) };
+    const hash = dest.indexOf("#");
+    if (hash >= 0)
+        return { path: dest.slice(0, hash), fragment: dest.slice(hash) };
+    return { path: dest, fragment: "" };
+}
+/**
+ * Canonical repo-relative path for a link as authored in `docDir`
+ * (mirrors omgbase `canonicalLinkPath`).
+ */
+export function canonicalLinkPath(path, docDir = "") {
+    if (path.startsWith("./") || path.startsWith("../")) {
+        const out = [];
+        for (const p of (docDir + path).split("/")) {
+            if (p === "." || p === "")
+                continue;
+            if (p === "..") {
+                out.pop();
+                continue;
+            }
+            out.push(p);
+        }
+        return out.join("/");
+    }
+    return path.replace(/^\//, "");
+}
+function isExternalDest(path) {
+    if (!path)
+        return false;
+    return /^[a-z][a-z0-9+.-]*:/i.test(path);
+}
+/** Build path/id indexes for every hydrated doc we may link to. */
+export function buildHrefIndex(entries) {
+    const byDocId = new Map();
+    const byPath = new Map();
+    const docIdByPath = new Map();
+    const rememberPath = (path, docId, href) => {
+        byPath.set(path, href);
+        docIdByPath.set(path, docId);
+        if (path.toLowerCase().endsWith(".md")) {
+            const stripped = path.slice(0, -3);
+            byPath.set(stripped, href);
+            docIdByPath.set(stripped, docId);
+        }
+    };
+    for (const e of entries) {
+        byDocId.set(e.docId, e.href);
+        rememberPath(e.path, e.docId, e.href);
+    }
+    return { byDocId, byPath, docIdByPath };
+}
+/** Stable fingerprint of the href map (for digests when rewrites are enabled). */
+export function hrefIndexFingerprint(index) {
+    const parts = [];
+    for (const [id, href] of [...index.byDocId.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+        parts.push(`${id}=${href}`);
+    }
+    return parts.join("|");
+}
+function lookupHref(canonical, index) {
+    const href = index.byPath.get(canonical);
+    const docId = index.docIdByPath.get(canonical);
+    if (href && docId)
+        return { href, docId };
+    return null;
+}
+/**
+ * Resolve an authored destination against the href index.
+ * Returns null for external, pure-fragment, dangling, or unknown targets.
+ */
+export function resolveLinkHref(dest, srcPath, index, allowedDstIds) {
+    const { path, fragment } = splitDestination(dest);
+    if (!path)
+        return null; // same-doc `#heading` / `^ref` — leave alone
+    if (isExternalDest(path))
+        return null;
+    const canonical = canonicalLinkPath(path, docDirOf(srcPath));
+    const hit = lookupHref(canonical, index);
+    if (!hit)
+        return null;
+    if (allowedDstIds && !allowedDstIds.has(hit.docId))
+        return null;
+    // Avoid `href/#frag` when href already ends with `/` → `href#frag` is fine;
+    // fragment already includes the marker.
+    return `${hit.href}${fragment}`;
+}
+// Destination-bearing syntaxes (prefix, dest, suffix) — same shapes as omgbase.
+const MD_LINK = /(!?\[[^\]]*\]\()([^)\s]+)((?:\s+"[^"]*")?\))/g;
+const WIKILINK = /(!?\[\[)([^\]|]+)((?:\|[^\]]*)?\]\])/g;
+const CODE_SPAN = /(`+)[^`][\s\S]*?\1/g;
+const FENCE_OPEN = /^[ \t]*(`{3,}|~{3,})/;
+const FENCE_CLOSE = /^[ \t]*(`{3,}|~{3,})[ \t]*$/;
+/**
+ * Rewrite link destinations in markdown that resolve to hydrated omg docs.
+ * Fenced code blocks and inline code spans are left untouched.
+ */
+export function rewriteMarkdownLinks(body, opts) {
+    const { srcPath, hrefIndex, allowedDstIds } = opts;
+    if (hrefIndex.byDocId.size === 0)
+        return body;
+    const replaceDest = (dest) => resolveLinkHref(dest, srcPath, hrefIndex, allowedDstIds);
+    const rewriteProse = (seg) => {
+        let out = seg.replace(MD_LINK, (whole, pre, dest, post) => {
+            const next = replaceDest(dest);
+            return next === null ? whole : pre + next + post;
+        });
+        out = out.replace(WIKILINK, (whole, pre, dest, post) => {
+            const next = replaceDest(dest);
+            return next === null ? whole : pre + next + post;
+        });
+        return out;
+    };
+    /** Rewrite outside inline code spans. */
+    const rewriteOutsideSpans = (seg) => {
+        let out = "";
+        let last = 0;
+        for (const m of seg.matchAll(CODE_SPAN)) {
+            const start = m.index ?? 0;
+            out += rewriteProse(seg.slice(last, start)) + m[0];
+            last = start + m[0].length;
+        }
+        return out + rewriteProse(seg.slice(last));
+    };
+    // Split on fenced code blocks (line-oriented), rewrite only the prose regions.
+    const lines = body.split("\n");
+    const outLines = [];
+    let fence = null;
+    let proseBuf = [];
+    const flushProse = () => {
+        if (proseBuf.length === 0)
+            return;
+        outLines.push(rewriteOutsideSpans(proseBuf.join("\n")));
+        proseBuf = [];
+    };
+    for (const line of lines) {
+        if (fence) {
+            outLines.push(line);
+            const m = FENCE_CLOSE.exec(line);
+            if (m && m[1][0] === fence.ch && m[1].length >= fence.len)
+                fence = null;
+            continue;
+        }
+        const open = FENCE_OPEN.exec(line);
+        if (open) {
+            const fenceMark = open[1];
+            if (fenceMark[0] === "`" && line.slice(open[0].length).includes("`")) {
+                proseBuf.push(line);
+                continue;
+            }
+            flushProse();
+            outLines.push(line);
+            fence = { ch: fenceMark[0], len: fenceMark.length };
+            continue;
+        }
+        proseBuf.push(line);
+    }
+    flushProse();
+    return outLines.join("\n");
+}
+/**
+ * Allowed destination doc ids for a source, from live out-edges ∩ href index.
+ * Phantoms / externals are dropped. Empty set means "no edge-gated targets".
+ */
+export function allowedDstsFor(srcDocId, edges, index) {
+    const out = new Set();
+    for (const e of edges) {
+        if (e.src !== srcDocId)
+            continue;
+        if (!e.dst || e.dst.startsWith("phantom:") || e.dst.startsWith("x_"))
+            continue;
+        if (!index.byDocId.has(e.dst))
+            continue;
+        out.add(e.dst);
+    }
+    return out;
+}
+//# sourceMappingURL=links.js.map

package/dist/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"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"}

package/dist/loader.d.ts

@@ -0,0 +1,70 @@
+import type { Loader } from "astro/loaders";
+import type { Transport } from "./transport.js";
+import { type SlugContext } from "./map.js";
+import { type HrefContext } from "./links.js";
+import { type WatchOption } from "./watch.js";
+export interface OmgLoaderBaseOptions {
+    /** OQX query selecting documents for this collection. Must return doc hits. */
+    query: string;
+    /** Optional result limit passed to OQX / the MCP `query` tool. */
+    limit?: number;
+    /** Repo slug (local workspace or remote multi-repo server). */
+    repo?: string;
+    /** Override slug generation. Default: path with `.md` stripped. */
+    slug?: (ctx: SlugContext) => string;
+    /**
+     * Site URL for a hydrated doc (used to rewrite markdown links that resolve to
+     * other docs in this load). Default: `/${slug}`. Match your routes, e.g.
+     * `({ slug }) => `/blog/${slug}/``.
+     *
+     * Set `href: false` to leave authored destinations unchanged.
+     */
+    href?: false | ((ctx: HrefContext) => string);
+    /**
+     * Live-reload in `astro dev` (default true when Astro provides a watcher).
+     * Local: Vite FS watch on the vault. Remote: poll MCP `changes_since`.
+     * Store updates use the same data-store write path as glob() → existing HMR.
+     */
+    watch?: WatchOption;
+    /** Inject a pre-built transport (tests). */
+    transport?: Transport;
+}
+export type OmgLoaderLocalOptions = OmgLoaderBaseOptions & {
+    /** Path to the omgbase workspace root (directory containing `.omgbase/`). */
+    workspace: string;
+    url?: undefined;
+    token?: undefined;
+    headers?: undefined;
+    headerLines?: undefined;
+    stale?: boolean;
+};
+export type OmgLoaderRemoteOptions = OmgLoaderBaseOptions & {
+    /**
+     * Streamable HTTP MCP endpoint (same as `omg … --server <url>`).
+     * When set, remote MCP transport is used.
+     */
+    url: string;
+    /** Extra headers on every MCP request (CLI `-H` as a map). */
+    headers?: Record<string, string>;
+    /** Extra headers as CLI `-H` strings: `["X-Foo: bar"]`. */
+    headerLines?: string[];
+    /** Convenience bearer token → `Authorization: Bearer …` if unset. */
+    token?: string;
+    workspace?: undefined;
+    stale?: undefined;
+};
+export type OmgLoaderOptions = OmgLoaderLocalOptions | OmgLoaderRemoteOptions | OmgLoaderBaseOptions;
+/**
+ * Astro Content Layer loader backed by omgbase.
+ *
+ * Local: opens a workspace via `@omgbase/core`, runs OQX, hydrates Markdown.
+ * Remote: Streamable HTTP MCP (`query` + `docs_get_many`), same as CLI `--server`.
+ * In `astro dev`, keeps the collection fresh (FS watch or `changes_since` poll)
+ * through Astro's normal content-store → HMR path.
+ *
+ * Entry `id` is the omg document id. `data.slug` is derived from path (overridable).
+ * Markdown bodies are rewritten so links to other hydrated docs use each doc's
+ * site `href` (identity via omg out-edges ∩ path resolution).
+ */
+export declare function omgLoader(opts: OmgLoaderOptions): Loader;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAsC,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC,CAAC;IAC9C;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG;IACzD,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC1D;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AA2BrG;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAsCxD"}

package/dist/loader.js

@@ -0,0 +1,75 @@
+import { createLocalTransport } from "./local.js";
+import { createRemoteTransport } from "./remote.js";
+import { defaultSlug } from "./map.js";
+import { defaultHref } from "./links.js";
+import { startWatch, stopWatch, syncEntries } from "./watch.js";
+function resolveTransport(opts) {
+    if (opts.transport)
+        return opts.transport;
+    if ("url" in opts && opts.url) {
+        const remote = {
+            url: opts.url,
+            ...(opts.token !== undefined ? { token: opts.token } : {}),
+            ...(opts.headers !== undefined ? { headers: opts.headers } : {}),
+            ...(opts.headerLines !== undefined ? { headerLines: opts.headerLines } : {}),
+            ...(opts.repo !== undefined ? { repo: opts.repo } : {}),
+        };
+        return createRemoteTransport(remote);
+    }
+    if ("workspace" in opts && opts.workspace) {
+        const local = {
+            workspace: opts.workspace,
+            ...(opts.repo !== undefined ? { repo: opts.repo } : {}),
+            ...(opts.stale !== undefined ? { stale: opts.stale } : {}),
+        };
+        return createLocalTransport(local);
+    }
+    throw new Error("omgLoader requires either `workspace` (local) or `url` (Streamable HTTP MCP), or an explicit `transport`");
+}
+/**
+ * Astro Content Layer loader backed by omgbase.
+ *
+ * Local: opens a workspace via `@omgbase/core`, runs OQX, hydrates Markdown.
+ * Remote: Streamable HTTP MCP (`query` + `docs_get_many`), same as CLI `--server`.
+ * In `astro dev`, keeps the collection fresh (FS watch or `changes_since` poll)
+ * through Astro's normal content-store → HMR path.
+ *
+ * Entry `id` is the omg document id. `data.slug` is derived from path (overridable).
+ * Markdown bodies are rewritten so links to other hydrated docs use each doc's
+ * site `href` (identity via omg out-edges ∩ path resolution).
+ */
+export function omgLoader(opts) {
+    const slugFn = opts.slug ?? defaultSlug;
+    const hrefFn = opts.href === false ? false : (opts.href ?? defaultHref);
+    const watchOpt = opts.watch ?? true;
+    return {
+        name: "@omgbase/astro",
+        async load(context) {
+            await stopWatch(context.collection);
+            const transport = resolveTransport(opts);
+            const syncOpts = {
+                query: opts.query,
+                ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
+                ...(opts.repo !== undefined ? { repo: opts.repo } : {}),
+                slug: slugFn,
+                href: hrefFn,
+            };
+            try {
+                context.logger.info(`querying omgbase (${transport.kind})`);
+                const { seen } = await syncEntries(context, transport, syncOpts);
+                context.logger.info(`loaded ${seen} entries from omgbase`);
+                if (context.watcher && watchOpt !== false) {
+                    await startWatch(context, transport, { ...syncOpts, watch: watchOpt });
+                    // Watch owns the transport lifetime.
+                    return;
+                }
+                await transport.close?.();
+            }
+            catch (err) {
+                await transport.close?.();
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"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"}