ACAgentic Craft

Part 1 of 8 · Design a Production Agent Runtime

Advanced~15 minHazelJS

Boot the Flagship

Clone Meridian Ops: env, store:sync, platform:sync, tour, and dev server with Skillgate + DNA overlay.

Authors
editorial-team
Published
Last reviewed

You will leave with

  • Run store:sync and explain what lock.json is for
  • Run platform:sync and explain apply ≠ restart Node
  • Confirm boot shows Skillgate report and DNA overlay
On this page

Journey A — Boot

Series hub: /guides/design-a-production-agent-runtime. Lab root: hazeljs-meridian-ops/ in the HazelJS monorepo.

Step 1 — Env and install

bash
cd hazeljs-meridian-ops
cp -n .env.example .env   # leave OPENAI_API_KEY empty → DemoLLM
npm install

Useful defaults from .env.example:

VariableDefault meaning
PORT3060
OPENAI_API_KEYempty → DemoLLM
AGENT_OS_HITL0 (auto-approve demos)
AGENT_OS_DNA_OVERLAY1 (prompt/policies from DNA/platform)

Step 2 — Store sync (DNA → packages)

bash
npm run store:sync

Publishes Meridian’s marketplace DNA into a local registry, materializes under .hazel/agents/, and writes lock.json.

Teach: Store answers how do we version and share the agent contract?

Step 3 — Platform sync (desired state)

bash
npm run platform:sync

Applies platform/*.yaml Definitions/Deployments into .hazel/platform/resources.json (+ events).

Teach: Platform answers what should this environment run?
Critical: apply / platform:sync does not start or restart your Node process. It is not kubectl apply for the app.

Step 4 — Tour map

bash
npm run tour

Prints the F1–F22 map and curl hints (same spirit as TOUR.md).

Step 5 — Dev server

bash
npm run dev
# http://localhost:3060
# Inspector: http://localhost:3060/__hazel

Boot log should show a Skillgate report and lines like DNA overlay: ….

Checkpoint A

  • store:sync and platform:sync succeed
  • Boot shows Skillgate + DNA overlay
  • /__hazel loads

Artifact: Checkpoint A: Meridian up on :3060 with overlay lines

Sources

  • Meridian Ops README — hazeljs-meridian-ops/README.md — mental model + quick start
  • Meridian TOUR.md — F1–F22 curl walkthrough
  • Flagship project plan (21) — docs/agent-os/21-flagship-project-plan.md
  • HazelJS Agent OS guide
  • HazelJS Agent package

Continue