faf-cli 6.16.0 → 7.0.0

package/dist/interop/faf.d.ts

@@ -7,8 +7,16 @@ export declare function readFaf(path: string): FafData;
  *  rendered as a `# found: <list>` YAML comment next to the `type:` field —
  *  Glass Hood doctrine: the user sees WHY the cli classified the project as
  *  it did. `_meta` is a runtime hint, never a serialized .faf field. */
+/** Serialize .faf data to YAML text (the exact bytes writeFaf would write).
+ *  Strips runtime `_meta` and renders its `found` rationale as a `# found:`
+ *  comment by `type:`. Used by writeFaf and by `faf git --stdout`. */
+export declare function serializeFaf(data: FafData): string;
 export declare function writeFaf(path: string, data: FafData): void;
 /** Read raw YAML text from a .faf file */
 export declare function readFafRaw(path: string): string;
+/** Parse .faf data from a YAML string — e.g. the output of `git show <ref>:project.faf`.
+ *  The readers above are path-only; `faf diff` needs to parse a version that
+ *  lives in git history, never on disk. */
+export declare function readFafFromString(text: string): FafData;
 /** Find the .faf file in a directory (walks up) */
 export declare function findFafFile(dir?: string): string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "6.16.0",
+  "version": "7.0.0",
   "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

@@ -29,7 +29,7 @@ human_context:
   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
+  when: Production since September 2025; v7.0 The GIT Version, June 2026
   how: bunx faf-cli auto, then project.faf versions with your code — faf show renders it human-visible
 monorepo:
   packages_count: slotignored