faf-cli 7.10.1 → 7.12.0

package/dist/core/drift.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Context-drift engine — SINGLE SOURCE.
+ *
+ * A pure, snapshot comparison: given a `project.faf` and its directory, report
+ * the mtime relationship between the .faf and each AI-context file it feeds
+ * (CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md). A target NEWER than the .faf
+ * has drifted — the human edited the context file and the DNA hasn't caught up.
+ *
+ * No console, no ANSI, no process.exit. The CLI `faf drift` renders the human
+ * table on top of this; `faf drift --json` emits this shape with a metadata
+ * header; the VS Code extension imports `computeDrift` directly (faf-cli as a
+ * library, never a shell-out). One comparison, every consumer.
+ */
+/** AI-context files the .faf feeds — the drift targets, in report order. */
+export declare const CONTEXT_FILES: string[];
+/** mtime window (ms) inside which a target counts as in sync with the .faf. */
+export declare const DRIFT_TOLERANCE_MS = 1000;
+/** 'newer' = target newer than the .faf → needs sync. */
+export type DriftStatus = 'newer' | 'older' | 'in-sync' | 'missing';
+export interface DriftTarget {
+    /** Context-file name, e.g. 'CLAUDE.md'. */
+    file: string;
+    /** Whether the file exists alongside the .faf. */
+    exists: boolean;
+    /** File mtime in epoch ms, or null when missing. */
+    mtime_ms: number | null;
+    /** 'newer' = target newer than the .faf → needs sync. */
+    status: DriftStatus;
+    /** mtime_ms - source_mtime_ms, or null when missing. */
+    delta_ms: number | null;
+}
+export interface DriftReport {
+    /** The `project.faf` path compared against. */
+    source: string;
+    /** .faf mtime in epoch ms. */
+    source_mtime_ms: number;
+    targets: DriftTarget[];
+    /** Count of targets with status 'newer' or 'older'. */
+    drifted: number;
+    /** Count of targets with status 'in-sync'. */
+    in_sync: number;
+    /** Count of targets with status 'missing'. */
+    missing: number;
+}
+/**
+ * Compare a `project.faf` against its AI-context files by mtime.
+ *
+ * @param fafPath  path to `project.faf`
+ * @param dir      directory holding the context files; defaults to the .faf's
+ *                 own directory. Never `process.cwd()` — the CLI passes it
+ *                 explicitly, and a library caller (the VS Code extension)
+ *                 passes the .faf's directory, which for a monorepo sub-package
+ *                 is the package dir, not the workspace root.
+ */
+export declare function computeDrift(fafPath: string, dir?: string): DriftReport;

package/dist/detect/assemble.d.ts

@@ -8,6 +8,15 @@
  */
 /** Build a fresh .faf for `dir` using the full slot-filling pipeline. */
 export declare function assembleFreshFaf(dir: string): Record<string, unknown>;
+/**
+ * Update an EXISTING .faf for `dir`. Existing values win; interrogated → detected
+ * → Turbo-Cat (formats) → Relentless (6 W's) fill only the remaining empties.
+ * This is exactly the chain `faf auto` runs on an existing file — exported so
+ * consumers (faf-mcp's faf_auto) compose it instead of re-deriving it and
+ * drifting (they used to merge assembleFreshFaf's slotignore'd output over the
+ * existing file, losing interrogated facts such as a docker-compose Redis).
+ */
+export declare function updateExistingFaf(dir: string, existing: Record<string, unknown>): Record<string, unknown>;
 /** Fill empty/placeholder slots in `target` with values from `source`.
  *  `target` wins when its slot is non-empty. Empty here is per `isPlaceholder`
  *  (covers '', null, undefined, and known placeholder strings) — this is what

package/dist/detect/enrich.d.ts

@@ -0,0 +1,11 @@
+import type { FafData } from '../core/types.js';
+/**
+ * Enrich .faf data with facts DETECTED from the repo at export time, so a lean
+ * or stale .faf still yields a complete AGENTS.md — the "frictionless, any repo"
+ * goal. Fill-if-absent: hand-authored .faf values always WIN; detection only
+ * fills the gaps. Pure (returns a shallow copy; never mutates the input).
+ *
+ * Detects: build/test/lint commands, key files/entry points, and secrets
+ * (.env presence — location only, never the values).
+ */
+export declare function enrichFromRepo(dir: string, data: FafData): FafData;

package/dist/index.d.ts

@@ -5,10 +5,12 @@ export { FAF_HEX } from './ui/colors.js';
 export { enrichScore, scoreFafYaml } from './core/scorer.js';
 export { validateFaf } from './core/schema.js';
 export { findFafFile, readFaf, readFafRaw } from './interop/faf.js';
-export { generateProjectHtml, writeProjectHtml } from './interop/projecthtml.js';
-export { generateServerCard, writeServerCard, fafContextBlock, registryMeta, registryName, REGISTRY_PUBLISHER_KEY, } from './interop/servercard.js';
+export { computeDrift } from './core/drift.js';
+export type { DriftReport, DriftTarget, DriftStatus } from './core/drift.js';
+export { renderProjectHtml, generateProjectHtml, writeProjectHtml } from './interop/projecthtml.js';
+export { buildServerCard, generateServerCard, writeServerCard, fafContextBlock, registryMeta, registryName, REGISTRY_PUBLISHER_KEY, } from './interop/servercard.js';
 export type { ServerCardOptions } from './interop/servercard.js';
-export { projectCards, readFafa, findFafaFile, generateA2ACard, upsertCatalog, A2A_CONTEXT_URI, } from './interop/cards.js';
+export { projectCards, readFafa, findFafaFile, buildA2ACard, generateA2ACard, upsertCatalog, A2A_CONTEXT_URI, } from './interop/cards.js';
 export type { FafaDoc, CardTarget, ProjectedCards } from './interop/cards.js';
 export { Soul as FafmSoul, fromClaudeDir, canonicalPriority, utcNow, PRIORITY_ORDER, PRIORITY_RANK, KNOWLEDGE_TYPES, } from './fafm/index.js';
 export type { Fact as FafmFact, SoulDoc, Profile as FafmProfile } from './fafm/index.js';
@@ -22,5 +24,14 @@ export { turboCatScan, turboCatSlots } from './detect/turbo-cat.js';
 export type { TurboCatResult, DiscoveredFormat } from './detect/turbo-cat.js';
 export { relentlessContext, relentlessContextDetailed } from './detect/relentless.js';
 export type { SeededContext, SeededContextDetailed, SourcedValue } from './detect/relentless.js';
-export { assembleFreshFaf } from './detect/assemble.js';
+export { assembleFreshFaf, updateExistingFaf, fillEmpties } from './detect/assemble.js';
+export { renderAgentsMd, writeAgentsMd } from './interop/agents.js';
+export { renderGeminiMd, writeGeminiMd } from './interop/gemini.js';
+export { renderCursorrules, writeCursorrules } from './interop/cursorrules.js';
+export { renderCopilotInstructions, writeCopilotInstructions } from './interop/copilot-instructions.js';
+export { renderClaudeMd, writeClaudeMd, readClaudeMd, parseClaudeMd, fafMetaTag } from './interop/claude.js';
+export type { FafMetaOpts } from './interop/claude.js';
+export { injectFafBlock, findFafBlock, FAF_START, FAF_END } from './interop/inject.js';
+export { enrichFromRepo } from './detect/enrich.js';
+export { serializeFaf, writeFaf } from './interop/faf.js';
 export * as kernel from './wasm/kernel.js';