@uniweb/build 0.21.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.21.0",
+  "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/projections": "^0.3.0",
+    "@uniweb/projections": "^0.3.1",
+    "@uniweb/content-writer": "^0.3.3",
     "@uniweb/theming": "^0.1.15",
-    "@uniweb/content-writer": "^0.3.3"
+    "@uniweb/schemas": "^0.2.10"
   },
   "optionalDependencies": {
-    "@uniweb/schemas": "^0.2.10",
     "@uniweb/content-reader": "^1.2.2",
-    "@uniweb/semantic-parser": "^1.2.2",
-    "@uniweb/runtime": "^0.11.7"
+    "@uniweb/schemas": "^0.2.10",
+    "@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

@@ -513,13 +513,20 @@ export function siteContentPlugin(options = {}) {
   /**
    * Collect the site, then drop `knowledge:` pages.
    *
-   * ⛔ **This is the bundle lane, and the bundle lane has no agent endpoint.**
+   * ⛔ **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 — no worker, no backend, nothing that can gate a request. A
-   * `knowledge:` page is content the author marked for an agent and not for a
-   * visitor; here there is no agent to serve it to and no gate to withhold it
-   * with, so shipping it is disclosure with **no consumer on the other side**.
+   * 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
@@ -543,8 +550,8 @@ export function siteContentPlugin(options = {}) {
       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 there is no agent endpoint to read them ` +
-          `and no gate to keep them from visitors. Use \`uniweb deploy\` to make them agent-readable.`
+          `  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.`
       )
     }
 

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)