Repository navigation
docs(design): the resource-construction rulings become the resource-management body; sketches retire - #592
Merged
Conversation
…anagement body; sketches retire Phase 0 of the resource-construction plan. 4-resource-management.md absorbs the 2026-08-20 rulings as body: new section 5, "The Catalog Travels with the Graph" -- intent-only plan-time claiming (string values mint pending entries, promises record promises, products are runtime facts), git-model plan-space paths with the home/system late-binding examples, rel identity with activation that never changes it, the mandatory serialized section with hard load and pre-flight failure, and the graph-intent/trace-observation split. Section 4 rewrites to runtime-only shadowing -- plan-time output claims and implicit same-URI edges are superseded; ordering is the promise's job, and sections 1 and 2 now say so -- with the two-path reconciler absorbed from the catalog-reconciler sketch as 4.1. Appendix A is deleted as rejected, recorded in the resolved decisions alongside the four new rulings. 4.1-resource-identity.md amends the file scheme: catalog identity is the slash-canonical root-relative path; the RFC 8089 absolute form survives only as the rendered form against a bound root; the buildURI sketch follows. 3.6 gains the dispatch-convergence law distilled from the stack-comparison sketches, in current names -- their line-level stacks described a shape that no longer exists. The package-signatures sketch relocates verbatim to 7-registry-knowledge as LorePackaging material. The transport plan's step 3 is annotated: the reference-entry exclusion is withdrawn; the content transport it landed is unchanged. Four stale cross-references to pre-rewrite section numbers are corrected in passing. All five sketches retire: mined, integrated, deleted. The status companion records that the DESIGN now leads the TREE -- the two red judgment pins measure the gap until #583-#586 land. Closes #582. Refs #581, #444.
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.
Phase 0 of resource-construction — design integration, docs only.
4-resource-management.md
promise, product → runtime fact), git-model plan-space paths (leading slash anchors at the fsroot;
home/system late binding), rel identity + activation-never-changes-identity, the mandatory-even-empty
serialized section with hard load/pre-flight failure, graph = intent / trace = observation.
superseded; §1/§2 corrected: ordering is the promise's job (judgment scenario 1 is the counterexample).
The two-path reconciler (Etag screen → Digest verdict; touch drift; content-mismatch-is-corruption for
CAS;
AddressingUnknowntripwire) absorbed as §4.1 from the retired sketch.The rest
filecatalog identity is the slash-canonical rel; RFC-absolute survives as the renderedform only;
buildURIsketch follows.op.Convert's one cascade; the timingasymmetry is the plan/immediate distinction) — distilled from the stack sketches in current names.
(
Epic:LorePackagingowns its maturation).§cross-references corrected (1-system-model, 6-execution-topology,2.7-control-plane, 3.1-provider-loading).
Sketches: all five retired
resource-construction,catalog-reconciler-logic,01/02-stack-comparison(integrated),package-signatures(relocated) —docs/sketches/is empty.The status companion records that the design now leads the tree; the two red judgment pins measure the
gap until #583–#586 land. Windows expectation: identical to baseline 3 (docs only).
Closes #582. Refs #581, #444.