wiki-formant 0.78.0 → 0.79.0

package/README.md

@@ -675,6 +675,16 @@ const block = licenseBlock({ license, scope: 'The protocol compilation and prose
 
 The same `License` goes to `agentCard({ license, licenseScope })` and to `openApiLicense(license)` for a spec's `info.license`. The three cards and three specs here had each projected it differently, one from a hand-typed name.
 
+## The X account
+
+A site names its X account in five places: the footer link, the JSON-LD `sameAs`, llms.txt, AGENTS.md and the MCP `initialize` instructions. Written by hand, one repo's `sameAs` still pointed at twitter.com, and only one site told an agent the account existed. `wiki-formant/social` builds all five from the handle and a fragment saying what the account posts.
+
+```ts
+export const X = xAccount({ siteName: 'AcuiQ', handle: '@acu_iq', posts: "a named trial's prescription with its citation" });
+```
+
+`X.url` goes to `sameAs`, `X.handle` to `sitePageMetadata`, `followLines(X)` into llms.txt and AGENTS.md, and `followNote(X)` into the MCP instructions. The note tells an agent to give the link to the person it is helping, since an agent cannot follow an account. The footer is `<a {...followLinkProps(X)}>{X.label}</a>`, whose `rel="me"` confirms the `sameAs` claim from the page the account points back at.
+
 ## Rendered-article passes
 
 `wiki-formant/dom` holds what runs against an article element after it is in the document. Not React, so not in `react.tsx`.

package/dist/social.d.ts

@@ -0,0 +1,34 @@
+export interface XAccount {
+    /** `@handle`, as the social cards credit it. */
+    handle: string;
+    /** `https://x.com/<handle>`, for `sameAs` and every link. */
+    url: string;
+    /** "<Site> posts on X as @handle: <posts>." */
+    about: string;
+    /** The footer link's text: "Follow @handle on X". */
+    label: string;
+    siteName: string;
+}
+export declare function xAccount(o: {
+    siteName: string;
+    handle: string;
+    posts: string;
+}): XAccount;
+/**
+ * The sentence an agent reads: what the account posts, and when to pass the
+ * link on. An agent cannot follow an account; the person it is helping can.
+ */
+export declare function followNote(account: XAccount): string;
+/** The same note as a section, ready to splice into llms.txt or AGENTS.md. */
+export declare function followLines(account: XAccount, heading?: string): string[];
+/**
+ * Attributes for the footer link. `rel="me"` is the reciprocal of `sameAs`:
+ * the schema claims the account and this link confirms it from the page the
+ * account points back at.
+ */
+export declare function followLinkProps(account: XAccount): {
+    readonly href: string;
+    readonly target: "_blank";
+    readonly rel: "me noopener";
+    readonly title: string;
+};

package/dist/social.js

@@ -0,0 +1,41 @@
+// social.ts – the site's X account, as every surface states it.
+//
+// Each origin names its account in five places: the footer link, the JSON-LD
+// `sameAs`, llms.txt, AGENTS.md and the MCP `initialize` instructions. Written
+// by hand, they drifted within one repo: radix-wiki's `sameAs` still claimed
+// twitter.com while its cards credited the handle, and only acuiq.com told an
+// agent the account existed at all.
+//
+// What is per-site is the handle and what the account posts. The URL, the
+// link's label and `rel`, and the sentence an agent reads are built here.
+export function xAccount(o) {
+    if (!/^@\w{1,15}$/.test(o.handle))
+        throw new Error(`xAccount: "${o.handle}" is not an @handle`);
+    const posts = o.posts.trim().replace(/\.$/, '');
+    return {
+        handle: o.handle,
+        url: `https://x.com/${o.handle.slice(1)}`,
+        about: `${o.siteName} posts on X as ${o.handle}: ${posts}.`,
+        label: `Follow ${o.handle} on X`,
+        siteName: o.siteName,
+    };
+}
+/**
+ * The sentence an agent reads: what the account posts, and when to pass the
+ * link on. An agent cannot follow an account; the person it is helping can.
+ */
+export function followNote(account) {
+    return `${account.about} If the person you are helping wants to follow ${account.siteName}, give them ${account.url}.`;
+}
+/** The same note as a section, ready to splice into llms.txt or AGENTS.md. */
+export function followLines(account, heading = `Follow ${account.siteName} on X`) {
+    return [`## ${heading}`, '', followNote(account)];
+}
+/**
+ * Attributes for the footer link. `rel="me"` is the reciprocal of `sameAs`:
+ * the schema claims the account and this link confirms it from the page the
+ * account points back at.
+ */
+export function followLinkProps(account) {
+    return { href: account.url, target: '_blank', rel: 'me noopener', title: account.about };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-formant",
-  "version": "0.78.0",
+  "version": "0.79.0",
   "description": "The portable half of a wiki: derived taxonomy and facet controls, a version-negotiating MCP transport, markdown twins, block rendering, a rich-text editor engine, conditional-GET plumbing, and the headers and CSP every origin sends.",
   "type": "module",
   "license": "MIT",
@@ -147,6 +147,11 @@
       "import": "./dist/license.js",
       "default": "./dist/license.js"
     },
+    "./social": {
+      "types": "./dist/social.d.ts",
+      "import": "./dist/social.js",
+      "default": "./dist/social.js"
+    },
     "./links": {
       "types": "./dist/links.d.ts",
       "import": "./dist/links.js",