v7.11.0 — The VS Code Edition

faf-cli becomes a library a VS Code extension can import — computeDrift() joins the public API and faf drift --json mirrors it on the CLI. Plus faf export --llms.

import { computeDrift, scoreFafYaml, findFafFile, generateProjectHtml } from 'faf-cli';

Added

• faf drift --json + exported computeDrift(fafPath, dir?) — the context-drift check moves to a pure function in src/core/drift.ts, exported from the package index alongside scoreFafYaml / findFafFile / generateProjectHtml. Programmatic consumers (a VS Code extension) call it directly instead of shelling out. faf drift --json is the CLI mirror: a faf_version / project / source header over the report, raw *_ms mtimes and deltas (no Date.now() in the payload). No project.faf → { error, hint } JSON, exit 2. Bare faf drift is unchanged.
• faf export --llms — writes llms.txt (llmstxt.org shape) from the authored 6 Ws. Opt-in, like --grok.

Changed

• faf hooks --install and faf diff --install wire faf-cli, not the faf alias — the canonical bin can't be shadowed by another faf on PATH.

Install

npm install -g faf-cli@7.11.0     # or: bunx faf-cli

---

1402/1402 tests. Dual-published: faf-cli@7.11.0 + faf@7.11.0. Docs: docs.faf.one/drift.

FAF defines. AGENTS.md instructs. AI codes.