docs: align prose with runtime contracts

tsdown.config.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from 'tsdown'
 
 /**
- * JS bundling for all workspace packages (vendor and the packages hierarchy).
+ * JS bundling for vendored Cordis and Harness TypeScript packages.
  * TypeScript source is compiled first by `tsc -b tsconfig.build.json`; tsdown
  * reads only the emitted JS under lib/types and writes lib/index.* runtime
  * bundles. Declarations are NOT produced here, hence `dts: false`.
@@ -10,9 +10,9 @@ import { defineConfig } from 'tsdown'
  * (schemastery: dual ESM+CJS; logger-console: extra browser entry).
  */
 export default defineConfig({
-  // Explicit globs: `workspace: true` would also discover examples (any package.json), but only
-  // vendor and the packages hierarchy are pnpm workspaces. Landlock platform packages contain only
-  // a prebuilt native binary, so they have no JavaScript entry to bundle.
+  // Explicit globs keep bundling to vendored Cordis and the TypeScript package tree;
+  // `workspace: true` would discover package manifests outside that bundle set. Landlock
+  // platform packages contain only a prebuilt native binary, so they have no JS entry.
   workspace: ['vendor/*', 'packages/*/*'],
   entry: ['lib/types/index.js'],
   outDir: 'lib',