Initial commit: VoIdeaAI - voice-first AI idea assistant

docs/blocks/AUDIT.md

@@ -0,0 +1,70 @@
+# System Audit - VoIdea
+
+**Date:** 2026-05-10
+**Status:** Active
+
+---
+
+## Overview
+
+Audit system ensures project quality control through automatic agents and periodic checks.
+
+---
+
+## Audit Agents
+
+### AuditAgent
+
+**Responsibilities:**
+- Rule compliance check (00-rules.md)
+- Project progress monitoring
+- Deviation detection
+- Admin reports generation
+
+**Triggers:**
+- pre-commit hook
+- Daily at 09:00 (cron)
+- On admin request
+
+### SecurityAgent
+
+**Responsibilities:**
+- Code vulnerability scanning
+- Input validation
+- Dependency checks
+- 152-FZ compliance
+- Suspicious activity logging
+
+---
+
+## Audit Types
+
+### 1. Code Audit
+- Ruff: 0 errors, < 10 warnings
+- MyPy: strict mode, 0 errors
+- Test coverage: > 80%
+
+### 2. Security Audit
+- Bandit: 0 high severity
+- Safety: 0 critical vulnerabilities
+- Secrets detection: 100%
+
+### 3. Architecture Audit
+- No cyclic dependencies
+- ADR up to date
+- All modules documented
+
+### 4. Compliance Audit
+- 152-FZ compliance
+- Data retention policy
+- RBAC verification
+
+---
+
+## Reports
+
+Reports stored in: docs/insights/audit/
+
+---
+
+*Updated: 2026-05-10*

docs/blocks/BACKLOG.md

@@ -0,0 +1,35 @@
+# Backlog System - VoIdea
+
+**Date:** 2026-05-10
+**Status:** Active
+
+---
+
+## Overview
+
+Backlog is a system for managing deferred ideas, plans, and tasks.
+
+## Data Model
+
+See docs/backlog/temp-users-cleanup-note.md, docs/backlog/rate-limiting-note.md, docs/backlog/observer-metrics-stages-note.md, docs/backlog/car-integration-note.md
+
+## Agent Versioning / EvolutionAgent Tasks
+
+- [ ] EvolutionAgent: auto-detect agent changes via checksum comparison
+- [ ] EvolutionAgent: minor/major bump on capability changes
+- [ ] EvolutionAgent: write changelog entries to `CHANGELOG/agents/<name>.md`
+- [ ] Create `CHANGELOG/agents/` directory with initial version files
+- [ ] BaseAgent: implement `compute_checksum()`, `bump_version()`, `write_changelog()`
+- [ ] AgentConfig: add version + checksum fields to DB model
+
+---
+
+## Storage
+
+- PostgreSQL table: backlog_items
+- Access via API: /api/v1/backlog/
+- Admin panel: Backlog management
+
+---
+
+*Updated: 2026-05-10*

docs/blocks/GLOSSARY.md

@@ -0,0 +1,25 @@
+# Project Glossary - VoIdea
+
+**Date:** 2026-05-10
+
+---
+
+## Terms
+
+| Term | Definition |
+|------|------------|
+| VoIdea | Application for capturing and developing ideas with AI |
+| Idea | Main entity - recorded user thought |
+| Agent (AI) | AI agent for idea analysis (11 roles) |
+| System Agent | Automatic agent for project support (11 agents) |
+| Backlog | Deferred tasks/ideas system |
+| Rollout | Gradual deployment (3-1-5-15-100%) |
+| Design Tokens | Unified style source (tokens.json) |
+| TDC | Template-Driven Configuration |
+| Agent Version | SemVer (A.B.C) assigned to each system agent independently |
+| Agent Checksum | SHA256 hash of agent's `__file__`, used to detect changes |
+| Agent Changelog | Change history in `CHANGELOG/agents/<name>.md` |
+
+---
+
+*Updated: 2026-05-10*

docs/blocks/VERSIONS.md

@@ -0,0 +1,70 @@
+# Versioning Rules - VoIdea
+
+**Date:** 2026-05-10
+
+---
+
+## Format
+
+MAJOR.MINOR.PATCH (SemVer)
+
+- MAJOR (X.0.0): breaking changes, full releases
+- MINOR (0.X.0): new functionality, backward compatible
+- PATCH (0.0.X): bug fixes
+
+---
+
+## CHANGELOG
+
+Location: CHANGELOG/
+- New file on X change: vX.0.md
+- New file on Y change: vX.Y.md
+- PATCH appended to existing file
+
+Examples:
+- CHANGELOG/v1.0.md (1.0.0 -> 1.0.5)
+- CHANGELOG/v1.1.md (1.1.0 -> 1.1.3)
+- CHANGELOG/v2.0.md (2.0.0 -> ...)
+
+---
+
+## Generation
+
+Auto-generated by SpecAgent on version change.
+
+---
+
+## Agent Versioning
+
+Each system agent is versioned independently (A.B.C).
+
+### Rules
+
+| Component | When | Who |
+|-----------|------|-----|
+| A (major) | Breaking change in public interface | EvolutionAgent |
+| B (minor) | New capability (method, role, prompt) | EvolutionAgent |
+| C (patch) | Internal fixes, no behavior change | Agent itself (auto) |
+
+### Mechanism
+
+1. Agent runs → `compute_checksum()` (SHA256 of `__file__`)
+2. Compares with `AgentConfig.checksum` in DB
+3. Mismatch → auto-bump patch → update changelog → save new checksum
+4. EvolutionAgent handles minor/major bumps via capability analysis
+
+### Storage
+
+`CHANGELOG/agents/<agent_name>.md` — flat file, all history in one file.
+
+Format:
+```markdown
+# audit_agent Changelog
+
+## 1.0.2 (2026-05-10)
+- Fixed: ruff output parsing for Windows paths
+```
+
+---
+
+*Updated: 2026-05-10*