Home / Sovereign Sheets / Sovereign Sheets Specification
Sovereign Sheets
Your Data. Your Rules.
Overview
Sovereign Sheets is an open-source, privacy-first spreadsheet and data platform designed to provide the capabilities of spreadsheets, databases, business intelligence platforms, automation systems, collaborative workspaces, and AI-powered productivity tools within a single modular system.
The platform is designed around user ownership, data sovereignty, interoperability, extensibility, local-first operation, and encryption throughout the data lifecycle. Sovereign Sheets enables individuals, businesses, researchers, organizations, educators, developers, and communities to create, manage, analyze, visualize, automate, and collaborate around structured and unstructured data.
Sovereign Sheets uses a modular architecture in which core platform capabilities provide shared infrastructure and application-specific capabilities are implemented through specialized modules and AI agents. Optional plugin modules extend the platform without requiring application-specific functionality to become part of the core.
Design Principles
- Open source development
- Modular architecture
- User-controlled data
- Encryption by default
- End-to-end encryption where applicable
- Local-first operation
- Offline capability
- Self-hosting support
- Interoperability
- Open data formats
- Vendor independence
- Extensible architecture
- Human-controlled automation
- Human oversight of AI actions
- Auditable operations
- Reversible automated actions
- Granular permissions
- Privacy-preserving AI
- Accessible design
- Internationalization
- Cross-platform operation
Core Platform Module
The Core Platform Module provides the shared foundation required by all other modules.
Core Capabilities
- Workspace management
- Workbook management
- Sheet management
- User management
- Identity management
- Permissions management
- Module management
- Agent management
- Plugin management
- Configuration management
- Settings management
- Search
- Command system
- Event system
- Task management
- Notification system
- Error handling
- Logging
- Auditability
- Backup coordination
- Recovery coordination
- Version management
- Application state management
- Cross-platform support
The core must provide stable interfaces that allow modules, agents, plugins, integrations, and AI models to operate without creating unnecessary dependencies between application-specific components.
Spreadsheet Engine Module
The Spreadsheet Engine Module provides the primary spreadsheet environment.
Spreadsheet Capabilities
- Rows and columns
- Cells
- Worksheets
- Workbooks
- Tables
- Cell formatting
- Rich text
- Images
- Attachments
- Links
- Notes
- Comments
- Hidden rows and columns
- Frozen rows and columns
- Row and column grouping
- Conditional formatting
- Data validation
- Dropdown fields
- Checkboxes
- Custom cell types
- Named ranges
- Named formulas
- Structured references
- Formula autocomplete
- Formula suggestions
- Formula error detection
- Formula auditing
- Precedent tracing
- Dependent tracing
- Circular reference detection
- Automatic calculation
- Manual calculation
- Incremental calculation
- Dynamic arrays
- Array formulas
- Custom functions
- User-defined functions
- Lambda-style functions
Formula Categories
- Mathematical functions
- Logical functions
- Text functions
- Date functions
- Time functions
- Statistical functions
- Financial functions
- Engineering functions
- Lookup functions
- Reference functions
- Database functions
- Array functions
- Information functions
- Compatibility functions
Advanced Modeling
- Pivot tables
- Pivot charts
- Goal Seek
- Solver
- Scenario analysis
- What-if analysis
- Sensitivity analysis
- Forecasting
- Regression
- Statistical modeling
- Financial modeling
- Time-series analysis
- Variance analysis
- Optimization
- Monte Carlo simulation
- Model validation
- Dependency graphs
Data and Database Module
The Data and Database Module transforms spreadsheet data into structured datasets and relational databases.
Database Capabilities
- Structured tables
- Relational tables
- Primary keys
- Foreign keys
- Relationships
- Linked records
- One-to-one relationships
- One-to-many relationships
- Many-to-many relationships
- Computed fields
- Formula fields
- Lookup fields
- Rollups
- Aggregations
- Saved queries
- Filters
- Sorting
- Grouping
- Full-text search
- Data validation
- Data constraints
- Schema management
- Data dictionaries
- Data lineage
- Record history
- Record-level permissions
Supported Data Types
- Text
- Long text
- Number
- Currency
- Percentage
- Date
- Time
- Date and time
- Boolean
- Checkbox
- Single select
- Multi-select
- URL
- Phone
- Rating
- Formula
- Attachment
- Image
- Geographic location
- Linked record
- Lookup
- Rollup
- JSON
- Custom data types
View System Module
The View System Module allows the same underlying data to be represented through different interfaces.
Supported Views
- Spreadsheet view
- Table view
- List view
- Kanban view
- Calendar view
- Timeline view
- Gantt view
- Gallery view
- Card view
- Form view
- Map view
- Pivot view
- Chart view
- Dashboard view
Views must operate against shared underlying data without creating unnecessary duplicate datasets.
Natural Language AI Module
The Natural Language AI Module provides a built-in natural-language interface for interacting with Sovereign Sheets.
Users must be able to describe desired outcomes using ordinary language rather than requiring knowledge of formulas, database queries, programming, or automation syntax.
Natural Language Capabilities
- Generate formulas
- Explain formulas
- Modify formulas
- Create worksheets
- Create workbooks
- Create tables
- Create databases
- Create fields
- Create relationships
- Create views
- Filter data
- Sort data
- Analyze datasets
- Clean datasets
- Transform datasets
- Generate charts
- Generate dashboards
- Generate reports
- Generate templates
- Create workflows
- Create automations
- Identify anomalies
- Detect trends
- Perform forecasting
- Perform comparisons
- Perform calculations
- Summarize information
- Answer questions about datasets
- Explain data relationships
- Recommend visualizations
- Recommend formulas
- Recommend workflows
- Recommend data structures
Natural Language Examples
- “Create a monthly household budget.”
- “Find duplicate customers.”
- “Show revenue by quarter.”
- “Explain this formula.”
- “Create a dashboard from this dataset.”
- “Find products with declining sales.”
- “Build an inventory tracker.”
- “Create a follow-up task when a customer has not been contacted for thirty days.”
- “Compare these three scenarios.”
- “Clean and standardize this dataset.”
The AI must distinguish between informational requests and actions that modify user data.
Actions that modify, delete, share, export, transmit, or otherwise materially affect user data must respect configured permissions and approval requirements.
AI Agent Orchestration Module
The Agent Orchestration Module coordinates specialized application agents.
Agent Capabilities
- Agent registration
- Agent discovery
- Agent permissions
- Agent tool access
- Agent task execution
- Agent-to-agent communication
- Agent delegation
- Agent task planning
- Agent task tracking
- Agent action logging
- Agent approval workflows
- Agent conflict handling
- Agent rollback support
- Agent execution limits
- Agent data-access boundaries
The orchestrator must prevent agents from receiving broader data access than required for an assigned task.
Finance Agent Module
The Finance Agent provides financial planning and analysis capabilities.
Finance Capabilities
- Budgeting
- Expense tracking
- Income tracking
- Cash-flow analysis
- Cash-flow forecasting
- Net worth tracking
- Debt analysis
- Loan analysis
- Mortgage calculations
- Savings planning
- Investment tracking
- Retirement planning
- Financial scenarios
- Financial forecasting
- Financial modeling
- Variance analysis
Accounting Agent Module
The Accounting Agent provides accounting-oriented workflows.
Accounting Capabilities
- Bookkeeping
- Accounts payable
- Accounts receivable
- Invoice tracking
- Reconciliation
- Expense categorization
- Financial statements
- Accounting reports
- Tax-related calculations
- Transaction analysis
- Audit preparation
Sales Agent Module
The Sales Agent provides customer and sales management capabilities.
Sales Capabilities
- CRM
- Lead management
- Prospect management
- Customer management
- Sales pipelines
- Deal tracking
- Sales forecasting
- Commission calculations
- Sales quotas
- Territory management
- Customer segmentation
- Customer analysis
- Follow-up tracking
Marketing Agent Module
The Marketing Agent provides marketing planning and analysis capabilities.
Marketing Capabilities
- Campaign planning
- Marketing calendars
- Content calendars
- Advertising budgets
- Campaign tracking
- Campaign analysis
- SEO data management
- Keyword tracking
- Customer segmentation
- Marketing analytics
- Lead analysis
- Marketing forecasting
Project Management Agent Module
The Project Management Agent provides project planning and execution capabilities.
Project Capabilities
- Project creation
- Task management
- Milestones
- Dependencies
- Resource allocation
- Capacity planning
- Project budgets
- Timelines
- Gantt planning
- Risk tracking
- Issue tracking
- Status reporting
- Workload management
Human Resources Agent Module
The Human Resources Agent provides workforce administration capabilities.
HR Capabilities
- Employee records
- Recruiting
- Applicant tracking
- Interview tracking
- Onboarding
- Scheduling
- Time tracking
- Leave tracking
- Training records
- Certification tracking
- Compensation planning
- Workforce planning
- Performance tracking
Inventory Agent Module
The Inventory Agent provides inventory and stock management capabilities.
Inventory Capabilities
- Product databases
- SKU management
- Stock tracking
- Warehouse tracking
- Stock movement
- Reorder points
- Purchase planning
- Inventory forecasting
- Supplier tracking
- Inventory analysis
- Inventory valuation
Procurement Agent Module
The Procurement Agent provides purchasing and vendor management capabilities.
Procurement Capabilities
- Vendor management
- Quote management
- Vendor comparison
- Purchase requests
- Purchase orders
- Contract tracking
- Spending analysis
- Supplier performance
- Procurement reporting
Supply Chain Agent Module
The Supply Chain Agent provides supply-chain planning capabilities.
Supply Chain Capabilities
- Supplier tracking
- Logistics tracking
- Shipment tracking
- Distribution planning
- Demand forecasting
- Supply planning
- Delivery tracking
- Supply risk analysis
- Supply performance analysis
Real Estate Agent Module
The Real Estate Agent provides property and real estate analysis capabilities.
Real Estate Capabilities
- Property databases
- Listing management
- Comparable analysis
- Property valuation
- Rental analysis
- Mortgage calculations
- Operating expense analysis
- Cash-flow analysis
- Cap rate calculations
- ROI calculations
- Investment analysis
- Property portfolio tracking
- Transaction tracking
Research Agent Module
The Research Agent provides research and scientific data capabilities.
Research Capabilities
- Research datasets
- Experimental data
- Survey data
- Sample tracking
- Statistical analysis
- Data cleaning
- Data transformation
- Research documentation
- Scientific calculations
- Research visualization
- Trend analysis
- Research reporting
Education Agent Module
The Education Agent provides education and academic management capabilities.
Education Capabilities
- Student records
- Class management
- Grade tracking
- Attendance
- Assignment tracking
- Course planning
- Lesson planning
- Student progress
- Rubrics
- Educational analytics
- School resource planning
Manufacturing Agent Module
The Manufacturing Agent provides production and manufacturing management capabilities.
Manufacturing Capabilities
- Production planning
- Work orders
- Bill of materials
- Material tracking
- Production costs
- Capacity planning
- Quality control
- Defect tracking
- Machine maintenance
- Production reporting
Engineering Agent Module
The Engineering Agent provides technical calculation and analysis capabilities.
Engineering Capabilities
- Engineering calculations
- Specifications
- Measurements
- Technical datasets
- Testing data
- Technical modeling
- Performance analysis
- Resource calculations
- Cost estimation
- Engineering reporting
Scheduling Agent Module
The Scheduling Agent provides scheduling and resource coordination capabilities.
Scheduling Capabilities
- Appointments
- Employee schedules
- Shifts
- Events
- Rooms
- Equipment
- Resource allocation
- Calendar coordination
- Availability tracking
- Scheduling conflict detection
Analytics Agent Module
The Analytics Agent provides advanced analytical capabilities.
Analytics Capabilities
- KPI analysis
- Trend detection
- Anomaly detection
- Correlation analysis
- Statistical analysis
- Forecasting
- Performance analysis
- Comparative analysis
- Cohort analysis
- Variance analysis
Reporting Agent Module
The Reporting Agent provides automated reporting capabilities.
Reporting Capabilities
- Report generation
- Recurring reports
- Executive summaries
- Financial reports
- Operational reports
- Performance reports
- Dashboard reports
- Data storytelling
- Report templates
- PDF generation
- Presentation-ready outputs
Data Agent Module
The Data Agent provides data preparation and transformation capabilities.
Data Capabilities
- Data cleaning
- Data validation
- Data normalization
- Deduplication
- Data matching
- Data transformation
- Schema detection
- Data classification
- Data migration
- Data enrichment
- Data quality analysis
- Data integrity checks
Automation Agent Module
The Automation Agent provides intelligent workflow creation and execution.
Automation Capabilities
- Workflow creation
- Workflow modification
- Trigger configuration
- Action configuration
- Conditional logic
- Branching
- Loops
- Scheduled tasks
- Notifications
- Approvals
- API calls
- Webhooks
- Database actions
- Data transformations
- Report generation
- Script execution
Visualization Agent Module
The Visualization Agent provides intelligent visualization creation.
Visualization Capabilities
- Chart selection
- Chart generation
- Dashboard generation
- Visualization recommendations
- Data storytelling
- Interactive visualization
- Geographic visualization
- KPI visualization
- Dashboard layout optimization
Decision Agent Module
The Decision Agent provides structured decision-support capabilities.
Decision Capabilities
- Decision matrices
- Scenario comparison
- Risk analysis
- Cost-benefit analysis
- Trade-off analysis
- Opportunity analysis
- Weighted scoring
- Recommendation generation
- Decision documentation
AI recommendations must remain distinguishable from user decisions and must not be represented as authoritative conclusions without appropriate context.
Simulation Agent Module
The Simulation Agent provides modeling and simulation capabilities.
Simulation Capabilities
- What-if analysis
- Scenario modeling
- Monte Carlo simulation
- Probability analysis
- Forecasting
- Sensitivity analysis
- Optimization
- Risk modeling
Geospatial Agent Module
The Geospatial Agent provides geographic data capabilities.
Geospatial Capabilities
- Address management
- Coordinate management
- Location datasets
- Geographic calculations
- Distance calculations
- Territory management
- Route analysis
- Geographic visualization
- Map generation
- Location-based analysis
Visualization and Dashboard Module
The Visualization and Dashboard Module provides the underlying visualization infrastructure.
Visualization Capabilities
- Line charts
- Bar charts
- Column charts
- Area charts
- Scatter plots
- Bubble charts
- Pie charts
- Donut charts
- Histograms
- Heatmaps
- Treemaps
- Waterfall charts
- Funnel charts
- Radar charts
- Box plots
- Sankey diagrams
- Geographic maps
- Financial charts
- KPI cards
- Interactive dashboards
- Dashboard filters
- Slicers
- Drill-down
- Drill-through
- Cross-filtering
- Live data updates
Data Import and Export Module
The Data Import and Export Module provides interoperable data movement.
Supported Formats
- CSV
- XLSX
- XLS
- JSON
- XML
- TSV
- SQL-compatible data
- Open spreadsheet formats
- Open structured data formats
Import Capabilities
- Single-file import
- Batch import
- Workbook import
- Worksheet import
- Database import
- API import
- Automated import
- Data mapping
- Field mapping
- Schema detection
- Data validation
- Import previews
- Import error reporting
Export Capabilities
- Spreadsheet export
- CSV export
- JSON export
- Database export
- PDF export
- Image export
- Report export
- Structured data export
Integration Module
The Integration Module provides connections to external systems.
Integration Capabilities
- REST APIs
- GraphQL
- Webhooks
- SQL databases
- Local databases
- Cloud databases
- File systems
- CRM systems
- Accounting systems
- Inventory systems
- Financial data sources
- IoT data sources
- External business systems
- Custom integrations
Integrations must respect user permissions and security policies.
Automation Engine Module
The Automation Engine provides the shared infrastructure for workflows.
Triggers
- Cell changes
- Record changes
- Table changes
- Form submissions
- Scheduled events
- Dates
- Time conditions
- API events
- Webhooks
- Agent events
Actions
- Update cells
- Create records
- Modify records
- Delete records subject to permissions
- Create tasks
- Send notifications
- Send email through approved integrations
- Call APIs
- Trigger webhooks
- Generate reports
- Run approved scripts
- Invoke agents
- Start workflows
Collaboration and Synchronization Module
The Collaboration and Synchronization Module provides shared access and synchronization.
Collaboration Capabilities
- Real-time collaboration
- Shared workspaces
- Shared workbooks
- Shared sheets
- Comments
- Mentions
- Assignments
- Presence indicators
- Change tracking
- Version history
- Workbook history
- Sheet history
- Cell history
- Record history
- Version restoration
- Conflict detection
- Conflict resolution
- Offline editing
- Synchronization
Synchronization should support conflict-resistant data models suitable for local-first operation.
Security and Encryption Module
The Security and Encryption Module is a foundational component of Sovereign Sheets.
Encryption Requirements
- Encryption by default
- Encryption at rest
- Encryption in transit
- End-to-end encryption
- Encrypted local storage
- Encrypted synchronization
- Encrypted backups
- Secure key management
- User-controlled keys where supported
- Secure sharing
- Key rotation
- Access revocation
- Secure deletion
Sensitive cryptographic operations should rely on established, well-reviewed cryptographic libraries rather than custom cryptographic implementations.
Access Control
- User authentication
- Multi-factor authentication
- Hardware security key support
- Role-based access control
- Attribute-based access control
- Workspace permissions
- Workbook permissions
- Sheet permissions
- Table permissions
- Record permissions
- Range permissions
- Agent permissions
- Plugin permissions
- API permissions
- Temporary permissions
- Permission expiration
- Access revocation
Security Monitoring
- Audit logs
- Security event logs
- Authentication logs
- Permission-change logs
- Agent action logs
- Plugin activity logs
- Integration activity logs
- Data access records
Privacy Module
The Privacy Module provides user control over data collection and processing.
Privacy Requirements
- No data harvesting
- No data selling
- No hidden analytics
- No telemetry by default
- Explicit consent for optional telemetry
- User-controlled data sharing
- Data retention controls
- Data export
- Data deletion
- Privacy-preserving defaults
- Transparent data processing
- Configurable privacy policies
AI Privacy Module
The AI Privacy Module applies Sovereign Sheets security principles to AI operations.
AI Deployment Options
- Local AI models
- Self-hosted AI models
- User-selected AI providers
- Pluggable AI models
- Offline AI where supported
- Private inference
- Remote inference with explicit authorization
AI Controls
- Per-workbook AI permissions
- Per-sheet AI permissions
- Per-dataset AI permissions
- Per-agent permissions
- Per-model permissions
- Data-sharing controls
- AI activity logs
- Human approval
- Action confirmation
- Action rollback
- AI output labeling
Forms Module
The Forms Module provides structured data collection.
Form Capabilities
- Form builder
- Public forms
- Private forms
- Internal forms
- Conditional fields
- Required fields
- Validation
- File uploads
- Signatures
- Automated submissions
- Submission workflows
- Form-to-table connections
- AI-generated forms
Search Module
The Search Module provides unified discovery across platform data and metadata.
Search Capabilities
- Workbook search
- Sheet search
- Cell search
- Table search
- Record search
- Formula search
- Comment search
- Attachment search
- Documentation search
- Natural-language search
- Filtered search
- Advanced search
- Search indexing
- Permission-aware search
Documentation and Knowledge Module
The Documentation and Knowledge Module allows users to document datasets, workbooks, workflows, and organizational knowledge.
Documentation Capabilities
- Workbook documentation
- Sheet documentation
- Formula documentation
- Data dictionaries
- Field descriptions
- Dataset documentation
- Workflow documentation
- Agent documentation
- Plugin documentation
- Embedded notes
- Comments
- Knowledge pages
- Searchable documentation
- AI-generated documentation
- Versioned documentation
Template Module
The Template Module provides reusable starting points.
Template Categories
- Personal finance
- Business finance
- Accounting
- CRM
- Project management
- Inventory
- Real estate
- Marketing
- Human resources
- Research
- Education
- Manufacturing
- Procurement
- Supply chain
- Financial modeling
- Planning
- Analytics
- Dashboards
- Data collection
Templates may be generated, modified, shared, exported, and imported.
Performance Module
The Performance Module provides scalability for large datasets and complex workbooks.
Performance Capabilities
- Large dataset support
- Millions of rows where hardware permits
- Virtualized rendering
- Lazy loading
- Incremental calculations
- Parallel calculations
- Background processing
- GPU acceleration where appropriate
- Local caching
- Efficient indexing
- Query optimization
- Memory management
- Workbook optimization
- Data pagination
- Background synchronization
Offline and Local-First Module
The Local-First Module allows users to work without continuous network access.
Capabilities
- Offline workbooks
- Offline databases
- Offline formulas
- Offline AI where supported
- Local storage
- Local processing
- Deferred synchronization
- Conflict detection
- Conflict resolution
- Reconnection handling
- Local backups
- User-controlled synchronization
Deployment Module
The Deployment Module supports multiple operating environments.
Deployment Options
- Local-only deployment
- Desktop deployment
- Web deployment
- Mobile deployment
- Tablet deployment
- Personal server
- Private server
- Organization server
- Self-hosted deployment
- Federated deployment
- Optional hosted deployment
Developer Platform Module
The Developer Platform Module provides extension and development interfaces.
Developer Capabilities
- Public API
- Local API
- CLI
- Plugin SDK
- Agent SDK
- Formula API
- Automation API
- Visualization API
- Integration API
- Event API
- Webhook API
- Extension points
- Developer documentation
- Development sandbox
- Testing interfaces
Accessibility Module
The Accessibility Module provides accessible interaction across the platform.
Accessibility Capabilities
- Keyboard navigation
- Screen-reader support
- High-contrast interfaces
- Adjustable text size
- Reduced-motion options
- Accessible forms
- Accessible charts
- Keyboard shortcuts
- Voice input
- Voice commands
- Alternative navigation methods
Internationalization Module
The Internationalization Module supports global use.
Capabilities
- Multiple languages
- Locale-aware numbers
- Currency support
- Date formats
- Time zones
- Regional calendars
- Right-to-left languages
- Localized interfaces
- Localized formulas
- Translation framework
Optional Plugin Modules
Optional plugin modules extend Sovereign Sheets without requiring additional functionality to become part of the core platform.
Plugins should use documented APIs and must operate within explicit permission boundaries.
Plugin Types
- Custom formula plugins
- Custom function plugins
- Custom field plugins
- Custom view plugins
- Custom chart plugins
- Custom dashboard plugins
- Custom agent plugins
- Custom AI model plugins
- Custom automation plugins
- Custom integration plugins
- Custom import plugins
- Custom export plugins
- Custom report plugins
- Custom workflow plugins
- Custom authentication plugins
- Custom storage plugins
- Custom synchronization plugins
- Custom geospatial plugins
- Custom industry plugins
Plugin Security
- Plugin permissions
- Sandboxed execution where appropriate
- Permission declarations
- Data-access restrictions
- Network-access restrictions
- API-access restrictions
- Plugin activity logging
- Plugin verification
- Plugin signing
- Plugin versioning
- Plugin revocation
- Plugin isolation
- Plugin uninstall support
Optional Industry Application Modules
Industry-specific modules may be developed independently from the core platform.
Potential modules include:
- Agriculture
- Construction
- Government
- Legal administration
- Nonprofit management
- Hospitality
- Retail
- Transportation
- Logistics
- Energy
- Environmental management
- Scientific research
- Healthcare administration
- Media
- Entertainment
- Gaming
- Sports management
- Professional services
Each industry module should reuse existing core capabilities rather than duplicating spreadsheet, database, AI, security, automation, or visualization infrastructure.
API and Interoperability Requirements
Sovereign Sheets should provide documented interfaces for exchanging data and functionality.
Requirements
- Stable APIs
- Versioned APIs
- Authentication
- Authorization
- Rate controls
- Webhooks
- Event subscriptions
- Data export
- Data import
- Machine-readable schemas
- Plugin interfaces
- Agent interfaces
- Integration interfaces
Agent Governance
AI agents must operate under explicit governance controls.
Requirements
- Agents must have identifiable capabilities.
- Agents must have defined permissions.
- Agents must operate only within authorized data boundaries.
- Agents must log material actions.
- Agents must distinguish recommendations from completed actions.
- Destructive actions should require appropriate authorization.
- Users must be able to review applicable agent activity.
- Users should be able to revoke agent access.
- Agent actions should be reversible where technically feasible.
- Agent-to-agent delegation must preserve permission boundaries.
- Plugins must not automatically inherit unrestricted agent permissions.
Data Governance
Sovereign Sheets must provide users with control over their data.
Capabilities
- Data ownership controls
- Data export
- Data portability
- Data deletion
- Data retention policies
- Data classification
- Data lineage
- Data versioning
- Access auditing
- Permission management
- Backup management
- Recovery management
- Dataset sharing controls
Reliability and Testing Module
The Reliability and Testing Module supports quality assurance across the platform.
Testing Requirements
- Unit testing
- Integration testing
- End-to-end testing
- Security testing
- Encryption testing
- Formula testing
- Data integrity testing
- AI behavior testing
- Agent permission testing
- Plugin sandbox testing
- API testing
- Synchronization testing
- Offline testing
- Performance testing
- Accessibility testing
- Internationalization testing
- Backup and recovery testing
Audit and Transparency Module
The Audit and Transparency Module provides visibility into system activity.
Capabilities
- User activity logs
- Agent activity logs
- Plugin activity logs
- Integration activity logs
- Permission changes
- Authentication events
- Data access events
- Workflow execution history
- Version history
- Security events
- Exportable audit records
Core Architectural Rule
Sovereign Sheets must maintain a clear separation between platform infrastructure and application-specific functionality.
Core modules provide reusable capabilities.
Application modules provide specialized functionality.
AI agents provide intelligent application assistance.
Optional plugins provide extensibility.
Integrations provide external connectivity.
AI models provide interchangeable intelligence.
No application-specific feature should be placed into the core solely for convenience when it can be implemented as an independent module or plugin.
User Experience
The interface should provide a unified workspace while allowing users to discover capabilities progressively.
Interface Capabilities
- Spreadsheet interface
- Database interface
- Natural-language interface
- Agent interface
- Dashboard interface
- Workflow interface
- Form interface
- Search interface
- Documentation interface
- Plugin management interface
- Permission management interface
- Security interface
- Version history interface
- Collaboration interface
Users should be able to accomplish complex operations through traditional interfaces, natural-language commands, or a combination of both.
Data Storytelling
Sovereign Sheets should allow users to transform structured data into understandable presentations.
Capabilities
- Automated summaries
- Narrative reports
- Interactive dashboards
- Charts
- KPI summaries
- Trend explanations
- Comparative analysis
- Executive summaries
- Report generation
- Presentation-ready outputs
Reversibility and User Control
Where technically feasible, actions that modify user data should support:
- Preview before execution
- Confirmation
- Undo
- Redo
- Version restoration
- Change history
- Action logs
- Rollback
- Selective reversal
AI-generated modifications should be distinguishable from manually created changes.
Open Source Requirements
Sovereign Sheets is intended to be developed as open-source software.
The project should prioritize:
- Transparent source code
- Open development
- Public documentation
- Community contributions
- Auditable security
- Interoperable formats
- Extensible APIs
- Portable data
- Self-hosting
- Vendor independence
Future Expansion
The modular architecture must allow Sovereign Sheets to expand without requiring fundamental redesign of the platform.
Future modules may provide:
- Additional application agents
- Additional AI models
- Additional database engines
- Additional visualization systems
- Additional integrations
- Additional industry applications
- Additional storage systems
- Additional synchronization mechanisms
- Additional collaboration systems
- Additional automation capabilities
- Additional privacy technologies
The platform should remain capable of evolving as new technologies, workflows, data formats, AI models, and user requirements emerge.
Project Goal
Sovereign Sheets aims to provide a comprehensive open-source environment for working with data, information, calculations, analysis, automation, and AI.
Rather than limiting the platform to traditional spreadsheet functionality, Sovereign Sheets combines spreadsheet capabilities, databases, specialized AI agents, natural-language interaction, analytics, visualization, automation, forms, collaboration, integrations, and extensibility within a secure modular architecture.
The system is designed so that users can begin with a simple spreadsheet and progressively add databases, dashboards, workflows, agents, integrations, and specialized application modules as their needs grow.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/sovereign-sheets/
License & Notice Requirements
Sovereign Sheets is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to: Roxanne Ardary and roxanneardary.com.
- Sovereign Sheets specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update
notice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – Sovereign Sheets
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – August 27, 2026
Created the repository for Sovereign Sheets. Created the open-source, encrypted spreadsheet and data platform combining spreadsheets, databases, natural-language AI, specialized agents, automation, analytics, visualization, collaboration, and integrations. - [Add other contributors here] – [Date]
[Describe contribution in one sentence]
License – Sovereign Sheets
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.
