@farming-labs/docs 0.1.119 → 0.1.120

package/dist/server.mjs

@@ -1,6 +1,7 @@
 import { A as resolveDocsAnalyticsConfig, D as emitDocsAgentTraceEvent, E as createDocsAgentTraceId, M as createDocsCloudAnalytics, O as emitDocsAnalyticsEvent, T as createDocsAgentTraceContext, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, j as resolveDocsObservabilityConfig, k as emitDocsObservabilityEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, w as DOCS_AGENT_TRACE_EVENT_TYPES } from "./search-BL7o2rXk.mjs";
 import { a as buildDocsSitemapManifest, c as renderDocsSitemapMarkdown, d as resolveDocsSitemapPageLastmod, f as resolveDocsSitemapRequest, i as DEFAULT_SITEMAP_XML_ROUTE, l as renderDocsSitemapXml, n as DEFAULT_SITEMAP_MD_ROUTE, o as createDocsSitemapResponse, p as toDocsSitemapMarkdownUrl, r as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, s as readDocsSitemapManifestFromContentMap, t as DEFAULT_SITEMAP_MANIFEST_PATH, u as resolveDocsSitemapConfig } from "./sitemap-CnqcTdQg.mjs";
 import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-DdHzJorR.mjs";
+import { a as ensureDocsReviewWorkflow, i as buildDocsReviewWorkflowPathFilters, n as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, o as readDocsReviewConfigFromSource, r as buildDocsReviewWorkflow, s as resolveDocsReviewConfig, t as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD } from "./review-_5fnI667.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
-export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
+export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/{sitemap-mqWvYODL.mjs → sitemap-CXwYOIIb.mjs}

@@ -3,8 +3,8 @@ import { a as buildDocsSitemapManifest, c as renderDocsSitemapMarkdown, l as ren
 import "./sitemap-server-DdHzJorR.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-Cio3byUJ.mjs";
-import { t as detectFramework } from "./utils-TPe8H1P-.mjs";
+import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-BHRL4R2v.mjs";
+import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{types-Dts3a32G.d.mts → types-DtBNjsk2.d.mts}

@@ -2032,6 +2032,88 @@ interface DocsAgentConfig {
    */
   compact?: DocsAgentCompactConfig;
 }
+type DocsReviewSeverity = "off" | "suggestion" | "warn" | "error";
+type DocsReviewCiMode = "off" | "warn" | "block";
+interface DocsReviewRulesConfig {
+  /** Check internal markdown/docs links. */
+  brokenLinks?: DocsReviewSeverity;
+  /** Check required page frontmatter such as title and description. */
+  frontmatter?: DocsReviewSeverity;
+  /** Check duplicate docs slugs in the resolved docs tree. */
+  duplicateSlugs?: DocsReviewSeverity;
+  /** Check whether changed markdown/MDX files can be parsed. */
+  invalidMdx?: DocsReviewSeverity;
+  /** Check docs.config examples against known config options when possible. */
+  configExamples?: DocsReviewSeverity;
+  /** Check code fences for useful metadata such as title and framework. */
+  codeFenceMetadata?: DocsReviewSeverity;
+  /** Check runnable command/code fences for package manager context. */
+  runnableMetadata?: DocsReviewSeverity;
+  /** Suggest machine-facing context for implementation-heavy pages. */
+  agentContext?: DocsReviewSeverity;
+}
+interface DocsReviewScoreConfig {
+  /**
+   * Minimum healthy score.
+   * CI reports the threshold in warn mode and blocks below it only when `ci.mode` is `"block"`.
+   *
+   * @default 80
+   */
+  threshold?: number;
+  /**
+   * Point deductions by finding severity.
+   *
+   * @default { error: 20, warn: 8, suggestion: 2 }
+   */
+  weights?: Partial<Record<"error" | "warn" | "suggestion", number>>;
+}
+interface DocsReviewCiConfig {
+  /**
+   * Enable Docs Review CI workflow generation.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * How CI should treat unhealthy review results.
+   *
+   * - `"off"`: do not create/report CI output
+   * - `"warn"`: report annotations but pass CI
+   * - `"block"`: fail CI when errors exist or the score is below threshold
+   *
+   * @default "warn"
+   */
+  mode?: DocsReviewCiMode;
+  /**
+   * Emit GitHub workflow command annotations in CI.
+   *
+   * @default true
+   */
+  annotations?: boolean;
+  /**
+   * Reserved for GitHub PR comments from the official action/bot.
+   *
+   * @default true
+   */
+  comment?: boolean;
+}
+interface DocsReviewConfig {
+  /**
+   * Enable Docs Review.
+   *
+   * Omitted review config is treated as enabled so docs sites get PR review CI by default.
+   * Set `review: false` to opt out.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /** Score threshold and severity weights. */
+  score?: DocsReviewScoreConfig;
+  /** GitHub Actions behavior. */
+  ci?: boolean | DocsReviewCiConfig;
+  /** Optional rule severity overrides. */
+  rules?: DocsReviewRulesConfig;
+}
 interface DocsConfig {
   /** Entry folder for docs (e.g. "docs" → /docs) */
   entry: string;
@@ -2476,10 +2558,26 @@ interface DocsConfig {
    * Agent-oriented configuration, including defaults for `docs agent compact`.
    */
   agent?: DocsAgentConfig;
+  /**
+   * Docs Review checks changed docs files in CI/local runs and can auto-create
+   * a GitHub Actions workflow during dev/build startup.
+   *
+   * - omitted or `true` → enabled with warn-mode CI and an 80 score threshold
+   * - `false` → disable review and workflow generation
+   *
+   * @example
+   * ```ts
+   * review: {
+   *   ci: { mode: "block" },
+   *   score: { threshold: 90 },
+   * }
+   * ```
+   */
+  review?: boolean | DocsReviewConfig;
   /** SEO metadata - separate from theme */
   metadata?: DocsMetadata;
   /** Open Graph image handling */
   og?: OGConfig;
 }
 //#endregion
-export { DocsSearchResultType as $, DocsConfig as A, SidebarFolderNode as At, DocsObservabilityEventInput as B, DocsAskAIActionData as C, PageSidebarFrontmatter as Ct, DocsAskAIFeedbackMessage as D, SidebarComponentProps as Dt, DocsAskAIFeedbackData as E, ResolvedDocsRelatedLink as Et, DocsMcpToolsConfig as F, ThemeToggleConfig as Ft, DocsSearchAdapterContext as G, DocsRobotsConfig as H, DocsMetadata as I, TypesenseDocsSearchConfig as It, DocsSearchConfig as J, DocsSearchAdapterFactory as K, DocsNav as L, TypographyConfig as Lt, DocsFeedbackValue as M, SidebarPageNode as Mt, DocsI18nConfig as N, SidebarTree as Nt, DocsAskAIFeedbackValue as O, SidebarConfig as Ot, DocsMcpConfig as P, SimpleDocsSearchConfig as Pt, DocsSearchResult as Q, DocsObservabilityConfig as R, UIConfig as Rt, DocsAnalyticsSource as S, PageOpenGraph as St, DocsAskAIFeedbackConfig as T, ReadingTimeConfig as Tt, DocsRobotsRule as U, DocsRelatedItem as V, DocsSearchAdapter as W, DocsSearchEmbeddingsConfig as X, DocsSearchDocument as Y, DocsSearchQuery as Z, DocsAnalyticsConfig as _, OpenDocsTarget as _t, ApiReferenceRenderer as a, GithubConfig as at, DocsAnalyticsEventType as b, PageActionsConfig as bt, ChangelogFrontmatter as c, LlmsTxtMaxCharsConfig as ct, CustomDocsSearchConfig as d, McpDocsSearchConfig as dt, DocsSearchSourcePage as et, DocsAgentFeedbackContext as f, OGConfig as ft, DocsAgentTraceStatus as g, OpenDocsProviderId as gt, DocsAgentTraceEventType as h, OpenDocsProviderConfig as ht, ApiReferenceConfig as i, FontStyle as it, DocsFeedbackData as j, SidebarNode as jt, DocsAskAIMcpConfig as k, SidebarFolderIndexBehavior as kt, CodeBlockCopyData as l, LlmsTxtMaxCharsMode as lt, DocsAgentTraceEventInput as m, OpenDocsProvider as mt, AgentFeedbackConfig as n, DocsTheme as nt, BreadcrumbConfig as o, LastUpdatedConfig as ot, DocsAgentFeedbackData as p, OpenDocsConfig as pt, DocsSearchChunkingConfig as q, AlgoliaDocsSearchConfig as r, FeedbackConfig as rt, ChangelogConfig as s, LlmsTxtConfig as st, AIConfig as t, DocsSitemapConfig as tt, CopyMarkdownConfig as u, LlmsTxtSectionConfig as ut, DocsAnalyticsEvent as v, OpenGraphImage as vt, DocsAskAIActionType as w, PageTwitter as wt, DocsAnalyticsInput as x, PageFrontmatter as xt, DocsAnalyticsEventInput as y, OrderingItem as yt, DocsObservabilityEvent as z };
+export { DocsSearchChunkingConfig as $, DocsConfig as A, PageTwitter as At, DocsObservabilityEventInput as B, SimpleDocsSearchConfig as Bt, DocsAskAIActionData as C, OpenDocsTarget as Ct, DocsAskAIFeedbackMessage as D, PageFrontmatter as Dt, DocsAskAIFeedbackData as E, PageActionsConfig as Et, DocsMcpToolsConfig as F, SidebarFolderIndexBehavior as Ft, DocsReviewRulesConfig as G, DocsReviewCiConfig as H, TypesenseDocsSearchConfig as Ht, DocsMetadata as I, SidebarFolderNode as It, DocsRobotsConfig as J, DocsReviewScoreConfig as K, DocsNav as L, SidebarNode as Lt, DocsFeedbackValue as M, ResolvedDocsRelatedLink as Mt, DocsI18nConfig as N, SidebarComponentProps as Nt, DocsAskAIFeedbackValue as O, PageOpenGraph as Ot, DocsMcpConfig as P, SidebarConfig as Pt, DocsSearchAdapterFactory as Q, DocsObservabilityConfig as R, SidebarPageNode as Rt, DocsAnalyticsSource as S, OpenDocsProviderId as St, DocsAskAIFeedbackConfig as T, OrderingItem as Tt, DocsReviewCiMode as U, TypographyConfig as Ut, DocsRelatedItem as V, ThemeToggleConfig as Vt, DocsReviewConfig as W, UIConfig as Wt, DocsSearchAdapter as X, DocsRobotsRule as Y, DocsSearchAdapterContext as Z, DocsAnalyticsConfig as _, McpDocsSearchConfig as _t, ApiReferenceRenderer as a, DocsSearchResultType as at, DocsAnalyticsEventType as b, OpenDocsProvider as bt, ChangelogFrontmatter as c, DocsTheme as ct, CustomDocsSearchConfig as d, GithubConfig as dt, DocsSearchConfig as et, DocsAgentFeedbackContext as f, LastUpdatedConfig as ft, DocsAgentTraceStatus as g, LlmsTxtSectionConfig as gt, DocsAgentTraceEventType as h, LlmsTxtMaxCharsMode as ht, ApiReferenceConfig as i, DocsSearchResult as it, DocsFeedbackData as j, ReadingTimeConfig as jt, DocsAskAIMcpConfig as k, PageSidebarFrontmatter as kt, CodeBlockCopyData as l, FeedbackConfig as lt, DocsAgentTraceEventInput as m, LlmsTxtMaxCharsConfig as mt, AgentFeedbackConfig as n, DocsSearchEmbeddingsConfig as nt, BreadcrumbConfig as o, DocsSearchSourcePage as ot, DocsAgentFeedbackData as p, LlmsTxtConfig as pt, DocsReviewSeverity as q, AlgoliaDocsSearchConfig as r, DocsSearchQuery as rt, ChangelogConfig as s, DocsSitemapConfig as st, AIConfig as t, DocsSearchDocument as tt, CopyMarkdownConfig as u, FontStyle as ut, DocsAnalyticsEvent as v, OGConfig as vt, DocsAskAIActionType as w, OpenGraphImage as wt, DocsAnalyticsInput as x, OpenDocsProviderConfig as xt, DocsAnalyticsEventInput as y, OpenDocsConfig as yt, DocsObservabilityEvent as z, SidebarTree as zt };

package/dist/{upgrade-B1EMfRQJ.mjs → upgrade-DrOWQIKI.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-TPe8H1P-.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-DQgrHnSb.mjs";
+import { c as fileExists, o as exec } from "./utils-x5EtYWjC.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-L4GZowaF.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.119",
+  "version": "0.1.120",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",