docs: update architecture, decisions, and HyperCard mapping - #284
Merged
Conversation
jrepp
force-pushed
the
docs/architecture-update
branch
from
June 21, 2026 00:21
d8ac1db to
2814586
Compare
jrepp
force-pushed
the
docs/architecture-update
branch
from
June 21, 2026 00:34
2814586 to
dc21e2d
Compare
10 tasks
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
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.
Summary
docs/architecture-updateonto currentorigin/main(f626f4f)..documentswitch commit during rebase because it is already onorigin/mainvia PR fix(asset-browser): handle .document case in AssetKind switches #283.dc21e2d docs: update architecture, decisions, and HyperCard mapping.What Changed
architecture.mdanddecisions.mdaround imported HyperCard project behavior, stack-library metadata, used-stack pass-up, external emulator outcomes, runtime navigation, and known compatibility gaps.selectedTime, slider tracking behavior, classic media lookup, chart/spider properties, and AI Context Library policy.docs/HyperCardExternalMapping.mdwith durable compatibility-slice labels for PICT/palette/QuickDraw/HyperTint/window emulation instead of PR-series labels.stackLibrary/legacyImportpersistence notes todocs/SQLiteStackStorageDesign.mdas non-breaking optionaldocument_valuesmetadata.script/build_and_run.sh, with a note that extensionless stack acceptance still depends on the importer’s.datafallback and stack-format validation path.Actionable Review Focus
stackLibrarypersistence wording matches current storage behavior: optional metadata indocument_values, default-on-missing decode, and no document-version bump.Verification
origin/docs/architecture-update.git diff --check origin/main...HEADpassed.PR 7xlabels, staleupdateSpriteViews()/draw()wording, and narrowed chart/calendar property-table regressions.