add dates to docs

2026-10-06 01:21:32 -04:00 · 2025-10-11 11:07:42 -07:00
1 parent 1a3c644092
commit efef06af63
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Spacedrive Extension Catalog

 **Date:** October 11, 2025
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 # Extension Lineup Ideas for November 2025 Launch

 **Last Updated:** October 10, 2025
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Extension Models: Final Architecture

 **Design:** Clean separation with unified tag/collection support.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Spacedrive Extensions: Own Your Data, Supercharge Your Workflow

 **A new ecosystem of applications built on a foundation of privacy, control, and intelligence.**
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-09-->
 # Extension SDK API Vision - The Sexiest API

 **Goal:** Extension development should feel like magic. Zero boilerplate, maximum clarity.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 # Investor Memo

 **To:** Spacedrive Seed Investors | **From:** James Pine, Founder | **Date:** October 9, 2025
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 # Investor Memo

 **To:** Spacedrive Seed Investors | **From:** James Pine, Founder | **Date:** October 10, 2025
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 This memo will be sent to existing Spacedrive investors alongside the codebase, whitepaper, deck and a demo video. We need to refine it.

 ---
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Metadata Blobs: Large Data Storage for VDFS

 **Problem:** Storing large data (embeddings, large JSON) in `models.data` or `user_metadata.custom_data` bloats queries.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Extension Models Schema - Final Design

 **Key Insight:** UserMetadata already supports `content_identity_uuid` scoping! Extension models should use the same pattern.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-09-->
 # Spacedrive Platform Revenue Model
 ## The Local-First SaaS Category Killer

@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 # SDK Enhancements & Core Development Alignment

 **Date:** October 11, 2025
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 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
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 # VDFS SDK Specification (Grounded in Spacedrive Core)

 **Version:** 3.0
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 # VDFS SDK Syntax Specification & Finalized Design

 **Version:** 2.0
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-10-->
 # VDFS SDK as Programming Language
 ## The Distributed Computing Primitive for the AI Era

@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 ## 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.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-11-->
 # CLI Daemon Actions Refactoring Design Document

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Action Builder Pattern Refactor Plan

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-02-->
 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.

 ---
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # GraphQL API with async-graphql

 Spacedrive's new API uses GraphQL with full type safety from Rust to TypeScript.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Design Doc: Spacedrive Architecture v2

 **Authors:** Gemini, jamespine
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # API Infrastructure Reorganization

 **Status**: RFC / Design Document
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # API Module Design: Unified Entry Point & Permission Layer

 ## Problem Analysis
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Architecture Decision Records

 ## ADR-000: SdPath as Core Abstraction
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-29-->
 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.

 ---
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-08-->
 ### Spacedrive Benchmarking Suite — Design Document

 Author: Core Team
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-23-->
 '''# Closure Table Indexing Proposal for Spacedrive

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-24-->
 # Cross-Device File Transfer Implementation

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Cross-Platform Copy Operations & Volume Awareness

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-11-->
 # Daemon Refactoring Design Document

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Core Lifecycle Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Device Management Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Spacedrive File Data Model Design (v2)

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # File Data Model - Visual Comparison

 ## Old Model (v1) - Current Spacedrive
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # File Type System

 A modern, extensible file type identification system for Spacedrive.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Library Organization - Implementation Guide

 ## Core Types
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Library Data Organization Design

 ## Current Problems
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Library Organization - Visual Comparison

 ## Current (v1) - Scattered Organization
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Storage Design

 ## Problem Statement
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Virtual Distributed File System - Integration Design

 ## How SdPath and the New Data Model Enable True VDFS
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-19-->
 # Spacedrive Device Pairing Protocol Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Domain Models

 The domain layer contains the core business entities that power Spacedrive's Virtual Distributed File System (VDFS).
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Dynamic Type Generation: The rspc Magic Applied to Spacedrive

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Email Ingestion Extension: Technical Design & Prototype

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-24-->
 # Entity Refactor Design: Library-Scoped ContentIdentity & Hierarchical Metadata

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Extension Agent System Design

 **Version:** 1.0
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # WASM Extension Architecture: Leveraging Existing Operation Registry

 ## TL;DR
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Extension-Defined Jobs and Actions

 **Question:** How can WASM extensions register their own custom jobs and actions, not just call existing ones?
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Extension Job System Parity

 **Question:** Can extensions do everything core jobs can? (Progress, checkpoints, child jobs, metrics, etc.)
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-30-->
 # FFmpeg Bundling Design for core

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-20-->
 # Spacedrive File Sharing Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 ## FS Event Pipeline Resilience and Correctness (Large Bursts)

 ### Goals
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-25-->
 # Cargo Test Subprocess Framework Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-06-->
 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.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Implementation Status

 ## Completed
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Spacedrive Indexer Analysis

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-19-->
 # Deep Analysis of Original Spacedrive Indexer vs New Implementation

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # 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.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-19-->
 # Indexer Implementation Progress

 Last Updated: 2025-06-19
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-19-->
 # Indexer Rules System Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-08-->
 ### Indexing Discovery Throughput Plan

 Author: Core Team
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Infrastructure Layer Separation of Concerns

 **Status**: RFC / Design Document
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-23-->
 # Integration System Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-25-->
 # Spacedrive v2: Integration System Design (Revised)

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-09-->
 # Design Document: iPhone as a Volume for Direct Import

 ## 1. Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-09-->
 # Spacedrive Networking: libp2p to Iroh Migration Design

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Iroh Relay Integration for Spacedrive

 **Author:** AI Assistant
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Spacedrive Job System Design v2

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Job System Macro Implementation Example

 This document shows what the `#[derive(Job)]` macro generates under the hood, demonstrating how we achieve minimal boilerplate.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Spacedrive Job System v2

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-20-->
 # Spacedrive libp2p Integration Design Document

 **Version:** 1.0  
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-29-->
 Spacedrive Core v2: Sync Leadership & Key Exchange Protocol
 Date: June 27, 2025
 Status: Proposed Design
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-19-->
 # Networking System Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Spacedrive Technical Analysis & Revival Strategy

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-07-->
 # Operations Module Refactor Plan

 ## Current Problems
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-20-->
 # Persistent Device Connections Design

 **Version:** 1.0
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Query Architecture Refactor Plan

 ## Goal: Consistent Input/Output Pattern for Queries
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-11-->
 # Reference Sidecars Implementation

 This document describes the reference sidecar feature added to the Virtual Sidecar System (VSS).
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Relay Integration Flow Diagrams

 ## Current State: mDNS-Only Pairing
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Iroh Relay Integration - Quick Summary

 ## TL;DR
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # Spacedrive Rewrite: From Complexity to Clarity

 ## What is Spacedrive?
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # RSPC Magic Implementation: SUCCESS!

 ## Breakthrough Achieved
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-30-->
 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.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-07-->
 # 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.
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-24-->
 # 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".
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Semantic Tagging Architecture Implementation

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Sidecar Scaling Design

 **Status**: Draft
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-30-->
 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.

 ---
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Spacedrive: Complete Technical Overview

 _A comprehensive analysis of the Spacedrive ecosystem, covering the core rewrite, cloud infrastructure, and the path to production._
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-20-->
 # Spacedrop Protocol Design

 ## Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # core Structure

 ```
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-19-->
 # Thumbnail System Design for core

 ## Executive Summary
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-10-11-->
 # Spacedrive Client Generation System Design Document

 ## 1. Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-09-->
 # Design Document: The Spacedrive UI

 ## 1. Overview
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-06-18-->
 # VDFS Domain Model - Visual Overview

 ## Core Relationships
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-06-->
 Guidance Document: Evolving to a Pure Hierarchical Model with
 Virtual Locations

@@ -1,3 +1,4 @@
+<!--CREATED: 2025-08-08-->
 # Virtual Sidecar System (VSS)

 Status: Draft
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-26-->
 # Volume Classification and UX Enhancement Design

 **Status:** Draft
@@ -1,3 +1,4 @@
+<!--CREATED: 2025-07-23-->
 # Volume Tracking Implementation Plan

 ## Overview