feat(ui): maintainer onboarding — hero install button + config-as-code docs

.gittensory.yml

@@ -1,4 +1,4 @@
 # Gittensory repo focus manifest — machine-readable contributor policy for this project.
 # Private maintainerNotes stay in authenticated API surfaces only.
 
 source: repo_file
@@ -48,6 +48,16 @@
   #   provider: anthropic      # anthropic | openai — which BYOK provider (the secret key is set via the dashboard, never here)
   #   model: claude-3-5-sonnet-latest   # optional model override for the BYOK write-up
 
+# Public review-panel content overrides (config-as-code). Maintainer text is dropped if it fails the
+# public-safe filter; the Gittensor attribution + register link always stay appended to the footer.
+# review:
+#   footer:
+#     text: "Reviewed by the Acme maintainer bot."     # custom lead line (attribution still appended)
+#   note: "Run the test suite before requesting review."   # short intro line shown above the panel
+#   fields:                                             # show/hide rows (default: all shown). Keys:
+#     relatedWork: false                                # linkedIssue | relatedWork | reviewLoad |
+#     openPrQueue: false                                # validationEvidence | openPrQueue | contributorContext | gateResult
+
 publicNotes:
   - Prefer backend Workers, MCP, GitHub App, registry, and scoring work when scope allows.
   - Focused control-panel UI changes are welcome when they use live API data or honest empty/error states and tie to safety, release readiness, or operator-facing analytics.

apps/gittensory-ui/src/routes/docs.github-app.tsx

@@ -1,4 +1,4 @@
 import { createFileRoute, Link } from "@tanstack/react-router";
 
 import { DocsPage } from "@/components/site/docs-page";
 import { CodeBlock, Callout } from "@/components/site/primitives";
@@ -124,6 +124,44 @@
         <code>qualityGateMinScore</code> threshold is configured.
       </p>
 
+      <h2>
+        Configure as code (<code>.gittensory.yml</code>)
+      </h2>
+      <p>
+        Every setting can be committed to <code>.gittensory.yml</code> at the repo root instead of,
+        or layered over, the dashboard. Precedence is <code>.gittensory.yml</code> &gt; repository
+        settings &gt; safe defaults; an unset field falls back to the next layer. It only chooses{" "}
+        <em>what</em> Gittensory does — only confirmed Gittensor contributors are ever hard-blocked,
+        regardless of config.
+      </p>
+      <CodeBlock
+        lang="yaml"
+        code={`# Repository settings as code — any dashboard toggle:
+settings:
+  gateCheckMode: enabled        # the Gate on/off
+  checkRunMode: enabled         # the advisory Context check on/off
+  commentMode: detected_contributors_only
+  publicSurface: comment_only
+
+# Friendly gate alias (wins over settings: for gate fields):
+gate:
+  enabled: true                 # Gate on/off
+  linkedIssue: advisory         # block | advisory | off
+  duplicates: block
+  readiness: { mode: advisory, minScore: 60 }
+
+# Public review-panel content:
+review:
+  footer: { text: "Reviewed by our bot." }   # custom lead — the Gittensor register link is always appended
+  note: "Run npm test before requesting review."
+  fields: { relatedWork: false }              # show/hide individual panel rows`}
+      />
+      <p>
+        Maintainer-supplied footer and note text is dropped if it contains forbidden public language
+        (reward, score, wallet, hotkey, payout, etc.); the Gittensor attribution and register link
+        always remain on the footer.
+      </p>
+
       <h2>Dogfood mode</h2>
       <p>
         For repos like <code>JSONbored/gittensory</code> and <code>awesome-claude</code>, enable PR

apps/gittensory-ui/src/routes/index.tsx

@@ -1,4 +1,4 @@
 import { createFileRoute, Link } from "@tanstack/react-router";
 import { useEffect, useState } from "react";
 import { Check, Copy } from "lucide-react";
 import { toast } from "sonner";
@@ -13,6 +13,9 @@
 import { describeApiStatus, pingHealth, useApiStatus } from "@/lib/api/status";
 import { MCP_PACKAGE_NAME, getLatestMcpVersion, useMcpPackageMetadata } from "@/lib/mcp-package";
 
+/** Canonical GitHub App install URL (app slug `gittensory`) — dead-simple one-click maintainer onboarding. */
+const GITHUB_APP_INSTALL_URL = "https://github.com/apps/gittensory/installations/new";
+
 export const Route = createFileRoute("/")({
   head: () => ({
     meta: [
@@ -75,6 +78,14 @@
             Plan better work, preflight branches, and keep maintainer review surfaces quiet.
           </p>
           <div className="mt-7 flex flex-wrap items-center gap-2">
+            <a
+              href={GITHUB_APP_INSTALL_URL}
+              target="_blank"
+              rel="noreferrer"
+              className="inline-flex h-9 items-center justify-center gap-1.5 whitespace-nowrap rounded-token bg-coral px-4 text-token-sm font-medium text-primary-foreground transition-[filter,transform] duration-150 hover:brightness-110 active:scale-[0.98] focus-ring motion-reduce:transition-none motion-reduce:active:scale-100"
+            >
+              Install the GitHub App →
+            </a>
             <Link
               to="/docs/quickstart"
               className="inline-flex h-9 items-center justify-center gap-1.5 whitespace-nowrap rounded-token bg-coral px-4 text-token-sm font-medium text-primary-foreground transition-[filter,transform] duration-150 hover:brightness-110 active:scale-[0.98] focus-ring motion-reduce:transition-none motion-reduce:active:scale-100"

src/config/gittensory-repo-focus-manifest.ts

@@ -1,4 +1,4 @@
 /**
  * Bundled fallback for JSONbored/gittensory when the repo file is not yet reachable
  * (local dev, pre-merge branches). Keep aligned with `.gittensory.yml` at repo root.
  */
@@ -52,6 +52,16 @@
   #   provider: anthropic      # anthropic | openai — which BYOK provider (the secret key is set via the dashboard, never here)
   #   model: claude-3-5-sonnet-latest   # optional model override for the BYOK write-up
 
+# Public review-panel content overrides (config-as-code). Maintainer text is dropped if it fails the
+# public-safe filter; the Gittensor attribution + register link always stay appended to the footer.
+# review:
+#   footer:
+#     text: "Reviewed by the Acme maintainer bot."     # custom lead line (attribution still appended)
+#   note: "Run the test suite before requesting review."   # short intro line shown above the panel
+#   fields:                                             # show/hide rows (default: all shown). Keys:
+#     relatedWork: false                                # linkedIssue | relatedWork | reviewLoad |
+#     openPrQueue: false                                # validationEvidence | openPrQueue | contributorContext | gateResult
+
 publicNotes:
   - Prefer backend Workers, MCP, GitHub App, registry, and scoring work when scope allows.
   - Focused control-panel UI changes are welcome when they use live API data or honest empty/error states and tie to safety, release readiness, or operator-facing analytics.