From efef06af637a7cc01acf88c1ac54dac953843fba Mon Sep 17 00:00:00 2001 From: Jamie Pine Date: Sat, 11 Oct 2025 11:07:42 -0700 Subject: [PATCH] add dates to docs --- docs/design/EXTENSION_CATALOG.md | 1 + docs/design/EXTENSION_LINEUP_IDEAS.md | 1 + docs/design/EXTENSION_MODELS_FINAL.md | 1 + docs/design/EXTENSION_PRODUCT_CATALOG.md | 1 + docs/design/EXTENSION_SDK_API_VISION.md | 1 + docs/design/MEMO2.md | 1 + docs/design/MEMO3.md | 1 + docs/design/MEMO_PLANNING.md | 1 + docs/design/METADATA_BLOBS_DESIGN.md | 1 + docs/design/MODELS_SCHEMA_FINAL.md | 1 + docs/design/PLATFORM_REVENUE_MODEL.md | 1 + docs/design/SDK_ENHANCEMENTS.md | 1 + docs/design/SDK_SPEC.md | 1 + docs/design/SDK_SPEC_GROUNDED.md | 1 + docs/design/SDK_SYNTAX_REFERENCE.md | 1 + docs/design/VDFS_SDK_AS_LANGUAGE.md | 1 + docs/design/core/ACTIONS_GUIDE.md | 1 + docs/design/core/ACTIONS_REFACTOR.md | 1 + docs/design/core/ACTION_BUILDER_REFACTOR_PLAN.md | 1 + docs/design/core/ACTION_SYSTEM_DESIGN.md | 1 + docs/design/core/API_COMPARISON.md | 1 + docs/design/core/API_DESIGN.md | 1 + docs/design/core/API_INFRASTRUCTURE_REORGANIZATION.md | 1 + docs/design/core/API_MODULE_DESIGN.md | 1 + docs/design/core/ARCHITECTURE_DECISIONS.md | 1 + docs/design/core/AT_REST_LIBRARY_ENCRYPTION.md | 1 + docs/design/core/BENCHMARKING_SUITE_DESIGN.md | 1 + docs/design/core/CLOSURE_TABLE_INDEXING_PROPOSAL.md | 1 + docs/design/core/CROSS_DEVICE_FILE_TRANSFER_IMPLEMENTATION.md | 1 + docs/design/core/CROSS_PLATFORM_COPY_AND_VOLUME_AWARENESS.md | 1 + docs/design/core/DAEMON_REFACTOR.md | 1 + docs/design/core/DESIGN_CORE_LIFECYCLE.md | 1 + docs/design/core/DESIGN_DEVICE_MANAGEMENT.md | 1 + docs/design/core/DESIGN_FILE_DATA_MODEL.md | 1 + docs/design/core/DESIGN_FILE_DATA_MODEL_VISUAL.md | 1 + docs/design/core/DESIGN_FILE_TYPE_SYSTEM.md | 1 + docs/design/core/DESIGN_LIBRARY_IMPLEMENTATION.md | 1 + docs/design/core/DESIGN_LIBRARY_ORGANIZATION.md | 1 + docs/design/core/DESIGN_LIBRARY_ORGANIZATION_VISUAL.md | 1 + docs/design/core/DESIGN_OPTIMIZED_STORAGE.md | 1 + docs/design/core/DESIGN_VDFS_INTEGRATION.md | 1 + docs/design/core/DEVICE_PAIRING_PROTOCOL.md | 1 + docs/design/core/DOMAIN_MODELS_README.md | 1 + docs/design/core/DYNAMIC_TYPE_GENERATION.md | 1 + docs/design/core/EMAIL_INGESTION_EXTENSION_DESIGN.md | 1 + docs/design/core/ENTITY_REFACTOR_DESIGN.md | 1 + docs/design/core/EXTENSION_AGENT_SYSTEM.md | 1 + docs/design/core/EXTENSION_IPC_DESIGN.md | 1 + docs/design/core/EXTENSION_JOBS_AND_ACTIONS.md | 1 + docs/design/core/EXTENSION_JOB_PARITY.md | 1 + docs/design/core/FFMPEG_BUNDLING_DESIGN.md | 1 + docs/design/core/FILE_SHARING_DESIGN.md | 1 + docs/design/core/FS_EVENT_PIPELINE_RESILIENCE.md | 1 + docs/design/core/FUNCTION_BASED_TEST_FRAMEWORK_DESIGN.md | 1 + docs/design/core/IDEA_FOR_BETTER_INDEXING.md | 1 + docs/design/core/IMPLEMENTATION_STATUS.md | 1 + docs/design/core/INDEXER_ANALYSIS.md | 1 + docs/design/core/INDEXER_ANALYSIS_2.md | 1 + docs/design/core/INDEXER_JOB_EXAMPLE.md | 1 + docs/design/core/INDEXER_PROGRESS.md | 1 + docs/design/core/INDEXER_RULES_SYSTEM.md | 1 + docs/design/core/INDEXING_DISCOVERY_OPTIMIZATION_PLAN.md | 1 + docs/design/core/INFRA_LAYER_SEPARATION.md | 1 + docs/design/core/INTEGRATION_SYSTEM_DESIGN.md | 1 + docs/design/core/INTEGRATION_SYSTEM_DESIGN_GEMINI.md | 1 + docs/design/core/IPHONE_AS_VOLUME_DESIGN.md | 1 + docs/design/core/IROH_MIGRATION_DESIGN.md | 1 + docs/design/core/IROH_RELAY_INTEGRATION.md | 1 + docs/design/core/JOB_SYSTEM_DESIGN.md | 1 + docs/design/core/JOB_SYSTEM_MACRO_EXAMPLE.md | 1 + docs/design/core/JOB_SYSTEM_README.md | 1 + docs/design/core/LIBP2P_INTEGRATION_DESIGN.md | 1 + docs/design/core/LIBRARY_LEADERSHIP.md | 1 + docs/design/core/NETWORKING_SYSTEM_DESIGN.md | 1 + docs/design/core/OLD_SPACEDRIVE_ANALYSIS.md | 1 + docs/design/core/OPERATIONS_REFACTOR_PLAN.md | 1 + docs/design/core/PERSISTENT_DEVICE_CONNECTIONS_DESIGN.md | 1 + docs/design/core/QUERY_REFACTOR_PLAN.md | 1 + docs/design/core/REFERENCE_SIDECARS.md | 1 + docs/design/core/RELAY_FLOW_DIAGRAM.md | 1 + docs/design/core/RELAY_INTEGRATION_SUMMARY.md | 1 + docs/design/core/REWRITE_PLAN.MD | 1 + docs/design/core/RSPC_MAGIC_SUCCESS.md | 1 + docs/design/core/SDPATH_REFACTOR.md | 1 + docs/design/core/SDPATH_REFACTOR_COVERAGE.md | 1 + docs/design/core/SEARCH_DESIGN.md | 1 + docs/design/core/SEMANTIC_TAGGING_IMPLEMENTATION.md | 1 + docs/design/core/SIDECAR_SCALING_DESIGN.md | 1 + docs/design/core/SIMULATION_ENGINE_DESIGN.md | 1 + docs/design/core/SPACEDRIVE_COMPLETE_OVERVIEW.md | 1 + docs/design/core/SPACEDROP_DESIGN.md | 1 + docs/design/core/STRUCTURE.md | 1 + docs/design/core/THUMBNAIL_SYSTEM_DESIGN.md | 1 + docs/design/core/TYPESAFE_CLIENT.md | 1 + docs/design/core/UI_DESIGN.md | 1 + docs/design/core/VDFS_MODEL_VISUAL.md | 1 + docs/design/core/VIRTUAL_LOCATIONS_DESIGN.md | 1 + docs/design/core/VIRTUAL_SIDECAR_SYSTEM.md | 1 + docs/design/core/VOLUME_CLASSIFICATION_DESIGN.md | 1 + docs/design/core/VOLUME_TRACKING_IMPLEMENTATION_PLAN.md | 1 + docs/design/core/WATCHER_VDFS_INTEGRATION.md | 1 + docs/design/core/WHITEPAPER_IMPL_ROADMAP.md | 1 + docs/design/core/action-metadata-for-jobs.md | 1 + docs/design/core/agents/AGENT_ARCHITECTURE_ANALYSIS.md | 1 + docs/design/core/agents/CONTEXT_WINDOW_MANAGEMENT_RESEARCH.md | 1 + docs/design/core/cli-output-refactor.md | 1 + docs/design/core/indexer-scope-upgrade.md | 1 + docs/design/core/landing-page-idea.md | 1 + docs/design/core/networking_implementation_summary.md | 1 + docs/design/core/sync/NORMALIZED_CACHE_DESIGN.md | 1 + docs/design/core/sync/README.md | 1 + docs/design/core/sync/SYNC_CONDUIT_DESIGN.md | 1 + docs/design/core/sync/SYNC_DESIGN.md | 1 + docs/design/core/sync/SYNC_DESIGN_2025_08_19.md | 1 + docs/design/core/sync/SYNC_FIRST_DRAFT_DESIGN.md | 1 + docs/design/core/sync/SYNC_INTEGRATION_NOTES.md | 1 + docs/design/core/sync/SYNC_TX_CACHE_MINI_SPEC.md | 1 + docs/design/core/sync/TRANSACTION_MANAGER_COMPATIBILITY.md | 1 + docs/design/core/sync/UNIFIED_RESOURCE_EVENTS.md | 1 + docs/design/core/sync/UNIFIED_TRANSACTIONAL_SYNC_AND_CACHE.md | 1 + docs/design/core/sync/leaderless-architecture.md | 1 + 121 files changed, 121 insertions(+) diff --git a/docs/design/EXTENSION_CATALOG.md b/docs/design/EXTENSION_CATALOG.md index 3fec9c69b..34f787580 100644 --- a/docs/design/EXTENSION_CATALOG.md +++ b/docs/design/EXTENSION_CATALOG.md @@ -1,3 +1,4 @@ + # Spacedrive Extension Catalog **Date:** October 11, 2025 diff --git a/docs/design/EXTENSION_LINEUP_IDEAS.md b/docs/design/EXTENSION_LINEUP_IDEAS.md index 81bd759dc..04a4bc31c 100644 --- a/docs/design/EXTENSION_LINEUP_IDEAS.md +++ b/docs/design/EXTENSION_LINEUP_IDEAS.md @@ -1,3 +1,4 @@ + # Extension Lineup Ideas for November 2025 Launch **Last Updated:** October 10, 2025 diff --git a/docs/design/EXTENSION_MODELS_FINAL.md b/docs/design/EXTENSION_MODELS_FINAL.md index 25da66f85..d813ab5a0 100644 --- a/docs/design/EXTENSION_MODELS_FINAL.md +++ b/docs/design/EXTENSION_MODELS_FINAL.md @@ -1,3 +1,4 @@ + # Extension Models: Final Architecture **Design:** Clean separation with unified tag/collection support. diff --git a/docs/design/EXTENSION_PRODUCT_CATALOG.md b/docs/design/EXTENSION_PRODUCT_CATALOG.md index 67bc4bfbb..638b661b8 100644 --- a/docs/design/EXTENSION_PRODUCT_CATALOG.md +++ b/docs/design/EXTENSION_PRODUCT_CATALOG.md @@ -1,3 +1,4 @@ + # Spacedrive Extensions: Own Your Data, Supercharge Your Workflow **A new ecosystem of applications built on a foundation of privacy, control, and intelligence.** diff --git a/docs/design/EXTENSION_SDK_API_VISION.md b/docs/design/EXTENSION_SDK_API_VISION.md index 52db89ace..c952eada6 100644 --- a/docs/design/EXTENSION_SDK_API_VISION.md +++ b/docs/design/EXTENSION_SDK_API_VISION.md @@ -1,3 +1,4 @@ + # Extension SDK API Vision - The Sexiest API **Goal:** Extension development should feel like magic. Zero boilerplate, maximum clarity. diff --git a/docs/design/MEMO2.md b/docs/design/MEMO2.md index d578d6183..fe8750220 100644 --- a/docs/design/MEMO2.md +++ b/docs/design/MEMO2.md @@ -1,3 +1,4 @@ + # Investor Memo **To:** Spacedrive Seed Investors | **From:** James Pine, Founder | **Date:** October 9, 2025 diff --git a/docs/design/MEMO3.md b/docs/design/MEMO3.md index e985de503..c28356c68 100644 --- a/docs/design/MEMO3.md +++ b/docs/design/MEMO3.md @@ -1,3 +1,4 @@ + # Investor Memo **To:** Spacedrive Seed Investors | **From:** James Pine, Founder | **Date:** October 10, 2025 diff --git a/docs/design/MEMO_PLANNING.md b/docs/design/MEMO_PLANNING.md index 24768ec72..8c256e07c 100644 --- a/docs/design/MEMO_PLANNING.md +++ b/docs/design/MEMO_PLANNING.md @@ -1,3 +1,4 @@ + This memo will be sent to existing Spacedrive investors alongside the codebase, whitepaper, deck and a demo video. We need to refine it. --- diff --git a/docs/design/METADATA_BLOBS_DESIGN.md b/docs/design/METADATA_BLOBS_DESIGN.md index a663f23f1..47dd571d9 100644 --- a/docs/design/METADATA_BLOBS_DESIGN.md +++ b/docs/design/METADATA_BLOBS_DESIGN.md @@ -1,3 +1,4 @@ + # Metadata Blobs: Large Data Storage for VDFS **Problem:** Storing large data (embeddings, large JSON) in `models.data` or `user_metadata.custom_data` bloats queries. diff --git a/docs/design/MODELS_SCHEMA_FINAL.md b/docs/design/MODELS_SCHEMA_FINAL.md index a8535fc32..8b872fa7c 100644 --- a/docs/design/MODELS_SCHEMA_FINAL.md +++ b/docs/design/MODELS_SCHEMA_FINAL.md @@ -1,3 +1,4 @@ + # Extension Models Schema - Final Design **Key Insight:** UserMetadata already supports `content_identity_uuid` scoping! Extension models should use the same pattern. diff --git a/docs/design/PLATFORM_REVENUE_MODEL.md b/docs/design/PLATFORM_REVENUE_MODEL.md index 673eba8c2..d08490e4e 100644 --- a/docs/design/PLATFORM_REVENUE_MODEL.md +++ b/docs/design/PLATFORM_REVENUE_MODEL.md @@ -1,3 +1,4 @@ + # Spacedrive Platform Revenue Model ## The Local-First SaaS Category Killer diff --git a/docs/design/SDK_ENHANCEMENTS.md b/docs/design/SDK_ENHANCEMENTS.md index 856a0ff2c..704f6f0c9 100644 --- a/docs/design/SDK_ENHANCEMENTS.md +++ b/docs/design/SDK_ENHANCEMENTS.md @@ -1,3 +1,4 @@ + # SDK Enhancements & Core Development Alignment **Date:** October 11, 2025 diff --git a/docs/design/SDK_SPEC.md b/docs/design/SDK_SPEC.md index 6b684aaf2..003890d1b 100644 --- a/docs/design/SDK_SPEC.md +++ b/docs/design/SDK_SPEC.md @@ -1,3 +1,4 @@ + Of course. Here is the complete v2.3 specification for the VDFS SDK, integrating all of the concepts we've designed. This document is intended to be the definitive guide for implementation. ```rust diff --git a/docs/design/SDK_SPEC_GROUNDED.md b/docs/design/SDK_SPEC_GROUNDED.md index dca1820dd..fe99cd850 100644 --- a/docs/design/SDK_SPEC_GROUNDED.md +++ b/docs/design/SDK_SPEC_GROUNDED.md @@ -1,3 +1,4 @@ + # VDFS SDK Specification (Grounded in Spacedrive Core) **Version:** 3.0 diff --git a/docs/design/SDK_SYNTAX_REFERENCE.md b/docs/design/SDK_SYNTAX_REFERENCE.md index 49d1a803c..04c9d4474 100644 --- a/docs/design/SDK_SYNTAX_REFERENCE.md +++ b/docs/design/SDK_SYNTAX_REFERENCE.md @@ -1,3 +1,4 @@ + # VDFS SDK Syntax Specification & Finalized Design **Version:** 2.0 diff --git a/docs/design/VDFS_SDK_AS_LANGUAGE.md b/docs/design/VDFS_SDK_AS_LANGUAGE.md index 755d3d6ff..6ade7bf6d 100644 --- a/docs/design/VDFS_SDK_AS_LANGUAGE.md +++ b/docs/design/VDFS_SDK_AS_LANGUAGE.md @@ -1,3 +1,4 @@ + # VDFS SDK as Programming Language ## The Distributed Computing Primitive for the AI Era diff --git a/docs/design/core/ACTIONS_GUIDE.md b/docs/design/core/ACTIONS_GUIDE.md index e00ac0208..3444f44a7 100644 --- a/docs/design/core/ACTIONS_GUIDE.md +++ b/docs/design/core/ACTIONS_GUIDE.md @@ -1,3 +1,4 @@ + ## Spacedrive Actions: Architecture and Authoring Guide This document explains the current Action System in `sd-core`, how actions are discovered and dispatched, how inputs/outputs are shaped, how domain paths (`SdPath`, `SdPathBatch`) are used, and how to add new actions consistently. diff --git a/docs/design/core/ACTIONS_REFACTOR.md b/docs/design/core/ACTIONS_REFACTOR.md index 11045c053..8dfe9c158 100644 --- a/docs/design/core/ACTIONS_REFACTOR.md +++ b/docs/design/core/ACTIONS_REFACTOR.md @@ -1,3 +1,4 @@ + # CLI Daemon Actions Refactoring Design Document ## Overview diff --git a/docs/design/core/ACTION_BUILDER_REFACTOR_PLAN.md b/docs/design/core/ACTION_BUILDER_REFACTOR_PLAN.md index 116e707d6..a028eb3a3 100644 --- a/docs/design/core/ACTION_BUILDER_REFACTOR_PLAN.md +++ b/docs/design/core/ACTION_BUILDER_REFACTOR_PLAN.md @@ -1,3 +1,4 @@ + # Action Builder Pattern Refactor Plan ## Overview diff --git a/docs/design/core/ACTION_SYSTEM_DESIGN.md b/docs/design/core/ACTION_SYSTEM_DESIGN.md index 71e542ced..c9ac3eed8 100644 --- a/docs/design/core/ACTION_SYSTEM_DESIGN.md +++ b/docs/design/core/ACTION_SYSTEM_DESIGN.md @@ -1,3 +1,4 @@ + Of course. Here is the revised design document, incorporating the more modular Action Handler pattern and a clear explanation of how parameters are passed into the system. --- diff --git a/docs/design/core/API_COMPARISON.md b/docs/design/core/API_COMPARISON.md index 6e1caecc4..29706af19 100644 --- a/docs/design/core/API_COMPARISON.md +++ b/docs/design/core/API_COMPARISON.md @@ -1,3 +1,4 @@ + # GraphQL API with async-graphql Spacedrive's new API uses GraphQL with full type safety from Rust to TypeScript. diff --git a/docs/design/core/API_DESIGN.md b/docs/design/core/API_DESIGN.md index 8419d49b6..d5072eeb2 100644 --- a/docs/design/core/API_DESIGN.md +++ b/docs/design/core/API_DESIGN.md @@ -1,3 +1,4 @@ + # Design Doc: Spacedrive Architecture v2 **Authors:** Gemini, jamespine diff --git a/docs/design/core/API_INFRASTRUCTURE_REORGANIZATION.md b/docs/design/core/API_INFRASTRUCTURE_REORGANIZATION.md index 8ea1f7cf3..c78ec1ab0 100644 --- a/docs/design/core/API_INFRASTRUCTURE_REORGANIZATION.md +++ b/docs/design/core/API_INFRASTRUCTURE_REORGANIZATION.md @@ -1,3 +1,4 @@ + # API Infrastructure Reorganization **Status**: RFC / Design Document diff --git a/docs/design/core/API_MODULE_DESIGN.md b/docs/design/core/API_MODULE_DESIGN.md index a60b5a14f..380da1c11 100644 --- a/docs/design/core/API_MODULE_DESIGN.md +++ b/docs/design/core/API_MODULE_DESIGN.md @@ -1,3 +1,4 @@ + # API Module Design: Unified Entry Point & Permission Layer ## Problem Analysis diff --git a/docs/design/core/ARCHITECTURE_DECISIONS.md b/docs/design/core/ARCHITECTURE_DECISIONS.md index c13006528..1b7085b21 100644 --- a/docs/design/core/ARCHITECTURE_DECISIONS.md +++ b/docs/design/core/ARCHITECTURE_DECISIONS.md @@ -1,3 +1,4 @@ + # Architecture Decision Records ## ADR-000: SdPath as Core Abstraction diff --git a/docs/design/core/AT_REST_LIBRARY_ENCRYPTION.md b/docs/design/core/AT_REST_LIBRARY_ENCRYPTION.md index a24f6a540..2ac3197dd 100644 --- a/docs/design/core/AT_REST_LIBRARY_ENCRYPTION.md +++ b/docs/design/core/AT_REST_LIBRARY_ENCRYPTION.md @@ -1,3 +1,4 @@ + Of course. Here is a complete implementation guide in Markdown format that incorporates the whitepaper's requirements, the new configuration setting, and a detailed plan for implementation. --- diff --git a/docs/design/core/BENCHMARKING_SUITE_DESIGN.md b/docs/design/core/BENCHMARKING_SUITE_DESIGN.md index 050a86a5b..f5f67ad40 100644 --- a/docs/design/core/BENCHMARKING_SUITE_DESIGN.md +++ b/docs/design/core/BENCHMARKING_SUITE_DESIGN.md @@ -1,3 +1,4 @@ + ### Spacedrive Benchmarking Suite — Design Document Author: Core Team diff --git a/docs/design/core/CLOSURE_TABLE_INDEXING_PROPOSAL.md b/docs/design/core/CLOSURE_TABLE_INDEXING_PROPOSAL.md index ae79d9d8d..02b24461d 100644 --- a/docs/design/core/CLOSURE_TABLE_INDEXING_PROPOSAL.md +++ b/docs/design/core/CLOSURE_TABLE_INDEXING_PROPOSAL.md @@ -1,3 +1,4 @@ + '''# Closure Table Indexing Proposal for Spacedrive ## Executive Summary diff --git a/docs/design/core/CROSS_DEVICE_FILE_TRANSFER_IMPLEMENTATION.md b/docs/design/core/CROSS_DEVICE_FILE_TRANSFER_IMPLEMENTATION.md index 2619d14f7..ddbf4d7d3 100644 --- a/docs/design/core/CROSS_DEVICE_FILE_TRANSFER_IMPLEMENTATION.md +++ b/docs/design/core/CROSS_DEVICE_FILE_TRANSFER_IMPLEMENTATION.md @@ -1,3 +1,4 @@ + # Cross-Device File Transfer Implementation ## Overview diff --git a/docs/design/core/CROSS_PLATFORM_COPY_AND_VOLUME_AWARENESS.md b/docs/design/core/CROSS_PLATFORM_COPY_AND_VOLUME_AWARENESS.md index dbbe1b58c..f96ce3d26 100644 --- a/docs/design/core/CROSS_PLATFORM_COPY_AND_VOLUME_AWARENESS.md +++ b/docs/design/core/CROSS_PLATFORM_COPY_AND_VOLUME_AWARENESS.md @@ -1,3 +1,4 @@ + # Cross-Platform Copy Operations & Volume Awareness ## Overview diff --git a/docs/design/core/DAEMON_REFACTOR.md b/docs/design/core/DAEMON_REFACTOR.md index da3602d2b..a31dac0d7 100644 --- a/docs/design/core/DAEMON_REFACTOR.md +++ b/docs/design/core/DAEMON_REFACTOR.md @@ -1,3 +1,4 @@ + # Daemon Refactoring Design Document ## Overview diff --git a/docs/design/core/DESIGN_CORE_LIFECYCLE.md b/docs/design/core/DESIGN_CORE_LIFECYCLE.md index 40eb50a5a..e684f5a7d 100644 --- a/docs/design/core/DESIGN_CORE_LIFECYCLE.md +++ b/docs/design/core/DESIGN_CORE_LIFECYCLE.md @@ -1,3 +1,4 @@ + # Core Lifecycle Design ## Overview diff --git a/docs/design/core/DESIGN_DEVICE_MANAGEMENT.md b/docs/design/core/DESIGN_DEVICE_MANAGEMENT.md index 86f5011e8..e56e1716c 100644 --- a/docs/design/core/DESIGN_DEVICE_MANAGEMENT.md +++ b/docs/design/core/DESIGN_DEVICE_MANAGEMENT.md @@ -1,3 +1,4 @@ + # Device Management Design ## Overview diff --git a/docs/design/core/DESIGN_FILE_DATA_MODEL.md b/docs/design/core/DESIGN_FILE_DATA_MODEL.md index 93aadffa2..b01bd3aee 100644 --- a/docs/design/core/DESIGN_FILE_DATA_MODEL.md +++ b/docs/design/core/DESIGN_FILE_DATA_MODEL.md @@ -1,3 +1,4 @@ + # Spacedrive File Data Model Design (v2) ## Overview diff --git a/docs/design/core/DESIGN_FILE_DATA_MODEL_VISUAL.md b/docs/design/core/DESIGN_FILE_DATA_MODEL_VISUAL.md index 0f44dc6f3..0aa773275 100644 --- a/docs/design/core/DESIGN_FILE_DATA_MODEL_VISUAL.md +++ b/docs/design/core/DESIGN_FILE_DATA_MODEL_VISUAL.md @@ -1,3 +1,4 @@ + # File Data Model - Visual Comparison ## Old Model (v1) - Current Spacedrive diff --git a/docs/design/core/DESIGN_FILE_TYPE_SYSTEM.md b/docs/design/core/DESIGN_FILE_TYPE_SYSTEM.md index 57c153fc3..9f6f075cd 100644 --- a/docs/design/core/DESIGN_FILE_TYPE_SYSTEM.md +++ b/docs/design/core/DESIGN_FILE_TYPE_SYSTEM.md @@ -1,3 +1,4 @@ + # File Type System A modern, extensible file type identification system for Spacedrive. diff --git a/docs/design/core/DESIGN_LIBRARY_IMPLEMENTATION.md b/docs/design/core/DESIGN_LIBRARY_IMPLEMENTATION.md index 9934799af..339f0509c 100644 --- a/docs/design/core/DESIGN_LIBRARY_IMPLEMENTATION.md +++ b/docs/design/core/DESIGN_LIBRARY_IMPLEMENTATION.md @@ -1,3 +1,4 @@ + # Library Organization - Implementation Guide ## Core Types diff --git a/docs/design/core/DESIGN_LIBRARY_ORGANIZATION.md b/docs/design/core/DESIGN_LIBRARY_ORGANIZATION.md index ebee0fa05..0ff473a85 100644 --- a/docs/design/core/DESIGN_LIBRARY_ORGANIZATION.md +++ b/docs/design/core/DESIGN_LIBRARY_ORGANIZATION.md @@ -1,3 +1,4 @@ + # Library Data Organization Design ## Current Problems diff --git a/docs/design/core/DESIGN_LIBRARY_ORGANIZATION_VISUAL.md b/docs/design/core/DESIGN_LIBRARY_ORGANIZATION_VISUAL.md index 9687ec5c1..f842eb10a 100644 --- a/docs/design/core/DESIGN_LIBRARY_ORGANIZATION_VISUAL.md +++ b/docs/design/core/DESIGN_LIBRARY_ORGANIZATION_VISUAL.md @@ -1,3 +1,4 @@ + # Library Organization - Visual Comparison ## Current (v1) - Scattered Organization diff --git a/docs/design/core/DESIGN_OPTIMIZED_STORAGE.md b/docs/design/core/DESIGN_OPTIMIZED_STORAGE.md index 18655f0c7..424e5c46e 100644 --- a/docs/design/core/DESIGN_OPTIMIZED_STORAGE.md +++ b/docs/design/core/DESIGN_OPTIMIZED_STORAGE.md @@ -1,3 +1,4 @@ + # Storage Design ## Problem Statement diff --git a/docs/design/core/DESIGN_VDFS_INTEGRATION.md b/docs/design/core/DESIGN_VDFS_INTEGRATION.md index baa378b9b..4515e4399 100644 --- a/docs/design/core/DESIGN_VDFS_INTEGRATION.md +++ b/docs/design/core/DESIGN_VDFS_INTEGRATION.md @@ -1,3 +1,4 @@ + # Virtual Distributed File System - Integration Design ## How SdPath and the New Data Model Enable True VDFS diff --git a/docs/design/core/DEVICE_PAIRING_PROTOCOL.md b/docs/design/core/DEVICE_PAIRING_PROTOCOL.md index 05e1cdcf7..c1f427b18 100644 --- a/docs/design/core/DEVICE_PAIRING_PROTOCOL.md +++ b/docs/design/core/DEVICE_PAIRING_PROTOCOL.md @@ -1,3 +1,4 @@ + # Spacedrive Device Pairing Protocol Design ## Overview diff --git a/docs/design/core/DOMAIN_MODELS_README.md b/docs/design/core/DOMAIN_MODELS_README.md index 1be3710e2..87be1da7c 100644 --- a/docs/design/core/DOMAIN_MODELS_README.md +++ b/docs/design/core/DOMAIN_MODELS_README.md @@ -1,3 +1,4 @@ + # Domain Models The domain layer contains the core business entities that power Spacedrive's Virtual Distributed File System (VDFS). diff --git a/docs/design/core/DYNAMIC_TYPE_GENERATION.md b/docs/design/core/DYNAMIC_TYPE_GENERATION.md index 3de2cc91c..f8105be49 100644 --- a/docs/design/core/DYNAMIC_TYPE_GENERATION.md +++ b/docs/design/core/DYNAMIC_TYPE_GENERATION.md @@ -1,3 +1,4 @@ + # Dynamic Type Generation: The rspc Magic Applied to Spacedrive ## Overview diff --git a/docs/design/core/EMAIL_INGESTION_EXTENSION_DESIGN.md b/docs/design/core/EMAIL_INGESTION_EXTENSION_DESIGN.md index 3a67374bb..edbaa60ca 100644 --- a/docs/design/core/EMAIL_INGESTION_EXTENSION_DESIGN.md +++ b/docs/design/core/EMAIL_INGESTION_EXTENSION_DESIGN.md @@ -1,3 +1,4 @@ + # Email Ingestion Extension: Technical Design & Prototype ## Executive Summary diff --git a/docs/design/core/ENTITY_REFACTOR_DESIGN.md b/docs/design/core/ENTITY_REFACTOR_DESIGN.md index 0d40957c9..298556738 100644 --- a/docs/design/core/ENTITY_REFACTOR_DESIGN.md +++ b/docs/design/core/ENTITY_REFACTOR_DESIGN.md @@ -1,3 +1,4 @@ + # Entity Refactor Design: Library-Scoped ContentIdentity & Hierarchical Metadata ## Overview diff --git a/docs/design/core/EXTENSION_AGENT_SYSTEM.md b/docs/design/core/EXTENSION_AGENT_SYSTEM.md index 85c514aeb..219f2f974 100644 --- a/docs/design/core/EXTENSION_AGENT_SYSTEM.md +++ b/docs/design/core/EXTENSION_AGENT_SYSTEM.md @@ -1,3 +1,4 @@ + # Extension Agent System Design **Version:** 1.0 diff --git a/docs/design/core/EXTENSION_IPC_DESIGN.md b/docs/design/core/EXTENSION_IPC_DESIGN.md index 230e81920..4a0dcb176 100644 --- a/docs/design/core/EXTENSION_IPC_DESIGN.md +++ b/docs/design/core/EXTENSION_IPC_DESIGN.md @@ -1,3 +1,4 @@ + # WASM Extension Architecture: Leveraging Existing Operation Registry ## TL;DR diff --git a/docs/design/core/EXTENSION_JOBS_AND_ACTIONS.md b/docs/design/core/EXTENSION_JOBS_AND_ACTIONS.md index f258bd6cb..65984371b 100644 --- a/docs/design/core/EXTENSION_JOBS_AND_ACTIONS.md +++ b/docs/design/core/EXTENSION_JOBS_AND_ACTIONS.md @@ -1,3 +1,4 @@ + # Extension-Defined Jobs and Actions **Question:** How can WASM extensions register their own custom jobs and actions, not just call existing ones? diff --git a/docs/design/core/EXTENSION_JOB_PARITY.md b/docs/design/core/EXTENSION_JOB_PARITY.md index 95c06aae9..d41cde139 100644 --- a/docs/design/core/EXTENSION_JOB_PARITY.md +++ b/docs/design/core/EXTENSION_JOB_PARITY.md @@ -1,3 +1,4 @@ + # Extension Job System Parity **Question:** Can extensions do everything core jobs can? (Progress, checkpoints, child jobs, metrics, etc.) diff --git a/docs/design/core/FFMPEG_BUNDLING_DESIGN.md b/docs/design/core/FFMPEG_BUNDLING_DESIGN.md index 863ddd7a5..aabc944e5 100644 --- a/docs/design/core/FFMPEG_BUNDLING_DESIGN.md +++ b/docs/design/core/FFMPEG_BUNDLING_DESIGN.md @@ -1,3 +1,4 @@ + # FFmpeg Bundling Design for core ## Executive Summary diff --git a/docs/design/core/FILE_SHARING_DESIGN.md b/docs/design/core/FILE_SHARING_DESIGN.md index 8b3492294..ef2bc68dc 100644 --- a/docs/design/core/FILE_SHARING_DESIGN.md +++ b/docs/design/core/FILE_SHARING_DESIGN.md @@ -1,3 +1,4 @@ + # Spacedrive File Sharing Design ## Overview diff --git a/docs/design/core/FS_EVENT_PIPELINE_RESILIENCE.md b/docs/design/core/FS_EVENT_PIPELINE_RESILIENCE.md index 4ee79b7ef..785a83984 100644 --- a/docs/design/core/FS_EVENT_PIPELINE_RESILIENCE.md +++ b/docs/design/core/FS_EVENT_PIPELINE_RESILIENCE.md @@ -1,3 +1,4 @@ + ## FS Event Pipeline Resilience and Correctness (Large Bursts) ### Goals diff --git a/docs/design/core/FUNCTION_BASED_TEST_FRAMEWORK_DESIGN.md b/docs/design/core/FUNCTION_BASED_TEST_FRAMEWORK_DESIGN.md index 1b75678cb..e98aea47c 100644 --- a/docs/design/core/FUNCTION_BASED_TEST_FRAMEWORK_DESIGN.md +++ b/docs/design/core/FUNCTION_BASED_TEST_FRAMEWORK_DESIGN.md @@ -1,3 +1,4 @@ + # Cargo Test Subprocess Framework Design ## Overview diff --git a/docs/design/core/IDEA_FOR_BETTER_INDEXING.md b/docs/design/core/IDEA_FOR_BETTER_INDEXING.md index a51ff703d..8db6b9689 100644 --- a/docs/design/core/IDEA_FOR_BETTER_INDEXING.md +++ b/docs/design/core/IDEA_FOR_BETTER_INDEXING.md @@ -1,3 +1,4 @@ + Currently the indexer will run on a location when it is added, populating the database. The location watcher will run on startup and watch for OS events to atomically update the index. The user can also explicitly re-index a location or path of a location at anytime. However this is not ideal, since Spacedrive going offline for a period would mean it to be impossible to know about changes within a location during that period. One method to solve this would be to detect offline periods and mark locations as stale, triggering a reindex, or just dispatch those re-indexing jobs upon detection of an offline period. This however would be pretty intensive for users with lots of large locations should Spacedrive go offline. I believe locations should have a last index timestamp at least. diff --git a/docs/design/core/IMPLEMENTATION_STATUS.md b/docs/design/core/IMPLEMENTATION_STATUS.md index 2943cc294..f94a09fba 100644 --- a/docs/design/core/IMPLEMENTATION_STATUS.md +++ b/docs/design/core/IMPLEMENTATION_STATUS.md @@ -1,3 +1,4 @@ + # Implementation Status ## Completed diff --git a/docs/design/core/INDEXER_ANALYSIS.md b/docs/design/core/INDEXER_ANALYSIS.md index cf07b227e..35abbded4 100644 --- a/docs/design/core/INDEXER_ANALYSIS.md +++ b/docs/design/core/INDEXER_ANALYSIS.md @@ -1,3 +1,4 @@ + # Spacedrive Indexer Analysis ## Overview diff --git a/docs/design/core/INDEXER_ANALYSIS_2.md b/docs/design/core/INDEXER_ANALYSIS_2.md index 61c263f9c..1c0205ede 100644 --- a/docs/design/core/INDEXER_ANALYSIS_2.md +++ b/docs/design/core/INDEXER_ANALYSIS_2.md @@ -1,3 +1,4 @@ + # Deep Analysis of Original Spacedrive Indexer vs New Implementation ## Executive Summary diff --git a/docs/design/core/INDEXER_JOB_EXAMPLE.md b/docs/design/core/INDEXER_JOB_EXAMPLE.md index ba29827d2..79c869be0 100644 --- a/docs/design/core/INDEXER_JOB_EXAMPLE.md +++ b/docs/design/core/INDEXER_JOB_EXAMPLE.md @@ -1,3 +1,4 @@ + # Indexer Job Implementation Example This document shows how the complex indexer job would be implemented using the new job system, demonstrating how it handles state machines, resumability, and progress reporting. diff --git a/docs/design/core/INDEXER_PROGRESS.md b/docs/design/core/INDEXER_PROGRESS.md index 683721465..76ee5a7c9 100644 --- a/docs/design/core/INDEXER_PROGRESS.md +++ b/docs/design/core/INDEXER_PROGRESS.md @@ -1,3 +1,4 @@ + # Indexer Implementation Progress Last Updated: 2025-06-19 diff --git a/docs/design/core/INDEXER_RULES_SYSTEM.md b/docs/design/core/INDEXER_RULES_SYSTEM.md index bd5b23a28..60d468fab 100644 --- a/docs/design/core/INDEXER_RULES_SYSTEM.md +++ b/docs/design/core/INDEXER_RULES_SYSTEM.md @@ -1,3 +1,4 @@ + # Indexer Rules System Design ## Overview diff --git a/docs/design/core/INDEXING_DISCOVERY_OPTIMIZATION_PLAN.md b/docs/design/core/INDEXING_DISCOVERY_OPTIMIZATION_PLAN.md index 377418555..6a63b5a31 100644 --- a/docs/design/core/INDEXING_DISCOVERY_OPTIMIZATION_PLAN.md +++ b/docs/design/core/INDEXING_DISCOVERY_OPTIMIZATION_PLAN.md @@ -1,3 +1,4 @@ + ### Indexing Discovery Throughput Plan Author: Core Team diff --git a/docs/design/core/INFRA_LAYER_SEPARATION.md b/docs/design/core/INFRA_LAYER_SEPARATION.md index eb1785db9..e526616b5 100644 --- a/docs/design/core/INFRA_LAYER_SEPARATION.md +++ b/docs/design/core/INFRA_LAYER_SEPARATION.md @@ -1,3 +1,4 @@ + # Infrastructure Layer Separation of Concerns **Status**: RFC / Design Document diff --git a/docs/design/core/INTEGRATION_SYSTEM_DESIGN.md b/docs/design/core/INTEGRATION_SYSTEM_DESIGN.md index 9d30af748..41299862d 100644 --- a/docs/design/core/INTEGRATION_SYSTEM_DESIGN.md +++ b/docs/design/core/INTEGRATION_SYSTEM_DESIGN.md @@ -1,3 +1,4 @@ + # Integration System Design ## Overview diff --git a/docs/design/core/INTEGRATION_SYSTEM_DESIGN_GEMINI.md b/docs/design/core/INTEGRATION_SYSTEM_DESIGN_GEMINI.md index da60f0e58..c75ab4c1e 100644 --- a/docs/design/core/INTEGRATION_SYSTEM_DESIGN_GEMINI.md +++ b/docs/design/core/INTEGRATION_SYSTEM_DESIGN_GEMINI.md @@ -1,3 +1,4 @@ + # Spacedrive v2: Integration System Design (Revised) ## Overview diff --git a/docs/design/core/IPHONE_AS_VOLUME_DESIGN.md b/docs/design/core/IPHONE_AS_VOLUME_DESIGN.md index 309829851..f0da95173 100644 --- a/docs/design/core/IPHONE_AS_VOLUME_DESIGN.md +++ b/docs/design/core/IPHONE_AS_VOLUME_DESIGN.md @@ -1,3 +1,4 @@ + # Design Document: iPhone as a Volume for Direct Import ## 1. Overview diff --git a/docs/design/core/IROH_MIGRATION_DESIGN.md b/docs/design/core/IROH_MIGRATION_DESIGN.md index 11e082fd7..ca83930ec 100644 --- a/docs/design/core/IROH_MIGRATION_DESIGN.md +++ b/docs/design/core/IROH_MIGRATION_DESIGN.md @@ -1,3 +1,4 @@ + # Spacedrive Networking: libp2p to Iroh Migration Design ## Executive Summary diff --git a/docs/design/core/IROH_RELAY_INTEGRATION.md b/docs/design/core/IROH_RELAY_INTEGRATION.md index f2aa76889..858c219cb 100644 --- a/docs/design/core/IROH_RELAY_INTEGRATION.md +++ b/docs/design/core/IROH_RELAY_INTEGRATION.md @@ -1,3 +1,4 @@ + # Iroh Relay Integration for Spacedrive **Author:** AI Assistant diff --git a/docs/design/core/JOB_SYSTEM_DESIGN.md b/docs/design/core/JOB_SYSTEM_DESIGN.md index 71f68c526..23225e7eb 100644 --- a/docs/design/core/JOB_SYSTEM_DESIGN.md +++ b/docs/design/core/JOB_SYSTEM_DESIGN.md @@ -1,3 +1,4 @@ + # Spacedrive Job System Design v2 ## Executive Summary diff --git a/docs/design/core/JOB_SYSTEM_MACRO_EXAMPLE.md b/docs/design/core/JOB_SYSTEM_MACRO_EXAMPLE.md index 169821b67..149f9eec7 100644 --- a/docs/design/core/JOB_SYSTEM_MACRO_EXAMPLE.md +++ b/docs/design/core/JOB_SYSTEM_MACRO_EXAMPLE.md @@ -1,3 +1,4 @@ + # Job System Macro Implementation Example This document shows what the `#[derive(Job)]` macro generates under the hood, demonstrating how we achieve minimal boilerplate. diff --git a/docs/design/core/JOB_SYSTEM_README.md b/docs/design/core/JOB_SYSTEM_README.md index c86fbc2a2..d3cb2c122 100644 --- a/docs/design/core/JOB_SYSTEM_README.md +++ b/docs/design/core/JOB_SYSTEM_README.md @@ -1,3 +1,4 @@ + # Spacedrive Job System v2 ## Overview diff --git a/docs/design/core/LIBP2P_INTEGRATION_DESIGN.md b/docs/design/core/LIBP2P_INTEGRATION_DESIGN.md index 063acd7ed..7b7062764 100644 --- a/docs/design/core/LIBP2P_INTEGRATION_DESIGN.md +++ b/docs/design/core/LIBP2P_INTEGRATION_DESIGN.md @@ -1,3 +1,4 @@ + # Spacedrive libp2p Integration Design Document **Version:** 1.0 diff --git a/docs/design/core/LIBRARY_LEADERSHIP.md b/docs/design/core/LIBRARY_LEADERSHIP.md index a30a5e26a..5f9e1a7de 100644 --- a/docs/design/core/LIBRARY_LEADERSHIP.md +++ b/docs/design/core/LIBRARY_LEADERSHIP.md @@ -1,3 +1,4 @@ + Spacedrive Core v2: Sync Leadership & Key Exchange Protocol Date: June 27, 2025 Status: Proposed Design diff --git a/docs/design/core/NETWORKING_SYSTEM_DESIGN.md b/docs/design/core/NETWORKING_SYSTEM_DESIGN.md index 459b26915..53721813e 100644 --- a/docs/design/core/NETWORKING_SYSTEM_DESIGN.md +++ b/docs/design/core/NETWORKING_SYSTEM_DESIGN.md @@ -1,3 +1,4 @@ + # Networking System Design ## Overview diff --git a/docs/design/core/OLD_SPACEDRIVE_ANALYSIS.md b/docs/design/core/OLD_SPACEDRIVE_ANALYSIS.md index 1e76fd5b6..8270c035e 100644 --- a/docs/design/core/OLD_SPACEDRIVE_ANALYSIS.md +++ b/docs/design/core/OLD_SPACEDRIVE_ANALYSIS.md @@ -1,3 +1,4 @@ + # Spacedrive Technical Analysis & Revival Strategy ## Executive Summary diff --git a/docs/design/core/OPERATIONS_REFACTOR_PLAN.md b/docs/design/core/OPERATIONS_REFACTOR_PLAN.md index b19ab7ebd..78cd3d821 100644 --- a/docs/design/core/OPERATIONS_REFACTOR_PLAN.md +++ b/docs/design/core/OPERATIONS_REFACTOR_PLAN.md @@ -1,3 +1,4 @@ + # Operations Module Refactor Plan ## Current Problems diff --git a/docs/design/core/PERSISTENT_DEVICE_CONNECTIONS_DESIGN.md b/docs/design/core/PERSISTENT_DEVICE_CONNECTIONS_DESIGN.md index e33e04339..43d816b69 100644 --- a/docs/design/core/PERSISTENT_DEVICE_CONNECTIONS_DESIGN.md +++ b/docs/design/core/PERSISTENT_DEVICE_CONNECTIONS_DESIGN.md @@ -1,3 +1,4 @@ + # Persistent Device Connections Design **Version:** 1.0 diff --git a/docs/design/core/QUERY_REFACTOR_PLAN.md b/docs/design/core/QUERY_REFACTOR_PLAN.md index b46ce73ae..67c06e661 100644 --- a/docs/design/core/QUERY_REFACTOR_PLAN.md +++ b/docs/design/core/QUERY_REFACTOR_PLAN.md @@ -1,3 +1,4 @@ + # Query Architecture Refactor Plan ## Goal: Consistent Input/Output Pattern for Queries diff --git a/docs/design/core/REFERENCE_SIDECARS.md b/docs/design/core/REFERENCE_SIDECARS.md index 0e329145d..810644bb8 100644 --- a/docs/design/core/REFERENCE_SIDECARS.md +++ b/docs/design/core/REFERENCE_SIDECARS.md @@ -1,3 +1,4 @@ + # Reference Sidecars Implementation This document describes the reference sidecar feature added to the Virtual Sidecar System (VSS). diff --git a/docs/design/core/RELAY_FLOW_DIAGRAM.md b/docs/design/core/RELAY_FLOW_DIAGRAM.md index 677a31356..fe0a3887a 100644 --- a/docs/design/core/RELAY_FLOW_DIAGRAM.md +++ b/docs/design/core/RELAY_FLOW_DIAGRAM.md @@ -1,3 +1,4 @@ + # Relay Integration Flow Diagrams ## Current State: mDNS-Only Pairing diff --git a/docs/design/core/RELAY_INTEGRATION_SUMMARY.md b/docs/design/core/RELAY_INTEGRATION_SUMMARY.md index 066679503..54a1d6580 100644 --- a/docs/design/core/RELAY_INTEGRATION_SUMMARY.md +++ b/docs/design/core/RELAY_INTEGRATION_SUMMARY.md @@ -1,3 +1,4 @@ + # Iroh Relay Integration - Quick Summary ## TL;DR diff --git a/docs/design/core/REWRITE_PLAN.MD b/docs/design/core/REWRITE_PLAN.MD index eda353896..3dab01a5b 100644 --- a/docs/design/core/REWRITE_PLAN.MD +++ b/docs/design/core/REWRITE_PLAN.MD @@ -1,3 +1,4 @@ + # Spacedrive Rewrite: From Complexity to Clarity ## What is Spacedrive? diff --git a/docs/design/core/RSPC_MAGIC_SUCCESS.md b/docs/design/core/RSPC_MAGIC_SUCCESS.md index aee99e4c3..055749114 100644 --- a/docs/design/core/RSPC_MAGIC_SUCCESS.md +++ b/docs/design/core/RSPC_MAGIC_SUCCESS.md @@ -1,3 +1,4 @@ + # RSPC Magic Implementation: SUCCESS! ## Breakthrough Achieved diff --git a/docs/design/core/SDPATH_REFACTOR.md b/docs/design/core/SDPATH_REFACTOR.md index 4edf0d39a..2d24194ae 100644 --- a/docs/design/core/SDPATH_REFACTOR.md +++ b/docs/design/core/SDPATH_REFACTOR.md @@ -1,3 +1,4 @@ + Of course. The whitepaper indeed specifies a more powerful, dual-mode `SdPath` that is crucial for enabling resilient and intelligent file operations. The current implementation in the codebase represents only the physical addressing portion of that vision. Here is a design document detailing the refactor required to align the `SdPath` implementation with the whitepaper's architecture. diff --git a/docs/design/core/SDPATH_REFACTOR_COVERAGE.md b/docs/design/core/SDPATH_REFACTOR_COVERAGE.md index 89a7393e7..2168afe1e 100644 --- a/docs/design/core/SDPATH_REFACTOR_COVERAGE.md +++ b/docs/design/core/SDPATH_REFACTOR_COVERAGE.md @@ -1,3 +1,4 @@ + # Guidance for SdPath Refactoring This document provides a comprehensive guide for refactoring existing `PathBuf` usages to `SdPath` throughout the Spacedrive codebase. The goal is to fully leverage `SdPath`'s content-addressing and cross-device capabilities, ensuring consistency, resilience, and future extensibility of file operations. diff --git a/docs/design/core/SEARCH_DESIGN.md b/docs/design/core/SEARCH_DESIGN.md index 96607a2cd..ece3cc09b 100644 --- a/docs/design/core/SEARCH_DESIGN.md +++ b/docs/design/core/SEARCH_DESIGN.md @@ -1,3 +1,4 @@ + # Lightning Search: Next-Generation File Discovery for Spacedrive Note: in recent versions of the whitepaper we now refer to search as "Temporal-Sematic Search", or simply just "search". diff --git a/docs/design/core/SEMANTIC_TAGGING_IMPLEMENTATION.md b/docs/design/core/SEMANTIC_TAGGING_IMPLEMENTATION.md index 09ea68f81..375b2f39a 100644 --- a/docs/design/core/SEMANTIC_TAGGING_IMPLEMENTATION.md +++ b/docs/design/core/SEMANTIC_TAGGING_IMPLEMENTATION.md @@ -1,3 +1,4 @@ + # Semantic Tagging Architecture Implementation ## Overview diff --git a/docs/design/core/SIDECAR_SCALING_DESIGN.md b/docs/design/core/SIDECAR_SCALING_DESIGN.md index 2fd4217ab..fdc685e58 100644 --- a/docs/design/core/SIDECAR_SCALING_DESIGN.md +++ b/docs/design/core/SIDECAR_SCALING_DESIGN.md @@ -1,3 +1,4 @@ + # Sidecar Scaling Design **Status**: Draft diff --git a/docs/design/core/SIMULATION_ENGINE_DESIGN.md b/docs/design/core/SIMULATION_ENGINE_DESIGN.md index 9bfaafac5..943d22d32 100644 --- a/docs/design/core/SIMULATION_ENGINE_DESIGN.md +++ b/docs/design/core/SIMULATION_ENGINE_DESIGN.md @@ -1,3 +1,4 @@ + Of course. Based on a thorough review of the Spacedrive whitepaper and the provided Rust codebase, here is a detailed design document for the Simulation Engine. This design aims for a clean, non-disruptive integration that leverages the existing architectural patterns. --- diff --git a/docs/design/core/SPACEDRIVE_COMPLETE_OVERVIEW.md b/docs/design/core/SPACEDRIVE_COMPLETE_OVERVIEW.md index 5ec9b3b36..3e9f4488b 100644 --- a/docs/design/core/SPACEDRIVE_COMPLETE_OVERVIEW.md +++ b/docs/design/core/SPACEDRIVE_COMPLETE_OVERVIEW.md @@ -1,3 +1,4 @@ + # Spacedrive: Complete Technical Overview _A comprehensive analysis of the Spacedrive ecosystem, covering the core rewrite, cloud infrastructure, and the path to production._ diff --git a/docs/design/core/SPACEDROP_DESIGN.md b/docs/design/core/SPACEDROP_DESIGN.md index 92b645bd6..ff218fb2d 100644 --- a/docs/design/core/SPACEDROP_DESIGN.md +++ b/docs/design/core/SPACEDROP_DESIGN.md @@ -1,3 +1,4 @@ + # Spacedrop Protocol Design ## Overview diff --git a/docs/design/core/STRUCTURE.md b/docs/design/core/STRUCTURE.md index ff3a92606..338a98f85 100644 --- a/docs/design/core/STRUCTURE.md +++ b/docs/design/core/STRUCTURE.md @@ -1,3 +1,4 @@ + # core Structure ``` diff --git a/docs/design/core/THUMBNAIL_SYSTEM_DESIGN.md b/docs/design/core/THUMBNAIL_SYSTEM_DESIGN.md index f48ca6ec0..82b706799 100644 --- a/docs/design/core/THUMBNAIL_SYSTEM_DESIGN.md +++ b/docs/design/core/THUMBNAIL_SYSTEM_DESIGN.md @@ -1,3 +1,4 @@ + # Thumbnail System Design for core ## Executive Summary diff --git a/docs/design/core/TYPESAFE_CLIENT.md b/docs/design/core/TYPESAFE_CLIENT.md index b38e9f1fb..b884042b0 100644 --- a/docs/design/core/TYPESAFE_CLIENT.md +++ b/docs/design/core/TYPESAFE_CLIENT.md @@ -1,3 +1,4 @@ + # Spacedrive Client Generation System Design Document ## 1. Overview diff --git a/docs/design/core/UI_DESIGN.md b/docs/design/core/UI_DESIGN.md index ade8a5dce..52b68b520 100644 --- a/docs/design/core/UI_DESIGN.md +++ b/docs/design/core/UI_DESIGN.md @@ -1,3 +1,4 @@ + # Design Document: The Spacedrive UI ## 1. Overview diff --git a/docs/design/core/VDFS_MODEL_VISUAL.md b/docs/design/core/VDFS_MODEL_VISUAL.md index 90e1ede93..f280c614d 100644 --- a/docs/design/core/VDFS_MODEL_VISUAL.md +++ b/docs/design/core/VDFS_MODEL_VISUAL.md @@ -1,3 +1,4 @@ + # VDFS Domain Model - Visual Overview ## Core Relationships diff --git a/docs/design/core/VIRTUAL_LOCATIONS_DESIGN.md b/docs/design/core/VIRTUAL_LOCATIONS_DESIGN.md index 07e16a7ff..d8a3aefa5 100644 --- a/docs/design/core/VIRTUAL_LOCATIONS_DESIGN.md +++ b/docs/design/core/VIRTUAL_LOCATIONS_DESIGN.md @@ -1,3 +1,4 @@ + Guidance Document: Evolving to a Pure Hierarchical Model with Virtual Locations diff --git a/docs/design/core/VIRTUAL_SIDECAR_SYSTEM.md b/docs/design/core/VIRTUAL_SIDECAR_SYSTEM.md index bf7ae88d1..4fc8e317e 100644 --- a/docs/design/core/VIRTUAL_SIDECAR_SYSTEM.md +++ b/docs/design/core/VIRTUAL_SIDECAR_SYSTEM.md @@ -1,3 +1,4 @@ + # Virtual Sidecar System (VSS) Status: Draft diff --git a/docs/design/core/VOLUME_CLASSIFICATION_DESIGN.md b/docs/design/core/VOLUME_CLASSIFICATION_DESIGN.md index 0d0675b41..2bf634665 100644 --- a/docs/design/core/VOLUME_CLASSIFICATION_DESIGN.md +++ b/docs/design/core/VOLUME_CLASSIFICATION_DESIGN.md @@ -1,3 +1,4 @@ + # Volume Classification and UX Enhancement Design **Status:** Draft diff --git a/docs/design/core/VOLUME_TRACKING_IMPLEMENTATION_PLAN.md b/docs/design/core/VOLUME_TRACKING_IMPLEMENTATION_PLAN.md index c330c323d..8b9214a2f 100644 --- a/docs/design/core/VOLUME_TRACKING_IMPLEMENTATION_PLAN.md +++ b/docs/design/core/VOLUME_TRACKING_IMPLEMENTATION_PLAN.md @@ -1,3 +1,4 @@ + # Volume Tracking Implementation Plan ## Overview diff --git a/docs/design/core/WATCHER_VDFS_INTEGRATION.md b/docs/design/core/WATCHER_VDFS_INTEGRATION.md index 2fb476be3..e44b12c09 100644 --- a/docs/design/core/WATCHER_VDFS_INTEGRATION.md +++ b/docs/design/core/WATCHER_VDFS_INTEGRATION.md @@ -1,3 +1,4 @@ + # File Watcher VDFS Integration Design ## Overview diff --git a/docs/design/core/WHITEPAPER_IMPL_ROADMAP.md b/docs/design/core/WHITEPAPER_IMPL_ROADMAP.md index 960f12b85..6c9907f3b 100644 --- a/docs/design/core/WHITEPAPER_IMPL_ROADMAP.md +++ b/docs/design/core/WHITEPAPER_IMPL_ROADMAP.md @@ -1,3 +1,4 @@ + Of course. Based on the V2 whitepaper, your design documents, and the current state of the codebase, here is a clear development roadmap to align the implementation with the full architectural vision. This roadmap is sequenced to build foundational layers first, ensuring that complex features like AI and Sync are built on a stable and complete core. diff --git a/docs/design/core/action-metadata-for-jobs.md b/docs/design/core/action-metadata-for-jobs.md index c9a8f0c17..936f9cacd 100644 --- a/docs/design/core/action-metadata-for-jobs.md +++ b/docs/design/core/action-metadata-for-jobs.md @@ -1,3 +1,4 @@ + # Universal Action Metadata for Jobs **Status**: Draft diff --git a/docs/design/core/agents/AGENT_ARCHITECTURE_ANALYSIS.md b/docs/design/core/agents/AGENT_ARCHITECTURE_ANALYSIS.md index 712f3caca..37f027f7a 100644 --- a/docs/design/core/agents/AGENT_ARCHITECTURE_ANALYSIS.md +++ b/docs/design/core/agents/AGENT_ARCHITECTURE_ANALYSIS.md @@ -1,3 +1,4 @@ + # Agent Architecture Analysis from Production Rust Projects This document analyzes three production Rust AI agent frameworks to extract patterns and best practices for Spacedrive's extension-based agent system. diff --git a/docs/design/core/agents/CONTEXT_WINDOW_MANAGEMENT_RESEARCH.md b/docs/design/core/agents/CONTEXT_WINDOW_MANAGEMENT_RESEARCH.md index 2999c0303..4abea42b3 100644 --- a/docs/design/core/agents/CONTEXT_WINDOW_MANAGEMENT_RESEARCH.md +++ b/docs/design/core/agents/CONTEXT_WINDOW_MANAGEMENT_RESEARCH.md @@ -1,3 +1,4 @@ + # Context Window Management - Research from Production Rust Agent Projects **Research Date:** October 2025 diff --git a/docs/design/core/cli-output-refactor.md b/docs/design/core/cli-output-refactor.md index 3e57eefd2..728ad0f88 100644 --- a/docs/design/core/cli-output-refactor.md +++ b/docs/design/core/cli-output-refactor.md @@ -1,3 +1,4 @@ + # CLI Output Refactor Design Document ## Overview diff --git a/docs/design/core/indexer-scope-upgrade.md b/docs/design/core/indexer-scope-upgrade.md index d56ead643..2b024faed 100644 --- a/docs/design/core/indexer-scope-upgrade.md +++ b/docs/design/core/indexer-scope-upgrade.md @@ -1,3 +1,4 @@ + # Indexer Scope and Ephemeral Mode Upgrade ## Overview diff --git a/docs/design/core/landing-page-idea.md b/docs/design/core/landing-page-idea.md index 9dc5c8501..096df0d28 100644 --- a/docs/design/core/landing-page-idea.md +++ b/docs/design/core/landing-page-idea.md @@ -1,3 +1,4 @@ + A landing page that is a live window into the development of the app, roadmap, history, agents activity. Blow people away with the automated development. diff --git a/docs/design/core/networking_implementation_summary.md b/docs/design/core/networking_implementation_summary.md index 3f28aca6e..0d36001f2 100644 --- a/docs/design/core/networking_implementation_summary.md +++ b/docs/design/core/networking_implementation_summary.md @@ -1,3 +1,4 @@ + # Networking Module Implementation Summary ## Overview diff --git a/docs/design/core/sync/NORMALIZED_CACHE_DESIGN.md b/docs/design/core/sync/NORMALIZED_CACHE_DESIGN.md index 9c2cc96e8..ae9d9b1da 100644 --- a/docs/design/core/sync/NORMALIZED_CACHE_DESIGN.md +++ b/docs/design/core/sync/NORMALIZED_CACHE_DESIGN.md @@ -1,3 +1,4 @@ + # Normalized Resource Cache Design **Status**: RFC / Design Document diff --git a/docs/design/core/sync/README.md b/docs/design/core/sync/README.md index d624f30de..18c02ec2f 100644 --- a/docs/design/core/sync/README.md +++ b/docs/design/core/sync/README.md @@ -1,3 +1,4 @@ + # Sync System Design Documentation This directory contains **detailed design documents** for Spacedrive's multi-device synchronization and client-side caching architecture. diff --git a/docs/design/core/sync/SYNC_CONDUIT_DESIGN.md b/docs/design/core/sync/SYNC_CONDUIT_DESIGN.md index dd7acab61..8158831ae 100644 --- a/docs/design/core/sync/SYNC_CONDUIT_DESIGN.md +++ b/docs/design/core/sync/SYNC_CONDUIT_DESIGN.md @@ -1,3 +1,4 @@ + ## **Design Document: Spacedrive Sync Conduits** ### 1\. Overview diff --git a/docs/design/core/sync/SYNC_DESIGN.md b/docs/design/core/sync/SYNC_DESIGN.md index 8c474a746..1de65edab 100644 --- a/docs/design/core/sync/SYNC_DESIGN.md +++ b/docs/design/core/sync/SYNC_DESIGN.md @@ -1,3 +1,4 @@ + # Pragmatic Sync System Design ## Overview diff --git a/docs/design/core/sync/SYNC_DESIGN_2025_08_19.md b/docs/design/core/sync/SYNC_DESIGN_2025_08_19.md index 75f11bed9..ad13a0cb6 100644 --- a/docs/design/core/sync/SYNC_DESIGN_2025_08_19.md +++ b/docs/design/core/sync/SYNC_DESIGN_2025_08_19.md @@ -1,3 +1,4 @@ + # Pragmatic Sync System Design (2025-08-19 Revision) ## Overview diff --git a/docs/design/core/sync/SYNC_FIRST_DRAFT_DESIGN.md b/docs/design/core/sync/SYNC_FIRST_DRAFT_DESIGN.md index e4ba0d6d5..c419fdd99 100644 --- a/docs/design/core/sync/SYNC_FIRST_DRAFT_DESIGN.md +++ b/docs/design/core/sync/SYNC_FIRST_DRAFT_DESIGN.md @@ -1,3 +1,4 @@ + # Pragmatic Sync System Design ## Overview diff --git a/docs/design/core/sync/SYNC_INTEGRATION_NOTES.md b/docs/design/core/sync/SYNC_INTEGRATION_NOTES.md index bf6dc1ae5..7be0b70df 100644 --- a/docs/design/core/sync/SYNC_INTEGRATION_NOTES.md +++ b/docs/design/core/sync/SYNC_INTEGRATION_NOTES.md @@ -1,3 +1,4 @@ + SYNC_INTEGRATION_NOTES.md Integrating the New Sync System into Spacedrive Core v2 This document outlines the strategic integration points and critical considerations for seamlessly weaving the newly designed universal dependency-aware sync system and the entity refactor into the existing, well-tested Spacedrive Core v2 architecture. The goal is to leverage existing robust modules while enhancing core file management capabilities. diff --git a/docs/design/core/sync/SYNC_TX_CACHE_MINI_SPEC.md b/docs/design/core/sync/SYNC_TX_CACHE_MINI_SPEC.md index 6e4abc882..eba92bdcb 100644 --- a/docs/design/core/sync/SYNC_TX_CACHE_MINI_SPEC.md +++ b/docs/design/core/sync/SYNC_TX_CACHE_MINI_SPEC.md @@ -1,3 +1,4 @@ + # Sync + Transaction Manager + Normalized Cache: Mini Spec ## Scope diff --git a/docs/design/core/sync/TRANSACTION_MANAGER_COMPATIBILITY.md b/docs/design/core/sync/TRANSACTION_MANAGER_COMPATIBILITY.md index cc08890c9..f369ba56a 100644 --- a/docs/design/core/sync/TRANSACTION_MANAGER_COMPATIBILITY.md +++ b/docs/design/core/sync/TRANSACTION_MANAGER_COMPATIBILITY.md @@ -1,3 +1,4 @@ + # TransactionManager Compatibility Analysis ## Executive Summary diff --git a/docs/design/core/sync/UNIFIED_RESOURCE_EVENTS.md b/docs/design/core/sync/UNIFIED_RESOURCE_EVENTS.md index 938eb69e7..86245aa42 100644 --- a/docs/design/core/sync/UNIFIED_RESOURCE_EVENTS.md +++ b/docs/design/core/sync/UNIFIED_RESOURCE_EVENTS.md @@ -1,3 +1,4 @@ + # Unified Resource Event System ## Problem Statement diff --git a/docs/design/core/sync/UNIFIED_TRANSACTIONAL_SYNC_AND_CACHE.md b/docs/design/core/sync/UNIFIED_TRANSACTIONAL_SYNC_AND_CACHE.md index e01810a03..02f82a35f 100644 --- a/docs/design/core/sync/UNIFIED_TRANSACTIONAL_SYNC_AND_CACHE.md +++ b/docs/design/core/sync/UNIFIED_TRANSACTIONAL_SYNC_AND_CACHE.md @@ -1,3 +1,4 @@ + # Unified Architecture: Transactional Sync and Real-Time Caching **Version**: 1.0 diff --git a/docs/design/core/sync/leaderless-architecture.md b/docs/design/core/sync/leaderless-architecture.md index 4175a5073..f4533cd46 100644 --- a/docs/design/core/sync/leaderless-architecture.md +++ b/docs/design/core/sync/leaderless-architecture.md @@ -1,3 +1,4 @@ + # New Sync Architecture: Leaderless Hybrid Model **Date**: 2025-10-08