faf-cli 7.7.0 → 7.9.0

package/dist/core/about.d.ts

@@ -0,0 +1,22 @@
+/** About is a repo role, not an app_type.
+ *
+ *  Signal: the `about:` block with `represents: owner/repo`.
+ *  Score is inherited (`about.source_score`) or unknown (−1 / —).
+ */
+export declare const REPRESENTS_RE: RegExp;
+export interface AboutDecl {
+    represents: string;
+    sourceScore: number;
+}
+/** Parsed .faf object: About iff about.represents is a non-empty string. */
+export declare function isAboutFaf(data: {
+    about?: {
+        represents?: unknown;
+    };
+} | null | undefined): boolean;
+/**
+ * Hot-path YAML detect — no parser.
+ * About = an `about:` map that contains `represents:`.
+ * `app_type: about` is not a type and does not trigger this.
+ */
+export declare function aboutFromYaml(yaml: string): AboutDecl | null;

package/dist/core/scorer.d.ts

@@ -4,20 +4,15 @@ 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.
+ * About is a repo role, not an app_type. The signal is the `about:` block
+ * (`about.represents`). The scorer reads `about.source_score` 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().
+ * For apps: delegates to kernel.score() + enrichScore().
  */
 export declare function scoreFafYaml(yaml: string): ScoreResult;

package/dist/core/slots.d.ts

@@ -29,9 +29,8 @@ 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 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).
+ *  detectable apps + `encyclopedia` (curated knowledge) + `intent` (seed).
+ *  About is NOT an app_type — it is a repo role (`about.represents`).
  *  (See v6.6.md doctrine memory + fafipedia-vs-grokipedia-architecture.)
  *  Sorted ascending by active slot count for readability.
  *

package/dist/core/types.d.ts

@@ -45,11 +45,10 @@ export interface ScoreResult {
     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.
+     * the `about:` block + `about.source_score`). The scorer did NOT calculate
+     * this — the owner attested to it. About is a repo role, not an app_type.
      *
-     * Set by scoreFafYaml when the input declares `app_type: about`.
+     * Set by scoreFafYaml when the input has `about.represents`.
      * 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.
@@ -77,17 +76,19 @@ export interface FafData {
         goal?: string;
         main_language?: string;
         type?: string;
+        /** Integration branch agents PR into — `dev`/`develop` for git-flow repos. Default `main`. */
+        default_branch?: 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).
+     * Must be a real app (cli, library, mcp, …). `about` is not an app_type.
      */
     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 Repo declaration. The `about:` block is the role signal
+     * (`about.represents` required). Scorer short-circuits and emits
+     * `source_score`. See memory/private-source-public-about-pattern.md.
      */
     about?: {
         /** Required: "owner/repo" pointing at the private source codebase. */

package/dist/detect/scanner.d.ts

@@ -37,8 +37,8 @@ export interface ProjectTypeDetection {
  *  positive signal that contributed to the classification — used downstream
  *  by `writeFaf` to render `# found: <list>` next to `type:` in the .faf.
  *
- *  Priority order per v6.6.md doctrine (most-specific first). `about` is
- *  owner-declared, not auto-detected — never matches in this function.
+ *  Priority order per v6.6.md doctrine (most-specific first). About is a
+ *  repo role (`about.represents`), not an app_type — never matches here.
  *  Rule: SDK keyword takes priority (sdk wins over library/cli/wasm). */
 export declare function detectProjectTypeWithRationale(dir: string): ProjectTypeDetection;
 /** Detect the project type for slot mapping. Backward-compatible wrapper —

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 { projectCards, readFafa, findFafaFile, generateA2ACard, upsertCatalog, A2A_CONTEXT_URI, } from './interop/cards.js';
+export type { FafaDoc, CardTarget, ProjectedCards } from './interop/cards.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';