SPECIMEN_ID: DDH-CORE

ddh-core

Centralized Engineering Intelligence & Cloud-Relay API

Designation
ddh-core
Caste
Ancestral Architect / Infrastructure V1
Primary Mission
Centralized Engineering Intelligence & Cloud-Relay API
Status
RETIRED (RE-PURPOSED) - Living Blueprint for Syntax V2
Visibility
PRIVATE
Port
n/a
Primary Surface
Backend API
Engine
Node.js / TypeScript / Express

Description

ddh-core was the original backend of the Daily Dev Habit ecosystem — a TypeScript/Express REST API that connected terminal clients and WordPress sensors to a PostgreSQL vault. It established the MVC + Dependency Injection patterns and the JWT authentication model that now underpin the Syntax Orchestrator. The cloud/Docker model has since been replaced by the local-first SQLite approach in V2, but this repo remains the reference architecture for how the whole system was designed.

Key Features

  • ›
    MVC + Dependency Injection

    Clean TypeScript architecture separating controllers, services, and repositories — the foundation for all V2 agents.

  • ›
    Hybrid Schema

    PostgreSQL with Relational + JSONB columns for storing structured metadata alongside log entries — now mirrored as metadata_json in SQLite vaults.

  • ›
    JWT Authentication (RS256)

    Stateless auth with BCrypt hashing; the direct predecessor to tokenGuard.ts in the Sovereign stack.

  • ›
    Two-stream Ingestion

    Unified endpoint accepting data from both the terminal CLI and the WordPress plugin sensor.

  • ›
    Containerized Infrastructure

    Full Docker Compose orchestration (Node.js API, PostgreSQL, WordPress) for local and cloud parity.

  • ›
    Documentation as Code

    Husky git hooks enforced structured commits as mandatory logging — an early version of the current telemetry philosophy.

Changelog

Version 2026.04.01

  • ›
    Refactor

    Replaced Axios with native fetch in entry service and repository.

Version 2026.03.08

  • ›
    Feature

    Added webhook support for outbound notifications.

  • ›
    Security

    Updated JWT fallback logic and added fail-fast guard.

  • ›
    Schema

    Extended Zod validation to accept new scope options and project column values.

Version 2025.12.27

  • ›
    Infra

    Switched to Nixpacks build system and repaired local Docker startup flow.

  • ›
    Runtime

    Hardened health-check boot behavior and start scripts for Railway and local execution.

  • ›
    Security

    Added validation and tightened middleware during stabilization passes.

Open GitHub Back to Registry