jml cce54358d2 feat(aphoria): add git commit tracking + comprehensive documentation

**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>

2026-02-08 18:36:46 +00:00

2.7 KiB

Raw Blame History

StemeDB Dashboard

Enterprise administration dashboard for StemeDB - the probabilistic knowledge graph database.

Features

Skeptic Query: Search and query assertions with lens-based resolution
Layered View: Visualize assertions across lifecycle stages
Sources: Browse and manage source registry
Quarantine: Review and manage quarantined assertions
Circuit Breakers: Monitor and configure circuit breaker status
Audit Trail: View assertion history and changes

Quick Start

# Install dependencies
npm install

# Run development server (port 18188)
npm run dev

# Build for production
npm run build

# Start production server (port 18188)
npm start

Architecture

Framework: Next.js 16 with App Router
UI: TailwindCSS 4 + shadcn/ui components
Port: 18188 (StemeDB Dashboard)
API Integration: Proxies requests to StemeDB API at port 18180

API Integration

The dashboard uses Next.js rewrites to proxy API requests:

// All /v1/* requests are proxied to http://localhost:18180/v1/*
// This is configured in next.config.ts

Leave NEXT_PUBLIC_STEMEDB_API_URL empty in .env.local to use proxy mode.

Project Structure

src/
├── app/                    # Next.js app router pages
│   ├── skeptic/           # Skeptic query route
│   ├── layered/           # Layered view route
│   ├── sources/           # Source registry route
│   ├── quarantine/        # Quarantine management route
│   ├── circuit/           # Circuit breakers route
│   ├── audit/             # Audit trail route
│   └── layout.tsx         # Root layout with StemeDB branding
├── components/
│   ├── skeptic/           # Skeptic query components
│   ├── layered/           # Layered view components
│   ├── sources/           # Source registry components
│   ├── quarantine/        # Quarantine components
│   ├── circuit/           # Circuit breaker components
│   ├── audit/             # Audit trail components
│   ├── layout/            # Sidebar, header, theme toggle
│   ├── shared/            # Shared components (error, api-status)
│   └── ui/                # shadcn/ui components
└── lib/
    ├── api/               # API client (includes both StemeDB + Aphoria)
    └── utils.ts           # Utilities

Aphoria Dashboard: Port 18189 - Aphoria code quality dashboard
StemeDB API: Port 18180 - Backend API

Development

The dashboard shares some infrastructure with Aphoria Dashboard (UI components, API client, utilities). See applications/DASHBOARD_SYNC.md for sync procedures if you update shared code.

2.7 KiB Raw Blame History