Skip to content

Unify documentation selection across repository commands - #29

Merged
Statusnone420 merged 23 commits into
fix/0.1.8-init-doctor-lifecyclefrom
feat/0.1.8-unified-selection-policy
Jul 29, 2026
Merged

Unify documentation selection across repository commands#29
Statusnone420 merged 23 commits into
fix/0.1.8-init-doctor-lifecyclefrom
feat/0.1.8-unified-selection-policy

Conversation

@Statusnone420

Copy link
Copy Markdown
Owner

What changed

  • Added one engine-owned repository selection policy and made Map, Check, Doctor, Audit, and Init consume the same repository evidence.
  • Made the default boundary the whole repository; an explicit component scope is now reported as partial and cannot select a map outside that component.
  • Included normal nonignored untracked documentation in the same selection rules as tracked documentation.
  • Added the required Python 3.14 runtime preflight for repository commands; if the engine cannot run, the command stops instead of inventing a fallback result.
  • Shared one inventory per invocation across selection, providers, and the documentation manifest.
  • Regenerated every distributed adapter from the canonical skills/docs/ source.

Why

The same repository could previously produce different realities across Map and Doctor: an omitted scope silently became docs/, root documents such as GLOSSARY.md disappeared, Init bypassed shared selection, and provider or working-tree state could alter which map won. This PR gives those commands one deterministic answer for the same repository snapshot.

User impact

  • A normal repository-wide command sees the repository-wide documentation landscape.
  • Explicit component commands stay inside the requested component and say that the result is partial.
  • Tracked and nonignored untracked documentation participate normally.
  • Ignored or excluded bodies remain outside automatic reads.
  • Init setup choices no longer replace the repository reality measured first.

Verification

Fresh local Windows proof on fd5c302:

  • 1,059 tests passed: 442 core, 438 lifecycle across five verified shards, 179 trajectory.
  • Adapter generation and byte-parity check: clean.
  • Repository checker: 89%, 151/151 links valid, 41/61 maintained pages reachable, 27 known generated-copy findings.
  • Public documentation and evidence checks: 39 passed.
  • git diff --check: clean.
  • Independent read-only review: PASS, no blocking findings.

Linux was not claimed locally; the draft CI run is the cross-platform proof gate.

Deliberately carried forward

  • PR 3 owns document classification, scoring eligibility, and the complete user-facing inventory.
  • PR 4 owns plain-English presentation and command hierarchy.
  • evidence_receipt.py still has its own map/scope path and remains assigned to PR 7.
  • Multi-candidate Doctor handling and ignored-tree performance remain tracked follow-ups.

No PR 3 work, release, or publication is included here.

@Statusnone420 Statusnone420 self-assigned this Jul 28, 2026
@Statusnone420
Statusnone420 marked this pull request as ready for review July 28, 2026 15:56

@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: fd5c302d81

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

@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: e75eb8827a

ℹ️ 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/paths.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: eee78adc3c

ℹ️ 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
Comment thread skills/docs/references/doctor.md 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: 0d3942d1e7

ℹ️ 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/_docs_checker/doctor_baseline.py
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: f16feda043

ℹ️ 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/discovery.py Outdated
Comment thread skills/docs/scripts/_docs_checker/discovery.py Outdated
Comment thread COMMANDS.md 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: 98fbe1ab9e

ℹ️ 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/selection.py
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: 36072ca2f9

ℹ️ 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 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: 5481a2d8d2

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

@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: 4df606b0ed

ℹ️ 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
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: fb66e68f06

ℹ️ 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/selection.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: 535b420aae

ℹ️ 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/references/commands.md 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: 1c58a5b647

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

@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

"score_receipt": {
"percentage": health["percentage"],
"status": health["structure_status"],

P1 Badge Report projected health in map-creation previews

When Init establishes a missing canonical map (for example, a corpus containing only docs/guide.md), _request_from_context correctly computes the projected result as 100/healthy, but this public score_receipt is still populated from the pre-change health and reports 25/needs-attention. The host presents this response rather than the external receipt, so the user is asked to approve a preview whose displayed score contradicts the approved outcome; carry the projected health, including its categories, into the preview when map creation is proposed.

AGENTS.md reference: AGENTS.md:L72-L72

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

@Statusnone420

Copy link
Copy Markdown
Owner Author

Addressed the P1 from review 4802184092 in 9caa539.

Init now carries the projected post-map health into the public approval preview, including percentage, status, and category receipt, while preserving the exported builder's existing current-health return contract. The regression proves the preview matches the approval-bound score_after and the health categories measured after the same map is applied.

Focused proof: 44 Init/Doctor tests and 71 distribution/architecture tests passed; generated adapter parity, partition verification, diff checks, and the repository checker are clean. This finding was posted in the review body rather than an inline thread, so GitHub provides no review thread to resolve; this comment records its closure.

@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: 9caa53918b

ℹ️ 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/selection.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: be0449c78b

ℹ️ 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/measurement.py Outdated
Comment thread skills/docs/scripts/_docs_checker/selection.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: 516ddf9cc0

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

@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: bd0503849c

ℹ️ 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/doctor_baseline.py
Comment thread skills/docs/scripts/_docs_checker/selection.py Outdated
Comment thread skills/docs/scripts/_docs_checker/discovery.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: 1a03a3e841

ℹ️ 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/selection.py Outdated
Comment thread PRODUCT.md

@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: 0a99701a0e

ℹ️ 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
@Statusnone420
Statusnone420 merged commit 855b9a6 into fix/0.1.8-init-doctor-lifecycle Jul 29, 2026
12 checks passed
@Statusnone420
Statusnone420 deleted the feat/0.1.8-unified-selection-policy branch July 29, 2026 01:35
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