faf-cli 6.11.0 → 6.12.0

package/dist/interop/servercard.d.ts

@@ -0,0 +1,61 @@
+import type { FafData } from '../core/types.js';
+/**
+ * Generate an MCP Server Card (SEP-2127) from a .faf.
+ *
+ * The card is a published discovery manifest. By design it carries the FAF
+ * context-block in `_meta["one.faf/context"]` — so every Server Card produced
+ * through FAF ships FAF context by default. This emitter is the SINGLE SOURCE of
+ * the block — faf-server-card-ref and `.fafa` provenance compose it (never
+ * hand-roll), so every surface is byte-identical by construction: one context,
+ * one source, every door.
+ *
+ * Honest-first: no score is baked (it would go stale on disk); the block points
+ * to the .faf and asserts the score is deterministic. The card omits `remotes`
+ * unless a deployment URL is supplied — it must not claim an endpoint it lacks.
+ */
+export interface ServerCardOptions {
+    /** Pointer to the .faf context (default: ./project.faf). Pass an absolute URL
+     *  for a remote/served card (e.g. faf-server-card-ref at context.faf.one). */
+    fafPointer?: string;
+    /** Optional live endpoint; adds a streamable-http remote when set. */
+    remoteUrl?: string;
+    /** Optional "verify the score here" URL — makes verify-don't-trust actionable
+     *  (faf-server-card-ref uses https://faf.one). Omitted from the block if unset. */
+    scoreEndpoint?: string;
+    /** Override timestamp (tests); otherwise .faf `generated`, else now. */
+    now?: string;
+}
+/**
+ * The canonical FAF context-block — the value of `_meta["one.faf/context"]`,
+ * identical across every surface (Server Card, registry `server.json`, `.fafa`):
+ * one context, every door. Honest-first: no score baked (it would go stale on
+ * disk); it points to the .faf and asserts the score is deterministic.
+ */
+export declare function fafContextBlock(data: FafData, opts?: ServerCardOptions): Record<string, unknown>;
+/** Build the Server Card object from .faf data. */
+export declare function generateServerCard(data: FafData, opts?: ServerCardOptions): Record<string, unknown>;
+export declare const REGISTRY_PUBLISHER_KEY = "io.modelcontextprotocol.registry/publisher-provided";
+/**
+ * Build the `_meta` for an MCP Registry `server.json`.
+ *
+ * The SAME canonical context-block as the Server Card, but nested under
+ * `io.modelcontextprotocol.registry/publisher-provided` — the ONLY `_meta` key
+ * the official registry preserves on publish. Top-level keys (the way the card
+ * carries `one.faf/context`) are silently dropped by the registry. Throws if the
+ * block exceeds the registry's 4KB cap. Merge the result into an existing
+ * `server.json` `_meta`; don't regenerate the manifest (packages/mcpb are tuned).
+ */
+export declare function registryMeta(data: FafData, opts?: ServerCardOptions): Record<string, unknown>;
+/** The canonical reverse-DNS registry name, e.g. `one.faf/claude-faf-mcp`.
+ *
+ *  HOMEPAGE REQUIRED: the namespace is derived from `project.homepage`'s host
+ *  (faf.one -> one.faf). With no homepage/website/url the namespace falls back
+ *  to `local/<name>`. This can't silently ship — the migration is guarded
+ *  (`rewrite-server-json.ts` refuses any name that isn't `one.faf/*`) — but set
+ *  `homepage: https://faf.one` in the .faf to get the correct `one.faf/<name>`. */
+export declare function registryName(data: FafData): string;
+/** Write the Server Card to a `server-card` file. Returns the path.
+ *  Per experimental-ext-server-card#22 the reserved location is
+ *  `<streamable-http-url>/server-card` (no longer `.well-known`); serve the
+ *  emitted file there as `application/mcp-server-card+json`. */
+export declare function writeServerCard(dir: string, data: FafData, opts?: ServerCardOptions): string;

package/dist/interrogate/cargo.d.ts

@@ -5,6 +5,6 @@
  * package.json's `description` — a one-line elevator pitch. It maps to
  * `project.goal` (overarching/use-case framing).
  */
-import type { ExtractedContext } from './types.js';
+import { type ExtractedContext } from './types.js';
 /** Read Cargo.toml and extract per-slot content. Returns {} if no Cargo.toml. */
 export declare function interrogateCargo(dir: string): ExtractedContext;

package/dist/interrogate/readme.d.ts

@@ -6,7 +6,7 @@
  *   If the anchor is missing or the content fails validation → return undefined.
  *   No slot is synthesized from another slot's content.
  */
-import type { ExtractedContext } from './types.js';
+import { type ExtractedContext } from './types.js';
 /** Extract `project.goal` — first prose paragraph or ## Use Case / ## Goal */
 export declare function extractGoal(content: string): string | undefined;
 /** Extract `human_context.what` — ## About / ## Description / ## Overview */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "faf-cli",
-  "version": "6.11.0",
-  "description": "Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-approved.",
+  "version": "6.12.0",
+  "description": "Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-merged.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",
   "logo": "https://faf.one/orange-smiley.svg",
@@ -25,7 +25,8 @@
   ],
   "scripts": {
     "dev": "bun src/cli.ts",
-    "build": "bun build src/cli.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open && bun build src/index.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "build": "bun run clean && bun build src/cli.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open && bun build src/index.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open && tsc -p tsconfig.build.json",
     "compile": "bun build src/cli.ts --compile --bytecode --minify --outfile faf",
     "compile:all": "bun build src/cli.ts --compile --bytecode --minify --target=bun-darwin-arm64 --outfile faf-darwin-arm64 && bun build src/cli.ts --compile --bytecode --minify --target=bun-darwin-x64 --outfile faf-darwin-x64 && bun build src/cli.ts --compile --bytecode --minify --target=bun-linux-x64 --outfile faf-linux-x64 && bun build src/cli.ts --compile --bytecode --minify --target=bun-windows-x64 --outfile faf-windows-x64.exe",
     "test": "bun test --timeout=120000",

package/project.faf

@@ -26,7 +26,7 @@ stack:
   storage: slotignored
 human_context:
   who: Developers and teams using AI coding assistants
-  what: Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-approved.
+  what: Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-merged.
   why: Eliminates 91% context re-discovery tax — define once, AI remembers forever
   where: npm registry, Homebrew, GitHub
   when: Production since September 2025, v6.0 March 2026