Release Diátaxis Docs 0.1.8 - #31
Merged
Merged
Conversation
Add lifecycle-aware initialized-state measurement to the Doctor baseline flow. Implements normalized state bindings and _lifecycle_baseline to re-run the mapped checker for Init-v3 state, fail-closed on state-conflict, and surface authority_kind initialized-map with treatment authority. Wire lifecycle handling into doctor_orientation_baseline, export a new INITIALIZED_BASELINE_LABEL, and update docs across adapters and web to describe the behaviour. Add comprehensive tests (tests/test_doctor_baseline_lifecycle.py) and an apply_doctor_fixture helper. Also increase PROMPT_REGRESSION_GUARD_BYTES to 45_000.
PR 0 of the 0.1.8 completion program. Establish the target product contract, publish the current architecture gaps, and preserve the verified current-versus-target distinctions before runtime implementation.
Preserve all 918 tests while reducing ordinary pull-request feedback through deterministic Windows lifecycle sharding, duplicate-run cancellation, and retained serial integration/release gates.
Establish one deterministic documentation manifest for later Map and Doctor integration. Includes bounded inventory, privacy-preserving ignored-document handling, tracked-link safety, honest no-Git coverage, generated adapter parity, and journey regressions.
* Unify Diátaxis Docs repository selection * Fix exported Init adoption measurement * Fix shared measurement test hook * Sanitize Git inventory failures * fix(docs): close unified selection review gaps * fix(docs): close missing-map init journeys * test(docs): align component init contract * fix(docs): bound and reuse discovery inventory * fix(docs): confine component setup inputs * fix(docs): route direct checks through selection * fix(docs): preserve component scope in init receipts * fix(docs): preserve init selection evidence * fix(docs): confine roots before inventory * docs: align Doctor with repository selection * fix(docs): reject occupied Init map targets * fix(docs): report projected Init health * fix(docs): fail closed on selection read errors * fix(docs): keep selection evidence comparable * fix(docs): preserve corpus map spelling * fix(docs): enforce doctor and closeout bounds * fix(docs): preserve deleted-path closeout semantics * fix(docs): report nested selection failures * fix(docs): fail closed on unreadable map targets
) * Classify documentation and publish readiness from one engine result Adds evidence-bounded three-fact classification (role, user-owned never-edit, repository status) driven by a fail-closed docs:policy block in the committed map; readiness v3 with honest percentage absence; deterministic unresolved cards with stateless single-use DOCS-R- resolution preview/apply; treatment write-eligibility policy; Init persistence of approved never-edit choices; corrected public evidence documents; and all adapters regenerated from canonical sources. Verified locally: 1,142 tests across core/lifecycle/trajectory, 54 PR 3 contracts, blind whole-PR review findings fixed and re-verified. Two expected failures remain assigned to the beginner-interface phase. * Stamp findings, expose resolution commands, and bind directory approvals * Make the readiness contract clone-portable * Record hosted validation and WSL clone guidance * Bind policy provenance, generator evidence, and exact opt-outs * Preserve Init map bytes and bound resolution input * Honor exact unresolved choices and frontmatter titles * Honor explicit Init never-edit choices * Scope directory resolutions and honor Mintlify labels * Preserve scoped resolution and Init recovery semantics * Ignore inert policy examples and validate reference links * Mask indented policy examples and flag undefined references * Validate resolution selection, policy durability, and Mintlify labels * Mask code examples and validate HTML links * Harden Markdown evidence and resolution approvals * Make rendered evidence syntax-complete * Complete rendered Markdown boundary handling * Handle soft link labels and escaped destinations * Normalize rendered destinations and validate anchors --------- Co-authored-by: Statusnone420 <244280175+Statusnone420@users.noreply.github.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e76fd7877b
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR releases Diátaxis Docs 0.1.8 as a bounded, Git-backed public alpha.
never_edit, and repository-status facts. Ordinary links and filenames do not assign purpose.DOCS-R-preview/apply commands support exact, zero-write-before-approval policy resolution.never-editchoices, Doctor begins read-only, and all generated adapters match canonical source.Release boundary
0.1.8 uses a tested Markdown/MDX evidence subset; it does not claim complete CommonMark or arbitrary MDX conformance. Five confirmed limitations are public in
docs/KNOWN_ISSUES.md: two fail-closed syntax gaps, two beginner-presentation gaps, and one fail-closed equals-form CLI inconsistency. Each has a severity, safety boundary, disposition, and reopen trigger.P0 always blocks release. P1 blocks when it affects the current daily-driver workflow, safety, privacy, data integrity, usability, or an explicit release contract. Parser expansion is frozen through 2026-08-06 unless a documented stop condition occurs.
Evidence
git diff --checkcleannonignored_unresolved39;denominator_representativefalse