BranchPy
Log in

Docs-Builder

# Analysis Configuration

Version: 1.1.1
Last Updated: January 23, 2026

Semantics

  • File: .branchpy/semantics/semantics.yaml (schema v1.0).
  • Update via API: GET/POST /semantics/current, /semantics/update (atomic write + backup .branchpy/semantics/.backup/).
  • CLI preview: branchpy analyze --emit-semantics (exports trace).

CFG & Propagation

  • Debug export: branchpy analyze <project> --debug-cfg cfg.dot (Graphviz-ready).
  • Flow metrics: branchpy semantics2 flow --project <path> [--json] [--label <name>].
  • Cache control: clear_flow_cache(cache_key=None) from branchpy.semantics.propagation.

SAE

  • Engine-agnostic; uses CFG + AST to infer operations.
  • Cosmetic/mechanical classification driven by semantics catalog; ensure semantics.yaml is current.

PFI

  • CLI flags: branchpy pfi -p <project> [--output FILE] [--format full|compact|by-stat] [--export-dot FILE] [--show-warnings] [--show-dead] [--complexity-threshold N] [--stats NAMES].
  • Governance logging: enabled by default; toggled via enable_governance parameters when constructing indexer/analyzer/checker.
  • Default paths: .branchpy/cache/function_index.json (export), ~/.branchpy/pfi_governance.jsonl (governance log).

AI Integration (analysis-facing)

  • Providers configured in ai_providers.toml; safe_mode=True restricts to local providers.
  • Per-request model/temperature/limits set via ChatRequest; provider validation is required before use.

Defaults & Limits

  • CFG entry prefers start label; otherwise first label.
  • Semantics schema version: 1.0 (placeholders must be declared).
  • PFI complexity warning default threshold: 15.
  • Flow caching enabled by default; disable with use_cache=False in propagation APIs.

Boundaries

  • No telemetry or background uploads in analysis; outputs are local artifacts (JSON, DOT, JSONL traces).
  • UI settings (panels/flowchart rendering) are documented in User-Guide, not here.