artifacts/incoming

FSGF-0.2 — Finance Semantic Grounding Framework

artifacts/incoming/fsgf_0.md

Rendered from markdown source. Open raw source on GitHub.

FSGF-0.2 — Finance Semantic Grounding Framework

Status

Second-draft anchor.

Purpose

The Finance Semantic Grounding Framework (FSGF) defines how financially material language becomes machine-reliable, human-auditable, context-stable, and runtime-maintainable.

Its purpose is to ensure that every materially relevant finance term used by humans, systems, and AI agents is bound to explicit meaning rather than assumed familiarity.

A grounded term must be bound to:

  • a semantic identity
  • a context envelope
  • an authority source
  • a transformation lineage
  • an ambiguity state
  • a governance owner
  • a maintenance and revalidation posture

The framework exists to prevent silent semantic drift in high-stakes financial operations.

---

Core principle

A finance term is not grounded by familiarity. It is grounded by binding.

Compactly:

Grounded finance language = meaning + context + authority + lineage + ambiguity + reviewability

---

Why this framework exists

Finance language often appears stable while actually remaining context-dependent.

Examples:

  • Revenue
  • EBITDA
  • Operating Expense
  • Free Cash Flow
  • Recognized ARR
  • Adjusted EBITDA
  • Headcount Cost

These terms may vary across:

  • accounting basis
  • internal policy
  • entity scope
  • reporting context
  • time validity
  • source system
  • intended audience

Humans often reconcile this implicitly. Machines usually do not.

FSGF exists to prevent this failure mode:

surface linguistic sameness masking materially different financial meaning

---

Foundational assumptions

1. Meaning must be scoped

No financially material term is globally self-evident.

2. Translation is first-class

Local vocabularies are not errors. They are real operating conditions and must map explicitly to canonical meaning.

3. Lineage outranks wording

A term is not grounded because its label feels familiar. It is grounded because its derivation and use constraints are inspectable.

4. Ambiguity must be representable

The system must be able to preserve unresolved, overloaded, and conditional meaning rather than silently collapsing it.

5. Definitions are versioned artifacts

Meanings change over time and must remain historically legible.

6. Use-context matters

Statutory, management, board, investor, planning, and ad hoc analytical contexts may validly differ.

7. Grounded meaning requires maintenance

A meaning object is not self-sustaining simply because it was once defined. It must be periodically reviewed, revalidated, and checked against drift.

---

Relationship to adjacent layers

FSGF

Defines what a grounded financial meaning object is.

FSP

Defines how that meaning is symbolically referenced in text.

SRE

Maintains live binding, drift detection, and runtime safety for grounded meaning.

Compactly:

  • FSGF = what meaning is
  • FSP = how meaning is pointed to
  • SRE = how meaning is kept alive

---

Framework stack

Layer 0: Surface term

The human-visible label.

Examples:

  • EBITDA
  • Revenue
  • Opex
  • Free Cash Flow

This layer is unstable by default.

Layer 1: Semantic identity

A canonical meaning object independent of local phrasing.

Example:

  • CANON.METRIC.EBITDA.ADJUSTED.INTERNAL.V3
  • CANON.REVENUE.RECOGNIZED.EXTERNAL.GAAP.V2

This is the anchor layer.

Layer 2: Context envelope

The conditions under which the semantic identity is valid.

Examples:

  • accounting basis
  • organizational scope
  • jurisdiction
  • intended use
  • time validity
  • currency basis
  • inclusion / exclusion rules

Layer 3: Authority

What legitimizes the definition.

Examples:

  • GAAP / IFRS standard
  • tax rule
  • internal accounting policy
  • CFO-approved metric definition
  • board reporting policy
  • approved transformation logic

Layer 4: Lineage

How raw inputs become this semantic object in use.

Examples:

  • source systems
  • transformation logic
  • adjustments
  • eliminations
  • rollups
  • overrides

Layer 5: Ambiguity state

How semantically clear, contested, or overloaded the term is.

Layer 6: Governance and maintenance

Who owns the term, how often it must be reviewed, and how drift is detected.

---

Grounded term requirements

A financially material term is grounded only when all of the following are explicit:

  • canonical semantic identity
  • valid context envelope
  • authority source
  • lineage path or lineage reference
  • ambiguity state
  • governance owner
  • review posture

Any missing element downgrades semantic trust.

---

Canonical semantic object model

Each grounded finance term should be represented as a semantic object.

1. Identifier

  • canonical ID
  • semantic version
  • status

2. Surface forms

  • preferred label
  • aliases
  • abbreviations
  • deprecated synonyms
  • prohibited substitutions

3. Definition

  • canonical definition
  • plain-language definition
  • examples
  • counterexamples

4. Scope

  • reporting basis
  • entity or business scope
  • geography or jurisdiction
  • time validity window
  • currency basis
  • intended use

5. Authority

  • authority type
  • policy or standards reference
  • approval state
  • approving function or person

6. Lineage

  • source systems
  • transformation logic references
  • rollup relationships
  • predecessor and successor objects
  • manual override conditions

7. Ambiguity metadata

  • ambiguity state
  • common confusions
  • nearby terms
  • mapping caveats
  • confidence notes

8. Governance

  • semantic steward
  • lineage owner
  • review cadence
  • last reviewed date
  • deprecation policy

9. Runtime posture

  • materiality tier
  • revalidation horizon
  • expected decay rate
  • resolver mode defaults

---

Context envelope schema

A term is not grounded unless its context envelope is explicit.

Required context fields

  • reporting basis
  • organizational scope
  • time basis
  • currency basis
  • inclusion / exclusion policy
  • intended use

Optional but often important context fields

  • jurisdiction
  • consolidation state
  • audience
  • materiality threshold
  • scenario type (actual, forecast, plan, pro forma)
  • system of record

Example context envelope

{
  "reporting_basis": "management",
  "organizational_scope": "consolidated_company",
  "time_basis": "fiscal_quarter",
  "currency_basis": "USD_reporting",
  "intended_use": "board_review",
  "inclusion_exclusion_policy": "FIN-MET-014.V3"
}

---

Semantic classes

Different classes require different grounding rigor.

Primitive ledger classes

Examples:

  • account
  • journal entry
  • legal entity
  • cost center
  • customer
  • vendor
  • currency

These require strong structural grounding.

Policy-defined classes

Examples:

  • recognized revenue category
  • capitalizable expense
  • bad debt reserve
  • material adjustment

These require date-aware policy grounding.

Management-defined metric classes

Examples:

  • Adjusted EBITDA
  • contribution margin
  • productivity spend
  • normalized headcount cost

These require explicit inclusion and exclusion logic.

Derived KPI classes

Examples:

  • ARR
  • CAC
  • LTV
  • Free Cash Flow
  • Rule of 40

These require formula lineage and presentation context.

Narrative classes

Examples:

  • one-time
  • exceptional
  • normalized
  • healthy
  • efficient

These must never quietly masquerade as grounded objects.

---

Grounding tiers

Not all terms require the same rigor.

Tier 1: Financially determinative

Used in books, filings, tax, or audit-critical outputs.

Required:

  • canonical identity
  • authority source
  • lineage
  • full context envelope
  • prohibited substitutions
  • named steward
  • review cadence
  • runtime revalidation posture

Tier 2: Management-critical

Used in board, forecasting, operating review, or executive decisions.

Required:

  • canonical identity
  • explicit formula or composition logic
  • use context
  • exclusions / adjustments
  • steward
  • review cadence

Tier 3: Analytical

Used in internal exploration and ad hoc analysis.

Required:

  • provisional or canonical definition
  • owner
  • intended scope
  • ambiguity disclosure where relevant

Tier 4: Narrative

Used rhetorically or descriptively.

Required:

  • mapping to grounded object where possible
  • or explicit non-authoritative designation

---

Mapping model

Local terms must not be assumed equivalent to canonical identities.

The framework must support explicit mapping records.

Mapping types

  • exact
  • narrower-than
  • broader-than
  • conditional
  • approximate
  • deprecated alias
  • prohibited

Mapping conditions

Mappings may depend on:

  • report type
  • source system
  • legal entity
  • business unit
  • policy version
  • date range
  • intended use

Example mapping logic

A local label such as Revenue may be:

  • exact in statutory P&L context
  • approximate in board-pack commentary
  • prohibited as a substitute for Bookings

---

Ambiguity protocol

The framework must preserve ambiguity instead of erasing it.

Ambiguity states

  • unambiguous
  • ambiguous
  • overloaded
  • conditional
  • deprecated
  • contested
  • unresolved

Ambiguity handling rules

  • ambiguity must be surfaced, not hidden
  • unresolved meaning must not be treated as authoritative
  • ambiguous mappings must carry candidate bindings where available
  • high-materiality ambiguity must escalate to review

---

Governance model

A semantic framework fails if nobody owns it.

Semantic steward

Owns term quality and definition integrity.

Policy authority

Approves financially binding definitions.

Lineage owner

Owns source mapping and transformation references.

Runtime governor

Defines allowed runtime and AI usage for the term.

Audit witness

Ensures inspectability across review, replay, and accountability workflows.

---

Maintenance and decay posture

FSGF should explicitly acknowledge that semantic objects decay if not maintained.

Each grounded object should include:

  • last review date
  • review cadence
  • revalidation horizon
  • decay risk
  • deprecation path

Example decay signals

  • policy superseded
  • lineage changed
  • repeated local overrides
  • unresolved alias collisions
  • organizational restructuring
  • change in intended use

This allows SRE to operate against a framework that was designed for maintenance rather than assumed permanence.

---

AI operating modes against FSGF

Different AI actions require different grounding thresholds.

Retrieval

AI may explain grounded terms.

Translation

AI may map local terms to canonical terms if mapping confidence is sufficient.

Composition

AI may generate summaries or analyses using grounded terms when all materially relevant terms are sufficiently bound.

Recommendation

AI may suggest classification or treatment only when policy-backed reasoning exists and review posture is explicit.

Autonomous action

AI may act only with deterministic execution controls, explicit policy authorization, lineage capture, and rollback support.

---

Artifact binding requirement

A grounded framework must attach to real artifacts, not only definitions in isolation.

Artifacts may include:

  • spreadsheets
  • reports
  • dashboards
  • models
  • board materials
  • filings
  • reconciliation workpapers

A finance term reaches practical grounding only when it can be bound to real artifacts and referenced consistently across them.

---

Minimum viable implementation

Phase 1: Critical term register

Define 50–100 high-value finance terms.

For each term:

  • canonical identity
  • preferred definition
  • aliases
  • context envelope
  • authority source
  • steward
  • ambiguity notes
  • review cadence

Phase 2: Report grounding

Apply the framework to:

  • P&L
  • balance sheet
  • cash flow
  • key board metrics
  • forecast glossary

Phase 3: System mapping

Map ERP labels, warehouse metrics, dashboard labels, and planning models to canonical semantic objects.

Phase 4: Runtime integration

Enable SRE and AI workflows to use the semantic layer as an operational dependency rather than a passive glossary.

---

Evaluation criteria

The framework is working when:

  • materially important terms have explicit, inspectable meaning per context
  • conflicting usages are visible instead of latent
  • reports can declare semantic versions
  • AI outputs can ground themselves in semantic objects rather than linguistic guesses
  • audits can trace not only numeric origin, but semantic validity
  • reorganizations and system migrations do not erase financial meaning

---

Failure modes

  • over-normalization that flattens meaningful distinctions
  • ontology theater disconnected from actual workflows
  • static glossary syndrome with no binding to systems or artifacts
  • hidden local drift outside steward review
  • false AI confidence built on approximate mappings
  • failure to model semantic maintenance and decay

---

Compact definition

The Finance Semantic Grounding Framework is the structural layer that binds financially material language to explicit meaning, context, authority, lineage, ambiguity, and governance so that financial reasoning can be safe, inspectable, and machine-usable.

---

Protocol statement

No financially material term should be treated as authoritative solely by linguistic familiarity. Authoritative use requires explicit semantic identity, scoped context, governing source, lineage relationship, ambiguity handling, and review ownership.

---

Anchor note

This document is intended as the next stable anchor for FSGF. It has been brought forward to align more tightly with FSP and SRE, especially around governance, artifact binding, runtime posture, and semantic maintenance over time.