faf-cli 8.2.1 → 8.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,8 +2,8 @@ import type { FafData } from '../core/types.js';
2
2
  /** Read CLAUDE.md from a directory. A CLAUDE.md link that leaves the
3
3
  * directory, or leads to a file that is not an AI context file, is refused
4
4
  * (SafePathError) and nothing is read; CLAUDE.md → AGENTS.md is read
5
- * through. A CLAUDE.md that is not UTF-8 is refused too (`faf sync --direction
6
- * pull` writes what it reads into project.faf). */
5
+ * through. A CLAUDE.md that is not UTF-8 is refused too. Library export;
6
+ * `faf sync` never reads CLAUDE.md back into project.faf. */
7
7
  export declare function readClaudeMd(dir: string): string | null;
8
8
  /** Write CLAUDE.md — non-destructive: injects/updates the faf block, preserves the rest. */
9
9
  export declare function writeClaudeMd(dir: string, content: string): void;
@@ -11,7 +11,7 @@ import { type KeptAlias } from '../core/yaml-edit.js';
11
11
  * through as it is. Every command that hands project.faf (or a .fafb) to
12
12
  * the kernel calls it through here, after it has read the file as a .faf
13
13
  * ({@link readFaf}, or {@link readFafFromString} with the path); one that
14
- * edits project.faf (`faf auto`, `faf go`, `faf sync --direction pull`)
14
+ * edits project.faf (`faf auto`, `faf go`)
15
15
  * asks the kernel before it writes, so the line is true. `faf diff` and
16
16
  * `faf log` score a version the kernel cannot read as 0 instead. */
17
17
  export declare function withKernel<T>(path: string, call: () => T): T;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "faf-cli",
3
- "version": "8.2.1",
3
+ "version": "8.2.2",
4
4
  "description": "Persistent AI context + memory — .faf and .fafm, IANA-registered. Anthropic-merged.",
5
5
  "type": "module",
6
6
  "icon": "https://faf.one/orange-smiley.svg",
package/project.faf CHANGED
@@ -1,8 +1,8 @@
1
1
  faf_version: "3.0"
2
2
  project:
3
3
  name: faf-cli
4
- version: "8.2.1"
5
- goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v8.2.1 The Ladder Edition — scored by the always-33 engine."
4
+ version: "8.2.2"
5
+ goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v8.2.2 The Ladder Edition — scored by the always-33 engine."
6
6
  main_language: TypeScript
7
7
  type: cli # found: package.json bin
8
8
  # Commands + key_files feed `faf export --agents` (hand values win over detection).
@@ -61,7 +61,7 @@ human_context:
61
61
  what: Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-merged.
62
62
  why: Eliminates 91% context re-discovery tax — define once, AI remembers forever
63
63
  where: npm registry, Homebrew, GitHub
64
- when: Production since September 2025; Bun-native since v6; current package 8.2.1 (always-33 engine)
64
+ when: Production since September 2025; Bun-native since v6; current package 8.2.2 (always-33 engine)
65
65
  how: bunx faf-cli auto, then project.faf versions with your code — faf show renders it human-visible
66
66
  monorepo:
67
67
  packages_count: slotignored