lintel-api 0.1.0a1__tar.gz

lintel_api-0.1.0a1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,97 @@
+name: Release Lintel to PyPI
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Existing release tag to publish
+        required: true
+        type: string
+permissions:
+  contents: read
+concurrency:
+  group: lintel-pypi-${{ github.event.release.tag_name || inputs.tag }}
+  cancel-in-progress: false
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    env:
+      TAG: ${{ github.event.release.tag_name || inputs.tag }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.tag }}
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: '0.13.3'
+      - name: Check release identity
+        run: |
+          python3 - <<'PY'
+          import os, tomllib
+          from pathlib import Path
+          p = tomllib.loads(Path('pyproject.toml').read_text())['project']
+          assert p['name'] == 'lintel-api'
+          assert os.environ['TAG'] == 'v' + p['version']
+          PY
+      - name: Validate source and build archives
+        run: |
+          uv sync --locked --group spike --python 3.11
+          uv run --locked python -m ruff check src scripts spikes tests
+          uv run --locked python -m ruff format --check src scripts spikes tests
+          uv run --locked python scripts/check_boundaries.py
+          uv run --locked python -m pytest -q
+          uv build
+          uvx --from twine==7.0.0 twine check --strict dist/*
+          sha256sum dist/* > SHA256SUMS
+      - name: Check installed wheel outside the checkout
+        run: |
+          uv venv --python 3.11 "$RUNNER_TEMP/installed"
+          uv pip install --python "$RUNNER_TEMP/installed/bin/python" dist/*.whl
+          "$RUNNER_TEMP/installed/bin/python" -I scripts/check_installed.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: lintel-distributions
+          path: |
+            dist/*
+            SHA256SUMS
+          if-no-files-found: error
+  publish:
+    needs: build
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: lintel-distributions
+          path: incoming
+      - name: Verify archive hashes
+        working-directory: incoming
+        run: sha256sum --check SHA256SUMS
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: incoming/dist/
+  public-consumer:
+    needs: publish
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.tag }}
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: '0.13.3'
+      - name: Install and exercise the public package
+        env:
+          TAG: ${{ github.event.release.tag_name || inputs.tag }}
+        run: |
+          uv venv --python 3.11 "$RUNNER_TEMP/public"
+          uv pip install --no-cache --index-url https://pypi.org/simple --python "$RUNNER_TEMP/public/bin/python" "lintel-api==${TAG#v}"
+          "$RUNNER_TEMP/public/bin/python" -I scripts/check_installed.py

lintel_api-0.1.0a1/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.py[cod]
+node_modules/
+.pytest_cache/
+.ruff_cache/
+dist/

lintel_api-0.1.0a1/.helix.yml

@@ -0,0 +1,3 @@
+flows:
+  - id: helix
+    root: docs/helix/

lintel_api-0.1.0a1/AGENTS.md

@@ -0,0 +1,32 @@
+# Working in Lintel
+
+Start at `docs/helix/README.md`. Use the installed HELIX skill and `.helix.yml`;
+keep governed artifacts under `docs/helix/`. Resolve the catalog from the installed
+plugin. Preserve IDs, frontmatter, traceability and unfamiliar metadata.
+
+Lintel is an independently packaged, embeddable Python GraphQL/Relay API runtime
+in the UMF family, intended for inclusion in Batten's qualified runtime.
+The owner selected Python/FastAPI, GraphQL + Relay and TypeScript client builds.
+REST/OpenAPI product APIs are outside the MVP. The name is provisional.
+
+UMF owns modeling and executable schema semantics; Weft owns SQL compilation;
+the existing access/graph runtimes own execution. Batten owns application
+admission, authenticated authority, confirmation, attribution and resource custody.
+Lintel defines neutral public execution ports; Batten owns its integration adapter
+in Batten. Lintel must not import Batten, and generic Batten core must not import
+Lintel or GraphQL. Never duplicate an engine or bypass Batten's host.
+Do not depend on any consuming application's internals.
+
+Use Python 3.11 as the initial library compatibility floor; qualify the actual
+Databricks Apps interpreter separately. Use uv, Ruff, Pyright and pytest.
+Use TypeScript/Bun for Relay client build tooling and real Chromium checks.
+No runtime package installation; no schema-selected code execution; no new
+application environment variables. Configuration is typed, file-based and injected.
+Use fabricated data. Qualify every claim by cohort, subset and observed evidence.
+
+The packet specifies desired behavior; src/lintel/experimental contains the bounded
+direct-UMF projection, and spikes/direct_umf its harness. This alpha is not a
+production runtime or full conformance claim.
+Consume UMF JSON directly; do not introduce an intermediate schema API.
+Make upstream changes only for demonstrated gaps. Resolve the named spikes/contracts
+before dependent implementation. Do not commit, push or publish unless asked.

lintel_api-0.1.0a1/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.5
+Name: lintel-api
+Version: 0.1.0a1
+Summary: UMF-driven GraphQL interoperability spikes (not a production runtime)
+Project-URL: Repository, https://github.com/DocumentDrivenDX/lintel
+Project-URL: Issues, https://github.com/DocumentDrivenDX/lintel/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: graphql-core==3.3.1
+Requires-Dist: strawberry-graphql==0.339.1
+Requires-Dist: umf-core==0.10.0
+Description-Content-Type: text/markdown
+
+# Lintel
+
+Dynamic GraphQL + Relay APIs from UMF, with an embeddable Python/FastAPI runtime
+and generated TypeScript operation/fragment artifacts for Batten applications.
+
+## Install the experimental alpha
+
+```sh
+pip install lintel-api==0.1.0a1
+```
+
+Import `project` from `lintel.experimental.projection` and
+`build_probe_schema` / `export_sdl` from `lintel.experimental.schema`.
+These expose the bounded S-01 scalar projection: string, boolean, exact decimal
+text and canonical UUID, with optional-field omission preserved. Supply UMF JSON
+and explicit record/field references; the example below uses the task-board model
+in the source distribution.
+
+```python
+from pathlib import Path
+from lintel.experimental.projection import project
+from lintel.experimental.schema import build_probe_schema
+
+plan = project(
+    Path("docs/helix/02-design/examples/task-board.umf.json").read_text(),
+    ("board", "Task"), "Task", {("board", "title"): "title"},
+)
+schema = build_probe_schema(plan, {"title": "Fabricated task"})
+assert schema.execute_sync("{ probe { title } }").data == {
+    "probe": {"title": "Fabricated task"}
+}
+```
+
+The alpha contains laboratory `probe` and `echo` roots. Do not mount them as a
+production API. Native execution/admission, Relay identity/pagination, TypeScript
+clients and Batten embedding are not provided by this wheel. Native qualification
+harnesses and governed specifications are included in the source archive, without
+installing PostgreSQL or its tools as library dependencies. Experimental APIs may
+change between alpha releases. Python 3.11 is the initial qualified interpreter.
+
+Lintel is a provisional name. This repository currently contains the HELIX
+specifications and a bounded [direct UMF interoperability spike](docs/helix/02-design/spikes/SPIKE-001-direct-umf.md).
+The spike reads UMF JSON through the public umf-core reader/validator and builds
+a dynamic Strawberry schema. It is not a production API service.
+
+Run `uv sync --locked --group spike --python 3.11`, then
+`uv run --locked --group spike python -m spikes.direct_umf.run`.
+[Verification and limits](docs/helix/04-build/direct-umf-spike.md) distinguish
+this proof from native execution, Relay clients and Batten embedding.
+
+Start with [the project packet](docs/helix/README.md),
+[scope and MVP](docs/helix/01-frame/prd.md), and
+[architecture](docs/helix/02-design/architecture.md).
+
+The intended family documentation location is
+[documentdrivendx.github.io/lintel](https://documentdrivendx.github.io/lintel/).
+The [source repository](https://github.com/DocumentDrivenDX/lintel) is created;
+family-catalog registration and documentation-site publication remain pending.
+
+
+The [native read spike](docs/helix/02-design/spikes/SPIKE-002-native-reads.md)
+measures pagination, declared-key batching and request consistency on disposable
+PostgreSQL 18. Run `uv sync --locked --group spike --group native-spike`, then
+`uv run --locked --group spike --group native-spike python -m spikes.native_reads.run`.
+Use both dependency groups for `python scripts/check_quality.py` on the current tree.
+[Results and gaps](docs/helix/04-build/native-read-spike.md) keep unsupported
+execution guarantees explicit; no upstream schema API is introduced.

lintel_api-0.1.0a1/README.md

@@ -0,0 +1,67 @@
+# Lintel
+
+Dynamic GraphQL + Relay APIs from UMF, with an embeddable Python/FastAPI runtime
+and generated TypeScript operation/fragment artifacts for Batten applications.
+
+## Install the experimental alpha
+
+```sh
+pip install lintel-api==0.1.0a1
+```
+
+Import `project` from `lintel.experimental.projection` and
+`build_probe_schema` / `export_sdl` from `lintel.experimental.schema`.
+These expose the bounded S-01 scalar projection: string, boolean, exact decimal
+text and canonical UUID, with optional-field omission preserved. Supply UMF JSON
+and explicit record/field references; the example below uses the task-board model
+in the source distribution.
+
+```python
+from pathlib import Path
+from lintel.experimental.projection import project
+from lintel.experimental.schema import build_probe_schema
+
+plan = project(
+    Path("docs/helix/02-design/examples/task-board.umf.json").read_text(),
+    ("board", "Task"), "Task", {("board", "title"): "title"},
+)
+schema = build_probe_schema(plan, {"title": "Fabricated task"})
+assert schema.execute_sync("{ probe { title } }").data == {
+    "probe": {"title": "Fabricated task"}
+}
+```
+
+The alpha contains laboratory `probe` and `echo` roots. Do not mount them as a
+production API. Native execution/admission, Relay identity/pagination, TypeScript
+clients and Batten embedding are not provided by this wheel. Native qualification
+harnesses and governed specifications are included in the source archive, without
+installing PostgreSQL or its tools as library dependencies. Experimental APIs may
+change between alpha releases. Python 3.11 is the initial qualified interpreter.
+
+Lintel is a provisional name. This repository currently contains the HELIX
+specifications and a bounded [direct UMF interoperability spike](docs/helix/02-design/spikes/SPIKE-001-direct-umf.md).
+The spike reads UMF JSON through the public umf-core reader/validator and builds
+a dynamic Strawberry schema. It is not a production API service.
+
+Run `uv sync --locked --group spike --python 3.11`, then
+`uv run --locked --group spike python -m spikes.direct_umf.run`.
+[Verification and limits](docs/helix/04-build/direct-umf-spike.md) distinguish
+this proof from native execution, Relay clients and Batten embedding.
+
+Start with [the project packet](docs/helix/README.md),
+[scope and MVP](docs/helix/01-frame/prd.md), and
+[architecture](docs/helix/02-design/architecture.md).
+
+The intended family documentation location is
+[documentdrivendx.github.io/lintel](https://documentdrivendx.github.io/lintel/).
+The [source repository](https://github.com/DocumentDrivenDX/lintel) is created;
+family-catalog registration and documentation-site publication remain pending.
+
+
+The [native read spike](docs/helix/02-design/spikes/SPIKE-002-native-reads.md)
+measures pagination, declared-key batching and request consistency on disposable
+PostgreSQL 18. Run `uv sync --locked --group spike --group native-spike`, then
+`uv run --locked --group spike --group native-spike python -m spikes.native_reads.run`.
+Use both dependency groups for `python scripts/check_quality.py` on the current tree.
+[Results and gaps](docs/helix/04-build/native-read-spike.md) keep unsupported
+execution guarantees explicit; no upstream schema API is introduced.

lintel_api-0.1.0a1/docs/helix/00-discover/owner-intent.md

@@ -0,0 +1,39 @@
+---
+ddx:
+  id: lintel.owner-intent
+  type: input
+  activity: discover
+  authoring:
+    home: repo
+---
+
+# Owner intent and scope decisions
+
+Source: this Codex conversation, 2026-11-02, America/New_York.
+
+1. Frame a separate sibling project with HELIX: scope, architecture, MVP and
+   changes needed in UMF and the runtime.
+2. Include it in the UMF family on DocumentDrivenDX.github.io.
+3. Use Lintel provisionally as the project name.
+4. Prefer a Python backend to fit the Databricks Apps FastAPI backend standard.
+5. Include this runtime in Batten and comprehend building TypeScript clients
+   for the same API.
+6. Prefer GraphQL + Relay; both GraphQL and OpenAPI are unnecessary. Relay's
+   type descriptions, pagination and node expansion motivate the selection.
+
+The latest choices replace the earlier dual REST/GraphQL and TypeScript-server
+suggestions. FastAPI is the HTTP host; it does not imply a generated REST product API.
+A standalone app factory remains useful for testing and other embedders; Batten
+is the required first consumer. Batten integration is a deliverable, not optional.
+
+Planning assumptions: PostgreSQL 18 first; one-hop relationships; startup schema
+construction; request-local cache; no admin UI. These are reversible design
+choices, not additional owner statements. No delivery date, staffing, budget,
+production workspace, IdP or family-catalog source repository was specified.
+
+## Direct UMF input
+
+Owner clarification: consume UMF directly. UMF is already the model/schema; do
+not invent an intermediate schema-description API. An ORM may expose its existing
+UMF as JSON if needed. Update the specs and execute the first direct-input spike;
+make only UMF/runtime changes that its evidence demonstrates are necessary.

lintel_api-0.1.0a1/docs/helix/00-discover/product-vision.md

@@ -0,0 +1,74 @@
+---
+ddx:
+  id: lintel.product-vision
+  type: product-vision
+  activity: discover
+  authoring:
+    home: repo
+  links:
+    - id: lintel.owner-intent
+      kind: informed_by
+---
+
+# Lintel product vision
+
+## Mission Statement
+
+Give Batten application builders a GraphQL API and typed Relay clients from
+UMF declarations, preserving the host's authority and the data runtime's meaning.
+
+## Positioning
+
+For Python application authors and Batten platform maintainers, Lintel is an
+embeddable API runtime that derives GraphQL types and executable access from
+approved UMF models. The alternative is handwritten Strawberry schemas,
+resolvers and separately maintained TypeScript API types for every application.
+
+## Vision
+
+An application declares its data and operations once. Its backend publishes a
+bounded API and its browser builds typed queries, fragments and mutations
+against exactly that API. Runtime upgrades remain a platform responsibility.
+
+**North Star**: One admitted model drives executable access and TypeScript client
+artifacts, with observable agreement across the application boundary.
+
+## User Experience
+
+A builder selects a fabricated task board's records, relationships and commands.
+Batten prepares the model and mounts Lintel. The builder compiles a Relay list
+query and fragments, pages tasks, expands an assignee and submits an approved
+command. The host enforces current authority and returns an attributable outcome.
+An unsupported selected meaning prevents activation with a useful diagnostic.
+
+## Target Market
+
+| Attribute | Description |
+| --- | --- |
+| Who | Batten's trusted first-party Python application authors and platform maintainers. Broader demand is unverified. |
+| Pain | Backend models, graph access, browser types and access checks drift when assembled per application. |
+| Current Solution | Handwritten GraphQL schemas/resolvers and application-specific API/client wiring. |
+| Why They Switch | Reuse declared semantics and platform-qualified execution across applications. |
+
+## Key Value Propositions
+
+| Value Proposition | Customer Benefit |
+| --- | --- |
+| Model-derived API | Builders maintain fewer copies of identities, fields and operations. |
+| Relay interoperability | Browser teams reuse node refetch, fragments and connection pagination. |
+| Batten embedding | Applications retain host admission, authority and lifecycle controls. |
+| Explicit support limits | Teams see unavailable semantics before exposing a misleading API. |
+
+## Success Definition
+
+| Indicator | Measurement |
+| --- | --- |
+| Reduced duplicate modeling | Compare one Batten application's handwritten schema/client definitions before and after adoption. No numeric target is established. |
+| Client/server agreement | Compare generated operation artifacts and actual endpoint results for the same admitted schema. |
+| Safe cohort changes | Observe changed-schema/client diagnostics and consumer regression outcomes during platform upgrades. |
+
+## Why Now
+
+UMF has a published Python/native access cohort and Batten is framing packaged
+runtimes and TypeScript application interfaces. The owner requested their shared
+API layer now. Neither upstream availability nor this request proves Lintel delivery.

lintel_api-0.1.0a1/docs/helix/00-discover/source-inventory.md

@@ -0,0 +1,62 @@
+---
+ddx:
+  id: lintel.source-inventory
+  type: research-note
+  activity: discover
+  authoring:
+    home: repo
+  links:
+    - id: lintel.owner-intent
+      kind: informed_by
+---
+
+# Source inventory and evidence limits
+
+The [manifest](sources/manifest.json) records exact hashes and checkout heads for
+inspected public UMF, Weft and Batten sources. Some primary-checkout files and
+candidate Batten packages are uncommitted. Working-tree hashes identify what was
+read; a Git HEAD alone does not claim those candidate files were published.
+Engine source is neither copied nor imported into Lintel. One small public UMF
+commerce fixture is pinned for offline design/schema inspection; it is not the
+final task-board application and adds no Lintel execution claim.
+
+Published UMF 0.5.2 qualification differs from older narrative notes and Batten's
+newer local Weft pin. Use the actual intersecting installed cohort for build work.
+The active UMF Rust-migration proposal is recorded as candidate direction.
+Native, package, browser and deployed claims remain separate.
+
+## Standards and framework references
+
+- [GraphQL September 2025](https://spec.graphql.org/September2025/): language and execution reference edition; selected feature support requires tests.
+- [Relay server guide](https://relay.dev/docs/guides/graphql-server-specification/): object refetch and connection conventions.
+- [Relay object identification](https://relay.dev/graphql/objectidentification.htm): Node and node lookup/field-stability requirements.
+- [Relay connections](https://relay.dev/graphql/connections.htm): edges, cursors, PageInfo and supported pagination conventions.
+- [Relay type emission](https://relay.dev/docs/guides/type-emission/): operation/fragment TypeScript artifacts; guide served v21.0.1 during inspection.
+- [Strawberry FastAPI](https://strawberry.rocks/docs/integrations/fastapi): GraphQLRouter, context injection and async resolver behavior. Observed documentation 0.339.1; implementation dependency remains unselected/unlocked.
+- [Strawberry Relay](https://strawberry.rocks/docs/guides/relay): existing Python Relay integration. It does not qualify Lintel's backend pagination.
+- [Databricks Apps development](https://docs.databricks.com/aws/en/dev-tools/databricks-apps/app-development): Python app/configuration development.
+- [Databricks app configuration](https://docs.databricks.com/aws/en/dev-tools/databricks-apps/app-runtime): app.yaml execution configuration.
+- [Databricks app authorization](https://docs.databricks.com/aws/en/dev-tools/databricks-apps/auth): app and user authority are distinct.
+
+Reference retrieval was read-only; no workspace access, live app deployment,
+package resolution, GraphQL execution or Relay compilation was performed.
+Public documentation is consulted, not vendored. Version locks and publication
+schema sources belong to the implementation cohort when chosen.
+
+## Family publication lookup
+
+The requested root `https://documentdrivendx.github.io/` could not be retrieved,
+and `DocumentDrivenDX/DocumentDrivenDX.github.io` returned 404. This does not prove
+the site/catalog does not exist. Batten's local public configuration identifies
+its project site at `/batten/`; family registry ownership remains unresolved.
+
+
+## Specification expansion references
+
+The 2026-11-02 expansion rechecked the public Python UMF exports, current core
+0.10 schema and Batten TablePort; its minimal existing operation shape does not
+claim the newly specified neutral execution protocol.
+[GraphQL over HTTP working draft](https://http-spec.graphql.org/draft/) was consulted
+on 2026-11-02; CONTRACT-005 defines a selected finite profile rather than claiming
+full draft conformance. Relay/GraphQL references above informed the target profile.
+No live provider or compiler execution was performed as research.

lintel_api-0.1.0a1/docs/helix/00-discover/sources/manifest.json

@@ -0,0 +1,140 @@
+{
+  "recorded": "2026-11-02",
+  "sources": [
+    {
+      "project": "umf",
+      "checkout": "/Users/erik/.codex/worktrees/7076/umf",
+      "path": "docs/helix/02-design/contracts/CONTRACT-079-unified-python-access.md",
+      "sha256": "250cda75996506a5a51f0f6029fbeae39b399e2571e8a2d0b08dee7c20e61239",
+      "checkoutHead": "b12a489844f29947ee52115b90f4ccc5c8bc5032",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "umf",
+      "checkout": "/Users/erik/Projects/umf",
+      "path": "docs/helix/05-deploy/sdk-release-notes-0.5.2.md",
+      "sha256": "61c939601595a1efe6b1b00be32e5fd846a8429c4534c8753c993e71d809c9fe",
+      "checkoutHead": "b12a489844f29947ee52115b90f4ccc5c8bc5032",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "umf",
+      "checkout": "/Users/erik/Projects/umf",
+      "path": "docs/helix/02-design/contracts/CONTRACT-081-table-lifecycle.md",
+      "sha256": "067b46a609a238886acd990ca0e84cb6100af6c87479c23b04eb20b8cc2ecd12",
+      "checkoutHead": "b12a489844f29947ee52115b90f4ccc5c8bc5032",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "umf",
+      "checkout": "/Users/erik/Projects/umf",
+      "path": "docs/helix/02-design/adr/ADR-006-shared-rust-implementation.md",
+      "sha256": "0e483f2b040560daf9c91b35e5ffaefbee2faad90fa7b8ade148b9c1b02f63ee",
+      "checkoutHead": "b12a489844f29947ee52115b90f4ccc5c8bc5032",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "umf",
+      "checkout": "/Users/erik/.codex/worktrees/7076/umf",
+      "path": "src/access/index.ts",
+      "sha256": "f3befb035ddc935d8b52192666aff3e64d65d1314fb28765762e35c07e6f5422",
+      "checkoutHead": "b12a489844f29947ee52115b90f4ccc5c8bc5032",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "umf",
+      "checkout": "/Users/erik/.codex/worktrees/7076/umf",
+      "path": "python/src/umf/__init__.py",
+      "sha256": "e9dca8a080364f76a1c370caabd95f35e36c011c6b27fd58a487cadf320aee9d",
+      "checkoutHead": "b12a489844f29947ee52115b90f4ccc5c8bc5032",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "weft",
+      "checkout": "/Users/erik/Projects/weft",
+      "path": "README.md",
+      "sha256": "685506b3b4c1ccdcfb15fbdd7e287cc801d6edc584d67346393e18dedb416e2d",
+      "checkoutHead": "ca86d095d4c362903a3461900dada0157efbdc63",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "docs/helix/00-discover/product-vision.md",
+      "sha256": "5947546f62df8de6732834053e7c35ff465ef9631233e992b44fc08281245b28",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "docs/helix/01-frame/prd.md",
+      "sha256": "9402ac744ac3f54ad8d40055dfda7a8a2a3081cbc863961c7bb01e65d994b10f",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "docs/helix/01-frame/concerns.md",
+      "sha256": "10b3a8e99b65252eb01251cb99b2f9c60deb9112514090ec4b66df868bd837f8",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "docs/helix/02-design/architecture.md",
+      "sha256": "1ecc1e3dcf243283a1bf776b0726fad1223dbdafcd378d32d1defddf832cee24",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "docs/helix/02-design/contracts/CONTRACT-001-public-host-api.md",
+      "sha256": "f257b5ff98326667ebac7ece53a4f42cacc74576e55473bdea3b19c25f023eb2",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "docs/helix/02-design/adr/ADR-015-typescript-app-ui-delivery.md",
+      "sha256": "67ff514c2189bc6d7db0b7d1e0569b0bb6267cc8cffc68a005ab897171478b2e",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "packages/batten-tables/src/batten/tables/__init__.py",
+      "sha256": "776914618c7d88b40470df52b6704052c24391b23b7292d07f994fdcbdf43d69",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "packages/batten-umf-postgres/src/batten/umf_postgres/__init__.py",
+      "sha256": "0d755c2288e342d149e8c5389fca6cb606f0efbf3f6b7387a4bacb9f70764869",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    },
+    {
+      "project": "batten",
+      "checkout": "/Users/erik/Projects/batten",
+      "path": "packages/batten-umf-postgres/pyproject.toml",
+      "sha256": "946b9163ce6324064eb178e2552bcad6ee3cce46028998d470765028b4af1a52",
+      "checkoutHead": "27f087666a56b3136e39cd5c471b954ceb5630ae",
+      "qualification": "Read-only source inspection; working-tree bytes may be uncommitted; not runtime evidence"
+    }
+  ],
+  "pinnedExamples": [
+    {
+      "path": "docs/helix/00-discover/sources/umf-commerce.json",
+      "sha256": "19c018888066d391599d4bc8079ec8f3479266e6ecc55237c57825bc33c3003d",
+      "origin": "/Users/erik/.codex/worktrees/7076/umf/tests/unified/commerce.json"
+    }
+  ]
+}