think-bigger/docs/plans/default-config-structure.md
Kade Heyborne 48c6ddc066
Add comprehensive project documentation
- Complete planning documentation for 5-phase development
- UI design specifications and integration
- Domain architecture and directory templates
- Technical specifications and requirements
- Knowledge incorporation strategies
- Dana language reference and integration notes
2025-12-03 16:54:37 -07:00

226 lines
5.8 KiB
Markdown

# Default Configuration Directory Structure
The `.config/think_bigger/` directory contains global configuration, templates, and default settings for the Advanced Second Brain PKM system.
```
.config/
└── think_bigger/
├── config.json # Global system configuration
├── domains/ # Domain templates and defaults
│ ├── default-domain/ # Template for new domains
│ │ ├── _meta/
│ │ ├── inbox/
│ │ ├── notes/
│ │ └── README.md
│ └── domain-types/ # Specialized domain templates
│ ├── research/
│ ├── development/
│ ├── personal/
│ └── business/
├── agents/ # Global AI agents
│ ├── system/ # Core system agents
│ │ ├── file-watcher.na
│ │ ├── indexer.na
│ │ └── maintenance.na
│ ├── user/ # User-customizable agents
│ └── templates/ # Agent templates
├── templates/ # Global templates
│ ├── notes/
│ ├── projects/
│ └── domains/
├── themes/ # UI themes and styles
├── plugins/ # Extension system
├── backups/ # Configuration backups
└── logs/ # System logs
```
## Configuration Files
### config.json
```json
{
"version": "1.0.0",
"system": {
"data_directory": "~/think_bigger_data",
"backup_directory": "~/think_bigger_backups",
"log_level": "INFO",
"auto_backup": true,
"backup_frequency": "daily"
},
"processing": {
"embedding_model": "sentence-transformers/all-MiniLM-L6-v2",
"chunk_size": 512,
"overlap": 50,
"max_file_size": "100MB",
"supported_formats": ["pdf", "md", "txt", "html", "docx"]
},
"ui": {
"theme": "dark",
"font_size": "medium",
"sidebar_width": 300,
"graph_layout": "force",
"default_view": "graph"
},
"agents": {
"enabled": true,
"max_concurrent": 3,
"timeout": 300,
"sandbox": true
},
"integrations": {
"notion": {
"enabled": false,
"api_key": "",
"database_id": ""
},
"obsidian": {
"enabled": false,
"vault_path": ""
}
}
}
```
## Domain Templates
### Default Domain Template
Each domain type has a complete template structure:
```
default-domain/
├── _meta/
│ ├── domain-config.json
│ ├── agents/
│ │ ├── researcher.na
│ │ └── organizer.na
│ └── templates/
│ ├── note.md
│ └── project.md
├── inbox/
├── notes/
│ ├── concepts/
│ ├── projects/
│ ├── research/
│ └── references/
└── README.md
```
### Specialized Templates
#### Research Domain
- Additional folders: `papers/`, `experiments/`, `datasets/`
- Specialized agents: `literature-review.na`, `data-analyzer.na`
- Templates: `research-note.md`, `experiment-log.md`
#### Development Domain
- Additional folders: `code/`, `docs/`, `tests/`
- Specialized agents: `code-reviewer.na`, `documentation-generator.na`
- Templates: `feature-spec.md`, `api-doc.md`
## Agent System
### System Agents
Core agents that run automatically:
- **file-watcher.na**: Monitors file system changes
- **indexer.na**: Maintains search index and knowledge graph
- **maintenance.na**: Performs cleanup and optimization tasks
### User Agents
Customizable agents for specific workflows:
- **researcher.na**: Automated information gathering
- **summarizer.na**: Content condensation
- **connector.na**: Relationship discovery
- **questioner.na**: Q&A processing
## Template System
### Template Categories
- **Notes**: Daily notes, meeting notes, research notes
- **Projects**: Project plans, task lists, progress reports
- **Domains**: Domain setup, README files, configuration
### Template Variables
Support for dynamic content:
- `{{date}}`: Current date
- `{{domain}}`: Domain name
- `{{user}}`: Current user
- `{{title}}`: Document title
## Theme System
### Available Themes
- **Light**: Clean, minimal design
- **Dark**: Easy on the eyes for long sessions
- **Auto**: Follows system preference
- **Custom**: User-defined color schemes
### Theme Configuration
```json
{
"name": "Custom Dark",
"colors": {
"primary": "#6366f1",
"secondary": "#8b5cf6",
"background": "#0f0f0f",
"surface": "#1a1a1a",
"text": "#ffffff",
"text-secondary": "#a1a1aa"
},
"typography": {
"font-family": "Inter, sans-serif",
"font-size-base": "16px",
"line-height": 1.6
}
}
```
## Plugin System
### Plugin Types
- **Importers**: Custom content import formats
- **Exporters**: Custom export destinations
- **Processors**: Content processing pipelines
- **Views**: Custom UI components
- **Agents**: Additional AI agent types
### Plugin Structure
```
plugins/
├── my-plugin/
│ ├── plugin.json
│ ├── main.js
│ ├── agents/
│ └── templates/
```
## Backup and Recovery
### Automatic Backups
- Configuration files backed up daily
- Knowledge graph snapshots weekly
- Full system backup monthly
### Recovery Options
- Point-in-time restore
- Selective domain recovery
- Configuration rollback
- Emergency mode startup
## Logging and Monitoring
### Log Categories
- **System**: Core application logs
- **Agents**: AI agent execution logs
- **Processing**: Content processing logs
- **User**: User action logs
- **Errors**: Error and exception logs
### Monitoring Metrics
- System performance
- Agent success rates
- Content processing statistics
- User engagement metrics
- Error rates and types</content>
<parameter name="filePath">docs/plans/default-config-structure.md