diffwiki-core 0.13.0 → 0.14.0-rc.202608012127.a1298c2

package/dist/{chunk-7V2DIQNL.js → chunk-B67AZFRA.js}

@@ -116,7 +116,7 @@ ${problems.map((p) => `  - ${p}`).join("\n")}`);
 // src/collections.ts
 async function fireHook(event, collection) {
   try {
-    const { emitPluginEvent: emitPluginEvent2 } = await import("./events-AVD3G5AX.js");
+    const { emitPluginEvent: emitPluginEvent2 } = await import("./events-QZYAWK7I.js");
     await emitPluginEvent2(event, collection);
   } catch {
   }
@@ -351,7 +351,11 @@ function mapHits(result, collections) {
       tags: Array.isArray(h.tags) ? h.tags.filter((t) => typeof t === "string") : [],
       snippet: typeof h.snippet === "string" ? h.snippet : void 0,
       score: typeof h.score === "number" ? h.score : void 0,
-      docid: typeof h.docid === "string" ? h.docid : void 0
+      docid: typeof h.docid === "string" ? h.docid : void 0,
+      rawChunk: typeof h.rawChunk === "string" ? h.rawChunk : void 0,
+      cleanedChunk: typeof h.cleanedChunk === "string" ? h.cleanedChunk : void 0,
+      line: typeof h.line === "number" ? h.line : void 0,
+      snippetFromBody: h.snippetFromBody === true ? true : void 0
     });
   }
   return out;

package/dist/{chunk-EEETAETA.js → chunk-HDJUZIQP.js}

@@ -1,3 +1,72 @@
+// src/frontmatter.ts
+import matter from "gray-matter";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+var YAML_ENGINE = {
+  parse: (input) => {
+    const data = parseYaml(input);
+    return data && typeof data === "object" ? data : {};
+  },
+  stringify: (data) => stringifyYaml(data)
+};
+var MATTER_OPTS = { engines: { yaml: YAML_ENGINE } };
+function coerceAudience(value) {
+  return value === "private" || value === "system" ? value : "public";
+}
+function coerceStatus(value) {
+  return value === "draft" || value === "deprecated" ? value : "published";
+}
+function parseFallback(raw) {
+  const fenceRe = /^---[ \t]*\n([\s\S]*?)\n---[ \t]*\n/;
+  const fenceMatch = fenceRe.exec(raw);
+  let title = "";
+  let audience = "public";
+  let status = "published";
+  let body;
+  const clean = (s) => s.trim().replace(/^["']|["']$/g, "");
+  if (fenceMatch) {
+    const inner = fenceMatch[1];
+    const titleMatch = /^title:\s*(.+)$/m.exec(inner);
+    if (titleMatch) {
+      title = clean(titleMatch[1]);
+    }
+    const audienceMatch = /^audience:\s*(.+)$/m.exec(inner);
+    if (audienceMatch) {
+      audience = coerceAudience(clean(audienceMatch[1]));
+    }
+    const statusMatch = /^status:\s*(.+)$/m.exec(inner);
+    if (statusMatch) {
+      status = coerceStatus(clean(statusMatch[1]));
+    }
+    body = raw.slice(fenceMatch[0].length);
+  } else {
+    body = raw;
+  }
+  return { title, tags: [], audience, status, body: body.replace(/^\n+/, "") };
+}
+var FRONTMATTER_BLOCK_RE = /^\uFEFF?[ \t]*---\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/;
+function stripFrontmatter(raw) {
+  return raw.replace(FRONTMATTER_BLOCK_RE, "");
+}
+function parseArticle(raw) {
+  try {
+    const { data, content } = matter(raw, MATTER_OPTS);
+    const title = typeof data.title === "string" ? data.title : "";
+    const tags = Array.isArray(data.tags) ? data.tags.map((t) => String(t)) : [];
+    const created = typeof data.created === "string" ? data.created : void 0;
+    const audience = coerceAudience(data.audience);
+    const status = coerceStatus(data.status);
+    return { title, tags, created, audience, status, body: content.replace(/^\n+/, "") };
+  } catch {
+    return parseFallback(raw);
+  }
+}
+function serializeArticle(article) {
+  const front = { title: article.title, tags: article.tags };
+  if (article.audience === "private" || article.audience === "system") front.audience = article.audience;
+  if (article.status === "draft" || article.status === "deprecated") front.status = article.status;
+  return matter.stringify(article.body, front, MATTER_OPTS);
+}
+
 // src/plugins/sdk.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
@@ -137,6 +206,9 @@ function definePlugin(def) {
 }
 
 export {
+  stripFrontmatter,
+  parseArticle,
+  serializeArticle,
   runProcess,
   runProcessJson,
   commandExists,

package/dist/{events-AVD3G5AX.js → events-QZYAWK7I.js}

@@ -1,6 +1,6 @@
 import {
   emitPluginEvent
-} from "./chunk-7V2DIQNL.js";
+} from "./chunk-B67AZFRA.js";
 export {
   emitPluginEvent
 };

package/dist/frontmatter-DQL69ovH.d.cts

@@ -0,0 +1,375 @@
+/** Audience axis — who an article is for. Private is never published; system is diffwiki-internal (hidden unless `showSystem`). Missing/invalid → 'public'. */
+type Audience = 'public' | 'private' | 'system';
+/** Lifecycle axis — readiness. Draft is unpublished; deprecated is superseded. Missing/invalid → 'published'. */
+type PublishStatus = 'draft' | 'published' | 'deprecated';
+type CollectionType = 'global' | 'repo' | 'external';
+interface CollectionEntry {
+    name: string;
+    type: CollectionType;
+    /** Absolute path to the collection's content directory. */
+    path: string;
+    createdAt: string;
+    /** Marks a diffwiki-internal collection (e.g. `transcripts`). 'system' hides it unless `showSystem`. */
+    audience?: Audience;
+    /** External only: stable git repo id (see `repoId`). Identity + dedupe key. */
+    id?: string;
+    /** External only: absolute repo root (branch/behind + open-at-root). */
+    repoRoot?: string;
+    /** External only: content dir relative to `repoRoot` (default "docs"). */
+    docsDir?: string;
+}
+interface Registry {
+    version: number;
+    collections: CollectionEntry[];
+}
+interface Config {
+    defaultCollection?: string;
+    defaultSearch?: string;
+    /** Editor command used by `diffwiki edit` (e.g. "code -w", "hx"). Falls back to $VISUAL/$EDITOR. */
+    editor?: string;
+    /** Reveal system-audience content in search, nav, and the UI (default: false). Stored as boolean or "true". */
+    showSystem?: boolean;
+}
+interface Article {
+    title: string;
+    tags: string[];
+    /** Absolute path to the article file. */
+    path: string;
+    collection: string;
+}
+interface RepoConfig {
+    collection: string;
+    /** Path to the wiki directory, relative to the repo root. */
+    path: string;
+}
+/** A home-page card (VitePress-style): icon + title + subtitle linking into the site. */
+interface HomeCard {
+    /** Icon name from the curated home-card icon set; unknown/missing → no icon. */
+    icon?: string;
+    title: string;
+    subtitle?: string;
+    /** In-site path, e.g. "/getting-started". */
+    link: string;
+}
+/** Home-page customization from `diffwiki.yaml` → `site.home`. */
+interface SiteHome {
+    /** Line shown under the wordmark on the home page. */
+    tagline?: string;
+    /** Cards rendered below the search bar. */
+    cards?: HomeCard[];
+}
+/** Footer copyright notice from `diffwiki.yaml` → `site.copyright`. Applies to the
+ *  site/software; article CONTENT copyright stays with its respective authors. */
+interface SiteCopyright {
+    /** The full notice text, e.g. "© 2026 Acme, Inc." */
+    text: string;
+    /** Optional URL — renders the notice as a link. */
+    url?: string;
+}
+/** Site-level config from `diffwiki.yaml` → `site`. The diffwiki logo + wordmark
+ *  are fixed branding and deliberately not configurable. */
+interface SiteConfig {
+    /** Project repository URL for the top-nav GitHub link. */
+    repo?: string;
+    /** Footer copyright notice; no default — the footer is empty when unset. */
+    copyright?: SiteCopyright;
+    home?: SiteHome;
+}
+/** One collection declared in `diffwiki.yaml` → `collections[]`. */
+interface ProjectCollection {
+    name: string;
+    /** Content directory, relative to the project root. */
+    path: string;
+    /** Optional display order (ascending). Unset sorts after ordered ones, keeping list order. */
+    order?: number;
+}
+/** Optional recall/search context from `diffwiki.yaml` → `context`. */
+interface ProjectContext {
+    /** Collection names recall/search should filter to by default. */
+    collections: string[];
+}
+/**
+ * Normalised repo-root `diffwiki.yaml`. The extended form carries `site` +
+ * `collections[]`; the legacy `{ collection, path }` form is folded into a
+ * one-element `collections` by the parser.
+ */
+interface ProjectConfig {
+    site?: SiteConfig;
+    collections: ProjectCollection[];
+    context?: ProjectContext;
+}
+/** A node in a collection's article tree. Branches have `children`; leaves have `slug`. */
+interface ArticleNode {
+    /** Segment label — dir name for branches, filename-without-ext for leaves. */
+    name: string;
+    /** Display title — frontmatter `title` (leaf) or the folder's index title, else `name`. */
+    title?: string;
+    /**
+     * Path within the collection, without extension, e.g. "guide/setup". Set on
+     * leaves (the article) and on branches (the folder, navigable to its index).
+     */
+    slug?: string;
+    /** Audience, set only when 'private' (omitted for 'public'). */
+    audience?: Audience;
+    /** Lifecycle status, set only when 'draft' (omitted for 'published'). */
+    status?: PublishStatus;
+    /** Frontmatter `order` — nav sort within a folder (ascending; unset sorts after). */
+    order?: number;
+    /** Branch only: nested nodes. */
+    children?: ArticleNode[];
+}
+/** A resolved article's content, returned by `readArticle`. */
+interface ArticleContent {
+    coll: string;
+    slug: string;
+    title: string;
+    tags: string[];
+    /** Audience from frontmatter ('public' when absent). */
+    audience: Audience;
+    /** Lifecycle status from frontmatter ('published' when absent). */
+    status: PublishStatus;
+    /** Frontmatter-stripped body (md/mdx). */
+    body: string;
+    /** Absolute path to the file on disk. */
+    path: string;
+    /**
+     * True when the resolved file is a folder-index page (`<slug>/index.md` or
+     * `<slug>/README.md`) rather than a leaf `<slug>.md`. The route slug is the
+     * same for both, so this flag is needed to resolve folder-local relative
+     * links against the article's own folder.
+     */
+    isIndex: boolean;
+}
+type PluginKind = 'search';
+declare const NATIVE_ENGINE = "native";
+interface QueryOptions {
+    engine?: string;
+    /** Limit to a single collection name, or a set of names. Empty/undefined = all. */
+    collection?: string | string[];
+    type?: string;
+    limit?: number;
+    /** Reveal system-audience content (default: config `showSystem`, else false). */
+    showSystem?: boolean;
+}
+interface QueryHit {
+    collection: string;
+    path: string;
+    title: string;
+    tags: string[];
+    snippet?: string;
+    score?: number;
+    docid?: string;
+    /** Verbatim engine chunk (unsanitized) for the search UI's inspection popover. */
+    rawChunk?: string;
+    /** The chunk cleaned to plain text, untruncated (full form for the popover). */
+    cleanedChunk?: string;
+    /** Absolute source line the chunk starts at, when the engine reports it. */
+    line?: number;
+    /** True when `snippet` is a body-preview fallback rather than the cleaned chunk. */
+    snippetFromBody?: boolean;
+}
+type DiagnosticLevel = 'ok' | 'warn' | 'error';
+interface Diagnostic {
+    level: DiagnosticLevel;
+    message: string;
+}
+interface PluginRecord {
+    name: string;
+    kind: PluginKind;
+    command: string[];
+    version?: string;
+    /** Capabilities cached at install/register time via the `describe` op. */
+    capabilities?: PluginCapabilities;
+    enabled: boolean;
+    managed?: boolean;
+}
+interface PluginRegistryFile {
+    version: number;
+    plugins: PluginRecord[];
+}
+/** Capabilities a plugin advertises via the `describe` op, cached in the registry. */
+interface PluginCapabilities {
+    /** Search types the plugin supports (e.g. `['keyword', 'semantic', 'hybrid']`). */
+    searchTypes: string[];
+    /** Whether the plugin supports filtering results by collection. */
+    collectionFilter: boolean;
+    /** Whether the plugin handles lifecycle events (article/collection mutations). */
+    events: boolean;
+}
+interface PluginReadiness {
+    toolInstalled: boolean;
+    modelsPresent: boolean;
+    indexBuilt: boolean;
+    docsIndexed: number;
+    embeddingsPending: number;
+    firstSearchCost: 'instant' | 'model-load' | 'model-download';
+}
+interface PluginHealth {
+    ready: boolean;
+    readiness?: PluginReadiness;
+    diagnostics: Diagnostic[];
+}
+interface SearchMode {
+    plugin: string;
+    type: string;
+    label: string;
+}
+type PluginEvent = 'collection-added' | 'collection-removed' | 'article-created' | 'article-updated' | 'article-removed';
+/**
+ * Host-side facade for a search plugin. Each method is backed by a one-shot
+ * subprocess invocation -- there is no persistent process and no `close()`.
+ */
+interface SearchProvider {
+    /** Plugin name. */
+    name: string;
+    /** Plugin capabilities (cached from the `describe` op). */
+    capabilities: PluginCapabilities;
+    /** Run a search query and return hits with absolute paths. */
+    handleSearch(term: string, collections: CollectionEntry[], opts?: QueryOptions): Promise<QueryHit[]>;
+    /** Rebuild the search index. Returns the number of documents indexed. */
+    reindex(collections: CollectionEntry[], opts?: {
+        embed?: boolean;
+    }): Promise<number>;
+    /** Emit a lifecycle event to the plugin (best-effort). */
+    emitEvent(event: PluginEvent, collection: string, relPath: string | undefined, collections: CollectionEntry[]): Promise<void>;
+    /** Check plugin health and readiness. */
+    health(collections: CollectionEntry[]): Promise<PluginHealth>;
+}
+interface NodeMeta {
+    branch?: string;
+    behind?: number;
+}
+interface TreeNode {
+    name: string;
+    title?: string;
+    path?: string;
+    /** Audience; present only when 'private' (drives the sidebar lock). */
+    audience?: Audience;
+    /** Lifecycle status; present only when 'draft' (drives the sidebar DRAFT tag). */
+    status?: PublishStatus;
+    children?: TreeNode[];
+    /** Set only on top-level collection rows: git branch/behind badge data. */
+    meta?: NodeMeta;
+}
+interface CollectionInfo {
+    name: string;
+    type: CollectionType;
+    path: string;
+    /** Display title from the collection's root index page frontmatter; falls back to `name` in the UI. */
+    title?: string;
+    branch?: string;
+    behind?: number;
+    /** Audience from the collection's root index page; present only when 'private'. */
+    audience?: Audience;
+    /** Lifecycle status from the collection's root index page; present only when 'draft'. */
+    status?: PublishStatus;
+}
+interface CollectionTree {
+    collection: CollectionInfo;
+    nodes: TreeNode[];
+}
+interface TocItem {
+    slug: string;
+    text: string;
+    depth: number;
+}
+interface DocData {
+    coll: string;
+    slug: string;
+    title: string;
+    tags: string[];
+    /** Audience; present only when 'private'. */
+    audience?: Audience;
+    /** Lifecycle status; present only when 'draft'. */
+    status?: PublishStatus;
+    html: string;
+    toc: TocItem[];
+    path: string;
+    /** ISO-8601 creation date, sourced from git history / filesystem (not frontmatter). */
+    created?: string;
+    /** ISO-8601 last-update date, sourced from git history / filesystem (not frontmatter). */
+    updated?: string;
+    /** Local knowledge-graph neighbourhood for this page (this node + its direct links). */
+    graph: LocalGraph;
+}
+interface ListingEntry {
+    name: string;
+    title: string;
+    path: string;
+    isDir: boolean;
+}
+type PageData = ({
+    kind: 'doc';
+} & DocData) | {
+    kind: 'listing';
+    coll: string;
+    slug: string;
+    title: string;
+    entries: ListingEntry[];
+};
+/**
+ * One node in the knowledge graph. Two kinds:
+ * - `article` — a wiki page. `id` is `"<coll>/<slug>"`, with `coll`/`slug` set.
+ * - `tag` — an Obsidian-style tag hub. `id` is `"tag:<name>"`; `coll`/`slug` are
+ *   empty (a tag is not a page, so clicking it never navigates), `title` is `#name`.
+ */
+interface GraphNode {
+    id: string;
+    kind: 'article' | 'tag';
+    coll: string;
+    slug: string;
+    title: string;
+}
+/**
+ * A graph edge. `kind` distinguishes an explicit hyperlink between two articles
+ * (`link`) from an article↔tag-hub membership edge (`tag`). For `link` edges the
+ * direction (source→target) is the link direction; `tag` edges go article→tag.
+ */
+interface GraphEdge {
+    source: string;
+    target: string;
+    kind: 'link' | 'tag';
+}
+/** The whole-wiki knowledge graph. */
+interface LinkGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+/**
+ * The local neighbourhood of one node: the node itself plus its directly linked
+ * (outgoing) and linking (incoming) neighbours, and the edges among them. `focus`
+ * is the id of the page this neighbourhood is centred on.
+ */
+interface LocalGraph {
+    focus: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+
+interface ParsedArticle {
+    title: string;
+    tags: string[];
+    created?: string;
+    audience: Audience;
+    status: PublishStatus;
+    body: string;
+}
+interface SerializableArticle {
+    title: string;
+    tags: string[];
+    audience?: Audience;
+    status?: PublishStatus;
+    body: string;
+}
+/**
+ * Remove a leading frontmatter block, returning the body **verbatim** — unlike
+ * {@link parseArticle}, no leading-whitespace trimming — so a caller that needs
+ * the body's original line offsets (e.g. a search index that blanks frontmatter
+ * to keep source line numbers aligned) can reconstruct them from the removed
+ * span. Returns the input unchanged when there is no frontmatter.
+ */
+declare function stripFrontmatter(raw: string): string;
+declare function parseArticle(raw: string): ParsedArticle;
+declare function serializeArticle(article: SerializableArticle): string;
+
+export { type Audience as A, type PluginHealth as B, type Config as C, type Diagnostic as D, type PluginReadiness as E, type ProjectCollection as F, type GraphEdge as G, type HomeCard as H, type ProjectContext as I, type SerializableArticle as J, type SiteCopyright as K, type LinkGraph as L, type SiteHome as M, NATIVE_ENGINE as N, parseArticle as O, type PublishStatus as P, type QueryHit as Q, type Registry as R, type SiteConfig as S, type TreeNode as T, serializeArticle as U, stripFrontmatter as V, type CollectionEntry as a, type Article as b, type RepoConfig as c, type ProjectConfig as d, type CollectionInfo as e, type CollectionTree as f, type PageData as g, type ArticleNode as h, type QueryOptions as i, type ParsedArticle as j, type ArticleContent as k, type TocItem as l, type LocalGraph as m, type SearchMode as n, type SearchProvider as o, type PluginRecord as p, type PluginEvent as q, type PluginKind as r, type PluginRegistryFile as s, type CollectionType as t, type DiagnosticLevel as u, type DocData as v, type GraphNode as w, type ListingEntry as x, type NodeMeta as y, type PluginCapabilities as z };