**Git Commit Tracking** - Automatically capture git commit hash when claims/observations are ingested - Store in assertion metadata for temporal context and audit trails - Graceful degradation in non-git environments - Solves double-commit problem by capturing hash at ingestion time **Implementation** - walker/git.rs: get_current_commit_hash() utility function - bridge.rs: Accept optional git_commit parameter in all conversion functions - episteme/local: Store project_root, capture git hash during ingestion - 5 new tests for git hash tracking + metadata validation - All 1162 aphoria tests passing **Documentation Overhaul** - README: Added Observations vs Claims distinction, git tracking, dashboard - CLI Reference: New sections for git integration and ignore/exclusion system - Comprehensive ignore documentation: .aphoriaignore, inline comments, 4 methods - Enhanced verification engine docs with matching capabilities - DOCUMENTATION_UPDATES.md: Complete audit summary **Dashboard Separation** - Moved Aphoria-specific UI from stemedb-dashboard to aphoria-dashboard - Clean separation of concerns: StemeDB for core, Aphoria for security - Added dashboard documentation and setup guides Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| aaa-game-development.md | ||
| authoritative-state-per-project.md | ||
| enterprise-pilot-guide.md | ||
| enterprise-quick-start.md | ||
| federating-truth.md | ||
| golden-path-loop.md | ||
| multi-team-policy-governance.md | ||
| policy-audit-trails.md | ||
| pre-flight-checks.md | ||
| README.md | ||
| solo-developer-guide.md | ||
| the-first-scan.md | ||
Aphoria Guides
Quick-start guides and workflows for Aphoria users.
Getting Started
| Guide | Audience | Description |
|---|---|---|
| Solo Developer Guide | Individual developers | Get immediate value on personal or side projects |
| Enterprise Pilot Guide | Security teams | Run a measurable pilot with stakeholder buy-in |
| Enterprise Quick Start | Platform engineering | 5-minute path from git clone to enforcing standards |
| The First Scan | Everyone | Your first Aphoria scan walkthrough |
| Pre-Flight Checks | DevOps | Pre-commit and CI integration |
Core Workflows
| Guide | Description |
|---|---|
| Federating Truth | Trust Pack creation and distribution |
| Multi-Team Policy Governance | Managing policies across teams |
| Policy Audit Trails | Compliance and auditing |
| Authoritative State Per Project | Project-specific policy management |
Advanced Topics
| Guide | Description |
|---|---|
| Golden Path Loop | Continuous policy improvement |
| AAA Game Development | Unreal Engine patterns |
Reference Documentation
| Document | Description |
|---|---|
| CLI Reference | Complete command documentation |
| Comparison Modes | Detailed guide for claim comparison modes |
Architecture
See Architecture Documentation for:
- System design and data flow
- Concept matching algorithms
- Extension points and performance targets
UAT Results
See UAT Reports for validation results:
- Policy Source Tracking UAT - Trust Pack workflow validation