github: PATs live in swarm bao; the agent fetches them itself

An operator links an agent's GitHub personal access token in the swarm UI
(LinkGithubAccountForm, "link github account" on /agents). swarm-controller's
PUT /api/hives/{hive}/agents/{agent}/github-account stores it at
swarm/agents/<agent>/github-token (swarm_secret_client::github), a flat leaf
under the agent's prefix that the agent's existing read grant already covers:
no policy change, and no list grant, since there is one token per agent.

In the agent, hive-agent-github-token (oneshot + 2-minute timer, as the agent
user, under its own store certificate, ordered before hive-github-notify)
reads that path and writes <state>/github-token, 0600 and agent-owned, the
file the gh wrapper, git credential helper and hive-github-notify already
read. It replaces the file by rename only when the bytes changed and never
deletes it: a hive-written github-token stays until a token is linked in the
swarm UI. It is installed only with a store address and
services.hyperhive.agent.github.enable.

Removed: the dashboard's CR3D3NTIALS page (credentials.html/js/css, its
build entries and H0M3 tile; GITHUB was its only tab), hive-c0re's
dashboard/matrix_accounts.rs with GET/POST /api/github-account,
priv_client::write_agent_github_token, the host socket's
SetAgentGithubToken and `hivectl github set-token`, and hive-priv's
WriteAgentGithubToken with write_agent_state_file, its only caller gone.

Docs: integrations/github.md and swarm/ui.md describe the swarm path,
swarm/credentials.md gains the store-path row, and the hive UI docs,
hivectl docs and security.md's hive-priv table drop the removed pieces.

Closes #4347

frontend/packages/swarm-ui/src/pages/LinkGithubAccountForm.tsx

@@ -0,0 +1,109 @@
+// <LinkGithubAccountForm> — writes a GitHub personal access token for one
+// agent into the swarm secret store.
+// PUTs `/api/hives/{hive}/agents/{agent}/github-account` — 204 on success,
+// 400/500 as `problem+json`, shown via `ApiErrorPanel` like
+// `LinkForgeAccountForm`.
+//
+// One token per agent. A blind set/update: no route says whether a token is
+// stored, and none hands one back.
+import { useState } from "preact/hooks";
+import { ApiErrorPanel } from "@hive/shared/api-error-panel.js";
+import { readApiError, type ProblemDetails } from "@hive/shared/api-error.js";
+import { Panel } from "../ui/panel/Panel.js";
+import { TextField } from "../ui/text-field/TextField.js";
+import { Button } from "../ui/button/Button.js";
+import "./LinkMatrixAccountForm.css";
+
+type SubmitState =
+  | { status: "idle" }
+  | { status: "submitting" }
+  | { status: "done" }
+  | { status: "error"; problem: ProblemDetails };
+
+export function LinkGithubAccountForm({
+  hive,
+  agent,
+  onClose,
+}: {
+  hive: string;
+  agent: string;
+  onClose?: () => void;
+}) {
+  const [token, setToken] = useState("");
+  const [result, setResult] = useState<SubmitState>({ status: "idle" });
+
+  async function submit(e: Event) {
+    e.preventDefault();
+    setResult({ status: "submitting" });
+    try {
+      const r = await fetch(
+        `/api/hives/${encodeURIComponent(hive)}/agents/${encodeURIComponent(agent)}/github-account`,
+        {
+          method: "PUT",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ token }),
+        },
+      );
+      if (!r.ok) {
+        setResult({ status: "error", problem: await readApiError(r) });
+        return;
+      }
+      setResult({ status: "done" });
+      // The store holds the token now; nothing here needs it.
+      setToken("");
+    } catch (err) {
+      setResult({ status: "error", problem: { detail: String(err) } });
+    }
+  }
+
+  return (
+    <Panel
+      title={`link a github account — ${agent}`}
+      icon="🔗"
+      onClose={onClose}
+    >
+      <p>
+        Writes the token to the swarm secret store. The agent fetches it within
+        two minutes, and its <code>gh</code> and <code>git push</code> to
+        github.com then authenticate with it. Use a dedicated bot account and a
+        minimally scoped token, created at{" "}
+        <a
+          href="https://github.com/settings/tokens"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          github.com/settings/tokens
+        </a>
+        ; GitHub notifications also need the <code>notifications</code> scope.
+      </p>
+      <form class="link-matrix-account-form" onSubmit={submit}>
+        <TextField
+          id="github-account-token"
+          label="personal access token"
+          type="password"
+          value={token}
+          required
+          onInput={setToken}
+        />
+        <Button
+          variant="primary"
+          type="submit"
+          disabled={result.status === "submitting"}
+        >
+          {result.status === "submitting" ? "linking…" : "link account"}
+        </Button>
+      </form>
+      {result.status === "done" && (
+        <p class="link-matrix-account-result-ok">
+          stored a github token for <strong>{agent}</strong>
+        </p>
+      )}
+      {result.status === "error" && (
+        <ApiErrorPanel
+          context="failed to link the account"
+          problem={result.problem}
+        />
+      )}
+    </Panel>
+  );
+}

frontend/packages/swarm-ui/src/pages/agents/AgentsPage.tsx

@@ -49,6 +49,7 @@ import { type TableColumn } from "../../ui/table/Table.js";
 import { CreateAgentForm } from "../CreateAgentForm.js";
 import { LinkMatrixAccountForm } from "../LinkMatrixAccountForm.js";
 import { LinkForgeAccountForm } from "../LinkForgeAccountForm.js";
+import { LinkGithubAccountForm } from "../LinkGithubAccountForm.js";
 import { WantedMenu } from "./WantedMenu.js";
 import "./AgentsPage.css";
 
@@ -98,6 +99,8 @@ const VIEW_MODE_KEY = "swarm-ui:agents:view-mode";
 
 export function AgentsPage() {
   const [rows, setRows] = useState<AgentRow[] | null>(null);
+  // The row showing the "link a github account" dialog, same shape.
+  const [githubTarget, setGithubTarget] = useState<AgentRow | null>(null);
   const [error, setError] = useState<ProblemDetails | null>(null);
   const [intervalMs, setIntervalMs] =
     useState<RefreshIntervalMs>(DEFAULT_INTERVAL_MS);
@@ -600,6 +603,22 @@ export function AgentsPage() {
                         : "no hive on record for this agent — nothing to link against"
                     }
                   />
+                  <Badge
+                    variant="quiet"
+                    icon={<LinkIcon />}
+                    value="link github account"
+                    onClick={
+                      detailTarget.hive
+                        ? () => setGithubTarget(detailTarget)
+                        : undefined
+                    }
+                    disabled={!detailTarget.hive}
+                    title={
+                      detailTarget.hive
+                        ? `link a github account to ${detailTarget.name}`
+                        : "no hive on record for this agent — nothing to link against"
+                    }
+                  />
                 </div>
                 {/* MVP scope per mara's own ruling: a small read-only
                     preview, no header/no input — the full terminal
@@ -651,6 +670,20 @@ export function AgentsPage() {
           />
         ) : null}
       </Dialog>
+      <Dialog
+        open={githubTarget !== null}
+        onClose={() => setGithubTarget(null)}
+        label="link a github account"
+        plain
+      >
+        {githubTarget?.hive ? (
+          <LinkGithubAccountForm
+            hive={githubTarget.hive}
+            agent={githubTarget.name}
+            onClose={() => setGithubTarget(null)}
+          />
+        ) : null}
+      </Dialog>
       <ConfirmDialog
         open={confirmTarget !== null}
         label={confirmTarget ? CONFIRM_COPY[confirmTarget.state].label : ""}