cce54358d2
**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> |
||
|---|---|---|
| .. | ||
| src | ||
| components.json | ||
| next-env.d.ts | ||
| next.config.ts | ||
| package-lock.json | ||
| package.json | ||
| pnpm-lock.yaml | ||
| postcss.config.mjs | ||
| README.md | ||
| tsconfig.json | ||
| tsconfig.tsbuildinfo | ||
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
Related Projects
- 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.