faf-cli 6.8.0 → 6.9.0

package/dist/core/interview.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The 6Ws Interview — SINGLE SOURCE.
+ *
+ * The canonical question registry for filling a .faf by asking a human (or an
+ * agent asking a human). faf-cli OWNS it; consumers (claude-faf-mcp's faf_go,
+ * siblings, UIs) IMPORT it — never reimplement, never copy. Decided
+ * 2026-06-10: the CLI exports, CFM consumes, zero drift. (CFM's previous
+ * hand-maintained registry had already drifted — e.g. its `how` asked "How
+ * should AI assist?" while the canonical slot semantic is "How is it built /
+ * used?". This file is the arbiter; slots.ts is its spine.)
+ *
+ * Shape carries what interactive consumers need: question text, a short
+ * header chip, input type, required flag, select options where a closed-ish
+ * vocabulary exists. Question SEMANTICS align to core/slots.ts descriptions —
+ * the slot is the meaning, the question is just its interview voice.
+ *
+ * Authoring doctrine baked into the prompts: 6Ws answers are terse LABELS
+ * (3-4 words, hard cap <6) — a scannable spec card, not prose.
+ */
+/** Bump when questions/options change — consumers can pin or report it. */
+export declare const INTERVIEW_VERSION = "faf-interview/1";
+export interface InterviewOption {
+    label: string;
+    value: string;
+    description: string;
+}
+export interface InterviewQuestion {
+    /** Canonical slot path (core/slots.ts is the spine). */
+    path: string;
+    question: string;
+    /** Short chip/header label (max ~12 chars) for option-UI consumers. */
+    header: string;
+    type: 'text' | 'select';
+    required: boolean;
+    options?: InterviewOption[];
+}
+/**
+ * THE 8-Q 6Ws INTERVIEW — the core. Project identity (name + goal) plus the
+ * six Ws. Language is deliberately NOT here: detection finds it; humans are
+ * only asked what machines cannot derive. The 6Ws are the underivable half.
+ */
+export declare const SIX_WS_INTERVIEW: InterviewQuestion[];
+/**
+ * Stack interview — asked only for slots ACTIVE for the app_type and still
+ * empty. Selects where a common vocabulary exists; every select includes
+ * Other (specify) and None where absence is legitimate.
+ */
+export declare const STACK_INTERVIEW: InterviewQuestion[];
+/** The full ordered registry: the 8-Q core first, then stack. */
+export declare const INTERVIEW: InterviewQuestion[];
+/** Lookup by slot path. */
+export declare const INTERVIEW_BY_PATH: Map<string, InterviewQuestion>;
+/**
+ * Interview voice for ANY slot: the registry question when one exists,
+ * otherwise derived from the slot's canonical description — so slot-driven
+ * flows (faf go) and registry-driven flows (faf_go) speak the same language.
+ */
+export declare function questionForSlot(path: string): string;
+/**
+ * The questions still worth asking for a given .faf: registry order, empty
+ * (or placeholder) slots only, slotignored skipped — the What-Not is never
+ * interviewed. `data` is the parsed .faf object.
+ */
+export declare function interviewForMissing(data: Record<string, unknown>, isEmpty: (value: unknown) => boolean): InterviewQuestion[];

package/dist/core/slots.d.ts

@@ -28,9 +28,10 @@ export declare const ENTERPRISE_SLOTS: SlotDef[];
 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 22-type ladder —
- *  20 detectable apps + `about` (non-app, 0 slots, owner-attested)
- *  + `encyclopedia` (curated knowledge surface, FAFipedia and similar).
+/** App-type to active category mapping. The canonical 24-type ladder —
+ *  21 detectable apps + `about` (non-app, 0 slots, owner-attested)
+ *  + `encyclopedia` (curated knowledge surface, FAFipedia and similar)
+ *  + `intent` (human-intent seed from builder.faf.one, not auto-detected).
  *  (See v6.6.md doctrine memory + fafipedia-vs-grokipedia-architecture.)
  *  Sorted ascending by active slot count for readability.
  *

package/dist/index.d.ts

@@ -6,4 +6,6 @@ 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 type { InterviewQuestion, InterviewOption } from './core/interview.js';
+export { INTERVIEW, SIX_WS_INTERVIEW, STACK_INTERVIEW, INTERVIEW_BY_PATH, INTERVIEW_VERSION, questionForSlot, interviewForMissing, } from './core/interview.js';
 export * as kernel from './wasm/kernel.js';