quadlet-lens 0.2.0

Loss-aware parsing, validation, and rendering of version-aware Quadlet documents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# Project structure

QuadletLens is one library crate with clear module boundaries. The crate foundation exists; entries marked `planned` are created with their first behavior and tests. The versioned data catalogue begins with the capability-schema milestone.

```text
quadlet-lens/
├── .devcontainer/         # digest-pinned VS Code environment and feature lock
├── .vscode/               # shared editor settings, recommendations, and local tasks
├── scripts/               # complete local checks and non-Rust file-quality tooling
├── package.json           # pinned repository-only Node tooling
├── package-lock.json      # complete repository-tool dependency graph
├── lychee.toml            # offline/local and rate-limited external link policy
├── Cargo.toml
├── Cargo.lock
├── CHANGELOG.md
├── rust-toolchain.toml
├── rustfmt.toml
├── clippy.toml
├── deny.toml
├── .cargo/
│   └── config.toml        # canonical Cargo aliases
├── AGENTS.md
├── README.md
├── LICENSE
├── src/
│   ├── lib.rs
│   ├── source.rs           # source identifiers, spans, and line/column lookup
│   ├── syntax.rs           # ordered syntax plus preservation/canonical rendering
│   ├── path.rs             # lexical literal, relative, and systemd-specifier paths
│   ├── capability.rs       # strict catalogue loading and target-range evaluation
│   ├── render.rs           # validated deterministic programmatic construction
│   ├── model/
│   │   ├── mod.rs          # source-aware native documents, keys, paths, and references
│   │   └── document_set.rs # named documents, exact references, and dependency graph
│   ├── validation/         # planned: native and target-aware validation
│   └── diagnostic.rs       # stable structured syntax diagnostics
├── catalogue/
│   └── v1/
│       └── podman-supported-range.toml # finite evidence inside the rolling support window
├── tests/
│   ├── README.md           # suite ownership and introduction rules
│   ├── capabilities.rs     # schema and version-boundary behavior
│   ├── generators.rs       # matrix contract plus ignored container execution harness
│   ├── model.rs            # native typed subset, preservation, and diagnostics
│   ├── document_sets.rs    # exact cross-file resolution and dependency edges
│   ├── public_api.rs       # supported external 0.2.x consumer path
│   ├── render.rs           # programmatic construction and parse-back validation
│   ├── syntax.rs           # preservation, recovery, canonical, property corpus
│   ├── repository_policy.rs # fixture and workflow-pin enforcement
│   └── support/            # private repository-test helpers
├── fixtures/
│   ├── README.md           # fixture location and safety rules
│   └── typed-model/        # authored container/pod/network/volume and graph cases
├── tools/
│   └── generator-matrix.toml # supported target, pinned images, commits, and builder
├── docs/
│   ├── api-stability.md    # supported pre-1.0 consumer contract
│   ├── releases/           # version-matched public release notes
│   └── fixture-format.md   # versioned fixture manifest contract
└── .github/
    ├── renovate.json
    └── workflows/
        ├── ci.yml
        ├── documentation-links.yml
        ├── generator-matrix.yml
        └── release.yml
```

## Module placement rules

| Concern                                  | Owner                                  |
| ---------------------------------------- | -------------------------------------- |
| Entry order, comments, and continuations | `syntax`                               |
| Quadlet-native fields and value types    | `model`                                |
| Cross-file references                    | `model::document_set`                  |
| Version and fallback evidence            | `capability` plus `capabilities/` data |
| Target-aware correctness                 | `validation`                           |
| File output                              | `render`                               |
| External generator execution             | test/tooling support                   |

Do not encode a version matrix in model enums, use unordered maps as the source syntax tree, or put BoxFerry conversion rules into the library.