wraith-sas-lineage 0.2.0__tar.gz

wraith_sas_lineage-0.2.0/.claude/settings.local.json

@@ -0,0 +1,48 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv run *)",
+      "Read(//home/thomaspeoples/pjt-nas/nas/SovereignDocs/gitea-repos/**)",
+      "Bash(ls -la sas-lineage-scaffolding-plan.md)",
+      "Bash(ls *.md)",
+      "Bash(ls -la wraith-sas-lineage/docs/)",
+      "Bash(ls -la wraith-sas-lineage/schema/)",
+      "Bash(uv sync *)",
+      "Bash(uv --version)",
+      "Bash(git add *)",
+      "Bash(git commit -m '👻 feature/TJP-20061: wire column-level lineage end to end *)",
+      "Bash(git stash *)",
+      "Bash(grep -nA15 \"\\\\[tool.ruff\" pyproject.toml)",
+      "Bash(git commit -m '👻 feature/TJP-20061: audit pass — stable flag IDs, lint clean *)",
+      "Bash(git commit -m '👻 feature/TJP-20061: wire patterns.py TODOs + factory dedup *)",
+      "Bash(git commit -m '👻 feature/TJP-20061: resolve final 8 patterns — zero unused *)",
+      "Bash(git commit -m '👻 feature/TJP-20061: step_count_mismatch as first-class flag *)",
+      "Bash(git rm *)",
+      "Bash(rm -f ../sas-lineage-scaffolding-plan.md)",
+      "Bash(git commit -m '👻 feature/TJP-20061: consolidate plans into docs/roadmap.md *)",
+      "Bash(git commit -m '👻 feature/TJP-20061: changelog + move pydoc config into pyproject *)",
+      "Bash(git commit -m '👻 fix/TJP-20061: CI uses uv.lock via setup-uv, drop system python *)",
+      "Bash(git push *)",
+      "Bash(git commit -m '👻 fix/TJP-20061: use image uv, drop setup-uv download *)",
+      "Bash(gh pr *)",
+      "Bash(echo \"---gh exit: $?\")",
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\\\\n\" https://git.thomaspeoples.com/api/v1/repos/thomaspeoples/wraith-sas-lineage)",
+      "Bash(curl -s https://git.thomaspeoples.com/api/v1/repos/thomaspeoples/wraith-sas-lineage)",
+      "Bash(python3 -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\('has_pull_requests:', d.get\\('has_pull_requests'\\)\\); print\\('default_branch:', d.get\\('default_branch'\\)\\)\")",
+      "Bash(git commit -m '👻 fix/TJP-20061: debug step to resolve auto-merge API target *)",
+      "Bash(git commit -m '👻 fix/TJP-20061: probe both api_url shapes for auto-merge 404 *)",
+      "Bash(git commit -m '👻 fix/TJP-20061: remove temporary auto-merge debug step *)",
+      "Bash(grep -nA40 \"commitizen\" pyproject.toml)",
+      "Bash(git fetch *)",
+      "Bash(echo \"dryrun exit: $?\")",
+      "Bash(echo \"real exit: $?\")",
+      "Bash(echo \"=====EXIT: $?=====\")",
+      "Bash(echo \"bump exit: $?\")",
+      "Read(//tmp/**)",
+      "Bash(echo \"REAL bump exit: $?\")",
+      "Bash(xargs -I{} grep -rn \"No tag found to do an incremental\" {})",
+      "Bash(git checkout *)",
+      "Bash(git ls-remote *)"
+    ]
+  }
+}

wraith_sas_lineage-0.2.0/.cz.yaml

@@ -0,0 +1,64 @@
+commitizen:
+  name: cz_customize
+  version_provider: uv
+  version_scheme: semver
+  major_version_zero: true
+  update_changelog_on_bump: true
+  tag_format: v$version
+  bump_message: ":ghost: chore: release v$current_version -> v$new_version [skip ci]"
+
+  customize:
+    bump_map:
+      Break: MAJOR
+      break: MAJOR
+      Feature: MINOR
+      feature: MINOR
+      Fix: PATCH
+      fix: PATCH
+      Bug: PATCH
+      bug: PATCH
+
+    bump_pattern: '(feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}'
+
+    commit_parser: '.*?(?P<change_type>feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}: (?P<message>.*)'
+
+    change_type_map:
+      Break: "Breaking Changes"
+      break: "Breaking Changes"
+      Feature: "Features"
+      feature: "Features"
+      Fix: "Bug Fixes"
+      fix: "Bug Fixes"
+      Bug: "Bug Fixes"
+      bug: "Bug Fixes"
+
+    change_type_order:
+      - break
+      - Break
+      - feature
+      - Feature
+      - fix
+      - Fix
+      - bug
+      - Bug
+
+    changelog_pattern: '.*(feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}'
+
+    example: '👻 feature/TJP-00001: implement sovereign automation'
+    message_template: '{{change_type}}: {{message}}'
+
+    questions:
+      - name: change_type
+        type: list
+        message: Select the type of change you are committing
+        choices:
+          - {name: "break:   A breaking change", value: break}
+          - {name: "feature: A new feature", value: feature}
+          - {name: "fix:     A standard fix", value: fix}
+          - {name: "bug:     A specific bug fix", value: bug}
+      - name: message
+        type: input
+        message: "Enter a brief description:"
+
+    schema: '<type>/<ticket>: <body>'
+    schema_pattern: '^.*(feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}: (.*)'

wraith_sas_lineage-0.2.0/.env.example

@@ -0,0 +1,16 @@
+# Paths to deployed SAS estate
+SAS_CODE_DIR=/path/to/sas/code
+SAS_LOG_DIR=/path/to/sas/logs
+
+# Output paths
+PROVENANCE_OUTPUT=./provenance.json
+PARSE_REPORT_OUTPUT=./parse_report.json
+CONTRACTS_OUTPUT=./contracts/
+DB_PATH=./lineage.db
+
+# Optional: manual owner/domain overlay
+OWNER_MAP_PATH=./owner_map.json
+
+# Web UI
+FLASK_ENV=development
+FLASK_PORT=5000

wraith_sas_lineage-0.2.0/.gitea/CODEOWNERS.md

@@ -0,0 +1 @@
+* @thomaspeoples

wraith_sas_lineage-0.2.0/.gitea/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,32 @@
+# 👻 Ghost Stack Pull Request
+
+## 🎯 Purpose
+_What are we haunting today? Briefly describe the change._
+
+**Fixes:** # (Link the Gitea Issue here)
+
+---
+
+## 🛠️ Proposed Changes
+- [ ] Logic updated in `src/`
+- [ ] Dependencies synced via `uv lock`
+- [ ] Schema updated in `schema/` if models changed
+
+---
+
+## 🚦 Quality Gate (The Ghost Protocol)
+- [ ] **uv Sync:** Environment is healthy and `uv.lock` is up to date.
+- [ ] **Tests:** `./bin/run_tests.sh` passes with >80% coverage.
+- [ ] **Linting:** `pre-commit run --all-files` passes.
+- [ ] **Commits:** Messages follow the `cz_customize` regex (Fix/Feature/Break).
+
+---
+
+## 🧪 Deployment & Verification
+- [ ] Branch is synced with the latest `main`.
+- [ ] Thin-slice test (one job end-to-end) passes if parser heuristics changed.
+
+---
+
+## 👤 Author's Final Word
+_Any specific notes for the reviewer or warnings about breaking changes?_

wraith_sas_lineage-0.2.0/.gitea/workflows/pages.yml

@@ -0,0 +1,59 @@
+name: Deploy Gitea Pages
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run Tests & Coverage
+        run: uv run pytest --cov=src --cov-report=xml
+
+      - name: Generate Coverage Badge
+        run: uv run genbadge coverage -i coverage.xml -o docs/coverage.svg
+
+      - name: Build Documentation
+        run: uv run mkdocs build
+
+      - name: Sync to Main Website Repo
+        env:
+          MY_TOKEN: ${{ secrets.GITEATOKEN }}
+          MY_URL: ${{ secrets.GITEAURL }}
+
+        run: |
+          # 1. Clone your main website repo
+          CLEAN_URL=${MY_URL#*//}
+          git clone https://${MY_TOKEN}@${CLEAN_URL}/thomaspeoples/ghost-site.git main_site
+
+          # 2. Create the target directory if it doesn't exist
+          TARGET_DIR="main_site/www/gitea-repos/wraith-sas-lineage"
+          mkdir -p $TARGET_DIR
+
+          # 3. Clean and Copy
+          rm -rf $TARGET_DIR/*
+          cp -r site/* $TARGET_DIR/
+
+          # 4. Commit and Push to the OTHER repo
+          cd main_site
+          git config user.name "Ghost Runner"
+          git config user.email "runner@ghost-stack.local"
+          git add .
+          if git diff --staged --quiet; then
+            echo "No changes to documentation. Skipping commit."
+          else
+            git commit -m ":books: main: Update docs for wraith-sas-lineage: ${{ gitea.sha }}"
+            git push origin main
+          fi

wraith_sas_lineage-0.2.0/.gitea/workflows/release.yml

@@ -0,0 +1,23 @@
+name: 'Sovereign Release'
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    runs-on: ghost-runner
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITEA_TOKEN }}
+
+      - name: Run Ghost Bump
+        uses: https://git.thomaspeoples.com/thomaspeoples/ci-actions/version-bump@main
+        with:
+          gitea_token: ${{ secrets.giteatoken }}
+          api_url: "${{ secrets.giteaurl }}/api/v1"

wraith_sas_lineage-0.2.0/.gitea/workflows/test.yml

@@ -0,0 +1,35 @@
+name: SAS Lineage CI
+
+on:
+  push:
+    branches-ignore:
+      - 'main'
+
+jobs:
+  test-and-verify:
+    runs-on: ghost-runner
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install dependencies
+        run: uv sync --all-extras
+      - name: Run Tests
+        run: |
+          chmod +x bin/run_tests.sh
+          ./bin/run_tests.sh
+        env:
+          PYTHONPATH: .
+
+  auto-merge:
+    needs: test-and-verify
+    if: github.ref != 'refs/heads/main'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Call Central Merge Action
+        uses: https://git.thomaspeoples.com/thomaspeoples/ci-actions/auto-merge@main
+        with:
+          gitea_token: ${{ secrets.giteatoken }}
+          api_url: "${{ secrets.giteaurl }}/api/v1"

wraith_sas_lineage-0.2.0/.gitignore

@@ -0,0 +1,28 @@
+.uv/
+__pycache__/
+*.py[cod]
+*.so
+build/
+dist/
+*.egg-info/
+.eggs/
+htmlcov/
+.coverage
+.coverage.*
+.cache
+.pytest_cache/
+.tox/
+.venv
+venv/
+env/
+ENV/
+.env
+.env.private
+/site
+.mypy_cache/
+*.db
+*.sqlite3
+provenance.json
+parse_report.json
+mapping_gaps.json
+contracts/

wraith_sas_lineage-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+    -   id: check-added-large-files
+
+-   repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.4
+    hooks:
+    -   id: ruff
+        args: [--fix]
+    -   id: ruff-format
+
+-   repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+    -   id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+        exclude: uv.lock
+
+-   repo: local
+    hooks:
+    -   id: pytest-coverage
+        name: pytest-coverage
+        entry: ./bin/run_tests.sh
+        language: system
+        pass_filenames: false
+        always_run: true
+
+    -   id: commitizen
+        name: commitizen check
+        entry: uv run cz check --commit-msg-file
+        language: system
+        stages: [commit-msg]

wraith_sas_lineage-0.2.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to `wraith-sas-lineage` are documented here.
+
+## v0.2.0 (2026-06-21)
+
+### Features
+
+- on a pig it looks nice' (#3) from feature/TJP-21061 into main
+- on a pig it looks nice
+- release v0.1.0 -> v0.2.0 [skip ci]
+
+## v0.0.1 (2026-06-20)
+
+### Features
+
+- Initial scaffold: parser, schema mapper, and web UI skeletons
+- Provenance JSON schema and Turso DDL
+- Extractor protocol and implementations for DATA step, PROC SQL, RSUBMIT, SCD2, LIBNAME

wraith_sas_lineage-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,69 @@
+# Contributing to wraith-sas-lineage
+
+## Prerequisites
+
+- Python 3.12+
+- [`uv`](https://docs.astral.sh/uv/) for dependency management
+
+## Setup
+
+```bash
+git clone https://git.thomaspeoples.com/thomaspeoples/wraith-sas-lineage.git
+cd wraith-sas-lineage
+uv run poe setup
+```
+
+This syncs all dependencies and installs pre-commit hooks.
+
+## Running tests
+
+```bash
+uv run poe test
+```
+
+Coverage must stay above 80%. The suite runs without any external services — no SAS licence, no database connections, no network.
+
+## Code style
+
+Ruff handles formatting and linting:
+
+```bash
+uv run poe lint
+uv run poe format
+```
+
+Line length is 79 characters.
+
+## Commits
+
+Commits follow the Ghost Stack convention via commitizen:
+
+```
+👻 <type>/<ticket>: <message>
+```
+
+```bash
+uv run cz commit
+```
+
+Do not bypass pre-commit hooks with `--no-verify`.
+
+## Pull requests
+
+- One concern per PR.
+- Include or update tests for any behaviour change.
+- If the change affects the JSON provenance schema or the Turso DDL, update `schema/` and the relevant `docs/` page.
+- Run the full pre-commit suite before opening: `uv run pre-commit run --all-files`.
+
+## Adding a new extractor
+
+1. Create `src/sas_lineage/parser/extractors/<name>.py` implementing the `StepExtractor` protocol.
+2. Register it in `parser/cli.py` via `builder.register(MyExtractor())`.
+3. Add tests in `tests/test_parser/test_extractors.py`.
+4. Add fixture SAS snippets to `tests/test_parser/fixtures/` if needed.
+
+Extractors must be additive — they receive a block and return what they find. Never raise; return a `Flag` instead.
+
+## Reporting issues
+
+Open a Gitea issue with the SAS snippet (anonymised), the log excerpt, and the exact command you ran. For extraction failures, include the `parse_report.json` and relevant entries from `mapping_gaps.json`.

wraith_sas_lineage-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Peoples
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wraith_sas_lineage-0.2.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: wraith-sas-lineage
+Version: 0.2.0
+Summary: SAS lineage extraction, schema mapping, and ODCS contract generation for the Ghost Stack.
+Project-URL: Homepage, https://git.thomaspeoples.com/thomaspeoples/wraith-sas-lineage
+Project-URL: Repository, https://git.thomaspeoples.com/thomaspeoples/wraith-sas-lineage.git
+Project-URL: Documentation, https://www.thomaspeoples.com/gitea-repos/wraith-sas-lineage/
+Project-URL: Issues, https://git.thomaspeoples.com/thomaspeoples/wraith-sas-lineage/issues
+Project-URL: Changelog, https://git.thomaspeoples.com/thomaspeoples/wraith-sas-lineage/src/branch/main/CHANGELOG.md
+Author-email: Thomas Peoples <hello@thomaspeoples.com>
+License: MIT License
+        
+        Copyright (c) 2026 Thomas Peoples
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: analytics-engineering,data-contracts,ghost-stack,lineage,odcs,sas
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1
+Requires-Dist: flask>=3.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: commitizen; extra == 'dev'
+Requires-Dist: detect-secrets; extra == 'dev'
+Requires-Dist: genbadge[coverage]>=1.1.1; extra == 'dev'
+Requires-Dist: mkdocs; extra == 'dev'
+Requires-Dist: mkdocs-material; extra == 'dev'
+Requires-Dist: mkdocstrings[python]; extra == 'dev'
+Requires-Dist: poethepoet; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pydoc-markdown; extra == 'dev'
+Requires-Dist: pymdown-extensions; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: ty; extra == 'dev'
+Requires-Dist: typer; extra == 'dev'
+Description-Content-Type: text/markdown
+
+[![Documentation](https://img.shields.io/badge/docs-live-brightgreen)](https://www.thomaspeoples.com/gitea-repos/wraith-sas-lineage/)
+![License](https://img.shields.io/badge/license-MIT-blue)
+![Python](https://img.shields.io/badge/python-3.12%2B-blue)
+
+# 👻 wraith-sas-lineage
+### *SAS Lineage Extraction for the Ghost Stack*
+
+**wraith-sas-lineage** extracts data lineage from SAS DI Studio code and verbose execution logs, maps it to Open Data Contract Standard (ODCS) contracts, and serves a local read-only lineage explorer. One JSON artefact connects all three tools.
+
+Designed for large SAS estates running on Unix. Output feeds [wraith-modelgen](https://git.thomaspeoples.com/thomaspeoples/wraith-modelgen) to auto-generate dbt on BigQuery.
+
+---
+
+## Three tools. One seam.
+
+```
+.sas + .log files
+      │
+      ▼
+  sas-parse  ──►  provenance.json
+                       │
+                       ▼
+                   sas-map  ──►  lineage.db  +  ODCS contracts  +  gaps report
+                                     │
+                                     ▼
+                                  sas-ui  ──►  localhost:5000
+```
+
+| Command | Input | Output |
+|---|---|---|
+| `sas-parse` | `.sas` files + verbose logs | `provenance.json` |
+| `sas-map` | `provenance.json` | `lineage.db`, ODCS YAML contracts, `mapping_gaps.json` |
+| `sas-ui` | `lineage.db` | Read-only lineage explorer |
+
+---
+
+## Install
+
+```bash
+uv tool install wraith-sas-lineage
+```
+
+Or for development:
+
+```bash
+git clone https://git.thomaspeoples.com/thomaspeoples/wraith-sas-lineage.git
+cd wraith-sas-lineage
+uv run poe setup
+```
+
+---
+
+## Quick start
+
+```bash
+# Parse SAS code + logs
+sas-parse \
+  --code-dir /path/to/sas/code \
+  --log-dir  /path/to/verbose/logs \
+  --estate   acme-risk \
+  --output   provenance.json
+
+# Map to DB + ODCS contracts
+sas-map \
+  --provenance provenance.json \
+  --db         lineage.db \
+  --contracts-dir contracts/ \
+  --gaps       mapping_gaps.json
+
+# Browse lineage
+sas-ui --db lineage.db
+# → http://localhost:5000/flags      all extraction flags
+# → http://localhost:5000/provenance upstream chain for a column
+# → http://localhost:5000/lineage    downstream to all MARTs
+```
+
+---
+
+## Design principles
+
+**Flag-never-drop.** Unresolved macros, remote execution blocks, and hand-written code surface as `Flag` objects with reason, context, and snippet. Nothing is silently discarded.
+
+**Log-first macro resolution.** `SYMBOLGEN`/`MLOGIC` log lines resolve `&macro_var` references before falling back to the code literal. Accurate lineage for DI Studio estates requires verbose logs.
+
+**Single seam.** `provenance.json` is the only interface between tools. Each tool is independently runnable and testable.
+
+**Content-hashed stable IDs.** Table, column, job, and lineage chain IDs are `SHA-256[:12]` of their canonical string. Same estate, same run, same IDs.
+
+---
+
+## Layer vocabulary
+
+| SAS layer | Schema value |
+|---|---|
+| RAW | `RAW` |
+| ODS (ODP) | `ODP` |
+| STG (CDP) | `CDP` |
+| MART (FDP) | `FDP` |
+
+---
+
+## Developer quality gate
+
+```bash
+uv run poe test       # pytest (interactive)
+uv run poe test-ci    # pytest + coverage ≥ 80%
+uv run poe lint       # ruff check
+uv run poe format     # ruff format
+uv run poe docs-serve # mkdocs at localhost:8000
+```
+
+All commits go through commitizen:
+
+```bash
+uv run cz commit
+```
+
+---
+
+*Part of the [Ghost Stack](https://git.thomaspeoples.com/thomaspeoples). Sovereign. Self-hosted. No nonsense.*