Skip to content

Classify documentation and publish readiness from one engine result - #30

Merged
Statusnone420 merged 19 commits into
fix/0.1.8-init-doctor-lifecyclefrom
feat/0.1.8-classification-readiness
Jul 30, 2026
Merged

Classify documentation and publish readiness from one engine result#30
Statusnone420 merged 19 commits into
fix/0.1.8-init-doctor-lifecyclefrom
feat/0.1.8-classification-readiness

Conversation

@Statusnone420

@Statusnone420 Statusnone420 commented Jul 29, 2026

Copy link
Copy Markdown
Owner

What changed

This PR makes documentation classification and readiness one canonical, engine-owned result shared by Map, Check, Audit, Doctor, and Init.

Each accounted document publishes three independent facts:

  • Role: maintained, preserved, generated, historical, or unresolved
  • Never-edit: the user-owned write boundary
  • Repository status: tracked, untracked, or ignored or excluded

Role evidence fails closed. The selected map, declared current-truth routes, explicit generator declarations, and the map's docs:policy block can assign roles. Ordinary links, filenames, and folder names cannot. Published findings carry the target document's role and write eligibility from the same manifest.

Readiness

Readiness v3 is the unweighted ready/eligible fraction. Trust remains separate, and the engine reports whether the denominator represents all accounted documentation.

A fresh checkout of this repository reports:

Fact Value
Accounted documents 61
Generator-declared documents 20
Nonignored unresolved documents 39
Denominator representative false

The current 2-of-2 eligible result is therefore not presented as whole-repository health. Local ignored drafts remain visible by name and count without their bodies entering the result.

Resolution and treatment

  • Deterministic unresolved cards provide exact paths, evidence, bounded choices, handles, and copy-paste replies.
  • --resolve-preview reads a bounded JSON decisions mapping and emits an exact zero-write map-policy diff with a short DOCS-R- approval code.
  • --resolve-apply APPROVAL recomputes that binding in a later process and applies only the matching current snapshot.
  • Approval codes bind the decisions, selected-map bytes, and exact directory-group route membership. Drift or mismatched evidence refuses with zero writes.
  • Exact-file decisions override directory groups. User-owned never-edit policy remains independent from role and readiness.
  • Init persists approved never-edit choices and preserves recoverable pre-Init map bytes for dirty or non-Git maps.

Verification

  • 1,187 tests: 556 core, 452 lifecycle, 179 trajectory
  • 99 focused PR 3 contracts green
  • 2 expected beginner-interface failures unchanged
  • Generated adapters match canonical sources
  • Repository checker exits 0
  • Hosted Ubuntu and Windows validation is green

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.
@Statusnone420 Statusnone420 self-assigned this Jul 29, 2026
@Statusnone420
Statusnone420 marked this pull request as ready for review July 29, 2026 21:55

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9ebf01c283

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/manifest.py Outdated
Comment thread skills/docs/scripts/_docs_checker/document_classification.py
Comment thread skills/docs/scripts/_docs_checker/resolution.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 176e5c97c0

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/init_adoption.py Outdated
Comment thread skills/docs/scripts/check.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e74dd42df8

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/resolution.py
Comment thread skills/docs/scripts/_docs_checker/readiness.py

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 629fc77b6c

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/init_adoption.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a134a8d975

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/resolution.py
Comment thread skills/docs/scripts/_docs_checker/scan.py

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f0b41270bd

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/resolution.py Outdated
Comment thread skills/docs/scripts/_docs_checker/init_adoption.py
Comment thread skills/docs/scripts/_docs_checker/resolution.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: aae578c051

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/documentation_policy.py Outdated
Comment thread skills/docs/scripts/_docs_checker/scan.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3a4726f2cf

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/documentation_policy.py Outdated
Comment thread skills/docs/scripts/_docs_checker/scan.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 96fc156eb7

ℹ️ 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".

Comment thread skills/docs/scripts/check.py
Comment thread skills/docs/scripts/_docs_checker/documentation_policy.py Outdated
Comment thread skills/docs/scripts/_docs_checker/scan.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0ceae14feb

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/scan.py Outdated
Comment thread skills/docs/scripts/_docs_checker/scan.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cd50cfbbb2

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/resolution.py Outdated
Comment thread skills/docs/scripts/_docs_checker/documentation_result.py
Comment thread skills/docs/scripts/_docs_checker/scan.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a65c2925df

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/documentation_policy.py Outdated
Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py Outdated
Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e05002db24

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/documentation_policy.py Outdated
Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py Outdated
Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py
Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: eb37369220

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py Outdated
Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 72f62fe4fa

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7f18ab9dfe

ℹ️ 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".

Comment thread skills/docs/scripts/_docs_checker/treatment_policy.py
Comment thread skills/docs/scripts/_docs_checker/rendered_markdown.py
@Statusnone420
Statusnone420 merged commit 2ec6849 into fix/0.1.8-init-doctor-lifecycle Jul 30, 2026
12 checks passed
@Statusnone420
Statusnone420 deleted the feat/0.1.8-classification-readiness branch July 30, 2026 15:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant