modelith-dbt 0.3.0__tar.gz → 0.3.2__tar.gz

{modelith_dbt-0.3.0 → modelith_dbt-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: modelith-dbt
-Version: 0.3.0
+Version: 0.3.2
 Summary: Ontology-anchored, git-native data modeling tool for dbt-core teams
 License: Apache-2.0
 License-File: LICENSE

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/.gitignore

@@ -0,0 +1,9 @@
+# dbt build artifacts (generated projects live here by default)
+target/
+dbt_packages/
+logs/
+# Fetched ontology layers + cache-on-align snapshots — pinned by .mdl/lock.yaml,
+# not committed (spec §3). Run `mdl ontology fetch` to repopulate.
+.mdl/ontology-cache/
+# Reverse/generation working state (the committed lock/decisions stay tracked).
+.mdl/state/

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/.mdl/lock.yaml

@@ -0,0 +1,6 @@
+dbt: '1.9'
+osi:
+  tag: osi-0.1.1-rc1
+  version: 0.1.1
+vocabularies: {}
+profiles: {}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/entities/benchmark.yaml

@@ -0,0 +1,4 @@
+id: 01KZ2FV3S38T2N77S0V8RQE4Z1
+kind: conceptual_entity
+name: Benchmark
+definition: An index a portfolio's performance is measured against.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/entities/counterparty.yaml

@@ -0,0 +1,10 @@
+id: 01KZ2659638XNEK72JK6PGQA7P
+kind: conceptual_entity
+name: Counterparty
+subject_area: 01KZ265963K1SX5TK770VJEYHD
+definition: >
+  A legal person with whom the firm has or may have a contractual obligation.
+stewardship:
+  owner: risk-data-office
+  steward: a.hough
+synonyms: [Counterparty, CPTY]

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/entities/instrument.yaml

@@ -0,0 +1,4 @@
+id: 01KZ2B1RV0PN06WKGDR8CA4SD4
+kind: conceptual_entity
+name: Instrument
+definition: A tradeable financial instrument held or referenced by the fund.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/entities/portfolio.yaml

@@ -0,0 +1,4 @@
+id: 01KZ2CBAD92B7NJ7XQ20PA09VK
+kind: conceptual_entity
+name: Portfolio
+definition: A mandate within the pension scheme with its own strategy and benchmark.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/entities/position.yaml

@@ -0,0 +1,4 @@
+id: 01KZ2CKNG2D1NKYJP72NC3HPVK
+kind: conceptual_entity
+name: Position
+definition: A holding of an instrument within a portfolio as of a date.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/entities/price.yaml

@@ -0,0 +1,4 @@
+id: 01KZ2CRW88NTFF2DFTK95FYF4R
+kind: conceptual_entity
+name: Price
+definition: An observed market price for an instrument on a date.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/entities/transaction.yaml

@@ -0,0 +1,4 @@
+id: 01KZ2FSTGAWJTYW5CENB6Y8P8N
+kind: conceptual_entity
+name: Transaction
+definition: An executed trade or cash movement affecting a portfolio.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/conceptual/subject-areas/counterparty.yaml

@@ -0,0 +1,5 @@
+id: 01KZ265963K1SX5TK770VJEYHD
+kind: subject_area
+name: Counterparty Management
+definition: >
+  Everything about the parties the firm transacts with.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/domains/asset_class_enum.yaml

@@ -0,0 +1,6 @@
+id: 01KZDOMAINASSETCLASS000000
+kind: domain
+name: asset_class_enum
+base_type: string
+definition: The regulatory asset class of a tradeable instrument.
+allowed_values: [equity, govt_bond, corp_bond, fx, derivative]

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/domains/identifier_bigint.yaml

@@ -0,0 +1,5 @@
+id: 01KZ265963936WFM47WBDJC88H
+kind: domain
+name: identifier_bigint
+base_type: bigint
+definition: A surrogate or business identifier stored as a 64-bit integer.

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/entities/benchmark.yaml

@@ -0,0 +1,15 @@
+id: 01KZ2FV3S3JZJQFY7QAA969635
+kind: logical_entity
+name: benchmark
+realises: 01KZ2FV3S38T2N77S0V8RQE4Z1
+attributes:
+  - id: 01KZ2Z2847JT0V7W2BB7JKTD69
+    name: benchmark_code
+    domain: string
+    role: business_key
+    nullable: false
+  - id: 01KZ2Z2EZ23J4F0KCKXZ3GV4ZQ
+    name: benchmark_name
+    domain: string
+    role: attribute
+    nullable: false

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/entities/counterparty.yaml

@@ -0,0 +1,20 @@
+id: 01KZ2659634FAG7WT6KDWKA62S
+kind: logical_entity
+name: counterparty
+realises: 01KZ2659638XNEK72JK6PGQA7P
+attributes:
+  - id: 01KZ265963ANMN3276ZTRPT5K3
+    name: counterparty_id
+    domain: identifier_bigint
+    role: business_key
+    nullable: false
+  - id: 01KZ2MAGACD933NTCW8DB0AERF
+    name: legal_name
+    domain: string
+    role: attribute
+    nullable: false
+  - id: 01KZ2MBC38TAWEE2VSG6AKV652
+    name: country
+    domain: string
+    role: attribute
+    nullable: false

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/entities/instrument.yaml

@@ -0,0 +1,28 @@
+id: 01KZ2B1RV0BZ5257G4AFKRW34X
+kind: logical_entity
+name: instrument
+realises: 01KZ2B1RV0PN06WKGDR8CA4SD4
+udp:
+  system_of_record: security_master
+  criticality: tier_1
+attributes:
+  - id: 01KZ2WQ5DTWCEVGQ568DK327BA
+    name: instrument_id
+    domain: identifier_bigint
+    role: business_key
+    nullable: false
+  - id: 01KZ2WQQZ39FVQBZQ3C05AX8HR
+    name: isin
+    domain: string
+    role: attribute
+    nullable: true
+  - id: 01KZ2YPXB764KAQ3B6VJR3M0AX
+    name: asset_class
+    domain: asset_class_enum
+    role: attribute
+    nullable: true
+  - id: 01KZ31ZGXYM6JQB1JJQSZR7E19
+    name: counterparty_id
+    domain: identifier_bigint
+    role: attribute
+    nullable: true

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/entities/portfolio.yaml

@@ -0,0 +1,20 @@
+id: 01KZ2CBAD9WD1EH0ZKQP3ESE2N
+kind: logical_entity
+name: portfolio
+realises: 01KZ2CBAD92B7NJ7XQ20PA09VK
+attributes:
+  - id: 01KZ2Z4MRKZEPPEWP1CE02F36B
+    name: portfolio_code
+    domain: string
+    role: business_key
+    nullable: false
+  - id: 01KZ2Z5EJDS5HCHA7KVMVTDYTE
+    name: mandate
+    domain: string
+    role: attribute
+    nullable: true
+  - id: 01KZ30ERDDHAA7FD11599HKTRW
+    name: benchmark_code
+    domain: string
+    role: attribute
+    nullable: true

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/entities/position.yaml

@@ -0,0 +1,25 @@
+id: 01KZ2CKNG2S3P5AX7PK826ET35
+kind: logical_entity
+name: position
+realises: 01KZ2CKNG2D1NKYJP72NC3HPVK
+attributes:
+  - id: 01KZ2Z6NHHYYZ8DQ5DRMRKHXZ6
+    name: as_of_date
+    domain: date
+    role: attribute
+    nullable: true
+  - id: 01KZ2Z70D8HAHT89DVSHBQ7S8E
+    name: quantity
+    domain: decimal
+    role: attribute
+    nullable: true
+  - id: 01KZ30H8PZ4VT0BSRDT2FP51X4
+    name: portfolio_code
+    domain: string
+    role: attribute
+    nullable: true
+  - id: 01KZ30PT8AEJG9ZB45S4TD7MNC
+    name: instrument_id
+    domain: identifier_bigint
+    role: attribute
+    nullable: true

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/entities/price.yaml

@@ -0,0 +1,25 @@
+id: 01KZ2CRW88VH6N972NY2G9VPDX
+kind: logical_entity
+name: price
+realises: 01KZ2CRW88NTFF2DFTK95FYF4R
+attributes:
+  - id: 01KZ2Z86TFTBHY3PPKYMZMCWCE
+    name: price_id
+    domain: string
+    role: business_key
+    nullable: false
+  - id: 01KZ2Z8KKVG5T5F8Z3WX5X6WZM
+    name: price_date
+    domain: date
+    role: attribute
+    nullable: false
+  - id: 01KZ2Z90YTHJJ552D9N6V4QQK1
+    name: close_price
+    domain: decimal
+    role: attribute
+    nullable: true
+  - id: 01KZ30XJ1JZRY1V45N4CKKMV85
+    name: instrument_id
+    domain: identifier_bigint
+    role: attribute
+    nullable: true

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/entities/transaction.yaml

@@ -0,0 +1,30 @@
+id: 01KZ2FSTGAEEH1QAZW9HTQVY1W
+kind: logical_entity
+name: transaction
+realises: 01KZ2FSTGAWJTYW5CENB6Y8P8N
+attributes:
+  - id: 01KZ2ZA5N02M22KVNN83DFK2T5
+    name: transaction_id
+    domain: string
+    role: business_key
+    nullable: false
+  - id: 01KZ2ZAJ1NXCMSWY9W6ZSC1SR4
+    name: trade_date
+    domain: date
+    role: attribute
+    nullable: false
+  - id: 01KZ2ZAW64TQGZRQDGGCNAEDZ6
+    name: amount
+    domain: decimal
+    role: attribute
+    nullable: true
+  - id: 01KZ30YSQ78B6XPFDV3H2GF6CT
+    name: portfolio_code
+    domain: string
+    role: attribute
+    nullable: true
+  - id: 01KZ30Z75KQ5TY8C3CJAKVG5NS
+    name: counterparty_id
+    domain: identifier_bigint
+    role: attribute
+    nullable: true

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/key-groups/ak_instrument_isin.yaml

@@ -0,0 +1,6 @@
+id: 01KZKEYGROUPINSTRUMENTAK000
+kind: key_group
+entity: 01KZ2B1RV0BZ5257G4AFKRW34X
+name: ak_instrument_isin
+type: unique
+members: [01KZ2WQQZ39FVQBZQ3C05AX8HR]

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/key-groups/pk_instrument.yaml

@@ -0,0 +1,6 @@
+id: 01KZKEYGROUPINSTRUMENTPK000
+kind: key_group
+entity: 01KZ2B1RV0BZ5257G4AFKRW34X
+name: pk_instrument
+type: pk
+members: [01KZ2WQ5DTWCEVGQ568DK327BA]

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/relationships/instrument_to_counterparty.yaml

@@ -0,0 +1,13 @@
+id: 01KZ31ZGXYKE7S82XFEP8A774C
+kind: relationship
+name: instrument_to_counterparty
+from:
+  entity: 01KZ2B1RV0BZ5257G4AFKRW34X
+  attributes:
+    - 01KZ31ZGXYM6JQB1JJQSZR7E19
+to:
+  entity: 01KZ2659634FAG7WT6KDWKA62S
+  attributes:
+    - 01KZ265963ANMN3276ZTRPT5K3
+cardinality: many_to_one
+optionality: mandatory

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/relationships/portfolio_to_benchmark.yaml

@@ -0,0 +1,13 @@
+id: 01KZ30ERDEA64BS5CZPXQT0G8N
+kind: relationship
+name: portfolio_to_benchmark
+from:
+  entity: 01KZ2CBAD9WD1EH0ZKQP3ESE2N
+  attributes:
+    - 01KZ30ERDDHAA7FD11599HKTRW
+to:
+  entity: 01KZ2FV3S3JZJQFY7QAA969635
+  attributes:
+    - 01KZ2Z2847JT0V7W2BB7JKTD69
+cardinality: many_to_one
+optionality: mandatory

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/relationships/position_to_instrument.yaml

@@ -0,0 +1,13 @@
+id: 01KZ30PT8AKWRTSBH3V9F84RAM
+kind: relationship
+name: position_to_instrument
+from:
+  entity: 01KZ2CKNG2S3P5AX7PK826ET35
+  attributes:
+    - 01KZ30PT8AEJG9ZB45S4TD7MNC
+to:
+  entity: 01KZ2B1RV0BZ5257G4AFKRW34X
+  attributes:
+    - 01KZ2WQ5DTWCEVGQ568DK327BA
+cardinality: many_to_one
+optionality: mandatory

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/relationships/position_to_portfolio.yaml

@@ -0,0 +1,13 @@
+id: 01KZ30H8PZGYM161RFKXKRXC16
+kind: relationship
+name: position_to_portfolio
+from:
+  entity: 01KZ2CKNG2S3P5AX7PK826ET35
+  attributes:
+    - 01KZ30H8PZ4VT0BSRDT2FP51X4
+to:
+  entity: 01KZ2CBAD9WD1EH0ZKQP3ESE2N
+  attributes:
+    - 01KZ2Z4MRKZEPPEWP1CE02F36B
+cardinality: many_to_one
+optionality: mandatory

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/relationships/price_to_instrument.yaml

@@ -0,0 +1,13 @@
+id: 01KZ30XJ1JZ1KT4KT4S5YBQNB5
+kind: relationship
+name: price_to_instrument
+from:
+  entity: 01KZ2CRW88VH6N972NY2G9VPDX
+  attributes:
+    - 01KZ30XJ1JZRY1V45N4CKKMV85
+to:
+  entity: 01KZ2B1RV0BZ5257G4AFKRW34X
+  attributes:
+    - 01KZ2WQ5DTWCEVGQ568DK327BA
+cardinality: many_to_one
+optionality: mandatory

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/relationships/transaction_to_counterparty.yaml

@@ -0,0 +1,13 @@
+id: 01KZ30Z75KWPCT60D90T4DNC01
+kind: relationship
+name: transaction_to_counterparty
+from:
+  entity: 01KZ2FSTGAEEH1QAZW9HTQVY1W
+  attributes:
+    - 01KZ30Z75KQ5TY8C3CJAKVG5NS
+to:
+  entity: 01KZ2659634FAG7WT6KDWKA62S
+  attributes:
+    - 01KZ265963ANMN3276ZTRPT5K3
+cardinality: many_to_one
+optionality: mandatory

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/logical/relationships/transaction_to_portfolio.yaml

@@ -0,0 +1,13 @@
+id: 01KZ30YSQ7V3HJXCFXMBRW88RA
+kind: relationship
+name: transaction_to_portfolio
+from:
+  entity: 01KZ2FSTGAEEH1QAZW9HTQVY1W
+  attributes:
+    - 01KZ30YSQ78B6XPFDV3H2GF6CT
+to:
+  entity: 01KZ2CBAD9WD1EH0ZKQP3ESE2N
+  attributes:
+    - 01KZ2Z4MRKZEPPEWP1CE02F36B
+cardinality: many_to_one
+optionality: mandatory

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/model/mdl-project.yaml

@@ -0,0 +1,21 @@
+# Modelith project config (spec §2.2) — bundled demo model (`mdl init --demo`).
+# A 7-entity investment book-of-record (IBoR): price, instrument, position,
+# counterparty, transaction, portfolio, benchmark. Validates offline, renders a
+# populated ERD in `mdl serve`, and generates a DuckDB warehouse you can `dbt build`.
+name: pension_ibor
+dbt_target: duckdb_dev
+platform_targets:
+  - duckdb_dev
+# Ontology sources plug in by declaration (types: ols, ols-compatible, ontoportal,
+# collibra, or a local file vocabulary). Left empty so the demo runs fully offline
+# with no spawned resolver. To try live ontology search, add a source, e.g.:
+#   ontology_stack:
+#     - name: ols
+#       layer: industry
+#       type: ols
+#       url: https://www.ebi.ac.uk/ols4/api
+ontology_stack: []
+naming:
+  logical_case: snake
+  physical_case: upper_snake
+  abbreviations: {}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/dbt_project.yml

@@ -0,0 +1,6 @@
+name: warehouse
+version: "1.0.0"
+profile: warehouse
+model-paths: ["models"]
+macro-paths: ["macros"]
+target-path: target

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/macros/mdl_helpers.sql

@@ -0,0 +1,7 @@
+{% macro dbt_utils_surrogate_key(fields) %}
+    md5(cast(concat({{ fields | join(", '-', ") }}) as varchar))
+{% endmacro %}
+
+{% macro dbt_utils_hash(fields) %}
+    md5(cast(concat({{ fields | join(", '-', ") }}) as varchar))
+{% endmacro %}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/macros/mdl_hub.sql

@@ -0,0 +1,8 @@
+{% macro mdl_hub(source_relation, business_key) %}
+{#- Data Vault hub: distinct business keys with a hash key. -#}
+select distinct
+    {{ dbt_utils_surrogate_key([business_key]) }} as hub_hashkey,
+    {{ business_key }},
+    cast(current_timestamp as timestamp) as load_dts
+from {{ source_relation }}
+{% endmacro %}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/macros/mdl_scd2.sql

@@ -0,0 +1,19 @@
+{% macro mdl_scd2(source_relation, business_key, tracked_columns, valid_from='valid_from', valid_to='valid_to', is_current='is_current') %}
+{#- Type-2 slowly changing dimension. Emitted by Modelith; call from a model. -#}
+with source as (
+    select * from {{ source_relation }}
+),
+hashed as (
+    select
+        *,
+        {{ dbt_utils_surrogate_key([business_key]) }} as mdl_scd_id,
+        {{ dbt_utils_hash(tracked_columns) }}          as mdl_row_hash
+    from source
+)
+select
+    hashed.*,
+    cast(current_timestamp as timestamp)     as {{ valid_from }},
+    cast(null as timestamp)                  as {{ valid_to }},
+    true                                     as {{ is_current }}
+from hashed
+{% endmacro %}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/models/staging/stg_benchmark.sql

@@ -0,0 +1 @@
+select * from {{ ref('raw_benchmarks') }}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/models/staging/stg_counterparty.sql

@@ -0,0 +1,5 @@
+select
+    cast(counterparty_id as bigint) as counterparty_id,
+    legal_name,
+    country
+from {{ ref('raw_counterparties') }}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/models/staging/stg_instrument.sql

@@ -0,0 +1,6 @@
+select
+    cast(instrument_id as bigint) as instrument_id,
+    isin,
+    asset_class,
+    cast(counterparty_id as bigint) as counterparty_id
+from {{ ref('raw_instruments') }}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/models/staging/stg_portfolio.sql

@@ -0,0 +1 @@
+select * from {{ ref('raw_portfolios') }}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/models/staging/stg_position.sql

@@ -0,0 +1,6 @@
+select
+    as_of_date,
+    cast(quantity as decimal(38,2)) as quantity,
+    portfolio_code,
+    cast(instrument_id as bigint) as instrument_id
+from {{ ref('raw_positions') }}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/models/staging/stg_price.sql

@@ -0,0 +1,6 @@
+select
+    price_id,
+    price_date,
+    cast(close_price as decimal(38,2)) as close_price,
+    cast(instrument_id as bigint) as instrument_id
+from {{ ref('raw_prices') }}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/models/staging/stg_transaction.sql

@@ -0,0 +1,7 @@
+select
+    transaction_id,
+    trade_date,
+    cast(amount as decimal(38,2)) as amount,
+    portfolio_code,
+    cast(counterparty_id as bigint) as counterparty_id
+from {{ ref('raw_transactions') }}

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/profiles.yml

@@ -0,0 +1,9 @@
+# Local dbt profile for the IBoR demo. Uses DuckDB (file-based, zero-setup).
+# The profile name must match `profile:` in dbt_project.yml (warehouse).
+warehouse:
+  target: duckdb_dev
+  outputs:
+    duckdb_dev:
+      type: duckdb
+      path: ibor.duckdb        # created on first run, relative to this dir
+      threads: 4

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/seeds/raw_benchmarks.csv

@@ -0,0 +1,3 @@
+benchmark_code,benchmark_name
+FTSE100,FTSE 100 Index
+BARCLAYS_GILT,Barclays Sterling Gilt Index

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/seeds/raw_counterparties.csv

@@ -0,0 +1,3 @@
+counterparty_id,legal_name,country
+1,Global Custody Bank NA,US
+2,Euro Clearing SA,FR

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/seeds/raw_instruments.csv

@@ -0,0 +1,4 @@
+instrument_id,isin,asset_class,counterparty_id
+101,GB0002634946,govt_bond,2
+102,US0378331005,equity,1
+103,GB00B03MLX29,equity,1

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/seeds/raw_portfolios.csv

@@ -0,0 +1,3 @@
+portfolio_code,mandate,benchmark_code
+PF_UK_EQ,UK Equity Growth,FTSE100
+PF_FI_CORE,Core Fixed Income,BARCLAYS_GILT

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/seeds/raw_positions.csv

@@ -0,0 +1,4 @@
+as_of_date,quantity,portfolio_code,instrument_id
+2026-06-30,15000.00,PF_UK_EQ,102
+2026-06-30,22000.00,PF_UK_EQ,103
+2026-06-30,500000.00,PF_FI_CORE,101

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/seeds/raw_prices.csv

@@ -0,0 +1,4 @@
+price_id,price_date,close_price,instrument_id
+PR001,2026-06-30,182.55,102
+PR002,2026-06-30,7.34,103
+PR003,2026-06-30,98.20,101

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/_demo/transform/warehouse/seeds/raw_transactions.csv

@@ -0,0 +1,4 @@
+transaction_id,trade_date,amount,portfolio_code,counterparty_id
+TXN001,2026-06-15,2738250.00,PF_UK_EQ,1
+TXN002,2026-06-20,161480.00,PF_UK_EQ,1
+TXN003,2026-06-25,49100000.00,PF_FI_CORE,2

modelith_dbt-0.3.2/packages/cli/src/mdl_cli/demo.py

@@ -0,0 +1,84 @@
+"""`mdl init --demo`: scaffold a populated example from a bundled adoption asset.
+
+The plain scaffold (`scaffold.py`) writes one entity, so a first `mdl serve` shows a
+near-empty grid. `--demo` instead lays down a real 7-entity investment
+book-of-record model (price, instrument, position, counterparty, transaction,
+portfolio, benchmark) plus a matching DuckDB dbt project, so the very first
+`mdl serve` renders a populated ERD and the full offline loop
+(`serve` → `validate` → `generate` → `dbt build`) runs with no warehouse account
+(spec §4.2).
+
+The asset is vendored under `_demo/` and shipped in the wheel. On copy we mint a
+fresh ULID for every id in the model so two `init --demo` runs, or two demos in one
+workspace, never collide on identity — while preserving cross-references (a given
+old id maps to one new id everywhere it appears).
+"""
+
+from __future__ import annotations
+
+import shutil
+from importlib import resources
+from pathlib import Path
+
+from mdl_core.ids import is_ulid, new_ulid
+
+# Files whose ULIDs we remint. YAML/text model files only; CSV seeds and .sql
+# carry no ULIDs, and the dbt project references models by name, not id.
+_REMINT_SUFFIXES = {".yaml", ".yml"}
+
+
+def _remint_ids(text: str, mapping: dict[str, str]) -> str:
+    """Replace every 26-char ULID token in `text` with a stable fresh ULID, so
+    references (realises:, subject_area:, relationship endpoints) stay consistent.
+    A token is any whitespace/quote/punctuation-delimited run; we only swap ones
+    `is_ulid` accepts, so ordinary words are untouched."""
+    out: list[str] = []
+    token = ""
+
+    def flush() -> None:
+        nonlocal token
+        if token and is_ulid(token):
+            out.append(mapping.setdefault(token, new_ulid()))
+        else:
+            out.append(token)
+        token = ""
+
+    for ch in text:
+        if ch.isalnum():
+            token += ch
+        else:
+            flush()
+            out.append(ch)
+    flush()
+    return "".join(out)
+
+
+def scaffold_demo(root: Path) -> list[str]:
+    """Copy the bundled demo into `root`, reminting ids. Returns the relative paths
+    written, sorted."""
+    root.mkdir(parents=True, exist_ok=True)
+    src = resources.files("mdl_cli") / "_demo"
+    mapping: dict[str, str] = {}
+    written: list[str] = []
+
+    # resources.files gives a Traversable; materialise it to a real path so we can
+    # walk it. For a normal (non-zipped) wheel install this is a directory on disk.
+    with resources.as_file(src) as src_dir:
+        for path in sorted(Path(src_dir).rglob("*")):
+            if path.is_dir():
+                continue
+            rel = path.relative_to(src_dir)
+            dest = root / rel
+            dest.parent.mkdir(parents=True, exist_ok=True)
+            if path.suffix in _REMINT_SUFFIXES:
+                dest.write_text(
+                    _remint_ids(path.read_text(encoding="utf-8"), mapping),
+                    encoding="utf-8",
+                )
+            else:
+                shutil.copyfile(path, dest)
+            written.append(str(rel))
+
+    # State dir the tool expects (excluded from the vendored asset).
+    (root / "model" / ".mdl" / "state").mkdir(parents=True, exist_ok=True)
+    return written