P2.6: Type Safety Cleanup - Replaced 'any' return types in vite-plugin.ts with concrete types (UserConfig, transform return type) - Documented TypeScript mixin 'any[]' exception in PlatformServiceMixin.ts - Audit confirmed: zero 'any' in codebase except documented TS mixin limitation - All external boundaries use 'unknown', all data payloads use 'Record<string, unknown>' P2.7: System Invariants Documentation - Created SYSTEM_INVARIANTS.md documenting all 6 enforced invariants - Added to docs/00-INDEX.md under Policy & Contracts section - Each invariant includes: What, Why, How, Where Progress Docs Updates: - Updated 00-STATUS.md: marked P2.6/P2.7 complete, added type safety invariant note - Updated 01-CHANGELOG-WORK.md: added 2025-12-22 entries for P2.6/P2.7 - Updated 03-TEST-RUNS.md: added P2.6 type safety audit test run - Updated P2-DESIGN.md: marked P2.6 acceptance criteria complete - Updated SYSTEM_INVARIANTS.md: added Type Safety Notes section Baseline Tag: - Created v1.0.11-p0-p1.4-p1.5-p2.6-p2.7-complete TypeScript compilation: ✅ PASSES Build: ✅ PASSES CI: ✅ All checks pass
19 KiB
19 KiB
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)
| Original Path | Status | Notes |
|---|---|---|
README.md |
Canonical | Main entry point, will link to docs/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 |
Canonical | Project TODO list |
PR_DESCRIPTION.md |
Canonical | PR template/description |
MERGE_READY_SUMMARY.md |
Canonical | Merge readiness summary |
Integration Documentation (Consolidate to docs/integration/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
INTEGRATION_GUIDE.md |
docs/integration/INTEGRATION_GUIDE.md |
Canonical | Primary integration guide |
QUICK_INTEGRATION.md |
docs/integration/QUICK_START.md |
Canonical | Quick start guide |
AI_INTEGRATION_GUIDE.md |
docs/ai/AI_INTEGRATION_GUIDE.md |
Canonical | AI-specific integration |
doc/INTEGRATION_CHECKLIST.md |
docs/integration/CHECKLIST.md |
Merged | Merge into INTEGRATION_GUIDE.md |
docs/INTEGRATION_REFACTOR_CONTEXT.md |
docs/integration/REFACTOR_NOTES.md |
Merged | Merge context into refactor notes |
docs/INTEGRATION_REFACTOR_QUICK_START.md |
docs/integration/REFACTOR_NOTES.md |
Merged | Merge into refactor notes |
docs/aar-integration-troubleshooting.md |
docs/integration/TROUBLESHOOTING.md |
Merged | Merge into troubleshooting guide |
docs/integration-point-refactor-analysis.md |
docs/integration/REFACTOR_NOTES.md |
Merged | Merge into refactor notes |
Legacy Documentation (Archive to docs/archive/2025-legacy-doc/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
doc/BACKGROUND_DATA_FETCHING_PLAN.md |
docs/archive/2025-legacy-doc/BACKGROUND_DATA_FETCHING_PLAN.md |
Archived | Historical planning doc |
doc/BUILD_FIXES_SUMMARY.md |
docs/archive/2025-legacy-doc/BUILD_FIXES_SUMMARY.md |
Archived | Historical build fixes |
doc/BUILD_SCRIPT_IMPROVEMENTS.md |
docs/archive/2025-legacy-doc/BUILD_SCRIPT_IMPROVEMENTS.md |
Archived | Historical build improvements |
doc/directives/0001-Daily-Notification-Plugin-Implementation-Directive.md |
docs/archive/2025-legacy-doc/directives/0001-Daily-Notification-Plugin-Implementation-Directive.md |
Archived | Historical directive |
doc/directives/0002-Daily-Notification-Plugin-Recommendations.md |
docs/archive/2025-legacy-doc/directives/0002-Daily-Notification-Plugin-Recommendations.md |
Archived | Historical recommendations |
doc/directives/0003-iOS-Android-Parity-Directive.md |
docs/archive/2025-legacy-doc/directives/0003-iOS-Android-Parity-Directive.md |
Archived | Historical directive |
doc/implementation-roadmap.md |
docs/archive/2025-legacy-doc/implementation-roadmap.md |
Archived | Historical roadmap |
doc/IOS_ANDROID_ERROR_CODE_MAPPING.md |
docs/archive/2025-legacy-doc/IOS_ANDROID_ERROR_CODE_MAPPING.md |
Archived | Historical mapping |
doc/IOS_PHASE1_FINAL_SUMMARY.md |
docs/archive/2025-legacy-doc/IOS_PHASE1_FINAL_SUMMARY.md |
Archived | Historical summary |
doc/IOS_PHASE1_GAPS_ANALYSIS.md |
docs/archive/2025-legacy-doc/IOS_PHASE1_GAPS_ANALYSIS.md |
Archived | Historical analysis |
doc/IOS_PHASE1_IMPLEMENTATION_CHECKLIST.md |
docs/platform/ios/IMPLEMENTATION_CHECKLIST.md |
Merged | Promote to canonical iOS docs |
doc/IOS_PHASE1_QUICK_REFERENCE.md |
docs/archive/2025-legacy-doc/IOS_PHASE1_QUICK_REFERENCE.md |
Archived | Historical quick reference |
doc/IOS_PHASE1_READY_FOR_TESTING.md |
docs/archive/2025-legacy-doc/IOS_PHASE1_READY_FOR_TESTING.md |
Archived | Historical testing status |
doc/IOS_PHASE1_TESTING_GUIDE.md |
docs/testing/IOS_PHASE1_TESTING_GUIDE.md |
Merged | Promote to testing docs |
doc/IOS_TEST_APP_SETUP_GUIDE.md |
docs/testing/IOS_TEST_APP_SETUP.md |
Merged | Promote to testing docs |
doc/migration-guide.md |
docs/platform/ios/MIGRATION_GUIDE.md |
Merged | Promote to canonical iOS docs |
doc/notification-system.md |
docs/archive/2025-legacy-doc/notification-system.md |
Archived | Historical system doc |
doc/PHASE1_COMPLETION_SUMMARY.md |
docs/archive/2025-legacy-doc/PHASE1_COMPLETION_SUMMARY.md |
Archived | Historical summary |
doc/RESEARCH_COMPLETE.md |
docs/archive/2025-legacy-doc/RESEARCH_COMPLETE.md |
Archived | Historical research doc |
doc/STARRED_PROJECTS_POLLING_IMPLEMENTATION.md |
docs/design/STARRED_PROJECTS_POLLING_IMPLEMENTATION.md |
Canonical | Promote to design docs (large, relevant) |
doc/test-app-ios/ENHANCEMENTS_APPLIED.md |
docs/archive/2025-legacy-doc/test-app-ios/ENHANCEMENTS_APPLIED.md |
Archived | Historical enhancements |
doc/test-app-ios/IOS_LOGGING_GUIDE.md |
docs/testing/IOS_LOGGING_GUIDE.md |
Merged | Promote to testing docs |
doc/test-app-ios/IOS_PREFETCH_GLOSSARY.md |
docs/platform/ios/PREFETCH_GLOSSARY.md |
Merged | Promote to iOS docs |
doc/test-app-ios/IOS_PREFETCH_TESTING.md |
docs/testing/IOS_PREFETCH_TESTING.md |
Merged | Promote to testing docs |
doc/test-app-ios/IOS_TEST_APP_REQUIREMENTS.md |
docs/testing/IOS_TEST_APP_REQUIREMENTS.md |
Merged | Promote to testing docs |
doc/UI_REQUIREMENTS.md |
docs/archive/2025-legacy-doc/UI_REQUIREMENTS.md |
Archived | Historical requirements |
Platform Documentation - iOS (Consolidate to docs/platform/ios/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
docs/IOS_IMPLEMENTATION_CHECKLIST.md |
docs/platform/ios/IMPLEMENTATION_CHECKLIST.md |
Canonical | Primary iOS checklist |
docs/ios-implementation-directive.md |
docs/platform/ios/IMPLEMENTATION_DIRECTIVE.md |
Canonical | iOS implementation directive |
docs/IOS_IMPLEMENTATION_DOCUMENTATION_REVIEW.md |
docs/platform/ios/DOCUMENTATION_REVIEW.md |
Canonical | Documentation review |
docs/ios-core-data-migration.md |
docs/platform/ios/CORE_DATA_MIGRATION.md |
Canonical | Core Data migration guide |
docs/ios-recovery-scenario-mapping.md |
docs/platform/ios/RECOVERY_SCENARIO_MAPPING.md |
Canonical | Recovery scenario mapping |
docs/ios-rollover-edge-case-plan.md |
docs/platform/ios/ROLLOVER_EDGE_CASES.md |
Canonical | Rollover edge cases |
docs/ios-rollover-implementation-review.md |
docs/platform/ios/ROLLOVER_IMPLEMENTATION_REVIEW.md |
Canonical | Rollover implementation review |
docs/ios-rollover-open-questions-answers.md |
docs/platform/ios/ROLLOVER_QA.md |
Canonical | Rollover Q&A |
docs/ios-troubleshooting-guide.md |
docs/platform/ios/TROUBLESHOOTING.md |
Canonical | iOS troubleshooting |
Platform Documentation - Android (Consolidate to docs/platform/android/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
docs/android-implementation-directive.md |
docs/platform/android/IMPLEMENTATION_DIRECTIVE.md |
Canonical | Primary Android directive |
docs/android-implementation-directive-phase1.md |
docs/platform/android/PHASE1_DIRECTIVE.md |
Canonical | Phase 1 directive |
docs/android-implementation-directive-phase2.md |
docs/platform/android/PHASE2_DIRECTIVE.md |
Canonical | Phase 2 directive |
docs/android-implementation-directive-phase3.md |
docs/platform/android/PHASE3_DIRECTIVE.md |
Canonical | Phase 3 directive |
docs/android-alarm-persistence-directive.md |
docs/platform/android/ALARM_PERSISTENCE_DIRECTIVE.md |
Canonical | Alarm persistence directive |
docs/android-app-analysis.md |
docs/platform/android/APP_ANALYSIS.md |
Canonical | App analysis |
docs/android-app-improvement-plan.md |
docs/platform/android/APP_IMPROVEMENT_PLAN.md |
Canonical | App improvement plan |
android/BUILDING.md |
docs/platform/android/BUILDING.md |
Canonical | Android build guide |
android/DATABASE_CONSOLIDATION_PLAN.md |
docs/platform/android/DATABASE_CONSOLIDATION_PLAN.md |
Canonical | Database consolidation plan |
Testing Documentation (Consolidate to docs/testing/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
docs/comprehensive-testing-guide-v2.md |
docs/testing/COMPREHENSIVE_GUIDE.md |
Canonical | Primary testing guide |
docs/testing-quick-reference.md |
docs/testing/QUICK_REFERENCE.md |
Canonical | Quick reference |
docs/testing-quick-reference-v2.md |
docs/testing/QUICK_REFERENCE.md |
Merged | Merge into QUICK_REFERENCE.md |
docs/manual_smoke_test.md |
docs/testing/MANUAL_SMOKE_TEST.md |
Canonical | Manual smoke test |
docs/notification-testing-procedures.md |
docs/testing/NOTIFICATION_PROCEDURES.md |
Canonical | Notification testing |
docs/reboot-testing-procedure.md |
docs/testing/REBOOT_PROCEDURE.md |
Canonical | Reboot testing |
docs/reboot-testing-steps.md |
docs/testing/REBOOT_PROCEDURE.md |
Merged | Merge into REBOOT_PROCEDURE.md |
docs/boot-receiver-testing-guide.md |
docs/testing/BOOT_RECEIVER_GUIDE.md |
Canonical | Boot receiver testing |
docs/standalone-emulator-guide.md |
docs/testing/EMULATOR_GUIDE.md |
Canonical | Emulator guide |
docs/localhost-testing-guide.md |
docs/testing/LOCALHOST_GUIDE.md |
Canonical | Localhost testing |
Alarm System Documentation (Keep in docs/alarms/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
docs/alarms/000-UNIFIED-ALARM-DIRECTIVE.md |
docs/alarms/000-UNIFIED-ALARM-DIRECTIVE.md |
Canonical | Keep as-is |
docs/alarms/01-platform-capability-reference.md |
docs/alarms/01-platform-capability-reference.md |
Canonical | Keep as-is |
docs/alarms/02-plugin-behavior-exploration.md |
docs/alarms/02-plugin-behavior-exploration.md |
Canonical | Keep as-is |
docs/alarms/03-plugin-requirements.md |
docs/alarms/03-plugin-requirements.md |
Canonical | Keep as-is |
docs/alarms/ACTIVATION-GUIDE.md |
docs/alarms/ACTIVATION-GUIDE.md |
Canonical | Keep as-is |
docs/alarms/PHASE1-EMULATOR-TESTING.md |
docs/alarms/PHASE1-EMULATOR-TESTING.md |
Canonical | Keep as-is |
docs/alarms/PHASE1-VERIFICATION.md |
docs/alarms/PHASE1-VERIFICATION.md |
Canonical | Keep as-is |
docs/alarms/PHASE2-EMULATOR-TESTING.md |
docs/alarms/PHASE2-EMULATOR-TESTING.md |
Canonical | Keep as-is |
docs/alarms/PHASE2-VERIFICATION.md |
docs/alarms/PHASE2-VERIFICATION.md |
Canonical | Keep as-is |
docs/alarms/PHASE3-EMULATOR-TESTING.md |
docs/alarms/PHASE3-EMULATOR-TESTING.md |
Canonical | Keep as-is |
docs/alarms/PHASE3-VERIFICATION.md |
docs/alarms/PHASE3-VERIFICATION.md |
Canonical | Keep as-is |
AI / ChatGPT Documentation (Consolidate to docs/ai/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
chatgpt-assessment-package.md |
docs/ai/chatgpt-assessment-package.md |
Canonical | AI artifacts |
chatgpt-files-overview.md |
docs/ai/chatgpt-files-overview.md |
Canonical | AI artifacts |
chatgpt-improvement-directives-template.md |
docs/ai/chatgpt-improvement-directives-template.md |
Canonical | AI artifacts |
code-summary-for-chatgpt.md |
docs/ai/code-summary-for-chatgpt.md |
Canonical | AI artifacts |
key-code-snippets-for-chatgpt.md |
docs/ai/key-code-snippets-for-chatgpt.md |
Canonical | AI artifacts |
docs/chatgpt-analysis-guide.md |
docs/ai/chatgpt-analysis-guide.md |
Canonical | AI artifacts |
Design & Research Documentation (Consolidate to docs/design/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
docs/exploration-findings-initial.md |
docs/design/exploration-findings-initial.md |
Canonical | Design research |
docs/explore-alarm-behavior-directive.md |
docs/design/explore-alarm-behavior-directive.md |
Canonical | Design research |
docs/improve-alarm-directives.md |
docs/design/improve-alarm-directives.md |
Canonical | Design research |
docs/plugin-behavior-exploration-template.md |
docs/design/plugin-behavior-exploration-template.md |
Canonical | Design template |
Deployment Documentation (Keep in docs/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
DEPLOYMENT_CHECKLIST.md |
docs/DEPLOYMENT_CHECKLIST.md |
Canonical | Move to docs/ |
DEPLOYMENT_SUMMARY.md |
docs/DEPLOYMENT_SUMMARY.md |
Canonical | Move to docs/ |
docs/deployment-guide.md |
docs/DEPLOYMENT_GUIDE.md |
Canonical | Primary deployment guide |
Feature-Specific Documentation (Keep in docs/)
| Original Path | New Path | Status | Notes |
|---|---|---|---|
docs/CROSS_PLATFORM_STORAGE_PATTERN.md |
docs/CROSS_PLATFORM_STORAGE_PATTERN.md |
Canonical | Keep as-is |
docs/DATABASE_INTERFACES.md |
docs/DATABASE_INTERFACES.md |
Canonical | Keep as-is |
docs/DATABASE_INTERFACES_IMPLEMENTATION.md |
docs/DATABASE_INTERFACES_IMPLEMENTATION.md |
Canonical | Keep as-is |
docs/NATIVE_FETCHER_CONFIGURATION.md |
docs/NATIVE_FETCHER_CONFIGURATION.md |
Canonical | Keep as-is |
docs/platform-capability-reference.md |
docs/platform-capability-reference.md |
Canonical | Keep as-is |
docs/plugin-requirements-implementation.md |
docs/plugin-requirements-implementation.md |
Canonical | Keep as-is |
docs/prefetch-scheduling-diagnosis.md |
docs/prefetch-scheduling-diagnosis.md |
Canonical | Keep as-is |
docs/prefetch-scheduling-trace.md |
docs/prefetch-scheduling-trace.md |
Canonical | Keep as-is |
docs/app-startup-recovery-solution.md |
docs/app-startup-recovery-solution.md |
Canonical | Keep as-is |
docs/getting-valid-plan-ids.md |
docs/getting-valid-plan-ids.md |
Canonical | Keep as-is |
docs/host-request-configuration.md |
docs/host-request-configuration.md |
Canonical | Keep as-is |
docs/hydrate-plan-implementation-guide.md |
docs/hydrate-plan-implementation-guide.md |
Canonical | Keep as-is |
docs/user-zero-stars-implementation.md |
docs/user-zero-stars-implementation.md |
Canonical | Keep as-is |
docs/accessibility-localization.md |
docs/accessibility-localization.md |
Canonical | Keep as-is |
docs/legal-store-compliance.md |
docs/legal-store-compliance.md |
Canonical | Keep as-is |
docs/observability-dashboards.md |
docs/observability-dashboards.md |
Canonical | Keep as-is |
docs/file-organization-summary.md |
docs/file-organization-summary.md |
Canonical | Keep as-is |
docs/capacitor-platform-service-clean-changes.md |
docs/capacitor-platform-service-clean-changes.md |
Canonical | Keep as-is |
Test App Documentation (Keep with Test Apps, Index in docs/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/docs/PHASE1_TEST0_GOLDEN.md |
test-apps/android-test-app/docs/PHASE1_TEST0_GOLDEN.md |
Canonical | Keep with test apps |
test-apps/android-test-app/docs/PHASE1_TEST1_GOLDEN.md |
test-apps/android-test-app/docs/PHASE1_TEST1_GOLDEN.md |
Canonical | Keep with test apps |
test-apps/daily-notification-test/docs/BUILD_QUICK_REFERENCE.md |
test-apps/daily-notification-test/docs/BUILD_QUICK_REFERENCE.md |
Canonical | Keep with test apps |
test-apps/daily-notification-test/docs/NOTIFICATION_STACK_IMPROVEMENT_PLAN.md |
test-apps/daily-notification-test/docs/NOTIFICATION_STACK_IMPROVEMENT_PLAN.md |
Canonical | Keep with test apps |
test-apps/daily-notification-test/docs/PLUGIN_DETECTION_GUIDE.md |
test-apps/daily-notification-test/docs/PLUGIN_DETECTION_GUIDE.md |
Canonical | Keep with test apps |
test-apps/daily-notification-test/docs/VUE3_NOTIFICATION_IMPLEMENTATION_GUIDE.md |
test-apps/daily-notification-test/docs/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 docs/00-INDEX.md
Last Updated: 2025-12-16
Status: Complete - Ready for Implementation