diffwiki-core 0.12.0 → 0.13.0

package/dist/index.d.cts

@@ -2,10 +2,10 @@ import { SearchDoc } from './bm25.cjs';
 export { RankableFields, rankDocs, tokenize } from './bm25.cjs';
 import { LogLevel, Logger } from '@logtape/logtape';
 
-/** Audience axis — who an article is for. Private is never published. Missing/invalid → 'public'. */
-type Audience = 'public' | 'private';
-/** Lifecycle axis — readiness. Draft is not yet published. Missing/invalid → 'published'. */
-type PublishStatus = 'draft' | 'published';
+/** 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;
@@ -13,6 +13,8 @@ interface CollectionEntry {
     /** 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). */
@@ -29,6 +31,8 @@ interface Config {
     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;
@@ -83,6 +87,11 @@ interface ProjectCollection {
     /** 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
@@ -91,6 +100,7 @@ interface ProjectCollection {
 interface ProjectConfig {
     site?: SiteConfig;
     collections: ProjectCollection[];
+    context?: ProjectContext;
 }
 /** A node in a collection's article tree. Branches have `children`; leaves have `slug`. */
 interface ArticleNode {
@@ -138,9 +148,12 @@ type PluginKind = 'search';
 declare const NATIVE_ENGINE = "native";
 interface QueryOptions {
     engine?: string;
-    collection?: 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;
@@ -373,6 +386,8 @@ declare function readConfig(): Promise<Config>;
 declare function writeConfig(config: Config): Promise<void>;
 declare function setConfigValue(key: string, value: string): Promise<void>;
 declare function getConfigValue(key: string): Promise<string | undefined>;
+/** Whether system-audience content should be shown (config `showSystem` set to true or "true"). */
+declare function showSystemEnabled(): Promise<boolean>;
 
 declare function readRegistry(): Promise<Registry>;
 declare function writeRegistry(registry: Registry): Promise<void>;
@@ -382,6 +397,8 @@ declare function unregisterCollection(name: string): Promise<void>;
 
 /** Turn a title (or a "# Heading" line) into a filesystem-safe slug. */
 declare function slugify(input: string): string;
+/** Slugify a `/`-separated path segment-by-segment, preserving the separators. */
+declare function slugifyPath(input: string): string;
 
 interface ParsedArticle {
     title: string;
@@ -404,7 +421,9 @@ declare function serializeArticle(article: SerializableArticle): string;
 declare function listCollections(): Promise<CollectionEntry[]>;
 declare function findCollection(name: string): Promise<CollectionEntry | undefined>;
 declare function findCollectionById(id: string): Promise<CollectionEntry | undefined>;
-declare function createCollection(name: string): Promise<CollectionEntry>;
+declare function createCollection(name: string, opts?: {
+    audience?: Audience;
+}): Promise<CollectionEntry>;
 /**
  * Remove a collection from the registry. For `global` collections we own the
  * storage, so its directory is deleted too; for `repo` wikis we only deregister
@@ -490,6 +509,8 @@ declare const PROJECT_CONFIG_FILE = "diffwiki.yaml";
  * undefined when the file is absent (ENOENT); parse/other read errors propagate.
  */
 declare function readProjectConfig(dir: string): Promise<ProjectConfig | undefined>;
+/** The `context.collections` list from `diffwiki.yaml`, or `[]` when absent. */
+declare function readContextCollections(dir: string): Promise<string[]>;
 /**
  * Resolve `diffwiki.yaml` collections into registry-shaped CollectionEntry[] with
  * absolute paths (relative to the project root). Empty when no config / no
@@ -565,9 +586,13 @@ declare function fileTimestamps(absPath: string): Promise<FileTimestamps>;
  *  In static builds, private (audience) or draft (status) articles are dropped
  *  entirely (no nav row, and — since routes + per-doc JSON derive from this tree
  *  — no route/JSON). */
-declare function toTreeNodes(coll: string, nodes: ArticleNode[]): TreeNode[];
-declare function buildCollections(): Promise<CollectionInfo[]>;
-declare function buildNavTree(): Promise<CollectionTree[]>;
+declare function toTreeNodes(coll: string, nodes: ArticleNode[], showSystem?: boolean): TreeNode[];
+declare function buildCollections(opts?: {
+    showSystem?: boolean;
+}): Promise<CollectionInfo[]>;
+declare function buildNavTree(opts?: {
+    showSystem?: boolean;
+}): Promise<CollectionTree[]>;
 /**
  * Resolve a route to a rendered doc or a generated directory listing (or null).
  *
@@ -632,16 +657,7 @@ declare function resolveCollectionSelection(all: string[], sel?: CollectionSelec
  * @module
  */
 
-/**
- * Built-in JS-native search: BM25-ranked full-text search over an article's
- * title, body, tags, and collection name -- across every registered collection's
- * ABSOLUTE registry path (so in-repo wikis outside ~/.diffwiki are searched too).
- * No `find`/OS shelling -- cross-platform and dependency-free.
- *
- * When `term` is empty, returns all articles unranked (no score) to preserve
- * the "browse all" behavior.
- */
-declare function nativeSearch(term: string, collections: CollectionEntry[], collection?: string): Promise<QueryHit[]>;
+declare function nativeSearch(term: string, collections: CollectionEntry[], collection?: string | string[], hideSystem?: boolean): Promise<QueryHit[]>;
 /**
  * Resolve the engine + type that `query()` would use when the caller passes no
  * explicit engine/type. Reads cached capabilities from the registry -- no spawn.
@@ -670,18 +686,6 @@ interface SearchOutcome {
     /** The captured failure message from the engine, when it errored. */
     error?: string;
 }
-/**
- * Search articles via the resolved search engine, surfacing engine failures.
- *
- * Routing precedence: explicit `opts.engine` -> `config.defaultSearch` ->
- * first enabled plugin -> native BM25.
- *
- * On ANY engine failure (no provider, or `handleSearch` throws) the error
- * message is CAPTURED, native BM25 is run as a fallback, and the outcome
- * reports `{ fellBackToNative: true, error }`. On success it reports
- * `{ fellBackToNative: false }` with the engine's hits. This lets callers
- * distinguish "the engine broke" from "the engine found nothing".
- */
 declare function search(term: string, opts?: QueryOptions): Promise<SearchOutcome>;
 /**
  * Search articles via the resolved search engine (native fallback on plugin
@@ -715,6 +719,28 @@ declare function buildSearchIndex(collection?: string): Promise<SearchDoc[]>;
 /** Run all diagnostics and return the results. */
 declare function doctor(): Promise<Diagnostic[]>;
 
+type LintLevel = 'error' | 'warn';
+interface LintFinding {
+    level: LintLevel;
+    rule: string;
+    message: string;
+}
+interface LintFileResult {
+    /** `<collection>/<relative-path>` label. */
+    path: string;
+    findings: LintFinding[];
+}
+interface LintResult {
+    files: LintFileResult[];
+    fileCount: number;
+    errorCount: number;
+    warnCount: number;
+}
+/** Stateless rules over a parsed article. */
+declare function lintArticle(article: Pick<ParsedArticle, 'title' | 'tags' | 'status' | 'body'>): LintFinding[];
+/** Lint every article in the resolved scope. `scope` = 'current' | 'all' | 'a,b,c'. */
+declare function lintCollections(scope: string): Promise<LintResult>;
+
 /**
  * Centralized logging for diffwiki host code, built on LogTape.
  *
@@ -1059,4 +1085,4 @@ declare function findEnabledPlugin(kind: PluginKind, name?: string): Promise<Plu
 /** Find a plugin record by name (regardless of enabled state). */
 declare function findPluginRecord(name: string): Promise<PluginRecord | undefined>;
 
-export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type Audience, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type EditTarget, type FileTimestamps, type GraphEdge, type GraphNode, type HomeCard, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, PROJECT_CONFIG_FILE, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type ProjectCollection, type ProjectConfig, type PublishStatus, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type SiteConfig, type SiteCopyright, type SiteHome, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, serializeArticle, setArticleMeta, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type Audience, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type EditTarget, type FileTimestamps, type GraphEdge, type GraphNode, type HomeCard, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type LintFileResult, type LintFinding, type LintLevel, type LintResult, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, PROJECT_CONFIG_FILE, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type ProjectCollection, type ProjectConfig, type ProjectContext, type PublishStatus, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type SiteConfig, type SiteCopyright, type SiteHome, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, lintArticle, lintCollections, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readContextCollections, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, serializeArticle, setArticleMeta, setConfigValue, setTags, showSystemEnabled, slugify, slugifyPath, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };

package/dist/index.d.ts

@@ -2,10 +2,10 @@ import { SearchDoc } from './bm25.js';
 export { RankableFields, rankDocs, tokenize } from './bm25.js';
 import { LogLevel, Logger } from '@logtape/logtape';
 
-/** Audience axis — who an article is for. Private is never published. Missing/invalid → 'public'. */
-type Audience = 'public' | 'private';
-/** Lifecycle axis — readiness. Draft is not yet published. Missing/invalid → 'published'. */
-type PublishStatus = 'draft' | 'published';
+/** 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;
@@ -13,6 +13,8 @@ interface CollectionEntry {
     /** 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). */
@@ -29,6 +31,8 @@ interface Config {
     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;
@@ -83,6 +87,11 @@ interface ProjectCollection {
     /** 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
@@ -91,6 +100,7 @@ interface ProjectCollection {
 interface ProjectConfig {
     site?: SiteConfig;
     collections: ProjectCollection[];
+    context?: ProjectContext;
 }
 /** A node in a collection's article tree. Branches have `children`; leaves have `slug`. */
 interface ArticleNode {
@@ -138,9 +148,12 @@ type PluginKind = 'search';
 declare const NATIVE_ENGINE = "native";
 interface QueryOptions {
     engine?: string;
-    collection?: 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;
@@ -373,6 +386,8 @@ declare function readConfig(): Promise<Config>;
 declare function writeConfig(config: Config): Promise<void>;
 declare function setConfigValue(key: string, value: string): Promise<void>;
 declare function getConfigValue(key: string): Promise<string | undefined>;
+/** Whether system-audience content should be shown (config `showSystem` set to true or "true"). */
+declare function showSystemEnabled(): Promise<boolean>;
 
 declare function readRegistry(): Promise<Registry>;
 declare function writeRegistry(registry: Registry): Promise<void>;
@@ -382,6 +397,8 @@ declare function unregisterCollection(name: string): Promise<void>;
 
 /** Turn a title (or a "# Heading" line) into a filesystem-safe slug. */
 declare function slugify(input: string): string;
+/** Slugify a `/`-separated path segment-by-segment, preserving the separators. */
+declare function slugifyPath(input: string): string;
 
 interface ParsedArticle {
     title: string;
@@ -404,7 +421,9 @@ declare function serializeArticle(article: SerializableArticle): string;
 declare function listCollections(): Promise<CollectionEntry[]>;
 declare function findCollection(name: string): Promise<CollectionEntry | undefined>;
 declare function findCollectionById(id: string): Promise<CollectionEntry | undefined>;
-declare function createCollection(name: string): Promise<CollectionEntry>;
+declare function createCollection(name: string, opts?: {
+    audience?: Audience;
+}): Promise<CollectionEntry>;
 /**
  * Remove a collection from the registry. For `global` collections we own the
  * storage, so its directory is deleted too; for `repo` wikis we only deregister
@@ -490,6 +509,8 @@ declare const PROJECT_CONFIG_FILE = "diffwiki.yaml";
  * undefined when the file is absent (ENOENT); parse/other read errors propagate.
  */
 declare function readProjectConfig(dir: string): Promise<ProjectConfig | undefined>;
+/** The `context.collections` list from `diffwiki.yaml`, or `[]` when absent. */
+declare function readContextCollections(dir: string): Promise<string[]>;
 /**
  * Resolve `diffwiki.yaml` collections into registry-shaped CollectionEntry[] with
  * absolute paths (relative to the project root). Empty when no config / no
@@ -565,9 +586,13 @@ declare function fileTimestamps(absPath: string): Promise<FileTimestamps>;
  *  In static builds, private (audience) or draft (status) articles are dropped
  *  entirely (no nav row, and — since routes + per-doc JSON derive from this tree
  *  — no route/JSON). */
-declare function toTreeNodes(coll: string, nodes: ArticleNode[]): TreeNode[];
-declare function buildCollections(): Promise<CollectionInfo[]>;
-declare function buildNavTree(): Promise<CollectionTree[]>;
+declare function toTreeNodes(coll: string, nodes: ArticleNode[], showSystem?: boolean): TreeNode[];
+declare function buildCollections(opts?: {
+    showSystem?: boolean;
+}): Promise<CollectionInfo[]>;
+declare function buildNavTree(opts?: {
+    showSystem?: boolean;
+}): Promise<CollectionTree[]>;
 /**
  * Resolve a route to a rendered doc or a generated directory listing (or null).
  *
@@ -632,16 +657,7 @@ declare function resolveCollectionSelection(all: string[], sel?: CollectionSelec
  * @module
  */
 
-/**
- * Built-in JS-native search: BM25-ranked full-text search over an article's
- * title, body, tags, and collection name -- across every registered collection's
- * ABSOLUTE registry path (so in-repo wikis outside ~/.diffwiki are searched too).
- * No `find`/OS shelling -- cross-platform and dependency-free.
- *
- * When `term` is empty, returns all articles unranked (no score) to preserve
- * the "browse all" behavior.
- */
-declare function nativeSearch(term: string, collections: CollectionEntry[], collection?: string): Promise<QueryHit[]>;
+declare function nativeSearch(term: string, collections: CollectionEntry[], collection?: string | string[], hideSystem?: boolean): Promise<QueryHit[]>;
 /**
  * Resolve the engine + type that `query()` would use when the caller passes no
  * explicit engine/type. Reads cached capabilities from the registry -- no spawn.
@@ -670,18 +686,6 @@ interface SearchOutcome {
     /** The captured failure message from the engine, when it errored. */
     error?: string;
 }
-/**
- * Search articles via the resolved search engine, surfacing engine failures.
- *
- * Routing precedence: explicit `opts.engine` -> `config.defaultSearch` ->
- * first enabled plugin -> native BM25.
- *
- * On ANY engine failure (no provider, or `handleSearch` throws) the error
- * message is CAPTURED, native BM25 is run as a fallback, and the outcome
- * reports `{ fellBackToNative: true, error }`. On success it reports
- * `{ fellBackToNative: false }` with the engine's hits. This lets callers
- * distinguish "the engine broke" from "the engine found nothing".
- */
 declare function search(term: string, opts?: QueryOptions): Promise<SearchOutcome>;
 /**
  * Search articles via the resolved search engine (native fallback on plugin
@@ -715,6 +719,28 @@ declare function buildSearchIndex(collection?: string): Promise<SearchDoc[]>;
 /** Run all diagnostics and return the results. */
 declare function doctor(): Promise<Diagnostic[]>;
 
+type LintLevel = 'error' | 'warn';
+interface LintFinding {
+    level: LintLevel;
+    rule: string;
+    message: string;
+}
+interface LintFileResult {
+    /** `<collection>/<relative-path>` label. */
+    path: string;
+    findings: LintFinding[];
+}
+interface LintResult {
+    files: LintFileResult[];
+    fileCount: number;
+    errorCount: number;
+    warnCount: number;
+}
+/** Stateless rules over a parsed article. */
+declare function lintArticle(article: Pick<ParsedArticle, 'title' | 'tags' | 'status' | 'body'>): LintFinding[];
+/** Lint every article in the resolved scope. `scope` = 'current' | 'all' | 'a,b,c'. */
+declare function lintCollections(scope: string): Promise<LintResult>;
+
 /**
  * Centralized logging for diffwiki host code, built on LogTape.
  *
@@ -1059,4 +1085,4 @@ declare function findEnabledPlugin(kind: PluginKind, name?: string): Promise<Plu
 /** Find a plugin record by name (regardless of enabled state). */
 declare function findPluginRecord(name: string): Promise<PluginRecord | undefined>;
 
-export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type Audience, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type EditTarget, type FileTimestamps, type GraphEdge, type GraphNode, type HomeCard, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, PROJECT_CONFIG_FILE, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type ProjectCollection, type ProjectConfig, type PublishStatus, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type SiteConfig, type SiteCopyright, type SiteHome, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, serializeArticle, setArticleMeta, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type Audience, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type EditTarget, type FileTimestamps, type GraphEdge, type GraphNode, type HomeCard, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type LintFileResult, type LintFinding, type LintLevel, type LintResult, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, PROJECT_CONFIG_FILE, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type ProjectCollection, type ProjectConfig, type ProjectContext, type PublishStatus, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type SiteConfig, type SiteCopyright, type SiteHome, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, lintArticle, lintCollections, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readContextCollections, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, serializeArticle, setArticleMeta, setConfigValue, setTags, showSystemEnabled, slugify, slugifyPath, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };