diffwiki-core 0.17.3 → 0.18.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as Config, R as Registry, a as CollectionEntry, A as Audience, b as Article, P as PublishStatus, c as RepoConfig, d as ProjectConfig, S as SiteConfig, e as CollectionInfo, f as CollectionTree, g as PageData, h as ArticleNode, T as TreeNode, Q as QueryHit, i as QueryOptions, D as Diagnostic, j as ParsedArticle, k as ArticleContent, l as TocItem, L as LinkGraph, m as LocalGraph, n as SearchMode, o as SearchProvider, p as PluginRecord, q as PluginEvent, r as PluginKind, s as PluginRegistryFile } from './frontmatter-ghMCpLNf.cjs';
-export { t as CollectionType, u as DiagnosticLevel, v as DocData, G as GraphEdge, w as GraphNode, H as HomeCard, x as ListingEntry, N as NATIVE_ENGINE, y as NodeMeta, z as PluginCapabilities, B as PluginHealth, E as PluginReadiness, F as ProjectCollection, I as ProjectContext, J as SearchExpansion, K as SerializableArticle, M as SiteCopyright, O as SiteHome, U as parseArticle, V as parseFrontmatter, W as serializeArticle, X as stripFrontmatter } from './frontmatter-ghMCpLNf.cjs';
+import { C as Config, a as CollectionEntry, R as Registry, A as Audience, P as PublishStatus, b as Article, c as RepoConfig, d as ProjectConfig, S as SiteConfig, e as CollectionInfo, f as CollectionTree, g as PageData, h as ArticleNode, T as TreeNode, Q as QueryHit, i as QueryOptions, D as Diagnostic, j as ParsedArticle, k as ArticleContent, l as TocItem, L as LinkGraph, m as LocalGraph, n as SearchMode, o as SearchProvider, p as PluginRecord, q as PluginEvent, r as PluginKind, s as PluginRegistryFile } from './frontmatter-D7gO1fg4.cjs';
+export { t as CollectionType, u as DiagnosticLevel, v as DocData, G as GraphEdge, w as GraphNode, H as HomeCard, x as ListingEntry, N as NATIVE_ENGINE, y as NodeMeta, z as PluginCapabilities, B as PluginHealth, E as PluginReadiness, F as ProjectCollection, I as ProjectContext, J as SearchExpansion, K as SerializableArticle, M as SiteCopyright, O as SiteHome, U as parseArticle, V as parseFrontmatter, W as patchArticle, X as serializeArticle, Y as stripFrontmatter } from './frontmatter-D7gO1fg4.cjs';
 import { SearchDoc } from './bm25.cjs';
 export { RankableFields, rankDocs, tokenize } from './bm25.cjs';
 import { LogLevel, Logger } from '@logtape/logtape';
@@ -42,6 +42,8 @@ declare function configPath(): string;
 declare function collectionsDir(): string;
 /** Where authoring templates live (user-overridable), seeded by `diffwiki templates init`. */
 declare function templatesDir(): string;
+/** Raw source records and per-article source manifests. */
+declare function metaDir(): string;
 declare function collectionDir(name: string): string;
 declare function pluginsDir(): string;
 declare function pluginsRegistryPath(): string;
@@ -80,6 +82,7 @@ interface SeedResult {
 declare function seedTemplates(srcDir: string): Promise<SeedResult>;
 /** The template shape names bundled at `srcDir`, e.g. `['guide', 'recipe', …]`. */
 declare function listTemplateShapes(srcDir: string): Promise<string[]>;
+type TemplateCategory = 'article' | 'meta';
 /** A template's self-describing metadata, read from its frontmatter. */
 interface TemplateInfo {
     /** The shape id (frontmatter `shape:`, else the filename stem). */
@@ -90,6 +93,9 @@ interface TemplateInfo {
     budget?: [number, number];
     /** The template file name. */
     file: string;
+    /** Effective user override or bundled file. */
+    path: string;
+    category: TemplateCategory;
 }
 /**
  * List the templates bundled at `srcDir` with their self-describing metadata
@@ -98,7 +104,7 @@ interface TemplateInfo {
  * hard-coding shape names, so dropping in a template with frontmatter
  * makes it discoverable. Falls back to the filename stem when `shape:` is absent.
  */
-declare function listTemplates(srcDir: string): Promise<TemplateInfo[]>;
+declare function listTemplates(srcDir: string, category?: TemplateCategory | 'all'): Promise<TemplateInfo[]>;
 
 declare function readConfig(): Promise<Config>;
 declare function writeConfig(config: Config): Promise<void>;
@@ -107,6 +113,34 @@ 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>;
 
+type MetaKind = (typeof META_KINDS)[number];
+type Collection = Pick<CollectionEntry, 'name' | 'path'>;
+interface MetaResult {
+    created: string[];
+    kept: string[];
+    index_paths: string[];
+    warnings: string[];
+    errors: string[];
+}
+interface MetaRecordResult {
+    id: string;
+    path: string;
+    target: string;
+    mirror_path?: string;
+    index_paths: string[];
+}
+declare const META_KINDS: readonly ["history", "external-source-extract", "dream-learning"];
+/** Exact file identity; unlike article titles, this must never be slugified. */
+declare function validateMetaArticlePath(file: string): string;
+declare function ensureCollectionMeta(entry: Collection): Promise<string>;
+declare function ensureArticleMeta(entry: Collection, articlePath: string): Promise<string>;
+/** A successful article write must remain visible when its mirror cannot be saved. */
+declare function mirrorSavedArticle(entry: Collection, file: string): Promise<void>;
+/** Rebuild only generated listings. Raw records are ordinary user-editable files. */
+declare function reindexMeta(collection?: string): Promise<MetaResult>;
+declare function initMeta(entries: Collection[]): Promise<MetaResult>;
+declare function createMetaRecord(entry: Collection, articlePath: string | undefined, kind: MetaKind, body: string): Promise<MetaRecordResult>;
+
 declare function readRegistry(): Promise<Registry>;
 declare function writeRegistry(registry: Registry): Promise<void>;
 /** Insert or replace the entry with the same name. */
@@ -148,13 +182,22 @@ declare function createArticle(opts: {
     audience?: Audience;
     status?: PublishStatus;
 }): Promise<Article>;
+interface ArticleUpdates {
+    title?: string;
+    body?: string;
+    tags?: string[];
+    audience?: Audience;
+    status?: PublishStatus;
+}
+/** Compose requested edits once so title/body/meta combinations retain unrelated fields. */
+declare function updateArticle(target: string, updates: ArticleUpdates): Promise<Article>;
 declare function updateArticleBody(target: string, body: string): Promise<Article>;
 declare function addTags(target: string, tags: string[]): Promise<Article>;
 declare function removeTags(target: string, tags: string[]): Promise<Article>;
 declare function setTags(target: string, tags: string[]): Promise<Article>;
 /**
  * Set an article's audience and/or status. Unspecified axes are left as-is; the
- * serializer drops frontmatter for default values (public/published), so setting
+ * writer drops frontmatter for default values (public/published), so setting
  * an axis back to its default cleans it out of the file.
  */
 declare function setArticleMeta(target: string, meta: {
@@ -803,4 +846,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, Article, ArticleContent, ArticleNode, ArticleNotFoundError, Audience, CollectionAlreadyAddedError, CollectionEntry, CollectionExistsError, type CollectionGitStatus, CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, CollectionTree, Config, Diagnostic, DiffwikiError, type DiffwikiLogLevel, type EditTarget, type FileTimestamps, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, LinkGraph, type LintFileResult, type LintFinding, type LintLevel, type LintResult, LocalGraph, NoDefaultCollectionError, PROJECT_CONFIG_FILE, PageData, ParsedArticle, PluginError, PluginEvent, PluginKind, PluginRecord, PluginRegistryFile, ProjectConfig, PublishStatus, QueryHit, QueryOptions, REPO_CONFIG_FILE, Registry, type RenderContext, type RenderedArticle, RepoConfig, SearchDoc, SearchMode, type SearchOutcome, SearchProvider, type SeedResult, type SetupOutcome, type SetupStep, SiteConfig, type TemplateInfo, TocItem, TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensureHome, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, lintArticle, lintCollections, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, listTemplateShapes, listTemplates, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readContextCollections, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repairPlugins, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, seedTemplates, setArticleMeta, setConfigValue, setContextCollections, setTags, showSystemEnabled, slugify, slugifyPath, templatesDir, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, Article, ArticleContent, ArticleNode, ArticleNotFoundError, type ArticleUpdates, Audience, CollectionAlreadyAddedError, CollectionEntry, CollectionExistsError, type CollectionGitStatus, CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, CollectionTree, Config, Diagnostic, DiffwikiError, type DiffwikiLogLevel, type EditTarget, type FileTimestamps, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, LinkGraph, type LintFileResult, type LintFinding, type LintLevel, type LintResult, LocalGraph, META_KINDS, type MetaKind, type MetaRecordResult, type MetaResult, NoDefaultCollectionError, PROJECT_CONFIG_FILE, PageData, ParsedArticle, PluginError, PluginEvent, PluginKind, PluginRecord, PluginRegistryFile, ProjectConfig, PublishStatus, QueryHit, QueryOptions, REPO_CONFIG_FILE, Registry, type RenderContext, type RenderedArticle, RepoConfig, SearchDoc, SearchMode, type SearchOutcome, SearchProvider, type SeedResult, type SetupOutcome, type SetupStep, SiteConfig, type TemplateCategory, type TemplateInfo, TocItem, TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, createMetaRecord, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureArticleMeta, ensureCollectionMeta, ensureGitRepo, ensureHome, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initMeta, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, lintArticle, lintCollections, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, listTemplateShapes, listTemplates, loadSearchProvider, localGraph, metaDir, mirrorSavedArticle, nativeSearch, parseAddTarget, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readContextCollections, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, reindexMeta, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repairPlugins, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, seedTemplates, setArticleMeta, setConfigValue, setContextCollections, setTags, showSystemEnabled, slugify, slugifyPath, templatesDir, toTreeNodes, unregisterCollection, updateArticle, updateArticleBody, upsertPlugin, upstreamStatus, validateMetaArticlePath, writeConfig, writePluginRegistry, writeRegistry };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as Config, R as Registry, a as CollectionEntry, A as Audience, b as Article, P as PublishStatus, c as RepoConfig, d as ProjectConfig, S as SiteConfig, e as CollectionInfo, f as CollectionTree, g as PageData, h as ArticleNode, T as TreeNode, Q as QueryHit, i as QueryOptions, D as Diagnostic, j as ParsedArticle, k as ArticleContent, l as TocItem, L as LinkGraph, m as LocalGraph, n as SearchMode, o as SearchProvider, p as PluginRecord, q as PluginEvent, r as PluginKind, s as PluginRegistryFile } from './frontmatter-ghMCpLNf.js';
-export { t as CollectionType, u as DiagnosticLevel, v as DocData, G as GraphEdge, w as GraphNode, H as HomeCard, x as ListingEntry, N as NATIVE_ENGINE, y as NodeMeta, z as PluginCapabilities, B as PluginHealth, E as PluginReadiness, F as ProjectCollection, I as ProjectContext, J as SearchExpansion, K as SerializableArticle, M as SiteCopyright, O as SiteHome, U as parseArticle, V as parseFrontmatter, W as serializeArticle, X as stripFrontmatter } from './frontmatter-ghMCpLNf.js';
+import { C as Config, a as CollectionEntry, R as Registry, A as Audience, P as PublishStatus, b as Article, c as RepoConfig, d as ProjectConfig, S as SiteConfig, e as CollectionInfo, f as CollectionTree, g as PageData, h as ArticleNode, T as TreeNode, Q as QueryHit, i as QueryOptions, D as Diagnostic, j as ParsedArticle, k as ArticleContent, l as TocItem, L as LinkGraph, m as LocalGraph, n as SearchMode, o as SearchProvider, p as PluginRecord, q as PluginEvent, r as PluginKind, s as PluginRegistryFile } from './frontmatter-D7gO1fg4.js';
+export { t as CollectionType, u as DiagnosticLevel, v as DocData, G as GraphEdge, w as GraphNode, H as HomeCard, x as ListingEntry, N as NATIVE_ENGINE, y as NodeMeta, z as PluginCapabilities, B as PluginHealth, E as PluginReadiness, F as ProjectCollection, I as ProjectContext, J as SearchExpansion, K as SerializableArticle, M as SiteCopyright, O as SiteHome, U as parseArticle, V as parseFrontmatter, W as patchArticle, X as serializeArticle, Y as stripFrontmatter } from './frontmatter-D7gO1fg4.js';
 import { SearchDoc } from './bm25.js';
 export { RankableFields, rankDocs, tokenize } from './bm25.js';
 import { LogLevel, Logger } from '@logtape/logtape';
@@ -42,6 +42,8 @@ declare function configPath(): string;
 declare function collectionsDir(): string;
 /** Where authoring templates live (user-overridable), seeded by `diffwiki templates init`. */
 declare function templatesDir(): string;
+/** Raw source records and per-article source manifests. */
+declare function metaDir(): string;
 declare function collectionDir(name: string): string;
 declare function pluginsDir(): string;
 declare function pluginsRegistryPath(): string;
@@ -80,6 +82,7 @@ interface SeedResult {
 declare function seedTemplates(srcDir: string): Promise<SeedResult>;
 /** The template shape names bundled at `srcDir`, e.g. `['guide', 'recipe', …]`. */
 declare function listTemplateShapes(srcDir: string): Promise<string[]>;
+type TemplateCategory = 'article' | 'meta';
 /** A template's self-describing metadata, read from its frontmatter. */
 interface TemplateInfo {
     /** The shape id (frontmatter `shape:`, else the filename stem). */
@@ -90,6 +93,9 @@ interface TemplateInfo {
     budget?: [number, number];
     /** The template file name. */
     file: string;
+    /** Effective user override or bundled file. */
+    path: string;
+    category: TemplateCategory;
 }
 /**
  * List the templates bundled at `srcDir` with their self-describing metadata
@@ -98,7 +104,7 @@ interface TemplateInfo {
  * hard-coding shape names, so dropping in a template with frontmatter
  * makes it discoverable. Falls back to the filename stem when `shape:` is absent.
  */
-declare function listTemplates(srcDir: string): Promise<TemplateInfo[]>;
+declare function listTemplates(srcDir: string, category?: TemplateCategory | 'all'): Promise<TemplateInfo[]>;
 
 declare function readConfig(): Promise<Config>;
 declare function writeConfig(config: Config): Promise<void>;
@@ -107,6 +113,34 @@ 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>;
 
+type MetaKind = (typeof META_KINDS)[number];
+type Collection = Pick<CollectionEntry, 'name' | 'path'>;
+interface MetaResult {
+    created: string[];
+    kept: string[];
+    index_paths: string[];
+    warnings: string[];
+    errors: string[];
+}
+interface MetaRecordResult {
+    id: string;
+    path: string;
+    target: string;
+    mirror_path?: string;
+    index_paths: string[];
+}
+declare const META_KINDS: readonly ["history", "external-source-extract", "dream-learning"];
+/** Exact file identity; unlike article titles, this must never be slugified. */
+declare function validateMetaArticlePath(file: string): string;
+declare function ensureCollectionMeta(entry: Collection): Promise<string>;
+declare function ensureArticleMeta(entry: Collection, articlePath: string): Promise<string>;
+/** A successful article write must remain visible when its mirror cannot be saved. */
+declare function mirrorSavedArticle(entry: Collection, file: string): Promise<void>;
+/** Rebuild only generated listings. Raw records are ordinary user-editable files. */
+declare function reindexMeta(collection?: string): Promise<MetaResult>;
+declare function initMeta(entries: Collection[]): Promise<MetaResult>;
+declare function createMetaRecord(entry: Collection, articlePath: string | undefined, kind: MetaKind, body: string): Promise<MetaRecordResult>;
+
 declare function readRegistry(): Promise<Registry>;
 declare function writeRegistry(registry: Registry): Promise<void>;
 /** Insert or replace the entry with the same name. */
@@ -148,13 +182,22 @@ declare function createArticle(opts: {
     audience?: Audience;
     status?: PublishStatus;
 }): Promise<Article>;
+interface ArticleUpdates {
+    title?: string;
+    body?: string;
+    tags?: string[];
+    audience?: Audience;
+    status?: PublishStatus;
+}
+/** Compose requested edits once so title/body/meta combinations retain unrelated fields. */
+declare function updateArticle(target: string, updates: ArticleUpdates): Promise<Article>;
 declare function updateArticleBody(target: string, body: string): Promise<Article>;
 declare function addTags(target: string, tags: string[]): Promise<Article>;
 declare function removeTags(target: string, tags: string[]): Promise<Article>;
 declare function setTags(target: string, tags: string[]): Promise<Article>;
 /**
  * Set an article's audience and/or status. Unspecified axes are left as-is; the
- * serializer drops frontmatter for default values (public/published), so setting
+ * writer drops frontmatter for default values (public/published), so setting
  * an axis back to its default cleans it out of the file.
  */
 declare function setArticleMeta(target: string, meta: {
@@ -803,4 +846,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, Article, ArticleContent, ArticleNode, ArticleNotFoundError, Audience, CollectionAlreadyAddedError, CollectionEntry, CollectionExistsError, type CollectionGitStatus, CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, CollectionTree, Config, Diagnostic, DiffwikiError, type DiffwikiLogLevel, type EditTarget, type FileTimestamps, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, LinkGraph, type LintFileResult, type LintFinding, type LintLevel, type LintResult, LocalGraph, NoDefaultCollectionError, PROJECT_CONFIG_FILE, PageData, ParsedArticle, PluginError, PluginEvent, PluginKind, PluginRecord, PluginRegistryFile, ProjectConfig, PublishStatus, QueryHit, QueryOptions, REPO_CONFIG_FILE, Registry, type RenderContext, type RenderedArticle, RepoConfig, SearchDoc, SearchMode, type SearchOutcome, SearchProvider, type SeedResult, type SetupOutcome, type SetupStep, SiteConfig, type TemplateInfo, TocItem, TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensureHome, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, lintArticle, lintCollections, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, listTemplateShapes, listTemplates, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readContextCollections, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repairPlugins, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, seedTemplates, setArticleMeta, setConfigValue, setContextCollections, setTags, showSystemEnabled, slugify, slugifyPath, templatesDir, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, Article, ArticleContent, ArticleNode, ArticleNotFoundError, type ArticleUpdates, Audience, CollectionAlreadyAddedError, CollectionEntry, CollectionExistsError, type CollectionGitStatus, CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, CollectionTree, Config, Diagnostic, DiffwikiError, type DiffwikiLogLevel, type EditTarget, type FileTimestamps, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, LinkGraph, type LintFileResult, type LintFinding, type LintLevel, type LintResult, LocalGraph, META_KINDS, type MetaKind, type MetaRecordResult, type MetaResult, NoDefaultCollectionError, PROJECT_CONFIG_FILE, PageData, ParsedArticle, PluginError, PluginEvent, PluginKind, PluginRecord, PluginRegistryFile, ProjectConfig, PublishStatus, QueryHit, QueryOptions, REPO_CONFIG_FILE, Registry, type RenderContext, type RenderedArticle, RepoConfig, SearchDoc, SearchMode, type SearchOutcome, SearchProvider, type SeedResult, type SetupOutcome, type SetupStep, SiteConfig, type TemplateCategory, type TemplateInfo, TocItem, TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSiteConfig, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, createMetaRecord, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureArticleMeta, ensureCollectionMeta, ensureGitRepo, ensureHome, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initMeta, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, lintArticle, lintCollections, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, listTemplateShapes, listTemplates, loadSearchProvider, localGraph, metaDir, mirrorSavedArticle, nativeSearch, parseAddTarget, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readContextCollections, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, reindexMeta, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repairPlugins, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveEditTarget, resolveEditorCommand, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, seedTemplates, setArticleMeta, setConfigValue, setContextCollections, setTags, showSystemEnabled, slugify, slugifyPath, templatesDir, toTreeNodes, unregisterCollection, updateArticle, updateArticleBody, upsertPlugin, upstreamStatus, validateMetaArticlePath, writeConfig, writePluginRegistry, writeRegistry };

package/dist/index.js

@@ -5,54 +5,66 @@ import {
 import {
   parseArticle,
   parseFrontmatter,
+  patchArticle,
   runProcess,
   serializeArticle,
   stripFrontmatter
-} from "./chunk-6MW6KSS4.js";
+} from "./chunk-NLBHSMHA.js";
 import {
-  ArticleNotFoundError,
-  CollectionAlreadyAddedError,
-  CollectionExistsError,
-  CollectionNotFoundError,
-  DiffwikiError,
-  InvalidExportSelectionError,
-  InvalidTargetError,
   LONG_TIMEOUT_MS,
+  META_KINDS,
   NATIVE_ENGINE,
-  NoDefaultCollectionError,
-  PluginError,
-  WorktreeNotAllowedError,
   collectionDir,
   collectionsDir,
   configPath,
   createCollection,
+  createMetaRecord,
   deregisterPlugin,
   emitPluginEvent,
+  ensureArticleMeta,
+  ensureCollectionMeta,
   findCollection,
   findCollectionById,
   findEnabledPlugin,
   findPluginRecord,
   getLogger,
+  initMeta,
   invokePlugin,
   listCollections,
   listEnabledPlugins,
   listSearchModes,
   loadSearchProvider,
+  metaDir,
+  mirrorSavedArticle,
   pluginsDir,
   pluginsRegistryPath,
   readPluginRegistry,
   readRegistry,
   registerCollection,
   registryPath,
+  reindexMeta,
   removeCollection,
   resolveHome,
   resolveLogLevel,
   templatesDir,
   unregisterCollection,
   upsertPlugin,
+  validateMetaArticlePath,
   writePluginRegistry,
   writeRegistry
-} from "./chunk-TXM4OGBA.js";
+} from "./chunk-KUX7GHHM.js";
+import {
+  ArticleNotFoundError,
+  CollectionAlreadyAddedError,
+  CollectionExistsError,
+  CollectionNotFoundError,
+  DiffwikiError,
+  InvalidExportSelectionError,
+  InvalidTargetError,
+  NoDefaultCollectionError,
+  PluginError,
+  WorktreeNotAllowedError
+} from "./chunk-FJ5XD2JN.js";
 
 // src/home.ts
 import fs from "fs/promises";
@@ -98,22 +110,34 @@ async function seedTemplates(srcDir) {
   return { seeded, skipped, dir };
 }
 async function listTemplateShapes(srcDir) {
-  const files = await fs2.readdir(srcDir);
-  return files.filter((f) => f.endsWith("-template.md")).map((f) => f.replace(/-template\.md$/, "")).sort();
+  return (await listTemplates(srcDir)).map((info) => info.shape).sort();
 }
-async function listTemplates(srcDir) {
-  const files = (await fs2.readdir(srcDir)).filter((f) => f.endsWith("-template.md")).sort();
+async function listTemplates(srcDir, category = "article") {
+  const files = /* @__PURE__ */ new Map();
+  for (const dir of [srcDir, templatesDir()]) {
+    let names;
+    try {
+      names = await fs2.readdir(dir);
+    } catch (err) {
+      if (err.code === "ENOENT") continue;
+      throw err;
+    }
+    for (const name of names.filter((name2) => name2.endsWith("-template.md")).sort())
+      files.set(name, path.resolve(dir, name));
+  }
   const out = [];
-  for (const file of files) {
+  for (const [file, filePath] of [...files].sort(([a], [b]) => a.localeCompare(b))) {
     let data = {};
     try {
-      ({ data } = parseFrontmatter(await fs2.readFile(path.join(srcDir, file), "utf8")));
+      ({ data } = parseFrontmatter(await fs2.readFile(filePath, "utf8")));
     } catch {
     }
     const shape = typeof data.shape === "string" && data.shape ? data.shape : file.replace(/-template\.md$/, "");
     const purpose = typeof data.purpose === "string" ? data.purpose : "";
     const budget = Array.isArray(data.budget) && data.budget.length === 2 ? [Number(data.budget[0]), Number(data.budget[1])] : void 0;
-    out.push({ shape, purpose, budget, file });
+    const templateCategory = data.category === "meta" ? "meta" : "article";
+    if (category === "all" || category === templateCategory)
+      out.push({ shape, purpose, budget, file, path: filePath, category: templateCategory });
   }
   return out;
 }
@@ -180,7 +204,7 @@ import fs4 from "fs/promises";
 import path2 from "path";
 async function fireHook(event, collection, relPath) {
   try {
-    const { emitPluginEvent: emitPluginEvent2 } = await import("./events-K3MKWACA.js");
+    const { emitPluginEvent: emitPluginEvent2 } = await import("./events-UG4JPZDZ.js");
     await emitPluginEvent2(event, collection, relPath);
   } catch {
   }
@@ -232,12 +256,13 @@ async function createArticle(opts) {
     "utf8"
   );
   void fireHook("article-created", name, path2.relative(dir, filePath));
+  await mirrorSavedArticle({ name, path: dir }, filePath);
   return { title, tags: opts.tags, path: filePath, collection: name };
 }
 async function loadArticle(target) {
   const { collection, file } = parsePathTarget(target);
   const { dir } = await resolveCollectionDir(collection);
-  const filePath = path2.join(dir, ensureMdPath(file));
+  const filePath = path2.join(dir, validateMetaArticlePath(ensureMdPath(file)));
   try {
     return { filePath, dir, raw: await fs4.readFile(filePath, "utf8"), collection };
   } catch (err) {
@@ -245,40 +270,29 @@ async function loadArticle(target) {
     throw err;
   }
 }
-async function updateArticleBody(target, body) {
+async function updateArticle(target, updates) {
   const { filePath, dir, raw, collection } = await loadArticle(target);
-  const parsed = parseArticle(raw);
-  await fs4.writeFile(
-    filePath,
-    serializeArticle({
-      title: parsed.title,
-      tags: parsed.tags,
-      audience: parsed.audience,
-      status: parsed.status,
-      body
-    }),
-    "utf8"
-  );
+  if (updates.title !== void 0 && !updates.title.trim())
+    throw new InvalidTargetError(updates.title, "title cannot be empty");
+  const fields = {};
+  if (updates.title !== void 0) fields.title = updates.title;
+  if (updates.tags !== void 0) fields.tags = Array.from(new Set(updates.tags));
+  if (updates.audience !== void 0) fields.audience = updates.audience === "public" ? void 0 : updates.audience;
+  if (updates.status !== void 0) fields.status = updates.status === "published" ? void 0 : updates.status;
+  const next = patchArticle(raw, fields, updates.body);
+  await fs4.writeFile(filePath, next, "utf8");
+  const parsed = parseArticle(next);
   void fireHook("article-updated", collection, path2.relative(dir, filePath));
+  await mirrorSavedArticle({ name: collection, path: dir }, filePath);
   return { title: parsed.title, tags: parsed.tags, path: filePath, collection };
 }
+function updateArticleBody(target, body) {
+  return updateArticle(target, { body });
+}
 async function mutateTags(target, fn) {
-  const { filePath, dir, raw, collection } = await loadArticle(target);
+  const { raw } = await loadArticle(target);
   const parsed = parseArticle(raw);
-  const tags = fn(parsed.tags);
-  await fs4.writeFile(
-    filePath,
-    serializeArticle({
-      title: parsed.title,
-      tags,
-      audience: parsed.audience,
-      status: parsed.status,
-      body: parsed.body
-    }),
-    "utf8"
-  );
-  void fireHook("article-updated", collection, path2.relative(dir, filePath));
-  return { title: parsed.title, tags, path: filePath, collection };
+  return updateArticle(target, { tags: fn(parsed.tags) });
 }
 function addTags(target, tags) {
   return mutateTags(target, (current) => Array.from(/* @__PURE__ */ new Set([...current, ...tags])));
@@ -291,17 +305,7 @@ function setTags(target, tags) {
   return mutateTags(target, () => Array.from(new Set(tags)));
 }
 async function setArticleMeta(target, meta) {
-  const { filePath, dir, raw, collection } = await loadArticle(target);
-  const parsed = parseArticle(raw);
-  const audience = meta.audience ?? parsed.audience;
-  const status = meta.status ?? parsed.status;
-  await fs4.writeFile(
-    filePath,
-    serializeArticle({ title: parsed.title, tags: parsed.tags, audience, status, body: parsed.body }),
-    "utf8"
-  );
-  void fireHook("article-updated", collection, path2.relative(dir, filePath));
-  return { title: parsed.title, tags: parsed.tags, path: filePath, collection };
+  return updateArticle(target, meta);
 }
 async function removeArticle(target) {
   const { filePath, dir, collection } = await loadArticle(target);
@@ -2023,6 +2027,7 @@ export {
   DiffwikiError,
   InvalidExportSelectionError,
   InvalidTargetError,
+  META_KINDS,
   NATIVE_ENGINE,
   NoDefaultCollectionError,
   PROJECT_CONFIG_FILE,
@@ -2044,10 +2049,13 @@ export {
   configPath,
   createArticle,
   createCollection,
+  createMetaRecord,
   currentBranch,
   deregisterPlugin,
   doctor,
   emitPluginEvent,
+  ensureArticleMeta,
+  ensureCollectionMeta,
   ensureGitRepo,
   ensureHome,
   ensurePluginRoot,
@@ -2059,6 +2067,7 @@ export {
   getConfigValue,
   getLogger,
   gitToplevel,
+  initMeta,
   initRepoWiki,
   installPlugin,
   invalidateLinkGraph,
@@ -2075,11 +2084,14 @@ export {
   listTemplates,
   loadSearchProvider,
   localGraph,
+  metaDir,
+  mirrorSavedArticle,
   nativeSearch,
   parseAddTarget,
   parseArticle,
   parseFrontmatter,
   parsePathTarget,
+  patchArticle,
   pluginsDir,
   pluginsRegistryPath,
   query,
@@ -2095,6 +2107,7 @@ export {
   registerCollection,
   registerPlugin,
   registryPath,
+  reindexMeta,
   removeArticle,
   removeCollection,
   removePlugin,
@@ -2128,9 +2141,11 @@ export {
   toTreeNodes,
   tokenize,
   unregisterCollection,
+  updateArticle,
   updateArticleBody,
   upsertPlugin,
   upstreamStatus,
+  validateMetaArticlePath,
   writeConfig,
   writePluginRegistry,
   writeRegistry

package/dist/plugin.cjs

@@ -53,7 +53,7 @@ var import_gray_matter = __toESM(require("gray-matter"), 1);
 var import_yaml = require("yaml");
 var YAML_ENGINE = {
   parse: (input) => {
-    const data = (0, import_yaml.parse)(input);
+    const data = (0, import_yaml.parse)(input.replace(/\r\n?/g, "\n"));
     return data && typeof data === "object" ? data : {};
   },
   stringify: (data) => (0, import_yaml.stringify)(data)

package/dist/plugin.d.cts

@@ -1,5 +1,5 @@
-import { Y as PluginDefinition, Z as DefinedPlugin, _ as PluginDependency, $ as ResolvedDependency, a0 as RunProcessOptions } from './frontmatter-ghMCpLNf.cjs';
-export { a1 as EventHandlerResult, a2 as EventParams, a3 as HealthHandlerResult, a4 as HealthParams, a5 as IndexHandlerResult, a6 as IndexParams, a7 as LogLevel, j as ParsedArticle, a8 as PluginCapabilities, a9 as PluginHandlers, aa as PluginLogFn, J as SearchExpansion, ab as SearchHandlerHit, ac as SearchHandlerResult, ad as SearchParams, ae as SetupHandlerResult, af as SetupParams, ag as WireCollection, ah as WireDiagnostic, ai as WireReadiness, U as parseArticle, X as stripFrontmatter } from './frontmatter-ghMCpLNf.cjs';
+import { Z as PluginDefinition, _ as DefinedPlugin, $ as PluginDependency, a0 as ResolvedDependency, a1 as RunProcessOptions } from './frontmatter-D7gO1fg4.cjs';
+export { a2 as EventHandlerResult, a3 as EventParams, a4 as HealthHandlerResult, a5 as HealthParams, a6 as IndexHandlerResult, a7 as IndexParams, a8 as LogLevel, j as ParsedArticle, a9 as PluginCapabilities, aa as PluginHandlers, ab as PluginLogFn, J as SearchExpansion, ac as SearchHandlerHit, ad as SearchHandlerResult, ae as SearchParams, af as SetupHandlerResult, ag as SetupParams, ah as WireCollection, ai as WireDiagnostic, aj as WireReadiness, U as parseArticle, Y as stripFrontmatter } from './frontmatter-D7gO1fg4.cjs';
 
 /**
  * diffwiki plugin authoring SDK — the public surface for plugin authors, imported

package/dist/plugin.d.ts

@@ -1,5 +1,5 @@
-import { Y as PluginDefinition, Z as DefinedPlugin, _ as PluginDependency, $ as ResolvedDependency, a0 as RunProcessOptions } from './frontmatter-ghMCpLNf.js';
-export { a1 as EventHandlerResult, a2 as EventParams, a3 as HealthHandlerResult, a4 as HealthParams, a5 as IndexHandlerResult, a6 as IndexParams, a7 as LogLevel, j as ParsedArticle, a8 as PluginCapabilities, a9 as PluginHandlers, aa as PluginLogFn, J as SearchExpansion, ab as SearchHandlerHit, ac as SearchHandlerResult, ad as SearchParams, ae as SetupHandlerResult, af as SetupParams, ag as WireCollection, ah as WireDiagnostic, ai as WireReadiness, U as parseArticle, X as stripFrontmatter } from './frontmatter-ghMCpLNf.js';
+import { Z as PluginDefinition, _ as DefinedPlugin, $ as PluginDependency, a0 as ResolvedDependency, a1 as RunProcessOptions } from './frontmatter-D7gO1fg4.js';
+export { a2 as EventHandlerResult, a3 as EventParams, a4 as HealthHandlerResult, a5 as HealthParams, a6 as IndexHandlerResult, a7 as IndexParams, a8 as LogLevel, j as ParsedArticle, a9 as PluginCapabilities, aa as PluginHandlers, ab as PluginLogFn, J as SearchExpansion, ac as SearchHandlerHit, ad as SearchHandlerResult, ae as SearchParams, af as SetupHandlerResult, ag as SetupParams, ah as WireCollection, ai as WireDiagnostic, aj as WireReadiness, U as parseArticle, Y as stripFrontmatter } from './frontmatter-D7gO1fg4.js';
 
 /**
  * diffwiki plugin authoring SDK — the public surface for plugin authors, imported

package/dist/plugin.js

@@ -7,7 +7,8 @@ import {
   runProcess,
   runProcessJson,
   stripFrontmatter
-} from "./chunk-6MW6KSS4.js";
+} from "./chunk-NLBHSMHA.js";
+import "./chunk-FJ5XD2JN.js";
 export {
   commandExists,
   definePlugin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffwiki-core",
-  "version": "0.17.3",
+  "version": "0.18.0",
   "description": "Core configuration, registry, and article management for diffwiki",
   "license": "MIT",
   "type": "module",

package/dist/events-K3MKWACA.js

@@ -1,6 +0,0 @@
-import {
-  emitPluginEvent
-} from "./chunk-TXM4OGBA.js";
-export {
-  emitPluginEvent
-};