Skip to content

docs: reconcile the bounded application build frontier - #206

Open
flyingrobots wants to merge 1 commit into
mainfrom
docs/reconcile-compiler-frontier
Open

docs: reconcile the bounded application build frontier#206
flyingrobots wants to merge 1 commit into
mainfrom
docs/reconcile-compiler-frontier

Conversation

@flyingrobots

Copy link
Copy Markdown
Owner

Plain-English Walkthrough

TL;DR

The roadmap still named a provider milestone that closed on July 13. It now points to the bounded application-build acceptance work in Edict #192 and the real Jedit consumer in Jedit #296/#302. [claim:current-frontier, confidence:0.99]

The curated facade requested by #189 has shipped and that issue is closed. Planned package inventory and independent packaged-consumer evidence now reference #204; the optional live frontier-state checker from #187 is tracked separately in #205. [claim:scope-split, confidence:0.99]

Walkthrough

A reader choosing the next Edict task starts at Current Frontier. The old section described the completed Provider Artifact Pipeline Alpha and called #147 current. The replacement keeps the completed milestone as historical evidence, links the owning shelves for delivered compiler/library contracts, and identifies the remaining acceptance work. GitHub owns the detailed checklists and current PR status. [claim:roadmap-routing, confidence:0.99]

The frontier distinguishes the real consumer's accepted package from runtime execution: the current ReplaceRange source constructs a typed boundary result, while the rope algorithm and generic Echo evaluator remain downstream work. Echo #724 is an open provider candidate. No new release milestone, publication decision, or runtime capability is declared. [claim:consumer-boundary, confidence:0.99]

The public Rust API test plan keeps its implemented facade requirement tied to #189 and moves only the two already-planned package requirements to #204. Their status remains planned. Automated comparison with GitHub state is also explicitly planned in #205. [claim:planned-evidence, confidence:0.99]

Validation and documentation impact

  • cargo xtask verify: passed: 898 tests in 51 groups, strict all-target/all-feature Clippy, 27 topic shelves, CLI/provider/golden checks.
  • cargo test -p edict-syntax --test compiler_spine --test lawpack: 80 compiler-spine and 58 lawpack tests passed on base main 3f81f759e921a69b04fe8cf8e62e62f8f3dc7b7e.
  • cargo test -p flyingrobots-edict: four integration tests and two doctests passed on that base.
  • Live milestone Validate semantic name scopes #15 read-back: closed, zero open issues, closed at 2026-07-13T07:51:17Z.
  • git diff --check: passed.

No RED/GREEN cycle was required: this corrects roadmap and evidence ownership metadata, with no compiler, API, schema, workflow, or validation behavior change. No tests assert documentation wording. docs-impact: Current Frontier and two source references updated; owning contract READMEs and executable tests remain accurate and unchanged. No dependencies or release artifacts changed.

Appendix: Citations
Claim Evidence Confidence Notes
claim:current-frontier, claim:roadmap-routing ROADMAP.md#30@404e77ef297ca765f556dd5ee579268ae65abfa6; closed provider milestone; #192 0.99 Repository text and live issue/milestone read-back.
claim:scope-split, claim:planned-evidence docs/topics/public-rust-api/test-plan.md#25@404e77ef297ca765f556dd5ee579268ae65abfa6; #189 disposition; #204; #205 0.99 Delivered facade is separate from planned package and automation evidence.
claim:consumer-boundary Jedit edict/replace-range/README.md#18@a894c7c4c6d150c0fb210d2e0ca4c27bf518b4c7; Jedit #302; Echo #724 0.99 Exact candidate boundary; no runtime or merge acceptance inferred.

Closes #187

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 7, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-07T23:11:27.453333Z 404e77e PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Sep 7, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Team

Run ID: cbb40239-c3f3-44d1-b6b4-14d7df15e498

📥 Commits

Reviewing files that changed from the base of the PR and between 3f81f75 and 404e77e.

📒 Files selected for processing (2)
  • ROADMAP.md
  • docs/topics/public-rust-api/test-plan.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

📜 Recent review details
⏰ Context from checks skipped due to timeout. (4)
  • GitHub Check: supply-chain (cargo-deny)
  • GitHub Check: windows lawpack containment
  • GitHub Check: rust msrv 1.94.0 (fmt · clippy · test)
  • GitHub Check: rust stable (fmt · clippy · test)
🧰 Additional context used
📓 Path-based instructions (5)
Tests must assert software behavior and stable error kinds or structured artifacts, not implementation details, prose, paths, or merely `is_err()`; documentation-tool tests may test validator behavior.

📄 CodeRabbit inference engine (AGENTS.md)

Files:

  • docs/topics/public-rust-api/test-plan.md
  • ROADMAP.md
Never amend Git commits, use `git rebase` without explicit user approval, or force any Git operation; use new commits and regular merge commits instead.

📄 CodeRabbit inference engine (AGENTS.md)

Files:

  • docs/topics/public-rust-api/test-plan.md
  • ROADMAP.md
Topic shelves document landed behavior: `README.md` describes current HEAD truth, `test-plan.md` records verification and known gaps, and optional architecture or rationale pages contain durable supporting information.

📄 CodeRabbit inference engine (AGENTS.md)

Files:

  • docs/topics/public-rust-api/test-plan.md
Documentation pages must have one primary reader job, separate user task help from contributor architecture and evidence maps, use concrete valid examples with expected results when relevant, and keep exact public facts in validated or gene...

📄 CodeRabbit inference engine (AGENTS.md)

Files:

  • docs/topics/public-rust-api/test-plan.md
  • ROADMAP.md
Use tables for consistent-shape comparisons and evidence, bullets for unordered sets, numbered lists for ordered procedures or states, and focused branch-accurate snippets for exact syntax.

📄 CodeRabbit inference engine (AGENTS.md)

Files:

  • docs/topics/public-rust-api/test-plan.md
  • ROADMAP.md
🪛 LanguageTool
ROADMAP.md

[grammar] ~62-~62: Ensure spelling is correct
Context: ...ic public-build witness. 2. Advance the Jedit application and the exact Echo provider...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🔇 Additional comments (2)
ROADMAP.md (1)

30-42: LGTM!

Also applies to: 44-56, 58-70, 72-82

docs/topics/public-rust-api/test-plan.md (1)

26-27: LGTM!


Summary by CodeRabbit

  • Documentation
    • Updated the roadmap to reflect the completed Provider Artifact Pipeline Alpha milestone and the next acceptance boundary.
    • Documented delivered compiler and library foundations, along with remaining implementation areas.
    • Clarified that runtime execution, admission, registry publication, and release tagging are not currently supported.
    • Updated public Rust API test-plan references to the latest tracking issues.

Walkthrough

The roadmap now uses bounded application-build evidence as its current frontier. It records delivered foundations, remaining evidence work, and unsupported runtime or publication activities. The public Rust API test plan updates two requirement references from issue #189 to issue #204.

Changes

Bounded application-build evidence

Layer / File(s) Summary
Frontier and delivered foundations
ROADMAP.md
The roadmap replaces the closed provider-pipeline frontier with bounded application-build evidence and lists completed compiler and library foundations.
Remaining evidence and source references
ROADMAP.md, docs/topics/public-rust-api/test-plan.md
The roadmap lists remaining compiler, acceptance, package-closure, and automation work. It also records unsupported runtime and publication evidence. The test plan changes the source issue for package-inventory and external-consumer requirements from #189 to #204.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to 404e7

This updates planning and requirement references without changing product behavior. No current merge-readiness risk remains.

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Linked Issues check ⚠️ Warning The PR updates the roadmap frontier as required by #187, but it does not implement the requested check that validates the named frontier milestone against GitHub state. It only tracks that work separa… Implement the automated frontier-state check required by #187, or split the PR explicitly and update the linked issue relationship so this PR claims only the roadmap correction.
Out of Scope Changes check ⚠️ Warning The public Rust API test-plan changes reference #189, #204, and #205 but are not required by linked issue #187. These changes are outside the linked issue's roadmap-frontier scope. Remove the unrelated test-plan changes from this PR, or link the issues that define those documentation requirements.
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the documentation change to reconcile the bounded application build frontier.
Description check ✅ Passed The description accurately explains the roadmap correction, related documentation updates, scope boundaries, and validation results.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Full details: Linked Issues check

Explanation

The PR updates the roadmap frontier as required by #187, but it does not implement the requested check that validates the named frontier milestone against GitHub state. It only tracks that work separately in #205.

  • Fix all pre-merge checks with AI

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

The roadmap sheds its dated crown
Evidence marks the pathway down
Compiler pieces stand in line
Issue references now align
Runtime gates remain unseen

Comment @coderabbitai help to get the list of available commands.

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.

ROADMAP.md Current Frontier points at a milestone closed 22 days ago

1 participant