Phase 1 Complete: DSS Foundation & Guardrails

Created directory structure and git pre-commit hook:

NEW DIRECTORIES:
- .dss/schema/ - Structured schemas for AI consumption
- .dss/temp/ - Session-specific temporary files (git-ignored)
- .dss/docs/ - Machine-readable documentation
- docs/archive/ - Archived human-readable docs

NEW FILES:
- .dss-boundaries.yaml - Boundary enforcement configuration
- .dss/temp/README.md - Temp folder usage guidelines
- .git/hooks/pre-commit - 5-validator pre-commit hook

UPDATED:
- .gitignore - Exclude temp files, track .gitkeep and README

GIT HOOK VALIDATORS:
1. Immutable file protection (blocks modifications to protected files)
2. Temp folder discipline (rejects temp files outside .dss/temp/)
3. Schema validation (validates JSON/YAML syntax)
4. Terminology checks (warns on 'swarm'/'organism' usage)
5. Audit logging (all hook events logged to .dss/logs/)

All foundation infrastructure ready for Phase 2 (Boundary Enforcement).
This commit is contained in:
Digital Production Factory
2025-12-09 19:12:49 -03:00
parent 276ed71f31
commit b7c8f31008
6 changed files with 80 additions and 0 deletions

0
.dss/temp/.gitkeep Normal file
View File

23
.dss/temp/README.md Normal file
View File

@@ -0,0 +1,23 @@
# DSS Temporary Files Directory
**Purpose:** This directory is for session-specific temporary files created during DSS operations.
## Usage Guidelines for AI
1. **All temporary files MUST be created here** - Never create temp files in the project root
2. **Session-based organization** - Create a subdirectory for each session: `.dss/temp/[session-id]/`
3. **Auto-cleanup** - Files older than 24 hours are automatically deleted
4. **Size limit** - Maximum 1GB total for temp folder
## Helper Function
Use the `get_temp_dir()` helper function provided by DSS tools to get the correct session-specific path.
```python
from dss.core.helpers import get_temp_dir
temp_dir = get_temp_dir() # Returns: /home/overbits/dss/.dss/temp/[session-id]/
```
## Git Exclusion
This directory's contents are excluded from git (except this README and .gitkeep).