# Inventory worksheet. One per run. Once the files are approved, keep it as
# martech-context/inventory/<YYYY-MM-DD>.yaml: it is the provenance evidence for
# stack.md and the baseline for the next drift check. Definitions and public
# identifiers only: no credentials, no customer data, no personal names.
#
# provenance: observed | stated | inferred | unknown
#   observed: source is a file path and line, an export file name and date, or a read-only tool call
#   stated:   source is the role of the person and the date
#   inferred: source is the reasoning; must be confirmed before a file is approved
# confidence: confirmed | unconfirmed
# Keep an observation and the inference drawn from it as two separate facts.

run:
  started: "YYYY-MM-DD"
  route: create           # create | extend | targeted-update | refresh
  trigger: ""             # for targeted-update: the named change, e.g. "Segment replaced by RudderStack"
  repo_scanned: true
  exports_read: []        # e.g. "gtm-container-v42.json (2026-10-15)"
  read_only_tools_used: []

business:
  - fact: Counting unit is the workspace; one person can belong to several workspaces
    provenance: stated
    source: "head-of-growth, YYYY-MM-DD"
    confidence: confirmed
    fills: data-dictionary.md

tools:
  - name: Google Tag Manager (web)
    environment: production
    layer: collection
    identifiers: ["GTM-XXXXXXX"]
    provenance: observed
    source: "app/layout.tsx line 12; gtm-container-v42.json"
    owner: unknown
    account_owned_by: unknown       # company | agency
    confidence: unconfirmed
    fills: stack.md
  - name: GA4
    environment: unknown
    layer: destination
    identifiers: ["G-XXXXXXXXXX"]
    provenance: observed
    source: "gtm-container-v42.json: Google tag with this measurement ID"
    confidence: confirmed
    fills: stack.md
  - fact: "G-XXXXXXXXXX is the production property"
    provenance: inferred
    source: "it is the only measurement ID in the published container that loads on www and app"
    confidence: unconfirmed
    fills: stack.md

data_flows:
  - flow: "web GTM container -> GA4 (G-XXXXXXXXXX)"
    provenance: observed
    source: "gtm-container-v42.json"

existing_context:
  - origin: "docs/kpis.md"
    defines: [CAC, MQL]
    owner: unknown
    route: undecided      # import | link | retire

identity: []

metric_candidates:
  - name_in_meetings: CAC
    competing_definitions:
      - "spend / first-paid customers (finance)"
      - "spend / closed-won opportunities (sales)"
    business_owner: unknown
    fills: metrics.md

naming:
  stated_rules_location: unknown
  observed_values_export: ""
  compliance_distinct_share: ""
  compliance_weighted_share: ""

dictionary_hazards: []

tracking_plans:
  authoritative_location: unknown
  last_export: ""

decisions_and_incidents: []

owners: []

open_items:
  - question: Who owns the definition of CAC?
    ask: head-of-growth
    due: "YYYY-MM-DD"
    blocks: metrics.md