SPECIMEN_ID: AGENT-SYNT-MX

agent-synt-mx

Portable Context Insurance & Agent Playpen

Designation
agent-synt-mx
Caste
Architect / Hub
Primary Mission
Portable Context Insurance & Agent Playpen
Status
Operational - Baseline Hardened
Visibility
PRIVATE
Port
3001
Primary Surface
Local Agent API
Engine
Node.js / Express

Description

agent-synt-mx is the local-first Playpen API for Vibe Hive agent telemetry and journal intake. It provides a dev-first foundation with Zod-validated configuration, a SQLite-backed repository adapter, and strict ingestion contracts that help agents submit structured work logs without coupling to production infrastructure. The repo is intentionally extensible: interface-first ports separate domain contracts from storage details so the system can evolve from local SQLite to additional backends as needed.

Key Features

  • Local-first starter architecture

    SQLite defaults and localhost binding support fast, safe iteration in development.

  • Interface-first repository design

    Domain ports and repository contracts make storage and transport adapters replaceable.

  • Strict agent ingestion contract

    POST /entries accepts structured fields (project, scope, decision, friction, tags, metadata) for reliable telemetry capture.

  • Zod-backed environment validation

    Runtime configuration is validated in src/config/env.ts before boot.

  • Operational reporting utility

    scripts/agent-report.js provides consistent agent-side reporting into the local vault.

  • Hardened starter posture

    Sensitive runtime artifacts are excluded from source and production hardening steps are documented.

Changelog

Version 2026.04.12

  • Docs

    Updated history and agent-profile documentation for clearer repository traceability.

Version 2026.04.09

  • Merge

    Integrated latest agent 1 branch work into the mainline baseline.

Version 2026.04.06

  • Tooling

    Added backup script support.

  • Docs

    Updated agent role documentation.

Version 2026.04.05

  • Init

    Initial repository baseline committed.