faf-cli 7.8.0 → 7.10.0

package/dist/core/types.d.ts

@@ -76,6 +76,8 @@ 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;
     };
     /**

package/dist/detect/relentless.d.ts

@@ -46,11 +46,17 @@ export interface SeededContextDetailed {
  * confidence}. This is the auditable form: the seeded/confirm UI can show the
  * human WHERE a value was relocated from before they accept it.
  */
-export declare function relentlessContextDetailed(dir: string): SeededContextDetailed;
+/** `toolingRoot`: the repo root's package.json is a tooling shell (polyglot repo
+ *  — real code is in sibling dirs), so its description/repo/scripts describe the
+ *  tooling, not the product. Skip package.json-sourced context; README only. */
+export interface RelentlessOpts {
+    toolingRoot?: boolean;
+}
+export declare function relentlessContextDetailed(dir: string, opts?: RelentlessOpts): SeededContextDetailed;
 /**
  * The bare 6-W extractor — values only, backward-compatible. A pure projection
  * of `relentlessContextDetailed` (single internal source; identical output to
  * the pre-provenance version). Existing consumers (claude-faf-mcp's faf_auto)
  * keep working unchanged; opt into provenance via the Detailed form.
  */
-export declare function relentlessContext(dir: string): SeededContext;
+export declare function relentlessContext(dir: string, opts?: RelentlessOpts): SeededContext;

package/dist/detect/scanner.d.ts

@@ -18,6 +18,33 @@ interface PackageJson {
     };
     files?: string[];
 }
+/** One app component discovered directly under the repo root. */
+export interface SubdirStack {
+    /** basename */
+    name: string;
+    /** detectLanguage() of the subdir */
+    language: string;
+    /** highest-confidence real-stack framework in the subdir (never Docker/CI/etc.) */
+    topFramework: string | null;
+    frontend: boolean;
+    backend: boolean;
+    /** a real-stack framework (not infra) was detected — ranks it as the "primary" */
+    hasFramework: boolean;
+    /** a "this dir IS the app" marker (manage.py / config.ru / bin/rails) */
+    appRoot: boolean;
+}
+/** Shallow (depth-1) scan for per-subdirectory app stacks. Feeds the polyglot
+ *  classifier + `main_language` aggregation. A dir counts only when it carries a
+ *  real language manifest. This is NOT monorepo tooling — it only exists to stop
+ *  a repo whose real stack lives in subdirs from falling to the `library` lie. */
+export declare function detectSubdirStacks(dir: string): SubdirStack[];
+/** Polyglot signal — ≥2 sibling app dirs, ≥2 distinct languages, a frontend AND
+ *  a backend among them. Returns the `# found:` evidence string, or null. */
+export declare function detectPolyglotSignal(dir: string, pkg: PackageJson | null): string | null;
+/** Aggregate the polyglot `main_language` string — primary first (a framework-
+ *  bearing backend dir wins), deduped by language, roles annotated.
+ *  e.g. "Python (Django · backend); JavaScript (React · frontend); Go (service)" */
+export declare function detectPolyglotLanguage(dir: string): string | null;
 /** Read and parse package.json from a directory */
 export declare function readPackageJson(dir: string): PackageJson | null;
 /** Detect frameworks in a directory */