faf-cli 6.10.1 → 6.11.0

package/dist/interrogate/cargo.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cargo.toml interrogation — extract Rust project metadata.
+ *
+ * The [package].description field is the Rust ecosystem's equivalent of
+ * package.json's `description` — a one-line elevator pitch. It maps to
+ * `project.goal` (overarching/use-case framing).
+ */
+import type { ExtractedContext } from './types.js';
+/** Read Cargo.toml and extract per-slot content. Returns {} if no Cargo.toml. */
+export declare function interrogateCargo(dir: string): ExtractedContext;

package/dist/interrogate/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Repo interrogation orchestrator — runs all extractors and merges results.
+ *
+ * Order of precedence: extractors that run first WIN (their non-empty values
+ * are kept; later extractors fill only empties). README is highest-precedence
+ * because its prose is most likely to be hand-curated; manifest fields
+ * (Cargo.toml description, package.json description) are fallbacks.
+ *
+ * The orchestrator never overwrites with empty — only fills empties.
+ */
+import type { ExtractedContext } from './types.js';
+export type { ExtractedContext } from './types.js';
+export { interrogateReadme } from './readme.js';
+export { interrogateCargo } from './cargo.js';
+/** Run all repo interrogators and return merged context. */
+export declare function interrogateRepo(dir: string): ExtractedContext;

package/dist/interrogate/readme.d.ts

@@ -0,0 +1,25 @@
+/**
+ * README.md interrogation — extract slot content from semantic markdown anchors.
+ *
+ * Per faf-auto-no-guess-no-slop:
+ *   Each extractor looks for a specific anchor (heading, structural pattern).
+ *   If the anchor is missing or the content fails validation → return undefined.
+ *   No slot is synthesized from another slot's content.
+ */
+import type { ExtractedContext } from './types.js';
+/** Extract `project.goal` — first prose paragraph or ## Use Case / ## Goal */
+export declare function extractGoal(content: string): string | undefined;
+/** Extract `human_context.what` — ## About / ## Description / ## Overview */
+export declare function extractWhat(content: string): string | undefined;
+/** Extract `human_context.who` — ## Audience / ## For Whom / ## Users */
+export declare function extractWho(content: string): string | undefined;
+/** Extract `human_context.why` — ## Why / ## Motivation / ## Problem */
+export declare function extractWhy(content: string): string | undefined;
+/** Extract `human_context.where` — ## Deployment / ## Where it runs / ## Install */
+export declare function extractWhere(content: string): string | undefined;
+/** Extract `human_context.when` — ## Status / ## History / "Production since" */
+export declare function extractWhen(content: string): string | undefined;
+/** Extract `human_context.how` — ## Architecture / ## How it works / ## Approach */
+export declare function extractHow(content: string): string | undefined;
+/** Read README.md and extract per-slot content. Returns {} if no README. */
+export declare function interrogateReadme(dir: string): ExtractedContext;

package/dist/interrogate/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Repo interrogation — extract slot content from README, Cargo.toml,
+ * package.json, etc., without guessing or substituting generic slop.
+ *
+ * Contract (per faf-auto-no-guess-no-slop doctrine):
+ *   - Each slot has a per-slot evidence anchor
+ *   - If the anchor is missing → leave empty (do NOT synthesize from other slots)
+ *   - If the anchor is present but content is generic / too long / structural →
+ *     leave empty (do NOT settle for slop)
+ *   - Empty is honest; wrong is a lie
+ *
+ * Per goal-is-not-a-6w doctrine:
+ *   - `project.goal` is the elevator pitch / use case — its own anchor
+ *   - Each `human_context.*` 6W has its own anchor
+ *   - No slot inherits from / is split-extracted from another
+ */
+/** Content extracted from a single source file (README, Cargo.toml, etc.) */
+export interface ExtractedContext {
+    project?: {
+        /** One-line elevator pitch / use case. README first prose paragraph,
+         *  ## Use Case section, or Cargo.toml description. */
+        goal?: string;
+    };
+    human_context?: {
+        /** Audience — "## Audience" / "for {audience}" patterns */
+        who?: string;
+        /** What's being built — "## About" / "## Description" / "X is..." */
+        what?: string;
+        /** Motivation — "## Why" / "## Motivation" / "Problem:" */
+        why?: string;
+        /** Where it runs — "## Deployment" / "## Where" / install-target */
+        where?: string;
+        /** Status / timeline — "## Status" / "Production since" / version line */
+        when?: string;
+        /** Approach — "## Architecture" / "## How it works" */
+        how?: string;
+    };
+}
+/** Confidence threshold rules for extracted text — empty if violated */
+export declare const EXTRACTION_LIMITS: {
+    /** Minimum length for a slot to be considered worth filling (in chars) */
+    readonly MIN_LENGTH: 8;
+    /** Maximum length — anything longer is documentation, not a slot fill */
+    readonly MAX_LENGTH: 280;
+};
+/** Generic slop patterns — extracted text matching these is rejected */
+export declare const SLOP_PATTERNS: readonly RegExp[];
+/** Validate extracted text against the no-guess/no-slop doctrine */
+export declare function isValidExtraction(text: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "6.10.1",
+  "version": "6.11.0",
   "description": "Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-approved.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",