faf-cli 7.0.0 → 7.0.1

package/dist/interop/faf.d.ts

@@ -20,3 +20,10 @@ export declare function readFafRaw(path: string): string;
 export declare function readFafFromString(text: string): FafData;
 /** Find the .faf file in a directory (walks up) */
 export declare function findFafFile(dir?: string): string | null;
+/** Repo-root-relative path of a .faf, computed BY git — runtime- and OS-independent.
+ *  Replaces `path.relative(top, fafPath)`, which breaks on Windows when git's
+ *  long-form `--show-toplevel` and an 8.3 short-name cwd (e.g. `RUNNER~1`) disagree.
+ *  git resolves both representations internally and emits forward slashes; works for
+ *  tracked AND untracked .faf (it's the cwd's location under the root, not file status).
+ *  Caller must already be inside a git repo. */
+export declare function gitRepoRel(fafPath: string, cwd?: string): string;

package/dist/interop/servercard.d.ts

@@ -54,6 +54,15 @@ export declare function registryMeta(data: FafData, opts?: ServerCardOptions): R
  *  (`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;
+/** The display title for a registry `server.json` — the human-readable card name
+ *  (e.g. "Claude FAF"), sourced from `project.title` in the .faf. This is the
+ *  SINGLE SOURCE of the title across the fleet: JS emitters import it, and the
+ *  `faf server-card` CLI uses it so Python/Rust repos compose the identical
+ *  value (compose-not-fork). Distinct from `registryName` (the reverse-DNS id).
+ *  Returns undefined when unset or >100 chars (the registry cap) so the field is
+ *  omitted rather than shipped invalid — GitHub's registry then derives a name
+ *  from the namespace, so set `project.title` to control the display. */
+export declare function registryTitle(data: FafData): string | undefined;
 /** 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "7.0.0",
+  "version": "7.0.1",
   "description": "Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-merged.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",

package/project.faf

@@ -37,3 +37,11 @@ monorepo:
   versioning_strategy: slotignored
   shared_configs: slotignored
   remote_cache: slotignored
+surfaces:
+  # Distribution map — the machine-checkable form of human_context.where. Score-neutral.
+  auto:                      # derived from manifests; regenerate with `faf surface --sync`
+    - { type: npm,    id: faf-cli,           source: "package.json#name" }
+    - { type: github, id: Wolfe-Jam/faf-cli, source: "package.json#repository" }
+  declared:                  # hand-authored: surfaces the manifests don't carry + targets
+    - { type: npm,      id: faf,     status: live }      # dual-publish alias (faf-cli ⇄ faf)
+    - { type: homebrew, id: faf-cli, status: live }