world-building-framework 0.2.0 → 0.2.2

package/README.md

@@ -6,6 +6,10 @@ Build a fictional world as a folder of Markdown files, and publish it as a wiki
 
 You need [Node.js 22](https://nodejs.org/) or newer and git.
 
+**With an AI agent:** in an empty folder, ask it: "Set up a world here with the npm package world-building-framework." It follows the steps in the next section and installs the skills it needs itself.
+
+**By hand:**
+
 ```
 mkdir my-world
 cd my-world
@@ -14,7 +18,7 @@ npx world-building-framework init --agent claude
 npm install
 ```
 
-`init` sets the folder up as a world. `--agent claude` also installs skills for Claude Code. Leave it out if you use another agent; the generated `AGENTS.md` works with any agent.
+`init` sets the folder up as a world. `--agent claude` also installs skills for Claude Code; for another agent, use `--skills-dir <folder>` with the folder that agent reads project skills from. Leave both out if you don't want skills; the generated `AGENTS.md` works with any agent.
 
 `init` never overwrites a file you already have. It creates:
 - `package.json`, with the framework version pinned
@@ -28,7 +32,21 @@ Then put it on GitHub:
 
 1. Create a GitHub repo, commit everything (including `package-lock.json` and `.wbf/managed.json`), and push.
 2. In the repo on GitHub: **Settings → Pages → Source: GitHub Actions**. On a free account, Pages needs the repo to be public.
-3. Every push to your default branch now publishes the wiki to `https://<you>.github.io/<repo>/wiki/`, with a landing page at `https://<you>.github.io/<repo>/`.
+3. Every push to your default branch now publishes the wiki to `https://<you>.github.io/<repo>/wiki/`, with a landing page at `https://<you>.github.io/<repo>/`. To publish without a push, run it by hand: **Actions → Publish wiki → Run workflow**.
+
+You don't enter the URL anywhere; the workflow asks GitHub for it. For a custom domain, set it under **Settings → Pages → Custom domain**; the next run picks it up.
+
+## For AI agents: setting up a world
+
+If a user asks you to set up a world with this package:
+
+1. In the folder they chose (run `git init` first if it isn't a git repo), run `npx world-building-framework init`, adding the option for **your own** skills:
+   - Claude Code: `--agent claude`
+   - any other agent that reads Agent Skills (`SKILL.md`): `--skills-dir <your project skills folder>`, relative to the repo. Only use a folder you know your agent reads; if you don't know one, leave the option out.
+   - Add `--title "<the world's name>"` if the user named it.
+2. Run `npm install`.
+3. Read the generated `AGENTS.md` and, if installed, the `world-vault` skill, then follow them for all further work.
+4. Tell the user the remaining steps from "Then put it on GitHub" above.
 
 ## Writing your world
 
@@ -49,8 +67,31 @@ Then put it on GitHub:
 
 Run `npx wbf` only inside a world folder. Elsewhere it would fetch an unrelated npm package that happens to be called `wbf`.
 
+**With an AI agent that has no terminal (MCP):** see [Agents without a terminal](#agents-without-a-terminal-mcp) below.
+
 **In Obsidian:** open the world folder as a vault to browse and read. Create and change files through `wbf`, so they get valid UUID names and checked links.
 
+## Agents without a terminal (MCP)
+
+Some AI apps can't run commands, but can use tools from an MCP server. `wbf mcp` offers the same functions as the commands above as tools: `schema`, `search`, `read`, `validate`, `create`, `update` and `list_variants`. The app starts the server itself; you only add it to the app's MCP settings once. You need [Node.js 22](https://nodejs.org/) or newer installed.
+
+For Claude Desktop, open **Settings → Developer → Edit Config** and add:
+
+```json
+{
+  "mcpServers": {
+    "my-world": {
+      "command": "npx",
+      "args": ["-y", "world-building-framework@0.2.2", "mcp", "--vault", "C:\\Users\\you\\worlds\\my-world"]
+    }
+  }
+}
+```
+
+- Use the **absolute path** to your world folder, and the framework version from your world's `package.json`, so the app checks files with the same rules as your published wiki. If they differ, the `schema` tool says so.
+- Restart the app afterwards. Other apps use the same `command` and `args`; see their docs for where they go.
+- Setting a world up (`init`, `npm install`) and publishing (commit and push) still happen outside the app, as described above.
+
 ## How a world is organized
 
 - **Files are named by UUID,** e.g. `7c1e9b2a-….md`. The readable name is the `title` field, so two characters can share a name.
@@ -81,6 +122,8 @@ Run `npx wbf` only inside a world folder. Elsewhere it would fetch an unrelated
 
 **Every wiki is public.** Anyone who knows or guesses a variant's address can open it. Variants decide what each wiki contains; they don't lock anything.
 
+**Variants filter whole files.** A file that's included is shown in full, body text and all. Put a secret in its own file with narrower tags rather than in the text of a file everyone sees. A link to a file a wiki leaves out turns into plain text, so its title still shows there.
+
 ## Preview locally
 
 ```
@@ -98,7 +141,7 @@ npm install world-building-framework@latest
 npx wbf refresh
 ```
 
-`refresh` updates the files `init` generated (the workflow, `AGENTS.md`, skills) to the new version. It leaves any file you've edited alone and lists it. `npx wbf init --agent <name>` adds skills for another agent later.
+`refresh` updates the files `init` generated (the workflow, `AGENTS.md`, skills) to the new version. It leaves any file you've edited alone and lists it. `npx wbf init --agent <name>` or `--skills-dir <folder>` adds skills for another agent later; `refresh` keeps those current too.
 
 ## License
 

package/dist/cli/commands/create.d.ts

@@ -4,13 +4,7 @@ import { type ValidationIssue } from "../../core/schema/index.js";
 export declare const fileInputSchema: z.ZodObject<{
     frontmatter: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     body: z.ZodDefault<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    frontmatter: Record<string, unknown>;
-    body: string;
-}, {
-    frontmatter: Record<string, unknown>;
-    body?: string | undefined;
-}>;
+}, z.core.$strip>;
 export interface CreateOutcome {
     written: boolean;
     id?: string;

package/dist/cli/commands/init.d.ts

@@ -5,6 +5,8 @@ export interface InitOptions {
     title?: string;
     /** Agents to install skills for (see AGENT_SKILL_DIRS). */
     agents?: string[];
+    /** Repo-relative folders to install skills into directly, for agents without a shortcut. */
+    skillsDirs?: string[];
     /** Branch the publish workflow runs on; defaults to the git repo's current branch, else "main". */
     branch?: string;
 }

package/dist/cli/commands/init.js

@@ -3,7 +3,7 @@ import { existsSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { WORLD_CONFIG_FILENAME } from "../../core/config/index.js";
-import { AGENT_SKILL_DIRS, contentHash, readFrameworkVersion, readManifest, renderManagedFiles, writeManifest, writeRepoFile, PACKAGE_ROOT, } from "../managed-files.js";
+import { AGENT_SKILL_DIRS, contentHash, normalizeSkillsDir, readFrameworkVersion, readManifest, renderManagedFiles, writeManifest, writeRepoFile, PACKAGE_ROOT, } from "../managed-files.js";
 const PACKAGE_NAME = "world-building-framework";
 function titleFromFolder(dir) {
     const words = path.basename(path.resolve(dir)).split(/[-_\s]+/).filter(Boolean);
@@ -29,9 +29,11 @@ export async function runInit(options = {}) {
     const agents = [...new Set(options.agents ?? [])];
     for (const agent of agents) {
         if (!AGENT_SKILL_DIRS[agent]) {
-            throw new Error(`Unknown agent "${agent}". Supported: ${Object.keys(AGENT_SKILL_DIRS).join(", ")}`);
+            throw new Error(`Unknown agent "${agent}". Supported: ${Object.keys(AGENT_SKILL_DIRS).join(", ")}. ` +
+                "For another agent, give its project skills folder instead: --skills-dir <folder>");
         }
     }
+    const skillsDirs = [...new Set((options.skillsDirs ?? []).map(normalizeSkillsDir))];
     const version = await readFrameworkVersion();
     const outcome = { dir, created: [], updated: [], skipped: [], nextSteps: [] };
     const exists = (rel) => existsSync(path.join(dir, rel));
@@ -94,6 +96,7 @@ export async function runInit(options = {}) {
     const settings = {
         branch: options.branch ?? previous?.branch ?? detectBranch(dir),
         agents: [...new Set([...(previous?.agents ?? []), ...agents])],
+        skillsDirs: [...new Set([...(previous?.skillsDirs ?? []), ...skillsDirs])],
     };
     const manifest = { frameworkVersion: version, ...settings, files: { ...(previous?.files ?? {}) } };
     for (const [rel, content] of await renderManagedFiles(version, settings)) {
@@ -112,8 +115,9 @@ export async function runInit(options = {}) {
         "Commit everything, including package-lock.json and .wbf/managed.json.",
         "On GitHub: Settings → Pages → Source: GitHub Actions. Then push to publish.",
     ];
-    if (agents.length === 0) {
-        outcome.nextSteps.push(`Optional: install skills for your AI agent with npx wbf init --agent <${Object.keys(AGENT_SKILL_DIRS).join("|")}>.`);
+    if (settings.agents.length === 0 && settings.skillsDirs.length === 0) {
+        outcome.nextSteps.push(`Optional: install skills for your AI agent with npx wbf init --agent <${Object.keys(AGENT_SKILL_DIRS).join("|")}>, ` +
+            "or for any other agent with npx wbf init --skills-dir <its project skills folder>.");
     }
     return outcome;
 }

package/dist/cli/commands/publish.js

@@ -49,7 +49,7 @@ export async function runPublish(vaultOption, options) {
     await setQuartzPageTitle(quartzDir, title);
     for (const name of variantNames) {
         const query = getBuildVariant(config, name);
-        const pages = buildDerivedTree(files, query);
+        const pages = buildDerivedTree(files, query, { title });
         await syncDerivedTreeToQuartz(path.join(quartzDir, "content"), pages);
         if (options.baseUrl) {
             await setQuartzBaseUrl(quartzDir, `${normalizeBaseUrl(options.baseUrl)}/${name}`);

package/dist/cli/commands/refresh.js

@@ -25,7 +25,11 @@ export async function runRefresh(options = {}) {
         kept: [],
         retired: [],
     };
-    const rendered = await renderManagedFiles(toVersion, { branch: manifest.branch, agents: manifest.agents });
+    const rendered = await renderManagedFiles(toVersion, {
+        branch: manifest.branch,
+        agents: manifest.agents,
+        skillsDirs: manifest.skillsDirs,
+    });
     const files = {};
     for (const [rel, content] of rendered) {
         const newHash = contentHash(content);

package/dist/cli/commands/render.js

@@ -11,7 +11,7 @@ export async function runRender(vaultOption, options) {
     const config = await loadWorldConfig(vaultDir);
     const query = getBuildVariant(config, options.variant);
     const files = await readVault(vaultDir);
-    const pages = buildDerivedTree(files, query);
+    const pages = buildDerivedTree(files, query, { title: worldTitle(config) });
     // Before syncing: a fresh clone must not land on top of a content folder we just wrote.
     if (options.build)
         await ensureQuartz(quartzDir);

package/dist/cli/index.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { Command } from "commander";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createMcpServer } from "../mcp/server.js";
 import { runSchema } from "./commands/schema.js";
 import { runInit } from "./commands/init.js";
 import { runRefresh } from "./commands/refresh.js";
@@ -35,9 +37,16 @@ program
     .option("--dir <path>", "folder to set up (default: current folder)")
     .option("--title <title>", "the world's display title (default: derived from the folder name)")
     .option("--agent <name>", "install skills for this AI agent; repeat for several", (value, previous) => [...previous, value], [])
+    .option("--skills-dir <folder>", "install skills into this repo-relative folder, for an agent --agent doesn't know; repeat for several", (value, previous) => [...previous, value], [])
     .option("--branch <name>", "branch the publish workflow runs on (default: the repo's current branch, else main)")
     .action(handle(async (opts) => {
-    const outcome = await runInit({ dir: opts.dir, title: opts.title, agents: opts.agent, branch: opts.branch });
+    const outcome = await runInit({
+        dir: opts.dir,
+        title: opts.title,
+        agents: opts.agent,
+        skillsDirs: opts.skillsDir,
+        branch: opts.branch,
+    });
     console.log(JSON.stringify(outcome, null, 2));
 }));
 program
@@ -154,4 +163,12 @@ program
     });
     console.log(JSON.stringify(outcome, null, 2));
 }));
+program
+    .command("mcp")
+    .description("Run an MCP server over stdio, offering the vault commands as tools to agents without a terminal. Started by the agent's host, not by hand")
+    .option("-v, --vault <path>", "world folder (default: WBF_VAULT_DIR, else the current folder)")
+    .action(handle(async (opts) => {
+    // stdout carries the protocol from here on; nothing else may write to it.
+    await createMcpServer({ vault: opts.vault, version }).connect(new StdioServerTransport());
+}));
 await program.parseAsync(process.argv);

package/dist/cli/managed-files.d.ts

@@ -10,7 +10,17 @@ export declare const AGENT_SKILL_DIRS: Record<string, string>;
 export interface ManagedSettings {
     branch: string;
     agents: string[];
+    /** Skill folders given directly (`--skills-dir`), for agents without a shortcut in AGENT_SKILL_DIRS. Missing in manifests from 0.2.1 and older. */
+    skillsDirs?: string[];
 }
+/**
+ * Checks a `--skills-dir` value and returns it repo-relative with forward
+ * slashes, e.g. ".agent\skills\" -> ".agent/skills". It must stay inside the
+ * repo: no absolute path, no "..".
+ */
+export declare function normalizeSkillsDir(dir: string): string;
+/** Every folder skills get copied into: the agents' known folders plus any given directly, without duplicates. */
+export declare function skillTargets(settings: ManagedSettings): string[];
 /** The record of generated files, kept in the world repo (committed) at MANIFEST_PATH. */
 export interface Manifest extends ManagedSettings {
     frameworkVersion: string;
@@ -27,7 +37,7 @@ export declare function readFrameworkVersion(): Promise<string>;
 /**
  * The files wbf owns in a world repo, rendered for this framework version:
  * the publish workflow, AGENTS.md, and the package's skills copied into each
- * chosen agent's skill folder. Keyed by repo-relative path.
+ * skill folder (see skillTargets). Keyed by repo-relative path.
  */
 export declare function renderManagedFiles(version: string, settings: ManagedSettings): Promise<Map<string, string>>;
 export declare function readManifest(rootDir: string): Promise<Manifest | undefined>;

package/dist/cli/managed-files.js

@@ -13,6 +13,31 @@ export const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.
 export const AGENT_SKILL_DIRS = {
     claude: ".claude/skills",
 };
+/**
+ * Checks a `--skills-dir` value and returns it repo-relative with forward
+ * slashes, e.g. ".agent\skills\" -> ".agent/skills". It must stay inside the
+ * repo: no absolute path, no "..".
+ */
+export function normalizeSkillsDir(dir) {
+    if (path.isAbsolute(dir) || /^[a-zA-Z]:/.test(dir)) {
+        throw new Error(`Skills folder "${dir}" must be relative to the world repo, e.g. .agent/skills`);
+    }
+    const parts = dir.split(/[\\/]+/).filter((part) => part !== "" && part !== ".");
+    if (parts.length === 0 || parts.includes("..")) {
+        throw new Error(`Skills folder "${dir}" must be a folder inside the world repo, e.g. .agent/skills`);
+    }
+    return parts.join("/");
+}
+/** Every folder skills get copied into: the agents' known folders plus any given directly, without duplicates. */
+export function skillTargets(settings) {
+    const targets = settings.agents.map((agent) => {
+        const target = AGENT_SKILL_DIRS[agent];
+        if (!target)
+            throw new Error(`Unknown agent "${agent}". Supported: ${Object.keys(AGENT_SKILL_DIRS).join(", ")}`);
+        return target;
+    });
+    return [...new Set([...targets, ...(settings.skillsDirs ?? [])])];
+}
 export const MANIFEST_PATH = ".wbf/managed.json";
 /**
  * Content hash, ignoring line endings: git may check a file out with CRLF on
@@ -44,7 +69,7 @@ async function listFiles(dir, prefix = "") {
 /**
  * The files wbf owns in a world repo, rendered for this framework version:
  * the publish workflow, AGENTS.md, and the package's skills copied into each
- * chosen agent's skill folder. Keyed by repo-relative path.
+ * skill folder (see skillTargets). Keyed by repo-relative path.
  */
 export async function renderManagedFiles(version, settings) {
     const files = new Map();
@@ -52,10 +77,7 @@ export async function renderManagedFiles(version, settings) {
     files.set("AGENTS.md", await template("AGENTS.md", version, settings.branch));
     const skillsDir = path.join(PACKAGE_ROOT, "skills");
     const skillFiles = await listFiles(skillsDir);
-    for (const agent of settings.agents) {
-        const target = AGENT_SKILL_DIRS[agent];
-        if (!target)
-            throw new Error(`Unknown agent "${agent}". Supported: ${Object.keys(AGENT_SKILL_DIRS).join(", ")}`);
+    for (const target of skillTargets(settings)) {
         for (const rel of skillFiles) {
             files.set(`${target}/${rel}`, await readFile(path.join(skillsDir, rel), "utf8"));
         }

package/dist/cli/vault-path.d.ts

@@ -3,5 +3,5 @@
  * that are useful without a vault (e.g. `schema`).
  */
 export declare function findVaultDir(cliOption: string | undefined): string | undefined;
-/** Resolves which vault to operate on: explicit flag, then WBF_VAULT_DIR, then the current folder if it has a world.config.json, then a single directory under ./vaults/. */
+/** Resolves which vault to operate on: explicit flag, then WBF_VAULT_DIR, then the current folder if it has a world.config.json. */
 export declare function resolveVaultDir(cliOption: string | undefined): string;

package/dist/cli/vault-path.js

@@ -1,24 +1,6 @@
-import { existsSync, readdirSync, statSync } from "node:fs";
+import { existsSync } from "node:fs";
 import path from "node:path";
 import { WORLD_CONFIG_FILENAME } from "../core/config/index.js";
-function findSingleVaultUnderVaultsDir() {
-    const vaultsRoot = path.join(process.cwd(), "vaults");
-    let entries;
-    try {
-        entries = readdirSync(vaultsRoot).filter((name) => {
-            try {
-                return statSync(path.join(vaultsRoot, name)).isDirectory();
-            }
-            catch {
-                return false;
-            }
-        });
-    }
-    catch {
-        return undefined;
-    }
-    return entries.length === 1 ? path.join(vaultsRoot, entries[0]) : undefined;
-}
 /** The current folder, if it's a vault — i.e. it has a world.config.json (the vault repo is the project, see claude-dev/DISTRIBUTION_PLAN.md). */
 function currentFolderIfVault() {
     const cwd = process.cwd();
@@ -29,16 +11,14 @@ function currentFolderIfVault() {
  * that are useful without a vault (e.g. `schema`).
  */
 export function findVaultDir(cliOption) {
-    // The ./vaults/ fallback is the old fork-the-framework layout, kept until the
-    // world-repo layout fully replaces it.
-    return cliOption ?? process.env.WBF_VAULT_DIR ?? currentFolderIfVault() ?? findSingleVaultUnderVaultsDir();
+    return cliOption ?? process.env.WBF_VAULT_DIR ?? currentFolderIfVault();
 }
-/** Resolves which vault to operate on: explicit flag, then WBF_VAULT_DIR, then the current folder if it has a world.config.json, then a single directory under ./vaults/. */
+/** Resolves which vault to operate on: explicit flag, then WBF_VAULT_DIR, then the current folder if it has a world.config.json. */
 export function resolveVaultDir(cliOption) {
     const vaultDir = findVaultDir(cliOption);
     if (!vaultDir) {
-        throw new Error("No vault specified — run this inside a vault (a folder with world.config.json), pass --vault <path>, " +
-            "set WBF_VAULT_DIR, or have exactly one directory under ./vaults/.");
+        throw new Error("No vault specified — run this inside a world (a folder with world.config.json; `wbf init` creates one), " +
+            "pass --vault <path>, or set WBF_VAULT_DIR.");
     }
     return vaultDir;
 }

package/dist/core/config/schema.d.ts

@@ -3,226 +3,26 @@ import { z } from "zod";
  * A vault's own project-specific setup parameters (PROJECT_CONFIG.md).
  * `title`, `entityTypes` and `buildVariants` are the fields with a decided consumer
  * so far — tag vocabulary itself (as opposed to where it's used, buildVariants)
- * and relation-field naming are still open, so this stays passthrough rather
+ * and relation-field naming are still open, so this stays loose (unknown keys kept) rather
  * than locking in a shape for those prematurely.
  */
 export declare const worldConfigSchema: z.ZodObject<{
-    /** The world's name, shown as the published site's title (every variant and the landing page). */
     title: z.ZodOptional<z.ZodString>;
-    entityTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    /** Named filter queries (render-pipeline's BuildVariantQuery) — PROJECT_CONFIG.md #3. */
+    entityTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     buildVariants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         dateRange: z.ZodOptional<z.ZodObject<{
             from: z.ZodOptional<z.ZodObject<{
                 year: z.ZodNumber;
                 day: z.ZodOptional<z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                year: number;
-                day?: number | undefined;
-            }, {
-                year: number;
-                day?: number | undefined;
-            }>>;
+            }, z.core.$strip>>;
             to: z.ZodOptional<z.ZodObject<{
                 year: z.ZodNumber;
                 day: z.ZodOptional<z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                year: number;
-                day?: number | undefined;
-            }, {
-                year: number;
-                day?: number | undefined;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        }, {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        tags?: string[] | undefined;
-        dateRange?: {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        } | undefined;
-    }, {
-        tags?: string[] | undefined;
-        dateRange?: {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        } | undefined;
-    }>>>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    /** The world's name, shown as the published site's title (every variant and the landing page). */
-    title: z.ZodOptional<z.ZodString>;
-    entityTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    /** Named filter queries (render-pipeline's BuildVariantQuery) — PROJECT_CONFIG.md #3. */
-    buildVariants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        dateRange: z.ZodOptional<z.ZodObject<{
-            from: z.ZodOptional<z.ZodObject<{
-                year: z.ZodNumber;
-                day: z.ZodOptional<z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                year: number;
-                day?: number | undefined;
-            }, {
-                year: number;
-                day?: number | undefined;
-            }>>;
-            to: z.ZodOptional<z.ZodObject<{
-                year: z.ZodNumber;
-                day: z.ZodOptional<z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                year: number;
-                day?: number | undefined;
-            }, {
-                year: number;
-                day?: number | undefined;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        }, {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        tags?: string[] | undefined;
-        dateRange?: {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        } | undefined;
-    }, {
-        tags?: string[] | undefined;
-        dateRange?: {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        } | undefined;
-    }>>>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    /** The world's name, shown as the published site's title (every variant and the landing page). */
-    title: z.ZodOptional<z.ZodString>;
-    entityTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    /** Named filter queries (render-pipeline's BuildVariantQuery) — PROJECT_CONFIG.md #3. */
-    buildVariants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        dateRange: z.ZodOptional<z.ZodObject<{
-            from: z.ZodOptional<z.ZodObject<{
-                year: z.ZodNumber;
-                day: z.ZodOptional<z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                year: number;
-                day?: number | undefined;
-            }, {
-                year: number;
-                day?: number | undefined;
-            }>>;
-            to: z.ZodOptional<z.ZodObject<{
-                year: z.ZodNumber;
-                day: z.ZodOptional<z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                year: number;
-                day?: number | undefined;
-            }, {
-                year: number;
-                day?: number | undefined;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        }, {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        tags?: string[] | undefined;
-        dateRange?: {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        } | undefined;
-    }, {
-        tags?: string[] | undefined;
-        dateRange?: {
-            from?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-            to?: {
-                year: number;
-                day?: number | undefined;
-            } | undefined;
-        } | undefined;
-    }>>>;
-}, z.ZodTypeAny, "passthrough">>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
 export type WorldConfig = z.infer<typeof worldConfigSchema>;
 export declare const DEFAULT_WORLD_TITLE = "World Wiki";
 /** The world's display title, falling back to a neutral default (never Quartz's own "Quartz 5"). */

package/dist/core/config/schema.js

@@ -4,7 +4,7 @@ import { buildVariantQuerySchema } from "../query/index.js";
  * A vault's own project-specific setup parameters (PROJECT_CONFIG.md).
  * `title`, `entityTypes` and `buildVariants` are the fields with a decided consumer
  * so far — tag vocabulary itself (as opposed to where it's used, buildVariants)
- * and relation-field naming are still open, so this stays passthrough rather
+ * and relation-field naming are still open, so this stays loose (unknown keys kept) rather
  * than locking in a shape for those prematurely.
  */
 export const worldConfigSchema = z
@@ -15,7 +15,7 @@ export const worldConfigSchema = z
     /** Named filter queries (render-pipeline's BuildVariantQuery) — PROJECT_CONFIG.md #3. */
     buildVariants: z.record(z.string(), buildVariantQuerySchema).optional(),
 })
-    .passthrough();
+    .loose();
 export const DEFAULT_WORLD_TITLE = "World Wiki";
 /** The world's display title, falling back to a neutral default (never Quartz's own "Quartz 5"). */
 export function worldTitle(config) {