stemedb/applications/stemedb-dashboard
jml 200b84751e feat: add claims search, promote, stats commands and convergence engine
Adds three new Aphoria CLI commands and supporting infrastructure for
org-pattern alignment and claim tier advancement:

- `aphoria claims search` — find claims by concept pattern, predicate,
  category, or max authority tier (works local and hosted mode)
- `aphoria claims promote` — raise a claim to a higher authority tier by
  creating a superseding claim (append-only; original marked Deprecated)
- `aphoria claims stats` — breakdown of claim counts by tier and status
  for a given concept_path + predicate pair

New modules:
- `convergence.rs` — pure engine comparing local scan observations to
  remote org claims, producing `ConvergenceSuggestion`s at read time
- `types/convergence.rs` — `ConvergenceSuggestion` type with severity
  derived from the driving claim's authority tier
- `types/promotion.rs` — `PromotionRequest` / `PromotionResult` types
- `handlers/promote.rs` — promotion handler; validates tier ordering

Remote client: adds `search_claims` and `claim_stats` methods to
`RemoteClaimStore`, wiring hosted mode for all three new commands.

API (`stemedb-api`): new `/v1/claims/search` and `/v1/claims/stats`
endpoints with DTOs, plus report formatters (JSON/Markdown/SARIF/table)
for search and stats output.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 08:21:37 +00:00
..
src feat: add source content to source registry, signed assertions, feed endpoint, dashboard enhancements 2026-02-19 21:54:27 -07:00
components.json feat: Complete Aphoria Phase 8-9 + UAT suite (90/90 tests passing) 2026-02-06 22:50:55 -07:00
next-env.d.ts feat: add claims search, promote, stats commands and convergence engine 2026-02-25 08:21:37 +00:00
next.config.ts fix(aphoria): fix 3 critical verification engine bugs 2026-02-08 15:13:10 +00:00
package-lock.json feat: Complete Aphoria Phase 8-9 + UAT suite (90/90 tests passing) 2026-02-06 22:50:55 -07:00
package.json feat: Complete Aphoria Phase 8-9 + UAT suite (90/90 tests passing) 2026-02-06 22:50:55 -07:00
pnpm-lock.yaml fix(aphoria): fix 3 critical verification engine bugs 2026-02-08 15:13:10 +00:00
postcss.config.mjs feat: Complete Aphoria Phase 8-9 + UAT suite (90/90 tests passing) 2026-02-06 22:50:55 -07:00
README.md feat(aphoria): add git commit tracking + comprehensive documentation 2026-02-08 18:36:46 +00:00
tsconfig.json feat: Complete Aphoria Phase 8-9 + UAT suite (90/90 tests passing) 2026-02-06 22:50:55 -07:00
tsconfig.tsbuildinfo feat: add source content to source registry, signed assertions, feed endpoint, dashboard enhancements 2026-02-19 21:54:27 -07:00

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.