From 515d5e04308f8604d8a7ba09fd34f2cc683cf2e9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 05:53:27 +0000 Subject: [PATCH 1/4] docs: improve SEO title for flows plugin page --- build-an-oracle/reference/bundled-plugins/flows.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build-an-oracle/reference/bundled-plugins/flows.mdx b/build-an-oracle/reference/bundled-plugins/flows.mdx index 9832de9..b19bd77 100644 --- a/build-an-oracle/reference/bundled-plugins/flows.mdx +++ b/build-an-oracle/reference/bundled-plugins/flows.mdx @@ -1,5 +1,5 @@ --- -title: "flows" +title: "flows plugin: author Qi Flow action templates" description: "Opt-in flow-builder plugin: author, inspect, wire, and form-fill multi-step Qi Flow action templates on top of the editor's Qi Flow engine." icon: "diagram-project" --- From bc3e3e259ea5a9fbb18f3719e3e0c2eb5b4bfe34 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 05:54:46 +0000 Subject: [PATCH 2/4] docs: lengthen manifest-schema description to meet SEO floor --- build-an-oracle/reference/manifest-schema.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build-an-oracle/reference/manifest-schema.mdx b/build-an-oracle/reference/manifest-schema.mdx index 1b38348..37cdc51 100644 --- a/build-an-oracle/reference/manifest-schema.mdx +++ b/build-an-oracle/reference/manifest-schema.mdx @@ -1,6 +1,6 @@ --- title: "Manifest schema" -description: "Field-by-field reference for PluginManifest — every field, type, constraint, and validation rule the runtime enforces at boot." +description: "Field-by-field reference for the PluginManifest schema — every field, type, constraint, and validation rule the oracle runtime enforces at boot." icon: "scroll" --- From 8e5b923b3423710370f82e916d1c79c8e41ed9a3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 10 Jul 2026 04:18:40 +0000 Subject: [PATCH 3/4] docs: tighten SEO titles and descriptions across oracle docs --- build-an-oracle/for-ai-agents.mdx | 2 +- build-an-oracle/index.mdx | 2 +- build-an-oracle/quickstart.mdx | 2 +- build-an-oracle/reference/bundled-plugins/vfs.mdx | 2 +- build-an-oracle/reference/environment-variables.mdx | 2 +- build-an-oracle/understand/architecture.mdx | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/build-an-oracle/for-ai-agents.mdx b/build-an-oracle/for-ai-agents.mdx index fba9837..adbc205 100644 --- a/build-an-oracle/for-ai-agents.mdx +++ b/build-an-oracle/for-ai-agents.mdx @@ -1,6 +1,6 @@ --- title: "For AI agents" -description: "Dense single-page reference. Every signature, every option, every env var, plus a copy-pasteable plugin template. Built so an AI agent can scaffold a QiForge oracle from this page alone." +description: "Dense single-page QiForge reference — every signature, option, and env var, plus a copy-pasteable plugin template for scaffolding an oracle." icon: "robot" --- diff --git a/build-an-oracle/index.mdx b/build-an-oracle/index.mdx index 22a5a48..39f772b 100644 --- a/build-an-oracle/index.mdx +++ b/build-an-oracle/index.mdx @@ -1,6 +1,6 @@ --- title: "Build an Oracle" -description: "QiForge is the framework for shipping Agentic Oracles — governed AI evaluators and workflow actors with verifiable identity, encrypted per-user storage, and a plugin runtime you wire up in ~30 lines of TypeScript." +description: "Ship Agentic Oracles with QiForge — governed AI evaluators with verifiable identity, encrypted per-user storage, and a TypeScript plugin runtime." icon: "compass" --- diff --git a/build-an-oracle/quickstart.mdx b/build-an-oracle/quickstart.mdx index d943a88..58739f2 100644 --- a/build-an-oracle/quickstart.mdx +++ b/build-an-oracle/quickstart.mdx @@ -1,6 +1,6 @@ --- title: "Quickstart" -description: "Scaffold a working oracle, boot it, and watch the agent call a plugin tool — in about ten minutes." +description: "Scaffold a working QiForge oracle, boot it, and watch the agent call a plugin tool — a ten-minute TypeScript setup walkthrough for developers." icon: "play" --- diff --git a/build-an-oracle/reference/bundled-plugins/vfs.mdx b/build-an-oracle/reference/bundled-plugins/vfs.mdx index 6c58392..d4eb296 100644 --- a/build-an-oracle/reference/bundled-plugins/vfs.mdx +++ b/build-an-oracle/reference/bundled-plugins/vfs.mdx @@ -1,5 +1,5 @@ --- -title: "vfs" +title: "vfs plugin: read, edit, and share user files" description: "The user's Virtual Filesystem — read, create, edit, search, organise, and share their real files, inside the folder they granted the oracle." icon: "folder" --- diff --git a/build-an-oracle/reference/environment-variables.mdx b/build-an-oracle/reference/environment-variables.mdx index 1ba9aa2..c76334c 100644 --- a/build-an-oracle/reference/environment-variables.mdx +++ b/build-an-oracle/reference/environment-variables.mdx @@ -1,6 +1,6 @@ --- title: "Environment variables" -description: "Tier-0 (core) vars the runtime always requires, plus per-plugin vars contributed by each bundled plugin's configSchema." +description: "Tier-0 core env vars the QiForge oracle runtime always requires at boot, plus per-plugin vars contributed by each bundled plugin's configSchema." icon: "key" --- diff --git a/build-an-oracle/understand/architecture.mdx b/build-an-oracle/understand/architecture.mdx index f4b7a36..c71c760 100644 --- a/build-an-oracle/understand/architecture.mdx +++ b/build-an-oracle/understand/architecture.mdx @@ -1,6 +1,6 @@ --- title: "Architecture" -description: "The three layers — your oracle, the runtime, the bundled plugins — and how they fit together." +description: "The three QiForge layers — your oracle, the runtime, and the bundled plugins — how they fit together, and the boot sequence the runtime executes." icon: "diagram-project" --- From 564399f7dee386fc8936e70013393728133d709c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 22 Jul 2026 13:55:44 +0000 Subject: [PATCH 4/4] docs: trim runtime-context description to SEO length --- build-an-oracle/reference/runtime-context.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build-an-oracle/reference/runtime-context.mdx b/build-an-oracle/reference/runtime-context.mdx index 2383cb2..9bf201a 100644 --- a/build-an-oracle/reference/runtime-context.mdx +++ b/build-an-oracle/reference/runtime-context.mdx @@ -1,6 +1,6 @@ --- title: "RuntimeContext" -description: "The per-request context. Every tool handler, sub-agent handler, middleware hook, and request-time builder receives one. Carries user, session, history, secrets, Matrix, UCAN, LLM, events." +description: "The per-request RuntimeContext passed to every tool handler, sub-agent, middleware hook, and builder — user, session, history, secrets, UCAN, LLM." icon: "user-gear" ---