faf-cli 6.7.0 → 6.7.1

package/dist/core/schema.d.ts

@@ -0,0 +1,5 @@
+/** Validate a parsed .faf object */
+export declare function validateFaf(data: unknown): {
+    valid: boolean;
+    errors: string[];
+};

package/dist/core/scorer.d.ts

@@ -0,0 +1,23 @@
+import type { KernelScoreResult, ScoreResult } from './types.js';
+/** Convert kernel result into enriched ScoreResult */
+export declare function enrichScore(kernel: KernelScoreResult): ScoreResult;
+/**
+ * Score a .faf YAML string with About-Repo short-circuit.
+ *
+ * About Repos (app_type: about) are documentation surfaces, not apps.
+ * They DISPLAY the source codebase's Trophy, they don't earn one. The
+ * scorer reads `about.source_score` from the project.faf and emits that
+ * directly — no slot scoring, no kernel call.
+ *
+ * Truth-printing is preserved by owner accountability: the score is
+ * their attestation of the source's score; they're on the hook if it's wrong.
+ *
+ * Required for about: `app_type: about` + `about.represents: <owner>/<repo>`.
+ * Optional: `about.source_score: <number>` — without it, score is -1
+ * (renders as "—" honest unknown).
+ *
+ * Doctrine: memory/private-source-public-about-pattern.md.
+ *
+ * For non-about types: delegates to kernel.score() + enrichScore().
+ */
+export declare function scoreFafYaml(yaml: string): ScoreResult;

package/dist/core/slots.d.ts

@@ -0,0 +1,44 @@
+import type { SlotDef, SlotCategory } from './types.js';
+/** All 33 Mk4 canonical slots */
+export declare const SLOTS: SlotDef[];
+/** Slot lookup by path — dual-keyed (current on-wire `path` AND Mk4 `canonical`
+ *  where defined) so callers can look up by either name. See issue #66. */
+export declare const SLOT_BY_PATH: Map<string, SlotDef>;
+/** Mk4 canonical → current on-wire path. Used by read helpers to resolve
+ *  a canonical name back to the path that read/write/kernel actually uses
+ *  today. Empty for slots whose path is already canonical. */
+export declare const CANONICAL_TO_CURRENT: ReadonlyMap<string, string>;
+/** Current on-wire path → Mk4 canonical. Used by display helpers when the
+ *  UI wants to surface the forward-spec name. */
+export declare const CURRENT_TO_CANONICAL: ReadonlyMap<string, string>;
+/** Resolve any path (legacy or canonical) to the slot definition. */
+export declare function getSlotByAnyPath(path: string): SlotDef | undefined;
+/** Read a value from a .faf data object, checking both the slot's current
+ *  `path` and its Mk4 `canonical` (if defined). Returns the first non-undefined
+ *  value. Lets the cli read .faf files that contain either legacy or canonical
+ *  keys without forcing a migration. */
+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 */
+export declare const BASE_SLOTS: SlotDef[];
+/** Enterprise-tier slots (1-33) — used by score_faf_enterprise */
+export declare const ENTERPRISE_SLOTS: SlotDef[];
+/** Placeholder values treated as Empty */
+export declare const PLACEHOLDERS: Set<string>;
+/** Check if a value is a placeholder (empty) */
+export declare function isPlaceholder(value: unknown): boolean;
+/** App-type to active category mapping. The canonical 21-type ladder —
+ *  19 detectable apps + `about` (non-app, 0 slots, owner-attested)
+ *  + `encyclopedia` (curated knowledge surface, FAFipedia and similar).
+ *  (See v6.6.md doctrine memory + fafipedia-vs-grokipedia-architecture.)
+ *  Sorted ascending by active slot count for readability.
+ *
+ *  v6.5.0 changes vs prior:
+ *  - Added `universal` to cli / library / mcp / frontend / data-science.
+ *    These types ship/build/CI somewhere — slotignoring those slots was
+ *    losing real signal. (cli/library: 9→12; mcp/data-science: 14→17;
+ *    frontend: 13→16.)
+ *  - Order is by ascending slot count, not insertion order.
+ */
+export declare const APP_TYPE_CATEGORIES: Record<string, SlotCategory[]>;

package/dist/core/tiers.d.ts

@@ -0,0 +1,19 @@
+import type { TierInfo } from './types.js';
+/** Tier boundaries — ordered from highest to lowest
+ *
+ * Indicators:
+ *   🏆 trophy (earned at 100%)
+ *   ★ 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)
+ */
+export declare const TIERS: TierInfo[];
+/** Get the display badge for a tier */
+export declare function tierBadge(tier: TierInfo): string;
+/** Get tier info for a given score */
+export declare function getTier(score: number): TierInfo;
+/** Get the next tier above the current score (for progress display) */
+export declare function getNextTier(score: number): TierInfo | null;

package/dist/core/types.d.ts

@@ -0,0 +1,148 @@
+/** State of a single slot in a .faf file */
+export type SlotState = 'populated' | 'empty' | 'slotignored';
+/** Category grouping for slots */
+export type SlotCategory = 'project' | 'human' | 'frontend' | 'backend' | 'universal' | 'enterprise_infra' | 'enterprise_app' | 'enterprise_ops';
+/** A single slot definition */
+export interface SlotDef {
+    /** Slot number (1-33) */
+    index: number;
+    /** Dot-path in .faf YAML (e.g. "project.name") — current on-wire identifier
+     *  used for read/write and kernel scoring. */
+    path: string;
+    /** Mk4 canonical dot-path (forward spec). Defined for slots where the
+     *  current `path` is a legacy name pending lockstep rename with
+     *  faf-scoring-kernel + xai-faf-rust. See issue #66. */
+    canonical?: string;
+    /** Human description */
+    description: string;
+    /** Category this slot belongs to */
+    category: SlotCategory;
+}
+/** Result from WASM kernel score_faf / score_faf_enterprise */
+export interface KernelScoreResult {
+    score: number;
+    tier: string;
+    populated: number;
+    empty: number;
+    ignored: number;
+    active: number;
+    total: number;
+    slots: Record<string, SlotState>;
+}
+/** Enriched score result for display */
+export interface ScoreResult {
+    score: number;
+    tier: TierInfo;
+    populated: number;
+    empty: number;
+    ignored: number;
+    active: number;
+    total: number;
+    slots: Record<string, SlotState>;
+    /**
+     * When true, the score is INHERITED from a source codebase (declared via
+     * `app_type: about` + `about.source_score` in project.faf). The scorer
+     * did NOT calculate this — the owner attested to it. About Repos are
+     * documentation surfaces, not apps.
+     *
+     * Set by scoreFafYaml when the input declares `app_type: about`.
+     * Consumers (TAF receipt generation, display logic) should distinguish
+     * inherited scores from calculated ones — they're qualitatively different
+     * artifacts. See memory/private-source-public-about-pattern.md.
+     */
+    inherited?: boolean;
+    /**
+     * For inherited scores: the owner/repo the About Repo represents.
+     * Format: "owner/repo" (e.g. "Wolfe-Jam/faf-mcpaas"). Required when
+     * `inherited: true` per schema validation.
+     */
+    represents?: string;
+}
+/** Tier boundary info */
+export interface TierInfo {
+    name: string;
+    threshold: number;
+    /** Display indicator (branded glyphs + ANSI color) */
+    indicator: string;
+}
+/** Parsed .faf file data */
+export interface FafData {
+    faf_version?: string;
+    project?: {
+        name?: string;
+        goal?: string;
+        main_language?: string;
+        type?: string;
+        [key: string]: unknown;
+    };
+    /**
+     * Top-level app_type — drives slot selection in APP_TYPE_CATEGORIES.
+     * Special value `'about'` is a non-app representation (see `about` block).
+     */
+    app_type?: string;
+    /**
+     * About Repo declaration block. Present when `app_type: about`. Lets the
+     * repo represent a private codebase: scorer short-circuits and emits
+     * `source_score` as the score. See memory/private-source-public-about-pattern.md.
+     */
+    about?: {
+        /** Required: "owner/repo" pointing at the private source codebase. */
+        represents?: string;
+        /** Optional: owner-attested score of the source (0-100). Missing = score "—". */
+        source_score?: number;
+    };
+    stack?: Record<string, unknown>;
+    human_context?: Record<string, unknown>;
+    monorepo?: Record<string, unknown>;
+    scores?: Record<string, unknown>;
+    /** TECH_STACK section content — flat list of technology components */
+    tech_stack?: string[];
+    /** KEY_FILES section — list of important file paths */
+    key_files?: string[];
+    /** COMMANDS section — build/test/lint/dev command map */
+    commands?: Record<string, string>;
+    /** ARCHITECTURE section — free-form structural description (user-fill) */
+    architecture?: string;
+    /** CONTEXT section — free-form additional signal (user-fill, NOT human_context) */
+    context?: string;
+    [key: string]: unknown;
+}
+/** FAFb binary info from kernel */
+export interface FafbInfo {
+    header: {
+        magic: string;
+        version: number;
+        flags: number;
+        section_count: number;
+        crc32: number;
+    };
+    sections: Array<{
+        name: string;
+        priority: number;
+        offset: number;
+        length: number;
+        classification: string;
+    }>;
+    content?: string;
+}
+/** Framework detection result */
+export interface DetectedFramework {
+    name: string;
+    slug: string;
+    category: string;
+    confidence: number;
+    version?: string;
+}
+/** Signal types for framework detection */
+export type SignalType = 'dependency' | 'file' | 'devDependency';
+export interface Signal {
+    type: SignalType;
+    key?: string;
+    pattern?: string;
+}
+export interface FrameworkSignature {
+    name: string;
+    slug: string;
+    category: string;
+    signals: Signal[];
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { SlotState, SlotCategory, SlotDef, KernelScoreResult, ScoreResult, TierInfo, FafData, FafbInfo, DetectedFramework, FrameworkSignature, Signal, SignalType, } from './core/types.js';
+export { SLOTS, BASE_SLOTS, ENTERPRISE_SLOTS, SLOT_BY_PATH, slotsByCategory, PLACEHOLDERS, isPlaceholder } from './core/slots.js';
+export { TIERS, getTier, getNextTier } from './core/tiers.js';
+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 * as kernel from './wasm/kernel.js';

package/dist/index.js

@@ -136,10 +136,10 @@ ${$.comment}`:$.comment}this.doc.range[2]=$.offset;break}default:this.errors.pus
 `)+1;while($!==0)this.onNewLine(this.offset+$),$=this.source.indexOf(`
 `,$)+1}yield*this.pop();break;default:yield*this.pop(),yield*this.step()}}*blockMap(q){let $=q.items[q.items.length-1];switch(this.type){case"newline":if(this.onKeyLine=!1,$.value){let U="end"in $.value?$.value.end:void 0;if((Array.isArray(U)?U[U.length-1]:void 0)?.type==="comment")U?.push(this.sourceToken);else q.items.push({start:[this.sourceToken]})}else if($.sep)$.sep.push(this.sourceToken);else $.start.push(this.sourceToken);return;case"space":case"comment":if($.value)q.items.push({start:[this.sourceToken]});else if($.sep)$.sep.push(this.sourceToken);else{if(this.atIndentedComment($.start,q.indent)){let Z=q.items[q.items.length-2]?.value?.end;if(Array.isArray(Z)){Array.prototype.push.apply(Z,$.start),Z.push(this.sourceToken),q.items.pop();return}}$.start.push(this.sourceToken)}return}if(this.indent>=q.indent){let U=!this.onKeyLine&&this.indent===q.indent,Z=U&&($.sep||$.explicitKey)&&this.type!=="seq-item-ind",H=[];if(Z&&$.sep&&!$.value){let z=[];for(let X=0;X<$.sep.length;++X){let G=$.sep[X];switch(G.type){case"newline":z.push(X);break;case"space":break;case"comment":if(G.indent>q.indent)z.length=0;break;default:z.length=0}}if(z.length>=2)H=$.sep.splice(z[1])}switch(this.type){case"anchor":case"tag":if(Z||$.value)H.push(this.sourceToken),q.items.push({start:H}),this.onKeyLine=!0;else if($.sep)$.sep.push(this.sourceToken);else $.start.push(this.sourceToken);return;case"explicit-key-ind":if(!$.sep&&!$.explicitKey)$.start.push(this.sourceToken),$.explicitKey=!0;else if(Z||$.value)H.push(this.sourceToken),q.items.push({start:H,explicitKey:!0});else this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:[this.sourceToken],explicitKey:!0}]});this.onKeyLine=!0;return;case"map-value-ind":if($.explicitKey)if(!$.sep)if(n($.start,"newline"))Object.assign($,{key:null,sep:[this.sourceToken]});else{let z=_0($.start);this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:z,key:null,sep:[this.sourceToken]}]})}else if($.value)q.items.push({start:[],key:null,sep:[this.sourceToken]});else if(n($.sep,"map-value-ind"))this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:H,key:null,sep:[this.sourceToken]}]});else if(H9($.key)&&!n($.sep,"newline")){let z=_0($.start),X=$.key,G=$.sep;G.push(this.sourceToken),delete $.key,delete $.sep,this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:z,key:X,sep:G}]})}else if(H.length>0)$.sep=$.sep.concat(H,this.sourceToken);else $.sep.push(this.sourceToken);else if(!$.sep)Object.assign($,{key:null,sep:[this.sourceToken]});else if($.value||Z)q.items.push({start:H,key:null,sep:[this.sourceToken]});else if(n($.sep,"map-value-ind"))this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:[],key:null,sep:[this.sourceToken]}]});else $.sep.push(this.sourceToken);this.onKeyLine=!0;return;case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":{let z=this.flowScalar(this.type);if(Z||$.value)q.items.push({start:H,key:z,sep:[]}),this.onKeyLine=!0;else if($.sep)this.stack.push(z);else Object.assign($,{key:z,sep:[]}),this.onKeyLine=!0;return}default:{let z=this.startBlockValue(q);if(z){if(z.type==="block-seq"){if(!$.explicitKey&&$.sep&&!n($.sep,"newline")){yield*this.pop({type:"error",offset:this.offset,message:"Unexpected block-seq-ind on same line with key",source:this.source});return}}else if(U)q.items.push({start:H});this.stack.push(z);return}}}}yield*this.pop(),yield*this.step()}*blockSequence(q){let $=q.items[q.items.length-1];switch(this.type){case"newline":if($.value){let U="end"in $.value?$.value.end:void 0;if((Array.isArray(U)?U[U.length-1]:void 0)?.type==="comment")U?.push(this.sourceToken);else q.items.push({start:[this.sourceToken]})}else $.start.push(this.sourceToken);return;case"space":case"comment":if($.value)q.items.push({start:[this.sourceToken]});else{if(this.atIndentedComment($.start,q.indent)){let Z=q.items[q.items.length-2]?.value?.end;if(Array.isArray(Z)){Array.prototype.push.apply(Z,$.start),Z.push(this.sourceToken),q.items.pop();return}}$.start.push(this.sourceToken)}return;case"anchor":case"tag":if($.value||this.indent<=q.indent)break;$.start.push(this.sourceToken);return;case"seq-item-ind":if(this.indent!==q.indent)break;if($.value||n($.start,"seq-item-ind"))q.items.push({start:[this.sourceToken]});else $.start.push(this.sourceToken);return}if(this.indent>q.indent){let U=this.startBlockValue(q);if(U){this.stack.push(U);return}}yield*this.pop(),yield*this.step()}*flowCollection(q){let $=q.items[q.items.length-1];if(this.type==="flow-error-end"){let U;do yield*this.pop(),U=this.peek(1);while(U?.type==="flow-collection")}else if(q.end.length===0){switch(this.type){case"comma":case"explicit-key-ind":if(!$||$.sep)q.items.push({start:[this.sourceToken]});else $.start.push(this.sourceToken);return;case"map-value-ind":if(!$||$.value)q.items.push({start:[],key:null,sep:[this.sourceToken]});else if($.sep)$.sep.push(this.sourceToken);else Object.assign($,{key:null,sep:[this.sourceToken]});return;case"space":case"comment":case"newline":case"anchor":case"tag":if(!$||$.value)q.items.push({start:[this.sourceToken]});else if($.sep)$.sep.push(this.sourceToken);else $.start.push(this.sourceToken);return;case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":{let Z=this.flowScalar(this.type);if(!$||$.value)q.items.push({start:[],key:Z,sep:[]});else if($.sep)this.stack.push(Z);else Object.assign($,{key:Z,sep:[]});return}case"flow-map-end":case"flow-seq-end":q.end.push(this.sourceToken);return}let U=this.startBlockValue(q);if(U)this.stack.push(U);else yield*this.pop(),yield*this.step()}else{let U=this.peek(2);if(U.type==="block-map"&&(this.type==="map-value-ind"&&U.indent===q.indent||this.type==="newline"&&!U.items[U.items.length-1].sep))yield*this.pop(),yield*this.step();else if(this.type==="map-value-ind"&&U.type!=="flow-collection"){let Z=gq(U),H=_0(Z);Z9(q);let z=q.end.splice(1,q.end.length);z.push(this.sourceToken);let X={type:"block-map",offset:q.offset,indent:q.indent,items:[{start:H,key:q,sep:z}]};this.onKeyLine=!0,this.stack[this.stack.length-1]=X}else yield*this.lineEnd(q)}}flowScalar(q){if(this.onNewLine){let $=this.source.indexOf(`
 `)+1;while($!==0)this.onNewLine(this.offset+$),$=this.source.indexOf(`
-`,$)+1}return{type:q,offset:this.offset,indent:this.indent,source:this.source}}startBlockValue(q){switch(this.type){case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return this.flowScalar(this.type);case"block-scalar-header":return{type:"block-scalar",offset:this.offset,indent:this.indent,props:[this.sourceToken],source:""};case"flow-map-start":case"flow-seq-start":return{type:"flow-collection",offset:this.offset,indent:this.indent,start:this.sourceToken,items:[],end:[]};case"seq-item-ind":return{type:"block-seq",offset:this.offset,indent:this.indent,items:[{start:[this.sourceToken]}]};case"explicit-key-ind":{this.onKeyLine=!0;let $=gq(q),U=_0($);return U.push(this.sourceToken),{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:U,explicitKey:!0}]}}case"map-value-ind":{this.onKeyLine=!0;let $=gq(q),U=_0($);return{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:U,key:null,sep:[this.sourceToken]}]}}}return null}atIndentedComment(q,$){if(this.type!=="comment")return!1;if(this.indent<=$)return!1;return q.every((U)=>U.type==="newline"||U.type==="space")}*documentEnd(q){if(this.type!=="doc-mode"){if(q.end)q.end.push(this.sourceToken);else q.end=[this.sourceToken];if(this.type==="newline")yield*this.pop()}}*lineEnd(q){switch(this.type){case"comma":case"doc-start":case"doc-end":case"flow-seq-end":case"flow-map-end":case"map-value-ind":yield*this.pop(),yield*this.step();break;case"newline":this.onKeyLine=!1;case"space":case"comment":default:if(q.end)q.end.push(this.sourceToken);else q.end=[this.sourceToken];if(this.type==="newline")yield*this.pop()}}}h1.Parser=z9});var B9=T((a1)=>{var X9=m$(),k1=v0(),a0=m0(),v1=oq(),m1=w(),p1=o$(),G9=t$();function J9(q){let $=q.prettyErrors!==!1;return{lineCounter:q.lineCounter||$&&new p1.LineCounter||null,prettyErrors:$}}function d1(q,$={}){let{lineCounter:U,prettyErrors:Z}=J9($),H=new G9.Parser(U?.addNewLine),z=new X9.Composer($),X=Array.from(z.compose(H.parse(q)));if(Z&&U)for(let G of X)G.errors.forEach(a0.prettifyError(q,U)),G.warnings.forEach(a0.prettifyError(q,U));if(X.length>0)return X;return Object.assign([],{empty:!0},z.streamInfo())}function Q9(q,$={}){let{lineCounter:U,prettyErrors:Z}=J9($),H=new G9.Parser(U?.addNewLine),z=new X9.Composer($),X=null;for(let G of z.compose(H.parse(q),!0,q.length))if(!X)X=G;else if(X.options.logLevel!=="silent"){X.errors.push(new a0.YAMLParseError(G.range.slice(0,2),"MULTIPLE_DOCS","Source contains multiple documents; please use YAML.parseAllDocuments()"));break}if(Z&&U)X.errors.forEach(a0.prettifyError(q,U)),X.warnings.forEach(a0.prettifyError(q,U));return X}function l1(q,$,U){let Z=void 0;if(typeof $==="function")Z=$;else if(U===void 0&&$&&typeof $==="object")U=$;let H=Q9(q,U);if(!H)return null;if(H.warnings.forEach((z)=>v1.warn(H.options.logLevel,z)),H.errors.length>0)if(H.options.logLevel!=="silent")throw H.errors[0];else H.errors=[];return H.toJS(Object.assign({reviver:Z},U))}function c1(q,$,U){let Z=null;if(typeof $==="function"||Array.isArray($))Z=$;else if(U===void 0&&$)U=$;if(typeof U==="string")U=U.length;if(typeof U==="number"){let H=Math.round(U);U=H<1?void 0:H>8?{indent:8}:{indent:H}}if(q===void 0){let{keepUndefined:H}=U??$??{};if(!H)return}if(m1.isDocument(q)&&!Z)return q.toString(U);return new k1.Document(q,Z,U).toString(U)}a1.parse=l1;a1.parseAllDocuments=d1;a1.parseDocument=Q9;a1.stringify=c1});var t=[{index:1,path:"project.name",description:"Project name",category:"project"},{index:2,path:"project.goal",description:"Goal (use case)",category:"project"},{index:3,path:"project.main_language",description:"Primary language",category:"project"},{index:4,path:"human_context.who",description:"Who is this for?",category:"human"},{index:5,path:"human_context.what",description:"What are they building",category:"human"},{index:6,path:"human_context.why",description:"Why does it exist",category:"human"},{index:7,path:"human_context.where",description:"Where does it run",category:"human"},{index:8,path:"human_context.when",description:"When was it started / timeline",category:"human"},{index:9,path:"human_context.how",description:"How is it built",category:"human"},{index:10,path:"stack.frontend",canonical:"stack.framework",description:"Framework (React, Svelte, etc.)",category:"frontend"},{index:11,path:"stack.css_framework",canonical:"stack.css",description:"CSS framework",category:"frontend"},{index:12,path:"stack.ui_library",description:"UI component library",category:"frontend"},{index:13,path:"stack.state_management",canonical:"stack.state",description:"State management",category:"frontend"},{index:14,path:"stack.backend",description:"Backend framework",category:"backend"},{index:15,path:"stack.api_type",canonical:"stack.api",description:"API style (REST, GraphQL, etc.)",category:"backend"},{index:16,path:"stack.runtime",description:"Runtime (Node, Bun, Python, etc.)",category:"backend"},{index:17,path:"stack.database",canonical:"stack.db",description:"Database",category:"backend"},{index:18,path:"stack.connection",description:"Connection method (Prisma, etc.)",category:"backend"},{index:19,path:"stack.hosting",description:"Hosting platform",category:"universal"},{index:20,path:"stack.build",description:"Build tool",category:"universal"},{index:21,path:"stack.cicd",description:"CI/CD",category:"universal"},{index:22,path:"stack.monorepo_tool",description:"Monorepo tool",category:"enterprise_infra"},{index:23,path:"stack.package_manager",canonical:"stack.pkg_manager",description:"Package manager",category:"enterprise_infra"},{index:24,path:"stack.workspaces",description:"Workspace configuration",category:"enterprise_infra"},{index:25,path:"monorepo.packages_count",description:"Number of packages",category:"enterprise_infra"},{index:26,path:"monorepo.build_orchestrator",description:"Build orchestration tool",category:"enterprise_infra"},{index:27,path:"stack.admin",description:"Admin panel",category:"enterprise_app"},{index:28,path:"stack.cache",description:"Caching layer",category:"enterprise_app"},{index:29,path:"stack.search",description:"Search engine",category:"enterprise_app"},{index:30,path:"stack.storage",description:"Object storage",category:"enterprise_app"},{index:31,path:"monorepo.versioning_strategy",description:"Version strategy",category:"enterprise_ops"},{index:32,path:"monorepo.shared_configs",description:"Shared configs",category:"enterprise_ops"},{index:33,path:"monorepo.remote_cache",description:"Remote build cache",category:"enterprise_ops"}],w9=new Map(t.flatMap((q)=>q.canonical?[[q.path,q],[q.canonical,q]]:[[q.path,q]])),r7=new Map(t.filter((q)=>q.canonical).map((q)=>[q.canonical,q.path])),n7=new Map(t.filter((q)=>q.canonical).map((q)=>[q.path,q.canonical]));function K9(q){return t.filter(($)=>$.category===q)}var N9=t.filter((q)=>q.index<=21),b9=t,UU=new Set(["describe your project goal","development teams","cloud platform","null","none","unknown","n/a","not applicable"]);function S9(q){if(q===null||q===void 0||q==="")return!0;if(typeof q==="string")return UU.has(q.toLowerCase().trim());if(Array.isArray(q)&&q.length===0)return!0;if(typeof q==="object"&&Object.keys(q).length===0)return!0;return!1}var xq=(q)=>($)=>`\x1B[${q}m${$}\x1B[0m`,hq=xq("1"),s0=xq("2"),t7=xq("3"),R0={cyan:"#00D4D4",cyanDeep:"#0E8C8C",orange:"#FF6B35"},uq=(q)=>`\x1B[38;2;0;212;212m${q}\x1B[0m`,kq=(q)=>`\x1B[38;2;14;140;140m${q}\x1B[0m`,P0=(q)=>`\x1B[38;5;208m${q}\x1B[0m`;var u=[{name:"TROPHY",indicator:`${P0("\uD83C\uDFC6")} ${P0("TROPHY")}`,threshold:100},{name:"GOLD",indicator:`${P0(hq("★"))} ${P0("GOLD")}`,threshold:99},{name:"SILVER",indicator:`${uq("◆")} ${uq("SILVER")}`,threshold:95},{name:"BRONZE",indicator:`${kq("◇")} ${kq("BRONZE")}`,threshold:85},{name:"GREEN",indicator:`${hq("●")} GREEN`,threshold:70},{name:"YELLOW",indicator:`${s0("●")} YELLOW`,threshold:55},{name:"RED",indicator:`${s0("○")} RED`,threshold:1},{name:"WHITE",indicator:`${s0("♡")}`,threshold:0}];function F0(q){for(let $ of u)if(q>=$.threshold)return $;return u[u.length-1]}function j9(q){let $=F0(q),U=u.indexOf($);return U>0?u[U-1]:null}var pq={};A9(pq,{validate:()=>E9,sdkVersion:()=>h9,scoreFafb:()=>x9,scoreEnterprise:()=>C9,score:()=>mq,fafbInfo:()=>y9,decompile:()=>f9,compile:()=>g9});var vq=null;function p(){if(!vq)try{vq=I0("faf-scoring-kernel")}catch{throw Error(`faf-scoring-kernel not installed.
+`,$)+1}return{type:q,offset:this.offset,indent:this.indent,source:this.source}}startBlockValue(q){switch(this.type){case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return this.flowScalar(this.type);case"block-scalar-header":return{type:"block-scalar",offset:this.offset,indent:this.indent,props:[this.sourceToken],source:""};case"flow-map-start":case"flow-seq-start":return{type:"flow-collection",offset:this.offset,indent:this.indent,start:this.sourceToken,items:[],end:[]};case"seq-item-ind":return{type:"block-seq",offset:this.offset,indent:this.indent,items:[{start:[this.sourceToken]}]};case"explicit-key-ind":{this.onKeyLine=!0;let $=gq(q),U=_0($);return U.push(this.sourceToken),{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:U,explicitKey:!0}]}}case"map-value-ind":{this.onKeyLine=!0;let $=gq(q),U=_0($);return{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:U,key:null,sep:[this.sourceToken]}]}}}return null}atIndentedComment(q,$){if(this.type!=="comment")return!1;if(this.indent<=$)return!1;return q.every((U)=>U.type==="newline"||U.type==="space")}*documentEnd(q){if(this.type!=="doc-mode"){if(q.end)q.end.push(this.sourceToken);else q.end=[this.sourceToken];if(this.type==="newline")yield*this.pop()}}*lineEnd(q){switch(this.type){case"comma":case"doc-start":case"doc-end":case"flow-seq-end":case"flow-map-end":case"map-value-ind":yield*this.pop(),yield*this.step();break;case"newline":this.onKeyLine=!1;case"space":case"comment":default:if(q.end)q.end.push(this.sourceToken);else q.end=[this.sourceToken];if(this.type==="newline")yield*this.pop()}}}h1.Parser=z9});var B9=T((a1)=>{var X9=m$(),k1=v0(),a0=m0(),v1=oq(),m1=w(),p1=o$(),G9=t$();function J9(q){let $=q.prettyErrors!==!1;return{lineCounter:q.lineCounter||$&&new p1.LineCounter||null,prettyErrors:$}}function d1(q,$={}){let{lineCounter:U,prettyErrors:Z}=J9($),H=new G9.Parser(U?.addNewLine),z=new X9.Composer($),X=Array.from(z.compose(H.parse(q)));if(Z&&U)for(let G of X)G.errors.forEach(a0.prettifyError(q,U)),G.warnings.forEach(a0.prettifyError(q,U));if(X.length>0)return X;return Object.assign([],{empty:!0},z.streamInfo())}function Q9(q,$={}){let{lineCounter:U,prettyErrors:Z}=J9($),H=new G9.Parser(U?.addNewLine),z=new X9.Composer($),X=null;for(let G of z.compose(H.parse(q),!0,q.length))if(!X)X=G;else if(X.options.logLevel!=="silent"){X.errors.push(new a0.YAMLParseError(G.range.slice(0,2),"MULTIPLE_DOCS","Source contains multiple documents; please use YAML.parseAllDocuments()"));break}if(Z&&U)X.errors.forEach(a0.prettifyError(q,U)),X.warnings.forEach(a0.prettifyError(q,U));return X}function l1(q,$,U){let Z=void 0;if(typeof $==="function")Z=$;else if(U===void 0&&$&&typeof $==="object")U=$;let H=Q9(q,U);if(!H)return null;if(H.warnings.forEach((z)=>v1.warn(H.options.logLevel,z)),H.errors.length>0)if(H.options.logLevel!=="silent")throw H.errors[0];else H.errors=[];return H.toJS(Object.assign({reviver:Z},U))}function c1(q,$,U){let Z=null;if(typeof $==="function"||Array.isArray($))Z=$;else if(U===void 0&&$)U=$;if(typeof U==="string")U=U.length;if(typeof U==="number"){let H=Math.round(U);U=H<1?void 0:H>8?{indent:8}:{indent:H}}if(q===void 0){let{keepUndefined:H}=U??$??{};if(!H)return}if(m1.isDocument(q)&&!Z)return q.toString(U);return new k1.Document(q,Z,U).toString(U)}a1.parse=l1;a1.parseAllDocuments=d1;a1.parseDocument=Q9;a1.stringify=c1});var t=[{index:1,path:"project.name",description:"Project name",category:"project"},{index:2,path:"project.goal",description:"Goal (use case)",category:"project"},{index:3,path:"project.main_language",description:"Primary language",category:"project"},{index:4,path:"human_context.who",description:"Who is this for?",category:"human"},{index:5,path:"human_context.what",description:"What are they building",category:"human"},{index:6,path:"human_context.why",description:"Why does it exist",category:"human"},{index:7,path:"human_context.where",description:"Where does it run",category:"human"},{index:8,path:"human_context.when",description:"When was it started / timeline",category:"human"},{index:9,path:"human_context.how",description:"How is it built",category:"human"},{index:10,path:"stack.frontend",canonical:"stack.framework",description:"Framework (React, Svelte, etc.)",category:"frontend"},{index:11,path:"stack.css_framework",canonical:"stack.css",description:"CSS framework",category:"frontend"},{index:12,path:"stack.ui_library",description:"UI component library",category:"frontend"},{index:13,path:"stack.state_management",canonical:"stack.state",description:"State management",category:"frontend"},{index:14,path:"stack.backend",description:"Backend framework",category:"backend"},{index:15,path:"stack.api_type",canonical:"stack.api",description:"API style (REST, GraphQL, etc.)",category:"backend"},{index:16,path:"stack.runtime",description:"Runtime (Node, Bun, Python, etc.)",category:"backend"},{index:17,path:"stack.database",canonical:"stack.db",description:"Database",category:"backend"},{index:18,path:"stack.connection",description:"Connection method (Prisma, etc.)",category:"backend"},{index:19,path:"stack.hosting",description:"Hosting platform",category:"universal"},{index:20,path:"stack.build",description:"Build tool",category:"universal"},{index:21,path:"stack.cicd",description:"CI/CD",category:"universal"},{index:22,path:"stack.monorepo_tool",description:"Monorepo tool",category:"enterprise_infra"},{index:23,path:"stack.package_manager",canonical:"stack.pkg_manager",description:"Package manager",category:"enterprise_infra"},{index:24,path:"stack.workspaces",description:"Workspace configuration",category:"enterprise_infra"},{index:25,path:"monorepo.packages_count",description:"Number of packages",category:"enterprise_infra"},{index:26,path:"monorepo.build_orchestrator",description:"Build orchestration tool",category:"enterprise_infra"},{index:27,path:"stack.admin",description:"Admin panel",category:"enterprise_app"},{index:28,path:"stack.cache",description:"Caching layer",category:"enterprise_app"},{index:29,path:"stack.search",description:"Search engine",category:"enterprise_app"},{index:30,path:"stack.storage",description:"Object storage",category:"enterprise_app"},{index:31,path:"monorepo.versioning_strategy",description:"Version strategy",category:"enterprise_ops"},{index:32,path:"monorepo.shared_configs",description:"Shared configs",category:"enterprise_ops"},{index:33,path:"monorepo.remote_cache",description:"Remote build cache",category:"enterprise_ops"}],w9=new Map(t.flatMap((q)=>q.canonical?[[q.path,q],[q.canonical,q]]:[[q.path,q]])),r7=new Map(t.filter((q)=>q.canonical).map((q)=>[q.canonical,q.path])),n7=new Map(t.filter((q)=>q.canonical).map((q)=>[q.path,q.canonical]));function K9(q){return t.filter(($)=>$.category===q)}var N9=t.filter((q)=>q.index<=21),b9=t,UU=new Set(["describe your project goal","development teams","cloud platform","null","none","unknown","n/a","not applicable"]);function S9(q){if(q===null||q===void 0||q==="")return!0;if(typeof q==="string")return UU.has(q.toLowerCase().trim());if(Array.isArray(q)&&q.length===0)return!0;if(typeof q==="object"&&Object.keys(q).length===0)return!0;return!1}var xq=(q)=>($)=>`\x1B[${q}m${$}\x1B[0m`,hq=xq("1"),s0=xq("2"),t7=xq("3"),R0={cyan:"#00D4D4",cyanDeep:"#0E8C8C",orange:"#FF6B35"},uq=(q)=>`\x1B[38;2;0;212;212m${q}\x1B[0m`,kq=(q)=>`\x1B[38;2;14;140;140m${q}\x1B[0m`,P0=(q)=>`\x1B[38;5;208m${q}\x1B[0m`;var u=[{name:"TROPHY",indicator:`${P0("\uD83C\uDFC6")} ${P0("TROPHY")}`,threshold:100},{name:"GOLD",indicator:`${P0(hq("★"))} ${P0("GOLD")}`,threshold:99},{name:"SILVER",indicator:`${uq("◆")} ${uq("SILVER")}`,threshold:95},{name:"BRONZE",indicator:`${kq("◇")} ${kq("BRONZE")}`,threshold:85},{name:"GREEN",indicator:`${hq("●")} GREEN`,threshold:70},{name:"YELLOW",indicator:`${s0("●")} YELLOW`,threshold:55},{name:"RED",indicator:`${s0("○")} RED`,threshold:1},{name:"WHITE",indicator:`${s0("♡")}`,threshold:0}];function F0(q){for(let $ of u)if(q>=$.threshold)return $;return u[u.length-1]}function j9(q){let $=F0(q),U=u.indexOf($);return U>0?u[U-1]:null}var pq={};A9(pq,{validate:()=>E9,sdkVersion:()=>h9,scoreFafb:()=>x9,scoreEnterprise:()=>C9,score:()=>mq,fafbInfo:()=>y9,decompile:()=>f9,compile:()=>g9});var vq=null;function p(){if(vq)return vq;try{let q=I0("faf-scoring-kernel");return vq=q,q}catch{throw Error(`faf-scoring-kernel not installed.
 
   Run: npm install faf-scoring-kernel
-`)}return vq}function mq(q){return JSON.parse(p().score_faf(q))}function C9(q){return JSON.parse(p().score_faf_enterprise(q))}function E9(q){return p().validate_faf(q)}function g9(q){return p().compile_fafb(q)}function f9(q){return JSON.parse(p().decompile_fafb(q))}function y9(q){return JSON.parse(p().fafb_info(q))}function x9(q){return JSON.parse(p().score_fafb(q))}function h9(){return p().sdk_version()}function ZU(q){return{score:q.score,tier:F0(q.score),populated:q.populated,empty:q.empty,ignored:q.ignored,active:q.active,total:q.total,slots:q.slots}}function u9(q){if(/^\s*app_type:\s*about\s*$/m.test(q)){let U=q.match(/^\s+source_score:\s*(\d+)\s*$/m),Z=U?parseInt(U[1],10):-1,H=Z>=0&&Z<=100?Z:-1,z=q.match(/^\s+represents:\s*(\S+)\s*$/m),X=z?z[1]:void 0;return{score:H,tier:H>=0?F0(H):u[u.length-1],populated:0,empty:0,ignored:0,active:0,total:0,slots:{},inherited:!0,represents:X}}return ZU(mq(q))}function k9(q){let $=[];if(!q||typeof q!=="object")return $.push("File is not a valid YAML mapping"),{valid:!1,errors:$};let U=q;if(!U.faf_version)$.push("Missing required field: faf_version");if(!U.project?.name)$.push("Missing required field: project.name");if(U.app_type==="about"){if(!U.about?.represents)$.push("app_type 'about' requires about.represents (owner/repo of the source codebase)");else if(!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(U.about.represents))$.push(`about.represents must be "owner/repo" format (got: ${U.about.represents})`);if(U.about?.source_score!==void 0){let Z=U.about.source_score;if(typeof Z!=="number"||Z<0||Z>100)$.push(`about.source_score must be a number 0-100 (got: ${Z})`)}}return{valid:$.length===0,errors:$}}import{readFileSync as L9,writeFileSync as wX,existsSync as W9}from"fs";import{join as O9,dirname as f7}from"path";var o1=m$(),t1=v0(),e1=w$(),e$=m0(),q7=w0(),o=w(),$7=a(),U7=N(),Z7=i(),H7=r(),FX=Cq(),z7=n$(),X7=o$(),G7=t$(),fq=B9(),Y9=A0();var J7=o1.Composer,Q7=t1.Document,B7=e1.Schema,Y7=e$.YAMLError,V7=e$.YAMLParseError,W7=e$.YAMLWarning,O7=q7.Alias,L7=o.isAlias,T7=o.isCollection,_7=o.isDocument,D7=o.isMap,I7=o.isNode,R7=o.isPair,P7=o.isScalar,F7=o.isSeq,A7=$7.Pair,M7=U7.Scalar,w7=Z7.YAMLMap,K7=H7.YAMLSeq;var N7=z7.Lexer,b7=X7.LineCounter,S7=G7.Parser,qU=fq.parse,j7=fq.parseAllDocuments,C7=fq.parseDocument,V9=fq.stringify,E7=Y9.visit,g7=Y9.visitAsync;function y7(q){let $=L9(q,"utf-8");return qU($)}function x7(q){return L9(q,"utf-8")}function h7(q=process.cwd()){let $=["project.faf",".faf"];for(let Z of $){let H=O9(q,Z);if(W9(H))return H}let U=f7(q);if(U!==q)for(let Z of $){let H=O9(U,Z);if(W9(H))return H}return null}import{writeFileSync as u7}from"fs";import{join as k7}from"path";var T9=R0.orange,v7=R0.cyan,m7=R0.cyanDeep,p7="#FF9500",d7="#FF3B30",l7="#E6EDF3",c7="#6E7681",_9={TROPHY:{glyph:"\uD83C\uDFC6",color:T9},GOLD:{glyph:"★",color:T9},SILVER:{glyph:"◆",color:v7},BRONZE:{glyph:"◇",color:m7},GREEN:{glyph:"●",color:l7},YELLOW:{glyph:"●",color:p7},RED:{glyph:"○",color:d7},WHITE:{glyph:"♡",color:c7}};function D0(q){return String(q??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}var D9=["who","what","why","where","when","how"];function yq(q){return q.filter(([,$])=>$!==void 0&&$!==null&&String($).trim()!=="").map(([$,U])=>`<div class="row"><div class="k">${D0($)}</div><div class="v">${D0(U)}</div></div>`).join(`
+`)}}function mq(q){return JSON.parse(p().score_faf(q))}function C9(q){return JSON.parse(p().score_faf_enterprise(q))}function E9(q){return p().validate_faf(q)}function g9(q){return p().compile_fafb(q)}function f9(q){return JSON.parse(p().decompile_fafb(q))}function y9(q){return JSON.parse(p().fafb_info(q))}function x9(q){return JSON.parse(p().score_fafb(q))}function h9(){return p().sdk_version()}function ZU(q){return{score:q.score,tier:F0(q.score),populated:q.populated,empty:q.empty,ignored:q.ignored,active:q.active,total:q.total,slots:q.slots}}function u9(q){if(/^\s*app_type:\s*about\s*$/m.test(q)){let U=q.match(/^\s+source_score:\s*(\d+)\s*$/m),Z=U?parseInt(U[1],10):-1,H=Z>=0&&Z<=100?Z:-1,z=q.match(/^\s+represents:\s*(\S+)\s*$/m),X=z?z[1]:void 0;return{score:H,tier:H>=0?F0(H):u[u.length-1],populated:0,empty:0,ignored:0,active:0,total:0,slots:{},inherited:!0,represents:X}}return ZU(mq(q))}function k9(q){let $=[];if(!q||typeof q!=="object")return $.push("File is not a valid YAML mapping"),{valid:!1,errors:$};let U=q;if(!U.faf_version)$.push("Missing required field: faf_version");if(!U.project?.name)$.push("Missing required field: project.name");if(U.app_type==="about"){if(!U.about?.represents)$.push("app_type 'about' requires about.represents (owner/repo of the source codebase)");else if(!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(U.about.represents))$.push(`about.represents must be "owner/repo" format (got: ${U.about.represents})`);if(U.about?.source_score!==void 0){let Z=U.about.source_score;if(typeof Z!=="number"||Z<0||Z>100)$.push(`about.source_score must be a number 0-100 (got: ${Z})`)}}return{valid:$.length===0,errors:$}}import{readFileSync as L9,writeFileSync as wX,existsSync as W9}from"fs";import{join as O9,dirname as f7}from"path";var o1=m$(),t1=v0(),e1=w$(),e$=m0(),q7=w0(),o=w(),$7=a(),U7=N(),Z7=i(),H7=r(),FX=Cq(),z7=n$(),X7=o$(),G7=t$(),fq=B9(),Y9=A0();var J7=o1.Composer,Q7=t1.Document,B7=e1.Schema,Y7=e$.YAMLError,V7=e$.YAMLParseError,W7=e$.YAMLWarning,O7=q7.Alias,L7=o.isAlias,T7=o.isCollection,_7=o.isDocument,D7=o.isMap,I7=o.isNode,R7=o.isPair,P7=o.isScalar,F7=o.isSeq,A7=$7.Pair,M7=U7.Scalar,w7=Z7.YAMLMap,K7=H7.YAMLSeq;var N7=z7.Lexer,b7=X7.LineCounter,S7=G7.Parser,qU=fq.parse,j7=fq.parseAllDocuments,C7=fq.parseDocument,V9=fq.stringify,E7=Y9.visit,g7=Y9.visitAsync;function y7(q){let $=L9(q,"utf-8");return qU($)}function x7(q){return L9(q,"utf-8")}function h7(q=process.cwd()){let $=["project.faf",".faf"];for(let Z of $){let H=O9(q,Z);if(W9(H))return H}let U=f7(q);if(U!==q)for(let Z of $){let H=O9(U,Z);if(W9(H))return H}return null}import{writeFileSync as u7}from"fs";import{join as k7}from"path";var T9=R0.orange,v7=R0.cyan,m7=R0.cyanDeep,p7="#FF9500",d7="#FF3B30",l7="#E6EDF3",c7="#6E7681",_9={TROPHY:{glyph:"\uD83C\uDFC6",color:T9},GOLD:{glyph:"★",color:T9},SILVER:{glyph:"◆",color:v7},BRONZE:{glyph:"◇",color:m7},GREEN:{glyph:"●",color:l7},YELLOW:{glyph:"●",color:p7},RED:{glyph:"○",color:d7},WHITE:{glyph:"♡",color:c7}};function D0(q){return String(q??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}var D9=["who","what","why","where","when","how"];function yq(q){return q.filter(([,$])=>$!==void 0&&$!==null&&String($).trim()!=="").map(([$,U])=>`<div class="row"><div class="k">${D0($)}</div><div class="v">${D0(U)}</div></div>`).join(`
 `)}function I9(q,$,U="project.faf"){let Z=D0(q.project?.name??"Project"),H=$.tier?.name??"WHITE",z=_9[H]??_9.WHITE,X=$.inherited?$.represents?`inherited from ${D0($.represents)}`:"inherited":`${$.score}%`,G=H==="TROPHY"&&!$.inherited,J=q.human_context??{},Q=D9.map((V)=>[V,J[V]]),W=Object.entries(J).filter(([V])=>!D9.includes(V)),B=[["goal",q.project?.goal],["main_language",q.project?.main_language],["type",q.project?.type],["framework",q.project?.framework],["faf_version",q.faf_version]],Y=Object.entries(q.stack??{}),L=Y.filter(([,V])=>V&&V!=="slotignored"&&String(V).trim()!==""),_=Y.filter(([,V])=>V==="slotignored").length;return`<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -212,5 +212,5 @@ Rendered on-demand from your current <strong>${D0(U)}</strong><br>
 </html>
 `}function a7(q,$,U,Z="project.faf"){u7(k7(q,"project.html"),I9($,U,Z),"utf-8")}export{a7 as writeProjectHtml,k9 as validateFaf,K9 as slotsByCategory,u9 as scoreFafYaml,x7 as readFafRaw,y7 as readFaf,pq as kernel,S9 as isPlaceholder,F0 as getTier,j9 as getNextTier,I9 as generateProjectHtml,h7 as findFafFile,ZU as enrichScore,u as TIERS,w9 as SLOT_BY_PATH,t as SLOTS,UU as PLACEHOLDERS,R0 as FAF_HEX,b9 as ENTERPRISE_SLOTS,N9 as BASE_SLOTS};
 
-//# debugId=E66C13716307F8C864756E2164756E21
+//# debugId=1373A6DAC8B91EBA64756E2164756E21
 //# sourceMappingURL=index.js.map