MemRelay/projects/d0abaf3f-da04-4dd4-a228-bacf68f44e8f/curated/Key Decisions, Root‑Cause Analyses and Implemented Solutions.md

title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags

title	type	permalink	stable_id	scope	project_id	workspace_type	usage_profile_id	preference_context	document_type	revision	source_memory_ids	source_checkpoint_ids	source_file_ids	source_git_commit	source_git_commits	source_agent_sync_ids	model_connection	model_name	source_count	source_revisions	source_dispositions	cited_source_ids	job_cited_source_ids	conflicts	supersedes	preferences	source_cursor	source_hash	prompt_version	schema_version	curation_job_id	created_at	updated_at	tags
Key Decisions, Root‑Cause Analyses and Implemented Solutions	curated	main/projects/d0abaf3f-da04-4dd4-a228-bacf68f44e8f/curated/key-decisions-root-cause-analyses-and-implemented-solutions	aa3057ab-54c5-4ffc-ba85-c2f2396ee60c	project	d0abaf3f-da04-4dd4-a228-bacf68f44e8f	development	null	development	decisions	8				36234e0082845515a053c10ee552ce35a03415f0	36234e0082845515a053c10ee552ce35a03415f0		Sub2API	openai/gpt-oss-120b	125	memory:bea4a5ba-4685-4869-a02e-f0f1c7f733ea memory:340af5e9-b3e5-423a-9971-b370992738ce memory:b70c1a22-6834-4e59-936c-1945b04273b7 1 1 1	processed unchanged unsupported skipped 78 0 47 0	memory:bea4a5ba-4685-4869-a02e-f0f1c7f733ea memory:340af5e9-b3e5-423a-9971-b370992738ce memory:b70c1a22-6834-4e59-936c-1945b04273b7 git:tools/rkdevtool/revision.txt git:tools/loader/WHICH-LOADER.txt					0	5fe39ad3a37421f812566dd39f89d4c28fc6078c8d39031dff10eb6eb8d72e00	2026-08-12.3	3	75339546-fef5-4656-8969-ba806e3ea6f0	2026-08-08T10:02:17.345816+00:00	2026-08-16T18:44:50.475932+00:00	decisions

Key Decisions & Resolutions

#	Decision	Reason / Outcome
1	Add syscon‑reboot‑mode DTB node and enable it.	Guarantees clean reboots; fixes power‑off hang.
2	Remove emergency‑reboot.shutdown hook (later kept only as hard‑reset fallback).	Hook proved redundant after DTB node works; kept as safety net.
3	Disable hardware TSO (snps,tso removed from DTB).	Prevents TX storms, improves throughput (29.6 Mbps).
4	Switch TCP congestion to Cubic via sysctl.	Improves network performance.
5	Disable GMAC0 (watchdog storms).	Stops spurious watchdog messages.
6	Enforce SPI‑NOR safety: target verification, SHA‑256 check, mandatory flash_erase.	Prevents accidental NOR overwrite (Failure A on 2026‑07‑25).
7	Strip proxy vars inside Docker; optional G18PRO_PROXY.	Avoids Docker‑proxy leakage.
8	Force LF line endings (.gitattributes), disable core.autocrlf.	Prevents CRLF corruption in containers.
9	Compress images with xz and record SHA‑256.	Reproducibility & size savings.
10	Vaultwarden‑first credential handling – repo stores only entry names.	Secrets never in VCS.
11	AI / Git integration disabled by default.	Keeps build deterministic.
12	Use shallow Git clones, pin RKBIN_GIT_COMMIT=ce50c0d1.	Faster, reproducible builds.
13	Documentation language = Chinese; Windows primary host.	Consistency for team.
14	Default Docker cache volume retained between builds.	Speeds up incremental builds.
15	Preference for shallow clones, pinned DDR/BL31 blobs, LF line endings, KISS/YAGNI.	Overall development philosophy.

Source IDs: aa3057ab-54c5-4ffc-ba85-c2f2396ee60c, ff34c6eb-6bba-41e5-9e43-ff80941fa823, 105b328f-4bda-4641-90a7-7282ef156316, bf88c265-4749-4c50-85bc-4bae25298cd5