faf-cli 7.1.4 → 7.2.0

package/dist/fafm/from-claude-dir.d.ts

@@ -0,0 +1,14 @@
+/**
+ * fromClaudeDir — Claude Code memory store → knowledge Soul.
+ * Cite: claude-fafm-sdk 1.0 / fafm-engine serialize_memory approach.
+ * Not the proof convert_md_to_fafm (entries/v1.0 anti-pattern).
+ */
+import { Soul } from './soul.js';
+export declare const DEFAULT_SKIP: Set<string>;
+/**
+ * Convert a Claude Code memory directory into a knowledge Soul.
+ */
+export declare function fromClaudeDir(path: string, opts?: {
+    namepoint?: string;
+    skip?: Set<string>;
+}): Soul;

package/dist/fafm/index.d.ts

@@ -0,0 +1,4 @@
+/** .fafm knowledge-profile library (TS) — INTEROP with claude-fafm-sdk 1.0 */
+export { PRIORITY_ORDER, PRIORITY_RANK, KNOWLEDGE_TYPES, type Fact, type Priority, type Profile, type SoulDoc, } from './types.js';
+export { Soul, utcNow, canonicalPriority, factFromObj, factToObj, } from './soul.js';
+export { fromClaudeDir, DEFAULT_SKIP } from './from-claude-dir.js';

package/dist/fafm/soul.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Soul — local .fafm model (TS mirror of claude-fafm-sdk 1.0 Soul).
+ * INTEROP: load/save fidelity, residual preserve, recall SoT.
+ */
+import { type Fact, type SoulDoc } from './types.js';
+export declare function utcNow(): string;
+export declare function canonicalPriority(p: string | null | undefined): string;
+export declare function factFromObj(obj: unknown): Fact;
+export declare function factToObj(f: Fact): unknown;
+export declare class Soul {
+    namepoint: string;
+    profile: string;
+    retention: string;
+    created: string;
+    last_etched: string;
+    private _facts;
+    private _byId;
+    private _index;
+    private _sessions;
+    private _preferences;
+    private _custom;
+    private _extra;
+    private _memoryExtra;
+    constructor(namepoint: string, opts?: {
+        profile?: string;
+        facts?: Fact[];
+        retention?: string;
+        created?: string | null;
+        index?: string[];
+        sessions?: unknown[];
+        preferences?: Record<string, unknown>;
+        custom?: Record<string, unknown>;
+        extra?: Record<string, unknown>;
+        memoryExtra?: Record<string, unknown>;
+    });
+    get facts(): Fact[];
+    get index(): string[];
+    get sessions(): unknown[];
+    get preferences(): Record<string, unknown>;
+    get custom(): Record<string, unknown>;
+    get extra(): Record<string, unknown>;
+    get memoryExtra(): Record<string, unknown>;
+    static load(path: string): Soul;
+    static fromFile(path: string): Soul;
+    toDoc(): SoulDoc;
+    toYaml(): string;
+    rebuildIndex(width?: number): string[];
+    save(path: string, opts?: {
+        reindex?: boolean;
+    }): string;
+    toFile(path: string, opts?: {
+        reindex?: boolean;
+    }): string;
+    add(fact: Fact): Fact;
+    etch(text: string, opts?: {
+        id?: string;
+        type?: string;
+        priority?: string;
+        tags?: string[];
+        links?: string[];
+        source?: string;
+    }): Fact;
+    recall(query?: string | null, opts?: {
+        tags?: string[];
+        type?: string;
+        minPriority?: string;
+        limit?: number | null;
+    }): Fact[];
+    getFact(id: string): Fact | null;
+    deleteFact(id: string): boolean;
+}

package/dist/fafm/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * .fafm types — INTEROP-aligned with claude-fafm-sdk 1.0.0
+ * application/vnd.fafm+yaml v1.1
+ */
+export declare const PRIORITY_ORDER: readonly ["ephemeral", "standard", "high", "critical"];
+export type Priority = (typeof PRIORITY_ORDER)[number];
+export declare const PRIORITY_RANK: Record<string, number>;
+export declare const KNOWLEDGE_TYPES: Set<string>;
+export declare const KNOWN_DOC_KEYS: Set<string>;
+export declare const KNOWN_MEMORY_KEYS: Set<string>;
+export declare const LEGACY_PRIORITY: Record<string, Priority>;
+export interface Fact {
+    text: string;
+    id?: string | null;
+    type?: string | null;
+    priority: Priority | string;
+    tags: string[];
+    links: string[];
+    timestamp?: string | null;
+    source?: string | null;
+    /** Unknown fact fields (INTEROP §4) */
+    extra: Record<string, unknown>;
+}
+export type Profile = 'voice' | 'knowledge';
+export interface SoulDoc {
+    version: string;
+    profile: string;
+    namepoint: string;
+    created: string;
+    last_etched: string;
+    retention: string;
+    index: string[];
+    memory: {
+        facts: unknown[];
+        sessions: unknown[];
+        preferences: Record<string, unknown>;
+        custom: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}

package/dist/index.d.ts

@@ -8,6 +8,8 @@ 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 type { ServerCardOptions } from './interop/servercard.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';
 export type { InterviewQuestion, InterviewOption, HumanSlotPath, SourcedSlotPath, GoalSeed, TableOf8, TableOf8Row, BoxStatus } from './core/interview.js';
 export { INTERVIEW, SIX_WS_INTERVIEW, STACK_INTERVIEW, INTERVIEW_BY_PATH, INTERVIEW_PATHS, INTERVIEW_VERSION, questionForSlot, interviewForMissing, seedSixWsFromGoal, buildTableOf8, } from './core/interview.js';
 export type { LoopStatus, LoopGaps, LoopVerdict, LoopRunStatus, LoopDeps, LoopRunOptions, LoopRunResult } from './core/loop.js';