[Birfy]

Fixes #499

What / why (owner decision 2026-10-20, option (a): all four polish items)

1. Friend's Bot placeholder (regression of Friend's Bot chat on the receiving home: 'Tool removed' line, turns/steps/tok/s footer, composer placeholder flips to coding copy #419). The shell picks its composer copy by phase before it knows whose chat it is (hero copy on first open, coding copy after a send). HeaderPill now holds Message <Bot (owner)> through a new core/src/client/composer-label.js in a layout effect (before the first paint). It writes both aria-label and data-placeholder (before, only aria-label) and rewrites them inside the MutationObserver callback, with no rAF delay. On cleanup it gives back the shell's latest value.
2. One invite control (inviteControls in plugins/social/client.js) in Add friend → Invite a friend and in Bot settings → Sharing. Before a link exists there is one button, Copy invite link for Chief, which makes the link and copies it. After that the link shows with Copy link / Copy with instructions / New link. Every copy note names the Bot: Invite link for Chief copied. / Invite for Chief copied with instructions.
3. Add friend. The paste box is now a wrapping textarea, so the whole link shows; Enter still accepts. Typing clears a failed accept's error. After an accept that shared a Bot, the result shows for about 1.8 s, then the panel closes and opens the new friend's Bot if it is already listed. A join with no Bot, or a sent request, stays open until Done.
4. Sharing hint. It reads Invite grants Chief only. and adds Revoke anytime in People with access. only once People with access lists someone. The empty list now reads Nobody has this Bot yet. Copy an invite link above and send it to a friend. People with access only gained an onGrants count callback; its grant logic is unchanged.

Tests

• core/test/composer-label.test.js (jsdom): a friend's Bot composer reads Message Chief (SelfA1233) from the first paint (hero copy), after a send (coding copy) and after a remount, with no build/commands/@ files/sessions wording; it hands back on cleanup. looks.test.js checks that the header uses a layout effect.
• plugins/social/test/social.test.js: the same control and Bot-named copy notes in Add friend and Sharing; the error clears when you type in the paste box; Enter accepts; auto-close plus opening the friend's Bot (only when a Bot was shared); the Revoke hint; wrapping paste box.

Ran at the tip: ARCH_DOCS_BASE=origin/main TZ=UTC npm run verify passed (core 1079, social 299, tree 80, timeline 83, scripts 93, interop 37, live-e2e 16; plugin lint OK). Not run: live Mac instances, browser smoke.

Generated files were rebuilt: core/client.js, patches/ds-bot (0003/0008/0012 and new files/), changelog fragment changelog.d/499-invite-friendchat-polish.fixed.md. Docs: README (en/zh), docs/subsystems/social.md, docs/subsystems/core-client.md.

Risk tier: T2 (estimate; the controller sets the label)

[Birfy]

Self-review: PASS
Tip SHA: c74a857
Ran:

• ARCH_DOCS_BASE=origin/main TZ=UTC npm run verify: passed (core lint + arch-docs OK, plugin lint OK, build-client --check OK, ds-bot-patches check OK; core 1079/1079, social 299/299, tree 80/80, timeline 83/83, scripts 93/93, interop 37/37, live-e2e 16/16). An earlier run had one flaky failure in the unrelated connectors.test.js (it passed 3 of 3 times alone and in the full rerun).
• node .github/scripts/changelog.mjs check: 18 fragments well formed.
• CI at the tip: tests-ok, test, plugins (social/tree/timeline), package, risk tier, reviewed tip all pass.
• Diff reviewed against the owner design rules: English UI; per-Bot grants and People with access grant logic unchanged (only an onGrants count callback was added); no publish; no approval by typed reply; friend chats keep no turn limit or Extend; one + menu unchanged; hooks unconditional (ManageAccess effect before its early return, Sharing state in a new OwnBotSharing).
  Not run:
• Live Mac instances or the production Bot Social server (not touched).
• Browser smoke on two live homes (clipboard permission, wrapping textarea at sidebar width, auto-close timing); these are covered only by the unit tests and jsdom.

[Birfy]

Self-review: PASS
Tip SHA: ebc484a
Ran:

• Merged origin/main (303c0d6, includes Fit chat approvals and the Agent inbox to a phone-width screen #481/Keep live shares in People with access using Bot Social's reply_only #501/Show a friend's first line and its approval card live: read friends' inboxes fast while a window is on screen #505) into fix/499-invite-friendchat-polish; resolved docs/subsystems/social.md keeping both Fit chat approvals and the Agent inbox to a phone-width screen #481 phone hold-card 40px targets and Invite and friend-chat polish: coding-agent placeholder in a friend's Bot chat (regression of #419), two inconsistent invite UIs, Add friend leftovers, Sharing hint #499 composer-label / data-placeholder; regenerated patches/ds-bot/0008-client-bundle.patch via build-client + ds-bot-patches generate/check (2026-10-20 14:57 Asia/Shanghai).
• ARCH_DOCS_BASE=origin/main TZ=UTC npm run verify: passed (core lint + arch-docs OK, plugin lint OK, build-client --check OK, ds-bot-patches check OK; core/social/tree/timeline/scripts/interop/live-e2e all green).
• node .github/scripts/changelog.mjs check: fragments well formed.
  Not run:
• Live Mac instances or the production Bot Social server (not touched).
• Browser smoke on two live homes.

[Birfy]

Self-review: PASS
Tip SHA: eaed3f1
Ran:

• ARCH_DOCS_BASE=origin/main TZ=UTC npm run verify (pass)
• reviewed diff at tip vs owner design rules
  Not run:
• live Mac instances / production Bot Social

[Birfy]

Self-review: PASS
Tip SHA: 347f18e
Ran:

• git merge origin/main (eb91742, after Remind about approvals waiting 15 min, switch each notification kind, one notification per chat #492 and Social: neutral 'You already have …' on a re-accepted invite; clearer Remove confirm #503) into the branch, no rebase or force-push; only conflict was the generated patches/ds-bot/0008-client-bundle.patch
• generated files regenerated, not hand-merged: took main's patches/ds-bot, then (cd core && npm run build), node scripts/ds-bot-patches.mjs generate, then check: ok (10 patches apply cleanly; core/ = ds-bot/ + patches)
• ARCH_DOCS_BASE=origin/main TZ=UTC npm run verify (core lint + arch-docs, plugin lint, build-client --check, ds-bot-patches check, all suites): pass, 0 failures (core 1100, social 312, tree 80, timeline 92, .github scripts 93, interop 37, live-e2e 16)
• CI on this tip: all checks pass (tests-ok, Node 24 · DSH 0.2.0-rc.2, plugins social/timeline/tree, package, risk tier, reviewed tip); mergeable MERGEABLE, mergeStateStatus CLEAN
• re-read the diff against main at this tip: changelog.d fragment kept, no CHANGELOG.md or ds-bot/ edits, owner design rules kept (approvals only via UI buttons, English UI, no separate Friends' Bots section, no turn limit or Extend in friend chats, connector tokens only at /mcp)
  Not run:
• live Mac instances / production Bot Social