faf-cli 7.16.1 → 8.0.0

package/dist/core/faf-dna.d.ts

@@ -52,6 +52,20 @@ export interface Milestone {
     label: string;
     emoji: string;
 }
+/**
+ * A lineage a reset ended. `faf init --force` starts a fresh certificate, and
+ * the life before it is kept here rather than erased — a birth score is the one
+ * value in this format that cannot be recreated, so a reset is a REBIRTH, not a
+ * deletion. Chains: a project reset twice keeps both earlier lives, oldest first.
+ */
+export interface PriorLineage {
+    born: string;
+    birthDNA: number;
+    certificate: string;
+    projectDNA: string;
+    lastScore: number;
+    endedAt: string;
+}
 export interface FafDNA {
     birthCertificate: BirthCertificate;
     versions: VersionEntry[];
@@ -67,6 +81,8 @@ export interface FafDNA {
     };
     lastModified: string;
     format: 'faf-dna-v1';
+    /** Lives ended by a reset, oldest first. Absent when there has never been one. */
+    priorLineage?: PriorLineage[];
 }
 /**
  * The `.faf-dna` lineage of one project: birth, growth and the journey line.
@@ -110,6 +126,10 @@ export declare class FafDNAManager {
      *  load()), a file that appeared since is refused (SafePathError `changed`)
      *  rather than written over; over a `.faf-dna` that is there, birth starts a
      *  fresh lineage (`faf init --force`). */
+    /** The lives this birth is about to end, oldest first — the one already on
+     *  disk, plus any it had itself inherited. Empty when there is no readable
+     *  `.faf-dna`, so a first birth writes no `priorLineage` key at all. */
+    private endingLineage;
     birth(birthDNA: number): FafDNA;
     /** True when `.faf-dna` exists and is one faf wrote — in faf's shape, and
      *  exactly faf's own text — so recordGrowth may add to it. Any other file is

package/dist/core/slots.d.ts

@@ -20,7 +20,7 @@ export declare function getSlotByAnyPath(path: string): SlotDef | undefined;
 export declare function readSlotValue(data: Record<string, unknown>, slot: SlotDef): unknown;
 /** Slots grouped by category */
 export declare function slotsByCategory(category: SlotCategory): SlotDef[];
-/** Base-tier slots (1-21) — used by score_faf */
+/** Base-tier slots (1-21) — the slots faf-cli fills; the other 12 are `slotignored` */
 export declare const BASE_SLOTS: SlotDef[];
 /** Enterprise-tier slots (1-33) — used by score_faf_enterprise */
 export declare const ENTERPRISE_SLOTS: SlotDef[];

package/dist/core/types.d.ts

@@ -108,35 +108,36 @@ export interface FafData {
     human_context?: Record<string, unknown>;
     monorepo?: Record<string, unknown>;
     scores?: Record<string, unknown>;
-    /** TECH_STACK section content — flat list of technology components */
+    /** `tech_stack` chunk — flat list of technology components */
     tech_stack?: string[];
-    /** KEY_FILES section — list of important file paths */
+    /** `key_files` chunk — list of important file paths */
     key_files?: string[];
-    /** COMMANDS section — build/test/lint/dev command map */
+    /** `commands` chunk — build/test/lint/dev command map */
     commands?: Record<string, string>;
-    /** ARCHITECTURE section — free-form structural description (user-fill) */
+    /** `architecture` chunk — free-form structural description (user-fill) */
     architecture?: string;
-    /** CONTEXT section — free-form additional signal (user-fill, NOT human_context) */
+    /** `context` chunk — free-form additional signal (user-fill, NOT human_context) */
     context?: string;
     [key: string]: unknown;
 }
-/** FAFb binary info from kernel */
+/** FAFb v2 info from kernel decompile / fafb_info */
 export interface FafbInfo {
-    header: {
-        magic: string;
-        version: number;
-        flags: number;
-        section_count: number;
-        crc32: number;
-    };
+    version: string;
+    flags: number;
+    section_count: number;
+    total_size: number;
+    source_checksum: string;
+    created?: number;
     sections: Array<{
         name: string;
+        name_index?: number;
         priority: number;
-        offset: number;
+        offset?: number;
         length: number;
+        token_count?: number;
         classification: string;
+        content?: string;
     }>;
-    content?: string;
 }
 /** Framework detection result */
 export interface DetectedFramework {

package/dist/detect/scanner.d.ts

@@ -89,14 +89,13 @@ export declare function detectHosting(dir: string): string | null;
 export declare function detectSvelteAdapter(dir: string): string | null;
 /** Detect build tool */
 export declare function detectBuildTool(dir: string): string | null;
-/** Detect a list of important file paths for the KEY_FILES FAFB section.
+/** Detect a list of important file paths for the `key_files` chunk.
  *  Returns up to ~10 entries, ordered by canonical importance. */
 export declare function detectKeyFiles(dir: string): string[];
-/** Detect build/test/lint commands for the COMMANDS FAFB section.
+/** Detect build/test/lint commands for the `commands` chunk.
  *  Returns a Record<string, string> mapping command name → shell command. */
 export declare function detectCommands(dir: string, pkg: PackageJson | null): Record<string, string>;
-/** Detect a tech-stack list for the TECH_STACK FAFB section.
- *  Combines language + frameworks + runtime into a flat list of strings
- *  (matching the canonical xai-faf-rust project.faf shape). */
+/** Detect a tech-stack list for the `tech_stack` chunk.
+ *  Combines language + frameworks + runtime into a flat list of strings. */
 export declare function detectTechStack(dir: string, pkg: PackageJson | null, frameworks: DetectedFramework[], language: string): string[];
 export {};