diff --git a/apps/gittensory-ui/public/sitemap.xml b/apps/gittensory-ui/public/sitemap.xml
index 026d36b418..769cdd5267 100644
--- a/apps/gittensory-ui/public/sitemap.xml
+++ b/apps/gittensory-ui/public/sitemap.xml
@@ -7,6 +7,7 @@
   <url><loc>https://gittensory.aethereal.dev/extension</loc></url>
   <url><loc>https://gittensory.aethereal.dev/roadmap</loc></url>
   <url><loc>https://gittensory.aethereal.dev/docs</loc></url>
+  <url><loc>https://gittensory.aethereal.dev/docs/beta-onboarding</loc></url>
   <url><loc>https://gittensory.aethereal.dev/docs/quickstart</loc></url>
   <url><loc>https://gittensory.aethereal.dev/docs/mcp-clients</loc></url>
   <url><loc>https://gittensory.aethereal.dev/docs/miner-workflow</loc></url>
diff --git a/apps/gittensory-ui/src/components/site/command-palette.tsx b/apps/gittensory-ui/src/components/site/command-palette.tsx
index f95a28ae09..4b428873f2 100644
--- a/apps/gittensory-ui/src/components/site/command-palette.tsx
+++ b/apps/gittensory-ui/src/components/site/command-palette.tsx
@@ -27,6 +27,7 @@ const DEFAULT_ITEMS: PaletteItem[] = [
   { label: "Product analytics", to: "/app/analytics", group: "App" },
   { label: "Maintainer digest", to: "/app/digest", group: "App" },
   { label: "Operator dashboard", to: "/app/operator", group: "App" },
+  { label: "Beta onboarding", to: "/docs/beta-onboarding", group: "Docs" },
   { label: "Quickstart", to: "/docs/quickstart", group: "Docs" },
   { label: "MCP clients", to: "/docs/mcp-clients", group: "Docs" },
   { label: "Miner workflow", to: "/docs/miner-workflow", group: "Docs" },
diff --git a/apps/gittensory-ui/src/components/site/docs-nav.tsx b/apps/gittensory-ui/src/components/site/docs-nav.tsx
index ea4fe31e29..3e011f10b9 100644
--- a/apps/gittensory-ui/src/components/site/docs-nav.tsx
+++ b/apps/gittensory-ui/src/components/site/docs-nav.tsx
@@ -10,6 +10,7 @@ export const docsNav: DocsGroup[] = [
     title: "Get started",
     items: [
       { to: "/docs", label: "Overview" },
+      { to: "/docs/beta-onboarding", label: "Beta onboarding" },
       { to: "/docs/quickstart", label: "Quickstart" },
       { to: "/docs/mcp-clients", label: "MCP client setup" },
     ],
diff --git a/apps/gittensory-ui/src/routeTree.gen.ts b/apps/gittensory-ui/src/routeTree.gen.ts
index 09d8351146..38b93e1b4f 100644
--- a/apps/gittensory-ui/src/routeTree.gen.ts
+++ b/apps/gittensory-ui/src/routeTree.gen.ts
@@ -32,6 +32,7 @@ import { Route as DocsMcpClientsRouteImport } from './routes/docs.mcp-clients'
 import { Route as DocsMaintainerWorkflowRouteImport } from './routes/docs.maintainer-workflow'
 import { Route as DocsGithubAppRouteImport } from './routes/docs.github-app'
 import { Route as DocsBranchAnalysisRouteImport } from './routes/docs.branch-analysis'
+import { Route as DocsBetaOnboardingRouteImport } from './routes/docs.beta-onboarding'
 import { Route as DocsAiSummariesRouteImport } from './routes/docs.ai-summaries'
 import { Route as AppWorkbenchRouteImport } from './routes/app.workbench'
 import { Route as AppRunsRouteImport } from './routes/app.runs'
@@ -161,6 +162,11 @@ const DocsBranchAnalysisRoute = DocsBranchAnalysisRouteImport.update({
   path: '/branch-analysis',
   getParentRoute: () => DocsRoute,
 } as any)
+const DocsBetaOnboardingRoute = DocsBetaOnboardingRouteImport.update({
+  id: '/beta-onboarding',
+  path: '/beta-onboarding',
+  getParentRoute: () => DocsRoute,
+} as any)
 const DocsAiSummariesRoute = DocsAiSummariesRouteImport.update({
   id: '/ai-summaries',
   path: '/ai-summaries',
@@ -251,6 +257,7 @@ export interface FileRoutesByFullPath {
   '/app/runs': typeof AppRunsRoute
   '/app/workbench': typeof AppWorkbenchRoute
   '/docs/ai-summaries': typeof DocsAiSummariesRoute
+  '/docs/beta-onboarding': typeof DocsBetaOnboardingRoute
   '/docs/branch-analysis': typeof DocsBranchAnalysisRoute
   '/docs/github-app': typeof DocsGithubAppRoute
   '/docs/maintainer-workflow': typeof DocsMaintainerWorkflowRoute
@@ -286,6 +293,7 @@ export interface FileRoutesByTo {
   '/app/runs': typeof AppRunsRoute
   '/app/workbench': typeof AppWorkbenchRoute
   '/docs/ai-summaries': typeof DocsAiSummariesRoute
+  '/docs/beta-onboarding': typeof DocsBetaOnboardingRoute
   '/docs/branch-analysis': typeof DocsBranchAnalysisRoute
   '/docs/github-app': typeof DocsGithubAppRoute
   '/docs/maintainer-workflow': typeof DocsMaintainerWorkflowRoute
@@ -325,6 +333,7 @@ export interface FileRoutesById {
   '/app/runs': typeof AppRunsRoute
   '/app/workbench': typeof AppWorkbenchRoute
   '/docs/ai-summaries': typeof DocsAiSummariesRoute
+  '/docs/beta-onboarding': typeof DocsBetaOnboardingRoute
   '/docs/branch-analysis': typeof DocsBranchAnalysisRoute
   '/docs/github-app': typeof DocsGithubAppRoute
   '/docs/maintainer-workflow': typeof DocsMaintainerWorkflowRoute
@@ -365,6 +374,7 @@ export interface FileRouteTypes {
     | '/app/runs'
     | '/app/workbench'
     | '/docs/ai-summaries'
+    | '/docs/beta-onboarding'
     | '/docs/branch-analysis'
     | '/docs/github-app'
     | '/docs/maintainer-workflow'
@@ -400,6 +410,7 @@ export interface FileRouteTypes {
     | '/app/runs'
     | '/app/workbench'
     | '/docs/ai-summaries'
+    | '/docs/beta-onboarding'
     | '/docs/branch-analysis'
     | '/docs/github-app'
     | '/docs/maintainer-workflow'
@@ -438,6 +449,7 @@ export interface FileRouteTypes {
     | '/app/runs'
     | '/app/workbench'
     | '/docs/ai-summaries'
+    | '/docs/beta-onboarding'
     | '/docs/branch-analysis'
     | '/docs/github-app'
     | '/docs/maintainer-workflow'
@@ -629,6 +641,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof DocsBranchAnalysisRouteImport
       parentRoute: typeof DocsRoute
     }
+    '/docs/beta-onboarding': {
+      id: '/docs/beta-onboarding'
+      path: '/beta-onboarding'
+      fullPath: '/docs/beta-onboarding'
+      preLoaderRoute: typeof DocsBetaOnboardingRouteImport
+      parentRoute: typeof DocsRoute
+    }
     '/docs/ai-summaries': {
       id: '/docs/ai-summaries'
       path: '/ai-summaries'
@@ -769,6 +788,7 @@ const AppRouteWithChildren = AppRoute._addFileChildren(AppRouteChildren)
 
 interface DocsRouteChildren {
   DocsAiSummariesRoute: typeof DocsAiSummariesRoute
+  DocsBetaOnboardingRoute: typeof DocsBetaOnboardingRoute
   DocsBranchAnalysisRoute: typeof DocsBranchAnalysisRoute
   DocsGithubAppRoute: typeof DocsGithubAppRoute
   DocsMaintainerWorkflowRoute: typeof DocsMaintainerWorkflowRoute
@@ -784,6 +804,7 @@ interface DocsRouteChildren {
 
 const DocsRouteChildren: DocsRouteChildren = {
   DocsAiSummariesRoute: DocsAiSummariesRoute,
+  DocsBetaOnboardingRoute: DocsBetaOnboardingRoute,
   DocsBranchAnalysisRoute: DocsBranchAnalysisRoute,
   DocsGithubAppRoute: DocsGithubAppRoute,
   DocsMaintainerWorkflowRoute: DocsMaintainerWorkflowRoute,
diff --git a/apps/gittensory-ui/src/routes/docs.beta-onboarding.tsx b/apps/gittensory-ui/src/routes/docs.beta-onboarding.tsx
new file mode 100644
index 0000000000..0c57f545d0
--- /dev/null
+++ b/apps/gittensory-ui/src/routes/docs.beta-onboarding.tsx
@@ -0,0 +1,253 @@
+import { createFileRoute, Link } from "@tanstack/react-router";
+
+import { DocsPage } from "@/components/site/docs-page";
+import { CodeBlock, Callout } from "@/components/site/primitives";
+
+export const Route = createFileRoute("/docs/beta-onboarding")({
+  head: () => ({
+    meta: [
+      { title: "Beta onboarding — Gittensory docs" },
+      {
+        name: "description",
+        content:
+          "Role-based beta paths for miners, maintainers, repo owners, and operators — first useful action, not just API reference.",
+      },
+      { property: "og:title", content: "Beta onboarding — Gittensory docs" },
+      {
+        property: "og:description",
+        content:
+          "Role-based beta paths for miners, maintainers, repo owners, and operators — first useful action, not just API reference.",
+      },
+      { property: "og:url", content: "/docs/beta-onboarding" },
+    ],
+    links: [{ rel: "canonical", href: "/docs/beta-onboarding" }],
+  }),
+  component: BetaOnboarding,
+});
+
+function BetaOnboarding() {
+  return (
+    <DocsPage
+      eyebrow="Get started"
+      title="Beta onboarding by role"
+      description="Pick the lane that matches you. Each path ends in a concrete first win — install, configure, or read a report — without treating Gittensory as an official Gittensor product surface."
+    >
+      <Callout>
+        <strong>Product positioning.</strong> Gittensory is a deterministic base-agent and
+        control-plane layer for the Gittensor ecosystem. It is{" "}
+        <a href="https://github.com/jsonbored/gittensory" target="_blank" rel="noreferrer">
+          jsonbored/gittensory
+        </a>
+        , independent of{" "}
+        <a href="https://github.com/entrius/gittensor" target="_blank" rel="noreferrer">
+          entrius/gittensor
+        </a>
+        . Use it to plan work, preflight branches, and keep GitHub review surfaces quiet — not as an
+        official Gittensor frontend, wallet UI, or payout dashboard.
+      </Callout>
+
+      <h2>Miner journey</h2>
+      <p>
+        Miners and contributors use the local MCP package. Metadata stays on your machine; private
+        scoreability and blockers appear only in authenticated MCP/API responses.
+      </p>
+      <ol>
+        <li>
+          <strong>Install the MCP.</strong> Global install or <code>npx</code> — see{" "}
+          <Link to="/docs/quickstart">Quickstart</Link>.
+          <CodeBlock
+            code={`npm i -g @jsonbored/gittensory-mcp
+gittensory-mcp --help`}
+          />
+        </li>
+        <li>
+          <strong>Sign in.</strong> GitHub Device Flow — no PAT storage.
+          <CodeBlock
+            code={`gittensory-mcp login
+gittensory-mcp whoami`}
+          />
+        </li>
+        <li>
+          <strong>Run diagnostics.</strong> Confirms API reachability, auth, source-upload posture,
+          and optional local score-preview wiring.
+          <CodeBlock code="gittensory-mcp doctor" />
+        </li>
+        <li>
+          <strong>Plan next work.</strong> Ranked actions, lane context, and blockers —
+          copilot-only; does not open PRs or post comments.
+          <CodeBlock
+            code={`gittensory-mcp agent plan --login your-login --json
+# optional: --repo owner/repo`}
+          />
+        </li>
+        <li>
+          <strong>Preflight the branch.</strong> Branch blockers, queue pressure, and maintainer-fit
+          notes before you push.
+          <CodeBlock
+            code={`gittensory-mcp analyze-branch --login your-login --json
+gittensory-mcp preflight --login your-login --json`}
+          />
+        </li>
+        <li>
+          <strong>Prepare a public-safe packet.</strong> Maintainer-readable PR description with no
+          private scoring language.
+          <CodeBlock
+            code={`gittensory-mcp agent packet --login your-login --repo owner/repo --json`}
+          />
+        </li>
+      </ol>
+      <p>
+        Wire the same tools into Codex, Claude Desktop, or Cursor via{" "}
+        <Link to="/docs/mcp-clients">MCP client setup</Link>. Signed-in miners can also use the{" "}
+        <Link to="/app/workbench">Workbench</Link> and <Link to="/app/miner">Miner dashboard</Link>{" "}
+        in the control panel.
+      </p>
+
+      <h2>Maintainer journey</h2>
+      <p>
+        Maintainers install the GitHub App, configure per-repo policy, preview what could appear on
+        a confirmed-miner PR, then pull context on demand.
+      </p>
+      <ol>
+        <li>
+          <strong>Install the GitHub App.</strong> Choose repositories and approve permissions —
+          default posture is silence. See <Link to="/docs/github-app">GitHub App setup</Link>.
+        </li>
+        <li>
+          <strong>Configure settings.</strong> Opt in to at most one configured label and one sticky
+          sanitized comment per confirmed-miner PR. Tune repo policy in installation settings or via
+          the API.
+        </li>
+        <li>
+          <strong>Preview the public surface.</strong> Dry-run what would be written to GitHub
+          without mutating state.
+          <CodeBlock
+            lang="http"
+            code={`POST /v1/repos/:owner/:repo/settings-preview
+# body: sample PR fields + desired policy flags`}
+          />
+          <p>
+            The signed-in <Link to="/app/maintainer">Maintainer console</Link> and{" "}
+            <Link to="/app/repos">Repos</Link> tab surface the same preview diff when live data is
+            available.
+          </p>
+        </li>
+        <li>
+          <strong>Use maintainer commands.</strong> On-demand context in the PR thread — output
+          stays maintainer-scoped when appropriate.
+          <CodeBlock
+            code={`@gittensory help
+@gittensory preflight
+@gittensory blockers
+@gittensory duplicate-check
+@gittensory miner-context
+@gittensory next-action`}
+          />
+        </li>
+      </ol>
+      <p>
+        Deeper workflow: <Link to="/docs/maintainer-workflow">Maintainer workflow</Link>. Privacy
+        rules: <Link to="/docs/privacy-security">Privacy & security</Link>.
+      </p>
+
+      <h2>Repo owner journey</h2>
+      <p>
+        Repo owners care about registration readiness and sensible <code>.gittensor.yml</code>{" "}
+        configuration before promoting labels or maintainer-cut policy.
+      </p>
+      <ol>
+        <li>
+          <strong>Run a readiness report.</strong> Blockers, warnings, recommended registration
+          mode, and issue policy — private API only.
+          <CodeBlock lang="http" code={`GET /v1/repos/:owner/:repo/registration-readiness`} />
+        </li>
+        <li>
+          <strong>Review config guidance.</strong> Recommended config diff with reasons and
+          tradeoffs — apply via PR when ready.
+          <CodeBlock
+            lang="http"
+            code={`GET /v1/repos/:owner/:repo/gittensor-config-recommendation`}
+          />
+        </li>
+        <li>
+          <strong>Use the control panel.</strong> Open <Link to="/app/owner">Repository owner</Link>{" "}
+          (or the Owner tab under <Link to="/app/repos">Repos</Link>) to inspect the same signals
+          with a live repo selector after you sign in with GitHub.
+        </li>
+      </ol>
+      <p>
+        Readiness is separate from upstream drift: a repo can look ready while Gittensor rules are
+        stale. Check <Link to="/docs/upstream-drift">Upstream drift</Link> when you change scoring
+        assumptions.
+      </p>
+
+      <h2>Operator journey</h2>
+      <p>
+        Operators watch deployment health, product usage, value rollups, and upstream drift across
+        installations. These surfaces are private and authenticated — never mirrored to public
+        GitHub comments.
+      </p>
+      <ol>
+        <li>
+          <strong>Open usage & value.</strong> Weekly rollups, activation status, and
+          noise-reduction metrics in the control panel.
+          <p>
+            <Link to="/app/operator">Operator dashboard</Link> — backed by{" "}
+            <code>GET /v1/app/operator-dashboard</code>.
+          </p>
+        </li>
+        <li>
+          <strong>Read the weekly value report.</strong> Summary lines plus rollup freshness and
+          warnings when backfills lag or fidelity degrades.
+        </li>
+        <li>
+          <strong>Check drift status.</strong> Compare ruleset snapshots and signal fidelity before
+          trusting miner or maintainer guidance.
+          <CodeBlock
+            lang="http"
+            code={`GET /v1/upstream/drift
+GET /v1/upstream/status
+GET /v1/readiness`}
+          />
+        </li>
+      </ol>
+      <p>
+        When drift is not <code>current</code>, treat MCP and API responses as tied to the printed
+        ruleset version. See <Link to="/docs/upstream-drift">Upstream drift</Link> for semantics.
+      </p>
+
+      <h2>Public vs private boundaries</h2>
+      <p>
+        Public GitHub output must never include wallets, hotkeys, payout or reward estimates, raw
+        trust scores, public score estimates, private reviewability details, or farming language.
+        Private MCP, API, and control-panel surfaces may show authenticated scoreability, blockers,
+        projections, and evidence — framed as guidance, not guaranteed outcomes.
+      </p>
+      <Callout variant="safety">
+        If you are unsure whether copy belongs on a PR thread, start with a maintainer packet or MCP
+        preflight. Public comments stay advisory and sanitized; richer context stays in private
+        channels.
+      </Callout>
+
+      <h2>Next steps</h2>
+      <ul>
+        <li>
+          Miners: <Link to="/docs/quickstart">Quickstart</Link> →{" "}
+          <Link to="/docs/miner-workflow">Miner workflow</Link>
+        </li>
+        <li>
+          Maintainers: <Link to="/docs/github-app">GitHub App</Link> →{" "}
+          <Link to="/docs/maintainer-workflow">Maintainer workflow</Link>
+        </li>
+        <li>
+          Repo owners: <Link to="/app/owner">Owner console</Link> +{" "}
+          <Link to="/docs/privacy-security">Privacy & security</Link>
+        </li>
+        <li>
+          Operators: <Link to="/app/operator">Operator dashboard</Link> +{" "}
+          <Link to="/docs/upstream-drift">Upstream drift</Link>
+        </li>
+      </ul>
+    </DocsPage>
+  );
+}
diff --git a/apps/gittensory-ui/src/routes/docs.index.tsx b/apps/gittensory-ui/src/routes/docs.index.tsx
index 93c65c7df6..d8f09e3db9 100644
--- a/apps/gittensory-ui/src/routes/docs.index.tsx
+++ b/apps/gittensory-ui/src/routes/docs.index.tsx
@@ -1,5 +1,5 @@
 import { createFileRoute, Link } from "@tanstack/react-router";
-import { ArrowRight, Bot, Building2, Compass, Shield } from "lucide-react";
+import { ArrowRight, Bot, Building2, Compass, Gauge, Shield } from "lucide-react";
 import type { ReactNode } from "react";
 
 import { DocsPage } from "@/components/site/docs-page";
@@ -31,7 +31,7 @@ function DocsIndex() {
     <DocsPage
       eyebrow="Documentation"
       title="Pick your path."
-      description="Docs are grouped by who you are. Start in the lane that fits, then dip into core concepts when you need depth."
+      description="Docs are grouped by who you are. Start with beta onboarding for a role-first path, then dip into core concepts when you need depth."
     >
       <div className="not-prose grid gap-4 sm:grid-cols-2">
         {AUDIENCES.map((a) => (
@@ -55,8 +55,9 @@ const AUDIENCES: Audience[] = [
     icon: <Compass className="size-4" />,
     title: "Miners",
     description: "Plan better work, preflight branches, prepare PR packets.",
-    primary: { to: "/docs/quickstart", label: "Quickstart" },
+    primary: { to: "/docs/beta-onboarding", label: "Beta onboarding" },
     links: [
+      { to: "/docs/quickstart", label: "Quickstart" },
       { to: "/docs/miner-workflow", label: "Miner workflow" },
       { to: "/docs/branch-analysis", label: "Branch analysis" },
       { to: "/docs/scoreability", label: "Scoreability" },
@@ -66,8 +67,9 @@ const AUDIENCES: Audience[] = [
     icon: <Shield className="size-4" />,
     title: "Maintainers",
     description: "Confirmed-miner context, sanitized comments, no noisy checks.",
-    primary: { to: "/docs/github-app", label: "Install the GitHub App" },
+    primary: { to: "/docs/beta-onboarding", label: "Beta onboarding" },
     links: [
+      { to: "/docs/github-app", label: "Install the GitHub App" },
       { to: "/docs/maintainer-workflow", label: "Maintainer workflow" },
       { to: "/docs/upstream-drift", label: "Upstream drift" },
       { to: "/docs/ai-summaries", label: "AI summaries policy" },
@@ -77,12 +79,24 @@ const AUDIENCES: Audience[] = [
     icon: <Building2 className="size-4" />,
     title: "Repo owners",
     description: "Registration readiness, label policy, repo settings preview.",
-    primary: { to: "/docs/github-app", label: "App install + scopes" },
+    primary: { to: "/docs/beta-onboarding", label: "Beta onboarding" },
     links: [
+      { to: "/app/owner", label: "Owner console" },
       { to: "/docs/privacy-security", label: "Privacy & security" },
       { to: "/docs/troubleshooting", label: "Troubleshooting" },
     ],
   },
+  {
+    icon: <Gauge className="size-4" />,
+    title: "Operators",
+    description: "Usage rollups, weekly value report, upstream drift across deployments.",
+    primary: { to: "/docs/beta-onboarding", label: "Beta onboarding" },
+    links: [
+      { to: "/app/operator", label: "Operator dashboard" },
+      { to: "/docs/upstream-drift", label: "Upstream drift" },
+      { to: "/docs/troubleshooting", label: "Troubleshooting" },
+    ],
+  },
   {
     icon: <Bot className="size-4" />,
     title: "Agent authors",
diff --git a/apps/gittensory-ui/src/routes/docs.quickstart.tsx b/apps/gittensory-ui/src/routes/docs.quickstart.tsx
index 826cf97d2d..e2ed31669b 100644
--- a/apps/gittensory-ui/src/routes/docs.quickstart.tsx
+++ b/apps/gittensory-ui/src/routes/docs.quickstart.tsx
@@ -71,7 +71,9 @@ gittensory-mcp preflight --login your-login --json`}
       <h2>4. Wire it into your coding agent</h2>
       <p>
         Print a config snippet for your editor of choice and paste it in. See{" "}
-        <a href="/docs/mcp-clients">MCP client setup</a> for the details.
+        <a href="/docs/mcp-clients">MCP client setup</a> for the details. For the full miner path
+        (plan → preflight → packet) and other roles, see{" "}
+        <a href="/docs/beta-onboarding">Beta onboarding</a>.
       </p>
       <CodeBlock
         code={`gittensory-mcp init-client --target codex
diff --git a/test/unit/docs-beta-onboarding.test.ts b/test/unit/docs-beta-onboarding.test.ts
new file mode 100644
index 0000000000..3d84f7f40b
--- /dev/null
+++ b/test/unit/docs-beta-onboarding.test.ts
@@ -0,0 +1,47 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, it } from "vitest";
+
+const BETA_ONBOARDING_PATH = resolve(
+  import.meta.dirname,
+  "../../apps/gittensory-ui/src/routes/docs.beta-onboarding.tsx",
+);
+
+describe("docs beta onboarding page", () => {
+  const source = readFileSync(BETA_ONBOARDING_PATH, "utf8");
+
+  it("documents miner MCP flow through packet", () => {
+    expect(source).toMatch(/gittensory-mcp login/);
+    expect(source).toMatch(/gittensory-mcp doctor/);
+    expect(source).toMatch(/agent plan/);
+    expect(source).toMatch(/preflight/);
+    expect(source).toMatch(/agent packet/);
+  });
+
+  it("documents maintainer GitHub App setup, preview, and commands", () => {
+    expect(source).toMatch(/GitHub App/);
+    expect(source).toMatch(/settings-preview/);
+    expect(source).toMatch(/@gittensory help/);
+    expect(source).toMatch(/@gittensory preflight/);
+  });
+
+  it("documents repo owner readiness and config guidance", () => {
+    expect(source).toMatch(/registration-readiness/);
+    expect(source).toMatch(/gittensor-config-recommendation/);
+    expect(source).toMatch(/\/app\/owner/);
+  });
+
+  it("documents operator usage, value, and drift reporting", () => {
+    expect(source).toMatch(/operator-dashboard/);
+    expect(source).toMatch(/weekly value report/i);
+    expect(source).toMatch(/upstream\/drift/);
+  });
+
+  it("positions Gittensory as independent control-plane, not official Gittensor frontend", () => {
+    expect(source).toMatch(/official Gittensor product surface/i);
+    expect(source).toMatch(/official Gittensor frontend/i);
+    expect(source).toMatch(/independent of/i);
+    expect(source).toMatch(/base-agent/i);
+    expect(source).not.toMatch(/the official Gittensor frontend/i);
+  });
+});