diffwiki-core 0.10.0 → 0.11.0-rc.202607301244.eb33166

package/dist/index.cjs

@@ -652,6 +652,7 @@ __export(index_exports, {
   search: () => search,
   seedProjectHome: () => seedProjectHome,
   serializeArticle: () => serializeArticle,
+  setArticleMeta: () => setArticleMeta,
   setConfigValue: () => setConfigValue,
   setTags: () => setTags,
   slugify: () => slugify,
@@ -851,7 +852,11 @@ async function createArticle(opts) {
   const body = opts.body ?? `# ${title}
 `;
   await import_promises5.default.mkdir(dir, { recursive: true });
-  await import_promises5.default.writeFile(filePath, serializeArticle({ title, tags: opts.tags, body }), "utf8");
+  await import_promises5.default.writeFile(
+    filePath,
+    serializeArticle({ title, tags: opts.tags, body, audience: opts.audience, status: opts.status }),
+    "utf8"
+  );
   void fireHook2("article-created", name, import_node_path3.default.relative(dir, filePath));
   return { title, tags: opts.tags, path: filePath, collection: name };
 }
@@ -911,6 +916,19 @@ function removeTags(target, tags) {
 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 import_promises5.default.writeFile(
+    filePath,
+    serializeArticle({ title: parsed.title, tags: parsed.tags, audience, status, body: parsed.body }),
+    "utf8"
+  );
+  void fireHook2("article-updated", collection, import_node_path3.default.relative(dir, filePath));
+  return { title: parsed.title, tags: parsed.tags, path: filePath, collection };
+}
 async function removeArticle(target) {
   const { filePath, dir, collection } = await loadArticle(target);
   await import_promises5.default.rm(filePath);
@@ -2611,6 +2629,7 @@ init_registry2();
   search,
   seedProjectHome,
   serializeArticle,
+  setArticleMeta,
   setConfigValue,
   setTags,
   slugify,

package/dist/index.d.cts

@@ -426,11 +426,22 @@ declare function createArticle(opts: {
     target: string;
     tags: string[];
     body?: string;
+    audience?: Audience;
+    status?: PublishStatus;
 }): 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
+ * an axis back to its default cleans it out of the file.
+ */
+declare function setArticleMeta(target: string, meta: {
+    audience?: Audience;
+    status?: PublishStatus;
+}): Promise<Article>;
 declare function removeArticle(target: string): Promise<string>;
 
 declare const REPO_CONFIG_FILE = "diffwiki.yaml";
@@ -1048,4 +1059,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, 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 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 };

package/dist/index.d.ts

@@ -426,11 +426,22 @@ declare function createArticle(opts: {
     target: string;
     tags: string[];
     body?: string;
+    audience?: Audience;
+    status?: PublishStatus;
 }): 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
+ * an axis back to its default cleans it out of the file.
+ */
+declare function setArticleMeta(target: string, meta: {
+    audience?: Audience;
+    status?: PublishStatus;
+}): Promise<Article>;
 declare function removeArticle(target: string): Promise<string>;
 
 declare const REPO_CONFIG_FILE = "diffwiki.yaml";
@@ -1048,4 +1059,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, 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 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 };

package/dist/index.js

@@ -217,7 +217,11 @@ async function createArticle(opts) {
   const body = opts.body ?? `# ${title}
 `;
   await fs2.mkdir(dir, { recursive: true });
-  await fs2.writeFile(filePath, serializeArticle({ title, tags: opts.tags, body }), "utf8");
+  await fs2.writeFile(
+    filePath,
+    serializeArticle({ title, tags: opts.tags, body, audience: opts.audience, status: opts.status }),
+    "utf8"
+  );
   void fireHook("article-created", name, path.relative(dir, filePath));
   return { title, tags: opts.tags, path: filePath, collection: name };
 }
@@ -277,6 +281,19 @@ function removeTags(target, tags) {
 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 fs2.writeFile(
+    filePath,
+    serializeArticle({ title: parsed.title, tags: parsed.tags, audience, status, body: parsed.body }),
+    "utf8"
+  );
+  void fireHook("article-updated", collection, path.relative(dir, filePath));
+  return { title: parsed.title, tags: parsed.tags, path: filePath, collection };
+}
 async function removeArticle(target) {
   const { filePath, dir, collection } = await loadArticle(target);
   await fs2.rm(filePath);
@@ -1857,6 +1874,7 @@ export {
   search,
   seedProjectHome,
   serializeArticle,
+  setArticleMeta,
   setConfigValue,
   setTags,
   slugify,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffwiki-core",
-  "version": "0.10.0",
+  "version": "0.11.0-rc.202607301244.eb33166",
   "description": "Core configuration, registry, and article management for diffwiki",
   "license": "MIT",
   "type": "module",