forge: config.anchoringUi — make the Anchors tab discoverable

The Anchors tab only surfaced once a repo had anchoring enabled — but the only
way to enable it is the /marks page, which had no tab/link when off. So the
forge's headline feature (Bitcoin anchoring) was undiscoverable unless you knew
the URL. config.anchoringUi:true now shows the Anchors tab on EVERY repo (the
page already carries the Enable pitch when a repo is unanchored); default off
keeps the legacy behavior (a plain forge shows no Bitcoin UI). +1 test (131).

Author: melvincarvalho

forge/AGENT.md

@@ -140,6 +140,12 @@ Key properties:
   commit cadence — the "rolling mark" that lets fast commits (fresh mirrors)
   coexist with slow, cheap anchoring. Default off (each commit is its own
   candidate state).
+- `anchoringUi` — when true, the repo **Anchors** tab is shown on every repo (the
+  marks page carries the Enable pitch when a repo hasn't enabled anchoring yet).
+  Default off, where the tab only appears once a repo has anchoring enabled —
+  which hides the feature (you'd have to know the `/marks` URL to turn it on). A
+  Bitcoin-forge turns this on so anchoring is discoverable; a plain forge leaves
+  it off and shows no Bitcoin UI.
 - `cspConnect: [origin, …]` — extra `connect-src` origins for a login widget
   that talks to external identity providers.
 - `pushTokenTtl`, `gitHttpBackend` — see `README.md`.

forge/plugin.js

@@ -611,6 +611,12 @@ export async function activate(api) {
   // of how many commits landed since. Lets a fast commit cadence (fresh mirrors)
   // coexist with a slow mark cadence (one super-commit per period). See recordTip.
   const sparseMarks = api.config.sparseMarks === true;
+  // Discoverability: by default the Anchors tab only appears once a repo has
+  // anchoring enabled — which hides the feature (you'd have to know the /marks
+  // URL to turn it on). A Bitcoin-forge sets anchoringUi:true to show the tab on
+  // EVERY repo (the page carries the Enable pitch when off); a plain forge that
+  // doesn't want Bitcoin UI leaves it off and stays clean.
+  const anchoringUi = api.config.anchoringUi === true;
 
   // Tier 3.5: anchoring chain, testnet4 by default. Checked FIRST, before
   // any other activation work. Mainnet is REFUSED at
@@ -1940,9 +1946,10 @@ ${body}
       ['commits', 'Commits', `${base}/commits/${branch}`],
       ['branches', 'Branches', `${base}/branches`],
       ['tags', 'Tags', `${base}/tags`],
-      // Anchors only surfaces once the owner enabled anchoring (the marks
-      // page itself always exists — it carries the Enable pitch).
-      ...(marksEnabled(owner, name) ? [['anchors', 'Anchors', `${base}/marks`]] : []),
+      // Anchors: always shown when config.anchoringUi is on (discoverable — the
+      // marks page carries the Enable pitch when off); otherwise legacy behavior,
+      // surfacing only once the owner has enabled anchoring on this repo.
+      ...((anchoringUi || marksEnabled(owner, name)) ? [['anchors', 'Anchors', `${base}/marks`]] : []),
     ].map(([id, label, href]) => `<a class="tab${tab === id ? ' active' : ''}" href="${href}">${label}</a>`).join('');
     return `<div class="repo-strip"><div class="container">
 <div class="crumb">${ICON_REPO} <a href="${prefix}/${owner}">${esc(dispOwner(owner))}</a><span class="muted">/</span><a href="${base}"><b>${esc(name)}</b></a>

forge/test.js

@@ -2450,6 +2450,30 @@ describe('forge plugin', () => {
 // ---------------------------------------------------------------------------
 // Sparse marking (config.sparseMarks): the trailing UNFUNDED mark is re-targeted
 // at each new tip instead of stacked, so anchoring HEAD is one tx per period.
+describe('forge anchoringUi — the Anchors tab is discoverable when enabled', () => {
+  let jss; let base; let owner;
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'forge-anchui-'));
+  const g = (args, opts = {}) => git(args, { ...opts, env: { HOME: tmp, ...(opts.env ?? {}) } });
+  before(async () => {
+    fs.writeFileSync(path.join(tmp, '.gitconfig'), '[user]\n\temail = a@e.org\n\tname = A\n[init]\n\tdefaultBranch = main\n');
+    jss = await startJss({ idp: true, plugins: [{ id: 'forge', module: module_, prefix: '/forge', config: { anchoringUi: true } }] });
+    base = jss.base;
+    owner = await registerAndMint(base, 'anchy');
+    const w = path.join(tmp, 'r'); fs.mkdirSync(w, { recursive: true });
+    fs.writeFileSync(path.join(w, 'a.txt'), '1\n');
+    await g(['init', '--quiet'], { cwd: w }); await g(['add', '-A'], { cwd: w }); await g(['commit', '--quiet', '-m', 'c1'], { cwd: w });
+    await g([...authFlag(owner.access_token), 'push', `${base}/forge/anchy/r.git`, 'main'], { cwd: w });
+  });
+  after(async () => { if (jss) await jss.close(); fs.rmSync(tmp, { recursive: true, force: true }); });
+
+  it('shows the Anchors tab on a repo that has NOT enabled anchoring (page carries the Enable pitch)', async () => {
+    const html = await (await fetch(`${base}/forge/anchy/r`)).text();
+    assert.match(html, /class="tab[^"]*" href="\/forge\/anchy\/r\/marks">Anchors<\/a>/, 'Anchors tab present with anchoringUi on');
+    const marks = await (await fetch(`${base}/forge/anchy/r/marks`)).text();
+    assert.match(marks, /Anchoring is not enabled/, 'the marks page shows the enable pitch');
+  });
+});
+
 describe('forge sparse marking (config.sparseMarks re-targets, does not stack)', () => {
   let jss; let base; let owner; let wdir;
   const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'forge-sparse-'));