MemRelay/global/curated/7aee455b-24cc-4008-bdaf-443721e6f939/Global Development Workflows.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, restored_from_commit

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	restored_from_commit
Global Development Workflows	curated	main/global/curated/7aee455b-24cc-4008-bdaf-443721e6f939/global-development-workflows	e4fc35f2-1606-4b79-9c1e-367edeea97d0	global	null	global	0c9feb46-d06e-43cd-9ef0-c5813c84a998	global	workflows	1	d8161df6-3159-46c9-9402-c5ab30d1436e			null			Sub2API	git-restore	90	memory:5ed86f53-b53e-4534-8e51-d3a010069d5e memory:105b328f-4bda-4641-90a7-7282ef156316 memory:3f91189b-11a1-45bb-8357-4f413dc1609d 2 2 1	processed unchanged unsupported skipped 90 0 0 0	curated_baseline:e4fc35f2-1606-4b79-9c1e-367edeea97d0 cross_workspace_memory:df065dbf-85de-4f2b-bbb1-5d8b115de08c cross_workspace_memory:9f00df57-ec45-4d63-9da6-9b2fb16c2d6b cross_workspace_memory:0f19c98d-0d69-4702-af18-e75edae6370a cross_workspace_memory:1dfbc803-3390-4cc7-9a17-6bf86c9bb165 cross_workspace_memory:6e63a053-fea4-4785-984c-b61fab08810a cross_workspace_memory:dd093dd7-71be-46a2-bcb1-4a87c3d4b9ab cross_workspace_memory:dc70f54c-8e29-4834-a5c1-a63bc9ac9e68 cross_workspace_memory:e1b8d25d-f638-4fbe-8a8d-0eda8f2d7d46 cross_workspace_memory:6b129c78-a412-41e9-af9f-63ab071e03d9 cross_workspace_memory:5924806e-b234-49f7-b971-3c844fd07cf3 cross_workspace_memory:2bff13bb-b5cc-40fd-8b2f-774f5c6b9dba cross_workspace_memory:61e30ee3-0e26-4d64-b00e-f77bc3a3fd60 memory:5ed86f53-b53e-4534-8e51-d3a010069d5e memory:105b328f-4bda-4641-90a7-7282ef156316 memory:3f91189b-11a1-45bb-8357-4f413dc1609d	curated_baseline:e4fc35f2-1606-4b79-9c1e-367edeea97d0				571	b84354eb37ab531c5be3076d5c3f130399f235bc33c8cf9453cbfcecae042e49	2026-08-12.3	3	null	2026-08-08T07:55:35.371609+00:00	2026-09-23T14:50:02.231152+00:00	workflows global	6a6a895eaf

Global Development Workflow

1. Project memory & Git process

   • All notes are kept in aidocs/project_context.md. aidocs/ is in .gitignore and never committed.
   • After completing a task, perform: delete temporary files, debug logs, unused code → update memory (what/why/validation/issues/next steps) → check .gitignore → commit with type: 中文一句话描述. Default is commit only; push only when explicitly requested.

2. Credential Retrieval Workflow

   • Before any login, SSH, database or API call, query Vaultwarden. If exactly one match, use it directly. If multiple or none, prompt for selection or manual input.
   • When adding or updating credentials, immediately write them to the password vault; memory records only the entry name, purpose, and usage method.

3. Technical Notes

   • FastAPI async – Never perform blocking I/O inside async def; change to normal def so FastAPI handles it in a thread‑pool.
   • PowerShell JSON – Write JSON to a temporary file and send with curl.exe --data-binary @file to preserve quotes.
   • Large‑table SQL – Add indexes on frequently queried text columns, raise DB read/write_timeout along with client upload_timeout/run_timeout.
   • Docker exec timeout – Obtain raw socket and call socket.settimeout(None) to disable default 3 s timeout.
   • Docker Hub proxy – Configure Docker Desktop to Manual with HTTP/HTTPS pointing to http://127.0.0.1:7897 and restart Docker.

4. Version & Deployment Rules

   • For OTA, always use the official release version matching the device's ABI and keep the device’s firmware tightly coupled to the release channel.
   • Do not flash generic RK3568 images; use the project‑provided U‑Boot, DTB and RTL8367S/DSA configurations.

5. Testing & Validation

   • Regression tests should use real timestamps and ensure that the JSON output from memrelay://capabilities rendered via jsonable_encoder matches the raw resource structure.
   • FastAPI handlers that perform blocking I/O should be switched to synchronous functions.