Initial commit

skills/session-management/references/config-reference.md

@@ -0,0 +1,228 @@
+# Configuration Reference
+
+Complete reference for `.session/config.yaml` configuration options.
+
+## Session Configuration
+
+```yaml
+session:
+  auto_track: true
+  auto_checkpoint: false
+  checkpoint_interval: 30m
+  handoff_on_end: true
+  archive_after_days: 30
+```
+
+### `auto_track`
+**Type:** boolean  
+**Default:** `true`  
+**Description:** Automatically track file changes during session
+
+### `auto_checkpoint`
+**Type:** boolean  
+**Default:** `false`  
+**Description:** Create automatic checkpoints at intervals
+
+### `checkpoint_interval`
+**Type:** string  
+**Default:** `30m`  
+**Description:** Interval for automatic checkpoints (30m, 1h, etc.)
+
+### `handoff_on_end`
+**Type:** boolean  
+**Default:** `true`  
+**Description:** Generate handoff document when ending session
+
+### `archive_after_days`
+**Type:** integer  
+**Default:** `30`  
+**Description:** Archive completed sessions after N days
+
+---
+
+## Context Configuration
+
+```yaml
+context:
+  architecture: hexagonal
+  patterns:
+    - ports-and-adapters
+    - repository-pattern
+  conventions:
+    - type-hints-required
+    - docstrings-required
+```
+
+### `architecture`
+**Type:** string  
+**Options:** `hexagonal`, `layered`, `microservices`, `mvc`, `clean`, `ddd`  
+**Description:** Primary architecture pattern for the project
+
+### `patterns`
+**Type:** list of strings  
+**Description:** Code patterns to detect and enforce  
+**Common values:**
+- `ports-and-adapters`
+- `repository-pattern`
+- `dependency-injection`
+- `factory-pattern`
+- `cqrs`
+- `event-sourcing`
+
+### `conventions`
+**Type:** list of strings  
+**Description:** Project conventions  
+**Common values:**
+- `type-hints-required`
+- `docstrings-required`
+- `snake-case`
+- `pep8-compliant`
+- `test-coverage-required`
+
+---
+
+## Tracking Configuration
+
+```yaml
+tracking:
+  watch_patterns:
+    - "src/**/*.py"
+    - "tests/**/*.py"
+  ignore_patterns:
+    - "**/__pycache__/**"
+    - "**/node_modules/**"
+  annotations:
+    - "TODO:"
+    - "FIXME:"
+    - "DECISION:"
+```
+
+### `watch_patterns`
+**Type:** list of glob patterns  
+**Description:** Files to watch for changes
+
+### `ignore_patterns`
+**Type:** list of glob patterns  
+**Description:** Files to ignore
+
+### `annotations`
+**Type:** list of strings  
+**Description:** Code annotations to track
+
+---
+
+## Quality Configuration
+
+```yaml
+quality:
+  coverage_threshold: 85
+  new_code_coverage_threshold: 90
+  require_tests: true
+  block_merge_on_quality: true
+```
+
+### `coverage_threshold`
+**Type:** integer (0-100)  
+**Default:** `85`  
+**Description:** Minimum overall test coverage percentage
+
+### `new_code_coverage_threshold`
+**Type:** integer (0-100)  
+**Default:** `90`  
+**Description:** Minimum coverage for new code
+
+### `require_tests`
+**Type:** boolean  
+**Default:** `true`  
+**Description:** Require tests for new features
+
+### `block_merge_on_quality`
+**Type:** boolean  
+**Default:** `true`  
+**Description:** Prevent merge if quality thresholds not met
+
+---
+
+## Display Configuration
+
+```yaml
+display:
+  color: true
+  verbose: false
+  emoji: true
+  date_format: "%Y-%m-%d %H:%M"
+```
+
+### `color`
+**Type:** boolean  
+**Default:** `true`  
+**Description:** Use colored terminal output
+
+### `verbose`
+**Type:** boolean  
+**Default:** `false`  
+**Description:** Enable verbose output by default
+
+### `emoji`
+**Type:** boolean  
+**Default:** `true`  
+**Description:** Use emoji in output
+
+### `date_format`
+**Type:** string  
+**Default:** `"%Y-%m-%d %H:%M"`  
+**Description:** Date/time format string (Python strftime format)
+
+---
+
+## Complete Example
+
+```yaml
+# Session Management Configuration
+
+session:
+  auto_track: true
+  auto_checkpoint: false
+  checkpoint_interval: 30m
+  handoff_on_end: true
+  archive_after_days: 30
+
+context:
+  architecture: hexagonal
+  patterns:
+    - ports-and-adapters
+    - repository-pattern
+    - dependency-injection
+  conventions:
+    - type-hints-required
+    - docstrings-required
+    - snake-case
+    - max-line-length-100
+
+tracking:
+  watch_patterns:
+    - "src/**/*.py"
+    - "tests/**/*.py"
+    - "docs/**/*.md"
+  ignore_patterns:
+    - "**/__pycache__/**"
+    - "**/.venv/**"
+    - "**/dist/**"
+  annotations:
+    - "TODO:"
+    - "FIXME:"
+    - "DECISION:"
+    - "BLOCKER:"
+
+quality:
+  coverage_threshold: 85
+  new_code_coverage_threshold: 90
+  require_tests: true
+  block_merge_on_quality: true
+
+display:
+  color: true
+  verbose: false
+  emoji: true
+  date_format: "%Y-%m-%d %H:%M"
+```