AI-Native PDLC Validity Framework
Research preview for measuring whether an AI-assisted delivery workflow—from approved issue through implementation, QA, repair, and human PR review—deserves trust.
Status: research preview 0.1.0 · formula v1.1 · evidence
simulation-calibrated (live Modus pilot documented; repo-fitted weights pending)
Maintainers: Elisha Sam Peter Prabhu · Preethi Rangamma
Quick start
Install the CLI:
pip install pdlc-validity
Or run from this repository:
pip install -e .
Inspect your repository (read-only; writes validity.layout.json on first run):
pdlc-validity init --repo .
pdlc-validity inspect --repo .
pdlc-validity evidence --repo .
Equivalent module form:
python -m framework init --repo .
python -m framework inspect --repo .
What you get
| Artifact | Purpose |
|---|---|
framework/ |
CLI, schemas, templates, intervention catalog |
paper/ |
TTC abstracts and pilot summary |
theory/formula.py |
Canonical recovery/decay model |
.cursor/skills/validity-* |
Optional Cursor skills for diagnose/improve |
Role split
- CLI emits facts: inspect, evidence, score, delta, report.
- AI skills (optional) reason about harness, loop, and graph weaknesses.
- Humans approve setup changes and every merge.
Read framework/CONTRACT.md before citing numeric results. Do not
treat placeholder-weight V* values as fitted causal estimates.
Try it in your workflow
- Run
pdlc-validity init --repo .in a repository that uses agent automations. - Run
pdlc-validity inspect --repo .to see measurement gaps. - Paste automation/PR evidence with
pdlc-validity intake --repo . --intake path/to/intake.json(seeframework/templates/intake/user-intake.example.json). - Use
pdlc-validity scorefor CLI-owned R/D/V* with provenance labels.
More detail: framework/README.md and
framework/AGENT-HANDOFF.md.
PyPI releases use trusted publishing. Until that one-time setup is complete, install from GitHub:
pip install git+https://github.com/ElishaSamPeterPrabhu/ai-native-pdlc-validity-framework.git@v0.1.0
Research evidence
- Structural simulations tested the recovery/decay model before live use.
- Modus Web Components console pilot: open QA/repair cycle → one intervention → closed cycle.
- See
paper/modus-pilot-abstract-summary.md.
License
Apache-2.0. See LICENSE.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pdlc_validity-0.1.0.tar.gz.
File metadata
- Download URL: pdlc_validity-0.1.0.tar.gz
- Upload date:
- Size: 59.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ff475c8ecfbca0365db229b397e8bf0f6fddef6cc59c65e5b5e2843e766b69bf
|
|
| MD5 |
98a1fc76347b7d637e105c0d95bb482a
|
|
| BLAKE2b-256 |
a2c878e1d6a6da7351d7d3888ecea7c31ccb9270ef80bbcbe8448186e99449a4
|
Provenance
The following attestation bundles were made for pdlc_validity-0.1.0.tar.gz:
Publisher:
publish.yml on ElishaSamPeterPrabhu/ai-native-pdlc-validity-framework
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pdlc_validity-0.1.0.tar.gz -
Subject digest:
ff475c8ecfbca0365db229b397e8bf0f6fddef6cc59c65e5b5e2843e766b69bf - Sigstore transparency entry: 2433237533
- Sigstore integration time:
-
Permalink:
ElishaSamPeterPrabhu/ai-native-pdlc-validity-framework@aae0bbbe67f0a0a9e509fba5ab037504c6e3c984 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/ElishaSamPeterPrabhu
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@aae0bbbe67f0a0a9e509fba5ab037504c6e3c984 -
Trigger Event:
release
-
Statement type:
File details
Details for the file pdlc_validity-0.1.0-py3-none-any.whl.
File metadata
- Download URL: pdlc_validity-0.1.0-py3-none-any.whl
- Upload date:
- Size: 74.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e8e5fcc655241ed96c3c060dc66548ec204b0828966765526710c99330d56c8
|
|
| MD5 |
138813b6df9ee040fcecc6613dd7bb74
|
|
| BLAKE2b-256 |
2ed5eb7c6f68ec006319cbfe62aef2d9755a33f96b37be2d6dd07526d8414dee
|
Provenance
The following attestation bundles were made for pdlc_validity-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on ElishaSamPeterPrabhu/ai-native-pdlc-validity-framework
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pdlc_validity-0.1.0-py3-none-any.whl -
Subject digest:
4e8e5fcc655241ed96c3c060dc66548ec204b0828966765526710c99330d56c8 - Sigstore transparency entry: 2433237605
- Sigstore integration time:
-
Permalink:
ElishaSamPeterPrabhu/ai-native-pdlc-validity-framework@aae0bbbe67f0a0a9e509fba5ab037504c6e3c984 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/ElishaSamPeterPrabhu
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@aae0bbbe67f0a0a9e509fba5ab037504c6e3c984 -
Trigger Event:
release
-
Statement type: