Operational Pipeline

CLI Workflow

This command-first workflow wraps components, captures artifacts, and validates rollout readiness with explicit quality gates.

Three-Step Integration

Keep the runtime tiny and push heavy work to build-time commands

Reference

1. Wrap your component. Use AutoSkeleton in loading paths.
2. Run capture and quality checks.Generate and verify manifest artifacts in CI.
3. Import generated artifacts once.Let runtime resolution use static data first.

Capabilities

Current ghostframes command surface exposed by @ghostframes/runtime

ghostframes

Build Layer Generation

Build commands generate fresh demo artifacts so developers can inspect skeleton behavior locally.

CI Validation

CI verifies artifacts and quality gates, and blocks stale or invalid outputs from being merged.

Deploy Sanity

Deploy runs quick checks against already-verified artifacts instead of expensive recomputation.

Capture

Snapshots route skeletons from the running app and writes manifest artifacts.

Validate

Checks required keys, coverage, and manifest safety limits before shipping.

Diff & Report

Compares candidate artifacts with baseline and generates operational reports.

Rollout

Executes policy-driven rollout decisions with telemetry and safety gates.

Layered Workflow

Generate in build/dev, validate in CI, sanity-check in deploy

Build + CI + Deploy

bash

# Build layer (local + CI build jobs)
# Generates skeleton artifacts after package builds
pnpm build

# Developer-focused generation while iterating
pnpm skeleton:generate:dev

# Skip auto-generation when needed
SKEL_SKIP_GENERATION=true pnpm build

bash

# CI validation layer (no artifact generation)
# Structural artifact sanity
pnpm quality:verify-artifacts

# Full quality and promotion gates
pnpm quality:gate

bash

# Deploy layer sanity (fast checks only)
pnpm deploy:sanity

# Deploy should consume already-verified artifacts:
# apps/demo/lib/ghostframes/generated/manifest.json
# apps/demo/lib/ghostframes/generated/manifest-loader.ts
# apps/demo/lib/ghostframes/generated/parity-report.json

Workflow Commands

Package scripts used in this repository

pnpm

bash

# 1) Capture fresh skeleton artifacts
pnpm capture:demo

# 2) Validate quality thresholds
pnpm quality:validate

# 3) Compare baseline vs candidate manifests
pnpm quality:diff

# 4) Build a combined report for CI dashboards
pnpm quality:report

# 5) Run the full gate sequence
pnpm quality:gate

Demo App Runbook

Use this sequence to demonstrate the full workflow locally

Demo

bash

# Terminal A: run demo app
pnpm --filter demo dev

# Terminal B: generate artifacts and validate
pnpm skeleton:generate:dev
pnpm quality:verify-artifacts
pnpm quality:gate

Runtime Rollout Template

Environment toggles that drive route-scoped behavior in the demo app

bash

# Runtime policy toggles in apps/demo/app/providers.tsx
NEXT_PUBLIC_SKEL_SERVE_HYBRID=true
NEXT_PUBLIC_SKEL_SERVE_PATHS=/reference,/advanced,/test
NEXT_PUBLIC_SKEL_SERVE_BLOCK_PATHS=/stress

NEXT_PUBLIC_SKEL_SHADOW_TELEMETRY=true
NEXT_PUBLIC_SKEL_SHADOW_PATHS=/reference

NEXT_PUBLIC_SKEL_STRICT_MODE=true
NEXT_PUBLIC_SKEL_STRICT_CANARY_PATHS=/reference
NEXT_PUBLIC_SKEL_STRICT_EXPANDED_PATHS=/advanced
NEXT_PUBLIC_SKEL_STRICT_BROAD_PATHS=/test
NEXT_PUBLIC_SKEL_STRICT_ROLLBACK_MODE=hybrid

NEXT_PUBLIC_SKEL_TELEMETRY_SINK=true
NEXT_PUBLIC_SKEL_USER_VISIBLE_REGRESSION_DELTA=0
NEXT_PUBLIC_SKEL_ROLLBACK_DRILL_DURATION_MS=540000

Direct CLI Invocation

Command entry points exposed by the installed ghostframes binary

bash

# Rollout command surface from the installed ghostframes binary
ghostframes capture
ghostframes validate
ghostframes diff
ghostframes report
ghostframes rollout