@uniweb/build 0.20.1 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.20.1",
+  "version": "0.22.0",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -59,16 +59,16 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
-    "@uniweb/schemas": "^0.2.10",
-    "@uniweb/theming": "^0.1.15",
+    "@uniweb/projections": "^0.3.1",
     "@uniweb/content-writer": "^0.3.3",
-    "@uniweb/projections": "^0.2.8"
+    "@uniweb/theming": "^0.1.15",
+    "@uniweb/schemas": "^0.2.10"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "^0.11.7",
+    "@uniweb/content-reader": "^1.2.2",
     "@uniweb/schemas": "^0.2.10",
-    "@uniweb/semantic-parser": "^1.2.2",
-    "@uniweb/content-reader": "^1.2.2"
+    "@uniweb/runtime": "^0.11.7",
+    "@uniweb/semantic-parser": "^1.2.2"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",

package/src/site/index.js

@@ -9,6 +9,10 @@
 export { siteContentPlugin } from './plugin.js'
 export { defineSiteConfig, readSiteConfig, default } from './config.js'
 export { collectSiteContent } from './content-collector.js'
+// The `agents:` vocabulary lives in @uniweb/projections (which owns the block);
+// re-exported so the CLI can validate an author's spelling without taking a
+// direct dependency on it. Same shape as the search re-exports.
+export { AGENTS_KEYS } from '@uniweb/projections'
 export { buildSiteData } from './build-site-data.js'
 export { shouldSplitContent } from './split-content.js'
 export {

package/src/site/plugin.js

@@ -43,6 +43,7 @@ import {
   pageMarkdownFilename,
   branchIndexFilename,
   applyRouteTranslation,
+  partitionKnowledgePages,
   INDEX_FILENAME
 } from '@uniweb/projections'
 import { collectSiteContent, mountEntriesOf } from './content-collector.js'
@@ -505,6 +506,58 @@ export function siteContentPlugin(options = {}) {
     robots: seo.robots || {}
   }
 
+  // Warn once per build, not once per collection — the dev server re-collects
+  // on every content change and would otherwise repeat this on every keystroke.
+  let warnedAboutKnowledge = false
+
+  /**
+   * Collect the site, then drop `knowledge:` pages.
+   *
+   * ⛔ **This is the bundle lane, and the bundle lane has no agent.**
+   * `uniweb export` and `uniweb deploy --host <adapter>` both run this pipeline
+   * (`cli/src/commands/export.js`, `deploy.js`), and their destinations are
+   * static hosts — files served as files, with no service running over the
+   * content. A `knowledge:` page is source material for such a service: prose
+   * written for it to reason with, addressed to it rather than to a person.
+   * Here there is no service to give it to, so publishing it would turn prose
+   * written for a machine reader into pages for visitors — the only readers
+   * this host has.
+   *
+   * ⚠️ **Not a confidentiality argument.** [Diego, 2026-08-13] *"It is not the
+   * case that it's private in the sense of sensitive."* The service quotes this
+   * material back to whoever prompts it, by design. The reason to drop it here
+   * is that it has no reader on this lane, not that it must be kept from one.
+   *
+   * Measured 2026-08-13, before this existed: a knowledge page became
+   * `dist/kb/index.html` — a public route — and its body rode in the
+   * `__SITE_CONTENT__` of *every* prerendered page including `404.html`,
+   * because that script carries the whole site.
+   *
+   * ⚠️ **Deliberately NOT inside `collectSiteContent`.** The link lane
+   * (`build-site-data.js`) calls that same collector and **must keep** these
+   * pages: it hands `site-content.json` to a backend that derives an agent
+   * corpus from it and gates access to that corpus. Same flag, two correct
+   * answers, decided by what is behind the destination — so the subtraction
+   * belongs to the pipeline, not to the collector.
+   */
+  async function collectForBundle(path, options) {
+    const collected = await collectSiteContent(path, options)
+    const { knowledgePages, renderedPages } = partitionKnowledgePages(collected.pages || [])
+    if (!knowledgePages.length) return collected
+
+    if (!warnedAboutKnowledge) {
+      warnedAboutKnowledge = true
+      const routes = knowledgePages.map(page => page.route).join(', ')
+      console.warn(
+        `[site-content] Dropped ${knowledgePages.length} knowledge page(s) from this build: ${routes}\n` +
+          `  This build targets a host that serves files only, so nothing here reads them — their prose is ` +
+          `written for a site assistant, not for visitors. Use \`uniweb deploy\` to make them agent-readable.`
+      )
+    }
+
+    return { ...collected, pages: renderedPages }
+  }
+
   let siteContent = null
   let resolvedSitePath = null
   let resolvedPublicDir = null
@@ -738,7 +791,7 @@ export function siteContentPlugin(options = {}) {
       if (!isProduction) {
         try {
           // Do an early content collection to get the collections config
-          const earlyContent = await collectSiteContent(resolvedSitePath, { foundationPath })
+          const earlyContent = await collectForBundle(resolvedSitePath, { foundationPath })
           collectionsConfig = earlyContent.config?.collections
 
           // Resolve content directory paths from site.yml paths: group
@@ -788,7 +841,7 @@ export function siteContentPlugin(options = {}) {
         // pages stay in the graph so in-progress drafts remain previewable.
         // strict on a production build: a mount that contributes no pages is a
         // warning while you author and a broken deploy once you ship.
-        siteContent = await collectSiteContent(resolvedSitePath, { foundationPath, dropUnpublished: isProduction, base: basePath, strict: isProduction })
+        siteContent = await collectForBundle(resolvedSitePath, { foundationPath, dropUnpublished: isProduction, base: basePath, strict: isProduction })
         headHtml = await loadHeadHtml()
         console.log(`[site-content] Collected ${siteContent.pages?.length || 0} pages`)
 
@@ -841,7 +894,7 @@ export function siteContentPlugin(options = {}) {
           rebuildTimeout = setTimeout(async () => {
             console.log('[site-content] Content changed, rebuilding...')
             try {
-              siteContent = await collectSiteContent(resolvedSitePath, { foundationPath, base: basePath })
+              siteContent = await collectForBundle(resolvedSitePath, { foundationPath, base: basePath })
               headHtml = await loadHeadHtml()
               // Execute fetches for the updated content
               await executeDevFetches(siteContent, resolvedSitePath)

package/src/uwx/site-project.js

@@ -358,7 +358,7 @@ export function pageSectionsToFiles({ pageDir, pageSections, ctx, pageContext })
 // and preserved. Keep in sync with pageRecordToYml below.
 const PAGE_YML_MANAGED_KEYS = new Set([
   'id', 'title', 'description', 'label', 'keywords', 'index', 'hidden',
-  'hideIn', 'redirect', 'rewrite', 'layout', 'seo',
+  'hideIn', 'knowledge', 'redirect', 'rewrite', 'layout', 'seo',
   'fetch', 'sections',
 ])
 
@@ -380,6 +380,7 @@ function pageRecordToYml(record, sectionsArray, sourceLocale) {
   if (record.is_index) y.index = true
   if (record.hidden !== undefined) y.hidden = record.hidden
   if (record.hide_in !== undefined) y.hideIn = record.hide_in
+  if (record.knowledge !== undefined) y.knowledge = record.knowledge
   if (record.redirect !== undefined) y.redirect = record.redirect
   if (record.rewrite !== undefined) y.rewrite = record.rewrite
   if (record.layout !== undefined) y.layout = record.layout

package/src/uwx/site.js

@@ -201,6 +201,11 @@ function buildPageData(config, ctx) {
   setIf(data, 'hidden', config.hidden)
   const hideIn = normalizeHideIn(config)
   if (hideIn.length) data.hide_in = hideIn
+  // Agent-only content. Sent as authored — only the marked page carries it, and
+  // the cascade to descendants is the CONSUMER's to compute (by route prefix, or
+  // equivalently by walking the page tree). A reader that tests this field alone
+  // honours the branch root and silently misses every child.
+  setIf(data, 'knowledge', config.knowledge)
   setIf(data, 'redirect', config.redirect)
   setIf(data, 'rewrite', config.rewrite)
   setIf(data, 'layout', config.layout)