daily-notification-plugin/doc/_archive/2025-12-16-consolidation/CONSOLIDATION_SOURCE_MAP.md

Documentation Consolidation Source Map

Date: 2025-12-16
Purpose: Complete audit trail of all markdown file destinations during consolidation
Total Files Mapped: 139

This document guarantees no information loss by tracking every file's destination.

---

Legend

• Canonical: File kept in active documentation, possibly edited/merged
• Merged: Content incorporated into canonical document, original archived
• Archived: File preserved verbatim in archive, referenced from index

---

Root Canonical Files (Keep As-Is)

Note (2025-03): The following were moved after consolidation: TODO.md → doc/progress/TODO.md; TODAY_SUMMARY.md → doc/progress/TODAY_SUMMARY.md; SESSION_RECONSTITUTION.md → doc/progress/SESSION_RECONSTITUTION.md; BATCH_A_COMPLETION_SUMMARY.md → doc/progress/BATCH_A_COMPLETION_SUMMARY.md; PR_DESCRIPTION.md → doc/_archive/PR_DESCRIPTION.md; MERGE_READY_SUMMARY.md → doc/_archive/MERGE_READY_SUMMARY.md.

Original Path	Status	Notes
README.md	Canonical	Main entry point, will link to doc/00-INDEX.md
ARCHITECTURE.md	Canonical	Foundational architecture document
BUILDING.md	Canonical	Build instructions
CHANGELOG.md	Canonical	Version history
CONTRIBUTING.md	Canonical	Contribution guidelines
SECURITY.md	Canonical	Security documentation
API.md	Canonical	API reference
USAGE.md	Canonical	Usage guide
TODO.md	Moved	→ doc/progress/TODO.md
PR_DESCRIPTION.md	Moved	→ doc/_archive/PR_DESCRIPTION.md
MERGE_READY_SUMMARY.md	Moved	→ doc/_archive/MERGE_READY_SUMMARY.md

---

Integration Documentation (Consolidate to doc/integration/)

Original Path	New Path	Status	Notes
INTEGRATION_GUIDE.md	doc/integration/INTEGRATION_GUIDE.md	Canonical	Primary integration guide
QUICK_INTEGRATION.md	doc/integration/QUICK_START.md	Canonical	Quick start guide
AI_INTEGRATION_GUIDE.md	doc/ai/AI_INTEGRATION_GUIDE.md	Canonical	AI-specific integration
doc/INTEGRATION_CHECKLIST.md	doc/integration/CHECKLIST.md	Merged	Merge into INTEGRATION_GUIDE.md
doc/INTEGRATION_REFACTOR_CONTEXT.md	doc/integration/REFACTOR_NOTES.md	Merged	Merge context into refactor notes
doc/INTEGRATION_REFACTOR_QUICK_START.md	doc/integration/REFACTOR_NOTES.md	Merged	Merge into refactor notes
doc/aar-integration-troubleshooting.md	doc/integration/TROUBLESHOOTING.md	Merged	Merge into troubleshooting guide
doc/integration-point-refactor-analysis.md	doc/integration/REFACTOR_NOTES.md	Merged	Merge into refactor notes

---

Legacy Documentation (Archive to doc/archive/2025-legacy-doc/)

Original Path	New Path	Status	Notes
doc/BACKGROUND_DATA_FETCHING_PLAN.md	doc/archive/2025-legacy-doc/BACKGROUND_DATA_FETCHING_PLAN.md	Archived	Historical planning doc
doc/BUILD_FIXES_SUMMARY.md	doc/archive/2025-legacy-doc/BUILD_FIXES_SUMMARY.md	Archived	Historical build fixes
doc/BUILD_SCRIPT_IMPROVEMENTS.md	doc/archive/2025-legacy-doc/BUILD_SCRIPT_IMPROVEMENTS.md	Archived	Historical build improvements
doc/directives/0001-Daily-Notification-Plugin-Implementation-Directive.md	doc/archive/2025-legacy-doc/directives/0001-Daily-Notification-Plugin-Implementation-Directive.md	Archived	Historical directive
doc/directives/0002-Daily-Notification-Plugin-Recommendations.md	doc/archive/2025-legacy-doc/directives/0002-Daily-Notification-Plugin-Recommendations.md	Archived	Historical recommendations
doc/directives/0003-iOS-Android-Parity-Directive.md	doc/archive/2025-legacy-doc/directives/0003-iOS-Android-Parity-Directive.md	Archived	Historical directive
doc/implementation-roadmap.md	doc/archive/2025-legacy-doc/implementation-roadmap.md	Archived	Historical roadmap
doc/IOS_ANDROID_ERROR_CODE_MAPPING.md	doc/archive/2025-legacy-doc/IOS_ANDROID_ERROR_CODE_MAPPING.md	Archived	Historical mapping
doc/IOS_PHASE1_FINAL_SUMMARY.md	doc/archive/2025-legacy-doc/IOS_PHASE1_FINAL_SUMMARY.md	Archived	Historical summary
doc/IOS_PHASE1_GAPS_ANALYSIS.md	doc/archive/2025-legacy-doc/IOS_PHASE1_GAPS_ANALYSIS.md	Archived	Historical analysis
doc/IOS_PHASE1_IMPLEMENTATION_CHECKLIST.md	doc/platform/ios/IMPLEMENTATION_CHECKLIST.md	Merged	Promote to canonical iOS docs
doc/IOS_PHASE1_QUICK_REFERENCE.md	doc/archive/2025-legacy-doc/IOS_PHASE1_QUICK_REFERENCE.md	Archived	Historical quick reference
doc/IOS_PHASE1_READY_FOR_TESTING.md	doc/archive/2025-legacy-doc/IOS_PHASE1_READY_FOR_TESTING.md	Archived	Historical testing status
doc/IOS_PHASE1_TESTING_GUIDE.md	doc/testing/IOS_PHASE1_TESTING_GUIDE.md	Merged	Promote to testing docs
doc/IOS_TEST_APP_SETUP_GUIDE.md	doc/testing/IOS_TEST_APP_SETUP.md	Merged	Promote to testing docs
doc/migration-guide.md	doc/platform/ios/MIGRATION_GUIDE.md	Merged	Promote to canonical iOS docs
doc/notification-system.md	doc/archive/2025-legacy-doc/notification-system.md	Archived	Historical system doc
doc/PHASE1_COMPLETION_SUMMARY.md	doc/archive/2025-legacy-doc/PHASE1_COMPLETION_SUMMARY.md	Archived	Historical summary
doc/RESEARCH_COMPLETE.md	doc/archive/2025-legacy-doc/RESEARCH_COMPLETE.md	Archived	Historical research doc
doc/STARRED_PROJECTS_POLLING_IMPLEMENTATION.md	doc/design/STARRED_PROJECTS_POLLING_IMPLEMENTATION.md	Canonical	Promote to design docs (large, relevant)
doc/test-app-ios/ENHANCEMENTS_APPLIED.md	doc/archive/2025-legacy-doc/test-app-ios/ENHANCEMENTS_APPLIED.md	Archived	Historical enhancements
doc/test-app-ios/IOS_LOGGING_GUIDE.md	doc/testing/IOS_LOGGING_GUIDE.md	Merged	Promote to testing docs
doc/test-app-ios/IOS_PREFETCH_GLOSSARY.md	doc/platform/ios/PREFETCH_GLOSSARY.md	Merged	Promote to iOS docs
doc/test-app-ios/IOS_PREFETCH_TESTING.md	doc/testing/IOS_PREFETCH_TESTING.md	Merged	Promote to testing docs
doc/test-app-ios/IOS_TEST_APP_REQUIREMENTS.md	doc/testing/IOS_TEST_APP_REQUIREMENTS.md	Merged	Promote to testing docs
doc/UI_REQUIREMENTS.md	doc/archive/2025-legacy-doc/UI_REQUIREMENTS.md	Archived	Historical requirements

---

Platform Documentation - iOS (Consolidate to doc/platform/ios/)

Original Path	New Path	Status	Notes
doc/IOS_IMPLEMENTATION_CHECKLIST.md	doc/platform/ios/IMPLEMENTATION_CHECKLIST.md	Canonical	Primary iOS checklist
doc/ios-implementation-directive.md	doc/platform/ios/IMPLEMENTATION_DIRECTIVE.md	Canonical	iOS implementation directive
doc/IOS_IMPLEMENTATION_DOCUMENTATION_REVIEW.md	doc/platform/ios/DOCUMENTATION_REVIEW.md	Canonical	Documentation review
doc/ios-core-data-migration.md	doc/platform/ios/CORE_DATA_MIGRATION.md	Canonical	Core Data migration guide
doc/ios-recovery-scenario-mapping.md	doc/platform/ios/RECOVERY_SCENARIO_MAPPING.md	Canonical	Recovery scenario mapping
doc/ios-rollover-edge-case-plan.md	doc/platform/ios/ROLLOVER_EDGE_CASES.md	Canonical	Rollover edge cases
doc/ios-rollover-implementation-review.md	doc/platform/ios/ROLLOVER_IMPLEMENTATION_REVIEW.md	Canonical	Rollover implementation review
doc/ios-rollover-open-questions-answers.md	doc/platform/ios/ROLLOVER_QA.md	Canonical	Rollover Q&A
doc/ios-troubleshooting-guide.md	doc/platform/ios/TROUBLESHOOTING.md	Canonical	iOS troubleshooting

---

Platform Documentation - Android (Consolidate to doc/platform/android/)

Original Path	New Path	Status	Notes
doc/android-implementation-directive.md	doc/platform/android/IMPLEMENTATION_DIRECTIVE.md	Canonical	Primary Android directive
doc/android-implementation-directive-phase1.md	doc/platform/android/PHASE1_DIRECTIVE.md	Canonical	Phase 1 directive
doc/android-implementation-directive-phase2.md	doc/platform/android/PHASE2_DIRECTIVE.md	Canonical	Phase 2 directive
doc/android-implementation-directive-phase3.md	doc/platform/android/PHASE3_DIRECTIVE.md	Canonical	Phase 3 directive
doc/android-alarm-persistence-directive.md	doc/platform/android/ALARM_PERSISTENCE_DIRECTIVE.md	Canonical	Alarm persistence directive
doc/android-app-analysis.md	doc/platform/android/APP_ANALYSIS.md	Canonical	App analysis
doc/android-app-improvement-plan.md	doc/platform/android/APP_IMPROVEMENT_PLAN.md	Canonical	App improvement plan
android/BUILDING.md	doc/platform/android/BUILDING.md	Canonical	Android build guide
android/DATABASE_CONSOLIDATION_PLAN.md	doc/platform/android/DATABASE_CONSOLIDATION_PLAN.md	Canonical	Database consolidation plan

---

Testing Documentation (Consolidate to doc/testing/)

Original Path	New Path	Status	Notes
doc/comprehensive-testing-guide-v2.md	doc/testing/COMPREHENSIVE_GUIDE.md	Canonical	Primary testing guide
doc/testing-quick-reference.md	doc/testing/QUICK_REFERENCE.md	Canonical	Quick reference
doc/testing-quick-reference-v2.md	doc/testing/QUICK_REFERENCE.md	Merged	Merge into QUICK_REFERENCE.md
doc/manual_smoke_test.md	doc/testing/MANUAL_SMOKE_TEST.md	Canonical	Manual smoke test
doc/notification-testing-procedures.md	doc/testing/NOTIFICATION_PROCEDURES.md	Canonical	Notification testing
doc/reboot-testing-procedure.md	doc/testing/REBOOT_PROCEDURE.md	Canonical	Reboot testing
doc/reboot-testing-steps.md	doc/testing/REBOOT_PROCEDURE.md	Merged	Merge into REBOOT_PROCEDURE.md
doc/boot-receiver-testing-guide.md	doc/testing/BOOT_RECEIVER_GUIDE.md	Canonical	Boot receiver testing
doc/standalone-emulator-guide.md	doc/testing/EMULATOR_GUIDE.md	Canonical	Emulator guide
doc/localhost-testing-guide.md	doc/testing/LOCALHOST_GUIDE.md	Canonical	Localhost testing

---

Alarm System Documentation (Keep in doc/alarms/)

Original Path	New Path	Status	Notes
doc/alarms/000-UNIFIED-ALARM-DIRECTIVE.md	doc/alarms/000-UNIFIED-ALARM-DIRECTIVE.md	Canonical	Keep as-is
doc/alarms/01-platform-capability-reference.md	doc/alarms/01-platform-capability-reference.md	Canonical	Keep as-is
doc/alarms/02-plugin-behavior-exploration.md	doc/alarms/02-plugin-behavior-exploration.md	Canonical	Keep as-is
doc/alarms/03-plugin-requirements.md	doc/alarms/03-plugin-requirements.md	Canonical	Keep as-is
doc/alarms/ACTIVATION-GUIDE.md	doc/alarms/ACTIVATION-GUIDE.md	Canonical	Keep as-is
doc/alarms/PHASE1-EMULATOR-TESTING.md	doc/alarms/PHASE1-EMULATOR-TESTING.md	Canonical	Keep as-is
doc/alarms/PHASE1-VERIFICATION.md	doc/alarms/PHASE1-VERIFICATION.md	Canonical	Keep as-is
doc/alarms/PHASE2-EMULATOR-TESTING.md	doc/alarms/PHASE2-EMULATOR-TESTING.md	Canonical	Keep as-is
doc/alarms/PHASE2-VERIFICATION.md	doc/alarms/PHASE2-VERIFICATION.md	Canonical	Keep as-is
doc/alarms/PHASE3-EMULATOR-TESTING.md	doc/alarms/PHASE3-EMULATOR-TESTING.md	Canonical	Keep as-is
doc/alarms/PHASE3-VERIFICATION.md	doc/alarms/PHASE3-VERIFICATION.md	Canonical	Keep as-is

---

AI / ChatGPT Documentation (Consolidate to doc/ai/)

Original Path	New Path	Status	Notes
chatgpt-assessment-package.md	doc/ai/chatgpt-assessment-package.md	Canonical	AI artifacts
chatgpt-files-overview.md	doc/ai/chatgpt-files-overview.md	Canonical	AI artifacts
chatgpt-improvement-directives-template.md	doc/ai/chatgpt-improvement-directives-template.md	Canonical	AI artifacts
code-summary-for-chatgpt.md	doc/ai/code-summary-for-chatgpt.md	Canonical	AI artifacts
key-code-snippets-for-chatgpt.md	doc/ai/key-code-snippets-for-chatgpt.md	Canonical	AI artifacts
doc/chatgpt-analysis-guide.md	doc/ai/chatgpt-analysis-guide.md	Canonical	AI artifacts

---

Design & Research Documentation (Consolidate to doc/design/)

Original Path	New Path	Status	Notes
doc/exploration-findings-initial.md	doc/design/exploration-findings-initial.md	Canonical	Design research
doc/explore-alarm-behavior-directive.md	doc/design/explore-alarm-behavior-directive.md	Canonical	Design research
doc/improve-alarm-directives.md	doc/design/improve-alarm-directives.md	Canonical	Design research
doc/plugin-behavior-exploration-template.md	doc/design/plugin-behavior-exploration-template.md	Canonical	Design template

---

Deployment Documentation (Keep in doc/)

Original Path	New Path	Status	Notes
DEPLOYMENT_CHECKLIST.md	doc/DEPLOYMENT_CHECKLIST.md	Canonical	Move to doc/
DEPLOYMENT_SUMMARY.md	doc/DEPLOYMENT_SUMMARY.md	Canonical	Move to doc/
doc/deployment-guide.md	doc/DEPLOYMENT_GUIDE.md	Canonical	Primary deployment guide

---

Feature-Specific Documentation (Keep in doc/)

Original Path	New Path	Status	Notes
doc/CROSS_PLATFORM_STORAGE_PATTERN.md	doc/CROSS_PLATFORM_STORAGE_PATTERN.md	Canonical	Keep as-is
doc/DATABASE_INTERFACES.md	doc/DATABASE_INTERFACES.md	Canonical	Keep as-is
doc/DATABASE_INTERFACES_IMPLEMENTATION.md	doc/DATABASE_INTERFACES_IMPLEMENTATION.md	Canonical	Keep as-is
doc/NATIVE_FETCHER_CONFIGURATION.md	doc/NATIVE_FETCHER_CONFIGURATION.md	Canonical	Keep as-is
doc/platform-capability-reference.md	doc/platform-capability-reference.md	Canonical	Keep as-is
doc/plugin-requirements-implementation.md	doc/plugin-requirements-implementation.md	Canonical	Keep as-is
doc/prefetch-scheduling-diagnosis.md	doc/prefetch-scheduling-diagnosis.md	Canonical	Keep as-is
doc/prefetch-scheduling-trace.md	doc/prefetch-scheduling-trace.md	Canonical	Keep as-is
doc/app-startup-recovery-solution.md	doc/app-startup-recovery-solution.md	Canonical	Keep as-is
doc/getting-valid-plan-ids.md	doc/getting-valid-plan-ids.md	Canonical	Keep as-is
doc/host-request-configuration.md	doc/host-request-configuration.md	Canonical	Keep as-is
doc/hydrate-plan-implementation-guide.md	doc/hydrate-plan-implementation-guide.md	Canonical	Keep as-is
doc/user-zero-stars-implementation.md	doc/user-zero-stars-implementation.md	Canonical	Keep as-is
doc/accessibility-localization.md	doc/accessibility-localization.md	Canonical	Keep as-is
doc/legal-store-compliance.md	doc/legal-store-compliance.md	Canonical	Keep as-is
doc/observability-dashboards.md	doc/observability-dashboards.md	Canonical	Keep as-is
doc/file-organization-summary.md	doc/file-organization-summary.md	Canonical	Keep as-is
doc/capacitor-platform-service-clean-changes.md	doc/capacitor-platform-service-clean-changes.md	Canonical	Keep as-is

---

Test App Documentation (Keep with Test Apps, Index in doc/testing/)

Original Path	New Path	Status	Notes
test-apps/BUILD_PROCESS.md	test-apps/BUILD_PROCESS.md	Canonical	Keep with test apps
test-apps/android-test-app/doc/PHASE1_TEST0_GOLDEN.md	test-apps/android-test-app/doc/PHASE1_TEST0_GOLDEN.md	Canonical	Keep with test apps
test-apps/android-test-app/doc/PHASE1_TEST1_GOLDEN.md	test-apps/android-test-app/doc/PHASE1_TEST1_GOLDEN.md	Canonical	Keep with test apps
test-apps/daily-notification-test/doc/BUILD_QUICK_REFERENCE.md	test-apps/daily-notification-test/doc/BUILD_QUICK_REFERENCE.md	Canonical	Keep with test apps
test-apps/daily-notification-test/doc/NOTIFICATION_STACK_IMPROVEMENT_PLAN.md	test-apps/daily-notification-test/doc/NOTIFICATION_STACK_IMPROVEMENT_PLAN.md	Canonical	Keep with test apps
test-apps/daily-notification-test/doc/PLUGIN_DETECTION_GUIDE.md	test-apps/daily-notification-test/doc/PLUGIN_DETECTION_GUIDE.md	Canonical	Keep with test apps
test-apps/daily-notification-test/doc/VUE3_NOTIFICATION_IMPLEMENTATION_GUIDE.md	test-apps/daily-notification-test/doc/VUE3_NOTIFICATION_IMPLEMENTATION_GUIDE.md	Canonical	Keep with test apps
test-apps/daily-notification-test/IMPLEMENTATION_COMPLETE.md	test-apps/daily-notification-test/IMPLEMENTATION_COMPLETE.md	Canonical	Keep with test apps
test-apps/daily-notification-test/INVESTIGATION_JWT_ALGORITHM.md	test-apps/daily-notification-test/INVESTIGATION_JWT_ALGORITHM.md	Canonical	Keep with test apps
test-apps/daily-notification-test/INVESTIGATION_JWT_ALGORITHM_RESULTS.md	test-apps/daily-notification-test/INVESTIGATION_JWT_ALGORITHM_RESULTS.md	Canonical	Keep with test apps
test-apps/daily-notification-test/README.md	test-apps/daily-notification-test/README.md	Canonical	Keep with test apps
test-apps/daily-notification-test/TODO_NATIVE_FETCHER.md	test-apps/daily-notification-test/TODO_NATIVE_FETCHER.md	Canonical	Keep with test apps
test-apps/ios-test-app/BUILD_NOTES.md	test-apps/ios-test-app/BUILD_NOTES.md	Canonical	Keep with test apps
test-apps/ios-test-app/BUILD_SUCCESS.md	test-apps/ios-test-app/BUILD_SUCCESS.md	Canonical	Keep with test apps
test-apps/ios-test-app/COMPILATION_FIXES.md	test-apps/ios-test-app/COMPILATION_FIXES.md	Canonical	Keep with test apps
test-apps/ios-test-app/COMPILATION_STATUS.md	test-apps/ios-test-app/COMPILATION_STATUS.md	Canonical	Keep with test apps
test-apps/ios-test-app/COMPILATION_SUMMARY.md	test-apps/ios-test-app/COMPILATION_SUMMARY.md	Canonical	Keep with test apps
test-apps/ios-test-app/README.md	test-apps/ios-test-app/README.md	Canonical	Keep with test apps
test-apps/ios-test-app/SETUP_COMPLETE.md	test-apps/ios-test-app/SETUP_COMPLETE.md	Canonical	Keep with test apps
test-apps/ios-test-app/SETUP_STATUS.md	test-apps/ios-test-app/SETUP_STATUS.md	Canonical	Keep with test apps

---

Plugin-Specific Documentation (Keep in ios/Plugin/)

Original Path	New Path	Status	Notes
ios/Plugin/README.md	ios/Plugin/README.md	Canonical	Keep with plugin code

---

Cursor Rules Documentation (Keep in .cursor/rules/)

Original Path	New Path	Status	Notes
.cursor/rules/README.md	.cursor/rules/README.md	Canonical	Keep with cursor rules
.cursor/rules/architecture/README.md	.cursor/rules/architecture/README.md	Canonical	Keep with cursor rules
.cursor/rules/meta_rule_architecture.md	.cursor/rules/meta_rule_architecture.md	Canonical	Keep with cursor rules

---

Summary Statistics

• Total Files: 139
• Canonical (Active): ~95 files
• Merged: ~15 files
• Archived: ~29 files

---

Verification Checklist

• All 139 files have a destination
• No file is marked for deletion
• All merged content is traceable
• Archive structure preserves original paths
• Index references all canonical files
• README.md links to doc/00-INDEX.md

---

Last Updated: 2025-12-16
Status: Complete - Ready for Implementation