feat(rebuild): generated-content fast path — Workstream C wiring (flag-gated, draft) - #2020
Merged
Conversation
…ated off)
On a slug-targeted run with CONTENT_CACHE_FAST_PATH=true, fetch-tutorials
reuses the previously-generated .md + sidecar nav/author rows for non-target
slugs, skipping composeTutorial/fetchRulesVr/AI-quiz/writeHugoPage — the bulk
of Phase 3's ~56s. Two gates, both required, else full regen:
- actions/cache KEY = parser-source hash (a parser change → cache miss → the
per-slug existsSync guard falls through to recompose)
- runtime feed fingerprint over CAP catalog + tag-labels (nav/mission/tags);
co-completions excluded (empty on warm-cache runs, recommendations are
client-hydrated)
Sidecar (navEntries + authorRows + fingerprint) written to .content-cache/,
cached by the same parser-hashed key as hugo/content/tutorials +
image_dimensions.json. Fail-open throughout; flag defaults OFF so default
behavior is byte-identical to today.
Enabling on DEV (input content-cache=true) + a byte-identical diff-verify
(task 3.6) is the follow-up before flipping the default.
Helper unchanged behavior; content-cache tests green (15).
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.
What
Wires the slug-targeted fast path on top of the #2019 helpers. On a slug-targeted run with
content-cache=true,fetch-tutorialsreuses the previously-generated.md+ sidecar nav/author rows for the ~1,400 unchanged tutorials, skippingcomposeTutorial/fetchRulesVr/AI-quiz/writeHugoPage— the bulk of the ~56s Phase 3 cost.Correctness (two gates, both required, else full regen)
existsSync(generatedFile)guard falls through to recompose.Sidecar (navEntries + authorRows + fingerprint) →
.content-cache/, cached by the same parser-hashed key ashugo/content/tutorials+image_dimensions.json. Fail-open everywhere; flag defaults OFF → default behavior byte-identical to today.Verification
content-cache=true): priming run (cold cache → full regen + writes sidecar), then a warm run to observe[reused]for non-target slugs + correct target output.Design/tasks: #2017. Foundation: #2019 (merged).