faf 7.1.4 → 7.3.0

package/dist/core/tiers.d.ts

@@ -1,14 +1,16 @@
 import type { TierInfo } from './types.js';
 /** Tier boundaries — ordered from highest to lowest
  *
- * Indicators:
- *   🏆 trophy (earned at 100%)
+ * Indicators (work surfaces — CLI · code · docs · receipts):
+ *   ✪ Proof Seal (Trophy 100% — work glyph; social still uses 🏆; brand uses Trophy Mark PNG)
  *   ★ filled star (gold — orange)
  *   ◆ filled diamond (silver — cyan)
  *   ◇ open diamond (bronze — deep cyan, one rung below silver)
  *   ● filled circle (mid tiers)
  *   ○ open circle (low — dim)
  *   ♡ heart (empty — good luck)
+ *
+ * All three 100% glyphs mean the same score: ✪ work · 🏆 social · Trophy Mark (PNG) visual.
  */
 export declare const TIERS: TierInfo[];
 /** Get the display badge for a tier */

package/dist/detect/go.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Go detection — CONTENT-AWARE go.mod classification.
+ *
+ * A go.mod alone does NOT mean "backend" or "CLI". The same module file backs
+ * libraries, HTTP servers (Gin / Echo / Fiber / Chi), CLIs (Cobra), and MCP
+ * servers (mcp-go). We read require paths and light layout signals, then branch.
+ *
+ * Same composition pattern as dart.ts: knowledge in go-detection.json, logic here.
+ * Turbo-Cat + scanner both call detectGoProject so they agree by construction.
+ */
+export type GoAppType = 'mcp' | 'backend' | 'cli' | 'library';
+export interface GoProject {
+    /** faf app_type — MCP→mcp, server→backend, CLI→cli, else library. */
+    appType: GoAppType;
+    /** Module path from `module` line, or ''. */
+    modulePath: string;
+    /** Primary framework (Gin / Cobra / …) or ''. */
+    framework: string;
+    /** Human-readable rationale for the .faf `# found:` comment (Glass Hood). */
+    found: string;
+}
+/** Collect require module paths from go.mod (require X and require ( … ) blocks). */
+export declare function goModRequires(content: string): Set<string>;
+/** Classify a Go project from go.mod (+ light layout). Returns null if not Go. */
+export declare function detectGoProject(dir: string): GoProject | null;

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';